@astralyn/pi 0.81.1-1

package/dist/extensions/question/state.d.ts

@@ -0,0 +1,9 @@
+import type { CustomAnswer, DisplayOption, Question, QuestionAnswer, QuestionState } from "./types.ts";
+export declare function newQuestionState(): QuestionState;
+export declare function selectedCustomAnswer(state: QuestionState): CustomAnswer | undefined;
+export declare function hasMultiAnswer(state: QuestionState): boolean;
+export declare function hasAnswer(state: QuestionState): boolean;
+export declare function displayOptions(question: Question): DisplayOption[];
+export declare function firstUnanswered(states: QuestionState[]): number | undefined;
+export declare function orderedAnswers(questions: Question[], states: QuestionState[]): QuestionAnswer[];
+//# sourceMappingURL=state.d.ts.map

package/dist/extensions/question/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/extensions/question/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGnH,wBAAgB,gBAAgB,IAAI,aAAa,CAMhD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,CAEnF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAEvD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,EAAE,CAKlE;AAWD,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,GAAG,SAAS,CAM3E;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,cAAc,EAAE,CAmC/F","sourcesContent":["import type { AnswerNote, CustomAnswer, DisplayOption, Question, QuestionAnswer, QuestionState } from \"./types.ts\";\nimport { OTHER_OPTION } from \"./types.ts\";\n\nexport function newQuestionState(): QuestionState {\n\treturn {\n\t\toptionIndex: 0,\n\t\tmultiSelected: new Set(),\n\t\tnotesByOption: new Map(),\n\t};\n}\n\nexport function selectedCustomAnswer(state: QuestionState): CustomAnswer | undefined {\n\treturn state.customAnswer?.selected ? state.customAnswer : undefined;\n}\n\nexport function hasMultiAnswer(state: QuestionState): boolean {\n\treturn state.multiSelected.size > 0 || selectedCustomAnswer(state) !== undefined;\n}\n\nexport function hasAnswer(state: QuestionState): boolean {\n\treturn Boolean(state.singleAnswer) || hasMultiAnswer(state);\n}\n\nexport function displayOptions(question: Question): DisplayOption[] {\n\treturn [\n\t\t...question.options.map((option, optionIndex) => ({ ...option, kind: \"option\" as const, optionIndex })),\n\t\tOTHER_OPTION,\n\t];\n}\n\nfunction noteEntries(state: QuestionState, allowedOptions: readonly string[]): AnswerNote[] | undefined {\n\tconst allowed = new Set(allowedOptions);\n\tconst entries = [...state.notesByOption.entries()]\n\t\t.filter(([option]) => allowed.has(option))\n\t\t.filter(([, text]) => text.trim().length > 0)\n\t\t.map(([option, text]) => ({ option, text: text.trim() }));\n\treturn entries.length ? entries : undefined;\n}\n\nexport function firstUnanswered(states: QuestionState[]): number | undefined {\n\tfor (let i = 0; i < states.length; i++) {\n\t\tconst state = states[i];\n\t\tif (!hasAnswer(state)) return i;\n\t}\n\treturn undefined;\n}\n\nexport function orderedAnswers(questions: Question[], states: QuestionState[]): QuestionAnswer[] {\n\tconst answers: QuestionAnswer[] = [];\n\tfor (let i = 0; i < questions.length; i++) {\n\t\tconst question = questions[i];\n\t\tconst state = states[i];\n\t\tif (state.singleAnswer) {\n\t\t\tconst notes =\n\t\t\t\tstate.singleAnswer.kind === \"option\" && state.singleAnswer.answer\n\t\t\t\t\t? noteEntries(state, [state.singleAnswer.answer])\n\t\t\t\t\t: undefined;\n\t\t\tanswers.push(notes ? { ...state.singleAnswer, notes } : state.singleAnswer);\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (question.multiSelect && hasMultiAnswer(state)) {\n\t\t\tconst selected: string[] = [];\n\t\t\tfor (const idx of [...state.multiSelected].sort((a, b) => a - b)) {\n\t\t\t\tconst option = question.options[idx];\n\t\t\t\tif (option) selected.push(option.label);\n\t\t\t}\n\t\t\tconst custom = selectedCustomAnswer(state);\n\t\t\tif (custom) selected.push(custom.text);\n\t\t\tconst notes = noteEntries(state, selected);\n\t\t\tanswers.push({\n\t\t\t\tquestionIndex: i,\n\t\t\t\tquestion: question.question,\n\t\t\t\theader: question.header,\n\t\t\t\tkind: \"multi\",\n\t\t\t\tanswer: null,\n\t\t\t\tselected,\n\t\t\t\t...(notes ? { notes } : {}),\n\t\t\t});\n\t\t}\n\t}\n\treturn answers;\n}\n"]}

package/dist/extensions/question/state.js

@@ -0,0 +1,76 @@
+import { OTHER_OPTION } from "./types.js";
+export function newQuestionState() {
+    return {
+        optionIndex: 0,
+        multiSelected: new Set(),
+        notesByOption: new Map(),
+    };
+}
+export function selectedCustomAnswer(state) {
+    return state.customAnswer?.selected ? state.customAnswer : undefined;
+}
+export function hasMultiAnswer(state) {
+    return state.multiSelected.size > 0 || selectedCustomAnswer(state) !== undefined;
+}
+export function hasAnswer(state) {
+    return Boolean(state.singleAnswer) || hasMultiAnswer(state);
+}
+export function displayOptions(question) {
+    return [
+        ...question.options.map((option, optionIndex) => ({ ...option, kind: "option", optionIndex })),
+        OTHER_OPTION,
+    ];
+}
+function noteEntries(state, allowedOptions) {
+    const allowed = new Set(allowedOptions);
+    const entries = [...state.notesByOption.entries()]
+        .filter(([option]) => allowed.has(option))
+        .filter(([, text]) => text.trim().length > 0)
+        .map(([option, text]) => ({ option, text: text.trim() }));
+    return entries.length ? entries : undefined;
+}
+export function firstUnanswered(states) {
+    for (let i = 0; i < states.length; i++) {
+        const state = states[i];
+        if (!hasAnswer(state))
+            return i;
+    }
+    return undefined;
+}
+export function orderedAnswers(questions, states) {
+    const answers = [];
+    for (let i = 0; i < questions.length; i++) {
+        const question = questions[i];
+        const state = states[i];
+        if (state.singleAnswer) {
+            const notes = state.singleAnswer.kind === "option" && state.singleAnswer.answer
+                ? noteEntries(state, [state.singleAnswer.answer])
+                : undefined;
+            answers.push(notes ? { ...state.singleAnswer, notes } : state.singleAnswer);
+            continue;
+        }
+        if (question.multiSelect && hasMultiAnswer(state)) {
+            const selected = [];
+            for (const idx of [...state.multiSelected].sort((a, b) => a - b)) {
+                const option = question.options[idx];
+                if (option)
+                    selected.push(option.label);
+            }
+            const custom = selectedCustomAnswer(state);
+            if (custom)
+                selected.push(custom.text);
+            const notes = noteEntries(state, selected);
+            answers.push({
+                questionIndex: i,
+                question: question.question,
+                header: question.header,
+                kind: "multi",
+                answer: null,
+                selected,
+                ...(notes ? { notes } : {}),
+            });
+        }
+    }
+    return answers;
+}
+//# sourceMappingURL=state.js.map

