mocode-ai 0.2.9 → 0.2.10

package/dist/config/index.js

@@ -122,7 +122,8 @@ ${PLATFORM_NOTE}
 ## Working notepad (todolist) — checklist for complex tasks
 - For **complex multi-step tasks** (≥3 file changes OR ≥5 tool calls expected OR user says "先计划再执行" / "plan then do" / "按步骤来"), call the \`todolist\` tool FIRST to write a plan to \`.mocode/plans/<id>.md\`, then execute step by step, calling \`todolist update\` to mark progress. For trivial single-step tasks, skip it and just execute.
 - The plan is file-backed (survives context compression, user can see/edit). The active plan summary is auto-injected into the system prompt each turn, so you can re-read it via \`todolist read\` whenever you're unsure of your place.
-- Single plan per session: \`todolist create\` refuses if an in-progress plan already exists — finish or abandon it first. After \`todolist finish\`, the plan is archived and a new one can be created.
+- Single plan per session: \`todolist create\` refuses if an in-progress plan already exists — finish or abandon it first.
+- **Lifecycle** (5 actions total): \`create\` / \`read\` / \`update\` / \`add_step\` / \`finish\` for normal flow. \`finish plan_status=finished\` AUTO-ARCHIVES the plan to \`.mocode/plans/archive/<id>.md\` (history preserved, active dir stays clean). To revisit old plans: \`list scope=archived\` (or \`all\`) + \`unarchive id=<id>\` to bring back. \`delete id=<id>\` permanently removes (any location); cannot delete the currently active plan.
 - Don't over-use it: for a single edit or a quick lookup, \`todolist\` is overhead. The threshold is "this needs ≥3 steps OR I might forget the plan after context compaction."
 
 ## Termination & Reporting

package/dist/plan/index.js

@@ -6,7 +6,7 @@
 // 被 repl 依赖(注入 systemPrompt + 状态行 + listener 注册)+ tools/builtins/todolist 依赖。
 export { 
 // store
-plansDir, planPath, ensurePlansDir, newPlanId, parsePlan, serializePlan, readPlan, writePlan, deletePlan, updatePlan, listPlans, renderPlanForLLM, renderPlanChip, } from './store.js';
+plansDir, archiveDir, planPath, ensurePlansDir, ensureArchiveDir, newPlanId, parsePlan, serializePlan, readPlan, writePlan, deletePlan, deletePlanAnywhere, updatePlan, listPlans, archivePlan, unarchivePlan, renderPlanForLLM, renderPlanChip, } from './store.js';
 export { getActivePlan, setActivePlan, clearActivePlan, onActivePlanChange, hasActivePlan, getActivePlanSummary, } from './active.js';
 import { getActivePlan } from './active.js';
 import { renderPlanForLLM } from './store.js';

package/dist/plan/store.js

@@ -16,9 +16,13 @@ export function plansDir() {
     const root = getSandboxRoot() ?? process.cwd();
     return join(root, '.mocode', 'plans');
 }
-/** 单 plan 文件路径:<root>/.mocode/plans/<id>.md。 */
-export function planPath(id) {
-    return join(plansDir(), `${id}.md`);
+/** 归档目录:<root>/.mocode/plans/archive/。finish 自动归档、用户手动 unarchive 都走这里。 */
+export function archiveDir() {
+    return join(plansDir(), 'archive');
+}
+/** 单 plan 文件路径:<root>/.mocode/plans/<id>.md。可选 baseDir:默认 plans,也可指 archive。 */
+export function planPath(id, baseDir = plansDir()) {
+    return join(baseDir, `${id}.md`);
 }
 /** 确保 plans 目录存在(惰性,工具每次写前调)。 */
 export function ensurePlansDir() {
@@ -26,7 +30,24 @@ export function ensurePlansDir() {
     if (!existsSync(d))
         mkdirSync(d, { recursive: true });
 }
+/** 确保归档目录存在(惰性)。 */
+export function ensureArchiveDir() {
+    const d = archiveDir();
+    if (!existsSync(d))
+        mkdirSync(d, { recursive: true });
+}
 // ── ID 生成 ──
+/** 本地时间戳(无时区后缀),与 filename 的 YYYY-MM-DDTHH-mm-ss 风格一致。
+ *  例:2026-07-04T22:54:51.729(本地时,便于人对读 frontmatter / progress log,
+ *  且与同 plan id 文件名"2026-07-04T22-54-51"对应)。
+ *  不带 Z 后缀 → JS Date 解析会按本地时读(一致 round-trip);
+ *  反例:toISOString() 返 2026-07-04T14:54:51.729Z(UTC),跟用户当地差 8 小时,易误解。 */
+export function localIsoTimestamp(d = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    const padMs = (n) => String(n).padStart(3, '0');
+    return (`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}` +
+        `T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${padMs(d.getMilliseconds())}`);
+}
 /** plan id:YYYY-MM-DDTHH-mm-ss-xxxxxx(本地时间,文件名安全)。xxxxxx = 4 字节随机 hex(防同秒并发撞)。 */
 export function newPlanId(now = new Date()) {
     const pad = (n) => String(n).padStart(2, '0');
@@ -52,7 +73,7 @@ const LOG_RE = /^-\s+(\S+)\s+(.+?)\s*$/;
  * 解析成功但 step id 缺序 / 重号:按出现顺序重排为 1..N(保稳定)。
  */
 export function parsePlan(raw, fallbackId) {
-    const now = new Date().toISOString();
+    const now = localIsoTimestamp();
     let meta = {};
     let body = raw;
     const m = FRONTMATTER_RE.exec(raw);
@@ -184,9 +205,10 @@ function checkboxMarker(s) {
     }
 }
 // ── CRUD(直接落盘)──
-/** 读 plan 文件;不存在 → null,坏文件 → fallbackId 最小可用 Plan(不抛,工具契约)。 */
-export function readPlan(id) {
-    const p = planPath(id);
+/** 读 plan 文件;不存在 → null,坏文件 → fallbackId 最小可用 Plan(不抛,工具契约)。
+ *  可选 baseDir:默认 plans,传 archiveDir() 可读归档。 */
+export function readPlan(id, baseDir = plansDir()) {
+    const p = planPath(id, baseDir);
     if (!existsSync(p))
         return null;
     try {
@@ -210,9 +232,9 @@ export function writePlan(p) {
         return false;
     }
 }
-/** 删 plan 文件;不存在静默 ok。 */
-export function deletePlan(id) {
-    const p = planPath(id);
+/** 删 plan 文件;不存在静默 ok。可选 baseDir:默认 plans,传 archiveDir() 删归档。 */
+export function deletePlan(id, baseDir = plansDir()) {
+    const p = planPath(id, baseDir);
     if (!existsSync(p))
         return true;
     try {
@@ -243,33 +265,89 @@ export function updatePlan(id, mutator) {
     }
     if (next === false)
         return cur; // 无改动:返原对象
-    next.updated = new Date().toISOString();
+    next.updated = localIsoTimestamp();
     if (!writePlan(next))
         return null;
     return next;
 }
-/** 列 plans 目录下所有 plan(按 updated 倒序,最新在前)。解析失败的跳过。 */
-export function listPlans() {
-    const dir = plansDir();
-    if (!existsSync(dir))
-        return [];
-    let names;
-    try {
-        names = readdirSync(dir).filter((n) => n.endsWith('.md'));
-    }
-    catch {
-        return [];
+/** 列 plans 目录下所有 plan(按 updated 倒序,最新在前)。解析失败的跳过。
+ *  scope: 'active'(默认)=仅 plans/;'archived'=仅 archive/;'all'=合并(去重按 id)。 */
+export function listPlans(scope = 'active') {
+    const dirs = [];
+    if (scope === 'active')
+        dirs.push(plansDir());
+    else if (scope === 'archived')
+        dirs.push(archiveDir());
+    else {
+        dirs.push(plansDir());
+        dirs.push(archiveDir());
     }
     const out = [];
-    for (const n of names) {
-        const id = n.slice(0, -3);
-        const p = readPlan(id);
-        if (p)
-            out.push(p);
+    const seen = new Set();
+    for (const dir of dirs) {
+        if (!existsSync(dir))
+            continue;
+        let names;
+        try {
+            names = readdirSync(dir).filter((n) => n.endsWith('.md'));
+        }
+        catch {
+            continue;
+        }
+        for (const n of names) {
+            const id = n.slice(0, -3);
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            const p = readPlan(id, dir);
+            if (p)
+                out.push(p);
+        }
     }
     out.sort((a, b) => (a.updated < b.updated ? 1 : a.updated > b.updated ? -1 : 0));
     return out;
 }
+// ── 归档/还原/全删 ──
+/** 把 plans/<id>.md mv 到 plans/archive/<id>.md(atomic rename)。
+ *  源不存在 → false(已归档 / 删了 / 从未存在都算)。 */
+export function archivePlan(id) {
+    const src = planPath(id, plansDir());
+    if (!existsSync(src))
+        return false;
+    ensureArchiveDir();
+    const dst = planPath(id, archiveDir());
+    try {
+        renameSync(src, dst);
+    }
+    catch {
+        return false;
+    }
+    return true;
+}
+/** 把 plans/archive/<id>.md 还原到 plans/<id>.md。源不存在 → false。 */
+export function unarchivePlan(id) {
+    const src = planPath(id, archiveDir());
+    if (!existsSync(src))
+        return false;
+    ensurePlansDir();
+    const dst = planPath(id, plansDir());
+    try {
+        renameSync(src, dst);
+    }
+    catch {
+        return false;
+    }
+    return true;
+}
+/** 任一处存在就都删(活跃 + 归档)。用于 todolist delete 不关心来源。 */
+export function deletePlanAnywhere(id) {
+    let any = false;
+    if (existsSync(planPath(id, plansDir())))
+        any = deletePlan(id, plansDir()) || any;
+    if (existsSync(planPath(id, archiveDir())))
+        any = deletePlan(id, archiveDir()) || any;
+    return any;
+}
 // ── 渲染(给 LLM / UI 用)──
 /** 把 Plan 渲成给 LLM 看的紧凑摘要(多行文本)。 */
 export function renderPlanForLLM(p) {

package/dist/tools/builtins/todolist.js

@@ -6,7 +6,7 @@
 // 单 plan/会话:create 前若有 in_progress 活跃 plan → 拒绝(避免误覆盖);finish/abandoned 后可再建。
 //
 // 工具返回:把当前 plan 紧凑渲染给 LLM(不只返操作结果——让 LLM 单次调用后看到完整状态,无需再 read)。
-import { newPlanId, readPlan, writePlan, updatePlan, listPlans, renderPlanForLLM, } from '../../plan/store.js';
+import { newPlanId, readPlan, writePlan, updatePlan, listPlans, archivePlan, unarchivePlan, deletePlanAnywhere, renderPlanForLLM, localIsoTimestamp, } from '../../plan/store.js';
 import { getActivePlan, setActivePlan, hasActivePlan, clearActivePlan } from '../../plan/active.js';
 import { MAX_OUTPUT } from '../constants.js';
 const VALID_STATUS = new Set([
@@ -23,14 +23,15 @@ export const todolistTool = {
         'For complex multi-step tasks (≥3 file changes or ≥5 tool calls expected, OR user says "先计划再执行" / "plan then do"), CALL THIS FIRST to write the plan, then update each step as you go.',
         'For simple single-step tasks, skip it and just execute.',
         'Single plan per session: create refuses if an in-progress plan already exists — finish or abandon it first.',
+        'Lifecycle: finish AUTO-ARCHIVES the plan to .mocode/plans/archive/ (history preserved, active dir stays clean). To revisit, call list with scope=archived or unarchive. Use delete to permanently remove a plan (any location).',
     ].join(''),
     parameters: {
         type: 'object',
         properties: {
             action: {
                 type: 'string',
-                enum: ['create', 'read', 'update', 'add_step', 'finish'],
-                description: 'create=新计划;read=读当前活跃;update=改步骤状态;add_step=追加步骤;finish=收尾',
+                enum: ['create', 'read', 'update', 'add_step', 'finish', 'list', 'delete', 'unarchive'],
+                description: 'create=新计划;read=读当前活跃;update=改步骤状态;add_step=追加步骤;finish=收尾(自动归档);list=列计划;delete=永久删除;unarchive=从归档还原到活跃',
             },
             title: { type: 'string', description: 'create 必填:计划标题' },
             goal: { type: 'string', description: 'create 可选:目标描述(写进「目标」段)' },
@@ -55,7 +56,16 @@ export const todolistTool = {
             plan_status: {
                 type: 'string',
                 enum: ['finished', 'abandoned'],
-                description: 'finish 必填:finished=完成;abandoned=放弃(中途取消)',
+                description: 'finish 必填:finished=完成;abandoned=放弃(中途取消)。finished 触发自动归档。',
+            },
+            scope: {
+                type: 'string',
+                enum: ['active', 'archived', 'all'],
+                description: 'list 可选:范围(active=默认,仅进行中;archived=仅归档;all=全)。',
+            },
+            id: {
+                type: 'string',
+                description: 'delete / unarchive 必填:目标 plan id(list 可拿到)。',
             },
         },
         required: ['action'],
@@ -69,8 +79,11 @@ export const todolistTool = {
                 case 'update': return doUpdate(args);
                 case 'add_step': return doAddStep(args);
                 case 'finish': return doFinish(args);
+                case 'list': return doList(args);
+                case 'delete': return doDelete(args);
+                case 'unarchive': return doUnarchive(args);
                 default:
-                    return `错误:未知 action「${action}」,合法值:create / read / update / add_step / finish。`;
+                    return `错误:未知 action「${action}」,合法值:create / read / update / add_step / finish / list / delete / unarchive。`;
             }
         }
         catch (e) {
@@ -99,7 +112,7 @@ function doCreate(args) {
         return `错误:已存在进行中的 plan「${cur?.title ?? ''}」(id=${cur?.id ?? ''}),需先 finish 后再建。`;
     }
     // 旧 plan 残留(finished/abandoned)→ 允许新建,不删历史(用户可后续 read 历史 plan)
-    const now = new Date().toISOString();
+    const now = localIsoTimestamp();
     const plan = {
         id: newPlanId(),
         title,
@@ -195,7 +208,7 @@ function doFinish(args) {
     const updated = updatePlan(cur.id, (p) => {
         p.status = ps;
         p.log.push({
-            at: new Date().toISOString(),
+            at: localIsoTimestamp(),
             text: note || (ps === 'finished' ? '完成' : '放弃'),
         });
         return p;
@@ -203,14 +216,65 @@ function doFinish(args) {
     if (!updated)
         return '错误:finish 写盘失败。';
     setActivePlan(updated);
+    // finished → 自动归档到 plans/archive/(历史完整保留,活跃目录保持干净)。
+    //   abandoned → 不归档(用户想丢就丢,但仍在 plans/ 下,可显式 delete 删掉)。
+    let archived = false;
+    if (ps === 'finished') {
+        archived = archivePlan(updated.id);
+    }
     // finish 后清活跃缓存(下轮 read 自动从 in_progress 列表兜底,本会话不再「活跃」)
-    if (ps === 'abandoned')
-        clearActivePlan();
-    else {
-        // finished 也清:「活跃」专指 in_progress;finished 是历史归档
-        clearActivePlan();
+    clearActivePlan();
+    const archivedNote = ps === 'finished'
+        ? (archived ? '(已自动归档到 plans/archive/)' : '(⚠ 归档失败,plan 仍留在 plans/,可手动 list 排查)')
+        : '';
+    return `${renderSuccess('finish', updated)}\n${archivedNote}`.trimEnd();
+}
+function doList(args) {
+    const scopeRaw = String(args.scope ?? 'active');
+    const scope = scopeRaw === 'archived' || scopeRaw === 'all' ? scopeRaw : 'active';
+    const plans = listPlans(scope);
+    if (plans.length === 0) {
+        return `list: 无 ${scope === 'active' ? '进行中' : scope === 'archived' ? '已归档' : ''}plan。`;
+    }
+    // 一行一条:id | status | 标题 | 进度
+    const lines = [`list (${scope},${plans.length} 条):`];
+    for (const p of plans) {
+        const done = p.steps.filter((s) => s.status === 'done' || s.status === 'skipped').length;
+        const status = p.status === 'in_progress' ? 'live' : p.status === 'finished' ? 'done' : 'gone';
+        lines.push(`  ${p.id}  [${status}]  ${p.title}  (${done}/${p.steps.length})`);
+    }
+    return lines.join('\n');
+}
+function doDelete(args) {
+    const id = String(args.id ?? '').trim();
+    if (!id)
+        return '错误:delete 必填 id(从 list 拿)。';
+    // 安全护栏:active 状态下不能直接 delete 当前活跃(避免误删正在用的 plan)
+    const cur = getActivePlan();
+    if (cur && cur.id === id) {
+        return `错误:不能 delete 当前活跃 plan「${cur.title}」,需先 finish(自动归档)再 delete 归档副本。`;
+    }
+    const ok = deletePlanAnywhere(id);
+    if (!ok)
+        return `错误:delete 失败,id「${id}」在 plans/ 和 plans/archive/ 都找不到。`;
+    return `delete ✓: 已永久删除「${id}」(.mocode/plans/ 与 archive/ 都不再存在)。`;
+}
+function doUnarchive(args) {
+    const id = String(args.id ?? '').trim();
+    if (!id)
+        return '错误:unarchive 必填 id(从 list scope=archived 拿)。';
+    if (!unarchivePlan(id)) {
+        return `错误:unarchive 失败,id「${id}」在 plans/archive/ 找不到(可能已还原,或被 delete)。`;
+    }
+    // 还原后读一次拿回 plan 对象(若 status=in_progress 还可顺手恢复为活跃)
+    const fresh = readPlan(id);
+    if (!fresh)
+        return `unarchive ✓: 「${id}」已还原到 plans/(读取失败,但文件在)。`;
+    if (fresh.status === 'in_progress') {
+        setActivePlan(fresh);
+        return `${renderSuccess('unarchive', fresh)}\n(已自动设为活跃)。`.trimEnd();
     }
-    return renderSuccess('finish', updated);
+    return `${renderSuccess('unarchive', fresh)}\n(注:该 plan 状态为 ${fresh.status},未自动激活 —— 显式 create 才激活)`;
 }
 // ── helpers ──
 /** 从盘上找一个 in_progress plan(进程级 state 丢失/首次访问时兜底)。无 → null。 */

package/dist/ui/layout.js

@@ -774,7 +774,7 @@ function composePlanLine(status, cols) {
     if (!plan)
         return ''; // 无 plan:画空,等 paint 路径 clearLine
     // 整行左对齐,不留右段(plan 自带进度信息,不需要 cwd)
-    return `${ui.dim}│ ${ui.yellow}${plan}${ui.reset}${ui.dim}`;
+    return `${ui.yellow}${plan}${ui.reset}`;
 }
 /** 画状态行(plan 行 + spinner 行 + model 行,三行)。RUNNING 态 spinner 频繁调。
  *  行号(footerH=6):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-ai",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 16 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {