npm - castle-web-cli - Versions diffs - 0.4.39 → 0.4.41 - Mend

castle-web-cli 0.4.39 → 0.4.41

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 (4) hide show

package/dist/init.js +80 -80
package/kits/basic-2d/pnpm-lock.yaml +1761 -0
package/kits/basic-3d/pnpm-lock.yaml +1769 -0
package/package.json +1 -1

package/dist/init.js CHANGED Viewed

@@ -1,9 +1,9 @@
-import { execSync } from "child_process";
-import * as fs from "fs";
-import * as path from "path";
-import { COMMON_INSTRUCTIONS } from "./commonInstructions.js";
-import { getCliEntryPath, getKitsDir, getRepoRoot, getSdkPackagePath, toPosixPath, } from "./localPaths.js";
-import { serve } from "./serve.js";
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { COMMON_INSTRUCTIONS } from './commonInstructions.js';
+import { getCliEntryPath, getKitsDir, getRepoRoot, getSdkPackagePath, toPosixPath } from './localPaths.js';
+import { serve } from './serve.js';
 const INDEX_HTML = `<!DOCTYPE html>
 <html>
 <head>
@@ -31,20 +31,14 @@ card.appendChild(el);
 `;
 // Default kit copied by `init` when no --kit is given. `none`/`bare` skip the
 // kit and produce the minimal index.html + game.js stub above.
-const DEFAULT_KIT = "basic-2d";
+const DEFAULT_KIT = 'basic-2d';
 // Registry version of castle-web-sdk to inject when scaffolding from a
 // globally-installed castle-web (not from inside the workspace). Bumped
 // alongside cli/sdk version bumps.
-const PUBLISHED_SDK_VERSION = "0.4.4";
+const PUBLISHED_SDK_VERSION = '0.4.4';
 // Never copied into a fresh deck: build/dependency junk, and castle.json (a
 // fresh deck has no deckId until its first save-deck).
-const KIT_COPY_EXCLUDE = new Set([
-    "node_modules",
-    ".castle",
-    "dist",
-    ".git",
-    "castle.json",
-]);
+const KIT_COPY_EXCLUDE = new Set(['node_modules', '.castle', 'dist', '.git', 'castle.json']);
 // Resolve how a scaffolded deck should reference the sdk + cli. Both the bare
 // and kit scaffold paths go through here so they stay in sync.
 //   workspace mode (sdk/ sits next to cli/, i.e. running from a checkout):
