@planu/cli 0.43.0 → 0.44.0

package/dist/types/file-hooks.d.ts

@@ -0,0 +1,230 @@
+export type WatcherEventType = 'create' | 'modify' | 'delete';
+export interface WatcherEvent {
+    /** Type of file system event */
+    type: WatcherEventType;
+    /** Normalized path relative to project root */
+    path: string;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+}
+export type FileHookType = 'on-save' | 'on-create' | 'on-delete' | 'on-test-pass' | 'on-commit';
+export interface FileHookTypeConfig {
+    /** Whether this hook type is enabled */
+    enabled: boolean;
+    /** Glob patterns to include */
+    include?: string[];
+    /** Glob patterns to exclude */
+    exclude?: string[];
+}
+export interface FileHookConfig {
+    /** Master switch for all file hooks */
+    enabled: boolean;
+    /** Debounce window in milliseconds */
+    debounceMs: number;
+    /** Rate limit per file in milliseconds */
+    rateLimitPerFileMs: number;
+    /** Per-hook-type configuration */
+    hooks: Record<string, FileHookTypeConfig>;
+}
+export interface DebouncerOptions {
+    /** Debounce window in milliseconds (default: 300) */
+    debounceMs?: number;
+    /** Rate limit per file in milliseconds (default: 5000) */
+    rateLimitPerFileMs?: number;
+    /** Rate limit per spec for auto-reconcile in milliseconds (default: 300000) */
+    rateLimitPerSpecMs?: number;
+}
+export interface DebouncerConfig {
+    /** Debounce window in ms (default: 300) */
+    debounceMs: number;
+    /** Rate limit per file in ms (default: 5000) */
+    rateLimitPerFileMs: number;
+    /** Rate limit per spec in ms for auto-reconcile (default: 300000 = 5 min) */
+    rateLimitPerSpecMs: number;
+}
+export interface TokenBucket {
+    tokens: number;
+    lastRefill: number;
+    capacity: number;
+    refillIntervalMs: number;
+}
+export interface FileWatcherOptions {
+    /** Root directory to watch */
+    rootDir: string;
+    /** Glob patterns to include (default: all) */
+    include?: string[];
+    /** Glob patterns to exclude (always includes data/ and node_modules/) */
+    exclude?: string[];
+}
+export interface OnSaveContext {
+    /** Absolute path to project root */
+    projectRoot: string;
+    /** Set of known spec IDs (e.g. from spec store) */
+    knownSpecs: Set<string>;
+}
+export interface SpecFilePlan {
+    /** Spec ID (e.g. "SPEC-042") */
+    specId: string;
+    /** Glob patterns of files planned in this spec */
+    plannedFiles: string[];
+}
+export interface OnCreateContext {
+    /** Active specs with their file plans */
+    specFilePlans: SpecFilePlan[];
+}
+export interface SpecAnnotationIndex {
+    /** Spec ID */
+    specId: string;
+    /** Files that reference this spec via @spec annotations */
+    annotatedFiles: string[];
+}
+export interface OnDeleteContext {
+    /** Index of specs and their annotated files */
+    specAnnotations: SpecAnnotationIndex[];
+}
+export interface OnSaveHookResult {
+    hook: 'on-save';
+    specId: string | null;
+    driftDelta: number;
+    hashChanged: boolean;
+    annotationsValid: boolean;
+}
+export interface OnCreateHookResult {
+    hook: 'on-create';
+    path: string;
+    matchedSpecs: string[];
+    suggestedAnnotations: string[];
+}
+export interface OnDeleteHookResult {
+    hook: 'on-delete';
+    path: string;
+    affectedSpecs: string[];
+    brokenAnnotations: string[];
+}
+export type FileHookResult = OnSaveHookResult | OnCreateHookResult | OnDeleteHookResult;
+export type ConfigChangeCallback = (config: FileHookConfig) => void;
+export type DebouncedCallback = (event: WatcherEvent) => void;
+/** Result from on-test-pass handler */
+export interface OnTestPassHookResult {
+    hook: 'on-test-pass';
+    coverageDelta: Record<string, number>;
+    specsUpdated: string[];
+}
+/** Context for on-test-pass handler */
+export interface OnTestPassContext {
+    /** Path to coverage-summary.json */
+    coveragePath: string;
+    /** Mapping of file patterns to spec IDs via annotations */
+    specAnnotationIndex: SpecAnnotationIndex[];
+    /** Previous coverage data for delta computation */
+    previousCoverage?: Record<string, number>;
+}
+/** Result from on-commit handler */
+export interface OnCommitHookResult {
+    hook: 'on-commit';
+    commitHash: string;
+    reconciledSpecs: string[];
+    integrityResult: {
+        valid: boolean;
+        errors: string[];
+    };
+}
+/** Context for on-commit handler */
+export interface OnCommitContext {
+    /** Absolute path to project root */
+    projectRoot: string;
+    /** Set of known spec IDs */
+    knownSpecs: Set<string>;
+}
+/** Plugin handler for custom hooks */
+export interface HookPluginHandler {
+    /** Unique name for the handler */
+    name: string;
+    /** Hook type this handler processes */
+    hookType: FileHookType;
+    /** Priority (lower = higher priority, default 100) */
+    priority?: number;
+    /** The handler function */
+    execute: (event: WatcherEvent) => Promise<FileHookResult | OnTestPassHookResult | OnCommitHookResult>;
+}
+/** Telemetry data per hook type */
+export interface HookTelemetry {
+    /** Total executions */
+    executionCount: number;
+    /** Average latency in ms */
+    avgLatencyMs: number;
+    /** Number of errors */
+    errorCount: number;
+    /** Error rate (0-1) */
+    errorRate: number;
+    /** Total latency accumulated (internal) */
+    totalLatencyMs: number;
+}
+/** Status returned by HookEngine.status() */
+export interface HookEngineStatus {
+    /** Whether the engine is running */
+    running: boolean;
+    /** Active hooks by type */
+    activeHooks: {
+        name: string;
+        hookType: FileHookType;
+        priority: number;
+    }[];
+    /** Number of pending events */
+    pendingEvents: number;
+    /** Telemetry per hook name */
+    telemetry: Record<string, HookTelemetry>;
+}
+/** Typed event for the EventBus */
+export interface EventBusEvent {
+    /** Unique event ID */
+    id: string;
+    /** Event type discriminator */
+    type: 'file:change' | 'hook:start' | 'hook:complete' | 'hook:error';
+    /** Timestamp in ms */
+    timestamp: number;
+    /** Event-specific data */
+    data: Record<string, unknown>;
+}
+/** Extended hook result union including SPEC-130 types */
+export interface CoverageMetric {
+    total: number;
+    covered: number;
+    skipped: number;
+    pct: number;
+}
+export interface FileCoverage {
+    lines: CoverageMetric;
+    statements: CoverageMetric;
+    functions: CoverageMetric;
+    branches: CoverageMetric;
+}
+export type CoverageSummary = Record<string, FileCoverage>;
+export type ExtendedHookResult = FileHookResult | OnTestPassHookResult | OnCommitHookResult;
+export interface StartHooksInput {
+    /** Absolute path to the project root directory to watch */
+    projectPath: string;
+    /** Hook types to enable */
+    hooks?: string[];
+}
+export interface StopHooksInput {
+    /** Optional reason for stopping the hook engine */
+    reason?: string;
+}
+export interface ConfigureHooksInput {
+    /** Absolute path to the project root directory */
+    projectPath: string;
+    /** Master switch for all hooks */
+    enabled?: boolean;
+    /** Debounce window in milliseconds */
+    debounceMs?: number;
+    /** Rate limit per file in milliseconds */
+    rateLimitPerFileMs?: number;
+    /** Per-hook-type configuration overrides */
+    hooks?: Record<string, {
+        enabled?: boolean;
+        include?: string[];
+        exclude?: string[];
+    }>;
+}
+//# sourceMappingURL=file-hooks.d.ts.map

