@forgeax/engine-devkit 0.1.7 → 0.1.20

package/dist/sdk-bootstrap.d.ts

@@ -17,7 +17,12 @@ export interface SdkInitReport extends SdkInitState {
 }
 export interface AgentOnboarding {
     readonly read: readonly string[];
-    readonly next: {
+    readonly templateSelection?: {
+        readonly required: true;
+        readonly game3d: 'game-3d';
+        readonly otherwise: 'empty';
+    };
+    readonly next?: {
         readonly cwd: string;
         readonly argv: readonly string[];
     };

package/dist/sdk-bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-bootstrap.d.ts","sourceRoot":"","sources":["../src/sdk-bootstrap.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,QAAA,MAAM,uBAAuB,EAAG,OAAgB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,uBAAuB,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;KAClC,CAAC;CACH;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAgBtF;AAeD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAYzE;AAmDD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAOzF;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAkBtC;AAsBD,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACtE,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAkDvC"}
+{"version":3,"file":"sdk-bootstrap.d.ts","sourceRoot":"","sources":["../src/sdk-bootstrap.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,QAAA,MAAM,uBAAuB,EAAG,OAAgB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,uBAAuB,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE;QAC3B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;KAClC,CAAC;CACH;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAqBtF;AAeD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAYzE;AAmDD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAOzF;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAkBtC;AAsBD,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACtE,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAkDvC"}

package/dist/sdk-cli.mjs

@@ -31,7 +31,7 @@ var SDK_DEV_DEPENDENCIES = {
   "@webgpu/types": "0.1.71",
   tsx: "4.23.1",
   typescript: "6.0.3",
-  vitest: "4.0.18"
+  vitest: "4.1.11"
 };
 function createInitPlan(facts, sdk) {
   const manifest = structuredClone(facts.packageJson);
@@ -4923,15 +4923,12 @@ async function findSdkContext() {
       const templates = new Map(
         manifest.templates.map((template2) => [template2.id, resolve(cursor, template2.root)])
       );
-      const defaultTemplate = manifest.templates.find((template2) => template2.default);
-      if (defaultTemplate === void 0) throw new Error("sdk-default-template-missing");
       const store = resolve(cursor, "store", "pnpm");
       return {
         root: cursor,
         manifest,
         ...await readable(store) ? { store } : {},
-        templates,
-        defaultTemplate: defaultTemplate.id
+        templates
       };
     }
     const parent = dirname(cursor);
@@ -4950,10 +4947,14 @@ function agentOnboarding(sdk, projectRoot) {
       resolve(root2, "skills", "forgeax-engine-sdk", "SKILL.md"),
       resolve(root2, "skills", "forgeax-engine-sdk", "references", "feature-catalog.md")
     ],
-    next: projectRoot === void 0 ? {
-      cwd: root2,
-      argv: ["node", "./bin/forgeax.mjs", "new", "../my-game"]
-    } : { cwd: root2, argv: ["pnpm", "exec", "forgeax", "list", "--json"] }
+    ...projectRoot === void 0 ? {
+      templateSelection: {
+        required: true,
+        game3d: "game-3d",
+        otherwise: "empty"
+      }
+    } : {},
+    ...projectRoot === void 0 ? {} : { next: { cwd: root2, argv: ["pnpm", "exec", "forgeax", "list", "--json"] } }
   };
 }
 function sdkInitPath(sdk) {
@@ -5035,8 +5036,8 @@ async function requireSdkInitialization(sdk) {
   return { ok: true, value: state };
 }
 async function copyBootstrapInputs(sdk, root2) {
-  const template2 = sdk.templates.get(sdk.defaultTemplate);
-  if (template2 === void 0) throw new Error("sdk-default-template-missing");
+  const template2 = sdk.templates.get("empty");
+  if (template2 === void 0) throw new Error("sdk-bootstrap-template-missing");
   for (const name of ["package.json", "pnpm-lock.yaml", "pnpm-workspace.yaml"]) {
     await cp(resolve(template2, name), resolve(root2, name));
   }
@@ -5620,8 +5621,8 @@ async function initCommand(options = {}) {
     const applied = await applyInitPlan(facts.value, plan.value, options);
     if (!applied.ok || options.dryRun === true) return applied;
     if (sdk !== void 0) {
-      const template2 = sdk.templates.get(sdk.defaultTemplate);
-      if (template2 === void 0) throw new Error("sdk-default-template-missing");
+      const template2 = sdk.templates.get("empty");
+      if (template2 === void 0) throw new Error("sdk-bootstrap-template-missing");
       await copyFile(
         resolve(template2, "pnpm-lock.yaml"),
         resolve(facts.value.root, "pnpm-lock.yaml")
@@ -5689,7 +5690,18 @@ async function newCommand(options = {}) {
         }
       };
     }
-    const templateId = options.template ?? sdk.defaultTemplate;
+    if (options.template === void 0) {
+      return {
+        ok: false,
+        error: {
+          code: "sdk-template-required",
+          expected: "forgeax new to select exactly one template with --template",
+          hint: "Use --template game-3d for a 3D game; otherwise use --template empty.",
+          detail: { templates: [...sdk.templates.keys()].sort() }
+        }
+      };
+    }
+    const templateId = options.template;
     const template2 = sdk.templates.get(templateId);
     if (template2 === void 0) {
       return {
@@ -5810,6 +5822,12 @@ function agentOnboardingLines(value) {
   if (onboarding === null || typeof onboarding !== "object" || Array.isArray(onboarding)) return [];
   const candidate = onboarding;
   const lines = Array.isArray(candidate.read) ? candidate.read.filter((path) => typeof path === "string").map((path) => `[forgeax] read: ${path}`) : [];
+  const selection = candidate.templateSelection;
+  if (selection !== null && typeof selection === "object" && !Array.isArray(selection)) {
+    lines.push("[forgeax] template required: use game-3d for a 3D game; otherwise use empty");
+    lines.push("[forgeax] create 3D: forgeax new <directory> --template game-3d");
+    lines.push("[forgeax] create other: forgeax new <directory> --template empty");
+  }
   if (typeof candidate.next?.cwd === "string" && Array.isArray(candidate.next.argv) && candidate.next.argv.every((part) => typeof part === "string")) {
     lines.push(`[forgeax] next cwd: ${candidate.next.cwd}`);
     lines.push(`[forgeax] next: ${candidate.next.argv.join(" ")}`);
@@ -5830,7 +5848,7 @@ function sdkUpdateLines(value) {
   ];
 }
 function renderForgeaxUsage() {
-  return "Usage: forgeax new [directory] [--template empty|game-3d]\n       forgeax <init|doctor|test|dev|build|package|serve|preview> [directory]\n       forgeax capture [directory] [--backend auto|software|hardware] [--require-ui] [--deterministic] [--headless] [--output PATH]\n       forgeax engine <status|doctor|unlink> [--root directory]\n       forgeax engine use-local <engine-directory> [--root directory]\n       forgeax package [directory] [--output release/game-web.zip]\n       forgeax run <rhi.capture|rhi.summary|rhi.inspect> [options]\n       forgeax run <operation-id> --input <request.json>\n       forgeax exec <program.mjs> [--json]\n       forgeax asset <add|verify|inspect|list> [subject]\n       forgeax shader check [path]\n       forgeax plugin <install|uninstall> <module-or-id> [options]\n       forgeax skill <install|verify> [--root directory]\n       forgeax sdk install <directory> [--version VERSION]\n";
+  return "Usage: forgeax new [directory] --template empty|game-3d\n       forgeax <init|doctor|test|dev|build|package|serve|preview> [directory]\n       forgeax capture [directory] [--backend auto|software|hardware] [--require-ui] [--deterministic] [--headless] [--output PATH]\n       forgeax engine <status|doctor|unlink> [--root directory]\n       forgeax engine use-local <engine-directory> [--root directory]\n       forgeax package [directory] [--format web-zip|single-html] [--output PATH]\n       forgeax run <rhi.capture|rhi.summary|rhi.inspect> [options]\n       forgeax run <operation-id> --input <request.json>\n       forgeax exec <program.mjs> [--json]\n       forgeax asset <add|verify|inspect|list> [subject]\n       forgeax shader check [path]\n       forgeax plugin <install|uninstall> <module-or-id> [options]\n       forgeax skill <install|verify> [--root directory]\n       forgeax sdk install <directory> [--version VERSION]\n";
 }
 
 // src/sdk-cli.ts