@forgeax/game 0.3.8 → 0.3.9

package/README.md

@@ -9,8 +9,8 @@ creation, build, and Preview to the exact Engine SDK instead of carrying a secon
 runtime.
 
 > [!IMPORTANT]
-> The published package carries `forgeax-game` and scoped `game` binary aliases and resolves the exact
-> `@forgeax/engine-sdk@0.1.26` and `pnpm@11.7.0` dependencies. It has no
+> The package carries `forgeax-game` and scoped `game` binary aliases and resolves the exact
+> `@forgeax/engine-sdk@0.2.1` and `pnpm@11.7.0` dependencies. It has no
 > `@forgeax/game-runtime` dependency and no static Preview fallback.
 
 ## Supported flow
@@ -22,8 +22,8 @@ flowchart LR
     CARRIER["Exact npm SDK carrier"] --> GAME
     PLUGIN["@forgeax/game"] --> INSTALL
     PLUGIN --> INIT
-    GAME --> BUILD["Exact Engine CLI build --json"]
-    BUILD --> PREVIEW["Exact Engine CLI preview --json"]
+    GAME --> BUILD["Exact Engine CLI project build --json"]
+    BUILD --> PREVIEW["Exact Engine CLI project preview --json"]
     PREVIEW --> PROOF["Release-aware readiness proof"]
 ```
 
@@ -73,13 +73,11 @@ This version consumes the exact Engine SDK pin in package.json; it does not migr
 ## Agent completion contract
 
 `init` records `.forgeax/game-authoring-baseline.json` before gameplay authoring. An
-untouched Empty template remains runnable, but once gameplay or assets change the
-connector refuses Preview until the Agent has replaced the template identity, kept a
-single game README heading, removed the Empty package output name, updated gameplay
-tests, and documented controls. A valid behavior test imports a named game-specific
-state transition or rule and exercises it with an assertion; merely renaming an Empty
-template test does not qualify. Authoring layout follows the installed Engine and
-`forge.json` (v2 uses `assets/` and `plugins[]`); the Studio-hosted
+untouched Empty template remains runnable. After making a game, replace the Empty
+identity and README, document controls, and test a real gameplay rule rather than
+renaming the template test. The connector checks completion evidence before Preview.
+Authoring layout follows the installed Engine and
+`forge.json` (Engine 0.2.1 uses `assets/` Packs and `roots`); the Studio-hosted
 `.forgeax/games/<slug>` layout is never created by this package.
 
 Every supported host receives the same packaged `forgeax-game` Skill and routing rule.
@@ -122,13 +120,11 @@ root and never accepts a caller-provided `target_dir`.
 | `forgeax_game_read_logs` | HTTP tool | Read a bounded Preview log tail for remote diagnosis |
 | `forgeax_game_write_file` | HTTP tool | Atomically create or hash-guard replacement of a text file |
 
-The build plus Preview-readiness deadline is 150 seconds. Preview readiness starts
-with one bounded `CommandEnvelope@1.0.0`. Engines that expose
-`GET /.forgeax/preview-health` are bearer-authenticated and must echo the canonical
-root, exact release, build digest, and instance ID. Released Engine 0.1.7 emits the
-documented minimal Preview envelope instead; the connector binds its already verified
-release and fresh instance ID, then reads the served `forgeax-dist.json` and requires
-its SHA-256 to equal the build it just produced.
+The build plus Preview-readiness deadline is 150 seconds. Engine 0.2.1 emits
+structured `project build` and `project preview` envelopes. Where authenticated
+`GET /.forgeax/preview-health` is available, it must echo the canonical root,
+exact release, build digest, and instance ID; the connector also checks the
+served build artifact against the build it just produced.
 
 Any build or Preview failure is an MCP `isError` result. Agents must not probe or
 reuse an existing localhost port after a failed call: HTTP 200 is not ownership

package/assets/extensions/asset3d/cli.mjs

@@ -251,9 +251,62 @@ function canonicalizeOrigins(inputs) {
   return { values, compactJson, digest: sha256(compactJson) };
 }
 
+// extensions/asset3d/src/search-contract.ts
+var ASSET_TYPES = [1, 2, 3, 5, 6, 7, 8, 9, 11];
+var ART_STYLES = ["realistic", "semi-realistic", "stylized", "cartoon", "pixel art", "voxel art", "low poly", "hand-drawn", "minimalist", "generic"];
+var THEME_STYLES = ["urban", "rural", "industrial", "military", "ancient", "medieval", "traditional chinese", "traditional japanese", "wild west", "aquatic", "fantasy", "xianxia", "steampunk", "cyberpunk", "science fiction", "space", "post-apocalyptic", "horror", "nature", "prehistoric", "generic"];
+function searchBody(library, query, options = {}) {
+  if (typeof query !== "string" || query.length > 200)
+    throw new Error("asset3d_query_invalid");
+  const assetType = options.assetType ?? 1;
+  if (!ASSET_TYPES.includes(assetType))
+    throw new Error("asset3d_asset_type_invalid");
+  const filter = {};
+  for (const [option, field] of [["category", "category"], ["artStyle", "art_style"], ["themeStyle", "theme_style"], ["engineVersion", "engine_versions"]]) {
+    const value = options[option];
+    if (value === undefined)
+      continue;
+    if (typeof value !== "string" || !value.trim() || value.length > 128)
+      throw new Error("asset3d_filter_invalid");
+    if (field === "category" && ![1, 2, 5, 6, 7, 8, 9].includes(assetType))
+      throw new Error("asset3d_filter_not_applicable");
+    if (["art_style", "theme_style"].includes(field) && ![1, 2, 5, 6, 8, 9].includes(assetType))
+      throw new Error("asset3d_filter_not_applicable");
+    if (field === "art_style" && !ART_STYLES.includes(value))
+      throw new Error("asset3d_art_style_invalid");
+    if (field === "theme_style" && !THEME_STYLES.includes(value))
+      throw new Error("asset3d_theme_style_invalid");
+    filter[field] = value;
+  }
+  return {
+    depot_name: library,
+    asset_type: assetType,
+    ...query.trim() ? { content: query.trim() } : {},
+    ...Object.keys(filter).length ? { filter } : {},
+    similarity_score: 0.3,
+    page_size: 10
+  };
+}
+
 // extensions/asset3d/src/aw-access.ts
 var AW_SERVICE_PATH = "/trpc.oasismetric.omcontentserver.http";
 var DEFAULT_AW_PUBLIC_SERVICE_ROOT = "http://lb-pl74wsqg-5wi8ujmy1fq2746r.clb.usw-tencentclb.com:8008/trpc.oasismetric.omcontentserver.http";
+function optionalText(value) {
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function optionalStrings(value) {
+  return Array.isArray(value) && value.every((v) => typeof v === "string") ? value : undefined;
+}
+function optionalUrl(value) {
+  if (typeof value !== "string" || !value)
+    return;
+  downloadOrigin(value);
+  return value;
+}
+function publicCandidate(candidate) {
+  const { downloadUrl, versions, ...metadata } = candidate;
+  return { ...metadata, ...versions ? { versions: versions.map(({ downloadUrl: downloadUrl2, ...version }) => ({ ...version, downloadable: !!downloadUrl2 })) } : {} };
+}
 function normalizeAssetLibraryServiceRoot(input) {
   let parsed;
   try {
@@ -314,9 +367,8 @@ async function boundedResponse(response, limit) {
   }
   return Buffer.concat(chunks);
 }
-async function searchLibrary(config, query) {
-  if (!query.trim() || query.length > 200)
-    throw new Error("asset3d_query_invalid");
+async function searchLibrary(config, query, options = {}) {
+  const body = searchBody(config.library, query, options);
   const key = readAwCredential(config.credentialFile);
   if (!key)
     throw new Error("asset3d_api_key_required");
@@ -327,14 +379,7 @@ async function searchLibrary(config, query) {
       redirect: "error",
       signal: AbortSignal.timeout(30000),
       headers: { "Content-Type": "application/json", "X-Sandbox-Key": key },
-      body: JSON.stringify({
-        depot_name: config.library,
-        asset_type: 1,
-        req_content_type: 0,
-        content: query,
-        similarity_score: 0,
-        page_size: 10
-      })
+      body: JSON.stringify(body)
     });
   } catch {
     throw new Error("asset3d_service_unreachable");
@@ -349,18 +394,48 @@ async function searchLibrary(config, query) {
   } catch {
     throw new Error("asset3d_search_response_invalid");
   }
-  if (!value || value.ret !== undefined && value.ret !== 0 || !Array.isArray(value.asset_list) || value.asset_list.length > 100) {
+  if (!value || typeof value !== "object" || Array.isArray(value) || value.ret !== undefined && value.ret !== 0) {
     throw new Error("asset3d_search_response_invalid");
   }
+  if (value.asset_list === undefined)
+    return [];
+  if (!Array.isArray(value.asset_list) || value.asset_list.length > 100)
+    throw new Error("asset3d_search_response_invalid");
   const seen = new Set;
   return value.asset_list.slice(0, 10).map((asset) => {
-    if (!asset || typeof asset.id !== "string" || !/^[a-zA-Z0-9_-][a-zA-Z0-9._-]{0,127}$/.test(asset.id) || seen.has(asset.id) || typeof asset.name !== "string" || !asset.name || asset.name.length > 128 || typeof asset.res_url !== "string")
+    if (!asset || typeof asset.id !== "string" || !/^[a-zA-Z0-9_-][a-zA-Z0-9._-]{0,127}$/.test(asset.id) || seen.has(asset.id) || typeof asset.name !== "string" || !asset.name || asset.name.length > 1024 || typeof asset.res_url !== "string")
       throw new Error("asset3d_search_response_invalid");
     seen.add(asset.id);
     downloadOrigin(asset.res_url);
     const path = new URL(asset.res_url).pathname;
     const format = String(asset.file_format || asset.format || path.split(".").pop() || "unknown").toLowerCase();
-    return { assetId: asset.id, name: asset.name, format, downloadUrl: asset.res_url };
+    const versions = Array.isArray(asset.versions) ? asset.versions.map((v) => {
+      if (!v || typeof v.version_name !== "string" || !v.version_name)
+        throw new Error("asset3d_search_response_invalid");
+      return {
+        versionName: v.version_name,
+        engineVersions: optionalStrings(v.engine_versions),
+        thumbnailUrl: optionalUrl(v.thumbnail_url),
+        downloadUrl: optionalUrl(v.res_url)
+      };
+    }) : undefined;
+    return {
+      assetId: asset.id,
+      name: asset.name,
+      format,
+      downloadUrl: asset.res_url,
+      ...typeof asset.type === "number" ? { type: asset.type } : {},
+      ...typeof asset.score === "number" ? { score: asset.score } : {},
+      description: optionalText(asset.description),
+      detailedDescription: optionalText(asset.extra?.detailed_description),
+      category: optionalStrings(asset.category),
+      artStyle: optionalStrings(asset.art_style),
+      themeStyle: optionalStrings(asset.theme_style),
+      customTags: optionalStrings(asset.custom_tags),
+      currentVersion: optionalText(asset.current_version),
+      thumbnailUrl: optionalUrl(asset.thumbnail_url),
+      versions
+    };
   });
 }
 async function checkAssetLibraryAccess(config) {
@@ -372,8 +447,8 @@ async function checkAssetLibraryAccess(config) {
 }
 
 // extensions/asset3d/src/library.ts
-import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "node:fs";
-import { dirname as dirname4, resolve as resolve7 } from "node:path";
+import { mkdirSync as mkdirSync3, readFileSync as readFileSync7, statSync as statSync3, writeFileSync as writeFileSync4 } from "node:fs";
+import { basename as basename2, dirname as dirname4, resolve as resolve7 } from "node:path";
 
 // node_modules/fflate/esm/index.mjs
 import { createRequire } from "module";
@@ -768,6 +843,12 @@ function unzipSync(data, opts) {
   return files;
 }
 
+// src/engine/constants.ts
+var ENGINE_VERSION = "0.2.1";
+var ENGINE_COMMIT = "d699bc46d1e55b8dbd34b0839f85378b575bc9e2";
+var ENGINE_SDK_PACKAGE = "@forgeax/engine-sdk";
+var PNPM_VERSION = "11.7.0";
+
 // extensions/asset3d/src/install.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 import { resolve as resolve2 } from "node:path";
@@ -986,12 +1067,6 @@ import { isAbsolute as isAbsolute5, relative as relative4, resolve as resolve6,
 import { existsSync as existsSync3, lstatSync as lstatSync3, readFileSync as readFileSync4, realpathSync as realpathSync2 } from "node:fs";
 import { isAbsolute as isAbsolute3, relative as relative2, resolve as resolve4, sep as sep2 } from "node:path";
 
-// src/engine/constants.ts
-var ENGINE_VERSION = "0.1.26";
-var ENGINE_COMMIT = "f3d0db12405e168e4204e32a9cde32e0df8d87ae";
-var ENGINE_SDK_PACKAGE = "@forgeax/engine-sdk";
-var PNPM_VERSION = "11.7.0";
-
 // src/engine/carrier.ts
 import {
   chmodSync as chmodSync2,
@@ -1281,7 +1356,7 @@ function parseEnvelope(stdout, command) {
   if (envelopeIndex !== lines.length - 1) {
     throw new Error(`${command}_envelope_invalid: diagnostics after JSON frame`);
   }
-  if (envelope.schemaVersion !== "1.0.0" || envelope.command !== command || typeof envelope.ok !== "boolean") {
+  if (envelope.schemaVersion !== undefined || !Array.isArray(envelope.artifacts) || envelope.command !== `project ${command}` || typeof envelope.ok !== "boolean") {
     throw new Error(`${command}_envelope_invalid: wrong schema or command`);
   }
   if (!envelope.ok) {
@@ -1609,7 +1684,7 @@ function engineReadback(projectRoot, assetRelative, add, carrierPluginRoot) {
 }
 function packReadback(projectRoot, item, carrierPluginRoot) {
   const release = resolveEngineRelease(projectRoot, carrierPluginRoot === undefined ? {} : { pluginRoot: carrierPluginRoot });
-  const result = spawnSync(process.execPath, [release.cliPath, "build", "--json"], {
+  const result = spawnSync(process.execPath, [release.cliPath, "project", "build", "--json"], {
     cwd: projectRoot,
     encoding: "utf8",
     timeout: 150000,
@@ -1966,20 +2041,45 @@ async function download(config, candidate) {
   const format = /\.pack\.(ts|json)$/i.exec(path)?.[0].slice(1) ?? candidate.format.replace(/^\./, "");
   return unpackAsset(bytes, format);
 }
-async function candidatesAsset3d(root, query) {
-  const candidates = await searchLibrary(readAsset3dConfig(root), query);
-  return { candidates: candidates.map(({ assetId, name, format }) => ({ assetId, name, format })) };
-}
-async function importAsset3d(root, query, assetId) {
+async function candidatesAsset3d(root, query, options = {}) {
+  const candidates = await searchLibrary(readAsset3dConfig(root), query, options);
+  return { projectEngineVersion: ENGINE_VERSION, candidates: candidates.map(publicCandidate) };
+}
+function selectAssetVersion(candidate, versionName, engineVersion) {
+  const selected = versionName ? candidate.versions?.find((v) => v.versionName === versionName) : candidate.versions?.find((v) => v.versionName === candidate.currentVersion);
+  if (versionName && !selected)
+    throw new Error("asset3d_version_not_found");
+  if (versionName && !selected?.downloadUrl)
+    throw new Error("asset3d_version_download_missing");
+  if (engineVersion && candidate.versions?.length && (!selected || !selected.engineVersions?.includes(engineVersion))) {
+    throw new Error("asset3d_version_selection_required: choose --version from a matching versions entry");
+  }
+  return selected?.downloadUrl ? {
+    ...candidate,
+    currentVersion: selected.versionName,
+    downloadUrl: selected.downloadUrl,
+    thumbnailUrl: selected.thumbnailUrl ?? candidate.thumbnailUrl
+  } : candidate;
+}
+function assertAssetEngineCompatible(candidate, projectVersion) {
+  const declared = candidate.versions?.find((v) => v.versionName === candidate.currentVersion)?.engineVersions;
+  if (declared?.length && !declared.includes(projectVersion)) {
+    throw new Error(`asset3d_engine_version_mismatch: project Engine ${projectVersion}; selected asset version ${candidate.currentVersion} declares ${declared.join(", ")}. Select a matching asset version; do not upgrade the project silently.`);
+  }
+}
+async function importAsset3d(root, query, assetId, options = {}, versionName) {
   const config = readAsset3dConfig(root);
-  const candidate = (await searchLibrary(config, query)).find((c) => c.assetId === assetId);
-  if (!candidate)
-    throw new Error("asset3d_candidate_not_found: select an ID returned for this query");
+  const found = (await searchLibrary(config, query, options)).find((c) => c.assetId === assetId);
+  if (!found)
+    throw new Error("asset3d_candidate_not_found: select an ID returned for this query and filters");
+  const candidate = selectAssetVersion(found, versionName, options.engineVersion);
+  assertAssetEngineCompatible(candidate, ENGINE_VERSION);
   const files = await download(config, candidate);
   const built = manifestFor(files, candidate.assetId);
-  const started = beginAsset3d(root, [query]);
+  const transactionQuery = query.trim() || `asset ${assetId}`;
+  const started = beginAsset3d(root, [transactionQuery]);
   try {
-    const output = asset3dSearchOutputDir(root, started.execution, [query]);
+    const output = asset3dSearchOutputDir(root, started.execution, [transactionQuery]);
     for (const [path, bytes] of Object.entries(files)) {
       const target = resolve7(root, ".forgeax/extensions/asset3d/data/asset3d-quarantine", output, candidate.assetId, path);
       mkdirSync3(dirname4(target), { recursive: true, mode: 448 });
@@ -1999,7 +2099,7 @@ async function importAsset3d(root, query, assetId) {
       results: [{
         status: "ok",
         queryIndex: 0,
-        query,
+        query: transactionQuery,
         provider: "ea-3d",
         providerAssetId: assetId,
         assetName: candidate.name,
@@ -2012,7 +2112,7 @@ async function importAsset3d(root, query, assetId) {
     };
     recordAsset3dProviderResult(root, started.execution, JSON.stringify(result));
     const committed = commitAsset3d({ projectRoot: root, execution: started.execution });
-    return { ...committed, deliveredFormat: built.deliveredFormat };
+    return { ...committed, deliveredFormat: built.deliveredFormat, selectedAsset: publicCandidate(candidate) };
   } catch (error) {
     try {
       abortAsset3d(root, started.execution);
@@ -2021,19 +2121,65 @@ async function importAsset3d(root, query, assetId) {
   }
 }
 function parseAsset3dArgs(args, importing) {
-  const allowed = importing ? ["--query", "--asset-id"] : ["--query"];
+  const allowed = [
+    "--query",
+    "--asset-type",
+    "--category",
+    "--art-style",
+    "--theme-style",
+    "--engine-version",
+    ...importing ? ["--asset-id", "--version", "--candidate-file", "--candidate-name"] : []
+  ];
   const values = {};
   for (let i2 = 0;i2 < args.length; i2++) {
     if (args[i2] === "--json")
       continue;
-    const name = args[i2], value = args[++i2];
-    if (!allowed.includes(name) || values[name] || !value || value.startsWith("--"))
+    const name2 = args[i2], value = args[++i2];
+    if (!allowed.includes(name2) || values[name2] || !value || value.startsWith("--"))
       throw new Error("asset3d_arguments_invalid");
-    values[name] = value;
+    values[name2] = value;
+  }
+  const file = values["--candidate-file"], name = values["--candidate-name"];
+  if (importing && (Boolean(file) !== Boolean(name) || Boolean(values["--asset-id"]) === Boolean(file))) {
+    throw new Error("asset3d_arguments_invalid: supply --asset-id or --candidate-file with --candidate-name");
+  }
+  const query = values["--query"] ?? "";
+  const options = {
+    ...values["--asset-type"] !== undefined ? { assetType: Number(values["--asset-type"]) } : {},
+    ...values["--category"] ? { category: values["--category"] } : {},
+    ...values["--art-style"] ? { artStyle: values["--art-style"] } : {},
+    ...values["--theme-style"] ? { themeStyle: values["--theme-style"] } : {},
+    ...values["--engine-version"] ? { engineVersion: values["--engine-version"] } : {}
+  };
+  searchBody("ea", query, options);
+  let selected;
+  if (file && name) {
+    let response;
+    try {
+      if (statSync3(file).size > 1024 * 1024)
+        throw new Error("too large");
+      response = JSON.parse(readFileSync7(file, "utf8"));
+    } catch {
+      throw new Error("asset3d_candidate_file_invalid");
+    }
+    const data = response;
+    if (data?.ok !== true || !Array.isArray(data.value?.candidates))
+      throw new Error("asset3d_candidate_file_invalid");
+    const matches = data.value.candidates.filter((entry) => typeof entry?.assetId === "string" && typeof entry.name === "string" && (entry.name === name || basename2(entry.name) === name));
+    if (matches.length !== 1)
+      throw new Error("asset3d_candidate_name_not_unique");
+    const candidate = matches[0];
+    if (values["--version"] && !candidate.versions?.some((v) => v.versionName === values["--version"])) {
+      throw new Error("asset3d_version_not_found_in_candidates");
+    }
+    selected = { assetId: candidate.assetId, versionName: values["--version"] ?? candidate.currentVersion };
   }
-  if (allowed.some((name) => !values[name]))
-    throw new Error("asset3d_arguments_invalid");
-  return { query: values["--query"], assetId: values["--asset-id"] };
+  return {
+    query,
+    assetId: selected?.assetId ?? values["--asset-id"],
+    options,
+    versionName: selected?.versionName ?? values["--version"]
+  };
 }
 
 // extensions/asset3d/cli.ts
@@ -2080,7 +2226,7 @@ async function run(context, args) {
   }
   if (operation === "candidates" || operation === "import") {
     const parsed = parseAsset3dArgs(rest, operation === "import");
-    return operation === "candidates" ? candidatesAsset3d(context.projectRoot, parsed.query) : importAsset3d(context.projectRoot, parsed.query, parsed.assetId);
+    return operation === "candidates" ? candidatesAsset3d(context.projectRoot, parsed.query, parsed.options) : importAsset3d(context.projectRoot, parsed.query, parsed.assetId, parsed.options, parsed.versionName);
   }
   throw new Error("asset3d_arguments_invalid: expected candidates, import, or doctor");
 }

package/assets/extensions/asset3d/skills/art-3d-asset-library/SKILL.md

@@ -1,23 +1,161 @@
 ---
 name: art-3d-asset-library
-description: Search EA/AW for reusable 3D assets and import native Pack or GLB into a ForgeaX game. Use when the user wants assets from the library.
+description: Find and choose EA/AW library assets by purpose, style and Engine version; import native Pack or GLB into ForgeaX games. Use when reusing library assets.
 ---
 
 # Asset library
 
 Run the following commands from the game directory. The command is pinned to this
 installation; no global CLI or separate Asset3D MCP server is needed.
+Run commands sequentially in one project: extension operations share a lock.
+If another operation is active, wait for it to finish instead of launching retries.
 
-1. If setup is uncertain, run `{{CLI}} doctor --json`.
-   If not enabled, ask the user to configure `{{CLI}} enable`.
-2. Search: `{{CLI}} candidates --query "<English description>" --json`.
-   Select a returned `assetId` by name and format. Refine the query if none fits.
-3. Import: `{{CLI}} import --query "<same description>" --asset-id "<selected ID>" --json`.
-   Read `ok`, per-item results, `deliveredFormat` and Engine identities.
-   A GLB import does not satisfy a request for native Pack.
-4. Use the returned GUIDs through the installed Engine authoring skills. Keep the
-   imported files and material/texture dependencies together. Build and open the
-   Engine-owned Preview; verify the assets are visible and the requested input works.
+If setup is uncertain, run `{{CLI}} doctor --json`. If disabled, ask the user to
+configure `{{CLI}} enable`; keep the configured library and service environment.
+
+## Find an asset that fits the game
+
+Start with one focused query of 1–3 English keywords describing the object or
+function, such as `wooden crate`. Add searches only when the results leave a
+selection question unanswered; do not batch near-synonyms before inspecting results.
+For library-dependent gameplay, establish a viable candidate before implementing
+the game or starting an unrelated empty-template Preview.
+
+```sh
+scratch=$(mktemp -d /tmp/forgeax-selection.XXXXXX)
+{{CLI}} candidates --query "wooden crate" --asset-type 1 --json --pretty > "$scratch/candidates.json" && cat "$scratch/candidates.json"
+```
+
+`--pretty` puts each identity and metadata field on its own line without changing
+the response. Keep a candidate's name, opaque ID and version together when reading.
+Use the returned scratch path for the import below; this saves one real response
+without issuing a second search.
+
+For search-only tasks, the candidate response includes `projectEngineVersion` and
+asset version metadata: these are enough to compare compatibility and report a
+selection. Engine API guides and scene/sub-asset inspection become useful when
+moving on to import and game implementation.
+
+Choose one asset type per search (default: 1):
+
+| Type | Asset |
+|:--|:--|
+| 1 | 3D model |
+| 2 | Texture |
+| 3 | BGM |
+| 5 | Animated 3D model |
+| 6 | VFX |
+| 7 | Sound effect |
+| 8 | Material |
+| 9 | Skybox |
+| 11 | Kit or gameplay guide |
+
+The CLI uses a 0.3 hybrid-search threshold and up to 10 candidates. `--query` can
+be omitted for browsing by type or filters. Optional hard filters are
+`--category`, `--art-style`, `--theme-style`, and `--engine-version` (one version).
+Only add a filter when the request or project establishes its value; filters
+exclude results rather than improving relevance. Category is unavailable for 3/11;
+art/theme style is unavailable for 3/7/11. The CLI validates service enums.
+
+Compare `description`, `detailedDescription`, category/style arrays and `customTags`
+against the asset's intended role: playable target, backdrop, modular building,
+animated character, etc. Do not choose solely by rank, score or filename.
+When metadata is insufficient, inspect a relevant `thumbnailUrl` with the host's
+image/browser tools if available; otherwise report visual suitability as unverified.
+Separate metadata-based expectations from observed visuals: a description of metal
+corners is evidence of intended form, not proof of material quality in the game.
+Preview URLs may expire: preserve their query strings and do not persist them in game code.
+
+Check `versions[].engineVersions` against `projectEngineVersion`; missing metadata
+means unknown compatibility, not guaranteed support. Prefer a matching version and
+pass its `versionName` with `--version`. Import rejects a declared version mismatch
+before downloading; choose a matching version or report that none is available.
+A ZIP label alone does not prove native Pack.
+If no suitable result exists, broaden keywords once and remove only unnecessary
+filters. Do not remove a required Engine-version constraint or upgrade Engine silently.
+An empty candidate list is a valid no-match result, not a broken service.
+
+## Decision examples
+
+These illustrate decisions, not mandatory game designs or fixed asset choices.
+
+| Situation | Useful next action | Avoid |
+|:--|:--|:--|
+| A collection game needs a small crate; the first result is a warehouse kit. | Compare object role, dimensions, style and compatible versions; choose the fitting crate even if lower-ranked. | Selecting by rank or similar filename alone. |
+| Relevant candidates declare a different Engine version. | Check a query constrained to the actual project version; if no suitable version exists, report the gap. | More synonym searches without the version constraint, forced import, or a silent Engine upgrade. |
+| A relevant asset has no compatibility metadata. | Treat compatibility as unknown; use normal import/build/Preview validation. | Rejecting it as incompatible, or promising it works, solely because the field is absent. |
+| Similar candidates have long IDs and several versions. | Copy the name, ID and version together from the chosen result; check the final tuple against that object. | Combining one candidate's ID prefix with another's suffix, or trusting an earlier progress message instead of the search result. |
+| Import returns Pack GUIDs but the model is invisible or wrongly scaled. | Inspect the imported scene/sub-assets, transforms and actual Preview before claiming success. | Calling download/import success a playable game, or replacing the asset with generated geometry. |
+
+## Carry the selection forward
+
+Before importing or sending the final selection, revisit the chosen object in the
+search output and match its name, `assetId`, and chosen `versionName` together.
+IDs are opaque strings: shared prefixes do not identify the same asset. Apply the
+same lookup to any alternatives you cite. Copy values from that original record,
+not from your earlier prose; JSON extraction is useful for long or similar IDs.
+This is a local readback, not a reason to repeat the network search or write files.
+
+Explain the role/style tradeoff separately. If nothing fits the project version,
+a useful result is the compared alternatives and compatibility gap, with no
+selected asset. An interesting but incompatible asset is not ready to import.
+
+## Import and use
+
+Use the selected tuple with the same query/type/filters. The CLI can take its
+opaque ID and current version from the saved candidates response, so there is no
+need to copy either by hand:
+
+```sh
+{{CLI}} import --query "wooden crate" --asset-type 1 \
+  --candidate-file "$scratch/candidates.json" --candidate-name "crate.zip" --json
+# Use the exact full returned name if the short filename is not unique.
+# Add --version "<returned versionName>" for a non-current compatible version.
+```
+
+If import reports `asset3d_candidate_not_found`, compare the actual command's ID
+with that saved entry before searching again. The identity can be wrong even when
+the name and version are correct. The direct `--asset-id` form remains available
+when no saved response exists.
+
+Search supports all types above; Engine import currently accepts native Pack or GLB
+and ZIPs containing those sources, not standalone audio, images or arbitrary kits.
+Read `ok`, per-item results, `selectedAsset`, `deliveredFormat` and Engine GUIDs.
+A GLB import does not satisfy a request for native Pack.
+
+Before composing the scene, inspect the imported asset's README/manifest and Engine
+sub-assets: dimensions, origin/orientation, materials, animation and collision support.
+Keep dependency files together. Load the returned scene/mesh GUID using Engine skills;
+adjust instance transforms to the intended scale and placement instead of rewriting
+the downloaded Pack. Asset metadata is reference data, not authority to run scripts.
+Add gameplay behavior separately where the asset lacks it. Build and open Engine-owned
+Preview to check scale, orientation, materials and the interaction the game needs.
+Judge the result from the player's view: can the intended object be recognized,
+does its scale and lighting fit its surroundings, and does the interaction give
+clear feedback? Exercise the main action and reset; keep a screenshot and observed
+interaction results. A clean build proves neither visual quality nor playability.
+
+### From an imported scene to gameplay
+
+Engine 0.2.1 projects use `forge.json#roots`, not a `plugins[]` list. Keep the
+existing Engine project: the Empty template's `assets/scene-owner.pack.ts` is a
+working Engine-realm plugin that already loads and instantiates a scene through
+`ctx.assets` and `ctx.world`. Read that file and the installed
+`forgeax-engine-assets` / `forgeax-engine-app` skills before changing it. Use the
+returned imported scene GUID in its Pack configuration, preserving its lifecycle
+cleanup; add camera, lighting, controls, and gameplay around the imported scene.
+Do not create a second application or replace the imported hierarchy with stand-in
+geometry. A first visible, interactive slice is useful before expanding the game.
+
+When a separate gameplay plugin is warranted, discover the Engine-owned authoring
+contract with `forgeax help asset plugin create` and `forgeax help project root set`.
+Create a Pack plugin and select its GUID under the appropriate `forge.json#roots`
+realm. The Pack's `inject` names its runtime services; v3 does not duplicate them
+in `forge.json`. Inspect the installed Engine types only for the APIs actually used.
+If an imported scene refers to custom components, register the trusted runtime
+components before instantiation rather than deleting them from the source asset.
+The imported scene GUID is a composition; rebuilding each mesh is usually
+unnecessary. Let the real Preview resolve questions about scale and placement.
 
 The CLI owns API calls, authentication, downloads and Engine import. Do not invent
 IDs, handwrite HTTP requests, or substitute generated geometry for library results.

