@migor/cli 0.10.6 → 0.10.8

package/dist/inspector/trace-view.css

@@ -217,3 +217,159 @@
   word-break: break-word;
   min-width: 0;
 }
+
+/* —— 结构化正文（2026-11-11）：`full` 是对象/数组时，展开行**下方**多一个兄弟块 ——
+   此前只有一条展开路：整串无缩进的 JSON 塞进 `.tr-io` 再靠 `.tr-open` 换行，20 个键就在
+   400px 宽的右栏里折成十几行连续文本（页面不报错、无溢出，只是人读不了）。
+
+   为什么是兄弟块、不是 `.tr-io` 的子节点：`.tr-row` 是 flex + nowrap，往里塞块级内容会把
+   树的列对齐打乱；独立成块才能自己换行、自己缩进、自己滚。
+
+   为什么 `.tr-io` 只是**隐藏**而不是不渲染：它仍持有原文（`textContent` = `JSON.stringify`），
+   `test/view.test.js` 的「展开拿到的是原文、不是摘要」与用户选中复制都靠它 ——
+   这里改的是画法，不是数据。 */
+.tr-row.tr-structured .tr-io {
+  display: none;
+}
+.tr-full {
+  margin: 2px 0 8px 2.2em; /* 与 `.tr-pre` 的树形前缀对齐，不跟父行抢左侧 */
+  border-left: 2px solid #2a2a31;
+  padding: 4px 0 4px 10px;
+  font-size: 11.5px;
+  line-height: 1.55;
+  /* 与 `.tr-row.tr-open .tr-io` 同一个高度上限：出参动辄上千行，不限高会把整棵树推出屏幕 */
+  max-height: 60vh;
+  overflow: auto;
+  white-space: normal;
+}
+.tr-full-head {
+  display: flex;
+  gap: 10px;
+  margin-bottom: 2px;
+  font-size: 10.5px;
+  color: var(--faint);
+}
+.tr-full-copy {
+  color: var(--ice);
+  cursor: pointer;
+}
+.tr-full-copy:hover {
+  text-decoration: underline;
+}
+/* 每一行自己换行：长字符串（工具出参常见）必须能折，否则横向滚动条把缩进吃掉 */
+.tr-full-line {
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  border-radius: 3px;
+}
+/* 可折叠的行（有 data-fold）才给 hover 反馈 —— 叶子行点了没事发生，就不该有可点的样子 */
+.tr-full-line[data-fold] {
+  cursor: pointer;
+}
+.tr-full-line[data-fold]:hover {
+  background: #17171a;
+}
+/* 折叠箭头与 .tr-caret 不同：它不是「这一行能展开」的唯一指示（同一行还写着 `{ object · 4 项 }`，
+   折叠态的值本身就说明了一切），所以不做常显的对比度承诺，跟着 hover 走。
+   **定宽**：叶子行也占这一格（见 full-view.js 的 caretSlot），否则同层键名会在有无箭头之间
+   左右跳 —— 一列键名对齐是这类面板最基本的可读性。 */
+.tr-full-caret {
+  display: inline-block;
+  width: 10px;
+  text-align: center;
+  color: var(--faint);
+  font-size: 10px;
+  margin-right: 3px;
+}
+.tr-full-hint {
+  color: var(--faint);
+}
+/* 「这个字符串里装着 JSON」的标记。它不是装饰，是**事实的一部分**：没有它，读者会以为
+   工具真的返回了对象。所以常显、不等 hover，也不跟 .tr-full-hint 一样隐形 —— 但保持
+   低对比度，避免每行都在喊。 */
+.tr-full-json {
+  color: var(--faint);
+  font-size: 10px;
+  line-height: 1.4;
+  border: 1px solid #2c2c32;
+  border-radius: 3px;
+  padding: 0 4px;
+  margin-right: 4px;
+}
+/* `⧉` 复制路径：hover 才露。与 .tr-caret 的区别是**它暴露的是动作、不是信息** ——
+   路径的内容（键名）始终写在行里，常显只会给每行多一个字形噪声。
+   没有剪贴板实现时照样显示、点了不谎报成功（见 full-view.js 的 copyInto）。 */
+.tr-full-path {
+  opacity: 0;
+  color: var(--ice);
+  cursor: pointer;
+  font-size: 10px;
+  margin: 0 4px;
+  transition: opacity 0.12s;
+}
+.tr-full-line:hover .tr-full-path,
+.tr-full-table th:hover .tr-full-path {
+  opacity: 1;
+}
+/* —— 同构对象数组 → 表格（2026-11-11 晚）——
+   3 行 `{name,score}` 在树形里要花 9 行重复键名，成表后是 1 行表头 + 3 行数据，
+   而且列天然对齐。只在「真同构且全标量列」时启用（判据在 full-view.js 的 tableColsOf），
+   否则回落树形 —— 表格里没法逐层展开，判错一次就是丢数据。 */
+.tr-full-table {
+  border-collapse: collapse;
+  margin: 2px 0 4px;
+  font-size: 11.5px;
+}
+/* 缩进：列数/行数都是动态的，没有能写死的 inline style（stub 里也没有 style 字段），
+   所以按层级给属性选择器 —— 0 层不写 data-depth，自然不缩进。 */
+.tr-full-table[data-depth="1"] {
+  margin-left: 2ch;
+}
+.tr-full-table[data-depth="2"] {
+  margin-left: 4ch;
+}
+.tr-full-table[data-depth="3"] {
+  margin-left: 6ch;
+}
+.tr-full-table[data-depth="4"] {
+  margin-left: 8ch;
+}
+.tr-full-table[data-depth="5"] {
+  margin-left: 10ch;
+}
+.tr-full-table th {
+  text-align: left;
+  font-weight: 500;
+  color: #71717a;
+  padding: 0 12px 1px 0;
+  border-bottom: 1px solid #27272a;
+  white-space: nowrap;
+}
+.tr-full-table td {
+  padding: 1px 12px 1px 0;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+}
+.tr-full-table tbody tr:hover {
+  background: #17171a;
+}
+/* 缩进用真空格 + `pre`，不靠 padding —— 嵌套层级要能被**选中复制**带出去 */
+.tr-full-indent {
+  white-space: pre;
+}
+.tr-full-key {
+  color: #a1a1aa;
+  margin-right: 2px;
+}
+.tr-full-str {
+  color: #9ece6a;
+}
+.tr-full-num {
+  color: #e0af68;
+}
+.tr-full-bool {
+  color: #7dcfff;
+}
+.tr-full-null {
+  color: var(--faint);
+}

