@linghun/tui 0.1.0

package/dist/chunk-ZYSN7AWW.js

@@ -0,0 +1,336 @@
+import {
+  formatRuntimePathDoctor,
+  formatStartupPathDoctor,
+  formatVerificationLevelDoctor
+} from "./chunk-CRW3636S.js";
+
+// src/terminal-readiness-presenter.ts
+var PASSABLE_STATUSES = /* @__PURE__ */ new Set(["pass"]);
+function formatTerminalReadinessDoctor(view, options = {}) {
+  const items = createReadinessItems(view);
+  if (!options.showAll) {
+    return formatTerminalReadinessDoctorSummary(view, items);
+  }
+  const passCount = items.filter((item) => PASSABLE_STATUSES.has(item.status)).length;
+  const blockedCount = items.filter((item) => item.status !== "pass").length;
+  const header = view.language === "en-US" ? "Doctor details (local/static only; not real smoke)" : "\u8BCA\u65AD\u8BE6\u60C5\uFF08\u4EC5\u672C\u5730/\u9759\u6001\u8F7B\u91CF\u68C0\u67E5\uFF1B\u4E0D\u662F\u771F\u5B9E smoke\uFF09";
+  const summary = view.language === "en-US" ? `Summary: ${passCount}/${items.length} local checks are pass; ${blockedCount} need attention. This is not Beta PASS, smoke-ready, or open-source-ready.` : `\u6458\u8981\uFF1A${passCount}/${items.length} \u9879\u672C\u5730\u68C0\u67E5\u4E3A pass\uFF1B${blockedCount} \u9879\u9700\u8981\u5904\u7406\u3002\u8FD9\u4E0D\u662F Beta PASS\u3001smoke-ready \u6216 open-source-ready\u3002`;
+  const lines = [
+    header,
+    summary,
+    view.language === "en-US" ? `Runtime: provider ${short(view.provider, 28)} \xB7 model ${short(view.model, 36)} \xB7 endpoint ${view.endpointProfile} \xB7 mode ${view.permissionMode}` : `\u8FD0\u884C\u65F6\uFF1Aprovider ${short(view.provider, 28)} \xB7 model ${short(view.model, 36)} \xB7 endpoint ${view.endpointProfile} \xB7 mode ${view.permissionMode}`,
+    view.language === "en-US" ? `Project: ${displayProject(view.projectPath)}` : `\u9879\u76EE\uFF1A${displayProject(view.projectPath)}`,
+    view.language === "en-US" ? "Checklist:" : "\u68C0\u67E5\u9879\uFF1A"
+  ];
+  for (const item of items) {
+    lines.push(
+      `- [${item.status.toUpperCase()}] ${item.label}: ${item.summary}; ${view.language === "en-US" ? "next" : "\u4E0B\u4E00\u6B65"}: ${item.nextAction}`
+    );
+  }
+  lines.push(...formatReadinessLiteSections(view));
+  lines.push(
+    view.language === "en-US" ? "Details: use /model doctor, /index doctor, /cache status, /memory, /mcp doctor, /background, /verify last, /problems." : "\u8BE6\u60C5\uFF1A\u4F7F\u7528 /model doctor\u3001/index doctor\u3001/cache status\u3001/memory\u3001/mcp doctor\u3001/background\u3001/verify last\u3001/problems\u3002"
+  );
+  return lines.join("\n");
+}
+function formatTerminalReadinessDoctorSummary(view, items) {
+  const attention = items.filter((item) => item.status !== "pass");
+  const hardBlocks = attention.filter(
+    (item) => item.status === "fail" || item.status === "blocked"
+  );
+  const conclusion = hardBlocks.length > 0 ? "BLOCK" : attention.length > 0 ? "WARN" : "OK";
+  const visible = [
+    ...hardBlocks,
+    ...attention.filter((item) => item.status !== "fail" && item.status !== "blocked")
+  ];
+  const lines = [
+    view.language === "en-US" ? `Doctor: ${conclusion} \u2014 local checks only, not a smoke or Beta verdict.` : `\u8BCA\u65AD\uFF1A${conclusion} \u2014 \u4EC5\u672C\u5730\u68C0\u67E5\uFF0C\u4E0D\u662F\u771F\u5B9E smoke \u6216 Beta \u7ED3\u8BBA\u3002`,
+    view.language === "en-US" ? `Scope: ${items.length - attention.length}/${items.length} local checks pass; ${attention.length} need attention.` : `\u8303\u56F4\uFF1A${items.length - attention.length}/${items.length} \u9879\u672C\u5730\u68C0\u67E5\u901A\u8FC7\uFF1B${attention.length} \u9879\u9700\u8981\u5904\u7406\u3002`
+  ];
+  if (visible.length === 0) {
+    lines.push(
+      view.language === "en-US" ? "Reason: no local blockers found." : "\u539F\u56E0\uFF1A\u672A\u53D1\u73B0\u672C\u5730\u963B\u585E\u9879\u3002"
+    );
+    lines.push(
+      view.language === "en-US" ? "Next: use /doctor all for details before claiming readiness." : "\u4E0B\u4E00\u6B65\uFF1A\u5982\u9700\u5B8C\u6574\u6E05\u5355\uFF0C\u7528 /doctor all\uFF1B\u4E0D\u8981\u636E\u6B64\u5BA3\u79F0\u6574\u4F53 ready\u3002"
+    );
+    return lines.join("\n");
+  }
+  lines.push(view.language === "en-US" ? "Needs attention:" : "\u9700\u8981\u5904\u7406\uFF1A");
+  for (const item of visible) {
+    lines.push(
+      `- [${item.status.toUpperCase()}] ${item.label}: ${short(sanitizePrimary(item.summary), 96)}; ${view.language === "en-US" ? "next" : "\u4E0B\u4E00\u6B65"}: ${sanitizePrimary(item.nextAction)}`
+    );
+  }
+  if (attention.length > visible.length) {
+    lines.push(
+      view.language === "en-US" ? `- ${attention.length - visible.length} more item(s) hidden from the default view.` : `- \u9ED8\u8BA4\u89C6\u56FE\u5DF2\u9690\u85CF ${attention.length - visible.length} \u4E2A\u8F83\u4F4E\u4F18\u5148\u7EA7\u9879\u76EE\u3002`
+    );
+  }
+  lines.push(
+    view.language === "en-US" ? "Details: /doctor all. Problems: /problems." : "\u8BE6\u60C5\uFF1A/doctor all\u3002\u95EE\u9898\u5217\u8868\uFF1A/problems\u3002"
+  );
+  return lines.join("\n");
+}
+function formatTerminalReadinessStatus(view) {
+  const items = createReadinessItems(view);
+  const blocked = items.filter((item) => item.status !== "pass");
+  const headline = view.language === "en-US" ? `Readiness: local ${items.length - blocked.length}/${items.length} pass \xB7 blockers ${blocked.length} \xB7 no smoke/Beta PASS` : `Readiness\uFF1A\u672C\u5730 ${items.length - blocked.length}/${items.length} pass \xB7 \u5F85\u5904\u7406 ${blocked.length} \xB7 \u975E smoke/Beta PASS`;
+  const top = blocked.slice(0, 3).map((item) => `${item.label}: ${item.status}`);
+  return [headline, top.length > 0 ? `- ${top.join("; ")}` : void 0].filter(Boolean).join("\n");
+}
+function formatTerminalProblemsPanel(view) {
+  const problems = view.problems.slice(0, 8);
+  if (problems.length === 0) {
+    return view.language === "en-US" ? "Problems Lite: no current local verification/provider/background/freshness problems. This is not a readiness PASS." : "Problems Lite\uFF1A\u5F53\u524D\u6CA1\u6709\u672C\u5730 verification/provider/background/freshness \u95EE\u9898\u3002\u8FD9\u4E0D\u4EE3\u8868 readiness PASS\u3002";
+  }
+  const lines = [
+    view.language === "en-US" ? `Problems Lite: ${problems.length} current problem(s); derived from local runtime evidence only.` : `Problems Lite\uFF1A\u5F53\u524D ${problems.length} \u4E2A\u95EE\u9898\uFF1B\u4EC5\u6765\u81EA\u672C\u5730 runtime evidence\u3002`
+  ];
+  for (const problem of problems) {
+    lines.push(
+      `- [${problem.severity.toUpperCase()}] ${problem.source}: ${short(sanitizePrimary(problem.summary), 140)}; ${view.language === "en-US" ? "next" : "\u4E0B\u4E00\u6B65"}: ${sanitizePrimary(problem.nextAction)}${problem.detailRef ? ` (${sanitizePrimary(problem.detailRef)})` : ""}`
+    );
+  }
+  lines.push(
+    view.language === "en-US" ? "Open details with /verify last, /details evidence, /details background <id>, or provider/index/cache doctors." : "\u53EF\u7528 /verify last\u3001/details evidence\u3001/details background <id> \u6216 provider/index/cache doctor \u67E5\u770B\u8BE6\u60C5\u3002"
+  );
+  return lines.join("\n");
+}
+function createReadinessItems(view) {
+  const verificationStatus = classifyVerification(view.verification?.status);
+  return [
+    {
+      id: "provider",
+      label: "provider/model",
+      // D.14A-R-Fix P1-5 — 没有真实 endpoint/provider evidence 时不显示 pass。
+      // last failure → fail；provider unknown → unknown；已配置但未 live-verified
+      // → partial（configured / not live-verified）；只有 live-verified 才 pass。
+      status: view.providerFailure ? "fail" : view.provider === "unknown" ? "unknown" : view.providerLiveVerified ? "pass" : "partial",
+      summary: view.providerFailure ? `last failure ${view.providerFailure.code} on ${view.providerFailure.provider}/${view.providerFailure.model}` : view.providerLiveVerified ? `live-verified ${view.provider}/${view.model}` : `configured ${view.provider}/${view.model}; not live-verified`,
+      nextAction: view.providerFailure ? "/model doctor" : view.providerLiveVerified ? "/model doctor for details" : "send a message or run a real provider smoke to live-verify; /model doctor for config"
+    },
+    {
+      id: "index",
+      label: "index",
+      status: view.index.status === "ready" ? "pass" : view.index.status === "stale" ? "stale" : view.index.status === "missing" || view.index.status === "error" ? "partial" : "unknown",
+      summary: view.language === "en-US" ? `status ${view.index.status}${typeof view.index.changedFiles === "number" ? `; changed files ${view.index.changedFiles}` : ""}` : `\u72B6\u6001 ${view.index.status}${typeof view.index.changedFiles === "number" ? `\uFF1B\u6539\u52A8\u6587\u4EF6 ${view.index.changedFiles}` : ""}`,
+      nextAction: view.index.status === "ready" ? "/index status" : "/index doctor"
+    },
+    {
+      id: "cache",
+      label: "cache/context",
+      status: view.cache.workspaceSnapshot === "ready" ? "pass" : "partial",
+      summary: view.language === "en-US" ? `hit rate ${formatPercent(view.cache.latestHitRate)}; compacted ${view.cache.compacted ? "yes" : "no"}; workspace snapshot ${view.cache.workspaceSnapshot}` : `\u547D\u4E2D\u7387 ${formatPercent(view.cache.latestHitRate)}\uFF1B\u5DF2\u538B\u7F29 ${view.cache.compacted ? "\u662F" : "\u5426"}\uFF1B\u5DE5\u4F5C\u533A\u5FEB\u7167 ${view.cache.workspaceSnapshot}`,
+      nextAction: "/cache status"
+    },
+    {
+      id: "memory",
+      label: "memory/rules",
+      status: view.memory.projectRules === "found" ? "pass" : "partial",
+      summary: view.language === "en-US" ? `project rules ${view.memory.projectRules}; candidates ${view.memory.candidates}; accepted ${view.memory.accepted}` : `\u9879\u76EE\u89C4\u5219 ${view.memory.projectRules}\uFF1B\u5019\u9009 ${view.memory.candidates}\uFF1B\u5DF2\u63A5\u53D7 ${view.memory.accepted}`,
+      nextAction: "/memory"
+    },
+    {
+      id: "mcp",
+      label: "mcp/connect",
+      status: view.mcp.errors > 0 ? "partial" : view.mcp.enabled && view.mcp.tools > 0 ? "pass" : view.mcp.servers > 0 ? "partial" : "unknown",
+      summary: view.language === "en-US" ? `enabled ${view.mcp.enabled ? "yes" : "no"}; servers ${view.mcp.servers}; tools ${view.mcp.tools}; errors ${view.mcp.errors}` : `\u542F\u7528 ${view.mcp.enabled ? "\u662F" : "\u5426"}\uFF1B\u670D\u52A1 ${view.mcp.servers}\uFF1B\u5DE5\u5177 ${view.mcp.tools}\uFF1B\u9519\u8BEF ${view.mcp.errors}`,
+      nextAction: "/mcp doctor"
+    },
+    {
+      id: "background",
+      label: "background/tasks",
+      status: view.background.blocked > 0 ? "partial" : view.background.running > 0 ? "unknown" : "pass",
+      summary: view.language === "en-US" ? `total ${view.background.total}; running ${view.background.running}; blocked ${view.background.blocked}` : `\u603B\u6570 ${view.background.total}\uFF1B\u8FD0\u884C\u4E2D ${view.background.running}\uFF1B\u963B\u585E ${view.background.blocked}`,
+      nextAction: view.background.total > 0 ? "/background" : view.background.blocked > 0 ? "/problems" : "no action"
+    },
+    {
+      id: "verification",
+      label: "verification",
+      status: verificationStatus,
+      summary: view.verification ? view.language === "en-US" ? `status ${view.verification.status}; unverified ${view.verification.unverified}; risk ${view.verification.risk}` : `\u72B6\u6001 ${view.verification.status}\uFF1B\u672A\u9A8C\u8BC1 ${view.verification.unverified}\uFF1B\u98CE\u9669 ${view.verification.risk}` : "no recent verification",
+      nextAction: view.verification ? "/verify last" : "/verify plan"
+    },
+    {
+      id: "freshness",
+      label: "freshness/web evidence",
+      status: view.freshness.webSourceEvidence === "present" ? "partial" : "unknown",
+      summary: view.language === "en-US" ? `web source evidence ${view.freshness.webSourceEvidence}; local presence is not source validation` : `\u7F51\u9875\u8BC1\u636E ${view.freshness.webSourceEvidence}\uFF1B\u672C\u5730\u5B58\u5728\u4E0D\u7B49\u4E8E\u6765\u6E90\u5DF2\u9A8C\u8BC1`,
+      nextAction: view.freshness.webSourceEvidence === "present" ? "/details evidence to confirm relevance and recency" : "mark current/external facts as unverified"
+    },
+    {
+      id: "project-doctor",
+      label: "project doctor lite",
+      status: view.projectDoctor.status,
+      summary: view.language === "en-US" ? `package manager ${view.projectDoctor.packageManager}; scripts ${view.projectDoctor.scripts.length}; checks ${view.projectDoctor.checks.length}; configs ${view.projectDoctor.configFiles.length}; ci ${view.projectDoctor.ciFiles.length}; unknown ${view.projectDoctor.unknown.length}` : `\u5305\u7BA1\u7406\u5668 ${view.projectDoctor.packageManager}\uFF1B\u811A\u672C ${view.projectDoctor.scripts.length}\uFF1B\u68C0\u67E5 ${view.projectDoctor.checks.length}\uFF1B\u914D\u7F6E ${view.projectDoctor.configFiles.length}\uFF1BCI ${view.projectDoctor.ciFiles.length}\uFF1B\u672A\u77E5 ${view.projectDoctor.unknown.length}`,
+      nextAction: "/doctor project"
+    },
+    {
+      id: "source-drift",
+      label: "source-of-truth drift lite",
+      status: view.sourceDrift.status,
+      summary: view.language === "en-US" ? `checked ${view.sourceDrift.checked.length}; issues ${view.sourceDrift.issues.length}` : `\u5DF2\u68C0\u67E5 ${view.sourceDrift.checked.length}\uFF1B\u95EE\u9898 ${view.sourceDrift.issues.length}`,
+      nextAction: view.sourceDrift.nextAction
+    },
+    {
+      id: "context-picker",
+      label: "context picker lite",
+      status: view.contextPicker.status,
+      summary: view.language === "en-US" ? `refs ${view.contextPicker.refs.length}; evidence kinds ${view.contextPicker.evidenceKinds.length}; index ${view.contextPicker.indexFreshness}` : `\u5F15\u7528 ${view.contextPicker.refs.length}\uFF1B\u8BC1\u636E\u7C7B\u578B ${view.contextPicker.evidenceKinds.length}\uFF1B\u7D22\u5F15 ${view.contextPicker.indexFreshness}`,
+      nextAction: "/doctor project"
+    },
+    {
+      id: "rollback-coach",
+      label: "rollback coach lite",
+      status: view.rollbackCoach.status,
+      summary: view.language === "en-US" ? `changed files ${view.rollbackCoach.changedFiles}; untracked ${view.rollbackCoach.untrackedFiles}; checkpoints ${view.rollbackCoach.checkpoints}; git status ${view.rollbackCoach.gitStatus}; mode ${view.rollbackCoach.mode}` : `\u6539\u52A8\u6587\u4EF6 ${view.rollbackCoach.changedFiles}\uFF1B\u672A\u8DDF\u8E2A ${view.rollbackCoach.untrackedFiles}\uFF1B\u68C0\u67E5\u70B9 ${view.rollbackCoach.checkpoints}\uFF1Bgit \u72B6\u6001 ${view.rollbackCoach.gitStatus}\uFF1B\u6A21\u5F0F ${view.rollbackCoach.mode}`,
+      nextAction: view.rollbackCoach.nextAction
+    },
+    {
+      id: "task-cost-preview",
+      label: "task cost preview lite",
+      status: view.costPreview.status,
+      summary: view.language === "en-US" ? `level ${view.costPreview.level}; labels ${view.costPreview.labels.join(", ")}` : `\u7EA7\u522B ${view.costPreview.level}\uFF1B\u6807\u7B7E ${view.costPreview.labels.join("\u3001")}`,
+      nextAction: view.costPreview.nextAction
+    },
+    ...view.runtimePath ? [guardRuntimePathToReadinessItem(view.runtimePath, view.language)] : [],
+    ...view.verificationLevel ? [guardVerificationLevelToReadinessItem(view.verificationLevel, view.language)] : [],
+    ...view.startupPath ? [guardStartupPathToReadinessItem(view.startupPath, view.language)] : []
+  ];
+}
+function formatReadinessLiteSections(view) {
+  const lines = [view.language === "en-US" ? "Lite readiness surfaces:" : "\u8F7B\u91CF\u5C31\u7EEA\u5165\u53E3\uFF1A"];
+  const projectUnknown = view.projectDoctor.unknown.length ? view.language === "en-US" ? ` \xB7 unknown ${safeReadableList(view.projectDoctor.unknown)}` : ` \xB7 \u672A\u77E5 ${safeReadableList(view.projectDoctor.unknown)}` : "";
+  if (view.language === "en-US") {
+    lines.push(
+      `- Project Doctor Lite: [${view.projectDoctor.status.toUpperCase()}] package manager ${view.projectDoctor.packageManager} \xB7 scripts ${safeReadableList(view.projectDoctor.scripts)} \xB7 checks ${safeReadableList(view.projectDoctor.checks)} \xB7 configs ${safeReadableList(view.projectDoctor.configFiles)} \xB7 ci ${safeReadableList(view.projectDoctor.ciFiles)} \xB7 project rules ${view.projectDoctor.projectRules}${projectUnknown}`
+    );
+    lines.push(
+      `- Source-of-Truth Drift Linter Lite: [${view.sourceDrift.status.toUpperCase()}] checked ${safeReadableList(view.sourceDrift.checked)} \xB7 issues ${safeReadableList(view.sourceDrift.issues)} \xB7 next ${view.sourceDrift.nextAction}`
+    );
+    lines.push(
+      `- Context Picker Lite: [${view.contextPicker.status.toUpperCase()}] refs ${safeReadableList(view.contextPicker.refs)} \xB7 evidence kinds ${safeReadableList(view.contextPicker.evidenceKinds)} \xB7 index ${view.contextPicker.indexFreshness}`
+    );
+    lines.push(
+      `- Rollback Coach Lite: [${view.rollbackCoach.status.toUpperCase()}] changed files ${view.rollbackCoach.changedFiles} \xB7 untracked ${view.rollbackCoach.untrackedFiles} \xB7 checkpoints ${view.rollbackCoach.checkpoints} \xB7 git status ${view.rollbackCoach.gitStatus} \xB7 mode ${view.rollbackCoach.mode} \xB7 next ${view.rollbackCoach.nextAction}`
+    );
+    lines.push(
+      `- Task Cost Preview Lite: [${view.costPreview.status.toUpperCase()}] level ${view.costPreview.level} \xB7 labels ${safeReadableList(view.costPreview.labels)} \xB7 next ${view.costPreview.nextAction}`
+    );
+    return lines.map(sanitizePrimary);
+  }
+  lines.push(
+    `- Project Doctor Lite: [${view.projectDoctor.status.toUpperCase()}] \u5305\u7BA1\u7406\u5668 ${view.projectDoctor.packageManager} \xB7 \u811A\u672C ${safeReadableList(view.projectDoctor.scripts)} \xB7 \u68C0\u67E5 ${safeReadableList(view.projectDoctor.checks)} \xB7 \u914D\u7F6E ${safeReadableList(view.projectDoctor.configFiles)} \xB7 CI ${safeReadableList(view.projectDoctor.ciFiles)} \xB7 \u9879\u76EE\u89C4\u5219 ${view.projectDoctor.projectRules}${projectUnknown}`
+  );
+  lines.push(
+    `- Source-of-Truth Drift Linter Lite: [${view.sourceDrift.status.toUpperCase()}] \u5DF2\u68C0\u67E5 ${safeReadableList(view.sourceDrift.checked)} \xB7 \u95EE\u9898 ${safeReadableList(view.sourceDrift.issues)} \xB7 \u4E0B\u4E00\u6B65 ${view.sourceDrift.nextAction}`
+  );
+  lines.push(
+    `- Context Picker Lite: [${view.contextPicker.status.toUpperCase()}] \u5F15\u7528 ${safeReadableList(view.contextPicker.refs)} \xB7 \u8BC1\u636E\u7C7B\u578B ${safeReadableList(view.contextPicker.evidenceKinds)} \xB7 \u7D22\u5F15 ${view.contextPicker.indexFreshness}`
+  );
+  lines.push(
+    `- Rollback Coach Lite: [${view.rollbackCoach.status.toUpperCase()}] \u6539\u52A8\u6587\u4EF6 ${view.rollbackCoach.changedFiles} \xB7 \u672A\u8DDF\u8E2A ${view.rollbackCoach.untrackedFiles} \xB7 \u68C0\u67E5\u70B9 ${view.rollbackCoach.checkpoints} \xB7 git \u72B6\u6001 ${view.rollbackCoach.gitStatus} \xB7 \u6A21\u5F0F ${view.rollbackCoach.mode} \xB7 \u4E0B\u4E00\u6B65 ${view.rollbackCoach.nextAction}`
+  );
+  lines.push(
+    `- Task Cost Preview Lite: [${view.costPreview.status.toUpperCase()}] \u7EA7\u522B ${view.costPreview.level} \xB7 \u6807\u7B7E ${safeReadableList(view.costPreview.labels)} \xB7 \u4E0B\u4E00\u6B65 ${view.costPreview.nextAction}`
+  );
+  return lines.map(sanitizePrimary);
+}
+function classifyVerification(status) {
+  if (!status) return "unknown";
+  if (status === "pass") return "pass";
+  if (status === "cancelled" || status === "timeout" || status === "stale") return "blocked";
+  if (status === "fail") return "fail";
+  return "partial";
+}
+function formatPercent(value) {
+  if (value === null || Number.isNaN(value)) return "unknown";
+  return `${Math.round(value * 100)}%`;
+}
+function safeReadableList(values) {
+  if (values.length === 0) return "none";
+  return values.map((value) => short(sanitizePrimary(value).replace(/=/gu, " "), 32)).join(", ");
+}
+function displayProject(value) {
+  const normalized = value.replaceAll("\\", "/");
+  const parts = normalized.split("/").filter(Boolean);
+  const tail = parts.at(-1) ?? "project";
+  return short(`\u2026/${tail}`, 90);
+}
+function sanitizePrimary(value) {
+  return value.replace(/sk-[A-Za-z0-9_-]+/gu, "sk-***").replace(/Bearer\s+[A-Za-z0-9._~-]+/giu, "Bearer ***").replace(/api[_-]?key=[^\s&]+/giu, "api_key=***").replace(/[A-Z]:[\\/][^\s)]+/gu, (match) => {
+    const parts = match.replace(/\\/g, "/").split("/");
+    const tail = parts.at(-1) ?? "file";
+    return `[\u2026/${tail}]`;
+  }).replace(/\/(?:home|Users|tmp|var|private)\/[^\s)]*/gu, (match) => {
+    const parts = match.split("/");
+    const tail = parts.at(-1) ?? "file";
+    return `[\u2026/${tail}]`;
+  });
+}
+function short(value, max) {
+  if (value.length <= max) return value;
+  return `${value.slice(0, Math.max(0, max - 1))}\u2026`;
+}
+function guardRuntimePathToReadinessItem(rp, language) {
+  const marker = {
+    path: rp.path,
+    kind: rp.kind,
+    isMainPath: rp.kind === "main",
+    isFallback: rp.kind === "fallback",
+    canClaimMature: rp.canClaimMature,
+    degradedReason: rp.degradedReason,
+    detectionMethod: "default"
+  };
+  const item = formatRuntimePathDoctor(marker, language);
+  return {
+    id: item.id,
+    label: item.label,
+    status: item.ok ? "pass" : "partial",
+    summary: item.summary,
+    nextAction: item.nextAction
+  };
+}
+function guardVerificationLevelToReadinessItem(vl, language) {
+  const classification = {
+    level: vl.level,
+    isRealSmoke: vl.level === "real-smoke",
+    canClaimMature: vl.canClaimMature,
+    canClaimPass: vl.canClaimPass,
+    upgradeBlocked: vl.upgradeBlocked,
+    blockReason: vl.blockReason,
+    requiredForMature: vl.canClaimMature ? "already-mature" : "real-smoke-required"
+  };
+  const item = formatVerificationLevelDoctor(classification, language);
+  return {
+    id: item.id,
+    label: item.label,
+    status: vl.canClaimPass ? vl.canClaimMature ? "pass" : "partial" : "unknown",
+    summary: item.summary,
+    nextAction: item.nextAction
+  };
+}
+function guardStartupPathToReadinessItem(sp, language) {
+  const marker = {
+    entryKind: sp.entryKind,
+    isVerifiedCurrent: sp.isVerifiedCurrent,
+    staleRisk: sp.staleRisk,
+    staleReason: sp.staleReason
+  };
+  const item = formatStartupPathDoctor(marker, language);
+  return {
+    id: item.id,
+    label: item.label,
+    status: item.ok ? "pass" : "partial",
+    summary: item.summary,
+    nextAction: item.nextAction
+  };
+}
+
+export {
+  formatTerminalReadinessDoctor,
+  formatTerminalReadinessStatus,
+  formatTerminalProblemsPanel,
+  createReadinessItems
+};

