@planu/cli 0.99.0 → 1.0.1

package/dist/engine/agent-orchestrator/index.js

@@ -0,0 +1,131 @@
+// engine/agent-orchestrator/index.ts — SPEC-331: Declarative Multi-Agent Orchestration
+// Generates a structured OrchestrationPlan from an approved spec.
+// Pure: no network calls; reads spec data already passed in by the handler.
+import { readFileContent } from './spec-reader.js';
+import { partitionFiles } from './file-partitioner.js';
+import { buildCoordinatorPrompt } from './coordinator-prompt.js';
+import { buildSpecialistPrompt } from './specialist-prompt.js';
+import { buildVerifierPrompt } from './verifier-prompt.js';
+import { buildExecutionGuide } from './execution-guide.js';
+/**
+ * Generate a declarative multi-agent orchestration plan from a spec.
+ *
+ * @param spec        - Spec metadata from spec-store
+ * @param agentCount  - Number of specialist agents (2–8)
+ * @param projectPath - Absolute path to the project root
+ */
+export async function generateOrchestrationPlan(spec, agentCount, projectPath) {
+    const count = Math.max(2, Math.min(8, agentCount));
+    // Read spec markdown content (acceptance criteria, technical file list)
+    const specContent = await readFileContent(spec.specPath, projectPath);
+    const technicalContent = await readFileContent(spec.technicalPath, projectPath);
+    // Extract acceptance criteria lines from spec markdown
+    const criteria = extractCriteria(specContent);
+    // Extract file list from technical.md (or fall back to logical layers)
+    const allFiles = extractFiles(technicalContent);
+    // Partition files across N specialist workstreams (non-overlapping)
+    const workstreams = partitionFiles(allFiles, count);
+    // Build roles
+    const roles = [];
+    // Wave 1 — Coordinator
+    roles.push({
+        role: 'coordinator',
+        name: 'Coordinator',
+        files: [],
+        wave: 1,
+        prompt: buildCoordinatorPrompt({ spec, specContent, technicalContent, count }),
+    });
+    // Wave 2 — Specialists (parallel)
+    for (let i = 0; i < count; i++) {
+        const files = workstreams[i] ?? [];
+        const label = deriveLabel(files, i);
+        roles.push({
+            role: 'specialist',
+            name: `Specialist-${String(i + 1)}: ${label}`,
+            files,
+            wave: 2,
+            prompt: buildSpecialistPrompt({
+                spec,
+                specContent,
+                index: i + 1,
+                label,
+                files,
+                criteria,
+                totalSpecialists: count,
+            }),
+        });
+    }
+    // Wave 3 — Verifier
+    roles.push({
+        role: 'verifier',
+        name: 'Verifier',
+        files: allFiles,
+        wave: 3,
+        prompt: buildVerifierPrompt({ spec, criteria, allFiles }),
+    });
+    return {
+        specId: spec.id,
+        specTitle: spec.title,
+        agentCount: count,
+        totalWaves: 3,
+        roles,
+        executionGuide: buildExecutionGuide({ spec, count, roles }),
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function extractCriteria(specContent) {
+    const lines = specContent.split('\n');
+    return lines
+        .filter((l) => /^\s*-\s*\[[ x]\]/.test(l))
+        .map((l) => l.replace(/^\s*-\s*\[[ x]\]\s*/, '').trim())
+        .filter((l) => l.length > 0);
+}
+function extractFiles(technicalContent) {
+    if (!technicalContent) {
+        // Fallback to logical layers when no technical.md available
+        return ['src/storage/', 'src/engine/', 'src/tools/', 'tests/'];
+    }
+    const lines = technicalContent.split('\n');
+    const files = [];
+    const filePattern = /`([^`]+\.[a-zA-Z]+)`|^\s*[-*]\s+(src\/[^\s]+|tests\/[^\s]+)/;
+    for (const line of lines) {
+        const match = filePattern.exec(line);
+        if (match) {
+            const candidate = (match[1] ?? match[2] ?? '').trim();
+            if (candidate.length > 0 && !files.includes(candidate)) {
+                files.push(candidate);
+            }
+        }
+    }
+    if (files.length === 0) {
+        return ['src/storage/', 'src/engine/', 'src/tools/', 'tests/'];
+    }
+    return files;
+}
+function deriveLabel(files, index) {
+    if (files.length === 0) {
+        return `Workstream ${String(index + 1)}`;
+    }
+    // Heuristic: derive label from most common path segment
+    const segments = files.flatMap((f) => f.split('/').filter(Boolean));
+    const freq = new Map();
+    for (const seg of segments) {
+        freq.set(seg, (freq.get(seg) ?? 0) + 1);
+    }
+    // Ignore generic segments
+    const ignored = new Set(['src', 'tests', 'ts', 'js', 'index']);
+    const ranked = [...freq.entries()]
+        .filter(([k]) => !ignored.has(k) && k.length > 2)
+        .sort((a, b) => b[1] - a[1]);
+    const top = ranked[0];
+    if (top) {
+        return capitalize(top[0]);
+    }
+    return `Workstream ${String(index + 1)}`;
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/agent-orchestrator/index.js.map

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

package/dist/engine/agent-orchestrator/spec-reader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read a spec file's content.
+ * Returns empty string if the file does not exist or the path is empty.
+ */
+export declare function readFileContent(filePath: string | undefined, projectPath: string): Promise<string>;
+//# sourceMappingURL=spec-reader.d.ts.map

package/dist/engine/agent-orchestrator/spec-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-reader.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/spec-reader.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/engine/agent-orchestrator/spec-reader.js

@@ -0,0 +1,20 @@
+// engine/agent-orchestrator/spec-reader.ts — Read spec file content from disk
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+/**
+ * Read a spec file's content.
+ * Returns empty string if the file does not exist or the path is empty.
+ */
+export async function readFileContent(filePath, projectPath) {
+    if (!filePath) {
+        return '';
+    }
+    try {
+        const absolute = filePath.startsWith('/') ? filePath : resolve(projectPath, filePath);
+        return await readFile(absolute, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=spec-reader.js.map

package/dist/engine/agent-orchestrator/spec-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-reader.js","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/spec-reader.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAA4B,EAC5B,WAAmB;IAEnB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACtF,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/engine/agent-orchestrator/specialist-prompt.d.ts

@@ -0,0 +1,3 @@
+import type { SpecialistPromptInput } from '../../types/agent-orchestration.js';
+export declare function buildSpecialistPrompt(input: SpecialistPromptInput): string;
+//# sourceMappingURL=specialist-prompt.d.ts.map

package/dist/engine/agent-orchestrator/specialist-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-prompt.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/specialist-prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAEhF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CA0D1E"}

package/dist/engine/agent-orchestrator/specialist-prompt.js

@@ -0,0 +1,56 @@
+// engine/agent-orchestrator/specialist-prompt.ts — Build specialist agent prompts
+export function buildSpecialistPrompt(input) {
+    const { spec, index, label, files, criteria, totalSpecialists } = input;
+    const fileList = files.length > 0
+        ? files.map((f) => `  - \`${f}\``).join('\n')
+        : '  - (See Coordinator workstream breakdown for your assigned files)';
+    const criteriaSection = criteria.length > 0
+        ? criteria.map((c) => `- [ ] ${c}`).join('\n')
+        : '- [ ] (Refer to spec.md for your assigned acceptance criteria)';
+    return `# Specialist-${String(index)} Agent: ${label} — ${spec.id}: ${spec.title}
+
+## Your Role
+You are **Specialist-${String(index)} (${label})** for implementing SPEC **${spec.id}**.
+You work in parallel with ${String(totalSpecialists - 1)} other Specialist(s). Each specialist has exclusive file ownership — you must NOT modify files outside your list.
+
+## Model Recommendation
+Use **claude-sonnet** for implementation tasks.
+
+## Your Exclusive File Ownership
+${fileList}
+
+Do NOT create or modify files outside this list. If you discover a shared dependency, coordinate with the Coordinator's workstream breakdown.
+
+## Acceptance Criteria (full list — implement the ones in your workstream)
+${criteriaSection}
+
+## Spec Context
+**ID:** ${spec.id}
+**Title:** ${spec.title}
+**Status:** ${spec.status}
+**Risk:** ${spec.risk}
+
+## Implementation Instructions
+1. Read the Coordinator's workstream breakdown to understand your exact assigned criteria
+2. Implement ONLY the files in your ownership list above
+3. Write tests alongside implementation (same branch of work)
+4. Follow existing codebase conventions: TypeScript strict mode, ES modules, explicit return types
+5. Use \`import type\` for type-only imports
+6. All types must be defined in \`src/types/\` (not alongside implementation)
+7. Run \`pnpm typecheck && pnpm lint\` before finishing
+
+## Success Criteria
+- All acceptance criteria assigned to you are implemented and tested
+- \`pnpm typecheck\` passes with 0 errors
+- \`pnpm lint\` passes with 0 warnings
+- No files modified outside your exclusive ownership list
+- Code coverage for your files ≥ 95%
+
+## Output When Done
+Report back:
+1. Files created/modified
+2. Acceptance criteria implemented (checked off)
+3. Any open questions or blockers for the Verifier
+`;
+}
+//# sourceMappingURL=specialist-prompt.js.map