package/dist/inspector/view.js

@@ -17,6 +17,16 @@
  * 宿主需提供的 CSS 变量：--ice --faint --text（见 trace-view.css）。
  */
 
+/* 展开态的正文有两种形状，由 `full` 的类型决定（2026-11-11，2026-11-12 扩了一档）：
+ *   - 纯文本字符串 → 老路：`.tr-io` 里放原文，靠 `.tr-open` 换行（纯文本正文、官网模拟回放）；
+ *   - 对象/数组 → 追加一个 `.tr-full` 结构化块（折叠 / 成表 / 路径复制），`.tr-io` 由 CSS 隐藏；
+ *   - **装着 JSON 的字符串**（`content: "{\"rows\":[...]}"`，工具把结构序列化后塞回文本字段）
+ *     → 同上一档，块头写明「string · N 字符 → object · M 项」并打 `str→json` 标记。
+ * 判据与块内完全同源（`hasStructuredBody`），「挂不挂块」与「块里画什么」因此不会跑偏。
+ * 前两档并存是刻意的：纯文本那条路有 test/style.test.js 的两个不变量守着（最小宽度、caret 常显），
+ * 全换成本件会让那两个守卫失去落点。 */
+import { createFullView, hasStructuredBody } from './full-view.js';
+
 export const CAP_ICO = { tool: '⚙', skill: '◆', prompt: '¶', subagent: '⊕' };
 
 /** 能力类型取自名字前缀（tool: / skill: / prompt: / subagent:） */
