mocode-ai 1.2.7 → 1.2.9

package/dist/agent/core.d.ts

@@ -1,112 +0,0 @@
-import type OpenAI from 'openai';
-import { type ChatMessage, type ChatUsage, type ToolCallRef } from '../llm/index.js';
-/** 解析工具 arguments JSON;非法或空返 null(调用方据此降级到普通 preview)。 */
-declare function parseArgs(raw: string): Record<string, unknown> | null;
-/** 只读工具集:一轮多个时,连续的只读工具成组 Promise.all 并行(无副作用、互不依赖)。 */
-declare const READ_TOOL_NAMES: Set<string>;
-/** mutation 工具:写盘 + 在 executeTool 内记回滚 before 快照,必须串行保快照序。 */
-declare const isMutationTool: (name: string) => boolean;
-/** 工具调用 ● 头所需信息(交给 hooks 渲染;core 不直接写屏)。 */
-export interface ToolCallView {
-    name: string;
-    arguments: string;
-    id: string;
-}
-/** mutation 执行前读旧内容供 diff:write_file 取整文件旧内容(不存在→null=新建),
- * edit_file 取 old_string 起始行号(供 diff 显示真实文件行号)。读不到则 diff 退化为相对行号。
- * 非 mutation 或参数非法返 { preWriteOld: null, editStartLine: 1 }。失败不阻断。 */
-declare function readDiffContext(tc: ToolCallRef, parsed: Record<string, unknown> | null): {
-    preWriteOld: string | null;
-    editStartLine: number;
-};
-/**
- * agent 循环的展示副作用接缝。主 agent 注入 TUI 渲染实现;子 agent 注入静默/摘要实现。
- * 所有方法可选——core 对 undefined hooks 安全跳过。
- */
-export interface AgentHooks {
-    /** 流式正文增量(主 agent:走 markdown 渲染写内容区)。 */
-    onText?: (delta: string) => void;
-    /** 模型开始生成某 tool_call 的参数(主 agent:补换行 + 启「生成中」spinner)。 */
-    onToolCall?: (name: string) => void;
-    /** 每步开始,spinner 启「思考中」(主 agent:spinner.start)。 */
-    onStepStart?: () => void;
-    /** chat 返回后停 spinner(主 agent:spinner.stop)。 */
-    onChatDone?: () => void;
-    /** 流式正文末尾补换行(若 onToolCall 已补则 no-op);防 ● 行黏在正文行尾。 */
-    onTextEnd?: () => void;
-    /** 工具调用 ● 头渲染(主 agent:工具名 + 参数摘要)。 */
-    onToolHeader?: (tc: ToolCallRef) => void;
-    /** 启「执行 工具」spinner(主 agent:spinner.start)。 */
-    onToolStart?: (name: string) => void;
-    /** 工具执行完停 spinner(主 agent:spinner.stop)。 */
-    onToolDone?: () => void;
-    /** 工具结果渲染(主 agent:mutation 走 diff 块;其余走一行 preview)。 */
-    onToolResult?: (tc: ToolCallRef, output: string, parsed: Record<string, unknown> | null, preWriteOld: string | null, editStartLine: number) => void;
-    /** 工具步末尾补一空行(与下一轮思考/正文分隔)。 */
-    onToolBatchEnd?: () => void;
-    /** 无回复提示(模型既无文本也无工具调用)。 */
-    onNoReply?: () => void;
-    /** 达到最大步数提示。 */
-    onMaxSteps?: () => void;
-    /** 中断还原:停 spinner + 补换行 + (已中断)提示 + history 还原 + 模式还原。 */
-    onAbort?: () => void;
-    /** 跑完(正常/达上限)在回复末尾打耗时摘要行;中断不调。
-     *  usage 是本轮 chat 调用累计的 token 用量(未开启 include_usage 或全失败时为 undefined)。 */
-    onDone?: (elapsedMs: number, usage?: ChatUsage) => void;
-}
-/** runAgentCore 的运行选项。 */
-export interface AgentRunOptions {
-    history: ChatMessage[];
-    /** 纯文本字符串,或多模态 parts 数组(OpenAI content 数组,text + image_url)。 */
-    userInput: string | ContentPart[];
-    signal?: AbortSignal;
-    /** 每步 chat() 返回后回调:repl 据此重算并重画状态行 context 用量条。 */
-    onContextUpdate?: () => void;
-    hooks: AgentHooks;
-    /** 步数上限;缺省 = config.maxSteps。子 agent 可传更低值。 */
-    maxSteps?: number;
-    /** 工具 schema 覆盖;plan 模式传 planChatTools(只读子集)。子 agent 可传受限子集。
-     *  缺省 = 按 getAgentMode() 自动选(auto=全量 / plan=只读)。 */
-    toolsOverride?: OpenAI.Chat.Completions.ChatCompletionTool[];
-    /** 跳过回滚快照记录(子 agent 逻辑隔离用)。true = 本 agent 的 write_file/edit_file 改动
-     *  不进主回滚链,主 /rollback 不撤销。透传给 executeTool。 */
-    skipRollback?: boolean;
-}
-/** OpenAI content array 的子集(text + image_url);repl 构造 user 多模态消息用。 */
-export type ContentPart = {
-    type: 'text';
-    text: string;
-} | {
-    type: 'image_url';
-    image_url: {
-        url: string;
-        detail?: 'auto' | 'low' | 'high';
-    };
-};
-/** runAgentCore 的运行结果。 */
-export interface AgentRunResult {
-    /** 正常完毕 / 达上限 true;中断 false。 */
-    completed: boolean;
-    /** 最终 assistant 文本回复(content);无回复或中断为 null。 */
-    finalText: string | null;
-    /** 本轮累计 token 用量(各 chat 步 prompt+completion 之和);后端不开 include_usage 或全失败则 undefined。 */
-    usage?: ChatUsage;
-}
-/**
- * agent 核心循环(纯逻辑):
- *  流式调 LLM(经 hooks.onText 实时渲染)→ 有 tool_calls 就分组执行并回灌
- *  → 否则流式正文即最终回复。history 在调用间持久,由调用方持有。
- *  步前经 session/maybeCompact 自动压缩(接近窗口上限时三层压缩);
- *  工具结果进 history 前经 Context Optimization Pipeline(optimizeToolResult:类型化编码 + 长度裁剪)。
- *
- *  中断语义:signal 经 executeTool(name, args, signal) 串进工具;run_command/web_fetch 等 abort 即时杀
- *  (树杀子进程 / 取消 fetch),循环顶 if(signal.aborted) 兜底还原。不会留下未配对的 tool_call_id。
- *  abort 时 history 还原到本 turn 前(savedHistory 浅拷贝),模式还原,调 hooks.onAbort。
- *
- *  所有展示副作用经 hooks 注入;core 自身不直接调 layout / spinner(不依赖 ui/layout.ts)。
- *  但 core 仍依赖 ui/render.ts 的纯函数(summarizeToolCall / truncateDisplay / fmtElapsed)——
- *  这些是纯字符串格式化,无副作用,共享安全。
- */
-export declare function runAgentCore(opts: AgentRunOptions): Promise<AgentRunResult>;
-export { parseArgs, readDiffContext, isMutationTool, READ_TOOL_NAMES };
-export type { ChatMessage, ToolCallRef, ChatUsage } from '../llm/index.js';

