castle-web-cli 0.4.27 → 0.4.29

package/dist/agent-prompts.js

@@ -13,7 +13,7 @@ What a deck is: a normal web project served by vite -- index.html plus plain JS/
 Hard rules:
 - You NEVER edit files or run state-changing commands. All building and fixing happens through background task agents -- always hand the longer work to them.
 - You are the fast lane: get to your final reply as quickly as possible. When the user reports something broken, do NOT dig into the code to diagnose it first -- spawn a task whose job is to investigate AND fix it. Only read deck files when your reply itself needs them (answering a question about the deck, grounding a claim -- never make things up); never read as pre-work before spawning a task.
-- ALWAYS break the user's request into separately testable, parallelizable chunks: several small focused tasks over one big one, each something the user can try in the running deck on its own.
+- Break the user's request into separately testable, parallelizable chunks -- but chunk by what can actually be TESTED alone, never by entity. Mechanics that only work through their interaction are ONE task: paddle + ball + bricks + their collisions is one breakout core, not three tasks shipping untestable pieces. Get the best initial testable chunk -- the smallest thing the user can genuinely play -- then parallelize the truly independent layers on top (separate features, art, levels, polish).
 - Write task prompts for speed: ask each task for the quickest viable, testable change that still delivers a meaningful step up (one or a few features, pieces of art, etc.). Only tell a task to take its time and dive deep when the user specifically asked for that.
 - To spawn a background task, include a fenced block in your reply:
 

package/dist/init.js

@@ -35,7 +35,7 @@ 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.3';
+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']);

package/kits/basic-2d/editors/App.jsx

@@ -1,5 +1,5 @@
 import React, { useEffect, useRef, useState } from 'react';
-import { writeFile } from 'castle-web-sdk';
+import { onBeforeRestart, writeFile } from 'castle-web-sdk';
 import {
   flatFileOrder,
   formatJson,
@@ -20,6 +20,7 @@ export function App() {
   const [multiSelectMode, setMultiSelectMode] = useState(false);
   const saveTimersRef = useRef({});
   const saveVersionsRef = useRef({});
+  const pendingWritesRef = useRef({});
   const drawings = {};
   for (const [path, text] of Object.entries(files)) {
     if (!path.endsWith('.drawing')) continue;
@@ -34,20 +35,44 @@ export function App() {
     }));
     scheduleFileWrite(path, nextText);
   }
+  function commitFileWrite(path, text, version) {
+    return writeFile(path, text)
+      .then(() => {
+        if (saveVersionsRef.current[path] === version && pendingWritesRef.current[path] === text) {
+          delete pendingWritesRef.current[path];
+        }
+      })
+      .catch((error) => {
+        if (saveVersionsRef.current[path] !== version) return;
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Failed to save ${path}: ${message}`);
+      });
+  }
   function scheduleFileWrite(path, nextText) {
     const version = (saveVersionsRef.current[path] ?? 0) + 1;
     saveVersionsRef.current[path] = version;
+    pendingWritesRef.current[path] = nextText;
     const existingTimer = saveTimersRef.current[path];
     if (existingTimer) window.clearTimeout(existingTimer);
     saveTimersRef.current[path] = window.setTimeout(() => {
       delete saveTimersRef.current[path];
-      writeFile(path, nextText).catch((error) => {
-        if (saveVersionsRef.current[path] !== version) return;
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`Failed to save ${path}: ${message}`);
-      });
+      void commitFileWrite(path, nextText, version);
     }, 1500);
   }
+  // A reload (npm run restart) can land mid-debounce; flush unsaved edits to
+  // disk before the page reloads so in-progress editor work isn't lost.
+  useEffect(() => {
+    return onBeforeRestart(async () => {
+      for (const timer of Object.values(saveTimersRef.current)) window.clearTimeout(timer);
+      saveTimersRef.current = {};
+      const pending = Object.entries(pendingWritesRef.current);
+      await Promise.all(
+        pending.map(([path, text]) =>
+          commitFileWrite(path, text, saveVersionsRef.current[path] ?? 0)
+        )
+      );
+    });
+  }, []);
   const kind = getFileKind(selectedPath);
   const text = files[selectedPath] ?? '';
   function selectFile(path) {

package/package.json

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