@migor/cli 0.10.2 → 0.10.3

package/dist/report.js

@@ -8,6 +8,11 @@
  * - 裸 Trace（含 `spans`）—— 如 `createOtlpExporter` 之外的本地落盘、或自己 writeFile 的记录；
  * - TaskRecord（含 `result.trace` 或 `trace`）—— 如 `FileTaskStore` / `SqliteTaskStore` 的导出。
  *
+ * ⚠️ TaskRecord 导出是 **append-only**（FileTaskStore 每次 save 追加一行）：审批流里同一棵
+ * 挂起段 trace 会被写多次（挂起 save / approve 落库 / 接管再 save，各行的 `result.trace`
+ * 是同一份）⇒ 按行计会把 runs / 成功率 / 成本全部翻倍。因此解析后按 **`traceId` 去重，
+ * 同一 traceId 只留最后一行**（append-only 里后面的是新状态），能力表与会话表共用这份输入。
+ *
  * 聚合实现**不在这里** —— 复用 `@migor/trace-view` 的 `summarizeTrace`
  * （构建期由 scripts/copy-assets.mjs 拷进 dist/inspector/）。CLI 因此保持零 npm 运行时依赖，
  * 且与 inspector 面板/官网 playground 共用同一份聚合口径（避免两处漂移）。
@@ -29,6 +34,51 @@ export function extractTrace(v) {
         return trace;
     return null;
 }
+/** TaskRecord 的任务键（`FileTaskStore` / `SqliteTaskStore` 导出的顶层 `taskId`）。裸 Trace 没有它。 */
+function taskKeyOf(v) {
+    if (!v || typeof v !== 'object')
+        return null;
+    const id = v.taskId;
+    return typeof id === 'string' && id.length > 0 ? id : null;
+}
+/**
+ * run 根 span —— 优先 `kind === 'run'`，跑挂的 trace 没有就退到第一个 span。
+ * 与 `inspector-routes.ts` 的 `summarize` 同款取法（两处都在读 run 根的 attribute，口径要一致）。
+ */
+function rootSpanOf(t) {
+    const spans = (t.spans ?? []);
+    return spans.find((s) => s?.kind === 'run') ?? spans[0] ?? null;
+}
+/** 「没有会话」桶的名字 —— 常量而非字面量：断言与渲染必须指同一个东西 */
+export const NO_SESSION = '(无会话)';
+/** 分组键：会话优先，其次任务，最后落「无会话」桶 */
+function groupKeyOf(t, taskKey) {
+    const attrs = rootSpanOf(t)?.attributes;
+    const sid = attrs?.['session.id'];
+    if (typeof sid === 'string' && sid.length > 0)
+        return sid;
+    return taskKey ?? NO_SESSION;
+}
+/** 单条 run 的根 span 耗时（`endedAt - startedAt`）；读不出计 0 */
+function runMs(t) {
+    const root = rootSpanOf(t);
+    const s = Number(root?.startedAt);
+    const e = Number(root?.endedAt);
+    return Number.isFinite(s) && Number.isFinite(e) && e >= s ? e - s : 0;
+}
+/**
+ * 单条 run 的成本（美元）。
+ *
+ * ⚠️ **刻意不从 `summarizeTrace` 的能力行反加**：能力行只覆盖进了 capability 的
+ * `llm.turn`，run 根直属的回合（主 agent 自己问的）不在任何能力行里 ⇒ 反加会**漏**。
+ * `Trace.totalUsage` 才是权威口径（各 `llm.turn` 之和，刻意不含 capability 聚合以免
+ * 重复计数，`src/core/trace.ts`）。读不出（手工写的 trace / 未定价模型）⇒ null
+ * （渲染成 `-`），**不伪装成 0**。
+ */
+function runCostUsd(t) {
+    const c = t.totalUsage?.costEstimate;
+    return typeof c === 'number' && Number.isFinite(c) ? c : null;
+}
 /** 打印一张按总耗时降序的能力排行（跨多行记录时按能力合并） */
 /** 用法串（cli.ts 的子命令 `--help` 也从这里取，避免两处各写一份） */
 export const USAGE = '用法：agentia report <trace.jsonl> [--json]';
