@forgeax/game 0.3.4 → 0.3.6

package/docs/asset3d.md

@@ -137,6 +137,14 @@ has its path, byte count, and digest in the ownership manifest.
 
 ## Transaction protocol
 
+For native Packs, first call `list_asset_candidates` with English queries and
+choose a suitable returned `assetId` by name and format. This does not download
+assets or call an auxiliary LLM. Keep the same query text in `asset3d begin`, then
+call `search_asset` with `queries: [{content: "<query>", assetId: "<selected ID>"}]`
+and `output_format: "asset"`. The Provider checks that the ID still belongs to the
+live query results; an invented or stale ID fails instead of selecting another
+asset. A GLB result does not prove native Pack support.
+
 1. `asset3d begin` records a private journal with a new execution UUID, query digest,
    provider identity, exact Engine identity, requested count, and the only allowed
    quarantine root.
@@ -154,7 +162,8 @@ has its path, byte count, and digest in the ownership manifest.
 6. A 30-second per-asset lock serializes publication at
    `assets/3d/ea-3d/<safeAssetId>`. The complete prior directory is preserved as the
    refresh/rollback snapshot.
-7. With the game root as `cwd`, Game Plugin runs the exact released Engine CLI:
+7. With the game root as `cwd`, Game Plugin runs the exact released Engine CLI.
+   For GLB imports:
 
    ```text
    asset add assets/3d/ea-3d/<safeAssetId> --reimport-policy semantic-only --json
@@ -166,6 +175,9 @@ has its path, byte count, and digest in the ownership manifest.
    Each command must produce exactly one newline-terminated, at-most-1-MiB
    `CommandEnvelope@1.0.0`. Game Plugin does not filter diagnostic stdout into a
    synthetic success.
+   Native Pack sources instead use the Engine build and verified build catalog;
+   the plugin preserves the complete source closure and reads cooked scene/mesh
+   GUIDs back. It does not run `asset add` on `.pack.ts` or `.pack.json`.
 8. Only after Engine readback succeeds does `.forgeax-asset.json` publish the provider
    commit, origin-set digest, exact Engine version/commit, per-file role/digest/bytes,
    Engine rows, and catalog readback. An Engine failure restores the whole previous

package/docs/release-0.3.5.md

@@ -0,0 +1,32 @@
+# @forgeax/game 0.3.5
+
+## Compatibility repair
+
+| Boundary | Release behavior |
+|:--|:--|
+| Engine SDK | Exact dependency 0.1.26, commit `f3d0db12405e168e4204e32a9cde32e0df8d87ae` |
+| Project discovery | Recognizes strict `forge.json` v2 with `defaultScene`; does not inject the forbidden legacy `entry` field |
+| SDK manifest | Validates the released 1.7.0 manifest and exact Engine/DevKit identities |
+| Preview | Uses Engine-owned `--port 0` allocation instead of conflicting with another game on port 5173 |
+| Asset3D upgrade | Refreshes existing older package-owned bridges during install/update; preserves custom configurations |
+
+## Install or update
+
+```bash
+npx -y @forgeax/game@0.3.5 install --ide codex,cursor,claude
+# In a genuinely empty game directory:
+npx -y @forgeax/game@0.3.5 init
+```
+
+For an existing Engine 0.1.26 project, run `update --ide codex` with this package,
+then restart the host session. Asset3D remains opt-in with `asset3d enable`.
+
+> [!IMPORTANT]
+> This release pins Engine 0.1.26. It does not silently migrate games using Engine
+> 0.1.7. Keep those games on plugin 0.3.4 until deliberately migrating through the
+> Engine-supported workflow. Do not add `entry` to a v2 manifest to work around the
+> old plugin's project detection.
+
+The plugin must return Engine-owned Preview readiness and matching root/build
+identity. A direct Engine CLI preview or a listening port alone is not MCP
+acceptance. Asset search/import and visible gameplay require separate verification.

package/package.json

@@ -1,7 +1,7 @@
 {
-  "packageManager": "bun@1.3.14",
+  "packageManager": "bun@1.4.0",
   "name": "@forgeax/game",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "private": false,
   "type": "module",
   "description": "@forgeax/game — an MCP/CLI connector for exact released ForgeaX Engine games and Engine-owned Preview.",
@@ -26,6 +26,7 @@
     "docs/release-0.3.2.md",
     "docs/release-0.3.3.md",
     "docs/release-0.3.4.md",
+    "docs/release-0.3.5.md",
     "README.md"
   ],
   "scripts": {
@@ -51,7 +52,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@forgeax/engine-sdk": "0.1.7",
+    "@forgeax/engine-sdk": "0.1.26",
     "pnpm": "11.7.0"
   },
   "devDependencies": {