specweave 1.0.593 → 2.0.0

package/dist/src/core/hooks/hook-health-tracker.d.ts

@@ -1,54 +0,0 @@
-import { HookLogEntry } from './hook-logger.js';
-export type HookStatus = 'OK' | 'DEGRADED' | 'FAILED' | 'UNKNOWN';
-export interface HookHealth {
-    hookName: string;
-    status: HookStatus;
-    successRate: number;
-    avgDuration: number;
-    lastRun: string | null;
-    totalExecutions: number;
-    consecutiveFailures: number;
-    recommendations: string[];
-}
-/**
- * Hook health tracking and analysis
- *
- * Analyzes hook execution logs to determine health status:
- * - OK: >90% success rate, no recent consecutive failures
- * - DEGRADED: 50-90% success rate OR 3+ warnings in last 10 executions
- * - FAILED: <50% success rate OR 3+ consecutive failures
- * - UNKNOWN: No execution data available
- *
- * @example
- * ```typescript
- * const tracker = new HookHealthTracker();
- * const logger = new HookLogger('.specweave/logs/hooks');
- * const logs = await logger.readLogs('session-start', 100);
- *
- * const health = tracker.analyze('session-start', logs);
- * console.log(`Status: ${health.status}`);
- * console.log(`Success rate: ${(health.successRate * 100).toFixed(1)}%`);
- * ```
- */
-export declare class HookHealthTracker {
-    private readonly WINDOW_HOURS;
-    private readonly DEGRADED_THRESHOLD;
-    private readonly OK_THRESHOLD;
-    private readonly CONSECUTIVE_FAILURE_THRESHOLD;
-    /**
-     * Analyze hook health from execution logs
-     *
-     * @param hookName - Name of the hook
-     * @param logs - Log entries (should be sorted by timestamp, most recent first)
-     * @param referenceTime - Reference time for 24h window (default: now)
-     * @returns Health analysis
-     */
-    analyze(hookName: string, logs: HookLogEntry[], referenceTime?: Date): HookHealth;
-    private static readonly STATUS_ORDER;
-    /**
-     * Analyze health for multiple hooks
-     * @returns Array of health analyses sorted by severity, then by name
-     */
-    analyzeAll(hooks: Map<string, HookLogEntry[]>): HookHealth[];
-}
-//# sourceMappingURL=hook-health-tracker.d.ts.map

package/dist/src/core/hooks/hook-health-tracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hook-health-tracker.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/hook-health-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAM;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAK;IAEnD;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,aAAa,CAAC,EAAE,IAAI,GAAG,UAAU;IA4FjF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAKlC;IAEF;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,UAAU,EAAE;CAQ7D"}

package/dist/src/core/hooks/hook-health-tracker.js

