@m-kopa/launchpad-cli 0.39.0 → 0.41.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 +84 -0
- package/dist/cli.js +400 -159
- package/dist/commands/deploy.d.ts.map +1 -1
- package/dist/commands/status.d.ts +8 -1
- package/dist/commands/status.d.ts.map +1 -1
- package/dist/deploy/manifest-state.d.ts +7 -0
- package/dist/deploy/manifest-state.d.ts.map +1 -1
- package/dist/http/api-client.d.ts.map +1 -1
- package/dist/report/classify-fault.d.ts +28 -0
- package/dist/report/classify-fault.d.ts.map +1 -0
- package/dist/report/fault-signal.d.ts +23 -0
- package/dist/report/fault-signal.d.ts.map +1 -0
- package/dist/report/report-nudge.d.ts +33 -0
- package/dist/report/report-nudge.d.ts.map +1 -0
- package/dist/version.d.ts +1 -1
- package/package.json +3 -1
- package/skills/launchpad-content-pr/SKILL.md +6 -1
- package/skills/launchpad-deploy/SKILL.md +26 -1
- package/skills/launchpad-deploy-status/SKILL.md +14 -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 +10 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAmEA,OAAO,EAGL,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAa,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AAKjE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;AAEjD,eAAO,MAAM,aAAa,EAAE,OAI3B,CAAC;AAEF,UAAU,UAAU;IAClB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAmQD;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAoBpC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAwBpE;
|
|
1
|
+
{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAmEA,OAAO,EAGL,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAa,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AAKjE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;AAEjD,eAAO,MAAM,aAAa,EAAE,OAI3B,CAAC;AAEF,UAAU,UAAU;IAClB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAmQD;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAoBpC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAwBpE;AAkMD,2BAA2B;AAC3B,OAAO,EAAE,4BAA4B,EAAE,CAAC"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { type CliConfig } from "../config.js";
|
|
2
2
|
import { type DeploymentStatusView, type StandingExceptionView } from "../deploy/deployment-status.js";
|
|
3
|
-
import { type Manifest } from "@m-kopa/launchpad-engine";
|
|
3
|
+
import { type Manifest, type AccessDrift } from "@m-kopa/launchpad-engine";
|
|
4
4
|
import type { Command } from "../dispatcher.js";
|
|
5
5
|
export declare const statusCommand: Command;
|
|
6
6
|
interface StatusArgs {
|
|
@@ -78,6 +78,13 @@ export interface StatusJsonOutput {
|
|
|
78
78
|
* policy violations in content already live on managed main.
|
|
79
79
|
* Absent when the bot pre-dates the endpoint. */
|
|
80
80
|
readonly standingExceptions?: readonly StandingExceptionView[];
|
|
81
|
+
/** PS-1755 / PS-1763 (T4): access drift between the LOCAL declared groups
|
|
82
|
+
* (`access.allowed_entra_groups`) and the ENFORCED gateway-KV allow-list
|
|
83
|
+
* the bot read from the app's TF. Distinct from the content-drift
|
|
84
|
+
* `access.allowed_entra_groups` row (which is local-vs-deployed *manifest*):
|
|
85
|
+
* this is "what I declare" vs "what the gateway actually enforces".
|
|
86
|
+
* Absent when not a gateway-KV app (`enforcedGroups` null / old bot). */
|
|
87
|
+
readonly accessDrift?: AccessDrift;
|
|
81
88
|
}
|
|
82
89
|
/** Fetch the app's provisioning lifecycle (sp-st5hw9). Returns null when the
|
|
83
90
|
* bot doesn't recognise the slug OR predates the endpoint — BOTH surface as a
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AASxC,OAAO,
|
|
1
|
+
{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}
|
|
@@ -9,6 +9,13 @@ export interface ManifestStateResponse {
|
|
|
9
9
|
readonly url: string;
|
|
10
10
|
readonly branch: string;
|
|
11
11
|
} | null;
|
|
12
|
+
/** PS-1763 (T4): the ENFORCED gateway allow-list — the per-app
|
|
13
|
+
* `<slug>_policy` KV `groups` array, as raw tokens (UUIDs +
|
|
14
|
+
* `entra_groups.<Name>` refs) parsed from the app's TF source. `null` for
|
|
15
|
+
* an app with no `<slug>_policy` block (a CF Access app / the gateway —
|
|
16
|
+
* a different enforcement mechanism, out of scope for gateway-KV drift).
|
|
17
|
+
* Older bots (pre-PS-1763) omit it → normalised to `null`. */
|
|
18
|
+
readonly enforcedGroups: readonly string[] | null;
|
|
12
19
|
readonly manifestYaml?: string | null;
|
|
13
20
|
}
|
|
14
21
|
/** Fetch `/apps/<slug>/manifest/state`. With `includeManifest: true`,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manifest-state.d.ts","sourceRoot":"","sources":["../../src/deploy/manifest-state.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;
|
|
1
|
+
{"version":3,"file":"manifest-state.d.ts","sourceRoot":"","sources":["../../src/deploy/manifest-state.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI,CAAC;IACT;;;;;mEAK+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAeD;;gCAEgC;AAChC,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,EACxC,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAgBhC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/http/api-client.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/http/api-client.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAO9C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD;;;;;;;OAOG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAC1B,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,QAAQ,CAAC,CA8FnB"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { RecordedFault } from "./fault-signal.js";
|
|
2
|
+
/**
|
|
3
|
+
* Exit codes that are themselves platform-fault signals, independent of any
|
|
4
|
+
* recorded HTTP fault. Today only 69 = no-new-deployment (sp-bld9kq): the
|
|
5
|
+
* commit committed but Cloudflare never built it.
|
|
6
|
+
*
|
|
7
|
+
* NB the unhandled-crash exit (70, EX_SOFTWARE) is NOT here — it is emitted
|
|
8
|
+
* only from `cli.ts`'s top-level `.catch`, which nudges directly; a returned
|
|
9
|
+
* code never carries it.
|
|
10
|
+
*/
|
|
11
|
+
export declare const PLATFORM_FAULT_EXIT_CODES: readonly number[];
|
|
12
|
+
export interface FaultClassifierInput {
|
|
13
|
+
readonly exitCode: number;
|
|
14
|
+
readonly lastFault: RecordedFault | null;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* True iff the failure warrants a "file a bug" nudge.
|
|
18
|
+
*
|
|
19
|
+
* - exit 0 (incl. the soft pending/superseded/not-registered-yet outcomes)
|
|
20
|
+
* is never a fault.
|
|
21
|
+
* - A platform-fault exit code (69) is a direct signal.
|
|
22
|
+
* - Otherwise classify by the last typed HTTP fault: `TransportError`
|
|
23
|
+
* (network) and `ApiError` with status >= 500 (bot/server 5xx) are platform
|
|
24
|
+
* faults; `ApiError` 4xx, 401/403/404, and any non-HTTP failure (local input,
|
|
25
|
+
* usage) are NOT.
|
|
26
|
+
*/
|
|
27
|
+
export declare function classifyFault(input: FaultClassifierInput): boolean;
|
|
28
|
+
//# sourceMappingURL=classify-fault.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"classify-fault.d.ts","sourceRoot":"","sources":["../../src/report/classify-fault.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAAS,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAUlE"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/** The discriminant + (for `ApiError`) status of the last typed HTTP error. */
|
|
2
|
+
export interface RecordedFault {
|
|
3
|
+
readonly code: string;
|
|
4
|
+
readonly status?: number;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* Record the last typed error. Accepts any of the `http/errors.ts` classes
|
|
8
|
+
* (all carry a string `.code`; `ApiError` also carries `.status`). A non-error
|
|
9
|
+
* or code-less value is ignored, so a stray throw can never poison the signal.
|
|
10
|
+
*/
|
|
11
|
+
export declare function recordFault(err: unknown): void;
|
|
12
|
+
/**
|
|
13
|
+
* Record then return the error — sugar for `throw recordedFault(new ApiError(…))`
|
|
14
|
+
* at the HTTP client throw sites, so recording can't be forgotten next to a throw.
|
|
15
|
+
*/
|
|
16
|
+
export declare function recordedFault<T>(err: T): T;
|
|
17
|
+
/** Clear the recorded fault — called by the HTTP client on a 2xx success. */
|
|
18
|
+
export declare function clearFault(): void;
|
|
19
|
+
/** Read the last recorded fault (null if none / cleared). */
|
|
20
|
+
export declare function peekFault(): RecordedFault | null;
|
|
21
|
+
/** Test-only: reset module state between cases. */
|
|
22
|
+
export declare function _resetFaultForTesting(): void;
|
|
23
|
+
//# sourceMappingURL=fault-signal.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fault-signal.d.ts","sourceRoot":"","sources":["../../src/report/fault-signal.ts"],"names":[],"mappings":"AAgBA,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAM9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAG1C;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,IAAI,aAAa,GAAG,IAAI,CAEhD;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { CliIo } from "../dispatcher.js";
|
|
2
|
+
import type { RecordedFault } from "./fault-signal.js";
|
|
3
|
+
export interface NudgeContext {
|
|
4
|
+
/** The raw command args; only argv[0] (the verb) is ever read. */
|
|
5
|
+
readonly argv: readonly string[];
|
|
6
|
+
readonly env: Record<string, string | undefined>;
|
|
7
|
+
readonly stderrIsTTY: boolean;
|
|
8
|
+
readonly exitCode: number;
|
|
9
|
+
readonly lastFault: RecordedFault | null;
|
|
10
|
+
}
|
|
11
|
+
/** Quiet in non-interactive / machine contexts, and never nudge the report
|
|
12
|
+
* verbs themselves. Mirrors update-notifier's isSuppressed. */
|
|
13
|
+
export declare function nudgeSuppressed(ctx: {
|
|
14
|
+
readonly argv: readonly string[];
|
|
15
|
+
readonly env: Record<string, string | undefined>;
|
|
16
|
+
readonly stderrIsTTY: boolean;
|
|
17
|
+
}): boolean;
|
|
18
|
+
/**
|
|
19
|
+
* Print the nudge for a finished command iff its failure classifies as a
|
|
20
|
+
* platform fault and we're on an interactive terminal. No-op otherwise.
|
|
21
|
+
*/
|
|
22
|
+
export declare function maybeReportNudge(io: CliIo, ctx: NudgeContext): void;
|
|
23
|
+
/**
|
|
24
|
+
* Print the nudge for the unhandled-crash path (cli.ts top-level `.catch`,
|
|
25
|
+
* exit 70). A crash is a platform fault by definition, so no classifier call —
|
|
26
|
+
* but still TTY/CI-gated and report-verb-skipped.
|
|
27
|
+
*/
|
|
28
|
+
export declare function maybeCrashReportNudge(io: CliIo, ctx: {
|
|
29
|
+
readonly argv: readonly string[];
|
|
30
|
+
readonly env: Record<string, string | undefined>;
|
|
31
|
+
readonly stderrIsTTY: boolean;
|
|
32
|
+
}): void;
|
|
33
|
+
//# sourceMappingURL=report-nudge.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"report-nudge.d.ts","sourceRoot":"","sources":["../../src/report/report-nudge.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;CAC1C;AAED;gEACgE;AAChE,wBAAgB,eAAe,CAAC,GAAG,EAAE;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CAOV;AAYD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAInE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;IACpD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B,GAAG,IAAI,CAGP"}
|
package/dist/version.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const CLI_VERSION = "0.
|
|
1
|
+
export declare const CLI_VERSION = "0.41.0";
|
|
2
2
|
//# sourceMappingURL=version.d.ts.map
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@m-kopa/launchpad-cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.41.0",
|
|
4
4
|
"description": "Launchpad CLI — clone / deploy / review / merge against Launchpad-managed apps. Talks to the portal-bot endpoints (SCOPE-M-760 / T4).",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -49,6 +49,8 @@
|
|
|
49
49
|
"test:watch": "vitest",
|
|
50
50
|
"lint": "eslint src tests",
|
|
51
51
|
"typecheck": "tsc --noEmit",
|
|
52
|
+
"typecheck:catalogue": "tsc -p channel/catalogue/tsconfig.json --noEmit",
|
|
53
|
+
"build:catalogue": "esbuild channel/catalogue/src/main.ts --bundle --format=esm --minify --target=es2020 --legal-comments=none --outfile=channel/catalogue/dist/app.js",
|
|
52
54
|
"check:version-sync": "bash scripts/check-version-sync.sh",
|
|
53
55
|
"check:runtime-deps": "node scripts/check-runtime-deps.mjs",
|
|
54
56
|
"check:installer-syntax": "bash scripts/check-installer-syntax.sh",
|
|
@@ -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 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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.41.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -248,6 +248,11 @@ Once you've shipped first content, the daily-use verbs are:
|
|
|
248
248
|
currently-deployed `launchpad.yaml`.
|
|
249
249
|
- **`launchpad deploy`** — bundle the working tree; the bot commits
|
|
250
250
|
it directly to the app repo's `main`.
|
|
251
|
+
- **`launchpad redeploy <slug>`** — re-run a Pages build of the
|
|
252
|
+
current commit *without* changing content. Use it to **activate a
|
|
253
|
+
secret you just pushed** (Cloudflare binds env only on a new build,
|
|
254
|
+
so `secrets push` alone won't take effect on a Pages tier) or to
|
|
255
|
+
force a clean rebuild. See `/commands/redeploy`.
|
|
251
256
|
- **`launchpad envvars`** — list / set / remove non-secret
|
|
252
257
|
production env vars.
|
|
253
258
|
- **`launchpad secrets template`** — emit `.env.example` from the
|
|
@@ -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.41.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -130,6 +130,16 @@ This is interactive by default. It will ask for:
|
|
|
130
130
|
layouts; the user overrides if needed.
|
|
131
131
|
- **allowed_entra_groups** — one or more, comma-separated; see §A.3.
|
|
132
132
|
|
|
133
|
+
By default the app is **listed in the app catalogue**
|
|
134
|
+
(get.launchpad/catalogue — the employee-facing app directory). Listing
|
|
135
|
+
is discovery only and grants no one access. To keep an internal-only
|
|
136
|
+
app out of it, add to `launchpad.yaml`:
|
|
137
|
+
|
|
138
|
+
```yaml
|
|
139
|
+
catalogue:
|
|
140
|
+
listed: false
|
|
141
|
+
```
|
|
142
|
+
|
|
133
143
|
Non-interactive form for scripting:
|
|
134
144
|
|
|
135
145
|
```bash
|
|
@@ -511,3 +521,18 @@ the in-flight case.
|
|
|
511
521
|
strips the user JWT and 401s every user (see "Gateway auth").
|
|
512
522
|
- Do **not** `wrangler secret put` for a two-tier app — `launchpad secrets
|
|
513
523
|
push` with `targets: all` seeds both tiers via the bot.
|
|
524
|
+
|
|
525
|
+
## When a deploy fails because the platform misbehaved
|
|
526
|
+
|
|
527
|
+
If `launchpad deploy` (or `status`) fails for a reason that is **not** the
|
|
528
|
+
user's — a bot 5xx, a network error, `✗ NO NEW DEPLOYMENT WAS CREATED` /
|
|
529
|
+
exit 69, or an unexpected crash — i.e. it looks like **our** fault, not a typo
|
|
530
|
+
or a missing permission — offer to file it via the **`/launchpad-report`** skill
|
|
531
|
+
(`launchpad bug "<what they were trying to do>"`). The CLI prints a one-line
|
|
532
|
+
nudge on these; offer proactively.
|
|
533
|
+
|
|
534
|
+
Follow `/launchpad-report`'s rules: **never file silently** — show the user the
|
|
535
|
+
exact title + body you'll send and get their confirmation first, and never paste
|
|
536
|
+
secret-bearing commands/values into the report body. Do **not** offer to file
|
|
537
|
+
for a user-side failure (auth/401, not-found/404, a bad manifest, a dirty tree) —
|
|
538
|
+
fix those instead.
|
|
@@ -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.41.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -360,3 +360,16 @@ such a link anyway.
|
|
|
360
360
|
`launchpad apps`. Use `launchpad status <slug> --json` for any
|
|
361
361
|
downstream automation (`launchpad apps` has no `--json`; for
|
|
362
362
|
per-app automation go through `status --json` instead).
|
|
363
|
+
|
|
364
|
+
## When a status check fails because the platform misbehaved
|
|
365
|
+
|
|
366
|
+
If `launchpad status` / `watch` / `recover` fails for a reason that is **not**
|
|
367
|
+
the user's — a bot 5xx, a network error, `✗ NO NEW DEPLOYMENT WAS CREATED` /
|
|
368
|
+
exit 69, or an unexpected crash — offer to file it via the
|
|
369
|
+
**`/launchpad-report`** skill (`launchpad bug "<what they were trying to do>"`).
|
|
370
|
+
The CLI prints a one-line nudge on these; offer proactively.
|
|
371
|
+
|
|
372
|
+
Follow `/launchpad-report`'s rules: **never file silently** — show the exact
|
|
373
|
+
title + body and confirm first, and never paste secret-bearing commands/values
|
|
374
|
+
into the body. Do **not** offer to file for a user-side failure (auth/401,
|
|
375
|
+
not-found/404) — resolve those instead.
|
|
@@ -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.41.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 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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.41.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.41.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.41.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: 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.
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.41.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -336,6 +336,15 @@ Group binding changed in your local manifest. This is the
|
|
|
336
336
|
`allowed-groups-change: true` label from a non-author human reviewer
|
|
337
337
|
(AC-S4) before it can auto-merge.
|
|
338
338
|
|
|
339
|
+
Reconcile it with **`launchpad deploy --apply`** — a plain
|
|
340
|
+
`launchpad deploy` ships content only and does **not** re-apply the
|
|
341
|
+
gateway's access policy. On a gateway app where enforcement is on, the
|
|
342
|
+
bot **refuses** a content deploy while the manifest's groups diverge
|
|
343
|
+
from what the gateway actually enforces (so access changes can't be
|
|
344
|
+
silently dropped); `--apply` is the gated route that reconciles the
|
|
345
|
+
enforced KV allow-list to the manifest. `launchpad status --strict`
|
|
346
|
+
exits non-zero on any drift, so it can gate CI.
|
|
347
|
+
|
|
339
348
|
## Related skills
|
|
340
349
|
|
|
341
350
|
- **`/launchpad-deploy`** — provision a new app (`launchpad init`
|