mocode-ai 1.2.7 → 1.2.9

package/dist/plan/index.js

@@ -1,33 +0,0 @@
-// plan 子系统 barrel:
-//  - store:文件级 CRUD(markdown 解析/序列化,落盘原子)
-//  - active:进程级活跃 plan 缓存 + 变更通知(单 plan/会话)
-//  - buildActivePlanSection:给 systemPrompt 用的活跃 plan 摘要段
-//
-// 被 repl 依赖(注入 systemPrompt + 状态行 + listener 注册)+ tools/builtins/todolist 依赖。
-export { 
-// store
-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';
-const ACTIVE_PLAN_HEADER = '## 当前活跃计划';
-/**
- * 拼给 systemPrompt 注入的活跃 plan 摘要段。
- *  - 无活跃 plan → 空串(repl 直接跳过拼接,systemPrompt 长度不变)。
- *  - 有 → 紧凑 markdown(目标 + 步骤 checkbox + 进度日志末 5 条),header + 内容。
- *
- * 触发:setActivePlan 后由 repl listener 调;也供 buildSystemMessage 直接同步取(repl 入口)。
- * 上限:超 MAX_ACTIVE_PLAN_CHARS 截到尾部(罕见,plan 文件本身就小)。
- */
-export function buildActivePlanSection() {
-    const p = getActivePlan();
-    if (!p)
-        return '';
-    const body = renderPlanForLLM(p);
-    const full = `${ACTIVE_PLAN_HEADER}\n${body}`;
-    if (full.length <= MAX_ACTIVE_PLAN_CHARS)
-        return full;
-    return full.slice(0, MAX_ACTIVE_PLAN_CHARS) + '\n…(plan 摘要已截断)';
-}
-/** 注入 systemPrompt 的活跃 plan 摘要上限(字符)。 */
-export const MAX_ACTIVE_PLAN_CHARS = 3000;

package/dist/plan/state.d.ts

@@ -1,2 +0,0 @@
-export type { ActivePlanSnapshot } from './active.js';
-export { getActivePlan, setActivePlan, clearActivePlan, onActivePlanChange, hasActivePlan, getActivePlanSummary, } from './active.js';

package/dist/plan/state.js

@@ -1,11 +0,0 @@
-// 活跃 plan 的进程级状态(共享叶子)。
-//
-// 职责:
-//  - 跟踪「当前会话的活跃 plan」——单 plan/会话(state 缓存,store 是文件源)。
-//  - 暴露 onActivePlanChange listener(repl 借此刷 status 行 + history[0])。
-//
-// 与 mode.ts 同形态:零依赖、不落盘、不反向引用业务;被 plan/、tools/builtins/todolist.ts、repl 依赖。
-//
-// 不在子 agent 持久化(子 agent 走 spawn,独立 history,不该继承主 plan——但 plan 文件本身在 sandboxRoot
-// 下,子 agent 仍能 readPlan 看到全部历史 plan;state 缓存不传,只属于主 agent)。
-export { getActivePlan, setActivePlan, clearActivePlan, onActivePlanChange, hasActivePlan, getActivePlanSummary, } from './active.js';

package/dist/plan/store.d.ts

@@ -1,78 +0,0 @@
-export type StepStatus = 'pending' | 'in_progress' | 'done' | 'skipped' | 'failed';
-export interface PlanStep {
-    /** 1-based 序号(在当前 plan 内稳定,即便中间 add_step 也不重用旧号——见 addStep)。 */
-    id: number;
-    title: string;
-    status: StepStatus;
-}
-export type PlanStatus = 'in_progress' | 'finished' | 'abandoned';
-export interface Plan {
-    id: string;
-    title: string;
-    status: PlanStatus;
-    created: string;
-    updated: string;
-    goal: string;
-    steps: PlanStep[];
-    /** 进度日志条目(时间戳 + 一行说明),append-only。 */
-    log: {
-        at: string;
-        text: string;
-    }[];
-}
-/** plans 目录:<sandboxRoot>/.mocode/plans/。无 sandboxRoot 退到 cwd(防御)。 */
-export declare function plansDir(): string;
-/** 归档目录:<root>/.mocode/plans/archive/。finish 自动归档、用户手动 unarchive 都走这里。 */
-export declare function archiveDir(): string;
-/** 单 plan 文件路径:<root>/.mocode/plans/<id>.md。可选 baseDir:默认 plans,也可指 archive。 */
-export declare function planPath(id: string, baseDir?: string): string;
-/** 确保 plans 目录存在(惰性,工具每次写前调)。 */
-export declare function ensurePlansDir(): void;
-/** 确保归档目录存在(惰性)。 */
-export declare function ensureArchiveDir(): void;
-/** 本地时间戳(无时区后缀),与 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 declare function localIsoTimestamp(d?: Date): string;
-/** plan id:YYYY-MM-DDTHH-mm-ss-xxxxxx(本地时间,文件名安全)。xxxxxx = 4 字节随机 hex(防同秒并发撞)。 */
-export declare function newPlanId(now?: Date): string;
-/**
- * 解析 plan 文件为 Plan 对象。失败(无 frontmatter / 段缺失 / 坏 checkbox)→ 退化:
- *  - 无 frontmatter:把整文当 title 段
- *  - 缺字段:空串 / 空数组
- *  - 坏 checkbox:跳过该行,不污染好行
- * 解析成功但 step id 缺序 / 重号:按出现顺序重排为 1..N(保稳定)。
- */
-export declare function parsePlan(raw: string, fallbackId: string): Plan;
-/** 序列化为 markdown 文本。固定段序:frontmatter → 目标 → 步骤 → 进度日志。 */
-export declare function serializePlan(p: Plan): string;
-/** 读 plan 文件;不存在 → null,坏文件 → fallbackId 最小可用 Plan(不抛,工具契约)。
- *  可选 baseDir:默认 plans,传 archiveDir() 可读归档。 */
-export declare function readPlan(id: string, baseDir?: string): Plan | null;
-/** 写 plan 文件(atomic:写 .tmp 再 rename)。返回是否成功。 */
-export declare function writePlan(p: Plan): boolean;
-/** 删 plan 文件;不存在静默 ok。可选 baseDir:默认 plans,传 archiveDir() 删归档。 */
-export declare function deletePlan(id: string, baseDir?: string): boolean;
-/**
- * 原子读-改-写:读 → mutator 改 → 写。mutator 返回 false 视为"无改动",跳过写。
- * mutator 抛错 → 写失败 → 返 null(不抛,工具契约)。
- *
- * mutator 同步:本 store 走同步 fs,mutator 必须同步(返 Promise 视为"无信号"——返原对象);
- *  设计如此以避免把 fs API 改成 async(同步 fs 在 node 单 tick 原子,无需锁)。
- */
-export declare function updatePlan(id: string, mutator: (p: Plan) => Plan | false): Plan | null;
-/** 列 plans 目录下所有 plan(按 updated 倒序,最新在前)。解析失败的跳过。
- *  scope: 'active'(默认)=仅 plans/;'archived'=仅 archive/;'all'=合并(去重按 id)。 */
-export declare function listPlans(scope?: 'active' | 'archived' | 'all'): Plan[];
-/** 把 plans/<id>.md mv 到 plans/archive/<id>.md(atomic rename)。
- *  源不存在 → false(已归档 / 删了 / 从未存在都算)。 */
-export declare function archivePlan(id: string): boolean;
-/** 把 plans/archive/<id>.md 还原到 plans/<id>.md。源不存在 → false。 */
-export declare function unarchivePlan(id: string): boolean;
-/** 任一处存在就都删(活跃 + 归档)。用于 todolist delete 不关心来源。 */
-export declare function deletePlanAnywhere(id: string): boolean;
-/** 把 Plan 渲成给 LLM 看的紧凑摘要(多行文本)。 */
-export declare function renderPlanForLLM(p: Plan): string;
-export declare function renderPlanChip(p: Plan | null, maxWidth?: number): string;

package/dist/plan/store.js

@@ -1,429 +0,0 @@
-// 单 plan 的文件级存储:CRUD + markdown 解析/序列化。
-//
-// 设计目标
-//  - 文件是唯一事实源(抗压缩、可视化、用户可改)。每次写都 atomic(rename 覆盖)。
-//  - 同会话单 plan(state.ts 跟踪「活跃」,本模块不参与并发控制——单进程单活跃 plan 串行调用)。
-//  - 解析宽松:坏 frontmatter / 缺段 → 退化到最小可用 Plan,不抛。
-//  - 序列化稳定:每段顺序固定(frontmatter → 目标 → 步骤 → 进度日志),便于 git diff 友好。
-//
-// 不依赖 agent / ui / llm;仅 node:fs + node:path。仿 memory/store.ts 的「叶子」分层。
-import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { getSandboxRoot } from '../sandbox/root.js';
-// ── 路径 ──
-/** plans 目录:<sandboxRoot>/.mocode/plans/。无 sandboxRoot 退到 cwd(防御)。 */
-export function plansDir() {
-    const root = getSandboxRoot() ?? process.cwd();
-    return join(root, '.mocode', 'plans');
-}
-/** 归档目录:<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() {
-    const d = plansDir();
-    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');
-    const y = now.getFullYear();
-    const mo = pad(now.getMonth() + 1);
-    const d = pad(now.getDate());
-    const h = pad(now.getHours());
-    const mi = pad(now.getMinutes());
-    const s = pad(now.getSeconds());
-    // crypto 不必要;Math.random 够防同秒撞(碰撞概率 ~1/2^32)
-    const r = Math.floor(Math.random() * 0xffffffff).toString(16).padStart(8, '0');
-    return `${y}-${mo}-${d}T${h}-${mi}-${s}-${r}`;
-}
-// ── 解析(宽松,坏文件不抛,退化到最小可用 Plan)──
-const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
-const CHECKBOX_RE = /^(\s*)-\s+\[([ xX\/~])\]\s+(\d+)\.\s+(.+?)\s*$/;
-const LOG_RE = /^-\s+(\S+)\s+(.+?)\s*$/;
-/**
- * 解析 plan 文件为 Plan 对象。失败(无 frontmatter / 段缺失 / 坏 checkbox)→ 退化:
- *  - 无 frontmatter:把整文当 title 段
- *  - 缺字段:空串 / 空数组
- *  - 坏 checkbox:跳过该行,不污染好行
- * 解析成功但 step id 缺序 / 重号:按出现顺序重排为 1..N(保稳定)。
- */
-export function parsePlan(raw, fallbackId) {
-    const now = localIsoTimestamp();
-    let meta = {};
-    let body = raw;
-    const m = FRONTMATTER_RE.exec(raw);
-    if (m) {
-        meta = parseFrontmatter(m[1]);
-        body = m[2];
-    }
-    const id = meta.id || fallbackId;
-    const title = meta.title || extractFirstHeading(body) || '(无标题)';
-    const status = normalizePlanStatus(meta.status);
-    const created = meta.created || now;
-    const updated = meta.updated || now;
-    const { goal, steps, log } = parseBody(body);
-    // 步骤 id 规范化:1..N(防文件手改致 id 跳号)
-    const normSteps = steps.map((s, i) => ({ ...s, id: i + 1 }));
-    return { id, title, status, created, updated, goal, steps: normSteps, log };
-}
-function parseFrontmatter(s) {
-    const out = {};
-    for (const line of s.split('\n')) {
-        const idx = line.indexOf(':');
-        if (idx <= 0)
-            continue;
-        const k = line.slice(0, idx).trim();
-        const v = line.slice(idx + 1).trim();
-        if (k)
-            out[k] = v;
-    }
-    return out;
-}
-function normalizePlanStatus(s) {
-    if (s === 'finished' || s === 'abandoned')
-        return s;
-    return 'in_progress';
-}
-function extractFirstHeading(body) {
-    const m = /^#\s+(.+?)\s*$/m.exec(body);
-    return m ? m[1] : '';
-}
-function parseBody(body) {
-    const sections = {};
-    const re = /^##\s+(.+?)\s*$/gm;
-    let lastKey = '';
-    let lastStart = -1;
-    let m;
-    while ((m = re.exec(body)) !== null) {
-        if (lastKey)
-            sections[lastKey] = body.slice(lastStart, m.index);
-        lastKey = m[1].trim();
-        lastStart = m.index + m[0].length;
-    }
-    if (lastKey)
-        sections[lastKey] = body.slice(lastStart);
-    const goal = (sections['目标'] || sections['Goal'] || '').trim();
-    const stepBlock = sections['步骤'] || sections['Steps'] || '';
-    const logBlock = sections['进度日志'] || sections['Log'] || sections['进度'] || '';
-    const steps = [];
-    for (const line of stepBlock.split('\n')) {
-        const cm = CHECKBOX_RE.exec(line);
-        if (!cm)
-            continue;
-        const marker = cm[2].toLowerCase();
-        const status = marker === 'x' ? 'done' :
-            marker === '/' ? 'in_progress' :
-                marker === '~' ? 'skipped' :
-                    'pending';
-        const id = Number(cm[3]);
-        const title = cm[4].trim();
-        if (!Number.isFinite(id) || id < 1)
-            continue;
-        steps.push({ id, title, status });
-    }
-    const log = [];
-    for (const line of logBlock.split('\n')) {
-        const lm = LOG_RE.exec(line);
-        if (!lm)
-            continue;
-        log.push({ at: lm[1], text: lm[2] });
-    }
-    return { goal, steps, log };
-}
-// ── 序列化 ──
-/** 序列化为 markdown 文本。固定段序:frontmatter → 目标 → 步骤 → 进度日志。 */
-export function serializePlan(p) {
-    const lines = [];
-    lines.push('---');
-    lines.push(`id: ${p.id}`);
-    lines.push(`title: ${p.title}`);
-    lines.push(`status: ${p.status}`);
-    lines.push(`created: ${p.created}`);
-    lines.push(`updated: ${p.updated}`);
-    lines.push('---');
-    lines.push('');
-    lines.push(`# ${p.title}`);
-    lines.push('');
-    lines.push('## 目标');
-    lines.push(p.goal || '(未填写)');
-    lines.push('');
-    lines.push('## 步骤');
-    if (p.steps.length === 0) {
-        lines.push('(无步骤)');
-    }
-    else {
-        for (const s of p.steps) {
-            lines.push(`- [${checkboxMarker(s.status)}] ${s.id}. ${s.title}`);
-        }
-    }
-    lines.push('');
-    lines.push('## 进度日志');
-    if (p.log.length === 0) {
-        lines.push('(无)');
-    }
-    else {
-        for (const e of p.log) {
-            lines.push(`- ${e.at} ${e.text}`);
-        }
-    }
-    lines.push('');
-    return lines.join('\n');
-}
-function checkboxMarker(s) {
-    switch (s) {
-        case 'done': return 'x';
-        case 'in_progress': return '/';
-        case 'skipped': return '~';
-        case 'failed': return 'x'; // 用 x + log 标 failed(checkbox 集 [ ]/x/[x] 之外的细态不上,降级)
-        case 'pending':
-        default: return ' ';
-    }
-}
-// ── CRUD(直接落盘)──
-/** 读 plan 文件;不存在 → null,坏文件 → fallbackId 最小可用 Plan(不抛,工具契约)。
- *  可选 baseDir:默认 plans,传 archiveDir() 可读归档。 */
-export function readPlan(id, baseDir = plansDir()) {
-    const p = planPath(id, baseDir);
-    if (!existsSync(p))
-        return null;
-    try {
-        return parsePlan(readFileSync(p, 'utf8'), id);
-    }
-    catch {
-        return null;
-    }
-}
-/** 写 plan 文件(atomic:写 .tmp 再 rename)。返回是否成功。 */
-export function writePlan(p) {
-    try {
-        ensurePlansDir();
-        const target = planPath(p.id);
-        const tmp = target + '.tmp';
-        writeFileSync(tmp, serializePlan(p), 'utf8');
-        renameSync(tmp, target);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** 删 plan 文件;不存在静默 ok。可选 baseDir:默认 plans,传 archiveDir() 删归档。 */
-export function deletePlan(id, baseDir = plansDir()) {
-    const p = planPath(id, baseDir);
-    if (!existsSync(p))
-        return true;
-    try {
-        unlinkSync(p);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * 原子读-改-写:读 → mutator 改 → 写。mutator 返回 false 视为"无改动",跳过写。
- * mutator 抛错 → 写失败 → 返 null(不抛,工具契约)。
- *
- * mutator 同步:本 store 走同步 fs,mutator 必须同步(返 Promise 视为"无信号"——返原对象);
- *  设计如此以避免把 fs API 改成 async(同步 fs 在 node 单 tick 原子,无需锁)。
- */
-export function updatePlan(id, mutator) {
-    const cur = readPlan(id);
-    if (!cur)
-        return null;
-    let next;
-    try {
-        next = mutator(cur);
-    }
-    catch {
-        return null;
-    }
-    if (next === false)
-        return cur; // 无改动:返原对象
-    next.updated = localIsoTimestamp();
-    if (!writePlan(next))
-        return null;
-    return next;
-}
-/** 列 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 = [];
-    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) {
-    const lines = [];
-    lines.push(`# ${p.title} [${p.status}]`);
-    if (p.goal)
-        lines.push(`\n## 目标\n${p.goal}`);
-    const done = p.steps.filter((s) => s.status === 'done' || s.status === 'skipped').length;
-    lines.push(`\n## 步骤 (${done}/${p.steps.length} 完成)`);
-    if (p.steps.length === 0) {
-        lines.push('(无)');
-    }
-    else {
-        for (const s of p.steps) {
-            lines.push(`- [${checkboxMarker(s.status)}] ${s.id}. ${s.title}`);
-        }
-    }
-    if (p.log.length > 0) {
-        lines.push(`\n## 进度日志(最近 ${Math.min(p.log.length, 5)} 条)`);
-        for (const e of p.log.slice(-5))
-            lines.push(`- ${e.at} ${e.text}`);
-    }
-    return lines.join('\n');
-}
-/**
- * 状态行 chip 的短摘要:`plan: 标题 (done/total) ▸ <当前 in_progress 步骤>`。
- * 无活跃 plan → 空串。
- *
- * 字符截断(非终端宽,固定长度 ~50 字符,方便状态行收纳):
- *  - 标题(plan 标题):超 10 字截断,加 "..."
- *  - 步骤标题:超 17 字截断,加 "..."
- *  - 例:`plan: 3D 贪吃蛇游戏 (0/9) ▸ 1. 搭建项目骨架:创建 snake3d...`
- *
- * 当前步骤取 status=in_progress;无 in_progress 但有 pending 时回退到第一项 pending
- * (LLM 刚标记某步 done 还没动 next 时,这样能看清下一步)。
- * 全 done → 不带 tail;finished → 拼「✓ N/N」。
- *
- * maxWidth 是软上限:极端窄(<26)时只保 head+count 不带 tail;否则按上述字符限。
- */
-const PLAN_TITLE_MAX = 10;
-const STEP_TITLE_MAX = 17;
-const TRUNC_DOTS = '...';
-export function renderPlanChip(p, maxWidth = 56) {
-    if (!p)
-        return '';
-    const title = truncateByChars(p.title, PLAN_TITLE_MAX);
-    const head = p.status === 'finished'
-        ? `plan ✓ ${title}`
-        : `plan: ${title}`;
-    const total = p.steps.length;
-    const done = p.steps.filter((s) => s.status === 'done' || s.status === 'skipped').length;
-    const count = `(${done}/${total})`;
-    const fixed = `${head} ${count}`;
-    // 极窄:没空间塞步骤,只保 head+count
-    if (maxWidth < 26)
-        return fixed;
-    const cur = p.status === 'in_progress'
-        ? p.steps.find((s) => s.status === 'in_progress')
-            ?? p.steps.find((s) => s.status === 'pending')
-        : null; // finished / abandoned → 不显当前步
-    if (!cur)
-        return fixed;
-    const stepTitle = truncateByChars(cur.title, STEP_TITLE_MAX);
-    return `${fixed} ▸ ${cur.id}. ${stepTitle}`;
-}
-/** 字符数截断(非显示宽):超 max 字符截到 max + "..."(3 字符省略号固定)。
- *  <= max → 原样返回;> max → 前 max 字符 + "..."。 */
-function truncateByChars(s, max) {
-    if (s.length <= max)
-        return s;
-    return s.slice(0, max) + TRUNC_DOTS;
-}
-function truncateForChip(s, max = 18) {
-    if (s.length <= max)
-        return s;
-    if (max <= 1)
-        return '…';
-    return s.slice(0, max - 1) + '…';
-}

package/dist/project-skill/index.js

@@ -1,95 +0,0 @@
-/**
- * 项目专属 Skill — 跨 session 持久化的项目开发知识。
- *
- * 每个项目可维护一个专属 skill 文件(.mocode/project-skill.md)，
- * 记录开发约定、架构决策、常见坑点等。开关启用后:
- *   1. 每次启动时内容注入系统提示词(buildProjectSkillSection)
- *   2. Agent 可通过 project_skill_update 工具动态更新
- *   3. 随着项目开发，skill 越来越了解项目，开发效率越来越高
- *
- * 存储位置: <cwd>/.mocode/project-skill.md
- * 开关: MOCODE_PROJECT_SKILL 环境变量，默认 false(零侵入)
- *
- * 与现有功能的关系:
- *   - 通用 skill(SKILLS_DIRS): 按需加载(use_skill);项目 skill: 始终注入
- *   - memory: 碎片化 fact/decision; 项目 skill: 结构化知识总结
- *   - snapshot: 静态文件缓存(只读); 项目 skill: 动态知识(可写)
- */
-import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from 'node:fs';
-import path from 'node:path';
-/** 项目 skill 文件路径 */
-function skillPath() {
-    return path.join(process.cwd(), '.mocode', 'project-skill.md');
-}
-/** 备份文件路径 */
-function backupPath() {
-    return path.join(process.cwd(), '.mocode', 'project-skill.md.bak');
-}
-/** 读取项目 skill 内容。不存在/读失败 → null */
-export function readProjectSkill() {
-    const p = skillPath();
-    if (!existsSync(p))
-        return null;
-    try {
-        const content = readFileSync(p, 'utf8').trim();
-        return content || null;
-    }
-    catch {
-        return null;
-    }
-}
-/** 写入/更新项目 skill。内容不设字符上限；写入前备份旧内容。 */
-export function writeProjectSkill(content) {
-    const trimmed = content.trim();
-    const p = skillPath();
-    const dir = path.dirname(p);
-    try {
-        if (existsSync(p)) {
-            copyFileSync(p, backupPath());
-        }
-        mkdirSync(dir, { recursive: true });
-        writeFileSync(p, trimmed + '\n', 'utf8');
-        return { ok: true };
-    }
-    catch (e) {
-        return { ok: false, error: `写入失败: ${e.message}` };
-    }
-}
-/** 追加内容到项目 skill 末尾(以 \n\n 分隔)，内容不设字符上限。 */
-export function appendProjectSkill(addition) {
-    const existing = readProjectSkill() ?? '';
-    const trimmed = addition.trim();
-    if (!trimmed)
-        return { ok: false, error: '追加内容为空' };
-    const separator = existing ? '\n\n' : '';
-    return writeProjectSkill(existing + separator + trimmed);
-}
-/** 兼容旧调用名：字数限制取消后直接写入，不再调用 LLM 压缩。 */
-export async function writeProjectSkillWithCompression(content, _maxAttempts = 3, _signal) {
-    return { ...writeProjectSkill(content), compressed: false };
-}
-/** 兼容旧调用名：字数限制取消后直接追加，不再调用 LLM 压缩。 */
-export async function appendProjectSkillWithCompression(addition, _maxAttempts = 3, _signal) {
-    return { ...appendProjectSkill(addition), compressed: false };
-}
-/**
- * 生成系统提示词注入段。
- * 开关关闭或文件不存在 → 空串(零行为变化)。
- *
- * 精简版：只注入 skill 内容本身，维护指南移到 project_skill_update 工具描述中。
- */
-export function buildProjectSkillSection() {
-    const content = readProjectSkill();
-    if (!content)
-        return '';
-    return [
-        '',
-        '',
-        '## Project Skill (project-specific knowledge)',
-        'The following is project-specific knowledge maintained across sessions. Use it as context for all tasks in this project.',
-        '',
-        '<project-skill>',
-        content,
-        '</project-skill>',
-    ].join('\n');
-}