@m-kopa/launchpad-cli 0.32.1 → 0.33.0

package/dist/commands/status.d.ts

@@ -1,3 +1,4 @@
+import { type CliConfig } from "../config.js";
 import { type DeploymentStatusView, type StandingExceptionView } from "../deploy/deployment-status.js";
 import { type Manifest } from "@m-kopa/launchpad-engine";
 import type { Command } from "../dispatcher.js";
@@ -7,6 +8,24 @@ interface StatusArgs {
     readonly file: string;
     readonly json: boolean;
     readonly strict: boolean;
+    /** `--watch`: delegate to the live `launchpad watch` renderer (sp-wtch7q). */
+    readonly watch: boolean;
+}
+/** The bot's `/apps/<slug>/lifecycle` response (sp-st5hw9) — mirrors the
+ *  bot-side `LifecycleResponse`. Lets status show provisioning progress + a
+ *  clear failed state instead of the misleading "no deployed manifest yet". */
+interface LifecycleView {
+    readonly slug: string;
+    readonly state: "provisioning" | "live" | "failed" | "destroying" | "destroyed" | "destroy_failed";
+    readonly stage?: string;
+    readonly submissionId?: string;
+    readonly failedAt?: {
+        readonly stage: string;
+        readonly message: string;
+        readonly retryable: boolean;
+    };
+    readonly liveUrl?: string;
+    readonly lifecycleReason?: string;
 }
 /** What status reports, in machine-readable form for downstream
  *  consumers (M-1187 destroy, M-1189 update-skill). The lifecycle states
@@ -56,6 +75,11 @@ export interface StatusJsonOutput {
      *  Absent when the bot pre-dates the endpoint. */
     readonly standingExceptions?: readonly StandingExceptionView[];
 }
+/** Fetch the app's provisioning lifecycle (sp-st5hw9). Returns null when the
+ *  bot doesn't recognise the slug OR predates the endpoint — BOTH surface as a
+ *  404, so the caller degrades to the manifest-diff path (which raises a real
+ *  not-found itself for a truly-unknown slug). Auth / forbidden propagate. */
+export declare function fetchLifecycle(cfg: CliConfig, slug: string): Promise<LifecycleView | null>;
 /**
  * Compute drift over the v1 closed field set (AC5).
  *

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AA6CA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AASxC,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AAEjE,eAAO,MAAM,aAAa,EAAE,OAI3B,CAAC;AAEF,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAuBD;;;uEAGuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EACV,cAAc,GACd,qBAAqB,GACrB,iBAAiB;IACnB;;wDAEoD;OAClD,wBAAwB,GACxB,SAAS,GACT,OAAO;IACT;;oEAEgE;OAC9D,oBAAoB,GACpB,sBAAsB,GACtB,YAAY,GACZ,WAAW,GACX,gBAAgB,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;sEAGkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;QACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC5B,CAAC,CAAC;IACH;;;wCAGoC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClD;;sDAEkD;IAClD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAChE;AAuRD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,GACjB,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CA2DpE;AAuRD;0BAC0B;AAC1B,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,GAAE,MAAsB,EAC3B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC5B,UAAU,GAAG,MAAM,CAqErB"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}

package/dist/commands/watch.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from "../dispatcher.js";
+/** Resolve the slug from args or the cwd, or return an error string. */
+export declare function resolveWatchSlug(args: readonly string[], cwd: string, warn: (line: string) => void): {
+    slug: string;
+} | {
+    error: string;
+};
+export declare const watchCommand: Command;
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAmB,MAAM,kBAAkB,CAAC;AAWjE,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA2BtC;AAYD,eAAO,MAAM,YAAY,EAAE,OAI1B,CAAC"}

package/dist/dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAmDA,MAAM,WAAW,KAAK;IACpB,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAiCtC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,EAAE,KAAK,EACT,QAAQ,GAAE,SAAS,OAAO,EAAa,GACtC,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAyBvE"}
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAoDA,MAAM,WAAW,KAAK;IACpB,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAkCtC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,EAAE,KAAK,EACT,QAAQ,GAAE,SAAS,OAAO,EAAa,GACtC,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAyBvE"}

package/dist/version.d.ts

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

package/dist/watch/capabilities.d.ts

