@evalops/maestro 0.10.50 → 0.10.53

package/dist/tools/write.js

@@ -54,6 +54,7 @@ import { constants } from "node:fs";
 import { access, mkdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
 import { dirname, resolve as resolvePath } from "node:path";
 import { Type } from "@sinclair/typebox";
+import { detectMissionSessionRole, validateMissionArtifactWrite, } from "../agent/mission-artifacts.js";
 import { captureDiagnosticBaseline, collectDiagnosticDelta, } from "../lsp/diagnostic-deltas.js";
 import { buildDiagnosticDeltaToolSummary, formatDiagnosticDeltaForToolOutput, } from "../lsp/diagnostic-repair.js";
 import { assertTeamMemoryContentSafe } from "../memory/team-memory.js";
@@ -87,6 +88,14 @@ export const writeTool = createTool({
         requirePlanCheck("write");
         const absolutePath = resolvePath(expandUserPath(path));
         assertTeamMemoryContentSafe(absolutePath, content);
+        const missionArtifactWrite = validateMissionArtifactWrite({
+            filePath: absolutePath,
+            content,
+            role: detectMissionSessionRole(),
+        });
+        if (!missionArtifactWrite.ok) {
+            return respond.error(missionArtifactWrite.message);
+        }
         // Use sandbox if available
         if (sandbox) {
             try {

package/dist/tools/write.js.map

@@ -1 +1 @@
-{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Write Tool - Safe File Writing with Validation\n *\n * This module provides a file writing tool with built-in safety features\n * including backup creation, LSP diagnostics, validator integration, and\n * sandbox support. It creates parent directories automatically.\n *\n * ## Safety Features\n *\n * - **Backup creation**: Automatically creates .bak files before overwriting\n * - **Plan checking**: Requires plan approval in safe mode\n * - **LSP integration**: Collects diagnostics after writing\n * - **Validator support**: Runs configured validators on written files\n * - **Rollback**: Restores original content if validators fail\n *\n * ## Write Flow\n *\n * ```\n * ┌─────────────────────────────────────────────────────────────┐\n * │                     Write Operation Flow                    │\n * ├─────────────────────────────────────────────────────────────┤\n * │  1. Check plan approval (safe mode)                         │\n * │  2. Create parent directories                               │\n * │  3. Read existing content (if any)                          │\n * │  4. Create backup (.bak file)                               │\n * │  5. Write new content                                       │\n * │  6. Collect LSP diagnostics                                 │\n * │  7. Run validators                                          │\n * │  8. If validators fail → restore backup                     │\n * │  9. Return success with diff preview                        │\n * └─────────────────────────────────────────────────────────────┘\n * ```\n *\n * ## Sandbox Mode\n *\n * When running in a sandbox environment, the tool uses the sandbox's\n * virtual filesystem instead of the real filesystem.\n *\n * ## Example\n *\n * ```typescript\n * // Write a new file\n * writeTool.execute('call-id', {\n *   path: 'src/utils/helper.ts',\n *   content: 'export function helper() { return 42; }',\n *   backup: true,\n *   previewDiff: true,\n * });\n * ```\n *\n * @module tools/write\n */\n\nimport { constants } from \"node:fs\";\nimport {\n\taccess,\n\tmkdir,\n\treadFile,\n\trename,\n\trm,\n\twriteFile,\n} from \"node:fs/promises\";\nimport { dirname, resolve as resolvePath } from \"node:path\";\nimport { Type } from \"@sinclair/typebox\";\nimport {\n\tcaptureDiagnosticBaseline,\n\tcollectDiagnosticDelta,\n} from \"../lsp/diagnostic-deltas.js\";\nimport {\n\ttype DiagnosticDeltaToolSummary,\n\tbuildDiagnosticDeltaToolSummary,\n\tformatDiagnosticDeltaForToolOutput,\n} from \"../lsp/diagnostic-repair.js\";\nimport { assertTeamMemoryContentSafe } from \"../memory/team-memory.js\";\nimport {\n\trequirePlanCheck,\n\trunValidatorsOnSuccess,\n} from \"../safety/safe-mode.js\";\nimport type { ValidatorRunResult } from \"../safety/safe-mode.js\";\nimport { formatLspDiagnostics, generateDiffString } from \"./diff-utils.js\";\nimport { createTool, expandUserPath } from \"./tool-dsl.js\";\n\nconst writeSchema = Type.Object({\n\tpath: Type.String({\n\t\tdescription: \"Path to the file to write (relative or absolute)\",\n\t\tminLength: 1,\n\t}),\n\tcontent: Type.String({\n\t\tdescription: \"Content to write to the file\",\n\t\tdefault: \"\",\n\t}),\n\tpreviewDiff: Type.Boolean({\n\t\tdescription:\n\t\t\t\"If true, return the diff between previous content and new content (when file exists)\",\n\t\tdefault: true,\n\t}),\n\tbackup: Type.Boolean({\n\t\tdescription:\n\t\t\t\"If true, writes a .bak copy alongside the file before overwriting\",\n\t\tdefault: true,\n\t}),\n});\n\ntype WriteToolDetails = {\n\tpreviousExists?: boolean;\n\tbytesWritten?: number;\n\tdiff?: string;\n\tbackupPath?: string;\n\tvalidators?: ValidatorRunResult[];\n\tdiagnosticDelta?: DiagnosticDeltaToolSummary;\n\tmode?: \"sandbox\";\n};\n\nexport const writeTool = createTool<typeof writeSchema, WriteToolDetails>({\n\tname: \"write\",\n\tlabel: \"write\",\n\tdescription:\n\t\t\"Write content to a file. Creates the file if it doesn't exist, overwrites if it does. Automatically creates parent directories.\",\n\tschema: writeSchema,\n\tasync run(\n\t\t{ path, content, previewDiff = true, backup = true },\n\t\t{ signal, respond, sandbox },\n\t) {\n\t\trequirePlanCheck(\"write\");\n\t\tconst absolutePath = resolvePath(expandUserPath(path));\n\t\tassertTeamMemoryContentSafe(absolutePath, content);\n\n\t\t// Use sandbox if available\n\t\tif (sandbox) {\n\t\t\ttry {\n\t\t\t\tlet previousContent: string | null = null;\n\t\t\t\ttry {\n\t\t\t\t\tif (await sandbox.exists(path)) {\n\t\t\t\t\t\tpreviousContent = await sandbox.readFile(path);\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// File doesn't exist\n\t\t\t\t}\n\n\t\t\t\tawait sandbox.writeFile(path, content);\n\n\t\t\t\tconst diff =\n\t\t\t\t\tpreviousContent !== null && previewDiff\n\t\t\t\t\t\t? generateDiffString(previousContent, content)\n\t\t\t\t\t\t: undefined;\n\n\t\t\t\treturn respond\n\t\t\t\t\t.text(\n\t\t\t\t\t\tpreviousContent !== null\n\t\t\t\t\t\t\t? `Updated ${path} in sandbox`\n\t\t\t\t\t\t\t: `Created ${path} in sandbox`,\n\t\t\t\t\t)\n\t\t\t\t\t.detail({ diff, mode: \"sandbox\" });\n\t\t\t} catch (err) {\n\t\t\t\treturn respond.error(\n\t\t\t\t\t`Failed to write file in sandbox: ${err instanceof Error ? err.message : String(err)}`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tconst dir = dirname(absolutePath);\n\t\tconst ensureNotAborted = () => {\n\t\t\tif (signal?.aborted) {\n\t\t\t\tthrow new Error(\"Operation aborted\");\n\t\t\t}\n\t\t};\n\n\t\tensureNotAborted();\n\t\tawait mkdir(dir, { recursive: true });\n\t\tensureNotAborted();\n\n\t\tlet previousContent: string | null = null;\n\t\tlet backupPath: string | undefined;\n\t\tlet previousExists = false;\n\n\t\ttry {\n\t\t\tawait access(absolutePath, constants.R_OK);\n\t\t\tpreviousContent = await readFile(absolutePath, \"utf-8\");\n\t\t\tpreviousExists = true;\n\t\t} catch {\n\t\t\tpreviousExists = false;\n\t\t}\n\n\t\tensureNotAborted();\n\n\t\tconst diagnosticBaseline = await captureDiagnosticBaseline(absolutePath);\n\t\tensureNotAborted();\n\n\t\tlet movedToBackup = false;\n\t\tif (previousExists && backup && previousContent !== null) {\n\t\t\tbackupPath = `${absolutePath}.bak`;\n\t\t\ttry {\n\t\t\t\tawait rename(absolutePath, backupPath);\n\t\t\t\tmovedToBackup = true;\n\t\t\t} catch {\n\t\t\t\tawait writeFile(backupPath, previousContent, \"utf-8\");\n\t\t\t}\n\t\t}\n\n\t\tensureNotAborted();\n\n\t\ttry {\n\t\t\tawait writeFile(absolutePath, content, \"utf-8\");\n\t\t} catch (error) {\n\t\t\tif (movedToBackup && backupPath) {\n\t\t\t\ttry {\n\t\t\t\t\tawait rename(backupPath, absolutePath);\n\t\t\t\t} catch {\n\t\t\t\t\t// Best-effort restore; ignore restore errors\n\t\t\t\t}\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\n\t\tensureNotAborted();\n\n\t\tconst diff =\n\t\t\tpreviousContent !== null && previewDiff\n\t\t\t\t? generateDiffString(previousContent, content)\n\t\t\t\t: undefined;\n\n\t\tlet validatorSummaries: ValidatorRunResult[] | undefined;\n\t\tlet linterOutput = \"\";\n\t\tlet diagnosticDeltaSummary: DiagnosticDeltaToolSummary | undefined;\n\t\ttry {\n\t\t\tconst diagnosticDelta = await collectDiagnosticDelta(diagnosticBaseline);\n\t\t\tdiagnosticDeltaSummary = buildDiagnosticDeltaToolSummary({\n\t\t\t\tfile: absolutePath,\n\t\t\t\tdisplayPath: path,\n\t\t\t\tresult: diagnosticDelta,\n\t\t\t});\n\t\t\tconst visibleDiagnostics = diagnosticDelta.usedDelta\n\t\t\t\t? diagnosticDelta.newDiagnostics\n\t\t\t\t: diagnosticDelta.fileDiagnostics;\n\t\t\tif (visibleDiagnostics.length > 0) {\n\t\t\t\tlinterOutput = formatLspDiagnostics(path, visibleDiagnostics);\n\t\t\t}\n\n\t\t\tvalidatorSummaries = await runValidatorsOnSuccess(\n\t\t\t\t[absolutePath],\n\t\t\t\tdiagnosticDelta.validatorDiagnostics,\n\t\t\t);\n\t\t} catch (validatorError) {\n\t\t\tif (movedToBackup && backupPath) {\n\t\t\t\tawait rename(backupPath, absolutePath);\n\t\t\t} else if (!previousExists) {\n\t\t\t\tawait rm(absolutePath, { force: true });\n\t\t\t} else if (previousContent !== null) {\n\t\t\t\tawait writeFile(absolutePath, previousContent, \"utf-8\");\n\t\t\t}\n\t\t\tthrow validatorError;\n\t\t}\n\n\t\tconst summaryLines: string[] = [];\n\t\tsummaryLines.push(`Successfully wrote ${content.length} bytes to ${path}`);\n\t\tif (previousExists) {\n\t\t\tsummaryLines.push(\"Previous content was overwritten.\");\n\t\t\tif (backupPath) {\n\t\t\t\tsummaryLines.push(`Backup saved to ${backupPath}`);\n\t\t\t}\n\t\t\tif (diff) {\n\t\t\t\tsummaryLines.push(\"Diff preview available in tool details.\");\n\t\t\t}\n\t\t} else {\n\t\t\tsummaryLines.push(\"File did not exist; it was created.\");\n\t\t}\n\n\t\tif (linterOutput) {\n\t\t\tsummaryLines.push(linterOutput);\n\t\t}\n\t\tif (diagnosticDeltaSummary) {\n\t\t\tconst diagnosticDeltaOutput = formatDiagnosticDeltaForToolOutput(\n\t\t\t\tdiagnosticDeltaSummary,\n\t\t\t);\n\t\t\tif (diagnosticDeltaOutput) {\n\t\t\t\tsummaryLines.push(diagnosticDeltaOutput);\n\t\t\t}\n\t\t}\n\n\t\treturn respond.text(summaryLines.join(\"\\n\")).detail({\n\t\t\tpreviousExists,\n\t\t\tbytesWritten: Buffer.byteLength(content, \"utf-8\"),\n\t\t\tdiff,\n\t\t\tbackupPath,\n\t\t\tvalidators: validatorSummaries,\n\t\t\tdiagnosticDelta: diagnosticDeltaSummary,\n\t\t});\n\t},\n});\n"]}
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Write Tool - Safe File Writing with Validation\n *\n * This module provides a file writing tool with built-in safety features\n * including backup creation, LSP diagnostics, validator integration, and\n * sandbox support. It creates parent directories automatically.\n *\n * ## Safety Features\n *\n * - **Backup creation**: Automatically creates .bak files before overwriting\n * - **Plan checking**: Requires plan approval in safe mode\n * - **LSP integration**: Collects diagnostics after writing\n * - **Validator support**: Runs configured validators on written files\n * - **Rollback**: Restores original content if validators fail\n *\n * ## Write Flow\n *\n * ```\n * ┌─────────────────────────────────────────────────────────────┐\n * │                     Write Operation Flow                    │\n * ├─────────────────────────────────────────────────────────────┤\n * │  1. Check plan approval (safe mode)                         │\n * │  2. Create parent directories                               │\n * │  3. Read existing content (if any)                          │\n * │  4. Create backup (.bak file)                               │\n * │  5. Write new content                                       │\n * │  6. Collect LSP diagnostics                                 │\n * │  7. Run validators                                          │\n * │  8. If validators fail → restore backup                     │\n * │  9. Return success with diff preview                        │\n * └─────────────────────────────────────────────────────────────┘\n * ```\n *\n * ## Sandbox Mode\n *\n * When running in a sandbox environment, the tool uses the sandbox's\n * virtual filesystem instead of the real filesystem.\n *\n * ## Example\n *\n * ```typescript\n * // Write a new file\n * writeTool.execute('call-id', {\n *   path: 'src/utils/helper.ts',\n *   content: 'export function helper() { return 42; }',\n *   backup: true,\n *   previewDiff: true,\n * });\n * ```\n *\n * @module tools/write\n */\n\nimport { constants } from \"node:fs\";\nimport {\n\taccess,\n\tmkdir,\n\treadFile,\n\trename,\n\trm,\n\twriteFile,\n} from \"node:fs/promises\";\nimport { dirname, resolve as resolvePath } from \"node:path\";\nimport { Type } from \"@sinclair/typebox\";\nimport {\n\tdetectMissionSessionRole,\n\tvalidateMissionArtifactWrite,\n} from \"../agent/mission-artifacts.js\";\nimport {\n\tcaptureDiagnosticBaseline,\n\tcollectDiagnosticDelta,\n} from \"../lsp/diagnostic-deltas.js\";\nimport {\n\ttype DiagnosticDeltaToolSummary,\n\tbuildDiagnosticDeltaToolSummary,\n\tformatDiagnosticDeltaForToolOutput,\n} from \"../lsp/diagnostic-repair.js\";\nimport { assertTeamMemoryContentSafe } from \"../memory/team-memory.js\";\nimport {\n\trequirePlanCheck,\n\trunValidatorsOnSuccess,\n} from \"../safety/safe-mode.js\";\nimport type { ValidatorRunResult } from \"../safety/safe-mode.js\";\nimport { formatLspDiagnostics, generateDiffString } from \"./diff-utils.js\";\nimport { createTool, expandUserPath } from \"./tool-dsl.js\";\n\nconst writeSchema = Type.Object({\n\tpath: Type.String({\n\t\tdescription: \"Path to the file to write (relative or absolute)\",\n\t\tminLength: 1,\n\t}),\n\tcontent: Type.String({\n\t\tdescription: \"Content to write to the file\",\n\t\tdefault: \"\",\n\t}),\n\tpreviewDiff: Type.Boolean({\n\t\tdescription:\n\t\t\t\"If true, return the diff between previous content and new content (when file exists)\",\n\t\tdefault: true,\n\t}),\n\tbackup: Type.Boolean({\n\t\tdescription:\n\t\t\t\"If true, writes a .bak copy alongside the file before overwriting\",\n\t\tdefault: true,\n\t}),\n});\n\ntype WriteToolDetails = {\n\tpreviousExists?: boolean;\n\tbytesWritten?: number;\n\tdiff?: string;\n\tbackupPath?: string;\n\tvalidators?: ValidatorRunResult[];\n\tdiagnosticDelta?: DiagnosticDeltaToolSummary;\n\tmode?: \"sandbox\";\n};\n\nexport const writeTool = createTool<typeof writeSchema, WriteToolDetails>({\n\tname: \"write\",\n\tlabel: \"write\",\n\tdescription:\n\t\t\"Write content to a file. Creates the file if it doesn't exist, overwrites if it does. Automatically creates parent directories.\",\n\tschema: writeSchema,\n\tasync run(\n\t\t{ path, content, previewDiff = true, backup = true },\n\t\t{ signal, respond, sandbox },\n\t) {\n\t\trequirePlanCheck(\"write\");\n\t\tconst absolutePath = resolvePath(expandUserPath(path));\n\t\tassertTeamMemoryContentSafe(absolutePath, content);\n\t\tconst missionArtifactWrite = validateMissionArtifactWrite({\n\t\t\tfilePath: absolutePath,\n\t\t\tcontent,\n\t\t\trole: detectMissionSessionRole(),\n\t\t});\n\t\tif (!missionArtifactWrite.ok) {\n\t\t\treturn respond.error(missionArtifactWrite.message);\n\t\t}\n\n\t\t// Use sandbox if available\n\t\tif (sandbox) {\n\t\t\ttry {\n\t\t\t\tlet previousContent: string | null = null;\n\t\t\t\ttry {\n\t\t\t\t\tif (await sandbox.exists(path)) {\n\t\t\t\t\t\tpreviousContent = await sandbox.readFile(path);\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// File doesn't exist\n\t\t\t\t}\n\n\t\t\t\tawait sandbox.writeFile(path, content);\n\n\t\t\t\tconst diff =\n\t\t\t\t\tpreviousContent !== null && previewDiff\n\t\t\t\t\t\t? generateDiffString(previousContent, content)\n\t\t\t\t\t\t: undefined;\n\n\t\t\t\treturn respond\n\t\t\t\t\t.text(\n\t\t\t\t\t\tpreviousContent !== null\n\t\t\t\t\t\t\t? `Updated ${path} in sandbox`\n\t\t\t\t\t\t\t: `Created ${path} in sandbox`,\n\t\t\t\t\t)\n\t\t\t\t\t.detail({ diff, mode: \"sandbox\" });\n\t\t\t} catch (err) {\n\t\t\t\treturn respond.error(\n\t\t\t\t\t`Failed to write file in sandbox: ${err instanceof Error ? err.message : String(err)}`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tconst dir = dirname(absolutePath);\n\t\tconst ensureNotAborted = () => {\n\t\t\tif (signal?.aborted) {\n\t\t\t\tthrow new Error(\"Operation aborted\");\n\t\t\t}\n\t\t};\n\n\t\tensureNotAborted();\n\t\tawait mkdir(dir, { recursive: true });\n\t\tensureNotAborted();\n\n\t\tlet previousContent: string | null = null;\n\t\tlet backupPath: string | undefined;\n\t\tlet previousExists = false;\n\n\t\ttry {\n\t\t\tawait access(absolutePath, constants.R_OK);\n\t\t\tpreviousContent = await readFile(absolutePath, \"utf-8\");\n\t\t\tpreviousExists = true;\n\t\t} catch {\n\t\t\tpreviousExists = false;\n\t\t}\n\n\t\tensureNotAborted();\n\n\t\tconst diagnosticBaseline = await captureDiagnosticBaseline(absolutePath);\n\t\tensureNotAborted();\n\n\t\tlet movedToBackup = false;\n\t\tif (previousExists && backup && previousContent !== null) {\n\t\t\tbackupPath = `${absolutePath}.bak`;\n\t\t\ttry {\n\t\t\t\tawait rename(absolutePath, backupPath);\n\t\t\t\tmovedToBackup = true;\n\t\t\t} catch {\n\t\t\t\tawait writeFile(backupPath, previousContent, \"utf-8\");\n\t\t\t}\n\t\t}\n\n\t\tensureNotAborted();\n\n\t\ttry {\n\t\t\tawait writeFile(absolutePath, content, \"utf-8\");\n\t\t} catch (error) {\n\t\t\tif (movedToBackup && backupPath) {\n\t\t\t\ttry {\n\t\t\t\t\tawait rename(backupPath, absolutePath);\n\t\t\t\t} catch {\n\t\t\t\t\t// Best-effort restore; ignore restore errors\n\t\t\t\t}\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\n\t\tensureNotAborted();\n\n\t\tconst diff =\n\t\t\tpreviousContent !== null && previewDiff\n\t\t\t\t? generateDiffString(previousContent, content)\n\t\t\t\t: undefined;\n\n\t\tlet validatorSummaries: ValidatorRunResult[] | undefined;\n\t\tlet linterOutput = \"\";\n\t\tlet diagnosticDeltaSummary: DiagnosticDeltaToolSummary | undefined;\n\t\ttry {\n\t\t\tconst diagnosticDelta = await collectDiagnosticDelta(diagnosticBaseline);\n\t\t\tdiagnosticDeltaSummary = buildDiagnosticDeltaToolSummary({\n\t\t\t\tfile: absolutePath,\n\t\t\t\tdisplayPath: path,\n\t\t\t\tresult: diagnosticDelta,\n\t\t\t});\n\t\t\tconst visibleDiagnostics = diagnosticDelta.usedDelta\n\t\t\t\t? diagnosticDelta.newDiagnostics\n\t\t\t\t: diagnosticDelta.fileDiagnostics;\n\t\t\tif (visibleDiagnostics.length > 0) {\n\t\t\t\tlinterOutput = formatLspDiagnostics(path, visibleDiagnostics);\n\t\t\t}\n\n\t\t\tvalidatorSummaries = await runValidatorsOnSuccess(\n\t\t\t\t[absolutePath],\n\t\t\t\tdiagnosticDelta.validatorDiagnostics,\n\t\t\t);\n\t\t} catch (validatorError) {\n\t\t\tif (movedToBackup && backupPath) {\n\t\t\t\tawait rename(backupPath, absolutePath);\n\t\t\t} else if (!previousExists) {\n\t\t\t\tawait rm(absolutePath, { force: true });\n\t\t\t} else if (previousContent !== null) {\n\t\t\t\tawait writeFile(absolutePath, previousContent, \"utf-8\");\n\t\t\t}\n\t\t\tthrow validatorError;\n\t\t}\n\n\t\tconst summaryLines: string[] = [];\n\t\tsummaryLines.push(`Successfully wrote ${content.length} bytes to ${path}`);\n\t\tif (previousExists) {\n\t\t\tsummaryLines.push(\"Previous content was overwritten.\");\n\t\t\tif (backupPath) {\n\t\t\t\tsummaryLines.push(`Backup saved to ${backupPath}`);\n\t\t\t}\n\t\t\tif (diff) {\n\t\t\t\tsummaryLines.push(\"Diff preview available in tool details.\");\n\t\t\t}\n\t\t} else {\n\t\t\tsummaryLines.push(\"File did not exist; it was created.\");\n\t\t}\n\n\t\tif (linterOutput) {\n\t\t\tsummaryLines.push(linterOutput);\n\t\t}\n\t\tif (diagnosticDeltaSummary) {\n\t\t\tconst diagnosticDeltaOutput = formatDiagnosticDeltaForToolOutput(\n\t\t\t\tdiagnosticDeltaSummary,\n\t\t\t);\n\t\t\tif (diagnosticDeltaOutput) {\n\t\t\t\tsummaryLines.push(diagnosticDeltaOutput);\n\t\t\t}\n\t\t}\n\n\t\treturn respond.text(summaryLines.join(\"\\n\")).detail({\n\t\t\tpreviousExists,\n\t\t\tbytesWritten: Buffer.byteLength(content, \"utf-8\"),\n\t\t\tdiff,\n\t\t\tbackupPath,\n\t\t\tvalidators: validatorSummaries,\n\t\t\tdiagnosticDelta: diagnosticDeltaSummary,\n\t\t});\n\t},\n});\n"]}

package/dist/undo/tracker.d.ts

@@ -62,6 +62,11 @@ export declare class ChangeTracker {
         skipped: number;
         errors: string[];
     };
+    /**
+     * Delete a checkpoint by name.
+     * @returns true if a checkpoint was removed, false if none matched.
+     */
+    deleteCheckpoint(name: string): boolean;
     /**
      * Clear all tracked changes.
      */

package/dist/undo/tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/undo/tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EACX,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,MAAM,YAAY,CAAC;AA6CpB;;GAEG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,KAAK,CAAqB;gBAEtB,UAAU,SAAsB;IAQ5C;;;OAGG;IACH,YAAY,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GAChB,MAAM;IA8CT;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqBtC;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,UAAU,EAAE;IAiBhB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE;IAI3C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IA0CvC;;;OAGG;IACH,IAAI,CACH,KAAK,EAAE,MAAM,EACb,KAAK,UAAQ,GACX;QACF,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;KACjB;IA2ED;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU;IAwBhE;;OAEG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B;;OAEG;IACH,iBAAiB,CAChB,IAAI,EAAE,MAAM,EACZ,KAAK,UAAQ,GACX;QACF,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;KACjB;IA0BD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;KACnC;IAqBD;;OAEG;IACH,MAAM,IAAI,kBAAkB;IAI5B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;CAGvC;AAKD,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/undo/tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EACX,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,MAAM,YAAY,CAAC;AA6CpB;;GAEG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,KAAK,CAAqB;gBAEtB,UAAU,SAAsB;IAQ5C;;;OAGG;IACH,YAAY,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GAChB,MAAM;IA8CT;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqBtC;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,UAAU,EAAE;IAiBhB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE;IAI3C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IA0CvC;;;OAGG;IACH,IAAI,CACH,KAAK,EAAE,MAAM,EACb,KAAK,UAAQ,GACX;QACF,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;KACjB;IA2ED;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU;IAwBhE;;OAEG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B;;OAEG;IACH,iBAAiB,CAChB,IAAI,EAAE,MAAM,EACZ,KAAK,UAAQ,GACX;QACF,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;KACjB;IA0BD;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAYvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;KACnC;IAqBD;;OAEG;IACH,MAAM,IAAI,kBAAkB;IAI5B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;CAGvC;AAKD,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/undo/tracker.js

@@ -309,6 +309,19 @@ export class ChangeTracker {
         }
         return this.undo(changesToUndo, force);
     }
+    /**
+     * Delete a checkpoint by name.
+     * @returns true if a checkpoint was removed, false if none matched.
+     */
+    deleteCheckpoint(name) {
+        const before = this.state.checkpoints.length;
+        this.state.checkpoints = this.state.checkpoints.filter((cp) => cp.name !== name);
+        const removed = this.state.checkpoints.length < before;
+        if (removed) {
+            logger.info("Checkpoint deleted", { name });
+        }
+        return removed;
+    }
     /**
      * Clear all tracked changes.
      */

package/dist/undo/tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../src/undo/tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AASrE,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAE5C,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,SAAS,WAAW,CAAC,MAAkB;IACtC,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,eAAe,CAAC,UAAsB;IAC9C,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,KAAyB;IAC5C,OAAO;QACN,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QACvC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC;QACnD,UAAU,EAAE,KAAK,CAAC,UAAU;KAC5B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB;IACxB,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,QAAgB;IACrC,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9B,QAAQ,CAAC,yBAAyB,EAAE;YACnC,GAAG,EAAE,GAAG;YACR,KAAK,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IAGzB,YAAY,UAAU,GAAG,mBAAmB;QAC3C,IAAI,CAAC,KAAK,GAAG;YACZ,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,EAAE;YACf,UAAU;SACV,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,YAAY,CACX,IAAY,EACZ,IAAgB,EAChB,QAAgB,EAChB,UAAkB,EAClB,SAAkB;QAElB,qCAAqC;QACrC,IAAI,MAAM,GAAkB,IAAI,CAAC;QACjC,IAAI,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACJ,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE;oBACpD,IAAI;oBACJ,KAAK,EAAE,sBAAsB,CAC5B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACtD;iBACD,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,MAAM,MAAM,GAAe;YAC1B,EAAE,EAAE,gBAAgB,EAAE;YACtB,IAAI;YACJ,IAAI;YACJ,MAAM;YACN,KAAK,EAAE,IAAI,EAAE,+BAA+B;YAC5C,QAAQ;YACR,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC;YAChC,SAAS;SACT,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhC,iCAAiC;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;YAC/B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI;YACJ,IAAI;YACJ,QAAQ;SACR,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,EAAE,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,QAAgB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/D,OAAO;QACR,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC;gBACJ,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;oBAC/C,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,KAAK,EAAE,sBAAsB,CAC5B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACtD;iBACD,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAIV;QACA,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAEjC,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YACvB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC;YACrC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;YACnB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAa;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAC7C,MAAM,SAAS,GAA6B,EAAE,CAAC;QAE/C,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACpC,gDAAgD;YAChD,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACJ,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;oBAC1D,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,cAAc,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;wBAC9D,SAAS,CAAC,IAAI,CAAC;4BACd,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,MAAM,EAAE,iDAAiD;yBACzD,CAAC,CAAC;wBACH,SAAS;oBACV,CAAC;gBACF,CAAC;gBAAC,MAAM,CAAC;oBACR,gCAAgC;gBACjC,CAAC;YACF,CAAC;YAED,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;gBACrB,KAAK,QAAQ;oBACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;oBACvD,MAAM;gBACP,KAAK,QAAQ;oBACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;oBACxD,MAAM;gBACP,KAAK,QAAQ;oBACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;oBACzD,MAAM;YACR,CAAC;QACF,CAAC;QAED,OAAO;YACN,OAAO,EAAE,aAAa;YACtB,QAAQ;YACR,SAAS;SACT,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,CACH,KAAa,EACb,KAAK,GAAG,KAAK;QAMb,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5C,OAAO;gBACN,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;gBACjC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;aAC9D,CAAC;QACH,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAE3D,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACpC,IAAI,CAAC;gBACJ,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;oBACrB,KAAK,QAAQ;wBACZ,0BAA0B;wBAC1B,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;4BAC7B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;4BACxB,MAAM,EAAE,CAAC;wBACV,CAAC;6BAAM,CAAC;4BACP,OAAO,EAAE,CAAC;wBACX,CAAC;wBACD,MAAM;oBAEP,KAAK,QAAQ;wBACZ,2BAA2B;wBAC3B,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;4BAC5B,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;gCAC/C,QAAQ,EAAE,OAAO;6BACjB,CAAC,CAAC;4BACH,MAAM,EAAE,CAAC;wBACV,CAAC;6BAAM,CAAC;4BACP,OAAO,EAAE,CAAC;4BACV,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,gCAAgC,CAAC,CAAC;wBAC7D,CAAC;wBACD,MAAM;oBAEP,KAAK,QAAQ;wBACZ,4BAA4B;wBAC5B,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;4BAC5B,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;4BACrD,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;gCAC/C,QAAQ,EAAE,OAAO;6BACjB,CAAC,CAAC;4BACH,MAAM,EAAE,CAAC;wBACV,CAAC;6BAAM,CAAC;4BACP,OAAO,EAAE,CAAC;4BACV,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,yBAAyB,CAAC,CAAC;wBACtD,CAAC;wBACD,MAAM;gBACR,CAAC;gBAED,kCAAkC;gBAClC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;gBACpE,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;oBAChB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACnC,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CACV,GAAG,MAAM,CAAC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3E,CAAC;gBACF,OAAO,EAAE,CAAC;YACX,CAAC;QACF,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAEzE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,IAAY,EAAE,WAAoB;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrE,MAAM,UAAU,GAAe;YAC9B,IAAI;YACJ,WAAW;YACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE;YAC9B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM;SACtC,CAAC;QAEF,4CAA4C;QAC5C,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CACrD,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CACxB,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAExC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;YACjC,IAAI;YACJ,WAAW,EAAE,UAAU,CAAC,WAAW;SACnC,CAAC,CAAC;QAEH,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,cAAc;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,iBAAiB,CAChB,IAAY,EACZ,KAAK,GAAG,KAAK;QAMb,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,OAAO;gBACN,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,CAAC;gBACV,MAAM,EAAE,CAAC,yBAAyB,IAAI,EAAE,CAAC;aACzC,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,QAAQ,CACnC,CAAC;QACF,MAAM,aAAa,GAClB,aAAa,KAAK,CAAC,CAAC;YACnB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM;YAC3B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,aAAa,GAAG,CAAC,CAAC;QAElD,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC9C,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,QAAQ;QAMP,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,MAAM,MAAM,GAA+B;YAC1C,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;SACT,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,CAAC;QAED,OAAO;YACN,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM;YACvC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM;YAC1C,MAAM;YACN,MAAM;SACN,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACL,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAyB;QAC/B,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACD;AAED,yCAAyC;AACzC,IAAI,aAAa,GAAyB,IAAI,CAAC;AAE/C,MAAM,UAAU,gBAAgB;IAC/B,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,aAAa,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,kBAAkB;IACjC,aAAa,GAAG,IAAI,CAAC;AACtB,CAAC","sourcesContent":["/**\n * File change tracker for undo/rollback functionality.\n *\n * Tracks file modifications made by tools during a session,\n * enabling granular undo operations beyond git.\n */\n\nimport { execSync } from \"node:child_process\";\nimport { existsSync, mkdirSync, readFileSync, unlinkSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { writeTextFileAtomic } from \"../utils/fs.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { sanitizeWithStaticMask } from \"../utils/secret-redactor.js\";\nimport type {\n\tChangeTrackerState,\n\tChangeType,\n\tCheckpoint,\n\tFileChange,\n\tUndoPreview,\n} from \"./types.js\";\n\nconst logger = createLogger(\"undo:tracker\");\n\nconst DEFAULT_MAX_CHANGES = 100;\n\nfunction cloneChange(change: FileChange): FileChange {\n\treturn { ...change };\n}\n\nfunction cloneCheckpoint(checkpoint: Checkpoint): Checkpoint {\n\treturn { ...checkpoint };\n}\n\nfunction cloneState(state: ChangeTrackerState): ChangeTrackerState {\n\treturn {\n\t\tchanges: state.changes.map(cloneChange),\n\t\tcheckpoints: state.checkpoints.map(cloneCheckpoint),\n\t\tmaxChanges: state.maxChanges,\n\t};\n}\n\n/**\n * Generates a unique change ID.\n */\nfunction generateChangeId(): string {\n\treturn `chg_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;\n}\n\n/**\n * Check if a path is inside a git repository.\n */\nfunction isGitTracked(filePath: string): boolean {\n\ttry {\n\t\tconst dir = dirname(filePath);\n\t\texecSync(\"git rev-parse --git-dir\", {\n\t\t\tcwd: dir,\n\t\t\tstdio: \"ignore\",\n\t\t});\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * File change tracker for session-based undo.\n */\nexport class ChangeTracker {\n\tprivate state: ChangeTrackerState;\n\n\tconstructor(maxChanges = DEFAULT_MAX_CHANGES) {\n\t\tthis.state = {\n\t\t\tchanges: [],\n\t\t\tcheckpoints: [],\n\t\t\tmaxChanges,\n\t\t};\n\t}\n\n\t/**\n\t * Record a file change before it happens.\n\t * Call this BEFORE writing/modifying/deleting a file.\n\t */\n\trecordChange(\n\t\tpath: string,\n\t\ttype: ChangeType,\n\t\ttoolName: string,\n\t\ttoolCallId: string,\n\t\tmessageId?: string,\n\t): string {\n\t\t// Read current content before change\n\t\tlet before: string | null = null;\n\t\tif (type !== \"create\" && existsSync(path)) {\n\t\t\ttry {\n\t\t\t\tbefore = readFileSync(path, \"utf-8\");\n\t\t\t} catch (error) {\n\t\t\t\tlogger.warn(\"Failed to read file for undo tracking\", {\n\t\t\t\t\tpath,\n\t\t\t\t\terror: sanitizeWithStaticMask(\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\t),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\tconst change: FileChange = {\n\t\t\tid: generateChangeId(),\n\t\t\ttype,\n\t\t\tpath,\n\t\t\tbefore,\n\t\t\tafter: null, // Will be set after the change\n\t\t\ttoolName,\n\t\t\ttoolCallId,\n\t\t\ttimestamp: Date.now(),\n\t\t\tisGitTracked: isGitTracked(path),\n\t\t\tmessageId,\n\t\t};\n\n\t\tthis.state.changes.push(change);\n\n\t\t// Trim old changes if over limit\n\t\twhile (this.state.changes.length > this.state.maxChanges) {\n\t\t\tthis.state.changes.shift();\n\t\t}\n\n\t\tlogger.debug(\"Recorded change\", {\n\t\t\tid: change.id,\n\t\t\ttype,\n\t\t\tpath,\n\t\t\ttoolName,\n\t\t});\n\n\t\treturn change.id;\n\t}\n\n\t/**\n\t * Finalize a change after it completes.\n\t * Call this AFTER writing/modifying a file to capture the new content.\n\t */\n\tfinalizeChange(changeId: string): void {\n\t\tconst change = this.state.changes.find((c) => c.id === changeId);\n\t\tif (!change) {\n\t\t\tlogger.warn(\"Change not found for finalization\", { changeId });\n\t\t\treturn;\n\t\t}\n\n\t\tif (change.type !== \"delete\" && existsSync(change.path)) {\n\t\t\ttry {\n\t\t\t\tchange.after = readFileSync(change.path, \"utf-8\");\n\t\t\t} catch (error) {\n\t\t\t\tlogger.warn(\"Failed to read file after change\", {\n\t\t\t\t\tpath: change.path,\n\t\t\t\t\terror: sanitizeWithStaticMask(\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\t),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Get all changes, optionally filtered.\n\t */\n\tgetChanges(options?: {\n\t\ttoolName?: string;\n\t\tsinceTimestamp?: number;\n\t\tpath?: string;\n\t}): FileChange[] {\n\t\tlet changes = this.state.changes;\n\n\t\tif (options?.toolName) {\n\t\t\tchanges = changes.filter((c) => c.toolName === options.toolName);\n\t\t}\n\t\tif (options?.sinceTimestamp) {\n\t\t\tconst since = options.sinceTimestamp;\n\t\t\tchanges = changes.filter((c) => c.timestamp >= since);\n\t\t}\n\t\tif (options?.path) {\n\t\t\tchanges = changes.filter((c) => c.path === options.path);\n\t\t}\n\n\t\treturn changes.map(cloneChange);\n\t}\n\n\t/**\n\t * Get the last N changes.\n\t */\n\tgetLastChanges(count: number): FileChange[] {\n\t\treturn this.state.changes.slice(-count).map(cloneChange);\n\t}\n\n\t/**\n\t * Preview what would be undone.\n\t */\n\tpreviewUndo(count: number): UndoPreview {\n\t\tconst changesToUndo = this.getLastChanges(count).reverse();\n\t\tconst restores: UndoPreview[\"restores\"] = [];\n\t\tconst conflicts: UndoPreview[\"conflicts\"] = [];\n\n\t\tfor (const change of changesToUndo) {\n\t\t\t// Check for conflicts (file changed externally)\n\t\t\tif (existsSync(change.path)) {\n\t\t\t\ttry {\n\t\t\t\t\tconst currentContent = readFileSync(change.path, \"utf-8\");\n\t\t\t\t\tif (change.after !== null && currentContent !== change.after) {\n\t\t\t\t\t\tconflicts.push({\n\t\t\t\t\t\t\tpath: change.path,\n\t\t\t\t\t\t\treason: \"File has been modified since the tracked change\",\n\t\t\t\t\t\t});\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// File exists but can't be read\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tswitch (change.type) {\n\t\t\t\tcase \"create\":\n\t\t\t\t\trestores.push({ path: change.path, action: \"delete\" });\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"modify\":\n\t\t\t\t\trestores.push({ path: change.path, action: \"restore\" });\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"delete\":\n\t\t\t\t\trestores.push({ path: change.path, action: \"recreate\" });\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\tchanges: changesToUndo,\n\t\t\trestores,\n\t\t\tconflicts,\n\t\t};\n\t}\n\n\t/**\n\t * Undo the last N changes.\n\t * Returns the number of changes successfully undone.\n\t */\n\tundo(\n\t\tcount: number,\n\t\tforce = false,\n\t): {\n\t\tundone: number;\n\t\tskipped: number;\n\t\terrors: string[];\n\t} {\n\t\tconst preview = this.previewUndo(count);\n\t\tconst errors: string[] = [];\n\t\tlet undone = 0;\n\t\tlet skipped = 0;\n\n\t\tif (preview.conflicts.length > 0 && !force) {\n\t\t\treturn {\n\t\t\t\tundone: 0,\n\t\t\t\tskipped: preview.conflicts.length,\n\t\t\t\terrors: preview.conflicts.map((c) => `${c.path}: ${c.reason}`),\n\t\t\t};\n\t\t}\n\n\t\tconst changesToUndo = this.getLastChanges(count).reverse();\n\n\t\tfor (const change of changesToUndo) {\n\t\t\ttry {\n\t\t\t\tswitch (change.type) {\n\t\t\t\t\tcase \"create\":\n\t\t\t\t\t\t// Delete the created file\n\t\t\t\t\t\tif (existsSync(change.path)) {\n\t\t\t\t\t\t\tunlinkSync(change.path);\n\t\t\t\t\t\t\tundone++;\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tskipped++;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\n\t\t\t\t\tcase \"modify\":\n\t\t\t\t\t\t// Restore previous content\n\t\t\t\t\t\tif (change.before !== null) {\n\t\t\t\t\t\t\twriteTextFileAtomic(change.path, change.before, {\n\t\t\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tundone++;\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tskipped++;\n\t\t\t\t\t\t\terrors.push(`${change.path}: No previous content recorded`);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\n\t\t\t\t\tcase \"delete\":\n\t\t\t\t\t\t// Recreate the deleted file\n\t\t\t\t\t\tif (change.before !== null) {\n\t\t\t\t\t\t\tmkdirSync(dirname(change.path), { recursive: true });\n\t\t\t\t\t\t\twriteTextFileAtomic(change.path, change.before, {\n\t\t\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tundone++;\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tskipped++;\n\t\t\t\t\t\t\terrors.push(`${change.path}: No content to restore`);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\t// Remove the change from tracking\n\t\t\t\tconst idx = this.state.changes.findIndex((c) => c.id === change.id);\n\t\t\t\tif (idx !== -1) {\n\t\t\t\t\tthis.state.changes.splice(idx, 1);\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\terrors.push(\n\t\t\t\t\t`${change.path}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t);\n\t\t\t\tskipped++;\n\t\t\t}\n\t\t}\n\n\t\tlogger.info(\"Undo complete\", { undone, skipped, errors: errors.length });\n\n\t\treturn { undone, skipped, errors };\n\t}\n\n\t/**\n\t * Create a named checkpoint.\n\t */\n\tcreateCheckpoint(name: string, description?: string): Checkpoint {\n\t\tconst lastChange = this.state.changes[this.state.changes.length - 1];\n\t\tconst checkpoint: Checkpoint = {\n\t\t\tname,\n\t\t\tdescription,\n\t\t\ttimestamp: Date.now(),\n\t\t\tchangeId: lastChange?.id ?? \"\",\n\t\t\tchangeCount: this.state.changes.length,\n\t\t};\n\n\t\t// Remove existing checkpoint with same name\n\t\tthis.state.checkpoints = this.state.checkpoints.filter(\n\t\t\t(cp) => cp.name !== name,\n\t\t);\n\t\tthis.state.checkpoints.push(checkpoint);\n\n\t\tlogger.info(\"Checkpoint created\", {\n\t\t\tname,\n\t\t\tchangeCount: checkpoint.changeCount,\n\t\t});\n\n\t\treturn cloneCheckpoint(checkpoint);\n\t}\n\n\t/**\n\t * Get all checkpoints.\n\t */\n\tgetCheckpoints(): Checkpoint[] {\n\t\treturn this.state.checkpoints.map(cloneCheckpoint);\n\t}\n\n\t/**\n\t * Restore to a checkpoint (undo all changes after it).\n\t */\n\trestoreCheckpoint(\n\t\tname: string,\n\t\tforce = false,\n\t): {\n\t\tundone: number;\n\t\tskipped: number;\n\t\terrors: string[];\n\t} {\n\t\tconst checkpoint = this.state.checkpoints.find((cp) => cp.name === name);\n\t\tif (!checkpoint) {\n\t\t\treturn {\n\t\t\t\tundone: 0,\n\t\t\t\tskipped: 0,\n\t\t\t\terrors: [`Checkpoint not found: ${name}`],\n\t\t\t};\n\t\t}\n\n\t\t// Find how many changes to undo\n\t\tconst checkpointIdx = this.state.changes.findIndex(\n\t\t\t(c) => c.id === checkpoint.changeId,\n\t\t);\n\t\tconst changesToUndo =\n\t\t\tcheckpointIdx === -1\n\t\t\t\t? this.state.changes.length\n\t\t\t\t: this.state.changes.length - checkpointIdx - 1;\n\n\t\tif (changesToUndo <= 0) {\n\t\t\treturn { undone: 0, skipped: 0, errors: [] };\n\t\t}\n\n\t\treturn this.undo(changesToUndo, force);\n\t}\n\n\t/**\n\t * Clear all tracked changes.\n\t */\n\tclear(): void {\n\t\tthis.state.changes = [];\n\t\tthis.state.checkpoints = [];\n\t\tlogger.info(\"Change tracker cleared\");\n\t}\n\n\t/**\n\t * Get tracker statistics.\n\t */\n\tgetStats(): {\n\t\ttotalChanges: number;\n\t\tcheckpoints: number;\n\t\tbyTool: Record<string, number>;\n\t\tbyType: Record<ChangeType, number>;\n\t} {\n\t\tconst byTool: Record<string, number> = {};\n\t\tconst byType: Record<ChangeType, number> = {\n\t\t\tcreate: 0,\n\t\t\tmodify: 0,\n\t\t\tdelete: 0,\n\t\t};\n\n\t\tfor (const change of this.state.changes) {\n\t\t\tbyTool[change.toolName] = (byTool[change.toolName] ?? 0) + 1;\n\t\t\tbyType[change.type]++;\n\t\t}\n\n\t\treturn {\n\t\t\ttotalChanges: this.state.changes.length,\n\t\t\tcheckpoints: this.state.checkpoints.length,\n\t\t\tbyTool,\n\t\t\tbyType,\n\t\t};\n\t}\n\n\t/**\n\t * Export state for persistence.\n\t */\n\texport(): ChangeTrackerState {\n\t\treturn cloneState(this.state);\n\t}\n\n\t/**\n\t * Import state from persistence.\n\t */\n\timport(state: ChangeTrackerState): void {\n\t\tthis.state = cloneState(state);\n\t}\n}\n\n// Singleton instance for global tracking\nlet globalTracker: ChangeTracker | null = null;\n\nexport function getChangeTracker(): ChangeTracker {\n\tif (!globalTracker) {\n\t\tglobalTracker = new ChangeTracker();\n\t}\n\treturn globalTracker;\n}\n\nexport function resetChangeTracker(): void {\n\tglobalTracker = null;\n}\n"]}
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../src/undo/tracker.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * File change tracker for undo/rollback functionality.\n *\n * Tracks file modifications made by tools during a session,\n * enabling granular undo operations beyond git.\n */\n\nimport { execSync } from \"node:child_process\";\nimport { existsSync, mkdirSync, readFileSync, unlinkSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { writeTextFileAtomic } from \"../utils/fs.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { sanitizeWithStaticMask } from \"../utils/secret-redactor.js\";\nimport type {\n\tChangeTrackerState,\n\tChangeType,\n\tCheckpoint,\n\tFileChange,\n\tUndoPreview,\n} from \"./types.js\";\n\nconst logger = createLogger(\"undo:tracker\");\n\nconst DEFAULT_MAX_CHANGES = 100;\n\nfunction cloneChange(change: FileChange): FileChange {\n\treturn { ...change };\n}\n\nfunction cloneCheckpoint(checkpoint: Checkpoint): Checkpoint {\n\treturn { ...checkpoint };\n}\n\nfunction cloneState(state: ChangeTrackerState): ChangeTrackerState {\n\treturn {\n\t\tchanges: state.changes.map(cloneChange),\n\t\tcheckpoints: state.checkpoints.map(cloneCheckpoint),\n\t\tmaxChanges: state.maxChanges,\n\t};\n}\n\n/**\n * Generates a unique change ID.\n */\nfunction generateChangeId(): string {\n\treturn `chg_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;\n}\n\n/**\n * Check if a path is inside a git repository.\n */\nfunction isGitTracked(filePath: string): boolean {\n\ttry {\n\t\tconst dir = dirname(filePath);\n\t\texecSync(\"git rev-parse --git-dir\", {\n\t\t\tcwd: dir,\n\t\t\tstdio: \"ignore\",\n\t\t});\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * File change tracker for session-based undo.\n */\nexport class ChangeTracker {\n\tprivate state: ChangeTrackerState;\n\n\tconstructor(maxChanges = DEFAULT_MAX_CHANGES) {\n\t\tthis.state = {\n\t\t\tchanges: [],\n\t\t\tcheckpoints: [],\n\t\t\tmaxChanges,\n\t\t};\n\t}\n\n\t/**\n\t * Record a file change before it happens.\n\t * Call this BEFORE writing/modifying/deleting a file.\n\t */\n\trecordChange(\n\t\tpath: string,\n\t\ttype: ChangeType,\n\t\ttoolName: string,\n\t\ttoolCallId: string,\n\t\tmessageId?: string,\n\t): string {\n\t\t// Read current content before change\n\t\tlet before: string | null = null;\n\t\tif (type !== \"create\" && existsSync(path)) {\n\t\t\ttry {\n\t\t\t\tbefore = readFileSync(path, \"utf-8\");\n\t\t\t} catch (error) {\n\t\t\t\tlogger.warn(\"Failed to read file for undo tracking\", {\n\t\t\t\t\tpath,\n\t\t\t\t\terror: sanitizeWithStaticMask(\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\t),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\tconst change: FileChange = {\n\t\t\tid: generateChangeId(),\n\t\t\ttype,\n\t\t\tpath,\n\t\t\tbefore,\n\t\t\tafter: null, // Will be set after the change\n\t\t\ttoolName,\n\t\t\ttoolCallId,\n\t\t\ttimestamp: Date.now(),\n\t\t\tisGitTracked: isGitTracked(path),\n\t\t\tmessageId,\n\t\t};\n\n\t\tthis.state.changes.push(change);\n\n\t\t// Trim old changes if over limit\n\t\twhile (this.state.changes.length > this.state.maxChanges) {\n\t\t\tthis.state.changes.shift();\n\t\t}\n\n\t\tlogger.debug(\"Recorded change\", {\n\t\t\tid: change.id,\n\t\t\ttype,\n\t\t\tpath,\n\t\t\ttoolName,\n\t\t});\n\n\t\treturn change.id;\n\t}\n\n\t/**\n\t * Finalize a change after it completes.\n\t * Call this AFTER writing/modifying a file to capture the new content.\n\t */\n\tfinalizeChange(changeId: string): void {\n\t\tconst change = this.state.changes.find((c) => c.id === changeId);\n\t\tif (!change) {\n\t\t\tlogger.warn(\"Change not found for finalization\", { changeId });\n\t\t\treturn;\n\t\t}\n\n\t\tif (change.type !== \"delete\" && existsSync(change.path)) {\n\t\t\ttry {\n\t\t\t\tchange.after = readFileSync(change.path, \"utf-8\");\n\t\t\t} catch (error) {\n\t\t\t\tlogger.warn(\"Failed to read file after change\", {\n\t\t\t\t\tpath: change.path,\n\t\t\t\t\terror: sanitizeWithStaticMask(\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\t),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Get all changes, optionally filtered.\n\t */\n\tgetChanges(options?: {\n\t\ttoolName?: string;\n\t\tsinceTimestamp?: number;\n\t\tpath?: string;\n\t}): FileChange[] {\n\t\tlet changes = this.state.changes;\n\n\t\tif (options?.toolName) {\n\t\t\tchanges = changes.filter((c) => c.toolName === options.toolName);\n\t\t}\n\t\tif (options?.sinceTimestamp) {\n\t\t\tconst since = options.sinceTimestamp;\n\t\t\tchanges = changes.filter((c) => c.timestamp >= since);\n\t\t}\n\t\tif (options?.path) {\n\t\t\tchanges = changes.filter((c) => c.path === options.path);\n\t\t}\n\n\t\treturn changes.map(cloneChange);\n\t}\n\n\t/**\n\t * Get the last N changes.\n\t */\n\tgetLastChanges(count: number): FileChange[] {\n\t\treturn this.state.changes.slice(-count).map(cloneChange);\n\t}\n\n\t/**\n\t * Preview what would be undone.\n\t */\n\tpreviewUndo(count: number): UndoPreview {\n\t\tconst changesToUndo = this.getLastChanges(count).reverse();\n\t\tconst restores: UndoPreview[\"restores\"] = [];\n\t\tconst conflicts: UndoPreview[\"conflicts\"] = [];\n\n\t\tfor (const change of changesToUndo) {\n\t\t\t// Check for conflicts (file changed externally)\n\t\t\tif (existsSync(change.path)) {\n\t\t\t\ttry {\n\t\t\t\t\tconst currentContent = readFileSync(change.path, \"utf-8\");\n\t\t\t\t\tif (change.after !== null && currentContent !== change.after) {\n\t\t\t\t\t\tconflicts.push({\n\t\t\t\t\t\t\tpath: change.path,\n\t\t\t\t\t\t\treason: \"File has been modified since the tracked change\",\n\t\t\t\t\t\t});\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// File exists but can't be read\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tswitch (change.type) {\n\t\t\t\tcase \"create\":\n\t\t\t\t\trestores.push({ path: change.path, action: \"delete\" });\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"modify\":\n\t\t\t\t\trestores.push({ path: change.path, action: \"restore\" });\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"delete\":\n\t\t\t\t\trestores.push({ path: change.path, action: \"recreate\" });\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\tchanges: changesToUndo,\n\t\t\trestores,\n\t\t\tconflicts,\n\t\t};\n\t}\n\n\t/**\n\t * Undo the last N changes.\n\t * Returns the number of changes successfully undone.\n\t */\n\tundo(\n\t\tcount: number,\n\t\tforce = false,\n\t): {\n\t\tundone: number;\n\t\tskipped: number;\n\t\terrors: string[];\n\t} {\n\t\tconst preview = this.previewUndo(count);\n\t\tconst errors: string[] = [];\n\t\tlet undone = 0;\n\t\tlet skipped = 0;\n\n\t\tif (preview.conflicts.length > 0 && !force) {\n\t\t\treturn {\n\t\t\t\tundone: 0,\n\t\t\t\tskipped: preview.conflicts.length,\n\t\t\t\terrors: preview.conflicts.map((c) => `${c.path}: ${c.reason}`),\n\t\t\t};\n\t\t}\n\n\t\tconst changesToUndo = this.getLastChanges(count).reverse();\n\n\t\tfor (const change of changesToUndo) {\n\t\t\ttry {\n\t\t\t\tswitch (change.type) {\n\t\t\t\t\tcase \"create\":\n\t\t\t\t\t\t// Delete the created file\n\t\t\t\t\t\tif (existsSync(change.path)) {\n\t\t\t\t\t\t\tunlinkSync(change.path);\n\t\t\t\t\t\t\tundone++;\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tskipped++;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\n\t\t\t\t\tcase \"modify\":\n\t\t\t\t\t\t// Restore previous content\n\t\t\t\t\t\tif (change.before !== null) {\n\t\t\t\t\t\t\twriteTextFileAtomic(change.path, change.before, {\n\t\t\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tundone++;\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tskipped++;\n\t\t\t\t\t\t\terrors.push(`${change.path}: No previous content recorded`);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\n\t\t\t\t\tcase \"delete\":\n\t\t\t\t\t\t// Recreate the deleted file\n\t\t\t\t\t\tif (change.before !== null) {\n\t\t\t\t\t\t\tmkdirSync(dirname(change.path), { recursive: true });\n\t\t\t\t\t\t\twriteTextFileAtomic(change.path, change.before, {\n\t\t\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tundone++;\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tskipped++;\n\t\t\t\t\t\t\terrors.push(`${change.path}: No content to restore`);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\t// Remove the change from tracking\n\t\t\t\tconst idx = this.state.changes.findIndex((c) => c.id === change.id);\n\t\t\t\tif (idx !== -1) {\n\t\t\t\t\tthis.state.changes.splice(idx, 1);\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\terrors.push(\n\t\t\t\t\t`${change.path}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t);\n\t\t\t\tskipped++;\n\t\t\t}\n\t\t}\n\n\t\tlogger.info(\"Undo complete\", { undone, skipped, errors: errors.length });\n\n\t\treturn { undone, skipped, errors };\n\t}\n\n\t/**\n\t * Create a named checkpoint.\n\t */\n\tcreateCheckpoint(name: string, description?: string): Checkpoint {\n\t\tconst lastChange = this.state.changes[this.state.changes.length - 1];\n\t\tconst checkpoint: Checkpoint = {\n\t\t\tname,\n\t\t\tdescription,\n\t\t\ttimestamp: Date.now(),\n\t\t\tchangeId: lastChange?.id ?? \"\",\n\t\t\tchangeCount: this.state.changes.length,\n\t\t};\n\n\t\t// Remove existing checkpoint with same name\n\t\tthis.state.checkpoints = this.state.checkpoints.filter(\n\t\t\t(cp) => cp.name !== name,\n\t\t);\n\t\tthis.state.checkpoints.push(checkpoint);\n\n\t\tlogger.info(\"Checkpoint created\", {\n\t\t\tname,\n\t\t\tchangeCount: checkpoint.changeCount,\n\t\t});\n\n\t\treturn cloneCheckpoint(checkpoint);\n\t}\n\n\t/**\n\t * Get all checkpoints.\n\t */\n\tgetCheckpoints(): Checkpoint[] {\n\t\treturn this.state.checkpoints.map(cloneCheckpoint);\n\t}\n\n\t/**\n\t * Restore to a checkpoint (undo all changes after it).\n\t */\n\trestoreCheckpoint(\n\t\tname: string,\n\t\tforce = false,\n\t): {\n\t\tundone: number;\n\t\tskipped: number;\n\t\terrors: string[];\n\t} {\n\t\tconst checkpoint = this.state.checkpoints.find((cp) => cp.name === name);\n\t\tif (!checkpoint) {\n\t\t\treturn {\n\t\t\t\tundone: 0,\n\t\t\t\tskipped: 0,\n\t\t\t\terrors: [`Checkpoint not found: ${name}`],\n\t\t\t};\n\t\t}\n\n\t\t// Find how many changes to undo\n\t\tconst checkpointIdx = this.state.changes.findIndex(\n\t\t\t(c) => c.id === checkpoint.changeId,\n\t\t);\n\t\tconst changesToUndo =\n\t\t\tcheckpointIdx === -1\n\t\t\t\t? this.state.changes.length\n\t\t\t\t: this.state.changes.length - checkpointIdx - 1;\n\n\t\tif (changesToUndo <= 0) {\n\t\t\treturn { undone: 0, skipped: 0, errors: [] };\n\t\t}\n\n\t\treturn this.undo(changesToUndo, force);\n\t}\n\n\t/**\n\t * Delete a checkpoint by name.\n\t * @returns true if a checkpoint was removed, false if none matched.\n\t */\n\tdeleteCheckpoint(name: string): boolean {\n\t\tconst before = this.state.checkpoints.length;\n\t\tthis.state.checkpoints = this.state.checkpoints.filter(\n\t\t\t(cp) => cp.name !== name,\n\t\t);\n\t\tconst removed = this.state.checkpoints.length < before;\n\t\tif (removed) {\n\t\t\tlogger.info(\"Checkpoint deleted\", { name });\n\t\t}\n\t\treturn removed;\n\t}\n\n\t/**\n\t * Clear all tracked changes.\n\t */\n\tclear(): void {\n\t\tthis.state.changes = [];\n\t\tthis.state.checkpoints = [];\n\t\tlogger.info(\"Change tracker cleared\");\n\t}\n\n\t/**\n\t * Get tracker statistics.\n\t */\n\tgetStats(): {\n\t\ttotalChanges: number;\n\t\tcheckpoints: number;\n\t\tbyTool: Record<string, number>;\n\t\tbyType: Record<ChangeType, number>;\n\t} {\n\t\tconst byTool: Record<string, number> = {};\n\t\tconst byType: Record<ChangeType, number> = {\n\t\t\tcreate: 0,\n\t\t\tmodify: 0,\n\t\t\tdelete: 0,\n\t\t};\n\n\t\tfor (const change of this.state.changes) {\n\t\t\tbyTool[change.toolName] = (byTool[change.toolName] ?? 0) + 1;\n\t\t\tbyType[change.type]++;\n\t\t}\n\n\t\treturn {\n\t\t\ttotalChanges: this.state.changes.length,\n\t\t\tcheckpoints: this.state.checkpoints.length,\n\t\t\tbyTool,\n\t\t\tbyType,\n\t\t};\n\t}\n\n\t/**\n\t * Export state for persistence.\n\t */\n\texport(): ChangeTrackerState {\n\t\treturn cloneState(this.state);\n\t}\n\n\t/**\n\t * Import state from persistence.\n\t */\n\timport(state: ChangeTrackerState): void {\n\t\tthis.state = cloneState(state);\n\t}\n}\n\n// Singleton instance for global tracking\nlet globalTracker: ChangeTracker | null = null;\n\nexport function getChangeTracker(): ChangeTracker {\n\tif (!globalTracker) {\n\t\tglobalTracker = new ChangeTracker();\n\t}\n\treturn globalTracker;\n}\n\nexport function resetChangeTracker(): void {\n\tglobalTracker = null;\n}\n"]}

package/dist/utils/fs.d.ts

@@ -63,7 +63,7 @@ export declare function readJsonFile<T = unknown>(path: string, options?: {
  * Returns the rotated path on success, `null` if the source file
  * didn't exist or the rotation failed.
  */
-export declare function rotateCorruptJsonFile(path: string): string | null;
+export declare function rotateCorruptJsonFile(path: string, expectedContent?: string): string | null;
 /**
  * Write JSON file with formatting and error handling
  */

package/dist/utils/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH,qBAAa,eAAgB,SAAQ,KAAK;aAGxB,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM;aACR,KAAK,CAAC,EAAE,KAAK;gBAHtC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,KAAK,YAAA;CAKvC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOhD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5D,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/D,IAAI,CA+BN;AAED,iBAAS,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,cAAc,CAO/D;AAED,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,GACzD,CAAC,CAmCH;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACtD,IAAI,CAiBN;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACtD,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAc5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/D,IAAI,CAkBN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACR,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACT,GACJ,IAAI,CAqCN"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH,qBAAa,eAAgB,SAAQ,KAAK;aAGxB,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM;aACR,KAAK,CAAC,EAAE,KAAK;gBAHtC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,KAAK,YAAA;CAKvC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOhD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5D,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/D,IAAI,CA+BN;AAED,iBAAS,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,cAAc,CAO/D;AAED,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,GACzD,CAAC,CA4CH;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,IAAI,CAyCf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACtD,IAAI,CAiBN;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACtD,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAc5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/D,IAAI,CAkBN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACR,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACT,GACJ,IAAI,CAqCN"}

package/dist/utils/fs.js

@@ -143,7 +143,16 @@ export function readJsonFile(path, options = {}) {
                     error: result.error.message,
                 });
                 if (rotateOnParseFail) {
-                    rotateCorruptJsonFile(path);
+                    const rotatedPath = rotateCorruptJsonFile(path, content);
+                    if (!rotatedPath) {
+                        const repairedContent = readTextFile(path, { fallback: "" });
+                        if (repairedContent !== "" && repairedContent !== content) {
+                            const repaired = safeJsonParse(repairedContent, path);
+                            if (repaired.success) {
+                                return repaired.data;
+                            }
+                        }
+                    }
                 }
                 return fallback;
             }
