Skip to content

Plugin version skew: /plugin list shows 0.1.0, docs claim 0.4.0-preview.1 #58

Description

@devfloor9

Summary

All four plugins ship "version": "0.1.0" in their plugin.json, but the marketplace, git tag, and docs all use 0.4.0-preview.1. Per the Claude Code plugin spec, plugin.json wins over the marketplace entry, so a user who installs from the marketplace sees 0.1.0 in /plugin list — directly contradicting the documented expected output.

Evidence

$ grep -m1 '"version"' plugins/*/.claude-plugin/plugin.json
ai-infra:      0.1.0
agenticops:    0.1.0
aidlc:         0.1.0
modernization: 0.1.0

$ grep '"version"' .claude-plugin/marketplace.json   # top-level + per-plugin
0.4.0-preview.1   (x5)

$ git tag --sort=-v:refname | head -1
v0.4.0-preview.1

Claude Code plugins-reference → Version management:

The version is resolved from the first of these that is set: 1. The version field in the plugin's plugin.json … 2. The version field in the plugin's marketplace entry … If also set in the marketplace entry, plugin.json wins.

The docs assert the opposite outcome:

  • docs/docs/getting-started.md:104-107ai-infra v0.4.0-preview.1 enabled (×4)
  • docs/docs/claude-code-setup.md:56-59 — same

Impact

  • /plugin list shows 0.1.0; users cannot tell whether they have the intended release.
  • /plugin update keys off the version string — a future 0.4.0-preview.2 bump in plugin.json would be required for users to receive updates; right now the stale 0.1.0 masks the real release line.

Proposed fix

Bump version to 0.4.0-preview.1 in all four plugins/*/.claude-plugin/plugin.json to match marketplace.json and the git tag. Add a release-hygiene check (the release.yml workflow, or oma compile --check) asserting plugin.json.version == marketplace entry version == tag, so the two never drift again.

Filed from a full-site/repo re-verification of the "install a plugin → get the dual-axis" UX.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingdocumentationImprovements or additions to documentation

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions