@m-kopa/launchpad-cli 0.49.0 → 0.50.0

package/CHANGELOG.md

@@ -8,6 +8,25 @@ pre-1.0 minor bumps may carry breaking changes per ADR 0005.
 
 ## Unreleased
 
+Bot-side provisioning recovery safety spine: `launchpad recover` now classifies non-serving failed apps by their recorded provisioning stage.
+Mutating dispatch is guarded by the original submission's single-flight lease, an original-Workflow terminal-state check, owner/co-owner/break-glass authorization for destructive or access-granting recovery, and the runtime `ROUTING_KV.__recovery_disabled` kill-switch.
+Reconcile-only recovery remains available to editors.
+No CLI version bump is required for this bot-side change.
+
+Bot-side pre-Terraform recovery: an owner-run `launchpad recover` now abandons a wedged pre-TF workflow, archive-renames its app repo through the existing destroy finalizer, releases the destroyed registry record, and names `launchpad create` with the original manifest as the single next step.
+`launchpad destroy` applies the same no-TF teardown when the persisted stage proves the wedge happened before Terraform, while post-TF failures continue through the existing Terraform destroy workflow so all credential and edge surfaces are revoked.
+No CLI version bump is required for this bot-side change.
+
+Bot-side post-Terraform recovery: `launchpad recover` now triggers a fresh Cloudflare Pages production deployment when infrastructure exists but content is not serving, then returns an async handoff to `launchpad status` and a final `launchpad recover` reconciliation once the deployment serves.
+The driver reuses the established Pages deployment trigger, stays behind the recovery kill-switch, single-flight lease, and original-Workflow terminal check, and remains available to owner, co-owner, editor, and break-glass identities like `deploy` and `redeploy`.
+No CLI version bump is required for this bot-side change.
+
+Bot-side Terraform-PR recovery: owner, co-owner, and break-glass callers can now use `launchpad recover` to regenerate a wedged provisioning PR from the managed app repo's current `main` manifest.
+The driver reuses the exact-SHA manifest reconcile engine, including fresh group resolution, ADR 0035 proof and attestation, shape validation, and gated auto-merge.
+It then comments and closes only the stale `portal-bot/add-*` PR tied to the original submission, by exact PR number, and refuses retirement while an apply run for that PR head is active.
+Failed `tf_pr_merged` resumes no longer skip forward to `tf_applied`; they direct the owner to the fresh-PR recovery path.
+No CLI version bump is required for this bot-side change.
+
 Platform-side delivery hardening (PS-2419): portal-bot production releases now deploy a verified, content-addressed CI artifact without rebuilding in the deploy job.
 The authenticated `/version` endpoint and standing drift detector expose and monitor the served source and artifact identity.
 No CLI version bump is required for this platform-side change.
@@ -22,6 +41,13 @@ No CLI version bump is required for this bot-side fix.
 Bot-side reliability fix (PS-2418): all documented manifest status routes are now reachable, and read-only GitHub API calls retry bounded transient failures before failing closed.
 No CLI version bump is required for this bot-side fix.
 
+## 0.50.0 - 2026-07-17
+
+**Async recovery initiation rendering.**
+
+- `launchpad recover` now treats HTTP 202 as a successful async initiation, prints the server-provided watch and finalize message, and includes the deployment or Terraform PR identifiers returned by the bot.
+- JSON output preserves the complete 202 response and exits successfully, so initiated post-Terraform and Terraform-PR recovery no longer appears to fail in scripts.
+
 ## 0.49.0 - 2026-07-15
 
 **Exact-commit access reconcile and group-reference parity.**

package/dist/cli.js

@@ -19,7 +19,7 @@ var __toESM = (mod, isNodeMode, target) => {
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/version.ts
-var CLI_VERSION = "0.49.0";
+var CLI_VERSION = "0.50.0";
 
 // src/config.ts
 import * as os from "node:os";
@@ -11154,19 +11154,23 @@ async function runRecover(args, io) {
     });
     const body = await res.json().catch(() => null);
     if (parsed.json) {
-      io.out(JSON.stringify({ httpStatus: res.status, ...body ?? {} }, null, 2));
-      return res.status === 200 ? 0 : 1;
+      io.out(JSON.stringify({ httpStatus: res.status, ...isRecord3(body) ? body : {} }, null, 2));
+      return res.status === 200 || res.status === 202 ? 0 : 1;
     }