package/dist/extensions/question/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/extensions/question/state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnswerNote, CustomAnswer, DisplayOption, Question, QuestionAnswer, QuestionState } from \"./types.ts\";\nimport { OTHER_OPTION } from \"./types.ts\";\n\nexport function newQuestionState(): QuestionState {\n\treturn {\n\t\toptionIndex: 0,\n\t\tmultiSelected: new Set(),\n\t\tnotesByOption: new Map(),\n\t};\n}\n\nexport function selectedCustomAnswer(state: QuestionState): CustomAnswer | undefined {\n\treturn state.customAnswer?.selected ? state.customAnswer : undefined;\n}\n\nexport function hasMultiAnswer(state: QuestionState): boolean {\n\treturn state.multiSelected.size > 0 || selectedCustomAnswer(state) !== undefined;\n}\n\nexport function hasAnswer(state: QuestionState): boolean {\n\treturn Boolean(state.singleAnswer) || hasMultiAnswer(state);\n}\n\nexport function displayOptions(question: Question): DisplayOption[] {\n\treturn [\n\t\t...question.options.map((option, optionIndex) => ({ ...option, kind: \"option\" as const, optionIndex })),\n\t\tOTHER_OPTION,\n\t];\n}\n\nfunction noteEntries(state: QuestionState, allowedOptions: readonly string[]): AnswerNote[] | undefined {\n\tconst allowed = new Set(allowedOptions);\n\tconst entries = [...state.notesByOption.entries()]\n\t\t.filter(([option]) => allowed.has(option))\n\t\t.filter(([, text]) => text.trim().length > 0)\n\t\t.map(([option, text]) => ({ option, text: text.trim() }));\n\treturn entries.length ? entries : undefined;\n}\n\nexport function firstUnanswered(states: QuestionState[]): number | undefined {\n\tfor (let i = 0; i < states.length; i++) {\n\t\tconst state = states[i];\n\t\tif (!hasAnswer(state)) return i;\n\t}\n\treturn undefined;\n}\n\nexport function orderedAnswers(questions: Question[], states: QuestionState[]): QuestionAnswer[] {\n\tconst answers: QuestionAnswer[] = [];\n\tfor (let i = 0; i < questions.length; i++) {\n\t\tconst question = questions[i];\n\t\tconst state = states[i];\n\t\tif (state.singleAnswer) {\n\t\t\tconst notes =\n\t\t\t\tstate.singleAnswer.kind === \"option\" && state.singleAnswer.answer\n\t\t\t\t\t? noteEntries(state, [state.singleAnswer.answer])\n\t\t\t\t\t: undefined;\n\t\t\tanswers.push(notes ? { ...state.singleAnswer, notes } : state.singleAnswer);\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (question.multiSelect && hasMultiAnswer(state)) {\n\t\t\tconst selected: string[] = [];\n\t\t\tfor (const idx of [...state.multiSelected].sort((a, b) => a - b)) {\n\t\t\t\tconst option = question.options[idx];\n\t\t\t\tif (option) selected.push(option.label);\n\t\t\t}\n\t\t\tconst custom = selectedCustomAnswer(state);\n\t\t\tif (custom) selected.push(custom.text);\n\t\t\tconst notes = noteEntries(state, selected);\n\t\t\tanswers.push({\n\t\t\t\tquestionIndex: i,\n\t\t\t\tquestion: question.question,\n\t\t\t\theader: question.header,\n\t\t\t\tkind: \"multi\",\n\t\t\t\tanswer: null,\n\t\t\t\tselected,\n\t\t\t\t...(notes ? { notes } : {}),\n\t\t\t});\n\t\t}\n\t}\n\treturn answers;\n}\n"]}

package/dist/extensions/question/types.d.ts

@@ -0,0 +1,60 @@
+export interface QuestionOption {
+    label: string;
+    description: string;
+    preview?: string;
+}
+export interface Question {
+    question: string;
+    header: string;
+    options: QuestionOption[];
+    multiSelect?: boolean;
+}
+export type InputMode = "custom" | "notes" | undefined;
+export type QuestionToolError = "no_ui" | "no_questions" | "too_many_questions" | "invalid_option_count" | "duplicate_question" | "duplicate_option_label" | "reserved_label" | "invalid_text_length";
+export interface AnswerNote {
+    option: string;
+    text: string;
+}
+export interface QuestionAnswer {
+    questionIndex: number;
+    question: string;
+    header: string;
+    kind: "option" | "custom" | "multi";
+    answer: string | null;
+    selected?: string[];
+    notes?: AnswerNote[];
+    preview?: string;
+}
+export type QuestionOutcome = "answered" | "cancelled" | "needs_clarification" | "error";
+export interface QuestionToolDetails {
+    answers: QuestionAnswer[];
+    outcome: QuestionOutcome;
+    cancelled: boolean;
+    error?: QuestionToolError;
+}
+export interface CustomAnswer {
+    text: string;
+    selected: boolean;
+}
+export interface QuestionState {
+    optionIndex: number;
+    singleAnswer?: QuestionAnswer;
+    multiSelected: Set<number>;
+    customAnswer?: CustomAnswer;
+    notesByOption: Map<string, string>;
+    warning?: string;
+}
+export interface DialogResult {
+    answers: QuestionAnswer[];
+    outcome: QuestionOutcome;
+}
+export type DisplayOption = (QuestionOption & {
+    kind: "option";
+    optionIndex: number;
+}) | {
+    kind: "other";
+    label: string;
+    isOther: true;
+};
+export declare const OTHER_OPTION: DisplayOption;
+//# sourceMappingURL=types.d.ts.map

package/dist/extensions/question/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extensions/question/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAC1B,OAAO,GACP,cAAc,GACd,oBAAoB,GACpB,sBAAsB,GACtB,oBAAoB,GACpB,wBAAwB,GACxB,gBAAgB,GAChB,qBAAqB,CAAC;AAEzB,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,WAAW,GAAG,qBAAqB,GAAG,OAAO,CAAC;AAEzF,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GACtB,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnD,eAAO,MAAM,YAAY,EAAE,aAA0E,CAAC","sourcesContent":["export interface QuestionOption {\n\tlabel: string;\n\tdescription: string;\n\tpreview?: string;\n}\n\nexport interface Question {\n\tquestion: string;\n\theader: string;\n\toptions: QuestionOption[];\n\tmultiSelect?: boolean;\n}\n\nexport type InputMode = \"custom\" | \"notes\" | undefined;\n\nexport type QuestionToolError =\n\t| \"no_ui\"\n\t| \"no_questions\"\n\t| \"too_many_questions\"\n\t| \"invalid_option_count\"\n\t| \"duplicate_question\"\n\t| \"duplicate_option_label\"\n\t| \"reserved_label\"\n\t| \"invalid_text_length\";\n\nexport interface AnswerNote {\n\toption: string;\n\ttext: string;\n}\n\nexport interface QuestionAnswer {\n\tquestionIndex: number;\n\tquestion: string;\n\theader: string;\n\tkind: \"option\" | \"custom\" | \"multi\";\n\tanswer: string | null;\n\tselected?: string[];\n\tnotes?: AnswerNote[];\n\tpreview?: string;\n}\n\nexport type QuestionOutcome = \"answered\" | \"cancelled\" | \"needs_clarification\" | \"error\";\n\nexport interface QuestionToolDetails {\n\tanswers: QuestionAnswer[];\n\toutcome: QuestionOutcome;\n\tcancelled: boolean;\n\terror?: QuestionToolError;\n}\n\nexport interface CustomAnswer {\n\ttext: string;\n\tselected: boolean;\n}\n\nexport interface QuestionState {\n\toptionIndex: number;\n\tsingleAnswer?: QuestionAnswer;\n\tmultiSelected: Set<number>;\n\tcustomAnswer?: CustomAnswer;\n\tnotesByOption: Map<string, string>;\n\twarning?: string;\n}\n\nexport interface DialogResult {\n\tanswers: QuestionAnswer[];\n\toutcome: QuestionOutcome;\n}\n\nexport type DisplayOption =\n\t| (QuestionOption & { kind: \"option\"; optionIndex: number })\n\t| { kind: \"other\"; label: string; isOther: true };\n\nexport const OTHER_OPTION: DisplayOption = { kind: \"other\", label: \"Type something.\", isOther: true };\n"]}

package/dist/extensions/question/types.js

@@ -0,0 +1,2 @@
+export const OTHER_OPTION = { kind: "other", label: "Type something.", isOther: true };
+//# sourceMappingURL=types.js.map

package/dist/extensions/question/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extensions/question/types.ts"],"names":[],"mappings":"AAyEA,MAAM,CAAC,MAAM,YAAY,GAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC","sourcesContent":["export interface QuestionOption {\n\tlabel: string;\n\tdescription: string;\n\tpreview?: string;\n}\n\nexport interface Question {\n\tquestion: string;\n\theader: string;\n\toptions: QuestionOption[];\n\tmultiSelect?: boolean;\n}\n\nexport type InputMode = \"custom\" | \"notes\" | undefined;\n\nexport type QuestionToolError =\n\t| \"no_ui\"\n\t| \"no_questions\"\n\t| \"too_many_questions\"\n\t| \"invalid_option_count\"\n\t| \"duplicate_question\"\n\t| \"duplicate_option_label\"\n\t| \"reserved_label\"\n\t| \"invalid_text_length\";\n\nexport interface AnswerNote {\n\toption: string;\n\ttext: string;\n}\n\nexport interface QuestionAnswer {\n\tquestionIndex: number;\n\tquestion: string;\n\theader: string;\n\tkind: \"option\" | \"custom\" | \"multi\";\n\tanswer: string | null;\n\tselected?: string[];\n\tnotes?: AnswerNote[];\n\tpreview?: string;\n}\n\nexport type QuestionOutcome = \"answered\" | \"cancelled\" | \"needs_clarification\" | \"error\";\n\nexport interface QuestionToolDetails {\n\tanswers: QuestionAnswer[];\n\toutcome: QuestionOutcome;\n\tcancelled: boolean;\n\terror?: QuestionToolError;\n}\n\nexport interface CustomAnswer {\n\ttext: string;\n\tselected: boolean;\n}\n\nexport interface QuestionState {\n\toptionIndex: number;\n\tsingleAnswer?: QuestionAnswer;\n\tmultiSelected: Set<number>;\n\tcustomAnswer?: CustomAnswer;\n\tnotesByOption: Map<string, string>;\n\twarning?: string;\n}\n\nexport interface DialogResult {\n\tanswers: QuestionAnswer[];\n\toutcome: QuestionOutcome;\n}\n\nexport type DisplayOption =\n\t| (QuestionOption & { kind: \"option\"; optionIndex: number })\n\t| { kind: \"other\"; label: string; isOther: true };\n\nexport const OTHER_OPTION: DisplayOption = { kind: \"other\", label: \"Type something.\", isOther: true };\n"]}

