mocode-ai 1.2.5 → 1.2.7

package/dist/skills/stats.js

@@ -0,0 +1,102 @@
+// skill 使用台账(自进化 Phase 0)。
+// 为什么不在 trace.jsonl 上做:工具事件出于隐私只存参数指纹(sha256/keys,
+// trace-sanitize.ts 刻意不存值),拿不到 skill name。台账因此在工具层直接记录——
+// use_skill / run_skill 是唯一知道真实 skill name 的落点。
+//
+// 落盘:<cwd>/.mocode/skill-stats.jsonl(append-only JSONL,每行一次使用)。
+// 纯观测:任何写失败静默吞掉,绝不阻断 agent 主流程(风格对齐 session/trace.ts)。
+// 聚合是纯函数(aggregateSkillStats),吃记录数组吐按 skill 的计数,便于单测。
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * 台账路径(项目级,与 sessions 同根;使用是项目上下文相关的,不写全局)。
+ * baseDir 可选:测试指向临时目录用;缺省 process.cwd()。
+ */
+export function skillStatsPath(baseDir = process.cwd()) {
+    return path.join(baseDir, '.mocode', 'skill-stats.jsonl');
+}
+/**
+ * 追加一条台账记录;任何失败静默(观测不得阻断主流程)。
+ * MOCODE_SKILL_EVAL=1(触发评测进程内设置)时跳过:评测里的人工构造调用
+ * 是测量手段不是真实使用,记入会污染自进化的输入信号。
+ */
+export function recordSkillUsage(rec, baseDir = process.cwd()) {
+    if (process.env.MOCODE_SKILL_EVAL === '1')
+        return;
+    try {
+        const p = skillStatsPath(baseDir);
+        const dir = path.dirname(p);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        appendFileSync(p, JSON.stringify(rec) + '\n', 'utf8');
+    }
+    catch {
+        // 观测失败静默
+    }
+}
+/** 读取台账原始记录;文件不存在 / 单行损坏 → 跳过(不抛)。 */
+export function loadSkillUsage(baseDir = process.cwd()) {
+    try {
+        const content = readFileSync(skillStatsPath(baseDir), 'utf8');
+        const out = [];
+        for (const line of content.split('\n')) {
+            const s = line.trim();
+            if (!s)
+                continue;
+            try {
+                const v = JSON.parse(s);
+                if (v && typeof v.skill === 'string' && (v.kind === 'use' || v.kind === 'run')) {
+                    out.push(v);
+                }
+            }
+            catch {
+                // 损坏行跳过
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 纯聚合:记录 → 按 skill 的计数视图。按 skill 名分组(大小写敏感),
+ * lastUsedAt 取 ts 字符串字典序最大(ISO 时间戳字典序 == 时间序)。
+ * 输入乱序也安全。空输入返回 []。
+ */
+export function aggregateSkillStats(records) {
+    const bySkill = new Map();
+    for (const r of records) {
+        const list = bySkill.get(r.skill);
+        if (list)
+            list.push(r);
+        else
+            bySkill.set(r.skill, [r]);
+    }
+    const out = [];
+    for (const [skill, list] of bySkill) {
+        const runs = list.filter((r) => r.kind === 'run');
+        const runSuccess = runs.filter((r) => r.status === 'success').length;
+        let lastFailure = null;
+        let lastUsedAt = '';
+        for (const r of list) {
+            if (typeof r.ts === 'string' && r.ts > lastUsedAt)
+                lastUsedAt = r.ts;
+            if (r.status !== 'success' && (!lastFailure || r.ts > lastFailure.ts)) {
+                lastFailure = { ts: r.ts, status: r.status, code: r.code };
+            }
+        }
+        out.push({
+            skill,
+            total: list.length,
+            uses: list.length - runs.length,
+            runs: runs.length,
+            runSuccessRate: runs.length ? runSuccess / runs.length : null,
+            lastFailure,
+            lastUsedAt,
+        });
+    }
+    // 按最近使用倒序,让 /skills 徽标与人工浏览都「最活跃的在前」。
+    out.sort((a, b) => (a.lastUsedAt < b.lastUsedAt ? 1 : a.lastUsedAt > b.lastUsedAt ? -1 : 0));
+    return out;
+}

package/dist/tools/builtins/index.js

@@ -14,6 +14,7 @@ import { useSkillTool } from './use-skill.js';
 import { runSkillTool } from './run-skill.js';
 import { askHumanTool } from './ask-human.js';
 import { planUpdateTool } from './plan-update.js';
+import { noteAppendTool } from './note-append.js';
 import { memorySaveTool } from './memory-save.js';
 import { memorySearchTool } from './memory-search.js';
 import { memoryListTool } from './memory-list.js';
@@ -68,6 +69,8 @@ const CAPABILITIES = {
     // plan_update 只写内部 notes.md(session 工作面),不作为用户代码 mutation 追踪/回滚/diff;
     // 串行即可(调用不频繁),固定资源键让并发调用排队。
     plan_update: { effect: 'write', concurrency: 'serial', resources: () => ['session-notepad'] },
+    // note_append 与 plan_update 同款:只写内部 notes.md 笔记段,不作 project mutation 追踪/diff/回滚;串行 + 固定资源键排队。
+    note_append: { effect: 'write', concurrency: 'serial', resources: () => ['session-notepad'] },
     memory_save: { effect: 'write', concurrency: 'serial', resources: memoryResource },
     memory_search: { effect: 'write', concurrency: 'serial', resources: memoryResource },
     memory_list: { effect: 'read', concurrency: 'serial', resources: memoryResource },
@@ -103,6 +106,7 @@ const rawBuiltinTools = [
     runSkillTool,
     askHumanTool,
     planUpdateTool,
+    noteAppendTool,
     ..._memoryTools,
     subAgentTool,
 ];

package/dist/tools/builtins/note-append.js

@@ -0,0 +1,103 @@
+import { appendNoteToSection, NOTE_SECTION_KEYS } from '../../session/notes.js';
+/**
+ * note_append:往会话笔记 notes.md 的预设笔记段追加一条 finding/decision/
+ * open_question/risk。与 plan_update 的边界:
+ *  - plan_update 维护执行计划(步骤进度),写 `## Plan:` 段;
+ *  - note_append 记发现/决策/问题/风险,写 `## Findings` 等笔记段。
+ * 写入的笔记正文会由 reinject 注入 system prompt 并常驻(5k token 预算内),
+ * compact 后仍可恢复——构成单会话永久记忆。与 memory_* 的边界:
+ *  - note_append 记本会话内、抗 compact 的笔记;
+ *  - memory_* 记跨会话稳定事实(另一系统,默认关)。
+ *
+ * 仿 plan_update:risk=safe,免权限/免 diff/免回滚;capabilities 由 builtins/index.ts
+ * 声明为 session-notepad 资源串行(与 plan_update 同款)。
+ */
+function err(message) {
+    return { status: 'error', code: 'INVALID_ARGUMENTS', retryable: false, output: `错误:${message}` };
+}
+/** 归一化 section:兼容单复数、下划线/空格/连字符、大小写偏差。 */
+function normalizeSection(raw) {
+    const s = String(raw ?? '').trim().toLowerCase().replace(/[-\s]+/g, '_');
+    if (NOTE_SECTION_KEYS.includes(s))
+        return s;
+    // 单数/别名归一
+    if (['finding', 'find', 'insight', 'insights'].includes(s))
+        return 'findings';
+    if (['decision', 'decide', 'choice', 'choices'].includes(s))
+        return 'decisions';
+    if (['open_question', 'question', 'questions', 'openquestion', 'openquestions'].includes(s))
+        return 'open_questions';
+    if (['risk', 'hazard', 'caveat', 'caveats'].includes(s))
+        return 'risks';
+    return null;
+}
+export const noteAppendTool = {
+    name: 'note_append',
+    description: 'Append a decision-grade note (a finding, decision, open question, or risk) to the session notepad ' +
+        '(`.mocode/sessions/<id>/notes.md`) so it survives context compaction and stays resident in the prompt. ' +
+        'Use this for NON-OBVIOUS, lasting-value discoveries — subtle constraints, decisions with downstream impact, ' +
+        'open questions that block a choice, or risks that affect later steps. Do NOT use it for routine progress ' +
+        '(that is the plan via `plan_update`) or for stable cross-session facts (that is `memory_save`). ' +
+        'Notes you write here persist across compaction within this session and are re-injected into the prompt ' +
+        'automatically, so the agent keeps remembering what it found/decided. Call it the moment you make the ' +
+        'discovery or decision — do not batch to the end.',
+    risk: 'safe',
+    parameters: {
+        type: 'object',
+        properties: {
+            section: {
+                type: 'string',
+                enum: NOTE_SECTION_KEYS,
+                description: 'Note category: findings (a non-obvious discovery/constraint), decisions (a choice with ' +
+                    'lasting impact), open_questions (a blocker needing resolution), risks (a hazard affecting later work).',
+            },
+            entry: {
+                type: 'string',
+                description: 'The note text. One concise, self-contained item: what was found/decided and why it matters. ' +
+                    'Keep each call to one item — call again for a second item.',
+            },
+            tag: {
+                type: 'string',
+                description: 'Optional short label for grouping (e.g. "parser-bug", "api-shape"). Rendered as **[tag]**.',
+            },
+        },
+        required: ['section', 'entry'],
+        additionalProperties: false,
+    },
+    // 兼容模型的 section 命名偏差:单复数/分隔符/别名归一到预设 key。
+    normalizeArguments(args) {
+        const s = normalizeSection(args.section);
+        if (s)
+            args.section = s;
+        if (typeof args.tag === 'string')
+            args.tag = args.tag.trim();
+    },
+    async execute(args) {
+        const section = normalizeSection(args.section);
+        if (!section) {
+            return err(`section 非法:"${String(args.section ?? '')}"(仅 ${NOTE_SECTION_KEYS.join('/')} 或常见别名)。`);
+        }
+        const entry = String(args.entry ?? '').trim();
+        if (!entry)
+            return err('entry 不能为空。');
+        if (entry.length > 2000) {
+            return err(`entry 过长(${entry.length} 字符,上限 2000)——拆成多条 note_append 或精简。`);
+        }
+        const tag = typeof args.tag === 'string' && args.tag.trim() ? args.tag.trim() : undefined;
+        const result = appendNoteToSection(section, entry, tag);
+        if ('error' in result) {
+            return { status: 'error', code: 'EXECUTION_ERROR', retryable: false, output: `错误:写入 notes.md 失败: ${result.error}` };
+        }
+        // note_append 写内部 notes.md,不作为用户代码 mutation 上报 changedFiles(与 plan_update 一致)。
+        const titleMap = {
+            findings: 'Findings', decisions: 'Decisions', open_questions: 'Open Questions', risks: 'Risks',
+        };
+        const rendered = tag ? `- **[${tag}]** ${entry}` : `- ${entry}`;
+        return {
+            status: 'success',
+            code: 'OK',
+            retryable: false,
+            output: `已追加笔记到 ## ${titleMap[section]} 段(将常驻 prompt,抗 compact):\n${rendered}`,
+        };
+    },
+};

package/dist/tools/registry.js

@@ -11,6 +11,11 @@ import { isToolErrorOutput } from './result.js';
  */
 const extensions = new Map();
 export const tools = [...builtinTools];
+/** 名字 → 工具 的 O(1) 索引，与 tools 数组在每次 rebuild 时同步重建；findTool 走此索引。 */
+let toolIndex = buildToolIndex(tools);
+function buildToolIndex(list) {
+    return new Map(list.map((tool) => [tool.name, tool]));
+}
 export function registerToolsExtension(sourceOrAdditions, maybeAdditions) {
     const source = typeof sourceOrAdditions === 'string' ? sourceOrAdditions : 'external';
     const additions = typeof sourceOrAdditions === 'string' ? (maybeAdditions ?? []) : sourceOrAdditions;
@@ -35,13 +40,14 @@ function rebuildTools() {
         next.push(tool);
     }
     tools.splice(0, tools.length, ...next);
+    toolIndex = buildToolIndex(next);
 }
 const DEFAULT_CAPABILITIES = Object.freeze({
     effect: 'unknown',
     concurrency: 'serial',
 });
 export function findTool(name) {
-    return tools.find((tool) => tool.name === name);
+    return toolIndex.get(name);
 }
 /** 缺少声明或找不到工具时返回保守能力，绝不把未知扩展并发执行。 */
 export function getToolCapabilities(toolOrName) {
@@ -58,10 +64,13 @@ export function getToolResourceKeys(toolOrName, args) {
     }
 }
 /** resource-locked write 是可生成文件 diff/按路径记 rollback 的文件 mutation。 */
-export function isFileMutationTool(name) {
-    const capabilities = getToolCapabilities(name);
+export function isFileMutationCapabilities(capabilities) {
     return capabilities.effect === 'write' && capabilities.concurrency === 'resource-locked';
 }
+/** 按工具名判定(兼容入口);热路径请直接复用已解析的 capabilities 走 isFileMutationCapabilities。 */
+export function isFileMutationTool(name) {
+    return isFileMutationCapabilities(getToolCapabilities(name));
+}
 function isStructuredOutcome(value) {
     return typeof value === 'object' && value !== null &&
         typeof value.status === 'string' && typeof value.code === 'string' &&
@@ -144,7 +153,7 @@ async function executeToolOnce(tool, args, signal, opts) {
             mutationVersionBefore = mutationBefore.version;
             // Transactional tools own their full write-set capture inside ChangeSet commit.
             const pathCapture = !capabilities.delegatesResourceLocks &&
-                isFileMutationTool(tool.name) && typeof args.path === 'string' && args.path
+                isFileMutationCapabilities(capabilities) && typeof args.path === 'string' && args.path
                 ? beginPathMutation(args.path)
                 : null;
             capturedPath = pathCapture?.path;
@@ -211,7 +220,11 @@ export async function executeToolOutcome(name, argsRaw, signal, opts) {
     }
     const validation = validateToolArguments(tool, parsed);
     if (!validation.valid) {
-        return terminalOutcome('error', validation.code, `错误:工具 ${name} 参数无效: ${validation.message}`, startedAt);
+        const hint = opts?.argumentErrorHint?.trim();
+        const message = hint
+            ? `错误:工具 ${name} 参数无效: ${validation.message}\n${hint}`
+            : `错误:工具 ${name} 参数无效: ${validation.message}`;
+        return terminalOutcome('error', validation.code, message, startedAt);
     }
     const args = parsed;
     const sandboxError = enforceSandbox(name, args);

package/dist/ui/diff.js

@@ -254,7 +254,7 @@ export function renderFileChange(opts) {
 /** 头行 + 计数行 + 正文(折叠 + 截断 + 行号),每行尾 \n。 */
 function renderBody(head, counts, items, padW, startLine, lang) {
     const lines = [head, counts];
-    const metaPrefix = `${BODY_INDENT}${' '.repeat(padW)}   `; // 对齐到代码列(num + 空格 + gutter + 空格)
+    const metaPrefix = `${BODY_INDENT}`; // 与正文行左对齐(batch 展开时还会再加外层 indent,避免双重缩进导致提示行突兀)
     let oldLine = startLine;
     let newLine = startLine;
     let shown = 0;

package/dist/ui/layout.js

@@ -671,6 +671,17 @@ export function contentDeleteFrom(startIdx, n) {
 export function totalRows() {
     return content.totalRows();
 }
+/** 缓冲尾部(已提交行)是否已经是空白行(去掉 ANSI 后无可见字符)。
+ *  供 compact 等在 step 循环顶部写通知行前判断是否需要补空行分隔。 */
+export function isLastContentRowBlank() {
+    const committed = content.committedRows();
+    if (committed === 0)
+        return false;
+    const line = content.lineAt(committed - 1);
+    if (line === null)
+        return false;
+    return line.replace(/\x1b\[[0-9;]*m/g, '').trim().length === 0;
+}
 /** 正文→mutation 首摘要前，把尾部间距强制归一为一条视觉空行。 */
 export function normalizeMutationBoundary() {
     if (!active || !ui.isTTY)
@@ -1936,7 +1947,7 @@ function renderDimInputRow(prompt, text, placeholder, cols) {
 /**
  * 单行运行态滑窗:以光标为中心,向左右扩展填满 contentW-1(留 1 cell 给光标),
  * 返回可见子串与光标在子串内的显示列。保证光标恒可见,且不软折行(运行态输入框恒单行,
- * 不触发 setRegion/ED,避免流式期间底栏抖动——见 scripts/check-layout.ts 断言)。
+ * 不触发 setRegion/ED,避免流式期间底栏抖动)。
  */
 function windowSingleLine(text, cursor, contentW) {
     const n = text.length;

package/dist/ui/render.js

@@ -2,7 +2,13 @@ import { stdout } from 'node:process';
 import { createRequire } from 'node:module';
 import { ui } from './theme.js';
 import { t } from '../i18n/index.js';
-const VERSION = createRequire(import.meta.url)('../../package.json').version;
+let VERSION = '0.0.0';
+try {
+    VERSION = createRequire(import.meta.url)('../../package.json').version;
+}
+catch {
+    // 非标准布局(测试编译产物、自定义打包)不含 package.json:版本号回落,不阻断模块加载。
+}
 /**
  * 清空整屏 + 滚动缓冲(向上滚动可见的历史输出),光标归位。
  * 进入会话时调用,让终端只剩当前 agent 对话。非 TTY 时空操作。

package/dist/verification/prompt.js

@@ -0,0 +1,55 @@
+import path from 'node:path';
+import { discoverPackageValidationCommands } from './discovery.js';
+import { discoverProjectProfile } from './profile.js';
+/** Keep the prompt section small on large monorepos; the agent can still discover the rest. */
+const MAX_LISTED_PACKAGES = 8;
+function displayRoot(profile, packageProfile) {
+    const relative = path.relative(profile.root, packageProfile.root);
+    return relative === '' ? '.' : relative.split(path.sep).join('/');
+}
+function lineFor(profile, packageProfile) {
+    const commands = discoverPackageValidationCommands(profile, packageProfile);
+    if (commands.length === 0)
+        return null;
+    const cwd = displayRoot(profile, packageProfile);
+    const rendered = commands.map((item) => `\`${item.command}\``).join(', ');
+    return `- ${packageProfile.name} (cwd \`${cwd}\`): ${rendered}`;
+}
+/**
+ * Deterministic project validation map injected into the system prompt: which package owns which
+ * script, and the exact command plus cwd to run it. Commands are listed in increasing cost order
+ * (typecheck → build → test) and are never executed here — this is evidence, not a completion gate.
+ *
+ * Returns '' when no package exposes a validation script, or when discovery fails for any reason
+ * (missing/invalid manifest, unreadable workspace): prompt construction must never break.
+ */
+export function buildValidationCommandsSection(root = process.cwd()) {
+    try {
+        const profile = discoverProjectProfile(root);
+        const lines = [];
+        let omitted = 0;
+        for (const packageProfile of profile.packages) {
+            const line = lineFor(profile, packageProfile);
+            if (!line)
+                continue;
+            if (lines.length >= MAX_LISTED_PACKAGES)
+                omitted += 1;
+            else
+                lines.push(line);
+        }
+        if (lines.length === 0)
+            return '';
+        if (omitted > 0) {
+            lines.push(`- …${omitted} more package(s) with scripts: read their package.json when needed.`);
+        }
+        return [
+            '',
+            '## Validation commands (discovered from project manifests)',
+            'Listed in increasing cost order. Use them when a check is worth running; prefer the package that owns your change over repository-wide runs. Not a completion gate.',
+            ...lines,
+        ].join('\n');
+    }
+    catch {
+        return ''; // Discovery is best-effort: never let it break prompt construction.
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-ai",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 16 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {
@@ -21,8 +21,9 @@
   "scripts": {
     "start": "tsx src/index.ts",
     "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit && tsc -p evals/tsconfig.json",
-    "eval:smoke": "tsx evals/smoke.ts && tsx evals/coding/smoke.ts",
+    "test": "tsc -p tsconfig.test-build.json && node --test --experimental-test-isolation=none \"dist-tests/tests/*.test.js\"",
+    "typecheck": "tsc --noEmit && tsc -p tests/tsconfig.json && tsc -p evals/tsconfig.json",
+    "eval:smoke": "tsx evals/smoke.ts && tsx evals/coding/smoke.ts && tsx evals/work-discipline.ts",
     "eval:coding": "tsx evals/coding/runner.ts",
     "eval:coding:list": "tsx evals/coding/runner.ts --list",
     "prepare": "npm run build"