feat: tighten home and compare control copy (#94)

Author: xiaojiou176

apps/dashboard/app/page.tsx

@@ -235,11 +235,11 @@ export default async function Home() {
   const latestFailureHint = firstEnglishText(latestFailure?.action_hint_zh) || "inspect failure events";
   const latestFailureGovernanceHref = latestFailure ? "/events" : "/runs";
   const latestFailureGovernanceLabel = latestFailure
-    ? `Governance entry: ${latestFailureHint}`
-    : "Governance entry: open runs";
+    ? `Next action: ${latestFailureHint}`
+    : "Next action: open runs";
   const riskSummaryTitle =
     hasDegradedRunsData
-      ? "Data degraded"
+      ? "Degraded inputs"
       : !hasRunHistory
       ? "Waiting for first run"
       : failureRate >= 0.5 || latestRunIsFailed
@@ -298,17 +298,17 @@ export default async function Home() {
         ) : null}
         <div className="stats-grid">
           <article className="metric-card">
-            <p className="metric-label">Risk summary</p>
+            <p className="metric-label">Operator risk bulletin</p>
             <p className={`metric-value ${riskSummaryClass}`}>{riskSummaryTitle}</p>
             <p className={`cell-sub mono ${latestRunStatusClass}`}>
-              Latest status: {hasDegradedRunsData ? "Data degraded" : hasRunHistory ? statusLabelEn(latestRun?.status) : "No runs yet"}
+              Current posture: {hasDegradedRunsData ? "Degraded inputs" : hasRunHistory ? statusLabelEn(latestRun?.status) : "No runs yet"}
             </p>
             <p className={`cell-sub mono ${hasDegradedRunsData ? "cell-warning" : latestFailure ? "cell-danger" : "muted"}`}>
-              Failure category: {hasDegradedRunsData ? "unavailable while data is degraded" : String(latestFailureCategory)}
+              Primary risk: {hasDegradedRunsData ? "run list unavailable" : String(latestFailureCategory)}
             </p>
             <p className="cell-sub mono muted">{formatLocalTime(latestRun?.last_event_ts || latestRun?.created_at)}</p>
             <Link href={latestFailureGovernanceHref} className="cell-sub mono">
-              {hasDegradedRunsData ? "Governance entry: inspect data sources and the run list" : latestFailureGovernanceLabel}
+              {hasDegradedRunsData ? "Next action: inspect data sources and the run list" : latestFailureGovernanceLabel}
             </Link>
           </article>
           <article className="metric-card">

apps/dashboard/app/runs/[id]/compare/page.tsx

@@ -130,6 +130,11 @@ export default async function RunComparePage({
   const displayNextAction = hasCompareReport
     ? decision.nextAction
     : "Go back to Run Detail, run replay compare, and refresh this page once the report exists.";
+  const actionPanelTitle = hasCompareReport ? "Next operator step" : "Recovery path";
+  const actionPanelIntro = hasCompareReport
+    ? "Use compare as a decision surface first, raw JSON second."
+    : "No compare report exists yet, so this card stays focused on the shortest recovery path.";
+  const choreographyTitle = hasCompareReport ? "Operator choreography" : "Observation posture";
   const verdictTitle = !hasCompareReport
     ? "Observation mode only."
     : decision.tone === "success"
@@ -187,8 +192,8 @@ export default async function RunComparePage({
             </div>
           </Card>
           <Card className="compare-next-card">
-            <h2 className="section-title">Next operator step</h2>
-            <p className="muted">Use compare as a decision surface first, raw JSON second.</p>
+            <h2 className="section-title">{actionPanelTitle}</h2>
+            <p className="muted">{actionPanelIntro}</p>
             <p className="mono">{displayNextAction}</p>
             {incidentPack.summary ? <p className="mono">Incident: {String(incidentPack.summary)}</p> : null}
             {proofPack.summary ? <p className="mono">Proof: {String(proofPack.summary)}</p> : null}
@@ -215,7 +220,7 @@ export default async function RunComparePage({
             </div>
           </Card>
           <Card className="compare-archive-card">
-            <h3>Operator choreography</h3>
+            <h3>{choreographyTitle}</h3>
             <div className="stack-gap-2">
               <p className="muted">Keep the second card decision-oriented too. Treat this as operator choreography, not a duplicate summary.</p>
               <p className="mono">{hasCompareReport ? "Compare first → proof second → replay only after the verdict is clear." : "No compare report yet → return to Run Detail, generate compare, then re-open this room."}</p>

apps/dashboard/tests/home_page.test.tsx

@@ -134,8 +134,8 @@ describe("dashboard home run-summary clarity", () => {
       "href",
       "https://xiaojiou176-open.github.io/OpenVibeCoding/use-cases/"
     );
-    expect(screen.getByText("Risk summary")).toBeInTheDocument();
-    expect(screen.getByRole("link", { name: "Governance entry: open runs" })).toHaveAttribute("href", "/runs");
+    expect(screen.getByText("Operator risk bulletin")).toBeInTheDocument();
+    expect(screen.getByRole("link", { name: "Next action: open runs" })).toHaveAttribute("href", "/runs");
     expect(screen.getByText("Stable: no recent failed runs (0%)")).toHaveClass("badge--success");
     expect(screen.getByRole("progressbar", { name: "Failure share 0/0" })).toBeInTheDocument();
     expect(screen.getByRole("link", { name: "View all runs" })).toHaveAttribute("href", "/runs");
@@ -277,9 +277,9 @@ describe("dashboard home run-summary clarity", () => {
     ] as never[]);
 
     render(await Home());
-    expect(screen.getByText("Risk summary")).toBeInTheDocument();
-    expect(screen.getByText("Failure category: Manual review required")).toBeInTheDocument();
-    expect(screen.getByRole("link", { name: "Governance entry: inspect failure events" })).toHaveAttribute("href", "/events");
+    expect(screen.getByText("Operator risk bulletin")).toBeInTheDocument();
+    expect(screen.getByText("Primary risk: Manual review required")).toBeInTheDocument();
+    expect(screen.getByRole("link", { name: "Next action: inspect failure events" })).toHaveAttribute("href", "/events");
     expect(screen.queryByText(/^manual$/i)).not.toBeInTheDocument();
     expect(screen.getByRole("link", { name: "Run run-1" })).toHaveAttribute("href", "/runs/run-1");
     expect(screen.getByText(/Task: task-1 · Manual review required/)).toBeInTheDocument();
@@ -411,10 +411,10 @@ describe("dashboard home run-summary clarity", () => {
 
     render(await Home());
 
-    expect(screen.getByText("Data degraded")).toHaveClass("metric-value--warning");
-    expect(screen.getByText("Latest status: Data degraded")).toBeInTheDocument();
-    expect(screen.getByText("Failure category: unavailable while data is degraded")).toHaveClass("cell-warning");
-    expect(screen.getByRole("link", { name: "Governance entry: inspect data sources and the run list" })).toHaveAttribute("href", "/runs");
+    expect(screen.getByText("Degraded inputs")).toHaveClass("metric-value--warning");
+    expect(screen.getByText("Current posture: Degraded inputs")).toBeInTheDocument();
+    expect(screen.getByText("Primary risk: run list unavailable")).toHaveClass("cell-warning");
+    expect(screen.getByRole("link", { name: "Next action: inspect data sources and the run list" })).toHaveAttribute("href", "/runs");
     expect(screen.getByText("Data degraded: the run list is temporarily unavailable (0%)")).toHaveClass("badge--warning");
     expect(screen.getByText("Total: -")).toBeInTheDocument();
 

apps/dashboard/tests/run_compare_page.test.tsx

@@ -136,7 +136,8 @@ describe("run compare decision surface", () => {
     expect(screen.getAllByText("Observation only").length).toBeGreaterThan(0);
     expect(screen.getByText(/does not have a `run_compare_report` yet/i)).toBeInTheDocument();
     expect(screen.getAllByText(/run replay compare, and refresh this page/i).length).toBeGreaterThan(0);
-    expect(screen.getByText("Operator choreography")).toBeInTheDocument();
+    expect(screen.getByText("Recovery path")).toBeInTheDocument();
+    expect(screen.getByText("Observation posture")).toBeInTheDocument();
     expect(screen.getByText(/Evidence chain: Unavailable/i)).toBeInTheDocument();
     expect(screen.getByText("Compare posture")).toBeInTheDocument();
     expect(screen.getByText("Awaiting report")).toBeInTheDocument();

apps/desktop/src/pages/RunComparePage.tsx

@@ -109,6 +109,10 @@ export function RunComparePage({ runId, onBack }: Props) {
   const displayNextAction = hasCompareReport
     ? compareDecision.nextAction
     : "Go back to Run Detail, run replay compare, and refresh this surface once the compare report exists.";
+  const actionPanelTitle = hasCompareReport ? "Key deltas" : "Recovery path";
+  const actionPanelIntro = hasCompareReport
+    ? ""
+    : "No compare report exists yet, so this panel stays focused on the shortest recovery path.";
   const verdictBadge = !hasCompareReport ? "Observation only" : compareDecision.badge;
   const verdictSummary = !hasCompareReport
     ? "No structured compare report exists yet, so this room stays in observation mode."
@@ -200,8 +204,9 @@ export function RunComparePage({ runId, onBack }: Props) {
           </CardBody>
         </Card>
         <Card className="compare-stage-next">
-          <CardHeader><CardTitle>Key deltas</CardTitle></CardHeader>
+          <CardHeader><CardTitle>{actionPanelTitle}</CardTitle></CardHeader>
           <CardBody>
+            {actionPanelIntro ? <p className="muted">{actionPanelIntro}</p> : null}
             <div className="data-list">
               {deltaRows.map((item) => (
                 <div key={item.label} className="data-list-row">

design-system/pages/run-compare.md

@@ -18,6 +18,7 @@ Tell the operator:
 - The raw evidence archive must remain collapsed and visually subordinate.
 - When no compare report exists, the room must explicitly read as observation mode rather than pretending a verdict exists.
 - Observation mode must never show synthetic failure posture. Use `Missing`, `Pending`, or `Unavailable` until the compare report exists.
+- In observation mode, the second primary card should read like a `Recovery path`, not like a duplicate delta explainer.
 
 ## Avoid