@webpresso/agent-kit 0.26.1 → 0.26.2

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Webpresso agent-kit Claude Code plugin: blueprints, skills, hooks, MCP server",
-    "version": "0.26.1"
+    "version": "0.26.2"
   },
   "plugins": [
     {
@@ -23,5 +23,5 @@
       ]
     }
   ],
-  "version": "0.26.1"
+  "version": "0.26.2"
 }

package/.claude-plugin/plugin.json

@@ -1,66 +1,9 @@
 {
   "name": "webpresso",
-  "version": "0.26.1",
+  "version": "0.26.2",
   "description": "Webpresso agent-kit: blueprints, skills, lore commit protocol, tech-debt lifecycle",
   "skills": "./skills",
   "commands": "./commands",
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash|Edit|Write|MultiEdit|WebFetch|Read|Grep",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/bin/wp-pretool-guard.js"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/bin/wp-post-tool.js",
-            "timeout": 15
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/bin/wp-stop-qa.js"
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/bin/wp-guard-switch.js",
-            "timeout": 5
-          }
-        ]
-      }
-    ],
-    "SessionStart": [
-      {
-        "matcher": "startup|resume|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/bin/wp-sessionstart-routing.js"
-          }
-        ]
-      }
-    ]
-  },
   "mcpServers": {
     "webpresso": {
       "command": "node",

package/README.md

@@ -44,6 +44,15 @@ Playwright, unit-test and file-based e2e smoke assets), wires `AGENTS.md` /
 execution-owned vs authoring-owned dependency migration guidance. Re-running
 refreshes the webpresso-owned pieces and preserves consumer-owned files.
 
+> **`wp setup` is required for hooks.** The Claude Code hooks (PreToolUse guard,
+> Stop-QA gate, SessionStart routing, …) are installed by `wp setup` into your
+> repo's `.claude/settings.json`. They are intentionally **not** shipped in the
+> plugin manifest — declaring them in both places double-fires every hook (Claude
+> Code does not dedup across sources), and settings.json is the more reliable
+> surface. So enabling the plugin alone does **not** activate hooks; run
+> `wp setup`. Run `wp hooks doctor` to check — it warns if the managed hooks are
+> missing from `.claude/settings.json`.
+
 `wp` owns **execution** for the generic tool lanes it manages (test / mutation /
 e2e / lint / format / typecheck). That does **not** mean every local
 devDependency disappears — keep dependencies your repo imports directly (e.g.

package/dist/esm/hooks/doctor.d.ts

@@ -13,6 +13,8 @@ export interface DoctorCheck {
     name: string;
     ok: boolean;
     detail?: string;
+    /** Advisory checks surface a warning but do not flip the doctor's exit code. */
+    advisory?: boolean;
 }
 export interface DoctorResult {
     ok: boolean;
@@ -28,6 +30,16 @@ export interface RunHooksDoctorOptions {
 }
 export declare function findOwningPackageRoot(startDir: string): string | null;
 export declare function checkRtkOnPath(cwd?: string): Promise<DoctorCheck | null>;
+/**
+ * Verify the consumer's `.claude/settings.json` carries the managed agent-kit
+ * hook launchers. Since the hooks are single-sourced there (not in the plugin
+ * manifest), a missing reference means a plugin-only install that never ran
+ * `wp setup` — i.e. no agent-kit hooks are active.
+ */
+export declare function checkManagedHooksInstalled(cwd?: string): {
+    ok: boolean;
+    detail?: string;
+};
 export declare function runHooksDoctor(opts?: RunHooksDoctorOptions): Promise<DoctorResult>;
 export declare function printHooksDoctor(opts?: RunHooksDoctorOptions): Promise<number>;
 export {};

package/dist/esm/hooks/doctor.js

@@ -590,6 +590,40 @@ function checkLiveSourceDevLink(cwd = process.cwd()) {
         detail: `${state.package} → ${state.linkedFrom}`,
     };
 }
+// Marker for the managed hook launchers `wp setup` writes under
+// `.claude/hooks/managed/` (CLAUDE_MANAGED_HOOK_SUBDIR in the agent-hooks
+// scaffolder). The plugin manifest no longer ships hooks (they double-fired
+// against these and were the less reliable surface), so settings.json is the
+// single source — if it does not reference them, the hooks are not installed.
+const MANAGED_HOOK_MARKER = 'hooks/managed/wp-pretool-guard';
+/**
+ * Verify the consumer's `.claude/settings.json` carries the managed agent-kit
+ * hook launchers. Since the hooks are single-sourced there (not in the plugin
+ * manifest), a missing reference means a plugin-only install that never ran
+ * `wp setup` — i.e. no agent-kit hooks are active.
+ */
+export function checkManagedHooksInstalled(cwd = process.cwd()) {
+    const settingsPath = join(cwd, '.claude', 'settings.json');
+    if (!tryAccess(settingsPath)) {
+        return {
+            ok: false,
+            detail: 'no .claude/settings.json — run `wp setup` to install the agent-kit hooks',
+        };
+    }
+    try {
+        const raw = readFileSync(settingsPath, 'utf-8');
+        if (!raw.includes(MANAGED_HOOK_MARKER)) {
+            return {
+                ok: false,
+                detail: 'agent-kit hooks not found in .claude/settings.json — run `wp setup`',
+            };
+        }
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, detail: `failed to read .claude/settings.json: ${String(err)}` };
+    }
+}
 export async function runHooksDoctor(opts = {}) {
     const checks = [];
     const isWin = platform() === 'win32';
@@ -609,6 +643,11 @@ export async function runHooksDoctor(opts = {}) {
     }
     checks.push(checkConsumerCodexHookPaths(opts.cwd));
     checks.push({ name: 'plugin.json integrity', ...checkPluginJson() });
+    checks.push({
+        name: 'managed hooks installed (.claude/settings.json)',
+        advisory: true,
+        ...checkManagedHooksInstalled(opts.cwd),
+    });
     if (opts.skipMcp) {
         checks.push({ name: 'MCP server liveness', ok: true, detail: 'skipped (--skip-mcp)' });
     }
@@ -676,7 +715,7 @@ export async function runHooksDoctor(opts = {}) {
             }
         }
     }