package/dist/extensions/rewind/config.d.ts

@@ -0,0 +1,16 @@
+export interface RewindConfig {
+    /** Master switch. When false, no backups are taken and rewind is inert. */
+    enabled: boolean;
+    /** Backups for sessions whose dir is older than this are GC'd. 0 = keep forever. */
+    retentionDays: number;
+    /** Cap on retained snapshots per session. */
+    maxSnapshots: number;
+}
+export declare const DEFAULT_CONFIG: RewindConfig;
+/** Cached config (reads disk once, then serves memory until reload/save). */
+export declare function loadRewindConfig(): RewindConfig;
+/** Force a disk re-read (call on session_start so external edits take effect). */
+export declare function reloadRewindConfig(): RewindConfig;
+/** Persist and update the in-memory cache so the next turn sees the change. */
+export declare function saveRewindConfig(config: RewindConfig): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/extensions/rewind/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/extensions/rewind/config.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,YAAY;IAC5B,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,YAI5B,CAAC;AA8BF,6EAA6E;AAC7E,wBAAgB,gBAAgB,IAAI,YAAY,CAG/C;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,IAAI,YAAY,CAGjD;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAW9D","sourcesContent":["/**\n * config.ts — load/save the rewind extension's settings at\n * <rewindDir>/config.json. Tolerant parse, atomic-ish write, sensible defaults\n * so a missing/corrupt file never breaks the session.\n *\n * Settings are user-editable via the /rewind menu (menu.ts).\n */\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nimport { rewindConfigPath } from \"./paths.ts\";\n\nexport interface RewindConfig {\n\t/** Master switch. When false, no backups are taken and rewind is inert. */\n\tenabled: boolean;\n\t/** Backups for sessions whose dir is older than this are GC'd. 0 = keep forever. */\n\tretentionDays: number;\n\t/** Cap on retained snapshots per session. */\n\tmaxSnapshots: number;\n}\n\nexport const DEFAULT_CONFIG: RewindConfig = {\n\tenabled: true,\n\tretentionDays: 30,\n\tmaxSnapshots: 100,\n};\n\n/** In-process cache so lifecycle hooks do not re-read config.json every turn. */\nlet cached: RewindConfig | null = null;\n\nfunction clampInt(value: unknown, min: number, max: number, fallback: number): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) return fallback;\n\treturn Math.min(max, Math.max(min, Math.round(value)));\n}\n\nfunction normalize(raw: unknown): RewindConfig {\n\tif (!raw || typeof raw !== \"object\") return { ...DEFAULT_CONFIG };\n\tconst r = raw as Partial<RewindConfig>;\n\treturn {\n\t\tenabled: typeof r.enabled === \"boolean\" ? r.enabled : DEFAULT_CONFIG.enabled,\n\t\tretentionDays: clampInt(r.retentionDays, 0, 3650, DEFAULT_CONFIG.retentionDays),\n\t\tmaxSnapshots: clampInt(r.maxSnapshots, 1, 1000, DEFAULT_CONFIG.maxSnapshots),\n\t};\n}\n\nfunction readConfigFromDisk(): RewindConfig {\n\tconst configPath = rewindConfigPath();\n\tif (!existsSync(configPath)) return { ...DEFAULT_CONFIG };\n\ttry {\n\t\treturn normalize(JSON.parse(readFileSync(configPath, \"utf8\")));\n\t} catch {\n\t\treturn { ...DEFAULT_CONFIG };\n\t}\n}\n\n/** Cached config (reads disk once, then serves memory until reload/save). */\nexport function loadRewindConfig(): RewindConfig {\n\tif (!cached) cached = readConfigFromDisk();\n\treturn cached;\n}\n\n/** Force a disk re-read (call on session_start so external edits take effect). */\nexport function reloadRewindConfig(): RewindConfig {\n\tcached = readConfigFromDisk();\n\treturn cached;\n}\n\n/** Persist and update the in-memory cache so the next turn sees the change. */\nexport function saveRewindConfig(config: RewindConfig): boolean {\n\tconst next = normalize(config);\n\tconst configPath = rewindConfigPath();\n\ttry {\n\t\tmkdirSync(dirname(configPath), { recursive: true });\n\t\twriteFileSync(configPath, `${JSON.stringify(next, null, 2)}\\n`, \"utf8\");\n\t\tcached = next;\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"]}

package/dist/extensions/rewind/config.js

