@forgeax/engine-devkit 0.1.4 → 0.1.6

package/README.md

@@ -36,11 +36,16 @@ forgeax list --json
 forgeax describe project.build --json
 forgeax run project.build --input request.json --json
 forgeax exec program.mjs --json
-forgeax run rhi.capture
-forgeax run rhi.summary --artifact {ArtifactRef}
-forgeax run rhi.inspect --artifact {ArtifactRef} --work-index {workIndex}
+forgeax run rhi.summary --artifact .forgeax-debug/{runId}/frame.rhitape --digest {sha256}
+forgeax run rhi.inspect --artifact .forgeax-debug/{runId}/frame.rhitape --digest {sha256} --work-index {workIndex}
 ```
 
+> [!IMPORTANT]
+> `forgeax dev` is a source-development server and `forgeax preview` is a
+> verified static `dist/` server. Their `--json` startup envelopes expose
+> `mode`, `serves`, and the current `rhi.capture` capability. Neither command
+> silently invents a live capture attachment.
+
 Static deployment is an Engine-owned build product. A publishing host supplies
 the project root, public URL base, and dedicated output directory; DevKit owns
 the generated host, asset cooking, shader compilation, Pack index, and
@@ -85,13 +90,23 @@ through to another realm.
 
 ## RHI-debug operations
 
+The operation manifest describes the complete host contract, but a standalone
+CLI process does not own a running browser App. Consequently,
+`forgeax run rhi.capture --json` is a structured capability probe and returns
+`capture-unavailable` until a recorder-enabled live host supplies the
+`rhiCapture` eval root. Use the browser live bridge described by the
+`forgeax-engine-cli` skill to invoke that root; preserve the resulting tape's
+`digest` and `path` for the offline commands below. `rhi.summary` and
+`rhi.inspect` remain directly executable because they consume the persisted
+artifact rather than live App state.
+
 ```mermaid
 sequenceDiagram
   participant AI as "AI or CLI"
   participant H as "Host"
   participant D as "DevKit"
   participant R as "Fresh replay backend"
-  AI->>H: "rhi.capture"
+  AI->>H: "rhiCapture.captureFrame through the live host"
   H-->>AI: "one ArtifactRef"
   AI->>D: "rhi.summary + ArtifactRef"
   D-->>AI: "FrameModel and workIndex"