@@ -1,140 +0,0 @@
-/**
- * Hook health tracking and analysis
- *
- * Analyzes hook execution logs to determine health status:
- * - OK: >90% success rate, no recent consecutive failures
- * - DEGRADED: 50-90% success rate OR 3+ warnings in last 10 executions
- * - FAILED: <50% success rate OR 3+ consecutive failures
- * - UNKNOWN: No execution data available
- *
- * @example
- * ```typescript
- * const tracker = new HookHealthTracker();
- * const logger = new HookLogger('.specweave/logs/hooks');
- * const logs = await logger.readLogs('session-start', 100);
- *
- * const health = tracker.analyze('session-start', logs);
- * console.log(`Status: ${health.status}`);
- * console.log(`Success rate: ${(health.successRate * 100).toFixed(1)}%`);
- * ```
- */
-export class HookHealthTracker {
-    constructor() {
-        this.WINDOW_HOURS = 24;
-        this.DEGRADED_THRESHOLD = 0.5;
-        this.OK_THRESHOLD = 0.9;
-        this.CONSECUTIVE_FAILURE_THRESHOLD = 3;
-    }
-    /**
-     * Analyze hook health from execution logs
-     *
-     * @param hookName - Name of the hook
-     * @param logs - Log entries (should be sorted by timestamp, most recent first)
-     * @param referenceTime - Reference time for 24h window (default: now)
-     * @returns Health analysis
-     */
-    analyze(hookName, logs, referenceTime) {
-        if (logs.length === 0) {
-            return {
-                hookName,
-                status: 'UNKNOWN',
-                successRate: 0,
-                avgDuration: 0,
-                lastRun: null,
-                totalExecutions: 0,
-                consecutiveFailures: 0,
-                recommendations: ['No execution data available']
-            };
-        }
-        // Filter logs to 24h window
-        const now = referenceTime || new Date();
-        const windowStart = new Date(now.getTime() - this.WINDOW_HOURS * 60 * 60 * 1000);
-        const recentLogs = logs
-            .filter(log => {
-            if (!log.timestamp)
-                return false;
-            const logTime = new Date(log.timestamp);
-            return logTime >= windowStart && logTime <= now;
-        })
-            .sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
-        if (recentLogs.length === 0) {
-            return {
-                hookName,
-                status: 'UNKNOWN',
-                successRate: 0,
-                avgDuration: 0,
-                lastRun: logs[0]?.timestamp || null,
-                totalExecutions: 0,
-                consecutiveFailures: 0,
-                recommendations: ['No recent executions in last 24h']
-            };
-        }
-        // Calculate metrics
-        const successCount = recentLogs.filter(l => l.status === 'success').length;
-        const successRate = successCount / recentLogs.length;
-        const durations = recentLogs.filter(l => l.duration !== undefined).map(l => l.duration);
-        const avgDuration = durations.length > 0
-            ? durations.reduce((sum, d) => sum + d, 0) / durations.length
-            : 0;
-        const lastRun = recentLogs[0]?.timestamp ?? null;
-        // Count consecutive failures from most recent
-        const consecutiveFailures = recentLogs.findIndex(log => log.status !== 'error');
-        const actualConsecutiveFailures = consecutiveFailures === -1 ? recentLogs.length : consecutiveFailures;
-        // Determine status
-        let status;
-        if (actualConsecutiveFailures >= this.CONSECUTIVE_FAILURE_THRESHOLD || successRate < this.DEGRADED_THRESHOLD) {
-            status = 'FAILED';
-        }
-        else if (successRate < this.OK_THRESHOLD) {
-            status = 'DEGRADED';
-        }
-        else {
-            const recentWarnings = recentLogs.slice(0, 10).filter(l => l.status === 'warning').length;
-            status = recentWarnings >= 3 ? 'DEGRADED' : 'OK';
-        }
-        // Generate recommendations
-        const recommendations = [];
-        if (status === 'FAILED') {
-            recommendations.push('Run `specweave hooks health` to diagnose issues');
-            if (actualConsecutiveFailures >= 3) {
-                recommendations.push('Multiple consecutive failures detected');
-            }
-            recommendations.push('Check `.specweave/logs/hooks/${hookName}.log` for details');
-        }
-        else if (status === 'DEGRADED') {
-            recommendations.push('Run `specweave hooks health` to identify problems');
-            if (avgDuration > 5000) {
-                recommendations.push('Hook execution is slow (>5s) - may timeout');
-            }
-        }
-        return {
-            hookName,
-            status,
-            successRate,
-            avgDuration: Math.round(avgDuration),
-            lastRun,
-            totalExecutions: recentLogs.length,
-            consecutiveFailures: actualConsecutiveFailures,
-            recommendations
-        };
-    }
-    /**
-     * Analyze health for multiple hooks
-     * @returns Array of health analyses sorted by severity, then by name
-     */
-    analyzeAll(hooks) {
-        return Array.from(hooks.entries())
-            .map(([hookName, logs]) => this.analyze(hookName, logs))
-            .sort((a, b) => {
-            const statusDiff = HookHealthTracker.STATUS_ORDER[a.status] - HookHealthTracker.STATUS_ORDER[b.status];
-            return statusDiff !== 0 ? statusDiff : a.hookName.localeCompare(b.hookName);
-        });
-    }
-}
-HookHealthTracker.STATUS_ORDER = {
-    FAILED: 0,
-    DEGRADED: 1,
-    OK: 2,
-    UNKNOWN: 3
-};
-//# sourceMappingURL=hook-health-tracker.js.map

package/dist/src/core/hooks/hook-health-tracker.js.map

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

package/dist/src/core/hooks/hook-logger.d.ts

