castle-web-cli 0.4.183 → 0.4.184

package/dist/platformDoc.d.ts

@@ -3,7 +3,7 @@ export declare const PLATFORM_DOC_REL: string;
 export declare function everyDeckBullets(deckDir: string): string[];
 export declare const PLATFORM_SECTION_HEADING = "### from the Castle platform (every deck)";
 export declare function platformSection(deckDir: string): string;
-export declare function quickReferenceFor(deckDir: string, quickReference: string, backend: 'claude' | 'cursor' | 'smith'): string;
+export declare function quickReferenceFor(deckDir: string, quickReference: string): string;
 export declare function platformGuide(deckDir: string): string;
 export declare function writePlatformDocs(deckDir: string): void;
 export declare const CLAUDE_MD_IMPORT_LINE: string;

package/dist/platformDoc.js

@@ -1,7 +1,6 @@
 import * as crypto from 'crypto';
 import * as fs from 'fs';
 import * as path from 'path';
-import { NO_DECK_DOCS } from './agent-prompts.js';
 import { resolveFileTypes } from './editorConfig.js';
 // The platform's own guidance to agents -- the rules identical in a bare deck
 // and a kit deck: the card, touch, assets and formats, imports, reloading,
@@ -9,7 +8,7 @@ import { resolveFileTypes } from './editorConfig.js';
 // at every start (runtime state: not saved, not versioned, never edited), the
 // deck's root CLAUDE.md `@`-imports the compact copy so any agent that
 // auto-loads CLAUDE.md gets it for free, and backends that read no CLAUDE.md
-// (cursor-agent, smith) get the same bullets in their composed prompt. Kits
+// get the same bullets in their composed prompt. Kits
 // state only what is theirs; nothing below is restated in a kit's guide.
 //
 // The text is what was always in context before it had one home: the four
@@ -53,9 +52,10 @@ export function everyDeckBullets(deckDir) {
         "- Do not reload the deck after an edit. Nothing auto-reloads: the person applies your changes when they are ready, from the Play panel's restart button or a panel's own reload control. `npm run restart` reloads every open panel at once and breaks their flow — only when asked.",
         "- The deck can define its own editors: declare a file type in `castle.json` (`editor.fileTypes`: ext, label, icon, and an `editors/` module) and the Files panel opens that type in it — whole recipe under `## Editors` in the deck's guide (its kit's `CLAUDE.md` under `imports/`). Editors under `imports/` are read-only; add or fork, don't edit.",
         '- An editor is for content FILES the creator keeps coming back to (catalogs, dialogue, level tables) that nothing already opens. One-off or generated data stays code.',
-        "- **Put the values someone would tune while playtesting in a `PARAMS` object**: `export const PARAMS = { jumpHeight: 4.2, coyoteTime: 0.08 };` near the top of the file that uses them. The Parameters panel lists every file in the deck that has one and renders their values as fields -- a number scrubs, a boolean toggles, a `'#rrggbb'` string opens a color picker -- and writes the edit back into the file. It edits every file's params in one place, so nobody has to remember which file a setting lives in, and a file that has params says so above its code with a way in. That is how a creator tunes a game on a phone without putting a cursor inside an expression. Nested one level deep (`player: { speed: 5 }`) renders as a group; a value that is an expression (`speed: BASE * 2`) still shows, read-only.",
+        "- **Put the values someone would tune while playtesting in a `PARAMS` object**: `export const PARAMS = { jumpHeight: 4.2, coyoteTime: 0.08 };` near the top of the file that uses them. The Parameters panel lists every file in the deck that has one and renders their values as fields -- a number scrubs, a boolean toggles, a `'#rrggbb'` string opens a color picker -- and writes the edit back into the file. It edits every file's params in one place, so nobody has to remember which file a setting lives in, and a file that has params says so above its code with a way in. That is how a creator tunes a game on a phone without putting a cursor inside an expression. Nested one level deep (`player: { speed: 5 }`) renders as a group. **Write each value as a plain number, not as arithmetic** (`0.333`, not `1 / 3`): the panel folds arithmetic over plain numbers into a field and replaces it with the tuned literal on the first edit, so the expression you wrote does not survive the first tune. A value that NAMES something (`speed: BASE * 2`) shows read-only, as a link onto its own line in the code.",
         '- **This is for the handful of numbers someone would actually reach for between playtests, not every constant in the file.** A `PARAMS` with sixty keys is a wall nobody can scan, which is how a creator stops opening the pane at all. A magic number that only ever has one right value is not a param.',
         "- **Read them through the object where they are used** -- `PARAMS.jumpHeight`, not `const { jumpHeight } = PARAMS` at module load. A destructured copy is taken once when the module loads and can never track a later change, so keeping the read at the use site is what leaves a tuned value able to reach the running deck.",
+        "- **A `PARAMS_META` object beside it, keyed the same way, says how to render a value**: `export const PARAMS_META = { jumpHeight: { min: 0, max: 10, step: 0.5, hint: 'Peak height in tiles.' }, mode: { options: ['easy', 'hard'] } };`. `min` and `max` together make a slider and cap what can be typed, so only set a `max` where going past it is meaningless; `step` sets the granularity, `unit` suffixes the value (`'s'`, `'px/s'`), `options` makes a select, `file` (`'image' | 'audio' | 'video' | 'any'`) a file picker, and `hint` a line of explanation under the field. Every key and every field is optional, a group's meta nests like the group does, and every value has to be a literal -- the panel PARSES the file, it never runs it.",
         MODE_BULLET,
     ];
 }
