Skip to content

feat(validator): add adapter authoring smoke check for contract:* tools#651

Merged
potiuk merged 2 commits into
apache:mainfrom
justinmclean:adapter-authoring-smoke-validation
Jun 30, 2026
Merged

feat(validator): add adapter authoring smoke check for contract:* tools#651
potiuk merged 2 commits into
apache:mainfrom
justinmclean:adapter-authoring-smoke-validation

Conversation

@justinmclean

Copy link
Copy Markdown
Member

Summary

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: run on existing skills

Add a SOFT advisory check (aspect apache#11) to skill-and-tool-validator that
verifies every contract:* adapter tool README declares the three authoring
fields the adapter contract requires: credential/privacy handling,
supported operations, and adopter config keys.

All three checks are SOFT so legacy adapters can be brought into
compliance deliberately without blocking unrelated changes. Twelve
advisories fire on the current tree; exit code stays 0. New
TestValidateAdapterAuthoring class adds 13 targeted tests.

Generated-by: Claude (Opus 4.7)
@justinmclean justinmclean self-assigned this Jun 30, 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.

Nice! I was thinking about that.

@potiuk potiuk merged commit 06c5237 into apache:main Jun 30, 2026
29 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