Repository navigation
docs(plugin-ops): document the verify-plugin --json output as a contract - #120
Conversation
Add a JSON output section to verify-plugin listing the top-level keys in order, their types, and the compatibility rule. Point the shape test at that section and cite Codex's is_file() catalog-slot check in the skip test. Bump plugin-ops to 0.2.4. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Claude finished @kyle-sexton's task in 29s —— View job Security review
Result: no security issues found. This PR is documentation-only plus a version bump:
Skip-gate check: no code paths, parsing, file I/O, or trust boundaries are touched — only prose and comments. No standing instruction ( |
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
|
Claude finished @kyle-sexton's task in 2m 14s —— View job Review of PR #120 —
|
|
claude-security-review has reviewed this pull request through 694434c; a later push is reviewed from there. |
|
Claude finished @kyle-sexton's task in 47s —— View job Security review — no issues foundScope: incremental — reviewed only the change since the last-reviewed commit (
What changedOne line in the "JSON output" contract table in -| `kind` | `"marketplace"`, `"plugin"`, or `null` | What the target was; `null` when neither was found. |
+| `kind` | `"marketplace"`, `"plugin"`, or `null` | What the target was; `null` when the target is neither or could not be inspected. |AssessmentThis is a prose-only clarification to a documentation table describing the
No security-relevant surface in this increment. No findings to report. |
|
claude-review has reviewed this pull request through 694434c; a later push is reviewed from there. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 694434c9be
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Refs: #117
Summary
Documents the
--jsonoutput ofvalidate-marketplace.mjsas a contract in the verify-plugin skill, links the shape test to it, and cites Codex's source for the skipped-catalog-slot test. User goal: a consumer of--jsoncan rely on the key list and knows which changes are breaking. Vertical slice: plugin-ops / verify-plugin. Bumps plugin-ops to 0.2.4.Fix
SKILL.md: new "JSON output" section with a table oftarget,kind,catalog,manifests,errors,warnings(order, type, meaning); adding a key is compatible, renaming or removing one is breaking.validate-marketplace.test.mjs: comment pointing the key-list assertion at that section; comment citingis_file()overMARKETPLACE_MANIFEST_RELATIVE_PATHSincodex-rs/core-plugins/src/marketplace.rsat rust-v0.162.0 (symbols verified at the tag via the GitHub API on 2026-10-10).plugin.jsonandtests/plugin-ops-plugin.test.mjs.Verification
npm test: 176 pass, 0 fail.npm run validate: no failures.$skill-creatorquick validator:python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py plugins/plugin-ops/skills/verify-plugin(run with PyYAML throughuv run --with pyyaml):Skill is valid!Upstream consulted:
SKILL.mdconcise and point at supporting files. The new section is a six-row table with no procedure, so it stays inSKILL.md.Related
Refs: #117
🤖 Generated with Claude Code