a11y-loop 0.2.2 → 0.2.4

package/.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Makes AI coding agents decide accessibility while the work is still being planned and write accessible UI by default, then verify it in a real browser across the states they built — and say exactly what could not be checked. Ships the a11y-loop Agent Skill, a /a11y-plan command, and a plan-mode gate that declines a UI plan with no accessibility content in it.",
-    "version": "0.2.2"
+    "version": "0.2.4"
   },
   "plugins": [
     {
       "name": "a11y-loop",
       "source": "./",
-      "version": "0.2.2",
+      "version": "0.2.4",
       "description": "Accessibility in the plan, not after the pull request. Adds §0 plan rules (conformance target, per-component criteria, the product decisions that foreclose accessibility, color tokens before components), standing WCAG 2.2 AA generation rules, and a PreToolUse hook on ExitPlanMode that declines a UI-touching plan with no accessibility content — once, handing back the section to fill in. Verification is the a11y-loop CLI: axe-core in Chromium across default, dark, forced-colors, reduced-motion and 320px passes.",
       "author": {
         "name": "Chan Meng",

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "a11y-loop",
   "displayName": "a11y-loop",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Hard-gates plan mode: a plan that changes UI has to say what it decided about accessibility before it can be approved. Ships the a11y-loop skill and a /a11y-plan command alongside it.",
   "author": {
     "name": "Chan Meng",

package/README.md

@@ -364,6 +364,16 @@ want the plugin. Do not do both: the plugin carries its own copy, so the model e
 `a11y-loop` *and* the directory-qualified `a11y-loop:a11y-loop`, paying the always-on token cost
 twice. If both names show up, delete `~/.claude/skills/a11y-loop` and keep the plugin.
 
+**Upgrading is a different command from installing** — `claude plugin install` on something already
+installed reports "already installed" and does nothing:
+
+```bash
+npm i -g a11y-loop@latest
+cp -r "$(npm root -g)/a11y-loop/skill/a11y-loop" ~/.claude/skills/   # if using the skill
+claude plugin marketplace update chanmeng-a11y-loop                  # if using the plugin
+claude plugin update a11y-loop@chanmeng-a11y-loop
+```
+
 ### Installation (details)
 
 ```bash
@@ -540,11 +550,17 @@ npm run test:integration  # integration tests only (drives real Chromium)
 The optional plugin layer is plain Node with no dependencies. Exercise the plan gate directly:
 
 ```bash
-echo '{"session_id":"s1","tool_name":"ExitPlanMode","tool_input":{"plan":"Build a React modal with Tailwind CSS."}}' \
-  | node hooks/plan-gate.mjs
-claude plugin validate . --strict
+echo '{"session_id":"s1","tool_name":"ExitPlanMode","tool_input":{"plan":"Add a settings page in React: a modal dialog, a members table with row actions, tabs, and a dark mode toggle styled with Tailwind CSS."}}' \
+  | node hooks/plan-gate.mjs        # expect a "deny" verdict
+claude plugin validate . --strict   # shape only — see AGENTS.md on why this is not proof
 ```
 
+Silence and exit 0 is the gate's normal answer, so an example that prints nothing proves nothing:
+the plan has to clear 40 characters and be unambiguously about UI, or you are testing the pass path
+by accident. Re-running the *same* plan returns `defer` rather than `deny` — the loop guard spends
+each plan's hash once, deliberately — so prefix with `CLAUDE_PLUGIN_DATA="$(mktemp -d)"` for a clean
+verdict. See [`AGENTS.md`](AGENTS.md) for the rest of the plugin-layer gotchas.
+
 See [`AGENTS.md`](AGENTS.md) for AI-agent-oriented project conventions, the fixture-manifest
 testing pattern, the loop discipline expected when touching `demo/` or other UI, and the rule that
 keeps `skill/` free of any Claude-Code-specific mechanism.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "a11y-loop",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Makes AI coding agents decide accessibility while the work is still being planned and write accessible UI by default, then proves what it can prove with a real browser audit across the states they built — and tells you exactly what it could not check.",
   "type": "module",
   "bin": {

package/skill/a11y-loop/SKILL.md

@@ -28,7 +28,7 @@ compatibility: >-
   The generation and honesty rules apply with or without the CLI; every step
   that says "audit" requires it.
 metadata:
-  "a11y-loop/version": "0.2.2"
+  "a11y-loop/version": "0.2.4"
 allowed-tools: 'Bash(a11y-loop *) Bash(npx a11y-loop *) Bash(node ${CLAUDE_SKILL_DIR}/../../src/cli.js *)'
 ---