Skip to content

fix(plugin): bump version to 0.1.7 so /plugin picks up changes + guard it#123

Merged
aktasbatuhan merged 1 commit into
mainfrom
fix/plugin-version-bump
Jun 8, 2026
Merged

fix(plugin): bump version to 0.1.7 so /plugin picks up changes + guard it#123
aktasbatuhan merged 1 commit into
mainfrom
fix/plugin-version-bump

Conversation

@aktasbatuhan

Copy link
Copy Markdown
Member

Why

The plugin reaches Claude Code / Codex through a marketplace clone, and /plugin only refreshes its installed cache when plugin.json's version changes. That version was frozen at 0.1.6 since 2026-05-12 while plugin/bin/ kept changing (through #122), so anyone who installed via /plugin has been stranded on a stale plugin. The #122 dedup hook and reframed statusline never reached them. This was found while trying to update a local setup: the marketplace clone updated fine, but the live cache stayed stale because the version never moved.

What changed

  • Bump both manifests 0.1.6 -> 0.1.7 (plugin/.claude-plugin/plugin.json and plugin-codex/.codex-plugin/plugin.json) so the feat(plugin): stop the skill-suggestion firehose; reframe the surface #122 payload actually ships.
  • CI guard (plugin-version job): on PRs, if anything under plugin*/{bin,hooks,skills}/ changed vs base, both manifest versions must bump too. Prevents the freeze from recurring.
  • Unit test: the two manifests must declare the same version (lockstep), so a one-sided bump can't strand the other harness.

After merge

Users refresh with /plugin marketplace update watchmen then reinstall; maintainers can watchmen plugin update to pull the clone. This unblocks the local-setup update path and is a prerequisite for a guided setup skill.

Testing

  • uv run pytest tests/test_plugin_version.py -q green
  • ci.yml validates as YAML; new job is pull_request-gated

…d it

The plugin ships to Claude Code / Codex via a marketplace clone, and `/plugin`
only refreshes its installed cache when plugin.json's version changes. The
version was frozen at 0.1.6 since 2026-05-12 while plugin/bin kept changing
(through #122), so every user who installed via /plugin was stranded on a stale
plugin — the dedup hook and reframed statusline never reached them.

- Bump plugin/.claude-plugin/plugin.json and plugin-codex/.codex-plugin/
  plugin.json 0.1.6 -> 0.1.7 to carry the #122 plugin payload.
- CI guard (plugin-version job): on PRs, if anything under plugin*/bin|hooks|
  skills changed vs base, both manifest versions must bump too. Stops the
  freeze from recurring.
- Unit test: the two manifests must declare the same version (lockstep), so a
  one-sided bump can't strand the other harness.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@aktasbatuhan aktasbatuhan merged commit 14b0798 into main Jun 8, 2026
8 checks passed
@aktasbatuhan aktasbatuhan deleted the fix/plugin-version-bump branch June 8, 2026 22:27
aktasbatuhan added a commit that referenced this pull request Jun 8, 2026
…ts (#124)

* feat(plugin): add `setup` skill — guided watchmen install across agents

A thin orchestrator skill (`/watchmen:setup` in Claude Code, `/skills setup`
or `$setup` in Codex) that walks a user through installing and wiring watchmen:
detects uv + existing install, installs the CLI, hands off the interactive
`watchmen init` wizard and the agent-only `/plugin` steps, wires the statusline,
and verifies with `watchmen doctor`. Cross-agent: covers both Claude Code and
Codex. Never touches credentials — defers all provider auth to the init wizard.

- plugin/skills/setup/SKILL.md (Claude variant, with allowed-tools)
- plugin-codex/skills/setup/SKILL.md (Codex variant: $-invocation, AGENTS.md,
  no statusline, no allowed-tools — matching the brief skill's conventions)
- Bump both plugin manifests 0.1.7 -> 0.1.8 (the #123 CI guard requires a bump
  when plugin/skills changes; keeps the two harnesses in version lockstep).

Note: shipping in the plugin means a brand-new user can't invoke it until they
install the plugin (the thing it sets up) — it's primarily for wiring a second
agent, repairing, or verifying. A standalone-install README line can follow.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs(readme): document the setup skill + standalone pre-install path

Adds a 'Guided setup skill' note to the Plugins section: how to invoke
/watchmen:setup (or $setup in Codex) once installed, and how to curl the
SKILL.md into ~/.claude/skills/ standalone so a brand-new machine can run it
before any plugin exists (resolving the in-plugin chicken-and-egg).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

1 participant