cool-workflow 0.1.98 → 0.2.1

package/dist/{onramp.js → shell/onramp.js}

@@ -1,4 +1,15 @@
 "use strict";
+// shell/onramp.ts — the change-contract onramp subsystem.
+//
+// Byte-exact port of the old flat build's src/onramp.ts (added in #198):
+// evaluateOnrampContract, recommendSmokeTests, resolveChangedFiles,
+// buildDoctorOnramp. Impure (git/fs reads), so it lives under shell/.
+// The v2 rebuild dropped this module on purpose for a later milestone;
+// this restores it and shell/doctor.ts wires --onramp back to it.
+//
+// The classification in evaluateOnrampContract works on path STRINGS only
+// (it never stats files), so the old flat paths the smoke passes still
+// classify correctly even though the real files moved under src/shell etc.
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/{operator-ux/format.js → shell/operator-ux-text.js}

@@ -1,191 +1,166 @@
 "use strict";
+// shell/operator-ux-text.ts — human-readable rendering for the operator
+// console surface (`cw status`, `cw graph`, `cw operator status|report|
+// graph`). Lives in shell/ (not core/format/) because it calls term.ts's
+// `dim()`, which is TTY/env-aware.
+//
+// MILESTONE 11 (reporting/observability). Byte-exact port of the parts of
+// the old build's src/operator-ux/format.ts this milestone's conformance
+// surface exercises: formatOperatorSummary (`--summary`/`--brief`),
+// formatOperatorStatus (full `cw status`), formatOperatorReport (`cw
+// report --show`), formatOperatorGraph (`cw graph`).
+//
+// Evidence: SPEC/reporting-ux.md "Operator UX human text";
+// plugins/cool-workflow/src/operator-ux/format.ts:1-132 (byte-exact
+// source for the ported pieces).
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatOperatorStatus = formatOperatorStatus;
 exports.formatOperatorSummary = formatOperatorSummary;
+exports.formatMultiAgentTrustAudit = formatMultiAgentTrustAudit;
+exports.formatMultiAgentSummaryText = formatMultiAgentSummaryText;
+exports.formatOperatorStatus = formatOperatorStatus;
 exports.formatOperatorReport = formatOperatorReport;
 exports.formatOperatorGraph = formatOperatorGraph;
