@kintsugi-ai/hook 0.1.0

package/.kintsugi/logs/hook.log

@@ -0,0 +1,11 @@
+[2026-09-23T12:36:50.957Z] hook invoked {"argv":["--help"],"cwd":"/Users/munch/Documents/coding/kintsugi/packages/hook","projectDir":"/Users/munch/Documents/coding/kintsugi/packages/hook","stdinBytes":0}
+[2026-09-23T12:36:50.957Z] WARN: stdin was empty — agent sent no hook payload
+[2026-09-23T12:36:50.957Z] agent detected {"agent":"codex","isStopEvent":false,"isExplicitStopEvent":false,"inputKeys":[]}
+[2026-09-23T12:36:50.957Z] non-stop event — deferring visual check to turn end
+[2026-09-23T12:36:53.296Z] hook invoked {"argv":["--event","stop"],"cwd":"/Users/munch/Documents/coding/kintsugi/packages/hook","projectDir":"/Users/munch/Documents/coding/kintsugi/packages/hook","stdinBytes":0}
+[2026-09-23T12:36:53.296Z] agent detected {"agent":"codex","isStopEvent":true,"isExplicitStopEvent":true,"inputKeys":[]}
+[2026-09-23T12:36:53.296Z] config loaded {"devServerUrl":"http://localhost:3000","classifierModel":"kintsugi-hosted"}
+[2026-09-23T12:36:54.063Z] WARN: could not obtain a kintsugi api key: fetch failed
+[2026-09-23T12:36:54.064Z] WARN: no API token found (env KINTSUGI_API_KEY, <project>/.kintsugi/.env, or ~/.kintsugi/.env) — classifier disabled, large diffs will escalate without classification
+[2026-09-23T12:36:54.065Z] flows discovered {"flowsDir":"/Users/munch/Documents/coding/kintsugi/packages/hook/.kintsugi/flows","count":0,"names":[]}
+[2026-09-23T12:36:54.065Z] no recorded flows — nothing to check

package/dist/agent-detect.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Agent type detection and protocol helpers for Claude Code, Codex CLI, and Antigravity (agy).
+ */
+export type AgentType = 'claude-code' | 'codex' | 'agy' | 'unknown';
+export interface HookInput {
+    conversationId?: string;
+    workspacePaths?: string[];
+    transcriptPath?: string;
+    artifactDirectoryPath?: string;
+    terminationReason?: string;
+    toolCall?: {
+        name: string;
+        args?: {
+            TargetFile?: string;
+            CommandLine?: string;
+            [key: string]: unknown;
+        };
+    };
+    hook_event_name?: string;
+    tool_input?: {
+        file_path?: string;
+        path?: string;
+        TargetFile?: string;
+        [key: string]: unknown;
+    };
+    tool_name?: string;
+    session_id?: string;
+    [key: string]: unknown;
+}
+/**
+ * Detects the type of agent invoking the hook.
+ * @param stdin Optional parsed stdin payload to inspect markers.
+ * @returns The detected agent type.
+ */
+export declare function detectAgent(stdin?: HookInput): AgentType;
+/**
+ * Extracts the modified file path from the agent context.
+ * @param agent The type of agent.
+ * @param stdin The input from standard input.
+ * @returns The modified file path, if found.
+ */
+export declare function getModifiedFilePath(agent: AgentType, stdin: HookInput): string | undefined;
+/**
+ * Outputs feedback based on the agent type protocols.
+ * @param agent The type of agent.
+ * @param feedback The formatted feedback string.
+ * @param options Additional metadata such as whether this is a Stop event.
+ */
+export declare function outputFeedback(agent: AgentType, feedback: string, options?: {
+    isStopEvent?: boolean;
+    hasRegression?: boolean;
+}): void;
+/**
+ * Exits the process with the appropriate code for the agent.
+ * @param agent The type of agent.
+ * @param hasRegression Whether a regression was detected.
+ */
+export declare function exitWithResult(agent: AgentType, hasRegression: boolean): never;
+//# sourceMappingURL=agent-detect.d.ts.map

package/dist/agent-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detect.d.ts","sourceRoot":"","sources":["../src/agent-detect.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,SAAS;IAEtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE;YACH,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SAC1B,CAAC;KACL,CAAC;IAGF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KAC1B,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CA2BxD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAuB1F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7D,IAAI,CAqCN;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,GAAG,KAAK,CAY9E"}

package/dist/agent-detect.js

