patchwork-os 0.2.0-beta.0 → 0.2.0-beta.10

package/dist/fileLock.js

@@ -39,10 +39,12 @@ export class FileLock {
             if (holder !== sessionId) {
                 return { lockedBySession: holder };
             }
-            // Same session already holds the lock — grant re-entry. The new promise
-            // chains behind the existing one; the caller gets its own release handle.
+            // Same-session re-entry: return a no-op release so we don't overwrite
+            // the live lock-tail promise, which would break the FIFO chain for any
+            // subsequent acquire() caller that chains behind it.
+            return { release: () => { } };
         }
-        // Lock is free (or same-session re-entry) — grant it synchronously.
+        // Lock is free — grant it synchronously.
         let release;
         const next = new Promise((r) => {
             release = r;
@@ -81,18 +83,23 @@ export class FileLock {
             await Promise.race([prev, timeout]);
             clearTimeout(timeoutId);
             if (timedOut) {
-                // Resolve next before throwing so any waiter chained behind us is not
-                // blocked for another full timeout cycle — they get the lock immediately
-                // (even though we do no work) and proceed normally.
-                release();
-                if (this.locks.get(path) === next)
-                    this.locks.delete(path);
+                // Bridge: resolve our slot only after the previous holder actually
+                // releases, so any waiter already chained behind us (awaiting `next`)
+                // gets the lock in FIFO order rather than immediately.
+                // Do NOT delete locks[path] here — the bridge needs it to stay so
+                // a new caller who arrives before prev resolves chains correctly.
+                void prev.then(() => {
+                    release();
+                    if (this.locks.get(path) === next)
+                        this.locks.delete(path);
+                });
                 throw new Error(`Timed out waiting for file lock on "${path}" after ${this.timeoutMs / 1000}s — another session may be editing the same file`);
             }
         }
         catch (err) {
             clearTimeout(timeoutId);
-            if (this.locks.get(path) === next)
+            // Do not delete the lock when timedOut — the bridge above will clean up.
+            if (!timedOut && this.locks.get(path) === next)
                 this.locks.delete(path);
             throw err;
         }
@@ -103,13 +110,15 @@ export class FileLock {
                 this.locks.delete(path);
             throw new Error("Aborted before lock acquired");
         }
-        // Clean up map entry after release so it doesn't grow forever
+        // Clean up map entry after release so it doesn't grow forever.
+        // acquire() does not own the holders map (only tryAcquire writes it),
+        // so we must not unconditionally delete a holders entry that a
+        // concurrent tryAcquire may have written.
         const wrappedRelease = () => {
             signal?.removeEventListener("abort", onAbort);
             release();
             if (this.locks.get(path) === next)
                 this.locks.delete(path);
-            this.holders.delete(path);
         };
         // If the holder is aborted while holding the lock, release automatically
         // so downstream waiters are not blocked for the full timeout period.

package/dist/fileLock.js.map

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

package/dist/fileLockSync.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Tiny cross-process file mutex for synchronous critical sections.
+ *
+ * Used to wrap append-only JSONL writers (`decisionTraceLog`,
+ * `runLog`, `commitIssueLinkLog`) so two bridge processes sharing
+ * one `~/.claude/ide/` log directory can't interleave bytes within a
+ * single row.
+ *
+ * Why ad-hoc instead of `proper-lockfile`? proper-lockfile is the more
+ * featureful option (TTL refresh, retry jitter, async API) but adds a
+ * runtime dependency for a use case the bridge needs only synchronously
+ * in three call-sites. The pattern below — `openSync(file, "wx")` as
+ * the atomic lock primitive plus a stale-lock cleanup heuristic — is
+ * standard for shell-style flock without a native binding.
+ *
+ * ## Semantics
+ *
+ * `withFileLockSync(file, fn)`:
+ *
+ *   1. Attempts to create `${file}.lock` with `O_EXCL` (`flag: "wx"`).
+ *      First writer wins atomically — the kernel rejects EEXIST for
+ *      every other contender.
+ *   2. On EEXIST, polls with a short busy-wait (`Atomics.wait` would
+ *      need a shared SharedArrayBuffer across processes — out of scope;
+ *      hot-loop with `process.hrtime` instead, kernels schedule sleep
+ *      anyway under contention).
+ *   3. If the existing lock is older than `staleLockMs` (default 30s),
+ *      assumes the owner crashed and force-unlinks it before retrying.
+ *      The append-only JSONL writes the bridge does complete in <1ms in
+ *      practice, so 30s is generous.
+ *   4. Runs `fn()`, unlinks the lock in `finally`. Rethrows fn's
+ *      exception.
+ *
+ * Lock granularity is per-file (each log gets its own lock). At the
+ * bridge's write volume (≤ tens/min across all three logs) contention
+ * is effectively zero.
+ *
+ * ## Failure modes
+ *
+ * - **Deadlock-on-crash:** mitigated by the 30s stale-lock TTL. A bridge
+ *   that crashes mid-append leaves the lock until the next contender
+ *   notices it's stale and clears it. The first crash is invisible
+ *   (target file already written); subsequent contenders pay a 30s
+ *   penalty only if they happen to arrive within the window.
+ * - **TOCTOU on stale-lock unlink:** two processes both decide the lock
+ *   is stale and both `unlinkSync`. Second `unlinkSync` ENOENT is
+ *   swallowed. Both then race the `openSync("wx")` — one wins, the
+ *   other goes back to polling. No data corruption.
+ * - **NFS / non-POSIX FS:** O_EXCL is undefined on stale NFSv2; modern
+ *   NFS (≥ v3 with `noac`) and all local FS we ship on (apfs / ext4 /
+ *   ntfs) implement it correctly.
+ *
+ * @param file - The target file the caller is about to write. The lock
+ *   sentinel is `${file}.lock`.
+ * @param fn - Synchronous critical section. Holds the lock for its
+ *   entire duration.
+ * @param opts.timeoutMs - Max wait for the lock before throwing (default
+ *   5000). Use a small value — appends finish in <1ms in practice; a
+ *   timeout this far above the expected duration only fires if
+ *   something genuinely wrong happens.
+ * @param opts.staleLockMs - Age (ms) at which an existing lock is
+ *   considered abandoned and force-unlinked. Default 30000.
+ */
+export declare function withFileLockSync<T>(file: string, fn: () => T, opts?: {
+    timeoutMs?: number;
+    staleLockMs?: number;
+}): T;

package/dist/fileLockSync.js

@@ -0,0 +1,126 @@
+import { closeSync, openSync, statSync, unlinkSync } from "node:fs";
+/**
+ * Tiny cross-process file mutex for synchronous critical sections.
+ *
+ * Used to wrap append-only JSONL writers (`decisionTraceLog`,
+ * `runLog`, `commitIssueLinkLog`) so two bridge processes sharing
+ * one `~/.claude/ide/` log directory can't interleave bytes within a
+ * single row.
+ *
+ * Why ad-hoc instead of `proper-lockfile`? proper-lockfile is the more
+ * featureful option (TTL refresh, retry jitter, async API) but adds a
+ * runtime dependency for a use case the bridge needs only synchronously
+ * in three call-sites. The pattern below — `openSync(file, "wx")` as
+ * the atomic lock primitive plus a stale-lock cleanup heuristic — is
+ * standard for shell-style flock without a native binding.
+ *
+ * ## Semantics
+ *
+ * `withFileLockSync(file, fn)`:
+ *
+ *   1. Attempts to create `${file}.lock` with `O_EXCL` (`flag: "wx"`).
+ *      First writer wins atomically — the kernel rejects EEXIST for
+ *      every other contender.
+ *   2. On EEXIST, polls with a short busy-wait (`Atomics.wait` would
+ *      need a shared SharedArrayBuffer across processes — out of scope;
+ *      hot-loop with `process.hrtime` instead, kernels schedule sleep
+ *      anyway under contention).
+ *   3. If the existing lock is older than `staleLockMs` (default 30s),
+ *      assumes the owner crashed and force-unlinks it before retrying.
+ *      The append-only JSONL writes the bridge does complete in <1ms in
+ *      practice, so 30s is generous.
+ *   4. Runs `fn()`, unlinks the lock in `finally`. Rethrows fn's
+ *      exception.
+ *
+ * Lock granularity is per-file (each log gets its own lock). At the
+ * bridge's write volume (≤ tens/min across all three logs) contention
+ * is effectively zero.
+ *
+ * ## Failure modes
+ *
+ * - **Deadlock-on-crash:** mitigated by the 30s stale-lock TTL. A bridge
+ *   that crashes mid-append leaves the lock until the next contender
+ *   notices it's stale and clears it. The first crash is invisible
+ *   (target file already written); subsequent contenders pay a 30s
+ *   penalty only if they happen to arrive within the window.
+ * - **TOCTOU on stale-lock unlink:** two processes both decide the lock
+ *   is stale and both `unlinkSync`. Second `unlinkSync` ENOENT is
+ *   swallowed. Both then race the `openSync("wx")` — one wins, the
+ *   other goes back to polling. No data corruption.
+ * - **NFS / non-POSIX FS:** O_EXCL is undefined on stale NFSv2; modern
+ *   NFS (≥ v3 with `noac`) and all local FS we ship on (apfs / ext4 /
+ *   ntfs) implement it correctly.
+ *
+ * @param file - The target file the caller is about to write. The lock
+ *   sentinel is `${file}.lock`.
+ * @param fn - Synchronous critical section. Holds the lock for its
+ *   entire duration.
+ * @param opts.timeoutMs - Max wait for the lock before throwing (default
+ *   5000). Use a small value — appends finish in <1ms in practice; a
+ *   timeout this far above the expected duration only fires if
+ *   something genuinely wrong happens.
+ * @param opts.staleLockMs - Age (ms) at which an existing lock is
+ *   considered abandoned and force-unlinked. Default 30000.
+ */
+export function withFileLockSync(file, fn, opts = {}) {
+    const lockFile = `${file}.lock`;
+    const timeoutMs = opts.timeoutMs ?? 5000;
+    const staleLockMs = opts.staleLockMs ?? 30_000;
+    const deadline = Date.now() + timeoutMs;
+    let lockFd = null;
+    while (lockFd === null) {
+        try {
+            // O_EXCL — atomic create; first caller wins.
+            lockFd = openSync(lockFile, "wx", 0o600);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== "EEXIST")
+                throw err;
+            // Stale-lock cleanup. Best-effort: another contender may unlink
+            // ours simultaneously; that race resolves benignly (next openSync
+            // either wins or sees EEXIST again).
+            try {
+                const stat = statSync(lockFile);
+                if (Date.now() - stat.mtimeMs > staleLockMs) {
+                    try {
+                        unlinkSync(lockFile);
+                    }
+                    catch {
+                        /* already gone — another contender beat us to the cleanup */
+                    }
+                    continue;
+                }
+            }
+            catch {
+                // statSync ENOENT — lock cleared between EEXIST and stat; retry
+                // immediately.
+                continue;
+            }
+            if (Date.now() > deadline) {
+                throw new Error(`withFileLockSync: timed out after ${timeoutMs}ms waiting for ${lockFile}`);
+            }
+            // Busy-spin for ~5ms via hrtime. Node has no sync sleep; under
+            // contention the kernel preempts us, so this isn't actually a hot
+            // loop in practice (and tests can pass a 0ms timeout for the
+            // "already locked" case).
+            const spinUntil = process.hrtime.bigint() + 5000000n; // 5ms
+            while (process.hrtime.bigint() < spinUntil) {
+                /* yield */
+            }
+        }
+    }
+    try {
+        closeSync(lockFd);
+        return fn();
+    }
+    finally {
+        try {
+            unlinkSync(lockFile);
+        }
+        catch {
+            /* lock cleared by stale-lock cleanup in another process; ok */
+        }
+    }
+}
+//# sourceMappingURL=fileLockSync.js.map

package/dist/fileLockSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileLockSync.js","sourceRoot":"","sources":["../src/fileLockSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,EAAW,EACX,OAAqD,EAAE;IAEvD,MAAM,QAAQ,GAAG,GAAG,IAAI,OAAO,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,OAAO,MAAM,KAAK,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,6CAA6C;YAC7C,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;YACjC,gEAAgE;YAChE,kEAAkE;YAClE,qCAAqC;YACrC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAChC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,WAAW,EAAE,CAAC;oBAC5C,IAAI,CAAC;wBACH,UAAU,CAAC,QAAQ,CAAC,CAAC;oBACvB,CAAC;oBAAC,MAAM,CAAC;wBACP,6DAA6D;oBAC/D,CAAC;oBACD,SAAS;gBACX,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,gEAAgE;gBAChE,eAAe;gBACf,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,qCAAqC,SAAS,kBAAkB,QAAQ,EAAE,CAC3E,CAAC;YACJ,CAAC;YACD,+DAA+D;YAC/D,kEAAkE;YAClE,6DAA6D;YAC7D,0BAA0B;YAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,QAAU,CAAC,CAAC,MAAM;YAC9D,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;gBAC3C,WAAW;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,SAAS,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/fp/activityAnalytics.js

@@ -3,12 +3,15 @@ const CO_OCCURRENCE_MAP_CAP = 200;
 export function computeStats(entries) {
     const map = new Map();
     for (const entry of entries) {
-        const s = map.get(entry.tool) ?? { count: 0, totalMs: 0, errors: 0 };
+        let s = map.get(entry.tool);
+        if (!s) {
+            s = { count: 0, totalMs: 0, errors: 0 };
+            map.set(entry.tool, s);
+        }
         s.count++;
         s.totalMs += entry.durationMs;
         if (entry.status === "error")
             s.errors++;
-        map.set(entry.tool, s);
     }
     const result = {};
     for (const [tool, s] of map) {
@@ -53,17 +56,21 @@ export function computePercentiles(samples) {
 export function computeCoOccurrence(entries, windowMs, maxPairs = 50) {
     const counts = new Map();
     const n = entries.length;
+    // Pre-compute epoch timestamps once to avoid repeated Date construction in nested loop.
+    const times = new Array(n);
+    for (let k = 0; k < n; k++) {
+        times[k] = Date.parse(entries[k]?.timestamp ?? "");
+    }
     for (let i = 0; i < n; i++) {
         const a = entries[i];
         if (!a)
             continue;
-        const tA = new Date(a.timestamp).getTime();
+        const tA = times[i] ?? 0;
         for (let j = i + 1; j < n; j++) {
             const b = entries[j];
             if (!b)
                 continue;
-            const tB = new Date(b.timestamp).getTime();
-            if (tB - tA > windowMs)
+            if ((times[j] ?? 0) - tA > windowMs)
                 break;
             if (a.tool === b.tool)
                 continue;
@@ -73,10 +80,14 @@ export function computeCoOccurrence(entries, windowMs, maxPairs = 50) {
             counts.set(key, (counts.get(key) ?? 0) + 1);
         }
     }
-    return [...counts.entries()]
-        .map(([pair, count]) => ({ pair, count }))
-        .sort((a, b) => b.count - a.count)
-        .slice(0, maxPairs);
+    const pairs = Array.from(counts.entries());
+    pairs.sort((a, b) => b[1] - a[1]);
+    const result = [];
+    for (let i = 0; i < pairs.length && i < maxPairs; i++) {
+        const [pair, count] = pairs[i];
+        result.push({ pair, count });
+    }
+    return result;
 }
 /**
  * Per-tool stats within a sliding time window.
@@ -89,14 +100,17 @@ export function computeWindowedStats(entries, windowMs, now) {
         const e = entries[i];
         if (!e)
             continue;
-        if (new Date(e.timestamp).getTime() < cutoff)
+        if (Date.parse(e.timestamp) < cutoff)
             break;
-        const s = map.get(e.tool) ?? { count: 0, totalMs: 0, errors: 0 };
+        let s = map.get(e.tool);
+        if (!s) {
+            s = { count: 0, totalMs: 0, errors: 0 };
+            map.set(e.tool, s);
+        }
         s.count++;
         s.totalMs += e.durationMs;
         if (e.status === "error")
             s.errors++;
-        map.set(e.tool, s);
     }
     const result = {};
     for (const [tool, s] of map) {

package/dist/fp/activityAnalytics.js.map

@@ -1 +1 @@
-{"version":3,"file":"activityAnalytics.js","sourceRoot":"","sources":["../../src/fp/activityAnalytics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"activityAnalytics.js","sourceRoot":"","sources":["../../src/fp/activityAnalytics.ts"],"names":[],"mappings":"AAMA,2FAA2F;AAC3F,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,MAAM,UAAU,YAAY,CAC1B,OAAiC;IAEjC,MAAM,GAAG,GAAG,IAAI,GAAG,EAGhB,CAAC;IACJ,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACxC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,CAAC,CAAC,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;YAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,MAAM,GAGR,EAAE,CAAC;IACP,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC;YAC9C,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iEAAiE;AACjE,SAAS,eAAe,CAAC,MAAgB,EAAE,GAAW;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA+C;IAK/C,MAAM,MAAM,GAGR,EAAE,CAAC;IACP,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC7B,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAChC,GAAG,EAAE,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAChC,GAAG,EAAE,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAChC,WAAW,EAAE,MAAM,CAAC,MAAM;SAC3B,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiC,EACjC,QAAgB,EAChB,QAAQ,GAAG,EAAE;IAEb,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACzB,wFAAwF;IACxF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,QAAQ;gBAAE,MAAM;YAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;gBAAE,SAAS;YAChC,MAAM,GAAG,GACP,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAClE,IAAI,MAAM,CAAC,IAAI,IAAI,qBAAqB;gBAAE,SAAS,CAAC,wBAAwB;YAC5E,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAA2C,EAAE,CAAC;IAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAiC,EACjC,QAAgB,EAChB,GAAW;IAEX,MAAM,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,GAAG,EAGhB,CAAC;IACJ,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM;YAAE,MAAM;QAC5C,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACxC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,CAAC,CAAC,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,UAAU,CAAC;QAC1B,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO;YAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,MAAM,GAGR,EAAE,CAAC;IACP,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,aAAa,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;SACjE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/fp/automationInterpreter.d.ts

@@ -10,6 +10,12 @@ import { type ToolResult } from "./result.js";
 /**
  * Returns true if `value` matches the condition pattern.
  * Negation via "!" prefix. Missing pattern → always true.
+ *
+ * On Windows, file paths arrive as `C:\Users\foo\src\bar.ts` while users
+ * write POSIX-style globs (`src/**\/*.ts`). minimatch is strict on `/` and
+ * NTFS is case-insensitive, so without normalisation onFileSave/onFileChanged
+ * hooks silently never fire on Windows. Normalise backslashes to forward
+ * slashes on both sides and pass `nocase` on win32.
  */
 export declare function matchesCondition(pattern: string | undefined, value: string): boolean;
 /**
@@ -25,7 +31,13 @@ export declare function primaryValue(hookType: HookType, eventData: Readonly<Rec
  * Resolve a PromptSourceNode to a string.
  * For named prompts, calls getPrompt() and concatenates user messages.
  * Returns null if a named prompt cannot be resolved (unknown name / missing args).
+ *
+ * When `source.kind === "none"`, returns the symbol `NO_PROMPT` so callers
+ * can distinguish "no inline prompt configured" (webhook-only hook) from
+ * "named prompt failed to resolve" (skip silently).
  */
+export declare const NO_PROMPT: unique symbol;
+export type ResolvedPrompt = string | null | typeof NO_PROMPT;
 export declare function resolvePromptSource(source: {
     kind: "inline";
     prompt: string;
@@ -33,5 +45,7 @@ export declare function resolvePromptSource(source: {
     kind: "named";
     promptName: string;
     promptArgs?: Record<string, string>;
-}, eventData: Readonly<Record<string, string>>): string | null;
+} | {
+    kind: "none";
+}, eventData: Readonly<Record<string, string>>): ResolvedPrompt;
 export declare function executeAutomationPolicy(programs: AutomationProgram[], ctx: InterpreterContext): Promise<ToolResult<InterpreterResult>>;