@mnemonik/shared 7.50.0 → 7.55.1

package/dist/contextBudget.d.ts

@@ -3,26 +3,31 @@ export type ContextBudgetUnits = 'characters' | 'utf8-bytes';
 export interface ContextBudgetItem {
     /** Exact text emitted when the item fits in full. */
     text: string;
-    /** Stable envelope name used by continuation/not-reached pointers. */
+    /** Stable envelope name used for diagnostics only. Never emitted as a retrieval stub. */
     name: string;
     /** Memory identity when this item is one pointer-terminated memory precis. */
     memoryId?: string;
     /** Memory identities when one rendered envelope represents several memories. */
     memoryIds?: readonly string[];
+    /** Exact server-side call that can retrieve this emission after it is shed. */
+    retrievalRoute?: string;
 }
 export type ContextBudgetPiece = string | ContextBudgetItem;
 export interface BudgetedContextFit {
     value: string;
     fullyDeliveredItems: number;
+    /** Retained for caller compatibility. Atomic shedding never sets it. */
     partialItemIndex: number | null;
+    /** Retained for caller compatibility. Atomic shedding always returns zero. */
     partialUnitsDelivered: number;
 }
 /** Measure rendered context in the host's native budget unit. */
 export declare function measureContext(text: string, units?: ContextBudgetUnits): number;
 /**
  * Compose ordered items within a fixed budget. Full items are emitted exactly;
- * the first item that does not fit is packed by whole natural units, and all
- * later identities share one trailing not-reached pointer.
+ * the first item that does not fit and every later item are shed. Shed items
+ * share one trailing marker containing only their explicit retrieval routes.
+ * Items without a route leave no agent-visible stub.
  */
 export declare function fitContextItems(items: readonly ContextBudgetItem[], opts: {
     budget: number;

package/dist/contextBudget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contextBudget.d.ts","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAgCD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,MAAM,CAE7F;AAiED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C,GACA,kBAAkB,CAmEpB;AA4BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,iBAAiB,EAAE,CAMrB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClF,MAAM,CAIR;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}
+{"version":3,"file":"contextBudget.d.ts","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,8EAA8E;IAC9E,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AA6BD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,MAAM,CAE7F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C,GACA,kBAAkB,CAiDpB;AA4BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,iBAAiB,EAAE,CAMrB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClF,MAAM,CAIR;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}

package/dist/contextBudget.js

@@ -1,26 +1,24 @@
 import { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
 export { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
 const JOINER = '\n\n';
-const CONTINUATION_PREFIX = '… continues: ';
 const NOT_REACHED_PREFIX = '… not reached: ';
 function itemMemoryIds(item) {
     if (item.memoryIds && item.memoryIds.length > 0)
         return item.memoryIds;
     return item.memoryId ? [item.memoryId] : [];
 }
-function identity(item) {
+function retrievalRoutes(item) {
     const memoryIds = itemMemoryIds(item);
     if (memoryIds.length > 0)
-        return memoryIds.map((id) => `memory_get ${id}`).join(', ');
-    return item.name.replace(/\s+/g, ' ').trim();
-}
-function continuationPointer(item) {
-    return `${CONTINUATION_PREFIX}${identity(item)}`;
+        return memoryIds.map((id) => `memory_get ${id}`);
+    const route = item.retrievalRoute?.replace(/\s+/g, ' ').trim();
+    return route ? [route] : [];
 }
 function notReachedPointer(items) {
-    if (items.length === 0)
+    const routes = [...new Set(items.flatMap(retrievalRoutes))];
+    if (routes.length === 0)
         return null;
-    return `${NOT_REACHED_PREFIX}${items.map(identity).join(', ')}`;
+    return `${NOT_REACHED_PREFIX}${routes.join(', ')}`;
 }
 function joinSections(sections) {
     return sections
@@ -31,66 +29,11 @@ function joinSections(sections) {
 export function measureContext(text, units = 'characters') {
     return units === 'utf8-bytes' ? Buffer.byteLength(text, 'utf8') : text.length;
 }
-function withoutTerminalMemoryPointer(item) {
-    if (!item.memoryId)
-        return item.text;
-    const terminalPointer = new RegExp(`\\s*${AMBIENT_ITEM_POINTER_SOURCE}\\s*$`);
-    return item.text.replace(terminalPointer, '').trimEnd();
-}
-/**
- * Prefer bullet lines whenever the item contains them. Text ahead of the first
- * bullet is framing and travels with the first admitted fact. Otherwise each
- * sentence (including a final sentence ending at end-of-item) is one unit.
- */
-function naturalUnits(item) {
-    const text = withoutTerminalMemoryPointer(item);
-    const bulletStarts = [];
-    const bulletPattern = /(^|\n)(?=[ \t]*(?:•|[-*])[ \t]+)/g;
-    let bulletMatch;
-    while ((bulletMatch = bulletPattern.exec(text)) !== null) {
-        bulletStarts.push(bulletMatch.index + (bulletMatch[1] ?? '').length);
-        if (bulletPattern.lastIndex === bulletMatch.index)
-            bulletPattern.lastIndex += 1;
-    }
-    // The validated-use clause is a factual unit of its own. Keeping its start
-    // beside bullet starts means a partial-memory fit emits the whole clause or
-    // none of it; the context boundary can never cut inside the count or date.
-    const trackStarts = [];
-    const trackPattern = /(^|\n)(?=\(acted on and validated \d+ times; last \d{4}-\d{2}-\d{2}\))/g;
-    let trackMatch;
-    while ((trackMatch = trackPattern.exec(text)) !== null) {
-        trackStarts.push(trackMatch.index + (trackMatch[1] ?? '').length);
-        if (trackPattern.lastIndex === trackMatch.index)
-            trackPattern.lastIndex += 1;
-    }
-    const explicitStarts = [...new Set([...bulletStarts, ...trackStarts])].sort((a, b) => a - b);
-    if (explicitStarts.length > 0) {
-        return {
-            prefix: text.slice(0, explicitStarts[0]),
-            units: explicitStarts.map((start, index) => text.slice(start, explicitStarts[index + 1])),
-        };
-    }
-    const units = [];
-    const sentenceEnd = /[.!?](?:["')\]]*)?(?=\s|$)/g;
-    let cursor = 0;
-    let sentenceMatch;
-    while ((sentenceMatch = sentenceEnd.exec(text)) !== null) {
-        const end = sentenceMatch.index + sentenceMatch[0].length;
-        units.push(text.slice(cursor, end));
-        cursor = end;
-    }
-    if (cursor < text.length)
-        units.push(text.slice(cursor));
-    return { prefix: '', units: units.filter((unit) => unit.trim().length > 0) };
-}
-function partialText(item, plan, count) {
-    const content = `${plan.prefix}${plan.units.slice(0, count).join('')}`.trimEnd();
-    return `${content}\n${continuationPointer(item)}`;
-}
 /**
  * Compose ordered items within a fixed budget. Full items are emitted exactly;
- * the first item that does not fit is packed by whole natural units, and all
- * later identities share one trailing not-reached pointer.
+ * the first item that does not fit and every later item are shed. Shed items
+ * share one trailing marker containing only their explicit retrieval routes.
+ * Items without a route leave no agent-visible stub.
  */
 export function fitContextItems(items, opts) {
     const units = opts.units ?? 'characters';
@@ -120,35 +63,17 @@ export function fitContextItems(items, opts) {
             accepted.push(item.text);
             continue;
         }
-        const plan = naturalUnits(item);
-        let partialUnitsDelivered = 0;
-        for (let count = 1; count <= plan.units.length; count += 1) {
-            const candidate = joinSections([
-                ...accepted,
-                partialText(item, plan, count),
-                ...suffix.map((entry) => entry.text),
-                notReachedPointer(later),
-            ]);
-            if (measureContext(candidate, units) > opts.budget)
-                break;
-            partialUnitsDelivered = count;
-        }
-        // A one-fact excerpt reads as though it were the whole memory. Require two
-        // complete units before admitting a partial item; otherwise name it only.
-        const meaningfulMinimum = Math.min(2, plan.units.length);
-        const partialAccepted = partialUnitsDelivered >= meaningfulMinimum && partialUnitsDelivered > 0;
-        const partial = partialAccepted ? partialText(item, plan, partialUnitsDelivered) : null;
-        const unreached = partialAccepted ? later : items.slice(index);
+        const withoutPointer = joinSections([...accepted, ...suffix.map((entry) => entry.text)]);
+        const withPointer = joinSections([
+            ...accepted,
+            ...suffix.map((entry) => entry.text),
+            notReachedPointer(items.slice(index)),
+        ]);
         return {
-            value: joinSections([
-                ...accepted,
-                partial,
-                ...suffix.map((entry) => entry.text),
-                notReachedPointer(unreached),
-            ]),
+            value: measureContext(withPointer, units) <= opts.budget ? withPointer : withoutPointer,
             fullyDeliveredItems: index,
-            partialItemIndex: partialAccepted ? index : null,
-            partialUnitsDelivered: partialAccepted ? partialUnitsDelivered : 0,
+            partialItemIndex: null,
+            partialUnitsDelivered: 0,
         };
     }
     return {

package/dist/contextBudget.js.map

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

package/dist/gitEditDetector.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shell-write classification via filesystem observation, not command parsing.
+ *
+ * Permissive/auto-approve modes steer agents toward the shell for file work on
+ * every host, and a shell payload carries a command string, not a file path —
+ * so post-shell events reached the server with no edit to report and the
+ * session's filesEdited/ideEditCount stayed empty, silencing every edit-gated
+ * signal (checkpoint pressure above all). Parsing the command text for written
+ * paths was considered and rejected (decision 2026-08-19: shell semantics make
+ * path extraction guesswork). What git reports about the working tree is not
+ * guesswork.
+ *
+ * Mechanism: snapshot the set of dirty paths (`git status --porcelain -uall`)
+ * at session start, and after each shell call diff the current set against the
+ * snapshot. Paths that are newly dirty were written between the two
+ * observations; report those as edits and roll the snapshot forward. Only
+ * additions count — a commit or stash SHRINKS the set, and saving work is not
+ * new work. Edit tool writes are unioned into the snapshot by each host's edit
+ * handler so they are never re-credited to the next shell call.
+ *
+ * Host-agnostic by construction: the caller owns session identity and passes
+ * the absolute path of its own private snapshot file. An empty `snapshotFile`
+ * is the caller's "no usable session identity" signal and every entry point
+ * no-ops on it — a synthesized or fallback id must never own a snapshot.
+ * Because the diff rolls the snapshot forward, it is idempotent: a host with
+ * no post-shell event may call it from several carrier events and each new
+ * write is still reported exactly once.
+ *
+ * Known limits, accepted by design:
+ * - A file already dirty at baseline that the shell modifies again is not
+ *   re-reported (set membership, not content, is compared).
+ * - Any working-tree change between two observations is credited to the shell
+ *   call, including background processes. For "does this session have unsaved
+ *   work" that is the right signal.
+ * - Only the repo containing cwd is observed. Not a git repo → report nothing
+ *   rather than guess.
+ */
+/**
+ * The current dirty set as absolute paths, or null when cwd is not inside a
+ * git repo, git is unavailable, a bound is exceeded, or the set is too large
+ * to be agent work.
+ */
+export declare function listGitDirtyPaths(cwd: string): {
+    root: string;
+    paths: string[];
+} | null;
+/** Session start: baseline the dirty set so pre-existing dirt is never reported. */
+export declare function captureGitDirtyBaseline(snapshotFile: string, cwd: string): void;
+/**
+ * After a shell call: paths newly dirty since the last observation, capped.
+ * Rolls the snapshot forward. Without a usable baseline it establishes one
+ * and reports nothing — degrading toward silence, never toward a false edit.
+ */
+export declare function diffGitDirtySnapshot(snapshotFile: string, cwd: string): string[];
+/**
+ * After an edit tool: fold tool-reported edits into the snapshot so the next
+ * shell diff does not re-credit them. Only when a baseline exists — seeding a
+ * partial snapshot would make later diffs report pre-existing dirt.
+ */
+export declare function addPathsToGitDirtySnapshot(snapshotFile: string, paths: string[]): void;
+//# sourceMappingURL=gitEditDetector.d.ts.map

package/dist/gitEditDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitEditDetector.d.ts","sourceRoot":"","sources":["../src/gitEditDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAsCH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAuBvF;AA0BD,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAK/E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAUhF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAQtF"}

package/dist/gitEditDetector.js

@@ -0,0 +1,165 @@
+/**
+ * Shell-write classification via filesystem observation, not command parsing.
+ *
+ * Permissive/auto-approve modes steer agents toward the shell for file work on
+ * every host, and a shell payload carries a command string, not a file path —
+ * so post-shell events reached the server with no edit to report and the
+ * session's filesEdited/ideEditCount stayed empty, silencing every edit-gated
+ * signal (checkpoint pressure above all). Parsing the command text for written
+ * paths was considered and rejected (decision 2026-08-19: shell semantics make
+ * path extraction guesswork). What git reports about the working tree is not
+ * guesswork.
+ *
+ * Mechanism: snapshot the set of dirty paths (`git status --porcelain -uall`)
+ * at session start, and after each shell call diff the current set against the
+ * snapshot. Paths that are newly dirty were written between the two
+ * observations; report those as edits and roll the snapshot forward. Only
+ * additions count — a commit or stash SHRINKS the set, and saving work is not
+ * new work. Edit tool writes are unioned into the snapshot by each host's edit
+ * handler so they are never re-credited to the next shell call.
+ *
+ * Host-agnostic by construction: the caller owns session identity and passes
+ * the absolute path of its own private snapshot file. An empty `snapshotFile`
+ * is the caller's "no usable session identity" signal and every entry point
+ * no-ops on it — a synthesized or fallback id must never own a snapshot.
+ * Because the diff rolls the snapshot forward, it is idempotent: a host with
+ * no post-shell event may call it from several carrier events and each new
+ * write is still reported exactly once.
+ *
+ * Known limits, accepted by design:
+ * - A file already dirty at baseline that the shell modifies again is not
+ *   re-reported (set membership, not content, is compared).
+ * - Any working-tree change between two observations is credited to the shell
+ *   call, including background processes. For "does this session have unsaved
+ *   work" that is the right signal.
+ * - Only the repo containing cwd is observed. Not a git repo → report nothing
+ *   rather than guess.
+ */
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** Bounded so a pathological repo cannot stall the hook's PostToolUse turn. */
+const GIT_REV_PARSE_TIMEOUT_MS = 400;
+const GIT_STATUS_TIMEOUT_MS = 800;
+/** T5, the widest volume tier, needs 15 files; 25 keeps tier semantics intact. */
+const MAX_REPORTED_PATHS_PER_CALL = 25;
+/**
+ * A dirty set larger than this is not agent work (mass generation, a missing
+ * .gitignore). Classification is skipped rather than flooding filesEdited.
+ */
+const MAX_SNAPSHOT_PATHS = 2000;
+function runGit(cwd, args, timeout) {
+    try {
+        // --no-optional-locks is a TOP-LEVEL git option: passed after the
+        // subcommand git exits 129 and every observation silently reports nothing.
+        return execFileSync('git', ['--no-optional-locks', '-C', cwd, ...args], {
+            timeout,
+            encoding: 'utf8',
+            maxBuffer: 8 * 1024 * 1024,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The current dirty set as absolute paths, or null when cwd is not inside a
+ * git repo, git is unavailable, a bound is exceeded, or the set is too large
+ * to be agent work.
+ */
+export function listGitDirtyPaths(cwd) {
+    const rootOut = runGit(cwd, ['rev-parse', '--show-toplevel'], GIT_REV_PARSE_TIMEOUT_MS);
+    const root = rootOut?.trim();
+    if (!root)
+        return null;
+    const statusOut = runGit(cwd, ['status', '--porcelain=v1', '-z', '--untracked-files=all'], GIT_STATUS_TIMEOUT_MS);
+    if (statusOut === null)
+        return null;
+    const paths = [];
+    const tokens = statusOut.split('\0');
+    for (let i = 0; i < tokens.length; i++) {
+        const entry = tokens[i];
+        if (!entry || entry.length < 4)
+            continue;
+        // "XY <path>"; a rename/copy entry is followed by the ORIGINAL path as its
+        // own NUL token — consume it so it is never misread as a status entry.
+        const statusCode = entry.slice(0, 2);
+        paths.push(join(root, entry.slice(3)));
+        if (statusCode.startsWith('R') || statusCode.startsWith('C'))
+            i++;
+        if (paths.length > MAX_SNAPSHOT_PATHS)
+            return null;
+    }
+    return { root, paths };
+}
+function readSnapshot(snapshotFile) {
+    try {
+        const parsed = JSON.parse(readFileSync(snapshotFile, 'utf8'));
+        if (parsed?.v !== 1 || typeof parsed.root !== 'string' || !Array.isArray(parsed.paths)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function writeSnapshot(snapshotFile, root, paths) {
+    try {
+        mkdirSync(dirname(snapshotFile), { recursive: true, mode: 0o700 });
+        writeFileSync(snapshotFile, JSON.stringify({ v: 1, root, paths }), {
+            mode: 0o600,
+        });
+    }
+    catch {
+        // Best-effort: a missing snapshot degrades to "report nothing", never to a
+        // wrong report.
+    }
+}
+/** Session start: baseline the dirty set so pre-existing dirt is never reported. */
+export function captureGitDirtyBaseline(snapshotFile, cwd) {
+    if (!snapshotFile)
+        return;
+    const current = listGitDirtyPaths(cwd);
+    if (!current)
+        return;
+    writeSnapshot(snapshotFile, current.root, current.paths);
+}
+/**
+ * After a shell call: paths newly dirty since the last observation, capped.
+ * Rolls the snapshot forward. Without a usable baseline it establishes one
+ * and reports nothing — degrading toward silence, never toward a false edit.
+ */
+export function diffGitDirtySnapshot(snapshotFile, cwd) {
+    if (!snapshotFile)
+        return [];
+    const current = listGitDirtyPaths(cwd);
+    if (!current)
+        return [];
+    const baseline = readSnapshot(snapshotFile);
+    writeSnapshot(snapshotFile, current.root, current.paths);
+    if (!baseline || baseline.root !== current.root)
+        return [];
+    const known = new Set(baseline.paths);
+    const additions = current.paths.filter((p) => !known.has(p));
+    return additions.slice(0, MAX_REPORTED_PATHS_PER_CALL);
+}
+/**
+ * After an edit tool: fold tool-reported edits into the snapshot so the next
+ * shell diff does not re-credit them. Only when a baseline exists — seeding a
+ * partial snapshot would make later diffs report pre-existing dirt.
+ */
+export function addPathsToGitDirtySnapshot(snapshotFile, paths) {
+    if (!snapshotFile || paths.length === 0)
+        return;
+    const snapshot = readSnapshot(snapshotFile);
+    if (!snapshot)
+        return;
+    const known = new Set(snapshot.paths);
+    const additions = paths.filter((p) => !known.has(p));
+    if (additions.length === 0)
+        return;
+    writeSnapshot(snapshotFile, snapshot.root, [...snapshot.paths, ...additions]);
+}
+//# sourceMappingURL=gitEditDetector.js.map

package/dist/gitEditDetector.js.map

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

package/dist/hookRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hookRuntime.d.ts","sourceRoot":"","sources":["../src/hookRuntime.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA6BjC;AAID,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAYzE"}
+{"version":3,"file":"hookRuntime.d.ts","sourceRoot":"","sources":["../src/hookRuntime.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA8BjC;AAID,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAYzE"}

package/dist/hookRuntime.js

@@ -5,8 +5,9 @@ const identityCache = new Map();
 export async function findProjectIdentity(startCwd, opts = {}) {
     if (!startCwd)
         return null;
-    if (identityCache.has(startCwd))
-        return identityCache.get(startCwd);
+    const cached = identityCache.get(startCwd);
+    if (cached !== undefined)
+        return cached;
     let directory = isAbsolute(startCwd) ? startCwd : resolve(startCwd);
     const maxDepth = opts.maxDepth ?? 10;
     for (let depth = 0; depth <= maxDepth; depth += 1) {

package/dist/hookRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"hookRuntime.js","sourceRoot":"","sources":["../src/hookRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAQtC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEhE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,IAAI,GAA0B,EAAE;IAEhC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;IAErE,IAAI,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAC/B,CAAC;YAC7B,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxE,MAAM,QAAQ,GAAoB;oBAChC,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;oBACpF,WAAW,EAAE,SAAS;iBACvB,CAAC;gBACF,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACtC,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,SAAS,GAAG,MAAM,CAAC;IACrB,CAAC;IACD,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,QAAkB;IAC3D,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAyC,CAAC;IACzD,IAAI,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QACtF,MAAM,CAAC,KAAK,CACV,mFAAmF;YACjF,qEAAqE;YACrE,0GAA0G,CAC7G,CAAC;QACF,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"hookRuntime.js","sourceRoot":"","sources":["../src/hookRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAQtC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEhE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,IAAI,GAA0B,EAAE;IAEhC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,IAAI,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAC/B,CAAC;YAC7B,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxE,MAAM,QAAQ,GAAoB;oBAChC,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;oBACpF,WAAW,EAAE,SAAS;iBACvB,CAAC;gBACF,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACtC,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,SAAS,GAAG,MAAM,CAAC;IACrB,CAAC;IACD,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,QAAkB;IAC3D,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAyC,CAAC;IACzD,IAAI,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QACtF,MAAM,CAAC,KAAK,CACV,mFAAmF;YACjF,qEAAqE;YACrE,0GAA0G,CAC7G,CAAC;QACF,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemonik/shared",
-  "version": "7.50.0",
+  "version": "7.55.1",
   "description": "Shared constants and utilities for Mnemonik packages",
   "repository": {
     "type": "git",
@@ -30,6 +30,10 @@
     "./context-budget": {
       "import": "./dist/contextBudget.js",
       "types": "./dist/contextBudget.d.ts"
+    },
+    "./git-edit-detector": {
+      "import": "./dist/gitEditDetector.js",
+      "types": "./dist/gitEditDetector.d.ts"
     }
   },
   "scripts": {

package/src/contextBudget.ts

@@ -7,12 +7,14 @@ export type ContextBudgetUnits = 'characters' | 'utf8-bytes';
 export interface ContextBudgetItem {
   /** Exact text emitted when the item fits in full. */
   text: string;
-  /** Stable envelope name used by continuation/not-reached pointers. */
+  /** Stable envelope name used for diagnostics only. Never emitted as a retrieval stub. */
   name: string;
   /** Memory identity when this item is one pointer-terminated memory precis. */
   memoryId?: string;
   /** Memory identities when one rendered envelope represents several memories. */
   memoryIds?: readonly string[];
+  /** Exact server-side call that can retrieve this emission after it is shed. */
+  retrievalRoute?: string;
 }
 
 export type ContextBudgetPiece = string | ContextBudgetItem;
@@ -20,12 +22,13 @@ export type ContextBudgetPiece = string | ContextBudgetItem;
 export interface BudgetedContextFit {
   value: string;
   fullyDeliveredItems: number;
+  /** Retained for caller compatibility. Atomic shedding never sets it. */
   partialItemIndex: number | null;
+  /** Retained for caller compatibility. Atomic shedding always returns zero. */
   partialUnitsDelivered: number;
 }
 
 const JOINER = '\n\n';
-const CONTINUATION_PREFIX = '… continues: ';
 const NOT_REACHED_PREFIX = '… not reached: ';
 
 function itemMemoryIds(item: ContextBudgetItem): readonly string[] {
@@ -33,19 +36,17 @@ function itemMemoryIds(item: ContextBudgetItem): readonly string[] {
   return item.memoryId ? [item.memoryId] : [];
 }
 
-function identity(item: ContextBudgetItem): string {
+function retrievalRoutes(item: ContextBudgetItem): readonly string[] {
   const memoryIds = itemMemoryIds(item);
-  if (memoryIds.length > 0) return memoryIds.map((id) => `memory_get ${id}`).join(', ');
-  return item.name.replace(/\s+/g, ' ').trim();
-}
-
-function continuationPointer(item: ContextBudgetItem): string {
-  return `${CONTINUATION_PREFIX}${identity(item)}`;
+  if (memoryIds.length > 0) return memoryIds.map((id) => `memory_get ${id}`);
+  const route = item.retrievalRoute?.replace(/\s+/g, ' ').trim();
+  return route ? [route] : [];
 }
 
 function notReachedPointer(items: readonly ContextBudgetItem[]): string | null {
-  if (items.length === 0) return null;
-  return `${NOT_REACHED_PREFIX}${items.map(identity).join(', ')}`;
+  const routes = [...new Set(items.flatMap(retrievalRoutes))];
+  if (routes.length === 0) return null;
+  return `${NOT_REACHED_PREFIX}${routes.join(', ')}`;
 }
 
 function joinSections(sections: readonly (string | null)[]): string {
@@ -59,73 +60,11 @@ export function measureContext(text: string, units: ContextBudgetUnits = 'charac
   return units === 'utf8-bytes' ? Buffer.byteLength(text, 'utf8') : text.length;
 }
 
-interface NaturalUnits {
-  prefix: string;
-  units: string[];
-}
-
-function withoutTerminalMemoryPointer(item: ContextBudgetItem): string {
-  if (!item.memoryId) return item.text;
-  const terminalPointer = new RegExp(`\\s*${AMBIENT_ITEM_POINTER_SOURCE}\\s*$`);
-  return item.text.replace(terminalPointer, '').trimEnd();
-}
-
-/**
- * Prefer bullet lines whenever the item contains them. Text ahead of the first
- * bullet is framing and travels with the first admitted fact. Otherwise each
- * sentence (including a final sentence ending at end-of-item) is one unit.
- */
-function naturalUnits(item: ContextBudgetItem): NaturalUnits {
-  const text = withoutTerminalMemoryPointer(item);
-  const bulletStarts: number[] = [];
-  const bulletPattern = /(^|\n)(?=[ \t]*(?:•|[-*])[ \t]+)/g;
-  let bulletMatch: RegExpExecArray | null;
-  while ((bulletMatch = bulletPattern.exec(text)) !== null) {
-    bulletStarts.push(bulletMatch.index + (bulletMatch[1] ?? '').length);
-    if (bulletPattern.lastIndex === bulletMatch.index) bulletPattern.lastIndex += 1;
-  }
-
-  // The validated-use clause is a factual unit of its own. Keeping its start
-  // beside bullet starts means a partial-memory fit emits the whole clause or
-  // none of it; the context boundary can never cut inside the count or date.
-  const trackStarts: number[] = [];
-  const trackPattern = /(^|\n)(?=\(acted on and validated \d+ times; last \d{4}-\d{2}-\d{2}\))/g;
-  let trackMatch: RegExpExecArray | null;
-  while ((trackMatch = trackPattern.exec(text)) !== null) {
-    trackStarts.push(trackMatch.index + (trackMatch[1] ?? '').length);
-    if (trackPattern.lastIndex === trackMatch.index) trackPattern.lastIndex += 1;
-  }
-
-  const explicitStarts = [...new Set([...bulletStarts, ...trackStarts])].sort((a, b) => a - b);
-  if (explicitStarts.length > 0) {
-    return {
-      prefix: text.slice(0, explicitStarts[0]),
-      units: explicitStarts.map((start, index) => text.slice(start, explicitStarts[index + 1])),
-    };
-  }
-
-  const units: string[] = [];
-  const sentenceEnd = /[.!?](?:["')\]]*)?(?=\s|$)/g;
-  let cursor = 0;
-  let sentenceMatch: RegExpExecArray | null;
-  while ((sentenceMatch = sentenceEnd.exec(text)) !== null) {
-    const end = sentenceMatch.index + sentenceMatch[0].length;
-    units.push(text.slice(cursor, end));
-    cursor = end;
-  }
-  if (cursor < text.length) units.push(text.slice(cursor));
-  return { prefix: '', units: units.filter((unit) => unit.trim().length > 0) };
-}
-
-function partialText(item: ContextBudgetItem, plan: NaturalUnits, count: number): string {
-  const content = `${plan.prefix}${plan.units.slice(0, count).join('')}`.trimEnd();
-  return `${content}\n${continuationPointer(item)}`;
-}
-
 /**
  * Compose ordered items within a fixed budget. Full items are emitted exactly;
- * the first item that does not fit is packed by whole natural units, and all
- * later identities share one trailing not-reached pointer.
+ * the first item that does not fit and every later item are shed. Shed items
+ * share one trailing marker containing only their explicit retrieval routes.
+ * Items without a route leave no agent-visible stub.
  */
 export function fitContextItems(
   items: readonly ContextBudgetItem[],
@@ -163,35 +102,17 @@ export function fitContextItems(
       continue;
     }
 
-    const plan = naturalUnits(item);
-    let partialUnitsDelivered = 0;
-    for (let count = 1; count <= plan.units.length; count += 1) {
-      const candidate = joinSections([
-        ...accepted,
-        partialText(item, plan, count),
-        ...suffix.map((entry) => entry.text),
-        notReachedPointer(later),
-      ]);
-      if (measureContext(candidate, units) > opts.budget) break;
-      partialUnitsDelivered = count;
-    }
-
-    // A one-fact excerpt reads as though it were the whole memory. Require two
-    // complete units before admitting a partial item; otherwise name it only.
-    const meaningfulMinimum = Math.min(2, plan.units.length);
-    const partialAccepted = partialUnitsDelivered >= meaningfulMinimum && partialUnitsDelivered > 0;
-    const partial = partialAccepted ? partialText(item, plan, partialUnitsDelivered) : null;
-    const unreached = partialAccepted ? later : items.slice(index);
+    const withoutPointer = joinSections([...accepted, ...suffix.map((entry) => entry.text)]);
+    const withPointer = joinSections([
+      ...accepted,
+      ...suffix.map((entry) => entry.text),
+      notReachedPointer(items.slice(index)),
+    ]);
     return {
-      value: joinSections([
-        ...accepted,
-        partial,
-        ...suffix.map((entry) => entry.text),
-        notReachedPointer(unreached),
-      ]),
+      value: measureContext(withPointer, units) <= opts.budget ? withPointer : withoutPointer,
       fullyDeliveredItems: index,
-      partialItemIndex: partialAccepted ? index : null,
-      partialUnitsDelivered: partialAccepted ? partialUnitsDelivered : 0,
+      partialItemIndex: null,
+      partialUnitsDelivered: 0,
     };
   }
 

package/src/gitEditDetector.ts

@@ -0,0 +1,167 @@
+/**
+ * Shell-write classification via filesystem observation, not command parsing.
+ *
+ * Permissive/auto-approve modes steer agents toward the shell for file work on
+ * every host, and a shell payload carries a command string, not a file path —
+ * so post-shell events reached the server with no edit to report and the
+ * session's filesEdited/ideEditCount stayed empty, silencing every edit-gated
+ * signal (checkpoint pressure above all). Parsing the command text for written
+ * paths was considered and rejected (decision 2026-08-19: shell semantics make
+ * path extraction guesswork). What git reports about the working tree is not
+ * guesswork.
+ *
+ * Mechanism: snapshot the set of dirty paths (`git status --porcelain -uall`)
+ * at session start, and after each shell call diff the current set against the
+ * snapshot. Paths that are newly dirty were written between the two
+ * observations; report those as edits and roll the snapshot forward. Only
+ * additions count — a commit or stash SHRINKS the set, and saving work is not
+ * new work. Edit tool writes are unioned into the snapshot by each host's edit
+ * handler so they are never re-credited to the next shell call.
+ *
+ * Host-agnostic by construction: the caller owns session identity and passes
+ * the absolute path of its own private snapshot file. An empty `snapshotFile`
+ * is the caller's "no usable session identity" signal and every entry point
+ * no-ops on it — a synthesized or fallback id must never own a snapshot.
+ * Because the diff rolls the snapshot forward, it is idempotent: a host with
+ * no post-shell event may call it from several carrier events and each new
+ * write is still reported exactly once.
+ *
+ * Known limits, accepted by design:
+ * - A file already dirty at baseline that the shell modifies again is not
+ *   re-reported (set membership, not content, is compared).
+ * - Any working-tree change between two observations is credited to the shell
+ *   call, including background processes. For "does this session have unsaved
+ *   work" that is the right signal.
+ * - Only the repo containing cwd is observed. Not a git repo → report nothing
+ *   rather than guess.
+ */
+
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+/** Bounded so a pathological repo cannot stall the hook's PostToolUse turn. */
+const GIT_REV_PARSE_TIMEOUT_MS = 400;
+const GIT_STATUS_TIMEOUT_MS = 800;
+/** T5, the widest volume tier, needs 15 files; 25 keeps tier semantics intact. */
+const MAX_REPORTED_PATHS_PER_CALL = 25;
+/**
+ * A dirty set larger than this is not agent work (mass generation, a missing
+ * .gitignore). Classification is skipped rather than flooding filesEdited.
+ */
+const MAX_SNAPSHOT_PATHS = 2000;
+
+interface DirtySnapshot {
+  v: 1;
+  root: string;
+  paths: string[];
+}
+
+function runGit(cwd: string, args: string[], timeout: number): string | null {
+  try {
+    // --no-optional-locks is a TOP-LEVEL git option: passed after the
+    // subcommand git exits 129 and every observation silently reports nothing.
+    return execFileSync('git', ['--no-optional-locks', '-C', cwd, ...args], {
+      timeout,
+      encoding: 'utf8',
+      maxBuffer: 8 * 1024 * 1024,
+      stdio: ['ignore', 'pipe', 'ignore'],
+    });
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * The current dirty set as absolute paths, or null when cwd is not inside a
+ * git repo, git is unavailable, a bound is exceeded, or the set is too large
+ * to be agent work.
+ */
+export function listGitDirtyPaths(cwd: string): { root: string; paths: string[] } | null {
+  const rootOut = runGit(cwd, ['rev-parse', '--show-toplevel'], GIT_REV_PARSE_TIMEOUT_MS);
+  const root = rootOut?.trim();
+  if (!root) return null;
+  const statusOut = runGit(
+    cwd,
+    ['status', '--porcelain=v1', '-z', '--untracked-files=all'],
+    GIT_STATUS_TIMEOUT_MS
+  );
+  if (statusOut === null) return null;
+  const paths: string[] = [];
+  const tokens = statusOut.split('\0');
+  for (let i = 0; i < tokens.length; i++) {
+    const entry = tokens[i];
+    if (!entry || entry.length < 4) continue;
+    // "XY <path>"; a rename/copy entry is followed by the ORIGINAL path as its
+    // own NUL token — consume it so it is never misread as a status entry.
+    const statusCode = entry.slice(0, 2);
+    paths.push(join(root, entry.slice(3)));
+    if (statusCode.startsWith('R') || statusCode.startsWith('C')) i++;
+    if (paths.length > MAX_SNAPSHOT_PATHS) return null;
+  }
+  return { root, paths };
+}
+
+function readSnapshot(snapshotFile: string): DirtySnapshot | null {
+  try {
+    const parsed = JSON.parse(readFileSync(snapshotFile, 'utf8')) as DirtySnapshot;
+    if (parsed?.v !== 1 || typeof parsed.root !== 'string' || !Array.isArray(parsed.paths)) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+function writeSnapshot(snapshotFile: string, root: string, paths: string[]): void {
+  try {
+    mkdirSync(dirname(snapshotFile), { recursive: true, mode: 0o700 });
+    writeFileSync(snapshotFile, JSON.stringify({ v: 1, root, paths } satisfies DirtySnapshot), {
+      mode: 0o600,
+    });
+  } catch {
+    // Best-effort: a missing snapshot degrades to "report nothing", never to a
+    // wrong report.
+  }
+}
+
+/** Session start: baseline the dirty set so pre-existing dirt is never reported. */
+export function captureGitDirtyBaseline(snapshotFile: string, cwd: string): void {
+  if (!snapshotFile) return;
+  const current = listGitDirtyPaths(cwd);
+  if (!current) return;
+  writeSnapshot(snapshotFile, current.root, current.paths);
+}
+
+/**
+ * After a shell call: paths newly dirty since the last observation, capped.
+ * Rolls the snapshot forward. Without a usable baseline it establishes one
+ * and reports nothing — degrading toward silence, never toward a false edit.
+ */
+export function diffGitDirtySnapshot(snapshotFile: string, cwd: string): string[] {
+  if (!snapshotFile) return [];
+  const current = listGitDirtyPaths(cwd);
+  if (!current) return [];
+  const baseline = readSnapshot(snapshotFile);
+  writeSnapshot(snapshotFile, current.root, current.paths);
+  if (!baseline || baseline.root !== current.root) return [];
+  const known = new Set(baseline.paths);
+  const additions = current.paths.filter((p) => !known.has(p));
+  return additions.slice(0, MAX_REPORTED_PATHS_PER_CALL);
+}
+
+/**
+ * After an edit tool: fold tool-reported edits into the snapshot so the next
+ * shell diff does not re-credit them. Only when a baseline exists — seeding a
+ * partial snapshot would make later diffs report pre-existing dirt.
+ */
+export function addPathsToGitDirtySnapshot(snapshotFile: string, paths: string[]): void {
+  if (!snapshotFile || paths.length === 0) return;
+  const snapshot = readSnapshot(snapshotFile);
+  if (!snapshot) return;
+  const known = new Set(snapshot.paths);
+  const additions = paths.filter((p) => !known.has(p));
+  if (additions.length === 0) return;
+  writeSnapshot(snapshotFile, snapshot.root, [...snapshot.paths, ...additions]);
+}

package/src/hookRuntime.ts

@@ -15,7 +15,8 @@ export async function findProjectIdentity(
   opts: { maxDepth?: number } = {}
 ): Promise<ProjectIdentity | null> {
   if (!startCwd) return null;
-  if (identityCache.has(startCwd)) return identityCache.get(startCwd)!;
+  const cached = identityCache.get(startCwd);
+  if (cached !== undefined) return cached;
 
   let directory = isAbsolute(startCwd) ? startCwd : resolve(startCwd);
   const maxDepth = opts.maxDepth ?? 10;