Skip to content

docs(spec-loop): sync specs with contributed functionality#720

Merged
potiuk merged 1 commit into
apache:mainfrom
justinmclean:sync-specs-20260704-075029
Jul 4, 2026
Merged

docs(spec-loop): sync specs with contributed functionality#720
potiuk merged 1 commit into
apache:mainfrom
justinmclean:sync-specs-20260704-075029

Conversation

@justinmclean

Copy link
Copy Markdown
Member

Summary

Back-fills spec coverage for new tools and adapters that landed since the previous sync (dd18a3c..821e564):

  • adapters.md: add SourceHut forge bridge, maildir, VCS abstraction (magpie-vcs), change-request contract, ASF SVN backend, forwarder-relay, mail-archive, mail-patch, jira-patch, github-body-field, github-rollup
  • agent-isolation-sandbox.md: add agent-guard (pre-execution guard dispatcher, PreToolUse/plugin hook), permission-audit (allow-list hygiene CLI), egress-gateway (HTTP forward proxy for egress control); reflect gh sandbox-exclusion model (excludedCommands)
  • meta-and-quality-tooling.md: add pilot-report-validator, vendor-neutrality-score, preflight-audit, spec-inventory; mark pilot-evidence gap resolved now that template and validator ship
  • overview.md: expand adapters row to name all shipped adapter modules
  • reviewer-routing.md: note skill is temporarily absent from docs/modes.md Triage table pending Privacy-LLM preflight addition

Generated-by: Claude (Opus 4.7)

Type of change

  • Skill change (.claude/skills/<name>/) — eval fixtures updated below
  • Tool / bridge contract (tools/<system>/*.md)
  • Python package (tools/*/ with pyproject.toml)
  • Groovy reference impl
  • Cross-cutting (RFC, AGENTS.md, sandbox, privacy-LLM)
  • Documentation (docs/, README.md, CONTRIBUTING.md)
  • Project template (projects/_template/)
  • CI / dev loop (prek, workflows, validators)
  • Other:

Test plan

  • prek run --all-files passes
  • For Python packages touched: uv run pytest / ruff check / mypy passes
  • For Groovy bridges touched: command-line invocation tested end-to-end
  • For skill changes: eval suite passes for the affected skill
    (PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/<skill>/)
  • For skill behaviour changes: a new or updated eval fixture is included in this PR
    (a regression test for the bug fixed / the behaviour added — see CONTRIBUTING.md)
  • Other:

Back-fills spec coverage for new tools and adapters that landed since
the previous sync (dd18a3c..821e564):

- adapters.md: add SourceHut forge bridge, maildir, VCS abstraction
  (magpie-vcs), change-request contract, ASF SVN backend, forwarder-relay,
  mail-archive, mail-patch, jira-patch, github-body-field, github-rollup
- agent-isolation-sandbox.md: add agent-guard (pre-execution guard
  dispatcher, PreToolUse/plugin hook), permission-audit (allow-list
  hygiene CLI), egress-gateway (HTTP forward proxy for egress control);
  reflect gh sandbox-exclusion model (excludedCommands)
- meta-and-quality-tooling.md: add pilot-report-validator,
  vendor-neutrality-score, preflight-audit, spec-inventory; mark
  pilot-evidence gap resolved now that template and validator ship
- overview.md: expand adapters row to name all shipped adapter modules
- reviewer-routing.md: note skill is temporarily absent from
  docs/modes.md Triage table pending Privacy-LLM preflight addition

Generated-by: Claude (Opus 4.7)
@justinmclean justinmclean self-assigned this Jul 4, 2026

@potiuk potiuk left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM — spec-loop sync. .last-sync is bumped to the correct synced tip (821e564d) and the five spec edits accurately describe adapters/tools that shipped since the last sync (verified against main). CI green.

One non-blocking note: .last-sync sits a few commits behind current main tip now, but those commits land in specs this PR doesn't touch, so its own edits aren't rendered stale and the next update run scopes from this marker and picks them up.

@potiuk
potiuk merged commit 65d759a into apache:main Jul 4, 2026
34 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants