@bridge_gpt/mcp-server 0.2.69 → 0.2.70

package/build/conductor/readiness-sections.js

@@ -1,3 +1,4 @@
+import { READINESS_PREREQUISITE_BY_ID } from "../readiness-prerequisites.generated.js";
 /**
  * The shared epic-implementer readiness SECTION layer (BAPI-1055).
  *
@@ -33,16 +34,17 @@
  * The one exception is {@link inspectWorkflowPresence}, which awaits the
  * READ-ONLY reader seams its caller injects and never opens a path of its own.
  */
-import { PRINTED_CONNECT_GITHUB_COMMAND } from "../printed-remedy-commands.js";
+import { CONSUMER_GUIDE_POINTER, PRINTED_CONNECT_GITHUB_COMMAND } from "../printed-remedy-commands.js";
 import { MANAGED_HOOK_NAMES } from "./git-hooks.js";
 import { MCP_PACKAGE_NAME } from "../mcp-identity.js";
 import { CLAUDE_REVIEW_WORKFLOW_DRIFT_REMEDIATION, summarizeClaudeReviewWorkflowDrift, } from "../claude-review-workflow-drift.js";
-import { describeNativeLedgerAvailability, GH_ACTIONS_MERGE_AUTH_REMEDIATION, GH_ACTIONS_MERGE_SKIPPED_DETAIL, GH_ACTIONS_MERGE_UNOBSERVABLE_REMEDIATION, } from "./doctor.js";
+import { describeNativeLedgerAvailability, GH_ACTIONS_MERGE_AUTH_REMEDIATION, GH_ACTIONS_MERGE_SKIPPED_DETAIL, GH_ACTIONS_MERGE_UNOBSERVABLE_REMEDIATION, WORKER_DATABASE_DOCTOR_OWNER, WORKER_DATABASE_DOCTOR_RUNBOOK_SECTION, } from "./doctor.js";
+import { PLANE_SLEEP_BATTERY_ADVISORY, PLANE_SLEEP_LID_ADVISORY, PLANE_SLEEP_REMEDY, } from "../plane/plane-freshness.js";
 import { classifyMergeExecutionEligibility, MERGE_EXECUTION_UNVERIFIABLE_REMEDIATION, } from "./merge-execution-eligibility.js";
 import { MERGE_WORKFLOW_CHILD_MERGE_COMPATIBLE_VERSIONS, MERGE_WORKFLOW_PATH, mergeWorkflowVersionSupportsChildMerge, } from "./merge-execution-contract.js";
 import { classifyDatabaseMigration, classifySingleTransitionAuthority, classifyWorkerPresent, } from "./bring-up-facts.js";
-/** Operator runbook pointer surfaced beside the executor gap. */
-export const CONDUCTOR_OPERATOR_RUNBOOK_POINTER = "docs/epic-implementer/operator-runbook.md";
+/** Guide pointer surfaced beside the executor gap: the consumer path and its refresh command. */
+export const CONDUCTOR_OPERATOR_RUNBOOK_POINTER = CONSUMER_GUIDE_POINTER;
 /**
  * Capability-matrix guidance for the executor leg.
  *
@@ -65,14 +67,14 @@ export const EPIC_IMPLEMENTER_PROFILE_TOKEN = "epic_implementer";
 export const CONDUCTOR_PROFILE_TOKEN_NO_ENTRY_REMEDIATION = "no supported host MCP config carries a Bridge entry — run " +
     `\`npx ${MCP_PACKAGE_NAME} install\` to register one, then re-run \`install conductor\`.`;
 /** Remediation for an entry that exists but lacks the conductor token. */
-export const CONDUCTOR_PROFILE_TOKEN_REMEDIATION = "re-run `install conductor` and accept the tool-visibility consent; the conductor " +
+export const CONDUCTOR_PROFILE_TOKEN_REMEDIATION = "re-run `install conductor` and accept the tool-visibility consent; the Epic Implementer " +
     "tools become visible after the MCP client is restarted.";
-/** Remediation surfaced whenever the managed conductor hooks are not usable. */
+/** Remediation surfaced whenever the managed git hooks are not usable. */
 export const CONDUCTOR_HOOK_TARGET_REMEDIATION = "re-run `install conductor` and accept the local-observability consent, or run " +
     "`epic-implementer install-git-hooks` directly.";
 /** Remediation surfaced when the ledger's native binding does not load. */
 export const CONDUCTOR_LEDGER_LOADABILITY_REMEDIATION = "`better-sqlite3` is an optionalDependency npm silently skips on a build failure — " +
-    "reinstall it for this Node runtime to restore local conductor observability.";
+    "reinstall it for this Node runtime to restore local Epic Implementer observability.";
 /** Remediation surfaced whenever no healthy generated service unit is detected. */
 export const EXECUTOR_INSTALL_SERVICE_REMEDIATION = "generate a persistent unit with `install conductor --executor-id <id> --repo-wide` or " +
     "`executor install-service` (or run the executor by hand) — " +
@@ -98,13 +100,13 @@ export const REQUIRED_CHECKS_PRESENTATION_COPY = {
         detail: "Configuration mismatch confirmed — a configured required check conflicts with the " +
             `current lane producer contract; ${REQUIRED_CHECKS_OPERATOR_HOLD}`,
         remediation: "repair the project-default required-check configuration so it names the check the " +
-            "lane workflow emits (see the operator runbook's patch-policy section for active runs).",
+            `lane workflow emits (see ${CONSUMER_GUIDE_POINTER}).`,
     },
     unverifiable: {
         detail: "Could not verify — the configured required checks could not be matched to an " +
             `authoritative producer; ${REQUIRED_CHECKS_OPERATOR_HOLD}`,
         remediation: "restore required-check verification (a readable default branch with static lane " +
-            "workflows and a current Bridge API), or correct the required-check configuration.",
+            `workflows), or correct the required-check configuration; see ${CONSUMER_GUIDE_POINTER}.`,
     },
     // BAPI-1360 — file- and check-specific copy for the two proven, repository-admin
     // causes of `unverifiable`. Fixed strings over the two hard-coded workflow paths
@@ -113,25 +115,27 @@ export const REQUIRED_CHECKS_PRESENTATION_COPY = {
         detail: "Could not verify — a configured required check is the retired gate " +
             `conductor-ci / gate; ${REQUIRED_CHECKS_OPERATOR_HOLD}`,
         remediation: "a repository administrator replaces conductor-ci / gate with epic-implementer-ci / gate in the " +
-            "plan's required_checks, the supervisor done-gate checks, and branch protection.",
+            `plan's required_checks, the supervisor done-gate checks, and branch protection; see ${CONSUMER_GUIDE_POINTER}.`,
     },
     laneAbsent: {
         detail: "Could not verify — a lane workflow file is missing from the default branch, so a configured " +
             `required check has no producer; ${REQUIRED_CHECKS_OPERATOR_HOLD}`,
         remediation: "a repository administrator adds the missing lane workflow file(s) — " +
             ".github/workflows/epic-implementer-ci.yml and/or .github/workflows/claude-review.yml — " +
-            "to the default branch so the configured required checks (such as epic-implementer-ci / gate) have a producer.",
+            "to the default branch so the configured required checks (such as epic-implementer-ci / gate) have a producer; " +
+            `see ${CONSUMER_GUIDE_POINTER}.`,
     },
     empty: {
         detail: "Could not verify — the required-check list is EMPTY, which is unsafe: the done gate " +
             `would pass unconditionally; ${REQUIRED_CHECKS_OPERATOR_HOLD}`,
-        remediation: "configure a non-empty required-check list naming the checks the lane workflows emit.",
+        remediation: "configure a non-empty required-check list naming the checks the lane workflows emit; " +
+            `see ${CONSUMER_GUIDE_POINTER}.`,
     },
     olderServer: {
-        detail: "Could not verify — this Bridge API does not report required-check verification; " +
+        detail: "Could not verify — the server did not report required-check verification; " +
             REQUIRED_CHECKS_OPERATOR_HOLD,
-        remediation: "upgrade the Bridge API deploy so it verifies required checks, or correct the " +
-            "required-check configuration; its state is unknown here, not healthy.",
+        remediation: "retry later or correct the required-check configuration; its state is unknown here, " +
+            `not healthy. If it persists, email info@bridgegpt.ai. See ${CONSUMER_GUIDE_POINTER}.`,
     },
 };
 /**
@@ -282,10 +286,10 @@ export function gateProfileSections(profile) {
         return [
             {
                 id: "supervisor-gate-profile",
-                label: "Supervisor gate profile",
+                label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-supervisor-gate-profile").label,
                 status: "degraded",
                 detail: "the server reported no gate profile, so the CI gate is unverified",
-                remediation: "upgrade the Bridge API deploy so it reports the gate profile.",
+                remediation: "retry later; if the server still does not report the gate profile, email info@bridgegpt.ai.",
             },
         ];
     }
@@ -298,7 +302,7 @@ export function gateProfileSections(profile) {
     if (held) {
         sections.push({
             id: "supervisor-gate-profile",
-            label: "Supervisor gate profile",
+            label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-supervisor-gate-profile").label,
             status: "degraded",
             detail: profile.read_failed
                 ? `the stored gate profile could not be read — ${detail}`
@@ -310,12 +314,12 @@ export function gateProfileSections(profile) {
         });
     }
     else if (profile.verdict === "confirmed" && profile.kind !== "none") {
-        sections.push({ id: "supervisor-gate-profile", label: "Supervisor gate profile", status: "ok", detail });
+        sections.push({ id: "supervisor-gate-profile", label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-supervisor-gate-profile").label, status: "ok", detail });
     }
     else {
         sections.push({
             id: "supervisor-gate-profile",
-            label: "Supervisor gate profile",
+            label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-supervisor-gate-profile").label,
             status: "degraded",
             detail,
             remediation: profile.kind === "none"
@@ -360,14 +364,14 @@ export const EPIC_BRANCH_CI_SECTION_LABELS = {
     coverage: "Epic-branch CI coverage warning",
 };
 /** What every row says when the server did not report the block. Never "no warning". */
-export const EPIC_BRANCH_CI_UNREPORTED_DETAIL = "Unreported — upgrade the server";
+export const EPIC_BRANCH_CI_UNREPORTED_DETAIL = "Unreported by the server";
 /** The one remediation an unreported block carries. */