@@ -117,19 +117,16 @@ function withEveryDeckBullets(deckDir, quickReference) {
     const bullets = everyDeckBullets(deckDir).join('\n');
     return own ? `${own}\n\n${bullets}` : bullets;
 }
-// A deck's quick reference as one backend sees it. cursor-agent and smith read
-// no CLAUDE.md, so the whole block goes in their prompt. claude auto-loads the
-// root CLAUDE.md -- but only a deck whose file carries the @import line has the
+// A deck's quick reference as the agent sees it. claude auto-loads the root
+// CLAUDE.md -- but only a deck whose file carries the @import line has the
 // guide that way. A deck the migration has not reached (gated off) or refused
 // ('kept' -- someone edited its sections) still has the four legacy sections
 // inline and is missing just the every-deck bullets, which left the kits'
 // quick reference in the same change that added the guide.
-export function quickReferenceFor(deckDir, quickReference, backend) {
-    if (backend === 'claude') {
-        return deckLoadsGuide(deckDir) ? quickReference : withEveryDeckBullets(deckDir, quickReference);
-    }
-    const own = quickReference.trim();
-    return `${platformSection(deckDir)}\n\n${own || NO_DECK_DOCS}`;
+export function quickReferenceFor(deckDir, quickReference) {
+    return deckLoadsGuide(deckDir)
+        ? quickReference
+        : withEveryDeckBullets(deckDir, quickReference);
 }
 // The four sections `init` appended to every deck's CLAUDE.md until 2026-08-25
 // (COMMON_INSTRUCTIONS), verbatim; only the "(every deck)" heading suffix is

package/dist/serve.js

@@ -817,11 +817,9 @@ export async function serve(dir, options = {}) {
             : undefined,
         // Same effect as the WS server's own 'restart' branch below (invalidate
         // then tell every connected tab to reload), called directly in-process
-        // instead of round-tripping through a WebSocket message -- this is what
-        // backs the native `restart` tool (see native/tools.ts) so a smith task
-        // agent doesn't have to spawn `npm run restart` (node + castle-web CLI +
-        // its own WS client) just to send one message to a serve it's already
-        // running inside of.
+        // instead of round-tripping through a WebSocket message. Built for the
+        // native loop's `restart` tool (native/tools.ts), which nothing spawns
+        // today; it stays because it is the serve's capability to offer.
         restart: () => {
             invalidateModuleCaches(viteHolder.vite);
             broadcast({ type: 'restart' });