-exports.formatWorkerSummary = formatWorkerSummary;
-exports.formatCandidateSummary = formatCandidateSummary;
-exports.formatFeedbackSummary = formatFeedbackSummary;
-exports.formatCommitSummary = formatCommitSummary;
-exports.formatMultiAgentSummary = formatMultiAgentSummary;
-exports.formatTopologySummary = formatTopologySummary;
-exports.formatMultiAgentTrustAudit = formatMultiAgentTrustAudit;
-const multi_agent_operator_ux_1 = require("../multi-agent-operator-ux");
-const term_1 = require("../term");
-function formatOperatorStatus(summary) {
-    return [
-        formatOperatorSummary(summary),
-        "",
-        formatWorkerPanel(summary.workers),
-        "",
-        formatCandidatePanel(summary.candidates),
-        "",
-        formatFeedbackPanel(summary.feedback),
-        "",
-        formatCommitPanel(summary.commits),
-        "",
-        formatTopologyPanel(summary.topologies),
-        "",
-        formatMultiAgentPanel(summary.multiAgent),
-        "",
-        "Multi-Agent Operator UX",
-        `  active=${operator(summary).activeMultiAgentRunIds.join(", ") || "none"}; topologies=${operator(summary).topologyRunIds.join(", ") || "none"}; blocked=${operator(summary).blocked ? "yes" : "no"}`,
-        `  dependencies=${operator(summary).dependencies.length}; failures=${operator(summary).failures.length}; adoptedEvidence=${operator(summary).adoptedEvidence.length}; missingEvidence=${operator(summary).missingEvidence.length}${operator(summary).inspectableEvidence.length ? ` (inspectable=${operator(summary).inspectableEvidence.length})` : ""}`,
-        `  next=${operator(summary).nextAction}`,
-        "",
-        formatBlackboardPanel(summary.blackboard),
-        "",
-        formatTrustPanel(summary.trust),
-        "",
-        formatMultiAgentTrustAudit(summary.multiAgentTrust),
-        "",
-        `Report: ${summary.reportPath}`
-    ].join("\n");
+exports.formatCandidateSummaryText = formatCandidateSummaryText;
+exports.formatFeedbackSummaryText = formatFeedbackSummaryText;
+const term_1 = require("./term");
+const multi_agent_operator_ux_1 = require("./multi-agent-operator-ux");
+function formatCounts(counts) {
+    const entries = Object.entries(counts).sort(([a], [b]) => a.localeCompare(b));
+    if (!entries.length)
+        return "none";
+    return entries.map(([k, v]) => `${k}=${v}`).join(", ");
+}
+function formatRecommendations(actions) {
+    if (!actions.length)
+        return ["  none"];
+    const lines = [];
+    for (const action of actions) {
+        lines.push(`  ${action.command}`);
+        lines.push(`    reason: ${action.reason}`);
+    }
+    return lines;
 }
-function operator(summary) { return summary.multiAgentOperator; }
-/** Compact summary — the default `cw status` output. `cw status --verbose` shows the full panel. */
+/** Compact summary — `cw status <id> --summary`/`--brief`. Byte-exact
+ *  port of formatOperatorSummary. */
 function formatOperatorSummary(summary) {
     return [
         `Run: ${summary.runId}`,
         `Workflow: ${summary.workflowId}${summary.appId ? ` (${summary.appId}@${summary.appVersion || "unknown"})` : ""}`,
         `Phase: ${summary.activePhase || "none"} | Stage: ${summary.loopStage} | Blocked: ${summary.blocked ? summary.blockedReasons.join("; ") : "no"}`,
         `Tasks: ${formatCounts(summary.tasks.byStatus)}; total=${summary.tasks.total}`,
-        ...summary.phases.map((phase) => `  ${phase.name}: ${phase.status} (${phase.tasks.completed}/${phase.tasks.total} completed)`),
+        ...summary.phases.map((phase) => `  ${phase.name}: ${phase.status} (${phase.tasks.completed || 0}/${phase.tasks.total} completed)`),
         "",
         "Next Action",
         ...formatRecommendations(summary.nextActions),
         "",
-        (0, term_1.dim)(`(use --verbose for full worker/candidate/feedback/commit/trust panels)`)
-    ].join("\n");
-}
-function formatOperatorReport(summary) {
-    return [
-        formatOperatorStatus(summary),
-        "",
-        "Active and Pending Tasks",
-        ...formatTaskList(summary.tasks),
-        "",
-        "Evidence",
-        ...(summary.evidencePaths.length ? summary.evidencePaths.map((entry) => `  ${entry}`) : ["  none recorded"]),
-        "",
-        (0, multi_agent_operator_ux_1.formatMultiAgentDependencies)(summary.multiAgentOperator.dependencies),
-        "",
-        (0, multi_agent_operator_ux_1.formatMultiAgentFailures)(summary.multiAgentOperator.failures),
-        "",
-        (0, multi_agent_operator_ux_1.formatMultiAgentEvidence)(summary.multiAgentOperator.evidence),
-        "",
-        "Resource Commands",
-        `  node scripts/cw.js graph ${summary.runId}`,
-        `  node scripts/cw.js worker summary ${summary.runId}`,
-        `  node scripts/cw.js topology summary ${summary.runId}`,
-        `  node scripts/cw.js topology graph ${summary.runId}`,
-        `  node scripts/cw.js multi-agent summary ${summary.runId}`,
-        `  node scripts/cw.js multi-agent graph ${summary.runId}`,
-        `  node scripts/cw.js multi-agent dependencies ${summary.runId}`,
-        `  node scripts/cw.js multi-agent failures ${summary.runId}`,
-        `  node scripts/cw.js multi-agent evidence ${summary.runId}`,
-        `  node scripts/cw.js blackboard summary ${summary.runId}`,
-        `  node scripts/cw.js blackboard graph ${summary.runId}`,
-        `  node scripts/cw.js coordinator summary ${summary.runId}`,
-        `  node scripts/cw.js candidate summary ${summary.runId}`,
-        `  node scripts/cw.js feedback summary ${summary.runId}`,
-        `  node scripts/cw.js commit summary ${summary.runId}`,
-        `  node scripts/cw.js audit summary ${summary.runId}`,
-        `  node scripts/cw.js audit provenance ${summary.runId}`,
-        `  node scripts/cw.js audit multi-agent ${summary.runId}`,
-        `  node scripts/cw.js audit policy ${summary.runId}`,
-        `  node scripts/cw.js audit blackboard ${summary.runId}`,
-        `  node scripts/cw.js audit judge ${summary.runId}`
+        (0, term_1.dim)("(use --verbose for full worker/candidate/feedback/commit/trust panels)"),
     ].join("\n");
 }
-function formatOperatorGraph(graph) {
-    const lines = [`Run Graph: ${graph.runId}`, "", "Nodes"];
-    const groups = groupBy(graph.nodes, (node) => node.kind);
-    for (const kind of Object.keys(groups).sort()) {
-        lines.push(`  ${kind}`);
-        for (const node of groups[kind]) {
-            const suffix = node.path ? ` -> ${node.path}` : "";
-            lines.push(`    [${node.status}] ${node.id} (${node.label})${suffix}`);
-        }
-    }
-    lines.push("", "Edges");
-    if (!graph.edges.length)
-        lines.push("  none");
-    for (const edge of graph.edges) {
-        lines.push(`  ${edge.from} -> ${edge.to}${edge.label ? ` (${edge.label})` : ""}`);
-    }
+function formatWorkerPanel(summary) {
+    const lines = ["Workers", `  Total: ${summary.total}`, `  By status: ${formatCounts(summary.byStatus)}`];
+    for (const worker of summary.workers)
+        lines.push(`  - ${worker.id} (${worker.status}) task=${worker.taskId}`);
     return lines.join("\n");
 }
-function formatWorkerSummary(summary) {
-    return formatWorkerPanel(summary);
-}
-function formatCandidateSummary(summary) {
-    return formatCandidatePanel(summary);
-}
-function formatFeedbackSummary(summary) {
-    return formatFeedbackPanel(summary);
+function formatCandidatePanel(summary) {
+    return [
+        "Candidates",
+        `  Total: ${summary.total}`,
+        `  By status: ${formatCounts(summary.byStatus)}`,
+        `  By kind: ${formatCounts(summary.byKind)}`,
+        `  Selections: ${summary.selections}`,
+        `  ready for commit=${summary.readyForCommit.map((item) => `${item.candidateId}/${item.selectionId}`).join(", ") || "none"}`,
+    ].join("\n");
 }
-function formatCommitSummary(summary) {
-    return formatCommitPanel(summary);
+function formatFeedbackPanel(summary) {
+    return ["Feedback", `  Total: ${summary.total}`, `  By status: ${formatCounts(summary.byStatus)}`, `  By severity: ${formatCounts(summary.bySeverity)}`].join("\n");
 }
-function formatTrustPanel(summary) {
+function formatCommitPanel(summary) {
     const lines = [
-        "Trust Audit",
-        `  total=${summary.eventCount}; decision=${formatCounts(summary.byDecision)}; source=${formatCounts(summary.bySource)}`,
-        `  sandbox=${formatCounts(summary.bySandboxProfile)}`,
-        `  multi-agent trust=${summary.multiAgentTrust ? formatCounts(summary.multiAgentTrust) : "none"}`,
-        `  events=${summary.eventLogPath}`,
-        `  summary=${summary.summaryPath}`
+        "Commits",
+        `  total=${summary.total}; verifier-gated=${summary.verifierGated}; checkpoints=${summary.checkpoints}`,
     ];
-    for (const worker of summary.workers.slice(0, 6)) {
-        lines.push(`  worker ${worker.workerId}: sandbox=${worker.sandboxProfileId || "none"}, decisions=${formatCounts(worker.decisions)}, denied=${worker.denied}`);
-    }
+    for (const commit of summary.commits)
+        lines.push(`  - ${commit.id}: ${commit.reason}`);
     return lines.join("\n");
 }
-function formatMultiAgentSummary(summary) {
-    return formatMultiAgentPanel(summary);
+function formatTrustPanel(summary) {
+    return [
+        "Trust Audit",
+        `  Events: ${summary.eventCount}`,
+        `  Chain integrity: ${summary.integrity.verified ? "verified" : "FAILED"}`,
+    ].join("\n");
+}
+function arrayView(value) {
+    return Array.isArray(value) ? value : [];
+}
+function formatRolePolicyRows(rows) {
+    if (!rows.length)
+        return ["  none"];
+    return rows.slice(0, 40).map((row) => {
+        const writes = Array.isArray(row.allowedWriteOperations) ? row.allowedWriteOperations.join(",") : "none";
+        const candidates = Array.isArray(row.allowedCandidateOperations) ? row.allowedCandidateOperations.join(",") : "none";
+        const judges = Array.isArray(row.allowedJudgeOperations) ? row.allowedJudgeOperations.join(",") : "none";
+        const topics = Array.isArray(row.allowedBlackboardTopicIds) ? row.allowedBlackboardTopicIds.join(",") : "none";
+        return `  ${String(row.policyRef || row.id || row.subjectId)} subject=${String(row.subjectKind || "unknown")}:${String(row.subjectId || "unknown")} topics=${topics} writes=${writes} candidates=${candidates} judges=${judges}`;
+    });
 }
-function formatTopologySummary(summary) {
-    return formatTopologyPanel(summary);
+function formatAuditEventRows(rows) {
+    if (!rows.length)
+        return ["  none"];
+    return rows.slice(0, 60).map((row) => {
+        const metadata = row.metadata && typeof row.metadata === "object" ? row.metadata : {};
+        const ids = [
+            row.agentRoleId ? `role=${row.agentRoleId}` : "",
+            row.agentMembershipId ? `membership=${row.agentMembershipId}` : "",
+            row.blackboardMessageId ? `message=${row.blackboardMessageId}` : "",
+            row.blackboardContextId ? `context=${row.blackboardContextId}` : "",
+            row.blackboardArtifactRefId ? `artifact=${row.blackboardArtifactRefId}` : "",
+            row.coordinatorDecisionId ? `decision=${row.coordinatorDecisionId}` : "",
+            row.candidateId ? `candidate=${row.candidateId}` : "",
+            row.scoreId ? `score=${row.scoreId}` : "",
+            row.selectionId ? `selection=${row.selectionId}` : "",
+        ].filter(Boolean).join(" ");
+        const reason = metadata.reason ? ` reason=${String(metadata.reason)}` : "";
+        const operation = metadata.operation ? ` operation=${String(metadata.operation)}` : "";
+        return `  [${String(row.decision || "recorded")}] ${String(row.kind || "event")} ${String(row.id || "")}${operation}${ids ? ` ${ids}` : ""}${row.policyRef ? ` policy=${String(row.policyRef)}` : ""}${reason}`;
+    });
 }
+/** `cw audit multi-agent|policy|role|blackboard|judge` human render — port
+ *  of the old build's formatMultiAgentTrustAudit (operator-ux/format.ts). */
 function formatMultiAgentTrustAudit(view) {
-    const rolePolicies = arrayView(view.rolePolicies);
-    const permissionDecisions = arrayView(view.permissionDecisions);
-    const blackboardWrites = arrayView(view.blackboardWrites);
-    const messageProvenance = arrayView(view.messageProvenance);
-    const judgeRationales = arrayView(view.judgeRationales);
-    const panelDecisions = arrayView(view.panelDecisions);
-    const policyViolations = arrayView(view.policyViolations);
     return [
         `Multi-Agent Trust: ${String(view.runId || "unknown")}`,
         "",
         "Role Policies",
-        ...formatRolePolicyRows(rolePolicies),
+        ...formatRolePolicyRows(arrayView(view.rolePolicies)),
         "",
         "Permission Decisions",
-        ...formatAuditRows(permissionDecisions),
+        ...formatAuditEventRows(arrayView(view.permissionDecisions)),
         "",
         "Blackboard Write Audit",
-        ...formatAuditRows(blackboardWrites),
+        ...formatAuditEventRows(arrayView(view.blackboardWrites)),
         "",
         "Message Provenance",
-        ...formatAuditRows(messageProvenance),
+        ...formatAuditEventRows(arrayView(view.messageProvenance)),
         "",
         "Judge Rationales",
-        ...formatAuditRows([...judgeRationales, ...panelDecisions]),
+        ...formatAuditEventRows([...arrayView(view.judgeRationales), ...arrayView(view.panelDecisions)]),
         "",
         "Policy Violations",
-        ...formatAuditRows(policyViolations),
+        ...formatAuditEventRows(arrayView(view.policyViolations)),
         "",
         "Next Action",
-        `  ${String(view.nextAction || `node scripts/cw.js audit multi-agent ${String(view.runId || "<run-id>")} --json`)}`
+        `  ${String(view.nextAction || `node scripts/cw.js audit multi-agent ${String(view.runId || "<run-id>")} --json`)}`,
     ].join("\n");
 }
+/** `Topologies` panel — port of the old build's formatTopologyPanel
+ *  (operator-ux/format.ts): the topology-run rollup with per-run roles/
+ *  topics/fanout/fanin/readiness. */
 function formatTopologyPanel(summary) {
     const lines = [
         "Topologies",
-        `  runs=${summary.totalRuns}; status=${formatCounts(summary.runsByStatus)}; official=${summary.officialTopologies.join(", ")}`
+        `  runs=${summary.totalRuns}; status=${formatCounts(summary.runsByStatus)}; official=${summary.officialTopologies.join(", ")}`,
     ];
     for (const record of summary.active.slice(0, 6)) {
         lines.push(`  ${record.id}: ${record.topologyId}, status=${record.status}, readiness=${record.readiness}`);
@@ -203,13 +178,16 @@ function formatTopologyPanel(summary) {
         lines.push(`  next=${summary.nextAction}`);
     return lines.join("\n");
 }
+/** `Multi-Agent` panel — port of the old build's formatMultiAgentPanel
+ *  (operator-ux/format.ts): the run/role/group/membership/fanout/fanin
+ *  rollup with per-group role coverage and blocked reasons. */
 function formatMultiAgentPanel(summary) {
     const lines = [
         "Multi-Agent",
         `  runs=${summary.totalRuns}; status=${formatCounts(summary.runsByStatus)}`,
         `  roles=${summary.roles}; groups=${summary.groups} (${formatCounts(summary.groupsByStatus)})`,
         `  memberships=${summary.memberships} (${formatCounts(summary.membershipsByStatus)})`,
-        `  fanouts=${summary.fanouts}; fanins=${summary.fanins} (${formatCounts(summary.faninsByStatus)})`
+        `  fanouts=${summary.fanouts}; fanins=${summary.fanins} (${formatCounts(summary.faninsByStatus)})`,
     ];
     for (const group of summary.groupsDetail.slice(0, 6)) {
         lines.push(`  group ${group.id}: ${group.status}, phase=${group.phase || "none"}, run=${group.multiAgentRunId}`);
@@ -224,6 +202,25 @@ function formatMultiAgentPanel(summary) {
         lines.push(`  next=${summary.nextAction}`);
     return lines.join("\n");
 }
+/** `cw multi-agent summary <run>` human text — the same `Multi-Agent`
+ *  panel `cw status` shows, port of the old build's formatMultiAgentSummary
+ *  (operator-ux/format.ts). */
+function formatMultiAgentSummaryText(summary) {
+    return formatMultiAgentPanel(summary);
+}
+/** `Multi-Agent Operator UX` block — port of the old build's inline
+ *  operator-status summary (operator-ux/format.ts:41-45): active runs,
+ *  dependency/failure/evidence counts, and the next command. */
+function formatMultiAgentOperatorBlock(operator) {
+    return [
+        "Multi-Agent Operator UX",
+        `  active=${operator.activeMultiAgentRunIds.join(", ") || "none"}; topologies=${operator.topologyRunIds.join(", ") || "none"}; blocked=${operator.blocked ? "yes" : "no"}`,
+        `  dependencies=${operator.dependencies.length}; failures=${operator.failures.length}; adoptedEvidence=${operator.adoptedEvidence.length}; missingEvidence=${operator.missingEvidence.length}${operator.inspectableEvidence.length ? ` (inspectable=${operator.inspectableEvidence.length})` : ""}`,
+        `  next=${operator.nextAction}`,
+    ].join("\n");
+}
+/** `Blackboard / Coordinator` panel — port of the old build's
+ *  formatBlackboardPanel (operator-ux/format.ts). */
 function formatBlackboardPanel(summary) {
     const lines = [
         "Blackboard / Coordinator",
@@ -231,7 +228,7 @@ function formatBlackboardPanel(summary) {
         `  open questions=${summary.openQuestions.length}; conflicts=${summary.conflicts.length}; missing evidence=${summary.missingEvidence.length}`,
         `  ready for fanin=${summary.readyForFanin ? "yes" : "no"}`,
         `  index=${summary.indexPath || "none"}`,
-        `  latest snapshot=${summary.latestSnapshotPath || "none"}`
+        `  latest snapshot=${summary.latestSnapshotPath || "none"}`,
     ];
     for (const question of summary.openQuestions.slice(0, 5))
         lines.push(`  question ${question.id}: ${question.value}`);
@@ -243,65 +240,124 @@ function formatBlackboardPanel(summary) {
         lines.push(`  next=${summary.nextAction}`);
     return lines.join("\n");
 }
-function arrayView(value) {
-    return Array.isArray(value) ? value : [];
+/** The full `cw status <id>` human render — port of formatOperatorStatus's
+ *  panel order (worker/candidate/feedback/commit, then the
+ *  multi-agent/operator-ux/blackboard sub-panels the operator-ux smokes
+ *  pin, then trust and the report path). */
+function formatOperatorStatus(summary) {
+    return [
+        formatOperatorSummary(summary),
+        "",
+        formatWorkerPanel(summary.workers),
+        "",
+        formatCandidatePanel(summary.candidates),
+        "",
+        formatFeedbackPanel(summary.feedback),
+        "",
+        formatCommitPanel(summary.commits),
+        "",
+        formatTopologyPanel(summary.multiAgentOperator.summaries.topologies),
+        "",
+        formatMultiAgentPanel(summary.multiAgent),
+        "",
+        formatMultiAgentOperatorBlock(summary.multiAgentOperator),
+        "",
+        formatBlackboardPanel(summary.blackboard),
+        "",
+        formatTrustPanel(summary.trust),
+        "",
+        formatMultiAgentTrustAudit(summary.multiAgentTrust),
+        "",
+        `Report: ${summary.reportPath}`,
+    ].join("\n");
 }
-function formatRolePolicyRows(rows) {
-    if (!rows.length)
+function formatTaskList(tasks) {
+    const active = [...tasks.running, ...tasks.pending];
+    if (!active.length)
         return ["  none"];
-    return rows.slice(0, 40).map((row) => {
-        const writes = Array.isArray(row.allowedWriteOperations) ? row.allowedWriteOperations.join(",") : "none";
-        const candidates = Array.isArray(row.allowedCandidateOperations) ? row.allowedCandidateOperations.join(",") : "none";
-        const judges = Array.isArray(row.allowedJudgeOperations) ? row.allowedJudgeOperations.join(",") : "none";
-        const topics = Array.isArray(row.allowedBlackboardTopicIds) ? row.allowedBlackboardTopicIds.join(",") : "none";
-        return `  ${String(row.policyRef || row.id || row.subjectId)} subject=${String(row.subjectKind || "unknown")}:${String(row.subjectId || "unknown")} topics=${topics} writes=${writes} candidates=${candidates} judges=${judges}`;
-    });
+    return active.map((id) => `  ${id}`);
 }
-function formatAuditRows(rows) {
-    if (!rows.length)
-        return ["  none"];
-    return rows.slice(0, 60).map((row) => {
-        const metadata = row.metadata && typeof row.metadata === "object" ? row.metadata : {};
-        const ids = [
-            row.agentRoleId ? `role=${row.agentRoleId}` : "",
-            row.agentMembershipId ? `membership=${row.agentMembershipId}` : "",
-            row.blackboardMessageId ? `message=${row.blackboardMessageId}` : "",
-            row.blackboardContextId ? `context=${row.blackboardContextId}` : "",
-            row.blackboardArtifactRefId ? `artifact=${row.blackboardArtifactRefId}` : "",
-            row.coordinatorDecisionId ? `decision=${row.coordinatorDecisionId}` : "",
-            row.candidateId ? `candidate=${row.candidateId}` : "",
-            row.scoreId ? `score=${row.scoreId}` : "",
-            row.selectionId ? `selection=${row.selectionId}` : ""
-        ].filter(Boolean).join(" ");
-        const reason = metadata.reason ? ` reason=${String(metadata.reason)}` : "";
-        const operation = metadata.operation ? ` operation=${String(metadata.operation)}` : "";
-        return `  [${String(row.decision || "recorded")}] ${String(row.kind || "event")} ${String(row.id || "")}${operation}${ids ? ` ${ids}` : ""}${row.policyRef ? ` policy=${String(row.policyRef)}` : ""}${reason}`;
-    });
+/** `cw report <id> --show` — byte-exact port of formatOperatorReport's
+ *  fixed 18-line Resource Commands tail plus Active/Pending Tasks and
+ *  Evidence sections (multi-agent dependency/failure/evidence panels are
+ *  scoped out of this milestone's port per the file header note). */
+function formatOperatorReport(summary, evidencePaths) {
+    return [
+        formatOperatorStatus(summary),
+        "",
+        "Active and Pending Tasks",
+        ...formatTaskList(summary.tasks),
+        "",
+        "Evidence",
+        ...(evidencePaths.length ? evidencePaths.map((entry) => `  ${entry}`) : ["  none recorded"]),
+        "",
+        (0, multi_agent_operator_ux_1.formatMultiAgentDependencies)(summary.multiAgentOperator.dependencies),
+        "",
+        (0, multi_agent_operator_ux_1.formatMultiAgentFailures)(summary.multiAgentOperator.failures),
+        "",
+        (0, multi_agent_operator_ux_1.formatMultiAgentEvidence)(summary.multiAgentOperator.evidence),
+        "",
+        "Resource Commands",
+        `  node scripts/cw.js graph ${summary.runId}`,
+        `  node scripts/cw.js worker summary ${summary.runId}`,
+        `  node scripts/cw.js topology summary ${summary.runId}`,
+        `  node scripts/cw.js topology graph ${summary.runId}`,
+        `  node scripts/cw.js multi-agent summary ${summary.runId}`,
+        `  node scripts/cw.js multi-agent graph ${summary.runId}`,
+        `  node scripts/cw.js multi-agent dependencies ${summary.runId}`,
+        `  node scripts/cw.js multi-agent failures ${summary.runId}`,
+        `  node scripts/cw.js multi-agent evidence ${summary.runId}`,
+        `  node scripts/cw.js blackboard summary ${summary.runId}`,
+        `  node scripts/cw.js blackboard graph ${summary.runId}`,
+        `  node scripts/cw.js coordinator summary ${summary.runId}`,
+        `  node scripts/cw.js candidate summary ${summary.runId}`,
+        `  node scripts/cw.js feedback summary ${summary.runId}`,
+        `  node scripts/cw.js commit summary ${summary.runId}`,
+        `  node scripts/cw.js audit summary ${summary.runId}`,
+        `  node scripts/cw.js audit provenance ${summary.runId}`,
+        `  node scripts/cw.js audit multi-agent ${summary.runId}`,
+        `  node scripts/cw.js audit policy ${summary.runId}`,
+        `  node scripts/cw.js audit blackboard ${summary.runId}`,
+        `  node scripts/cw.js audit judge ${summary.runId}`,
+    ].join("\n");
 }
-function formatWorkerPanel(summary) {
-    const lines = [
-        "Workers",
-        `  total=${summary.total}; status=${formatCounts(summary.byStatus)}; sandbox=${formatCounts(summary.bySandboxProfile)}; backend=${formatCounts(summary.byBackend)}`
-    ];
-    for (const worker of summary.workers.slice(0, 8)) {
-        const attestation = worker.backendAttestationStatus ? `/${worker.backendAttestationStatus}` : "";
-        lines.push(`  ${worker.id}: ${worker.status}, task=${worker.taskId}, sandbox=${worker.sandboxProfileId || "none"}, backend=${worker.backendId || "none"}${attestation}`);
-        lines.push(`    manifest=${worker.manifestPath}`);
-        lines.push(`    result=${worker.resultPath}`);
-        if (worker.feedbackIds.length)
-            lines.push(`    feedback=${worker.feedbackIds.join(", ")}`);
+function groupBy(values, key) {
+    const groups = {};
+    for (const value of values) {
+        const bucket = key(value);
+        (groups[bucket] ||= []).push(value);
+    }
+    return groups;
+}
+/** `cw graph <id>` human render — byte-exact port of formatOperatorGraph. */
+function formatOperatorGraph(graph) {
+    const lines = [`Run Graph: ${graph.runId}`, "", "Nodes"];
+    const groups = groupBy(graph.nodes, (node) => node.kind);
+    for (const kind of Object.keys(groups).sort()) {
+        lines.push(`  ${kind}`);
+        for (const node of groups[kind]) {
+            const suffix = node.path ? ` -> ${node.path}` : "";
+            lines.push(`    [${node.status}] ${node.id} (${node.label})${suffix}`);
+        }
+    }
+    lines.push("", "Edges");
+    if (!graph.edges.length)
+        lines.push("  none");
+    for (const edge of graph.edges) {
+        lines.push(`  ${edge.from} -> ${edge.to}${edge.label ? ` (${edge.label})` : ""}`);
     }
-    if (summary.workers.length > 8)
-        lines.push(`  ... ${summary.workers.length - 8} more worker(s)`);
     return lines.join("\n");
 }
-function formatCandidatePanel(summary) {
+/** `cw candidate summary <run>` human text — port of the old build's
+ *  formatCandidatePanel (operator-ux/format.ts): a `Candidates` rollup with
+ *  status/kind counts, the latest ranking, and the ready-for-commit list. */
+function formatCandidateSummaryText(summary) {
     const lines = [
         "Candidates",
         `  total=${summary.total}; status=${formatCounts(summary.byStatus)}; kind=${formatCounts(summary.byKind)}`,
-        `  latest ranking=${summary.latestRankingPath || "none"}`,
+        `  latest ranking=${summary.latestRankingPath || summary.rankingPath || "none"}`,
         `  selected=${summary.selected.map((selection) => `${selection.candidateId}/${selection.selectionId}`).join(", ") || "none"}`,
-        `  ready for commit=${summary.readyForCommit.map((item) => `${item.candidateId}/${item.selectionId}`).join(", ") || "none"}`
+        `  ready for commit=${summary.readyForCommit.map((item) => `${item.candidateId}/${item.selectionId}`).join(", ") || "none"}`,
     ];
     for (const problem of summary.problems.slice(0, 5))
         lines.push(`  problem: ${problem}`);
@@ -312,59 +368,14 @@ function formatCandidatePanel(summary) {
         lines.push(`  ... ${summary.candidates.length - 8} more candidate(s)`);
     return lines.join("\n");
 }
-function formatFeedbackPanel(summary) {
-    const lines = [
+/** `cw feedback summary <run>` human text — port of the old build's
+ *  formatFeedbackPanel (operator-ux/format.ts): a `Feedback` rollup with
+ *  status/severity/classification counts. */
+function formatFeedbackSummaryText(summary) {
+    return [
         "Feedback",
         `  total=${summary.total}; status=${formatCounts(summary.byStatus)}`,
         `  severity=${formatCounts(summary.bySeverity)}`,
         `  classification=${formatCounts(summary.byClassification)}`,
-        `  retryable=${summary.retryable}; nonRetryable=${summary.nonRetryable}`
-    ];
-    for (const record of summary.open.slice(0, 6)) {
-        lines.push(`  ${record.id}: ${record.severity}/${record.classification}, retryable=${record.retryable ? "yes" : "no"}`);
-        lines.push(`    ${record.message}`);
-    }
-    return lines.join("\n");
-}
-function formatCommitPanel(summary) {
-    const lines = [
-        "Commits",
-        `  total=${summary.total}; verifier-gated=${summary.verifierGated}; checkpoints=${summary.checkpoints}`,
-        `  latest=${summary.latest ? `${summary.latest.id} (${summary.latest.kind}) ${summary.latest.snapshotPath}` : "none"}`
-    ];
-    for (const commit of summary.commits.slice(-8)) {
-        lines.push(`  ${commit.id}: ${commit.kind}, reason=${commit.reason}`);
-        lines.push(`    verifier=${commit.verifierNodeId || "none"} candidate=${commit.candidateId || "none"} selection=${commit.selectionId || "none"} evidence=${commit.evidenceCount}`);
-        lines.push(`    snapshot=${commit.snapshotPath}`);
-    }
-    return lines.join("\n");
-}
-function formatTaskList(summary) {
-    const lines = [];
-    for (const [label, values] of [
-        ["pending", summary.pending],
-        ["running", summary.running],
-        ["failed", summary.failed]
-    ]) {
-        lines.push(`  ${label}: ${values.length ? values.join(", ") : "none"}`);
-    }
-    return lines;
-}
-function formatRecommendations(actions) {
-    return actions.length ? actions.map((action) => `  ${action.command}\n    reason: ${action.reason}`) : ["  none"];
-}
-function formatCounts(counts) {
-    const entries = Object.entries(counts).filter(([, value]) => value > 0).sort(([left], [right]) => left.localeCompare(right));
-    if (!entries.length)
-        return "none";
-    return entries.map(([key, value]) => `${key}=${value}`).join(", ");
-}
-function groupBy(items, getKey) {
-    const groups = {};
-    for (const item of items) {
-        const key = getKey(item);
-        groups[key] = groups[key] || [];
-        groups[key].push(item);
-    }
-    return groups;
+    ].join("\n");
 }