specweave 1.0.550 → 1.0.552

package/dist/src/core/hooks/handlers/stop-reflect.js

@@ -0,0 +1,43 @@
+/**
+ * Stop-reflect hook handler.
+ *
+ * Fires when a session ends. Checks if reflection is enabled in config.
+ * If enabled, logs that reflection was requested (actual reflection logic
+ * will call `specweave reflect-stop` CLI in a follow-up).
+ *
+ * NEVER blocks — always returns approve.
+ *
+ * @module core/hooks/handlers/stop-reflect
+ */
+import * as fs from 'fs';
+import { logHook } from './utils.js';
+/** Check if reflect is enabled in config. Default: true */
+function isReflectEnabled(configPath) {
+    try {
+        if (!fs.existsSync(configPath))
+            return true;
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        // Note: explicit false check — missing key defaults to enabled
+        return config.reflect?.enabled !== false;
+    }
+    catch {
+        return true; // Default enabled on error
+    }
+}
+export const handle = async (input, context) => {
+    try {
+        const enabled = isReflectEnabled(context.configPath);
+        if (!enabled) {
+            logHook(context, 'stop-reflect', 'Reflection disabled in config');
+            return { decision: 'approve' };
+        }
+        // Reflection is enabled — log intent
+        logHook(context, 'stop-reflect', 'Reflection requested at session end');
+        return { decision: 'approve' };
+    }
+    catch {
+        // Never throw — always approve
+        return { decision: 'approve' };
+    }
+};
+//# sourceMappingURL=stop-reflect.js.map

package/dist/src/core/hooks/handlers/stop-reflect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-reflect.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-reflect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,2DAA2D;AAC3D,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,+DAA+D;QAC/D,OAAO,MAAM,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,2BAA2B;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAc,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAErD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,+BAA+B,CAAC,CAAC;YAClE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,qCAAqC;QACrC,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,qCAAqC,CAAC,CAAC;QACxE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;QAC/B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;AACH,CAAC,CAAC"}

package/dist/src/core/hooks/handlers/stop-sync.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Stop-sync hook handler.
+ *
+ * Fires at session end (after stop-reflect and stop-auto). Reads pending
+ * sync events, deduplicates by increment ID, logs sync intent, and clears
+ * the event queue. Actual sync calls (LivingDocsSync, GitHub/JIRA/ADO)
+ * will be added in a follow-up.
+ *
+ * NEVER blocks — always returns approve.
+ *
+ * @module core/hooks/handlers/stop-sync
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=stop-sync.d.ts.map

package/dist/src/core/hooks/handlers/stop-sync.d.ts.map

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

package/dist/src/core/hooks/handlers/stop-sync.js

@@ -0,0 +1,68 @@
+/**
+ * Stop-sync hook handler.
+ *
+ * Fires at session end (after stop-reflect and stop-auto). Reads pending
+ * sync events, deduplicates by increment ID, logs sync intent, and clears
+ * the event queue. Actual sync calls (LivingDocsSync, GitHub/JIRA/ADO)
+ * will be added in a follow-up.
+ *
+ * NEVER blocks — always returns approve.
+ *
+ * @module core/hooks/handlers/stop-sync
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logHook } from './utils.js';
+/** Parse a JSONL line safely */
+function parseEventLine(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+}
+export const handle = async (input, context) => {
+    try {
+        const pendingPath = path.join(context.stateDir, 'event-queue', 'pending.jsonl');
+        // 1. Check if pending events exist
+        if (!fs.existsSync(pendingPath)) {
+            logHook(context, 'stop-sync', 'No pending events');
+            return { decision: 'approve' };
+        }
+        const content = fs.readFileSync(pendingPath, 'utf8').trim();
+        if (!content) {
+            logHook(context, 'stop-sync', 'No pending events');
+            return { decision: 'approve' };
+        }
+        // 2. Parse and deduplicate events by increment ID
+        const lines = content.split('\n').filter((l) => l.trim());
+        const seenIncrements = new Set();
+        for (const line of lines) {
+            const event = parseEventLine(line);
+            if (!event?.incrementId)
+                continue;
+            const incId = event.incrementId;
+            if (seenIncrements.has(incId))
+                continue;
+            seenIncrements.add(incId);
+            logHook(context, 'stop-sync', `Sync requested for increment: ${incId} (event: ${event.event ?? 'unknown'})`);
+        }
+        // 3. Clear processed events
+        try {
+            fs.writeFileSync(pendingPath, '');
+        }
+        catch {
+            // Non-critical — events may be re-processed next time
+        }
+        if (seenIncrements.size > 0) {
+            logHook(context, 'stop-sync', `Processed ${seenIncrements.size} unique increment(s)`);
+        }
+        return { decision: 'approve' };
+    }
+    catch {
+        // Never throw — always approve
+        return { decision: 'approve' };
+    }
+};
+//# sourceMappingURL=stop-sync.js.map

