@caperjs/core 0.5.2 → 0.6.0

package/extras/skills/caper/SKILL.md

@@ -53,6 +53,8 @@ not enough, open the one file the doc cites, not the whole tree.
 ## 3. Verify loop
 
 ```bash
+npx caper doctor      # 10 lines: which caper, types fresh?, pointers, peers. Fix ✗/⚠ first
+npx caper types       # regenerate caper-app.d.ts + caper-assets.d.ts, no dev server (fresh clone, renames)
 pnpm typecheck        # or the app's tsc script; first gate after any .ts change
 pnpm build            # vite build; catches asset and discovery errors
 ```
@@ -77,11 +79,13 @@ Then check behaviour live, cheapest first:
   ```
 
 - **Headless via the automation bridge** (dev server, or `automation: true`
-  in config, or `VITE_CAPER_AUTOMATION=true`): from Playwright or a browser
-  tool, `const app = await Caper.ready(); const a = Caper.automation[app.config.id];`
-  then `a.action('name', data)`, `a.getContext()`, `a.getState()`,
-  `await a.waitFor(s => …, { timeoutMs })`, and inspect `a.log` (last 200
-  actions / context changes / state pushes). Details: llms.txt §17.
+  in config, or `VITE_CAPER_AUTOMATION=true`). Shipped driver, no code:
+  `npx caper agent probe <url> [--action name[=json]]… [--until "s => …"] [--screenshot p] [--json]`
+  → context, state, action log, page/console errors, exit 1 on failure. For
+  anything richer, in Playwright: `const app = await Caper.ready(); const a =
+  Caper.automation[app.config.id];` then `a.action('name', data)`,
+  `a.getContext()`, `a.getState()`, `await a.waitFor(s => …, { timeoutMs })`,
+  and inspect `a.log` (last 200 entries). Details: llms.txt §17.
 - **Do not start the dev server yourself** and leave it running in the
   foreground; it never exits. If the human has it running, use it. Otherwise
   ask them to run `pnpm dev` and report.
@@ -90,14 +94,14 @@ Then check behaviour live, cheapest first:
 
 - Out-of-context actions are **dropped by the ActionsPlugin**. That is the
   phase guard; do not add `if (phase !== …)` checks around `sendAction`.
-- `src/types/caper-app.d.ts` and `caper-assets.d.ts` are **generated** on dev
-  server start. Never hand-edit. Missing or stale → delete them and have the
-  dev server run once. They are usually gitignored, so a fresh clone has no
-  typed ids until then.
+- `src/types/caper-app.d.ts` and `caper-assets.d.ts` are **generated**. Never
+  hand-edit. Missing (fresh clone; they are usually gitignored) or stale after a
+  rename → `npx caper types`. No dev server needed.
 - Weird asset / name mismatches → `rm -rf .assetpack .cache dist` and rebuild.
 - Renamed a scene / popup / entity id? Regenerate types (above) or old ids
   linger in the unions and cause confusing downstream errors.
 - If the engine is **linked from a local checkout**, consumer apps resolve the
   built `lib/`; rebuild the engine (`pnpm framework:build` in the caper repo)
   after editing engine source, unless the app's vite config aliases
-  `@caperjs/core` to the engine `src/`.
+  `@caperjs/core` to the engine `src/`. `npx caper doctor` reports "linked from
+  …" and flags a stale build.

package/lib/caper.mjs

@@ -204,7 +204,7 @@ function B(e, t) {
 }
 //#endregion
 //#region src/version.ts
-var V = "0.5.2", H = "8.19.0", Mn = "     ........        .....     ............    ............. ...........     \n  .............     .......   ................ ............. ..............  \n ..............    .........   ............... ............. ..............  \n .....            ...........   .............. ............  ..............  \n .....           ...... ......  .............. ............. .............   \n .............. ......   .....  ............   ............. .....  ......   \n  ...................     ..... .....          ............. .....   ....... \n    ................       ..........          ............. .....     ..... ";
+var V = "0.6.0", H = "8.19.0", Mn = "     ........        .....     ............    ............. ...........     \n  .............     .......   ................ ............. ..............  \n ..............    .........   ............... ............. ..............  \n .....            ...........   .............. ............  ..............  \n .....           ...... ......  .............. ............. .............   \n .............. ......   .....  ............   ............. .....  ......   \n  ...................     ..... .....          ............. .....   ....... \n    ................       ..........          ............. .....     ..... ";
 function U() {
 	let e = `\n${Mn}\n\n v${V} | %cPixi.js v${H} %c| %chttps://github.com/anthonysapp/caper\n\n`;
 	console.log(e, "color: #E91E63; font-weight: 600;", "color: inherit;", "color: #00BCD4; text-decoration: underline;");