@jterrats/open-orchestra 0.4.1 → 0.4.2-beta.2

package/AGENTS.md

@@ -150,7 +150,7 @@
 - Mark breaking changes with `!` and a `BREAKING CHANGE:` footer.
 - Keep PRs <400 lines. Review your own diff before requesting review.
 
-<!-- open-orchestra:start block-id="runtime-bootstrap" generator="open-orchestra runtime bootstrap" version="1" target="codex" source-manifest="open-orchestra command-manifest,runtime-bootstrap" content-sha256="c215b82bf89b09651384dbee3c7bd8c4e66cab148adc844b4979788848017be5" updated-at="2026-05-06T22:12:02.623Z" -->
+<!-- open-orchestra:start block-id="runtime-bootstrap" generator="open-orchestra runtime bootstrap" version="1" target="codex" source-manifest="open-orchestra command-manifest,runtime-bootstrap" content-sha256="411e2d184a03aafe61fc4b71d49011f83a4f94d33d3a64cc4cd590a979d07319" updated-at="2026-05-10T05:17:06.513Z" -->
 # Open Orchestra Runtime Bootstrap
 
 Runtime target: Codex. Reference Open Orchestra from AGENTS.md so local CLI work follows workflow gates.
@@ -210,9 +210,11 @@ orchestra benchmark --task <ID>
 ```
 
 ## Active Work
-- Run `orchestra health --json`.
-- Run `orchestra task list --json` and identify the active task.
+- At session start, run `orchestra health --json` before implementation or file edits.
+- Run `orchestra task list --json --status pending,blocked,in_progress` and identify resumable work before creating a new task.
 - For the active task, run context, delegation, plan, skills, protocol, and workflow render commands.
+- Run `orchestra validate --pre-run --task <ID> --json` before implementation; resolve missing estimate, workflow run, evidence, or review checks.
+- If a user accepts a smaller/advisory path, record it with `orchestra validate --pre-run --task <ID> --bypass --bypass-rationale "..."`.
 
 ## Task Loop
 - `orchestra health` - Check local tools and workflow readiness.

package/dist/advisory-artifacts.d.ts

@@ -0,0 +1,14 @@
+import type { WorkspaceClassification } from "./types.js";
+export interface AdvisoryArtifactsResult {
+    files: string[];
+    projectTask: {
+        id: string;
+        title: string;
+        ownerRole: string;
+        acceptanceCriteria: string[];
+    };
+}
+export declare function writeAdvisoryArtifacts({ root, classification, }: {
+    root: string;
+    classification: WorkspaceClassification;
+}): Promise<AdvisoryArtifactsResult>;

package/dist/advisory-artifacts.js

@@ -0,0 +1,100 @@
+import { WORKFLOW_DIR } from "./constants.js";
+import { defaultRoles } from "./defaults.js";
+import { writeArtifact } from "./workspace.js";
+const ADVISORY_DIRECTORY = "advisory";
+export async function writeAdvisoryArtifacts({ root, classification, }) {
+    const projectTask = advisoryProjectTask();
+    const files = [
+        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, "project-task.json", `${JSON.stringify(projectTask, null, 2)}\n`),
+    ];
+    return { files, projectTask };
+}
+function advisoryProjectTask() {
+    return {
+        id: "ADVISORY-CONVERSION",
+        title: "Convert advisory findings into a project task",
+        ownerRole: "product_owner",
+        acceptanceCriteria: [
+            "Target project is confirmed",
+            "Backlog item and scope are approved",
+            "Risks and assumptions are reviewed",
+            "Evidence from advisory artifacts is linked",
+        ],
+    };
+}
+function renderAdvisoryReadme(classification) {
+    return `# Advisory Workspace
+
+This workspace was initialized in advisory mode. Open Orchestra created workflow
+state and portable guidance under \`${WORKFLOW_DIR}/advisory\` without writing
+root instruction files.
+
+## Use This For
+
+- Product and technical discovery before choosing a target repository.
+- Reviewing requirements, risks, acceptance criteria, and delivery evidence.
+- Preparing a project task that can be copied into a real project workspace.
+
+## Safe Next Steps
+
+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.
+
+## Classification
+
+- Kind: \`${classification.kind}\`
+- Write policy: \`${classification.writePolicy}\`
+- Signals: ${classification.signals.map((signal) => `\`${signal}\``).join(", ")}
+`;
+}
+function renderRoleGuides(roles) {
+    const advisoryRoles = roles.filter((role) => [
+        "product_owner",
+        "analyst",
+        "architect",
+        "developer",
+        "qa",
+        "security",
+        "release_manager",
+        "technical_writer",
+    ].includes(role.id));
+    return `# Advisory Role Guides
+
+${advisoryRoles.map(renderRoleGuide).join("\n\n")}
+`;
+}
+function renderRoleGuide(role) {
+    const activates = (role.activationCriteria ?? ["requested by workflow"])
+        .slice(0, 3)
+        .map((item) => `- ${item}`)
+        .join("\n");
+    return `## ${role.name}
+
+Focus: ${role.description}
+
+Activation:
+${activates}
+`;
+}
+function renderPortableDecisions() {
+    return `# Portable Advisory Decisions
+
+Use this file for decisions that should survive the move from advisory mode to a
+project workspace.
+
+## Decision Template
+
+- Title:
+- Context:
+- Decision:
+- Consequences:
+- Evidence:
+- Owner:
+- Status: proposed
+`;
+}
+//# sourceMappingURL=advisory-artifacts.js.map

package/dist/advisory-artifacts.js.map

@@ -0,0 +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"}

package/dist/assets/web-console.js

@@ -6,6 +6,10 @@ function buildDashboardChartData(input) {
     graphState: GRAPH_STATE_LABELS.map((label) => ({
       label,
       value: input.graph[label].length
+    })).filter((slice) => slice.value > 0),
+    costByProvider: (input.usage?.byProvider ?? []).map((provider) => ({
+      label: provider.key,
+      value: provider.estimatedCostUsd
     })).filter((slice) => slice.value > 0)
   };
 }
@@ -18,7 +22,10 @@ var endpoints = [
   ["roles", "/api/roles"],
   ["evidence", "/api/evidence"],
   ["approvals", "/api/approvals"],
+  ["usage", "/api/usage"],
+  ["budget", "/api/budget"],
   ["tasks", "/api/tasks"],
+  ["workflowRuns", "/api/workflow/runs"],
   ["evidenceView", "/api/evidence/view"],
   ["roleActivation", "/api/roles/activation"],
   ["skills", "/api/skills"],
@@ -34,12 +41,16 @@ var validation = document.querySelector("#validation");
 var workspaceView = document.querySelector("#workspace-view");
 var graph = document.querySelector("#graph");
 var actions = document.querySelector("#actions");
+var taskOwner = document.querySelector("#task-owner");
 var charts = document.querySelector("#charts");
 var evidenceTask = document.querySelector("#evidence-task");
 var evidenceType = document.querySelector("#evidence-type");
 var evidenceList = document.querySelector("#evidence-list");
 var rolesView = document.querySelector("#roles-view");
 var planningView = document.querySelector("#planning-view");
+var workflowTask = document.querySelector("#workflow-task");
+var workflowRuns = document.querySelector("#workflow-runs");
+var costView = document.querySelector("#cost-view");
 var playwrightTask = document.querySelector("#playwright-task");
 var playwrightPlan = document.querySelector("#playwright-plan");
 var skillsTask = document.querySelector("#skills-task");
@@ -56,6 +67,7 @@ var lessonPromotionResult = document.querySelector(
 );
 var taskStatusChart;
 var graphStateChart;
+var providerCostChart;
 var themeToggle = document.querySelector("#theme-toggle");
 applyStoredTheme();
 themeToggle.addEventListener("click", toggleTheme);
@@ -69,6 +81,9 @@ document.querySelector("#skills-plan").addEventListener("click", loadSkillPlan);
 document.querySelector("#skills-render").addEventListener("click", loadSkillRender);
 document.querySelector("#lesson-add").addEventListener("click", addLesson);
 document.querySelector("#lesson-promote").addEventListener("click", promoteLessons);
+document.querySelector("#task-add").addEventListener("click", addTaskFromWeb);
+document.querySelector("#workflow-start").addEventListener("click", startWorkflowFromWeb);
+workflowRuns.addEventListener("click", handleWorkflowAction);
 loadDashboard();
 function applyStoredTheme() {
   const stored = localStorage.getItem("open-orchestra-theme");
@@ -115,17 +130,22 @@ function render(data) {
     metric(String(data.roles.length), "Roles"),
     metric(String(data.evidence.length), "Evidence"),
     metric(String(data.approvals.length), "Approvals"),
+    metric(formatCurrency(data.usage.totals.estimatedCostUsd), "Est. Cost"),
     metric(data.validation.valid ? "Valid" : "Needs work", "Workspace")
   ]);
   renderValidation(data.validation);
   renderWorkspace(data.workspaceClassification, data.runtimeAdapters);
   renderGraph(data.graph);
   renderActions(data);
+  renderTaskWriteControls(data.roles);
   renderCharts(data);
   renderEvidenceControls(data);
   renderEvidence(data.evidenceView);
   renderRoles(data.roleActivation);
   renderPlanning(data.roleActivation);
+  renderWorkflowControls(data.tasks, data.workflowRuns);
+  renderWorkflowRuns(data.workflowRuns);
+  renderCost(data.usage, data.budget);
   renderPlaywrightTasks(data.tasks);
   renderSkillControls(data);
   renderSkillCatalog(data.skills, data.sources);
@@ -134,6 +154,46 @@ function render(data) {
   loadPlaywrightPlan();
   loadSkillPlan();
 }
+function renderTaskWriteControls(roles) {
+  replace(
+    taskOwner,
+    roles.map(function(role) {
+      return option(role.id, role.id);
+    })
+  );
+}
+async function addTaskFromWeb() {
+  const id = document.querySelector("#task-id").value.trim();
+  const title = document.querySelector("#task-title").value.trim();
+  if (!id || !title || !taskOwner.value) {
+    setLoading("Task id, title, and owner are required", "warn");
+    return;
+  }
+  const response = await fetch("/api/tasks/add", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      id,
+      title,
+      ownerRole: taskOwner.value,
+      paths: csvValues(document.querySelector("#task-paths").value),
+      acceptanceCriteria: csvValues(
+        document.querySelector("#task-acceptance").value
+      ),
+      risks: csvValues(document.querySelector("#task-risks").value)
+    })
+  });
+  if (!response.ok) {
+    setLoading("Task add failed", "warn");
+    return;
+  }
+  ["#task-id", "#task-title", "#task-paths", "#task-acceptance", "#task-risks"].map(function(selector) {
+    return document.querySelector(selector);
+  }).forEach(function(input) {
+    input.value = "";
+  });
+  await loadDashboard();
+}
 function renderWorkspace(classification, adapters) {
   const adapterNames = adapters.map(function(adapter) {
     return adapter.label;
@@ -149,7 +209,7 @@ function renderWorkspace(classification, adapters) {
 }
 function renderCharts(data) {
   const chartData = buildDashboardChartData(data);
-  const hasChartData = chartData.taskStatus.length > 0 || chartData.graphState.length > 0;
+  const hasChartData = chartData.taskStatus.length > 0 || chartData.graphState.length > 0 || chartData.costByProvider.length > 0;
   charts.hidden = !hasChartData;
   if (!hasChartData || !globalThis.Chart) {
     return;
@@ -166,6 +226,12 @@ function renderCharts(data) {
     "bar",
     chartData.graphState
   );
+  providerCostChart = renderChart(
+    providerCostChart,
+    "provider-cost-chart",
+    "bar",
+    chartData.costByProvider
+  );
 }
 function renderChart(current, canvasId, type, slices) {
   const style = getComputedStyle(document.documentElement);
@@ -214,6 +280,166 @@ function renderChart(current, canvasId, type, slices) {
     }
   });
 }
+function renderWorkflowControls(tasks, runs) {
+  const currentValue = workflowTask.value;
+  replace(
+    workflowTask,
+    tasks.length > 0 ? tasks.map(function(task) {
+      return option(task.id, task.id);
+    }) : [option("", "No tasks")]
+  );
+  if (currentValue) {
+    workflowTask.value = currentValue;
+  }
+  const runningTaskIds = new Set(
+    runs.filter(function(run) {
+      return run.status === "running" || run.status === "paused";
+    }).map(function(run) {
+      return run.taskId;
+    })
+  );
+  document.querySelector("#workflow-start").disabled = !workflowTask.value || runningTaskIds.has(workflowTask.value);
+}
+function renderWorkflowRuns(runs) {
+  replace(
+    workflowRuns,
+    runs.length > 0 ? runs.slice(0, 8).map(workflowRunItem) : [
+      empty(
+        "No workflow runs yet",
+        "Start a task workflow to track phases, gates, and handoffs."
+      )
+    ]
+  );
+}
+function workflowRunItem(run) {
+  const phases = (run.phases || []).map(function(phase) {
+    return phase.phase + ":" + phase.status;
+  }).join(" -> ");
+  const node = listItem(
+    run.id + " [" + run.status + "]",
+    run.taskId + " - gates " + run.gates + (phases ? " - " + phases : "")
+  );
+  const pausedGate = [...run.phases || []].reverse().find(function(phase) {
+    return phase.status === "gate_paused";
+  });
+  const row = document.createElement("div");
+  row.className = "tag-row";
+  if (pausedGate) {
+    const approve = document.createElement("button");
+    approve.className = "text-button";
+    approve.type = "button";
+    approve.dataset.workflowAction = "approve";
+    approve.dataset.run = run.id;
+    approve.dataset.task = run.taskId;
+    approve.dataset.gate = pausedGate.gateId || "";
+    approve.textContent = "Approve Gate";
+    row.append(approve);
+  }
+  if (run.status === "paused") {
+    const resume = document.createElement("button");
+    resume.className = "text-button";
+    resume.type = "button";
+    resume.dataset.workflowAction = "resume";
+    resume.dataset.run = run.id;
+    resume.dataset.task = run.taskId;
+    resume.textContent = "Resume";
+    row.append(resume);
+  }
+  node.append(row);
+  return node;
+}
+async function startWorkflowFromWeb() {
+  if (!workflowTask.value) {
+    setLoading("Select a task to start workflow", "warn");
+    return;
+  }
+  const response = await fetch("/api/workflow/start", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      task: workflowTask.value,
+      gates: document.querySelector("#workflow-gates").value
+    })
+  });
+  if (!response.ok) {
+    setLoading("Workflow start failed", "warn");
+    return;
+  }
+  await loadDashboard();
+}
+async function handleWorkflowAction(event) {
+  const button = event.target.closest("[data-workflow-action]");
+  if (!button) {
+    return;
+  }
+  if (button.dataset.workflowAction === "approve") {
+    await approveWorkflowGateFromWeb(button);
+    return;
+  }
+  if (button.dataset.workflowAction === "resume") {
+    await resumeWorkflowFromWeb(button);
+  }
+}
+async function approveWorkflowGateFromWeb(button) {
+  const response = await fetch("/api/workflow/gate-approve", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      run: button.dataset.run,
+      gate: button.dataset.gate,
+      approver: document.querySelector("#workflow-approver").value,
+      rationale: document.querySelector("#workflow-rationale").value
+    })
+  });
+  if (!response.ok) {
+    setLoading("Gate approval failed", "warn");
+    return;
+  }
+  await loadDashboard();
+}
+async function resumeWorkflowFromWeb(button) {
+  const response = await fetch("/api/workflow/resume", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      task: button.dataset.task,
+      run: button.dataset.run
+    })
+  });
+  if (!response.ok) {
+    setLoading("Workflow resume failed", "warn");
+    return;
+  }
+  await loadDashboard();
+}
+function renderCost(usage, budget) {
+  const rows = [
+    listItem("Requests", String(usage.totals.requests)),
+    listItem("Total tokens", String(usage.totals.totalTokens)),
+    listItem("Estimated cost", formatCurrency(usage.totals.estimatedCostUsd)),
+    listItem(
+      "Budget",
+      budget.passed ? "Within configured limits" : budget.violations.length + " violation(s)"
+    )
+  ];
+  usage.byProvider.slice(0, 6).forEach(function(provider) {
+    rows.push(
+      listItem(
+        provider.key,
+        provider.requests + " request(s) - " + provider.totalTokens + " tokens - " + formatCurrency(provider.estimatedCostUsd)
+      )
+    );
+  });
+  budget.violations.slice(0, 6).forEach(function(violation) {
+    rows.push(
+      listItem(
+        "Budget violation: " + violation.scope,
+        violation.metric + " " + violation.actual + " / " + violation.limit
+      )
+    );
+  });
+  replace(costView, rows);
+}
 async function loadEvidence() {
   const query = new URLSearchParams();
   if (evidenceTask.value) {
@@ -706,6 +932,9 @@ function metric(value, label) {
   node.append(strong, span);
   return node;
 }
+function formatCurrency(value) {
+  return "$" + Number(value || 0).toFixed(4);
+}
 function listItem(title, detail) {
   const node = document.createElement("li");
   node.className = "list-item";

package/dist/autonomous-phase-lifecycle.d.ts

@@ -1,3 +1,4 @@
+import type { AutonomousPhaseDefinition } from "./autonomous-workflow-constants.js";
 import type { AutonomousPhase, AutonomousRun, SizingLabel } from "./types.js";
 export type SizingCheckResult = {
     found: true;
@@ -17,8 +18,8 @@ export type PhaseOutcome = {
     kind: "qa_fail";
     notes: string;
 };
-export declare function initPhase(root: string, run: AutonomousRun, phaseIndex: number, retryContext?: string): Promise<AutonomousPhase>;
-export declare function closePhase(root: string, run: AutonomousRun, phaseIndex: number, outcome: PhaseOutcome): Promise<{
+export declare function initPhase(root: string, run: AutonomousRun, phaseIndex: number, retryContext?: string, sequence?: AutonomousPhaseDefinition[]): Promise<AutonomousPhase>;
+export declare function closePhase(root: string, run: AutonomousRun, phaseIndex: number, outcome: PhaseOutcome, sequence?: AutonomousPhaseDefinition[]): Promise<{
     run: AutonomousRun;
     handoffArtifact?: string;
     reviewArtifact?: string;

package/dist/autonomous-phase-lifecycle.js

@@ -1,6 +1,6 @@
 import { appendEvent, readEvents, writeArtifact } from "./workspace.js";
 import { addTask, createHandoff, updateTask } from "./workflow-services.js";
-import { notifyGatePaused } from "./notifications.js";
+import { notifyGatePaused, notifyWorkflowLifecycle } from "./notifications.js";
 import { AUTONOMOUS_PHASE_SEQUENCE, PHASE_GATES, } from "./autonomous-workflow-constants.js";
 import { persistRun } from "./autonomous-run-store.js";
 import { SIZING_LABELS } from "./types.js";
@@ -26,8 +26,8 @@ export async function checkArchitectSizing(root, taskId) {
     }
     return { found: false };
 }
-export async function initPhase(root, run, phaseIndex, retryContext) {
-    const def = AUTONOMOUS_PHASE_SEQUENCE[phaseIndex];
+export async function initPhase(root, run, phaseIndex, retryContext, sequence = AUTONOMOUS_PHASE_SEQUENCE) {
+    const def = sequence[phaseIndex];
     if (!def)
         throw new Error(`invalid phase index: ${phaseIndex}`);
     const now = new Date().toISOString();
@@ -36,7 +36,7 @@ export async function initPhase(root, run, phaseIndex, retryContext) {
     const phaseTaskId = iteration === 0
         ? `${run.taskId}-${def.phase}-${runSuffix}`
         : `${run.taskId}-${def.phase}-${runSuffix}-retry${iteration}`;
-    const prevDef = phaseIndex > 0 ? AUTONOMOUS_PHASE_SEQUENCE[phaseIndex - 1] : undefined;
+    const prevDef = phaseIndex > 0 ? sequence[phaseIndex - 1] : undefined;
     const prevPhaseTaskId = prevDef
         ? `${run.taskId}-${prevDef.phase}-${runSuffix}`
         : undefined;
@@ -56,11 +56,11 @@ export async function initPhase(root, run, phaseIndex, retryContext) {
         ...(retryContext ? { notes: retryContext } : {}),
     };
 }
-export async function closePhase(root, run, phaseIndex, outcome) {
+export async function closePhase(root, run, phaseIndex, outcome, sequence = AUTONOMOUS_PHASE_SEQUENCE) {
     let resolvedOutcome = outcome;
     const now = new Date().toISOString();
-    const def = AUTONOMOUS_PHASE_SEQUENCE[phaseIndex];
-    const nextDef = AUTONOMOUS_PHASE_SEQUENCE[phaseIndex + 1];
+    const def = sequence[phaseIndex];
+    const nextDef = sequence[phaseIndex + 1];
     if (!def)
         throw new Error(`invalid phase index: ${phaseIndex}`);
     const phase = run.phases.find((p) => p.phase === def.phase);
@@ -95,6 +95,9 @@ export async function closePhase(root, run, phaseIndex, outcome) {
     const updatedPhase = {
         ...phase,
         status: outcomeToPhaseStatus(resolvedOutcome),
+        ...(resolvedOutcome.kind === "gate_pause" && nextDef
+            ? { gateId: `${def.phase}->${nextDef.phase}` }
+            : {}),
         ...(handoffArtifact !== undefined ? { handoffArtifact } : {}),
         ...(reviewArtifact !== undefined ? { reviewArtifact } : {}),
         notes: resolvedOutcome.kind !== "gate_pause"
@@ -126,7 +129,12 @@ export async function closePhase(root, run, phaseIndex, outcome) {
             taskId: run.taskId,
             actor: def.role,
             summary: `Gate pause at ${def.phase}→${nextDef?.phase ?? "end"}`,
-            metadata: { runId: run.id, phase: def.phase, reviewArtifact },
+            metadata: {
+                runId: run.id,
+                phase: def.phase,
+                gateId: `${def.phase}->${nextDef?.phase ?? "end"}`,
+                reviewArtifact,
+            },
         });
         if (reviewArtifact) {
             await notifyGatePaused({
@@ -147,6 +155,18 @@ export async function closePhase(root, run, phaseIndex, outcome) {
         });
         await updateTask({ id: phase.taskId, status: "done" }, root);
     }
+    else if (resolvedOutcome.kind === "qa_fail") {
+        await notifyWorkflowLifecycle({
+            root,
+            taskId: run.taskId,
+            kind: "qa_retry",
+            runId: run.id,
+            phase: def.phase,
+            actor: def.role,
+            detail: resolvedOutcome.notes,
+            idempotencyKey: `qa_retry:${run.id}:${updatedRun.qaIterations}`,
+        });
+    }
     return {
         run: updatedRun,
         ...(handoffArtifact !== undefined ? { handoffArtifact } : {}),

package/dist/autonomous-phase-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"autonomous-phase-lifecycle.js","sourceRoot":"","sources":["../src/autonomous-phase-lifecycle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"autonomous-phase-lifecycle.js","sourceRoot":"","sources":["../src/autonomous-phase-lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/autonomous-run-state.d.ts

@@ -1,6 +1,8 @@
+import type { AutonomousPhaseDefinition } from "./autonomous-workflow-constants.js";
 import type { AutonomousRun } from "./types.js";
-export declare function markRunFailed(root: string, run: AutonomousRun, reason: string): Promise<AutonomousRun>;
+export declare function cancelRun(root: string, runId: string, reason?: string): Promise<AutonomousRun>;
+export declare function markRunFailed(root: string, run: AutonomousRun, reason: string, failedPhase?: string): Promise<AutonomousRun>;
 export declare function markRunDone(root: string, run: AutonomousRun): Promise<AutonomousRun>;
-export declare function resumePhaseIndex(run: AutonomousRun): number;
-export declare function suspendPhaseForClarification(root: string, run: AutonomousRun, phaseIndex: number): Promise<AutonomousRun>;
-export declare function resumePhaseFromClarification(root: string, run: AutonomousRun, phaseIndex: number): Promise<AutonomousRun>;
+export declare function resumePhaseIndex(run: AutonomousRun, sequence?: AutonomousPhaseDefinition[]): number;
+export declare function suspendPhaseForClarification(root: string, run: AutonomousRun, phaseIndex: number, sequence?: AutonomousPhaseDefinition[]): Promise<AutonomousRun>;
+export declare function resumePhaseFromClarification(root: string, run: AutonomousRun, phaseIndex: number, sequence?: AutonomousPhaseDefinition[]): Promise<AutonomousRun>;