npm - castle-web-cli - Versions diffs - 0.4.5 → 0.4.7 - Mend

castle-web-cli 0.4.5 → 0.4.7

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.

Files changed (6) hide show

package/dist/index.js CHANGED Viewed

@@ -25,6 +25,9 @@ function getFlagValue(flag) {
     const idx = args.indexOf(flag);
     return idx >= 0 ? args[idx + 1] : undefined;
 }
+function hasFlag(flag) {
+    return args.includes(flag);
+}
 function readServeWsPort(dir) {
     try {
         const serveJson = JSON.parse(fs.readFileSync(path.join(path.resolve(dir), '.castle', 'serve.json'), 'utf-8'));
@@ -70,7 +73,7 @@ async function main() {
                 process.exit(1);
             }
             const kit = getFlagValue('--kit');
-            init(dir, { kit });
+            await init(dir, { kit, serve: !hasFlag('--no-serve') });
             break;
         }
         case 'serve': {

package/dist/init.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
 export declare function init(dir: string, opts?: {
     kit?: string;
-}): void;
+    serve?: boolean;
+}): Promise<void>;

package/dist/init.js CHANGED Viewed

@@ -1,6 +1,8 @@
+import { execSync } from 'child_process';
 import * as fs from 'fs';
 import * as path from 'path';
 import { getCliEntryPath, getKitsDir, getRepoRoot, getSdkPackagePath, toPosixPath } from './localPaths.js';
+import { serve } from './serve.js';
 const INDEX_HTML = `<!DOCTYPE html>
 <html>
 <head>
@@ -187,7 +189,7 @@ function scaffoldFromKit(kit, projectDir) {
     }
     ensureAgentsSymlink(projectDir);
 }
-export function init(dir, opts = {}) {
+export async function init(dir, opts = {}) {
     const projectDir = path.resolve(dir);
     if (fs.existsSync(projectDir) && fs.readdirSync(projectDir).length > 0) {
         console.error(`Directory "${dir}" is not empty.`);
@@ -202,10 +204,37 @@ export function init(dir, opts = {}) {
         scaffoldFromKit(kit, projectDir);
     }
     console.log(`Created project in ${projectDir}/${bare ? '' : ` (from kit "${kit}")`}`);
+    // Auto-run npm install + serve so the page is up the moment the
+    // agent / user starts editing. Pass --no-serve to skip.
+    const autoServe = opts.serve !== false;
+    if (autoServe) {
+        console.log('');
+        console.log('Installing deps + serving (pass --no-serve to skip)...');
+        try {
+            execSync('npm install --no-audit --no-fund --loglevel=error', {
+                cwd: projectDir,
+                stdio: 'inherit',
+            });
+        }
+        catch {
+            console.error('npm install failed; skipping serve. Re-run yourself with `npm install && castle-web serve .` (& in your shell to background it).');
+            return;
+        }
+        // Call serve() with detach so init returns once the server is up. serve()
+        // handles the background spawn internally; init doesn't shell out.
+        // Bind all interfaces by default so a tailnet / LAN browser can reach
+        // the served page; users can override host on a subsequent serve call.
+        // Open in the user's default browser unless we're clearly headless (SSH
+        // session) or the user has opted out via CASTLE_WEB_CLI_NO_OPEN=1.
+        const noOpen = process.env.CASTLE_WEB_CLI_NO_OPEN === '1' ||
+            !!process.env.SSH_CONNECTION ||
+            !!process.env.SSH_TTY;
+        await serve(projectDir, { host: '0.0.0.0', detach: true, open: !noOpen });
+        return;
+    }
     console.log('');
     console.log('Next steps:');
     console.log(`  cd ${dir}`);
     console.log('  npm install');
-    console.log('  npm run serve');
-    console.log('  npm run save-deck');
+    console.log('  castle-web serve .   # & in your shell to background it');
 }

package/dist/serve.js CHANGED Viewed

@@ -84,7 +84,10 @@ export async function serve(dir, options = {}) {
         console.error(`No index.html found in ${projectDir}`);
         process.exit(1);
     }
-    if (options.detach) {
+    // --detach is kept for back-compat. Agent evals (and any harness running
+    // castle-web in a context that can't manage a foreground process) should
+    // prefer the CASTLE_WEB_CLI_DETACH=1 env var instead.
+    if (options.detach || process.env.CASTLE_WEB_CLI_DETACH === '1') {
         await serveDetached(projectDir, options);
         return;
     }

package/kits/basic-2d/CLAUDE.md CHANGED Viewed

@@ -12,9 +12,10 @@ Write the smallest game that satisfies what the user asked for. No sound, partic
 ## Workflow
-1. **Serve first.** `castle-web serve . --detach` immediately (unless a serve is already running -- check `.castle/serve.json`). This makes your work visible to the user from the start.
-2. **Build incrementally.** Start with a minimal playable core (one mechanic, simplest scene), restart, verify, then add the next piece. Do NOT write the whole game in one shot. The user is watching the served page; demonstrate progress.
-3. **After every edit:** `npm run restart` (no hot reload). The served page refreshes; keep showing results as you go.
+The deck is already serving when you start (`castle-web init` set that up; see `.castle/serve.json` for the URL). The user is watching that page right now. Your job is to make it interesting incrementally:
+1. **Build incrementally.** Start with the smallest playable thing (one mechanic, one scene change), `npm run restart`, then add the next piece. Do NOT write the whole game in one shot.
+2. **After every edit:** `npm run restart` (no hot reload). The served page refreshes and the user sees the change.
 Card size is **500 wide × 700 tall** (origin top-left, +y is down).

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "castle-web-cli",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "type": "module",
   "bin": {
     "castle-web": "./dist/index.js"