package/dist/chunk-ZZ2CNCXJ.js

@@ -0,0 +1,282 @@
+import {
+  deriveAgentDisplayName,
+  findDurableJob,
+  formatJobList,
+  formatJobLogs,
+  formatJobPrimary,
+  formatJobReport,
+  getDurableJobMaxSteps,
+  getDurableJobPaths,
+  getDurableJobsRoot,
+  listDurableJobs
+} from "./chunk-TYF4GJR3.js";
+import {
+  formatJobNextAction,
+  mapDurableJobToBackgroundResult,
+  mapDurableJobToBackgroundStatus
+} from "./chunk-UDQT5CWK.js";
+import {
+  MAX_BACKGROUND_TASKS
+} from "./chunk-RDGM4RUE.js";
+import {
+  formatIndexRuntimeRef
+} from "./chunk-UT2TYK2A.js";
+import {
+  truncateDisplay
+} from "./chunk-OMZYPQVA.js";
+
+// src/tui-agent-job-runtime.ts
+function isAgentType(value) {
+  return value === "explorer" || value === "worker" || value === "verifier" || value === "planner";
+}
+function getAgentRole(type) {
+  if (type === "planner") {
+    return "planner";
+  }
+  if (type === "verifier") {
+    return "verifier";
+  }
+  return "executor";
+}
+function getAgentPermissionMode(type, parentMode) {
+  if (type === "explorer" || type === "planner") {
+    return "plan";
+  }
+  if (type === "verifier") {
+    return "default";
+  }
+  return parentMode;
+}
+function createEmptyAgentCost(task) {
+  const inputTokens = Math.ceil(task.length / 4);
+  return { inputTokens, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, estimatedCny: 0 };
+}
+function createAgentContextSummary(packet, task, context) {
+  const evidence = packet.evidenceRefs.map((item) => `${item.kind}:${item.source}`).slice(0, 5);
+  const files = packet.keyFiles.slice(0, 8);
+  const activeFailures = context.failureLearning.records.filter(
+    (item) => item.status === "active" && item.projectScope === context.failureLearning.projectScope
+  );
+  const freshness = context.cache.lastFreshness ? `changed ${context.cache.lastFreshness.changedKeys.slice(0, 5).join(", ") || "none"}` : "not checked";
+  const architecture = packet.currentArchitectureCard ? truncateDisplay(packet.currentArchitectureCard.recommendedApproach, 120) : "none";
+  const indexSummary = formatIndexRuntimeRef(packet.indexStatus).replace(/=/gu, " ");
+  return [
+    "Agent context package (trimmed)",
+    `handoff ${packet.id}`,
+    `task ${truncateDisplay(task, 200)}`,
+    `language ${context.language}`,
+    `todos ${packet.todos.length}`,
+    `evidence ${evidence.length > 0 ? evidence.join("; ") : "none"}`,
+    `key files ${files.length > 0 ? files.join(", ") : "none"}`,
+    `index ${indexSummary}`,
+    `cache freshness ${freshness}`,
+    `architecture ${architecture}`,
+    `failure learning ${activeFailures.length}`,
+    `permission ${context.permissionMode}`,
+    "not included: full transcript/full memory/full index/large logs"
+  ].join(" | ");
+}
+function createAgentBackgroundTask(agent, context) {
+  const label = agent.displayName ?? deriveAgentDisplayName(agent.type, agent.task);
+  const isEn = context.language === "en-US";
+  const isTerminal = agent.status === "blocked" || agent.status === "cancelled" || agent.status === "failed";
+  const isIdle = agent.status === "idle";
+  const backgroundStatus = isTerminal ? agent.status === "blocked" ? "blocked" : agent.status === "cancelled" ? "cancelled" : agent.status === "failed" ? "failed" : "completed" : isIdle ? "completed" : agent.status === "stale" ? "stale" : "running";
+  const backgroundResult = isTerminal ? agent.status === "cancelled" ? "cancelled" : "fail" : isIdle ? mapAgentBackgroundResult(agent, agent.lastTerminalStatus) : agent.status === "stale" ? "partial" : void 0;
+  const currentStep = isTerminal ? agent.status : isIdle ? agent.activitySummary ? `idle: ${agent.activitySummary}` : "idle" : agent.status === "stale" ? "stale/resumable" : isEn ? `running ${agent.type}` : `\u6B63\u5728\u8FD0\u884C ${agent.type}`;
+  const progress = isTerminal || isIdle ? { completed: 1, total: 1, label } : { completed: 0, total: 1, label };
+  const userVisibleSummary = isTerminal ? agent.summary : isIdle ? agent.summary : agent.status === "stale" ? agent.summary : isEn ? `Started ${label}. Use /agents show ${agent.id}.` : `\u5DF2\u542F\u52A8 ${label}\u3002\u53EF\u7528 /agents show ${agent.id} \u67E5\u770B\u3002`;
+  return {
+    id: agent.id,
+    kind: "agent",
+    title: `Agent ${label}`,
+    status: backgroundStatus,
+    currentStep,
+    progress,
+    result: backgroundResult,
+    startedAt: agent.startedAt,
+    updatedAt: agent.updatedAt,
+    heartbeatIntervalMs: 3e4,
+    staleAfterMs: 12e4,
+    outputPath: agent.transcriptPath,
+    hasOutput: true,
+    userVisibleSummary,
+    nextAction: isEn ? `Use /agents cancel ${agent.id} to interrupt.` : `\u53EF\u7528 /agents cancel ${agent.id} \u4E2D\u65AD\u3002`
+  };
+}
+function isAgentCancellable(agent) {
+  return agent.status === "running";
+}
+function mapAgentBackgroundResult(agent, lastTerminalStatus) {
+  if (agent.type !== "verifier") {
+    return "partial";
+  }
+  return lastTerminalStatus === "completed" ? "partial" : lastTerminalStatus === "failed" ? "fail" : "partial";
+}
+function findAgent(context, id) {
+  if (id) {
+    const normalized = id.trim();
+    return context.agents.find(
+      (agent) => agent.id === normalized || agent.id.endsWith(normalized) || agent.addressableName === normalized || agent.teamName === normalized
+    );
+  }
+  return context.agents.find((agent) => agent.status === "running") ?? context.agents.find((agent) => agent.status === "idle") ?? context.agents.find((agent) => agent.status === "stale") ?? context.agents.find((agent) => agent.status === "blocked") ?? context.agents[0];
+}
+function listCancellableAgents(context) {
+  return context.agents.filter(isAgentCancellable);
+}
+function formatAgentSummary(agent, _context) {
+  const displayStatus = agent.status === "idle" && agent.lastTerminalStatus ? agent.lastTerminalStatus : agent.status;
+  return `[agent] ${agent.id} \xB7 ${agent.type} \xB7 ${displayStatus} \xB7 ${agent.summary}`;
+}
+function findBackgroundTask(context, id) {
+  if (!id) {
+    return context.backgroundTasks[0];
+  }
+  return context.backgroundTasks.find((task) => task.id === id || task.id.endsWith(id));
+}
+function isActiveBackgroundStatus(status) {
+  return status === "running";
+}
+function isRuntimeActiveBackgroundTask(task) {
+  return task.status === "running";
+}
+function rememberBackgroundTask(context, task) {
+  context.backgroundTasks.unshift(task);
+  context.backgroundTasks = context.backgroundTasks.slice(0, MAX_BACKGROUND_TASKS);
+}
+var AUTO_REMOVE_COMPLETED_TASKS_MS = 5e3;
+function cleanupCompletedBackgroundTasks(context) {
+  if (!context.dismissedBackgroundTaskIds) {
+    context.dismissedBackgroundTaskIds = /* @__PURE__ */ new Set();
+  }
+  const now = Date.now();
+  for (const task of context.backgroundTasks) {
+    if (task.status === "completed" && task.completedAt && !context.dismissedBackgroundTaskIds.has(task.id)) {
+      const completedTime = Date.parse(task.completedAt);
+      if (Number.isFinite(completedTime) && now - completedTime >= AUTO_REMOVE_COMPLETED_TASKS_MS) {
+        context.dismissedBackgroundTaskIds.add(task.id);
+      }
+    }
+  }
+}
+function getBackgroundAbortControllers(context) {
+  if (!context.backgroundAbortControllers) {
+    context.backgroundAbortControllers = /* @__PURE__ */ new Map();
+  }
+  return context.backgroundAbortControllers;
+}
+function registerBackgroundAbortController(context, taskId) {
+  const controller = new AbortController();
+  getBackgroundAbortControllers(context).set(taskId, controller);
+  return controller;
+}
+function clearBackgroundAbortController(context, taskId) {
+  context.backgroundAbortControllers?.delete(taskId);
+}
+function abortBackgroundTask(context, taskId) {
+  const controller = context.backgroundAbortControllers?.get(taskId);
+  if (!controller) {
+    return false;
+  }
+  controller.abort();
+  clearBackgroundAbortController(context, taskId);
+  return true;
+}
+function toJobContext(context) {
+  return { config: context.config, projectPath: context.projectPath, language: context.language };
+}
+async function listDurableJobs2(context) {
+  return listDurableJobs(toJobContext(context));
+}
+async function findDurableJob2(context, id) {
+  return findDurableJob(toJobContext(context), id);
+}
+function getDurableJobsRoot2(context) {
+  return getDurableJobsRoot(toJobContext(context));
+}
+function getDurableJobPaths2(context, id) {
+  return getDurableJobPaths(toJobContext(context), id);
+}
+function formatJobList2(jobs, context) {
+  return formatJobList(jobs, toJobContext(context));
+}
+function formatJobPrimary2(job, context) {
+  return formatJobPrimary(job, toJobContext(context));
+}
+function formatJobReport2(job) {
+  return formatJobReport(job);
+}
+async function formatJobLogs2(job) {
+  return formatJobLogs(job);
+}
+function createJobBackgroundTask(job, context) {
+  const runningAgents = job.agents.filter((agent) => agent.status === "running").length;
+  return {
+    id: job.id,
+    kind: "job",
+    title: `Job: ${truncateDisplay(job.goal, 40)}`,
+    status: mapDurableJobToBackgroundStatus(job.status),
+    currentStep: job.pauseReason ?? `worker step ${job.budget.usedSteps ?? 0}/${getDurableJobMaxSteps(job)}; agents ${runningAgents}/${job.agents.length}`,
+    progress: {
+      completed: job.budget.usedSteps ?? 0,
+      total: getDurableJobMaxSteps(job),
+      label: "worker steps"
+    },
+    startedAt: job.startedAt ?? job.createdAt,
+    updatedAt: job.updatedAt,
+    completedAt: job.status === "completed" ? job.endedAt : void 0,
+    heartbeatIntervalMs: 3e4,
+    staleAfterMs: job.timeoutMs,
+    logPath: job.logPath,
+    outputPath: job.fullOutputPath,
+    hasOutput: true,
+    result: mapDurableJobToBackgroundResult(job.status),
+    userVisibleSummary: job.status === "running" ? `Job running with ${runningAgents}/${job.agents.length} agents under cap ${job.budget.maxRunningAgents}; output stays in logs.` : `Job ${job.status}; ${job.pauseReason ?? "no evidence that verification passed was generated"}.`,
+    nextAction: formatJobNextAction(job, context.language)
+  };
+}
+function upsertJobBackgroundTask(context, job) {
+  const existing = context.backgroundTasks.find((task2) => task2.id === job.id);
+  const task = createJobBackgroundTask(job, context);
+  if (existing) {
+    Object.assign(existing, task);
+    return existing;
+  }
+  rememberBackgroundTask(context, task);
+  return task;
+}
+
+export {
+  isAgentType,
+  getAgentRole,
+  getAgentPermissionMode,
+  createEmptyAgentCost,
+  createAgentContextSummary,
+  createAgentBackgroundTask,
+  isAgentCancellable,
+  mapAgentBackgroundResult,
+  findAgent,
+  listCancellableAgents,
+  formatAgentSummary,
+  findBackgroundTask,
+  isActiveBackgroundStatus,
+  isRuntimeActiveBackgroundTask,
+  rememberBackgroundTask,
+  cleanupCompletedBackgroundTasks,
+  getBackgroundAbortControllers,
+  registerBackgroundAbortController,
+  clearBackgroundAbortController,
+  abortBackgroundTask,
+  toJobContext,
+  listDurableJobs2 as listDurableJobs,
+  findDurableJob2 as findDurableJob,
+  getDurableJobsRoot2 as getDurableJobsRoot,
+  getDurableJobPaths2 as getDurableJobPaths,
+  formatJobList2 as formatJobList,
+  formatJobPrimary2 as formatJobPrimary,
+  formatJobReport2 as formatJobReport,
+  formatJobLogs2 as formatJobLogs,
+  createJobBackgroundTask,
+  upsertJobBackgroundTask
+};