package/dist/agent/index.d.ts

@@ -1,19 +0,0 @@
-import type { ChatMessage } from '../llm/index.js';
-import { type AgentRunResult, type ContentPart } from './core.js';
-/**
- * agent 核心循环(主 agent,TUI 渲染版):
- *  流式调 LLM(onText 实时写内容区)→ 有 tool_calls 就执行并回灌
- *  → 否则流式正文即最终回复。history 在调用间持久,由 REPL 持有。
- *  步前经 session/maybeCompact 自动压缩(接近窗口上限时三层压缩);
- *  工具结果进 history 前经 capToolResultForHistory 裁到单条上限。
- *
- *  所有正文写经 layout.contentWrite(保证落在内容区、跟踪续写位、底栏不被顶);
- *  spinner 经 onFrame 回调刷状态行(layout.drawStatusBar),等待时内容区静止、底栏转圈。
- *  思考期间不写思考内容,只让 spinner 持续转「思考中…」(首个正文 / tool_call token 到达才停)。
- *
- *  循环逻辑委托 runAgentCore;本函数只注入 TUI 渲染 hooks(layout + spinner + diff + 回滚轮次)。
- *  开新轮次(beginTurn)在入口调——core 不依赖 rollback,回滚轮次是主 agent 的展示副作用。
- */
-export declare function runAgent(history: ChatMessage[], userInput: string | ContentPart[], signal?: AbortSignal, 
-/** 每步 chat() 返回后回调:repl 据此重算并重画状态行 context 用量条(运行中实时刷新,不冻结在轮首)。 */
-onContextUpdate?: () => void): Promise<AgentRunResult>;

package/dist/agent/mode.d.ts

@@ -1,29 +0,0 @@
-/**
- * agent 模式的共享状态(零依赖纯叶子)。
- *
- * 把 `agentMode` 从 repl 的模块变量提到这里,让三方都能用、且不破坏依赖单向:
- *  - `tools/builtins/switch-mode.ts` 写它(setAgentMode)——LLM 在 agent 循环里自切 plan↔auto。
- *  - `agent/index.ts` 每步读它(getAgentMode)——决定 chat() 用全量 chatTools 还是 planChatTools 只读子集,
- *    以及串行分支的 plan 防御 backstop。这样 LLM 中途切模式后,下一次 chat() 立即看到新工具集。
- *  - `repl/index.ts` 读写它 + 注册 onModeChange 监听器(做 applyMode 重写 history[0] + refreshStatusBase
- *    刷状态行 modeTag)。
- *
- * 依赖方向无环:本模块不 import 任何业务模块。`agent/index → tools/registry → tools/builtins/switch-mode
- * → agent/mode` 链终点是本叶子,不回到 agent/index。`tools → agent/mode` 与既有 `tools → ui`(ask-human)、
- * `tools → rollback`(registry)同性质——都是引叶子。
- *
- * listener 同步触发:setAgentMode 在变更模式后同步调 listener(无 async)。switch_mode 工具在 executeTool
- * 内调 setAgentMode → listener 同步 applyMode(重写 history[0])+ refreshStatusBase;execute 返回字符串后,
- * agent 串行分支继续,下一步 chat() 读到新模式 + 新系统提示,一致。
- */
-export type AgentMode = 'auto' | 'plan';
-/** 当前 agent 模式。auto=全工具执行;plan=只读探查 + 产出计划(写盘/命令/记忆写入工具被 schema 剔除)。 */
-export declare function getAgentMode(): AgentMode;
-/**
- * 设置 agent 模式。同模式 no-op(不触发 listener)。变更时同步触发 onModeChange 注册的监听器
- * (repl 在 startRepl 注册:applyMode 重写 history[0] + refreshStatusBase 刷状态行)。
- * 返回之前的模式,供调用方(如 runAgent 中断恢复)还原。
- */
-export declare function setAgentMode(m: AgentMode): AgentMode;
-/** 注册模式变更监听器(单一,后注册覆盖先注册)。repl 在 startRepl 启动时注册一次。 */
-export declare function onModeChange(cb: (m: AgentMode) => void): void;

package/dist/agent/retry-classifier.js