@@ -0,0 +1,23 @@
+export type RenderTier = "inline" | "ascii" | "append" | "plain";
+export interface TerminalCaps {
+    readonly isTTY: boolean;
+    /** Cursor-control / VT escape sequences are safe to emit. */
+    readonly ansi: boolean;
+    /** Unicode box/braille glyphs render correctly. */
+    readonly unicode: boolean;
+}
+export interface ProbeEnv {
+    readonly platform: NodeJS.Platform;
+    readonly env: NodeJS.ProcessEnv;
+    readonly isTTY: boolean;
+}
+export declare function probeCapabilities(p: ProbeEnv): TerminalCaps;
+export declare function selectTier(caps: TerminalCaps): RenderTier;
+/** Convenience: probe the live process + pick a tier. */
+export declare function detectTier(stream?: {
+    isTTY?: boolean;
+}): {
+    caps: TerminalCaps;
+    tier: RenderTier;
+};
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/watch/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/watch/capabilities.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAqBD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,GAAG,YAAY,CAsB3D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAIzD;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,MAAM,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAmB,GAAG;IACxE,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CAClB,CAOA"}

package/dist/watch/engine.d.ts

@@ -0,0 +1,35 @@
+import { type LifecycleSnapshot, type WatchSnapshot } from "./model.js";
+export type WatchOutcome = "live" | "failed" | "timeout" | "interrupted" | "not_found";
+export interface WatchEngineDeps {
+    /** One poll. Resolves to the lifecycle, or null when the slug is
+     *  unknown to the bot (terminal: nothing to watch). Throws on transient
+     *  / network / 5xx errors (the loop backs off and retries). */
+    readonly fetchLifecycle: () => Promise<LifecycleSnapshot | null>;
+    readonly now: () => number;
+    /** Resolves after `ms`, or early if `signal` aborts. */
+    readonly sleep: (ms: number, signal: AbortSignal) => Promise<void>;
+    /** Aborts the watch (wired to SIGINT/SIGTERM by the caller). */
+    readonly signal: AbortSignal;
+    /** Called every poll with the latest snapshot (the live frame). */
+    readonly onTick: (snapshot: WatchSnapshot) => void;
+    /** Called once on a terminal state (live/failed) with the final frame. */
+    readonly onTerminal: (snapshot: WatchSnapshot) => void;
+    /** Non-fatal: a transient poll error the loop is retrying. */
+    readonly onPollError?: (error: unknown, nextRetryMs: number) => void;
+}
+export interface WatchEngineOptions {
+    readonly pollIntervalMs?: number;
+    readonly backoffFactor?: number;
+    readonly maxBackoffMs?: number;
+    readonly maxDurationMs?: number;
+}
+export interface WatchResult {
+    readonly outcome: WatchOutcome;
+    /** The last snapshot rendered (null only if the very first poll said
+     *  the slug is unknown). */
+    readonly snapshot: WatchSnapshot | null;
+}
+export declare function runWatchLoop(slug: string, deps: WatchEngineDeps, options?: WatchEngineOptions): Promise<WatchResult>;
+/** Real interruptible sleep (production). */
+export declare function makeRealSleep(): (ms: number, signal: AbortSignal) => Promise<void>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/watch/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/watch/engine.ts"],"names":[],"mappings":"AAQA,OAAO,EAAc,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,QAAQ,GACR,SAAS,GACT,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,eAAe;IAC9B;;mEAE+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IACnD,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IACvD,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AASD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B;gCAC4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CACzC;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,CA2CtB;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAclF"}

package/dist/watch/index.d.ts

@@ -0,0 +1,19 @@
+import type { CliIo, ExitCode } from "../dispatcher.js";
+import { type WatchEngineOptions } from "./engine.js";
+export interface RunWatchDeps {
+    readonly now?: () => number;
+    readonly stdout?: {
+        isTTY?: boolean;
+        write: (s: string) => void;
+    };
+    /** Test seam for signal registration; defaults to process. */
+    readonly onSignal?: (handler: () => void) => () => void;
+    readonly engineOptions?: WatchEngineOptions;
+}
+/**
+ * Watch a slug provision to live. Returns an exit code:
+ *   0 live (or timed-out-but-still-going); 1 failed / not-found;
+ *   2 auth/transport; 130 interrupted (Ctrl-C).
+ */
+export declare function runWatch(slug: string, io: CliIo, deps?: RunWatchDeps): Promise<ExitCode>;
+//# sourceMappingURL=index.d.ts.map