@@ -0,0 +1,123 @@
+/**
+ * Agent type detection and protocol helpers for Claude Code, Codex CLI, and Antigravity (agy).
+ */
+/**
+ * Detects the type of agent invoking the hook.
+ * @param stdin Optional parsed stdin payload to inspect markers.
+ * @returns The detected agent type.
+ */
+export function detectAgent(stdin) {
+    // 1. Explicit Antigravity (agy) payload markers in stdin
+    if (stdin?.conversationId ||
+        stdin?.transcriptPath ||
+        stdin?.toolCall) {
+        return 'agy';
+    }
+    // 2. Explicit Claude Code markers
+    if (process.env.CLAUDE_SESSION_ID || process.env.CLAUDE_FILE_PATH) {
+        return 'claude-code';
+    }
+    // 3. Explicit Codex payload marker (tool_input without agy headers)
+    if (stdin?.tool_input && !stdin?.conversationId) {
+        return 'codex';
+    }
+    // 4. Ambient environment markers
+    if (process.env.ANTIGRAVITY_AGENT || process.env.GEMINI_CLI) {
+        return 'agy';
+    }
+    // 5. Default fallback
+    return 'codex';
+}
+/**
+ * Extracts the modified file path from the agent context.
+ * @param agent The type of agent.
+ * @param stdin The input from standard input.
+ * @returns The modified file path, if found.
+ */
+export function getModifiedFilePath(agent, stdin) {
+    if (agent === 'agy') {
+        return (stdin?.toolCall?.args?.TargetFile ||
+            stdin?.toolCall?.args?.['target_file'] ||
+            stdin?.tool_input?.TargetFile ||
+            stdin?.tool_input?.file_path);
+    }
+    if (agent === 'claude-code') {
+        return (process.env.CLAUDE_FILE_PATH ||
+            stdin?.tool_input?.file_path ||
+            stdin?.tool_input?.['filePath']);
+    }
+    return (stdin?.tool_input?.file_path ||
+        stdin?.tool_input?.path ||
+        stdin?.tool_input?.TargetFile);
+}
+/**
+ * Outputs feedback based on the agent type protocols.
+ * @param agent The type of agent.
+ * @param feedback The formatted feedback string.
+ * @param options Additional metadata such as whether this is a Stop event.
+ */
+export function outputFeedback(agent, feedback, options) {
+    if (agent === 'agy') {
+        if (options?.isStopEvent) {
+            if (options.hasRegression) {
+                // Antigravity Stop Hook protocol: continue execution loop with reason
+                const response = {
+                    decision: 'continue',
+                    reason: feedback
+                };
+                process.stdout.write(JSON.stringify(response, null, 2) + '\n');
+            }
+            else {
+                process.stdout.write('{}\n');
+            }
+        }
+        else {
+            // Antigravity PostToolUse contract expects empty JSON {}
+            process.stdout.write('{}\n');
+        }
+    }
+    else if (agent === 'claude-code') {
+        if (options?.isStopEvent) {
+            // Claude Code Stop-hook contract: {"decision":"block"} keeps the
+            // agent working with `reason` as the feedback. Plain stdout text
+            // would not reach the model on a Stop event.
+            if (options.hasRegression) {
+                const response = {
+                    decision: 'block',
+                    reason: feedback
+                };
+                process.stdout.write(JSON.stringify(response, null, 2) + '\n');
+            }
+            else {
+                process.stdout.write('{}\n');
+            }
+        }
+        else {
+            process.stdout.write(feedback + '\n');
+        }
+    }
+    else {
+        process.stderr.write(feedback + '\n');
+    }
+}
+/**
+ * Exits the process with the appropriate code for the agent.
+ * @param agent The type of agent.
+ * @param hasRegression Whether a regression was detected.
+ */
+export function exitWithResult(agent, hasRegression) {
+    if (agent === 'agy') {
+        // Antigravity communicates decisions via JSON on stdout, with exit code 0
+        process.exit(0);
+    }
+    else if (agent === 'claude-code') {
+        // Claude always expects exit 0; feedback is passed via stdout
+        process.exit(0);
+    }
+    else if (agent === 'codex') {
+        // Codex expects exit 2 for failure (reject action)
+        process.exit(hasRegression ? 2 : 0);
+    }
+    process.exit(0);
+}
+//# sourceMappingURL=agent-detect.js.map

package/dist/agent-detect.js.map

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

package/dist/agent-detect.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-detect.test.d.ts.map

package/dist/agent-detect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detect.test.d.ts","sourceRoot":"","sources":["../src/agent-detect.test.ts"],"names":[],"mappings":""}

package/dist/agent-detect.test.js