@@ -1,64 +0,0 @@
-// RETRY-01: 错误反思分类器。
-//
-// 在 tools/retry.ts 之上叠加一层"反思"语义:把每个 ToolOutcomeCode 映射到
-// 一个 ErrorCategory,供 (a) PROMPT 反思 prompt 注入、(b) QUAL-01 trace 指标。
-//
-// 设计要点:
-// - 纯映射函数,无副作用 → 易测,易扩展(新 code → 改一处)。
-// - 6 类对齐路线图 L163:`TRANSIENT_RATE_LIMIT` / `TRANSIENT_TIMEOUT` /
-//   `INVALID_ARGUMENTS` / `PERMISSION_DENIED` / `CONFLICT` / `UNKNOWN_FAILURE`。
-// - 提供"反思指针"模板(reflectionHint),与 PROMPT-01 hard rule
-//   / PROMPT-02 checklist 共用同一套"先想清楚再动"语言,避免新造话。
-// - 不**决策**重试与否(`shouldRetry` 在 tools/retry.ts 已经稳定;本次不动),
-//   只**注解**每个错误"该反思什么"。
-/** code → category 的稳定映射。fixture 直接断言(避免漏改)。 */
-const CODE_TO_CATEGORY = {
-    OK: 'UNKNOWN_FAILURE', // OK 不该走到这里;归 UNKNOWN 是为了编译期不漏。
-    // rate-limit / timeout / network
-    TIMEOUT: 'TRANSIENT_TIMEOUT',
-    HTTP_ERROR: 'TRANSIENT_RATE_LIMIT', // 4xx/5xx 中除 408/429 之外的 5xx 视为 rate-limit 语义
-    NETWORK_ERROR: 'TRANSIENT_TIMEOUT', // 网络层错(ECONNRESET 等)→ 与 timeout 同类反思
-    // 参数 / schema(模型自己改,不是 retry 自己改)
-    INVALID_JSON: 'INVALID_ARGUMENTS',
-    INVALID_ARGUMENTS: 'INVALID_ARGUMENTS',
-    INVALID_TOOL_SCHEMA: 'INVALID_ARGUMENTS',
-    UNKNOWN_TOOL: 'INVALID_ARGUMENTS', // 调用了不存在的工具 → 模型改 tool name
-    // 权限 / 沙箱 / 模式(永久拒绝)
-    SANDBOX_DENIED: 'PERMISSION_DENIED',
-    PERMISSION_DENIED: 'PERMISSION_DENIED',
-    TOOL_DISABLED: 'PERMISSION_DENIED',
-    MODE_DENIED: 'PERMISSION_DENIED',
-    ABORTED: 'PERMISSION_DENIED', // 用户主动 abort,与 permission 同类(无 retry 价值)
-    // 冲突 / 写失败(retry 之前必须重新读)
-    EDIT_CONFLICT: 'CONFLICT',
-    CHANGE_CONFLICT: 'CONFLICT',
-    PATCH_INVALID: 'CONFLICT',
-    POSTCONDITION_FAILED: 'CONFLICT',
-    PROCESS_FAILED: 'CONFLICT',
-    // 兜底
-    EXECUTION_ERROR: 'UNKNOWN_FAILURE',
-    MCP_ERROR: 'UNKNOWN_FAILURE',
-};
-export function classifyError(code) {
-    return CODE_TO_CATEGORY[code];
-}
-/** 反思指针:每类错误给 LLM 一句"反思什么"的话。 */
-const REFLECTION_HINTS = {
-    TRANSIENT_RATE_LIMIT: 'The remote is throttling or returned 5xx. Re-running the same call with identical arguments is unlikely to help — wait, downgrade call frequency, or reduce request size; do not retry the same args in tight loop.',
-    TRANSIENT_TIMEOUT: 'A network or process timeout occurred. Re-running the same call may help once, but if it fails again with identical args, the path/host/argument is wrong; switch tool, reduce scope, or ask the user.',
-    INVALID_ARGUMENTS: 'The tool rejected the call shape (JSON / schema / unknown tool). Read the tool description again and fix the arguments yourself; do not resend the same call and do not retry automatically — only the model can fix argument shape.',
-    PERMISSION_DENIED: 'The call was denied (sandbox / permission / disabled / mode). Retry will not help; surface the constraint to the user and ask for guidance or a permission grant.',
-    CONFLICT: 'A write/patch conflicted with the on-disk state. Do not resend the same args; re-read the file or change target, then re-derive the diff. If the conflict is structural, the plan itself is wrong — go back to the spec.',
-    UNKNOWN_FAILURE: 'An unclassified error occurred. Do not retry blindly; capture the message, re-read the tool description, and decide whether the same call with a smaller scope or a different tool is appropriate. If unsure, ask the user.',
-};
-export function reflectionHint(category) {
-    return REFLECTION_HINTS[category];
-}
-/**
- * 一站式:对 ToolOutcome 给出"反思 category + 反思 hint"。
- * 调用方一般是 tools/retry.ts 的 onRetry hook,把 hint 注入 retry 提示尾部。
- */
-export function reflectOn(code) {
-    const category = classifyError(code);
-    return { category, hint: reflectionHint(category) };
-}

package/dist/agent/spawn.d.ts