package/dist/src/core/hooks/handlers/stop-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-sync.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAUrC,gCAAgC;AAChC,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAc,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;QAEhF,mCAAmC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,kDAAkD;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,EAAE,WAAW;gBAAE,SAAS;YAElC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC;YAChC,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAExC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1B,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,iCAAiC,KAAK,YAAY,KAAK,CAAC,KAAK,IAAI,SAAS,GAAG,CAAC,CAAC;QAC/G,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;QAED,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,cAAc,CAAC,IAAI,sBAAsB,CAAC,CAAC;QACxF,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;QAC/B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,63 @@
+/**
+ * Hook handler types for CLI delegation model.
+ *
+ * All hook handlers share this contract:
+ * - Read JSON from stdin (HookInput)
+ * - Return JSON to stdout (HookResult)
+ * - Never throw — errors become safe fallback responses
+ *
+ * @module core/hooks/handlers/types
+ */
+/** Raw JSON input from Claude Code hook protocol */
+export interface HookInput {
+    /** Tool name (PreToolUse/PostToolUse) */
+    tool_name?: string;
+    toolName?: string;
+    /** Tool input parameters */
+    tool_input?: Record<string, unknown>;
+    toolInput?: Record<string, unknown>;
+    /** User prompt text (UserPromptSubmit) */
+    prompt?: string;
+    /** Session transcript (Stop hooks) */
+    transcript?: string;
+    /** Catch-all for additional fields */
+    [key: string]: unknown;
+}
+/** JSON output to Claude Code hook protocol */
+export interface HookResult {
+    /** Decision for guard/prompt/stop hooks */
+    decision?: 'approve' | 'block' | 'allow';
+    /** Continuation signal for session/compact/post-tool hooks */
+    continue?: boolean;
+    /** Reason for blocking */
+    reason?: string;
+    /** Hook-specific output for context injection */
+    hookSpecificOutput?: {
+        hookEventName?: string;
+        additionalContext?: string;
+    };
+    /** Catch-all for additional fields */
+    [key: string]: unknown;
+}
+/** Context resolved by the router before handler execution */
+export interface HookContext {
+    /** Absolute path to project root (contains .specweave/) */
+    projectRoot: string;
+    /** Path to .specweave/state/ directory */
+    stateDir: string;
+    /** Path to .specweave/logs/ directory */
+    logsDir: string;
+    /** Path to .specweave/config.json */
+    configPath: string;
+    /** ISO timestamp of hook invocation */
+    timestamp: string;
+}
+/** Handler function signature — every handler exports a `handle` matching this */
+export type HandlerFn = (input: HookInput, context: HookContext) => Promise<HookResult>;
+/** Event types supported by the hook router */
+export type HookEventType = 'user-prompt-submit' | 'pre-tool-use' | 'post-tool-use' | 'post-tool-use-analytics' | 'session-start' | 'pre-compact' | 'stop-reflect' | 'stop-auto' | 'stop-sync';
+/** Map of event types to their safe fallback responses */
+export declare const SAFE_DEFAULTS: Record<string, HookResult>;
+/** Get safe default response for an event type */
+export declare function getSafeDefault(eventType: string): HookResult;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,sCAAsC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,cAAc,GACd,eAAe,GACf,yBAAyB,GACzB,eAAe,GACf,aAAa,GACb,cAAc,GACd,WAAW,GACX,WAAW,CAAC;AAEhB,0DAA0D;AAC1D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAUpD,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAE5D"}

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

