@nexusclawhq/cli 0.3.26 → 0.3.27

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.3.27 - 2026-08-03
+
+- Introduce the complete v2 CLI command-contract inventory for every executable
+  leaf and mode, with one canonical machine-result envelope and outermost error
+  boundary across legacy and current command families.
+- Add registry-derived success, empty, failure, and dry-run contract coverage,
+  including exit-code equality, stdout/stderr isolation, redaction, resource
+  hygiene, and persistent side-effect checks.
+- Make the focused CLI command-contract gate release-blocking and expose the
+  complete implemented inventory through machine-readable AI help.
+
 ## 0.3.26 - 2026-08-02
 
 - Keep `workspace health` JSON envelope and process exit semantics aligned for

package/dist/build-info.json

@@ -1,8 +1,8 @@
 {
   "packageName": "@nexusclawhq/cli",
-  "version": "0.3.26",
-  "gitSha": "c4922a47e26700c8f121d74921eb40d417cbdfa2",
+  "version": "0.3.27",
+  "gitSha": "11a23ccec61ac33bd99331a5517019fd01d457bf",
   "ciRunId": null,
-  "contentDigest": "sha256:a2e5fa18c91dc3676a872532be375c83f695f7f3633286c45ff1c1741184cebf",
-  "generatedAt": "2026-08-02T13:17:53.782Z"
+  "contentDigest": "sha256:91e277b464f261562326f77735a60cf1fb9d29e30147831b1353774d404f0918",
+  "generatedAt": "2026-08-02T23:23:46.412Z"
 }

package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/cli-contract.types.d.ts

@@ -7,7 +7,7 @@
  * registry is owned by the CLI package; these types are the shared import
  * surface consumed by backend guard parity checks as well.
  */
-import { CLI_COMMAND_CONTRACT_SCHEMA_VERSION, CLI_RESULT_SCHEMA_VERSION } from './contract-versions';
+import { CLI_COMMAND_CONTRACT_SCHEMA_VERSION, CLI_COMMAND_CONTRACT_SCHEMA_VERSION_V2, CLI_RESULT_SCHEMA_VERSION } from './contract-versions';
 import type { JsonValue } from './json-value';
 export type CliExitCode = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 64 | 70;
 export type CliArgvSchemaMatcher = 'uuid' | 'sha256' | 'positive_integer';
@@ -93,6 +93,42 @@ export interface CliCommandContractV1 {
     }>;
     readonly contractCompleteness: 'complete' | 'derived' | 'partial';
 }