@@ -1,36 +0,0 @@
-/** 子 agent 运行选项。 */
-export interface SpawnOptions {
-    /** 子任务指令(作为子 agent 的 user 消息)。 */
-    prompt: string;
-    /** 附加系统提示(角色/约束),拼在 SUBAGENT_SUFFIX 后。 */
-    systemPromptSuffix?: string;
-    /** 允许的工具名白名单(可选)。无 = 全量工具;给则从 chatTools 过滤。 */
-    tools?: string[];
-    /** 步数上限(可选,默认 config.subAgentMaxSteps ?? 50)。 */
-    maxSteps?: number;
-    /** 主 agent 的 abort signal(可选)。透传给子 runAgentCore → chat/executeTool,
-     *  主 Ctrl+C 树杀子 agent(chat 流式 abort + run_command/web_fetch 即时取消)。 */
-    signal?: AbortSignal;
-}
-/** 子 agent 运行结果。 */
-export interface SpawnResult {
-    /** 子 agent 最终文本回复;中断或无回复为 null。 */
-    summary: string | null;
-    /** 正常完毕 true;中断 false。 */
-    completed: boolean;
-    /** 子 agent 中间过程的人类可读日志(工具调用 + 结果摘要 + 流式正文片段)。主 agent 通常不看,调试用。 */
-    transcript: string;
-}
-/**
- * 派生一个子 agent 执行独立子任务。
- *
- * 行为:
- *  - 构造独立 history:[{system: 主系统提示 + SUBAGENT_SUFFIX + 自定义后缀}, {user: prompt}]
- *  - 工具子集:按 opts.tools 白名单过滤 chatTools;无白名单 = 全量。
- *  - 静默 hooks:流式正文 / 工具头 / 结果缓冲到 transcript;不写主屏(layout)。
- *  - 返回 { summary, completed, transcript }。summary 给 task 工具回灌主 history。
- *
- * 中断:opts.signal 透传给子 runAgentCore——主 Ctrl+C 树杀子 agent(chat abort + 工具 abort)。
- * 子 agent 跑在主 signal 下,主 abort 即子 abort;子 agent 的 abortRestore 还原子 history + 模式。
- */
-export declare function spawnAgent(opts: SpawnOptions): Promise<SpawnResult>;

package/dist/attachments/image.d.ts

@@ -1,22 +0,0 @@
-export type ImageMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
-export interface ImageAttachment {
-    id: string;
-    path: string;
-    name: string;
-    bytes: number;
-    mime: ImageMime;
-    dataUrl: string;
-}
-export declare const MAX_INLINE_BYTES_DEFAULT: number;
-export declare function detectMime(p: string): ImageMime | null;
-export declare function renderChip(att: ImageAttachment): string;
-export type LoadImageResult = {
-    ok: true;
-    att: ImageAttachment;
-} | {
-    ok: false;
-    reason: string;
-};
-export declare function loadImageAttachment(input: string, opts: {
-    maxBytes: number;
-}): Promise<LoadImageResult>;

package/dist/commands/config.d.ts

@@ -1,8 +0,0 @@
-/**
- * 首跑配置向导:交互填 LLM_BASE_URL / LLM_API_KEY / LLM_MODEL,写 ~/.mocode/config。
- * 只交互三键、保留文件里其它键(MAX_TOKENS / CONTEXT_WINDOW_TOKENS / MOCODE_THEME 等)。
- * prompt 全纯文本(readline 光标按字符算,不能含 ANSI)。
- * 由 index.ts 在 `mocode config` 时动态加载,故不 import config/index.ts(避免触发 config 单例初始化 / loadEnvFiles,
- * 直接退出);只 import config/file.ts(纯 I/O 叶子,无 env 校验 / process.exit)。
- */
-export declare function runConfigWizard(): Promise<void>;

package/dist/commands/skill.js