@@ -169,9 +178,27 @@ export function readJsonFile(path, options = {}) {
  * Returns the rotated path on success, `null` if the source file
  * didn't exist or the rotation failed.
  */
-export function rotateCorruptJsonFile(path) {
+export function rotateCorruptJsonFile(path, expectedContent) {
     if (!fileExists(path))
         return null;
+    if (expectedContent !== undefined) {
+        try {
+            const currentContent = readFileSync(path, "utf8");
+            if (currentContent !== expectedContent) {
+                logger.warn("Skipped corrupt JSON rotation; file changed after read", {
+                    path,
+                });
+                return null;
+            }
+        }
+        catch (error) {
+            logger.warn("Failed to re-read corrupt JSON before rotation", {
+                path,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
     const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
     // Append per-call randomness so two processes parsing the same
     // corrupt file in the same millisecond produce different rotated

package/dist/utils/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Centralized file system utilities with consistent error handling.\n * Replaces scattered readFileSync/writeFileSync/existsSync calls.\n */\n\nimport { randomBytes } from \"node:crypto\";\nimport {\n\tconstants,\n\tcloseSync,\n\texistsSync,\n\tfsyncSync,\n\tmkdirSync,\n\topenSync,\n\treadFileSync,\n\trenameSync,\n\tstatSync,\n\tunlinkSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { access } from \"node:fs/promises\";\nimport { basename, dirname, join } from \"node:path\";\nimport { safeJsonParse, safeJsonStringify } from \"./json.js\";\nimport { createLogger } from \"./logger.js\";\n\nconst logger = createLogger(\"fs-utils\");\n\nexport class FileSystemError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly path: string,\n\t\tpublic readonly operation: string,\n\t\tpublic override readonly cause?: Error,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"FileSystemError\";\n\t}\n}\n\n/**\n * Safely check if a file exists\n */\nexport function fileExists(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path);\n\t} catch (error) {\n\t\tlogger.debug(\"File existence check failed\", { path, error });\n\t\treturn false;\n\t}\n}\n\n/**\n * Safely check if a file is readable\n */\nexport async function isReadable(path: string): Promise<boolean> {\n\ttry {\n\t\tawait access(path, constants.R_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Safely check if a file is writable\n */\nexport async function isWritable(path: string): Promise<boolean> {\n\ttry {\n\t\tawait access(path, constants.W_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Read text file with error handling\n */\nexport function readTextFile(\n\tpath: string,\n\toptions: { encoding?: BufferEncoding; fallback?: string } = {},\n): string {\n\tconst { encoding = \"utf-8\", fallback } = options;\n\n\ttry {\n\t\tif (!fileExists(path)) {\n\t\t\tif (fallback !== undefined) {\n\t\t\t\treturn fallback;\n\t\t\t}\n\t\t\tthrow new FileSystemError(`File not found: ${path}`, path, \"read\");\n\t\t}\n\n\t\treturn readFileSync(path, encoding);\n\t} catch (error) {\n\t\tif (error instanceof FileSystemError) throw error;\n\n\t\tconst fsError = new FileSystemError(\n\t\t\t`Failed to read file: ${path}`,\n\t\t\tpath,\n\t\t\t\"read\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\n\t\tif (fallback !== undefined) {\n\t\t\tlogger.warn(\"File read failed, using fallback\", { path, error });\n\t\t\treturn fallback;\n\t\t}\n\n\t\tlogger.error(\n\t\t\t\"File read failed\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t\t{ path },\n\t\t);\n\t\tthrow fsError;\n\t}\n}\n\n/**\n * Write text file with error handling and automatic directory creation\n */\nexport function writeTextFile(\n\tpath: string,\n\tcontent: string,\n\toptions: { encoding?: BufferEncoding; createDirs?: boolean } = {},\n): void {\n\tconst { encoding = \"utf-8\", createDirs = true } = options;\n\n\ttry {\n\t\tif (createDirs) {\n\t\t\tconst dir = dirname(path);\n\t\t\tif (!fileExists(dir)) {\n\t\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\t}\n\t\t}\n\n\t\twriteFileSync(path, content, encoding);\n\t\tlogger.debug(\"File written successfully\", { path, size: content.length });\n\t} catch (error) {\n\t\tconst fsError = new FileSystemError(\n\t\t\t`Failed to write file: ${path}`,\n\t\t\tpath,\n\t\t\t\"write\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t\tif (isErrno(error) && error.code === \"ENOENT\" && createDirs === false) {\n\t\t\tlogger.debug(\"File write failed\", { path, error });\n\t\t} else {\n\t\t\tlogger.error(\n\t\t\t\t\"File write failed\",\n\t\t\t\terror instanceof Error ? error : undefined,\n\t\t\t\t{ path },\n\t\t\t);\n\t\t}\n\t\tthrow fsError;\n\t}\n}\n\nfunction isErrno(error: unknown): error is NodeJS.ErrnoException {\n\treturn Boolean(\n\t\terror &&\n\t\t\ttypeof error === \"object\" &&\n\t\t\t\"code\" in error &&\n\t\t\ttypeof (error as NodeJS.ErrnoException).code === \"string\",\n\t);\n}\n\nexport { isErrno };\n\n/**\n * Read JSON file with parsing and error handling.\n *\n * When `rotateOnParseFail` is enabled, a file whose content fails to\n * parse as JSON is moved to a `<file>.corrupt.<iso-ts>` sibling\n * before the fallback is returned (#2631). This preserves forensic\n * evidence — instead of silently replacing user data with empty\n * state on the next write — and surfaces the bug in monitoring.\n *\n * The rotation does NOT fire on \"file not present\" (returns fallback\n * directly) or on \"file is empty string\" (also returns fallback);\n * it only fires when bytes exist but don't parse.\n */\nexport function readJsonFile<T = unknown>(\n\tpath: string,\n\toptions: { fallback?: T; rotateOnParseFail?: boolean } = {},\n): T {\n\tconst { fallback, rotateOnParseFail = false } = options;\n\n\ttry {\n\t\tconst content = readTextFile(path, {\n\t\t\tfallback: fallback !== undefined ? \"\" : undefined,\n\t\t});\n\n\t\tif (content === \"\" && fallback !== undefined) {\n\t\t\treturn fallback;\n\t\t}\n\n\t\tconst result = safeJsonParse<T>(content, path);\n\t\tif (!result.success) {\n\t\t\tif (fallback !== undefined) {\n\t\t\t\tlogger.warn(\"JSON parse failed, using fallback\", {\n\t\t\t\t\tpath,\n\t\t\t\t\terror: result.error.message,\n\t\t\t\t});\n\t\t\t\tif (rotateOnParseFail) {\n\t\t\t\t\trotateCorruptJsonFile(path);\n\t\t\t\t}\n\t\t\t\treturn fallback;\n\t\t\t}\n\t\t\tthrow result.error;\n\t\t}\n\n\t\treturn result.data;\n\t} catch (error) {\n\t\tif (fallback !== undefined) {\n\t\t\tlogger.warn(\"Failed to read JSON file, using fallback\", { path, error });\n\t\t\treturn fallback;\n\t\t}\n\t\tthrow error;\n\t}\n}\n\n/**\n * Rename a corrupt JSON state file to `<file>.corrupt.<iso-ts>` so\n * subsequent writes create a fresh valid file while the corrupted\n * bytes are preserved for forensics (#2631). Best-effort: failures\n * are logged and swallowed because rotation is a hygiene step, not\n * a load-bearing operation.\n *\n * Returns the rotated path on success, `null` if the source file\n * didn't exist or the rotation failed.\n */\nexport function rotateCorruptJsonFile(path: string): string | null {\n\tif (!fileExists(path)) return null;\n\tconst timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n\t// Append per-call randomness so two processes parsing the same\n\t// corrupt file in the same millisecond produce different rotated\n\t// names. `renameSync` overwrites the destination on POSIX, so\n\t// without the random suffix the second rename would clobber the\n\t// first's forensic evidence.\n\tconst nonce = randomBytes(4).toString(\"hex\");\n\tconst rotatedPath = `${path}.corrupt.${timestamp}.${nonce}`;\n\ttry {\n\t\trenameSync(path, rotatedPath);\n\t\tlogger.warn(\"Rotated corrupt JSON file aside; starting fresh\", {\n\t\t\tfrom: path,\n\t\t\tto: rotatedPath,\n\t\t});\n\t\treturn rotatedPath;\n\t} catch (error) {\n\t\tlogger.warn(\"Failed to rotate corrupt JSON file\", {\n\t\t\tpath,\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t});\n\t\treturn null;\n\t}\n}\n\n/**\n * Write JSON file with formatting and error handling\n */\nexport function writeJsonFile(\n\tpath: string,\n\tdata: unknown,\n\toptions: { pretty?: boolean; createDirs?: boolean } = {},\n): void {\n\tconst { pretty = true, createDirs = true } = options;\n\n\ttry {\n\t\tconst content = pretty\n\t\t\t? JSON.stringify(data, null, 2)\n\t\t\t: safeJsonStringify(data);\n\n\t\twriteTextFileAtomic(path, content, { createDirs });\n\t} catch (error) {\n\t\tthrow new FileSystemError(\n\t\t\t`Failed to write JSON file: ${path}`,\n\t\t\tpath,\n\t\t\t\"write-json\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\nexport function writeJsonFileAtomic(\n\tpath: string,\n\tdata: unknown,\n\toptions: { pretty?: boolean; createDirs?: boolean } = {},\n): void {\n\twriteJsonFile(path, data, options);\n}\n\n/**\n * Ensure a directory exists, creating it if necessary\n */\nexport function ensureDir(path: string): void {\n\ttry {\n\t\tif (!fileExists(path)) {\n\t\t\tmkdirSync(path, { recursive: true });\n\t\t\tlogger.debug(\"Directory created\", { path });\n\t\t}\n\t} catch (error) {\n\t\tthrow new FileSystemError(\n\t\t\t`Failed to create directory: ${path}`,\n\t\t\tpath,\n\t\t\t\"mkdir\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\n/**\n * Safely append to a file\n */\nexport function appendTextFile(\n\tpath: string,\n\tcontent: string,\n\toptions: { encoding?: BufferEncoding; createDirs?: boolean } = {},\n): void {\n\tconst { encoding = \"utf-8\", createDirs = true } = options;\n\n\ttry {\n\t\tif (createDirs) {\n\t\t\tensureDir(dirname(path));\n\t\t}\n\n\t\tconst existing = fileExists(path) ? readTextFile(path, { encoding }) : \"\";\n\t\twriteTextFile(path, existing + content, { encoding, createDirs: false });\n\t} catch (error) {\n\t\tthrow new FileSystemError(\n\t\t\t`Failed to append to file: ${path}`,\n\t\t\tpath,\n\t\t\t\"append\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\n/**\n * Atomic write - write to temp file then rename\n */\nexport function writeTextFileAtomic(\n\tpath: string,\n\tcontent: string,\n\toptions: {\n\t\tencoding?: BufferEncoding;\n\t\tcreateDirs?: boolean;\n\t\tfsync?: boolean;\n\t\tmode?: number;\n\t} = {},\n): void {\n\tconst { encoding = \"utf-8\", createDirs = true, fsync = true } = options;\n\tconst tempPath = join(\n\t\tdirname(path),\n\t\t`.${basename(path)}.tmp.${process.pid}.${Date.now()}.${randomBytes(6).toString(\"hex\")}`,\n\t);\n\n\ttry {\n\t\tif (createDirs) {\n\t\t\tensureDir(dirname(path));\n\t\t}\n\t\tconst mode = options.mode ?? existingFileMode(path) ?? 0o600;\n\t\twriteFileSync(tempPath, content, { encoding, flag: \"wx\", mode });\n\t\tif (fsync) {\n\t\t\tsyncFile(tempPath);\n\t\t}\n\t\t// Rename is atomic on most filesystems\n\t\trenameSync(tempPath, path);\n\t\tif (fsync) {\n\t\t\tsyncDirectory(dirname(path));\n\t\t}\n\t} catch (error) {\n\t\t// Clean up temp file if it exists\n\t\ttry {\n\t\t\tif (fileExists(tempPath)) {\n\t\t\t\tunlinkSync(tempPath);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Ignore cleanup errors\n\t\t}\n\t\tthrow new FileSystemError(\n\t\t\t`Failed to write file atomically: ${path}`,\n\t\t\tpath,\n\t\t\t\"write-atomic\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\nfunction existingFileMode(path: string): number | undefined {\n\ttry {\n\t\tif (!fileExists(path)) return undefined;\n\t\treturn statSync(path).mode & 0o777;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction syncFile(path: string): void {\n\tconst fd = openSync(path, \"r+\");\n\ttry {\n\t\tfsyncSync(fd);\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n}\n\nfunction syncDirectory(path: string): void {\n\tif (process.platform === \"win32\") return;\n\tlet fd: number | undefined;\n\ttry {\n\t\tfd = openSync(path, \"r\");\n\t\tfsyncSync(fd);\n\t} catch (error) {\n\t\tlogger.debug(\"Directory fsync failed\", { path, error });\n\t} finally {\n\t\tif (fd !== undefined) {\n\t\t\ttry {\n\t\t\t\tcloseSync(fd);\n\t\t\t} catch (error) {\n\t\t\t\tlogger.debug(\"Directory fd close failed\", { path, error });\n\t\t\t}\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Centralized file system utilities with consistent error handling.\n * Replaces scattered readFileSync/writeFileSync/existsSync calls.\n */\n\nimport { randomBytes } from \"node:crypto\";\nimport {\n\tconstants,\n\tcloseSync,\n\texistsSync,\n\tfsyncSync,\n\tmkdirSync,\n\topenSync,\n\treadFileSync,\n\trenameSync,\n\tstatSync,\n\tunlinkSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { access } from \"node:fs/promises\";\nimport { basename, dirname, join } from \"node:path\";\nimport { safeJsonParse, safeJsonStringify } from \"./json.js\";\nimport { createLogger } from \"./logger.js\";\n\nconst logger = createLogger(\"fs-utils\");\n\nexport class FileSystemError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly path: string,\n\t\tpublic readonly operation: string,\n\t\tpublic override readonly cause?: Error,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"FileSystemError\";\n\t}\n}\n\n/**\n * Safely check if a file exists\n */\nexport function fileExists(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path);\n\t} catch (error) {\n\t\tlogger.debug(\"File existence check failed\", { path, error });\n\t\treturn false;\n\t}\n}\n\n/**\n * Safely check if a file is readable\n */\nexport async function isReadable(path: string): Promise<boolean> {\n\ttry {\n\t\tawait access(path, constants.R_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Safely check if a file is writable\n */\nexport async function isWritable(path: string): Promise<boolean> {\n\ttry {\n\t\tawait access(path, constants.W_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Read text file with error handling\n */\nexport function readTextFile(\n\tpath: string,\n\toptions: { encoding?: BufferEncoding; fallback?: string } = {},\n): string {\n\tconst { encoding = \"utf-8\", fallback } = options;\n\n\ttry {\n\t\tif (!fileExists(path)) {\n\t\t\tif (fallback !== undefined) {\n\t\t\t\treturn fallback;\n\t\t\t}\n\t\t\tthrow new FileSystemError(`File not found: ${path}`, path, \"read\");\n\t\t}\n\n\t\treturn readFileSync(path, encoding);\n\t} catch (error) {\n\t\tif (error instanceof FileSystemError) throw error;\n\n\t\tconst fsError = new FileSystemError(\n\t\t\t`Failed to read file: ${path}`,\n\t\t\tpath,\n\t\t\t\"read\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\n\t\tif (fallback !== undefined) {\n\t\t\tlogger.warn(\"File read failed, using fallback\", { path, error });\n\t\t\treturn fallback;\n\t\t}\n\n\t\tlogger.error(\n\t\t\t\"File read failed\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t\t{ path },\n\t\t);\n\t\tthrow fsError;\n\t}\n}\n\n/**\n * Write text file with error handling and automatic directory creation\n */\nexport function writeTextFile(\n\tpath: string,\n\tcontent: string,\n\toptions: { encoding?: BufferEncoding; createDirs?: boolean } = {},\n): void {\n\tconst { encoding = \"utf-8\", createDirs = true } = options;\n\n\ttry {\n\t\tif (createDirs) {\n\t\t\tconst dir = dirname(path);\n\t\t\tif (!fileExists(dir)) {\n\t\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\t}\n\t\t}\n\n\t\twriteFileSync(path, content, encoding);\n\t\tlogger.debug(\"File written successfully\", { path, size: content.length });\n\t} catch (error) {\n\t\tconst fsError = new FileSystemError(\n\t\t\t`Failed to write file: ${path}`,\n\t\t\tpath,\n\t\t\t\"write\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t\tif (isErrno(error) && error.code === \"ENOENT\" && createDirs === false) {\n\t\t\tlogger.debug(\"File write failed\", { path, error });\n\t\t} else {\n\t\t\tlogger.error(\n\t\t\t\t\"File write failed\",\n\t\t\t\terror instanceof Error ? error : undefined,\n\t\t\t\t{ path },\n\t\t\t);\n\t\t}\n\t\tthrow fsError;\n\t}\n}\n\nfunction isErrno(error: unknown): error is NodeJS.ErrnoException {\n\treturn Boolean(\n\t\terror &&\n\t\t\ttypeof error === \"object\" &&\n\t\t\t\"code\" in error &&\n\t\t\ttypeof (error as NodeJS.ErrnoException).code === \"string\",\n\t);\n}\n\nexport { isErrno };\n\n/**\n * Read JSON file with parsing and error handling.\n *\n * When `rotateOnParseFail` is enabled, a file whose content fails to\n * parse as JSON is moved to a `<file>.corrupt.<iso-ts>` sibling\n * before the fallback is returned (#2631). This preserves forensic\n * evidence — instead of silently replacing user data with empty\n * state on the next write — and surfaces the bug in monitoring.\n *\n * The rotation does NOT fire on \"file not present\" (returns fallback\n * directly) or on \"file is empty string\" (also returns fallback);\n * it only fires when bytes exist but don't parse.\n */\nexport function readJsonFile<T = unknown>(\n\tpath: string,\n\toptions: { fallback?: T; rotateOnParseFail?: boolean } = {},\n): T {\n\tconst { fallback, rotateOnParseFail = false } = options;\n\n\ttry {\n\t\tconst content = readTextFile(path, {\n\t\t\tfallback: fallback !== undefined ? \"\" : undefined,\n\t\t});\n\n\t\tif (content === \"\" && fallback !== undefined) {\n\t\t\treturn fallback;\n\t\t}\n\n\t\tconst result = safeJsonParse<T>(content, path);\n\t\tif (!result.success) {\n\t\t\tif (fallback !== undefined) {\n\t\t\t\tlogger.warn(\"JSON parse failed, using fallback\", {\n\t\t\t\t\tpath,\n\t\t\t\t\terror: result.error.message,\n\t\t\t\t});\n\t\t\t\tif (rotateOnParseFail) {\n\t\t\t\t\tconst rotatedPath = rotateCorruptJsonFile(path, content);\n\t\t\t\t\tif (!rotatedPath) {\n\t\t\t\t\t\tconst repairedContent = readTextFile(path, { fallback: \"\" });\n\t\t\t\t\t\tif (repairedContent !== \"\" && repairedContent !== content) {\n\t\t\t\t\t\t\tconst repaired = safeJsonParse<T>(repairedContent, path);\n\t\t\t\t\t\t\tif (repaired.success) {\n\t\t\t\t\t\t\t\treturn repaired.data;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn fallback;\n\t\t\t}\n\t\t\tthrow result.error;\n\t\t}\n\n\t\treturn result.data;\n\t} catch (error) {\n\t\tif (fallback !== undefined) {\n\t\t\tlogger.warn(\"Failed to read JSON file, using fallback\", { path, error });\n\t\t\treturn fallback;\n\t\t}\n\t\tthrow error;\n\t}\n}\n\n/**\n * Rename a corrupt JSON state file to `<file>.corrupt.<iso-ts>` so\n * subsequent writes create a fresh valid file while the corrupted\n * bytes are preserved for forensics (#2631). Best-effort: failures\n * are logged and swallowed because rotation is a hygiene step, not\n * a load-bearing operation.\n *\n * Returns the rotated path on success, `null` if the source file\n * didn't exist or the rotation failed.\n */\nexport function rotateCorruptJsonFile(\n\tpath: string,\n\texpectedContent?: string,\n): string | null {\n\tif (!fileExists(path)) return null;\n\tif (expectedContent !== undefined) {\n\t\ttry {\n\t\t\tconst currentContent = readFileSync(path, \"utf8\");\n\t\t\tif (currentContent !== expectedContent) {\n\t\t\t\tlogger.warn(\"Skipped corrupt JSON rotation; file changed after read\", {\n\t\t\t\t\tpath,\n\t\t\t\t});\n\t\t\t\treturn null;\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tlogger.warn(\"Failed to re-read corrupt JSON before rotation\", {\n\t\t\t\tpath,\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t});\n\t\t\treturn null;\n\t\t}\n\t}\n\tconst timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n\t// Append per-call randomness so two processes parsing the same\n\t// corrupt file in the same millisecond produce different rotated\n\t// names. `renameSync` overwrites the destination on POSIX, so\n\t// without the random suffix the second rename would clobber the\n\t// first's forensic evidence.\n\tconst nonce = randomBytes(4).toString(\"hex\");\n\tconst rotatedPath = `${path}.corrupt.${timestamp}.${nonce}`;\n\ttry {\n\t\trenameSync(path, rotatedPath);\n\t\tlogger.warn(\"Rotated corrupt JSON file aside; starting fresh\", {\n\t\t\tfrom: path,\n\t\t\tto: rotatedPath,\n\t\t});\n\t\treturn rotatedPath;\n\t} catch (error) {\n\t\tlogger.warn(\"Failed to rotate corrupt JSON file\", {\n\t\t\tpath,\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t});\n\t\treturn null;\n\t}\n}\n\n/**\n * Write JSON file with formatting and error handling\n */\nexport function writeJsonFile(\n\tpath: string,\n\tdata: unknown,\n\toptions: { pretty?: boolean; createDirs?: boolean } = {},\n): void {\n\tconst { pretty = true, createDirs = true } = options;\n\n\ttry {\n\t\tconst content = pretty\n\t\t\t? JSON.stringify(data, null, 2)\n\t\t\t: safeJsonStringify(data);\n\n\t\twriteTextFileAtomic(path, content, { createDirs });\n\t} catch (error) {\n\t\tthrow new FileSystemError(\n\t\t\t`Failed to write JSON file: ${path}`,\n\t\t\tpath,\n\t\t\t\"write-json\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\nexport function writeJsonFileAtomic(\n\tpath: string,\n\tdata: unknown,\n\toptions: { pretty?: boolean; createDirs?: boolean } = {},\n): void {\n\twriteJsonFile(path, data, options);\n}\n\n/**\n * Ensure a directory exists, creating it if necessary\n */\nexport function ensureDir(path: string): void {\n\ttry {\n\t\tif (!fileExists(path)) {\n\t\t\tmkdirSync(path, { recursive: true });\n\t\t\tlogger.debug(\"Directory created\", { path });\n\t\t}\n\t} catch (error) {\n\t\tthrow new FileSystemError(\n\t\t\t`Failed to create directory: ${path}`,\n\t\t\tpath,\n\t\t\t\"mkdir\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\n/**\n * Safely append to a file\n */\nexport function appendTextFile(\n\tpath: string,\n\tcontent: string,\n\toptions: { encoding?: BufferEncoding; createDirs?: boolean } = {},\n): void {\n\tconst { encoding = \"utf-8\", createDirs = true } = options;\n\n\ttry {\n\t\tif (createDirs) {\n\t\t\tensureDir(dirname(path));\n\t\t}\n\n\t\tconst existing = fileExists(path) ? readTextFile(path, { encoding }) : \"\";\n\t\twriteTextFile(path, existing + content, { encoding, createDirs: false });\n\t} catch (error) {\n\t\tthrow new FileSystemError(\n\t\t\t`Failed to append to file: ${path}`,\n\t\t\tpath,\n\t\t\t\"append\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\n/**\n * Atomic write - write to temp file then rename\n */\nexport function writeTextFileAtomic(\n\tpath: string,\n\tcontent: string,\n\toptions: {\n\t\tencoding?: BufferEncoding;\n\t\tcreateDirs?: boolean;\n\t\tfsync?: boolean;\n\t\tmode?: number;\n\t} = {},\n): void {\n\tconst { encoding = \"utf-8\", createDirs = true, fsync = true } = options;\n\tconst tempPath = join(\n\t\tdirname(path),\n\t\t`.${basename(path)}.tmp.${process.pid}.${Date.now()}.${randomBytes(6).toString(\"hex\")}`,\n\t);\n\n\ttry {\n\t\tif (createDirs) {\n\t\t\tensureDir(dirname(path));\n\t\t}\n\t\tconst mode = options.mode ?? existingFileMode(path) ?? 0o600;\n\t\twriteFileSync(tempPath, content, { encoding, flag: \"wx\", mode });\n\t\tif (fsync) {\n\t\t\tsyncFile(tempPath);\n\t\t}\n\t\t// Rename is atomic on most filesystems\n\t\trenameSync(tempPath, path);\n\t\tif (fsync) {\n\t\t\tsyncDirectory(dirname(path));\n\t\t}\n\t} catch (error) {\n\t\t// Clean up temp file if it exists\n\t\ttry {\n\t\t\tif (fileExists(tempPath)) {\n\t\t\t\tunlinkSync(tempPath);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Ignore cleanup errors\n\t\t}\n\t\tthrow new FileSystemError(\n\t\t\t`Failed to write file atomically: ${path}`,\n\t\t\tpath,\n\t\t\t\"write-atomic\",\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\nfunction existingFileMode(path: string): number | undefined {\n\ttry {\n\t\tif (!fileExists(path)) return undefined;\n\t\treturn statSync(path).mode & 0o777;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction syncFile(path: string): void {\n\tconst fd = openSync(path, \"r+\");\n\ttry {\n\t\tfsyncSync(fd);\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n}\n\nfunction syncDirectory(path: string): void {\n\tif (process.platform === \"win32\") return;\n\tlet fd: number | undefined;\n\ttry {\n\t\tfd = openSync(path, \"r\");\n\t\tfsyncSync(fd);\n\t} catch (error) {\n\t\tlogger.debug(\"Directory fsync failed\", { path, error });\n\t} finally {\n\t\tif (fd !== undefined) {\n\t\t\ttry {\n\t\t\t\tcloseSync(fd);\n\t\t\t} catch (error) {\n\t\t\t\tlogger.debug(\"Directory fd close failed\", { path, error });\n\t\t\t}\n\t\t}\n\t}\n}\n"]}

package/dist/utils/git-stash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-stash.d.ts","sourceRoot":"","sources":["../../src/utils/git-stash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAOH;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAqDD;;GAEG;AACH,cAAM,eAAe;IACpB,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,MAAM,CAKZ;IAEF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAIhD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOrC;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmFhE;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCrD;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BlD;;OAEG;IACG,eAAe,CAAC,CAAC,EACtB,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC;IAsBb;;OAEG;IACH,kBAAkB,IAAI,UAAU,EAAE;IAOlC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA6BxE;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;YACW,YAAY;IAS1B;;OAEG;IACH,QAAQ,IAAI;QACX,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;KAC5B;IAcD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,KAAK,IAAI,IAAI;CAIb;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,iBAAwB,CAAC;AAE9C;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACtC,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC,CAEZ"}
+{"version":3,"file":"git-stash.d.ts","sourceRoot":"","sources":["../../src/utils/git-stash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAOH;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B;AA6DD;;GAEG;AACH,cAAM,eAAe;IACpB,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,MAAM,CAKZ;IAEF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAIhD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOrC;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmFhE;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCrD;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BlD;;OAEG;IACG,eAAe,CAAC,CAAC,EACtB,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC;IAsBb;;OAEG;IACH,kBAAkB,IAAI,UAAU,EAAE;IAOlC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA6BxE;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;YACW,YAAY;IAS1B;;OAEG;IACH,QAAQ,IAAI;QACX,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;KAC5B;IAcD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,KAAK,IAAI,IAAI;CAIb;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,iBAAwB,CAAC;AAE9C;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACtC,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/utils/git-stash.js

@@ -33,18 +33,25 @@
  * });
  * ```
  */
-import { execSync, spawnSync } from "node:child_process";
+import { spawnSync } from "node:child_process";
 import { createLogger } from "./logger.js";
 const logger = createLogger("utils:git-stash");
+/**
+ * Run a git command, throwing on non-zero exit (mirrors execSync's contract)
+ * but via argv array form so interpolated values can never reach a shell.
+ */
+function runGit(args, cwd) {
+    const result = spawnSync("git", args, { cwd, stdio: "pipe" });
+    if (result.status !== 0) {
+        throw new Error(`git ${args.join(" ")} failed (exit ${result.status})`);
+    }
+}
 /**
  * Check if current directory is a git repository
  */
 function isGitRepo(cwd) {
     try {
-        execSync("git rev-parse --is-inside-work-tree", {
-            cwd,
-            stdio: "pipe",
-        });
+        runGit(["rev-parse", "--is-inside-work-tree"], cwd);
         return true;
     }
     catch {
@@ -133,7 +140,7 @@ class GitStashManager {
             if (this.config.includeIgnored) {
                 args.push("--all");
             }
-            execSync(`git ${args.join(" ")}`, { cwd, stdio: "pipe" });
+            runGit(args, cwd);
             // Get the stash ref
             const refResult = spawnSync("git", ["stash", "list", "-n", "1"], {
                 cwd,
@@ -193,7 +200,7 @@ class GitStashManager {
                 logger.warn("Stash ref not found in git", { stashId });
                 return false;
             }
-            execSync(`git stash pop ${currentRef}`, { cwd, stdio: "pipe" });
+            runGit(["stash", "pop", currentRef], cwd);
             // Remove from tracking
             this.removeStashEntry(stashId);
             logger.info("Stash restored", { stashId, ref: currentRef });
@@ -217,7 +224,7 @@ class GitStashManager {
         try {
             const currentRef = await this.findStashRef(entry.message, cwd);
             if (currentRef) {
-                execSync(`git stash drop ${currentRef}`, { cwd, stdio: "pipe" });
+                runGit(["stash", "drop", currentRef], cwd);
             }
             this.removeStashEntry(stashId);
             logger.debug("Stash dropped", { stashId });