package/dist/watch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watch/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAA+B,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA6CnF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IAClE,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC;CAC7C;AAWD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA2ElG"}

package/dist/watch/model.d.ts

@@ -0,0 +1,69 @@
+import { type PhaseName } from "./phases.js";
+/** The subset of the bot's LifecycleView the watcher consumes. */
+export interface LifecycleSnapshot {
+    readonly state: "provisioning" | "live" | "failed" | "destroying" | "destroyed" | "destroy_failed";
+    readonly stage?: string;
+    readonly failedAt?: {
+        readonly stage: string;
+        readonly message: string;
+        readonly retryable: boolean;
+    };
+    readonly liveUrl?: string;
+}
+export type PhaseStatus = "pending" | "active" | "done" | "failed";
+export interface PhaseView {
+    readonly name: PhaseName;
+    readonly status: PhaseStatus;
+    /** Observed client-side elapsed for this phase, or null when unknown
+     *  (the phase completed before the watch attached, or hasn't started). */
+    readonly elapsedMs: number | null;
+}
+export type Terminal = "live" | "failed" | null;
+export interface WatchSnapshot {
+    readonly slug: string;
+    readonly phases: readonly PhaseView[];
+    readonly currentStage: string | null;
+    /** N in "stage N/15" (15 when live). */
+    readonly stageOrdinal: number | null;
+    readonly totalStages: number;
+    readonly terminal: Terminal;
+    readonly failure: {
+        readonly stage: string;
+        readonly message: string;
+        readonly retryable: boolean;
+    } | null;
+    readonly liveUrl: string | null;
+    readonly startedAtMs: number;
+    readonly elapsedTotalMs: number;
+}
+/**
+ * Accumulates lifecycle observations into a renderable snapshot. One
+ * instance per watch session; `ingest` is called once per poll tick.
+ */
+export declare class WatchModel {
+    private readonly slug;
+    private startedAtMs;
+    /** First time each stage was observed (client-side). */
+    private readonly stageFirstSeen;
+    /** Order in which stages were first observed. */
+    private readonly observedOrder;
+    private currentStage;
+    private terminal;
+    private failure;
+    private liveUrl;
+    constructor(slug: string);
+    /** Fold one poll result into the model. */
+    ingest(view: LifecycleSnapshot, nowMs: number): void;
+    /** True once a terminal (live/failed) state has been observed. */
+    isTerminal(): boolean;
+    /** Render the current snapshot as of `nowMs`. */
+    snapshot(nowMs: number): WatchSnapshot;
+    /**
+     * Observed elapsed for a phase: from the first observed stage in the
+     * phase to the first observed stage of a LATER phase (or `nowMs` if the
+     * phase is still the active one). null when we never observed the
+     * phase's start (it completed before the watch attached).
+     */
+    private phaseElapsed;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/watch/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/watch/model.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,aAAa,CAAC;AAErB,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EACV,cAAc,GACd,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,gBAAgB,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;8EAC0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,wCAAwC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;KAC7B,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,UAAU;IAWT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVjC,OAAO,CAAC,WAAW,CAAuB;IAC1C,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,OAAO,CAAuB;gBAET,IAAI,EAAE,MAAM;IAEzC,2CAA2C;IAC3C,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBpD,kEAAkE;IAClE,UAAU,IAAI,OAAO;IAIrB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAsDtC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CA4BrB"}

package/dist/watch/phases.d.ts

@@ -0,0 +1,20 @@
+/** The six phases, in display order. */
+export declare const PHASE_NAMES: readonly ["Repo", "Build", "Infra", "Certificate", "Access", "Verify"];
+export type PhaseName = (typeof PHASE_NAMES)[number];
+/**
+ * The 15 working stages in happy-path order. `done` is terminal and is
+ * NOT a working stage — reaching it means the Verify phase is complete
+ * (the app is live). `stage N/15` uses a stage's index in this array.
+ */
+export declare const STAGE_ORDER: readonly ["pending", "repo_created", "bootstrap_pr_opened", "bootstrap_pr_merged", "content_seeded", "tf_pr_opened", "tf_pr_merged", "tf_applied", "cert_active", "policy_attached", "tf_env_pr_opened", "tf_env_pr_merged", "tf_env_applied", "ready_for_content", "deployment_verified"];
+export declare const TOTAL_STAGES: 15;
+/** 1-based ordinal of a working stage, or null if not a working stage. */
+export declare function ordinalOfStage(stage: string): number | null;
+/**
+ * The phase a stage belongs to. Returns null for an unrecognised stage
+ * (the model then keeps the last-known active phase rather than guessing).
+ */
+export declare function phaseOfStage(stage: string): PhaseName | null;
+/** Index of a phase in PHASE_NAMES (display/ordering), or -1. */
+export declare function phaseIndex(phase: PhaseName): number;
+//# sourceMappingURL=phases.d.ts.map

package/dist/watch/phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.d.ts","sourceRoot":"","sources":["../../src/watch/phases.ts"],"names":[],"mappings":"AAWA,wCAAwC;AACxC,eAAO,MAAM,WAAW,wEAOd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,WAAW,4RAgBd,CAAC;AAEX,eAAO,MAAM,YAAY,IAAqB,CAAC;AAmC/C,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE5D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEnD"}

package/dist/watch/render.d.ts

@@ -0,0 +1,55 @@
+import type { RenderTier } from "./capabilities.js";
+import type { WatchSnapshot } from "./model.js";
+type GlyphStyle = "unicode" | "ascii";
+export declare const CURSOR_HIDE = "\u001B[?25l";
+export declare const CURSOR_SHOW = "\u001B[?25h";
+export declare function styleForTier(tier: RenderTier): GlyphStyle;
+export declare function launchpadUrl(slug: string): string;
+/** ms → "M:SS" (or `dash` when unknown/null). */
+export declare function formatDuration(ms: number | null, dash?: string): string;
+/** The live provisioning frame (multi-line) for inline/ascii tiers. */
+export declare function renderProvisioningFrame(s: WatchSnapshot, opts: {
+    style: GlyphStyle;
+    spinnerFrame: number;
+}): string;
+/** One-line compact update for the append-only tier. */
+export declare function renderAppendLine(s: WatchSnapshot, opts: {
+    style: GlyphStyle;
+    spinnerFrame: number;
+}): string;
+/**
+ * Plain, ASCII-only, escape-free line for the non-TTY tier (pipes / CI).
+ * Mirrors the existing `launchpad status` one-liner style so piped output
+ * stays familiar and never carries control sequences.
+ */
+export declare function renderPlainLine(s: WatchSnapshot): string;
+/** Final LIVE frame. */
+export declare function renderLiveFrame(s: WatchSnapshot, opts: {
+    style: GlyphStyle;
+}): string;
+/** Final FAILED frame. */
+export declare function renderFailedFrame(s: WatchSnapshot, opts: {
+    style: GlyphStyle;
+}): string;
+/**
+ * Owns the cursor mechanics for the redraw tiers. `write` receives raw
+ * strings (the renderer's own trusted ANSI + already-sanitised content).
+ */
+export declare class Renderer {
+    private readonly write;
+    private readonly tier;
+    private prevLines;
+    private spinnerFrame;
+    private cursorHidden;
+    private readonly style;
+    constructor(write: (s: string) => void, tier: RenderTier);
+    /** Per-poll live frame. No-op for the plain tier (caller handles it). */
+    tick(s: WatchSnapshot): void;
+    /** Final frame; settles the view (no spinner) and restores the cursor. */
+    terminal(s: WatchSnapshot): void;
+    /** Restore the terminal on any exit path (also called from signal handlers). */
+    restoreCursor(): void;
+    private redraw;
+}
+export {};
+//# sourceMappingURL=render.d.ts.map

package/dist/watch/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/watch/render.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,KAAK,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAoCtC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAIzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAEzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,SAAM,GAAG,MAAM,CAMpE;AAqBD,uEAAuE;AACvE,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,aAAa,EAChB,IAAI,EAAE;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAChD,MAAM,CAkBR;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,aAAa,EAChB,IAAI,EAAE;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAChD,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAaxD;AAED,wBAAwB;AACxB,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,MAAM,CAYrF;AAED,0BAA0B;AAC1B,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,MAAM,CAiBvF;AAED;;;GAGG;AACH,qBAAa,QAAQ;IAOjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAGhB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC1B,IAAI,EAAE,UAAU;IAKnC,yEAAyE;IACzE,IAAI,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;IAc5B,0EAA0E;IAC1E,QAAQ,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;IAchC,gFAAgF;IAChF,aAAa,IAAI,IAAI;IAOrB,OAAO,CAAC,MAAM;CAKf"}

package/dist/watch/sanitize.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Strip all control characters from an untrusted string so nothing it
+ * contains can be interpreted as a terminal control sequence. Printable
+ * text (incl. full Unicode) is preserved; an ESC that would introduce a
+ * CSI/OSC sequence is removed, so the rest renders as inert literal text.
+ */
+export declare function sanitizeForTerminal(input: string): string;
+/**
+ * Sanitise + bound a value to a single line of at most `max` glyphs, so a
+ * pathologically long bot string can't blow the layout. Adds an ellipsis
+ * when truncated.
+ */
+export declare function sanitizeField(input: string | null | undefined, max?: number): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/watch/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/watch/sanitize.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,SAAM,GAAG,MAAM,CAKjF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m-kopa/launchpad-cli",
-  "version": "0.32.1",
+  "version": "0.33.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": {
@@ -50,6 +50,7 @@
     "lint": "eslint src tests",
     "typecheck": "tsc --noEmit",
     "check:version-sync": "bash scripts/check-version-sync.sh",
+    "check:runtime-deps": "node scripts/check-runtime-deps.mjs",
     "check:installer-syntax": "bash scripts/check-installer-syntax.sh",
     "check:skill-contract": "bash scripts/sync-skill-contract.sh --check",
     "check:skill-bash-dialect": "bash scripts/check-skill-bash-dialect.sh",

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.32.1
+version: 0.33.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
@@ -96,11 +96,17 @@ What happens:
   the bundle **directly to `main`** on `launchpad-app-<slug>` via
   the Git Data API — you are the commit author, the bot is the
   committer. No PR, no merge step.
-- The CLI returns at the bot's 202 ack — `✓ Bundle accepted —
-  committed as <sha>`, then "Committed; build pending". It does
-  **not** wait for the Pages build: a successful deploy is **not** a
-  live app yet — the build runs asynchronously and can fail after
-  the commit lands. Always confirm with `launchpad status`.
+- The CLI prints the bot's 202 ack — `✓ Bundle accepted —
+  committed as <sha>`, then "Committed; build pending". By default it
+  then **waits for the Pages build and verifies it** (up to ~180s):
+  it byte-compares the served entrypoint against what you shipped and
+  prints `✓ Verified — the live deployment serves exactly what you
+  shipped`, or exits non-zero if the build fails or the served bytes
+  don't match (sp-dplvfy). Tune with `--verify-timeout=<secs>`, or skip
+  it with `--no-verify` (commit only, return immediately). When verify
+  is skipped or times out (`pending`), the commit landed but the build
+  is still async and can fail afterwards — confirm with
+  `launchpad status`.
 
 Flags worth knowing:
 
@@ -117,11 +123,15 @@ Flags worth knowing:
 Exit codes:
 
 - **0** — bundle accepted and committed (or "nothing to deploy"
-  when `main` already matches the bundle). This is **not** proof the
-  app is live — verify with `launchpad status`.
+  when `main` already matches the bundle), **and** default in-line
+  verification confirmed the live deployment serves it. With
+  `--no-verify`, or if verification times out at `pending`, exit 0
+  means only that the commit landed — confirm with `launchpad status`.
 - **non-zero** — gate rejections are rendered with per-file detail
-  on stderr; fix the bundle and re-run. For provisioning-phase
-  failures see `/launchpad-deploy-status <slug>`.
+  on stderr; fix the bundle and re-run. A build failure or a
+  served-content mismatch caught by default verification also exits
+  non-zero. For provisioning-phase failures see
+  `/launchpad-deploy-status <slug>`.
 
 ## What the bot enforces on every bundle
 
@@ -263,9 +273,11 @@ Once you've shipped first content, the daily-use verbs are:
   hand-rolled change bypasses the bundle policy, secret-scan,
   build-command gates, and the standing-exception ledger. Use
   `launchpad deploy`.
-- Do **not** treat exit 0 from `launchpad deploy` as "live". The
-  commit landed, but the Pages build runs asynchronously and can
-  fail afterwards — always verify with `launchpad status`.
+- Do **not** treat exit 0 from `launchpad deploy --no-verify` (or a
+  run whose verification timed out at `pending`) as "live". The commit
+  landed, but the build is still async and can fail afterwards —
+  verify with `launchpad status`. A default deploy (verification on)
+  already byte-checks the served content before exiting 0.
 - Do **not** re-implement the server-side gates locally.
   `launchpad validate` plus the CLI's own app-boundary pre-flight
   cover the local half; the bot enforces the rest server-side and

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.32.1
+version: 0.33.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
@@ -271,8 +271,10 @@ fresh slug auto-provisions:
   5–10 minutes. **Your bundle ships with the provisioning run** — when
   lifecycle reaches `live`, this deploy's content is what's serving.
   **No second deploy needed**; re-deploying is only for the rare case
-  where the app comes up live *without* your content. Watch with
-  `launchpad status <slug>`.
+  where the app comes up live *without* your content. **Watch it go
+  live in real time with `launchpad watch <slug>`** (a self-updating
+  view of the provisioning pipeline that exits when the app is live or
+  failed); `launchpad status <slug>` is the one-shot equivalent.
 - **Subsequent deploys** (slug already live): the bot extracts the
   tarball, runs the ingest gates (see below), commits the bundle
   straight onto `main` of `launchpad-app-<slug>` via the GitHub App
@@ -314,8 +316,9 @@ re-trying.
 
 The CLI exits as soon as the bot acknowledges the upload (202). For
 subsequent deploys it prints the commit short-SHA + repo; for first
-deploys it prints provisioning guidance. Use `launchpad status
-<slug>` to watch lifecycle progress to its terminal state.
+deploys it prints provisioning guidance. Run `launchpad watch <slug>`
+to watch lifecycle progress live to its terminal state (or
+`launchpad status <slug>` for a one-shot check).
 
 Flags — there is nothing useful to pass on the Model A path:
 

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.1
+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.33.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.
@@ -90,7 +119,7 @@ Live-app states:
 - **`drift: <field list>`** — local and deployed differ on at least
   one v1 closed-set field (`metadata.name`, `metadata.team`,
   `metadata.owner`, `metadata.description`, `deployment.type`,
-  `access.allowed_entra_group`, `hostnames[0]`, `build.command`,
+  `access.allowed_entra_groups`, `hostnames[0]`, `build.command`,
   `build.destination_dir`, `build.root_dir`, `production_env.*`).
   Run `launchpad deploy` to roll the local manifest out.
 - **`live_no_content`** — provisioned, but no content deployed yet.

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.1
+version: 0.33.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.1
+version: 0.33.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.1
+version: 0.33.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
@@ -39,9 +39,9 @@ a copy-pasteable fix for any red row.
 This is the **only** skill that mutates the user's machine (it can
 trigger `launchpad login` and suggest installs). The other skills
 (`/launchpad-deploy`, `/launchpad-deploy-status`,
-`/launchpad-content-pr`, `/launchpad-status`, `/launchpad-destroy`)
-assume the machine is already onboarded and fail loudly if a prereq is
-missing — pointing back here.
+`/launchpad-content-pr`, `/launchpad-status`, `/launchpad-destroy`,
+`/launchpad-identity`) assume the machine is already onboarded and fail
+loudly if a prereq is missing — pointing back here.
 
 ## Zero non-Launchpad dependencies
 

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.1
+version: 0.33.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
@@ -132,7 +132,7 @@ union of states, not just a drift verdict. The drift pair:
   one field in the v1 closed set:
   `metadata.name`, `metadata.team`, `metadata.owner`,
   `metadata.description`, `deployment.type`,
-  `access.allowed_entra_group`, `hostnames[0]`, `build.command`,
+  `access.allowed_entra_groups`, `hostnames[0]`, `build.command`,
   `build.destination_dir`, `build.root_dir`, `production_env.*`.
 
 The lifecycle states (rendered without needing a local manifest):
@@ -328,7 +328,7 @@ edge-auth + cert re-issuance — the gateway hostname/cert for an
 `auth: gateway` app, or the Cf Access app for an `auth: access` one —
 which the bot handles.)
 
-### "drift: access.allowed_entra_group"
+### "drift: access.allowed_entra_groups"
 
 Group binding changed in your local manifest. This is the
 **load-bearing** drift — it controls who can access the app. After