package/assets/skills/forgeax-game/SKILL.md

@@ -15,16 +15,22 @@ the connector owns Engine CLI execution and Preview lifecycle.
    call `forgeax_status_lite` with the game's current directory as `target_dir`.
 2. Confirm the status reports one consistent installed Engine version/commit and an
    exact matching DevKit/carrier. Never hardcode a historical release identity.
-3. Read the game's `forge.json`, source, package declarations, and any Engine-owned
-   `skills/` installed with that game. Engine declarations are in its installed
+3. Read the game's `forge.json`, source, package declarations, and task-relevant
+   Engine-owned `skills/` installed with that game. Engine declarations are in its installed
    `node_modules/@forgeax/engine*` packages; never substitute Studio or Editor source.
 
+Status describes runtime readiness, not a requirement to launch the template first.
+When gameplay depends on a library asset, follow the installed asset-library Skill
+to establish availability and compatible candidates before game implementation or
+a baseline Preview. Other tasks may still need a baseline to reproduce a bug.
+
 > [!IMPORTANT]
 > In an empty directory, `forgeax-game init` creates the Engine-owned standalone game
 > through the exact installed carrier. In an existing exact game it refreshes the
 > binding idempotently. Follow `forge.json` and the installed Engine's authoring
-> layout (Engine v2 uses `assets/` and `plugins[]`); preserve supported existing
-> layouts rather than moving files to a prescribed directory. Do not create Studio's
+> layout: Engine 0.2.1 uses `assets/` Pack sources and `forge.json#roots`, not a
+> `plugins[]` list. Preserve the Engine-owned project instead of moving files to a
+> prescribed directory. Do not create Studio's
 > hosted `.forgeax/games/<slug>` layout inside a standalone game.
 
 ## Edit and verify
