@trenchwork/erosolar 1.1.30 → 1.1.32

package/dist/tools/fileChangeTracker.js

@@ -0,0 +1,154 @@
+/**
+ * File Change Tracker - Tracks file modifications for revert functionality
+ *
+ * This module stores original file content before modifications so users
+ * can revert all changes made during a run with /revert command.
+ */
+import { readFileSync, writeFileSync, existsSync, unlinkSync } from 'node:fs';
+import { relative } from 'node:path';
+/** Map of file paths to their original state */
+const fileChanges = new Map();
+/** Current run ID to track which run we're in */
+let currentRunId = 0;
+/** Run ID when changes were recorded */
+let changesRunId = 0;
+/**
+ * Start a new run - clears previous change tracking
+ */
+export function startNewRun() {
+    currentRunId++;
+    // Don't clear changes yet - allow revert of previous run until new changes happen
+}
+/**
+ * Record original content before a file is modified
+ * Only records the FIRST state - subsequent edits don't overwrite
+ */
+export function recordFileChange(filePath) {
+    // If this is a new run, clear old tracking
+    if (changesRunId !== currentRunId) {
+        fileChanges.clear();
+        changesRunId = currentRunId;
+    }
+    // Only record first modification
+    if (fileChanges.has(filePath)) {
+        const record = fileChanges.get(filePath);
+        record.modifyCount++;
+        return;
+    }
+    // Check if file exists and read original content
+    const existedBefore = existsSync(filePath);
+    let originalContent = null;
+    if (existedBefore) {
+        try {
+            originalContent = readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            // If we can't read it, we can't revert it
+            originalContent = null;
+        }
+    }
+    fileChanges.set(filePath, {
+        originalContent,
+        existedBefore,
+        firstModified: Date.now(),
+        modifyCount: 1,
+    });
+}
+/**
+ * Get all changed files in the current run
+ */
+export function getChangedFiles() {
+    return new Map(fileChanges);
+}
+/**
+ * Check if there are any changes to revert
+ */
+export function hasChangesToRevert() {
+    return fileChanges.size > 0;
+}
+/**
+ * Revert all changes made during the current run
+ * Returns a summary of what was reverted
+ */
+export function revertAllChanges(workingDir) {
+    if (fileChanges.size === 0) {
+        return 'No changes to revert.';
+    }
+    const results = [];
+    let reverted = 0;
+    let deleted = 0;
+    let errors = 0;
+    for (const [filePath, record] of fileChanges) {
+        const relativePath = relative(workingDir, filePath);
+        const displayPath = relativePath && !relativePath.startsWith('..') ? relativePath : filePath;
+        try {
+            if (record.existedBefore && record.originalContent !== null) {
+                // Restore original content
+                writeFileSync(filePath, record.originalContent, 'utf-8');
+                results.push(`  ✓ Restored: ${displayPath}`);
+                reverted++;
+            }
+            else if (!record.existedBefore) {
+                // Delete file that was created
+                if (existsSync(filePath)) {
+                    unlinkSync(filePath);
+                    results.push(`  ✓ Deleted: ${displayPath} (was created this run)`);
+                    deleted++;
+                }
+            }
+            else {
+                results.push(`  ⚠ Skipped: ${displayPath} (no original content recorded)`);
+            }
+        }
+        catch (error) {
+            results.push(`  ✗ Failed: ${displayPath} - ${error.message}`);
+            errors++;
+        }
+    }
+    // Clear the change tracking after revert
+    fileChanges.clear();
+    const summary = [];
+    if (reverted > 0)
+        summary.push(`${reverted} file${reverted === 1 ? '' : 's'} restored`);
+    if (deleted > 0)
+        summary.push(`${deleted} file${deleted === 1 ? '' : 's'} deleted`);
+    if (errors > 0)
+        summary.push(`${errors} error${errors === 1 ? '' : 's'}`);
+    return [
+        `⏪ Revert complete: ${summary.join(', ')}`,
+        '',
+        ...results,
+    ].join('\n');
+}
+/**
+ * Get a summary of pending changes that can be reverted
+ */
+export function getRevertSummary(workingDir) {
+    if (fileChanges.size === 0) {
+        return 'No changes to revert.';
+    }
+    const lines = [
+        `📋 Changes that will be reverted (${fileChanges.size} file${fileChanges.size === 1 ? '' : 's'}):`,
+        '',
+    ];
+    for (const [filePath, record] of fileChanges) {
+        const relativePath = relative(workingDir, filePath);
+        const displayPath = relativePath && !relativePath.startsWith('..') ? relativePath : filePath;
+        if (record.existedBefore) {
+            lines.push(`  • ${displayPath} (modified ${record.modifyCount}x)`);
+        }
+        else {
+            lines.push(`  • ${displayPath} (created - will be deleted)`);
+        }
+    }
+    lines.push('');
+    lines.push('Use /revert confirm to revert these changes.');
+    return lines.join('\n');
+}
+/**
+ * Clear change tracking (for testing or manual reset)
+ */
+export function clearChangeTracking() {
+    fileChanges.clear();
+}
+//# sourceMappingURL=fileChangeTracker.js.map