@@ -1,83 +0,0 @@
-/**
- * Warning entry for hook execution
- */
-export interface HookWarning {
-    severity: 'WARNING' | 'ERROR';
-    message: string;
-    recommendation?: string;
-}
-/**
- * Log entry for hook execution
- */
-export interface HookLogEntry {
-    hookName: string;
-    status: 'success' | 'warning' | 'error';
-    duration?: number;
-    timestamp?: string;
-    requestId?: string;
-    error?: string;
-    stackTrace?: string;
-    warnings?: HookWarning[];
-    startTime?: number;
-    endTime?: number;
-}
-/**
- * Centralized hook logging system with structured output
- *
- * Features:
- * - Real-time log writing to .specweave/logs/hooks/
- * - Structured JSON format for easy parsing
- * - Request ID correlation for multi-hook operations
- * - Append-only logs per hook name
- *
- * @example
- * ```typescript
- * const logger = new HookLogger('.specweave/logs/hooks');
- *
- * await logger.log({
- *   hookName: 'user-prompt-submit',
- *   status: 'warning',
- *   duration: 5200,
- *   warnings: [{
- *     severity: 'WARNING',
- *     message: 'Hook execution timeout after 5s',
- *     recommendation: 'Run specweave hooks health'
- *   }]
- * });
- * ```
- */
-export declare class HookLogger {
-    private logDir;
-    /**
-     * Create a new HookLogger instance
-     *
-     * @param logDir - Directory to write log files (e.g., '.specweave/logs/hooks')
-     */
-    constructor(logDir: string);
-    /**
-     * Log a hook execution event
-     *
-     * Writes to {logDir}/{hookName}.log in append mode.
-     * Each line is a complete JSON object.
-     *
-     * @param entry - Hook log entry
-     */
-    log(entry: HookLogEntry): Promise<void>;
-    /**
-     * Read recent log entries for a hook
-     *
-     * @param hookName - Name of the hook
-     * @param limit - Maximum number of entries to return (default: 100)
-     * @returns Array of log entries, most recent first
-     */
-    readLogs(hookName: string, limit?: number): Promise<HookLogEntry[]>;
-    /**
-     * List all hooks that have log files
-     */
-    listHooks(): Promise<string[]>;
-    /**
-     * Clear logs for a specific hook or all hooks
-     */
-    clearLogs(hookName?: string): Promise<void>;
-}
-//# sourceMappingURL=hook-logger.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hook-logger.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/hook-logger.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;;OAOG;IACG,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7C;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAuB9E;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IASpC;;OAEG;IACG,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBlD"}

package/dist/src/core/hooks/hook-logger.js

@@ -1,120 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-/**
- * Centralized hook logging system with structured output
- *
- * Features:
- * - Real-time log writing to .specweave/logs/hooks/
- * - Structured JSON format for easy parsing
- * - Request ID correlation for multi-hook operations
- * - Append-only logs per hook name
- *
- * @example
- * ```typescript
- * const logger = new HookLogger('.specweave/logs/hooks');
- *
- * await logger.log({
- *   hookName: 'user-prompt-submit',
- *   status: 'warning',
- *   duration: 5200,
- *   warnings: [{
- *     severity: 'WARNING',
- *     message: 'Hook execution timeout after 5s',
- *     recommendation: 'Run specweave hooks health'
- *   }]
- * });
- * ```
- */
-export class HookLogger {
-    /**
-     * Create a new HookLogger instance
-     *
-     * @param logDir - Directory to write log files (e.g., '.specweave/logs/hooks')
-     */
-    constructor(logDir) {
-        this.logDir = logDir;
-    }
-    /**
-     * Log a hook execution event
-     *
-     * Writes to {logDir}/{hookName}.log in append mode.
-     * Each line is a complete JSON object.
-     *
-     * @param entry - Hook log entry
-     */
-    async log(entry) {
-        // Ensure log directory exists
-        if (!fs.existsSync(this.logDir)) {
-            fs.mkdirSync(this.logDir, { recursive: true });
-        }
-        // Add timestamp if not provided
-        const logEntry = {
-            ...entry,
-            timestamp: entry.timestamp || new Date().toISOString()
-        };
-        // Build log file path
-        const logFile = path.join(this.logDir, `${entry.hookName}.log`);
-        // Write log entry as JSON line
-        const logLine = JSON.stringify(logEntry) + '\n';
-        // Append to log file
-        fs.appendFileSync(logFile, logLine, 'utf8');
-    }
-    /**
-     * Read recent log entries for a hook
-     *
-     * @param hookName - Name of the hook
-     * @param limit - Maximum number of entries to return (default: 100)
-     * @returns Array of log entries, most recent first
-     */
-    async readLogs(hookName, limit = 100) {
-        const logFile = path.join(this.logDir, `${hookName}.log`);
-        if (!fs.existsSync(logFile)) {
-            return [];
-        }
-        const content = fs.readFileSync(logFile, 'utf8');
-        const lines = content.trim().split('\n').filter(Boolean);
-        const entries = lines
-            .map(line => {
-            try {
-                return JSON.parse(line);
-            }
-            catch {
-                return null;
-            }
-        })
-            .filter((entry) => entry !== null);
-        return entries.slice(-limit).reverse();
-    }
-    /**
-     * List all hooks that have log files
-     */
-    async listHooks() {
-        if (!fs.existsSync(this.logDir)) {
-            return [];
-        }
-        return fs.readdirSync(this.logDir)
-            .filter(file => file.endsWith('.log'))
-            .map(file => file.replace('.log', ''));
-    }
-    /**
-     * Clear logs for a specific hook or all hooks
-     */
-    async clearLogs(hookName) {
-        if (hookName) {
-            const logFile = path.join(this.logDir, `${hookName}.log`);
-            if (fs.existsSync(logFile)) {
-                fs.unlinkSync(logFile);
-            }
-            return;
-        }
-        if (!fs.existsSync(this.logDir)) {
-            return;
-        }
-        for (const file of fs.readdirSync(this.logDir)) {
-            if (file.endsWith('.log')) {
-                fs.unlinkSync(path.join(this.logDir, file));
-            }
-        }
-    }
-}
-//# sourceMappingURL=hook-logger.js.map