@@ -58,17 +52,11 @@ function resolveScaffoldRefs() {
     // npm package and need the published refs + `castle-web` binary.
     const workspaceMode = fs.existsSync(sdkPath);
     const sdkPathPosix = workspaceMode ? toPosixPath(sdkPath) : null;
-    const cliDistAbs = workspaceMode
-        ? toPosixPath(path.dirname(getCliEntryPath()))
-        : null;
+    const cliDistAbs = workspaceMode ? toPosixPath(path.dirname(getCliEntryPath())) : null;
     return {
         workspaceMode,
-        sdkRef: workspaceMode
-            ? `file:${sdkPathPosix}`
-            : `^${PUBLISHED_SDK_VERSION}`,
-        cliCommand: workspaceMode
-            ? `node ${toPosixPath(getCliEntryPath())}`
-            : "castle-web",
+        sdkRef: workspaceMode ? `file:${sdkPathPosix}` : `^${PUBLISHED_SDK_VERSION}`,
+        cliCommand: workspaceMode ? `node ${toPosixPath(getCliEntryPath())}` : 'castle-web',
         cliDistAbs,
         sdkPathPosix,
     };
@@ -78,9 +66,9 @@ function makeClaudeMd() {
     // castle-experimental-web checkout, but breaks when the scaffold lives
     // outside the repo (the relative path no longer resolves).
     const repoRoot = getRepoRoot();
-    const upstream = path.join(repoRoot, "CLAUDE.md");
+    const upstream = path.join(repoRoot, 'CLAUDE.md');
     try {
-        return fs.readFileSync(upstream, "utf8").trimEnd() + "\n";
+        return fs.readFileSync(upstream, 'utf8').trimEnd() + '\n';
     }
     catch {
         return `# Castle Experimental Web\n\nSee https://github.com/castle-xyz/castle-experimental-web for the agent guide.\n`;
@@ -90,15 +78,13 @@ function makeClaudeMd() {
 // the kit's (or bare) CLAUDE.md is written; the AGENTS.md symlink picks the
 // appended content up for free.
 function appendCommonInstructions(projectDir) {
-    const claudePath = path.join(projectDir, "CLAUDE.md");
-    const existing = fs.existsSync(claudePath)
-        ? fs.readFileSync(claudePath, "utf8").trimEnd() + "\n\n"
-        : "";
+    const claudePath = path.join(projectDir, 'CLAUDE.md');
+    const existing = fs.existsSync(claudePath) ? fs.readFileSync(claudePath, 'utf8').trimEnd() + '\n\n' : '';
     fs.writeFileSync(claudePath, existing + COMMON_INSTRUCTIONS);
 }
 function tryMakeAgentsSymlink(agentsPath) {
     try {
-        fs.symlinkSync("CLAUDE.md", agentsPath);
+        fs.symlinkSync('CLAUDE.md', agentsPath);
     }
     catch {
         // symlink already exists / unsupported FS — non-fatal
@@ -109,37 +95,37 @@ function makePackageJson(projectDir) {
     return {
         name: path.basename(projectDir),
         private: true,
-        type: "module",
+        type: 'module',
         scripts: {
             restart: `${cliCommand} restart .`,
             screenshot: `${cliCommand} screenshot .`,
-            "save-deck": `${cliCommand} save-deck .`,
+            'save-deck': `${cliCommand} save-deck .`,
         },
         dependencies: {
-            "castle-web-sdk": sdkRef,
+            'castle-web-sdk': sdkRef,
         },
     };
 }
 // Some coding agents read AGENTS.md by convention. Symlink so they get the
 // same guidance without a duplicate copy.
 function ensureAgentsSymlink(projectDir) {
-    const agentsPath = path.join(projectDir, "AGENTS.md");
+    const agentsPath = path.join(projectDir, 'AGENTS.md');
     if (fs.lstatSync(agentsPath, { throwIfNoEntry: false }))
         return;
     // Don't create a dangling link — only symlink when CLAUDE.md is present.
-    if (!fs.existsSync(path.join(projectDir, "CLAUDE.md")))
+    if (!fs.existsSync(path.join(projectDir, 'CLAUDE.md')))
         return;
     tryMakeAgentsSymlink(agentsPath);
 }
 // Bare scaffold: a plain code-only deck with no kit framework.
 function scaffoldBare(projectDir) {
     fs.mkdirSync(projectDir, { recursive: true });
-    fs.writeFileSync(path.join(projectDir, "index.html"), INDEX_HTML);
-    fs.writeFileSync(path.join(projectDir, "game.js"), GAME_JS);
-    fs.writeFileSync(path.join(projectDir, "CLAUDE.md"), makeClaudeMd());
+    fs.writeFileSync(path.join(projectDir, 'index.html'), INDEX_HTML);
+    fs.writeFileSync(path.join(projectDir, 'game.js'), GAME_JS);
+    fs.writeFileSync(path.join(projectDir, 'CLAUDE.md'), makeClaudeMd());
     appendCommonInstructions(projectDir);
     ensureAgentsSymlink(projectDir);
-    fs.writeFileSync(path.join(projectDir, "package.json"), JSON.stringify(makePackageJson(projectDir), null, 2) + "\n");
+    fs.writeFileSync(path.join(projectDir, 'package.json'), JSON.stringify(makePackageJson(projectDir), null, 2) + '\n');
 }
 // Copy a framework kit from kits/<kit>/ into the new deck dir, dropping
 // build/dependency junk and castle.json.
@@ -147,7 +133,7 @@ function scaffoldFromKit(kit, projectDir) {
     const kitDir = path.join(getKitsDir(), kit);
     if (!fs.existsSync(kitDir) || !fs.statSync(kitDir).isDirectory()) {
         console.error(`Kit "${kit}" not found at ${kitDir}.`);
-        console.error("Available kits:");
+        console.error('Available kits:');
         try {
             const kits = fs
                 .readdirSync(getKitsDir())
@@ -156,12 +142,12 @@ function scaffoldFromKit(kit, projectDir) {
                 for (const name of kits)
                     console.error(`  ${name}`);
             else
-                console.error("  (none)");
+                console.error('  (none)');
         }
         catch {
-            console.error("  (none — kits/ directory is missing)");
+            console.error('  (none — kits/ directory is missing)');
         }
-        console.error("Or use `--kit none` for a bare code-only deck.");
+        console.error('Or use `--kit none` for a bare code-only deck.');
         process.exit(1);
     }
     fs.cpSync(kitDir, projectDir, {
@@ -175,10 +161,10 @@ function scaffoldFromKit(kit, projectDir) {
     // deck lives at castle-experimental-web/decks/<name>/. Rewrite both to
     // absolute paths so the scaffolded deck works anywhere -- including under
     // /tmp where macOS's /tmp -> /private/tmp symlink breaks relative-path math.
-    const pkgPath = path.join(projectDir, "package.json");
+    const pkgPath = path.join(projectDir, 'package.json');
     if (fs.existsSync(pkgPath)) {
         try {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
             pkg.name = path.basename(projectDir);
             // Local-dev paths (`file:../../sdk` / `node ../../cli/dist/index.js`) only
             // work when the deck lives inside the castle-experimental-web workspace.
@@ -187,13 +173,13 @@ function scaffoldFromKit(kit, projectDir) {
             // the bare scaffold path uses.
             const { workspaceMode, sdkRef, cliDistAbs, sdkPathPosix } = resolveScaffoldRefs();
             if (pkg.dependencies &&
-                typeof pkg.dependencies["castle-web-sdk"] === "string" &&
-                pkg.dependencies["castle-web-sdk"].startsWith("file:")) {
-                pkg.dependencies["castle-web-sdk"] = sdkRef;
+                typeof pkg.dependencies['castle-web-sdk'] === 'string' &&
+                pkg.dependencies['castle-web-sdk'].startsWith('file:')) {
+                pkg.dependencies['castle-web-sdk'] = sdkRef;
             }
             if (pkg.scripts) {
                 for (const k of Object.keys(pkg.scripts)) {
-                    if (typeof pkg.scripts[k] !== "string")
+                    if (typeof pkg.scripts[k] !== 'string')
                         continue;
                     if (workspaceMode) {
                         pkg.scripts[k] = pkg.scripts[k]
@@ -203,13 +189,13 @@ function scaffoldFromKit(kit, projectDir) {
                     else {
                         // Globally-installed: route through the `castle-web` binary on PATH.
                         pkg.scripts[k] = pkg.scripts[k]
-                            .replace(/node\s+\.\.\/\.\.\/cli\/dist\/index\.js/g, "castle-web")
+                            .replace(/node\s+\.\.\/\.\.\/cli\/dist\/index\.js/g, 'castle-web')
                             .replace(/await import\((['"])\.\.\/\.\.\/cli\/dist\/bundle\.js\1\)/g, "await import('castle-web-cli/dist/bundle.js')")
-                            .replace(/\.\.\/\.\.\/sdk/g, "");
+                            .replace(/\.\.\/\.\.\/sdk/g, '');
                     }
                 }
             }
-            fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+            fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
         }
         catch {
             // kit shipped an unparseable package.json — leave it for the user to fix
@@ -217,7 +203,7 @@ function scaffoldFromKit(kit, projectDir) {
     }
     // Every deck needs a CLAUDE.md so coding agents know how castle-web works.
     // Keep the kit's own if it ships one; otherwise generate from the upstream.
-    const claudePath = path.join(projectDir, "CLAUDE.md");
+    const claudePath = path.join(projectDir, 'CLAUDE.md');
     if (!fs.existsSync(claudePath)) {
         fs.writeFileSync(claudePath, makeClaudeMd());
     }
@@ -226,7 +212,7 @@ function scaffoldFromKit(kit, projectDir) {
 }
 function hasPnpm() {
     try {
-        execSync("pnpm --version", { stdio: "ignore" });
+        execSync('pnpm --version', { stdio: 'ignore' });
         return true;
     }
     catch {
@@ -234,23 +220,27 @@ function hasPnpm() {
     }
 }
 // Install the scaffolded deck's deps. Prefer pnpm -- in the e2b template a pnpm
-// store is baked in, so `pnpm install` is near-instant (hardlinks from the
-// store, no download). Fall back to npm when pnpm isn't on PATH (e.g. a local
-// laptop that never installed it). --prefer-offline uses the store/cache first
-// and only hits the network for anything missing.
-function installDeps(projectDir) {
+// store is baked in, so this is near-instant (hardlinks from the store, no
+// download). Fall back to npm when pnpm isn't on PATH (e.g. a laptop that never
+// installed it). --prefer-offline uses the store/cache first; --ignore-scripts
+// skips dep build scripts (pnpm 10+ gates them and exits non-zero otherwise,
+// and the deck's deps are all prebuilt pure JS that don't need them). `frozen`
+// installs straight from the shipped lockfile (skips resolution -> no network,
+// fast + deterministic); used in published mode where the kit lockfile matches.
+function installDeps(projectDir, frozen) {
     if (hasPnpm()) {
-        console.log("Installing deps (pnpm)...");
-        execSync("pnpm install --prefer-offline", {
+        console.log('Installing deps (pnpm)...');
+        const frozenFlag = frozen ? '--frozen-lockfile ' : '';
+        execSync(`pnpm install ${frozenFlag}--prefer-offline --ignore-scripts`, {
             cwd: projectDir,
-            stdio: "inherit",
+            stdio: 'inherit',
         });
     }
     else {
-        console.log("Installing deps (npm)...");
-        execSync("npm install --no-audit --no-fund --loglevel=error", {
+        console.log('Installing deps (npm)...');
+        execSync('npm install --no-audit --no-fund --loglevel=error', {
             cwd: projectDir,
-            stdio: "inherit",
+            stdio: 'inherit',
         });
     }
 }
@@ -261,25 +251,35 @@ export async function init(dir, opts = {}) {
         process.exit(1);
     }
     const kit = opts.kit ?? DEFAULT_KIT;
-    const bare = kit === "none" || kit === "bare";
+    const bare = kit === 'none' || kit === 'bare';
     if (bare) {
         scaffoldBare(projectDir);
     }
     else {
         scaffoldFromKit(kit, projectDir);
     }
-    console.log(`Created project in ${projectDir}/${bare ? "" : ` (from kit "${kit}")`}`);
-    // Always install deps so the deck is ready to serve/edit immediately. The
-    // serve step is what `--no-serve` skips (callers like the cloud launcher run
-    // their own serve), but they still want the deps in place.
-    console.log("");
+    console.log(`Created project in ${projectDir}/${bare ? '' : ` (from kit "${kit}")`}`);
+    // Always install deps so the deck is ready to serve/edit immediately.
+    // `--no-serve` only skips the serve step below (callers like the cloud
+    // launcher run their own serve, but still want deps in place).
+    //
+    // Published kit decks ship a matching pnpm-lock.yaml -> frozen install (no
+    // resolution, no network; hardlinks from the template's warm store). Workspace
+    // decks rewrite the sdk to file:../../sdk, which the shipped (published)
+    // lockfile won't match -> drop it and let pnpm resolve. Bare decks have no
+    // lockfile -> non-frozen.
+    const lockPath = path.join(projectDir, 'pnpm-lock.yaml');
+    if (resolveScaffoldRefs().workspaceMode)
+        fs.rmSync(lockPath, { force: true });
+    const frozen = fs.existsSync(lockPath);
+    console.log('');
     let installed = false;
     try {
-        installDeps(projectDir);
+        installDeps(projectDir, frozen);
         installed = true;
     }
     catch {
-        console.error("dependency install failed; re-run `pnpm install` (or `npm install`) in the deck.");
+        console.error('dependency install failed; re-run `pnpm install` (or `npm install`) in the deck.');
     }
     const autoServe = opts.serve !== false;
     if (autoServe && installed) {
@@ -289,16 +289,16 @@ export async function init(dir, opts = {}) {
         // 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" ||
+        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 });
+        await serve(projectDir, { host: '0.0.0.0', detach: true, open: !noOpen });
         return;
     }
-    console.log("");
-    console.log("Next steps:");
+    console.log('');
+    console.log('Next steps:');
     console.log(`  cd ${dir}`);
     if (!installed)
-        console.log("  pnpm install   # or: npm install");
-    console.log("  castle-web serve .   # & in your shell to background it");
+        console.log('  pnpm install   # or: npm install');
+    console.log('  castle-web serve .   # & in your shell to background it');
 }