specweave 1.0.593 → 2.0.3

package/dist/src/core/hooks/pretooluse-guard.js

@@ -1,64 +0,0 @@
-/**
- * PreToolUse skill-chain state guard (0669 Wave 3 / AC-US5-03).
- *
- * Replaces the prior filesystem-marker-only implementation with a dual-read
- * strategy that prefers TaskGet-based state and falls back to legacy
- * `.specweave/state/skill-chain-*.json` markers for one release (NFR-1.2).
- *
- * @module core/hooks/pretooluse-guard
- */
-import * as fs from 'fs';
-import * as path from 'path';
-/**
- * Safely read a skill-chain JSON marker from the filesystem.
- * Tolerates missing files, malformed JSON, and IO errors (NFR-1.2).
- */
-function readFilesystemMarker(stateDir, incrementId) {
-    if (!incrementId)
-        return null;
-    const markerPath = path.join(stateDir, `skill-chain-${incrementId}.json`);
-    try {
-        if (!fs.existsSync(markerPath))
-            return null;
-        const raw = fs.readFileSync(markerPath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        return parsed;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Invoke the TaskGet-based state provider. Swallows provider errors and
- * treats them as "no state", enabling the filesystem fallback path.
- */
-async function safeGetTaskState(provider, incrementId) {
-    if (!provider)
-        return null;
-    try {
-        return await provider(incrementId);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Determine the skill-chain state for the current increment.
- *
- * Resolution order:
- *   1. TaskGet-based state (primary source).
- *   2. Filesystem `skill-chain-*.json` marker (legacy fallback for one release).
- *   3. Safe permissive default — never block tool use on missing state.
- */
-export async function checkSkillChainState(context, taskStateProvider) {
-    const taskState = await safeGetTaskState(taskStateProvider, context.incrementId);
-    if (taskState) {
-        return { decision: 'allow', source: 'task-state', state: taskState };
-    }
-    const fsState = readFilesystemMarker(context.stateDir, context.incrementId);
-    if (fsState) {
-        return { decision: 'allow', source: 'filesystem', state: fsState };
-    }
-    return { decision: 'allow', source: 'default', state: null };
-}
-//# sourceMappingURL=pretooluse-guard.js.map

package/dist/src/core/hooks/pretooluse-guard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pretooluse-guard.js","sourceRoot":"","sources":["../../../../src/core/hooks/pretooluse-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AA2B7B;;;GAGG;AACH,SAAS,oBAAoB,CAC3B,QAAgB,EAChB,WAA+B;IAE/B,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,WAAW,OAAO,CAAC,CAAC;IAE1E,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAC7B,QAAuC,EACvC,WAA+B;IAE/B,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAqB,EACrB,iBAAqC;IAErC,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,iBAAiB,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACjF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACvE,CAAC;IAED,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5E,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACrE,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC/D,CAAC"}

package/dist/src/core/hooks/project-scope-guard.d.ts

@@ -1,77 +0,0 @@
-/**
- * Project-Scope Initialization Guard
- *
- * Prevents SpecWeave skills from running in non-initialized projects.
- * Provides user-friendly prompts to initialize or disable plugins.
- *
- * ## Background
- *
- * Claude Code plugins are globally enabled in `~/.claude/settings.json`,
- * which means SpecWeave skills appear in ALL projects, not just initialized ones.
- * This guard prevents skills from executing in non-initialized projects and
- * provides clear guidance to users.
- *
- * ## Usage
- *
- * ```typescript
- * import { evaluateProjectScopeGuard } from './project-scope-guard.js';
- *
- * const result = evaluateProjectScopeGuard(userPrompt, process.cwd());
- * if (result.shouldBlock) {
- *   console.error(result.userPromptMessage);
- *   process.exit(1);
- * }
- * ```
- *
- * ## Configuration
- *
- * - Environment: `SPECWEAVE_DISABLE_GUARD=1` to bypass guard
- * - Config: `.specweave/config.json` → `guard.enabled: false`
- *
- * @module core/hooks/project-scope-guard
- * @since 1.0.235
- */
-/**
- * Guard evaluation result
- */
-export interface GuardResult {
-    /** Whether to block the skill invocation */
-    shouldBlock: boolean;
-    /** Reason for blocking (if applicable) */
-    reason?: string;
-    /** Whether to prompt the user for action */
-    promptUser?: boolean;
-    /** User-friendly prompt message */
-    userPromptMessage?: string;
-}
-/**
- * Check if a prompt is invoking a SpecWeave skill
- *
- * Detects patterns like:
- * - sw:increment "feature"
- * - /frontend:architect
- * - /SW:DO (case-insensitive)
- *
- * @param prompt - User's prompt
- * @returns true if it's a SpecWeave skill invocation
- */
-export declare function isSpecWeaveSkillInvocation(prompt: string): boolean;
-/**
- * Check if SpecWeave is initialized in a project
- *
- * A project is considered initialized if .specweave/config.json exists
- * and is readable.
- *
- * @param projectPath - Path to check (defaults to cwd)
- * @returns true if .specweave/config.json exists
- */
-export declare function isProjectInitialized(projectPath?: string): boolean;
-/**
- * Evaluate if skill invocation should be guarded
- *
- * @param prompt - User's prompt
- * @param projectPath - Current working directory
- * @returns Guard decision with reason and user prompt if needed
- */
-export declare function evaluateProjectScopeGuard(prompt: string, projectPath?: string): GuardResult;
-//# sourceMappingURL=project-scope-guard.d.ts.map

package/dist/src/core/hooks/project-scope-guard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"project-scope-guard.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/project-scope-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAYlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CA8BjF;AAgFD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAsB,GAClC,WAAW,CA0Bb"}

package/dist/src/core/hooks/project-scope-guard.js

@@ -1,206 +0,0 @@
-/**
- * Project-Scope Initialization Guard
- *
- * Prevents SpecWeave skills from running in non-initialized projects.
- * Provides user-friendly prompts to initialize or disable plugins.
- *
- * ## Background
- *
- * Claude Code plugins are globally enabled in `~/.claude/settings.json`,
- * which means SpecWeave skills appear in ALL projects, not just initialized ones.
- * This guard prevents skills from executing in non-initialized projects and
- * provides clear guidance to users.
- *
- * ## Usage
- *
- * ```typescript
- * import { evaluateProjectScopeGuard } from './project-scope-guard.js';
- *
- * const result = evaluateProjectScopeGuard(userPrompt, process.cwd());
- * if (result.shouldBlock) {
- *   console.error(result.userPromptMessage);
- *   process.exit(1);
- * }
- * ```
- *
- * ## Configuration
- *
- * - Environment: `SPECWEAVE_DISABLE_GUARD=1` to bypass guard
- * - Config: `.specweave/config.json` → `guard.enabled: false`
- *
- * @module core/hooks/project-scope-guard
- * @since 1.0.235
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { findProjectRoot } from '../../utils/find-project-root.js';
-/**
- * Check if a prompt is invoking a SpecWeave skill
- *
- * Detects patterns like:
- * - sw:increment "feature"
- * - /frontend:architect
- * - /SW:DO (case-insensitive)
- *
- * @param prompt - User's prompt
- * @returns true if it's a SpecWeave skill invocation
- */
-export function isSpecWeaveSkillInvocation(prompt) {
-    if (!prompt)
-        return false;
-    // Normalize: trim whitespace and convert to lowercase
-    const normalized = prompt.trim().toLowerCase();
-    // Check for /sw: or /sw-<plugin>: patterns (integration plugins)
-    // Also check for domain plugin patterns: /frontend:, /backend:, /testing:, etc.
-    const DOMAIN_PLUGINS = ['frontend', 'backend', 'testing', 'mobile', 'infra', 'k8s', 'ml', 'payments', 'kafka', 'confluent', 'cost', 'docs', 'security', 'skills', 'blockchain'];
-    if (/^\/sw(-[a-z0-9-]+)?:/.test(normalized))
-        return true;
-    const match = normalized.match(/^\/([a-z0-9-]+):/);
-    return match !== null && DOMAIN_PLUGINS.includes(match[1]);
-}
-/**
- * Check if SpecWeave is initialized in a project
- *
- * A project is considered initialized if .specweave/config.json exists
- * and is readable.
- *
- * @param projectPath - Path to check (defaults to cwd)
- * @returns true if .specweave/config.json exists
- */
-export function isProjectInitialized(projectPath = process.cwd()) {
-    try {
-        // First, try to find project root by walking up the tree
-        const projectRoot = findProjectRoot(projectPath);
-        if (!projectRoot) {
-            // No .specweave found in tree
-            return false;
-        }
-        // Check if config.json exists and is readable
-        const configPath = path.join(projectRoot, '.specweave', 'config.json');
-        if (!fs.existsSync(configPath)) {
-            return false;
-        }
-        // Try to read the file to ensure it's valid
-        try {
-            fs.accessSync(configPath, fs.constants.R_OK);
-            // Try to parse it to ensure it's valid JSON
-            const content = fs.readFileSync(configPath, 'utf8');
-            JSON.parse(content);
-            return true;
-        }
-        catch (error) {
-            // File exists but can't read or parse - treat as not initialized
-            return false;
-        }
-    }
-    catch (error) {
-        // Any error means not initialized
-        return false;
-    }
-}
-/**
- * Check if guard is disabled via environment variable or config
- *
- * @param projectPath - Path to check config (optional)
- * @returns true if guard is disabled
- */
-function isGuardDisabled(projectPath) {
-    // Check environment variable first
-    if (process.env.SPECWEAVE_DISABLE_GUARD === '1') {
-        return true;
-    }
-    // Check config if project is initialized
-    if (projectPath) {
-        try {
-            const projectRoot = findProjectRoot(projectPath);
-            if (projectRoot) {
-                const configPath = path.join(projectRoot, '.specweave', 'config.json');
-                if (fs.existsSync(configPath)) {
-                    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-                    if (config.guard?.enabled === false) {
-                        return true;
-                    }
-                }
-            }
-        }
-        catch (error) {
-            // Ignore errors reading config
-        }
-    }
-    return false;
-}
-/**
- * Generate user-friendly prompt message for non-initialized projects
- *
- * @param skillInvocation - The skill that was invoked (e.g., "sw:increment")
- * @returns Formatted message for the user
- */
-function generateUserPromptMessage(skillInvocation) {
-    return `⚠️ **SpecWeave Not Initialized**
-
-You invoked \`${skillInvocation}\`, but this project hasn't been initialized with SpecWeave yet.
-
-**Options:**
-
-1. **Initialize SpecWeave in this project:**
-   \`\`\`bash
-   specweave init
-   # or
-   npx specweave init
-   \`\`\`
-
-2. **Use SpecWeave in a different directory:**
-   Navigate to a SpecWeave project first:
-   \`\`\`bash
-   cd /path/to/your/specweave-project
-   \`\`\`
-
-3. **Disable SpecWeave plugins globally:**
-   If you don't need SpecWeave in most projects, disable it in:
-   \`~/.claude/settings.json\`
-   \`\`\`json
-   {
-     "enabledPlugins": {
-       "sw@specweave": false
-     }
-   }
-   \`\`\`
-
-4. **Disable this guard (not recommended):**
-   \`\`\`bash
-   export SPECWEAVE_DISABLE_GUARD=1
-   \`\`\`
-
-**Note:** SpecWeave skills are globally installed but require project-specific initialization to work correctly.`;
-}
-/**
- * Evaluate if skill invocation should be guarded
- *
- * @param prompt - User's prompt
- * @param projectPath - Current working directory
- * @returns Guard decision with reason and user prompt if needed
- */
-export function evaluateProjectScopeGuard(prompt, projectPath = process.cwd()) {
-    // Check if guard is disabled
-    if (isGuardDisabled(projectPath)) {
-        return { shouldBlock: false };
-    }
-    // Check if this is a SpecWeave skill invocation
-    if (!isSpecWeaveSkillInvocation(prompt)) {
-        return { shouldBlock: false };
-    }
-    // Check if project is initialized
-    if (isProjectInitialized(projectPath)) {
-        return { shouldBlock: false };
-    }
-    // Block with user-friendly prompt
-    const skillMatch = prompt.trim().match(/^(\/sw(-[a-z0-9-]+)?:[a-z-]+)/i);
-    const skillName = skillMatch ? skillMatch[1] : '/sw:<skill>';
-    return {
-        shouldBlock: true,
-        promptUser: true,
-        reason: 'Project not initialized with SpecWeave',
-        userPromptMessage: generateUserPromptMessage(skillName)
-    };
-}
-//# sourceMappingURL=project-scope-guard.js.map

package/dist/src/core/hooks/project-scope-guard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"project-scope-guard.js","sourceRoot":"","sources":["../../../../src/core/hooks/project-scope-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAgBnE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,sDAAsD;IACtD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE/C,iEAAiE;IACjE,gFAAgF;IAChF,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAChL,IAAI,sBAAsB,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACnD,OAAO,KAAK,KAAK,IAAI,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IACtE,IAAI,CAAC;QACH,yDAAyD;QACzD,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,8BAA8B;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,8CAA8C;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;QACvE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7C,4CAA4C;YAC5C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iEAAiE;YACjE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kCAAkC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,WAAoB;IAC3C,mCAAmC;IACnC,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yCAAyC;IACzC,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;YACjD,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;gBACvE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;oBAC/D,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;wBACpC,OAAO,IAAI,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,yBAAyB,CAAC,eAAuB;IACxD,OAAO;;gBAEO,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iHAiCkF,CAAC;AAClH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAc,EACd,cAAsB,OAAO,CAAC,GAAG,EAAE;IAEnC,6BAA6B;IAC7B,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,gDAAgD;IAChD,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,kCAAkC;IAClC,IAAI,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,kCAAkC;IAClC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;IAE7D,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,wCAAwC;QAChD,iBAAiB,EAAE,yBAAyB,CAAC,SAAS,CAAC;KACxD,CAAC;AACJ,CAAC"}

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

@@ -1,322 +0,0 @@
-/**
- * Hook Health Check Types
- *
- * Type definitions for the hook health monitoring system.
- * Supports detection, validation, and auto-fixing of hook failures.
- *
- * Part of increment 0037: Hook Health Check System
- */
-/**
- * Trigger event that causes a hook to execute
- *
- * Updated for EDA v2 architecture:
- * - session-start: Session initialization hooks
- * - session-end: Session cleanup hooks
- * - post-tool-use: Primary trigger for most v2 hooks (via PostToolUse dispatcher)
- * - pre-tool-use: Guard hooks that run before tool execution
- *
- * Legacy triggers (for backward compatibility):
- * - user-prompt-submit, post-task-completion, post-increment-change, etc.
- */
-export type HookTrigger = 'session-start' | 'session-end' | 'user-prompt-submit' | 'post-task-completion' | 'post-increment-change' | 'pre-tool-use' | 'post-tool-use' | 'post-write' | 'post-edit';
-/**
- * Hook file type
- */
-export type HookType = 'shell' | 'typescript' | 'javascript';
-/**
- * Hook definition discovered by scanner
- */
-export interface HookDefinition {
-    /** Hook name (e.g., "update-ac-status") */
-    name: string;
-    /** Plugin that owns this hook (e.g., "specweave") */
-    plugin: string;
-    /** Absolute path to hook file */
-    path: string;
-    /** File type */
-    type: HookType;
-    /** Imported modules/dependencies */
-    dependencies: string[];
-    /** Trigger event */
-    trigger: HookTrigger;
-    /** Can be tested in isolation */
-    testable: boolean;
-    /** Failure blocks workflow (critical hooks) */
-    critical: boolean;
-    /** Expected execution time (ms) */
-    expectedDuration?: number;
-}
-/**
- * Error detected during hook execution
- */
-export interface HookError {
-    /** Error type */
-    type: 'import' | 'runtime' | 'timeout' | 'validation' | 'syntax';
-    /** Error message */
-    message: string;
-    /** Stack trace (if available) */
-    stack?: string;
-    /** Auto-fix suggestion */
-    suggestion?: string;
-    /** Can be auto-fixed */
-    fixable: boolean;
-    /** Line number where error occurred */
-    line?: number;
-    /** Column number where error occurred */
-    column?: number;
-}
-/**
- * Warning detected during hook execution
- */
-export interface HookWarning {
-    /** Warning type */
-    type: 'performance' | 'deprecation' | 'best-practice' | 'security';
-    /** Warning message */
-    message: string;
-    /** Severity level */
-    severity: 'low' | 'medium' | 'high';
-    /** Recommendation to address warning */
-    recommendation?: string;
-}
-/**
- * Result of executing a single hook
- */
-export interface HookExecutionResult {
-    /** Hook name */
-    hook: string;
-    /** Plugin name */
-    plugin: string;
-    /** Hook passed health check */
-    success: boolean;
-    /** Process exit code */
-    exitCode: number;
-    /** Standard output */
-    stdout: string;
-    /** Standard error */
-    stderr: string;
-    /** Execution time in milliseconds */
-    executionTime: number;
-    /** Detected errors */
-    errors: HookError[];
-    /** Detected warnings */
-    warnings: HookWarning[];
-    /** Execution timestamp */
-    timestamp: string;
-    /** Performance threshold exceeded */
-    performanceIssue: boolean;
-    /** Expected vs actual duration */
-    performanceRatio?: number;
-}
-/**
- * Overall health check result
- */
-export interface HealthCheckResult {
-    /** Check timestamp */
-    timestamp: string;
-    /** Total hooks checked */
-    totalHooks: number;
-    /** Hooks that passed */
-    passedHooks: number;
-    /** Hooks that failed */
-    failedHooks: number;
-    /** Critical hook failures */
-    criticalFailures: number;
-    /** Overall health status */
-    overallHealth: 'healthy' | 'degraded' | 'unhealthy';
-    /** Individual hook results */
-    results: HookExecutionResult[];
-    /** Summary and recommendations */
-    summary: HealthSummary;
-    /** Total execution time */
-    totalExecutionTime: number;
-    /** Project root path */
-    projectRoot: string;
-}
-/**
- * Health check summary with recommendations
- */
-export interface HealthSummary {
-    /** Pass/warn/fail status */
-    status: 'pass' | 'warn' | 'fail';
-    /** Summary message */
-    message: string;
-    /** Actionable recommendations */
-    recommendations: string[];
-    /** Number of auto-fixable issues */
-    fixableIssues: number;
-    /** Number of issues requiring manual intervention */
-    manualIssues: number;
-    /** Hooks with performance issues */
-    slowHooks: string[];
-    /** Critical hooks that failed */
-    criticalHooksFailed: string[];
-}
-/**
- * Auto-fix result
- */
-export interface FixResult {
-    /** Hook that was fixed */
-    hook: string;
-    /** Fix was successful */
-    success: boolean;
-    /** Type of fix applied */
-    fixType: 'import' | 'static-method' | 'timeout' | 'dependency';
-    /** Fix description */
-    description: string;
-    /** Files modified */
-    filesModified: string[];
-    /** Error if fix failed */
-    error?: string;
-    /** Verification after fix */
-    verification?: HookExecutionResult;
-}
-/**
- * Auto-fix batch result
- */
-export interface BatchFixResult {
-    /** Total fixes attempted */
-    totalFixes: number;
-    /** Successful fixes */
-    successfulFixes: number;
-    /** Failed fixes */
-    failedFixes: number;
-    /** Individual fix results */
-    results: FixResult[];
-    /** Hooks that require manual intervention */
-    manualFixRequired: string[];
-    /** Overall success */
-    success: boolean;
-}
-/**
- * Hook response warning (v1.0.102+)
- *
- * Warnings are included in hook responses to surface failures to users
- * instead of silent {"continue":true} defaults.
- *
- * Part of increment 0161: Hook Execution Visibility
- */
-export interface HookResponseWarning {
-    /** Severity level */
-    severity: 'WARNING' | 'ERROR';
-    /** User-facing warning message */
-    message: string;
-    /** Actionable recommendation */
-    recommendation: string;
-}
-/**
- * Hook response format (v1.0.102+)
- *
- * Replaces silent {"continue":true} with warnings array.
- * Hooks return this format to surface failures to users.
- *
- * Part of increment 0161: Hook Execution Visibility
- */
-export interface HookResponse {
-    /** Whether to continue workflow */
-    continue: boolean;
-    /** Warnings from hook execution (optional for backwards compatibility) */
-    warnings?: HookResponseWarning[];
-    /** Optional system message to display */
-    systemMessage?: string;
-}
-/**
- * Hook health check configuration
- */
-export interface HealthCheckConfig {
-    /** Project root directory */
-    projectRoot: string;
-    /** Timeout for hook execution (ms) */
-    timeout: number;
-    /** Run auto-fix for detected issues */
-    autoFix: boolean;
-    /** Verbose output */
-    verbose: boolean;
-    /** Check only critical hooks */
-    criticalOnly: boolean;
-    /** Specific hooks to check (empty = all) */
-    hooksToCheck: string[];
-    /** Performance threshold ratio (actual/expected) */
-    performanceThreshold: number;
-    /** Fail on warnings */
-    failOnWarnings: boolean;
-}
-/**
- * Health report format
- */
-export type ReportFormat = 'console' | 'markdown' | 'json' | 'junit';
-/**
- * Health report options
- */
-export interface ReportOptions {
-    /** Output format */
-    format: ReportFormat;
-    /** Output file path (null = stdout) */
-    outputPath?: string;
-    /** Include full details */
-    detailed: boolean;
-    /** Color output for console */
-    color: boolean;
-    /** Show only failures */
-    failuresOnly: boolean;
-}
-/**
- * Scanner configuration
- */
-export interface ScannerConfig {
-    /** Project root */
-    projectRoot: string;
-    /** Plugin directories to scan */
-    pluginDirs: string[];
-    /** Include non-testable hooks */
-    includeNonTestable: boolean;
-}
-/**
- * Executor configuration
- */
-export interface ExecutorConfig {
-    /** Execution timeout (ms) */
-    timeout: number;
-    /** Capture stdout */
-    captureStdout: boolean;
-    /** Capture stderr */
-    captureStderr: boolean;
-    /** Test increment ID to use */
-    testIncrementId: string;
-    /** Test input data */
-    testInput?: any;
-}
-/**
- * Import error details
- */
-export interface ImportErrorDetails {
-    /** Missing module path */
-    modulePath: string;
-    /** Importing file */
-    importingFile: string;
-    /** Import statement line */
-    importStatement: string;
-    /** Has .js extension */
-    hasExtension: boolean;
-    /** Suggested fix */
-    suggestedPath: string;
-    /** Fix confidence */
-    fixConfidence: 'high' | 'medium' | 'low';
-}
-/**
- * Performance analysis result
- */
-export interface PerformanceAnalysis {
-    /** Hook name */
-    hook: string;
-    /** Actual execution time (ms) */
-    actualTime: number;
-    /** Expected execution time (ms) */
-    expectedTime: number;
-    /** Performance ratio (actual/expected) */
-    ratio: number;
-    /** Exceeds threshold */
-    exceedsThreshold: boolean;
-    /** Performance recommendation */
-    recommendation?: string;
-}
-//# sourceMappingURL=types.d.ts.map