-    if (res.status === 200 && body !== null && "outcome" in body) {
+    if (res.status === 200 && hasRecoverOutcome(body)) {
       renderSuccess2(body, io);
       return 0;
     }
+    if (res.status === 202 && isRecoverInitiatedBody(body)) {
+      renderInitiated(body, io);
+      return 0;
+    }
     if (res.status === 503) {
-      const msg = body !== null && "message" in body && typeof body.message === "string" ? body.message : "live state unavailable — nothing was changed; retry shortly.";
+      const msg = isRecord3(body) && typeof body.message === "string" ? body.message : "live state unavailable — nothing was changed; retry shortly.";
       io.err(`launchpad recover: ${msg}`);
       return 1;
     }
-    if (res.status === 409 && body !== null && "error" in body) {
+    if (res.status === 409 && hasRecoverRefusal(body)) {
       renderRefusal(parsed.slug, body, io);
       return 1;
     }
@@ -11176,6 +11180,28 @@ async function runRecover(args, io) {
     return mapError(e, parsed.slug, io);
   }
 }
+function isRecord3(value) {
+  return typeof value === "object" && value !== null;
+}
+function hasRecoverOutcome(value) {
+  return isRecord3(value) && "outcome" in value;
+}
+function isRecoverInitiatedBody(value) {
+  if (!isRecord3(value))
+    return false;
+  return [
+    typeof value.slug === "string",
+    typeof value.outcome === "string",
+    typeof value.message === "string",
+    value.deploymentId === undefined || typeof value.deploymentId === "string",
+    value.freshPrNumber === undefined || typeof value.freshPrNumber === "number",
+    value.stalePrNumber === undefined || typeof value.stalePrNumber === "number",
+    value.recoveryClass === undefined || value.recoveryClass === "post_tf" || value.recoveryClass === "tf_pr"
+  ].every(Boolean);
+}
+function hasRecoverRefusal(value) {
+  return isRecord3(value) && "error" in value;
+}
 function renderSuccess2(body, io) {
   if (body.outcome === "noop_already_healthy") {
     io.out(`${body.slug}: already healthy — nothing to recover.`);
@@ -11199,6 +11225,19 @@ function renderSuccess2(body, io) {
   io.out("");
   io.out(`Run \`launchpad status ${body.slug}\` — it now reports the live deployment truth.`);
 }
+function renderInitiated(body, io) {
+  io.out(`${body.slug}: recovery initiated (${body.outcome}).`);
+  if (body.deploymentId !== undefined) {
+    io.out(`  deployment: ${body.deploymentId}`);
+  }
+  if (body.freshPrNumber !== undefined) {
+    io.out(`  fresh PR: #${body.freshPrNumber}`);
+  }
+  if (body.stalePrNumber !== undefined) {
+    io.out(`  stale PR: #${body.stalePrNumber}`);
+  }
+  io.out(`  ${body.message}`);
+}
 function renderRefusal(slug, body, io) {
   io.err(`launchpad recover: refused — "${slug}" was NOT repaired.`);
   if (typeof body.message === "string") {

package/dist/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAsDA,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AAGjE,eAAO,MAAM,eAAe,EAAE,OAI7B,CAAC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AAGjE,eAAO,MAAM,eAAe,EAAE,OAI7B,CAAC"}

package/dist/commands/recover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../src/commands/recover.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AAEjE,eAAO,MAAM,cAAc,EAAE,OAI5B,CAAC;AAIF,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAiLD;;kEAEkE;AAClE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,GAAE,MAAsB,EAC3B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC5B,WAAW,GAAG,MAAM,CAgDtB"}
+{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../src/commands/recover.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AAEjE,eAAO,MAAM,cAAc,EAAE,OAI5B,CAAC;AAIF,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AA2OD;;kEAEkE;AAClE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,GAAE,MAAsB,EAC3B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC5B,WAAW,GAAG,MAAM,CAgDtB"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.49.0";
+export declare const CLI_VERSION = "0.50.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m-kopa/launchpad-cli",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "description": "Launchpad CLI — clone / deploy / review / merge against Launchpad-managed apps. Talks to the portal-bot endpoints (SCOPE-M-760 / T4).",
   "type": "module",
   "bin": {

package/skills/launchpad-content-pr/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-content-pr
 description: Push a content change to a Launchpad app via `launchpad deploy` and verify it shipped via `launchpad status`. Covers the post-first-deploy iteration loop (edit → deploy → verify) — subsequent deploys commit directly to the app repo's main and the Pages build runs asynchronously, so verification is its own step. Use when someone says "push a content change", "ship an update", "/launchpad-content-pr", "verify my deploy", or after `/launchpad-deploy` reports `done` and they want to follow up with an edit.
-version: 0.49.0
+version: 0.50.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-deploy/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-deploy
 description: Walk a Launchpad user through deploying an app from their local working directory (Model A — `launchpad init` + `launchpad deploy`). Wraps the CLI verbs end-to-end: detects the app shape, scaffolds `launchpad.yaml`, resolves the allowed Entra group via `launchpad groups`, bundles the CWD via `launchpad deploy`, and watches the rollout via `launchpad status`. Use when someone says "deploy a new app", "ship my app to Launchpad", "/launchpad-deploy", "I have an app locally — get it on Launchpad", or any variant. Resume/abandon for legacy in-flight provisioning is at the bottom.
-version: 0.49.0
+version: 0.50.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-deploy-status/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-deploy-status
 description: Show the current provisioning stage + failure reason for a Launchpad app via `launchpad status` (Model A drift + deployment_verified) and `launchpad apps` (lifecycle bucket), or watch provisioning live with `launchpad watch`. Renders the M-892 stage trace for in-flight provisioning, and is the canonical home for `launchpad recover` (repair a terminal-failed app record that is actually live). Use when someone says "what's the status of demo-X", "/launchpad-deploy-status", "is my deploy stuck", "watch my deploy go live", "watch provisioning", "my app says failed but it's serving", or after `/launchpad-deploy` reports a non-`done` terminal stage.
-version: 0.49.0
+version: 0.50.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-destroy/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-destroy
 description: Tear down a Launchpad app end-to-end via `launchpad destroy` — Cloudflare Pages project, edge-auth wiring (gateway KV/audience entries, or the Access app for `auth: access` apps), custom hostname, platform-repo TF, and the app repo (archive-renamed). Owner-only verb with a two-step destructive confirmation. Use when someone says "destroy this app", "/launchpad-destroy", "tear down `<slug>`", "delete the app", or asks to clean up a smoke-test / orphan / retired app.
-version: 0.49.0
+version: 0.50.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-identity/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-identity
 description: Teach an app author how to use the signed-in user's identity inside a Launchpad app — read the gateway-forwarded X-Launchpad-User-Assertion in a Pages Function, VERIFY it with @m-kopa/platform-auth (fail-closed), and show who's logged in (sub/email/name). Use when someone says "who is logged in", "show the current user", "get the user's email in my app", "auth in my launchpad app", "read the user identity", "/launchpad-identity", or is wiring up an /api/me for a gateway-fronted app.
-version: 0.49.0
+version: 0.50.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-onboard/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-onboard
 description: One-time setup for the Launchpad CLI + Claude Code skill bundle. Verifies the `launchpad` CLI is installed and current, runs `launchpad whoami` to confirm the session is fresh, and checks the bundled skills are installed and in lock-step with the CLI. Idempotent — safe to re-run any time. Use when someone says "set me up for Launchpad", "I just got a new machine and want to use Launchpad", "/launchpad-onboard", or any of the other launchpad-* skills fails on a prereq check.
-version: 0.49.0
+version: 0.50.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-report/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-report
 description: File a bug report or feature request to the Launchpad team's tracker from the CLI. Use when someone reports something broken, hits an error in a launchpad command, or wishes a feature existed — e.g. "this is broken", "report a bug", "can you file that", "I wish launchpad could…", "/launchpad-bug", "/launchpad-feature". Always confirm and show exactly what you'll send before filing; never file silently.
-version: 0.49.0
+version: 0.50.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-status/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-status
 description: Show whether a Launchpad app's local launchpad.yaml matches what's deployed, and read the deployed manifest. Wraps `launchpad pull` (fetch deployed YAML) and `launchpad status` (drift report). Use when someone says "is my app in sync", "what's deployed", "show drift", "/launchpad-status", "/launchpad-pull", or after `launchpad deploy` to verify the change landed.
-version: 0.49.0
+version: 0.50.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->