@@ -0,0 +1,27 @@
+/**
+ * Hook handler types for CLI delegation model.
+ *
+ * All hook handlers share this contract:
+ * - Read JSON from stdin (HookInput)
+ * - Return JSON to stdout (HookResult)
+ * - Never throw — errors become safe fallback responses
+ *
+ * @module core/hooks/handlers/types
+ */
+/** Map of event types to their safe fallback responses */
+export const SAFE_DEFAULTS = {
+    'user-prompt-submit': { decision: 'approve' },
+    'pre-tool-use': { decision: 'allow' },
+    'post-tool-use': { continue: true },
+    'post-tool-use-analytics': { continue: true },
+    'session-start': { continue: true },
+    'pre-compact': { continue: true },
+    'stop-reflect': { decision: 'approve' },
+    'stop-auto': { decision: 'approve' },
+    'stop-sync': { decision: 'approve' },
+};
+/** Get safe default response for an event type */
+export function getSafeDefault(eventType) {
+    return SAFE_DEFAULTS[eventType] ?? { continue: true };
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmEH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAA+B;IACvD,oBAAoB,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE;IAC7C,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;IACrC,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;IACnC,yBAAyB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC7C,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;IACnC,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjC,cAAc,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE;IACvC,WAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE;IACpC,WAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE;CACrC,CAAC;AAEF,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC"}

package/dist/src/core/hooks/handlers/user-prompt-submit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * UserPromptSubmit hook handler.
+ *
+ * Fires before the user's prompt is processed. Responsibilities:
+ * 1. Fast-path approve for built-in Claude Code commands
+ * 2. Fast-path approve for /sw: and /sw- commands
+ * 3. Block SW skill invocations in non-initialized projects (scope guard)
+ * 4. Inject active increment context + TDD mode info
+ *
+ * @module core/hooks/handlers/user-prompt-submit
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=user-prompt-submit.d.ts.map

package/dist/src/core/hooks/handlers/user-prompt-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-prompt-submit.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/user-prompt-submit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AAsHxD,eAAO,MAAM,MAAM,EAAE,SAmDpB,CAAC"}

package/dist/src/core/hooks/handlers/user-prompt-submit.js

@@ -0,0 +1,173 @@
+/**
+ * UserPromptSubmit hook handler.
+ *
+ * Fires before the user's prompt is processed. Responsibilities:
+ * 1. Fast-path approve for built-in Claude Code commands
+ * 2. Fast-path approve for /sw: and /sw- commands
+ * 3. Block SW skill invocations in non-initialized projects (scope guard)
+ * 4. Inject active increment context + TDD mode info
+ *
+ * @module core/hooks/handlers/user-prompt-submit
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logHook } from './utils.js';
+/** Built-in Claude Code commands that should bypass all SpecWeave processing */
+const BUILTIN_COMMANDS = [
+    '/help', '/clear', '/config', '/status', '/context', '/compact', '/cost',
+    '/memory', '/permissions', '/doctor', '/login', '/logout',
+];
+/** Strip IDE metadata tags from prompt (VSCode injects these) */
+function stripIdeMetadata(prompt) {
+    return prompt.replace(/.*<\/ide_[a-z_]*>/g, '').trimStart();
+}
+/** Check if prompt starts with a built-in Claude Code command */
+function isBuiltinCommand(prompt) {
+    const clean = stripIdeMetadata(prompt).toLowerCase();
+    // Match /command at start, followed by end-of-string or whitespace
+    const match = clean.match(/^\/([a-z][a-z0-9_-]*)/);
+    if (!match)
+        return false;
+    const cmd = '/' + match[1];
+    // If it's a /sw: or /sw- command, it's NOT a built-in
+    if (/^\/sw[-:]/.test(cmd))
+        return false;
+    return BUILTIN_COMMANDS.some((b) => cmd === b) ||
+        // Any slash command that isn't /sw: is treated as built-in
+        !cmd.startsWith('/sw');
+}
+/** Check if prompt is a SpecWeave command (/sw: or /sw-*:) */
+function isSwCommand(prompt) {
+    const clean = stripIdeMetadata(prompt).trimStart().toLowerCase();
+    return /^\/sw(-[a-z0-9-]+)?:/.test(clean);
+}
+/** Check if prompt invokes a SpecWeave skill (SW commands + domain plugins) */
+function isSwSkillInvocation(prompt) {
+    const clean = stripIdeMetadata(prompt).trimStart().toLowerCase();
+    if (/^\/sw(-[a-z0-9-]+)?:/.test(clean))
+        return true;
+    const DOMAINS = ['frontend', 'backend', 'testing', 'mobile', 'infra', 'k8s', 'ml', 'payments', 'kafka', 'confluent', 'cost', 'docs', 'security', 'skills', 'blockchain'];
+    const match = clean.match(/^\/([a-z0-9-]+):/);
+    return match !== null && DOMAINS.includes(match[1]);
+}
+/** Read and parse JSON config file, returns null on any error */
+function readJsonSafe(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Build context string from active increments */
+function buildIncrementContext(projectRoot) {
+    const incDir = path.join(projectRoot, '.specweave', 'increments');
+    if (!fs.existsSync(incDir))
+        return '';
+    const parts = [];
+    let dirs;
+    try {
+        dirs = fs.readdirSync(incDir);
+    }
+    catch {
+        return '';
+    }
+    for (const dir of dirs) {
+        const metaPath = path.join(incDir, dir, 'metadata.json');
+        if (!fs.existsSync(metaPath))
+            continue;
+        const meta = readJsonSafe(metaPath);
+        if (!meta)
+            continue;
+        if (meta.status !== 'active' && meta.status !== 'in-progress')
+            continue;
+        const tasksPath = path.join(incDir, dir, 'tasks.md');
+        let pending = 0;
+        let completed = 0;
+        try {
+            const tasks = fs.readFileSync(tasksPath, 'utf8');
+            pending = (tasks.match(/\[ \]/g) || []).length;
+            completed = (tasks.match(/\[x\]/g) || []).length;
+        }
+        catch {
+            // No tasks file
+        }
+        parts.push(`Active increment: ${dir} (${completed}/${completed + pending} tasks done)`);
+    }
+    return parts.join('\n');
+}
+/** Build TDD context string from config */
+function buildTddContext(projectRoot) {
+    const configPath = path.join(projectRoot, '.specweave', 'config.json');
+    const config = readJsonSafe(configPath);
+    if (!config)
+        return '';
+    const testMode = config.testing?.defaultTestMode;
+    if (!testMode || (testMode !== 'TDD' && testMode !== 'tdd'))
+        return '';
+    const enforcement = config.testing?.tddEnforcement ?? 'warn';
+    if (enforcement === 'strict') {
+        return 'STRICT TDD ACTIVE. RED->GREEN->REFACTOR enforced. No implementation before failing test. Use /sw:tdd-cycle.';
+    }
+    return 'TDD MODE ACTIVE. RED->GREEN->REFACTOR discipline. Use /sw:tdd-cycle.';
+}
+/** Create approve result with optional context injection */
+function approveWithContext(context) {
+    if (!context)
+        return { decision: 'approve' };
+    return {
+        decision: 'approve',
+        hookSpecificOutput: {
+            hookEventName: 'UserPromptSubmit',
+            additionalContext: context,
+        },
+    };
+}
+export const handle = async (input, context) => {
+    try {
+        const prompt = input.prompt ?? '';
+        // Empty prompt — approve
+        if (!prompt.trim()) {
+            return { decision: 'approve' };
+        }
+        // 1. Built-in command fast-path (no SpecWeave processing)
+        if (isBuiltinCommand(prompt)) {
+            return { decision: 'approve' };
+        }
+        // 2. Project scope guard — block SW skills in non-initialized projects
+        if (isSwSkillInvocation(prompt)) {
+            if (process.env.SPECWEAVE_DISABLE_GUARD !== '1') {
+                const configExists = fs.existsSync(context.configPath);
+                if (!configExists) {
+                    logHook(context, 'user-prompt-submit', `Blocked: project not initialized`);
+                    return {
+                        decision: 'block',
+                        reason: 'SpecWeave Not Initialized. Run `specweave init` to initialize this project.',
+                    };
+                }
+            }
+            // SW commands are approved (SpecWeave handles them via skills)
+            return { decision: 'approve' };
+        }
+        // 3. Context injection for regular prompts
+        const contextParts = [];
+        // Active increment context
+        const incCtx = buildIncrementContext(context.projectRoot);
+        if (incCtx)
+            contextParts.push(incCtx);
+        // TDD mode context
+        const tddCtx = buildTddContext(context.projectRoot);
+        if (tddCtx)
+            contextParts.push(tddCtx);
+        const combined = contextParts.join('\n');
+        if (combined) {
+            logHook(context, 'user-prompt-submit', 'Injecting context');
+        }
+        return approveWithContext(combined || undefined);
+    }
+    catch (err) {
+        // Never throw — return safe default
+        return { decision: 'approve' };
+    }
+};
+//# sourceMappingURL=user-prompt-submit.js.map

package/dist/src/core/hooks/handlers/user-prompt-submit.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Shared utilities for hook handlers.
+ *
+ * @module core/hooks/handlers/utils
+ */
+import type { HookContext, HookInput } from './types.js';
+/**
+ * Walk up from `startDir` to find the nearest directory containing `.specweave/config.json`.
+ * Returns the project root path, or null if not found.
+ */
+export declare function findProjectRoot(startDir?: string): string | null;
+/**
+ * Build a HookContext from a project root path.
+ */
+export declare function createContext(projectRoot: string): HookContext;
+/**
+ * Parse a raw stdin string as JSON. Returns empty object on failure.
+ */
+export declare function parseStdinJson(raw: string): HookInput;
+/**
+ * Append a log entry to `.specweave/logs/hooks.log`.
+ * Never throws — logging failures are silently ignored.
+ */
+export declare function logHook(context: HookContext, handler: string, message: string): void;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAahE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAQ9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAOrD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,IAAI,CAQN"}

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

@@ -0,0 +1,64 @@
+/**
+ * Shared utilities for hook handlers.
+ *
+ * @module core/hooks/handlers/utils
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Walk up from `startDir` to find the nearest directory containing `.specweave/config.json`.
+ * Returns the project root path, or null if not found.
+ */
+export function findProjectRoot(startDir) {
+    let current = startDir ?? process.cwd();
+    const root = path.parse(current).root;
+    let limit = 0;
+    while (current !== root && limit < 100) {
+        if (fs.existsSync(path.join(current, '.specweave', 'config.json'))) {
+            return current;
+        }
+        current = path.dirname(current);
+        limit++;
+    }
+    return null;
+}
+/**
+ * Build a HookContext from a project root path.
+ */
+export function createContext(projectRoot) {
+    return {
+        projectRoot,
+        stateDir: path.join(projectRoot, '.specweave', 'state'),
+        logsDir: path.join(projectRoot, '.specweave', 'logs'),
+        configPath: path.join(projectRoot, '.specweave', 'config.json'),
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Parse a raw stdin string as JSON. Returns empty object on failure.
+ */
+export function parseStdinJson(raw) {
+    if (!raw || !raw.trim())
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Append a log entry to `.specweave/logs/hooks.log`.
+ * Never throws — logging failures are silently ignored.
+ */
+export function logHook(context, handler, message) {
+    try {
+        fs.mkdirSync(context.logsDir, { recursive: true });
+        const entry = `[${context.timestamp}] ${handler}: ${message}\n`;
+        fs.appendFileSync(path.join(context.logsDir, 'hooks.log'), entry);
+    }
+    catch {
+        // Never throw from logging
+    }
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,IAAI,OAAO,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,OAAO,KAAK,IAAI,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QACvC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;YACnE,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,KAAK,EAAE,CAAC;IACV,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO;QACL,WAAW;QACX,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC;QACvD,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC;QACrD,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC;QAC/D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,OAAoB,EACpB,OAAe,EACf,OAAe;IAEf,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,SAAS,KAAK,OAAO,KAAK,OAAO,IAAI,CAAC;QAChE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;AACH,CAAC"}

package/dist/src/core/increment/completion-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion-validator.d.ts","sourceRoot":"","sources":["../../../../src/core/increment/completion-validator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAMpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,4BAA4B;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;WACU,kBAAkB,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAO,GAC5D,OAAO,CAAC,gBAAgB,CAAC;IAuM5B;;;;;;;;;;;;;;;OAeG;mBACkB,0BAA0B;IA4G/C;;;;;;;;;;;OAWG;mBACkB,kBAAkB;IAoEvC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAiDtC;;;;;;;OAOG;WACU,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa/D;;;;;;;OAOG;WACU,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAarE"}
+{"version":3,"file":"completion-validator.d.ts","sourceRoot":"","sources":["../../../../src/core/increment/completion-validator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAMpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,4BAA4B;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;WACU,kBAAkB,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAO,GAC5D,OAAO,CAAC,gBAAgB,CAAC;IAuM5B;;;;;;;;;;;;;;;OAeG;mBACkB,0BAA0B;IAgJ/C;;;;;;;;;;;OAWG;mBACkB,kBAAkB;IAoEvC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAiDtC;;;;;;;OAOG;WACU,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa/D;;;;;;;OAOG;WACU,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAarE"}

package/dist/src/core/increment/completion-validator.js

@@ -240,6 +240,7 @@ export class IncrementCompletionValidator {
         // Check if quality gates are globally disabled via auto config
         let skipAll = false;
         let grillRequired = true;
+        let codeReviewRequired = true;
         try {
             const configPath = path.join(resolveEffectiveRoot(), '.specweave', 'config.json');
             if (await fs.pathExists(configPath)) {
@@ -250,6 +251,9 @@ export class IncrementCompletionValidator {
                 if (config.grill?.required === false) {
                     grillRequired = false;
                 }
+                if (config.codeReview?.required === false) {
+                    codeReviewRequired = false;
+                }
             }
         }
         catch {
@@ -324,6 +328,34 @@ export class IncrementCompletionValidator {
             warnings.push('Quality gate: judge-llm-report.json not found.\n' +
                 '    Consider running sw:judge-llm for independent validation.');
         }
+        // --- Code-review report validation (v1.0.646) ---
+        if (codeReviewRequired) {
+            const codeReviewReportPath = path.join(reportsDir, 'code-review-report.json');
+            if (!(await fs.pathExists(codeReviewReportPath))) {
+                errors.push('Quality gate: code-review-report.json not found.\n' +
+                    `    Run sw:code-reviewer --increment ${incrementId} before closing, or set "codeReview": { "required": false } in config.json.\n` +
+                    `    The report is written to .specweave/increments/${incrementId}/reports/code-review-report.json`);
+            }
+            else {
+                try {
+                    const report = JSON.parse(await fs.readFile(codeReviewReportPath, 'utf-8'));
+                    const summary = report.summary ?? {};
+                    const blockingSeverities = ['critical', 'high', 'medium'];
+                    const blockingCount = blockingSeverities.reduce((acc, sev) => acc + (summary[sev] ?? 0), 0);
+                    if (blockingCount > 0) {
+                        errors.push(`Quality gate: code-review report has ${blockingCount} blocking findings ` +
+                            `(${summary.critical ?? 0} critical, ${summary.high ?? 0} high, ${summary.medium ?? 0} medium).\n` +
+                            `    Fix issues and re-run sw:code-reviewer --increment ${incrementId}.`);
+                    }
+                }
+                catch {
+                    warnings.push('Quality gate: code-review-report.json exists but could not be parsed.');
+                }
+            }
+        }
+        else {
+            logger.info('Quality gate reports: code-review report not required (codeReview.required=false)');
+        }
         return { errors, warnings };
     }
     /**