package/dist/engine/agent-orchestrator/specialist-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-prompt.js","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/specialist-prompt.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAIlF,MAAM,UAAU,qBAAqB,CAAC,KAA4B;IAChE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAExE,MAAM,QAAQ,GACZ,KAAK,CAAC,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7C,CAAC,CAAC,oEAAoE,CAAC;IAE3E,MAAM,eAAe,GACnB,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,gEAAgE,CAAC;IAEvE,OAAO,gBAAgB,MAAM,CAAC,KAAK,CAAC,WAAW,KAAK,MAAM,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK;;;uBAG3D,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,+BAA+B,IAAI,CAAC,EAAE;4BACxD,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC;;;;;;EAMtD,QAAQ;;;;;EAKR,eAAe;;;UAGP,IAAI,CAAC,EAAE;aACJ,IAAI,CAAC,KAAK;cACT,IAAI,CAAC,MAAM;YACb,IAAI,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;CAuBpB,CAAC;AACF,CAAC"}

package/dist/engine/agent-orchestrator/verifier-prompt.d.ts

@@ -0,0 +1,3 @@
+import type { VerifierPromptInput } from '../../types/agent-orchestration.js';
+export declare function buildVerifierPrompt(input: VerifierPromptInput): string;
+//# sourceMappingURL=verifier-prompt.d.ts.map

