specweave 1.0.551 → 1.0.552

package/bin/specweave.js

@@ -1244,6 +1244,28 @@ program
     }
   });
 
+// Hook command - CLI delegation entry point for Claude Code hooks (internal)
+program
+  .command('hook <event-type>')
+  .description('Handle Claude Code hook events (internal)')
+  .action(async (eventType) => {
+    try {
+      const { handleHook } = await import('../dist/src/cli/commands/hook.js');
+      await handleHook(eventType);
+    } catch {
+      // Never crash — output safe default
+      const defaults = {
+        'user-prompt-submit': '{"decision":"approve"}',
+        'pre-tool-use': '{"decision":"allow"}',
+        'stop-reflect': '{"decision":"approve"}',
+        'stop-auto': '{"decision":"approve"}',
+        'stop-sync': '{"decision":"approve"}',
+      };
+      process.stdout.write(defaults[eventType] || '{"continue":true}');
+    }
+    process.exit(0);
+  });
+
 // Detect intent command - Hook helper for automatic plugin loading (internal)
 program
   .command('detect-intent [prompt]')
@@ -1556,7 +1578,7 @@ program
   await checkForDuplicates();
 
   // Hide internal-only commands from --help (still callable by hooks)
-  for (const name of ['detect-intent', 'evaluate-completion', 'reflect-stop', 'detect-project']) {
+  for (const name of ['hook', 'detect-intent', 'evaluate-completion', 'reflect-stop', 'detect-project']) {
     const cmd = program.commands.find(c => c.name() === name);
     if (cmd) cmd._hidden = true;
   }

package/dist/src/cli/commands/hook.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Hook CLI Command — entry point for Claude Code hook delegation.
+ *
+ * Usage: specweave hook <event-type>
+ *
+ * Reads JSON from stdin, dispatches to the correct handler via hook-router,
+ * writes JSON to stdout. Always exits 0 — never crashes Claude Code.
+ *
+ * @module cli/commands/hook
+ */
+/**
+ * Main hook handler entry point.
+ */
+export declare function handleHook(eventType: string): Promise<void>;
+//# sourceMappingURL=hook.d.ts.map

package/dist/src/cli/commands/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsCH;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBjE"}

package/dist/src/cli/commands/hook.js

@@ -0,0 +1,61 @@
+/**
+ * Hook CLI Command — entry point for Claude Code hook delegation.
+ *
+ * Usage: specweave hook <event-type>
+ *
+ * Reads JSON from stdin, dispatches to the correct handler via hook-router,
+ * writes JSON to stdout. Always exits 0 — never crashes Claude Code.
+ *
+ * @module cli/commands/hook
+ */
+import { hookRouter } from '../../core/hooks/handlers/hook-router.js';
+import { getSafeDefault } from '../../core/hooks/handlers/types.js';
+/**
+ * Read all of stdin as a string.
+ */
+async function readStdin() {
+    return new Promise((resolve) => {
+        const chunks = [];
+        const timeout = setTimeout(() => {
+            process.stdin.removeAllListeners();
+            resolve(Buffer.concat(chunks).toString('utf-8'));
+        }, 5000);
+        process.stdin.on('data', (chunk) => {
+            chunks.push(chunk);
+        });
+        process.stdin.on('end', () => {
+            clearTimeout(timeout);
+            resolve(Buffer.concat(chunks).toString('utf-8'));
+        });
+        process.stdin.on('error', () => {
+            clearTimeout(timeout);
+            resolve('');
+        });
+        // If stdin is already ended (no pipe), resolve immediately
+        if (process.stdin.readableEnded) {
+            clearTimeout(timeout);
+            resolve(Buffer.concat(chunks).toString('utf-8'));
+        }
+    });
+}
+/**
+ * Main hook handler entry point.
+ */
+export async function handleHook(eventType) {
+    // Crash prevention
+    process.on('unhandledRejection', () => {
+        const fallback = getSafeDefault(eventType);
+        process.stdout.write(JSON.stringify(fallback));
+        process.exit(0);
+    });
+    try {
+        const rawStdin = await readStdin();
+        const result = await hookRouter(eventType, rawStdin);
+        process.stdout.write(JSON.stringify(result));
+    }
+    catch {
+        const fallback = getSafeDefault(eventType);
+        process.stdout.write(JSON.stringify(fallback));
+    }
+}
+//# sourceMappingURL=hook.js.map

package/dist/src/cli/commands/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../../../src/cli/commands/hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE;;GAEG;AACH,KAAK,UAAU,SAAS;IACtB,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC,EAAE,IAAI,CAAC,CAAC;QAET,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC7B,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,CAAC,EAAE,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,2DAA2D;QAC3D,IAAI,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAChC,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,mBAAmB;IACnB,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QACpC,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,SAAS,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/src/config/types.d.ts

@@ -19,12 +19,12 @@ export declare const ResearchConfigSchema: z.ZodObject<{
             iot: "iot";
             gaming: "gaming";
             marketplace: "marketplace";
+            blockchain: "blockchain";
             "productivity-saas": "productivity-saas";
             "e-commerce": "e-commerce";
             "social-network": "social-network";
             "enterprise-b2b": "enterprise-b2b";
             "consumer-b2c": "consumer-b2c";
-            blockchain: "blockchain";
             "ai-ml": "ai-ml";
         }>;
         competitors: z.ZodArray<z.ZodObject<{
@@ -190,12 +190,12 @@ export declare const SpecWeaveConfigSchema: z.ZodObject<{
                 iot: "iot";
                 gaming: "gaming";
                 marketplace: "marketplace";
+                blockchain: "blockchain";
                 "productivity-saas": "productivity-saas";
                 "e-commerce": "e-commerce";
                 "social-network": "social-network";
                 "enterprise-b2b": "enterprise-b2b";
                 "consumer-b2c": "consumer-b2c";
-                blockchain: "blockchain";
                 "ai-ml": "ai-ml";
             }>;
             competitors: z.ZodArray<z.ZodObject<{

package/dist/src/core/hooks/handlers/hook-router.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Hook router — the central dispatcher for all hook events.
+ *
+ * Reads stdin JSON, resolves the project root, dynamically imports the
+ * correct handler, and returns JSON. Wraps everything in try/catch so
+ * no hook can ever crash.
+ *
+ * @module core/hooks/handlers/hook-router
+ */
+import type { HookResult } from './types.js';
+/**
+ * Route a hook event to the correct handler.
+ *
+ * @param eventType - The hook event type (e.g. 'pre-compact', 'user-prompt-submit')
+ * @param rawStdin - Raw stdin string (JSON from Claude Code)
+ * @returns HookResult — always valid JSON, never throws
+ */
+export declare function hookRouter(eventType: string, rawStdin: string): Promise<HookResult>;
+//# sourceMappingURL=hook-router.d.ts.map

package/dist/src/core/hooks/handlers/hook-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-router.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/hook-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;AAiBxD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CA+CrB"}

package/dist/src/core/hooks/handlers/hook-router.js

@@ -0,0 +1,75 @@
+/**
+ * Hook router — the central dispatcher for all hook events.
+ *
+ * Reads stdin JSON, resolves the project root, dynamically imports the
+ * correct handler, and returns JSON. Wraps everything in try/catch so
+ * no hook can ever crash.
+ *
+ * @module core/hooks/handlers/hook-router
+ */
+import { getSafeDefault } from './types.js';
+import { findProjectRoot, createContext, parseStdinJson, logHook } from './utils.js';
+/** Dynamic import map — only the requested handler is loaded per invocation */
+const HANDLERS = {
+    'user-prompt-submit': () => import('./user-prompt-submit.js'),
+    'pre-tool-use': () => import('./pre-tool-use.js'),
+    'post-tool-use': () => import('./post-tool-use.js'),
+    'post-tool-use-analytics': () => import('./post-tool-use-analytics.js'),
+    'session-start': () => import('./session-start.js'),
+    'pre-compact': () => import('./pre-compact.js'),
+    'stop-reflect': () => import('./stop-reflect.js'),
+    'stop-auto': () => import('./stop-auto.js'),
+    'stop-sync': () => import('./stop-sync.js'),
+};
+/**
+ * Route a hook event to the correct handler.
+ *
+ * @param eventType - The hook event type (e.g. 'pre-compact', 'user-prompt-submit')
+ * @param rawStdin - Raw stdin string (JSON from Claude Code)
+ * @returns HookResult — always valid JSON, never throws
+ */
+export async function hookRouter(eventType, rawStdin) {
+    const safeDefault = getSafeDefault(eventType);
+    try {
+        // Global kill switch
+        if (process.env.SPECWEAVE_DISABLE_HOOKS === '1') {
+            return safeDefault;
+        }
+        // Parse stdin
+        const input = parseStdinJson(rawStdin);
+        // Resolve project root
+        const projectRoot = findProjectRoot();
+        if (!projectRoot) {
+            // Not a SpecWeave project — pass through
+            return safeDefault;
+        }
+        // Build context
+        const context = createContext(projectRoot);
+        // Find handler
+        const loader = HANDLERS[eventType];
+        if (!loader) {
+            logHook(context, 'router', `Unknown event type: ${eventType}`);
+            return safeDefault;
+        }
+        // Dynamic import + execute
+        const handlerModule = await loader();
+        const result = await handlerModule.handle(input, context);
+        return result;
+    }
+    catch (error) {
+        // Never crash — log and return safe default
+        try {
+            const projectRoot = findProjectRoot();
+            if (projectRoot) {
+                const context = createContext(projectRoot);
+                const msg = error instanceof Error ? error.message : String(error);
+                logHook(context, 'router', `Error in ${eventType}: ${msg}`);
+            }
+        }
+        catch {
+            // Even logging can fail — swallow everything
+        }
+        return safeDefault;
+    }
+}
+//# sourceMappingURL=hook-router.js.map

package/dist/src/core/hooks/handlers/hook-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-router.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/hook-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErF,+EAA+E;AAC/E,MAAM,QAAQ,GAAyD;IACrE,oBAAoB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC;IAC7D,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;IACjD,eAAe,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;IACnD,yBAAyB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,8BAA8B,CAAC;IACvE,eAAe,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;IACnD,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAC/C,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;IACjD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAC3C,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,SAAiB,EACjB,QAAgB;IAEhB,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,qBAAqB;QACrB,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,EAAE,CAAC;YAChD,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,cAAc;QACd,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAEvC,uBAAuB;QACvB,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,yCAAyC;YACzC,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,gBAAgB;QAChB,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAE3C,eAAe;QACf,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,uBAAuB,SAAS,EAAE,CAAC,CAAC;YAC/D,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,2BAA2B;QAC3B,MAAM,aAAa,GAAG,MAAM,MAAM,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4CAA4C;QAC5C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;YACtC,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;gBAC3C,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,SAAS,KAAK,GAAG,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/src/core/hooks/handlers/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Hook handlers barrel export.
+ *
+ * @module core/hooks/handlers
+ */
+export type { HandlerFn, HookContext, HookInput, HookResult, HookEventType } from './types.js';
+export { getSafeDefault, SAFE_DEFAULTS } from './types.js';
+export { hookRouter } from './hook-router.js';
+export { findProjectRoot, createContext, parseStdinJson, logHook } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/hooks/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/hooks/handlers/index.js

@@ -0,0 +1,9 @@
+/**
+ * Hook handlers barrel export.
+ *
+ * @module core/hooks/handlers
+ */
+export { getSafeDefault, SAFE_DEFAULTS } from './types.js';
+export { hookRouter } from './hook-router.js';
+export { findProjectRoot, createContext, parseStdinJson, logHook } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/hooks/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/hooks/handlers/post-tool-use-analytics.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PostToolUse analytics handler — tracks Skill and Task (subagent) usage.
+ *
+ * Appends events to `.specweave/state/analytics/events.jsonl`.
+ * Non-blocking, never throws.
+ *
+ * @module core/hooks/handlers/post-tool-use-analytics
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=post-tool-use-analytics.d.ts.map

package/dist/src/core/hooks/handlers/post-tool-use-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool-use-analytics.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/post-tool-use-analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AAyBvD,eAAO,MAAM,MAAM,EAAE,SAkCpB,CAAC"}

package/dist/src/core/hooks/handlers/post-tool-use-analytics.js

@@ -0,0 +1,73 @@
+/**
+ * PostToolUse analytics handler — tracks Skill and Task (subagent) usage.
+ *
+ * Appends events to `.specweave/state/analytics/events.jsonl`.
+ * Non-blocking, never throws.
+ *
+ * @module core/hooks/handlers/post-tool-use-analytics
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const CONTINUE = { continue: true };
+function getToolInput(input) {
+    return (input.tool_input ?? input.toolInput ?? {});
+}
+function resolveToolName(input) {
+    const explicit = (input.tool_name ?? input.toolName ?? '');
+    if (explicit)
+        return explicit;
+    // Fallback: detect from input fields
+    const ti = getToolInput(input);
+    if (ti.skill)
+        return 'Skill';
+    if (ti.subagent_type)
+        return 'Task';
+    return '';
+}
+function extractPlugin(skillName) {
+    if (!skillName.includes(':'))
+        return 'specweave';
+    const prefix = skillName.split(':')[0];
+    return prefix === 'sw' ? 'specweave' : prefix;
+}
+export const handle = async (input, context) => {
+    const toolName = resolveToolName(input);
+    const ti = getToolInput(input);
+    if (toolName === 'Skill') {
+        const skillName = (ti.skill ?? '');
+        if (!skillName)
+            return CONTINUE;
+        const plugin = extractPlugin(skillName);
+        const event = {
+            type: 'skill',
+            name: skillName,
+            plugin,
+            timestamp: context.timestamp,
+        };
+        appendEvent(context.stateDir, event);
+        return CONTINUE;
+    }
+    if (toolName === 'Task') {
+        const agentType = (ti.subagent_type ?? 'general');
+        const event = {
+            type: 'agent',
+            name: agentType,
+            plugin: 'specweave',
+            timestamp: context.timestamp,
+        };
+        appendEvent(context.stateDir, event);
+        return CONTINUE;
+    }
+    return CONTINUE;
+};
+function appendEvent(stateDir, event) {
+    try {
+        const analyticsDir = path.join(stateDir, 'analytics');
+        fs.mkdirSync(analyticsDir, { recursive: true });
+        fs.appendFileSync(path.join(analyticsDir, 'events.jsonl'), JSON.stringify(event) + '\n');
+    }
+    catch {
+        // Never throw from analytics
+    }
+}
+//# sourceMappingURL=post-tool-use-analytics.js.map

package/dist/src/core/hooks/handlers/post-tool-use-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool-use-analytics.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/post-tool-use-analytics.ts"],"names":[],"mappings":"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"}

package/dist/src/core/hooks/handlers/post-tool-use.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PostToolUse hook handler — non-blocking event detector and queue writer.
+ *
+ * Detects changes to increment files and queues events to pending.jsonl
+ * for later processing by stop-sync.
+ *
+ * @module core/hooks/handlers/post-tool-use
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=post-tool-use.d.ts.map

package/dist/src/core/hooks/handlers/post-tool-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool-use.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/post-tool-use.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AA2CvD,eAAO,MAAM,MAAM,EAAE,SA+CpB,CAAC"}

package/dist/src/core/hooks/handlers/post-tool-use.js

@@ -0,0 +1,76 @@
+/**
+ * PostToolUse hook handler — non-blocking event detector and queue writer.
+ *
+ * Detects changes to increment files and queues events to pending.jsonl
+ * for later processing by stop-sync.
+ *
+ * @module core/hooks/handlers/post-tool-use
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const CONTINUE = { continue: true };
+function getToolInput(input) {
+    return (input.tool_input ?? input.toolInput ?? {});
+}
+function getFilePath(input) {
+    const ti = getToolInput(input);
+    return (ti.file_path ?? '');
+}
+function extractIncrementId(filePath) {
+    const match = filePath.match(/(\d{4}-[^/]+)/);
+    return match ? match[1] : null;
+}
+function queueEvent(stateDir, event, incrementId, timestamp, data) {
+    try {
+        const queueDir = path.join(stateDir, 'event-queue');
+        fs.mkdirSync(queueDir, { recursive: true });
+        const entry = {
+            event,
+            incrementId,
+            timestamp,
+            ...(data ? { data } : {}),
+        };
+        fs.appendFileSync(path.join(queueDir, 'pending.jsonl'), JSON.stringify(entry) + '\n');
+    }
+    catch {
+        // Never throw from event queuing
+    }
+}
+export const handle = async (input, context) => {
+    const filePath = getFilePath(input);
+    // Ignore non-increment files
+    if (!filePath.includes('.specweave/increments/')) {
+        return CONTINUE;
+    }
+    const incrementId = extractIncrementId(filePath);
+    if (!incrementId)
+        return CONTINUE;
+    const basename = path.basename(filePath);
+    // metadata.json → detect status changes
+    if (basename === 'metadata.json') {
+        try {
+            if (fs.existsSync(filePath)) {
+                const raw = fs.readFileSync(filePath, 'utf-8');
+                const meta = JSON.parse(raw);
+                const status = meta.status ?? 'unknown';
+                queueEvent(context.stateDir, 'increment.status_changed', incrementId, context.timestamp, { field: 'status', value: status });
+            }
+        }
+        catch {
+            // Read failure — skip silently
+        }
+        return CONTINUE;
+    }
+    // tasks.md → queue task.updated
+    if (basename === 'tasks.md') {
+        queueEvent(context.stateDir, 'task.updated', incrementId, context.timestamp);
+        return CONTINUE;
+    }
+    // spec.md → queue spec.updated
+    if (basename === 'spec.md') {
+        queueEvent(context.stateDir, 'spec.updated', incrementId, context.timestamp);
+        return CONTINUE;
+    }
+    return CONTINUE;
+};
+//# sourceMappingURL=post-tool-use.js.map

package/dist/src/core/hooks/handlers/post-tool-use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool-use.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/post-tool-use.ts"],"names":[],"mappings":"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"}

package/dist/src/core/hooks/handlers/pre-compact.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pre-compact hook handler — context pressure signal.
+ *
+ * Fires when Claude Code approaches context limits (before compaction).
+ * Tracks compaction count, escalates pressure level, writes health alerts.
+ *
+ * Escalation: 1st=elevated, 2nd=critical, 3+=emergency
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=pre-compact.d.ts.map

package/dist/src/core/hooks/handlers/pre-compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-compact.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/pre-compact.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqC5C,eAAO,MAAM,MAAM,EAAE,SA0CpB,CAAC"}

package/dist/src/core/hooks/handlers/pre-compact.js

@@ -0,0 +1,77 @@
+/**
+ * Pre-compact hook handler — context pressure signal.
+ *
+ * Fires when Claude Code approaches context limits (before compaction).
+ * Tracks compaction count, escalates pressure level, writes health alerts.
+ *
+ * Escalation: 1st=elevated, 2nd=critical, 3+=emergency
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+function readPressure(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const data = JSON.parse(raw);
+        return typeof data.compactionCount === 'number' ? data.compactionCount : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function getLevel(count) {
+    if (count >= 3)
+        return 'emergency';
+    if (count >= 2)
+        return 'critical';
+    return 'elevated';
+}
+function getAdvice(level) {
+    switch (level) {
+        case 'elevated':
+            return 'Context budget reduced to compact. Session is running long.';
+        case 'critical':
+            return 'Context budget at minimal. Consider starting a new session or setting contextBudget.level to off.';
+        case 'emergency':
+            return 'Context budget stripped to off (3+ compactions). Strongly recommend starting a new session.';
+        default:
+            return '';
+    }
+}
+export const handle = async (_input, context) => {
+    if (process.env.SPECWEAVE_DISABLE_HOOKS === '1') {
+        return { continue: true };
+    }
+    const { stateDir, logsDir, timestamp } = context;
+    fs.mkdirSync(stateDir, { recursive: true });
+    const pressurePath = path.join(stateDir, 'context-pressure.json');
+    const prevCount = readPressure(pressurePath);
+    const newCount = prevCount + 1;
+    const level = getLevel(newCount);
+    const advice = getAdvice(level);
+    // Write context-pressure.json
+    const pressure = {
+        level,
+        compactionCount: newCount,
+        lastCompaction: timestamp,
+    };
+    fs.writeFileSync(pressurePath, JSON.stringify(pressure));
+    // Write prompt-health-alert.json
+    const alertPath = path.join(stateDir, 'prompt-health-alert.json');
+    fs.writeFileSync(alertPath, JSON.stringify({
+        level,
+        compactionCount: newCount,
+        advice,
+        timestamp,
+    }));
+    // Log compaction event
+    try {
+        fs.mkdirSync(logsDir, { recursive: true });
+        const logEntry = `[${timestamp}] COMPACTION #${newCount} | level=${level} | ${advice}\n`;
+        fs.appendFileSync(path.join(logsDir, 'prompt-health.log'), logEntry);
+    }
+    catch {
+        // Never throw from logging
+    }
+    return { continue: true };
+};
+//# sourceMappingURL=pre-compact.js.map

package/dist/src/core/hooks/handlers/pre-compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-compact.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/pre-compact.ts"],"names":[],"mappings":"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"}

package/dist/src/core/hooks/handlers/pre-tool-use.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PreToolUse hook handler — inlines all guard logic:
+ * 1. Status Completion Guard (Edit metadata.json → "completed")
+ * 2. Interview Enforcement Guard (Write spec.md with strict interview)
+ * 3. Increment Existence Guard (TeamCreate without valid spec)
+ *
+ * @module core/hooks/handlers/pre-tool-use
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=pre-tool-use.d.ts.map

package/dist/src/core/hooks/handlers/pre-tool-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool-use.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/pre-tool-use.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAA0B,MAAM,YAAY,CAAC;AA0UpE,eAAO,MAAM,MAAM,EAAE,SA0BpB,CAAC"}