codexmate 0.1.9 → 0.1.12

package/README.md

@@ -184,10 +184,6 @@ Special thanks to all contributors for their contributions to Codex Mate ❤️
   <img src="https://contrib.rocks/image?repo=SakuraByteCore/codexmate" />
 </a>
 
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=SakuraByteCore/codexmate&type=Date)](https://star-history.com/#SakuraByteCore/codexmate&Date)
-
 ## License
 
 Apache-2.0

package/README.vi.md

@@ -167,10 +167,6 @@ Cảm ơn tất cả những người đóng góp cho Codex Mate ❤️
   <img src="https://contrib.rocks/image?repo=SakuraByteCore/codexmate" alt="Contributors" />
 </a>
 
-## Lịch sử Star
-
-[![Star History Chart](https://api.star-history.com/svg?repos=SakuraByteCore/codexmate&type=Date)](https://star-history.com/#SakuraByteCore/codexmate&Date)
-
 ## Giấy phép
 
 Apache-2.0

package/README.zh.md

@@ -181,10 +181,6 @@ flowchart TD
   <img src="https://contrib.rocks/image?repo=SakuraByteCore/codexmate" />
 </a>
 
-## Star 历史
-
-[![Star History Chart](https://api.star-history.com/svg?repos=SakuraByteCore/codexmate&type=Date)](https://star-history.com/#SakuraByteCore/codexmate&Date)
-
 ## 开源协议
 
 Apache-2.0

package/cli/agents-files.js

@@ -14,7 +14,8 @@ function createAgentsFileController(deps = {}) {
         CLAUDE_DIR,
         CLAUDE_MD_FILE_NAME,
         readOpenclawAgentsFile,
-        readOpenclawWorkspaceFile
+        readOpenclawWorkspaceFile,
+        backupPromptBeforeWrite
     } = deps;
 
     if (!fs) throw new Error('createAgentsFileController 缺少 fs');
@@ -32,6 +33,7 @@ function createAgentsFileController(deps = {}) {
     if (typeof CLAUDE_MD_FILE_NAME !== 'string' || !CLAUDE_MD_FILE_NAME) throw new Error('createAgentsFileController 缺少 CLAUDE_MD_FILE_NAME');
     if (typeof readOpenclawAgentsFile !== 'function') throw new Error('createAgentsFileController 缺少 readOpenclawAgentsFile');
     if (typeof readOpenclawWorkspaceFile !== 'function') throw new Error('createAgentsFileController 缺少 readOpenclawWorkspaceFile');
+    if (typeof backupPromptBeforeWrite !== 'function' && typeof backupPromptBeforeWrite !== 'undefined') throw new Error('createAgentsFileController 备份回调无效');
 
     function resolveAgentsFilePath(params = {}) {
         const baseDir = typeof params.baseDir === 'string' && params.baseDir.trim()
@@ -40,6 +42,12 @@ function createAgentsFileController(deps = {}) {
         return path.join(baseDir, AGENTS_FILE_NAME);
     }
 
+    function sanitizeHistoryId(raw) {
+        const safe = typeof raw === 'string' ? raw.trim() : '';
+        if (!safe) return 'global';
+        return safe.replace(/[^A-Za-z0-9_.-]/g, '_').slice(0, 64) || 'global';
+    }
+
     function validateAgentsBaseDir(filePath) {
         const dirPath = path.dirname(filePath);
         try {
@@ -152,6 +160,13 @@ function createAgentsFileController(deps = {}) {
         if (content.length > 2 * 1024 * 1024) {
             return { error: 'content too large (max 2MB)' };
         }
+        if (typeof backupPromptBeforeWrite === 'function') {
+            var bucket = resolved.isProject
+                ? 'claude-project_' + sanitizeHistoryId(resolved.projectPath)
+                : 'claude-global';
+            backupPromptBeforeWrite(bucket, filePath);
+            resolved.historyBucket = bucket;
+        }
         var lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
         var normalized = normalizeLineEnding(content, lineEnding);
         var finalContent = ensureUtf8Bom(normalized);
@@ -159,6 +174,7 @@ function createAgentsFileController(deps = {}) {
             ensureDir(path.dirname(filePath));
             fs.writeFileSync(filePath, finalContent, 'utf-8');
             var result = { success: true, path: filePath };
+            if (resolved.historyBucket) result.historyBucket = resolved.historyBucket;
             if (resolved.isProject) {
                 result.projectPath = resolved.projectPath;
                 result.detectionSource = resolved.detectionSource;
@@ -218,13 +234,21 @@ function createAgentsFileController(deps = {}) {
         if (content.length > 2 * 1024 * 1024) {
             return { error: '内容过大（最大 2MB）' };
         }
+        let agentsHistoryBucket = '';
+        if (typeof backupPromptBeforeWrite === 'function') {
+            const bucket = 'codex_' + sanitizeHistoryId(String(params.baseDir || '').trim() || 'global');
+            backupPromptBeforeWrite(bucket, filePath);
+            agentsHistoryBucket = bucket;
+        }
         const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
-        const normalized = normalizeLineEnding(content, lineEnding);
+        var normalized = normalizeLineEnding(content, lineEnding);
         const finalContent = ensureUtf8Bom(normalized);
 
         try {
             fs.writeFileSync(filePath, finalContent, 'utf-8');
-            return { success: true, path: filePath };
+            const agentsResult = { success: true, path: filePath };
+            if (agentsHistoryBucket) agentsResult.historyBucket = agentsHistoryBucket;
+            return agentsResult;
         } catch (e) {
             return { error: `写入 AGENTS.md 失败: ${e.message}` };
         }

package/cli/prompt-history.js

@@ -0,0 +1,171 @@
+'use strict';
+
+function createPromptHistoryController(deps = {}) {
+    const {
+        fs,
+        path,
+        CONFIG_DIR,
+        MAX_HISTORY = 20
+    } = deps;
+
+    if (!fs) throw new Error('createPromptHistoryController 缺少 fs');
+    if (!path) throw new Error('createPromptHistoryController 缺少 path');
+    if (typeof CONFIG_DIR !== 'string' || !CONFIG_DIR) throw new Error('createPromptHistoryController 缺少 CONFIG_DIR');
+
+    const HISTORY_ROOT = path.join(CONFIG_DIR, 'codexmate-prompt-history');
+    const STAMP_RE = /^(\d{8})-(\d{6})-(\d{3})\.bak$/;
+
+    function sanitizeBucket(bucket) {
+        const raw = typeof bucket === 'string' ? bucket.trim() : '';
+        if (!raw) throw new Error('prompt history bucket 不能为空');
+        const safe = raw.replace(/[^A-Za-z0-9_.-]/g, '_');
+        if (!safe) throw new Error('prompt history bucket 无效: ' + bucket);
+        return safe;
+    }
+
+    function resolveBucketDir(bucket) {
+        const safe = sanitizeBucket(bucket);
+        return path.join(HISTORY_ROOT, safe);
+    }
+
+    function buildTimestamp(d = new Date()) {
+        const pad2 = (n) => String(n).padStart(2, '0');
+        const pad3 = (n) => String(n).padStart(3, '0');
+        return `${d.getFullYear()}${pad2(d.getMonth() + 1)}${pad2(d.getDate())}`
+            + `-${pad2(d.getHours())}${pad2(d.getMinutes())}${pad2(d.getSeconds())}`
+            + `-${pad3(d.getMilliseconds())}`;
+    }
+
+    function parseStamp(name) {
+        return STAMP_RE.test(name) ? name.slice(0, name.length - 4) : null;
+    }
+
+    function ensureDirSync(dir) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+
+    function rmtreeSync(dir) {
+        try {
+            fs.rmSync(dir, { recursive: true, force: true });
+        } catch (_) {}
+    }
+
+    function backupPromptBeforeWrite(bucket, currentFilePath) {
+        const dir = resolveBucketDir(bucket);
+        const exists = fs.existsSync(currentFilePath);
+        if (!exists) return { backedUp: false, entries: listPromptHistory(bucket) };
+        let raw;
+        try {
+            raw = fs.readFileSync(currentFilePath, 'utf-8');
+        } catch (e) {
+            return { backedUp: false, error: '读取当前文件失败: ' + e.message };
+        }
+        ensureDirSync(dir);
+        const stamp = buildTimestamp();
+        const dest = path.join(dir, stamp + '.bak');
+        try {
+            fs.writeFileSync(dest, raw, 'utf-8');
+        } catch (e) {
+            return { backedUp: false, error: '写入备份失败: ' + e.message };
+        }
+        trimHistory(dir);
+        return { backedUp: true, entries: listPromptHistory(bucket) };
+    }
+
+    function listPromptHistory(bucket) {
+        const dir = resolveBucketDir(bucket);
+        if (!fs.existsSync(dir)) return [];
+        let names;
+        try {
+            names = fs.readdirSync(dir);
+        } catch (_) {
+            return [];
+        }
+        const items = [];
+        for (const name of names) {
+            const stamp = parseStamp(name);
+            if (!stamp) continue;
+            let stat;
+            try {
+                stat = fs.statSync(path.join(dir, name));
+            } catch (_) {
+                continue;
+            }
+            items.push({
+                id: stamp,
+                bucket: sanitizeBucket(bucket),
+                size: Number(stat.size) || 0,
+                mtimeMs: Number(stat.mtimeMs) || 0
+            });
+        }
+        items.sort((a, b) => b.mtimeMs - a.mtimeMs);
+        return items;
+    }
+
+    function readPromptHistory(bucket, id) {
+        const dir = resolveBucketDir(bucket);
+        const stamp = typeof id === 'string' ? id.trim() : '';
+        const fullName = stamp + '.bak';
+        if (!stamp || !STAMP_RE.test(fullName)) {
+            return { error: 'history id invalid' };
+        }
+        const file = path.join(dir, fullName);
+        if (!fs.existsSync(file)) return { error: 'history entry 不存在' };
+        try {
+            const content = fs.readFileSync(file, 'utf-8');
+            return { id: stamp, content, bucket: sanitizeBucket(bucket) };
+        } catch (e) {
+            return { error: '读取 history 失败: ' + e.message };
+        }
+    }
+
+    function trimHistory(dir) {
+        let names;
+        try {
+            names = fs.readdirSync(dir);
+        } catch (_) {
+            return;
+        }
+        const stamped = [];
+        for (const name of names) {
+            const stamp = parseStamp(name);
+            if (!stamp) continue;
+            let stat;
+            try {
+                stat = fs.statSync(path.join(dir, name));
+            } catch (_) {
+                continue;
+            }
+            stamped.push({ name, mtimeMs: Number(stat.mtimeMs) || 0 });
+        }
+        stamped.sort((a, b) => b.mtimeMs - a.mtimeMs);
+        if (stamped.length <= MAX_HISTORY) return;
+        for (let i = MAX_HISTORY; i < stamped.length; i++) {
+            try {
+                fs.unlinkSync(path.join(dir, stamped[i].name));
+            } catch (_) {}
+        }
+    }
+
+    function clearPromptHistory(bucket) {
+        if (!bucket) {
+            rmtreeSync(HISTORY_ROOT);
+            return { cleared: true };
+        }
+        const dir = resolveBucketDir(bucket);
+        rmtreeSync(dir);
+        return { cleared: true };
+    }
+
+    return {
+        sanitizeBucket,
+        backupPromptBeforeWrite,
+        listPromptHistory,
+        readPromptHistory,
+        clearPromptHistory
+    };
+}
+
+module.exports = {
+    createPromptHistoryController
+};

package/cli/system-prompt-files.js

@@ -8,7 +8,8 @@ function createSystemPromptFileController(deps = {}) {
         crypto,
         buildLineDiff,
         CONFIG_DIR,
-        PI_AGENT_DIR
+        PI_AGENT_DIR,
+        backupPromptBeforeWrite
     } = deps;
 
     if (!fs) throw new Error('createSystemPromptFileController 缺少 fs');
@@ -18,6 +19,7 @@ function createSystemPromptFileController(deps = {}) {
     if (typeof buildLineDiff !== 'function') throw new Error('createSystemPromptFileController 缺少 buildLineDiff');
     if (typeof CONFIG_DIR !== 'string' || !CONFIG_DIR) throw new Error('createSystemPromptFileController 缺少 CONFIG_DIR');
     if (typeof PI_AGENT_DIR !== 'string' || !PI_AGENT_DIR) throw new Error('createSystemPromptFileController 缺少 PI_AGENT_DIR');
+    if (typeof backupPromptBeforeWrite !== 'function' && typeof backupPromptBeforeWrite !== 'undefined') throw new Error('createSystemPromptFileController 备份回调无效');
 
     const MODES = {
         system: 'SYSTEM.md',
@@ -34,6 +36,12 @@ function createSystemPromptFileController(deps = {}) {
         return key;
     }
 
+    function sanitizeSystemHistoryId(raw) {
+        const safe = typeof raw === 'string' ? raw.trim() : '';
+        if (!safe) return 'global';
+        return safe.replace(/[^A-Za-z0-9_.-]/g, '_').slice(0, 64) || 'global';
+    }
+
     function normalizeScope(scope) {
         const key = typeof scope === 'string' ? scope.trim() : '';
         if (!SCOPES.includes(key)) {
@@ -104,16 +112,26 @@ function createSystemPromptFileController(deps = {}) {
         if (baseHash && baseHash !== current.hash) {
             return { error: '文件已被外部修改，请重新加载后再保存' };
         }
+        let sysHistoryBucket = '';
         try {
             const dir = path.dirname(target.path);
             fs.mkdirSync(dir, { recursive: true });
+            if (typeof backupPromptBeforeWrite === 'function') {
+                const bucket = 'system_' + target.scope + '_' + (target.scope === 'project'
+                    ? sanitizeSystemHistoryId(path.dirname(target.path))
+                    : 'global');
+                backupPromptBeforeWrite(bucket, target.path);
+                sysHistoryBucket = bucket;
+            }
             const finalContent = content.endsWith('\n') ? content : content + '\n';
             fs.writeFileSync(target.path, finalContent, { encoding: 'utf8', mode: 0o600 });
             try { fs.chmodSync(target.path, 0o600); } catch (_) {}
         } catch (e) {
             return { error: '写入 system prompt 失败: ' + e.message };
         }
-        return readSystemPromptFilePath(target);
+        const saved = readSystemPromptFilePath(target);
+        if (sysHistoryBucket) saved.historyBucket = sysHistoryBucket;
+        return saved;
     }
 
     function readSystemPromptFilePath(resolved) {