package/dist/engine/agent-orchestrator/verifier-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier-prompt.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/verifier-prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAuEtE"}

package/dist/engine/agent-orchestrator/verifier-prompt.js

@@ -0,0 +1,69 @@
+// engine/agent-orchestrator/verifier-prompt.ts — Build verifier agent prompt
+export function buildVerifierPrompt(input) {
+    const { spec, criteria, allFiles } = input;
+    const criteriaList = criteria.length > 0
+        ? criteria.map((c) => `- [ ] ${c}`).join('\n')
+        : '- [ ] (Read spec.md acceptance criteria section)';
+    /* v8 ignore next 3 */
+    const fileList = allFiles.length > 0
+        ? allFiles.map((f) => `  - \`${f}\``).join('\n')
+        : '  - (Scan the full project for changes related to this spec)';
+    return `# Verifier Agent — ${spec.id}: ${spec.title}
+
+## Your Role
+You are the **Verifier** for SPEC **${spec.id}**. You run AFTER all Specialist agents have completed. Your job is to validate that EVERY acceptance criterion has been correctly implemented.
+
+## Model Recommendation
+Use **claude-opus** for deep validation and cross-cutting analysis.
+
+## Spec Reference
+**ID:** ${spec.id}
+**Title:** ${spec.title}
+**Status:** ${spec.status}
+
+## All Acceptance Criteria to Verify
+${criteriaList}
+
+## Files to Inspect
+${fileList}
+
+## Verification Instructions
+For each acceptance criterion:
+1. Find the implementation in the codebase
+2. Confirm the behavior matches what the criterion specifies
+3. Check edge cases: error paths, empty inputs, boundary values
+4. Verify tests exist and actually cover the criterion
+5. Run \`pnpm typecheck && pnpm lint && pnpm test:coverage\` and confirm all pass
+
+## Cross-Cutting Checks
+- No file ownership violations (each specialist only touched their assigned files)
+- No circular imports introduced
+- Type definitions are in \`src/types/\` (not in engine/tools files)
+- All public functions have explicit return types
+- No \`any\` types introduced
+
+## Output Report (REQUIRED)
+Produce a Verification Report:
+\`\`\`
+## Verification Report — ${spec.id}
+
+### ✅ Criteria Met
+(list each passing criterion with file reference)
+
+### ❌ Criteria Missing or Incorrect
+(list each failing criterion with explanation)
+
+### Test Coverage
+(summarize coverage results)
+
+### Decision: PASS / FAIL
+(if FAIL, list exact actions needed before marking spec done)
+\`\`\`
+
+## Success Criteria
+- All acceptance criteria are implemented and verifiably working
+- \`pnpm test:coverage\` passes with coverage ≥ 95%
+- Verification Report is produced with PASS/FAIL decision
+`;
+}
+//# sourceMappingURL=verifier-prompt.js.map

