@assethub/cli 0.1.15 → 0.1.16

package/README.md

@@ -141,7 +141,7 @@ Existing parts commands use the same canvas and durable operation storage:
 assethub parts split --source-id "$IMAGE_ASSET_ID" --canvas "$CANVAS_ID" --part-extractor V1.5 --wait
 # Select only the parts to execute; --all-ready selects all ready tasks.
 assethub parts split --source-id "$IMAGE_ASSET_ID" --canvas "$CANVAS_ID" --part-extractor V1.5 --all-ready --wait
-# Internal V3.6.1 runs the complete graph split through one analyze receipt.
+# Internal V3.6.1 and V3.6.3 run the complete graph split through one analyze receipt.
 assethub production agents
 assethub parts split --source-id "$IMAGE_ASSET_ID" --canvas "$CANVAS_ID" --part-extractor V3.6.1 --all-ready --wait
 assethub production automation --canvas "$CANVAS_ID" --input-json @batch.json --wait
@@ -149,7 +149,8 @@ assethub production automation --canvas "$CANVAS_ID" --input-json @batch.json --
 
 `parts split` keeps separate analysis and selected-part execution phases. Each phase
 has its own saved operation ID, with the execution linked to the analysis run.
-For Internal `V3.6.1` (`V3.6.1 Primary Images First`), analysis runs the complete
+For Internal `V3.6.1` (`V3.6.1 Primary Images First`) and `V3.6.3`
+(`V3.6.3 Fast Analysis`, CLI 0.1.16+), analysis runs the complete
 Artifact Graph split. `--all-ready` waits for that one receipt and does not start a
 second production execution. Resume an interrupted graph split with
 `runs resume <operation-id>`; `--task-id`, `--mission-id`,
@@ -419,8 +420,11 @@ Image generation uses the `v2` endpoint with mandatory canvas history.
 `--api-version v1` is rejected; run `assethub capabilities` to check availability.
 
 Part extraction uses the same names shown in the AssetHub product: `V1.5`,
-`V2.0 alpha`, `V2.1 alpha`, and the Internal-only `V3.6.1` alias for
-`V3.6.1 Primary Images First`. Retired names are no longer accepted by the CLI.
+`V2.0 alpha`, `V2.1 alpha`, and the Internal-only aliases `V3.6.1`
+(`V3.6.1 Primary Images First`) and `V3.6.3` (`V3.6.3 Fast Analysis`).
+Run `production agents` to check availability and `supportedOnGraphEndpoint`
+before selecting a graph version. These aliases do not change the default.
+Retired names are no longer accepted by the CLI.
 Internal agent IDs are intentionally not part of the CLI interface.
 
 The CLI only uses AssetHub's public API surface and is designed so this package
@@ -464,6 +468,13 @@ and each mode's `--max-rounds` policy come from `composer refine --list-modes`.
 Incomplete native results remain `needs_review` and return exit code 3, so inspect
 the execution and its new geometry asset IDs before continuing.
 