package/dist/src/core/hooks/hook-logger.js.map

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

package/dist/src/core/hooks/log-rotator.d.ts

@@ -1,51 +0,0 @@
-/**
- * Log rotation system for hook logs
- *
- * Features:
- * - Dated log files (YYYY-MM-DD format)
- * - Automatic cleanup of old logs
- * - Configurable retention period
- *
- * @example
- * ```typescript
- * const rotator = new LogRotator('.specweave/logs/hooks');
- *
- * // Get current log path
- * const logPath = rotator.getCurrentLogPath('session-start');
- * // Returns: .specweave/logs/hooks/session-start-2026-01-08.log
- *
- * // Clean logs older than 7 days
- * await rotator.cleanOldLogs(7);
- * ```
- */
-export declare class LogRotator {
-    private logDir;
-    /**
-     * Create a new LogRotator instance
-     *
-     * @param logDir - Directory containing log files
-     */
-    constructor(logDir: string);
-    /**
-     * Get the current log file path for a hook
-     *
-     * Returns path with today's date: {hookName}-YYYY-MM-DD.log
-     *
-     * @param hookName - Name of the hook
-     * @returns Full path to current log file
-     */
-    getCurrentLogPath(hookName: string): string;
-    private static readonly DATE_PATTERN;
-    private static readonly MS_PER_DAY;
-    /**
-     * Clean up log files older than retention period
-     * Only removes files matching pattern: *-YYYY-MM-DD.log
-     */
-    cleanOldLogs(retentionDays: number): Promise<void>;
-    /**
-     * Get all dated log files for a specific hook
-     * @returns Array of log file paths, sorted by date (newest first)
-     */
-    getLogFiles(hookName: string): Promise<string[]>;
-}
-//# sourceMappingURL=log-rotator.d.ts.map

package/dist/src/core/hooks/log-rotator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"log-rotator.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/log-rotator.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;;OAOG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAK3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAA+B;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAEzD;;;OAGG;IACG,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBxD;;;OAGG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAavD"}

package/dist/src/core/hooks/log-rotator.js