package/dist/engine/agent-orchestrator/verifier-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier-prompt.js","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/verifier-prompt.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAI7E,MAAM,UAAU,mBAAmB,CAAC,KAA0B;IAC5D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAE3C,MAAM,YAAY,GAChB,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,kDAAkD,CAAC;IAEzD,sBAAsB;IACtB,MAAM,QAAQ,GACZ,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAChD,CAAC,CAAC,8DAA8D,CAAC;IAErE,OAAO,sBAAsB,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK;;;sCAGf,IAAI,CAAC,EAAE;;;;;;UAMnC,IAAI,CAAC,EAAE;aACJ,IAAI,CAAC,KAAK;cACT,IAAI,CAAC,MAAM;;;EAGvB,YAAY;;;EAGZ,QAAQ;;;;;;;;;;;;;;;;;;;;2BAoBiB,IAAI,CAAC,EAAE;;;;;;;;;;;;;;;;;;;CAmBjC,CAAC;AACF,CAAC"}

package/dist/engine/filesystem-watcher/index.d.ts

@@ -0,0 +1,31 @@
+import type { FsHookConfig, FsHooksConfig, FsHookTriggerEvent, FsHookResult } from '../../types/index.js';
+/**
+ * Returns the default hooks configuration (disabled with no hooks).
+ */
+export declare function getDefaultHooksConfig(): FsHooksConfig;
+/**
+ * Loads the hooks configuration from `.planu/hooks.json` in the given project path.
+ * Returns the default config if the file does not exist.
+ */
+export declare function loadHooksConfig(projectPath: string): Promise<FsHooksConfig>;
+/**
+ * Saves the hooks configuration to `.planu/hooks.json` in the given project path.
+ * Creates the `.planu` directory if it does not exist.
+ */
+export declare function saveHooksConfig(projectPath: string, config: FsHooksConfig): Promise<void>;
+/**
+ * Returns true if `filePath` matches the given glob `pattern`.
+ * Supports `**` and `*` wildcards.
+ */
+export declare function matchesPattern(filePath: string, pattern: string): boolean;
+/**
+ * Builds a trigger event for a filesystem hook match.
+ */
+export declare function buildTriggerEvent(event: FsHookConfig['event'], filePath: string, hook: FsHookConfig): FsHookTriggerEvent;
+/**
+ * Finds all hooks in `config` that match the given event and file path,
+ * and returns the result with triggered events.
+ * Does NOT call any tools — pure logic only.
+ */
+export declare function processFileEvent(event: 'on_save' | 'on_create' | 'on_delete', filePath: string, config: FsHooksConfig): FsHookResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/filesystem-watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/filesystem-watcher/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAI9B;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CAErD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAQjF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/F;AAsBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,GACjB,kBAAkB,CAQpB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,EAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,GACpB,YAAY,CAuBd"}

