@m-kopa/launchpad-cli 0.75.1 → 0.76.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 CHANGED
@@ -6,6 +6,19 @@ 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.76.0 - 2026-10-15
10
+
11
+ ### Added
12
+
13
+ - The `launchpad-integration-contract` skill helps an app owner agree an approved integration's payload with the calling team before building it. It covers where the data lands next to existing rows, which fields the server sets, choosing the idempotency key, status codes for business rules, versioning by path, the allow-list request (including exact egress IPs) and the handoff note for the calling team.
14
+ - The `launchpad-ingest` skill now points to it when the data belongs in an existing table.
15
+
16
+ ## 0.75.2 - 2026-10-12
17
+
18
+ ### Fixed
19
+
20
+ - `launchpad envvars set KEY=value --secret` on a per-app-workspace app (this includes new dispatch apps) no longer stops at a dead-end HTTP 501 `per_app_env_var_edit_not_wired` that named an internal runbook (AIO-1070). The platform still makes no direct change there, because Terraform is the only writer for that app (ADR 0018). The CLI now prints the supported route: declare the name in `launchpad.yaml` under `spec.env_vars` with `type: secret_text` and a `secret_ref`, run `launchpad deploy`, then run `launchpad secrets push` (or `--env <file>`). A plain-text `set` or an `rm` prints the manifest and `launchpad deploy` step. The bot sends a `hint` field (`use_secrets_push` or `use_manifest_deploy`) so that an older CLI also shows a usable message.
21
+
9
22
  ## 0.75.1 - 2026-10-07
10
23
 
11
24
  ### Fixed
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.75.1";
22
+ var CLI_VERSION = "0.76.0";
23
23
 
24
24
  // src/config.ts
25
25
  import { readFileSync } from "node:fs";
