@planu/cli 0.43.1 → 0.45.0

package/dist/engine/hooks/handlers/on-save.js

@@ -0,0 +1,118 @@
+// engine/hooks/handlers/on-save.ts — on-save hook handler (SPEC-129)
+// Validates @spec annotations, computes SHA-256 hash, updates drift score.
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const SPEC_ANNOTATION_REGEX = /@spec\s+(SPEC-\d+)/;
+const DRIFT_THRESHOLD = 0.3;
+// ---------------------------------------------------------------------------
+// Hash snapshots (in-memory store, keyed by file path)
+// ---------------------------------------------------------------------------
+const hashSnapshots = new Map();
+/**
+ * Compute SHA-256 hash of file content.
+ */
+function computeHash(content) {
+    return createHash('sha256').update(content, 'utf-8').digest('hex');
+}
+/**
+ * Extract @spec annotations from file content.
+ */
+export function extractSpecAnnotations(content) {
+    const matches = [];
+    const regex = new RegExp(SPEC_ANNOTATION_REGEX.source, 'g');
+    let match = regex.exec(content);
+    while (match !== null) {
+        if (match[1]) {
+            matches.push(match[1]);
+        }
+        match = regex.exec(content);
+    }
+    return matches;
+}
+/**
+ * Validate that spec IDs from annotations exist in the known specs set.
+ */
+function validateAnnotations(specIds, knownSpecs) {
+    if (specIds.length === 0) {
+        return true;
+    }
+    return specIds.every((id) => knownSpecs.has(id));
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+/**
+ * Handle on-save event for a file.
+ * - Validates @spec annotations
+ * - Computes SHA-256 hash and compares with stored snapshot
+ * - Reports drift delta
+ */
+export async function handleOnSave(relPath, ctx) {
+    const fullPath = join(ctx.projectRoot, relPath);
+    let content;
+    try {
+        content = await readFile(fullPath, 'utf-8');
+    }
+    catch {
+        return {
+            hook: 'on-save',
+            specId: null,
+            driftDelta: 0,
+            hashChanged: false,
+            annotationsValid: true,
+        };
+    }
+    // Extract and validate annotations
+    const specIds = extractSpecAnnotations(content);
+    const annotationsValid = validateAnnotations(specIds, ctx.knownSpecs);
+    const specId = (specIds.length > 0 ? specIds[0] : null) ?? null;
+    // Compute hash and compare
+    const newHash = computeHash(content);
+    const previousHash = hashSnapshots.get(relPath);
+    const hashChanged = previousHash !== undefined && previousHash !== newHash;
+    // Update snapshot
+    hashSnapshots.set(relPath, newHash);
+    // Compute drift delta (simple: 0.1 if changed, 0 if not)
+    // In a real implementation this would compare with spec baseline
+    const driftDelta = hashChanged ? 0.1 : 0;
+    // Warn if drift exceeds threshold
+    if (driftDelta > DRIFT_THRESHOLD) {
+        console.warn(`[hooks] Drift warning: ${relPath} drift=${String(driftDelta)} exceeds threshold=${String(DRIFT_THRESHOLD)}`);
+    }
+    return {
+        hook: 'on-save',
+        specId,
+        driftDelta,
+        hashChanged,
+        annotationsValid,
+    };
+}
+/**
+ * Get the stored hash for a file path.
+ */
+export function getStoredHash(relPath) {
+    return hashSnapshots.get(relPath);
+}
+/**
+ * Set a hash snapshot (useful for initialization / testing).
+ */
+export function setStoredHash(relPath, hash) {
+    hashSnapshots.set(relPath, hash);
+}
+/**
+ * Remove a hash snapshot.
+ */
+export function removeStoredHash(relPath) {
+    return hashSnapshots.delete(relPath);
+}
+/**
+ * Clear all stored hashes.
+ */
+export function clearStoredHashes() {
+    hashSnapshots.clear();
+}
+//# sourceMappingURL=on-save.js.map

package/dist/engine/hooks/handlers/on-save.js.map

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

package/dist/engine/hooks/handlers/on-test-pass.d.ts

@@ -0,0 +1,33 @@
+import type { OnTestPassHookResult, OnTestPassContext } from '../../../types/file-hooks.js';
+/**
+ * Get previous coverage cache (for testing).
+ */
+export declare function getPreviousCoverage(coveragePath: string): Record<string, number> | undefined;
+/**
+ * Clear previous coverage cache (for testing).
+ */
+export declare function clearPreviousCoverage(): void;
+/**
+ * Parse coverage-summary.json and extract per-file line coverage percentage.
+ */
+export declare function parseCoverageSummary(coveragePath: string): Promise<Record<string, number>>;
+/**
+ * Compute coverage delta per file.
+ */
+export declare function computeCoverageDelta(current: Record<string, number>, previous: Record<string, number>): Record<string, number>;
+/**
+ * Map coverage files to spec IDs via annotation index.
+ */
+export declare function mapFilesToSpecs(files: string[], annotationIndex: {
+    specId: string;
+    annotatedFiles: string[];
+}[]): string[];
+/**
+ * Handle on-test-pass event.
+ * - Reads coverage-summary.json
+ * - Computes coverage delta per file
+ * - Maps changed files to specs via annotations
+ * - Returns coverage delta and updated specs
+ */
+export declare function handleOnTestPass(ctx: OnTestPassContext): Promise<OnTestPassHookResult>;
+//# sourceMappingURL=on-test-pass.d.ts.map

package/dist/engine/hooks/handlers/on-test-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-test-pass.d.ts","sourceRoot":"","sources":["../../../../src/engine/hooks/handlers/on-test-pass.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EAElB,MAAM,8BAA8B,CAAC;AAQtC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAE5F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAMD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAahG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EAAE,EACf,eAAe,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,GAC9D,MAAM,EAAE,CAYV;AAMD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8B5F"}

package/dist/engine/hooks/handlers/on-test-pass.js

@@ -0,0 +1,103 @@
+// engine/hooks/handlers/on-test-pass.ts — on-test-pass hook handler (SPEC-130)
+// Watches coverage-summary.json, extracts coverage delta, maps to specs.
+import { readFile } from 'node:fs/promises';
+// ---------------------------------------------------------------------------
+// In-memory previous coverage cache
+// ---------------------------------------------------------------------------
+const previousCoverageCache = new Map();
+/**
+ * Get previous coverage cache (for testing).
+ */
+export function getPreviousCoverage(coveragePath) {
+    return previousCoverageCache.get(coveragePath);
+}
+/**
+ * Clear previous coverage cache (for testing).
+ */
+export function clearPreviousCoverage() {
+    previousCoverageCache.clear();
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parse coverage-summary.json and extract per-file line coverage percentage.
+ */
+export async function parseCoverageSummary(coveragePath) {
+    const raw = await readFile(coveragePath, 'utf-8');
+    const summary = JSON.parse(raw);
+    const result = {};
+    for (const [filePath, coverage] of Object.entries(summary)) {
+        if (filePath === 'total') {
+            continue;
+        }
+        result[filePath] = coverage.lines.pct;
+    }
+    return result;
+}
+/**
+ * Compute coverage delta per file.
+ */
+export function computeCoverageDelta(current, previous) {
+    const delta = {};
+    for (const [file, pct] of Object.entries(current)) {
+        const prev = previous[file] ?? 0;
+        const diff = pct - prev;
+        if (Math.abs(diff) > 0.001) {
+            delta[file] = Math.round(diff * 100) / 100;
+        }
+    }
+    return delta;
+}
+/**
+ * Map coverage files to spec IDs via annotation index.
+ */
+export function mapFilesToSpecs(files, annotationIndex) {
+    const specIds = new Set();
+    for (const file of files) {
+        for (const entry of annotationIndex) {
+            if (entry.annotatedFiles.some((af) => file.includes(af) || af.includes(file))) {
+                specIds.add(entry.specId);
+            }
+        }
+    }
+    return [...specIds];
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+/**
+ * Handle on-test-pass event.
+ * - Reads coverage-summary.json
+ * - Computes coverage delta per file
+ * - Maps changed files to specs via annotations
+ * - Returns coverage delta and updated specs
+ */
+export async function handleOnTestPass(ctx) {
+    let current;
+    try {
+        current = await parseCoverageSummary(ctx.coveragePath);
+    }
+    catch {
+        return {
+            hook: 'on-test-pass',
+            coverageDelta: {},
+            specsUpdated: [],
+        };
+    }
+    // Get previous coverage
+    const previous = ctx.previousCoverage ?? previousCoverageCache.get(ctx.coveragePath) ?? {};
+    // Compute delta
+    const coverageDelta = computeCoverageDelta(current, previous);
+    // Update cache for next run
+    previousCoverageCache.set(ctx.coveragePath, current);
+    // Map files with coverage changes to specs
+    const changedFiles = Object.keys(coverageDelta);
+    const specsUpdated = mapFilesToSpecs(changedFiles, ctx.specAnnotationIndex);
+    return {
+        hook: 'on-test-pass',
+        coverageDelta,
+        specsUpdated,
+    };
+}
+//# sourceMappingURL=on-test-pass.js.map

package/dist/engine/hooks/handlers/on-test-pass.js.map

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

package/dist/engine/hooks/hook-engine.d.ts

@@ -0,0 +1,50 @@
+import type { HookPluginHandler, HookEngineStatus, WatcherEvent, FileHookType, ExtendedHookResult } from '../../types/file-hooks.js';
+import { EventBus } from './event-bus.js';
+/**
+ * Orchestrates all hook handlers with plugin support, priority ordering,
+ * async non-blocking execution, and telemetry.
+ */
+export declare class HookEngine {
+    private readonly handlers;
+    private readonly telemetry;
+    private readonly eventBus;
+    private running;
+    private pendingCount;
+    constructor(eventBus?: EventBus);
+    /**
+     * Register a hook handler with optional priority.
+     * Lower priority = executed first (default: 100).
+     */
+    register(handler: HookPluginHandler): void;
+    /**
+     * Unregister a handler by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Start the engine (marks as running).
+     */
+    start(): void;
+    /**
+     * Stop the engine.
+     */
+    stop(): void;
+    /**
+     * Dispatch an event to all matching handlers (async, non-blocking).
+     * Each handler is wrapped in try/catch — errors don't propagate.
+     */
+    dispatch(event: WatcherEvent, hookType: FileHookType): Promise<ExtendedHookResult[]>;
+    /**
+     * Get current engine status including telemetry.
+     */
+    status(): HookEngineStatus;
+    /**
+     * Get the underlying event bus.
+     */
+    getEventBus(): EventBus;
+    /**
+     * Get registered handler count.
+     */
+    getHandlerCount(): number;
+    private updateTelemetry;
+}
+//# sourceMappingURL=hook-engine.d.ts.map

package/dist/engine/hooks/hook-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-engine.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/hook-engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EAEjB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAK;gBAEb,QAAQ,CAAC,EAAE,QAAQ;IAI/B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAkB1C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAuD1F;;OAEG;IACH,MAAM,IAAI,gBAAgB;IAc1B;;OAEG;IACH,WAAW,IAAI,QAAQ;IAIvB;;OAEG;IACH,eAAe,IAAI,MAAM;IAQzB,OAAO,CAAC,eAAe;CAcxB"}

package/dist/engine/hooks/hook-engine.js

@@ -0,0 +1,159 @@
+// engine/hooks/hook-engine.ts — Hook orchestration engine (SPEC-130)
+import { EventBus } from './event-bus.js';
+// ---------------------------------------------------------------------------
+// HookEngine
+// ---------------------------------------------------------------------------
+/**
+ * Orchestrates all hook handlers with plugin support, priority ordering,
+ * async non-blocking execution, and telemetry.
+ */
+export class HookEngine {
+    handlers = [];
+    telemetry = new Map();
+    eventBus;
+    running = false;
+    pendingCount = 0;
+    constructor(eventBus) {
+        this.eventBus = eventBus ?? new EventBus();
+    }
+    /**
+     * Register a hook handler with optional priority.
+     * Lower priority = executed first (default: 100).
+     */
+    register(handler) {
+        const h = { ...handler, priority: handler.priority ?? 100 };
+        this.handlers.push(h);
+        // Re-sort by priority
+        this.handlers.sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+        // Initialize telemetry
+        if (!this.telemetry.has(h.name)) {
+            this.telemetry.set(h.name, {
+                executionCount: 0,
+                avgLatencyMs: 0,
+                errorCount: 0,
+                errorRate: 0,
+                totalLatencyMs: 0,
+            });
+        }
+    }
+    /**
+     * Unregister a handler by name.
+     */
+    unregister(name) {
+        const idx = this.handlers.findIndex((h) => h.name === name);
+        if (idx === -1) {
+            return false;
+        }
+        this.handlers.splice(idx, 1);
+        return true;
+    }
+    /**
+     * Start the engine (marks as running).
+     */
+    start() {
+        this.running = true;
+    }
+    /**
+     * Stop the engine.
+     */
+    stop() {
+        this.running = false;
+    }
+    /**
+     * Dispatch an event to all matching handlers (async, non-blocking).
+     * Each handler is wrapped in try/catch — errors don't propagate.
+     */
+    async dispatch(event, hookType) {
+        if (!this.running) {
+            return [];
+        }
+        const matching = this.handlers.filter((h) => h.hookType === hookType);
+        if (matching.length === 0) {
+            return [];
+        }
+        this.pendingCount++;
+        const results = [];
+        try {
+            for (const handler of matching) {
+                this.eventBus.emitEvent('hook:start', {
+                    handler: handler.name,
+                    hookType,
+                    path: event.path,
+                });
+                const startMs = Date.now();
+                try {
+                    const result = await handler.execute(event);
+                    results.push(result);
+                    const latency = Date.now() - startMs;
+                    this.updateTelemetry(handler.name, latency, false);
+                    this.eventBus.emitEvent('hook:complete', {
+                        handler: handler.name,
+                        hookType,
+                        path: event.path,
+                        latencyMs: latency,
+                    });
+                }
+                catch (err) {
+                    const latency = Date.now() - startMs;
+                    this.updateTelemetry(handler.name, latency, true);
+                    const message = err instanceof Error ? err.message : String(err);
+                    this.eventBus.emitEvent('hook:error', {
+                        handler: handler.name,
+                        hookType,
+                        path: event.path,
+                        error: message,
+                    });
+                }
+            }
+        }
+        finally {
+            this.pendingCount--;
+        }
+        return results;
+    }
+    /**
+     * Get current engine status including telemetry.
+     */
+    status() {
+        return {
+            running: this.running,
+            activeHooks: this.handlers.map((h) => ({
+                name: h.name,
+                hookType: h.hookType,
+                /* v8 ignore next -- priority always set in register(), ?? 100 is defensive */
+                priority: h.priority ?? 100,
+            })),
+            pendingEvents: this.pendingCount,
+            telemetry: Object.fromEntries(this.telemetry),
+        };
+    }
+    /**
+     * Get the underlying event bus.
+     */
+    getEventBus() {
+        return this.eventBus;
+    }
+    /**
+     * Get registered handler count.
+     */
+    getHandlerCount() {
+        return this.handlers.length;
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    updateTelemetry(name, latencyMs, isError) {
+        const t = this.telemetry.get(name);
+        if (!t) {
+            return;
+        }
+        t.executionCount++;
+        t.totalLatencyMs += latencyMs;
+        t.avgLatencyMs = t.totalLatencyMs / t.executionCount;
+        if (isError) {
+            t.errorCount++;
+        }
+        t.errorRate = t.errorCount / t.executionCount;
+    }
+}
+//# sourceMappingURL=hook-engine.js.map

package/dist/engine/hooks/hook-engine.js.map

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

package/dist/engine/hooks/index.d.ts

@@ -2,4 +2,14 @@ export { dispatchEvent, executeHook, dryRunDispatch } from './core.js';
 export { buildSpecCreatedPayload, buildStatusChangePayload, buildDriftDetectedPayload, buildCommitPayload, matchesFilter, matchesGlob, } from './triggers.js';
 export { generateGitHookScript, generateGitHooks, formatGitHookInstallGuide, } from './git-hook-generator.js';
 export { listTemplateNames, getTemplate, getAllTemplates } from './templates.js';
+export { FileWatcher, globToRegex, matchesGlobPattern, matchesPatterns } from './file-watcher.js';
+export { Debouncer } from './debouncer.js';
+export { ConfigLoader } from './config-loader.js';
+export { handleOnSave, extractSpecAnnotations, getStoredHash, setStoredHash, removeStoredHash, clearStoredHashes, } from './handlers/on-save.js';
+export { handleOnCreate } from './handlers/on-create.js';
+export { handleOnDelete } from './handlers/on-delete.js';
+export { HookEngine } from './hook-engine.js';
+export { EventBus } from './event-bus.js';
+export { handleOnTestPass, parseCoverageSummary, computeCoverageDelta, mapFilesToSpecs, clearPreviousCoverage, } from './handlers/on-test-pass.js';
+export { handleOnCommit, installGitHook, uninstallGitHook } from './handlers/on-commit.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/engine/hooks/index.js

@@ -3,4 +3,16 @@ export { dispatchEvent, executeHook, dryRunDispatch } from './core.js';
 export { buildSpecCreatedPayload, buildStatusChangePayload, buildDriftDetectedPayload, buildCommitPayload, matchesFilter, matchesGlob, } from './triggers.js';
 export { generateGitHookScript, generateGitHooks, formatGitHookInstallGuide, } from './git-hook-generator.js';
 export { listTemplateNames, getTemplate, getAllTemplates } from './templates.js';
+// SPEC-129 — File Event Hooks
+export { FileWatcher, globToRegex, matchesGlobPattern, matchesPatterns } from './file-watcher.js';
+export { Debouncer } from './debouncer.js';
+export { ConfigLoader } from './config-loader.js';
+export { handleOnSave, extractSpecAnnotations, getStoredHash, setStoredHash, removeStoredHash, clearStoredHashes, } from './handlers/on-save.js';
+export { handleOnCreate } from './handlers/on-create.js';
+export { handleOnDelete } from './handlers/on-delete.js';
+// SPEC-130 — Hook Engine Advanced
+export { HookEngine } from './hook-engine.js';
+export { EventBus } from './event-bus.js';
+export { handleOnTestPass, parseCoverageSummary, computeCoverageDelta, mapFilesToSpecs, clearPreviousCoverage, } from './handlers/on-test-pass.js';
+export { handleOnCommit, installGitHook, uninstallGitHook } from './handlers/on-commit.js';
 //# sourceMappingURL=index.js.map

package/dist/engine/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/hooks/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/hooks/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjF,8BAA8B;AAC9B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,kCAAkC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/engine/living-spec/annotation-parser.d.ts

@@ -0,0 +1,18 @@
+import type { SpecAnnotation, AnnotationParseResult } from '../../types/index.js';
+/**
+ * Parse a single line for a @spec annotation.
+ */
+export declare function parseAnnotationLine(line: string, file: string, lineNumber: number): SpecAnnotation | null;
+/**
+ * Parse criteria string like "AC-1,AC-3,AC-5" into [1, 3, 5].
+ */
+export declare function parseCriteriaList(criteriaStr: string): number[];
+/**
+ * Parse all @spec annotations from a file's content.
+ */
+export declare function parseAnnotationsFromContent(content: string, file: string): SpecAnnotation[];
+/**
+ * Parse all @spec annotations from a project directory.
+ */
+export declare function parseAnnotationsFromProject(projectPath: string, filterSpecId?: string): Promise<AnnotationParseResult>;
+//# sourceMappingURL=annotation-parser.d.ts.map

package/dist/engine/living-spec/annotation-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-parser.d.ts","sourceRoot":"","sources":["../../../src/engine/living-spec/annotation-parser.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAYlF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,cAAc,GAAG,IAAI,CAoBvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAc/D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,cAAc,EAAE,CAclB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,qBAAqB,CAAC,CA+BhC"}