@@ -88,6 +98,9 @@ export function createTraceView(rootEl, opts = {}) {
   /* 展开态的行 key 集合 + 事件 key 发号器。两者都必须活在 renderTrace 之外：
      渲染是【全量重建】（rootEl.innerHTML = ''），状态放进 DOM 或渲染过程里就活不过下一次事件。 */
   const expanded = new Set();
+  /* 结构化块内部的折叠状态，按事件键一份（`ev.key` → 路径 → 是否展开）。
+     与 `expanded` 同一条理由，而且更硬：块本身每次重建都会 new 一个，状态只能挂在树上。 */
+  const folds = new Map();
   let evSeq = 0;
 
   /** 正在选文本时不要收起/展开 —— 鼠标拖选到行外松手会补一次 click，否则选完就自己合上了 */
@@ -136,20 +149,36 @@ export function createTraceView(rootEl, opts = {}) {
         // 非 tool.* 事件（usage.unpriced / llm.retry / budget.* / context.budget）没有工具名 ——
         // 这一格整个不渲染，别把「无工具」显示成假工具名（.tr-name 是 flex:none，.tr-io 自然占满）
         if (ev.tool) row.appendChild(el('span', 'tr-name', ev.tool));
-        // 展开态用全文（ev.full），折叠态用摘要（ev.text）—— 折叠态因此与加展开之前逐字一致
-        const io = el('span', 'tr-io', (open ? ev.full : ev.text) || '');
+        // 展开态用全文（ev.full），折叠态用摘要（ev.text）—— 折叠态因此与加展开之前逐字一致。
+        // `full` 是对象/数组、或**装着 JSON 的字符串**时（2026-11-11 / 2026-11-12）：`.tr-io`
+        // 仍放**原文**（结构化块挂在行后、由 CSS 隐藏本格），所以「展开拿到的是原文而不是
+        // 62 字符摘要」这条不变量原样成立。
+        const structured = hasStructuredBody(ev.full);
+        const fullText = structured ? rawArg(ev.full) : ev.full || '';
+        const io = el('span', 'tr-io', (open ? fullText : ev.text) || '');
         // 展开后正文已在行里，再挂一个占满整行的原生 tooltip 只会挡视线
         io.title = open ? '' : ev.text || '';
         row.appendChild(io);
         if (ev.full) {
           row.dataset.expandable = '1'; // 可展开标记：CSS 靠它出 caret / cursor，测试靠它找行
           row.appendChild(el('span', 'tr-caret', open ? '▾' : '▸'));
-          if (open) row.className += ' tr-open';
+          if (open) row.className += ' tr-open' + (structured ? ' tr-structured' : '');
           row.addEventListener('click', () => {
             if (!hasSelection()) toggleExpand(ev.key);
           });
         }
         rootEl.appendChild(row);
+        // 结构化正文是**兄弟块**而不是 `.tr-io` 的子节点：行是 flex + nowrap，
+        // 塞进去会把树的列对齐打乱；独立成块才能自己换行、自己缩进。
+        // 折叠状态按事件键取一份带进去（2026-11-11 晚）：块每次重建都 new，状态不能放块里。
+        if (open && structured) {
+          let fold = folds.get(ev.key);
+          if (!fold) {
+            fold = new Map();
+            folds.set(ev.key, fold);
+          }
+          rootEl.appendChild(createFullView(ev.full, { fold }));
+        }
         return;
       }
 
@@ -224,6 +253,7 @@ export function createTraceView(rootEl, opts = {}) {
     spanMap.clear();
     spanMap.set('root', traceRoot);
     expanded.clear(); // 展开态属于上一棵树：reset 开新树时一并清掉
+    folds.clear(); // 块内折叠同理：留着只会在下一次点开时出现"莫名已折叠"的状态
     usageAcc.input = 0;
     usageAcc.output = 0;
     usageAcc.cacheRead = 0;

package/dist/inspector-routes.js

@@ -108,6 +108,10 @@ const STATIC = new Map([
     ['index.js', join(ASSETS, 'index.js')],
     ['view.js', join(ASSETS, 'view.js')],
     ['fromTrace.js', join(ASSETS, 'fromTrace.js')],
+    /* 结构化展开正文（2026-11-11）：`full` 是对象/数组时，view.js 用它铺缩进/着色/复制块。
+     * 与上面四个同性质 —— 渲染器的一部分，页面**会** import 它（view.js 的静态 import 被
+     * 剥成页面级 import 时它必须可达），漏登记 = 浏览器 404 = 面板整块模块求值失败。 */
+    ['full-view.js', join(ASSETS, 'full-view.js')],
     ['summary.js', join(ASSETS, 'summary.js')],
     ['trace-view.css', join(ASSETS, 'trace-view.css')],
     /* 单文件 bundle（`agentia view` 内联进自包含 HTML 用）。⚠️ **页面不 import 它** ——

package/dist/templates/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@migor/cli",
-  "version": "0.10.6",
+  "version": "0.10.8",
   "description": "CLI for the Agentia framework: scaffold a project, generate a capability, and open a local trace inspector for runs.",
   "type": "module",
   "bin": {