-    const nonMcpChecks = checks.filter((c) => !c.name.startsWith('MCP '));
+    const nonMcpChecks = checks.filter((c) => !c.name.startsWith('MCP ') && !c.advisory);
     const overallOk = nonMcpChecks.every((c) => c.ok);
     return { ok: overallOk, checks };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpresso/agent-kit",
-  "version": "0.26.1",
+  "version": "0.26.2",
   "private": false,
   "repository": {
     "type": "git",
@@ -710,10 +710,10 @@
     "@stryker-mutator/typescript-checker": "^9.6.1",
     "@playwright/test": "^1.55.0",
     "wrangler": "^4.50.0",
-    "@webpresso/agent-kit-runtime-darwin-arm64": "0.26.1",
-    "@webpresso/agent-kit-runtime-darwin-x64": "0.26.1",
-    "@webpresso/agent-kit-runtime-linux-x64": "0.26.1",
-    "@webpresso/agent-kit-runtime-linux-arm64": "0.26.1",
-    "@webpresso/agent-kit-runtime-windows-x64": "0.26.1"
+    "@webpresso/agent-kit-runtime-darwin-arm64": "0.26.2",
+    "@webpresso/agent-kit-runtime-darwin-x64": "0.26.2",
+    "@webpresso/agent-kit-runtime-linux-x64": "0.26.2",
+    "@webpresso/agent-kit-runtime-linux-arm64": "0.26.2",
+    "@webpresso/agent-kit-runtime-windows-x64": "0.26.2"
   }
 }