Skip to content

Enforce plugin registration in root webcmd-plugin.json - #301

Closed
ayushsingh82 wants to merge 1 commit into
agentrhq:mainfrom
ayushsingh82:fix/222-enforce-plugin-registration
Closed

Enforce plugin registration in root webcmd-plugin.json#301
ayushsingh82 wants to merge 1 commit into
agentrhq:mainfrom
ayushsingh82:fix/222-enforce-plugin-registration

Conversation

@ayushsingh82

Copy link
Copy Markdown
Contributor

Summary

  • Fixes webcmd-adapter-author skill: root webcmd-plugin.json step is documented but skippable — should be enforced, not optional #222 — the root-manifest registration step in the webcmd-adapter-author skill's promotion flow could be silently skipped: webcmd plugin create, webcmd plugin install, and webcmd validate <site> all succeed even when a promoted plugin never lands in the root webcmd-plugin.json.
  • webcmd validate (untargeted) now warns when a plugins/<site> directory has its own webcmd-plugin.json but is missing from the root manifest's plugins map, via a new findUnregisteredPlugins() in plugin-manifest.ts. No-op outside a monorepo checkout (e.g. npm installs, which ship neither plugins/ nor a root manifest).
  • adapter-template.md gets an explicit grep-based verification step right after the root-manifest edit, so an agent following the skill has to confirm the step landed instead of trusting that every command succeeding means it worked.

Test plan

  • npx vitest run src/plugin-manifest.test.ts src/validate.test.ts — new coverage for findUnregisteredPlugins (missing/registered/disabled/no-monorepo/no-plugins/-dir cases) and the webcmd validate wiring
  • npx tsc --build --force — clean
  • Manually verified against this repo: removed amazon's entry from the root manifest, confirmed webcmd validate flagged it, restored and confirmed clean again
  • Full unit vitest project (147 files / 2356 tests) passes with these changes in the tree

…#222)

The webcmd-adapter-author skill documents adding a promoted plugin to
the root webcmd-plugin.json plugins map, but nothing checks it landed.
webcmd plugin create, webcmd plugin install, and webcmd validate <site>
all succeed even when that step is skipped, so the gap goes unnoticed
until the plugin is silently missing from the catalog.

- webcmd validate (no target) now warns when a plugins/<site> directory
  has its own webcmd-plugin.json but isn't registered in the root
  manifest's plugins map.
- adapter-template.md gets an explicit grep-based verification step
  right after the root-manifest edit.
@github-actions

Copy link
Copy Markdown
Contributor

🟠 Maintainer review suggested — low confidence

The automated review could not reach a fully supported conclusion.

This review is advisory and does not block merging.

@ankitranjan7

Copy link
Copy Markdown
Contributor

Thanks for the thorough implementation and tests. I’m closing this because it enforces a workflow that is no longer intended: the root plugin catalog and README table are generated after merge from each plugin’s local manifest by the community-plugin sync workflow. A validation warning here would incorrectly flag contributions that follow the current generated-catalog process. #117 will align the authoring documentation with that workflow.

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.

webcmd-adapter-author skill: root webcmd-plugin.json step is documented but skippable — should be enforced, not optional

2 participants