@@ -0,0 +1,42 @@
+import { test, describe } from 'node:test';
+import assert from 'node:assert/strict';
+import { detectAgent, getModifiedFilePath } from './agent-detect.js';
+describe('Agent Detection & Protocol Adaptation', () => {
+    test('detects Antigravity (agy) from stdin payload markers', () => {
+        const agyPayload = {
+            conversationId: '550e8400-e29b-41d4-a716-446655440000',
+            workspacePaths: ['/workspace/kintsugi'],
+            toolCall: {
+                name: 'write_to_file',
+                args: {
+                    TargetFile: 'src/components/Checkout.tsx',
+                }
+            }
+        };
+        const detected = detectAgent(agyPayload);
+        assert.equal(detected, 'agy');
+        const filePath = getModifiedFilePath(detected, agyPayload);
+        assert.equal(filePath, 'src/components/Checkout.tsx');
+    });
+    test('detects Antigravity from Stop event payload', () => {
+        const stopPayload = {
+            conversationId: '550e8400-e29b-41d4-a716-446655440000',
+            terminationReason: 'model_stop',
+            fullyIdle: true
+        };
+        const detected = detectAgent(stopPayload);
+        assert.equal(detected, 'agy');
+    });
+    test('extracts modified file path from Codex tool input', () => {
+        const codexPayload = {
+            tool_input: {
+                file_path: 'src/Navbar.tsx'
+            }
+        };
+        const detected = detectAgent(codexPayload);
+        assert.equal(detected, 'codex');
+        const filePath = getModifiedFilePath(detected, codexPayload);
+        assert.equal(filePath, 'src/Navbar.tsx');
+    });
+});
+//# sourceMappingURL=agent-detect.test.js.map

package/dist/agent-detect.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detect.test.js","sourceRoot":"","sources":["../src/agent-detect.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EACH,WAAW,EACX,mBAAmB,EAEtB,MAAM,mBAAmB,CAAC;AAE3B,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACnD,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,UAAU,GAAc;YAC1B,cAAc,EAAE,sCAAsC;YACtD,cAAc,EAAE,CAAC,qBAAqB,CAAC;YACvC,QAAQ,EAAE;gBACN,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE;oBACF,UAAU,EAAE,6BAA6B;iBAC5C;aACJ;SACJ,CAAC;QAEF,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE9B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,6BAA6B,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,WAAW,GAAc;YAC3B,cAAc,EAAE,sCAAsC;YACtD,iBAAiB,EAAE,YAAY;YAC/B,SAAS,EAAE,IAAI;SAClB,CAAC;QAEF,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,YAAY,GAAc;YAC5B,UAAU,EAAE;gBACR,SAAS,EAAE,gBAAgB;aAC9B;SACJ,CAAC;QAEF,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEhC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,10 @@
+import type { HookInput } from './agent-detect.js';
+/**
+ * Best-effort extraction of "what was the agent asked to do" from the latest
+ * turn, to give the vision classifier intent context. Claude Code Stop
+ * payloads carry `transcript_path` (JSONL); Antigravity carries
+ * `transcriptPath`. Codex has none — return empty and let the classifier
+ * decide without context.
+ */
+export declare function extractTurnContext(input: HookInput): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAmC3D"}

