phibelle-kit 1.0.34 → 1.0.36

package/dist/commands/init-scene.js

@@ -36,7 +36,9 @@ export async function initSceneCommand() {
     await fs.mkdir(sceneDir, { recursive: false });
     setupSceneDirectory(sceneDir);
     await fs.writeFile(path.join(sceneDir, SCENE_FILE_NAME), MINIMAL_SCENE_JSON, "utf8");
-    await unpackageScene(MINIMAL_SCENE_JSON, sceneDir, "template", templateId);
+    await unpackageScene(MINIMAL_SCENE_JSON, sceneDir, "template", templateId, {
+        uninitialized: true,
+    });
     console.log(chalk.green("  ✓ Project initialized"));
     console.log(chalk.gray(`  Directory: ${sceneDir}`));
     console.log(chalk.yellow("  Next steps:"));

package/dist/commands/watch-scene.js

@@ -11,7 +11,7 @@ import { toErrorMessage } from "../lib/utils.js";
 export const BASE_URL = process.env.NODE_ENV === "development" ? "http://localhost:3131" : "https://phibelle.studio";
 export async function watchSceneCommand() {
     const sceneDir = process.cwd();
-    const { sceneId, templateId } = getRequiredManifestIds(sceneDir);
+    const { sceneId, templateId, uninitialized } = getRequiredManifestIds(sceneDir);
     let lastPrintedEditorLink = null;
     console.log();
     console.log(chalk.bold.cyan("  Watching for scene sync (WebSocket)"));
@@ -45,6 +45,10 @@ export async function watchSceneCommand() {
             const incoming = parseIncomingSceneMessage(raw);
             if (!incoming)
                 return;
+            if (incoming.sceneId !== sceneId) {
+                console.log(chalk.red("  ✖ Scene ID mismatch: " + incoming.sceneId + " !== " + sceneId));
+                process.exit(1);
+            }
             try {
                 parseSceneJson(incoming.sceneData);
             }
@@ -69,13 +73,15 @@ export async function watchSceneCommand() {
                     startWatcher();
                     return;
                 }
-                const choice = sceneId === "template"
-                    ? "push-local"
-                    : await promptForInitialSyncChoice().catch((error) => {
-                        console.log(chalk.red("  ✖ " + toErrorMessage(error)));
-                        ws.close();
-                        return null;
-                    });
+                const choice = uninitialized
+                    ? "accept-web"
+                    : sceneId === "template"
+                        ? "push-local"
+                        : await promptForInitialSyncChoice().catch((error) => {
+                            console.log(chalk.red("  ✖ " + toErrorMessage(error)));
+                            ws.close();
+                            return null;
+                        });
                 if (!choice || currentClient !== ws)
                     return;
                 if (choice === "push-local") {
@@ -100,7 +106,9 @@ export async function watchSceneCommand() {
             const resolvedTemplateId = incoming.templateId ??
                 (incoming.sceneId === "template" ? getRequiredManifestIds(sceneDir).templateId : undefined);
             try {
-                await unpackageScene(incoming.sceneData, sceneDir, incoming.sceneId, resolvedTemplateId);
+                await unpackageScene(incoming.sceneData, sceneDir, incoming.sceneId, resolvedTemplateId, {
+                    uninitialized: false,
+                });
                 console.log(chalk.green("  ✓ Synced scene from app"));
                 const updatedIds = getRequiredManifestIds(sceneDir);
                 lastPrintedEditorLink = printEditorLink(updatedIds.sceneId, updatedIds.templateId, lastPrintedEditorLink);

package/dist/lib/manifest.d.ts

@@ -2,6 +2,8 @@ export type ManifestIds = {
     sceneId: string;
     /** Only present when sceneId === "template" */
     templateId?: string;
+    /** When true, watch skips the initial sync prompt and accepts the web scene once. */
+    uninitialized?: boolean;
 };
 /**
  * Read manifest.json from sceneDir and return sceneId and optional templateId.

package/dist/lib/manifest.js

@@ -32,6 +32,9 @@ export function getRequiredManifestIds(sceneDir) {
     if (sceneId === "template" && typeof manifest.templateId === "string" && manifest.templateId.trim()) {
         result.templateId = manifest.templateId.trim();
     }
+    if (manifest.uninitialized === true) {
+        result.uninitialized = true;
+    }
     return result;
 }
 /** @deprecated Use getRequiredManifestIds instead */

package/dist/lib/scene/scene-packaging.d.ts

@@ -11,7 +11,11 @@ export declare function parseSceneJson(content: string): PhibelleScene;
 export declare function entityNameToSlug(name: string): string;
 /** Convert slug to display name: "main-enemy" -> "Main Enemy". */
 export declare function slugToEntityName(slug: string): string;
+export type UnpackageOptions = {
+    /** When true, write `uninitialized`; when false, remove it. */
+    uninitialized?: boolean;
+};
 /** Unpackage scene JSON to filesystem. No DB; accepts full scene JSON string. */
-export declare function unpackageScene(sceneJson: string, sceneDir: string, sceneId?: string, templateId?: string): Promise<void>;
+export declare function unpackageScene(sceneJson: string, sceneDir: string, sceneId?: string, templateId?: string, options?: UnpackageOptions): Promise<void>;
 export declare function patchSceneFromFile(sceneJson: string, sceneDir: string, _relativePath: string, _eventType: "change" | "add" | "unlink" | "addDir" | "unlinkDir"): Promise<string>;
 export declare function packageSceneFromFilesystem(sceneJson: string, sceneDir: string): Promise<string>;

package/dist/lib/scene/scene-packaging.js

@@ -40,7 +40,7 @@ export function slugToEntityName(slug) {
         .join(" ");
 }
 /** Unpackage scene JSON to filesystem. No DB; accepts full scene JSON string. */
-export async function unpackageScene(sceneJson, sceneDir, sceneId, templateId) {
+export async function unpackageScene(sceneJson, sceneDir, sceneId, templateId, options) {
     const parsed = parseSceneJson(sceneJson);
     const parsedSceneId = typeof parsed._id === "string"
         ? parsed._id
@@ -51,11 +51,13 @@ export async function unpackageScene(sceneJson, sceneDir, sceneId, templateId) {
     await cleanupKnownEntityDirectories(appDir, previousManifest);
     await cleanupLegacySceneFiles(appDir);
     const resolvedSceneId = sceneId?.trim() || parsedSceneId;
+    const resolvedUninitialized = options?.uninitialized ?? previousManifest.uninitialized ?? false;
     const manifest = {
         sceneId: resolvedSceneId,
         ...(resolvedSceneId === "template" && templateId?.trim()
             ? { templateId: templateId.trim() }
             : {}),
+        ...(resolvedUninitialized ? { uninitialized: true } : {}),
         sceneScript: SCENE_SCRIPT_FILE,
         sceneProperties: SCENE_PROPERTIES_FILE,
         entities: {},
@@ -146,6 +148,7 @@ async function readManifest(sceneDir) {
             ...(sceneId === "template" && typeof parsed.templateId === "string" && parsed.templateId.trim()
                 ? { templateId: parsed.templateId.trim() }
                 : {}),
+            ...(parsed.uninitialized === true ? { uninitialized: true } : {}),
             sceneScript: typeof parsed.sceneScript === "string" ? parsed.sceneScript : SCENE_SCRIPT_FILE,
             sceneProperties: typeof parsed.sceneProperties === "string" ? parsed.sceneProperties : SCENE_PROPERTIES_FILE,
             entities: parsed.entities ?? {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phibelle-kit",
-  "version": "1.0.34",
+  "version": "1.0.36",
   "description": "CLI tool for interacting with the Phibelle engine",
   "type": "module",
   "bin": {