@@ -1,230 +0,0 @@
-// `mocode skill` CLI 子命令(skill 自进化 Phase 0/1 的用户入口)。
-//
-//   mocode skill eval <name> [--runs N] [--threshold x] [--timeout ms]
-//       触发评测:对 <skill-dir>/evals/trigger.json 的每条 query 跑单轮 agent,
-//       统计 use_skill/run_skill 触发率,输出 PASS/FAIL 报告并落盘 JSON。
-//
-//   mocode skill improve <name> [--runs N] [--threshold x] [--iterations N]
-//                     [--holdout x] [--timeout ms] [--apply]
-//       description 进化循环:train/holdout 切分 + LLM 提案 + 接受门,默认 dry-run
-//       只打印最佳 description;--apply 才写回 SKILL.md(写前显式确认;非 TTY 拒绝)。
-//
-//   mocode skill usage [name]
-//       展示使用台账(Phase 0):按 skill 的调用次数/成功率/最近失败。
-//
-// 由 index.ts 在 `mocode skill …` 时动态加载(与 mocode config 同模式):
-// 此时才引入 config 单例(LLM 配置)+ agent 依赖图,缺 LLM 配置时给友好报错而非崩。
-// 纯打印/非 TUI:本进程不进 alt screen,输出走 stdout。
-import * as readline from 'node:readline';
-import path from 'node:path';
-import { config, isModelConfigured } from '../config/index.js';
-import { listSkills } from '../skills/index.js';
-import { loadSkillForEval, loadTriggerEvalSet, triggerEvalTemplate, triggerEvalPath, runTriggerEval, renderTriggerReport, saveTriggerReport, validateEvalParams, } from '../skills/skill-eval.js';
-import { runImproveLoop, applyImprovedDescription } from '../skills/skill-improve.js';
-import { loadSkillUsage, aggregateSkillStats, skillStatsPath } from '../skills/stats.js';
-function usage() {
-    console.log(`mocode skill — skill 自进化(触发评测 / description 进化 / 使用台账)
-
-用法:
-  mocode skill eval <name> [选项]        触发评测(需要 <skill-dir>/evals/trigger.json)
-  mocode skill improve <name> [选项]     description 进化循环(默认 dry-run)
-  mocode skill usage [name]              展示使用台账
-
-eval 选项:
-  --runs <n>          每 query 运行次数(默认 3;1..10)
-  --threshold <x>     触发率判定阈值(默认 0.5;>0 且 ≤1)
-  --timeout <ms>      单 query 超时(默认 60000)
-
-improve 选项:
-  --runs <n>          同 eval(默认 3)
-  --threshold <x>     同 eval(默认 0.5)
-  --iterations <n>    迭代上限(默认 5)
-  --holdout <x>       holdout 比例(默认 0.4;0 禁用)
-  --timeout <ms>      单 query 超时(默认 60000)
-  --apply             把最佳 description 写回 SKILL.md(默认 dry-run,仅打印)
-
-eval 集格式(<skill-dir>/evals/trigger.json,非空数组):
-  [
-    { "query": "应该触发该 skill 的真实请求", "should_trigger": true },
-    { "query": "不应触发的相近请求", "should_trigger": false }
-  ]
-
-注: 进化对象仅限 ~/.mocode/skills 与 <cwd>/.mocode/skills 下的 skill(内置 skill 不可进化)。
-    没有 evals/trigger.json 的 skill 只能 eval 前手工补建,improve 一律拒绝(没验证门不优化)。`);
-}
-function numArg(args, name, fallback) {
-    const i = args.indexOf(name);
-    if (i === -1 || i + 1 >= args.length)
-        return fallback;
-    const v = Number(args[i + 1]);
-    if (!Number.isFinite(v) || v <= 0) {
-        throw new Error(`${name} 需要正数: ${args[i + 1]}`);
-    }
-    return v;
-}
-function parseCommon(args) {
-    const runs = Math.round(numArg(args, '--runs', 3));
-    const threshold = numArg(args, '--threshold', 0.5);
-    const timeoutMs = Math.round(numArg(args, '--timeout', 60_000));
-    const err = validateEvalParams(runs, threshold);
-    if (err)
-        throw new Error(err);
-    return { runs, threshold, timeoutMs };
-}
-function requireModel() {
-    if (!isModelConfigured()) {
-        console.error('未配置 LLM(缺 LLM_BASE_URL / LLM_API_KEY)。先运行 `mocode config` 或设置环境变量。');
-        process.exit(1);
-    }
-}
-/** 定位 eval 集;缺失时打印模板并退出(不猜、不自动建)。 */
-function requireEvalSet(skillName) {
-    const skill = loadSkillForEval(skillName);
-    const cases = loadTriggerEvalSet(skill);
-    if (!cases) {
-        console.error(`未找到触发评测集: ${path.relative(process.cwd(), triggerEvalPath(skill))}`);
-        console.error('手工创建该文件(格式):');
-        console.error(triggerEvalTemplate(skill));
-        process.exit(1);
-    }
-    return { skill, cases };
-}
-async function evalCommand(args) {
-    const rest = args.slice();
-    const name = rest.find((a) => !a.startsWith('--'));
-    if (!name)
-        throw new Error('缺少 skill 名。见: mocode skill eval --help');
-    requireModel();
-    const { skill, cases } = requireEvalSet(name);
-    const { runs, threshold, timeoutMs } = parseCommon(rest);
-    console.log(`评测 skill "${skill.name}" — ${cases.length} 条 query × ${runs} 次,模型 ${config.model}\n`);
-    const startedAt = Date.now();
-    const report = await runTriggerEval(skill, skill.description, cases, runs, threshold, {
-        timeoutMs,
-        onProgress: (_d, _t, line) => process.stdout.write(line + '\n'),
-    });
-    const saved = saveTriggerReport(report);
-    console.log(`\n${renderTriggerReport(report, { runsPerQuery: runs, threshold })}`);
-    console.log(`\n耗时 ${((Date.now() - startedAt) / 1000).toFixed(1)}s,结果已存: ${path.relative(process.cwd(), saved)}`);
-    if (report.summary.passed < report.summary.total) {
-        console.log('存在失败项。可用 `mocode skill improve ' + skill.name + '` 尝试自动优化 description(dry-run)。');
-        process.exitCode = 1;
-    }
-}
-function confirmApply(skillName) {
-    if (!process.stdin.isTTY) {
-        // 非 TTY fail closed:自动落盘必须有人在场。
-        console.error('非 TTY 环境拒绝 --apply 自动落盘。请在终端运行,或手工编辑 SKILL.md 的 description。');
-        process.exit(1);
-    }
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    return new Promise((resolve) => {
-        rl.question(`确认把新 description 写回 skill "${skillName}" 的 SKILL.md?(y/N) `, (ans) => {
-            rl.close();
-            resolve(ans.trim().toLowerCase() === 'y' || ans.trim().toLowerCase() === 'yes');
-        });
-    });
-}
-async function improveCommand(args) {
-    const rest = args.slice();
-    const name = rest.find((a) => !a.startsWith('--'));
-    if (!name)
-        throw new Error('缺少 skill 名。见: mocode skill improve --help');
-    requireModel();
-    const { skill, cases } = requireEvalSet(name);
-    const { runs, threshold, timeoutMs } = parseCommon(rest);
-    const iterations = Math.round(numArg(rest, '--iterations', 5));
-    const holdout = (() => {
-        const i = rest.indexOf('--holdout');
-        const v = i === -1 ? 0.4 : Number(rest[i + 1]);
-        if (i !== -1 && (!Number.isFinite(v) || v < 0 || v > 0.9))
-            throw new Error('--holdout 需要 0..0.9 的数');
-        return v;
-    })();
-    const apply = rest.includes('--apply');
-    console.log(`进化 skill "${skill.name}" — ${cases.length} 条 query,train/holdout=${1 - holdout}/${holdout},${apply ? '将写回(--apply)' : 'dry-run(不落盘)'}\n`);
-    const result = await runImproveLoop(skill, cases, {
-        maxIterations: iterations,
-        runsPerQuery: runs,
-        threshold,
-        holdout,
-        timeoutMs,
-        onIteration: (_i, _max, line) => console.log(line),
-    });
-    console.log('');
-    if (!result.improved) {
-        console.log(`没有更优的 description(原 description 已是最佳或循环未产出改进)。`);
-        console.log(`原: ${result.originalDescription}`);
-        return;
-    }
-    console.log(`原 description: ${result.originalDescription}`);
-    console.log(`新 description: ${result.bestDescription}`);
-    if (apply) {
-        const ok = await confirmApply(skill.name);
-        if (!ok) {
-            console.log('已取消写回(dry-run 结果见上,可手工应用)。');
-            return;
-        }
-        applyImprovedDescription(skill, result.bestDescription);
-        console.log(`已写回: ${skill.skillMdPath}`);
-        console.log('提示: 内容哈希已变更,project 级 skill 下次 run_skill 会重新要求信任确认。');
-    }
-    else {
-        console.log('dry-run:未写文件。确认满意后加 --apply 重跑,或直接手工把新 description 写进 SKILL.md。');
-    }
-}
-function usageCommand(args) {
-    const filter = args.find((a) => !a.startsWith('--'));
-    const records = loadSkillUsage();
-    const summaries = aggregateSkillStats(records);
-    const list = filter ? summaries.filter((s) => s.skill === filter) : summaries;
-    if (list.length === 0) {
-        console.log(`(台账为空: ${path.relative(process.cwd(), skillStatsPath())})`);
-        console.log('台账在模型调用 use_skill / run_skill 时自动记录,跑几个会话后这里有数。');
-        return;
-    }
-    for (const s of list) {
-        const rate = s.runSuccessRate === null ? '' : ` run 成功率 ${(s.runSuccessRate * 100).toFixed(0)}%`;
-        console.log(`${s.skill}  ×${s.total}(use ${s.uses} / run ${s.runs})${rate}  最近 ${s.lastUsedAt}`);
-        if (s.lastFailure) {
-            console.log(`  最近失败: ${s.lastFailure.status}${s.lastFailure.code ? ` (${s.lastFailure.code})` : ''} @ ${s.lastFailure.ts}`);
-        }
-    }
-}
-export async function runSkillCommand(args) {
-    const sub = args[0];
-    if (!sub || sub === '--help' || sub === '-h' || sub === 'help') {
-        usage();
-        return;
-    }
-    try {
-        if (sub === 'eval')
-            await evalCommand(args.slice(1));
-        else if (sub === 'improve')
-            await improveCommand(args.slice(1));
-        else if (sub === 'usage')
-            usageCommand(args.slice(1));
-        else {
-            console.error(`未知子命令 "${sub}"。`);
-            usage();
-            process.exitCode = 1;
-        }
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        if (/aborted/i.test(msg)) {
-            console.error('\n已中断。');
-            process.exitCode = 130;
-        }
-        else {
-            console.error(`错误: ${msg}`);
-            process.exitCode = 1;
-        }
-    }
-}
-// 供 index.ts 判断子命令名集合(避免它 parse 我们的参数)。
-export const SKILL_SUBCOMMANDS = ['eval', 'improve', 'usage', 'help', '--help', '-h'];
-// listSkills 在 eval/improve 未命中时供报错文案复用(保持与 /skills 一致的名字集)。
-export function listSkillNames() {
-    return listSkills().map((s) => s.name);
-}