package/dist/engine/filesystem-watcher/index.js

@@ -0,0 +1,101 @@
+// engine/filesystem-watcher/index.ts — SPEC-329: Filesystem watcher engine
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+const HOOKS_FILE = '.planu/hooks.json';
+/**
+ * Returns the default hooks configuration (disabled with no hooks).
+ */
+export function getDefaultHooksConfig() {
+    return { enabled: false, hooks: [] };
+}
+/**
+ * Loads the hooks configuration from `.planu/hooks.json` in the given project path.
+ * Returns the default config if the file does not exist.
+ */
+export async function loadHooksConfig(projectPath) {
+    const filePath = join(projectPath, HOOKS_FILE);
+    try {
+        const raw = await readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return getDefaultHooksConfig();
+    }
+}
+/**
+ * Saves the hooks configuration to `.planu/hooks.json` in the given project path.
+ * Creates the `.planu` directory if it does not exist.
+ */
+export async function saveHooksConfig(projectPath, config) {
+    const dir = join(projectPath, '.planu');
+    await mkdir(dir, { recursive: true });
+    const filePath = join(projectPath, HOOKS_FILE);
+    await writeFile(filePath, JSON.stringify(config, null, 2), 'utf-8');
+}
+/**
+ * Converts a glob pattern to a RegExp.
+ * Supports `**` (any path segments) and `*` (any characters within a segment).
+ * Strategy: split on `*` boundaries to escape non-wildcard parts separately.
+ */
+function patternToRegex(pattern) {
+    // Split by ** first, then by *
+    const parts = pattern.split('**');
+    const regexStr = parts
+        .map((part) => {
+        // Within each ** segment, handle single *
+        return part
+            .split('*')
+            .map((segment) => segment.replace(/[.+^${}()|[\]\\]/g, '\\$&'))
+            .join('[^/]*');
+    })
+        .join('.*');
+    return new RegExp(`^${regexStr}$`);
+}
+/**
+ * Returns true if `filePath` matches the given glob `pattern`.
+ * Supports `**` and `*` wildcards.
+ */
+export function matchesPattern(filePath, pattern) {
+    const regex = patternToRegex(pattern);
+    return regex.test(filePath);
+}
+/**
+ * Builds a trigger event for a filesystem hook match.
+ */
+export function buildTriggerEvent(event, filePath, hook) {
+    return {
+        event,
+        filePath,
+        timestamp: new Date().toISOString(),
+        matchedPattern: hook.pattern,
+        tool: hook.tool,
+    };
+}
+/**
+ * Finds all hooks in `config` that match the given event and file path,
+ * and returns the result with triggered events.
+ * Does NOT call any tools — pure logic only.
+ */
+export function processFileEvent(event, filePath, config) {
+    if (!config.enabled) {
+        return { triggered: 0, events: [], errors: [] };
+    }
+    const events = [];
+    const errors = [];
+    for (const hook of config.hooks) {
+        if (hook.event !== event) {
+            continue;
+        }
+        try {
+            if (matchesPattern(filePath, hook.pattern)) {
+                events.push(buildTriggerEvent(event, filePath, hook));
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            errors.push(`Pattern "${hook.pattern}" error: ${msg}`);
+        }
+    }
+    return { triggered: events.length, events, errors };
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/filesystem-watcher/index.js.map

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

package/dist/engine/living-specs/criteria-matcher.d.ts

@@ -0,0 +1,12 @@
+import type { LivingSpecFileResult, LivingSpecCriteriaMatch } from '../../types/index.js';
+/**
+ * Extract criteria lines from spec.md content.
+ * Returns the text after the `- [ ] ` or `- [x] ` prefix.
+ */
+export declare function extractCriteriaLines(specMdContent: string): string[];
+/**
+ * Match each criterion against the scanned file results.
+ * A criterion is "met" if at least one keyword is found in any file export or path.
+ */
+export declare function matchCriteria(criteriaLines: string[], fileResults: LivingSpecFileResult[]): LivingSpecCriteriaMatch[];
+//# sourceMappingURL=criteria-matcher.d.ts.map

package/dist/engine/living-specs/criteria-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-matcher.d.ts","sourceRoot":"","sources":["../../../src/engine/living-specs/criteria-matcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AA0C1F;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAapE;AAiCD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,EAAE,oBAAoB,EAAE,GAClC,uBAAuB,EAAE,CAc3B"}

package/dist/engine/living-specs/criteria-matcher.js

@@ -0,0 +1,105 @@
+const CRITERIA_LINE_REGEX = /^- \[[ x]\] (.+)$/;
+const STOP_WORDS = new Set([
+    'that',
+    'this',
+    'with',
+    'from',
+    'have',
+    'been',
+    'will',
+    'should',
+    'must',
+    'when',
+    'then',
+    'each',
+    'they',
+    'their',
+    'there',
+    'where',
+    'which',
+    'while',
+    'about',
+    'after',
+    'before',
+    'below',
+    'above',
+    'given',
+    'other',
+    'more',
+    'into',
+    'only',
+    'also',
+    'both',
+    'such',
+    'some',
+    'than',
+    'over',
+    'under',
+]);
+/**
+ * Extract criteria lines from spec.md content.
+ * Returns the text after the `- [ ] ` or `- [x] ` prefix.
+ */
+export function extractCriteriaLines(specMdContent) {
+    const lines = specMdContent.split('\n');
+    const result = [];
+    for (const line of lines) {
+        const match = CRITERIA_LINE_REGEX.exec(line.trimEnd());
+        if (match !== null) {
+            const text = match[1];
+            if (text !== undefined && text.trim().length > 0) {
+                result.push(text.trim());
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Extract meaningful keywords from a criterion string.
+ * Words must be longer than 4 chars and not in the stop-words list.
+ */
+function extractKeywords(criterion) {
+    return criterion
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((word) => word.length > 4 && !STOP_WORDS.has(word));
+}
+/**
+ * Check if any export name or file path contains a given keyword.
+ */
+function findKeywordInFiles(keyword, fileResults) {
+    for (const file of fileResults) {
+        if (!file.exists) {
+            continue;
+        }
+        if (file.path.toLowerCase().includes(keyword)) {
+            return file.path;
+        }
+        for (const exportName of file.exportsFound) {
+            if (exportName.toLowerCase().includes(keyword)) {
+                return file.path;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Match each criterion against the scanned file results.
+ * A criterion is "met" if at least one keyword is found in any file export or path.
+ */
+export function matchCriteria(criteriaLines, fileResults) {
+    return criteriaLines.map((criterion) => {
+        const keywords = extractKeywords(criterion);
+        if (keywords.length === 0) {
+            return { criterion, met: false, evidence: 'No match' };
+        }
+        for (const keyword of keywords) {
+            const foundIn = findKeywordInFiles(keyword, fileResults);
+            if (foundIn !== null) {
+                return { criterion, met: true, evidence: `Found in ${foundIn}` };
+            }
+        }
+        return { criterion, met: false, evidence: 'No match' };
+    });
+}
+//# sourceMappingURL=criteria-matcher.js.map

package/dist/engine/living-specs/criteria-matcher.js.map

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

package/dist/engine/living-specs/file-scanner.d.ts

@@ -0,0 +1,11 @@
+import type { LivingSpecFileResult } from '../../types/index.js';
+/**
+ * Scan a single file: check existence, count lines, extract exports.
+ */
+export declare function scanFile(filePath: string): Promise<LivingSpecFileResult>;
+/**
+ * Extract all file paths referenced in technical.md content (src/ and tests/ paths).
+ * Deduplicates results.
+ */
+export declare function extractFilePaths(technicalMdContent: string): string[];
+//# sourceMappingURL=file-scanner.d.ts.map

package/dist/engine/living-specs/file-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../../src/engine/living-specs/file-scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKjE;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAe9E;AAkBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,EAAE,CAWrE"}