Summary
Rewrite the Known gaps bullet in tools/spec-loop/specs/adapters.md that says
adapter authoring smoke validation is missing. The check exists.
Background
The bullet reads "Adapter authoring smoke validation is missing. The docs define
the expected README contract, but no validator currently checks that each adapter
declares capability, prerequisites, privacy/credential handling, operations, and
config keys." All five of those are now checked by validate_adapter_authoring.
Spec Known gaps sections are not just documentation: the spec-loop plan beat
reads them to choose the next work item, so a gap that describes already-shipped
code sends the loop at finished work.
Where to look
tools/spec-loop/specs/adapters.md line 165 - the bullet to rewrite.
tools/skill-and-tool-validator/src/skill_and_tool_validator/__init__.py -
validate_adapter_authoring is called at line 3710. The regexes it uses for
credentials, operations and config keys are defined near the top of the file.
Verify by finding the call site, not the definition.
Acceptance criteria
Estimated effort
~ 30 minutes for someone new to the codebase.
Getting started
New to Magpie? Start with
Your first contribution.
Note: this issue was drafted by an AI-assisted mentoring tool and may contain
mistakes. A Magpie maintainer, a real person, will be the next to engage on it.
If something here looks wrong or unclear, please say so on the issue and a
maintainer will follow up. See
CONTRIBUTING.md
for how Magpie handles contributions.
Summary
Rewrite the
Known gapsbullet intools/spec-loop/specs/adapters.mdthat saysadapter authoring smoke validation is missing. The check exists.
Background
The bullet reads "Adapter authoring smoke validation is missing. The docs define
the expected README contract, but no validator currently checks that each adapter
declares capability, prerequisites, privacy/credential handling, operations, and
config keys." All five of those are now checked by
validate_adapter_authoring.Spec
Known gapssections are not just documentation: the spec-loop plan beatreads them to choose the next work item, so a gap that describes already-shipped
code sends the loop at finished work.
Where to look
tools/spec-loop/specs/adapters.mdline 165 - the bullet to rewrite.tools/skill-and-tool-validator/src/skill_and_tool_validator/__init__.py-validate_adapter_authoringis called at line 3710. The regexes it uses forcredentials, operations and config keys are defined near the top of the file.
Verify by finding the call site, not the definition.
Acceptance criteria
it applies to
contract:*adapters only, notsubstrate:*tools.uv run --project tools/spec-validator spec-validate tools/spec-loop/specs/passes.
Estimated effort
~ 30 minutes for someone new to the codebase.
Getting started
New to Magpie? Start with
Your first contribution.
Note: this issue was drafted by an AI-assisted mentoring tool and may contain
mistakes. A Magpie maintainer, a real person, will be the next to engage on it.
If something here looks wrong or unclear, please say so on the issue and a
maintainer will follow up. See
CONTRIBUTING.md
for how Magpie handles contributions.