@jterrats/open-orchestra 0.4.2-beta.2 → 0.5.0-beta.0

package/README.md

@@ -4,19 +4,43 @@ Open Orchestra is a local-first, provider-agnostic framework for governed multi-
 
 It coordinates agents through task graphs, durable workflow files, handoffs, reviews, evidence, gates, locks, model routing, model provenance, budget controls, and an autonomous multi-phase workflow engine. The public CLI is `orchestra`.
 
+Package naming: install `@jterrats/open-orchestra`; run the CLI as
+`orchestra`. The shorter `@jterrats/orchestra` package is not the canonical
+published install target.
+
 ## Quick Start
 
 ```bash
-npm install
-npm run build
-node bin/orchestra.js init
-node bin/orchestra.js status
-node bin/orchestra.js roles list --json
+npm install -g @jterrats/open-orchestra
+orchestra init
+orchestra status
+orchestra roles list --json
 ```
 
+When developing Open Orchestra from this repository, use `npm install`,
+`npm run build`, and `node bin/orchestra.js ...` to exercise the local source.
+
 For Claude, Codex, Cursor, VS Code, Windsurf, and generic LLM usage, see
 [docs/runtime-llm-flow.md](docs/runtime-llm-flow.md) and
 [docs/runtime-adapters.md](docs/runtime-adapters.md).
+To start by job-to-be-done, use the
+[persona workflows guide](docs/persona-workflows.md) for PO refinement,
+developer execution, QA validation, tech lead oversight, and release
+management.
+For package naming rules, see [docs/package-naming.md](docs/package-naming.md).
+
+## Supported Platforms
+
+Open Orchestra supports current Node.js LTS/runtime releases on macOS, Linux,
+and Windows. Repository scripts avoid Unix-only shell requirements for the
+core quality and workflow gates; `npm run validate:workflow` runs through a
+Node helper so it works in Windows shells as well as POSIX shells. The CI
+dogfood path validates installed-package init and workflow validation on
+`ubuntu-latest`, `macos-latest`, and `windows-latest`.
+
+Known limitations: publish/release automation may still use GitHub-hosted
+Linux shell steps, but local development, validation, and installed CLI
+dogfooding are expected to be cross-platform.
 
 ## Autonomous Workflow
 

package/dist/advisory-artifacts.d.ts