package/dist/context.js

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+const MAX_CONTEXT_CHARS = 600;
+/**
+ * Best-effort extraction of "what was the agent asked to do" from the latest
+ * turn, to give the vision classifier intent context. Claude Code Stop
+ * payloads carry `transcript_path` (JSONL); Antigravity carries
+ * `transcriptPath`. Codex has none — return empty and let the classifier
+ * decide without context.
+ */
+export function extractTurnContext(input) {
+    const transcriptPath = (typeof input.transcript_path === 'string' && input.transcript_path) ||
+        input.transcriptPath;
+    if (!transcriptPath)
+        return '';
+    try {
+        const content = fs.readFileSync(transcriptPath, 'utf-8');
+        const userTexts = [];
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            let entry;
+            try {
+                entry = JSON.parse(trimmed);
+            }
+            catch {
+                continue;
+            }
+            const text = extractUserText(entry);
+            if (text)
+                userTexts.push(text);
+        }
+        const context = userTexts.slice(-2).join(' | ');
+        return context.length > MAX_CONTEXT_CHARS
+            ? context.slice(0, MAX_CONTEXT_CHARS) + '…'
+            : context;
+    }
+    catch (err) {
+        // ENOENT is expected when the agent has no transcript — everything else is unusual
+        const isNotFound = typeof err === 'object' && err !== null && 'code' in err && err.code === 'ENOENT';
+        if (!isNotFound) {
+            console.warn(`kintsugi: failed to read transcript at ${transcriptPath}:`, err);
+        }
+        return '';
+    }
+}
+function extractUserText(entry) {
+    // Claude Code transcript entries: { type: "user", message: { role: "user", content: string | [{type:"text",text}] } }
+    const message = entry?.message ?? entry;
+    const role = message?.role ?? entry?.type;
+    if (role !== 'user' && role !== 'human')
+        return undefined;
+    // Skip tool results / interrupt notices — only real instructions help
+    if (entry?.type === 'tool_result')
+        return undefined;
+    const content = message?.content;
+    if (typeof content === 'string' && content.trim()) {
+        return isNoise(content) ? undefined : content.trim();
+    }
+    if (Array.isArray(content)) {
+        const text = content
+            .filter((c) => c?.type === 'text' && typeof c.text === 'string')
+            .map((c) => c.text)
+            .join(' ')
+            .trim();
+        return text && !isNoise(text) ? text : undefined;
+    }
+    return undefined;
+}
+/** Filters transcript noise like system-injected reminders and empty interrupts. */
+function isNoise(text) {
+    const t = text.trim();
+    if (!t)
+        return true;
+    if (t.startsWith('<'))
+        return true;
+    if (t === '[Request interrupted by user]')
+        return true;
+    return false;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/escalation.d.ts

@@ -0,0 +1,28 @@
+import type { ComparisonResult } from '@kintsugi-ai/core';
+export interface EscalationSignal {
+    flowName: string;
+    result: ComparisonResult;
+    oldVideoPath?: string;
+    newVideoPath?: string;
+    timestamp: string;
+    attempt: number;
+    maxAttempts: number;
+}
+/**
+ * Writes an escalation signal for the VS Code extension.
+ * @param projectDir The project directory.
+ * @param signal The escalation signal data.
+ */
+export declare function writeEscalation(projectDir: string, signal: EscalationSignal): Promise<void>;
+/**
+ * Reads the current escalation signal.
+ * @param projectDir The project directory.
+ * @returns The current escalation signal or null if not found.
+ */
+export declare function readEscalation(projectDir: string): Promise<EscalationSignal | null>;
+/**
+ * Clears the escalation signal.
+ * @param projectDir The project directory.
+ */
+export declare function clearEscalation(projectDir: string): Promise<void>;
+//# sourceMappingURL=escalation.d.ts.map

package/dist/escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../src/escalation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACvB;AAMD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjG;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAQzF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvE"}

package/dist/escalation.js

@@ -0,0 +1,48 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+function getEscalationFilePath(projectDir) {
+    return path.join(projectDir, '.kintsugi', '.escalation.json');
+}
+/**
+ * Writes an escalation signal for the VS Code extension.
+ * @param projectDir The project directory.
+ * @param signal The escalation signal data.
+ */
+export async function writeEscalation(projectDir, signal) {
+    const filePath = getEscalationFilePath(projectDir);
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(signal, null, 2), 'utf-8');
+}
+/**
+ * Reads the current escalation signal.
+ * @param projectDir The project directory.
+ * @returns The current escalation signal or null if not found.
+ */
+export async function readEscalation(projectDir) {
+    const filePath = getEscalationFilePath(projectDir);
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Clears the escalation signal.
+ * @param projectDir The project directory.
+ */
+export async function clearEscalation(projectDir) {
+    const filePath = getEscalationFilePath(projectDir);
+    try {
+        await fs.unlink(filePath);
+    }
+    catch (err) {
+        const isNotFound = typeof err === 'object' && err !== null && 'code' in err && err.code === 'ENOENT';
+        if (!isNotFound) {
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=escalation.js.map

package/dist/escalation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.js","sourceRoot":"","sources":["../src/escalation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAa7B,SAAS,qBAAqB,CAAC,UAAkB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB,EAAE,MAAwB;IAC9E,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACnD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB;IACpD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,IAAI,GAAG,IAAK,GAAwB,CAAC,IAAI,KAAK,QAAQ,CAAC;QAC3H,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/flow-matcher.d.ts

@@ -0,0 +1,9 @@
+import type { FlowMetadata } from '@kintsugi-ai/core';
+/**
+ * Determines which flows are affected by a file change.
+ * @param filePath The modified file path.
+ * @param flows The list of available flows.
+ * @returns Array of affected flow names.
+ */
+export declare function findAffectedFlows(filePath: string, flows: FlowMetadata[]): string[];
+//# sourceMappingURL=flow-matcher.d.ts.map

package/dist/flow-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-matcher.d.ts","sourceRoot":"","sources":["../src/flow-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAInF"}

package/dist/flow-matcher.js

@@ -0,0 +1,12 @@
+/**
+ * Determines which flows are affected by a file change.
+ * @param filePath The modified file path.
+ * @param flows The list of available flows.
+ * @returns Array of affected flow names.
+ */
+export function findAffectedFlows(filePath, flows) {
+    // A conservative approach: for now, assume all flows might be affected by the UI change.
+    // Future enhancements can check if the file path matches explicit mappings.
+    return flows.map(f => f.name);
+}
+//# sourceMappingURL=flow-matcher.js.map

package/dist/flow-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-matcher.js","sourceRoot":"","sources":["../src/flow-matcher.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAqB;IACrE,yFAAyF;IACzF,4EAA4E;IAC5E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}