@m-kopa/launchpad-cli 0.77.0 → 0.79.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 +21 -0
- package/dist/cli.js +1444 -254
- package/dist/commands/deploy-flags.d.ts +2 -0
- package/dist/commands/deploy-flags.d.ts.map +1 -1
- package/dist/commands/deploy.d.ts.map +1 -1
- package/dist/commands/destroy.d.ts +36 -0
- package/dist/commands/destroy.d.ts.map +1 -1
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/skills.d.ts +1 -1
- package/dist/commands/skills.d.ts.map +1 -1
- package/dist/commands/status.d.ts +13 -1
- package/dist/commands/status.d.ts.map +1 -1
- package/dist/deploy/preflight.d.ts +134 -0
- package/dist/deploy/preflight.d.ts.map +1 -0
- package/dist/deploy/verify-deploy.d.ts.map +1 -1
- package/dist/destroy-failure.d.ts +23 -0
- package/dist/destroy-failure.d.ts.map +1 -0
- package/dist/scaffold/react-api-starter-files.d.ts +7 -0
- package/dist/scaffold/react-api-starter-files.d.ts.map +1 -0
- package/dist/scaffold/react-api-starter.d.ts +26 -0
- package/dist/scaffold/react-api-starter.d.ts.map +1 -0
- package/dist/version.d.ts +1 -1
- package/package.json +1 -1
- package/skills/README.md +1 -0
- package/skills/launchpad-content-pr/SKILL.md +1 -1
- package/skills/launchpad-deploy/SKILL.md +159 -73
- package/skills/launchpad-deploy-status/SKILL.md +39 -22
- package/skills/launchpad-destroy/SKILL.md +20 -13
- package/skills/launchpad-fix-findings/SKILL.md +218 -0
- package/skills/launchpad-identity/SKILL.md +82 -2
- package/skills/launchpad-ingest/SKILL.md +1 -1
- package/skills/launchpad-integration-contract/SKILL.md +1 -1
- package/skills/launchpad-onboard/SKILL.md +2 -2
- package/skills/launchpad-report/SKILL.md +1 -1
- package/skills/launchpad-status/SKILL.md +6 -5
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: launchpad-fix-findings
|
|
3
|
+
description: Help an app owner fix security findings that AIOps sent for their Launchpad app, one at a time, and put the fixed app live. Checks the caller's role with `launchpad apps`, takes a fresh `launchpad clone`, explains each finding in plain words and asks yes or no before changing anything, makes the smallest fix per finding kind (published data files, routes with no server-side sign-in check, writes open to everyone, keys in code, open AI or service proxies), tests, deploys with `launchpad deploy`, confirms with `launchpad status`, and writes a summary the owner sends to AIOps. Use when someone says "fix the security findings", "AIOps sent me findings", "fix my app's security issues", "/launchpad-fix-findings", or pastes a findings note for an app.
|
|
4
|
+
version: 0.79.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-fix-findings
|
|
32
|
+
|
|
33
|
+
The owner pastes the findings AIOps sent for one app. Fix them safely, one
|
|
34
|
+
at a time, and put the fixed app live. The owner decides; you explain and ask.
|
|
35
|
+
|
|
36
|
+
Ask the owner for three things if they did not give them: the app's slug on
|
|
37
|
+
Launchpad, the commit AIOps scanned (if the note gives one), and the findings
|
|
38
|
+
text ("What we found", "Steps to fix", "Also seen").
|
|
39
|
+
|
|
40
|
+
## Stop and ask the owner
|
|
41
|
+
|
|
42
|
+
Stop and ask before you would: delete data or a data file; change who can open
|
|
43
|
+
the app; turn the app off; use a group name or ID, or a list of devices or
|
|
44
|
+
systems, that the findings do not give; use any flag that skips a check; or
|
|
45
|
+
make any change you are not sure is safe. If the app is no longer needed, say
|
|
46
|
+
so: the owner asks AIOps to retire it.
|
|
47
|
+
|
|
48
|
+
## 1. Set up
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
launchpad --version
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
If it is older than the version in this skill's frontmatter, run `launchpad
|
|
55
|
+
update`, then `launchpad --version` again: right after a release, `update` can
|
|
56
|
+
report success and leave the old version in place. Use `/launchpad-onboard` if
|
|
57
|
+
any command fails on sign-in or setup.
|
|
58
|
+
|
|
59
|
+
Check that the owner may work on this app:
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
launchpad apps
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
The app must be in the list with ROLE `owner` or `editor`. If it is not, or if
|
|
66
|
+
any command later says the caller has no role or is not authorised, **stop**:
|
|
67
|
+
tell the owner to ask AIOps for access. Do not look for another copy of the
|
|
68
|
+
app and do not try to give anyone a role.
|
|
69
|
+
|
|
70
|
+
Take a fresh copy. Make a new empty folder, then clone inside it; the clone
|
|
71
|
+
makes its own sub-folder `launchpad-app-<slug>`, and you work only there:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
mkdir -p "$HOME/launchpad-fix-<slug>"
|
|
75
|
+
cd "$HOME/launchpad-fix-<slug>"
|
|
76
|
+
launchpad clone <slug>
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Do not use an old copy on the computer: a deploy from a folder without a
|
|
80
|
+
trusted baseline is refused. If the findings name a commit, compare it with
|
|
81
|
+
the `Base revision` that `launchpad clone` printed (also stored in
|
|
82
|
+
`launchpad-app-<slug>/.launchpad/base-sha`) and say whether they match. If
|
|
83
|
+
the note gives no commit, say so and work from the clone as it is. Read the
|
|
84
|
+
files as the clone wrote them; line numbers in the note may have drifted, so
|
|
85
|
+
find the code the note describes rather than trusting a line number.
|
|
86
|
+
|
|
87
|
+
Read `launchpad.yaml` to learn the app shape (`static`, `react`, `react+api`,
|
|
88
|
+
`container`) and the audience (`allowed_entra_group(s)`). A v2 manifest says
|
|
89
|
+
`spec.origin: dispatch` for Workers dispatch; a v1 manifest, or a v2 one
|
|
90
|
+
without it, means a legacy Pages app; a container has no origin field.
|
|
91
|
+
|
|
92
|
+
## 2. Explain before you change
|
|
93
|
+
|
|
94
|
+
For each finding, read the code it points to. Then tell the owner, in plain
|
|
95
|
+
words and briefly:
|
|
96
|
+
|
|
97
|
+
- what the problem is;
|
|
98
|
+
- who could see or change what today;
|
|
99
|
+
- what you plan to change;
|
|
100
|
+
- if the finding no longer matches the code, say so;
|
|
101
|
+
- if you found the same problem in more places than the note lists, list them.
|
|
102
|
+
|
|
103
|
+
Re-scan for each finding kind across every folder of the clone except
|
|
104
|
+
`node_modules/` and `.git/`, including scripts, sub-apps and workflow files: a
|
|
105
|
+
note can list fewer files than the code has. Never print a password, key or row of people's data
|
|
106
|
+
in the chat; name the file and line only.
|
|
107
|
+
|
|
108
|
+
Then list what is missing, as plain items the owner must get from AIOps
|
|
109
|
+
before that part can ship: for example a group ID, the live value of a
|
|
110
|
+
setting, or who runs a job that calls the app. Say which fixes can go ahead
|
|
111
|
+
without them. Do not ask the owner technical questions they cannot answer.
|
|
112
|
+
|
|
113
|
+
End with one question and wait: **"Shall I make these changes?"** Change
|
|
114
|
+
nothing before the owner says yes.
|
|
115
|
+
|
|
116
|
+
## 3. Fix each finding with the smallest change
|
|
117
|
+
|
|
118
|
+
Follow §"Build it safe" in `/launchpad-deploy` and the patterns in
|
|
119
|
+
`/launchpad-identity`. Per finding kind:
|
|
120
|
+
|
|
121
|
+
- **A data file with people's details is published with the app.** Take it
|
|
122
|
+
out of what the app publishes (`public/`, `static/`, `dist/`, the bundle).
|
|
123
|
+
If the app needs the data, load it from a store behind a route that checks
|
|
124
|
+
the signed-in user. Ask before you delete any data file.
|
|
125
|
+
- **A route returns or changes data without a check.** Make every such route
|
|
126
|
+
check the signed-in user on the server. A check in the page or the browser is
|
|
127
|
+
not enough.
|
|
128
|
+
- `react+api` (Pages or dispatch): verify `X-Launchpad-User-Assertion` with
|
|
129
|
+
`@m-kopa/platform-auth` in a middleware before the routes
|
|
130
|
+
(`/launchpad-identity`).
|
|
131
|
+
- Container: **read how the app already gets the signed-in user first**
|
|
132
|
+
(search for `X-User-`, `x-user-`, `identity`, `auth`). The platform sends
|
|
133
|
+
`X-User-Sub`, `X-User-Email` and, when present, `X-User-Groups`. If the app
|
|
134
|
+
already has a function that reads these, use it and extend it (for
|
|
135
|
+
example to read `X-User-Groups` for a group check); do not add a second
|
|
136
|
+
reader beside it. Exempt the
|
|
137
|
+
`containers[].healthcheck` path and any path the Dockerfile `HEALTHCHECK`
|
|
138
|
+
calls. If the app gates the headers on its own setting, say which setting
|
|
139
|
+
and that it must be on live; ask AIOps to confirm, because you cannot see
|
|
140
|
+
live values.
|
|
141
|
+
- Find every caller with no user session (health checks, scheduled jobs,
|
|
142
|
+
other systems) and keep them working. If the code does not show who calls
|
|
143
|
+
a route, list it as a question for AIOps (step 2), not for the owner.
|
|
144
|
+
- **Anyone signed in can change or delete data.** Add a server-side group
|
|
145
|
+
check before every write (`/launchpad-identity` § "Only this group may
|
|
146
|
+
write"). It needs the exact Entra group ID. **Never guess a group name or
|
|
147
|
+
ID.** If the findings do not give it, tell the owner what to ask AIOps for
|
|
148
|
+
(the group name and its ID, and confirmation that the group is in the
|
|
149
|
+
sign-in token), and do not deploy that fix until you have it. Check a value
|
|
150
|
+
you were given with `launchpad groups show <name>`. Hold the ID as a
|
|
151
|
+
setting declared in `launchpad.yaml`, never as a guess in code.
|
|
152
|
+
- **A password or key is in the code.** Remove it from the code, tell the
|
|
153
|
+
owner they must replace (rotate) it with the service that issued it, and
|
|
154
|
+
store the new value as a Launchpad secret: declare the name in
|
|
155
|
+
`launchpad.yaml` and set it with `launchpad secrets push`
|
|
156
|
+
(`/launchpad-deploy` §A.4). Never put a password or key in the chat, a file
|
|
157
|
+
you write, or a commit message. A secret already in git history needs
|
|
158
|
+
AIOps; say so in the summary.
|
|
159
|
+
- **A route forwards any request to an AI or another service with the app's
|
|
160
|
+
key.** Limit it to what the app needs: fixed model, fixed size limits, fixed
|
|
161
|
+
destination, chosen in server code. Require a signed-in user.
|
|
162
|
+
- **Too many people can open the app.** Do **not** change the audience
|
|
163
|
+
(`allowed_entra_group(s)`), even if the note says to narrow it. Say what you
|
|
164
|
+
recommend; the owner and AIOps decide together.
|
|
165
|
+
|
|
166
|
+
No other changes: no redesign, no new features, no tidy-up of code that works.
|
|
167
|
+
|
|
168
|
+
## 4. Test before you deploy
|
|
169
|
+
|
|
170
|
+
Run the app's own checks (install, lint, type check, tests, build). Use the
|
|
171
|
+
lock file the app already has:
|
|
172
|
+
|
|
173
|
+
- `bun.lock`: `npx --yes bun@1.3.4 install` (the platform builds with bun 1.3.4);
|
|
174
|
+
- `package-lock.json`: `npm ci`.
|
|
175
|
+
|
|
176
|
+
If the app has separate parts, install only the part you changed. Do not build
|
|
177
|
+
or run a container image. If a check cannot run here (it needs a database or a
|
|
178
|
+
secret the owner does not have), say which check and why; never skip it
|
|
179
|
+
silently and never invent data that looks like real people. Test the changed
|
|
180
|
+
code in the smallest way you can instead.
|
|
181
|
+
|
|
182
|
+
For each fix, show that the old behaviour is gone: for example, a request with
|
|
183
|
+
no signed-in user gets 401, a user outside the group gets 403 on a write, a
|
|
184
|
+
forged `X-User-*` header on a non-container app is ignored.
|
|
185
|
+
|
|
186
|
+
Then run the platform checks from `/launchpad-deploy` §A.4:
|
|
187
|
+
`launchpad validate --app-lints` and the data-file check. Show any finding.
|
|
188
|
+
|
|
189
|
+
## 5. Deploy and confirm
|
|
190
|
+
|
|
191
|
+
```bash
|
|
192
|
+
launchpad deploy
|
|
193
|
+
launchpad status <slug>
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
If the deploy is refused, show the message exactly and follow it. Do not use a
|
|
197
|
+
flag that skips a check (for example `--allow-unguarded` or
|
|
198
|
+
`--allow-preflight-failure`) without asking first. Confirm with `launchpad
|
|
199
|
+
status <slug>` that the new commit is live; for a dispatch app,
|
|
200
|
+
`v2 delivery: state delivered`.
|
|
201
|
+
|
|
202
|
+
## 6. Summary for AIOps
|
|
203
|
+
|
|
204
|
+
When the app is live, write a short summary the owner sends to AIOps
|
|
205
|
+
themselves: each finding, what you changed, how you tested it, and anything
|
|
206
|
+
you could not fix and why (for example a group ID still needed, or a secret
|
|
207
|
+
in git history). Plain words, no passwords, no keys, no people's details. The
|
|
208
|
+
owner deploys and reports; AIOps then checks the live app.
|
|
209
|
+
|
|
210
|
+
## Don'ts
|
|
211
|
+
|
|
212
|
+
- Do **not** start without an `owner` or `editor` role from `launchpad apps`.
|
|
213
|
+
- Do **not** work in an old copy of the app; use the fresh clone.
|
|
214
|
+
- Do **not** change the app's audience, delete data, or turn the app off
|
|
215
|
+
without the owner's explicit yes.
|
|
216
|
+
- Do **not** guess a group name or ID.
|
|
217
|
+
- Do **not** build or run a container image locally.
|
|
218
|
+
- Do **not** send any message to anyone; the owner sends the summary.
|
|
@@ -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.79.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -263,9 +263,89 @@ Container apps behind the gateway (AIO-811) get the same signed-in identity. The
|
|
|
263
263
|
- **The container Worker verifies the assertion for you.** The generated `container-worker.ts` reads `X-Launchpad-User-Assertion`, verifies it with `@m-kopa/platform-auth` against `GATEWAY_ISSUER`, `GATEWAY_AUD` and `GATEWAY_JWKS_URL`, and returns 401 if it is missing or invalid. It is the only gate, because the container has no public hostname and no Cloudflare Access app.
|
|
264
264
|
- **Your container process receives plain headers after that check:** `X-User-Sub` (Entra `oid`) and `X-User-Email` (tenant UPN), plus `X-User-Groups` when groups are present. Inbound `X-User-*` headers are stripped before the Worker sets its own, so a client cannot forge them.
|
|
265
265
|
- **Do not re-verify in the container unless you need to.** The raw assertion is checked at the container Worker and your process sees only the `X-User-*` headers.
|
|
266
|
-
-
|
|
266
|
+
- Who may open the app is set by `access.allowed_entra_group`. A route that returns or changes data still checks `X-User-Sub` itself, and a write also checks the group (§ Safe patterns per app shape).
|
|
267
267
|
- The legacy `auth: access` container mode (Cloudflare Access JWT, `CF_ACCESS_*`) still works for existing apps but is limited by the Zero Trust seat cap. New container apps should use `auth: gateway`.
|
|
268
268
|
|
|
269
|
+
## Safe patterns per app shape
|
|
270
|
+
|
|
271
|
+
| App shape | What your server code reads | How to trust it |
|
|
272
|
+
|---|---|---|
|
|
273
|
+
| Pages or dispatch `react+api` (and a legacy Pages app with Functions) | `X-Launchpad-User-Assertion` | Verify it with `@m-kopa/platform-auth` (above). Never read `X-User-*` here: the gateway strips client copies and nothing sets them for these apps, and anyone who reaches a Pages origin directly can send any header. |
|
|
274
|
+
| Dispatch `static` or `react` | nothing (no server code) | No route check is possible. Limit who opens the whole app with `access.allowed_entra_group(s)`. |
|
|
275
|
+
| `type: container` (`auth: gateway` or `auth: access`) | `X-User-Sub`, `X-User-Email`, `X-User-Groups` | The generated container Worker verifies the token, deletes any client `X-User-*`, then sets these. Trust them inside the container only. |
|
|
276
|
+
|
|
277
|
+
Rules for every shape:
|
|
278
|
+
|
|
279
|
+
- Run the check in server middleware before the routes. No verified user:
|
|
280
|
+
**401**. Verified user in the wrong group: **403**.
|
|
281
|
+
- **Container: exempt the health path.** The platform health probe calls the
|
|
282
|
+
manifest's `containers[].healthcheck` path with no user headers, so a check
|
|
283
|
+
on that path marks the app unhealthy. Exempt any path your own Dockerfile
|
|
284
|
+
`HEALTHCHECK` calls, too. The container Worker answers its own `/health`
|
|
285
|
+
without reaching your code.
|
|
286
|
+
- **Groups are Entra group object IDs, not names.** The gateway sends them in
|
|
287
|
+
lowercase. Lowercase your configured IDs too and compare IDs, never names.
|
|
288
|
+
- **The groups can be absent.** In the token, a missing `groups` claim reads
|
|
289
|
+
as an empty list. On a container, `X-User-Groups` (comma separated, no
|
|
290
|
+
spaces) is sent only when the user has at least one group. Treat a missing
|
|
291
|
+
header as "no groups" (403 on a group-gated route), not as "not signed in".
|
|
292
|
+
- **Which groups the token carries.** The token holds the groups that Entra
|
|
293
|
+
put in the user's sign-in token, as of that sign-in: a user added to a group
|
|
294
|
+
later is not in the list until they sign in again. Which groups Entra puts
|
|
295
|
+
there is set in Entra, not in code. The gateway can also admit a user to the
|
|
296
|
+
app through a live membership check on a group that is not in their token,
|
|
297
|
+
so a route check on that same group would refuse them. Before you rely on a
|
|
298
|
+
per-route group check, **ask AIOps to confirm the group is in the token**.
|
|
299
|
+
- **Never guess a group ID.** Look it up with `launchpad groups show <name>`
|
|
300
|
+
(it also accepts an ID and prints the display name, so you can confirm an ID
|
|
301
|
+
you were given). If the user does not know the exact group, ask them to get
|
|
302
|
+
it from AIOps.
|
|
303
|
+
|
|
304
|
+
### Only this group may write
|
|
305
|
+
|
|
306
|
+
A new `react+api` app: start from `launchpad init --type react+api
|
|
307
|
+
--secure-template`. Its `requireRole("writer")` refuses every write unless the
|
|
308
|
+
caller's verified groups include an ID listed in `ROLE_WRITER_GROUP_IDS`, and
|
|
309
|
+
its test fails if a write route lacks the check. For an existing Hono app
|
|
310
|
+
behind `createPlatformAuthMiddleware` (it stores the verified user as
|
|
311
|
+
`c.get("user")`), the same check is:
|
|
312
|
+
|
|
313
|
+
```js
|
|
314
|
+
// Comma-separated Entra group object IDs. Unset or empty: every write is refused.
|
|
315
|
+
export function requireGroup(envKey) {
|
|
316
|
+
return async (c, next) => {
|
|
317
|
+
const allowed = String(c.env?.[envKey] ?? '')
|
|
318
|
+
.split(',')
|
|
319
|
+
.map((g) => g.trim().toLowerCase())
|
|
320
|
+
.filter((g) => g !== '');
|
|
321
|
+
const groups = (c.get('user')?.groups ?? []).map((g) => g.toLowerCase());
|
|
322
|
+
if (allowed.length === 0 || !groups.some((g) => allowed.includes(g))) {
|
|
323
|
+
return c.json({ error: 'forbidden' }, 403);
|
|
324
|
+
}
|
|
325
|
+
await next();
|
|
326
|
+
};
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
// app.post('/items', requireGroup('ROLE_WRITER_GROUP_IDS'), handler);
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
On dispatch, set the IDs as a plain value in `launchpad.yaml` (a group ID is
|
|
333
|
+
not a secret):
|
|
334
|
+
|
|
335
|
+
```yaml
|
|
336
|
+
spec:
|
|
337
|
+
env_vars:
|
|
338
|
+
ROLE_WRITER_GROUP_IDS:
|
|
339
|
+
type: plain_text
|
|
340
|
+
value: <group object ID from launchpad groups show>
|
|
341
|
+
```
|
|
342
|
+
|
|
343
|
+
In a container, read the headers instead: no `X-User-Sub` is 401; split
|
|
344
|
+
`X-User-Groups` on `,`, trim and lowercase each ID (a missing header is an
|
|
345
|
+
empty list); no allowed ID is 403. A container setting is declared under
|
|
346
|
+
`containers[].env`, every such name must also be listed in
|
|
347
|
+
`secrets.bindings`, and its value is set with `launchpad secrets push`.
|
|
348
|
+
|
|
269
349
|
## Dispatch rules (`spec.origin: dispatch`)
|
|
270
350
|
|
|
271
351
|
The verify code is the same on dispatch. What changes is how `functions/`
|
|
@@ -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.
|
|
4
|
+
version: 0.79.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-integration-contract
|
|
3
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.
|
|
4
|
+
version: 0.79.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.79.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -40,7 +40,7 @@ This is the **only** skill that mutates the user's machine (it can
|
|
|
40
40
|
trigger `launchpad login` and suggest installs). The other skills
|
|
41
41
|
(`/launchpad-deploy`, `/launchpad-deploy-status`,
|
|
42
42
|
`/launchpad-content-pr`, `/launchpad-status`, `/launchpad-destroy`,
|
|
43
|
-
`/launchpad-identity`, `/launchpad-ingest`) assume the machine is already onboarded and fail
|
|
43
|
+
`/launchpad-identity`, `/launchpad-ingest`, `/launchpad-fix-findings`) assume the machine is already onboarded and fail
|
|
44
44
|
loudly if a prereq is missing — pointing back here.
|
|
45
45
|
|
|
46
46
|
After `launchpad clone <slug>`, refresh that same directory with bare
|
|
@@ -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.79.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.79.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
|
|
@@ -163,8 +163,9 @@ The lifecycle states (rendered without needing a local manifest):
|
|
|
163
163
|
- **`provisioning_failed`** — the workflow failed; status names the
|
|
164
164
|
failing stage + reason. Fix the cause and re-run
|
|
165
165
|
`launchpad deploy` — or, if the app is actually serving despite
|
|
166
|
-
the failed record, `launchpad recover <slug>` reconciles the
|
|
167
|
-
record against live Cloudflare state
|
|
166
|
+
the failed record on a Pages app, `launchpad recover <slug>` reconciles the
|
|
167
|
+
record against live Cloudflare state (a failed dispatch app: see
|
|
168
|
+
`/launchpad-deploy-status`; recover refuses it).
|
|
168
169
|
- **`destroying` / `destroyed` / `destroy_failed`** — teardown
|
|
169
170
|
phases; route to `/launchpad-destroy`.
|
|
170
171
|
|
|
@@ -336,8 +337,8 @@ launchpad apps # confirm lifecycle is `live`
|
|
|
336
337
|
/launchpad-deploy-status # diagnose the M-892 stage trace
|
|
337
338
|
```
|
|
338
339
|
|
|
339
|
-
If the record says `failed` but the app is actually serving
|
|
340
|
-
`launchpad recover <slug>` reconciles the record against live
|
|
340
|
+
If the record says `failed` but the app is actually serving (a Pages app;
|
|
341
|
+
recover refuses a dispatch app), `launchpad recover <slug>` reconciles the record against live
|
|
341
342
|
Cloudflare state (it verifies; it never fabricates a live state).
|
|
342
343
|
|
|
343
344
|
### "drift: hostnames[0]"
|