@@ -75,6 +75,7 @@ function decodeErrorEnvelope(input, context) {
75
75
  const code = boundedOptionalString(body.code, "code", omissions) ?? legacyError ?? "api_error";
76
76
  const serverMessage = boundedOptionalString(body.message, "message", omissions);
77
77
  const reason = boundedOptionalString(body.reason, "reason", omissions);
78
+ const hint = boundedOptionalString(body.hint, "hint", omissions);
78
79
  const message = serverMessage ?? `bot returned HTTP ${context.status}`;
79
80
  const source = boundedOptionalString(body.source, "source", omissions);
80
81
  const sourceSha = nullableBoundedString(body.source_sha ?? body.sourceSha, "source_sha", omissions);
@@ -86,6 +87,7 @@ function decodeErrorEnvelope(input, context) {
86
87
  message,
87
88
  ...serverMessage === undefined ? {} : { serverMessage },
88
89
  ...reason === undefined ? {} : { reason },
90
+ ...hint === undefined ? {} : { hint },
89
91
  ...legacyError === undefined ? {} : { legacyError },
90
92
  ...source === undefined ? {} : { source },
91
93
  ...sourceSha === undefined ? {} : { sourceSha },
@@ -12123,6 +12125,12 @@ async function runEnvvars(args, io) {
12123
12125
  return 1;
12124
12126
  }
12125
12127
  if (e instanceof ApiError) {
12128
+ const steps = nextStepsFor(e);
12129
+ if (steps !== null) {
12130
+ for (const line of steps)
12131
+ io.err(line);
12132
+ return 1;
12133
+ }
12126
12134
  io.err(`launchpad envvars: ${e.message}`);
12127
12135
  return 1;
12128
12136
  }
@@ -12227,6 +12235,36 @@ function renderList(envVars, io) {
12227
12235
  io.out(fmt(row));
12228
12236
  }
12229
12237
  }
12238
+ function nextStepsFor(e) {
12239
+ if (e.code !== "per_app_env_var_edit_not_wired")
12240
+ return null;
12241
+ const hint = e.envelope.hint;
12242
+ if (hint === "use_secrets_push") {
12243
+ return [
12244
+ "launchpad envvars: this app does not take secret values through `envvars set`.",
12245
+ "Nothing was changed. Set the secret with `launchpad secrets push`:",
12246
+ " 1. In launchpad.yaml, declare the name under spec.env_vars:",
12247
+ " MY_SECRET:",
12248
+ " type: secret_text",
12249
+ " secret_ref: my-secret",
12250
+ " 2. Run `launchpad deploy`.",
12251
+ " 3. Put MY_SECRET=<value> in .env (or a separate file), then run",
12252
+ " `launchpad secrets push` (or `launchpad secrets push --env <file>`).",
12253
+ "secrets push sends only the secret_text names that launchpad.yaml declares.",
12254
+ "It skips other .env keys with a warning. It sends nothing if a declared",
12255
+ "secret has no value in the env file. A static app holds secrets only on",
12256
+ "a cron target (see `launchpad secrets push` in the docs)."
12257
+ ];
12258
+ }
12259
+ if (hint === "use_manifest_deploy") {
12260
+ return [
12261
+ "launchpad envvars: this app does not take env-var edits through `envvars`.",
12262
+ "Nothing was changed. Change the env var in launchpad.yaml under",
12263
+ "spec.env_vars (type: plain_text, value: ...), then run `launchpad deploy`."
12264
+ ];
12265
+ }
12266
+ return null;
12267
+ }
12230
12268
  function describe19(e) {
12231
12269
  return e instanceof Error ? e.message : String(e);
12232
12270
  }
@@ -16699,6 +16737,7 @@ var BUNDLED_SKILLS = [
16699
16737
  "launchpad-destroy",
16700
16738
  "launchpad-identity",
16701
16739
  "launchpad-ingest",
16740
+ "launchpad-integration-contract",
16702
16741
  "launchpad-report",
16703
16742
  "marquee-share"
16704
16743
  ];
@@ -1,3 +1,4 @@
1
+ import { ApiError } from "../http/errors.js";
1
2
  import type { CliIo, Command } from "../dispatcher.js";
2
3
  import { inferSlugFromCwd } from "./infer-slug.js";
3
4
  export { inferSlugFromCwd };
@@ -25,4 +26,11 @@ export declare function parseArgs(args: readonly string[]): EnvArgs | null;
25
26
  * `•••` (the bot never returns them, so this is what we have).
26
27
  */
27
28
  export declare function renderList(envVars: readonly EnvVarEntry[], io: CliIo): void;
29
+ /**
30
+ * AIO-1070: a per-app-workspace app answers a direct env-var edit with
31
+ * 501 `per_app_env_var_edit_not_wired` and a `hint`. Print the supported
32
+ * route instead of the raw bot message, so the user is not left at a
33
+ * dead end. Returns `null` for any other error.
34
+ */
35
+ export declare function nextStepsFor(e: ApiError): readonly string[] | null;
28
36
  //# sourceMappingURL=envvars.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"envvars.d.ts","sourceRoot":"","sources":["../../src/commands/envvars.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAY,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAa,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAI9D,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,cAAc,EAAE,OAI5B,CAAC;AAEF,UAAU,QAAQ;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AACD,UAAU,OAAO;IACf,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AACD,UAAU,MAAM;IACd,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AACD,KAAK,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAoH3C,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,GAAG,IAAI,CAqDjE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,EAAE,EAAE,KAAK,GACR,IAAI,CAqBN"}
1
+ {"version":3,"file":"envvars.d.ts","sourceRoot":"","sources":["../../src/commands/envvars.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,QAAQ,EAKT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAY,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAa,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAI9D,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,cAAc,EAAE,OAI5B,CAAC;AAEF,UAAU,QAAQ;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AACD,UAAU,OAAO;IACf,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AACD,UAAU,MAAM;IACd,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AACD,KAAK,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAyH3C,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,GAAG,IAAI,CAqDjE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,EAAE,EAAE,KAAK,GACR,IAAI,CAqBN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,CA4BlE"}
@@ -5,7 +5,7 @@ import type { Command } from "../dispatcher.js";
5
5
  * "bundled list matches the skills dir" test in `tests/skills-command.test.ts`
6
6
  * enforces this so a newly-added skill dir can't silently go un-installed.
7
7
  */
8
- export declare const BUNDLED_SKILLS: readonly ["launchpad-onboard", "launchpad-deploy", "launchpad-deploy-status", "launchpad-content-pr", "launchpad-status", "launchpad-destroy", "launchpad-identity", "launchpad-ingest", "launchpad-report", "marquee-share"];
8
+ export declare const BUNDLED_SKILLS: readonly ["launchpad-onboard", "launchpad-deploy", "launchpad-deploy-status", "launchpad-content-pr", "launchpad-status", "launchpad-destroy", "launchpad-identity", "launchpad-ingest", "launchpad-integration-contract", "launchpad-report", "marquee-share"];
9
9
  export declare const skillsCommand: Command;
10
10
  interface InstallEnv {
11
11
  readonly bundleDir: string;
@@ -1 +1 @@
1
- {"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AASjE;;;;;GAKG;AACH,eAAO,MAAM,cAAc,+NAejB,CAAC;AAcX,eAAO,MAAM,aAAa,EAAE,OAK3B,CAAC;AA2CF,UAAU,UAAU;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAQ9C"}
1
+ {"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AASjE;;;;;GAKG;AACH,eAAO,MAAM,cAAc,iQAgBjB,CAAC;AAcX,eAAO,MAAM,aAAa,EAAE,OAK3B,CAAC;AA2CF,UAAU,UAAU;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAQ9C"}
@@ -22,6 +22,8 @@ export interface StructuredErrorEnvelope {
22
22
  readonly serverMessage?: string;
23
23
  /** Machine-readable sub-code (e.g. `insufficient-role` on a 403), when sent. */
24
24
  readonly reason?: string;
25
+ /** Machine-readable next-step hint (e.g. `use_secrets_push`), when sent. */
26
+ readonly hint?: string;
25
27
  readonly legacyError?: string;
26
28
  readonly source?: string;
27
29
  readonly sourceSha?: string | null;
@@ -1 +1 @@
1
- {"version":3,"file":"error-envelope.d.ts","sourceRoot":"","sources":["../../src/http/error-envelope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,kBAAkB,GAC1B,uBAAuB,CA+CzB;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,uBAAuB,CAkBzB;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,CA8B7E;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,CAwB3E"}
1
+ {"version":3,"file":"error-envelope.d.ts","sourceRoot":"","sources":["../../src/http/error-envelope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,kBAAkB,GAC1B,uBAAuB,CAiDzB;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,uBAAuB,CAkBzB;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,CA8B7E;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,CAwB3E"}
package/dist/version.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const CLI_VERSION = "0.75.1";
1
+ export declare const CLI_VERSION = "0.76.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.75.1",
3
+ "version": "0.76.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": {
package/skills/README.md CHANGED
@@ -17,6 +17,7 @@ skills/
17
17
  ├── launchpad-destroy/SKILL.md
18
18
  ├── launchpad-identity/SKILL.md # dev / how-to-build skill (see below)
19
19
  ├── launchpad-ingest/SKILL.md # dev skill: verified ingest for approved integrations
20
+ ├── launchpad-integration-contract/SKILL.md # design skill: agree an integration payload + allow-list request
20
21
  └── marquee-share/ # vendored from M-KOPA/marquee, do
21
22
  # not hand-edit — managed by
22
23
  # scripts/sync-marquee-share-skill.sh
@@ -50,6 +51,11 @@ convention for this kind:
50
51
  run by `tests/skill-ingest-extraction.test.ts`, so the code an author copies is
51
52
  the code that was tested.
52
53
 
54
+ `launchpad-integration-contract` is a **design skill**: it helps the author agree a
55
+ payload with another team, so its SQL and bash blocks are illustrations, not code
56
+ lifted from a deployed app. It has no extraction test; the runnable handler stays
57
+ in `launchpad-ingest`, which is pinned.
58
+
53
59
  ## Cross-platform shell contract
54
60
 
55
61
  Claude Code's `Bash` tool **always** runs `bash`, on every OS — on
@@ -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.75.1
4
+ version: 0.76.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-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.75.1
4
+ version: 0.76.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-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.75.1
4
+ version: 0.76.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-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.75.1
4
+ version: 0.76.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.75.1
4
+ version: 0.76.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-ingest
3
3
  description: Scaffold a verified ingest endpoint so an approved backend (an approved integration, ADR 0060) can write into a Launchpad react+api app - declare the integration in launchpad.yaml, add a Hono route registered ahead of the user-auth middleware that verifies the gateway's X-Launchpad-Integration-Assertion with @m-kopa/platform-auth, validates the body with zod, and does an idempotent D1 insert keyed on a caller-supplied idempotency key. Use when someone says "let another system push data into my app", "add an ingest endpoint", "receive data from the Sales backend", "approved integration", "machine-to-machine write", "/launchpad-ingest", or asks what a calling team must send.
4
- version: 0.75.1
4
+ version: 0.76.0
5
5
  ---
6
6
 
7
7
  <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
@@ -63,6 +63,8 @@ integrations:
63
63
 
64
64
  ## Step 2 - create the table
65
65
 
66
+ If the data has to sit next to rows your users already write, add columns to that table instead; `/launchpad-integration-contract` Step 1 shows how.
67
+ This fresh table is for data no existing screen reads.
66
68
  The idempotency key is the primary key, so a replayed request can never add a second row.
67
69
  Add this as a D1 migration (for example `migrations/0001_stock_counts.sql`).
68
70
 
@@ -236,7 +238,7 @@ If you genuinely cannot (for example a build-less app with no `package.json`), y
236
238
  |---|---|
237
239
  | signature | RS256 against the gateway JWKS (`https://auth.launchpad.m-kopa.us/.well-known/jwks.json`). No other algorithm. |
238
240
  | `iss` | `GATEWAY_ISSUER` (`https://auth.launchpad.m-kopa.us`) |
239
- | `aud` | `"integration:" + GATEWAY_AUD`, for example `integration:wh-count.launchpad.m-kopa.us` |
241
+ | `aud` | `"integration:" + GATEWAY_AUD`, for example `integration:shelf-check.launchpad.m-kopa.us` |
240
242
  | `typ` | `launchpad-integration` |
241
243
  | `sub` | starts with `integration:`; the rest is the integration name, which must be yours |
242
244
  | `htm` | the request method, upper case |
@@ -263,6 +265,7 @@ Hand the calling team this contract:
263
265
  - **Never retry other `4xx`.**
264
266
  `401` means a wrong, revoked or unapproved key or route; `403` means a wrong integration or a blocked IP; `400` means a bad body.
265
267
  Retrying won't fix any of them.
268
+ The one exception is a `409` the contract names as resendable later, such as a closed window; see `/launchpad-integration-contract` Step 4.
266
269
 
267
270
  ## Checklist before you ship
268
271
 
@@ -0,0 +1,276 @@
1
+ ---
2
+ name: launchpad-integration-contract
3
+ description: Design the payload contract for an approved integration (ADR 0060) before anyone writes code - which fields the calling backend sends, which the app sets itself, the idempotency key, how the data lands next to what users already enter, business rules like submission windows, versioning, the allow-list request to the platform team, and the handoff note for the calling team. Use when someone says "design the webhook payload", "what should the other team send us", "agree the contract", "set up the integration with <team>", "what does the platform need to approve this", "allow-list", "/launchpad-integration-contract", or before running /launchpad-ingest on an app that already has its own data.
4
+ version: 0.76.0
5
+ ---
6
+
7
+ <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
8
+ ## Shell contract — read this first
9
+
10
+ Every fenced `bash` block below MUST be sent to the `Bash` tool **verbatim**.
11
+ Do not rewrite into PowerShell, cmd, zsh-isms, or "equivalent" forms.
12
+
13
+ - macOS / Linux: the `Bash` tool runs system bash.
14
+ - Windows: the `Bash` tool runs Git for Windows (MSYS) bash. `$HOME`,
15
+ forward slashes, `test -f`, `command -v`, heredocs, and `[[ … ]]` all
16
+ work. There is no reason to translate to `Test-Path`, `$env:USERPROFILE`,
17
+ `Get-Content`, `Where-Object`, `Get-ChildItem`, or backslash paths —
18
+ doing so will fail with `/usr/bin/bash: syntax error`.
19
+
20
+ If a step genuinely needs OS branching, branch *inside* bash:
21
+
22
+ ```bash
23
+ case "$(uname -s)" in
24
+ Darwin) : ;;
25
+ Linux) : ;;
26
+ MINGW*|MSYS*|CYGWIN*) : ;;
27
+ esac
28
+ ```
29
+ <!-- END shell-contract -->
30
+
31
+ # /launchpad-integration-contract
32
+
33
+ How to agree what an approved backend sends into a Launchpad app, before anyone builds the endpoint.
34
+
35
+ This is a **design** skill.
36
+ It produces three short documents: the payload contract, the allow-list request for the platform team, and the handoff note for the calling team.
37
+ `/launchpad-ingest` builds the endpoint afterwards.
38
+
39
+ ## How the pieces fit
40
+
41
+ - The **calling team** sends `Authorization: Bearer lpi_...` to one exact route on your app.
42
+ - The **gateway** checks the key, the route and the method against the platform's allow-list (`terraform/envs/prod/integrations.json`), and optionally the caller's IP.
43
+ On a match it strips the key and forwards a signed `X-Launchpad-Integration-Assertion`.
44
+ - **Your handler** verifies that assertion, validates the body and writes.
45
+
46
+ The contract is the part only you and the calling team can decide.
47
+ Everything else is mechanical.
48
+
49
+ ## Step 1 - start from the data you already have
50
+
51
+ Read the app's schema and the code that writes it today before proposing a single field.
52
+ If the machine data has to be counted, reported or exported next to what users enter by hand, write it into the **same table** with a column that says where each row came from.
53
+ A side table means every report, export and dashboard needs a second query, and someone forgets one.
54
+
55
+ Use a fresh table only when the machine data is a different kind of thing that no existing screen reads.
56
+ That is the case `/launchpad-ingest` scaffolds.
57
+
58
+ For an existing table, the change is additive:
59
+
60
+ ```sql
61
+ ALTER TABLE shelf_check ADD COLUMN idempotency_key TEXT;
62
+ ALTER TABLE shelf_check ADD COLUMN source TEXT;
63
+ CREATE UNIQUE INDEX IF NOT EXISTS shelf_check_idempotency_key ON shelf_check (idempotency_key);
64
+ ```
65
+
66
+ SQLite allows many `NULL`s under a unique index, so rows your users already wrote are untouched.
67
+ The insert then uses `ON CONFLICT(idempotency_key) DO NOTHING`.
68
+
69
+ ## Step 2 - split the fields: caller-set and server-set
70
+
71
+ Go through every column and put it in one of two lists.
72
+
73
+ **Server-set** fields come from the verified assertion or the server, never from the body:
74
+
75
+ - Who or what wrote the row (`source`, `checked_by`, `role`).
76
+ Set it from the verified integration name, for example `integration:routes-backend`.
77
+ - Received-at timestamps, row IDs, anything derived from your own lookups.
78
+
79
+ **Caller-set** fields are the facts only the caller knows: the item, who did it, when it happened, where.
80
+
81
+ If a field is used for attribution or permissions, it is server-set.
82
+ A body field is whatever the caller typed, so a caller-set `role: admin` is a bug waiting to happen.
83
+ This is the same rule the user path follows when it reads the user from `X-Launchpad-User-Assertion` instead of a form field.
84
+
85
+ ## Step 3 - pick the idempotency key
86
+
87
+ Every record carries an `idempotency_key`.
88
+ A retry with the same key returns `200` with `"duplicate": true` and writes nothing.
89
+
90
+ Choose with the calling team which of these it is, and write it down:
91
+
92
+ | Key | Use when | Effect |
93
+ |---|---|---|
94
+ | The caller's own record ID | The caller stores each event with a stable ID | Two genuine events about the same thing are two rows. |
95
+ | A natural key, such as `<sku>:<store_id>:<audit_week>` | There must only ever be one row per thing per period | A second, different event for the same thing is silently treated as a duplicate. |
96
+
97
+ The natural key is the one that bites.
98
+ If a driver can legitimately check the same shelf twice in a week, it drops the second check.
99
+ When unsure, use the caller's record ID and dedupe in reporting.
100
+
101
+ Never let the server generate the key.
102
+ The whole point is that the caller's retry sends the same value.
103
+
104
+ A key names one immutable record.
105
+ A resend with the same key and a different body is still answered as a duplicate, so the change is lost.
106
+ Tell the caller to send a correction under a new key, or agree a separate correction route.
107
+
108
+ ## Step 4 - business rules on the machine path
109
+
110
+ List every rule the user path enforces: submission windows, location limits, format checks, role checks.
111
+ For each one, decide whether the machine path follows it too, and what the caller sees.
112
+
113
+ The calling team is told to retry `429` and `5xx` and never retry other `4xx`, except where the contract names one.
114
+ So every refusal needs one of these, chosen on purpose:
115
+
116
+ - **`400`** for a body the caller must fix. Never retried.
117
+ - **`409`** with a clear `error` code for "valid, but not now", such as a closed audit week.
118
+ This is the one `4xx` a contract may name as resendable: never straight away, only once the condition has cleared and only if the handoff says so.
119
+ Spell out in the handoff when to resend (for example "hold it and resend once the next audit week opens") or that the record is dropped.
120
+ - **`200`** with a per-record status, when it is a batch and some records are refused.
121
+
122
+ Don't reuse `401` or `403` for business rules.
123
+ Those mean "wrong key" and "wrong integration or IP" to the caller and to whoever is on call.
124
+
125
+ ## Step 5 - shape the body
126
+
127
+ - **One record or a batch.** One record per request is the simplest contract and the default.
128
+ Ask for a batch only if the caller sends hundreds a minute.
129
+ The gateway rate-limits each integration and answers `429` above its ceiling.
130
+ A batch response must give a status per record, keyed by `idempotency_key`.
131
+ - **Timestamps** are ISO 8601 in UTC with a `Z`, for example `2026-10-07T09:00:00Z`.
132
+ If the table splits date and time into separate columns, the server does the split, so the caller sends one field.
133
+ - **Strict validation.** Reject unknown fields (`.strict()` in zod).
134
+ A typo then fails loudly instead of being dropped.
135
+ Give each field a type, a max length and a format where one exists.
136
+ - **No secrets and no more personal data than the app needs.** If the app doesn't show it, don't ask for it.
137
+ - **Name fields after your columns** where you can, so the handler is a straight copy.
138
+
139
+ ## Step 6 - versioning
140
+
141
+ The allow-list is exact: one host, one path, a fixed set of methods.
142
+ If you change the path or the methods in `launchpad.yaml`, the integration drops to `pending` and the gateway answers `401` until the platform approves the new values.
143
+
144
+ So:
145
+
146
+ - **Adding an optional field** is safe on the same route.
147
+ - **Removing a field, making one required, or changing its meaning** is a new route under a new integration name, such as `routes-backend-v2` on `/api/ingest/shelf-check-v2`.
148
+ Each integration has exactly one path and names are unique, so declare it next to the old one and get it approved with its own key.
149
+ Retire the old integration once the caller has moved.
150
+
151
+ ## Step 7 - the allow-list request
152
+
153
+ Send this to the platform team with `/launchpad-report`, once the contract is agreed:
154
+
155
+ ```text
156
+ App: <slug>.launchpad.m-kopa.us
157
+ Integration name: routes-backend
158
+ Path: /api/ingest/shelf-check
159
+ Methods: POST
160
+ Calling team: <team and a named contact>
161
+ Fixed egress IPs: <exact addresses, or "none">
162
+ Contract: <link to the agreed contract>
163
+ ```
164
+
165
+ The platform team adds the entry to `terraform/envs/prod/integrations.json` in a reviewed PR and mints the key.
166
+ The key goes straight to the calling team's secret store.
167
+ The app owner never holds it.
168
+
169
+ **IPs** are optional and must be exact IPv4 or IPv6 addresses.
170
+ CIDR ranges are refused.
171
+ With IPs set, a request from anywhere else gets `403 ip_not_allowed` even with the right key.
172
+ Ask the calling team early whether their outbound traffic leaves through fixed addresses, such as an Azure NAT gateway or firewall.
173
+ If it doesn't, skip the IP list rather than guessing.
174
+
175
+ ## Step 8 - the handoff note for the calling team
176
+
177
+ Keep it to one screen.
178
+ Never put a key in it.
179
+
180
+ ```text
181
+ Endpoint
182
+ POST https://<slug>.launchpad.m-kopa.us/api/ingest/shelf-check
183
+ Headers
184
+ Authorization: Bearer <key from your Key Vault>
185
+ Content-Type: application/json
186
+ Body
187
+ { "idempotency_key": "...", ...agreed fields... }
188
+ Unknown fields are refused. Timestamps are UTC ISO 8601.
189
+ idempotency_key
190
+ <what it is, from Step 3>. Send the same value on every retry.
191
+ Responses (one record per request; a batch route lists these per idempotency_key)
192
+ 200 {"ok":true,"duplicate":false} stored
193
+ 200 {"ok":true,"duplicate":true} already stored, nothing written
194
+ 400 bad body; the response lists the bad fields. Fix, don't retry.
195
+ 401 wrong key, path or method. Don't retry.
196
+ 403 wrong integration or IP not allowed. Don't retry.
197
+ 409 <your business-rule refusals, and whether to resend later or drop>
198
+ 429 / 5xx retry with exponential backoff and jitter.
199
+ Before go-live
200
+ Check your backend can reach *.launchpad.m-kopa.us from where it runs.
201
+ Tell us if outbound traffic uses fixed IPs.
202
+ ```
203
+
204
+ ## Step 9 - prove it live
205
+
206
+ Once the endpoint is deployed and approved, run each case against the real host.
207
+ The app owner never holds the key, so the calling team runs these (or a platform admin with a test key).
208
+ They share the response bodies with the key redacted, because checks 1 and 2 both return `200` and only the body shows `duplicate: false` then `duplicate: true`.
209
+ Fill in the values first; the block stops if any is missing.
210
+ `BODY` must be a valid record for your contract, with a fresh `idempotency_key` on every run.
211
+
212
+ ```bash
213
+ HOST="${HOST:?set HOST, for example https://<slug>.launchpad.m-kopa.us}"
214
+ ROUTE="${ROUTE:?set ROUTE, for example /api/ingest/shelf-check}"
215
+ KEY_FILE="${KEY_FILE:?set KEY_FILE to the path of the key file}"
216
+ BODY="${BODY:?set BODY to a valid test record with a fresh idempotency_key}"
217
+
218
+ # Only ever send the key to a Launchpad host over HTTPS.
219
+ case "$HOST" in
220
+ https://*/*|https://*@*|https://*:*) echo "HOST must be a bare https://<slug>.launchpad.m-kopa.us" >&2; exit 1 ;;
221
+ https://*.launchpad.m-kopa.us) : ;;
222
+ *) echo "HOST must be https://<slug>.launchpad.m-kopa.us" >&2; exit 1 ;;
223
+ esac
224
+
225
+ # The key goes in a 0600 header file so it never shows up in the process list,
226
+ # and the trap removes it even if a check fails or is interrupted.
227
+ AUTH="$(mktemp)"
228
+ trap 'rm -f "$AUTH"' EXIT
229
+ chmod 600 "$AUTH"
230
+ printf 'Authorization: Bearer %s\n' "$(cat "$KEY_FILE")" > "$AUTH"
231
+
232
+ # 1. stored: 200, duplicate false
233
+ curl -sS -X POST "$HOST$ROUTE" -H @"$AUTH" -H "Content-Type: application/json" -d "$BODY"
234
+ # 2. replay: 200, duplicate true
235
+ curl -sS -X POST "$HOST$ROUTE" -H @"$AUTH" -H "Content-Type: application/json" -d "$BODY"
236
+ # 3. bad body: 400, and the body lists the bad fields
237
+ curl -sS -w '\n%{http_code}\n' -X POST "$HOST$ROUTE" -H @"$AUTH" -H "Content-Type: application/json" -d '{}'
238
+ # 4. wrong path: 401
239
+ curl -sS -o /dev/null -w '%{http_code}\n' -X POST "$HOST$ROUTE-nope" -H @"$AUTH" -H "Content-Type: application/json" -d "$BODY"
240
+ ```
241
+
242
+ Delete the test rows afterwards, or agree a test SKU the app's reports ignore.
243
+
244
+ ## Worked example - shelf checks from delivery drivers
245
+
246
+ This app is made up.
247
+ `shelf-check` lets store staff record shelf checks in the browser, into `shelf_check`.
248
+ Delivery drivers also check shelves on their rounds, but they won't sign in to the app.
249
+ Their checks come from the drivers' mobile app, through the routing team's backend, into the same app.
250
+
251
+ - **Same table.** Driver checks must sit next to staff checks in every export, so they go into `shelf_check` with new `idempotency_key` and `source` columns (Step 1).
252
+ - **Server-set:** `source = integration:routes-backend`, `role = driver`, `checked_by = integration:routes-backend`.
253
+ - **Caller-set:** `sku`, `store_id`, `driver_id`, `audit_week`, `checked_at` (the server splits it into `check_date` and `check_time`), plus optional `gps` and `shelf_state`.
254
+ On the browser path the checker comes from the signed-in user.
255
+ Here the driver is not the caller, so `driver_id` is a body field the backend vouches for, and `checked_by` still records which integration sent it.
256
+ If the app keeps a driver roster, check `driver_id` against it and refuse unknown IDs with `400`.
257
+ - **Open questions for the owner:** whether a closed audit week refuses driver checks with `409 audit_week_closed` or accepts them late.
258
+ - **Key:** the routing backend's own check record ID, because a driver may check the same SKU twice in a week.
259
+
260
+ ## Checklist
261
+
262
+ - [ ] The contract names every field, says who sets it, and gives its type and format.
263
+ - [ ] Attribution and permission fields are server-set.
264
+ - [ ] The idempotency key is agreed and written down, with what a duplicate means.
265
+ - [ ] Every business rule has a status code and a retry instruction.
266
+ - [ ] The path is final. Changing it later means a new approval.
267
+ - [ ] The allow-list request is filed, with exact IPs or "none".
268
+ - [ ] The handoff note has no key in it.
269
+ - [ ] The four live checks pass against the real host.
270
+
271
+ ## Related
272
+
273
+ - `/launchpad-ingest` - build the verified endpoint once the contract is agreed.
274
+ - `/launchpad-report` - file the allow-list request.
275
+ - ADR 0060 - the trust model, approval by reviewed PR, and revoke latency.
276
+ - [Manifest reference: integrations](https://get.launchpad.m-kopa.us/manifest/#integrations-machine-callers).
@@ -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.75.1
4
+ version: 0.76.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.75.1
4
+ version: 0.76.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.75.1
4
+ version: 0.76.0
5
5
  ---
6
6
 
7
7
  <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->