package/dist/tools/fileChangeTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileChangeTracker.js","sourceRoot":"","sources":["../../src/tools/fileChangeTracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAarC,gDAAgD;AAChD,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;AAExD,iDAAiD;AACjD,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,wCAAwC;AACxC,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,YAAY,EAAE,CAAC;IACf,kFAAkF;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,2CAA2C;IAC3C,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;QAClC,WAAW,CAAC,KAAK,EAAE,CAAC;QACpB,YAAY,GAAG,YAAY,CAAC;IAC9B,CAAC;IAED,iCAAiC;IACjC,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QAC1C,MAAM,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,iDAAiD;IACjD,MAAM,aAAa,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,eAAe,GAAkB,IAAI,CAAC;IAE1C,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,eAAe,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;YAC1C,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE;QACxB,eAAe;QACf,aAAa;QACb,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE;QACzB,WAAW,EAAE,CAAC;KACf,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC7C,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,YAAY,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE7F,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;gBAC5D,2BAA2B;gBAC3B,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;gBACzD,OAAO,CAAC,IAAI,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC;gBAC7C,QAAQ,EAAE,CAAC;YACb,CAAC;iBAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;gBACjC,+BAA+B;gBAC/B,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACzB,UAAU,CAAC,QAAQ,CAAC,CAAC;oBACrB,OAAO,CAAC,IAAI,CAAC,gBAAgB,WAAW,yBAAyB,CAAC,CAAC;oBACnE,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,gBAAgB,WAAW,iCAAiC,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,eAAe,WAAW,MAAO,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YACzE,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,WAAW,CAAC,KAAK,EAAE,CAAC;IAEpB,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,QAAQ,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC;IACxF,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,QAAQ,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;IACpF,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAE1E,OAAO;QACL,sBAAsB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC1C,EAAE;QACF,GAAG,OAAO;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,qCAAqC,WAAW,CAAC,IAAI,QAAQ,WAAW,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;QAClG,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC7C,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,YAAY,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE7F,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,OAAO,WAAW,cAAc,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,OAAO,WAAW,8BAA8B,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAE3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}

package/dist/tools/fileReadTracker.d.ts

@@ -0,0 +1,69 @@
+/**
+ * File Read Tracker - Enforces "Read Before Edit" pattern
+ *
+ * This module tracks file reads to ensure the AI has fresh content
+ * before attempting edits. This prevents "old_string not found" errors
+ * caused by using stale content from memory.
+ */
+export interface FileReadRecord {
+    /** When the file was last read */
+    timestamp: number;
+    /** Hash of the content at read time (for staleness detection) */
+    contentHash: string;
+    /** Line range that was read (null = full file) */
+    lineRange: {
+        start: number;
+        end: number;
+    } | null;
+}
+export interface ReadValidationResult {
+    /** Whether the read is valid for editing */
+    valid: boolean;
+    /** Type of issue if not valid */
+    issue?: 'not_read' | 'stale' | 'content_changed';
+    /** Error message for display */
+    errorMessage?: string;
+    /** Whether auto-refresh can resolve the issue */
+    canAutoRefresh?: boolean;
+}
+/**
+ * Simple content hash for staleness detection
+ */
+export declare function hashContent(content: string): string;
+/**
+ * Record that a file was read
+ */
+export declare function recordFileRead(filePath: string, content: string, lineRange?: {
+    start: number;
+    end: number;
+}): void;
+/**
+ * Check if a file has been read recently enough for editing
+ */
+export declare function wasFileReadRecently(filePath: string): boolean;
+/**
+ * Get the read record for a file
+ */
+export declare function getFileReadRecord(filePath: string): FileReadRecord | null;
+/**
+ * Validate that a file read is valid for the edit being attempted
+ * Returns null if valid, or an error message if not
+ */
+export declare function validateReadForEdit(filePath: string, _oldString: string, currentContent: string): string | null;
+/**
+ * Enhanced validation that returns structured result for auto-refresh support.
+ * Returns detailed info about validation state instead of just an error message.
+ */
+export declare function validateReadForEditEx(filePath: string, _oldString: string, currentContent: string): ReadValidationResult;
+/**
+ * Clear all read records (for testing or session reset)
+ */
+export declare function clearFileReadRecords(): void;
+/**
+ * Get stats for debugging
+ */
+export declare function getReadTrackerStats(): {
+    trackedFiles: number;
+    oldestReadAge: number | null;
+};
+//# sourceMappingURL=fileReadTracker.d.ts.map

