tyc-cli 0.3.7 → 0.3.9

package/dist/oauth.js

@@ -1,6 +1,19 @@
 import { spawn } from "node:child_process";
 import { createHash, randomBytes } from "node:crypto";
 import { createServer } from "node:http";
+export const DEVICE_CODE_GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
+export class OAuthTokenEndpointError extends Error {
+    status;
+    error;
+    errorDescription;
+    constructor(status, error, errorDescription) {
+        super(errorDescription ? `${error}: ${errorDescription}` : error);
+        this.name = "OAuthTokenEndpointError";
+        this.status = status;
+        this.error = error;
+        this.errorDescription = errorDescription;
+    }
+}
 function trimRightSlash(v) {
     return v.replace(/\/+$/, "");
 }
@@ -123,10 +136,16 @@ export async function discoverAuthorizationServer(issuer) {
                 return {
                     authorizationEndpoint: metadata.authorization_endpoint,
                     tokenEndpoint: metadata.token_endpoint,
+                    deviceAuthorizationEndpoint: typeof metadata.device_authorization_endpoint === "string"
+                        ? metadata.device_authorization_endpoint
+                        : undefined,
                     registrationEndpoint: typeof metadata.registration_endpoint === "string"
                         ? metadata.registration_endpoint
                         : undefined,
                     issuer,
+                    grantTypesSupported: Array.isArray(metadata.grant_types_supported)
+                        ? metadata.grant_types_supported.filter((v) => typeof v === "string")
+                        : undefined,
                     resourceDocumentation: typeof metadata.resource_documentation === "string"
                         ? metadata.resource_documentation
                         : undefined,
@@ -189,13 +208,20 @@ export async function startCallbackServer(opts) {
     let server;
     let settled = false;
     let timer;
+    const close = () => {
+        settled = true;
+        if (timer)
+            clearTimeout(timer);
+        server?.close();
+        server?.closeIdleConnections?.();
+    };
     const codePromise = new Promise((resolve, reject) => {
         timer = setTimeout(() => {
             if (settled)
                 return;
             settled = true;
             reject(new Error("等待 OAuth 回调超时"));
-            server?.close();
+            close();
         }, opts.timeoutMs);
         server = createServer((req, res) => {
             const url = new URL(req.url || "/", `http://${req.headers.host || opts.host}`);
@@ -218,7 +244,7 @@ export async function startCallbackServer(opts) {
                 res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
                 res.end(callbackHTML("OAuth 登录失败", "state 校验失败，请回到终端重新运行 tyc login。"));
                 reject(new Error("OAuth state mismatch"));
-                server?.close();
+                close();
                 return;
             }
             if (error) {
@@ -226,7 +252,7 @@ export async function startCallbackServer(opts) {
                 res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
                 res.end(callbackHTML("OAuth 登录失败", errorDescription || error));
                 reject(new Error(`OAuth error: ${errorDescription || error}`));
-                server?.close();
+                close();
                 return;
             }
             if (!code) {
@@ -234,49 +260,52 @@ export async function startCallbackServer(opts) {
                 res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
                 res.end(callbackHTML("OAuth 登录失败", "授权服务未返回 code。"));
                 reject(new Error("OAuth callback missing code"));
-                server?.close();
+                close();
                 return;
             }
             settled = true;
             res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
             res.end(callbackHTML("OAuth 登录成功", "tyc CLI 已收到授权结果，可以关闭这个窗口。"));
             resolve(code);
-            server?.close();
+            close();
         });
     });
-    await new Promise((resolve, reject) => {
-        if (!server) {
-            reject(new Error("callback server not initialized"));
-            return;
-        }
-        const onError = (err) => reject(err);
-        server.once("error", onError);
-        server.listen(opts.port, opts.host, () => {
-            server?.off("error", onError);
-            resolve();
+    // Registration/browser setup happens before waitForCode(). Keep an early
+    // callback rejection handled while preserving it for that eventual await.
+    void codePromise.catch(() => { });
+    try {
+        await new Promise((resolve, reject) => {
+            if (!server) {
+                reject(new Error("callback server not initialized"));
+                return;
+            }
+            const onError = (err) => reject(err);
+            server.once("error", onError);
+            server.listen(opts.port, opts.host, () => {
+                server?.off("error", onError);
+                resolve();
+            });
         });
-    });
+    }
+    catch (err) {
+        close();
+        throw err;
+    }
     const address = server?.address();
     if (!address || typeof address.port !== "number") {
-        server?.close();
+        close();
         throw new Error("无法启动 OAuth 本地回调服务");
     }
     const redirectUri = `http://${opts.host}:${address.port}${opts.path}`;
     return {
         redirectUri,
-        close: () => {
-            if (timer)
-                clearTimeout(timer);
-            server?.close();
-        },
+        close,
         waitForCode: async () => {
             try {
                 return await codePromise;
             }
             finally {
-                if (timer)
-                    clearTimeout(timer);
-                server?.close();
+                close();
             }
         },
     };
@@ -315,6 +344,54 @@ export async function registerDynamicOAuthClient(opts) {
         clientSecret: registered.client_secret,
     };
 }
+export async function requestDeviceAuthorization(opts) {
+    const body = new URLSearchParams();
+    body.set("client_id", opts.clientId);
+    body.set("scope", opts.scope);
+    if (opts.clientSecret)
+        body.set("client_secret", opts.clientSecret);
+    if (opts.resource)
+        body.set("resource", opts.resource);
+    const resp = await fetch(opts.deviceAuthorizationEndpoint, {
+        method: "POST",
+        headers: {
+            Accept: "application/json",
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body,
+    });
+    const text = await resp.text();
+    if (resp.status < 200 || resp.status >= 300) {
+        throw new Error(`device authorization HTTP ${resp.status}: ${text.slice(0, 500)}`);
+    }
+    const payload = JSON.parse(text);
+    if (!payload.device_code || !payload.user_code || !payload.verification_uri) {
+        throw new Error("device authorization response missing required fields");
+    }
+    return {
+        ...payload,
+        device_code: payload.device_code,
+        user_code: payload.user_code,
+        verification_uri: payload.verification_uri,
+        expires_in: Number(payload.expires_in) > 0 ? Number(payload.expires_in) : 600,
+        interval: Number(payload.interval) > 0 ? Number(payload.interval) : 5,
+    };
+}
+function parseOAuthTokenError(status, text) {
+    try {
+        const payload = JSON.parse(text);
+        const error = typeof payload.error === "string" && payload.error
+            ? payload.error
+            : `token endpoint HTTP ${status}`;
+        const description = typeof payload.error_description === "string"
+            ? payload.error_description
+            : undefined;
+        return new OAuthTokenEndpointError(status, error, description);
+    }
+    catch {
+        return new OAuthTokenEndpointError(status, `token endpoint HTTP ${status}`, text.slice(0, 500));
+    }
+}
 export async function exchangeAuthorizationCode(opts) {
     const body = new URLSearchParams();
     body.set("grant_type", "authorization_code");
@@ -344,6 +421,33 @@ export async function exchangeAuthorizationCode(opts) {
     }
     return token;
 }
+export async function exchangeDeviceCode(opts) {
+    const body = new URLSearchParams();
+    body.set("grant_type", DEVICE_CODE_GRANT_TYPE);
+    body.set("client_id", opts.clientId);
+    body.set("device_code", opts.deviceCode);
+    if (opts.clientSecret)
+        body.set("client_secret", opts.clientSecret);
+    if (opts.resource)
+        body.set("resource", opts.resource);
+    const resp = await fetch(opts.tokenEndpoint, {
+        method: "POST",
+        headers: {
+            Accept: "application/json",
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body,
+    });
+    const text = await resp.text();
+    if (resp.status < 200 || resp.status >= 300) {
+        throw parseOAuthTokenError(resp.status, text);
+    }
+    const token = JSON.parse(text);
+    if (!token.access_token) {
+        throw new Error("token endpoint response missing access_token");
+    }
+    return token;
+}
 export async function exchangeRefreshToken(opts) {
     const body = new URLSearchParams();
     body.set("grant_type", "refresh_token");

package/dist/oauthPending.js

@@ -1,7 +1,8 @@
 // ~/.tyc/oauth_pending.json 读写
 //
-// 非阻塞 OAuth 登录会先保存 PKCE code_verifier、state、client_id 等一次性上下文；
-// 用户完成浏览器授权后，再用 tyc login --callback-token <code_or_callback_url> 继续换取 access token。
+// 非阻塞 OAuth 登录会保存一次性上下文：
+// - legacy PKCE 模式保存 code_verifier/state，靠 --callback-token 续接；
+// - RFC 8628 device flow 保存 device_code，靠 --resume 续接。
 import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";

package/dist/registry.js

@@ -1,7 +1,7 @@
 // 从 src/catalog.json 加载命令树元数据
 //
 // catalog.json 由 apimcp 主仓 scripts/gen_cli_catalog 生成；仅包含 CLI
-// 需要的字段（name / group / layer / cliMethod / categoryNameZh /
+// 需要的字段（name / group / layer / requiredPlan / cliMethod / categoryNameZh /
 // description / params）。不含 sources / execution / summary 等服务端
 // 内部映射，服务端实现细节不泄露。
 import { readFileSync } from "node:fs";

package/dist/utils/history.js

@@ -0,0 +1,68 @@
+const object = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+const text = (v) => typeof v === "string" ? v : JSON.stringify(v) ?? "null";
+const cell = (v) => text(v).replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+export function renderHistoryGuide(value) {
+    if (!object(value))
+        return [];
+    const lines = [`> 查询范围：${cell(value.scope)}`];
+    if (Array.isArray(value.nextTools))
+        for (const next of value.nextTools) {
+            if (object(next))
+                lines.push(`> 后续查询：\`${cell(next.toolName)}\` — ${cell(next.purpose)}`);
+        }
+    if (Array.isArray(value.notes))
+        for (const note of value.notes)
+            lines.push(`> 历史查询说明：${cell(note)}`);
+    return lines;
+}
+export function splitHistoricalPersonnel(obj, toolName) {
+    if (toolName !== "get_historical_registration" || !object(obj.sources) || !object(obj.sources.hi))
+        return undefined;
+    const hi = { ...obj.sources.hi };
+    const lines = [];
+    for (const [key, title] of [["pastLegalPersonList", "历史法定代表人"], ["pastStafferList", "历史主要人员"]]) {
+        if (!(key in hi))
+            continue;
+        const value = hi[key];
+        delete hi[key];
+        lines.push(`### ${title}\n`, "> 按来源分组完整展示；组号不代表任职阶段。\n");
+        let groups = Array.isArray(value) ? value : [value];
+        if (groups.length === 0)
+            lines.push("_(空列表)_\n");
+        if (groups.length && groups.every(object)) {
+            lines.push("单层名单：\n");
+            groups = [groups];
+        }
+        groups.forEach((group, i) => {
+            const people = Array.isArray(group) ? group : [group];
+            lines.push(`#### 第 ${i + 1} 组（${people.length} 项）\n`);
+            people.forEach((person, j) => {
+                lines.push(`人员 ${j + 1}：\n`, "| 字段 | 值 |", "|---|---|");
+                if (object(person))
+                    for (const field of Object.keys(person).sort()) {
+                        const label = field === "name" ? "名称" : field === "time" ? "变更时间" : field;
+                        lines.push(`| ${cell(label)} | ${cell(person[field])} |`);
+                    }
+                else
+                    lines.push(`| 原始项 | ${cell(person)} |`);
+                lines.push("");
+            });
+        });
+    }
+    return lines.length ? { rest: { ...obj, sources: { ...obj.sources, hi } }, markdown: lines.join("\n") } : undefined;
+}
+function changeDate(value) {
+    if (!object(value) || typeof value.changeTime !== "string")
+        return "";
+    const match = /^(\d{4}-\d{2}-\d{2})(?:$|[ T])/.exec(value.changeTime);
+    if (!match)
+        return "";
+    const day = new Date(`${match[1]}T00:00:00Z`);
+    return !Number.isNaN(day.getTime()) && day.toISOString().slice(0, 10) === match[1] ? match[1] : "";
+}
+export function changeRecordsForDisplay(records) {
+    return [...records].sort((a, b) => {
+        const x = changeDate(a), y = changeDate(b);
+        return x < y ? 1 : x > y ? -1 : 0;
+    });
+}

package/dist/utils/jsonToMarkdown.js

@@ -5,21 +5,14 @@
  * - 顶层简单字段渲染为 key/value 表格
  * - 项目元数据（_summary / _empty / _warnings）单独凸显
  * - items 列表自动渲染为表格
- * - 嵌套对象/对象数组优雅折叠
+ * - 嵌套对象/对象数组完整保留；显式截断由统一输出层负责
  */
-const META_KEYS = new Set(["_summary", "_empty", "_warnings", "_tip"]);
+import { renderChangeRecords, splitChangeRecords } from "./personnelChanges.js";
+import { renderHistoryGuide, splitHistoricalPersonnel } from "./history.js";
+const META_KEYS = new Set(["_summary", "_empty", "_warnings", "_tip", "_truncated", "_pagination", "_riskOverview", "_dateSemantics", "_fieldSemantics", "_historyGuide", "_source"]);
 function isPlainObject(v) {
     return v !== null && typeof v === "object" && !Array.isArray(v);
 }
-function isEmptyValue(v) {
-    if (v === null || v === undefined || v === "")
-        return true;
-    if (Array.isArray(v) && v.length === 0)
-        return true;
-    if (isPlainObject(v) && Object.keys(v).length === 0)
-        return true;
-    return false;
-}
 function formatPrimitive(v) {
     if (v === null || v === undefined || v === "")
         return "-";
@@ -49,21 +42,16 @@ function formatArrayCell(arr) {
         return arr.map(formatPrimitive).join(", ");
     }
     // 对象数组：紧凑 JSON
-    return JSON.stringify(arr).slice(0, 80) + (JSON.stringify(arr).length > 80 ? "…" : "");
+    return JSON.stringify(arr);
 }
 function formatObjectInline(obj) {
-    const parts = [];
-    for (const [k, v] of Object.entries(obj)) {
-        if (isEmptyValue(v))
-            continue;
-        if (isPlainObject(v) || Array.isArray(v)) {
-            parts.push(`${k}=…`);
-        }
-        else {
-            parts.push(`${k}=${formatPrimitive(v)}`);
-        }
-    }
-    return parts.join("; ") || "-";
+    return JSON.stringify(obj);
+}
+function renderJSONBlock(value) {
+    const text = JSON.stringify(value, null, 2);
+    const longestFence = Math.max(0, ...(text.match(/`+/g) || []).map((s) => s.length));
+    const fence = "`".repeat(Math.max(3, longestFence + 1));
+    return `${fence}json\n${text}\n${fence}\n`;
 }
 function renderItemsTable(items, title = "items") {
     if (items.length === 0) {
@@ -75,6 +63,9 @@ function renderItemsTable(items, title = "items") {
         items.forEach((v, i) => lines.push(`${i + 1}. ${formatPrimitive(v)}`));
         return lines.join("\n") + "\n";
     }
+    if (!items.every(isPlainObject)) {
+        return `\n### ${title}（${items.length} 条）\n\n${renderJSONBlock(items)}`;
+    }
     // 对象数组 → Markdown 表格
     const cols = getAllKeys(items);
     if (cols.length === 0)
@@ -119,16 +110,71 @@ function renderTopFields(obj) {
     return lines.join("\n") + "\n";
 }
 function renderMeta(obj) {
-    const lines = [];
+    const lines = renderHistoryGuide(obj._historyGuide);
+    const sourceNotes = (payload, prefix = "") => {
+        if (!isPlainObject(payload._source))
+            return;
+        const source = payload._source;
+        lines.push(`> ${prefix}数据来源：${escapeCell(formatPrimitive(source.api))}；${escapeCell(formatPrimitive(source.meaning))}`);
+        lines.push(`> ${prefix}来源时间口径：${escapeCell(formatPrimitive(source.temporalNote))}`);
+    };
+    sourceNotes(obj);
+    if (isPlainObject(obj.sources)) {
+        for (const [scope, payload] of Object.entries(obj.sources)) {
+            if (isPlainObject(payload))
+                sourceNotes(payload, `${scope}：`);
+        }
+    }
+    if (isPlainObject(obj._fieldSemantics)) {
+        for (const key of Object.keys(obj._fieldSemantics).sort()) {
+            const note = obj._fieldSemantics[key];
+            if (typeof note === "string" && note)
+                lines.push(`> 字段口径：${escapeCell(note)}`);
+        }
+    }
+    if (isPlainObject(obj._dateSemantics)) {
+        for (const key of ["change_time", "ftShareholding", "changeTime", "createTime", "historicalTime", "firstAppointment"]) {
+            const note = obj._dateSemantics[key];
+            if (typeof note === "string" && note)
+                lines.push(`> 时间口径：${escapeCell(note)}`);
+        }
+    }
     if (obj._summary) {
         lines.push(`> 📋 **摘要**：${formatPrimitive(obj._summary)}`);
     }
     if (obj._tip) {
         lines.push(`> 💡 **提示**：${formatPrimitive(obj._tip)}`);
     }
-    if (obj._empty === true) {
+    if (obj._empty === true && !isPlainObject(obj._riskOverview)) {
         lines.push(`> ⚪ **空结果**：未发现该维度记录`);
     }
+    if (isPlainObject(obj._pagination)) {
+        const p = obj._pagination;
+        const parts = [];
+        if (p.page !== undefined)
+            parts.push(`第${p.page}页`);
+        if (p.requested_page_size !== undefined)
+            parts.push(`请求每页${p.requested_page_size}条`);
+        if (p.effective_page_size !== undefined)
+            parts.push(`实际每页${p.effective_page_size}条`);
+        if (p.max_page_size !== undefined)
+            parts.push(`上游每页上限${p.max_page_size}条`);
+        parts.push(`本次返回${p.returned}条`);
+        parts.push(p.total === undefined ? "全量总数未知" : `共${p.total}条`);
+        if (p.has_more === true) {
+            parts.push(`还有下一页；沿用原命令和主体/筛选参数，传 --pageNum ${p.next_page} --pageSize ${p.effective_page_size}`);
+        }
+        else if (p.has_more === false) {
+            parts.push("已到末页");
+        }
+        else {
+            parts.push("尚不能确定是否还有下一页");
+        }
+        lines.push(`> 分页：${parts.join("；")}。`);
+    }
+    else if (obj._truncated === true) {
+        lines.push("> 当前返回不是全量；请根据工具分页参数继续查询。");
+    }
     if (obj._warnings && isPlainObject(obj._warnings) && Object.keys(obj._warnings).length > 0) {
         lines.push(`> ⚠️ **警告**：`);
         for (const [path, msg] of Object.entries(obj._warnings)) {
@@ -137,6 +183,55 @@ function renderMeta(obj) {
     }
     return lines.length > 0 ? lines.join("\n") + "\n" : "";
 }
+function renderRiskOverview(obj) {
+    const parts = [];
+    const meta = obj._riskOverview;
+    if (isPlainObject(meta)) {
+        // State and counts come from Shared Core; never derive them from local rows.
+        parts.push(`> 数据状态：${formatPrimitive(meta.dataStatus)}；摘要及诊断行数：${formatPrimitive(meta.displayRowCount)}；风险事件总数：未确认。`);
+        parts.push(`> 计数口径：${formatPrimitive(meta.countMeaning)}`);
+        if (meta.reportedTotal !== undefined) {
+            parts.push(`> 上游报告总数：${formatPrimitive(meta.reportedTotal)}（保留原始口径，未经事件去重核实）。`);
+        }
+        if (Array.isArray(meta.reportedCounts) && meta.reportedCounts.length > 0) {
+            parts.push(renderItemsTable(meta.reportedCounts, "上游计数来源"));
+        }
+        if (Array.isArray(meta.issues)) {
+            parts.push(...meta.issues.map((issue) => `> 数据说明：${escapeCell(formatPrimitive(issue))}`));
+        }
+    }
+    const sections = [
+        ["toolRisks", "可用专项工具获取详情"],
+        ["detailRisks", "需通过风险 ID 获取详情"],
+        ["relationRiskNotes", "周边风险提示"],
+        ["warningRisks", "预警提醒"],
+        ["unclassifiedRisks", "未分类风险及诊断信息"],
+    ];
+    const sectionKeys = new Set(sections.map(([key]) => key));
+    const otherFields = Object.fromEntries(Object.entries(obj).filter(([key]) => !META_KEYS.has(key) && !sectionKeys.has(key) && key !== "name" && !(key === "total" && isPlainObject(meta))));
+    if (Object.keys(otherFields).length > 0)
+        parts.push(renderTopFields(otherFields));
+    for (const [key, title] of sections) {
+        const rows = obj[key];
+        if (!Array.isArray(rows) || rows.length === 0)
+            continue;
+        if (key === "detailRisks") {
+            parts.push("使用 get_risk_detail，将 riskId 作为 id 参数、同一行 type 作为 type 参数。");
+        }
+        parts.push(renderItemsTable(rows.map((row) => {
+            if (!isPlainObject(row) || !Array.isArray(row.examples))
+                return row;
+            const { examples, ...rest } = row;
+            return rest;
+        }), title));
+        for (const row of rows) {
+            if (isPlainObject(row) && Array.isArray(row.examples) && row.examples.length > 0) {
+                parts.push(renderItemsTable(row.examples, `${title} / ${formatPrimitive(row.riskType)}：关联主体与原始风险示例`));
+            }
+        }
+    }
+    return parts.join("\n\n");
+}
 function renderNestedObjects(obj) {
     const lines = [];
     for (const [k, v] of Object.entries(obj)) {
@@ -181,6 +276,15 @@ export function jsonToMarkdown(value, toolName) {
         return "```\n" + formatPrimitive(value) + "\n```\n";
     }
     const obj = value;
+    const historical = splitHistoricalPersonnel(obj, toolName);
+    if (historical)
+        return jsonToMarkdown(historical.rest, toolName) + "\n" + historical.markdown;
+    const changes = splitChangeRecords(obj, toolName);
+    if (changes) {
+        // The recursive call receives a copy without the extracted list. Keep raw
+        // code blocks verbatim: the generic newline compaction must not touch them.
+        return jsonToMarkdown(changes.rest, toolName) + "\n" + renderChangeRecords(changes.records, changes.title);
+    }
     const parts = [];
     // 标题
     if (toolName) {
@@ -193,6 +297,10 @@ export function jsonToMarkdown(value, toolName) {
     const meta = renderMeta(obj);
     if (meta)
         parts.push(meta);
+    if (toolName === "get_risk_overview" || isPlainObject(obj._riskOverview)) {
+        parts.push(renderRiskOverview(obj));
+        return parts.join("\n").replace(/\n{3,}/g, "\n\n");
+    }
     // 顶层字段
     const topFields = renderTopFields(obj);
     parts.push(topFields);

package/dist/utils/personnelChanges.js

@@ -0,0 +1,74 @@
+// Presentation only: all personnel extraction and statuses come from Shared Core.
+import { changeRecordsForDisplay } from "./history.js";
+const object = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+const text = (v) => typeof v === "string" ? v : JSON.stringify(v) ?? "null";
+const cell = (v) => (v === undefined || v === "" ? "-" : text(v)).replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+function block(value) {
+    const raw = text(value);
+    const longest = Math.max(0, ...(raw.match(/`+/g) ?? []).map((s) => s.length));
+    const fence = "`".repeat(Math.max(3, longest + 1));
+    return `${fence}text\n${raw}\n${fence}\n`;
+}
+export function splitChangeRecords(obj, toolName) {
+    if (toolName === "get_change_records" && Array.isArray(obj.items)) {
+        const rest = { ...obj };
+        delete rest.items;
+        return { rest, records: obj.items, title: "变更记录" };
+    }
+    if (toolName === "get_historical_registration" && object(obj.sources) && object(obj.sources.cb) && Array.isArray(obj.sources.cb.changeList)) {
+        const cb = { ...obj.sources.cb };
+        delete cb.changeList;
+        return { rest: { ...obj, sources: { ...obj.sources, cb } }, records: obj.sources.cb.changeList, title: "工商信息 / 变更记录" };
+    }
+    return undefined;
+}
+function renderSide(title, side) {
+    if (!object(side))
+        return "";
+    const out = [`#### ${title}\n`, `解析状态：${cell(side.status)}\n`];
+    const people = Array.isArray(side.people) ? side.people : [];
+    if (people.length) {
+        out.push("| 姓名 | 职务原值 | 法定代表人标志原值 | 显式变更标记 | 其他登记字段 |", "|---|---|---|---|---|");
+        for (const person of people) {
+            if (!object(person)) {
+                out.push(block(person));
+                continue;
+            }
+            const fields = Array.isArray(person.fields) ? person.fields : [];
+            const other = fields.filter((field) => !object(field) || !["姓名", "职务", "法定代表人标志"].includes(String(field.key)));
+            out.push(`| ${[person.name, person.position, person.legalRepresentativeFlag, person.marker, other].map(cell).join(" | ")} |`);
+        }
+        out.push("");
+    }
+    if (Array.isArray(side.warnings))
+        for (const warning of side.warnings)
+            out.push(`> 解析说明：${cell(warning)}\n`);
+    if (Array.isArray(side.unparsedFragments))
+        for (const fragment of side.unparsedFragments)
+            out.push("未解析片段：\n", block(fragment));
+    return out.join("\n");
+}
+export function renderChangeRecords(records, title) {
+    const out = [`## ${title}（${records.length} 条）\n`, "> 本次返回记录按变更日期倒序展示；同日维持来源顺序，日期未知置后，不代表全量历程。\n"];
+    changeRecordsForDisplay(records).forEach((value, index) => {
+        if (!object(value)) {
+            out.push(block(value));
+            return;
+        }
+        out.push(`### 第 ${index + 1} 条 · ${cell(value.changeTime)} · ${cell(value.changeItem)}\n`);
+        const parsed = object(value._parsed) && value._parsed.version === 1 ? value._parsed : undefined;
+        for (const [key, v] of Object.entries(value)) {
+            if (["changeTime", "changeItem", "contentBefore", "contentAfter"].includes(key) || (key === "_parsed" && parsed))
+                continue;
+            out.push(`${key === "createTime" ? "记录创建日期" : key}：${cell(v)}\n`);
+        }
+        if (parsed) {
+            out.push(`> 解析版本：${cell(parsed.version)}；原文完整性：${cell(parsed.sourceCompleteness)}（未确认）。解析结果不是完整任职快照，标志原值未转换。\n`);
+            out.push(renderSide("变更前人员", parsed.before), renderSide("变更后人员", parsed.after));
+        }
+        for (const [key, name] of [["contentBefore", "变更前原文"], ["contentAfter", "变更后原文"]]) {
+            out.push(`#### ${name}\n`, key in value ? block(value[key]) : "_(原字段未返回)_\n");
+        }
+    });
+    return out.join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tyc-cli",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "天眼查 AI CLI — 162 个业务语义聚合工具 · 默认 Shared Core 调用 · 兼容 MCP transport",
   "main": "dist/index.js",
   "bin": {