@@ -0,0 +1,69 @@
+/**
+ * config.ts — load/save the rewind extension's settings at
+ * <rewindDir>/config.json. Tolerant parse, atomic-ish write, sensible defaults
+ * so a missing/corrupt file never breaks the session.
+ *
+ * Settings are user-editable via the /rewind menu (menu.ts).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { rewindConfigPath } from "./paths.js";
+export const DEFAULT_CONFIG = {
+    enabled: true,
+    retentionDays: 30,
+    maxSnapshots: 100,
+};
+/** In-process cache so lifecycle hooks do not re-read config.json every turn. */
+let cached = null;
+function clampInt(value, min, max, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    return Math.min(max, Math.max(min, Math.round(value)));
+}
+function normalize(raw) {
+    if (!raw || typeof raw !== "object")
+        return { ...DEFAULT_CONFIG };
+    const r = raw;
+    return {
+        enabled: typeof r.enabled === "boolean" ? r.enabled : DEFAULT_CONFIG.enabled,
+        retentionDays: clampInt(r.retentionDays, 0, 3650, DEFAULT_CONFIG.retentionDays),
+        maxSnapshots: clampInt(r.maxSnapshots, 1, 1000, DEFAULT_CONFIG.maxSnapshots),
+    };
+}
+function readConfigFromDisk() {
+    const configPath = rewindConfigPath();
+    if (!existsSync(configPath))
+        return { ...DEFAULT_CONFIG };
+    try {
+        return normalize(JSON.parse(readFileSync(configPath, "utf8")));
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+/** Cached config (reads disk once, then serves memory until reload/save). */
+export function loadRewindConfig() {
+    if (!cached)
+        cached = readConfigFromDisk();
+    return cached;
+}
+/** Force a disk re-read (call on session_start so external edits take effect). */
+export function reloadRewindConfig() {
+    cached = readConfigFromDisk();
+    return cached;
+}
+/** Persist and update the in-memory cache so the next turn sees the change. */
+export function saveRewindConfig(config) {
+    const next = normalize(config);
+    const configPath = rewindConfigPath();
+    try {
+        mkdirSync(dirname(configPath), { recursive: true });
+        writeFileSync(configPath, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+        cached = next;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/extensions/rewind/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/extensions/rewind/config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * config.ts — load/save the rewind extension's settings at\n * <rewindDir>/config.json. Tolerant parse, atomic-ish write, sensible defaults\n * so a missing/corrupt file never breaks the session.\n *\n * Settings are user-editable via the /rewind menu (menu.ts).\n */\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nimport { rewindConfigPath } from \"./paths.ts\";\n\nexport interface RewindConfig {\n\t/** Master switch. When false, no backups are taken and rewind is inert. */\n\tenabled: boolean;\n\t/** Backups for sessions whose dir is older than this are GC'd. 0 = keep forever. */\n\tretentionDays: number;\n\t/** Cap on retained snapshots per session. */\n\tmaxSnapshots: number;\n}\n\nexport const DEFAULT_CONFIG: RewindConfig = {\n\tenabled: true,\n\tretentionDays: 30,\n\tmaxSnapshots: 100,\n};\n\n/** In-process cache so lifecycle hooks do not re-read config.json every turn. */\nlet cached: RewindConfig | null = null;\n\nfunction clampInt(value: unknown, min: number, max: number, fallback: number): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) return fallback;\n\treturn Math.min(max, Math.max(min, Math.round(value)));\n}\n\nfunction normalize(raw: unknown): RewindConfig {\n\tif (!raw || typeof raw !== \"object\") return { ...DEFAULT_CONFIG };\n\tconst r = raw as Partial<RewindConfig>;\n\treturn {\n\t\tenabled: typeof r.enabled === \"boolean\" ? r.enabled : DEFAULT_CONFIG.enabled,\n\t\tretentionDays: clampInt(r.retentionDays, 0, 3650, DEFAULT_CONFIG.retentionDays),\n\t\tmaxSnapshots: clampInt(r.maxSnapshots, 1, 1000, DEFAULT_CONFIG.maxSnapshots),\n\t};\n}\n\nfunction readConfigFromDisk(): RewindConfig {\n\tconst configPath = rewindConfigPath();\n\tif (!existsSync(configPath)) return { ...DEFAULT_CONFIG };\n\ttry {\n\t\treturn normalize(JSON.parse(readFileSync(configPath, \"utf8\")));\n\t} catch {\n\t\treturn { ...DEFAULT_CONFIG };\n\t}\n}\n\n/** Cached config (reads disk once, then serves memory until reload/save). */\nexport function loadRewindConfig(): RewindConfig {\n\tif (!cached) cached = readConfigFromDisk();\n\treturn cached;\n}\n\n/** Force a disk re-read (call on session_start so external edits take effect). */\nexport function reloadRewindConfig(): RewindConfig {\n\tcached = readConfigFromDisk();\n\treturn cached;\n}\n\n/** Persist and update the in-memory cache so the next turn sees the change. */\nexport function saveRewindConfig(config: RewindConfig): boolean {\n\tconst next = normalize(config);\n\tconst configPath = rewindConfigPath();\n\ttry {\n\t\tmkdirSync(dirname(configPath), { recursive: true });\n\t\twriteFileSync(configPath, `${JSON.stringify(next, null, 2)}\\n`, \"utf8\");\n\t\tcached = next;\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"]}

package/dist/extensions/rewind/engine.d.ts

@@ -0,0 +1,97 @@
+import type { FileBackup, FileHistorySnapshot } from "./snapshot.ts";
+/** Worktree identity recorded when we last backed up / confirmed a tracking path. */
+interface SeenStats {
+    mtimeMs: number;
+    size: number;
+    mode: number;
+}
+export interface FileHistoryState {
+    /** Finalized + persisted frames, oldest first. */
+    snapshots: FileHistorySnapshot[];
+    /** All tracking-paths ever edited this session. */
+    trackedFiles: Set<string>;
+    /** Latest backup per tracking path (finalized + in-progress pending versions). */
+    latestByTracking: Map<string, FileBackup>;
+    /**
+     * Worktree mtime/size/mode at the last backup or unchanged confirmation.
+     * beginTurn uses this to skip backup-blob stats/content when the worktree
+     * has not moved since we last recorded it (still stats the worktree once).
+     */
+    lastSeen: Map<string, SeenStats>;
+    /** The current turn's working frame (built across the turn, persisted at endTurn). */
+    pending: FileHistorySnapshot | null;
+    /** Whether the pending frame differs from the last finalized frame. */
+    dirty: boolean;
+    /** Monotonic activity counter (incremented on every finalized frame). */
+    seq: number;
+}
+export interface ApplySnapshotOptions {
+    /**
+     * Absolute paths already known to differ (e.g. from collectChanges).
+     * When set, only those paths are restored/deleted and originChanged is skipped.
+     */
+    onlyPaths?: ReadonlySet<string>;
+}
+/** Bind a session id to its cwd (for relative-path keying). Call at session_start. */
+export declare function registerSession(sid: string, cwd: string): void;
+export declare function disposeSession(sid: string): void;
+export declare function getSnapshots(sid: string): FileHistorySnapshot[];
+/**
+ * Open the working frame for a turn and re-record every tracked file at its
+ * current state (reuse latest backup when unchanged, new version when changed).
+ * Sets state.dirty when any file produced a new version.
+ */
+export declare function beginTurn(sid: string): Promise<void>;
+/**
+ * Back up a file about to be edited/written, if not already captured this turn.
+ * Call from the tool_call hook BEFORE the edit lands. ENOENT target -> null
+ * marker (rewind deletes the created file). Synchronous so the backup is on disk
+ * before the hook returns (see createBackupSync).
+ */
+export declare function trackEdit(sid: string, absPath: string): void;
+/**
+ * Finalize the turn. Returns the snapshot to persist (caller appendEntry's it),
+ * or null when nothing changed this turn. Pushes finalized frames into the
+ * in-memory ring (capped at MAX_SNAPSHOTS).
+ */
+export declare function endTurn(sid: string, userEntryId: string, turnId: string, prompt: string, timestamp: string, maxSnapshots?: number): FileHistorySnapshot | null;
+/**
+ * Absolute paths that restoring to `target` would change on disk (empty =
+ * nothing to do). Same walk applySnapshot performs, without writing — the
+ * caller can both count and preview the files from one pass. Concurrent with
+ * IO_CONCURRENCY; result order matches trackedFiles insertion order.
+ */
+export declare function collectChanges(sid: string, target: FileHistorySnapshot): Promise<string[]>;
+export interface CoarseDiffStats {
+    /** Absolute paths that would change (same as collectChanges). */
+    paths: string[];
+    /**
+     * Coarse line insertions when restoring (lines present in backup, not in
+     * current). Bag-of-lines, not a true Myers diff — confirm UI only.
+     */
+    insertions: number;
+    /** Coarse line deletions when restoring (lines present in current, not in backup). */
+    deletions: number;
+}
+/**
+ * Coarse +N/−M line stats for a restore confirm dialog. Only loads text for
+ * paths already known to differ (from collectChanges). Oversized files still
+ * appear in `paths` but contribute 0 to line totals. No extra dependency.
+ */
+export declare function collectChangeDiffStats(sid: string, target: FileHistorySnapshot, changedPaths: readonly string[]): Promise<CoarseDiffStats>;
+/**
+ * Restore the work tree to `target`. Returns the list of changed file paths.
+ * Pass `onlyPaths` (from a prior collectChanges) to skip a second originChanged
+ * pass and only touch those absolute paths.
+ */
+export declare function applySnapshot(sid: string, target: FileHistorySnapshot, opts?: ApplySnapshotOptions): Promise<string[]>;
+/** Rebuild in-memory state from snapshots persisted in the session JSONL. */
+export declare function restoreStateFromSnapshots(sid: string, cwd: string, snapshots: FileHistorySnapshot[], maxSnapshots?: number): void;
+/**
+ * Hard-link this session's backup blobs from a previous session's directory
+ * (resume/fork carries the conversation + its snapshot index, but the blobs live
+ * under the old session id). Falls back to copy. No-op when ids match.
+ */
+export declare function migrateBackupsFromSession(prevSid: string, sid: string, snapshots: FileHistorySnapshot[]): Promise<void>;
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/extensions/rewind/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/extensions/rewind/engine.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAcrE,qFAAqF;AACrF,UAAU,SAAS;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAUD,MAAM,WAAW,gBAAgB;IAChC,kDAAkD;IAClD,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,mDAAmD;IACnD,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,kFAAkF;IAClF,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,sFAAsF;IACtF,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChC;AAwDD,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAG9D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGhD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAE/D;AAqOD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqD1D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA2B5D;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACtB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,SAAgB,GAC1B,mBAAmB,GAAG,IAAI,CAkB5B;AAiCD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBhG;AAED,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC3C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,eAAe,CAAC,CA+B1B;AAkFD;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,mBAAmB,EAC3B,IAAI,CAAC,EAAE,oBAAoB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAuCnB;AAID,6EAA6E;AAC7E,wBAAgB,yBAAyB,CACxC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,mBAAmB,EAAE,EAChC,YAAY,SAAgB,GAC1B,IAAI,CAyBN;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC9C,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,mBAAmB,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC,CAyBf","sourcesContent":["/**\n * engine.ts — file-history backup engine for the rewind extension.\n *\n * Ported from Claude Code 2.1.88's src/utils/fileHistory.ts, adapted from its\n * React state-updater to module-level per-session maps. The core idea (and the\n * reason this exists): we back up ONLY the files Pi's edit/write tools are about\n * to modify — one copyFile before the edit — instead of snapshotting the whole\n * work tree. Cost is proportional to \"how many files Pi changed\", not project\n * size, so it never blocks the session-lifecycle critical path and storage stays\n * tiny.\n *\n * Per turn:\n *   - beginTurn()  (before_agent_start): open a working frame and re-record every\n *     already-tracked file at its current (turn-start) state, reusing the latest\n *     backup when unchanged (worktree lastSeen → mtime/size/content), creating a\n *     new version when not. lastSeen skips backup-blob IO when the worktree has\n *     not moved since the last confirm; content compare streams in 64 KiB chunks.\n *   - trackEdit()  (tool_call edit|write, before the write): back up a *newly*\n *     edited file at its pre-edit state into the working frame (null marker when\n *     the target does not exist yet, so rewind deletes the created file).\n *   - endTurn()    (agent_settled): if anything changed, stamp + return the frame\n *     to persist; else discard it. agent_settled (not agent_end) so auto-retry /\n *     overflow compact-retry / queued follow-ups share one logical turn.\n *\n * Rewind = applySnapshot(): restore every tracked file to the version recorded in\n * the target frame (copy back / delete for null), touching only files that differ.\n *\n * Backups live at <rewindBackupsDir(sessionId)>/<sha256(relpath)[:16]>@v<n>.\n */\nimport { createHash } from \"node:crypto\";\nimport { chmodSync, copyFileSync, mkdirSync, type Stats, statSync } from \"node:fs\";\nimport { chmod, copyFile, link, mkdir, open, readFile, stat, unlink } from \"node:fs/promises\";\nimport { dirname, isAbsolute, join, relative } from \"node:path\";\nimport type { FileBackup, FileHistorySnapshot } from \"./snapshot.ts\";\nimport { backupsDir } from \"./storage.ts\";\n\n/** Cap on retained snapshots per session (matches CC's MAX_SNAPSHOTS). */\nconst MAX_SNAPSHOTS = 100;\n/** Avoid reading very large files solely to compare backup content. */\nconst MAX_CONTENT_BYTES = 25 * 1024 * 1024;\n/** Cap concurrent backup/compare/restore IO so long tracked sets don't thrash handles. */\nconst IO_CONCURRENCY = 16;\n/** Cap bytes loaded for coarse restore line stats (confirm dialog only). */\nconst MAX_DIFF_BYTES = 1_048_576;\n/** Streaming compare chunk size (avoids buffering whole files up to MAX_CONTENT_BYTES). */\nconst COMPARE_CHUNK_BYTES = 64 * 1024;\n\n/** Worktree identity recorded when we last backed up / confirmed a tracking path. */\ninterface SeenStats {\n\tmtimeMs: number;\n\tsize: number;\n\tmode: number;\n}\n\nfunction seenFromStats(st: Stats): SeenStats {\n\treturn { mtimeMs: st.mtimeMs, size: st.size, mode: st.mode };\n}\n\nfunction sameSeen(a: SeenStats, b: Stats): boolean {\n\treturn a.mtimeMs === b.mtimeMs && a.size === b.size && a.mode === b.mode;\n}\n\nexport interface FileHistoryState {\n\t/** Finalized + persisted frames, oldest first. */\n\tsnapshots: FileHistorySnapshot[];\n\t/** All tracking-paths ever edited this session. */\n\ttrackedFiles: Set<string>;\n\t/** Latest backup per tracking path (finalized + in-progress pending versions). */\n\tlatestByTracking: Map<string, FileBackup>;\n\t/**\n\t * Worktree mtime/size/mode at the last backup or unchanged confirmation.\n\t * beginTurn uses this to skip backup-blob stats/content when the worktree\n\t * has not moved since we last recorded it (still stats the worktree once).\n\t */\n\tlastSeen: Map<string, SeenStats>;\n\t/** The current turn's working frame (built across the turn, persisted at endTurn). */\n\tpending: FileHistorySnapshot | null;\n\t/** Whether the pending frame differs from the last finalized frame. */\n\tdirty: boolean;\n\t/** Monotonic activity counter (incremented on every finalized frame). */\n\tseq: number;\n}\n\nexport interface ApplySnapshotOptions {\n\t/**\n\t * Absolute paths already known to differ (e.g. from collectChanges).\n\t * When set, only those paths are restored/deleted and originChanged is skipped.\n\t */\n\tonlyPaths?: ReadonlySet<string>;\n}\n\n// ---- per-session state ----------------------------------------------------\n\nconst states = new Map<string, FileHistoryState>();\nconst cwds = new Map<string, string>();\n\nfunction freshState(): FileHistoryState {\n\treturn {\n\t\tsnapshots: [],\n\t\ttrackedFiles: new Set(),\n\t\tlatestByTracking: new Map(),\n\t\tlastSeen: new Map(),\n\t\tpending: null,\n\t\tdirty: false,\n\t\tseq: 0,\n\t};\n}\n\n/** Run async work over items with a fixed concurrency cap. Preserves result order. */\nasync function mapPool<T, R>(items: readonly T[], concurrency: number, fn: (item: T) => Promise<R>): Promise<R[]> {\n\tif (items.length === 0) return [];\n\tconst results = new Array<R>(items.length);\n\tlet next = 0;\n\tasync function worker(): Promise<void> {\n\t\tfor (;;) {\n\t\t\tconst i = next++;\n\t\t\tif (i >= items.length) return;\n\t\t\tresults[i] = await fn(items[i]!);\n\t\t}\n\t}\n\tconst n = Math.min(concurrency, items.length);\n\tawait Promise.all(Array.from({ length: n }, () => worker()));\n\treturn results;\n}\n\n/** Rebuild latestByTracking from finalized frames (oldest → newest, last write wins). */\nfunction rebuildLatestIndex(snapshots: FileHistorySnapshot[]): Map<string, FileBackup> {\n\tconst latest = new Map<string, FileBackup>();\n\tfor (const snap of snapshots) {\n\t\tfor (const [tracking, backup] of Object.entries(snap.trackedFileBackups)) {\n\t\t\tlatest.set(tracking, backup);\n\t\t}\n\t}\n\treturn latest;\n}\n\nfunction getState(sid: string): FileHistoryState {\n\tlet s = states.get(sid);\n\tif (!s) {\n\t\ts = freshState();\n\t\tstates.set(sid, s);\n\t}\n\treturn s;\n}\n\n/** Bind a session id to its cwd (for relative-path keying). Call at session_start. */\nexport function registerSession(sid: string, cwd: string): void {\n\tcwds.set(sid, cwd);\n\tgetState(sid);\n}\n\nexport function disposeSession(sid: string): void {\n\tstates.delete(sid);\n\tcwds.delete(sid);\n}\n\nexport function getSnapshots(sid: string): FileHistorySnapshot[] {\n\treturn states.get(sid)?.snapshots ?? [];\n}\n\nfunction cwdFor(sid: string): string {\n\treturn cwds.get(sid) ?? process.cwd();\n}\n\n// ---- path helpers ---------------------------------------------------------\n\n/** Use the cwd-relative path as the tracking key when inside cwd (shorter, portable). */\nfunction shorten(absPath: string, cwd: string): string {\n\tif (!isAbsolute(absPath)) return absPath;\n\tif (absPath === cwd) return absPath;\n\tconst rel = relative(cwd, absPath);\n\tif (!rel || rel.startsWith(\"..\") || isAbsolute(rel)) return absPath;\n\treturn rel;\n}\n\nfunction expand(tracking: string, cwd: string): string {\n\treturn isAbsolute(tracking) ? tracking : join(cwd, tracking);\n}\n\nfunction backupName(tracking: string, version: number): string {\n\tconst h = createHash(\"sha256\").update(tracking).digest(\"hex\").slice(0, 16);\n\treturn `${h}@v${version}`;\n}\n\nfunction backupPathFor(sid: string, name: string): string {\n\treturn join(backupsDir(sid), name);\n}\n\nfunction latestBackupOf(state: FileHistoryState, tracking: string): FileBackup | undefined {\n\treturn state.latestByTracking.get(tracking);\n}\n\n/** First-ever recorded backup for a file (used when rewinding before it was tracked). */\nfunction firstBackupName(state: FileHistoryState, tracking: string): string | null | undefined {\n\tfor (const snap of state.snapshots) {\n\t\tconst b = snap.trackedFileBackups[tracking];\n\t\tif (b && b.version === 1) return b.backupName;\n\t}\n\treturn undefined;\n}\n\n/** Resolve the backup blob name for `tracking` at `target` (null = did not exist). */\nfunction backupNameForTarget(\n\tstate: FileHistoryState,\n\ttarget: FileHistorySnapshot,\n\ttracking: string,\n): string | null | undefined {\n\tconst tb = target.trackedFileBackups[tracking];\n\tif (tb) return tb.backupName;\n\treturn firstBackupName(state, tracking);\n}\n\n// ---- change detection (ported fileHistory.ts compareStatsAndContent;\n//      content path streams via filesEqualChunked instead of full-buffer reads)\n\nfunction isENOENT(e: unknown): boolean {\n\treturn !!e && typeof e === \"object\" && (e as { code?: string }).code === \"ENOENT\";\n}\n\nasync function statOrNull(p: string): Promise<Stats | null> {\n\ttry {\n\t\treturn await stat(p);\n\t} catch (e) {\n\t\tif (isENOENT(e)) return null;\n\t\tthrow e;\n\t}\n}\n\n/**\n * Raw-byte equality without buffering whole files. A utf-8 decode maps invalid\n * sequences to U+FFFD, which can make two DIFFERENT binary files compare equal —\n * and then rewind would silently skip both the re-backup and the restore.\n */\nasync function filesEqualChunked(aPath: string, bPath: string, size: number): Promise<boolean> {\n\tif (size === 0) return true;\n\tconst [aHandle, bHandle] = await Promise.all([open(aPath, \"r\"), open(bPath, \"r\")]);\n\ttry {\n\t\tconst aBuf = Buffer.allocUnsafe(COMPARE_CHUNK_BYTES);\n\t\tconst bBuf = Buffer.allocUnsafe(COMPARE_CHUNK_BYTES);\n\t\tlet remaining = size;\n\t\twhile (remaining > 0) {\n\t\t\tconst want = Math.min(COMPARE_CHUNK_BYTES, remaining);\n\t\t\tconst [aRead, bRead] = await Promise.all([\n\t\t\t\taHandle.read(aBuf, 0, want, null),\n\t\t\t\tbHandle.read(bBuf, 0, want, null),\n\t\t\t]);\n\t\t\tif (aRead.bytesRead !== bRead.bytesRead) return false;\n\t\t\tif (aRead.bytesRead === 0) return remaining === 0;\n\t\t\tif (!aBuf.subarray(0, aRead.bytesRead).equals(bBuf.subarray(0, bRead.bytesRead))) return false;\n\t\t\tremaining -= aRead.bytesRead;\n\t\t}\n\t\treturn true;\n\t} finally {\n\t\tawait Promise.allSettled([aHandle.close(), bHandle.close()]);\n\t}\n}\n\n/** True when the on-disk file differs from its backup blob. */\nasync function originChanged(sid: string, filePath: string, name: string, hint?: Stats): Promise<boolean> {\n\tconst backupPath = backupPathFor(sid, name);\n\tconst orig = hint ?? (await statOrNull(filePath).catch(() => null));\n\tconst back = await statOrNull(backupPath).catch(() => null);\n\n\t// One exists, one missing -> changed.\n\tif ((orig === null) !== (back === null)) return true;\n\tif (orig === null || back === null) return false;\n\tif (orig.mode !== back.mode || orig.size !== back.size) return true;\n\t// Original untouched since the backup was written -> unchanged (skip content read).\n\tif (orig.mtimeMs < back.mtimeMs) return false;\n\t// Memory guard: don't load huge files just to byte-compare; assume changed and\n\t// let createBackup stream a new version instead (copyFile never buffers whole files).\n\tif (orig.size > MAX_CONTENT_BYTES) return true;\n\ttry {\n\t\treturn !(await filesEqualChunked(filePath, backupPath, orig.size));\n\t} catch {\n\t\treturn true;\n\t}\n}\n\n// ---- backup / restore IO --------------------------------------------------\n\n/** Copy the file's current contents into a backup blob; null backup when absent. */\nasync function createBackup(\n\tsid: string,\n\tfilePath: string,\n\ttracking: string,\n\tversion: number,\n\tknown?: Stats | null,\n): Promise<FileBackup> {\n\tlet src: Stats;\n\tif (known === null) return { backupName: null, version };\n\tif (known) {\n\t\tsrc = known;\n\t} else {\n\t\ttry {\n\t\t\tsrc = await stat(filePath);\n\t\t} catch (e) {\n\t\t\tif (isENOENT(e)) return { backupName: null, version };\n\t\t\tthrow e;\n\t\t}\n\t}\n\tconst name = backupName(tracking, version);\n\tconst dest = backupPathFor(sid, name);\n\ttry {\n\t\tawait copyFile(filePath, dest);\n\t} catch (e) {\n\t\tif (!isENOENT(e)) throw e;\n\t\tawait mkdir(dirname(dest), { recursive: true });\n\t\tawait copyFile(filePath, dest);\n\t}\n\ttry {\n\t\tawait chmod(dest, src.mode);\n\t} catch {\n\t\t// best-effort (e.g. Windows); content is what matters\n\t}\n\treturn { backupName: name, version };\n}\n\n/**\n * Synchronous backup, used on the edit critical path (tool_call). Doing the copy\n * synchronously guarantees it completes before the hook returns control to the\n * host — so the backup always captures the file's PRE-edit contents, regardless\n * of whether the host awaits the hook before running the tool.\n *\n * `known` reuses a pre-stat from the caller (`null` = known ENOENT) so trackEdit\n * can record lastSeen without a second statSync on the critical path.\n */\nfunction createBackupSync(\n\tsid: string,\n\tfilePath: string,\n\ttracking: string,\n\tversion: number,\n\tknown?: Stats | null,\n): FileBackup {\n\tlet src: Stats;\n\tif (known === null) return { backupName: null, version };\n\tif (known) {\n\t\tsrc = known;\n\t} else {\n\t\ttry {\n\t\t\tsrc = statSync(filePath);\n\t\t} catch (e) {\n\t\t\tif (isENOENT(e)) return { backupName: null, version };\n\t\t\tthrow e;\n\t\t}\n\t}\n\tconst name = backupName(tracking, version);\n\tconst dest = backupPathFor(sid, name);\n\ttry {\n\t\tcopyFileSync(filePath, dest);\n\t} catch (e) {\n\t\tif (!isENOENT(e)) throw e;\n\t\tmkdirSync(dirname(dest), { recursive: true });\n\t\tcopyFileSync(filePath, dest);\n\t}\n\ttry {\n\t\tchmodSync(dest, src.mode);\n\t} catch {\n\t\t// best-effort\n\t}\n\treturn { backupName: name, version };\n}\n\nasync function restoreBackup(sid: string, filePath: string, name: string): Promise<void> {\n\tconst backupPath = backupPathFor(sid, name);\n\tlet back: Stats;\n\ttry {\n\t\tback = await stat(backupPath);\n\t} catch {\n\t\treturn; // backup vanished; leave the file untouched\n\t}\n\ttry {\n\t\tawait copyFile(backupPath, filePath);\n\t} catch (e) {\n\t\tif (!isENOENT(e)) throw e;\n\t\tawait mkdir(dirname(filePath), { recursive: true });\n\t\tawait copyFile(backupPath, filePath);\n\t}\n\ttry {\n\t\tawait chmod(filePath, back.mode);\n\t} catch {\n\t\t// best-effort\n\t}\n}\n\n// ---- per-turn lifecycle ---------------------------------------------------\n\n/**\n * Open the working frame for a turn and re-record every tracked file at its\n * current state (reuse latest backup when unchanged, new version when changed).\n * Sets state.dirty when any file produced a new version.\n */\nexport async function beginTurn(sid: string): Promise<void> {\n\tconst state = getState(sid);\n\tconst cwd = cwdFor(sid);\n\tconst backups: Record<string, FileBackup> = {};\n\tlet dirty = false;\n\n\tawait mapPool(Array.from(state.trackedFiles), IO_CONCURRENCY, async (tracking) => {\n\t\ttry {\n\t\t\tconst filePath = expand(tracking, cwd);\n\t\t\tconst latest = latestBackupOf(state, tracking);\n\t\t\tconst nextVersion = latest ? latest.version + 1 : 1;\n\t\t\tconst st = await statOrNull(filePath);\n\t\t\tif (!st) {\n\t\t\t\t// Already recorded absent in the latest frame -> reuse it. Allocating a\n\t\t\t\t// fresh null version every turn would pin dirty=true forever once a\n\t\t\t\t// tracked file is deleted, defeating the \"skip unchanged turns\" check\n\t\t\t\t// and flushing real checkpoints out of the capped ring.\n\t\t\t\tstate.lastSeen.delete(tracking);\n\t\t\t\tif (latest && latest.backupName === null) {\n\t\t\t\t\tbackups[tracking] = latest;\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst absent: FileBackup = { backupName: null, version: nextVersion };\n\t\t\t\tbackups[tracking] = absent;\n\t\t\t\tstate.latestByTracking.set(tracking, absent);\n\t\t\t\tdirty = true;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Worktree identity unchanged since last backup/confirm → reuse without\n\t\t\t// opening the backup blob (still paid one worktree stat above).\n\t\t\tconst seen = state.lastSeen.get(tracking);\n\t\t\tif (latest && latest.backupName !== null && seen && sameSeen(seen, st)) {\n\t\t\t\tbackups[tracking] = latest;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (latest && latest.backupName !== null && !(await originChanged(sid, filePath, latest.backupName, st))) {\n\t\t\t\tbackups[tracking] = latest; // unchanged -> reuse\n\t\t\t\tstate.lastSeen.set(tracking, seenFromStats(st));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst created = await createBackup(sid, filePath, tracking, nextVersion, st);\n\t\t\tbackups[tracking] = created;\n\t\t\tstate.latestByTracking.set(tracking, created);\n\t\t\t// Record the pre-backup worktree identity (copyFile does not change it).\n\t\t\tstate.lastSeen.set(tracking, seenFromStats(st));\n\t\t\tdirty = true;\n\t\t} catch {\n\t\t\t// skip this file; never break the turn\n\t\t}\n\t});\n\n\tstate.pending = { v: 1, userEntryId: \"\", turnId: \"\", prompt: \"\", trackedFileBackups: backups, timestamp: \"\" };\n\tstate.dirty = dirty;\n}\n\n/**\n * Back up a file about to be edited/written, if not already captured this turn.\n * Call from the tool_call hook BEFORE the edit lands. ENOENT target -> null\n * marker (rewind deletes the created file). Synchronous so the backup is on disk\n * before the hook returns (see createBackupSync).\n */\nexport function trackEdit(sid: string, absPath: string): void {\n\tconst state = getState(sid);\n\tconst cwd = cwdFor(sid);\n\tconst tracking = shorten(absPath, cwd);\n\n\tif (!state.pending) {\n\t\tstate.pending = { v: 1, userEntryId: \"\", turnId: \"\", prompt: \"\", trackedFileBackups: {}, timestamp: \"\" };\n\t}\n\tif (state.pending.trackedFileBackups[tracking]) return; // already captured this turn\n\n\tconst latest = latestBackupOf(state, tracking);\n\tconst version = latest ? latest.version + 1 : 1;\n\tconst filePath = expand(tracking, cwd);\n\t// One pre-edit stat: drives the backup and lastSeen (null = new-file marker).\n\tlet preEdit: Stats | null = null;\n\ttry {\n\t\tpreEdit = statSync(filePath);\n\t} catch (e) {\n\t\tif (!isENOENT(e)) throw e;\n\t}\n\tconst backup = createBackupSync(sid, filePath, tracking, version, preEdit);\n\tstate.pending.trackedFileBackups[tracking] = backup;\n\tstate.trackedFiles.add(tracking);\n\tstate.latestByTracking.set(tracking, backup);\n\tif (preEdit) state.lastSeen.set(tracking, seenFromStats(preEdit));\n\telse state.lastSeen.delete(tracking);\n\tstate.dirty = true;\n}\n\n/**\n * Finalize the turn. Returns the snapshot to persist (caller appendEntry's it),\n * or null when nothing changed this turn. Pushes finalized frames into the\n * in-memory ring (capped at MAX_SNAPSHOTS).\n */\nexport function endTurn(\n\tsid: string,\n\tuserEntryId: string,\n\tturnId: string,\n\tprompt: string,\n\ttimestamp: string,\n\tmaxSnapshots = MAX_SNAPSHOTS,\n): FileHistorySnapshot | null {\n\tconst state = getState(sid);\n\tconst pending = state.pending;\n\tstate.pending = null;\n\tif (!pending || !state.dirty) {\n\t\tstate.dirty = false;\n\t\treturn null;\n\t}\n\tstate.dirty = false;\n\tconst frame: FileHistorySnapshot = { ...pending, userEntryId, turnId, prompt, timestamp };\n\tstate.snapshots.push(frame);\n\tif (state.snapshots.length > maxSnapshots) {\n\t\tconst dropped = state.snapshots.slice(0, state.snapshots.length - maxSnapshots);\n\t\tstate.snapshots = state.snapshots.slice(-maxSnapshots);\n\t\tvoid pruneDroppedBlobs(sid, dropped, state.snapshots);\n\t}\n\tstate.seq++;\n\treturn frame;\n}\n\n/**\n * Best-effort deletion of backup blobs referenced ONLY by frames dropped from\n * the capped ring. Backups are reused across frames (an unchanged file keeps\n * pointing at the same version), so a blob is unlinked only when no retained\n * frame still references it. Without this, the cap trims the in-memory index\n * while the blob files accumulate for the whole session — gc.ts only reclaims\n * whole session directories.\n */\nasync function pruneDroppedBlobs(\n\tsid: string,\n\tdropped: FileHistorySnapshot[],\n\tretained: FileHistorySnapshot[],\n): Promise<void> {\n\tconst live = new Set<string>();\n\tfor (const snap of retained) {\n\t\tfor (const b of Object.values(snap.trackedFileBackups)) {\n\t\t\tif (b.backupName) live.add(b.backupName);\n\t\t}\n\t}\n\tconst doomed = new Set<string>();\n\tfor (const snap of dropped) {\n\t\tfor (const b of Object.values(snap.trackedFileBackups)) {\n\t\t\tif (b.backupName && !live.has(b.backupName)) doomed.add(b.backupName);\n\t\t}\n\t}\n\tif (doomed.size === 0) return;\n\tawait Promise.allSettled(Array.from(doomed, (name) => unlink(backupPathFor(sid, name))));\n}\n\n// ---- rewind ---------------------------------------------------------------\n\n/**\n * Absolute paths that restoring to `target` would change on disk (empty =\n * nothing to do). Same walk applySnapshot performs, without writing — the\n * caller can both count and preview the files from one pass. Concurrent with\n * IO_CONCURRENCY; result order matches trackedFiles insertion order.\n */\nexport async function collectChanges(sid: string, target: FileHistorySnapshot): Promise<string[]> {\n\tconst state = getState(sid);\n\tconst cwd = cwdFor(sid);\n\tconst trackings = Array.from(state.trackedFiles);\n\tconst results = await mapPool(trackings, IO_CONCURRENCY, async (tracking) => {\n\t\ttry {\n\t\t\tconst filePath = expand(tracking, cwd);\n\t\t\tconst name = backupNameForTarget(state, target, tracking);\n\t\t\tif (name === undefined) return null;\n\t\t\tif (name === null) {\n\t\t\t\treturn (await statOrNull(filePath)) ? filePath : null;\n\t\t\t}\n\t\t\treturn (await originChanged(sid, filePath, name)) ? filePath : null;\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t});\n\treturn results.filter((p): p is string => p !== null);\n}\n\nexport interface CoarseDiffStats {\n\t/** Absolute paths that would change (same as collectChanges). */\n\tpaths: string[];\n\t/**\n\t * Coarse line insertions when restoring (lines present in backup, not in\n\t * current). Bag-of-lines, not a true Myers diff — confirm UI only.\n\t */\n\tinsertions: number;\n\t/** Coarse line deletions when restoring (lines present in current, not in backup). */\n\tdeletions: number;\n}\n\n/**\n * Coarse +N/−M line stats for a restore confirm dialog. Only loads text for\n * paths already known to differ (from collectChanges). Oversized files still\n * appear in `paths` but contribute 0 to line totals. No extra dependency.\n */\nexport async function collectChangeDiffStats(\n\tsid: string,\n\ttarget: FileHistorySnapshot,\n\tchangedPaths: readonly string[],\n): Promise<CoarseDiffStats> {\n\tif (changedPaths.length === 0) {\n\t\treturn { paths: [], insertions: 0, deletions: 0 };\n\t}\n\tconst state = getState(sid);\n\tconst cwd = cwdFor(sid);\n\t// Reverse map abs path → tracking key for the known changed set.\n\tconst trackingByAbs = new Map<string, string>();\n\tfor (const tracking of state.trackedFiles) {\n\t\ttrackingByAbs.set(expand(tracking, cwd), tracking);\n\t}\n\n\tconst results = await mapPool([...changedPaths], IO_CONCURRENCY, async (filePath) => {\n\t\ttry {\n\t\t\tconst tracking = trackingByAbs.get(filePath);\n\t\t\tif (!tracking) return { insertions: 0, deletions: 0 };\n\t\t\tconst name = backupNameForTarget(state, target, tracking);\n\t\t\tif (name === undefined) return { insertions: 0, deletions: 0 };\n\t\t\treturn await coarseLineDelta(sid, filePath, name);\n\t\t} catch {\n\t\t\treturn { insertions: 0, deletions: 0 };\n\t\t}\n\t});\n\n\tlet insertions = 0;\n\tlet deletions = 0;\n\tfor (const r of results) {\n\t\tinsertions += r.insertions;\n\t\tdeletions += r.deletions;\n\t}\n\treturn { paths: [...changedPaths], insertions, deletions };\n}\n\n/**\n * Bag-of-lines delta for current worktree → backup target (restore direction).\n * insertions = lines that appear after restore; deletions = lines removed.\n */\nasync function coarseLineDelta(\n\tsid: string,\n\tfilePath: string,\n\tbackupName: string | null,\n): Promise<{ insertions: number; deletions: number }> {\n\tconst currentText = await readTextCapped(filePath, MAX_DIFF_BYTES);\n\tif (backupName === null) {\n\t\t// Snapshot: file did not exist → restore deletes it.\n\t\tif (currentText === null) return { insertions: 0, deletions: 0 };\n\t\treturn { insertions: 0, deletions: countLines(currentText) };\n\t}\n\tconst backupText = await readTextCapped(backupPathFor(sid, backupName), MAX_DIFF_BYTES);\n\tif (currentText === null && backupText === null) return { insertions: 0, deletions: 0 };\n\tif (currentText === null) return { insertions: countLines(backupText ?? \"\"), deletions: 0 };\n\tif (backupText === null) return { insertions: 0, deletions: countLines(currentText) };\n\treturn bagOfLinesDelta(currentText, backupText);\n}\n\n/** null = missing or oversize/unreadable (skip line contrib). */\nasync function readTextCapped(filePath: string, maxBytes: number): Promise<string | null> {\n\ttry {\n\t\tconst st = await statOrNull(filePath);\n\t\tif (!st) return null;\n\t\tif (st.size > maxBytes) return null;\n\t\tconst buf = await readFile(filePath);\n\t\t// Skip obvious binary (NUL in the first 8K).\n\t\tconst sample = buf.subarray(0, Math.min(buf.length, 8192));\n\t\tif (sample.includes(0)) return null;\n\t\treturn buf.toString(\"utf8\");\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction countLines(text: string): number {\n\tif (text.length === 0) return 0;\n\tlet n = 1;\n\tfor (let i = 0; i < text.length; i++) {\n\t\tif (text.charCodeAt(i) === 10 /* \\n */) n++;\n\t}\n\t// Trailing newline does not add an extra empty \"line\" for display counts.\n\tif (text.endsWith(\"\\n\")) n--;\n\treturn Math.max(n, 0);\n}\n\n/**\n * Multiset frequency delta: from → to.\n * deletions = lines over-represented in `from`; insertions = over-represented in `to`.\n */\nfunction bagOfLinesDelta(from: string, to: string): { insertions: number; deletions: number } {\n\tconst fromCounts = lineFrequency(from);\n\tconst toCounts = lineFrequency(to);\n\tlet insertions = 0;\n\tlet deletions = 0;\n\tconst keys = new Set([...fromCounts.keys(), ...toCounts.keys()]);\n\tfor (const key of keys) {\n\t\tconst a = fromCounts.get(key) ?? 0;\n\t\tconst b = toCounts.get(key) ?? 0;\n\t\tif (b > a) insertions += b - a;\n\t\telse if (a > b) deletions += a - b;\n\t}\n\treturn { insertions, deletions };\n}\n\nfunction lineFrequency(text: string): Map<string, number> {\n\tconst map = new Map<string, number>();\n\t// Preserve empty file as zero lines; otherwise split including last empty.\n\tif (text.length === 0) return map;\n\tconst lines = text.split(\"\\n\");\n\tif (lines.length > 0 && lines[lines.length - 1] === \"\") lines.pop();\n\tfor (const line of lines) {\n\t\tmap.set(line, (map.get(line) ?? 0) + 1);\n\t}\n\treturn map;\n}\n\n/**\n * Restore the work tree to `target`. Returns the list of changed file paths.\n * Pass `onlyPaths` (from a prior collectChanges) to skip a second originChanged\n * pass and only touch those absolute paths.\n */\nexport async function applySnapshot(\n\tsid: string,\n\ttarget: FileHistorySnapshot,\n\topts?: ApplySnapshotOptions,\n): Promise<string[]> {\n\tconst state = getState(sid);\n\tconst cwd = cwdFor(sid);\n\tconst only = opts?.onlyPaths;\n\tconst trackings = Array.from(state.trackedFiles).filter((tracking) => {\n\t\tif (!only) return true;\n\t\treturn only.has(expand(tracking, cwd));\n\t});\n\n\tconst results = await mapPool(trackings, IO_CONCURRENCY, async (tracking) => {\n\t\ttry {\n\t\t\tconst filePath = expand(tracking, cwd);\n\t\t\tconst name = backupNameForTarget(state, target, tracking);\n\t\t\tif (name === undefined) return null; // can't resolve -> leave file alone\n\t\t\tif (name === null) {\n\t\t\t\ttry {\n\t\t\t\t\tawait unlink(filePath);\n\t\t\t\t\t// Worktree no longer matches any recorded identity.\n\t\t\t\t\tstate.lastSeen.delete(tracking);\n\t\t\t\t\treturn filePath;\n\t\t\t\t} catch (e) {\n\t\t\t\t\tif (!isENOENT(e)) throw e;\n\t\t\t\t\treturn null;\n\t\t\t\t}\n\t\t\t}\n\t\t\t// onlyPaths already proven different at confirm time — skip re-compare.\n\t\t\tif (only || (await originChanged(sid, filePath, name))) {\n\t\t\t\tawait restoreBackup(sid, filePath, name);\n\t\t\t\t// Drop stale lastSeen: worktree now matches the target blob, not the\n\t\t\t\t// latest backup identity beginTurn compares against.\n\t\t\t\tstate.lastSeen.delete(tracking);\n\t\t\t\treturn filePath;\n\t\t\t}\n\t\t\treturn null;\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t});\n\treturn results.filter((p): p is string => p !== null);\n}\n\n// ---- persistence rebuild + resume migration -------------------------------\n\n/** Rebuild in-memory state from snapshots persisted in the session JSONL. */\nexport function restoreStateFromSnapshots(\n\tsid: string,\n\tcwd: string,\n\tsnapshots: FileHistorySnapshot[],\n\tmaxSnapshots = MAX_SNAPSHOTS,\n): void {\n\tcwds.set(sid, cwd);\n\t// Apply the same cap on reload so a long session's JSONL can't reinflate the\n\t// in-memory ring past the limit. trackedFiles is rebuilt from the retained\n\t// frames only (older frames are unreachable for rewind anyway); blobs only\n\t// those frames referenced are pruned best-effort, mirroring endTurn.\n\tconst retained = snapshots.length > maxSnapshots ? snapshots.slice(-maxSnapshots) : snapshots;\n\tif (retained.length < snapshots.length) {\n\t\tvoid pruneDroppedBlobs(sid, snapshots.slice(0, snapshots.length - retained.length), retained);\n\t}\n\tconst trackedFiles = new Set<string>();\n\tfor (const snap of retained) {\n\t\tfor (const key of Object.keys(snap.trackedFileBackups)) trackedFiles.add(key);\n\t}\n\tstates.set(sid, {\n\t\tsnapshots: [...retained],\n\t\ttrackedFiles,\n\t\tlatestByTracking: rebuildLatestIndex(retained),\n\t\t// lastSeen is process-local; after reload we re-establish it on the first\n\t\t// beginTurn via originChanged / createBackup.\n\t\tlastSeen: new Map(),\n\t\tpending: null,\n\t\tdirty: false,\n\t\tseq: retained.length,\n\t});\n}\n\n/**\n * Hard-link this session's backup blobs from a previous session's directory\n * (resume/fork carries the conversation + its snapshot index, but the blobs live\n * under the old session id). Falls back to copy. No-op when ids match.\n */\nexport async function migrateBackupsFromSession(\n\tprevSid: string,\n\tsid: string,\n\tsnapshots: FileHistorySnapshot[],\n): Promise<void> {\n\tif (!prevSid || prevSid === sid) return;\n\tconst destDir = backupsDir(sid);\n\tawait mkdir(destDir, { recursive: true });\n\tawait Promise.allSettled(\n\t\tsnapshots.flatMap((snap) =>\n\t\t\tObject.values(snap.trackedFileBackups)\n\t\t\t\t.filter((b): b is FileBackup & { backupName: string } => b.backupName !== null)\n\t\t\t\t.map(async ({ backupName: name }) => {\n\t\t\t\t\tconst from = join(backupsDir(prevSid), name);\n\t\t\t\t\tconst to = join(destDir, name);\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait link(from, to);\n\t\t\t\t\t} catch (e) {\n\t\t\t\t\t\tconst code = (e as { code?: string }).code;\n\t\t\t\t\t\tif (code === \"EEXIST\") return;\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tawait copyFile(from, to);\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t// best-effort; a missing blob just means that version can't restore\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t),\n\t);\n}\n"]}