@@ -1,85 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-/**
- * Log rotation system for hook logs
- *
- * Features:
- * - Dated log files (YYYY-MM-DD format)
- * - Automatic cleanup of old logs
- * - Configurable retention period
- *
- * @example
- * ```typescript
- * const rotator = new LogRotator('.specweave/logs/hooks');
- *
- * // Get current log path
- * const logPath = rotator.getCurrentLogPath('session-start');
- * // Returns: .specweave/logs/hooks/session-start-2026-01-08.log
- *
- * // Clean logs older than 7 days
- * await rotator.cleanOldLogs(7);
- * ```
- */
-export class LogRotator {
-    /**
-     * Create a new LogRotator instance
-     *
-     * @param logDir - Directory containing log files
-     */
-    constructor(logDir) {
-        this.logDir = logDir;
-    }
-    /**
-     * Get the current log file path for a hook
-     *
-     * Returns path with today's date: {hookName}-YYYY-MM-DD.log
-     *
-     * @param hookName - Name of the hook
-     * @returns Full path to current log file
-     */
-    getCurrentLogPath(hookName) {
-        const today = new Date().toISOString().split('T')[0];
-        return path.join(this.logDir, `${hookName}-${today}.log`);
-    }
-    /**
-     * Clean up log files older than retention period
-     * Only removes files matching pattern: *-YYYY-MM-DD.log
-     */
-    async cleanOldLogs(retentionDays) {
-        if (!fs.existsSync(this.logDir)) {
-            return;
-        }
-        const cutoffDate = Date.now() - retentionDays * LogRotator.MS_PER_DAY;
-        for (const file of fs.readdirSync(this.logDir)) {
-            if (!file.endsWith('.log')) {
-                continue;
-            }
-            const dateMatch = file.match(LogRotator.DATE_PATTERN);
-            if (!dateMatch) {
-                continue;
-            }
-            const fileDate = new Date(dateMatch[1]).getTime();
-            if (fileDate < cutoffDate) {
-                fs.unlinkSync(path.join(this.logDir, file));
-            }
-        }
-    }
-    /**
-     * Get all dated log files for a specific hook
-     * @returns Array of log file paths, sorted by date (newest first)
-     */
-    async getLogFiles(hookName) {
-        if (!fs.existsSync(this.logDir)) {
-            return [];
-        }
-        const pattern = new RegExp(`^${hookName}-(\\d{4}-\\d{2}-\\d{2})\\.log$`);
-        return fs.readdirSync(this.logDir)
-            .filter(file => pattern.test(file))
-            .map(file => ({ path: path.join(this.logDir, file), date: file.match(pattern)[1] }))
-            .sort((a, b) => b.date.localeCompare(a.date))
-            .map(f => f.path);
-    }
-}
-LogRotator.DATE_PATTERN = /(\d{4}-\d{2}-\d{2})\.log$/;
-LogRotator.MS_PER_DAY = 24 * 60 * 60 * 1000;
-//# sourceMappingURL=log-rotator.js.map

package/dist/src/core/hooks/log-rotator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"log-rotator.js","sourceRoot":"","sources":["../../../../src/core/hooks/log-rotator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,UAAU;IAGrB;;;;OAIG;IACH,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,QAAgB;QAChC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,IAAI,KAAK,MAAM,CAAC,CAAC;IAC5D,CAAC;IAKD;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,aAAqB;QACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC;QAEtE,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YACtD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAClD,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;gBAC1B,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB;QAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,QAAQ,gCAAgC,CAAC,CAAC;QAEzE,OAAO,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;aAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAClC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACpF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;;AA/CuB,uBAAY,GAAG,2BAA2B,CAAC;AAC3C,qBAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC"}

package/dist/src/core/hooks/pretooluse-guard.d.ts

@@ -1,37 +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
- */
-export interface SkillChainState {
-    phase?: string;
-    incrementId?: string;
-    source?: string;
-    [key: string]: unknown;
-}
-export type TaskStateProvider = (incrementId: string | undefined) => Promise<SkillChainState | null>;
-export interface GuardContext {
-    stateDir: string;
-    incrementId?: string;
-}
-export type StateSource = 'task-state' | 'filesystem' | 'default';
-export interface GuardDecision {
-    decision: 'allow' | 'block';
-    source: StateSource;
-    state: SkillChainState | null;
-    reason?: string;
-}
-/**
- * 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 declare function checkSkillChainState(context: GuardContext, taskStateProvider?: TaskStateProvider): Promise<GuardDecision>;
-//# sourceMappingURL=pretooluse-guard.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"pretooluse-guard.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/pretooluse-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,KAC5B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;AAErC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwCD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,aAAa,CAAC,CAYxB"}