@m-kopa/launchpad-cli 0.32.2 → 0.34.0

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). 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", "my app says failed but it's serving", or after `/launchpad-deploy` reports a non-`done` terminal stage.
-version: 0.32.2
+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.34.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
@@ -56,6 +56,7 @@ inference source resolves.
 
 | Question | Verb |
 |---|---|
+| Watch a first deploy provision to live in real time | `launchpad watch <slug>` — see § Watch below |
 | Is my local manifest in sync with what's deployed? | `launchpad status <slug>` |
 | What lifecycle bucket is the app in? | `launchpad apps` |
 | What was actually deployed? | `launchpad pull <slug>` |
@@ -63,8 +64,34 @@ inference source resolves.
 | What broke the most recent deploy? | `launchpad status <slug> --json` + the bot's PR check trail |
 | It says `failed` but the app is live in a browser | `launchpad recover <slug>` — see § Recover below |
 
-The Model A default is `launchpad status <slug>`. The other verbs
-are specialisations.
+The Model A default is `launchpad status <slug>` (a one-shot read).
+For an in-flight first deploy, `launchpad watch <slug>` is the live
+view. The other verbs are specialisations.
+
+## Watch — live provisioning (`launchpad watch`)
+
+For a first deploy still provisioning, `launchpad watch <slug>` (alias:
+`launchpad status <slug> --watch`) renders the pipeline live and updates
+in place until the app is **live** or **failed** — no manual re-running:
+
+```bash
+launchpad watch <slug>
+```
+
+- The 15 workflow stages are grouped into six phases (Repo · Build ·
+  Infra · Certificate · Access · Verify) with a spinner on the active
+  phase and a `stage N/15` counter. Slug inference matches
+  `launchpad status` (manifest slug, then the `launchpad-app-<slug>/`
+  dirname).
+- On **live** it settles to a final frame with the app URL; on
+  **failed** it shows the failing stage, the reason, and the exact
+  recovery command (`launchpad deploy --resume <slug>`, or
+  `launchpad recover <slug>` for a terminal-failed-but-live record —
+  see § Recover). Exit `0` live, `1` failed, `130` on `Ctrl-C`.
+- `Ctrl-C` stops **watching** only — it never affects provisioning.
+- It adapts to the terminal (full glyphs → ASCII → plain when piped/CI),
+  so it is safe to run anywhere. It is **read-only** — it polls the same
+  lifecycle `launchpad status` reads, and makes no change.
 
 ## Standard (Model A) status
 
@@ -77,6 +104,8 @@ the canonical reference). Lifecycle-shaped states:
 
 - **`provisioning`** — first deploy still in flight. The live
   workflow stage is shown inline (`stage: …`); see § Stage taxonomy.
+  To watch it advance to its terminal state live, use
+  `launchpad watch <slug>` (§ Watch).
 - **`provisioning_failed`** — provisioning failed; the failing stage
   and reason are shown inline. If the app is actually live, see
   § Recover.

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.32.2
+version: 0.34.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.32.2
+version: 0.34.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.32.2
+version: 0.34.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.32.2
+version: 0.34.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->