Skip to content

Commit fbdf977

Browse files
MajorTalclaude
andcommitted
docs(llms-cli): pin @run402/astro >=1.2.0 + summarize the v1.2 slice contract
v1.1.0 emitted a slice the gateway rejected (multi-file function spec, /* catchall route, manifest at wrong path). v1.2.0 fixes all three: esbuild bundles the SSR output, the gateway's class:'ssr' auto-fallback removes the need for a /* route, and the integration writes _assets-manifest.json into the resolved build.client dir. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent a90c7fb commit fbdf977

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

cli/llms-cli.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -312,7 +312,7 @@ run402 deploy apply --dir ./dist --project prj_...
312312
run402 deploy apply --dir ./dist --manifest run402.config.json --project prj_...
313313
```
314314

315-
The CLI dynamically imports `@run402/astro/release-slice` (must be installed in the consuming project). On a missing/incompatible manifest the error envelope carries `code: "R402_ASTRO_ADAPTER_MANIFEST_MISSING"` or `R402_ASTRO_ADAPTER_MANIFEST_VERSION_UNSUPPORTED` with `hint` + `docs` fields pointing at run402.com/errors. Direct-SDK callers get the same primitive via `import { buildAstroReleaseSlice } from "@run402/astro/release-slice"`.
315+
The CLI dynamically imports `@run402/astro/release-slice` (must be installed in the consuming project, **`>=1.2.0`** — v1.1.0 emitted a slice the gateway rejected and is deprecated). The helper bundles the SSR server output with esbuild into a single `source` (the gateway rejects multi-file function specs), emits no `/*` catchall route (the gateway routes every unmatched path to the project's `class: 'ssr'` function automatically), and colocates the `_assets-manifest.json` inside the resolved `build.client` dir (so the slice's site replace dir carries it). On a missing/incompatible manifest the error envelope carries `code: "R402_ASTRO_ADAPTER_MANIFEST_MISSING"` or `R402_ASTRO_ADAPTER_MANIFEST_VERSION_UNSUPPORTED` with `hint` + `docs` fields pointing at run402.com/errors. Direct-SDK callers get the same primitive via `import { buildAstroReleaseSlice } from "@run402/astro/release-slice"`.
316316

317317
Recovery from a stuck deploy: when an `apply` ends in `activation_pending` (rare; transient gateway failure between SQL commit and the pointer-swap activation), the gateway auto-resumes on the hourly tick. Static spec/config activation failures are classified promptly and thrown as structured deploy errors instead of polling until timeout. For genuinely resumable operations, call resume explicitly:
318318

0 commit comments

Comments
 (0)