@@ -50,16 +100,21 @@ export async function reportCommand(args) {
     catch (e) {
         throw new Error(`读不到文件 ${file}（${e.message}）`);
     }
-    const traces = [];
+    // 解析时同时留下**外层记录**的任务键（TaskRecord 的 `taskId`）—— 它与 trace 本体不同源
+    // （在 wrapper 上，不在 `spans` 里），故在解析处一并取出。
+    // ⚠️ 「一行 = 一条 run」对 append-only 导出不成立（同一棵 trace 可能占多行），
+    // 去重在解析**之后**统一做（见下），别在循环里顺手去重 —— 坏行计数会被带歪。
+    const entries = [];
     let badLines = 0;
     for (const line of raw.split('\n')) {
         const s = line.trim();
         if (!s)
             continue;
         try {
-            const t = extractTrace(JSON.parse(s));
+            const v = JSON.parse(s);
+            const t = extractTrace(v);
             if (t)
-                traces.push(t);
+                entries.push({ trace: t, taskKey: taskKeyOf(v) });
             else
                 badLines += 1;
         }
@@ -67,10 +122,30 @@ export async function reportCommand(args) {
             badLines += 1;
         }
     }
-    if (traces.length === 0) {
+    if (entries.length === 0) {
         throw new Error(`${file} 里没有可识别的 trace（支持裸 Trace 或含 result.trace / trace 的记录）` +
             (badLines > 0 ? `；另有 ${badLines} 行无法解析` : ''));
     }
+    // **按 traceId 去重，同一 traceId 只留最后一行**。FileTaskStore 是 append-only：审批流里
+    // 同一棵挂起段 trace 会被写多次（挂起 save / approve 落库 / 接管再 save），各行的
+    // `result.trace` 是同一份 —— 不去重则 runs / 成功率 / 成本按行数翻倍。
+    // - 取**最后**一行：append-only 里后面的是新状态（接管后的记录才是终态）；
+    // - 键是 traceId 而不是 taskId：一个任务可以跨**多段** run（挂起 → 恢复 → 再挂起），
+    //   每段一棵新 trace（traceId == runId），按 taskId 去重会把不同段错并成一条；
+    // - 无 traceId 的行（手写 trace）无从判同，全部保留；
+    // - 过滤保序：留下的是各 traceId 在文件里**最后一次出现的位置**，输出顺序与直觉一致。
+    //   能力表、runs 总计、会话表**共用**这份去重后的输入（两处各算各的必然漂移）。
+    const lastByTraceId = new Map();
+    entries.forEach((e, i) => {
+        const id = e.trace.traceId;
+        if (typeof id === 'string' && id.length > 0)
+            lastByTraceId.set(id, i);
+    });
+    const deduped = entries.filter((e, i) => {
+        const id = e.trace.traceId;
+        return typeof id !== 'string' || id.length === 0 || lastByTraceId.get(id) === i;
+    });
+    const traces = deduped.map((e) => e.trace);
     // 聚合口径与 inspector 面板 / 官网 playground 同源（构建期拷进来的 trace-view 产物）
     // 这份聚合实现由 packages/cli/scripts/copy-assets.mjs 在构建期从 trace-view 产物拷进来。
     // 缺它只可能是「装坏了」或「直接跑未构建的源码」—— 原始 ERR_MODULE_NOT_FOUND 里全是
@@ -105,6 +180,42 @@ export async function reportCommand(args) {
         }
     }
     const rows = [...merged.values()].sort((a, b) => b.totalMs - a.totalMs || b.calls - a.calls);
+    // G6：会话 / 任务维度 —— 与上面的能力表**互补**：能力表看单个能力，这里看一整段会话/任务
+    // （多轮 run 的合计 + 成功率）。成功率**必须带分母**：只报百分比在小组上是噪声。
+    const byGroup = new Map();
+    for (const e of deduped) {
+        const key = groupKeyOf(e.trace, e.taskKey);
+        let row = byGroup.get(key);
+        if (!row) {
+            row = {
+                session: key,
+                runs: 0,
+                succeeded: 0,
+                failed: 0,
+                totalMs: 0,
+                costUsd: null,
+                costPerSuccess: null,
+            };
+            byGroup.set(key, row);
+        }
+        row.runs += 1;
+        // 成败判据与上面的 `okRuns` **同一条**（`status !== 'error'`）—— 两处各写一份会漂移。
+        if (e.trace.status !== 'error')
+            row.succeeded += 1;
+        else
+            row.failed += 1;
+        row.totalMs += runMs(e.trace);
+        const c = runCostUsd(e.trace);
+        if (c != null)
+            row.costUsd = (row.costUsd ?? 0) + c;
+    }
+    for (const row of byGroup.values()) {
+        // ⚠️ 成功数为 0 ⇒ null（渲染成 `-`）。写成 0 是把「除不了」伪装成「每个成功任务不花钱」，
+        // 正好说反 —— 这正是本项要防的那笔假账。
+        row.costPerSuccess =
+            row.costUsd != null && row.succeeded > 0 ? row.costUsd / row.succeeded : null;
+    }
+    const sessions = [...byGroup.values()].sort((a, b) => b.totalMs - a.totalMs || b.runs - a.runs || a.session.localeCompare(b.session));
     const failRows = traces
         .filter((t) => t.status === 'error')
         .map((t) => {
@@ -124,12 +235,25 @@ export async function reportCommand(args) {
             skippedLines: badLines,
             failures: failRows,
             capabilities: rows,
+            sessions,
             totals: { totalMs, errors: errTotal, capabilities: rows.length },
         };
         console.log(JSON.stringify(payload, null, 2));
         return 0;
     }
-    const pad = (s, n) => (s.length >= n ? s : s + ' '.repeat(n - s.length));
+    // 按**显示宽度**补齐：`(无会话)` 里的汉字占 2 列而 `String.length` 只算 1 ⇒ 用字符数补齐
+    // 会把那一行整体右推 3 格。而它偏偏是「宿主没开会话」时的**唯一**一行，歪得很显眼。
+    // 判据是启发式（≥ U+2E80 记 2 列）：覆盖 CJK 与全角标点；`…`（U+2026）等仍是 1 列。
+    const dispWidth = (s) => {
+        let w = 0;
+        for (const ch of s)
+            w += (ch.codePointAt(0) ?? 0) >= 0x2e80 ? 2 : 1;
+        return w;
+    };
+    const pad = (s, n) => {
+        const w = dispWidth(s);
+        return w >= n ? s : s + ' '.repeat(n - w);
+    };
     const fmtMs = (ms) => (ms >= 1000 ? `${(ms / 1000).toFixed(2)}s` : `${ms}ms`);
     console.log(`trace 文件  ${file}`);
     console.log(`runs       ${traces.length}（失败 ${traces.length - okRuns}）${badLines > 0 ? `  ·  跳过无法解析 ${badLines} 行` : ''}`);
@@ -141,6 +265,18 @@ export async function reportCommand(args) {
     if (failRows.length > 3)
         console.log(`  …另有 ${failRows.length - 3} 条失败 run`);
     console.log('');
+    // G6 区块：**无论有没有会话都打**。没配 `session: { store, id }` 时只会有一行
+    // `(无会话)` —— 那是**如实呈现**（说明宿主没开会话），不是缺陷（见设计稿 §6）。
+    console.log(`${pad('session', 34)} ${pad('runs', 6)} ${pad('ok', 5)} ${pad('fail', 6)} ${pad('total', 9)} ${pad('cost', 12)} ${pad('cost/ok', 12)}`);
+    for (const r of sessions) {
+        console.log(`${pad(r.session, 34)} ${pad(String(r.runs), 6)} ${pad(String(r.succeeded), 5)} ` +
+            `${pad(String(r.failed), 6)} ${pad(fmtMs(r.totalMs), 9)} ` +
+            `${pad(r.costUsd != null ? r.costUsd.toFixed(6) : '-', 12)} ` +
+            // `costPerSuccess` 为 null 有两种来路（没成本 / 没成功），两者都只能给 `-` ——
+            // 区别在 ok 列上写着（ok = 0 时就是后者）。
+            `${pad(r.costPerSuccess != null ? r.costPerSuccess.toFixed(6) : '-', 12)}`);
+    }
+    console.log('');
     if (rows.length === 0) {
         console.log('（没有可归因的能力：这些 trace 里既没有 capability span，也没有 tool.output 事件）');
         return 0;

package/dist/templates/package.json

@@ -11,10 +11,10 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@migor/agentia": "^0.10.2"
+    "@migor/agentia": "^0.10.3"
   },
   "devDependencies": {
-    "@migor/cli": "^0.10.2",
+    "@migor/cli": "^0.10.3",
     "tsx": "^4.19.0",
     "typescript": "^7.0.2",
     "@types/node": "^22.0.0"

package/dist/templates/tsconfig.json

@@ -7,6 +7,8 @@
       "ES2022"
     ],
     "strict": true,
+    "exactOptionalPropertyTypes": true,
+    "forceConsistentCasingInFileNames": true,
     "rootDir": "src",
     "outDir": "dist",
     "types": [

package/dist/templates.js

@@ -4,7 +4,7 @@
  * 字符串不过编译器：模板代码对仓库自己的 typecheck/lint 不可见，缺陷要等用户
  * npm install 后才暴露（discover 路径「生产必崩」就是这么漏出去的）。真文件化后
  * 模板被仓库自己的工具链全程照看：`tsconfig.templates.json` 把它纳入 tsc
- * （'@migor/agentia' 经 paths 映射到框架 src），Biome 照常收 lint/format。
+ * （'@migor/agentia' 经 paths 映射到框架 src）；Biome 收 lint，formatter 对 templates/** 关闭（生成物字节是兼容契约，见 biome.jsonc）。
  *
  * 占位符纪律：token 只许出现在**字符串 / 注释 / 标识符**位置
  * （`__PROJECT_NAME__` / `__NAME__` / `__CLASS_NAME__` / `__METHOD_NAME__`），

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@migor/cli",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Agentia 框架命令行工具：create 脚手架 + g 能力生成 + dev 本地可观测面板（trace inspector）",
   "type": "module",
   "bin": {