Skip to content

chore(spec-loop): sync specs to main and advance .last-sync - #1313

Merged
potiuk merged 1 commit into
apache:mainfrom
potiuk:sync-specs-20260921-045009
Sep 21, 2026
Merged

potiuk merged 1 commit into
apache:mainfrom
potiuk:sync-specs-20260921-045009

Conversation

@potiuk

@potiuk potiuk commented Sep 21, 2026

Copy link
Copy Markdown
Member

Summary

No functional change: specs only.

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: tools/spec-loop/ spec sync + .last-sync bump

Test plan

  • prek run --all-files passes (including spec-validate and the workspace pytest)
  • 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
  • For skill behaviour changes: a new or updated eval fixture is included in this PR
  • Other: no skill, tool or eval behaviour changes — the diff is spec prose plus the .last-sync pointer

RFC-AI-0004 compliance

No principle is touched: the change adds no mutation, no host access, no
LLM hop. It records sandbox and privacy behaviour that already shipped.

Linked issues

Refs #1306, #1308, #1309, #1310.

Notes for reviewers (optional)

Worth spot-checking that the agent-isolation-sandbox wording matches
what the merged settings actually do — in particular the distinction
between the read dispatcher (excluded) and vetted-op itself (never
excluded, because --caller is argv), and the claim that the in-repo
policy override needs a sandbox_write_denied entry or prek's fixers
abort with Operation not permitted.

🤖 Generated with Claude Code

@potiuk potiuk added the family:docs Docs, MISSION.md, READMEs label Sep 21, 2026
Reconciles the spec-loop specs with the functionality that shipped
between 0e7012b and 5c75abd:

- agent-isolation-sandbox: records the write-deny over the vetted-ops
  **policy** on both surfaces it resolves to — the plugin-cache install
  and the committed `.apache-magpie-overrides/tools/vetted-ops/**`
  override — why it applies even though the write dispatcher is never
  excluded from the sandbox, and why the framework's own dispatcher
  source at `tools/vetted-ops/` is deliberately left un-denied. apache#1311
  landed the excludedCommands list and the "excluded code must not be
  agent-writable" rule that this builds on.
- sandbox-diagnostics: an eighth troubleshooting entry (the touch
  overlay's runtime-state directory denied) and the branch-order rule
  the hint hook follows where two entries both end in "agent refused
  operation".
- security-reporting: the per-issue event cache is trusted only when it
  was written after that issue's `updatedAt`, so a relabelled issue is
  refetched instead of being served stale label history.

Generated-by: Claude Opus 5
@potiuk
potiuk force-pushed the sync-specs-20260921-045009 branch from be2267f to 4ae2353 Compare September 21, 2026 07:38
@potiuk
potiuk merged commit de5830a into apache:main Sep 21, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

family:docs Docs, MISSION.md, READMEs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant