Skip to content

fix(tools): spell the OSV and CVE.org recipes with the framework runner prefix - #1339

Merged
potiuk merged 1 commit into
mainfrom
fix/vetted-ops-recipe-invocation-form
Sep 22, 2026
Merged

potiuk merged 1 commit into
mainfrom
fix/vetted-ops-recipe-invocation-form

Conversation

@potiuk

@potiuk potiuk commented Sep 22, 2026

Copy link
Copy Markdown
Member

Summary

Type of change

  • Tool / bridge contract (tools/<system>/*.md)
  • Documentation (docs/, README.md, CONTRIBUTING.md)

Test plan

  • prek run --all-files passes
  • Verified <framework> is the documented placeholder for this use (AGENTS.md § Placeholder convention) and matches existing usage in tools/privacy-llm/, tools/reproducible-archive/
  • No behaviour change — the recipes are prose; no skill logic, no Python touched

RFC-AI-0004 compliance

  • Sandbox — no new host access; this makes the documented invocation match the shipped sandbox exclusion rather than widening anything
  • Vendor neutrality — uses the <framework> / <caller> placeholders

Linked issues

Refs #1320, Refs #1326

Notes for reviewers

Raised as a non-blocking note during review of #1326 and fixed here rather than lost in a merged PR.

The alternative was to document that vetted-op-read is assumed on PATH and keep the recipes bare. I went with the prefixed form because it is what the rest of the repository already does and what the permission rules actually match — but if you would rather assume PATH, the fix is a sentence in tools/vetted-ops/README.md instead and this PR should be closed.

…er prefix

The recipes added in #1326 invoke the dispatcher as a bare
`vetted-op-read …`, but every permission rule and sandbox exclusion in
the repository spells it with the runner prefix, and
`tools/vetted-ops/README.md` writes it as `… vetted-op-read` with an
explicit ellipsis for the variable part. An agent following these
recipes literally therefore hits a permission prompt or a sandboxed
run — the same recipe-versus-baseline mismatch #1320 set out to close,
in a new spelling.

The framework already has a settled convention for addressing its own
`tools/<name>/` subtrees: `uv run --project <framework>/tools/<name>`,
used by `privacy-llm`, `reproducible-archive` and others, with
`<framework>` resolved per the placeholder table in AGENTS.md. These
nine recipes were the outlier rather than a new question, so they now
match it.

Generated-by: Claude Opus 5
@potiuk
potiuk merged commit c6ee52e into main Sep 22, 2026
8 checks passed
@potiuk
potiuk deleted the fix/vetted-ops-recipe-invocation-form branch September 22, 2026 21:47
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.

1 participant