Release Control
@@ -558,7 +721,7 @@ -Published Modules
@@ -581,7 +744,7 @@Compatibility
@@ -602,7 +765,7 @@Repositories
@@ -634,46 +797,33 @@
-
+
-
- Durable Run State
+Durable Release Run
no run selected
-
Durable execution. A run freezes the selected inputs and plan, claims each supported executor before its effect, and keeps explicit confirmation and reconciliation boundaries. Unsupported dependency-ordering or version-metadata steps stay visible and disabled.
-
-
-
+
-
-
-
-
+
-
-
-
-
- Release Workflow
- +
+
-
+ Durable execution. Durable Run State preserves the frozen plan and mutation receipts across refreshes. Select exact repository versions, validate the plan, then create or resume a run.
+
-
+
-
+
+
-
+
+
@@ -851,6 +1001,8 @@
unitCount: document.getElementById("unitCount"),
workflowStageStatus: document.getElementById("workflowStageStatus"),
workflowStages: document.getElementById("workflowStages"),
+ workflowGuidance: document.getElementById("workflowGuidance"),
+ workflowPrimaryAction: document.getElementById("workflowPrimaryAction"),
catalog: document.getElementById("catalog"),
catalogStatus: document.getElementById("catalogStatus"),
actions: document.getElementById("actions"),
@@ -909,8 +1061,10 @@
const releaseState = {
rows: {},
dashboard: null,
+ currentPlan: null,
manualRepo: "",
currentRun: null,
+ workflowAction: null,
runs: [],
runNextCursor: null,
runStoreAvailable: true,
@@ -945,9 +1099,16 @@
elements.cancelManualTarget.addEventListener("click", closeManualTarget);
elements.applyManualTarget.addEventListener("click", applyManualTarget);
elements.manualTargetInput.addEventListener("input", validateManualTarget);
+ elements.workflowPrimaryAction.addEventListener("click", runWorkflowPrimaryAction);
elements.candidateDir.addEventListener("input", () => {
if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
});
+ for (const control of [elements.channel, elements.publicCatalog, elements.online, elements.migrations]) {
+ control.addEventListener("change", () => {
+ invalidateReleaseDraft();
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
+ });
+ }
function api(path) {
const separator = path.indexOf("?");
@@ -1068,6 +1229,7 @@
if (selectedId && releaseState.runs.some((run) => run.run_id === selectedId)) {
elements.releaseRun.value = selectedId;
}
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
}
function renderReleaseRunStoreUnavailable(error) {
@@ -1082,6 +1244,7 @@
elements.resumeReleaseRun.disabled = true;
elements.runStatus.textContent = "unavailable";
elements.runOutput.innerHTML = ``;
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
}
async function createReleaseRun() {
@@ -1204,6 +1367,7 @@
elements.runStatus.textContent = "no run selected";
elements.resumeReleaseRun.disabled = true;
elements.runOutput.innerHTML = ``;
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
}
}
@@ -1265,7 +1430,7 @@
` : "";
- return `
1. Git Sync
@@ -700,7 +850,7 @@2. Prepare Changes
@@ -725,7 +875,7 @@3. Source Release Tag
idle · plan idle @@ -752,7 +902,7 @@ -4. Signed Website Catalog
@@ -782,7 +932,7 @@Catalog State
@@ -790,13 +940,13 @@ -
-
5. Install Catalog
- planned +5. Installation Verification
+ external gate
-
Future work: signed module archives and an installer/update catalog for deployments.
+The signed catalog and Python artifacts are produced by the durable candidate step. End-to-end installation verification still runs in release integration CI and is not yet a bounded local-console executor.
${pill("unavailable", "block")} Durable run storage cannot be read
${escapeHtml(error.message)}
Create a run after selecting exact repository versions, or choose a saved run.
`;
+ renderIdlePlan();
return;
}
elements.runStatus.textContent = "loading...";
@@ -1218,6 +1382,7 @@
elements.runStatus.textContent = "unavailable";
elements.resumeReleaseRun.disabled = true;
elements.runOutput.innerHTML = `${pill("unavailable", "block")} Run cannot be read
${escapeHtml(error.message)}
+ return `
`;
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
return;
}
const plan = await api("/api/selective-plan");
renderPlan(plan);
elements.planStatus.textContent = plan.status;
} catch (error) {
+ releaseState.currentPlan = null;
elements.planStatus.textContent = "error";
elements.actions.innerHTML = ``;
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
} finally {
setBusy([elements.buildSelectedPlan], false);
}
@@ -2117,6 +2493,7 @@
function selectChangedUnits() {
if (!releaseState.dashboard) return;
+ invalidateReleaseDraft();
let count = 0;
for (const repo of releaseState.dashboard.repositories) {
const current = primaryVersion(repo);
@@ -2134,6 +2511,7 @@
function selectUnpushedUnits() {
if (!releaseState.dashboard) return;
+ invalidateReleaseDraft();
let count = 0;
for (const repo of releaseState.dashboard.repositories) {
const current = primaryVersion(repo);
@@ -2151,6 +2529,7 @@
function selectUnreleasedUnits() {
if (!releaseState.dashboard) return;
+ invalidateReleaseDraft();
for (const repo of releaseState.dashboard.repositories) {
if (repo.spec.name === "govoplan") continue;
const unreleased = !primaryVersion(repo);
@@ -2164,11 +2543,11 @@
}
function clearSelectedUnits() {
+ invalidateReleaseDraft();
for (const repo of Object.keys(releaseState.rows)) {
releaseState.rows[repo] = { ...releaseState.rows[repo], selected: false };
}
if (releaseState.dashboard) renderReleaseUnits(releaseState.dashboard);
- renderIdlePlan();
}
function selectedRepoNames() {
${escapeHtml(`${step.order}. ${step.title || step.id}`)}
${pill(step.state, kind)}${escapeHtml(step.detail || "")}
${step.result_code ? `` : ""} @@ -1305,6 +1470,7 @@ submit.addEventListener("click", () => executeReleaseRunStep(controls.dataset.runExecuteStep, required, submit)); if (preview) preview.addEventListener("click", () => previewReleaseRunStep(controls.dataset.runExecuteStep, preview)); } + if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard); } async function executeReleaseRunStep(stepId, confirmation, button) { @@ -1572,62 +1738,245 @@ function renderWorkflowStages(data) { const s = data.summary || {}; const selected = elements.releaseUnits ? elements.releaseUnits.querySelectorAll("[data-release-check]:checked").length : 0; - const gitBlockers = (s.missing_count || 0) + (s.safe_directory_count || 0); - const branchDrift = (s.ahead_count || 0) + (s.behind_count || 0); - const releaseBlockers = gitBlockers + (s.behind_count || 0) + (s.no_head_count || 0) + (s.dirty_count || 0) + (s.error_count || 0); - const catalog = data.catalog || {}; - const hasCandidate = Boolean(elements.candidateDir?.value.trim()); - const catalogPublished = catalog.catalog_matches_public === true && catalog.keyring_matches_public === true; - const gitStatus = gitBlockers ? "blocked" : branchDrift ? "sync" : "current"; - const tagStatus = releaseBlockers ? "blocked" : selected ? "plan ready" : "select repos"; - const signedStatus = hasCandidate ? "candidate" : "waiting"; - const catalogStatus = catalogPublished ? "published" : catalog.public_checked ? "review" : "local"; - const prepareStatus = s.dirty_count ? "dirty" : "clean"; - - elements.workflowStageStatus.textContent = data.summary?.status || "unknown"; - elements.workflowStages.innerHTML = [ - workflowStage( - "1. Sync local/remote Git", - gitStatus, - gitBlockers ? "block" : branchDrift ? "warn" : "ok", - `${s.ahead_count || 0} ahead / ${s.behind_count || 0} behind / ${s.dirty_count || 0} dirty repositories` - ), - workflowStage( - "2. Prepare changes", - prepareStatus, - s.dirty_count ? "warn" : "ok", - s.dirty_count - ? `${s.dirty_count} dirty repositories need explicit prepare commits.` - : "No dirty worktrees in the current dashboard." - ), - workflowStage( - "3. Publish source release tags", - tagStatus, - releaseBlockers ? "block" : selected ? "ok" : "warn", - selected - ? `${selected} selected; preview here, then create a durable run and execute its enabled tag/push steps.` - : "Select repositories, set target versions, then preview the source release tags." - ), - workflowStage( - "4. Sign and publish website catalog", - signedStatus, - hasCandidate ? "ok" : "warn", - hasCandidate ? `Preview candidate: ${elements.candidateDir.value.trim()}` : "After every selected source tag is remotely published, use a durable run to generate and publish its receipt-bound candidate." - ), - workflowStage( - "5. Maintain install catalog", - catalogStatus, - catalogPublished ? "ok" : "warn", - "Future: signed module archives for installer and module update workflows." - ), - ].join(""); + const plan = releaseState.currentRun?.immutable?.plan || releaseState.currentPlan; + const run = releaseState.currentRun; + const phases = releaseWorkflowPhases({ summary: s, selected, plan, run }); + const completed = phases.filter((phase) => phase.state === "complete").length; + const blocked = phases.find((phase) => phase.state === "blocked" || phase.state === "unavailable"); + const active = phases.find((phase) => phase.state === "current") || blocked; + elements.workflowStageStatus.textContent = `${completed}/${phases.length} complete${run ? ` · ${run.state?.status || "unknown"}` : ""}`; + elements.workflowStages.innerHTML = phases.map(workflowStage).join(""); + for (const stage of elements.workflowStages.querySelectorAll("[data-workflow-target]")) { + stage.addEventListener("click", () => scrollToReleaseTarget(stage.dataset.workflowTarget)); + } + renderWorkflowGuidance({ summary: s, selected, plan, run, active }); } - function workflowStage(title, status, kind, detail) { - return `
-
-
`;
+ function releaseWorkflowPhases({ summary, selected, plan, run }) {
+ const inspectionNotices = (summary.missing_count || 0)
+ + (summary.safe_directory_count || 0)
+ + (summary.error_count || 0);
+ const inspectionBlockers = (summary.repository_count || 0) === 0 ? 1 : 0;
+ const phases = [
+ {
+ id: "inspect",
+ label: "Inspect",
+ target: "releaseControlSection",
+ state: inspectionBlockers ? "blocked" : "complete",
+ status: inspectionBlockers
+ ? "no repositories"
+ : inspectionNotices
+ ? `${inspectionNotices} notices`
+ : "ready",
+ },
+ {
+ id: "select",
+ label: "Targets",
+ target: "releaseTargetsSection",
+ state: selected || run ? "complete" : inspectionBlockers ? "locked" : "current",
+ status: selected || run ? `${selected || Object.keys(run?.immutable?.input?.repo_versions || {}).length} selected` : "select",
+ },
+ validationWorkflowPhase({ selected, plan, run, inspectionBlockers }),
+ runWorkflowPhase({
+ id: "source",
+ label: "Source",
+ target: "releaseRunSection",
+ run,
+ plan,
+ match: (step) => /:(preflight|tag|push)$/.test(step.id || ""),
+ waitingStatus: "create run",
+ }),
+ runWorkflowPhase({
+ id: "package",
+ label: "Package",
+ target: "releaseRunSection",
+ run,
+ plan,
+ match: (step) => ["catalog:initial-version-metadata", "catalog:selective-generator"].includes(step.id),
+ waitingStatus: "waiting",
+ }),
+ runWorkflowPhase({
+ id: "publish",
+ label: "Publish",
+ target: "releaseRunSection",
+ run,
+ plan,
+ match: (step) => step.id === "catalog:validate-sign-publish",
+ waitingStatus: "waiting",
+ }),
+ {
+ id: "verify",
+ label: "Verify",
+ target: "installVerificationSection",
+ state: run?.state?.status === "completed" ? "unavailable" : "locked",
+ status: run?.state?.status === "completed" ? "CI gate" : "waiting",
+ },
+ ];
+ const firstOpen = phases.findIndex((phase) => ["current", "blocked", "unavailable"].includes(phase.state));
+ if (firstOpen >= 0) {
+ for (let index = firstOpen + 1; index < phases.length; index += 1) {
+ if (phases[index].state !== "complete") phases[index] = { ...phases[index], state: "locked" };
+ }
+ }
+ return phases;
+ }
+
+ function validationWorkflowPhase({ selected, plan, run, inspectionBlockers }) {
+ if (inspectionBlockers) return { id: "validate", label: "Validate", target: "sourceReleaseSection", state: "locked", status: "waiting" };
+ if (!selected && !run) return { id: "validate", label: "Validate", target: "sourceReleaseSection", state: "locked", status: "waiting" };
+ if (!plan) return { id: "validate", label: "Validate", target: "sourceReleaseSection", state: "current", status: "build plan" };
+ if (plan.status === "blocked") return { id: "validate", label: "Validate", target: "sourceReleaseSection", state: "blocked", status: "blocked" };
+ return { id: "validate", label: "Validate", target: "sourceReleaseSection", state: "complete", status: "gates pass" };
+ }
+
+ function runWorkflowPhase({ id, label, target, run, plan, match, waitingStatus }) {
+ if (!plan || plan.status === "blocked") return { id, label, target, state: "locked", status: waitingStatus };
+ if (!run) return {
+ id,
+ label,
+ target,
+ state: id === "source" ? "current" : "locked",
+ status: id === "source" ? "create run" : waitingStatus,
+ };
+ const steps = (run.state?.steps || []).filter(match);
+ if (!steps.length) return { id, label, target, state: "unavailable", status: "not available" };
+ const succeeded = steps.filter((step) => step.state === "succeeded").length;
+ if (succeeded === steps.length) return { id, label, target, state: "complete", status: `${succeeded}/${steps.length}` };
+ if (steps.some((step) => ["failed", "interrupted"].includes(step.state))) {
+ return { id, label, target, state: "blocked", status: `${succeeded}/${steps.length}` };
+ }
+ if (steps.some((step) => step.state === "running" || step.available)) {
+ return { id, label, target, state: "current", status: `${succeeded}/${steps.length}` };
+ }
+ const next = steps.find((step) => step.state === "pending");
+ if (next && next.executor?.available === false && next.status !== "planned") {
+ return { id, label, target, state: "unavailable", status: next.status || "unavailable" };
+ }
+ return { id, label, target, state: "locked", status: `${succeeded}/${steps.length}` };
+ }
+
+ function workflowStage(phase, index) {
+ const unavailable = phase.state === "unavailable";
+ const marker = phase.state === "complete" ? "✓" : String(index + 1);
+ return ``;
+ }
+
+ function renderWorkflowGuidance({ summary, selected, plan, run, active }) {
+ const recommendation = run?.recommended_next || plan?.recommended_action || null;
+ let guidance;
+ if ((summary.repository_count || 0) === 0) {
+ guidance = {
+ title: "Restore the release workspace",
+ detail: "No registered repositories are available for release planning.",
+ remediation: "Review Release Control, restore the workspace or repository registry, then refresh.",
+ button: "Review blockers",
+ action: { type: "scroll", target: "releaseControlSection" },
+ };
+ } else if (!selected && !run) {
+ guidance = {
+ title: "Select release targets",
+ detail: "Choose one or more repositories and confirm each exact target version.",
+ remediation: "The release plan will include only the selected independently versioned repositories.",
+ button: "Choose targets",
+ action: { type: "scroll", target: "releaseTargetsSection" },
+ };
+ } else if (!plan) {
+ guidance = {
+ title: "Validate the selected release",
+ detail: "Build a dry-run plan to check versions, contracts, migrations, Git state, and release composition.",
+ remediation: "Planning is read-only and does not create tags or artifacts.",
+ button: "Build plan",
+ action: { type: "build-plan" },
+ };
+ } else if (plan.status === "blocked") {
+ guidance = {
+ title: recommendation?.title || "Resolve release gates",
+ detail: recommendation?.detail || "The current plan contains blockers.",
+ remediation: recommendation?.remediation || "Review the plan findings, correct the source state, then build a fresh plan.",
+ button: "Review plan",
+ action: { type: "scroll", target: "sourceReleaseSection" },
+ };
+ } else if (!run) {
+ guidance = releaseState.runStoreAvailable ? {
+ title: "Freeze a durable release run",
+ detail: `${selected} repository target${selected === 1 ? "" : "s"} passed the plan-visible gates.`,
+ remediation: "Creating the run binds the exact plan, source commits, registered remotes, and ordered mutation boundaries.",
+ button: "Create durable run",
+ action: { type: "create-run" },
+ } : {
+ title: "Restore durable run storage",
+ detail: "The release plan is valid, but the console cannot persist a safe execution record.",
+ remediation: "Review the run-storage error and restore the private state directory before executing release mutations.",
+ button: "Review storage error",
+ action: { type: "scroll", target: "releaseRunSection" },
+ };
+ } else if (recommendation?.step_id) {
+ guidance = {
+ title: recommendation.title || "Continue the release run",
+ detail: recommendation.detail || "The next durable step is ready for review.",
+ remediation: recommendation.remediation || "Open the step, review its prerequisites, and use its narrowly scoped confirmation.",
+ button: ["retry_step", "reconcile_step"].includes(recommendation.id) ? "Resolve step" : "Open next step",
+ action: { type: "run-step", target: recommendation.step_id },
+ };
+ } else if (run.state?.status === "completed") {
+ guidance = {
+ title: "Run installation verification",
+ detail: "Every durable source, package, signing, and publication step has a recorded success receipt.",
+ remediation: "End-to-end installation verification is still an external release-integration CI gate.",
+ button: "Review verification gate",
+ action: { type: "scroll", target: "installVerificationSection" },
+ };
+ } else {
+ guidance = {
+ title: recommendation?.title || active?.label || "Review release state",
+ detail: recommendation?.detail || "The next release action is not currently executable.",
+ remediation: recommendation?.remediation || "Review the blocked or unavailable step and its prerequisites.",
+ button: "Review run",
+ action: { type: "scroll", target: "releaseRunSection" },
+ };
+ }
+ releaseState.workflowAction = guidance.action;
+ elements.workflowGuidance.innerHTML = `${escapeHtml(title)}
${pill(status, kind)}${escapeHtml(detail)}
-
+
+ `;
+ elements.workflowPrimaryAction = document.getElementById("workflowPrimaryAction");
+ elements.workflowPrimaryAction.addEventListener("click", runWorkflowPrimaryAction);
+ }
+
+ function runWorkflowPrimaryAction() {
+ const action = releaseState.workflowAction;
+ if (!action) return;
+ if (action.type === "build-plan") {
+ void buildSelectedPlan();
+ return;
+ }
+ if (action.type === "create-run") {
+ void createReleaseRun();
+ return;
+ }
+ if (action.type === "run-step") {
+ const step = elements.runOutput.querySelector(`[data-run-step-id="${cssEscape(action.target)}"]`);
+ if (step) {
+ step.scrollIntoView({ behavior: "smooth", block: "center" });
+ step.querySelector("input:not(:disabled), select:not(:disabled), button:not(:disabled)")?.focus();
+ return;
+ }
+ scrollToReleaseTarget("releaseRunSection");
+ return;
+ }
+ scrollToReleaseTarget(action.target);
+ }
+
+ function scrollToReleaseTarget(targetId) {
+ const target = document.getElementById(targetId);
+ if (target) target.scrollIntoView({ behavior: "smooth", block: "start" });
}
function renderReleaseIntelligence(data) {
@@ -1723,6 +2072,7 @@
input.addEventListener("change", () => {
const repo = input.dataset.repo;
releaseState.rows[repo] = { ...releaseState.rows[repo], selected: input.checked };
+ invalidateReleaseDraft();
updateUnitCount();
});
}
@@ -1868,6 +2218,7 @@
}
function resetTarget(repoName) {
+ invalidateReleaseDraft();
const row = { ...releaseState.rows[repoName] };
delete row.target;
releaseState.rows[repoName] = row;
@@ -1880,6 +2231,7 @@
}
setRowTargetTag(repoName, target);
elements.statusLine.textContent = `${repoName} target reset.`;
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
}
function currentRowTarget(repoName) {
@@ -1887,6 +2239,7 @@
}
function setRowTarget(repoName, value) {
+ invalidateReleaseDraft();
releaseState.rows[repoName] = { ...releaseState.rows[repoName], target: value };
const element = rowTargetElement(repoName);
if (element) {
@@ -1894,6 +2247,7 @@
element.textContent = value;
}
setRowTargetTag(repoName, value);
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
}
function rowTargetElement(repoName) {
@@ -2003,6 +2357,7 @@
}
function renderPlan(plan) {
+ releaseState.currentPlan = plan;
elements.planStatus.textContent = plan.status;
const units = plan.units || [];
const compatibility = plan.compatibility || [];
@@ -2011,6 +2366,7 @@
const recommendation = plan.recommended_action || null;
if (!units.length && !compatibility.length && !steps.length && !recommendation) {
elements.actions.innerHTML = `${escapeHtml(guidance.title)}
+${escapeHtml(guidance.detail)}
+ +No selective release candidates. Select repositories above to plan a release.
`;
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
return;
}
const recommendationKind = plan.status === "blocked" ? "block" : plan.source_preflight_ready ? "ok" : "warn";
@@ -2061,11 +2417,27 @@
${compatibilityHtml}
${stepHtml}
`;
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
}
function renderIdlePlan() {
+ releaseState.currentPlan = null;
elements.planStatus.textContent = "idle";
elements.actions.innerHTML = `Select repositories above, adjust target versions, then build a plan.
`;
+ if (releaseState.dashboard) renderWorkflowStages(releaseState.dashboard);
+ }
+
+ function invalidateReleaseDraft() {
+ releaseState.currentPlan = null;
+ if (releaseState.currentRun) {
+ releaseState.currentRun = null;
+ elements.releaseRun.value = "";
+ elements.runStatus.textContent = "no run selected";
+ elements.resumeReleaseRun.disabled = true;
+ elements.runOutput.innerHTML = `The repository selection changed. Build a fresh plan before creating a durable run; saved runs remain available from the selector.
`;
+ }
+ elements.planStatus.textContent = "idle";
+ elements.actions.innerHTML = `The release inputs changed. Build a fresh plan before continuing.
`;
}
async function generateCandidate() {
@@ -2100,16 +2472,20 @@
setBusy([elements.buildSelectedPlan], true);
try {
if (!Object.keys(selectedRepoVersions()).length) {
+ releaseState.currentPlan = null;
elements.planStatus.textContent = "idle";
elements.actions.innerHTML = `${pill("idle", "warn")} No repositories selected
Select one or more rows in the repository table first.
${pill("error", "block")} Plan failed
${escapeHtml(error.message)}