+export type CliOutputModeV2 = 'human' | 'machine' | 'dual';
+export type CliMutabilityV2 = 'read-only' | 'local-write' | 'remote-write';
+export interface CliDryRunExemptionV2 {
+    readonly owner: string;
+    readonly reason: string;
+    readonly exitCriteria: string;
+    /** ISO-8601 calendar date. An expired exemption fails the CLI owner gate. */
+    readonly expiresOn: string;
+}
+export interface CliInvocationPolicyV2 {
+    readonly outputMode: CliOutputModeV2;
+    readonly mutability: CliMutabilityV2;
+    readonly supportsDryRun: boolean;
+    readonly dryRunExemption?: CliDryRunExemptionV2;
+    readonly environmentOption: '--env' | null;
+    readonly environmentAliases: ReadonlyArray<string>;
+    readonly workspaceOption: '--workspace-id' | null;
+    readonly localWorkspaceOption: '--workspace' | null;
+    readonly exitCodes: {
+        readonly success: ReadonlyArray<CliExitCode>;
+        readonly warning: ReadonlyArray<CliExitCode>;
+        readonly error: ReadonlyArray<CliExitCode>;
+    };
+}
+export interface CliExecutionModeV2 extends CliExecutionModeV1 {
+    readonly invocationPolicy: CliInvocationPolicyV2;
+}
+/**
+ * v2 covers every executable Commander leaf. v1 stays frozen for consumers of
+ * the original executable-asset subset; callers must never treat a partial
+ * v1-to-v2 projection as satisfying the completeness gate.
+ */
+export interface CliCommandContractV2 extends Omit<CliCommandContractV1, 'schemaVersion' | 'executionModes'> {
+    readonly schemaVersion: typeof CLI_COMMAND_CONTRACT_SCHEMA_VERSION_V2;
+    readonly executionModes: ReadonlyArray<CliExecutionModeV2>;
+}
 export interface CliDiagnosticV1 {
     readonly code: string;
     readonly severity: 'error' | 'warning' | 'info';

package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/contract-versions.d.ts

@@ -66,8 +66,12 @@ export declare const WORKFORCE_RELEASE_HEAD_CHANGED_EVENT: "ai.workforce.release
 export declare const CODE_ACTION_REVOKED_EVENT: "ai.workforce.code-action.revoked.v1";
 /** Machine-readable command-contract registry version. */
 export declare const CLI_COMMAND_CONTRACT_SCHEMA_VERSION: "nexusclaw.cli-command-contract/v1";
+/** Complete all-Commander-leaf contract with invocation/output policy. */
+export declare const CLI_COMMAND_CONTRACT_SCHEMA_VERSION_V2: "nexusclaw.cli-command-contract/v2";
 /** Exported registry document containing every command contract. */
 export declare const CLI_COMMAND_REGISTRY_SCHEMA_VERSION: "nexusclaw.cli-command-registry/v1";
+/** Complete all-Commander-leaf registry. */
+export declare const CLI_COMMAND_REGISTRY_SCHEMA_VERSION_V2: "nexusclaw.cli-command-registry/v2";
 /** The single machine result envelope emitted on `--json` stdout. */
 export declare const CLI_RESULT_SCHEMA_VERSION: "nexusclaw.cli-result/v1";
 /** Deterministic command-order DAG (implemented modes only). */
@@ -122,4 +126,4 @@ export declare const APPROVAL_SUBJECT_LEGACY: "legacy";
 export declare const APPROVAL_POLICY_PURPOSE_TOOL_CALL: "tool_call";
 export declare const APPROVAL_POLICY_PURPOSE_WORKFORCE_RELEASE: "workforce_release";
 /** All schema-version string literals as a discriminated alias. */
-export type AgentExecutableAssetSchemaVersion = typeof BUNDLE_SCHEMA_VERSION | typeof RUNTIME_BINDINGS_SCHEMA_VERSION | typeof BUNDLE_LOCK_SCHEMA_VERSION | typeof CONNECTOR_BINDING_REVISION_SCHEMA_VERSION | typeof AGENT_CODE_TOOL_CATALOG_SCHEMA_VERSION | typeof AGENT_CODE_TOOL_EXPORT_SCHEMA_VERSION | typeof ACTION_CONTRACT_VERSION | typeof RUNTIME_API_VERSION_V2 | typeof FLOWS_PAYLOAD_V2 | typeof FLOWS_PAYLOAD_V1 | typeof CLI_COMMAND_CONTRACT_SCHEMA_VERSION | typeof CLI_COMMAND_REGISTRY_SCHEMA_VERSION | typeof CLI_RESULT_SCHEMA_VERSION | typeof COMMAND_ORDER_SCHEMA_VERSION | typeof AI_AUTHORING_CONTEXT_SCHEMA_VERSION | typeof AI_AUTHORING_CONTEXT_LOCK_SCHEMA_VERSION;
+export type AgentExecutableAssetSchemaVersion = typeof BUNDLE_SCHEMA_VERSION | typeof RUNTIME_BINDINGS_SCHEMA_VERSION | typeof BUNDLE_LOCK_SCHEMA_VERSION | typeof CONNECTOR_BINDING_REVISION_SCHEMA_VERSION | typeof AGENT_CODE_TOOL_CATALOG_SCHEMA_VERSION | typeof AGENT_CODE_TOOL_EXPORT_SCHEMA_VERSION | typeof ACTION_CONTRACT_VERSION | typeof RUNTIME_API_VERSION_V2 | typeof FLOWS_PAYLOAD_V2 | typeof FLOWS_PAYLOAD_V1 | typeof CLI_COMMAND_CONTRACT_SCHEMA_VERSION | typeof CLI_COMMAND_CONTRACT_SCHEMA_VERSION_V2 | typeof CLI_COMMAND_REGISTRY_SCHEMA_VERSION | typeof CLI_COMMAND_REGISTRY_SCHEMA_VERSION_V2 | typeof CLI_RESULT_SCHEMA_VERSION | typeof COMMAND_ORDER_SCHEMA_VERSION | typeof AI_AUTHORING_CONTEXT_SCHEMA_VERSION | typeof AI_AUTHORING_CONTEXT_LOCK_SCHEMA_VERSION;

package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/contract-versions.js

@@ -11,8 +11,8 @@
  * edit: it requires paired schema/test/release-evidence updates.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CODE_ACTION_CASES_SCHEMA_VERSION = exports.WORKFORCE_RELEASE_EVIDENCE_SCHEMA_VERSION = exports.EMPLOYEE_PACKAGE_V2_SCHEMA_VERSION = exports.FLOW_PACKAGE_SCHEMA_VERSION = exports.FLOW_NODE_CATALOG_SCHEMA_VERSION = exports.INVOKABLE_AUTHORING_CATALOG_SCHEMA_VERSION = exports.APPROVAL_POLICY_AUTHORING_CATALOG_SCHEMA_VERSION = exports.AI_POLICY_AUTHORING_CATALOG_SCHEMA_VERSION = exports.CONNECTOR_AUTHORING_CATALOG_SCHEMA_VERSION = exports.OBJECT_AUTHORING_CATALOG_SCHEMA_VERSION = exports.AI_CONTEXT_SIGNING_KEY_CACHE_SCHEMA_VERSION = exports.AI_CONTEXT_SIGNING_KEYRING_SCHEMA_VERSION = exports.AI_CONTEXT_SIGNING_KEY_SET_SCHEMA_VERSION = exports.AI_CONTEXT_SIGNATURE_ALG_NONE = exports.AI_CONTEXT_SIGNATURE_ALG_ED25519 = exports.AI_CONTEXT_SIGNATURE_TYP = exports.WORKSPACE_AUTHORING_CONTRACT_SCHEMA_VERSION = exports.AI_AUTHORING_CONTEXT_LOCK_SCHEMA_VERSION = exports.AI_AUTHORING_CONTEXT_SCHEMA_VERSION = exports.CLI_CONTRACT_HUMAN_HELP_POINTER = exports.COMMAND_ORDER_SCHEMA_VERSION = exports.CLI_RESULT_SCHEMA_VERSION = exports.CLI_COMMAND_REGISTRY_SCHEMA_VERSION = exports.CLI_COMMAND_CONTRACT_SCHEMA_VERSION = exports.CODE_ACTION_REVOKED_EVENT = exports.WORKFORCE_RELEASE_HEAD_CHANGED_EVENT = exports.RELEASE_SET_ELIGIBILITY_REJECTED = exports.RELEASE_SET_ELIGIBILITY_ELIGIBLE = exports.RELEASE_SET_ELIGIBILITY_STAGED = exports.APPROVAL_SUBJECT_DECIDED_EVENT = exports.FLOW_ACTION_TYPE_INVOKE_UNIT = exports.RULE_SUGAR_INVOKE_ACTION = exports.FLOWS_PAYLOAD_V1 = exports.FLOWS_PAYLOAD_V2 = exports.CODE_RUNTIME_ISOLATION_EVIDENCE_SCHEMA_VERSION = exports.SANDBOX_PAYLOAD_CIPHER_SCHEMA_VERSION = exports.SANDBOX_EXECUTION_RESULT_SCHEMA_VERSION = exports.SANDBOX_EXECUTION_TICKET_SCHEMA_VERSION = exports.WORKER_THREAD_PROVIDER_ID = exports.VERIFIED_ISOLATE_PROVIDER_ID = exports.RUNTIME_API_VERSION_V2 = exports.ACTION_CONTRACT_VERSION = exports.AGENT_CODE_TOOL_EXPORT_SCHEMA_VERSION = exports.AGENT_CODE_TOOL_CATALOG_SCHEMA_VERSION = exports.CODE_EXTENSION_GOVERNANCE_V1 = exports.CODE_EXTENSION_GOVERNANCE_V2 = exports.CONNECTOR_BINDING_REVISION_SCHEMA_VERSION = exports.BUNDLE_LOCK_SCHEMA_VERSION = exports.RUNTIME_BINDINGS_SCHEMA_VERSION = exports.BUNDLE_SCHEMA_VERSION = void 0;
-exports.APPROVAL_POLICY_PURPOSE_WORKFORCE_RELEASE = exports.APPROVAL_POLICY_PURPOSE_TOOL_CALL = exports.APPROVAL_SUBJECT_LEGACY = exports.APPROVAL_SUBJECT_FLOW_TOOL = exports.APPROVAL_SUBJECT_AGENT_TOOL = exports.APPROVAL_SUBJECT_WORKFORCE_RELEASE = exports.IDEMPOTENCY_DOMAIN_CODE_ACTION_WRITE = exports.IDEMPOTENCY_DOMAIN_RECORD_CURSOR = exports.CANONICAL_ARCHIVE_FORMAT = exports.JSZIP_VERSION = exports.AJV_VERSION = exports.TYPESCRIPT_VERSION = void 0;
+exports.EMPLOYEE_PACKAGE_V2_SCHEMA_VERSION = exports.FLOW_PACKAGE_SCHEMA_VERSION = exports.FLOW_NODE_CATALOG_SCHEMA_VERSION = exports.INVOKABLE_AUTHORING_CATALOG_SCHEMA_VERSION = exports.APPROVAL_POLICY_AUTHORING_CATALOG_SCHEMA_VERSION = exports.AI_POLICY_AUTHORING_CATALOG_SCHEMA_VERSION = exports.CONNECTOR_AUTHORING_CATALOG_SCHEMA_VERSION = exports.OBJECT_AUTHORING_CATALOG_SCHEMA_VERSION = exports.AI_CONTEXT_SIGNING_KEY_CACHE_SCHEMA_VERSION = exports.AI_CONTEXT_SIGNING_KEYRING_SCHEMA_VERSION = exports.AI_CONTEXT_SIGNING_KEY_SET_SCHEMA_VERSION = exports.AI_CONTEXT_SIGNATURE_ALG_NONE = exports.AI_CONTEXT_SIGNATURE_ALG_ED25519 = exports.AI_CONTEXT_SIGNATURE_TYP = exports.WORKSPACE_AUTHORING_CONTRACT_SCHEMA_VERSION = exports.AI_AUTHORING_CONTEXT_LOCK_SCHEMA_VERSION = exports.AI_AUTHORING_CONTEXT_SCHEMA_VERSION = exports.CLI_CONTRACT_HUMAN_HELP_POINTER = exports.COMMAND_ORDER_SCHEMA_VERSION = exports.CLI_RESULT_SCHEMA_VERSION = exports.CLI_COMMAND_REGISTRY_SCHEMA_VERSION_V2 = exports.CLI_COMMAND_REGISTRY_SCHEMA_VERSION = exports.CLI_COMMAND_CONTRACT_SCHEMA_VERSION_V2 = exports.CLI_COMMAND_CONTRACT_SCHEMA_VERSION = exports.CODE_ACTION_REVOKED_EVENT = exports.WORKFORCE_RELEASE_HEAD_CHANGED_EVENT = exports.RELEASE_SET_ELIGIBILITY_REJECTED = exports.RELEASE_SET_ELIGIBILITY_ELIGIBLE = exports.RELEASE_SET_ELIGIBILITY_STAGED = exports.APPROVAL_SUBJECT_DECIDED_EVENT = exports.FLOW_ACTION_TYPE_INVOKE_UNIT = exports.RULE_SUGAR_INVOKE_ACTION = exports.FLOWS_PAYLOAD_V1 = exports.FLOWS_PAYLOAD_V2 = exports.CODE_RUNTIME_ISOLATION_EVIDENCE_SCHEMA_VERSION = exports.SANDBOX_PAYLOAD_CIPHER_SCHEMA_VERSION = exports.SANDBOX_EXECUTION_RESULT_SCHEMA_VERSION = exports.SANDBOX_EXECUTION_TICKET_SCHEMA_VERSION = exports.WORKER_THREAD_PROVIDER_ID = exports.VERIFIED_ISOLATE_PROVIDER_ID = exports.RUNTIME_API_VERSION_V2 = exports.ACTION_CONTRACT_VERSION = exports.AGENT_CODE_TOOL_EXPORT_SCHEMA_VERSION = exports.AGENT_CODE_TOOL_CATALOG_SCHEMA_VERSION = exports.CODE_EXTENSION_GOVERNANCE_V1 = exports.CODE_EXTENSION_GOVERNANCE_V2 = exports.CONNECTOR_BINDING_REVISION_SCHEMA_VERSION = exports.BUNDLE_LOCK_SCHEMA_VERSION = exports.RUNTIME_BINDINGS_SCHEMA_VERSION = exports.BUNDLE_SCHEMA_VERSION = void 0;
+exports.APPROVAL_POLICY_PURPOSE_WORKFORCE_RELEASE = exports.APPROVAL_POLICY_PURPOSE_TOOL_CALL = exports.APPROVAL_SUBJECT_LEGACY = exports.APPROVAL_SUBJECT_FLOW_TOOL = exports.APPROVAL_SUBJECT_AGENT_TOOL = exports.APPROVAL_SUBJECT_WORKFORCE_RELEASE = exports.IDEMPOTENCY_DOMAIN_CODE_ACTION_WRITE = exports.IDEMPOTENCY_DOMAIN_RECORD_CURSOR = exports.CANONICAL_ARCHIVE_FORMAT = exports.JSZIP_VERSION = exports.AJV_VERSION = exports.TYPESCRIPT_VERSION = exports.CODE_ACTION_CASES_SCHEMA_VERSION = exports.WORKFORCE_RELEASE_EVIDENCE_SCHEMA_VERSION = void 0;
 // ---- Composite workforce bundle & bindings (design §5) ----------------------
 /** Source bundle contract. */
 exports.BUNDLE_SCHEMA_VERSION = 'ai-workforce-executable-bundle/v1';
@@ -76,8 +76,12 @@ exports.CODE_ACTION_REVOKED_EVENT = 'ai.workforce.code-action.revoked.v1';
 // ---- CLI machine contract (design §16) --------------------------------------
 /** Machine-readable command-contract registry version. */
 exports.CLI_COMMAND_CONTRACT_SCHEMA_VERSION = 'nexusclaw.cli-command-contract/v1';
+/** Complete all-Commander-leaf contract with invocation/output policy. */
+exports.CLI_COMMAND_CONTRACT_SCHEMA_VERSION_V2 = 'nexusclaw.cli-command-contract/v2';
 /** Exported registry document containing every command contract. */
 exports.CLI_COMMAND_REGISTRY_SCHEMA_VERSION = 'nexusclaw.cli-command-registry/v1';
+/** Complete all-Commander-leaf registry. */
+exports.CLI_COMMAND_REGISTRY_SCHEMA_VERSION_V2 = 'nexusclaw.cli-command-registry/v2';
 /** The single machine result envelope emitted on `--json` stdout. */
 exports.CLI_RESULT_SCHEMA_VERSION = 'nexusclaw.cli-result/v1';
 /** Deterministic command-order DAG (implemented modes only). */

package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/contract-versions.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract-versions.js","sourceRoot":"","sources":["../../src/agent-executable-assets/contract-versions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contract-versions.js","sourceRoot":"","sources":["../../src/agent-executable-assets/contract-versions.ts"],"names":[],"mappings":"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"}

package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/index.d.ts

@@ -20,7 +20,7 @@ export { validateWorkforceReleaseEvidencePayload, type CandidateEvidenceExecutio
 export { buildWorkforceReleaseGateReceipt } from './workforce-release-gate-receipt';
 export { FLOW_PAYLOAD_V2_VERSION, type FlowActionTypeV2, type FlowInvokeUnitActionSettingV2, type FlowInputMappingV2, type FlowErrorPolicyV2, type FlowFaultMarkerV2, type FlowRuleSugarActionTypeV2, type FlowRevisionIdentityV1, type WorkflowVersionLifecycleStatus, type ApprovalSubjectDecidedEventV1, type FlowBindingRiskLevelV2, } from './flow-payload-v2.types';
 export { type FlowRevisionDefinitionV2, canonicalizeFlowJsonPointer, normalizeFlowInputMappings, buildCanonicalFlowMappedInput, normalizeFlowRevisionDefinition, computeFlowRevisionIdentity, } from './flow-v2-canonical';
-export { type CliExitCode, type CliArgvSchemaMatcher, type CliArgvPredicateAtomV1, type CliArgvPredicateExprV1, type CliPermissionFactV1, type CliPermissionRuleV1, type CliPermissionProfileId, type CliEffectKind, type CliArgumentContract, type CliOptionContract, type CliExecutionModeV1, type CliCommandContractV1, type CliDiagnosticV1, type CliNextCommandV1, type CliEvidenceEntryV1, type CliResultV1, } from './cli-contract.types';
+export { type CliExitCode, type CliArgvSchemaMatcher, type CliArgvPredicateAtomV1, type CliArgvPredicateExprV1, type CliPermissionFactV1, type CliPermissionRuleV1, type CliPermissionProfileId, type CliEffectKind, type CliArgumentContract, type CliOptionContract, type CliExecutionModeV1, type CliCommandContractV1, type CliOutputModeV2, type CliMutabilityV2, type CliDryRunExemptionV2, type CliInvocationPolicyV2, type CliExecutionModeV2, type CliCommandContractV2, type CliDiagnosticV1, type CliNextCommandV1, type CliEvidenceEntryV1, type CliResultV1, } from './cli-contract.types';
 export { type AiContextPrincipalKind, type AiContextOnlineSelector, type AiContextSurface, type AiContextSha256, type DescribeAiAuthoringContextRequestV2, type AiAuthoringCandidateReleaseStampV1, type AiAuthoringCatalogDocumentV1, type AiAuthoringContextHashesV1, type AiAuthoringContextSnapshotV2, type VerifyAiAuthoringContextFreshnessRequestV2, type SignAiAuthoringContextLockRequestV2, type AiAuthoringContextVerificationV1, type AiAuthoringContextManifestV2, type AiAuthoringContextLockV2, type AiAuthoringContextDigestSetV1, type AiContextSignatureHeaderV1, type AiContextSignaturePayloadV1, type AiContextSigningPublicJwkV1, type AiContextSigningKeySetV1, type AiContextCommonFileEntry, AI_CONTEXT_COMMON_FILES, AI_CONTEXT_SURFACE_FILES, resolveAiContextFileMatrix, resolveAiContextManifestFileMatrix, assertAiContextDeclaredPaths, } from './ai-authoring-context.types';
 export { type Sha256Digest as CanonicalSha256Digest, canonicalJsonString, canonicalJsonDigest, rawByteDigest, rawStringDigest, aiAuthoringContextDigests, unsignedAiAuthoringContextLock, releaseItemSetDigest, type ReleaseItemDigestInput, portableBundleDigest, materializedItemRefsDigest, releaseEnvelopeDigest, selfExcludingDigest, escapeJsonPointer, parseSha256, isSha256Digest, } from './canonical-hash';
 export { type AiContextSigningErrorCode, AiContextSigningError, type AiContextDetachedSigningInput, type VerifyAiContextDetachedJwsInput, assertAiContextSigningKeySet, buildAiContextDetachedSigningInput, verifyAiContextDetachedJws, } from './ai-authoring-context-signing';

package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-executable-assets/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;AAEH,+EAA+E;AAC/E,sDAAoC;AAEpC,oCAAoC;AACpC,2CASsB;AAHpB,yGAAA,WAAW,OAAA;AACX,4GAAA,cAAc,OAAA;AACd,6GAAA,eAAe,OAAA;AAGjB,2EAA2E;AAC3E,sDAAoC;AAEpC,kFAAkF;AAClF,kEAAgD;AAChD,wEAAsD;AACtD,8EAA4D;AAC5D,mEAAiD;AAkCjD,6EAIuC;AAHrC,sJAAA,uCAAuC,OAAA;AAIzC,mFAAoF;AAA3E,kJAAA,gCAAgC,OAAA;AAEzC,mBAAmB;AACnB,iEAYiC;AAX/B,gIAAA,uBAAuB,OAAA;AAYzB,yDAO6B;AAL3B,gIAAA,2BAA2B,OAAA;AAC3B,+HAAA,0BAA0B,OAAA;AAC1B,kIAAA,6BAA6B,OAAA;AAC7B,oIAAA,+BAA+B,OAAA;AAC/B,gIAAA,2BAA2B,OAAA;AAuB7B,6BAA6B;AAC7B,2EA0BsC;AALpC,qIAAA,uBAAuB,OAAA;AACvB,sIAAA,wBAAwB,OAAA;AACxB,wIAAA,0BAA0B,OAAA;AAC1B,gJAAA,kCAAkC,OAAA;AAClC,0IAAA,4BAA4B,OAAA;AAG9B,qCAAqC;AACrC,mDAiB0B;AAfxB,qHAAA,mBAAmB,OAAA;AACnB,qHAAA,mBAAmB,OAAA;AACnB,+GAAA,aAAa,OAAA;AACb,iHAAA,eAAe,OAAA;AACf,2HAAA,yBAAyB,OAAA;AACzB,gIAAA,8BAA8B,OAAA;AAC9B,sHAAA,oBAAoB,OAAA;AAEpB,sHAAA,oBAAoB,OAAA;AACpB,4HAAA,0BAA0B,OAAA;AAC1B,uHAAA,qBAAqB,OAAA;AACrB,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AACjB,6GAAA,WAAW,OAAA;AACX,gHAAA,cAAc,OAAA;AAEhB,+EAQwC;AANtC,qIAAA,qBAAqB,OAAA;AAGrB,4IAAA,4BAA4B,OAAA;AAC5B,kJAAA,kCAAkC,OAAA;AAClC,0IAAA,0BAA0B,OAAA;AAG5B,6EAA6E;AAC7E,6FAM+C;AAL7C,yKAAA,kDAAkD,OAAA;AAGlD,gJAAA,yBAAyB,OAAA;AACzB,wIAAA,iBAAiB,OAAA;AAGnB,6CAA6C;AAC7C,uDAa4B;AAZ1B,qHAAA,iBAAiB,OAAA;AACjB,iHAAA,aAAa,OAAA;AACb,yHAAA,qBAAqB,OAAA;AACrB,oHAAA,gBAAgB,OAAA;AAChB,qHAAA,iBAAiB,OAAA;AACjB,kHAAA,cAAc,OAAA;AACd,sHAAA,kBAAkB,OAAA;AAClB,6HAAA,yBAAyB,OAAA;AACzB,mHAAA,eAAe,OAAA;AACf,qIAAA,iCAAiC,OAAA;AACjC,iIAAA,6BAA6B,OAAA;AAC7B,2HAAA,uBAAuB,OAAA;AAGzB,uCAAuC;AACvC,iDAMyB;AALvB,6HAAA,4BAA4B,OAAA;AAE5B,mHAAA,kBAAkB,OAAA;AAClB,gHAAA,eAAe,OAAA;AACf,gHAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-executable-assets/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;AAEH,+EAA+E;AAC/E,sDAAoC;AAEpC,oCAAoC;AACpC,2CASsB;AAHpB,yGAAA,WAAW,OAAA;AACX,4GAAA,cAAc,OAAA;AACd,6GAAA,eAAe,OAAA;AAGjB,2EAA2E;AAC3E,sDAAoC;AAEpC,kFAAkF;AAClF,kEAAgD;AAChD,wEAAsD;AACtD,8EAA4D;AAC5D,mEAAiD;AAkCjD,6EAIuC;AAHrC,sJAAA,uCAAuC,OAAA;AAIzC,mFAAoF;AAA3E,kJAAA,gCAAgC,OAAA;AAEzC,mBAAmB;AACnB,iEAYiC;AAX/B,gIAAA,uBAAuB,OAAA;AAYzB,yDAO6B;AAL3B,gIAAA,2BAA2B,OAAA;AAC3B,+HAAA,0BAA0B,OAAA;AAC1B,kIAAA,6BAA6B,OAAA;AAC7B,oIAAA,+BAA+B,OAAA;AAC/B,gIAAA,2BAA2B,OAAA;AA6B7B,6BAA6B;AAC7B,2EA0BsC;AALpC,qIAAA,uBAAuB,OAAA;AACvB,sIAAA,wBAAwB,OAAA;AACxB,wIAAA,0BAA0B,OAAA;AAC1B,gJAAA,kCAAkC,OAAA;AAClC,0IAAA,4BAA4B,OAAA;AAG9B,qCAAqC;AACrC,mDAiB0B;AAfxB,qHAAA,mBAAmB,OAAA;AACnB,qHAAA,mBAAmB,OAAA;AACnB,+GAAA,aAAa,OAAA;AACb,iHAAA,eAAe,OAAA;AACf,2HAAA,yBAAyB,OAAA;AACzB,gIAAA,8BAA8B,OAAA;AAC9B,sHAAA,oBAAoB,OAAA;AAEpB,sHAAA,oBAAoB,OAAA;AACpB,4HAAA,0BAA0B,OAAA;AAC1B,uHAAA,qBAAqB,OAAA;AACrB,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AACjB,6GAAA,WAAW,OAAA;AACX,gHAAA,cAAc,OAAA;AAEhB,+EAQwC;AANtC,qIAAA,qBAAqB,OAAA;AAGrB,4IAAA,4BAA4B,OAAA;AAC5B,kJAAA,kCAAkC,OAAA;AAClC,0IAAA,0BAA0B,OAAA;AAG5B,6EAA6E;AAC7E,6FAM+C;AAL7C,yKAAA,kDAAkD,OAAA;AAGlD,gJAAA,yBAAyB,OAAA;AACzB,wIAAA,iBAAiB,OAAA;AAGnB,6CAA6C;AAC7C,uDAa4B;AAZ1B,qHAAA,iBAAiB,OAAA;AACjB,iHAAA,aAAa,OAAA;AACb,yHAAA,qBAAqB,OAAA;AACrB,oHAAA,gBAAgB,OAAA;AAChB,qHAAA,iBAAiB,OAAA;AACjB,kHAAA,cAAc,OAAA;AACd,sHAAA,kBAAkB,OAAA;AAClB,6HAAA,yBAAyB,OAAA;AACzB,mHAAA,eAAe,OAAA;AACf,qIAAA,iCAAiC,OAAA;AACjC,iIAAA,6BAA6B,OAAA;AAC7B,2HAAA,uBAAuB,OAAA;AAGzB,uCAAuC;AACvC,iDAMyB;AALvB,6HAAA,4BAA4B,OAAA;AAE5B,mHAAA,kBAAkB,OAAA;AAClB,gHAAA,eAAe,OAAA;AACf,gHAAA,eAAe,OAAA"}

package/dist/nexus-cli/src/cli-runner.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/nexus-cli/src/cli-runner.test.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = __importDefault(require("node:test"));
+const commander_1 = require("commander");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const cli_1 = require("./cli");
+function streams() {
+    let stdout = '';
+    let stderr = '';
+    return {
+        stdout: { write: (chunk) => { stdout += String(chunk); return true; } },
+        stderr: { write: (chunk) => { stderr += String(chunk); return true; } },
+        read: () => ({ stdout, stderr }),
+    };
+}
+function throwingProgram(kind) {
+    const program = new commander_1.Command('nexus').option('--json');
+    program.command('boom').action(kind === 'sync'
+        ? () => { throw new Error('Bearer super-secret stack must-not-leak'); }
+        : async () => { await Promise.resolve(); throw new Error('token=super-secret rejected'); });
+    return program;
+}
+for (const kind of ['sync', 'async']) {
+    (0, node_test_1.default)(`outer machine boundary catches ${kind} failures as one redacted result`, async () => {
+        const output = streams();
+        const exitCode = await (0, cli_1.runCli)(['node', 'nexus', '--json', 'boom'], {
+            program: throwingProgram(kind), stdout: output.stdout, stderr: output.stderr,
+        });
+        const captured = output.read();
+        strict_1.default.equal(exitCode, 1);
+        strict_1.default.equal(captured.stderr, '');
+        strict_1.default.equal(captured.stdout.trim().split('\n').length, 1);
+        const result = JSON.parse(captured.stdout);
+        strict_1.default.equal(result.command, 'boom');
+        strict_1.default.equal(result.ok, false);
+        strict_1.default.equal(result.exitCode, exitCode);
+        strict_1.default.equal(captured.stdout.includes('super-secret'), false);
+        if (kind === 'sync')
+            strict_1.default.equal(captured.stdout.includes('stack must-not-leak'), true);
+        strict_1.default.equal(captured.stdout.includes(' at '), false);
+    });
+}
+(0, node_test_1.default)('outer human boundary sends errors only to stderr without a stack', async () => {
+    const output = streams();
+    const exitCode = await (0, cli_1.runCli)(['node', 'nexus', 'boom'], {
+        program: throwingProgram('async'), stdout: output.stdout, stderr: output.stderr,
+    });
+    const captured = output.read();
+    strict_1.default.equal(exitCode, 1);
+    strict_1.default.equal(captured.stdout, '');
+    strict_1.default.match(captured.stderr, /^Error: /);
+    strict_1.default.equal(captured.stderr.includes('super-secret'), false);
+    strict_1.default.equal(captured.stderr.includes('\n    at '), false);
+});
+(0, node_test_1.default)('Commander usage failures use exit 64 and one machine result', async () => {
+    const program = new commander_1.Command('nexus').option('--json');
+    program.command('get <id>');
+    const output = streams();
+    const exitCode = await (0, cli_1.runCli)(['node', 'nexus', '--json', 'get'], {
+        program, stdout: output.stdout, stderr: output.stderr,
+    });
+    const captured = output.read();
+    strict_1.default.equal(exitCode, 64);
+    strict_1.default.equal(captured.stderr, '');
+    const result = JSON.parse(captured.stdout);
+    strict_1.default.equal(result.exitCode, 64);
+    strict_1.default.equal(result.diagnostics[0].code, 'commander.missingArgument');
+});
+(0, node_test_1.default)('missing mandatory options are also usage exit 64', async () => {
+    const program = new commander_1.Command('nexus').option('--json');
+    program.command('get').requiredOption('--id <id>');
+    const output = streams();
+    const exitCode = await (0, cli_1.runCli)(['node', 'nexus', '--json', 'get'], {
+        program, stdout: output.stdout, stderr: output.stderr,
+    });
+    const result = JSON.parse(output.read().stdout);
+    strict_1.default.equal(exitCode, 64);
+    strict_1.default.equal(result.exitCode, 64);
+    strict_1.default.equal(result.diagnostics[0].code, 'commander.missingMandatoryOptionValue');
+});
+(0, node_test_1.default)('machine help is captured inside one successful result document', async () => {
+    const program = new commander_1.Command('nexus').option('--json');
+    program.command('get').description('Get records');
+    const output = streams();
+    const exitCode = await (0, cli_1.runCli)(['node', 'nexus', '--json', 'get', '--help'], {
+        program, stdout: output.stdout, stderr: output.stderr,
+    });
+    const captured = output.read();
+    strict_1.default.equal(exitCode, 0);
+    strict_1.default.equal(captured.stderr, '');
+    const result = JSON.parse(captured.stdout);
+    strict_1.default.equal(result.ok, true);
+    strict_1.default.equal(result.phase, 'help');
+    strict_1.default.match(result.data.output, /Get records/);
+});
+for (const [name, expectedExit] of [['PermissionError', 3], ['ContractConflictError', 2]]) {
+    (0, node_test_1.default)(`outer boundary keeps ${name} envelope and actual exit codes equal`, async () => {
+        const program = new commander_1.Command('nexus').option('--json');
+        program.command('fail').action(() => {
+            const error = new Error('operation rejected');
+            error.name = name;
+            throw error;
+        });
+        const output = streams();
+        const exitCode = await (0, cli_1.runCli)(['node', 'nexus', '--json', 'fail'], {
+            program, stdout: output.stdout, stderr: output.stderr,
+        });
+        const result = JSON.parse(output.read().stdout);
+        strict_1.default.equal(exitCode, expectedExit);
+        strict_1.default.equal(result.exitCode, expectedExit);
+        strict_1.default.equal(result.ok, false);
+    });
+}
+(0, node_test_1.default)('bootstrap failures are contained by the same outer machine boundary', async () => {
+    const output = streams();
+    const exitCode = await (0, cli_1.runCli)(['node', 'nexus', '--json', 'anything'], {
+        programFactory: () => { throw new Error('Bearer bootstrap-secret failed'); },
+        stdout: output.stdout, stderr: output.stderr,
+    });
+    const captured = output.read();
+    const result = JSON.parse(captured.stdout);
+    strict_1.default.equal(exitCode, 1);
+    strict_1.default.equal(captured.stderr, '');
+    strict_1.default.equal(result.phase, 'bootstrap');
+    strict_1.default.equal(result.exitCode, exitCode);
+    strict_1.default.equal(captured.stdout.includes('bootstrap-secret'), false);
+});
+(0, node_test_1.default)('a real workspace write command emits one result only after creating its artifact', async () => {
+    const tempDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'nexus-cli-runner-'));
+    const output = streams();
+    try {
+        const exitCode = await (0, cli_1.runCli)([
+            'node', 'nexus', '--json', 'workspace', 'init',
+            '--name', 'contract-fixture', '--dir', tempDir, '--template', 'base-crm',
+        ], { program: (0, cli_1.buildCliProgram)(), stdout: output.stdout, stderr: output.stderr });
+        const captured = output.read();
+        const result = JSON.parse(captured.stdout);
+        strict_1.default.equal(exitCode, 0);
+        strict_1.default.equal(captured.stderr, '');
+        strict_1.default.equal(captured.stdout.trim().split('\n').length, 1);
+        strict_1.default.equal(result.command, 'workspace.init');
+        strict_1.default.equal(result.exitCode, exitCode);
+        strict_1.default.equal(result.data.projectName, 'contract-fixture');
+        strict_1.default.equal(node_fs_1.default.existsSync(node_path_1.default.join(result.data.projectDir, 'nexus-project.yaml')), true);
+    }
+    finally {
+        node_fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=cli-runner.test.js.map

package/dist/nexus-cli/src/cli-runner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.test.js","sourceRoot":"","sources":["../../../src/cli-runner.test.ts"],"names":[],"mappings":"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"}

package/dist/nexus-cli/src/cli.d.ts

@@ -1,3 +1,11 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
+import { type CliOutputStream } from './runtime/output-coordinator';
 export declare function buildCliProgram(): Command;
+export interface RunCliOptions {
+    readonly program?: Command;
+    readonly programFactory?: () => Command;
+    readonly stdout?: CliOutputStream;
+    readonly stderr?: CliOutputStream;
+}
+export declare function runCli(argv: ReadonlyArray<string>, options?: RunCliOptions): Promise<number>;

package/dist/nexus-cli/src/cli.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildCliProgram = buildCliProgram;
+exports.runCli = runCli;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const commander_1 = require("commander");
@@ -64,6 +65,9 @@ const preflight_1 = require("./commands/preflight");
 const install_contract_1 = require("./commands/install-contract");
 const user_1 = require("./commands/user");
 const build_info_1 = require("./services/build-info");
+const machine_result_1 = require("./contracts/machine-result");
+const output_coordinator_1 = require("./runtime/output-coordinator");
+const failure_normalizer_1 = require("./runtime/failure-normalizer");
 function resolveCliVersion() {
     let dir = __dirname;
     for (let i = 0; i < 6; i++) {
@@ -119,14 +123,10 @@ function buildCliProgram() {
     (0, preflight_1.registerPreflightCommands)(program);
     (0, install_contract_1.registerInstallContractCommands)(program);
     (0, user_1.registerUserCommands)(program);
-    return program;
-}
-if (require.main === module) {
-    const program = buildCliProgram();
     program.action((_, cmd) => {
         if (cmd.args?.includes('--build-info') || process.argv.includes('--build-info')) {
             const info = (0, build_info_1.loadBuildInfo)();
-            if (process.argv.includes('--json')) {
+            if (cmd.optsWithGlobals().json === true || process.argv.includes('--json')) {
                 process.stdout.write(`${JSON.stringify(info, null, 2)}\n`);
             }
             else {
@@ -135,10 +135,136 @@ if (require.main === module) {
                     `contentDigest: ${info.contentDigest}\n` +
                     `generatedAt: ${info.generatedAt}\n`);
             }
-            process.exit(0);
+            process.exitCode = 0;
+            return;
         }
         program.help();
     });
-    program.parse(process.argv);
+    return program;
+}
+if (require.main === module) {
+    void runCli(process.argv).then((exitCode) => {
+        process.exitCode = exitCode;
+    });
+}
+function commandIdFromArgv(program, argv) {
+    const tokens = argv.slice(2).filter((token) => token !== '--json');
+    const candidates = [];
+    const visit = (command, path) => {
+        for (const child of command.commands) {
+            const next = [...path, child.name()];
+            if (child.commands.length === 0 && next.every((token, index) => tokens[index] === token)) {
+                candidates.push({ id: next.join('.'), length: next.length });
+            }
+            visit(child, next);
+        }
+    };
+    visit(program, []);
+    candidates.sort((left, right) => right.length - left.length || left.id.localeCompare(right.id));
+    return candidates[0]?.id ?? 'unknown';
+}
+function safeErrorMessage(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return (0, machine_result_1.scrubMachineValue)(message);
+}
+function commanderExitCode(error) {
+    if (!(error instanceof commander_1.CommanderError))
+        return 1;
+    if (error.exitCode === 0)
+        return 0;
+    return 64;
+}
+async function runCli(argv, options = {}) {
+    const stdout = options.stdout ?? process.stdout;
+    const stderr = options.stderr ?? process.stderr;
+    const machine = (0, output_coordinator_1.isMachineOutputArgv)(argv);
+    let program;
+    try {
+        program = options.program ?? options.programFactory?.() ?? buildCliProgram();
+    }
+    catch (error) {
+        const normalized = (0, failure_normalizer_1.normalizeCliFailure)(error, 'bootstrap');
+        const coordinator = new output_coordinator_1.CliOutputCoordinator({
+            command: 'unknown', machine, stdout, stderr,
+            setExitCode: () => undefined,
+        });
+        if (machine) {
+            coordinator.emitMachineResult((0, machine_result_1.buildCliResult)({
+                command: 'unknown', phase: 'bootstrap',
+                contractVersion: 'nexusclaw.cli-command-contract/v2', ok: false,
+                exitCode: normalized.exitCode, data: normalized.data,
+                diagnostics: normalized.diagnostics,
+            }));
+        }
+        else {
+            coordinator.writeHumanStderr(`Error: ${safeErrorMessage(error)}\n`);
+        }
+        return normalized.exitCode;
+    }
+    const command = commandIdFromArgv(program, argv);
+    const capturedCommanderStdout = [];
+    let humanStderrWritten = false;
+    let actualExitCode = 0;
+    const coordinator = new output_coordinator_1.CliOutputCoordinator({
+        command,
+        machine,
+        stdout,
+        stderr,
+        setExitCode: (exitCode) => { actualExitCode = exitCode; },
+        renderResult: (result) => JSON.stringify((0, machine_result_1.scrubMachineValue)(result)),
+    });
+    try {
+        const commanderOutput = {
+            writeOut: (message) => {
+                if (machine)
+                    capturedCommanderStdout.push(message);
+                else
+                    stdout.write(message);
+            },
+            writeErr: (message) => {
+                if (!machine) {
+                    humanStderrWritten = true;
+                    stderr.write(message);
+                }
+            },
+        };
+        const configureCommand = (commandNode) => {
+            commandNode.exitOverride();
+            commandNode.configureOutput(commanderOutput);
+            for (const child of commandNode.commands)
+                configureCommand(child);
+        };
+        configureCommand(program);
+        await (0, output_coordinator_1.runWithCliOutputCoordinator)(coordinator, () => program.parseAsync([...argv], { from: 'node' }));
+        return actualExitCode;
+    }
+    catch (error) {
+        const normalized = error instanceof commander_1.CommanderError
+            ? null
+            : (0, failure_normalizer_1.normalizeCliFailure)(error);
+        const exitCode = normalized?.exitCode ?? commanderExitCode(error);
+        actualExitCode = exitCode;
+        if (machine) {
+            if (!coordinator.hasEmittedTerminalResult()) {
+                const helpDisplayed = error instanceof commander_1.CommanderError && error.exitCode === 0;
+                coordinator.emitMachineResult((0, machine_result_1.buildCliResult)({
+                    command,
+                    phase: helpDisplayed ? 'help' : 'failed',
+                    contractVersion: 'nexusclaw.cli-command-contract/v2',
+                    ok: helpDisplayed,
+                    exitCode,
+                    data: helpDisplayed ? { output: capturedCommanderStdout.join('') } : normalized?.data ?? null,
+                    diagnostics: helpDisplayed ? [] : normalized?.diagnostics ?? [{
+                            code: error.code,
+                            severity: 'error', phase: 'failed', message: safeErrorMessage(error), retryable: false,
+                        }],
+                }));
+            }
+        }
+        else if (exitCode !== 0 && !humanStderrWritten) {
+            coordinator.writeHumanStderr(`Error: ${safeErrorMessage(error)}\n`);
+        }
+        return actualExitCode;
+    }
 }
 //# sourceMappingURL=cli.js.map

package/dist/nexus-cli/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/nexus-cli/src/commands/ai/context-export.js

@@ -9,6 +9,8 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
+const machine_result_1 = require("../../contracts/machine-result");
+const command_options_1 = require("../../utils/command-options");
 const LEGACY_V1_WARNING = {
     code: 'AI_CONTEXT_V1_RUNTIME_INCOMPATIBLE',
     message: 'Legacy v1 context is non-authoritative and cannot be used for bundle deploy or promote.',
@@ -285,7 +287,8 @@ exports.aiContextExportCommand = new commander_1.Command('export-legacy')
     .option('--assets-root <path>', 'Assets repo root used with --industry')
     .option('--out <dir>', 'Output directory for generated AI authoring files', '.nexusclaw')
     .option('--json', 'Print export result as JSON', false)
-    .action((options) => {
+    .action((options, command) => {
+    const json = (0, command_options_1.isJsonOutputRequested)(options, command);
     const result = exportAiAuthoringContext({
         source: options.source,
         industry: options.industry,
@@ -294,8 +297,8 @@ exports.aiContextExportCommand = new commander_1.Command('export-legacy')
         outDir: options.out,
         legacyV1: options.legacyV1,
     });
-    if (options.json) {
-        console.log(JSON.stringify(result, null, 2));
+    if (json) {
+        (0, machine_result_1.emitCliResult)((0, machine_result_1.buildCliResult)({ command: 'ai context export-legacy', phase: 'complete', contractVersion: 'nexusclaw.cli-command-contract/v1', ok: true, data: result }));
         return;
     }
     console.log(chalk_1.default.cyan(`AI context exported: ${result.contextId}`));