-export const EPIC_BRANCH_CI_UNREPORTED_REMEDIATION = "upgrade the Bridge API deploy so it reports epic-branch CI facts; this does not hold a launch.";
+export const EPIC_BRANCH_CI_UNREPORTED_REMEDIATION = "retry later; this does not hold a launch. If the server still does not report epic-branch CI facts, email info@bridgegpt.ai.";
 /** The single next step for evidence that may be out of date or uncertain. */
 export const EPIC_BRANCH_CI_RERUN_INSTALL_ADVICE = "Rerun install after workflow or ruleset changes.";
 /** Plain words for each effective review mode. */
 const EFFECTIVE_REVIEW_MODE_WORDS = {
-    repository_policy: "repository_policy — no review verdict is required for epic-branch merges",
+    repository_policy: "repository_policy — no review verdict is required for epic-branch merges; a current-head claude-review changes_requested verdict still sends the child back for fixes",
     verdict_protocol: "verdict_protocol — child merges wait for the claude-review verdict",
     native_review_decision: "native_review_decision — child merges wait for GitHub's own review decision",
     none: "none — no review signal gates child merges",
@@ -450,7 +454,10 @@ function effectiveReviewModeSection(block) {
         id: EPIC_BRANCH_CI_SECTION_IDS.reviewMode,
         label: EPIC_BRANCH_CI_SECTION_LABELS.reviewMode,
         status: "ok",
-        detail: EFFECTIVE_REVIEW_MODE_WORDS[mode],
+        // BAPI-1465 — say what the row describes. Only this row is scoped; an absent or
+        // unknown scope (an older server) reads as the repository default.
+        detail: EFFECTIVE_REVIEW_MODE_WORDS[mode] +
+            (block.effective_review_mode_scope === "run" ? " (this run)" : " (default for a new feature-branch run)"),
     };
 }
 function epicBranchCiDecisionSection(block) {
@@ -558,7 +565,7 @@ export function supervisorSection(readiness) {
         ].filter(Boolean).join(" and ");
         sections.push({
             id: "supervisor-configuration",
-            label: "Supervisor configuration",
+            label: READINESS_PREREQUISITE_BY_ID.get("server.supervisor-config").label,
             status: "degraded",
             detail: `project-default supervisor ${missing} absent`,
             remediation: "bootstrap writes the safe project-default posture.",
@@ -567,7 +574,7 @@ export function supervisorSection(readiness) {
     else {
         sections.push({
             id: "supervisor-configuration",
-            label: "Supervisor configuration",
+            label: READINESS_PREREQUISITE_BY_ID.get("server.supervisor-config").label,
             status: "ok",
             detail: `setup=${s.setup_source}, config=${s.config_source}`,
         });
@@ -582,7 +589,7 @@ export function supervisorSection(readiness) {
     const requiredChecks = presentRequiredChecks(s);
     sections.push({
         id: "supervisor-required-checks",
-        label: "Supervisor required CI checks",
+        label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-supervisor-required-checks").label,
         status: requiredChecks.satisfied ? "ok" : "degraded",
         detail: requiredChecks.detail,
         ...(requiredChecks.remediation === undefined
@@ -608,7 +615,7 @@ export function supervisorSection(readiness) {
             // warns: an unreadable review configuration is its own problem.
             sections.push({
                 id: "supervisor-review-alignment",
-                label: "Supervisor review-policy alignment",
+                label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-supervisor-review-alignment").label,
                 status: "ok",
                 detail: "not applicable: the effective review mode is 'repository_policy', which requires no review verdict",
             });
@@ -616,7 +623,7 @@ export function supervisorSection(readiness) {
         else if (alignment.status === "divergent" || alignment.status === "invalid") {
             sections.push({
                 id: "supervisor-review-alignment",
-                label: "Supervisor review-policy alignment",
+                label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-supervisor-review-alignment").label,
                 status: "degraded",
                 detail: alignment.explanation,
                 remediation: alignment.status === "invalid"
@@ -633,7 +640,7 @@ export function supervisorSection(readiness) {
             // facts, and collapsing them would imply a stored default that is absent.
             sections.push({
                 id: "supervisor-review-alignment",
-                label: "Supervisor review-policy alignment",
+                label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-supervisor-review-alignment").label,
                 status: "ok",
                 detail: alignment.explanation,
             });
@@ -648,7 +655,7 @@ export function githubCredentialsSection(readiness) {
     if (g.credentials_complete) {
         return {
             id: "github-credentials",
-            label: "GitHub App credentials",
+            label: READINESS_PREREQUISITE_BY_ID.get("server.github-credentials").label,
             status: "ok",
             detail: "owner, repository id, and installation id all resolved",
         };
@@ -660,7 +667,7 @@ export function githubCredentialsSection(readiness) {
     ].filter(Boolean).join(", ");
     return {
         id: "github-credentials",
-        label: "GitHub App credentials",
+        label: READINESS_PREREQUISITE_BY_ID.get("server.github-credentials").label,
         status: "degraded",
         detail: g.credentials_readable
             ? `incomplete: ${missing} unresolved`
@@ -673,7 +680,7 @@ export function githubActionsSection(readiness) {
     if (g.actions_write) {
         return {
             id: "github-actions-permission",
-            label: "GitHub App actions permission",
+            label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-github-actions-permission").label,
             status: "ok",
             detail: "actions: write",
         };
@@ -683,7 +690,7 @@ export function githubActionsSection(readiness) {
         // the first needs a retry, the second needs a permission grant.
         return {
             id: "github-actions-permission",
-            label: "GitHub App actions permission",
+            label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-github-actions-permission").label,
             status: "degraded",
             detail: "permission could not be checked",
             remediation: "re-run once credentials resolve; the workflow rerun lane fails open on 403 until this reads `write`.",
@@ -691,10 +698,10 @@ export function githubActionsSection(readiness) {
     }
     return {
         id: "github-actions-permission",
-        label: "GitHub App actions permission",
+        label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-github-actions-permission").label,
         status: "degraded",
         detail: `actions: ${g.actions_permission_level}`,
-        remediation: "grant the GitHub App `actions: write`; the conductor's workflow rerun lane fails open on 403 without it.",
+        remediation: "grant the GitHub App `actions: write`; without it, the workflow rerun lane fails open on 403.",
     };
 }
 /**
@@ -733,7 +740,7 @@ export function mergeExecutionSections(readiness) {
         return [
             {
                 id: "merge-execution-eligibility",
-                label: "Merge execution eligibility",
+                label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-merge-execution-eligibility").label,
                 status: "degraded",
                 detail: `could not verify: ${verdict.detail}`,
                 remediation: verdict.remediation ?? MERGE_EXECUTION_UNVERIFIABLE_REMEDIATION,
@@ -742,7 +749,7 @@ export function mergeExecutionSections(readiness) {
     }
     const decisive = {
         id: "merge-execution-eligibility",
-        label: "Merge execution eligibility",
+        label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-merge-execution-eligibility").label,
         status: verdict.status === "eligible" ? "ok" : "degraded",
         detail: verdict.status === "eligible"
             ? `eligible: ${verdict.detail}`
@@ -793,7 +800,7 @@ export function reconcilerSection(readiness) {
         // remediation at all — so a report could name a gap with no next step.
         return {
             id: "reconciler-liveness",
-            label: "Active-run progress",
+            label: READINESS_PREREQUISITE_BY_ID.get("server.reconciler-liveness").label,
             status: "degraded",
             detail: "liveness could not be read",
             remediation: "retry once the Bridge API is reachable; reconciler liveness is unknown here, " +
@@ -803,14 +810,14 @@ export function reconcilerSection(readiness) {
     if (!r.stale) {
         return {
             id: "reconciler-liveness",
-            label: "Active-run progress",
+            label: READINESS_PREREQUISITE_BY_ID.get("server.reconciler-liveness").label,
             status: "ok",
             detail: `last tick ${r.last_tick_age_seconds}s ago across ${r.active_run_count} active run(s)`,
         };
     }
     return {
         id: "reconciler-liveness",
-        label: "Active-run progress",
+        label: READINESS_PREREQUISITE_BY_ID.get("server.reconciler-liveness").label,
         status: "degraded",
         detail: r.last_tick_at === null
             ? "no reconciler tick recorded for this repository"
@@ -870,7 +877,7 @@ export function workflowSection(presence, reviewPolicySource, driftDetail) {
     if (presence === "present") {
         return {
             id: "claude-review-workflow",
-            label: "claude-review workflow",
+            label: READINESS_PREREQUISITE_BY_ID.get("server.review-workflow").label,
             status: "ok",
             // BAPI-941: when the lineage comparison ran but could not be completed,
             // that uncertainty rides on the SAME informational detail line rather than
@@ -893,7 +900,7 @@ export function workflowSection(presence, reviewPolicySource, driftDetail) {
     if (presence === "drifted" && reviewPolicySource !== "repository_policy") {
         return {
             id: "claude-review-workflow",
-            label: "claude-review workflow",
+            label: READINESS_PREREQUISITE_BY_ID.get("server.review-workflow").label,
             status: "degraded",
             detail: driftDetail ??
                 ".github/workflows/claude-review.yml differs from the repository default branch",
@@ -909,19 +916,19 @@ export function workflowSection(presence, reviewPolicySource, driftDetail) {
         reviewPolicySource === "repository_policy") {
         return {
             id: "claude-review-workflow",
-            label: "claude-review workflow",
+            label: READINESS_PREREQUISITE_BY_ID.get("server.review-workflow").label,
             status: "ok",
             detail: `not applicable for review policy '${reviewPolicySource}'`,
         };
     }
     return {
         id: "claude-review-workflow",
-        label: "claude-review workflow",
+        label: READINESS_PREREQUISITE_BY_ID.get("server.review-workflow").label,
         status: "degraded",
         detail: presence === "unreadable"
             ? ".github/workflows/claude-review.yml could not be read"
             : ".github/workflows/claude-review.yml absent",
-        remediation: "the selected review policy consumes the sticky verdict this workflow emits; install the template.",
+        remediation: `the selected review policy consumes the sticky verdict this workflow emits; install the template (see ${CONSUMER_GUIDE_POINTER}).`,
     };
 }
 /**
@@ -937,7 +944,7 @@ export function workflowSection(presence, reviewPolicySource, driftDetail) {
  * separate sections — a healthy unit here proves only that a file exists.
  */
 export function executorProvisioningSection(diagnostics) {
-    const base = { id: "executor-provisioning", label: "Executor provisioning" };
+    const base = { id: "executor-provisioning", label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-executor-provisioning").label };
     if (diagnostics === null) {
         return {
             ...base,
@@ -985,7 +992,7 @@ export function executorProvisioningSection(diagnostics) {
  * manager has no such unit" lead to different operator actions.
  */
 export function executorServiceStateSection(observations, unitsDiscovered, inspectorAvailable) {
-    const base = { id: "executor-service-state", label: "Executor service state" };
+    const base = { id: "executor-service-state", label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-executor-service-state").label };
     if (!unitsDiscovered) {
         return {
             ...base,
@@ -1030,7 +1037,7 @@ export function executorServiceStateSection(observations, unitsDiscovered, inspe
  * fresh install, or vice versa.
  */
 export function executorObservationSection(readiness) {
-    const base = { id: "executor-observation", label: "Executor server observation" };
+    const base = { id: "executor-observation", label: READINESS_PREREQUISITE_BY_ID.get("server.executor-readiness").label };
     if (readiness === null || !readiness.executor.liveness_readable) {
         return {
             ...base,
@@ -1096,7 +1103,7 @@ export function detectConductorContext(legacyConductor, profile) {
  * that Codex or Copilot configuration was inspected or changed.
  */
 export function conductorProfileTokenSection(profile, conductorContext) {
-    const base = { id: "epic-implementer-profile-token", label: "Epic Implementer MCP profile token" };
+    const base = { id: "epic-implementer-profile-token", label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-epic-implementer-profile-token").label };
     if (profile === null) {
         return {
             ...base,
@@ -1143,7 +1150,7 @@ export function conductorProfileTokenSection(profile, conductorContext) {
  * read for the file check and never copied into this section.
  */
 export function conductorHookTargetsSection(legacyConductor, conductorContext) {
-    const base = { id: "conductor-hook-targets", label: "Conductor hook targets" };
+    const base = { id: "conductor-hook-targets", label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-conductor-hook-targets").label };
     // Nullish, not `=== null`: an injected builder may resolve `undefined`, and a
     // doctor that throws on it would abort the run it exists to diagnose.
     if (legacyConductor === null || legacyConductor === undefined) {
@@ -1169,7 +1176,7 @@ export function conductorHookTargetsSection(legacyConductor, conductorContext) {
         return {
             ...base,
             status: "ok",
-            detail: "advisory — not a git worktree, so no managed conductor hooks apply",
+            detail: "advisory — not a git worktree, so no managed git hooks apply",
         };
     }
     // BAPI-1290: the shared per-hook `usable` verdict — a recognized command, an
@@ -1226,11 +1233,11 @@ export function conductorHookTargetsSection(legacyConductor, conductorContext) {
 export function gitHubActionsMergeObservabilitySections(legacyConductor) {
     const authBase = {
         id: "gh-actions-merge-auth",
-        label: "GitHub Actions merge: local observation prerequisites",
+        label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-gh-actions-merge-auth").label,
     };
     const observeBase = {
         id: "gh-actions-merge-observable",
-        label: "GitHub Actions merge: capability observability",
+        label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-gh-actions-merge-observable").label,
     };
     const inspection = legacyConductor?.github_actions_merge;
     if (inspection === undefined || inspection === null) {
@@ -1275,7 +1282,7 @@ export function gitHubActionsMergeObservabilitySections(legacyConductor) {
 export function conductorLedgerLoadabilitySection(legacyConductor) {
     const base = {
         id: "epic-implementer-ledger-loadability",
-        label: "Epic Implementer ledger loadability",
+        label: READINESS_PREREQUISITE_BY_ID.get("conductor.install-section-epic-implementer-ledger-loadability").label,
     };
     if (legacyConductor === null || legacyConductor === undefined) {
         return {
@@ -1355,3 +1362,286 @@ export async function inspectWorkflowLocalPresence(readWorkflowFile) {
         return code === "ENOENT" ? "absent" : "unreadable";
     }
 }
+/**
+ * BAPI-1496 — project the advisory worker-database doctor section into launch
+ * readiness rows.
+ *
+ * Only non-healthy rows are projected: each becomes a `warn` with
+ * `blocking: false`, its existing `worker-db-*` id, fixed label and fixed
+ * detail, and the BAPI-1479 runbook as its remedy. A healthy row adds nothing,
+ * so a healthy inspection leaves a launch's rows exactly as they were. PURE:
+ * it reads an already-collected section and never probes, and it can never
+ * produce a `fail` or a blocking row — the doctor section's contract is that it
+ * never affects an exit code, and launch readiness keeps that contract.
+ */
+export function workerDatabaseReadinessChecks(section) {
+    return section.rows
+        .filter((row) => row.state !== "healthy")
+        .map((row) => ({
+        id: row.id,
+        source: "conductor",
+        label: row.label,
+        status: "warn",
+        blocking: false,
+        // Some doctor details already lead with their state ("unknown — …").
+        detail: row.detail.startsWith(`${row.state} — `) ? row.detail : `${row.state} — ${row.detail}`,
+        remediation: `${row.owner}: see ${WORKER_DATABASE_DOCTOR_RUNBOOK_SECTION}`,
+    }));
+}
+// ---------------------------------------------------------------------------
+// BAPI-1506 — launch needs: human-only needs asked about before a run exists
+// ---------------------------------------------------------------------------
+/**
+ * The closed set of human-only needs a create preview checks. Four are asked
+ * about before `Create this run? (y/N)`; `epic_branch_behind_base` is shown as
+ * information only, because integration's `sync_base` reconciles it.
+ */
+export const LAUNCH_NEEDS = [
+    "worker_db_role",
+    "self_hosted_runner",
+    "host_power",
+    "usage_reset_after_run",
+    "epic_branch_behind_base",
+];
+/** `present` = the need exists; `absent` = no need; `unverifiable` = could not tell. */
+export const LAUNCH_NEED_STATES = ["present", "absent", "unverifiable", "not_applicable"];
+/** Row ids, one per need. `worker-db-role` and `host-sleep` are the existing rows. */
+export const LAUNCH_NEED_ROW_IDS = Object.freeze({
+    worker_db_role: "worker-db-role",
+    self_hosted_runner: "self-hosted-runner",
+    host_power: "host-sleep",
+    usage_reset_after_run: "usage-reset-after-run",
+    epic_branch_behind_base: "epic-branch-behind-base",
+});
+const LAUNCH_NEED_LABELS = Object.freeze({
+    worker_db_role: "Worker DB role",
+    self_hosted_runner: "Self-hosted runner for required checks",
+    host_power: "Host sleep",
+    usage_reset_after_run: "Usage reset after the run",
+    epic_branch_behind_base: "Epic branch behind base",
+});
+/** Each need's one-line remedy: the exit for its launch question. */
+export const LAUNCH_NEED_REMEDIES = Object.freeze({
+    worker_db_role: `${WORKER_DATABASE_DOCTOR_OWNER}: see ${WORKER_DATABASE_DOCTOR_RUNBOOK_SECTION}`,
+    self_hosted_runner: "Start the self-hosted runner for the required checks (the machine that runs your CI jobs), " +
+        "then run /drive-epic-run again.",
+    host_power: PLANE_SLEEP_REMEDY,
+    usage_reset_after_run: "Wait for the usage window to reset, or launch fewer tickets, then run /drive-epic-run again.",
+    epic_branch_behind_base: "Integration's `sync_base` merges the base into the epic branch; no action is needed.",
+});
+/** The estimate of one ticket's share of a run, for the usage row's likely end. */
+export const LAUNCH_USAGE_PER_TICKET_MINUTES = 120;
+const LAUNCH_NEED_STATUS = Object.freeze({
+    present: "warn",
+    absent: "pass",
+    unverifiable: "warn",
+    not_applicable: "skip",
+});
+/**
+ * Build one launch-need row. The status follows the state (`present` and
+ * `unverifiable` warn, `absent` passes, `not_applicable` skips), `blocking` is
+ * always `false`, and every `present` and `unverifiable` row carries the need's
+ * remedy. `asked` is `true` for the four human-only needs and `false` for the
+ * information-only branch row. `detail` must be fixed prose plus bounded counts
+ * or normalized times — never subprocess output, a path, a URL or a credential.
+ */
+export function buildLaunchNeedRow(need, state, detail, overrides = {}) {
+    const needsRemedy = state === "present" || state === "unverifiable";
+    return {
+        id: overrides.id ?? LAUNCH_NEED_ROW_IDS[need],
+        label: overrides.label ?? LAUNCH_NEED_LABELS[need],
+        status: LAUNCH_NEED_STATUS[state],
+        blocking: false,
+        ...(detail !== undefined && detail !== "" ? { detail } : {}),
+        ...(needsRemedy ? { remedy: LAUNCH_NEED_REMEDIES[need] } : {}),
+        launch_need: { need, state, asked: need !== "epic_branch_behind_base" },
+    };
+}
+// --- Worker DB role (local only; reuses BAPI-1496's doctor row) --------------
+/**
+ * The `worker-db-role` launch-need state from an already-collected doctor
+ * section. `null` section = the inspection did not run (no inspector);
+ * a section without the role row = the inspection failed (BAPI-1496 then keeps
+ * only `worker-db-unverifiable`). `healthy` → absent; `unsafe` (including
+ * `role_missing`) → present; `unknown` → unverifiable.
+ */
+export function workerDbRoleLaunchState(section) {
+    const row = section?.rows.find((entry) => entry.id === "worker-db-role");
+    if (row === undefined)
+        return "unverifiable";
+    if (row.state === "healthy")
+        return "absent";
+    if (row.state === "unsafe")
+        return "present";
+    return "unverifiable";
+}
+/**
+ * The worker-role launch-need row. `local: false` (not this machine's plane) is
+ * `not_applicable` and never reads the section. Otherwise the doctor's own role
+ * detail is kept (fixed prose), so this row describes the same fact the merged
+ * `worker-db-role` warning does.
+ */
+export function buildWorkerDbRoleLaunchRow(section, local) {
+    if (!local) {
+        return buildLaunchNeedRow("worker_db_role", "not_applicable", "not applicable — the target is not this machine's local plane");
+    }
+    const state = workerDbRoleLaunchState(section);
+    const row = section?.rows.find((entry) => entry.id === "worker-db-role");
+    const detail = row !== undefined
+        ? row.detail.startsWith(`${row.state} — `) ? row.detail : `${row.state} — ${row.detail}`
+        : "unverifiable — the worker-database inspection did not complete";
+    return buildLaunchNeedRow("worker_db_role", state, detail, row !== undefined ? { label: row.label } : {});
+}
+const RUNNER_UNVERIFIABLE_DETAIL = Object.freeze({
+    no_gate_profile: "the required checks could not be read from readiness",
+    no_provider_repository: "the provider repository is unknown",
+    workflows_unreadable: "the workflow files could not be read",
+    check_not_mapped: "a required check does not map to exactly one workflow job",
+    runs_on_unreadable: "a required job's runs-on is not a plain label or a one-line label list",
+    runner_list_unavailable: "the repository's runners could not be listed (gh missing, no admin scope, or a timeout)",
+    runner_list_malformed: "the runner list was incomplete or malformed",
+    probe_failed: "the runner check did not complete",
+});
+export function buildSelfHostedRunnerLaunchRow(fact) {
+    switch (fact.state) {
+        case "present":
+            return buildLaunchNeedRow("self_hosted_runner", "present", `present — ${fact.unsatisfied_label_sets} of ${fact.label_sets} self-hosted label set(s) behind the ` +
+                "required checks have no online runner");
+        case "absent":
+            return buildLaunchNeedRow("self_hosted_runner", "absent", `absent — every self-hosted label set behind the required checks (${fact.label_sets}) has an online runner`);
+        case "not_applicable":
+            return buildLaunchNeedRow("self_hosted_runner", "not_applicable", "not applicable — no required check runs on a self-hosted runner");
+        default:
+            return buildLaunchNeedRow("self_hosted_runner", "unverifiable", `unverifiable — ${RUNNER_UNVERIFIABLE_DETAIL[fact.reason] ?? RUNNER_UNVERIFIABLE_DETAIL.probe_failed}`);
+    }
+}
+const HOST_POWER_UNVERIFIABLE_DETAIL = Object.freeze({
+    remote_executor: "the run's executor will run on another host, so its power and sleep settings cannot be read here",
+    unverified: "could not verify the host's power and sleep settings",
+    probe_failed: "the host sleep check did not complete",
+});
+const HOST_POWER_ADVISORIES = new Set([
+    PLANE_SLEEP_BATTERY_ADVISORY,
+    PLANE_SLEEP_LID_ADVISORY,
+]);
+/**
+ * Project the existing `inspectHostSleep` report into a launch-need fact. Only
+ * the two fixed advisory sentences are ever carried forward; a pass with
+ * either advisory is `present`, a pass without one is `absent`, the macOS-only
+ * skip is `not_applicable`, and anything else is `unverifiable`.
+ */
+export function hostPowerFactFromReport(report) {
+    const outcome = report?.outcomes[0];
+    if (outcome === undefined)
+        return { state: "unverifiable", reason: "probe_failed" };
+    if (outcome.status === "skip")
+        return { state: "not_applicable" };
+    const detail = outcome.detail ?? "";
+    const advisories = [PLANE_SLEEP_BATTERY_ADVISORY, PLANE_SLEEP_LID_ADVISORY].filter((advisory) => detail.includes(advisory));
+    if (outcome.status === "pass") {
+        return advisories.length > 0 ? { state: "present", advisories } : { state: "absent" };
+    }
+    return { state: "unverifiable", reason: "unverified" };
+}
+export function buildHostPowerLaunchRow(fact) {
+    switch (fact.state) {
+        case "present": {
+            const advisories = fact.advisories.filter((advisory) => HOST_POWER_ADVISORIES.has(advisory));
+            return buildLaunchNeedRow("host_power", "present", `present — ${advisories.join("; ")}. Does not block setup.`);
+        }
+        case "absent":
+            return buildLaunchNeedRow("host_power", "absent", "absent — no host sleep risk found; does not block setup");
+        case "not_applicable":
+            return buildLaunchNeedRow("host_power", "not_applicable", "not applicable — not a macOS host");
+        default:
+            return buildLaunchNeedRow("host_power", "unverifiable", `unverifiable — ${HOST_POWER_UNVERIFIABLE_DETAIL[fact.reason] ?? HOST_POWER_UNVERIFIABLE_DETAIL.probe_failed}`);
+    }
+}
+// --- Usage resets after the run's likely end ---------------------------------
+/** The warning-state rule the producer applies (`executor/observation.ts`). */
+const LAUNCH_USAGE_WARNING_PERCENT = 75;
+/** Fixed wording for "no stored advisory": information, not a fault. */
+export const LAUNCH_USAGE_NO_ADVISORY_DETAIL = "No usage warning is stored for this repository. Usage was below the warning threshold, or retention removed the record.";
+function isoSeconds(ms) {
+    return new Date(ms).toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+/**
+ * The usage launch-need row.
+ *
+ * The likely end is an ESTIMATE: `now + child_count × LAUNCH_USAGE_PER_TICKET_MINUTES`.
+ * `present` = a warning-state advisory (utilization ≥ 75% or status not exactly
+ * `allowed`) whose reset falls after the likely end. `absent` = an advisory not
+ * in its warning state, or one that resets at or before the likely end.
+ * Everything that cannot be decided — no reset, an unparseable reset, a
+ * malformed or unavailable read, no child count, or no stored advisory at all —
+ * is `unverifiable` and only warns.
+ */
+export function buildUsageResetAfterRunLaunchRow(input) {
+    const { advisory, childCount, nowMs } = input;
+    const unverifiable = (why) => buildLaunchNeedRow("usage_reset_after_run", "unverifiable", `unverifiable — ${why}`);
+    if (advisory.state === "unavailable")
+        return unverifiable("the stored usage advisory could not be read");
+    if (advisory.state === "absent")
+        return unverifiable("the stored usage advisory is malformed");
+    if (advisory.state === "below_warning_threshold") {
+        return buildLaunchNeedRow("usage_reset_after_run", "unverifiable", LAUNCH_USAGE_NO_ADVISORY_DETAIL);
+    }
+    const percent = advisory.utilization_percent;
+    const warning = (typeof percent === "number" && percent >= LAUNCH_USAGE_WARNING_PERCENT) || advisory.status !== "allowed";
+    const observed = [];
+    if (advisory.observed_at !== null) {
+        const observedMs = Date.parse(advisory.observed_at);
+        if (Number.isFinite(observedMs))
+            observed.push(`observed ${isoSeconds(observedMs)}`);
+    }
+    if (advisory.stale === true)
+        observed.push("stale");
+    const observedNote = observed.length > 0 ? ` (${observed.join(", ")})` : "";
+    const percentText = typeof percent === "number" ? `${percent}%` : "unknown";
+    if (!warning) {
+        return buildLaunchNeedRow("usage_reset_after_run", "absent", `absent — the last observed usage (${percentText}) is not in its warning state${observedNote}`);
+    }
+    if (childCount === null ||
+        typeof childCount !== "number" ||
+        !Number.isSafeInteger(childCount) ||
+        childCount <= 0 ||
+        !Number.isFinite(nowMs)) {
+        return unverifiable(`the run's ticket count is unknown, so its likely end cannot be estimated${observedNote}`);
+    }
+    const likelyEndMs = nowMs + childCount * LAUNCH_USAGE_PER_TICKET_MINUTES * 60_000;
+    if (!Number.isFinite(likelyEndMs) || !Number.isFinite(new Date(likelyEndMs).getTime())) {
+        return unverifiable("the run's likely end cannot be estimated");
+    }
+    const estimate = `estimated likely end ${isoSeconds(likelyEndMs)} ` +
+        `(now + ${childCount} × ${LAUNCH_USAGE_PER_TICKET_MINUTES} minutes)`;
+    const resetMs = advisory.resets_at !== null ? Date.parse(advisory.resets_at) : Number.NaN;
+    if (!Number.isFinite(resetMs)) {
+        return unverifiable(`the last observed usage (${percentText}) is in its warning state but has no usable reset time; ${estimate}${observedNote}`);
+    }
+    if (resetMs > likelyEndMs) {
+        return buildLaunchNeedRow("usage_reset_after_run", "present", `present — the last observed usage (${percentText}) is in its warning state and resets ${isoSeconds(resetMs)}, ` +
+            `after the ${estimate}${observedNote}`);
+    }
+    return buildLaunchNeedRow("usage_reset_after_run", "absent", `absent — the last observed usage (${percentText}) resets ${isoSeconds(resetMs)}, at or before the ${estimate}${observedNote}`);
+}
+const BRANCH_NOT_APPLICABLE_DETAIL = Object.freeze({
+    no_epic_branch: "not applicable — this run targets the base branch directly",
+    branch_not_on_origin: "not applicable — the epic branch does not exist on origin yet; it will be cut fresh",
+});
+const BRANCH_UNVERIFIABLE_DETAIL = Object.freeze({
+    no_base_branch: "the base branch the epic branch is cut from is unknown",
+    invalid_branch_name: "a branch name failed validation",
+    git_failed: "git could not compare the epic branch with its base",
+});
+export function buildEpicBranchBehindBaseLaunchRow(fact) {
+    switch (fact.state) {
+        case "present":
+            return buildLaunchNeedRow("epic_branch_behind_base", "present", `present — the epic branch is ${fact.behind} commit(s) behind its base (information only)`);
+        case "absent":
+            return buildLaunchNeedRow("epic_branch_behind_base", "absent", "absent — the epic branch is not behind its base");
+        case "not_applicable":
+            return buildLaunchNeedRow("epic_branch_behind_base", "not_applicable", BRANCH_NOT_APPLICABLE_DETAIL[fact.reason] ?? BRANCH_NOT_APPLICABLE_DETAIL.no_epic_branch);
+        default:
+            return buildLaunchNeedRow("epic_branch_behind_base", "unverifiable", `unverifiable — ${BRANCH_UNVERIFIABLE_DETAIL[fact.reason] ?? BRANCH_UNVERIFIABLE_DETAIL.git_failed}`);
+    }
+}