+Native refinement `completed` or `reviewed` means execution finished; it is not
+creator approval. Read `execution.refinement.report` and inspect the actual
+`execution.composition` and downloaded meshes. Structured unresolved issues or
+incomplete refinement can return `needs_review` (exit 3). Review narrative issues
+even on completed runs, using overlays and oblique/side views before claiming
+visual improvement.
+
 Existing Production outputs can be inspected and downloaded without regenerating:
 
 ```sh

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAsBA,OAAO,EAIL,KAAK,wBAAwB,EAO7B,KAAK,YAAY,EAEjB,KAAK,UAAU,EAgBhB,MAAM,sBAAsB,CAAA;AAa7B,OAAO,EAAC,kBAAkB,EAAc,MAAM,gCAAgC,CAAA;AAI9E,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;AA8HxD,eAAO,MAAM,KAAK,4zZA4HjB,CAAA;AAq1ED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,KACX,wBA0BF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,KAAK,KACX,IAAI,CAAC,UAAU,EAAE,QAAQ,CAM1B,CAAA;AA6fF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,SAAS,MAAM,EAAE,KACtB,YAAY,EAuGd,CAAA;AAkqCD,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,OAAO,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,GAAG,SAAS,EAC9B,aAAa,MAAM,EAAE,EACrB,OAAO,KAAK,KACX,cAoBF,CAAA;AAED,KAAK,iBAAiB,GAAG,IAAI,CAC3B,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,EAC5C,SAAS,GACT,UAAU,GACV,KAAK,GACL,WAAW,GACX,QAAQ,GACR,OAAO,GACP,OAAO,GACP,UAAU,CACb,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EACjB,MAAM,iBAAiB;;;;;;;;;;;;;;CAUvB,CAAA;AAEF,eAAO,MAAM,sBAAsB,GACjC,SAAS,UAAU,CAAC,OAAO,iBAAiB,CAAC,EAC7C,MAAM,iBAAiB,EACvB,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;CAYf,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAsBA,OAAO,EAIL,KAAK,wBAAwB,EAO7B,KAAK,YAAY,EAEjB,KAAK,UAAU,EAgBhB,MAAM,sBAAsB,CAAA;AAa7B,OAAO,EAAC,kBAAkB,EAAc,MAAM,gCAAgC,CAAA;AAI9E,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;AAoIxD,eAAO,MAAM,KAAK,4zZA4HjB,CAAA;AAq1ED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,KACX,wBA0BF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,KAAK,KACX,IAAI,CAAC,UAAU,EAAE,QAAQ,CAM1B,CAAA;AA6fF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,SAAS,MAAM,EAAE,KACtB,YAAY,EAuGd,CAAA;AAmqCD,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,OAAO,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,GAAG,SAAS,EAC9B,aAAa,MAAM,EAAE,EACrB,OAAO,KAAK,KACX,cAoBF,CAAA;AAED,KAAK,iBAAiB,GAAG,IAAI,CAC3B,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,EAC5C,SAAS,GACT,UAAU,GACV,KAAK,GACL,WAAW,GACX,QAAQ,GACR,OAAO,GACP,OAAO,GACP,UAAU,CACb,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EACjB,MAAM,iBAAiB;;;;;;;;;;;;;;CAUvB,CAAA;AAEF,eAAO,MAAM,sBAAsB,GACjC,SAAS,UAAU,CAAC,OAAO,iBAAiB,CAAC,EAC7C,MAAM,iBAAiB,EACvB,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;CAYf,CAAA"}

package/dist/index.js

@@ -28,7 +28,7 @@ const defaultImageModelId = 'imageGen.nanoBanana2.openrouter';
 const defaultMeshModelId = 'meshGen.hunyuan31';
 const defaultProfileName = 'default';
 const defaultPartExtractorName = 'V1.5';
-const artifactGraphPartExtractorApiValue = 'ah_agent_graph_v3_6_1';
+const isArtifactGraphPartExtractor = (value) => value === 'ah_agent_graph_v3_6_1' || value === 'ah_agent_graph_v3_6_3';
 const partExtractorOptions = [
     {
         publicName: 'V1.5',
@@ -47,9 +47,14 @@ const partExtractorOptions = [
     },
     {
         publicName: 'V3.6.1',
-        apiValue: artifactGraphPartExtractorApiValue,
+        apiValue: 'ah_agent_graph_v3_6_1',
         aliases: ['v3.6.1', '3.6.1', 'v3.6.1 primary images first'],
     },
+    {
+        publicName: 'V3.6.3',
+        apiValue: 'ah_agent_graph_v3_6_3',
+        aliases: ['v3.6.3', '3.6.3', 'v3.6.3 fast analysis'],
+    },
 ];
 const partExtractorPublicNames = partExtractorOptions
     .map(option => option.publicName)
@@ -2746,7 +2751,7 @@ const isArtifactGraphPartSplit = (value, execution) => (value != null &&
     typeof value === 'object' &&
     'engine' in value &&
     value.engine === 'artifact-graph') ||
-    execution.resolvedInput?.agentVersion === artifactGraphPartExtractorApiValue;
+    isArtifactGraphPartExtractor(execution.resolvedInput?.agentVersion);
 const commandParts = async (subcommand, ctx) => {
     const runPartSplit = async (source, operationId = getFlag(ctx.flags, 'operation-id') ?? randomUUID()) => {
         let orderId = source == null ? getFlag(ctx.flags, 'order-id') : undefined;
@@ -2757,13 +2762,14 @@ const commandParts = async (subcommand, ctx) => {
         const requestedAgentVersion = orderId == null || partExtractorFlag != null
             ? resolvePartExtractorApiValue(partExtractorFlag ?? defaultPartExtractorName)
             : undefined;
-        if (requestedAgentVersion === artifactGraphPartExtractorApiValue) {
+        if (isArtifactGraphPartExtractor(requestedAgentVersion)) {
+            const name = partExtractorPublicNameByApiValue.get(requestedAgentVersion);
             for (const flag of ['task-id', 'mission-id', 'part-extraction-mode']) {
                 if (hasFlag(ctx.flags, flag))
-                    throw new Error(`--${flag} is not supported with V3.6.1`);
+                    throw new Error(`--${flag} is not supported with ${name}`);
             }
             if (orderId != null)
-                throw new Error('--order-id is not supported with V3.6.1; use runs resume <operation-id> to resume a graph split');
+                throw new Error(`--order-id is not supported with ${name}; use runs resume <operation-id> to resume a graph split`);
         }
         const session = await productionSession(ctx, orderId == null ? 'production.analyze' : 'production.execute');
         let execution;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assethub/cli",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Command line interface for AssetHub.",
   "type": "module",
   "bin": {