feat: align CortexPilot with the L0 command tower contract (#66)

Author: xiaojiou176

README.md

@@ -1,11 +1,10 @@
 # CortexPilot
 
-One request. One command tower. One proof pack you can inspect before you
-trust the run.
+The command tower for AI engineering.
 
-CortexPilot gives Codex / Claude Code teams one governed operator path from the
-PM request to the Workflow Case to Proof & Replay instead of scattered agents,
-local scripts, and after-the-fact logs.
+Stop babysitting AI coding work. CortexPilot helps teams plan, delegate, track,
+resume, and prove long-running engineering work across Codex and Claude Code
+instead of juggling scattered chats, local scripts, and after-the-fact logs.
 
 CortexPilot is a contract-first multi-agent orchestration repository.
 
@@ -15,8 +14,8 @@ The public story is intentionally narrower than the full monorepo:
 - **Choose the right adoption path second**
 - **Open MCP / API / builder / skills surfaces only after the real job is clear**
 
-Current public boundary: CortexPilot is a repo-backed operator control plane,
-not a hosted product, and the shipped MCP surface remains **read-only**.
+Current public boundary: CortexPilot is a repo-backed AI engineering command
+tower, not a hosted product, and the shipped MCP surface remains **read-only**.
 
 Current lane order is deliberate:
 
@@ -105,12 +104,26 @@ Most agent demos stop at "the model replied." CortexPilot is built for the next
 question: **can we inspect what happened, review what changed, classify the
 workflow case, and rerun it without guessing?**
 
+The deeper product claim is straightforward:
+
+- **Plan** the next move instead of improvising one more prompt.
+- **Delegate** scoped work without losing the case record.
+- **Track** live progress and queue posture from one command tower.
+- **Resume** long-running work when humans step away or sessions degrade.
+- **Prove** what happened with evidence, compare, replay, and approvals.
+
+The engineering philosophy underneath that loop is equally explicit:
+
+- **Prompt Engineering**: write the right worker brief, scope, constraints, and deliverables.
+- **Context Engineering**: keep the right material in the right head, and treat explicit handoff as a fallback rather than the default loop.
+- **Harness Engineering**: move work through contracts, runtime bindings, approvals, and proof surfaces so the system can keep operating safely.
+
 This repository combines:
 
-- **Command Tower**: one operator surface for governed AI work, live run visibility, and queue posture
+- **Command Tower**: one operator surface for governed AI work, live run visibility, queue posture, and L0-style oversight
 - **Workflow Cases**: one stable operating record that ties request, verdict, proof, and linked runs together
 - **Proof & Replay**: one place to inspect evidence bundles, compare reruns, and replay failures before promotion
-- **Operator surfaces**: a web dashboard plus a macOS desktop shell for the same control plane
+- **Control surfaces**: a web dashboard plus a macOS desktop shell for the same command tower
 - **Read-only inspection surfaces**: repo-local MCP, API, and contract read models that expose truth without turning mirrors into execution authority
 - **Governed boundaries**: fail-closed gates for CI, host safety, repo hygiene, and public-proof honesty
 

apps/dashboard/README.md

@@ -2,14 +2,14 @@
 
 ## Positioning
 
-This module is the repository's **web operator surface**.
+This module is the repository's **web command-tower surface**.
 
 Read it as:
 
-- the browser-based control surface for runs, sessions, reviews, and command
-  visibility
+- the browser-based command tower for plan, delegate, track, resume, and prove
+  loops
 - a way to inspect and operate CortexPilot Command Tower orchestration truth from the web
-- a repo-owned UI for evaluating control-plane behavior
+- a repo-owned UI for L0-style oversight and case-driven operator review
 
 Do **not** read it as:
 
@@ -28,9 +28,9 @@ Do **not** read it as:
 ## Why This Module Exists
 
 If `apps/orchestrator/` is the machine room, `apps/dashboard/` is the glass
-window operators use to see what the machine room is doing. Its job is
-visibility and control, not pretending the whole repository is already a
-finished consumer product.
+command tower operators use to see what the machine room is doing. Its job is
+visibility, delegation, and proof-first oversight, not pretending the whole
+repository is already a finished consumer product.
 
 ## Input / Output
 

apps/dashboard/app/layout.tsx

@@ -4,9 +4,9 @@ import WebVitalsBridge from "../components/WebVitalsBridge";
 import "./globals.css";
 
 export const metadata = {
-  title: "CortexPilot | AI Work Command Tower for Codex, Claude Code, and MCP",
+  title: "CortexPilot | The command tower for AI engineering",
   description:
-    "Operate Codex and Claude Code workflows through one AI Work Command Tower with Workflow Cases, Model Context Protocol (MCP)-readable proof and replay, public first-run cases, and one governed operator path.",
+    "Stop babysitting AI coding work. CortexPilot plans, delegates, tracks, resumes, and proves long-running engineering work across Codex and Claude Code with Workflow Cases, read-only MCP truth, and replayable proof.",
 };
 
 export const dynamic = "force-dynamic";

apps/dashboard/app/pm/components/PMIntakeRightSidebar.tsx

@@ -115,6 +115,29 @@ function summarizeCapabilityTriggers(report: ExecutionPlanReport): string[] {
   return triggers;
 }
 
+function summarizeWorkerPromptContracts(report: ExecutionPlanReport): Array<{
+  id: string;
+  role: string;
+  scope: string;
+  verification: string;
+}> {
+  const rawContracts = Array.isArray(report.worker_prompt_contracts) ? report.worker_prompt_contracts : [];
+  return rawContracts
+    .filter((item) => typeof item === "object" && item !== null && !Array.isArray(item))
+    .map((item) => {
+      const record = item as Record<string, unknown>;
+      const verificationRaw = Array.isArray(record.verification_requirements)
+        ? record.verification_requirements.map((entry) => String(entry || "").trim()).filter(Boolean)
+        : [];
+      return {
+        id: String(record.prompt_contract_id || "-").trim() || "-",
+        role: String((record.assigned_agent as Record<string, unknown> | undefined)?.role || "-").trim() || "-",
+        scope: String(record.scope || "-").trim() || "-",
+        verification: verificationRaw.length > 0 ? verificationRaw.join(", ") : "-",
+      };
+    });
+}
+
 export default function PMIntakeRightSidebar(props: Props) {
   const {
     pmJourneyContext,
@@ -281,6 +304,10 @@ export default function PMIntakeRightSidebar(props: Props) {
   const flightPlanPredictedReports = executionPlanPreview ? compactList(executionPlanPreview.predicted_reports) : "-";
   const flightPlanPredictedArtifacts = executionPlanPreview ? compactList(executionPlanPreview.predicted_artifacts) : "-";
   const flightPlanAcceptanceChecks = executionPlanPreview ? summarizeAcceptanceChecks(executionPlanPreview) : "-";
+  const workerPromptContracts = executionPlanPreview ? summarizeWorkerPromptContracts(executionPlanPreview) : [];
+  const wavePlan = executionPlanPreview && typeof executionPlanPreview.wave_plan === "object" && executionPlanPreview.wave_plan
+    ? (executionPlanPreview.wave_plan as Record<string, unknown>)
+    : null;
 
   return (
     <aside className="pm-claude-right" aria-label="Context sidebar">
@@ -573,6 +600,30 @@ export default function PMIntakeRightSidebar(props: Props) {
                 </ul>
               </>
             ) : null}
+            {wavePlan ? (
+              <>
+                <strong>Wave plan snapshot</strong>
+                <ul className="pm-question-list">
+                  <li>Wave ID: {String(wavePlan.wave_id || "-")}</li>
+                  <li>Execution mode: {String(wavePlan.execution_mode || "-")}</li>
+                  <li>Workers in this wave: {String(wavePlan.worker_count || "-")}</li>
+                  <li>Wake policy ref: {String(wavePlan.wake_policy_ref || "-")}</li>
+                  <li>Completion policy ref: {String(wavePlan.completion_policy_ref || "-")}</li>
+                </ul>
+              </>
+            ) : null}
+            {workerPromptContracts.length > 0 ? (
+              <>
+                <strong>Worker prompt contracts</strong>
+                <ul className="pm-question-list">
+                  {workerPromptContracts.map((item) => (
+                    <li key={item.id}>
+                      <span className="mono">{item.id}</span> · {item.role} · {item.scope} · verify via {item.verification}
+                    </li>
+                  ))}
+                </ul>
+              </>
+            ) : null}
             <details>
               <summary className="pm-details-summary">Contract preview excerpts</summary>
               <div className="mono">allowed paths: {flightPlanAllowedPaths}</div>

apps/dashboard/app/policies/page.tsx

@@ -4,6 +4,11 @@ import { fetchPolicies } from "../../lib/api";
 import { safeLoad } from "../../lib/serverPageData";
 
 const SECTIONS = [
+  {
+    title: "Control-plane runtime policy",
+    key: "control_plane_runtime_policy",
+    desc: "L0 command-tower rules for session lifecycle, wake policy, completion governance, and harness evolution",
+  },
   { title: "Agent registry", key: "agent_registry", desc: "Registered agent roles and permission mappings" },
   { title: "Command allowlist", key: "command_allowlist", desc: "System commands that operators may execute" },
   { title: "Forbidden actions", key: "forbidden_actions", desc: "Globally blocked high-risk actions" },

apps/dashboard/components/AppNav.tsx

@@ -26,21 +26,21 @@ function buildNavSections(locale: UiLocale): NavSection[] {
         { href: "/", label: uiCopy.dashboard.labels.overview, icon: "grid" },
         { href: "/pm", label: uiCopy.dashboard.labels.pmIntake, icon: "message" },
         { href: "/command-tower", label: uiCopy.dashboard.labels.commandTower, icon: "tower" },
+        { href: "/workflows", label: uiCopy.dashboard.labels.workflowCases, icon: "workflow" },
         { href: "/runs", label: uiCopy.dashboard.labels.runs, icon: "play" },
         { href: "/god-mode", label: uiCopy.dashboard.labels.quickApproval, icon: "zap" },
+        { href: "/agents", label: uiCopy.dashboard.labels.agents, icon: "bot" },
+        { href: "/contracts", label: uiCopy.dashboard.labels.contracts, icon: "file" },
       ],
     },
     {
       title: uiCopy.dashboard.sectionAdvanced,
       items: [
         { href: "/search", label: uiCopy.dashboard.labels.search, icon: "search" },
-        { href: "/agents", label: uiCopy.dashboard.labels.agents, icon: "bot" },
-        { href: "/workflows", label: uiCopy.dashboard.labels.workflowCases, icon: "workflow" },
         { href: "/events", label: uiCopy.dashboard.labels.events, icon: "activity" },
         { href: "/reviews", label: uiCopy.dashboard.labels.reviews, icon: "check" },
         { href: "/diff-gate", label: uiCopy.dashboard.labels.diffGate, icon: "shield" },
         { href: "/tests", label: uiCopy.dashboard.labels.tests, icon: "test" },
-        { href: "/contracts", label: uiCopy.dashboard.labels.contracts, icon: "file" },
         { href: "/policies", label: uiCopy.dashboard.labels.policies, icon: "lock" },
         { href: "/locks", label: uiCopy.dashboard.labels.locks, icon: "key" },
         { href: "/worktrees", label: uiCopy.dashboard.labels.worktrees, icon: "tree" },

apps/dashboard/components/DashboardHomeStorySections.tsx

@@ -99,6 +99,25 @@ export default function DashboardHomeStorySections({
         </div>
       </section>
 
+      <section className="app-section" aria-labelledby="dashboard-public-advantages-title">
+        <div className="section-header">
+          <div>
+            <h2 id="dashboard-public-advantages-title" className="section-title">
+              {homePhase2Copy.publicAdvantagesTitle}
+            </h2>
+            <p>{homePhase2Copy.publicAdvantagesDescription}</p>
+          </div>
+        </div>
+        <div className="quick-grid">
+          {homePhase2Copy.publicAdvantageCards.map((item) => (
+            <Link key={item.title} href={resolveHomeHref(item.href)} className="quick-card">
+              <span className="quick-card-title">{item.title}</span>
+              <span className="quick-card-desc">{item.desc}</span>
+            </Link>
+          ))}
+        </div>
+      </section>
+
       <section className="app-section" aria-labelledby="dashboard-public-templates-title">
         <div className="section-header">
           <div>

apps/dashboard/tests/command_tower_ui.test.tsx

@@ -226,7 +226,7 @@ describe("command tower ui surfaces", () => {
 
     expect(screen.getByRole("navigation", { name: "控制台导航" })).toBeInTheDocument();
     expect(screen.getByRole("link", { name: "指挥塔" })).toBeInTheDocument();
-    expect(screen.getByText(/低频工具\s*11/)).toBeInTheDocument();
+    expect(screen.getByText(/低频工具\s*8/)).toBeInTheDocument();
   });
 
   it("keeps command tower page copy aligned across locales", () => {

apps/dashboard/tests/home_page.test.tsx

@@ -58,10 +58,14 @@ describe("dashboard home run-summary clarity", () => {
   it("renders first-run CTA and onboarding guidance when no runs", async () => {
     render(await Home());
 
-    expect(screen.getByRole("heading", { name: "Command Tower for Codex and Claude Code workflows" })).toBeInTheDocument();
+    expect(screen.getByRole("heading", { name: "The command tower for AI engineering" })).toBeInTheDocument();
     expect(
-      screen.getByText(/See one proven workflow first, then choose the right adoption path\./)
+      screen.getByText(/Stop babysitting AI coding work\./)
     ).toBeInTheDocument();
+    expect(screen.getByText("Three engineering layers behind the command tower")).toBeInTheDocument();
+    expect(screen.getByText("Prompt Engineering")).toBeInTheDocument();
+    expect(screen.getByText("Context Engineering")).toBeInTheDocument();
+    expect(screen.getByText("Harness Engineering")).toBeInTheDocument();
     expect(screen.getByRole("link", { name: "Start first task" })).toHaveAttribute("href", "/pm");
     expect(screen.getAllByRole("link", { name: /Workflow Cases/ })[0]).toHaveAttribute("href", "/workflows");
 
@@ -222,7 +226,7 @@ describe("dashboard home run-summary clarity", () => {
 
     render(await Home());
 
-    expect(screen.getByRole("heading", { name: "面向 Codex 和 Claude Code 工作流的指挥塔" })).toBeInTheDocument();
+    expect(screen.getByRole("heading", { name: "AI 工程的指挥塔" })).toBeInTheDocument();
     expect(screen.getByRole("link", { name: "启动首个任务" })).toHaveAttribute("href", "/pm");
     expect(screen.getByText("选择正确的采用路径")).toBeInTheDocument();
     expect(screen.getByRole("link", { name: "打开 AI + MCP + API 页面" })).toHaveAttribute(
@@ -412,8 +416,8 @@ describe("dashboard home run-summary clarity", () => {
   });
 
   it("renders the public shell with English-first layout metadata and chrome copy", () => {
-    expect(metadata.title).toBe("CortexPilot | AI Work Command Tower for Codex, Claude Code, and MCP");
-    expect(metadata.description).toContain("Model Context Protocol (MCP)-readable proof and replay");
+    expect(metadata.title).toBe("CortexPilot | The command tower for AI engineering");
+    expect(metadata.description).toContain("Stop babysitting AI coding work.");
 
     render(
       <DashboardShellChrome>
@@ -423,8 +427,8 @@ describe("dashboard home run-summary clarity", () => {
 
     expect(screen.getByRole("link", { name: "Skip to dashboard content" })).toHaveAttribute("href", "#dashboard-content");
     expect(screen.getAllByLabelText("Dashboard navigation").length).toBeGreaterThan(0);
-    expect(screen.getByText("Command Tower · Workflow Cases · Proof & Replay")).toBeInTheDocument();
-    expect(screen.getByText("Operator control plane")).toBeInTheDocument();
+    expect(screen.getByText("Plan · Delegate · Track · Resume · Prove")).toBeInTheDocument();
+    expect(screen.getByText("AI engineering command tower")).toBeInTheDocument();
     expect(screen.getByLabelText("Platform status overview")).toBeInTheDocument();
     expect(screen.getByText("Governance view")).toBeInTheDocument();
     expect(screen.getByText("Live verification required")).toBeInTheDocument();

apps/dashboard/tests/pm_intake_components_branches.test.tsx

@@ -337,6 +337,21 @@ describe("pm intake right sidebar component branches", () => {
             predicted_reports: ["task_result.json", "review_report.json"],
             predicted_artifacts: ["queue.jsonl", "patch.diff"],
             requires_human_approval: true,
+            wave_plan: {
+              wave_id: "bundle-preview-1",
+              execution_mode: "long_running",
+              worker_count: 1,
+              wake_policy_ref: "policies/control_plane_runtime_policy.json#/wake_policy",
+              completion_policy_ref: "policies/control_plane_runtime_policy.json#/wave_completion_policy",
+            },
+            worker_prompt_contracts: [
+              {
+                prompt_contract_id: "worker-prompt-1",
+                assigned_agent: { role: "WORKER", agent_id: "agent-1" },
+                scope: "Queue the latest workflow case run",
+                verification_requirements: ["repo_hygiene"],
+              },
+            ],
             contract_preview: {
               assigned_agent: { role: "WORKER", agent_id: "agent-1" },
               owner_agent: { role: "TECH_LEAD", agent_id: "agent-2" },
@@ -355,6 +370,10 @@ describe("pm intake right sidebar component branches", () => {
     expect(screen.getByText(/Capability triggers: Search \(1 query\), Manual approval/)).toBeInTheDocument();
     expect(screen.getByText("Operator notes")).toBeInTheDocument();
     expect(screen.getByText("Risk gates")).toBeInTheDocument();
+    expect(screen.getByText("Wave plan snapshot")).toBeInTheDocument();
+    expect(screen.getByText(/Wave ID: bundle-preview-1/)).toBeInTheDocument();
+    expect(screen.getByText("Worker prompt contracts")).toBeInTheDocument();
+    expect(screen.getByText(/worker-prompt-1/)).toBeInTheDocument();
     expect(screen.getByText("Contract preview excerpts")).toBeInTheDocument();
     expect(screen.getByText("Advanced planning payloads")).toBeInTheDocument();
   });