@@ -5,7 +5,13 @@ export interface AdvisoryArtifactsResult {
         id: string;
         title: string;
         ownerRole: string;
+        goal: string;
+        scope: string;
         acceptanceCriteria: string[];
+        assumptions: string[];
+        risks: string[];
+        paths: string[];
+        testStrategy: string;
     };
 }
 export declare function writeAdvisoryArtifacts({ root, classification, }: {

package/dist/advisory-artifacts.js

@@ -8,6 +8,7 @@ export async function writeAdvisoryArtifacts({ root, classification, }) {
         await writeArtifact(root, ADVISORY_DIRECTORY, "README.md", renderAdvisoryReadme(classification)),
         await writeArtifact(root, ADVISORY_DIRECTORY, "role-guides.md", renderRoleGuides(defaultRoles)),
         await writeArtifact(root, ADVISORY_DIRECTORY, "decisions.md", renderPortableDecisions()),
+        await writeArtifact(root, ADVISORY_DIRECTORY, "conversion.md", renderConversionGuide()),
         await writeArtifact(root, ADVISORY_DIRECTORY, "project-task.json", `${JSON.stringify(projectTask, null, 2)}\n`),
     ];
     return { files, projectTask };
@@ -17,12 +18,18 @@ function advisoryProjectTask() {
         id: "ADVISORY-CONVERSION",
         title: "Convert advisory findings into a project task",
         ownerRole: "product_owner",
+        goal: "Convert advisory findings into a project delivery task",
+        scope: "Advisory findings, decisions, role guides, and conversion path",
         acceptanceCriteria: [
             "Target project is confirmed",
             "Backlog item and scope are approved",
             "Risks and assumptions are reviewed",
             "Evidence from advisory artifacts is linked",
         ],
+        assumptions: ["Target project repository is confirmed before conversion."],
+        risks: ["Advisory findings may require project-owner validation."],
+        paths: [".agent-workflow/advisory"],
+        testStrategy: "Review advisory artifacts and attach project evidence.",
     };
 }
 function renderAdvisoryReadme(classification) {
@@ -42,7 +49,8 @@ root instruction files.
 
 1. Refine findings in \`${WORKFLOW_DIR}/advisory/decisions.md\`.
 2. Review role-specific responsibilities in \`${WORKFLOW_DIR}/advisory/role-guides.md\`.
-3. Convert \`${WORKFLOW_DIR}/advisory/project-task.json\` into a project task after the target repo is confirmed.
+3. Follow \`${WORKFLOW_DIR}/advisory/conversion.md\` after the target repo is confirmed.
+4. Convert \`${WORKFLOW_DIR}/advisory/project-task.json\` with \`orchestra advisory convert --json\`.
 
 ## Classification
 
@@ -51,6 +59,34 @@ root instruction files.
 - Signals: ${classification.signals.map((signal) => `\`${signal}\``).join(", ")}
 `;
 }
+function renderConversionGuide() {
+    return `# Advisory Conversion
+
+Use this checklist after the target project repository is confirmed.
+
+## Convert To A Task
+
+\`\`\`sh
+orchestra advisory convert --json
+\`\`\`
+
+Optional flags:
+
+- \`--file <file>\` converts a different project-task JSON file.
+- \`--id <id>\` overrides the advisory task ID.
+- \`--backlog <url>\` links the converted task to an external backlog item.
+- \`--target-dir <dir>\` writes the task into a specific project workspace.
+
+## Verify
+
+\`\`\`sh
+orchestra status --json
+orchestra health --json
+\`\`\`
+
+Attach the advisory README, decisions, role guides, and this conversion result as evidence on the project task.
+`;
+}
 function renderRoleGuides(roles) {
     const advisoryRoles = roles.filter((role) => [
         "product_owner",

package/dist/advisory-artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"advisory-artifacts.js","sourceRoot":"","sources":["../src/advisory-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAa/C,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAC3C,IAAI,EACJ,cAAc,GAIf;IACC,MAAM,WAAW,GAAG,mBAAmB,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG;QACZ,MAAM,aAAa,CACjB,IAAI,EACJ,kBAAkB,EAClB,WAAW,EACX,oBAAoB,CAAC,cAAc,CAAC,CACrC;QACD,MAAM,aAAa,CACjB,IAAI,EACJ,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,CAAC,YAAY,CAAC,CAC/B;QACD,MAAM,aAAa,CACjB,IAAI,EACJ,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EAAE,CAC1B;QACD,MAAM,aAAa,CACjB,IAAI,EACJ,kBAAkB,EAClB,mBAAmB,EACnB,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC5C;KACF,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO;QACL,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,+CAA+C;QACtD,SAAS,EAAE,eAAe;QAC1B,kBAAkB,EAAE;YAClB,6BAA6B;YAC7B,qCAAqC;YACrC,oCAAoC;YACpC,4CAA4C;SAC7C;KACF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,cAAuC;IACnE,OAAO;;;sCAG6B,YAAY;;;;;;;;;;;0BAWxB,YAAY;gDACU,YAAY;eAC7C,YAAY;;;;YAIf,cAAc,CAAC,IAAI;oBACX,cAAc,CAAC,WAAW;aACjC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;CAC9E,CAAC;AACF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAsB;IAC9C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1C;QACE,eAAe;QACf,SAAS;QACT,WAAW;QACX,WAAW;QACX,IAAI;QACJ,UAAU;QACV,iBAAiB;QACjB,kBAAkB;KACnB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CACpB,CAAC;IACF,OAAO;;EAEP,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;CAChD,CAAC;AACF,CAAC;AAED,SAAS,eAAe,CAAC,IAAU;IACjC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,uBAAuB,CAAC,CAAC;SACrE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;SAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,MAAM,IAAI,CAAC,IAAI;;SAEf,IAAI,CAAC,WAAW;;;EAGvB,SAAS;CACV,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;CAcR,CAAC;AACF,CAAC"}
+{"version":3,"file":"advisory-artifacts.js","sourceRoot":"","sources":["../src/advisory-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAmB/C,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAC3C,IAAI,EACJ,cAAc,GAIf;IACC,MAAM,WAAW,GAAG,mBAAmB,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG;QACZ,MAAM,aAAa,CACjB,IAAI,EACJ,kBAAkB,EAClB,WAAW,EACX,oBAAoB,CAAC,cAAc,CAAC,CACrC;QACD,MAAM,aAAa,CACjB,IAAI,EACJ,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,CAAC,YAAY,CAAC,CAC/B;QACD,MAAM,aAAa,CACjB,IAAI,EACJ,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EAAE,CAC1B;QACD,MAAM,aAAa,CACjB,IAAI,EACJ,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EAAE,CACxB;QACD,MAAM,aAAa,CACjB,IAAI,EACJ,kBAAkB,EAClB,mBAAmB,EACnB,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC5C;KACF,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO;QACL,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,+CAA+C;QACtD,SAAS,EAAE,eAAe;QAC1B,IAAI,EAAE,wDAAwD;QAC9D,KAAK,EAAE,gEAAgE;QACvE,kBAAkB,EAAE;YAClB,6BAA6B;YAC7B,qCAAqC;YACrC,oCAAoC;YACpC,4CAA4C;SAC7C;QACD,WAAW,EAAE,CAAC,2DAA2D,CAAC;QAC1E,KAAK,EAAE,CAAC,yDAAyD,CAAC;QAClE,KAAK,EAAE,CAAC,0BAA0B,CAAC;QACnC,YAAY,EAAE,wDAAwD;KACvE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,cAAuC;IACnE,OAAO;;;sCAG6B,YAAY;;;;;;;;;;;0BAWxB,YAAY;gDACU,YAAY;cAC9C,YAAY;eACX,YAAY;;;;YAIf,cAAc,CAAC,IAAI;oBACX,cAAc,CAAC,WAAW;aACjC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;CAC9E,CAAC;AACF,CAAC;AAED,SAAS,qBAAqB;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;CAyBR,CAAC;AACF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAsB;IAC9C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1C;QACE,eAAe;QACf,SAAS;QACT,WAAW;QACX,WAAW;QACX,IAAI;QACJ,UAAU;QACV,iBAAiB;QACjB,kBAAkB;KACnB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CACpB,CAAC;IACF,OAAO;;EAEP,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;CAChD,CAAC;AACF,CAAC;AAED,SAAS,eAAe,CAAC,IAAU;IACjC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,uBAAuB,CAAC,CAAC;SACrE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;SAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,MAAM,IAAI,CAAC,IAAI;;SAEf,IAAI,CAAC,WAAW;;;EAGvB,SAAS;CACV,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;CAcR,CAAC;AACF,CAAC"}

package/dist/assets/web-console.js

@@ -36,11 +36,15 @@ var endpoints = [
 ];
 var statePill = document.querySelector("#load-state");
 var lastUpdated = document.querySelector("#last-updated");
+var adoptionGuide = document.querySelector("#adoption-guide");
+var releaseReadiness = document.querySelector("#release-readiness");
 var metrics = document.querySelector("#metrics");
 var validation = document.querySelector("#validation");
 var workspaceView = document.querySelector("#workspace-view");
 var graph = document.querySelector("#graph");
 var actions = document.querySelector("#actions");
+var taskDetailSelect = document.querySelector("#task-detail-select");
+var taskDetail = document.querySelector("#task-detail");
 var taskOwner = document.querySelector("#task-owner");
 var charts = document.querySelector("#charts");
 var evidenceTask = document.querySelector("#evidence-task");
@@ -82,6 +86,8 @@ document.querySelector("#skills-render").addEventListener("click", loadSkillRend
 document.querySelector("#lesson-add").addEventListener("click", addLesson);
 document.querySelector("#lesson-promote").addEventListener("click", promoteLessons);
 document.querySelector("#task-add").addEventListener("click", addTaskFromWeb);
+document.querySelector("#task-detail-refresh").addEventListener("click", loadTaskDetail);
+taskDetailSelect.addEventListener("change", loadTaskDetail);
 document.querySelector("#workflow-start").addEventListener("click", startWorkflowFromWeb);
 workflowRuns.addEventListener("click", handleWorkflowAction);
 loadDashboard();
@@ -134,9 +140,12 @@ function render(data) {
     metric(data.validation.valid ? "Valid" : "Needs work", "Workspace")
   ]);
   renderValidation(data.validation);
+  renderAdoptionGuide(data);
+  renderReleaseReadiness(data);
   renderWorkspace(data.workspaceClassification, data.runtimeAdapters);
   renderGraph(data.graph);
   renderActions(data);
+  renderTaskDetailControls(data.tasks);
   renderTaskWriteControls(data.roles);
   renderCharts(data);
   renderEvidenceControls(data);
@@ -153,6 +162,149 @@ function render(data) {
   renderLessons(data.lessons);
   loadPlaywrightPlan();
   loadSkillPlan();
+  loadTaskDetail();
+}
+function renderTaskDetailControls(tasks) {
+  const currentValue = taskDetailSelect.value;
+  replace(
+    taskDetailSelect,
+    tasks.length > 0 ? tasks.map(function(task) {
+      return option(task.id, task.id + " - " + task.title);
+    }) : [option("", "No tasks")]
+  );
+  if (currentValue) {
+    taskDetailSelect.value = currentValue;
+  }
+}
+async function loadTaskDetail() {
+  if (!taskDetailSelect.value) {
+    replace(taskDetail, [
+      empty(
+        "No task selected",
+        "Create or select a task to inspect acceptance, evidence, and gates."
+      )
+    ]);
+    return;
+  }
+  try {
+    const response = await fetch(
+      "/api/task/detail?task=" + encodeURIComponent(taskDetailSelect.value)
+    );
+    if (!response.ok) {
+      throw new Error("task detail returned " + response.status);
+    }
+    renderTaskDetail(await response.json());
+  } catch (error) {
+    replace(taskDetail, [
+      empty("Task detail unavailable", String(error.message || error))
+    ]);
+  }
+}
+function renderTaskDetail(detail) {
+  const context = detail.context;
+  const task = context.task;
+  const releaseReadiness2 = detail.releaseReadiness;
+  const rows = document.createElement("div");
+  rows.className = "detail-grid";
+  rows.append(
+    detailBlock("Summary", [
+      task.id + " [" + task.status + "] " + task.title,
+      "Owner: " + task.ownerRole,
+      "Backlog: " + (task.backlogItem || "missing")
+    ]),
+    detailBlock("Acceptance Criteria", task.acceptanceCriteria || []),
+    detailBlock("Definition of Ready", readinessLines(context)),
+    detailBlock("Definition of Done", releaseReadinessLines(releaseReadiness2)),
+    detailBlock(
+      "AC Coverage",
+      releaseCoverageLines(detail.releaseReadinessReport)
+    ),
+    detailBlock("Risks", task.risks || []),
+    detailBlock("Handoffs", eventLines(context.handoffs)),
+    detailBlock("Reviews", eventLines(context.reviews)),
+    detailBlock("Evidence", eventLines(context.evidence)),
+    detailBlock("Gates", eventLines(context.gates)),
+    detailBlock("Next Actions", taskNextActions(context, releaseReadiness2))
+  );
+  replace(taskDetail, [rows]);
+}
+function releaseCoverageLines(report) {
+  if (!report || !Array.isArray(report.acceptanceCoverage)) {
+    return ["Coverage unavailable"];
+  }
+  if (report.acceptanceCoverage.length === 0) {
+    return ["No acceptance criteria"];
+  }
+  return report.acceptanceCoverage.map(function(coverage) {
+    const status = coverage.covered ? "covered" : "missing";
+    const suffix = coverage.missing && coverage.missing.length > 0 ? " (" + coverage.missing.join(", ") + ")" : "";
+    return coverage.criterion + ": " + status + suffix;
+  });
+}
+function readinessLines(context) {
+  const missing = [];
+  [
+    "backlogItem",
+    "goal",
+    "scope",
+    "acceptanceCriteria",
+    "assumptions",
+    "risks",
+    "testStrategy"
+  ].forEach(function(field) {
+    const value = context.task[field];
+    if (Array.isArray(value) ? value.length === 0 : !value) {
+      missing.push(field);
+    }
+  });
+  return missing.length === 0 ? ["Ready for implementation"] : missing.map(function(field) {
+    return "Missing " + field;
+  });
+}
+function releaseReadinessLines(releaseReadiness2) {
+  if (releaseReadiness2.passed) {
+    return ["Release readiness passed"];
+  }
+  return releaseReadiness2.missing.map(function(field) {
+    return "Missing " + field;
+  });
+}
+function taskNextActions(context, releaseReadiness2) {
+  const actions2 = [];
+  if ((context.task.acceptanceCriteria || []).length === 0) {
+    actions2.push("Add acceptance criteria before implementation.");
+  }
+  if (context.handoffs.length === 0) {
+    actions2.push("Create the next role handoff when work changes owner.");
+  }
+  if (context.evidence.length === 0) {
+    actions2.push(
+      "Attach command, report, screenshot, trace, or video evidence."
+    );
+  }
+  if (!releaseReadiness2.passed) {
+    actions2.push("Resolve release-readiness missing fields.");
+  }
+  return actions2.length > 0 ? actions2 : ["No task-specific action required."];
+}
+function eventLines(events) {
+  return events.length > 0 ? events.map(function(event) {
+    return event.actor + ": " + event.summary;
+  }) : ["none"];
+}
+function detailBlock(title, lines) {
+  const block = document.createElement("section");
+  block.className = "detail-block";
+  const heading = document.createElement("h3");
+  heading.textContent = title;
+  const list = document.createElement("ul");
+  (lines.length > 0 ? lines : ["none"]).forEach(function(line) {
+    const item = document.createElement("li");
+    item.textContent = line;
+    list.append(item);
+  });
+  block.append(heading, list);
+  return block;
 }
 function renderTaskWriteControls(roles) {
   replace(
@@ -194,6 +346,135 @@ async function addTaskFromWeb() {
   });
   await loadDashboard();
 }
+function renderAdoptionGuide(data) {
+  const next = determinePrimaryNextAction(data);
+  const container = document.createElement("div");
+  const lead = document.createElement("p");
+  lead.textContent = next.summary;
+  const commands = document.createElement("div");
+  commands.className = "command-list";
+  next.commands.forEach(function(command) {
+    const chip = document.createElement("code");
+    chip.className = "command-chip";
+    chip.textContent = command;
+    commands.append(chip);
+  });
+  const steps = document.createElement("ol");
+  steps.className = "step-list";
+  next.steps.forEach(function(step, index) {
+    const item = document.createElement("li");
+    const number = document.createElement("b");
+    number.textContent = String(index + 1);
+    const text = document.createElement("span");
+    text.textContent = step;
+    item.append(number, text);
+    steps.append(item);
+  });
+  container.append(lead, commands, steps);
+  replace(adoptionGuide, [container]);
+}
+function determinePrimaryNextAction(data) {
+  if (!data.validation.valid) {
+    return {
+      summary: "Resolve workspace validation before starting or releasing work.",
+      commands: ["orchestra validate", "orchestra health --json"],
+      steps: [
+        "Inspect validation errors and warnings.",
+        "Fix missing workflow files, invalid task references, or stale locks.",
+        "Refresh the console after validation passes."
+      ]
+    };
+  }
+  if (data.status.tasks.total === 0) {
+    return {
+      summary: "Create the first governed task with an owner and acceptance criteria.",
+      commands: [
+        'orchestra task add --id STORY-001 --title "First story" --owner developer --acceptance "verified outcome"',
+        "orchestra context --task STORY-001 --json"
+      ],
+      steps: [
+        "Add a task from the console or CLI.",
+        "Confirm the owner role and acceptance criteria.",
+        "Render context before implementation starts."
+      ]
+    };
+  }
+  if (data.graph.ready.length > 0) {
+    const task = data.graph.ready[0];
+    return {
+      summary: task.id + " is ready. Start with context, memory, and planning.",
+      commands: [
+        "orchestra context --task " + task.id + " --json",
+        "orchestra memory hook --point before_plan --task " + task.id + " --json",
+        "orchestra workflow run --task " + task.id + " --dry-run --gates phase"
+      ],
+      steps: [
+        "Review task context and relevant memory.",
+        "Confirm role plan and workflow gates.",
+        "Start the workflow when the plan matches the work."
+      ]
+    };
+  }
+  if (data.approvals.length > 0) {
+    return {
+      summary: "There are approval artifacts waiting for a release or workflow decision.",
+      commands: ["orchestra approvals list --json", "orchestra summary --json"],
+      steps: [
+        "Review each pending approval artifact.",
+        "Approve, reject, or capture accepted risk.",
+        "Resume the paused workflow after approval."
+      ]
+    };
+  }
+  return {
+    summary: "The workspace has no immediate blocking action.",
+    commands: ["orchestra summary --json", "orchestra release check --json"],
+    steps: [
+      "Review summary for stale evidence or locks.",
+      "Run release check before tagging.",
+      "Record smoke and rollback evidence when preparing a release."
+    ]
+  };
+}
+function renderReleaseReadiness(data) {
+  const evidenceCount = data.evidence.length;
+  const approvalCount = data.approvals.length;
+  const rows = [
+    readinessRow(
+      data.validation.valid,
+      "Workspace validation",
+      data.validation.valid ? "Valid" : "Needs fixes"
+    ),
+    readinessRow(
+      data.graph.blocked.length === 0 && data.graph.locked.length === 0,
+      "Task flow",
+      data.graph.blocked.length + " blocked, " + data.graph.locked.length + " locked"
+    ),
+    readinessRow(evidenceCount > 0, "Evidence", evidenceCount + " artifact(s)"),
+    readinessRow(
+      approvalCount === 0,
+      "Approvals",
+      approvalCount + " pending artifact(s)"
+    ),
+    readinessRow(
+      data.budget.passed,
+      "Budget",
+      data.budget.passed ? "Within configured limits" : data.budget.violations.length + " violation(s)"
+    )
+  ];
+  replace(releaseReadiness, rows);
+}
+function readinessRow(ok, title, detail) {
+  const node = listItem(title, detail);
+  const tag = document.createElement("span");
+  tag.className = ok ? "tag ok" : "tag warn";
+  tag.textContent = ok ? "ready" : "attention";
+  const row = document.createElement("div");
+  row.className = "tag-row";
+  row.append(tag);
+  node.append(row);
+  return node;
+}
 function renderWorkspace(classification, adapters) {
   const adapterNames = adapters.map(function(adapter) {
     return adapter.label;
@@ -862,10 +1143,7 @@ function renderGraph(plan) {
     ["Complete", plan.complete]
   ].flatMap(function(group) {
     return group[1].slice(0, 4).map(function(item) {
-      return listItem(
-        item.title,
-        group[0] + " - " + item.id + " - " + item.ownerRole
-      );
+      return listItem(item.title, graphItemDetail(group[0], item));
     });
   });
   replace(
@@ -878,6 +1156,20 @@ function renderGraph(plan) {
     ]
   );
 }
+function graphItemDetail(group, item) {
+  const base = group + " - " + item.id + " - " + item.ownerRole;
+  if (group === "Blocked" && item.incomplete?.length > 0) {
+    return base + " - blockers: " + item.incomplete.map(function(dependency) {
+      return dependency.id + " [" + dependency.status + "]";
+    }).join(", ");
+  }
+  if (group === "Locked" && item.locks?.length > 0) {
+    return base + " - locks: " + item.locks.map(function(lock) {
+      return lock.path + " (" + lock.reason + ")";
+    }).join(", ");
+  }
+  return base;
+}
 function renderActions(data) {
   const next = [];
   if (!data.validation.valid) {
@@ -965,6 +1257,7 @@ function renderEmpty(title, detail) {
   replace(workspaceView, []);
   replace(graph, []);
   replace(actions, []);
+  replace(taskDetail, []);
 }
 function setLoading(label, tone) {
   statePill.textContent = label;