package/dist/types/file-hooks.d.ts.map

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

package/dist/types/file-hooks.js

@@ -0,0 +1,3 @@
+// types/file-hooks.ts — Domain types for File Event Hooks (SPEC-129)
+export {};
+//# sourceMappingURL=file-hooks.js.map

package/dist/types/file-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hooks.js","sourceRoot":"","sources":["../../src/types/file-hooks.ts"],"names":[],"mappings":"AAAA,qEAAqE"}

package/dist/types/index.d.ts

@@ -75,4 +75,7 @@ export * from './export.js';
 export * from './reverse-engineer.js';
 export * from './frontmatter.js';
 export * from './source-resolution.js';
+export * from './living-spec.js';
+export * from './cli.js';
+export * from './file-hooks.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dist/types/index.js

@@ -76,4 +76,7 @@ export * from './export.js';
 export * from './reverse-engineer.js';
 export * from './frontmatter.js';
 export * from './source-resolution.js';
+export * from './living-spec.js';
+export * from './cli.js';
+export * from './file-hooks.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dist/types/living-spec.d.ts

@@ -0,0 +1,382 @@
+/** A single @spec annotation extracted from source code. */
+export interface SpecAnnotation {
+    /** Spec ID referenced (e.g., "SPEC-120"). */
+    specId: string;
+    /** Acceptance criteria numbers (e.g., [1, 3, 5] from "AC-1,AC-3,AC-5"). */
+    criteria: number[];
+    /** Optional description after the dash. */
+    description: string;
+    /** File where the annotation was found. */
+    file: string;
+    /** Line number (1-based). */
+    line: number;
+    /** Raw annotation text as written in the source. */
+    raw: string;
+}
+/** Result of parsing all @spec annotations from a set of files. */
+export interface AnnotationParseResult {
+    annotations: SpecAnnotation[];
+    fileCount: number;
+    annotatedFileCount: number;
+}
+/** Result of validating annotations against stored specs. */
+export interface AnnotationValidationResult {
+    valid: AnnotationValidationEntry[];
+    invalid: AnnotationValidationEntry[];
+    totalAnnotations: number;
+    validCount: number;
+    invalidCount: number;
+}
+/** A single annotation validation entry. */
+export interface AnnotationValidationEntry {
+    annotation: SpecAnnotation;
+    reason: string;
+}
+/** Suggestion for annotating a file that lacks annotations. */
+export interface AnnotationSuggestion {
+    file: string;
+    suggestedAnnotation: string;
+    reason: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+/** SHA-256 hash snapshot of a file. */
+export interface FileHashEntry {
+    file: string;
+    hash: string;
+    /** Size in bytes. */
+    size: number;
+    /** ISO timestamp of last snapshot. */
+    snapshotAt: string;
+}
+/** Exported function signature tracked for drift detection. */
+export interface FunctionSignature {
+    name: string;
+    params: string;
+    returnType: string;
+    file: string;
+    line: number;
+}
+/** A complete hash snapshot for a spec, including file hashes and function signatures. */
+export interface SpecHashSnapshot {
+    specId: string;
+    createdAt: string;
+    files: FileHashEntry[];
+    signatures: FunctionSignature[];
+}
+/** Change classification for function signatures. */
+export type SignatureChangeType = 'added' | 'modified' | 'removed';
+/** A single signature change between two snapshots. */
+export interface SignatureChange {
+    name: string;
+    file: string;
+    changeType: SignatureChangeType;
+    /** Previous signature string (empty for 'added'). */
+    before: string;
+    /** Current signature string (empty for 'removed'). */
+    after: string;
+}
+/** File hash diff between two snapshots. */
+export interface FileHashDiff {
+    file: string;
+    /** Previous hash (empty for new files). */
+    previousHash: string;
+    /** Current hash (empty for deleted files). */
+    currentHash: string;
+    /** Criteria linked to this file via annotations. */
+    linkedCriteria: number[];
+}
+/** Report of hash and signature changes for a spec. */
+export interface HashDiffReport {
+    specId: string;
+    changedFiles: FileHashDiff[];
+    signatureChanges: SignatureChange[];
+    unchangedFileCount: number;
+    comparedAt: string;
+}
+/** Extended criterion status that includes annotation-based statuses. */
+export type AnnotatedCriterionStatus = 'met' | 'pending' | 'drift' | 'regression' | 'untracked';
+/** Extended drift report fields for annotation-based mode. */
+export interface AnnotationDriftInfo {
+    annotationCoverage: number;
+    annotatedCriteria: number;
+    totalCriteria: number;
+    regressions: string[];
+    untrackedCriteria: string[];
+}
+/** Entry in the auto-reconciliation log. */
+export interface ReconcileLogEntry {
+    timestamp: string;
+    changeType: 'completion-update' | 'status-flip' | 'hash-update' | 'timestamp-update';
+    specId: string;
+    description: string;
+    previousValue: string;
+    newValue: string;
+}
+/** Classification of reconciliation changes. */
+export type ReconcileChangeClass = 'safe' | 'unsafe';
+/** Input for the validate_annotations tool. */
+export interface ValidateAnnotationsInput {
+    projectId: string;
+    projectPath: string;
+    specId?: string;
+}
+/** Input for the generate_annotations tool. */
+export interface GenerateAnnotationsInput {
+    projectId: string;
+    projectPath: string;
+    specId: string;
+}
+/** Input for the snapshot_spec_hashes tool. */
+export interface SnapshotSpecHashesInput {
+    projectId: string;
+    specId: string;
+}
+/** Input for the auto_reconcile tool. */
+export interface AutoReconcileInput {
+    projectId: string;
+    specId?: string;
+    changedFiles?: string[];
+}
+/** Result of auto-reconciliation. */
+export interface AutoReconcileResult {
+    specId: string;
+    appliedChanges: ReconcileLogEntry[];
+    skippedUnsafe: string[];
+    rateLimited: boolean;
+    reconciledAt: string;
+}
+/** Options for creating a drift watcher. */
+export interface DriftWatcherOptions {
+    /** TTL in seconds for cached drift entries. Default 60. */
+    ttlSeconds?: number;
+    /** Glob patterns to exclude from watching. */
+    excludePatterns?: string[];
+    /** Project ID to watch. */
+    projectId: string;
+}
+/** In-memory state of the drift watcher. */
+export interface DriftWatcherState {
+    /** Whether the watcher is currently running. */
+    running: boolean;
+    /** ISO timestamp when the watcher was started. */
+    startedAt: string | null;
+    /** Number of cached entries. */
+    cacheSize: number;
+    /** Project ID being watched. */
+    projectId: string;
+}
+/** A single cached drift entry. */
+export interface DriftCacheEntry {
+    /** Spec ID this entry is for. */
+    specId: string;
+    /** Cached drift report data. */
+    data: HashDiffReport;
+    /** ISO timestamp when the entry was cached. */
+    cachedAt: string;
+    /** ISO timestamp when the entry expires. */
+    expiresAt: string;
+}
+/** Drift watcher instance interface. */
+export interface DriftWatcherInstance {
+    start: () => void;
+    stop: () => void;
+    status: () => DriftWatcherState;
+    invalidate: (specId?: string) => void;
+    getCachedDrift: (specId: string) => DriftCacheEntry | null;
+    setCachedDrift: (specId: string, data: HashDiffReport) => void;
+}
+/** Minimal spec shape needed for dashboard collection. */
+export interface DashboardSpecInput {
+    id: string;
+    status: string;
+    completion: number;
+}
+/** A single spec entry for the living dashboard. */
+export interface DashboardSpecEntry {
+    specId: string;
+    status: string;
+    completion: number;
+    driftDetected: boolean;
+    changedFileCount: number;
+    signatureChangeCount: number;
+    lastCheckedAt: string;
+}
+/** Summary statistics for the dashboard. */
+export interface DashboardSummary {
+    totalSpecs: number;
+    specsWithDrift: number;
+    averageCompletion: number;
+    healthScore: number;
+    generatedAt: string;
+}
+/** A single trend data point. */
+export interface DashboardTrendPoint {
+    timestamp: string;
+    specsWithDrift: number;
+    averageCompletion: number;
+    healthScore: number;
+}
+/** A row in the spec diff table. */
+export interface SpecDiffRow {
+    specId: string;
+    file: string;
+    previousHash: string;
+    currentHash: string;
+    status: 'added' | 'modified' | 'removed';
+}
+/** Status of a criterion's test coverage. */
+export type CriterionCoverageStatus = 'verified' | 'regression' | 'untested';
+/** Coverage information for a group of annotations. */
+export interface AnnotationCoverageGroup {
+    specId: string;
+    criterion: number;
+    status: CriterionCoverageStatus;
+    testCount: number;
+    passCount: number;
+    failCount: number;
+    files: string[];
+}
+/** Full test coverage report correlated with specs (living-spec). */
+export interface LivingSpecCoverageReport {
+    projectId: string;
+    groups: AnnotationCoverageGroup[];
+    totalTests: number;
+    passedTests: number;
+    failedTests: number;
+    coveragePercentage: number;
+    generatedAt: string;
+}
+/** Minimal shape of a Vitest JSON test result. */
+export interface VitestTestResult {
+    name: string;
+    status: 'passed' | 'failed' | 'skipped' | 'pending';
+    duration?: number;
+}
+/** Minimal shape of a Vitest JSON test file. */
+export interface VitestFileResult {
+    filepath: string;
+    tests: VitestTestResult[];
+}
+/** Minimal shape of the full Vitest JSON report. */
+export interface VitestJsonReport {
+    testResults: VitestFileResult[];
+}
+/** A single test case from JUnit XML. */
+export interface JUnitTestCase {
+    name: string;
+    classname: string;
+    file: string;
+    passed: boolean;
+}
+/** A normalized test result for grouping. */
+export interface NormalizedTestResult {
+    name: string;
+    file: string;
+    passed: boolean;
+}
+/** Direction of synchronization. */
+export type SyncDirection = 'spec-to-code' | 'code-to-spec';
+/** Criterion info for TODO generation. */
+export interface CriterionInfo {
+    specId: string;
+    criterion: number;
+    description: string;
+    status: string;
+}
+/** A TODO comment to be generated in code. */
+export interface TodoComment {
+    file: string;
+    line: number;
+    text: string;
+    specId: string;
+    criterion: number;
+}
+/** A progress update to apply to a spec. */
+export interface ProgressUpdate {
+    specId: string;
+    criterion: number;
+    previousStatus: string;
+    newStatus: string;
+    reason: string;
+}
+/** A conflict detected during sync. */
+export interface SyncConflict {
+    id: string;
+    specId: string;
+    criterion: number;
+    direction: SyncDirection;
+    description: string;
+    codeState: string;
+    specState: string;
+    detectedAt: string;
+    resolved: boolean;
+    resolution?: string;
+}
+/** An entry in the sync log. */
+export interface SyncLogEntry {
+    timestamp: string;
+    direction: SyncDirection;
+    specId: string;
+    action: string;
+    details: string;
+}
+/** Result of a sync operation. */
+export interface SyncResult {
+    direction: SyncDirection;
+    specId: string;
+    todosGenerated: TodoComment[];
+    progressUpdates: ProgressUpdate[];
+    conflicts: SyncConflict[];
+    logEntries: SyncLogEntry[];
+    syncedAt: string;
+}
+/** Input for the living_spec_watch tool. */
+export interface LivingSpecWatchInput {
+    projectId: string;
+    action: 'start' | 'stop' | 'status';
+    ttlSeconds?: number;
+    excludePatterns?: string[];
+}
+/** Input for the living_spec_status tool. */
+export interface LivingSpecStatusInput {
+    projectId: string;
+    specId?: string;
+}
+/** Input for the spec_diff tool. */
+export interface SpecDiffInput {
+    projectId: string;
+    specId?: string;
+}
+/** Input for the living_spec_coverage tool. */
+export interface LivingSpecCoverageInput {
+    projectId: string;
+    coverageJsonPath?: string;
+    junitXmlPath?: string;
+}
+/** Input for the sync_spec_to_code tool. */
+export interface SyncSpecToCodeInput {
+    projectId: string;
+    specId: string;
+    projectPath: string;
+}
+/** Input for the sync_code_to_spec tool. */
+export interface SyncCodeToSpecInput {
+    projectId: string;
+    specId: string;
+    projectPath: string;
+}
+/** Input for the resolve_sync_conflict tool. */
+export interface ResolveSyncConflictInput {
+    projectId: string;
+    conflictId: string;
+    resolution: 'accept-code' | 'accept-spec' | 'manual';
+    manualResolution?: string;
+}
+/** Dashboard data persisted to disk. */
+export interface LivingDashboardData {
+    entries: DashboardSpecEntry[];
+    summary: DashboardSummary;
+    trends: DashboardTrendPoint[];
+    updatedAt: string;
+}
+//# sourceMappingURL=living-spec.d.ts.map