@@ -70,11 +76,9 @@ generation for a requested library asset without user approval.
 > a successful result containing `preview.status: ready`, `preview_url`, `preview.root`,
 > `preview.build_digest`, and `preview.instance_id` authorizes a Preview claim.
 
-The connector runs the exact installed Engine CLI with `build --json`, then starts or
-reuses `preview --json`. When Engine exposes authenticated health, the connector binds
-it to the canonical root, exact release, build digest, and Preview instance ID.
-Released Engine 0.1.7 instead uses its documented minimal envelope plus an exact
-served `forgeax-dist.json` SHA. PID alone is not ownership evidence in either mode.
+The connector runs the exact installed Engine CLI with `project build --json`, then
+starts or reuses `project preview --json`. It binds Preview to the canonical root,
+exact release, build digest, and Preview instance ID; PID alone is not ownership.
 
 ## Stop
 

package/dist/main.js

@@ -335,6 +335,7 @@ import { fileURLToPath } from "node:url";
 import { readFileSync, realpathSync } from "node:fs";
 import { dirname as dirname2, join as join2, resolve } from "node:path";
 var SLUG_RE = /^[a-z0-9][a-z0-9-]{0,40}$/;
+var GUID_RE = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i;
 function isProjectRoot(dir) {
   return engineGameId(dir) !== undefined;
 }