package/dist/tools/fileReadTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileReadTracker.d.ts","sourceRoot":"","sources":["../../src/tools/fileReadTracker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,iBAAiB,CAAC;IACjD,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAcD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzC,IAAI,CAqBN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEzE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAqDf;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,oBAAoB,CAoEtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAgB5F"}

package/dist/tools/fileReadTracker.js

@@ -0,0 +1,213 @@
+/**
+ * File Read Tracker - Enforces "Read Before Edit" pattern
+ *
+ * This module tracks file reads to ensure the AI has fresh content
+ * before attempting edits. This prevents "old_string not found" errors
+ * caused by using stale content from memory.
+ */
+/** How long a read is considered valid (5 minutes) */
+const READ_VALIDITY_MS = 5 * 60 * 1000;
+/** Environment flag to disable enforcement (for testing) */
+const ENFORCE_READ_BEFORE_EDIT = process.env['EROSOLAR_ENFORCE_READ_BEFORE_EDIT'] !== 'false';
+/** Maximum entries to track (LRU eviction) */
+const MAX_TRACKED_FILES = 100;
+/** Map of file paths to their read records */
+const fileReadRecords = new Map();
+/**
+ * Simple content hash for staleness detection
+ */
+export function hashContent(content) {
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        const char = content.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    return hash.toString(36);
+}
+/**
+ * Record that a file was read
+ */
+export function recordFileRead(filePath, content, lineRange) {
+    // LRU eviction if at capacity
+    if (fileReadRecords.size >= MAX_TRACKED_FILES) {
+        let oldestPath = null;
+        let oldestTime = Infinity;
+        for (const [path, record] of fileReadRecords) {
+            if (record.timestamp < oldestTime) {
+                oldestTime = record.timestamp;
+                oldestPath = path;
+            }
+        }
+        if (oldestPath) {
+            fileReadRecords.delete(oldestPath);
+        }
+    }
+    fileReadRecords.set(filePath, {
+        timestamp: Date.now(),
+        contentHash: hashContent(content),
+        lineRange: lineRange ?? null,
+    });
+}
+/**
+ * Check if a file has been read recently enough for editing
+ */
+export function wasFileReadRecently(filePath) {
+    const record = fileReadRecords.get(filePath);
+    if (!record)
+        return false;
+    const age = Date.now() - record.timestamp;
+    return age < READ_VALIDITY_MS;
+}
+/**
+ * Get the read record for a file
+ */
+export function getFileReadRecord(filePath) {
+    return fileReadRecords.get(filePath) ?? null;
+}
+/**
+ * Validate that a file read is valid for the edit being attempted
+ * Returns null if valid, or an error message if not
+ */
+export function validateReadForEdit(filePath, _oldString, currentContent) {
+    // Allow bypass for testing environments
+    if (!ENFORCE_READ_BEFORE_EDIT) {
+        return null;
+    }
+    const record = fileReadRecords.get(filePath);
+    // No read record at all
+    if (!record) {
+        return [
+            'Error: You must Read the file before editing it.',
+            '',
+            'This ensures you have the exact current content including whitespace.',
+            '',
+            'Required steps:',
+            `1. Use read_file tool to read: ${filePath}`,
+            '2. Copy the EXACT text from the Read output (including indentation)',
+            '3. Use that text as old_string in your Edit call',
+            '',
+            'NEVER edit a file without reading it first in this conversation.',
+        ].join('\n');
+    }
+    // Check if read is stale (too old)
+    const age = Date.now() - record.timestamp;
+    if (age > READ_VALIDITY_MS) {
+        const minutes = Math.floor(age / 60000);
+        return [
+            `Error: File read is stale (${minutes} minutes old).`,
+            '',
+            'The file may have changed since you last read it.',
+            '',
+            'Required: Read the file again before editing.',
+            `Use read_file tool to get fresh content from: ${filePath}`,
+        ].join('\n');
+    }
+    // Check if content has changed since read (file was modified externally)
+    const currentHash = hashContent(currentContent);
+    if (record.contentHash !== currentHash) {
+        return [
+            'Error: File content has changed since you read it.',
+            '',
+            'The file was modified (possibly by a formatter, linter, or external process).',
+            '',
+            'Required: Read the file again to get the current content.',
+            `Use read_file tool to refresh: ${filePath}`,
+        ].join('\n');
+    }
+    // Valid read
+    return null;
+}
+/**
+ * Enhanced validation that returns structured result for auto-refresh support.
+ * Returns detailed info about validation state instead of just an error message.
+ */
+export function validateReadForEditEx(filePath, _oldString, currentContent) {
+    // Allow bypass for testing environments
+    if (!ENFORCE_READ_BEFORE_EDIT) {
+        return { valid: true };
+    }
+    const record = fileReadRecords.get(filePath);
+    // No read record at all
+    if (!record) {
+        return {
+            valid: false,
+            issue: 'not_read',
+            canAutoRefresh: false,
+            errorMessage: [
+                'Error: You must Read the file before editing it.',
+                '',
+                'This ensures you have the exact current content including whitespace.',
+                '',
+                'Required steps:',
+                `1. Use read_file tool to read: ${filePath}`,
+                '2. Copy the EXACT text from the Read output (including indentation)',
+                '3. Use that text as old_string in your Edit call',
+                '',
+                'NEVER edit a file without reading it first in this conversation.',
+            ].join('\n'),
+        };
+    }
+    // Check if read is stale (too old)
+    const age = Date.now() - record.timestamp;
+    if (age > READ_VALIDITY_MS) {
+        const minutes = Math.floor(age / 60000);
+        return {
+            valid: false,
+            issue: 'stale',
+            canAutoRefresh: true,
+            errorMessage: [
+                `Error: File read is stale (${minutes} minutes old).`,
+                '',
+                'The file may have changed since you last read it.',
+                '',
+                'Required: Read the file again before editing.',
+                `Use read_file tool to get fresh content from: ${filePath}`,
+            ].join('\n'),
+        };
+    }
+    // Check if content has changed since read (file was modified externally)
+    const currentHash = hashContent(currentContent);
+    if (record.contentHash !== currentHash) {
+        return {
+            valid: false,
+            issue: 'content_changed',
+            canAutoRefresh: true,
+            errorMessage: [
+                'Error: File content has changed since you read it.',
+                '',
+                'The file was modified (possibly by a formatter, linter, or external process).',
+                '',
+                'Required: Read the file again to get the current content.',
+                `Use read_file tool to refresh: ${filePath}`,
+            ].join('\n'),
+        };
+    }
+    // Valid read
+    return { valid: true };
+}
+/**
+ * Clear all read records (for testing or session reset)
+ */
+export function clearFileReadRecords() {
+    fileReadRecords.clear();
+}
+/**
+ * Get stats for debugging
+ */
+export function getReadTrackerStats() {
+    if (fileReadRecords.size === 0) {
+        return { trackedFiles: 0, oldestReadAge: null };
+    }
+    let oldestTime = Infinity;
+    for (const record of fileReadRecords.values()) {
+        if (record.timestamp < oldestTime) {
+            oldestTime = record.timestamp;
+        }
+    }
+    return {
+        trackedFiles: fileReadRecords.size,
+        oldestReadAge: Date.now() - oldestTime,
+    };
+}
+//# sourceMappingURL=fileReadTracker.js.map

package/dist/tools/fileReadTracker.js.map

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

package/dist/tools/fileTools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function createFileTools(workingDir: string): ToolDefinition[];
+//# sourceMappingURL=fileTools.d.ts.map

package/dist/tools/fileTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTools.d.ts","sourceRoot":"","sources":["../../src/tools/fileTools.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAY7D,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CA4MpE"}