@nexusclawhq/cli 0.3.26 → 0.3.27

package/dist/nexus-cli/src/contracts/command-contract-matrix.scenarios.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.controlledDryRunScenarioManifest = void 0;
+const command_contract_matrix_1 = require("./command-contract-matrix");
+function dryRunSuccess(argv) {
+    return { status: 'fixture', fixture: { argv: [...argv, '--dry-run', '--json'], adapterId: 'no-remote-mutation' } };
+}
+function previewEmptyInapplicable(reason) {
+    return { status: 'inapplicable', reason };
+}
+exports.controlledDryRunScenarioManifest = {
+    [(0, command_contract_matrix_1.matrixScenarioId)('sandbox.create', 'dry-run', 'success')]: dryRunSuccess([
+        'sandbox', 'create', '--name', 'matrix-sandbox', '--type', 'developer',
+    ]),
+    [(0, command_contract_matrix_1.matrixScenarioId)('sandbox.create', 'dry-run', 'empty')]: previewEmptyInapplicable('Sandbox creation preview always returns one normalized operation receipt.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('source.pull', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['source', 'pull', '--dry-run', '--json'], adapterId: 'source-status-changed' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('source.pull', 'dry-run', 'empty')]: {
+        status: 'fixture', fixture: { argv: ['source', 'pull', '--dry-run', '--json'], adapterId: 'source-status-empty' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('source.push', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['source', 'push', '--dry-run', '--json'], adapterId: 'source-push-changed' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('source.push', 'dry-run', 'empty')]: {
+        status: 'fixture', fixture: { argv: ['source', 'push', '--dry-run', '--json'], adapterId: 'source-push-empty' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('changeset.deploy', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['changeset', 'deploy', '--changeset-id', 'matrix-change-set',
+                '--dry-run', '--json'], adapterId: 'changeset-validation' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('changeset.deploy', 'dry-run', 'empty')]: previewEmptyInapplicable('A valid change-set deployment preview always returns one validation report.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('metadata.deploy', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['metadata', 'deploy', '--change-set-id', 'matrix-change-set',
+                '--dry-run', '--json'], adapterId: 'metadata-deploy-validation' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('metadata.deploy', 'dry-run', 'empty')]: previewEmptyInapplicable('A valid metadata deployment preview always returns one validation result.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('metadata.import', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['metadata', 'import', '--source', '.', '--dry-run', '--json'],
+            adapterId: 'metadata-import-changed' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('metadata.import', 'dry-run', 'empty')]: {
+        status: 'fixture', fixture: { argv: ['metadata', 'import', '--source', '.', '--dry-run', '--json'],
+            adapterId: 'metadata-import-empty' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('sandbox.promote', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['sandbox', 'promote', '--sandbox-id', 'matrix-sandbox',
+                '--reason', 'Matrix preview', '--dry-run', '--json'], adapterId: 'sandbox-promotion-precheck' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('sandbox.promote', 'dry-run', 'empty')]: previewEmptyInapplicable('Sandbox promotion preview always returns one precheck with frontend/backend diffs.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('workspace.pull', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['workspace', 'pull', '--workspace', '.', '--dry-run', '--json'],
+            adapterId: 'workspace-pull-changed' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('workspace.pull', 'dry-run', 'empty')]: {
+        status: 'fixture', fixture: { argv: ['workspace', 'pull', '--workspace', '.', '--dry-run', '--json'],
+            adapterId: 'workspace-pull-empty' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('workspace.push', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['workspace', 'push', '--workspace', '.', '--dry-run', '--json'],
+            adapterId: 'workspace-push-changed' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('workspace.push', 'dry-run', 'empty')]: {
+        status: 'fixture', fixture: { argv: ['workspace', 'push', '--workspace', '.', '--dry-run', '--json'],
+            adapterId: 'workspace-push-empty' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('pull', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['pull', '--workspace', '.', '--kind', 'source', '--dry-run', '--json'],
+            adapterId: 'workspace-pull-changed' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('pull', 'dry-run', 'empty')]: {
+        status: 'fixture', fixture: { argv: ['pull', '--workspace', '.', '--kind', 'source', '--dry-run', '--json'],
+            adapterId: 'workspace-pull-empty' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('promote', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['promote', '--workspace', '.', '--env', 'dev', '--dry-run', '--json'],
+            adapterId: 'workspace-pull-empty' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('promote', 'dry-run', 'empty')]: previewEmptyInapplicable('Promotion preview always returns one sandbox or code-package operation.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('rollback', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['rollback', '--workspace', '.', '--env', 'dev',
+                '--history-id', 'matrix-history', '--dry-run', '--json'], adapterId: 'workspace-pull-empty' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('rollback', 'dry-run', 'empty')]: previewEmptyInapplicable('Rollback preview requires and returns one package or deployment-history target.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('install', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['install', '--source', 'packages/matrix-package', '--workspace', '.',
+                '--env', 'dev', '--dry-run', '--json'], adapterId: 'package-lifecycle-preview' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('install', 'dry-run', 'empty')]: previewEmptyInapplicable('Package installation preview always returns one validated package operation.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('package.install', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['package', 'install', '--source', 'packages/matrix-package',
+                '--workspace-id', '00000000-0000-4000-8000-000000000004', '--dry-run', '--json'],
+            adapterId: 'package-lifecycle-preview' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('package.install', 'dry-run', 'empty')]: previewEmptyInapplicable('Package installation preview always returns one validated package operation.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('package.rollback', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['package', 'rollback', 'matrix-package',
+                '--workspace-id', '00000000-0000-4000-8000-000000000004', '--dry-run', '--json'],
+            adapterId: 'package-lifecycle-preview' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('package.rollback', 'dry-run', 'empty')]: previewEmptyInapplicable('Package rollback preview requires a current state and returns one rollback plan.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('employee.deploy', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['employee', 'deploy', 'employee-package.json',
+                '--workspace-id', '00000000-0000-4000-8000-000000000004', '--dry-run', '--json'],
+            adapterId: 'employee-deploy-preview' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('employee.deploy', 'dry-run', 'empty')]: previewEmptyInapplicable('Employee deployment preview always returns one validation/gate report.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('employee.bundle.deploy', 'dry_run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['employee', 'bundle', 'deploy', 'bundle', '--target-org', 'matrix',
+                '--expected-active-release-set-id', 'none', '--expected-generation', '0', '--dry-run', '--json'],
+            adapterId: 'workforce-bundle-signed-preview' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('employee.bundle.deploy', 'dry_run', 'empty')]: previewEmptyInapplicable('A signed workforce bundle preview always returns one immutable plan.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('package.promote', 'dry-run', 'success')]: dryRunSuccess([
+        'package', 'promote', 'matrix-package', '1.0.0', '--from', 'dev', '--to', 'staging',
+    ]),
+    [(0, command_contract_matrix_1.matrixScenarioId)('package.promote', 'dry-run', 'empty')]: previewEmptyInapplicable('Package promotion preview always returns one normalized operation receipt.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('project.deploy.start', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['project', 'deploy', 'start', '--manifest', 'package.xml', '--dry-run', '--json'],
+            adapterId: 'project-local-workspace' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('project.deploy.start', 'dry-run', 'empty')]: previewEmptyInapplicable('A valid project deployment preview requires and returns at least one matched source file.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('workforce.escalation.create', 'dry-run', 'success')]: dryRunSuccess([
+        'workforce', 'escalation', 'create', '--target-org', 'matrix', '--name', 'Matrix escalation',
+    ]),
+    [(0, command_contract_matrix_1.matrixScenarioId)('workforce.escalation.create', 'dry-run', 'empty')]: previewEmptyInapplicable('Escalation creation preview always returns its normalized input.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('workforce.escalation.entry-add', 'dry-run', 'success')]: dryRunSuccess([
+        'workforce', 'escalation', 'entry-add', '--target-org', 'matrix', '--input',
+        '{"escalationRuleId":"00000000-0000-4000-8000-000000000001","sortOrder":1,"ageMinutes":30}',
+    ]),
+    [(0, command_contract_matrix_1.matrixScenarioId)('workforce.escalation.entry-add', 'dry-run', 'empty')]: previewEmptyInapplicable('Escalation-entry preview always returns its validated input.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('workforce.escalation.activate', 'dry-run', 'success')]: {
+        status: 'fixture', fixture: { argv: ['workforce', 'escalation', 'activate', '--target-org', 'matrix',
+                '--rule-id', '00000000-0000-4000-8000-000000000003', '--dry-run', '--json'], adapterId: 'escalation-read-only' },
+    },
+    [(0, command_contract_matrix_1.matrixScenarioId)('workforce.escalation.activate', 'dry-run', 'empty')]: previewEmptyInapplicable('Activation preview fails closed when the requested rule does not exist.'),
+    [(0, command_contract_matrix_1.matrixScenarioId)('workforce.notification.create', 'dry-run', 'success')]: dryRunSuccess([
+        'workforce', 'notification', 'create', '--target-org', 'matrix',
+        '--user-id', '00000000-0000-4000-8000-000000000002', '--type', 'matrix',
+        '--title', 'Matrix title', '--body', 'Matrix body', '--severity', 'low',
+        '--idempotency-key', 'matrix-notification',
+    ]),
+    [(0, command_contract_matrix_1.matrixScenarioId)('workforce.notification.create', 'dry-run', 'empty')]: previewEmptyInapplicable('Notification creation preview always returns its normalized input.'),
+};
+//# sourceMappingURL=command-contract-matrix.scenarios.js.map

package/dist/nexus-cli/src/contracts/command-contract-matrix.scenarios.js.map

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

package/dist/nexus-cli/src/contracts/command-contract-matrix.test.d.ts

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

package/dist/nexus-cli/src/contracts/command-contract-matrix.test.js

@@ -0,0 +1,53 @@
+"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 command_contract_matrix_1 = require("./command-contract-matrix");
+const policies = [{
+        commandId: 'thing.write', path: 'thing write', source: 'explicit-v2', modes: [{
+                modeId: 'apply', selection: 'always', invocationPolicy: {
+                    outputMode: 'dual', mutability: 'remote-write', supportsDryRun: false,
+                    dryRunExemption: { owner: 'thing-owner', reason: 'No preview API.',
+                        exitCriteria: 'Add preview API and side-effect snapshot.', expiresOn: '2099-01-01' },
+                    environmentOption: null, environmentAliases: [], workspaceOption: null, localWorkspaceOption: null,
+                    exitCodes: { success: [0], warning: [], error: [1] },
+                },
+            }],
+    }];
+(0, node_test_1.default)('matrix expansion makes every absent registry-derived scenario visible', () => {
+    const report = (0, command_contract_matrix_1.buildCommandContractMatrixReport)(policies, {});
+    strict_1.default.deepEqual(report.counts, { tested: 0, exempted: 1, inapplicable: 0, missing: 3 });
+    strict_1.default.equal(report.entries.some((entry) => entry.scenarioId === 'thing.write#apply#dry-run'
+        && entry.status === 'exempted'), true);
+    strict_1.default.throws(() => (0, command_contract_matrix_1.assertCommandContractMatrixComplete)(report), /CLI_COMMAND_CONTRACT_MATRIX_INCOMPLETE/);
+});
+(0, node_test_1.default)('matrix accepts fixtures and an explicit empty inapplicability reason', () => {
+    const fixture = (kind) => ({ status: 'fixture',
+        fixture: { argv: ['thing', 'write', '--json', `--fixture=${kind}`], adapterId: `thing-${kind}` } });
+    const manifest = {
+        [(0, command_contract_matrix_1.matrixScenarioId)('thing.write', 'apply', 'success')]: fixture('success'),
+        [(0, command_contract_matrix_1.matrixScenarioId)('thing.write', 'apply', 'empty')]: {
+            status: 'inapplicable', reason: 'This mutation always returns one immutable receipt.'
+        },
+        [(0, command_contract_matrix_1.matrixScenarioId)('thing.write', 'apply', 'failure')]: fixture('failure'),
+    };
+    const report = (0, command_contract_matrix_1.buildCommandContractMatrixReport)(policies, manifest, new Set([
+        (0, command_contract_matrix_1.matrixScenarioId)('thing.write', 'apply', 'success'),
+        (0, command_contract_matrix_1.matrixScenarioId)('thing.write', 'apply', 'failure'),
+    ]));
+    strict_1.default.equal(report.ok, true);
+    strict_1.default.deepEqual(report.counts, { tested: 2, exempted: 1, inapplicable: 1, missing: 0 });
+    strict_1.default.doesNotThrow(() => (0, command_contract_matrix_1.assertCommandContractMatrixComplete)(report));
+    strict_1.default.match(report.reportDigest, /^sha256:[0-9a-f]{64}$/);
+});
+(0, node_test_1.default)('stale manifest declarations fail closed', () => {
+    const report = (0, command_contract_matrix_1.buildCommandContractMatrixReport)(policies, {
+        'removed.command#default#success': { status: 'inapplicable', reason: 'Must not survive command removal.' },
+    });
+    strict_1.default.equal(report.entries.some((entry) => entry.scenarioId === 'removed.command#default#success'
+        && entry.status === 'missing'), true);
+});
+//# sourceMappingURL=command-contract-matrix.test.js.map

package/dist/nexus-cli/src/contracts/command-contract-matrix.test.js.map

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

package/dist/nexus-cli/src/contracts/command-inventory.d.ts

@@ -0,0 +1,35 @@
+import type { Command } from 'commander';
+export declare const CLI_COMMAND_INVENTORY_SCHEMA_VERSION: "nexusclaw.cli-command-inventory/v1";
+export interface CliCommandInventoryArgumentV1 {
+    readonly name: string;
+    readonly required: boolean;
+    readonly variadic: boolean;
+    readonly description: string;
+}
+export interface CliCommandInventoryOptionV1 {
+    readonly long: string | null;
+    readonly short: string | null;
+    readonly flags: string;
+    readonly required: boolean;
+    readonly optional: boolean;
+    readonly variadic: boolean;
+    readonly negated: boolean;
+    readonly defaultValue: unknown;
+    readonly description: string;
+    readonly inherited: boolean;
+    readonly declaredOnPath: string;
+}
+export interface CliCommandInventoryLeafV1 {
+    readonly commandId: string;
+    readonly path: string;
+    readonly aliases: ReadonlyArray<string>;
+    readonly summary: string;
+    readonly arguments: ReadonlyArray<CliCommandInventoryArgumentV1>;
+    readonly options: ReadonlyArray<CliCommandInventoryOptionV1>;
+}
+export interface CliCommandInventoryV1 {
+    readonly schemaVersion: typeof CLI_COMMAND_INVENTORY_SCHEMA_VERSION;
+    readonly rootCommand: string;
+    readonly leaves: ReadonlyArray<CliCommandInventoryLeafV1>;
+}
+export declare function buildCommandInventory(root: Command): CliCommandInventoryV1;

package/dist/nexus-cli/src/contracts/command-inventory.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_COMMAND_INVENTORY_SCHEMA_VERSION = void 0;
+exports.buildCommandInventory = buildCommandInventory;
+exports.CLI_COMMAND_INVENTORY_SCHEMA_VERSION = 'nexusclaw.cli-command-inventory/v1';
+function commandPath(command, root) {
+    const names = [];
+    for (let current = command; current && current !== root; current = current.parent) {
+        names.push(current.name());
+    }
+    return names.reverse().join(' ');
+}
+function optionKey(option) {
+    return option.long ?? option.short ?? option.flags;
+}
+function projectArgument(argument) {
+    return {
+        name: argument.name(),
+        required: argument.required,
+        variadic: argument.variadic,
+        description: argument.description,
+    };
+}
+function projectOption(option, declaredOnPath, inherited) {
+    return {
+        long: option.long ?? null,
+        short: option.short ?? null,
+        flags: option.flags,
+        required: option.required,
+        optional: option.optional,
+        variadic: option.variadic,
+        negated: option.negate,
+        defaultValue: option.defaultValue,
+        description: option.description,
+        inherited,
+        declaredOnPath,
+    };
+}
+function effectiveOptions(command, root) {
+    const lineage = [];
+    for (let current = command; current; current = current.parent) {
+        lineage.push(current);
+        if (current === root)
+            break;
+    }
+    lineage.reverse();
+    const effective = new Map();
+    for (const owner of lineage) {
+        const ownerPath = owner === root ? root.name() : commandPath(owner, root);
+        for (const option of owner.options) {
+            effective.set(optionKey(option), projectOption(option, ownerPath, owner !== command));
+        }
+    }
+    return [...effective.values()].sort((left, right) => (left.long ?? left.short ?? left.flags).localeCompare(right.long ?? right.short ?? right.flags));
+}
+function projectLeaf(command, root) {
+    const path = commandPath(command, root);
+    return {
+        commandId: path.split(/\s+/u).join('.'),
+        path,
+        aliases: [...command.aliases()].sort(),
+        summary: command.description(),
+        arguments: command.registeredArguments.map(projectArgument),
+        options: effectiveOptions(command, root),
+    };
+}
+function buildCommandInventory(root) {
+    const leaves = [];
+    const visit = (command) => {
+        if (command !== root && command.commands.length === 0) {
+            leaves.push(projectLeaf(command, root));
+            return;
+        }
+        for (const child of command.commands)
+            visit(child);
+    };
+    visit(root);
+    leaves.sort((left, right) => left.commandId.localeCompare(right.commandId));
+    const ids = new Set();
+    for (const leaf of leaves) {
+        if (ids.has(leaf.commandId)) {
+            throw new Error(`CLI_COMMAND_INVENTORY_DUPLICATE: ${leaf.commandId}`);
+        }
+        ids.add(leaf.commandId);
+    }
+    return { schemaVersion: exports.CLI_COMMAND_INVENTORY_SCHEMA_VERSION, rootCommand: root.name(), leaves };
+}
+//# sourceMappingURL=command-inventory.js.map

package/dist/nexus-cli/src/contracts/command-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-inventory.js","sourceRoot":"","sources":["../../../../src/contracts/command-inventory.ts"],"names":[],"mappings":";;;AAkHA,sDAoBC;AApIY,QAAA,oCAAoC,GAC/C,oCAA6C,CAAC;AAqChD,SAAS,WAAW,CAAC,OAAgB,EAAE,IAAa;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,OAAO,GAAmB,OAAO,EAAE,OAAO,IAAI,OAAO,KAAK,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAClG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;AACrD,CAAC;AAED,SAAS,eAAe,CAAC,QAAkB;IACzC,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;QACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,MAAc,EACd,cAAsB,EACtB,SAAkB;IAElB,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS;QACT,cAAc;KACf,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB,EAAE,IAAa;IACvD,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,KAAK,IAAI,OAAO,GAAmB,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM;IAC9B,CAAC;IACD,OAAO,CAAC,OAAO,EAAE,CAAC;IAElB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuC,CAAC;IACjE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1E,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAClD,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAChG,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,OAAgB,EAAE,IAAa;IAClD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACvC,IAAI;QACJ,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;QACtC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE;QAC9B,SAAS,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,eAAe,CAAC;QAC3D,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC;KACzC,CAAC;AACJ,CAAC;AAGD,SAAgB,qBAAqB,CAAC,IAAa;IACjD,MAAM,MAAM,GAAgC,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,CAAC,OAAgB,EAAQ,EAAE;QACvC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ;YAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAE5E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,4CAAoC,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC;AACnG,CAAC"}

package/dist/nexus-cli/src/contracts/command-inventory.test.d.ts

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

package/dist/nexus-cli/src/contracts/command-inventory.test.js

@@ -0,0 +1,46 @@
+"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 cli_1 = require("../cli");
+const command_inventory_1 = require("./command-inventory");
+(0, node_test_1.default)('inventory deterministically exports every Commander leaf', () => {
+    const first = (0, command_inventory_1.buildCommandInventory)((0, cli_1.buildCliProgram)());
+    const second = (0, command_inventory_1.buildCommandInventory)((0, cli_1.buildCliProgram)());
+    strict_1.default.equal(first.schemaVersion, command_inventory_1.CLI_COMMAND_INVENTORY_SCHEMA_VERSION);
+    strict_1.default.equal(first.rootCommand, 'nexus');
+    strict_1.default.equal(first.leaves.length, 280);
+    strict_1.default.deepEqual(first, second);
+    strict_1.default.deepEqual(first.leaves.map((leaf) => leaf.commandId), [...first.leaves.map((leaf) => leaf.commandId)].sort());
+    strict_1.default.equal(new Set(first.leaves.map((leaf) => leaf.commandId)).size, 280);
+});
+(0, node_test_1.default)('inventory distinguishes inherited and local JSON declarations', () => {
+    const inventory = (0, command_inventory_1.buildCommandInventory)((0, cli_1.buildCliProgram)());
+    const withJson = inventory.leaves.filter((leaf) => leaf.options.some((option) => option.long === '--json'));
+    const withLocalJson = inventory.leaves.filter((leaf) => leaf.options.some((option) => option.long === '--json' && !option.inherited));
+    strict_1.default.equal(withJson.length, 280);
+    strict_1.default.equal(withLocalJson.length, 280);
+    strict_1.default.equal(inventory.leaves.some((leaf) => leaf.options.some((option) => option.long === '--json' && option.inherited)), false);
+});
+(0, node_test_1.default)('inventory records arguments, aliases and effective option ownership', () => {
+    const root = new commander_1.Command('nexus').option('--json', 'machine output');
+    const group = root.command('thing').alias('t').option('--env <name>', 'environment');
+    group.command('get <id> [fields...]').alias('show').description('Get one thing').option('-w, --workspace-id <id>', 'workspace');
+    const [leaf] = (0, command_inventory_1.buildCommandInventory)(root).leaves;
+    strict_1.default.equal(leaf.commandId, 'thing.get');
+    strict_1.default.deepEqual(leaf.aliases, ['show']);
+    strict_1.default.deepEqual(leaf.arguments, [
+        { name: 'id', required: true, variadic: false, description: '' },
+        { name: 'fields', required: false, variadic: true, description: '' },
+    ]);
+    strict_1.default.deepEqual(leaf.options.map((option) => [option.long, option.inherited, option.declaredOnPath]), [
+        ['--env', true, 'thing'],
+        ['--json', true, 'nexus'],
+        ['--workspace-id', false, 'thing get'],
+    ]);
+});
+//# sourceMappingURL=command-inventory.test.js.map

package/dist/nexus-cli/src/contracts/command-inventory.test.js.map

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

package/dist/nexus-cli/src/contracts/command-policy.exporter.d.ts

@@ -0,0 +1,24 @@
+import { CLI_COMMAND_REGISTRY_SCHEMA_VERSION_V2 } from '@nexusclaw/shared';
+import type { CliCommandInventoryV1 } from './command-inventory';
+import type { CliRegisteredCommandPolicyV2 } from './command-policy.registry';
+import type { CliCommandPolicyReportV1 } from './command-policy.validator';
+export interface CliCommandPolicyRegistryEntryV2 {
+    readonly commandId: string;
+    readonly path: string;
+    readonly aliases: ReadonlyArray<string>;
+    readonly summary: string;
+    readonly arguments: CliCommandInventoryV1['leaves'][number]['arguments'];
+    readonly options: CliCommandInventoryV1['leaves'][number]['options'];
+    readonly policySource: CliRegisteredCommandPolicyV2['source'];
+    readonly modes: CliRegisteredCommandPolicyV2['modes'];
+    readonly contractCompleteness: 'complete' | 'partial';
+    readonly diagnosticRuleIds: ReadonlyArray<string>;
+}
+export interface CliCommandPolicyRegistryExportV2 {
+    readonly schemaVersion: typeof CLI_COMMAND_REGISTRY_SCHEMA_VERSION_V2;
+    readonly inventorySchemaVersion: CliCommandInventoryV1['schemaVersion'];
+    readonly commands: ReadonlyArray<CliCommandPolicyRegistryEntryV2>;
+    readonly policyReport: CliCommandPolicyReportV1;
+    readonly registryDigest: `sha256:${string}`;
+}
+export declare function exportCommandPolicyRegistryV2(inventory: CliCommandInventoryV1, policies: ReadonlyArray<CliRegisteredCommandPolicyV2>, policyReport: CliCommandPolicyReportV1): CliCommandPolicyRegistryExportV2;

package/dist/nexus-cli/src/contracts/command-policy.exporter.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportCommandPolicyRegistryV2 = exportCommandPolicyRegistryV2;
+const shared_1 = require("@nexusclaw/shared");
+function toJsonValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function exportCommandPolicyRegistryV2(inventory, policies, policyReport) {
+    const policyById = new Map(policies.map((policy) => [policy.commandId, policy]));
+    const diagnosticsById = new Map();
+    for (const diagnostic of policyReport.diagnostics) {
+        const rules = diagnosticsById.get(diagnostic.commandId) ?? [];
+        rules.push(diagnostic.ruleId);
+        diagnosticsById.set(diagnostic.commandId, rules);
+    }
+    const commands = inventory.leaves.map((leaf) => {
+        const policy = policyById.get(leaf.commandId);
+        if (!policy)
+            throw new Error(`CLI_COMMAND_POLICY_EXPORT_MISSING: ${leaf.commandId}`);
+        const diagnosticRuleIds = [...new Set(diagnosticsById.get(leaf.commandId) ?? [])].sort();
+        return {
+            commandId: leaf.commandId,
+            path: leaf.path,
+            aliases: leaf.aliases,
+            summary: leaf.summary,
+            arguments: leaf.arguments,
+            options: leaf.options,
+            policySource: policy.source,
+            modes: policy.modes,
+            contractCompleteness: diagnosticRuleIds.length === 0 ? 'complete' : 'partial',
+            diagnosticRuleIds,
+        };
+    }).sort((left, right) => left.commandId.localeCompare(right.commandId));
+    if (commands.length !== policies.length) {
+        throw new Error(`CLI_COMMAND_POLICY_EXPORT_COUNT_MISMATCH: inventory=${commands.length} policies=${policies.length}`);
+    }
+    const digestInput = toJsonValue({
+        schemaVersion: shared_1.CLI_COMMAND_REGISTRY_SCHEMA_VERSION_V2,
+        inventorySchemaVersion: inventory.schemaVersion,
+        commands,
+        policyReport,
+    });
+    return {
+        schemaVersion: shared_1.CLI_COMMAND_REGISTRY_SCHEMA_VERSION_V2,
+        inventorySchemaVersion: inventory.schemaVersion,
+        commands,
+        policyReport,
+        registryDigest: (0, shared_1.canonicalJsonDigest)(digestInput),
+    };
+}
+//# sourceMappingURL=command-policy.exporter.js.map

package/dist/nexus-cli/src/contracts/command-policy.exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-policy.exporter.js","sourceRoot":"","sources":["../../../../src/contracts/command-policy.exporter.ts"],"names":[],"mappings":";;AAmCA,sEA6CC;AAhFD,8CAI2B;AA0B3B,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAc,CAAC;AACxD,CAAC;AAGD,SAAgB,6BAA6B,CAC3C,SAAgC,EAChC,QAAqD,EACrD,YAAsC;IAEtC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,eAAe,GAAG,IAAI,GAAG,EAAoB,CAAC;IACpD,KAAK,MAAM,UAAU,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC9B,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAmC,EAAE;QAC9E,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACrF,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzF,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,oBAAoB,EAAE,iBAAiB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YAC7E,iBAAiB;SAClB,CAAC;IACJ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uDAAuD,QAAQ,CAAC,MAAM,aAAa,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACxH,CAAC;IACD,MAAM,WAAW,GAAG,WAAW,CAAC;QAC9B,aAAa,EAAE,+CAAsC;QACrD,sBAAsB,EAAE,SAAS,CAAC,aAAa;QAC/C,QAAQ;QACR,YAAY;KACb,CAAC,CAAC;IACH,OAAO;QACL,aAAa,EAAE,+CAAsC;QACrD,sBAAsB,EAAE,SAAS,CAAC,aAAa;QAC/C,QAAQ;QACR,YAAY;QACZ,cAAc,EAAE,IAAA,4BAAmB,EAAC,WAAW,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/dist/nexus-cli/src/contracts/command-policy.exporter.test.d.ts

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

package/dist/nexus-cli/src/contracts/command-policy.exporter.test.js

@@ -0,0 +1,33 @@
+"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 cli_1 = require("../cli");
+const command_contract_registry_1 = require("./command-contract.registry");
+const command_inventory_1 = require("./command-inventory");
+const command_policy_exporter_1 = require("./command-policy.exporter");
+const command_policy_registry_1 = require("./command-policy.registry");
+const command_policy_validator_1 = require("./command-policy.validator");
+(0, node_test_1.default)('v2 exporter is complete, sorted and digest-stable', () => {
+    const build = () => {
+        const inventory = (0, command_inventory_1.buildCommandInventory)((0, cli_1.buildCliProgram)());
+        const policies = (0, command_policy_registry_1.buildCommandPolicyRegistry)(inventory, command_contract_registry_1.commandContractRegistry.all().map((entry) => entry.contract));
+        const report = (0, command_policy_validator_1.validateCommandPolicyRegistry)(inventory, policies, '2026-08-02');
+        return (0, command_policy_exporter_1.exportCommandPolicyRegistryV2)(inventory, policies, report);
+    };
+    const first = build();
+    const second = build();
+    strict_1.default.deepEqual(first, second);
+    strict_1.default.equal(first.schemaVersion, 'nexusclaw.cli-command-registry/v2');
+    strict_1.default.equal(first.commands.length, 280);
+    strict_1.default.equal(first.policyReport.modeCount, 319);
+    strict_1.default.match(first.registryDigest, /^sha256:[0-9a-f]{64}$/);
+    strict_1.default.deepEqual(first.commands.map((command) => command.commandId), [...first.commands.map((command) => command.commandId)].sort());
+    strict_1.default.equal(first.commands.some((command) => command.commandId === 'source.pull'), true);
+    strict_1.default.equal(first.policyReport.ok, true);
+    strict_1.default.equal(first.commands.every((command) => command.contractCompleteness === 'complete'), true);
+});
+//# sourceMappingURL=command-policy.exporter.test.js.map

package/dist/nexus-cli/src/contracts/command-policy.exporter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-policy.exporter.test.js","sourceRoot":"","sources":["../../../../src/contracts/command-policy.exporter.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAE7B,gCAAyC;AACzC,2EAAsE;AACtE,2DAA4D;AAC5D,uEAA0E;AAC1E,uEAAuE;AACvE,yEAA2E;AAE3E,IAAA,mBAAI,EAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,MAAM,SAAS,GAAG,IAAA,yCAAqB,EAAC,IAAA,qBAAe,GAAE,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAA,oDAA0B,EAAC,SAAS,EAAE,mDAAuB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrH,MAAM,MAAM,GAAG,IAAA,wDAA6B,EAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAChF,OAAO,IAAA,uDAA6B,EAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC;IACtB,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,gBAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAChC,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,EAAE,mCAAmC,CAAC,CAAC;IACvE,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChD,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;IAC5D,gBAAM,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrI,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,KAAK,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1F,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1C,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,oBAAoB,KAAK,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;AACrG,CAAC,CAAC,CAAC"}

package/dist/nexus-cli/src/contracts/command-policy.registry.d.ts

@@ -0,0 +1,14 @@
+import type { CliCommandContractV1, CliInvocationPolicyV2 } from '@nexusclaw/shared';
+import type { CliCommandInventoryV1 } from './command-inventory';
+export interface CliRegisteredModePolicyV2 {
+    readonly modeId: string;
+    readonly selection: string;
+    readonly invocationPolicy: CliInvocationPolicyV2;
+}
+export interface CliRegisteredCommandPolicyV2 {
+    readonly commandId: string;
+    readonly path: string;
+    readonly source: 'v1-contract' | 'explicit-v2';
+    readonly modes: ReadonlyArray<CliRegisteredModePolicyV2>;
+}
+export declare function buildCommandPolicyRegistry(inventory: CliCommandInventoryV1, v1Contracts: ReadonlyArray<CliCommandContractV1>): ReadonlyArray<CliRegisteredCommandPolicyV2>;