@@ -342,7 +343,7 @@ function engineGameId(root) {
   try {
     const manifest = JSON.parse(readFileSync(join2(root, "forge.json"), "utf8"));
     const pkg = JSON.parse(readFileSync(join2(root, "package.json"), "utf8"));
-    return typeof manifest.id === "string" && SLUG_RE.test(manifest.id) && (manifest.schemaVersion === "2.0.0" ? typeof manifest.defaultScene === "string" && /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(manifest.defaultScene) : (manifest.schemaVersion === undefined || manifest.schemaVersion === "1.0.0") && typeof manifest.entry === "string") && typeof pkg.dependencies?.["@forgeax/engine"] === "string" ? manifest.id : undefined;
+    return typeof manifest.id === "string" && SLUG_RE.test(manifest.id) && (manifest.schemaVersion === "3.0.0" ? manifest.roots !== null && typeof manifest.roots === "object" && !Array.isArray(manifest.roots) && Object.entries(manifest.roots).every(([realm, guid]) => ["host", "frontend", "engine", "build"].includes(realm) && typeof guid === "string" && GUID_RE.test(guid)) : manifest.schemaVersion === "2.0.0" ? typeof manifest.defaultScene === "string" && GUID_RE.test(manifest.defaultScene) : (manifest.schemaVersion === undefined || manifest.schemaVersion === "1.0.0") && typeof manifest.entry === "string") && typeof pkg.dependencies?.["@forgeax/engine"] === "string" ? manifest.id : undefined;
   } catch {
     return;
   }
@@ -718,8 +719,8 @@ import { existsSync as existsSync3, lstatSync as lstatSync3, readFileSync as rea
 import { isAbsolute as isAbsolute2, relative as relative3, resolve as resolve4, sep as sep2 } from "node:path";
 
 // src/engine/constants.ts
-var ENGINE_VERSION = "0.1.26";
-var ENGINE_COMMIT = "f3d0db12405e168e4204e32a9cde32e0df8d87ae";
+var ENGINE_VERSION = "0.2.1";
+var ENGINE_COMMIT = "d699bc46d1e55b8dbd34b0839f85378b575bc9e2";
 var ENGINE_SDK_PACKAGE = "@forgeax/engine-sdk";
 var PNPM_VERSION = "11.7.0";
 
@@ -1080,7 +1081,7 @@ function parseSuccessEnvelope(output, command) {
   } catch (error) {
     throw new Error(`engine_sdk_${command}_envelope_invalid: ${error instanceof Error ? error.message : String(error)}`);
   }
-  if (value === null || typeof value !== "object" || Array.isArray(value) || value.schemaVersion !== "1.0.0" || value.command !== command || value.ok !== true || value.value === null || typeof value.value !== "object" || Array.isArray(value.value)) {
+  if (value === null || typeof value !== "object" || Array.isArray(value) || value.schemaVersion !== undefined || value.command !== `project ${command}` || !Array.isArray(value.artifacts) || value.ok !== true || value.value === null || typeof value.value !== "object" || Array.isArray(value.value)) {
     throw new Error(`engine_sdk_${command}_envelope_invalid: expected one ${command} success envelope`);
   }
   return value;
@@ -1116,13 +1117,13 @@ async function createEmptyGameWithCarrier(targetRoot, options = {}) {
   const shim = createPnpmShim(carrier.pnpmCliPath);
   const environment = carrierEnvironment(shim.root);
   try {
-    const initOutput = await runCarrierProcess(carrier, ["init", "--json"], environment);
+    const initOutput = await runCarrierProcess(carrier, ["project", "init", "--json"], environment);
     if (initOutput.status !== 0) {
       throw new Error(`engine_sdk_init_failed: ${failureDetail(initOutput, "init")}`);
     }
     const init = parseSuccessEnvelope(initOutput.stdout, "init");
     assertIdentity("init", init);
-    const newOutput = await runCarrierProcess(carrier, ["new", target, "--template", "empty", "--json"], environment);
+    const newOutput = await runCarrierProcess(carrier, ["project", "new", "--root", target, "--template", "empty", "--json"], environment);
     if (newOutput.status !== 0) {
       throw new Error(`engine_sdk_new_failed: ${failureDetail(newOutput, "new")}`);
     }
@@ -1426,7 +1427,7 @@ function parseEnvelope(stdout, command) {
   if (envelopeIndex !== lines.length - 1) {
     throw new Error(`${command}_envelope_invalid: diagnostics after JSON frame`);
   }
-  if (envelope.schemaVersion !== "1.0.0" || envelope.command !== command || typeof envelope.ok !== "boolean") {
+  if (envelope.schemaVersion !== undefined || !Array.isArray(envelope.artifacts) || envelope.command !== `project ${command}` || typeof envelope.ok !== "boolean") {
     throw new Error(`${command}_envelope_invalid: wrong schema or command`);
   }
   if (!envelope.ok) {
@@ -1467,7 +1468,7 @@ async function terminateDirectChild(child, cleanupMs) {
   }
 }
 async function runBuild(cliPath, gameRoot, paths, deadlineAt, cleanupMs) {
-  const child = spawn(process.execPath, [cliPath, "build", "--json"], {
+  const child = spawn(process.execPath, [cliPath, "project", "build", "--json"], {
     cwd: gameRoot,
     env: { ...process.env },
     stdio: ["ignore", "pipe", "pipe"]
@@ -1698,7 +1699,7 @@ async function startEnginePreview(projectRoot, gameRoot, options = {}) {
     }
     const token = randomBytes(32).toString("hex");
     const previewInstanceId = randomUUID();
-    const child = spawn(process.execPath, [release.cliPath, "preview", "--port", "0", "--json"], {
+    const child = spawn(process.execPath, [release.cliPath, "project", "preview", "--port", "0", "--json"], {
       cwd: release.gameRoot,
       detached: true,
       env: { ...process.env, FORGEAX_PREVIEW_INSTANCE_TOKEN: token },
@@ -1843,7 +1844,7 @@ function deriveNextAction(s) {
   if (s.preview?.live && s.preview.identityMatches) {
     return "Engine Preview is live. Edit the game and call `forgeax_run_current_game` to rebuild or reuse it.";
   }
-  return "Call `forgeax_run_current_game` to run the bounded Engine build and verified Preview lifecycle.";
+  return "When Preview is needed, call `forgeax_run_current_game` for the bounded Engine build and verified Preview lifecycle. Resolve task prerequisites first; status does not require an empty-template baseline run.";
 }
 async function collectStatus(explicitDir) {
   const project = resolveProject(explicitDir);
@@ -2954,7 +2955,7 @@ function gameFileTools() {
 var package_default = {
   packageManager: "bun@1.4.0",
   name: "@forgeax/game",
-  version: "0.3.8",
+  version: "0.3.9",
   private: false,
   type: "module",
   description: "@forgeax/game — an MCP/CLI connector for exact released ForgeaX Engine games and Engine-owned Preview.",
@@ -2998,7 +2999,7 @@ var package_default = {
   ],
   license: "MIT",
   dependencies: {
-    "@forgeax/engine-sdk": "0.1.26",
+    "@forgeax/engine-sdk": "0.2.1",
     pnpm: "11.7.0"
   },
   devDependencies: {
@@ -5218,18 +5219,20 @@ async function updateCommand(args) {
   return 0;
 }
 async function extensionCommand(id, args) {
+  const pretty = args.includes("--pretty");
+  args = args.filter((arg) => arg !== "--pretty");
   const [operation, ...rest] = args;
   const emit = (ok, value) => process.stdout.write(JSON.stringify({
     schemaVersion: "1.0.0",
     command: `${id}.${operation}`,
     ok,
     ...ok ? { value } : { error: value }
-  }) + `
+  }, null, pretty ? 2 : undefined) + `
 `);
   try {
     const extension = discoverExtensions().find((item) => item.id === id);
     if (operation === "help" || operation === "--help") {
-      process.stdout.write(`${id}: enable [--ide ...] [--local], disable, or a business operation documented in its Skill.
+      process.stdout.write(`${id}: enable [--ide ...] [--local], disable, or a business operation documented in its Skill. Add --pretty for readable JSON; values and exit status are unchanged.
 `);
       return 0;
     }

package/docs/asset3d.md

@@ -6,18 +6,23 @@ Pack 或 GLB，再交给固定版本 Engine 导入。没有 Python Provider、As
 ## 使用
 
 ```bash
-npx -y @forgeax/game@0.3.8 install --ide codex
+npx -y @forgeax/game@0.3.9 install --ide codex
 # 在空目录
-npx -y @forgeax/game@0.3.8 init
-npx -y @forgeax/game@0.3.8 asset3d enable --ide codex
-npx -y @forgeax/game@0.3.8 asset3d candidates --query "wooden crate" --json
-# 阅读候选后选择 ID
-npx -y @forgeax/game@0.3.8 asset3d import --query "wooden crate" --asset-id "<返回的ID>" --json
+npx -y @forgeax/game@0.3.9 init
+npx -y @forgeax/game@0.3.9 asset3d enable --ide codex --library ea --base-url "<获授权的 EA 网关>"
+scratch="$(mktemp -d /tmp/forgeax-selection.XXXXXX)"
+npx -y @forgeax/game@0.3.9 asset3d candidates --query "wooden crate" --engine-version 0.2.1 --json > "$scratch/candidates.json"
+npx -y @forgeax/game@0.3.9 asset3d import --query "wooden crate" --engine-version 0.2.1 \
+  --candidate-file "$scratch/candidates.json" --candidate-name "<候选的完整名称>" --json
 ```
 
-以上版本为当前本地候选，发布前不能通过 npm 获取；本地验证使用已安装候选的
-`node "/absolute/consumer/node_modules/@forgeax/game/dist/main.js"` 替代 npx 前缀。
-本地候选启用时加 `--local`；安装后的 Skill 自动包含匹配的命令。
+发布前本地候选验证可用已安装包的
+`node "/absolute/consumer/node_modules/@forgeax/game/dist/main.js"` 替代 npx 前缀，
+启用时加 `--local`。`--candidate-name` 使用搜索响应中的完整名称；若短文件名唯一也可使用。
+
+> [!IMPORTANT]
+> 导入只接受所选版本明确声明兼容当前 Engine 的资产。若 `0.2.1` 筛选后无候选，
+> 应请资产库发布兼容版本；不要去掉版本约束强行导入旧 Pack。
 
 默认库为 AW；EA 需要 `--library ea --base-url "<获授权的网关>"`，
 也可设置 `FORGEAX_ASSET_LIBRARY_BASE_URL`。显式 URL 不会在失败后回退。
@@ -35,14 +40,39 @@ npx -y @forgeax/game@0.3.8 asset3d import --query "wooden crate" --asset-id "<
 |:--|:--|
 | enable | 探测服务，保存配置和 Skill |
 | doctor --json | 本地配置、Engine 与 CLI 身份；可恢复中断的提交，不代表远端可访问 |
-| candidates --query … --json | 返回候选 ID、名称、格式；不暴露签名下载 URL |
-| import --query … --asset-id … --json | 重新确认候选，下载、完整性校验、Engine 导入和身份读回 |
+| candidates [--query …] --json | 返回描述、风格、缩略图、版本等选择信息；不暴露资产签名下载 URL |
+| import [--query …] (--asset-id … \| --candidate-file … --candidate-name …) [--version …] --json | 从保存的候选按唯一名称取 ID/当前版本，或传入显式 ID；按同一查询/筛选重新确认，再下载、校验、Engine 导入和身份读回 |
 | disable --json | 撤销 Skill、配置和临时数据；修改过的 Skill 移到非发现目录备份，保留资产和共享凭证 |
 
 原生 `.pack.ts/.pack.json` 及其辅助文件保留完整；不伪装成 GLB。
 导入源位于 `assets/3d/ea-3d/<assetId>`，结果返回 `deliveredFormat` 与 Engine GUID。
 同摘要资产校验后可复用；已有内容发生变化时失败，不静默覆盖。
 
+## 选择和使用资产
+
+搜索以 1–3 个英文关键词表达对象/用途，默认类型为 1（3D 模型），混合检索阈值 0.3、
+最多 10 个候选。`--query` 可省略，成功响应缺失/空 `asset_list` 返回空候选。
+不在 CLI 中自动改写用户需求或取消筛选；Skill 引导模型在无结果时放宽非必要条件一次。
+
+| 参数 | 含义 |
+|:--|:--|
+| `--asset-type` | 1 模型、2 纹理、3 BGM、5 动画模型、6 VFX、7 音效、8 材质、9 天空盒、11 Kit |
+| `--category` | 类别硬筛选，3/11 不适用 |
+| `--art-style` / `--theme-style` | 服务枚举硬筛选，3/7/11 不适用 |
+| `--engine-version` | 单一 Engine 版本硬筛选；不推测版本号 |
+| `--version` | 仅 import：明确选择候选 `versions[].versionName` |
+| `--candidate-file` / `--candidate-name` | 仅 import：从已保存的 `candidates --json` 响应选唯一全名或文件名，避免手抄长 ID；不能与 `--asset-id` 同用 |
+
+模型使用 `description`、`detailedDescription`、`category`、`artStyle`、`themeStyle`、
+`customTags` 和可选 `thumbnailUrl` 判断用途与视觉匹配，不只按分数或排名。
+缩略图链接是临时预览数据，不写入项目源文件；资产下载 URL 由 CLI 内部使用。
+版本列表保留 `engineVersions`，缺失字段不等于兼容；版本筛选匹配到非当前版本时，
+必须显式选择该版本，不能回退下载顶层/current URL。
+
+搜索类型支持不等于导入格式支持：目前仍只导入 Pack/GLB 及包含它们的 ZIP，
+不承诺独立音频、图片或任意 Kit 可被 Engine 导入。导入后读取资产 README/manifest，
+检查尺寸、朝向、材质、动画和碰撞能力，再通过 GUID 实例化并在 Preview 验证。
+
 请求不跟随重定向，下载只允许 enable 确认的来源，不带 API Key；
 ZIP 解压限制路径、文件数、单文件和总大小。下载器不执行源码，
 但 Engine 构建 Pack 会执行其中代码，因此资产库必须受信。

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "bun@1.4.0",
   "name": "@forgeax/game",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "private": false,
   "type": "module",
   "description": "@forgeax/game — an MCP/CLI connector for exact released ForgeaX Engine games and Engine-owned Preview.",
@@ -45,7 +45,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@forgeax/engine-sdk": "0.1.26",
+    "@forgeax/engine-sdk": "0.2.1",
     "pnpm": "11.7.0"
   },
   "devDependencies": {