specweave 1.0.550 → 1.0.552

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

@@ -0,0 +1,318 @@
+/**
+ * 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 * as fs from 'fs';
+import * as path from 'path';
+const ALLOW = { decision: 'allow' };
+const TEMPLATE_MARKERS = [
+    '[Story Title]',
+    '[user type]',
+    '[goal]',
+    '[benefit]',
+    '[Specific, testable criterion]',
+    '[Component 1]',
+    '[High-level description',
+    '{{RESOLVED_PROJECT}}',
+    'TEMPLATE FILE',
+];
+const DEFAULT_INTERVIEW_CATEGORIES = [
+    'architecture',
+    'integrations',
+    'ui-ux',
+    'performance',
+    'security',
+    'edge-cases',
+];
+const NON_IMPL_PREFIXES = [
+    'review-',
+    'brainstorm-',
+    'analysis-',
+    'audit-',
+    'explore-',
+    'ideate-',
+    'research-',
+    'plan-',
+];
+const NON_IMPL_KEYWORDS = [
+    'review',
+    'brainstorm',
+    'analyze',
+    'audit',
+    'explore',
+    'ideate',
+    'pull request',
+    'pr #',
+    'pr review',
+    'code review',
+    'architecture review',
+    'security audit',
+    'performance audit',
+    'code audit',
+    'ideation',
+    'exploration',
+    'research',
+    'planning',
+    'perspectives',
+    "devil's advocate",
+    'pros and cons',
+];
+function getToolName(input) {
+    return (input.tool_name ?? input.toolName ?? '');
+}
+function getToolInput(input) {
+    return (input.tool_input ?? input.toolInput ?? {});
+}
+function getFilePath(input) {
+    const ti = getToolInput(input);
+    return (ti.file_path ?? '');
+}
+function isIncrementFile(filePath) {
+    return filePath.includes('.specweave/increments/');
+}
+function extractIncrementId(filePath) {
+    const match = filePath.match(/(\d{4}[E]?-[^/]+)/);
+    return match ? match[1] : 'unknown';
+}
+function readJsonSafe(filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return {};
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+// ---------------------------------------------------------------------------
+// Guard: Status Completion (Edit metadata.json → "completed")
+// ---------------------------------------------------------------------------
+function checkStatusCompletionGuard(input, context) {
+    const ti = getToolInput(input);
+    const filePath = getFilePath(input);
+    const newString = (ti.new_string ?? '');
+    // Only care about metadata.json in increments
+    if (!filePath.match(/\.specweave\/increments\/.*\/metadata\.json$/)) {
+        return ALLOW;
+    }
+    // Check if setting status to "completed"
+    if (!/"status"\s*:\s*"completed"/.test(newString)) {
+        return ALLOW;
+    }
+    // Allow if sw-done marker exists
+    const doneMarker = path.join(context.stateDir, '.sw-done-in-progress');
+    if (fs.existsSync(doneMarker)) {
+        return ALLOW;
+    }
+    // Allow if auto-mode active with testsVerified
+    const autoSession = path.join(context.stateDir, 'auto', 'session.json');
+    if (fs.existsSync(autoSession)) {
+        const session = readJsonSafe(autoSession);
+        if (session.status === 'active' && session.testsVerified === true) {
+            return ALLOW;
+        }
+    }
+    const incrementId = extractIncrementId(filePath);
+    return {
+        decision: 'block',
+        reason: `Direct status change to 'completed' is blocked for ${incrementId}. Use /sw:done or /sw:auto instead.`,
+    };
+}
+// ---------------------------------------------------------------------------
+// Guard: Interview Enforcement (Write spec.md with strict interview)
+// ---------------------------------------------------------------------------
+function checkInterviewGuard(input, context) {
+    const filePath = getFilePath(input);
+    const ti = getToolInput(input);
+    const content = (ti.content ?? '');
+    // Only care about spec.md in increments
+    if (!filePath.match(/\.specweave\/increments\/\d{4}-[^/]+\/spec\.md$/)) {
+        return ALLOW;
+    }
+    // Allow template writes through
+    for (const marker of TEMPLATE_MARKERS) {
+        if (content.includes(marker)) {
+            return ALLOW;
+        }
+    }
+    // Read config to check if strict interview enabled
+    const config = readJsonSafe(context.configPath);
+    const planning = (config.planning ?? {});
+    const di = (planning.deepInterview ?? {});
+    if (di.enabled !== true || di.enforcement !== 'strict') {
+        return ALLOW;
+    }
+    const incrementId = extractIncrementId(filePath);
+    const categories = di.categories ?? DEFAULT_INTERVIEW_CATEGORIES;
+    // Check interview state file
+    const interviewState = path.join(context.stateDir, `interview-${incrementId}.json`);
+    if (!fs.existsSync(interviewState)) {
+        return {
+            decision: 'block',
+            reason: `Strict Interview Enforcement: Interview Required. Deep Interview has not been started for ${incrementId}. Start and cover all categories before writing spec.md.`,
+        };
+    }
+    // Check covered categories
+    const state = readJsonSafe(interviewState);
+    const covered = state.coveredCategories;
+    const coveredKeys = covered ? Object.keys(covered) : [];
+    const missing = categories.filter((c) => !coveredKeys.includes(c));
+    if (missing.length > 0) {
+        return {
+            decision: 'block',
+            reason: `Strict Interview Enforcement: Incomplete Interview for ${incrementId}. Missing categories: ${missing.join(', ')}`,
+        };
+    }
+    return ALLOW;
+}
+// ---------------------------------------------------------------------------
+// Guard: Increment Existence (TeamCreate without valid spec)
+// ---------------------------------------------------------------------------
+function isNonImplTeam(input) {
+    const ti = getToolInput(input);
+    const teamName = (ti.team_name ?? '').toLowerCase();
+    const description = (ti.description ?? '').toLowerCase();
+    // Check team name prefix
+    for (const prefix of NON_IMPL_PREFIXES) {
+        if (teamName.startsWith(prefix))
+            return true;
+    }
+    // Check description keywords
+    for (const keyword of NON_IMPL_KEYWORDS) {
+        if (description.includes(keyword))
+            return true;
+    }
+    return false;
+}
+function hasValidSpec(specPath) {
+    try {
+        if (!fs.existsSync(specPath))
+            return false;
+        const content = fs.readFileSync(specPath, 'utf-8');
+        // Min 500 bytes
+        if (Buffer.byteLength(content) <= 500)
+            return false;
+        // No template markers
+        for (const marker of TEMPLATE_MARKERS) {
+            if (content.includes(marker))
+                return false;
+        }
+        // No {{UPPERCASE}} mustache placeholders
+        if (/\{\{[A-Z_]+\}\}/.test(content))
+            return false;
+        // Must have at least one acceptance criterion
+        if (!/AC-US\d+-\d+|AC-\d+/.test(content))
+            return false;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function checkIncrementExistenceGuard(_input, context) {
+    // Env var bypass
+    if (process.env.SPECWEAVE_NO_INCREMENT === '1') {
+        return ALLOW;
+    }
+    // Scan increments for valid specs with active/in-progress status
+    const incDir = path.join(context.projectRoot, '.specweave', 'increments');
+    if (fs.existsSync(incDir)) {
+        try {
+            const entries = fs.readdirSync(incDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const specPath = path.join(incDir, entry.name, 'spec.md');
+                    if (!hasValidSpec(specPath))
+                        continue;
+                    // Check metadata.json for qualifying status
+                    const metaPath = path.join(incDir, entry.name, 'metadata.json');
+                    if (fs.existsSync(metaPath)) {
+                        try {
+                            const meta = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+                            const status = meta?.status ?? '';
+                            const qualifying = ['active', 'in-progress', 'ready_for_review', 'planned'];
+                            if (qualifying.includes(status))
+                                return ALLOW;
+                        }
+                        catch {
+                            // Unreadable metadata — skip this increment
+                        }
+                    }
+                    else {
+                        // No metadata.json but valid spec — allow (legacy increments)
+                        return ALLOW;
+                    }
+                }
+            }
+        }
+        catch {
+            // scan failure — don't block
+        }
+    }
+    // Scan multi-repo increments
+    const reposDir = path.join(context.projectRoot, 'repositories');
+    if (fs.existsSync(reposDir)) {
+        try {
+            const orgs = fs.readdirSync(reposDir, { withFileTypes: true });
+            for (const org of orgs) {
+                if (!org.isDirectory())
+                    continue;
+                const orgPath = path.join(reposDir, org.name);
+                const repos = fs.readdirSync(orgPath, { withFileTypes: true });
+                for (const repo of repos) {
+                    if (!repo.isDirectory())
+                        continue;
+                    const repoIncDir = path.join(orgPath, repo.name, '.specweave', 'increments');
+                    if (!fs.existsSync(repoIncDir))
+                        continue;
+                    const incs = fs.readdirSync(repoIncDir, { withFileTypes: true });
+                    for (const inc of incs) {
+                        if (inc.isDirectory()) {
+                            const specPath = path.join(repoIncDir, inc.name, 'spec.md');
+                            if (hasValidSpec(specPath))
+                                return ALLOW;
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // scan failure — don't block
+        }
+    }
+    return {
+        decision: 'block',
+        reason: 'Increment Required Before Team Creation. No qualifying increment with a valid spec.md found. Run /sw:increment first, or use a mode-prefixed team name (review-*, brainstorm-*, analysis-*, research-*) for non-implementation work.',
+    };
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export const handle = async (input, context) => {
+    const toolName = getToolName(input);
+    const filePath = getFilePath(input);
+    // Fast path: not targeting increment files AND not TeamCreate
+    if (!isIncrementFile(filePath) && toolName !== 'TeamCreate') {
+        return ALLOW;
+    }
+    // Edit guard: status completion
+    if (toolName === 'Edit') {
+        return checkStatusCompletionGuard(input, context);
+    }
+    // Write guard: interview enforcement
+    if (toolName === 'Write') {
+        return checkInterviewGuard(input, context);
+    }
+    // TeamCreate guard: increment existence
+    if (toolName === 'TeamCreate') {
+        if (isNonImplTeam(input))
+            return ALLOW;
+        return checkIncrementExistenceGuard(input, context);
+    }
+    return ALLOW;
+};
+//# sourceMappingURL=pre-tool-use.js.map

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

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

package/dist/src/core/hooks/handlers/session-start.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Session-start hook handler — session initialization.
+ *
+ * Clears stale auto-mode files, resets context pressure,
+ * and performs baseline prompt health check.
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=session-start.d.ts.map

package/dist/src/core/hooks/handlers/session-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/session-start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkC5C,eAAO,MAAM,MAAM,EAAE,SA6EpB,CAAC"}

package/dist/src/core/hooks/handlers/session-start.js

@@ -0,0 +1,111 @@
+/**
+ * Session-start hook handler — session initialization.
+ *
+ * Clears stale auto-mode files, resets context pressure,
+ * and performs baseline prompt health check.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const STALE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24 hours
+const WARNING_THRESHOLD = 80000;
+const CRITICAL_THRESHOLD = 120000;
+const SYSTEM_ESTIMATE = 12000;
+const SKILL_BUDGET = 15000;
+const HOOK_PER_TURN = 3000;
+function isStale(filePath) {
+    try {
+        const stat = fs.statSync(filePath);
+        return Date.now() - stat.mtimeMs > STALE_THRESHOLD_MS;
+    }
+    catch {
+        return false;
+    }
+}
+function safeRemove(filePath) {
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch {
+        // Ignore
+    }
+}
+function fileSize(filePath) {
+    try {
+        return fs.statSync(filePath).size;
+    }
+    catch {
+        return 0;
+    }
+}
+export const handle = async (_input, context) => {
+    const { projectRoot, stateDir, logsDir, timestamp } = context;
+    try {
+        fs.mkdirSync(stateDir, { recursive: true });
+    }
+    catch {
+        return { continue: true };
+    }
+    // --- Auto-mode cleanup: remove stale session files (>24h) ---
+    const autoFile = path.join(stateDir, 'auto-mode.json');
+    if (fs.existsSync(autoFile) && isStale(autoFile)) {
+        safeRemove(autoFile);
+        safeRemove(path.join(stateDir, '.stop-auto-dedup'));
+        safeRemove(path.join(stateDir, '.stop-auto-dedup-prev'));
+        safeRemove(path.join(stateDir, '.stop-auto-turns'));
+        try {
+            fs.mkdirSync(logsDir, { recursive: true });
+            fs.appendFileSync(path.join(logsDir, 'session.log'), `[${timestamp}] SessionStart: Cleared stale auto-mode session files (>24h)\n`);
+        }
+        catch {
+            // Never throw from logging
+        }
+    }
+    // --- Context pressure reset ---
+    safeRemove(path.join(stateDir, 'context-pressure.json'));
+    safeRemove(path.join(stateDir, 'prompt-health-alert.json'));
+    // --- Baseline health check ---
+    try {
+        const claudeMdSize = fileSize(path.join(projectRoot, 'CLAUDE.md'));
+        const memoryDir = path.join(projectRoot, '.claude', 'projects');
+        let memoryMdSize = 0;
+        try {
+            // Find MEMORY.md in any project subdirectory
+            if (fs.existsSync(memoryDir)) {
+                const entries = fs.readdirSync(memoryDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.isDirectory()) {
+                        const memPath = path.join(memoryDir, entry.name, 'memory', 'MEMORY.md');
+                        memoryMdSize += fileSize(memPath);
+                    }
+                }
+            }
+        }
+        catch {
+            // Best-effort
+        }
+        const baseline = claudeMdSize + memoryMdSize + SYSTEM_ESTIMATE + SKILL_BUDGET + HOOK_PER_TURN;
+        let warningLevel = 'normal';
+        if (baseline > CRITICAL_THRESHOLD) {
+            warningLevel = 'critical';
+        }
+        else if (baseline > WARNING_THRESHOLD) {
+            warningLevel = 'warning';
+        }
+        const health = {
+            baseline,
+            claudeMdSize,
+            memoryMdSize,
+            skillBudget: SKILL_BUDGET,
+            systemEstimate: SYSTEM_ESTIMATE,
+            hookPerTurn: HOOK_PER_TURN,
+            warningLevel,
+            checkedAt: timestamp,
+        };
+        fs.writeFileSync(path.join(stateDir, 'prompt-health.json'), JSON.stringify(health));
+    }
+    catch {
+        // Health check is best-effort
+    }
+    return { continue: true };
+};
+//# sourceMappingURL=session-start.js.map

package/dist/src/core/hooks/handlers/session-start.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Stop-auto hook handler.
+ *
+ * Fires when a session ends. Checks if an auto-mode session is active:
+ * 1. Look for auto-mode.json (per-session or global)
+ * 2. Check session staleness
+ * 3. Scan active increments for pending tasks
+ * 4. Include progress context but always approve
+ *
+ * Stop hooks should NEVER block session exit.
+ *
+ * @module core/hooks/handlers/stop-auto
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=stop-auto.d.ts.map

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

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

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

@@ -0,0 +1,122 @@
+/**
+ * Stop-auto hook handler.
+ *
+ * Fires when a session ends. Checks if an auto-mode session is active:
+ * 1. Look for auto-mode.json (per-session or global)
+ * 2. Check session staleness
+ * 3. Scan active increments for pending tasks
+ * 4. Include progress context but always approve
+ *
+ * Stop hooks should NEVER block session exit.
+ *
+ * @module core/hooks/handlers/stop-auto
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logHook } from './utils.js';
+/** Read JSON safely, return null on error */
+function readJsonSafe(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Get auto-mode session file path (per-session or global fallback) */
+function getSessionPath(stateDir) {
+    const sessionId = process.env.CLAUDE_SESSION_ID;
+    if (sessionId) {
+        const perSession = path.join(stateDir, 'sessions', sessionId, 'auto-mode.json');
+        if (fs.existsSync(perSession))
+            return perSession;
+    }
+    return path.join(stateDir, 'auto-mode.json');
+}
+/** Check if session file is stale (older than maxSessionAge seconds) */
+function isSessionStale(sessionPath, maxSessionAge) {
+    try {
+        const stat = fs.statSync(sessionPath);
+        const ageMs = Date.now() - stat.mtimeMs;
+        return ageMs > maxSessionAge * 1000;
+    }
+    catch {
+        return true;
+    }
+}
+/** Count pending tasks across active increments */
+function scanPendingTasks(projectRoot) {
+    const incDir = path.join(projectRoot, '.specweave', 'increments');
+    let pending = 0;
+    let completed = 0;
+    const incrementIds = [];
+    try {
+        if (!fs.existsSync(incDir))
+            return { pending, completed, incrementIds };
+        const dirs = fs.readdirSync(incDir);
+        for (const dir of dirs) {
+            const metaPath = path.join(incDir, dir, 'metadata.json');
+            if (!fs.existsSync(metaPath))
+                continue;
+            const meta = readJsonSafe(metaPath);
+            if (!meta || (meta.status !== 'active' && meta.status !== 'in-progress'))
+                continue;
+            const tasksPath = path.join(incDir, dir, 'tasks.md');
+            try {
+                const tasks = fs.readFileSync(tasksPath, 'utf8');
+                const p = (tasks.match(/\[ \]/g) || []).length;
+                const c = (tasks.match(/\[x\]/g) || []).length;
+                if (p > 0) {
+                    pending += p;
+                    completed += c;
+                    incrementIds.push(dir);
+                }
+            }
+            catch {
+                // No tasks file
+            }
+        }
+    }
+    catch {
+        // fs errors
+    }
+    return { pending, completed, incrementIds };
+}
+export const handle = async (input, context) => {
+    try {
+        // 1. Find auto-mode session file
+        const sessionPath = getSessionPath(context.stateDir);
+        if (!fs.existsSync(sessionPath)) {
+            logHook(context, 'stop-auto', 'No auto session');
+            return { decision: 'approve' };
+        }
+        // 2. Read session data
+        const session = readJsonSafe(sessionPath);
+        if (!session || session.active !== true) {
+            logHook(context, 'stop-auto', 'Session not active');
+            return { decision: 'approve' };
+        }
+        // 3. Read config for maxSessionAge
+        const config = readJsonSafe(context.configPath);
+        const maxSessionAge = config?.auto?.maxSessionAge ?? 7200;
+        // 4. Check staleness
+        if (isSessionStale(sessionPath, maxSessionAge)) {
+            logHook(context, 'stop-auto', 'Stale session — expired');
+            return { decision: 'approve' };
+        }
+        // 5. Scan active increments for pending tasks
+        const { pending, completed, incrementIds } = scanPendingTasks(context.projectRoot);
+        if (pending === 0) {
+            logHook(context, 'stop-auto', 'All tasks complete');
+            return { decision: 'approve' };
+        }
+        // 6. Pending tasks exist — include progress context but still approve
+        logHook(context, 'stop-auto', `Pending tasks: ${pending} across ${incrementIds.length} increment(s)`);
+        return { decision: 'approve' };
+    }
+    catch {
+        // Never throw — always approve
+        return { decision: 'approve' };
+    }
+};
+//# sourceMappingURL=stop-auto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop-auto.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,6CAA6C;AAC7C,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAChF,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,UAAU,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAC/C,CAAC;AAED,wEAAwE;AACxE,SAAS,cAAc,CAAC,WAAmB,EAAE,aAAqB;IAChE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACxC,OAAO,KAAK,GAAG,aAAa,GAAG,IAAI,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IAClE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;QAExE,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC;YACzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAEvC,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC;gBAAE,SAAS;YAEnF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACjD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC/C,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACV,OAAO,IAAI,CAAC,CAAC;oBACb,SAAS,IAAI,CAAC,CAAC;oBACf,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAc,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACxD,IAAI,CAAC;QACH,iCAAiC;QACjC,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;YACjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,uBAAuB;QACvB,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,oBAAoB,CAAC,CAAC;YACpD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,mCAAmC;QACnC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,aAAa,GAAG,MAAM,EAAE,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC;QAE1D,qBAAqB;QACrB,IAAI,cAAc,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,yBAAyB,CAAC,CAAC;YACzD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,8CAA8C;QAC9C,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAEnF,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,oBAAoB,CAAC,CAAC;YACpD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,sEAAsE;QACtE,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,kBAAkB,OAAO,WAAW,YAAY,CAAC,MAAM,eAAe,CAAC,CAAC;QACtG,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-reflect.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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 type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=stop-reflect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop-reflect.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-reflect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAe5C,eAAO,MAAM,MAAM,EAAE,SAgBpB,CAAC"}