@m-kopa/launchpad-cli 0.71.0 → 0.72.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/dist/cli.js +47 -4
- package/dist/secrets/push.d.ts +2 -0
- package/dist/secrets/push.d.ts.map +1 -1
- package/dist/version.d.ts +1 -1
- package/package.json +1 -1
- package/skills/launchpad-content-pr/SKILL.md +8 -1
- package/skills/launchpad-deploy/SKILL.md +3 -1
- package/skills/launchpad-deploy-status/SKILL.md +2 -1
- package/skills/launchpad-destroy/SKILL.md +1 -1
- package/skills/launchpad-identity/SKILL.md +1 -1
- package/skills/launchpad-onboard/SKILL.md +1 -1
- package/skills/launchpad-report/SKILL.md +1 -1
- package/skills/launchpad-status/SKILL.md +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
|
|
6
6
|
This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html);
|
|
7
7
|
pre-1.0 minor bumps may carry breaking changes per ADR 0005.
|
|
8
8
|
|
|
9
|
+
## 0.72.0 - 2026-10-06
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
|
|
13
|
+
- `launchpad secrets push` now works for a container app that has not deployed yet. A container's deploy workflow reads its declared secrets from GitHub Actions secrets on the app repo, which authors cannot reach, so `push` also writes them there (ADR 0059): only names declared in `secrets.bindings[]`, never platform-owned names, encrypted to the repo's key. A Worker that does not exist yet is reported as `skipped_not_deployed` without failing the push. Before this, a container's first deploy failed at "Verify required deployment inputs" and every later deploy would have too.
|
|
14
|
+
- For a container app stuck at `provisioning_failed` / `deployment_verified` because of missing secrets, `push` prints the next step: `launchpad recover <slug>` (run it again when the deploy run finishes). `launchpad secrets push --redeploy` runs the first `recover` for you; it has no effect on an already-deployed container app, and `launchpad redeploy` stays a no-op for containers.
|
|
15
|
+
- `launchpad secrets status` lists a `github_actions` surface for container apps.
|
|
16
|
+
|
|
9
17
|
## 0.71.0 - 2026-10-06
|
|
10
18
|
|
|
11
19
|
### Added
|
package/dist/cli.js
CHANGED
|
@@ -19,7 +19,7 @@ var __toESM = (mod, isNodeMode, target) => {
|
|
|
19
19
|
var __require = /* @__PURE__ */ createRequire(import.meta.url);
|
|
20
20
|
|
|
21
21
|
// src/version.ts
|
|
22
|
-
var CLI_VERSION = "0.
|
|
22
|
+
var CLI_VERSION = "0.72.0";
|
|
23
23
|
|
|
24
24
|
// src/config.ts
|
|
25
25
|
import { readFileSync } from "node:fs";
|
|
@@ -15394,6 +15394,8 @@ async function runSecretsPush(opts, io, deps = {}) {
|
|
|
15394
15394
|
let anyPagesUpdated = false;
|
|
15395
15395
|
let anyWorkerUpdated = false;
|
|
15396
15396
|
let anyDispatchUpdated = false;
|
|
15397
|
+
let anyGithubWritten = false;
|
|
15398
|
+
let anyWorkerNotDeployed = false;
|
|
15397
15399
|
for (const b of envFileBindings) {
|
|
15398
15400
|
const value = parsed.entries.get(b.name);
|
|
15399
15401
|
io.out(`Pushing ${b.name} …`);
|
|
@@ -15421,6 +15423,10 @@ async function runSecretsPush(opts, io, deps = {}) {
|
|
|
15421
15423
|
}
|
|
15422
15424
|
const results = resp.results ?? [];
|
|
15423
15425
|
for (const r of results) {
|
|
15426
|
+
if (r.kind === "github_actions" && r.status === "written")
|
|
15427
|
+
anyGithubWritten = true;
|
|
15428
|
+
if (r.kind === "worker" && r.status === "skipped_not_deployed")
|
|
15429
|
+
anyWorkerNotDeployed = true;
|
|
15424
15430
|
if (r.status !== "updated")
|
|
15425
15431
|
continue;
|
|
15426
15432
|
if (r.kind === "pages")
|
|
@@ -15430,11 +15436,17 @@ async function runSecretsPush(opts, io, deps = {}) {
|
|
|
15430
15436
|
else if (r.kind === "dispatch")
|
|
15431
15437
|
anyDispatchUpdated = true;
|
|
15432
15438
|
}
|
|
15433
|
-
const
|
|
15439
|
+
const isSet = (r) => r.status === "updated" || r.status === "written";
|
|
15440
|
+
const notUpdated = resp.updated === true ? [] : results.filter((r) => !isSet(r));
|
|
15434
15441
|
if (resp.updated === true && notUpdated.length === 0) {
|
|
15435
15442
|
pushed += 1;
|
|
15436
|
-
|
|
15437
|
-
|
|
15443
|
+
const setOn = results.filter(isSet);
|
|
15444
|
+
const deferred = results.filter((r) => !isSet(r));
|
|
15445
|
+
if (setOn.length > 1 || setOn.some((r) => r.kind === "github_actions")) {
|
|
15446
|
+
io.out(` → set on ${setOn.length} destination${setOn.length === 1 ? "" : "s"}: ${setOn.map((r) => describeDestination(r)).join(", ")}`);
|
|
15447
|
+
}
|
|
15448
|
+
for (const r of deferred) {
|
|
15449
|
+
io.out(` · ${describeDestination(r)}: ${describeDeferred(r.status)}`);
|
|
15438
15450
|
}
|
|
15439
15451
|
} else {
|
|
15440
15452
|
partial += 1;
|
|
@@ -15449,6 +15461,9 @@ async function runSecretsPush(opts, io, deps = {}) {
|
|
|
15449
15461
|
return 1;
|
|
15450
15462
|
}
|
|
15451
15463
|
io.out(`✓ Pushed ${pushed} binding${pushed === 1 ? "" : "s"} via portal-bot.`);
|
|
15464
|
+
if (anyGithubWritten) {
|
|
15465
|
+
return containerNextStep(slug, anyWorkerNotDeployed, opts, io, deps);
|
|
15466
|
+
}
|
|
15452
15467
|
if (anyPagesUpdated) {
|
|
15453
15468
|
return offerRedeploy(slug, opts, io, deps);
|
|
15454
15469
|
}
|
|
@@ -15461,6 +15476,34 @@ async function runSecretsPush(opts, io, deps = {}) {
|
|
|
15461
15476
|
}
|
|
15462
15477
|
return 0;
|
|
15463
15478
|
}
|
|
15479
|
+
function describeDestination(r) {
|
|
15480
|
+
return r.kind === "github_actions" ? `GitHub Actions secrets (${r.cfName})` : r.id;
|
|
15481
|
+
}
|
|
15482
|
+
function describeDeferred(status) {
|
|
15483
|
+
return status === "skipped_not_deployed" ? "Worker not deployed yet; it receives the value on the first successful deploy" : status;
|
|
15484
|
+
}
|
|
15485
|
+
async function containerNextStep(slug, workerNotDeployed, opts, io, deps) {
|
|
15486
|
+
if (!workerNotDeployed) {
|
|
15487
|
+
io.out("Set on the deployed Worker (live on its next invocation) and in the app repo's GitHub Actions secrets");
|
|
15488
|
+
io.out("(so the next `launchpad deploy` keeps them). No redeploy needed.");
|
|
15489
|
+
if (opts.redeploy === true) {
|
|
15490
|
+
io.out("Note: --redeploy has no effect on a container app that is already deployed.");
|
|
15491
|
+
}
|
|
15492
|
+
return 0;
|
|
15493
|
+
}
|
|
15494
|
+
io.out("");
|
|
15495
|
+
io.out("The values are in the app repo's GitHub Actions secrets and ship with the next deploy workflow run.");
|
|
15496
|
+
io.out(`If ${slug} is stuck in provisioning_failed at deployment_verified, re-run its deploy workflow with:`);
|
|
15497
|
+
io.out(` launchpad recover ${slug}`);
|
|
15498
|
+
io.out(`then run \`launchpad recover ${slug}\` again once the run finishes to mark the app live.`);
|
|
15499
|
+
io.out(`(If ${slug} is still provisioning, wait for \`launchpad status ${slug}\` to settle first.`);
|
|
15500
|
+
io.out("`launchpad deploy` with no content change and `launchpad redeploy` cannot re-run a container deploy.)");
|
|
15501
|
+
if (opts.redeploy !== true)
|
|
15502
|
+
return 0;
|
|
15503
|
+
io.out("");
|
|
15504
|
+
const run = deps.runRecover ?? ((args, cliIo) => recoverCommand.run(args, cliIo));
|
|
15505
|
+
return run([slug], io);
|
|
15506
|
+
}
|
|
15464
15507
|
async function offerRedeploy(slug, opts, io, deps) {
|
|
15465
15508
|
io.out("");
|
|
15466
15509
|
io.out("A Pages app binds a pushed secret only on its NEXT deployment — the value is set but");
|
package/dist/secrets/push.d.ts
CHANGED
|
@@ -29,6 +29,8 @@ export interface PushDeps {
|
|
|
29
29
|
readonly prompt?: (question: string) => Promise<string>;
|
|
30
30
|
/** Override the redeploy trigger (tests). */
|
|
31
31
|
readonly runRedeploy?: (opts: RedeployOptions, io: CliIo, deps?: RedeployDeps) => Promise<ExitCode>;
|
|
32
|
+
/** Override `launchpad recover <slug>` for a stuck container app (tests). */
|
|
33
|
+
readonly runRecover?: (args: readonly string[], io: CliIo) => Promise<ExitCode>;
|
|
32
34
|
}
|
|
33
35
|
export declare function runSecretsPush(opts: PushOptions, io: CliIo, deps?: PushDeps): Promise<ExitCode>;
|
|
34
36
|
//# sourceMappingURL=push.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/secrets/push.ts"],"names":[],"mappings":"AAoDA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAY1D,OAAO,EAAe,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;
|
|
1
|
+
{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/secrets/push.ts"],"names":[],"mappings":"AAoDA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAY1D,OAAO,EAAe,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE/F,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,KAAK,EACT,IAAI,CAAC,EAAE,YAAY,KAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACjF;AAiBD,wBAAsB,cAAc,CAClC,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,KAAK,EACT,IAAI,GAAE,QAAa,GAClB,OAAO,CAAC,QAAQ,CAAC,CA2OnB"}
|
package/dist/version.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const CLI_VERSION = "0.
|
|
1
|
+
export declare const CLI_VERSION = "0.72.0";
|
|
2
2
|
//# sourceMappingURL=version.d.ts.map
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: launchpad-content-pr
|
|
3
3
|
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, then the dispatch delivery (or, for a legacy Pages app, 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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.72.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -367,6 +367,13 @@ Once you've shipped first content, the daily-use verbs are:
|
|
|
367
367
|
The gateway verifier names (`GATEWAY_*`, `CF_ACCESS_*`, `JWKS_URL`)
|
|
368
368
|
are platform-set on dispatch and refused with `reserved_secret_name`.
|
|
369
369
|
On a Pages app, follow the push with `launchpad redeploy`.
|
|
370
|
+
On a container app, `push` also sets the secrets as GitHub Actions
|
|
371
|
+
secrets on the app repo (the deploy workflow reads them there), so a
|
|
372
|
+
container's first deploy can be unblocked without repo access. If the
|
|
373
|
+
app is `provisioning_failed` at `deployment_verified` for missing
|
|
374
|
+
secrets, run `launchpad secrets push` then `launchpad recover <slug>`
|
|
375
|
+
(run it again when the deploy run finishes). `launchpad redeploy` is a
|
|
376
|
+
no-op for containers and cannot do this.
|
|
370
377
|
- **`launchpad secrets status`** — names-only PRESENT/MISSING audit
|
|
371
378
|
per binding.
|
|
372
379
|
- **`launchpad logs --slug <slug>`** - Pages apps only: recent
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: launchpad-deploy
|
|
3
3
|
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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.72.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -403,6 +403,8 @@ Only keep `auth: access` on an existing container app that has not been migrated
|
|
|
403
403
|
Do not switch an existing container between modes on your own; offer `/launchpad-report` so the platform team can migrate it.
|
|
404
404
|
Reading the signed-in user inside the container is covered in `/launchpad-identity`.
|
|
405
405
|
|
|
406
|
+
A container app's deploy workflow reads its declared secrets from GitHub Actions secrets on the app repo, which the author cannot reach. `launchpad secrets push` writes them there, so a container that declares secrets needs them pushed before its deploy workflow can pass. If the first deploy ends `provisioning_failed` at `deployment_verified` because of missing secrets, run `launchpad secrets push` and then `launchpad recover <slug>` (again when the deploy run finishes, to mark it live). `launchpad deploy` with no change and `launchpad redeploy` cannot re-run a failed container deploy.
|
|
407
|
+
|
|
406
408
|
**First deploy vs subsequent deploys** (M-1234). Under Model A there
|
|
407
409
|
is no separate "create the app" step — `launchpad deploy` against a
|
|
408
410
|
fresh slug auto-provisions:
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: launchpad-deploy-status
|
|
3
3
|
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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.72.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -71,6 +71,7 @@ inference source resolves.
|
|
|
71
71
|
| Is the app stuck in the legacy M-892 zero-touch flow? | See § Legacy below |
|
|
72
72
|
| What broke the most recent deploy? | `launchpad status <slug> --json` + the bot's PR check trail |
|
|
73
73
|
| It says `failed` but the app is live in a browser | `launchpad recover <slug>` — see § Recover below |
|
|
74
|
+
| A container app is `provisioning_failed` at `deployment_verified` (deploy workflow found its secrets missing) | `launchpad secrets push`, then `launchpad recover <slug>`; run `recover` again once the deploy run finishes |
|
|
74
75
|
|
|
75
76
|
The Model A default is `launchpad status <slug>` (a one-shot read).
|
|
76
77
|
For an in-flight first deploy, `launchpad watch <slug>` is the live
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: launchpad-destroy
|
|
3
3
|
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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.72.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: launchpad-identity
|
|
3
3
|
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 the app's server code (functions/ on a react+api app, compiled into its Worker on dispatch, or a Pages Function on a legacy Pages app), 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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.72.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: launchpad-onboard
|
|
3
3
|
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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.72.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: launchpad-report
|
|
3
3
|
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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.72.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: launchpad-status
|
|
3
3
|
description: Safely refresh a Launchpad clone, show manifest drift, or read the deployed manifest. Wraps bare `launchpad pull` for source sync, `launchpad pull --manifest` for deployed YAML, and `launchpad status` for drift. Use for "sync my clone", "what's deployed", "show drift", "/launchpad-status", "/launchpad-pull", or post-deploy verification.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.72.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|