package/dist/command-panel-runtime.d.ts

@@ -0,0 +1,33 @@
+import type { Writable } from "node:stream";
+import type { TuiContext } from "./index.js";
+import type { CommandPanelRow, CommandPanelView } from "./shell/types.js";
+/**
+ * D.13Q-UX Task Surface Maturity Sweep — 通用 CommandPanel 设置器。
+ *
+ * 高级 slash 命令（/mcp, /memory, /index status, /cache, /background, /job,
+ * /plugins, /skills, /remote, /doctor, /model 等）的默认输出应走这条路径，
+ * 让命令结果落到独立面板，不污染 transcript / assistant_text 流。
+ *
+ * - ink session（context.isInkSession === true）走 commandPanelState 路径，
+ *   shell.rerender 由调用栈外面统一触发。
+ * - 非 ink（plain TUI / 非交互）走 writeDiagnosticLine fallback：把 panel
+ *   的 summary + sections 拼成可读多行文本，保留原行为。
+ *
+ * 调用方应当只把"用户面向"的关键状态填进 panel；guard / runtime / binary /
+ * source / version / schemaLoaded / trustLevel / endpoint 等内部字段一律
+ * 不进 summary / sections，要么入 detailsText，要么仅在 doctor 子命令路径上输出。
+ */
+/**
+ * D.13Q-UX Task Surface Maturity Sweep — explicit /details panel 装配器。
+ *
+ * 把 lastFullOutput / evidence / background 装配成一个 CommandPanel detailsText
+ * 视图，供显式 /details slash 命令和测试使用。Ctrl+O 不走这里；它只切换
+ * transcript/message block 的 verbose 展开态。
+ *
+ * 返回 undefined 表示三类内容都为空 —— 调用方走 notifications 轻提示。
+ */
+export declare function buildExplicitDetailsCommandPanel(context: TuiContext): CommandPanelView | undefined;
+export declare function showCommandPanel(context: TuiContext, output: Writable, panel: CommandPanelView): void;
+export declare function getCommandPanelRowText(row: CommandPanelRow): string;
+export declare function getCommandPanelSelectableRows(panel: CommandPanelView): Exclude<CommandPanelRow, string>[];
+//# sourceMappingURL=command-panel-runtime.d.ts.map

package/dist/command-panel-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-panel-runtime.d.ts","sourceRoot":"","sources":["../src/command-panel-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG1E;;;;;;;;;;;;;;;GAeG;AACH;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,UAAU,GAClB,gBAAgB,GAAG,SAAS,CA8M9B;AAsBD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,gBAAgB,GACtB,IAAI,CA+BN;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAEnE;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAOpC"}