package/dist/config/file.d.ts

@@ -1,23 +0,0 @@
-/**
- * ~/.mocode/config 全局 dotenv 配置的读写叶子(纯 node:fs / node:os / node:path + dotenv)。
- *
- * 独立于 `config/index.ts`——**不**触发 config 单例初始化 / loadEnvFiles,故 `commands/config.ts`
- * (首跑向导,刻意不 import config/index.ts)与 `repl/index.ts`(`/theme` 持久化)都能安全共享。
- * 主题等 UI 偏好走 `updateConfigKey` 单键写;向导多键一次性写走 `writeConfigKeys`。
- */
-/** ~/.mocode/config:全局配置(与 ~/.mocode/skills 同目录,任意终端 / 任意目录生效)。 */
-export declare const CONFIG_PATH: string;
-/** 读已有配置(没有则空对象),用于回填默认值与保留其它键。 */
-export declare function readConfigFile(): Record<string, string>;
-/**
- * 读-合并-写:把 entries 覆盖进 ~/.mocode/config,保留文件里其它键。
- * mkdirSync 兜底(首跑无 ~/.mocode)。不吞 I/O 异常——向导路径让其抛(与历史行为一致);
- * UI 偏好路径用 `updateConfigKey`(自带 try/catch 静默)。
- */
-export declare function writeConfigKeys(entries: Record<string, string>): void;
-/**
- * 单键持久化(主题等 UI 偏好):写失败静默——下次启动读不到则回退默认,不阻断 REPL。
- * 注意:shell env 设了同名键时,`config/index.ts` 的 loadEnvFiles 只 backfill undefined 的
- * process.env,故文件写对**下次启动**可能被 shell 盖——调用方据此给 dim 警告。
- */
-export declare function updateConfigKey(key: string, value: string): void;