@nexusclawhq/cli 0.2.1

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

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectImplementedNextCommands = projectImplementedNextCommands;
+exports.buildImplementedCommandOrder = buildImplementedCommandOrder;
+const shared_1 = require("@nexusclaw/shared");
+const command_contract_1 = require("./command-contract");
+const FROZEN_EDGES = [
+    { from: 'ai.help#all', to: 'ai.context.describe#online_caller_preview', predicates: ['target_org_configured'], authorization: 'none' },
+    { from: 'ai.help#all', to: 'ai.context.describe#offline', predicates: ['offline_requested'], authorization: 'none' },
+    { from: 'ai.context.describe#offline', to: 'ai.context.export#offline', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.describe#online_caller_preview', to: 'ai.context.export#online_caller_preview', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.describe#online_agent_active', to: 'ai.context.export#online_agent_active', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.describe#online_agent_candidate', to: 'ai.context.export#online_agent_candidate', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.export#offline', to: 'ai.context.verify#local', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.export#online_caller_preview', to: 'ai.context.verify#online', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.export#online_agent_active', to: 'ai.context.verify#online', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.export#online_agent_candidate', to: 'ai.context.verify#online', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.verify#local', to: 'ai.context.install#preview', predicates: ['offline_requested'], authorization: 'none' },
+    { from: 'ai.context.verify#local', to: 'ai.context.install#preview', predicates: ['selector_is_caller_or_active'], authorization: 'none' },
+    { from: 'ai.context.verify#online', to: 'ai.context.install#preview', predicates: ['selector_is_caller_or_active'], authorization: 'none' },
+    { from: 'ai.context.verify#online', to: 'employee.code.test#candidate_remote', predicates: ['selector_is_candidate', 'candidate_contains_code'], authorization: 'none' },
+    { from: 'ai.context.verify#online', to: 'employee.flow.test#candidate_remote', predicates: ['selector_is_candidate', 'candidate_contains_flow'], authorization: 'none' },
+    { from: 'ai.context.verify#online', to: 'employee.bundle.test#candidate_remote', predicates: ['selector_is_candidate'], authorization: 'none' },
+    { from: 'ai.context.install#preview', to: 'ai.context.install#apply', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.install#preview', to: 'employee.code.describe#describe', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.code.describe#describe', to: 'employee.code.scaffold#scaffold', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.code.scaffold#scaffold', to: 'employee.code.validate#local', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.code.validate#local', to: 'employee.code.build#local', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.code.build#local', to: 'employee.code.test#local', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.install#preview', to: 'employee.flow.describe#describe', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.flow.describe#describe', to: 'employee.flow.scaffold#scaffold', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.flow.scaffold#scaffold', to: 'employee.flow.validate#local', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.flow.validate#local', to: 'employee.flow.test#local', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.install#preview', to: 'employee.bundle.init#init', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.install#apply', to: 'employee.code.describe#describe', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.install#apply', to: 'employee.flow.describe#describe', predicates: ['always'], authorization: 'none' },
+    { from: 'ai.context.install#apply', to: 'employee.bundle.init#init', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.bundle.init#init', to: 'employee.bundle.validate#local', predicates: ['workspace_has_bundle'], authorization: 'none' },
+    { from: 'employee.code.test#local', to: 'employee.bundle.validate#local', predicates: ['local_code_passed'], authorization: 'none' },
+    { from: 'employee.flow.test#local', to: 'employee.bundle.validate#local', predicates: ['local_flow_passed'], authorization: 'none' },
+    { from: 'employee.bundle.validate#local', to: 'employee.bundle.validate#online', predicates: ['target_org_configured'], authorization: 'none' },
+    { from: 'employee.bundle.validate#online', to: 'employee.bundle.lock#online', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.bundle.lock#online', to: 'employee.bundle.deploy#dry_run', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.bundle.deploy#dry_run', to: 'employee.bundle.deploy#stage', predicates: ['always'], authorization: 'explicit_user' },
+    { from: 'employee.bundle.deploy#stage', to: 'ai.context.describe#online_agent_candidate', predicates: ['selector_is_candidate'], authorization: 'none' },
+    { from: 'employee.code.test#candidate_remote', to: 'employee.bundle.approval_request#request', predicates: ['evidence_complete'], authorization: 'explicit_user' },
+    { from: 'employee.flow.test#candidate_remote', to: 'employee.bundle.approval_request#request', predicates: ['evidence_complete'], authorization: 'explicit_user' },
+    { from: 'employee.bundle.test#candidate_remote', to: 'employee.bundle.approval_request#request', predicates: ['evidence_complete'], authorization: 'explicit_user' },
+    { from: 'employee.bundle.approval_request#request', to: 'employee.bundle.approval_status#read', predicates: ['always'], authorization: 'none' },
+    { from: 'employee.bundle.approval_status#read', to: 'employee.bundle.gate#evaluate_and_seal', predicates: ['release_approval_approved'], authorization: 'explicit_user' },
+    { from: 'employee.bundle.gate#evaluate_and_seal', to: 'employee.bundle.promote#cas_head', predicates: ['gate_eligible'], authorization: 'explicit_user' },
+    { from: 'employee.bundle.promote#cas_head', to: 'employee.bundle.rollback#cas_previous', predicates: ['rollback_target_release'], authorization: 'explicit_user' },
+    { from: 'employee.bundle.promote#cas_head', to: 'employee.bundle.rollback#cas_none', predicates: ['rollback_target_none'], authorization: 'explicit_user' },
+    { from: 'employee.bundle.promote#cas_head', to: 'employee.bundle.revoke_action#emergency_revoke', predicates: ['emergency_revoke_requested'], authorization: 'explicit_user' },
+];
+function projectImplementedNextCommands(contracts) {
+    const implemented = new Set(contracts.flatMap((contract) => (0, command_contract_1.implementedModesOf)(contract).map((mode) => `${contract.commandId}#${mode.modeId}`)));
+    return contracts.map((contract) => {
+        const grouped = new Map();
+        for (const edge of FROZEN_EDGES) {
+            if (!implemented.has(edge.from) || !implemented.has(edge.to))
+                continue;
+            const [sourceCommandId, sourceModeId] = splitNode(edge.from);
+            const [targetCommandId] = splitNode(edge.to);
+            if (sourceCommandId !== contract.commandId)
+                continue;
+            const key = `${targetCommandId}|${edge.authorization}`;
+            const current = grouped.get(key) ?? {
+                commandId: targetCommandId,
+                whenModeIds: [],
+                authorization: edge.authorization,
+            };
+            if (!current.whenModeIds.includes(sourceModeId)) {
+                current.whenModeIds.push(sourceModeId);
+            }
+            grouped.set(key, current);
+        }
+        return {
+            ...contract,
+            nextCommands: [...grouped.values()]
+                .map((next) => ({ ...next, whenModeIds: next.whenModeIds.sort() }))
+                .sort((a, b) => a.commandId.localeCompare(b.commandId) ||
+                a.authorization.localeCompare(b.authorization)),
+        };
+    });
+}
+function splitNode(node) {
+    const separator = node.lastIndexOf('#');
+    if (separator <= 0 || separator === node.length - 1) {
+        throw new Error(`CLI_COMMAND_ORDER_NODE_INVALID:${node}`);
+    }
+    return [node.slice(0, separator), node.slice(separator + 1)];
+}
+function buildImplementedCommandOrder(contracts) {
+    const nodes = contracts
+        .flatMap((contract) => (0, command_contract_1.implementedModesOf)(contract).map((mode) => ({
+        nodeId: `${contract.commandId}#${mode.modeId}`,
+        commandId: contract.commandId,
+        modeId: mode.modeId,
+        contractDigest: (0, shared_1.canonicalJsonDigest)({
+            commandId: contract.commandId,
+            mode,
+        }),
+    })))
+        .sort((a, b) => a.nodeId.localeCompare(b.nodeId));
+    const nodeIds = new Set(nodes.map((node) => node.nodeId));
+    const edges = FROZEN_EDGES.filter((edge) => nodeIds.has(edge.from) && nodeIds.has(edge.to))
+        .map((edge) => ({
+        from: edge.from,
+        to: edge.to,
+        when: {
+            allOf: [...edge.predicates].sort().map((kind) => ({ kind })),
+        },
+        authorization: edge.authorization,
+    }))
+        .sort((a, b) => a.from.localeCompare(b.from) ||
+        a.to.localeCompare(b.to) ||
+        JSON.stringify(a.when).localeCompare(JSON.stringify(b.when)));
+    assertAcyclic(nodes.map((node) => node.nodeId), edges);
+    return {
+        schemaVersion: shared_1.COMMAND_ORDER_SCHEMA_VERSION,
+        nodes,
+        edges,
+    };
+}
+function assertAcyclic(nodes, edges) {
+    const outgoing = new Map(nodes.map((node) => [node, []]));
+    for (const edge of edges)
+        outgoing.get(edge.from).push(edge);
+    const conflicts = new Set([
+        'selector_is_candidate|selector_is_caller_or_active',
+        'selector_is_caller_or_active|selector_is_candidate',
+    ]);
+    const visit = (node, path, facts) => {
+        if (path.includes(node))
+            throw new Error('CLI_COMMAND_ORDER_CYCLE');
+        for (const edge of outgoing.get(node) ?? []) {
+            const nextFacts = new Set(facts);
+            for (const predicate of edge.when.allOf) {
+                if (predicate.kind !== 'always')
+                    nextFacts.add(predicate.kind);
+            }
+            const incompatible = [...nextFacts].some((left) => [...nextFacts].some((right) => conflicts.has(`${left}|${right}`)));
+            if (!incompatible)
+                visit(edge.to, [...path, node], nextFacts);
+        }
+    };
+    for (const node of nodes)
+        visit(node, [], new Set());
+}
+//# sourceMappingURL=command-order.js.map

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

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

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

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

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

@@ -0,0 +1,301 @@
+"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 index_1 = require("./index");
+(0, node_test_1.default)('registry: implemented modes are projected; planned modes are NOT', () => {
+    const implemented = index_1.commandContractRegistry.implemented();
+    const plannedOnly = index_1.commandContractRegistry.plannedOnly();
+    strict_1.default.ok(implemented.some((c) => c.commandId === 'ai.help'));
+    strict_1.default.ok(!plannedOnly.some((c) => c.commandId === 'employee.bundle.promote'));
+    strict_1.default.ok(implemented.some((c) => c.commandId === 'employee.bundle.promote'));
+});
+(0, node_test_1.default)('registry: promoted bundle mode has exact implementationId', () => {
+    const promote = index_1.commandContractRegistry.find('employee.bundle.promote');
+    strict_1.default.ok(promote);
+    const modes = promote.contract.executionModes;
+    strict_1.default.equal(modes.length, 1);
+    strict_1.default.equal(modes[0].availability, 'implemented');
+    strict_1.default.equal(modes[0].implementationId, 'nexus-cli/employee.bundle.promote#cas_head@v1');
+    strict_1.default.equal((0, index_1.hasImplementedMode)(promote.contract), true);
+});
+(0, node_test_1.default)('registry: implemented mode has a non-null implementationId', () => {
+    const help = index_1.commandContractRegistry.find('ai.help');
+    strict_1.default.ok(help);
+    const modes = (0, index_1.implementedModesOf)(help.contract);
+    strict_1.default.equal(modes.length, 2);
+    for (const m of modes) {
+        strict_1.default.equal(m.availability, 'implemented');
+        strict_1.default.ok(typeof m.implementationId === 'string' && m.implementationId.length > 0);
+    }
+});
+(0, node_test_1.default)('registry: internal dispatch resolves the implemented promote owner', () => {
+    const promote = index_1.commandContractRegistry.find('employee.bundle.promote');
+    strict_1.default.equal((0, index_1.hasImplementedMode)(promote.contract), true);
+    strict_1.default.equal(index_1.CLI_COMMAND_NOT_IMPLEMENTED, 'CLI_COMMAND_NOT_IMPLEMENTED');
+    strict_1.default.deepEqual((0, index_1.resolveInternalDispatch)(promote.contract, 'cas_head'), { ok: true, implementationId: 'nexus-cli/employee.bundle.promote#cas_head@v1' });
+});
+(0, node_test_1.default)('Phase 8 direct candidate modes are atomically present in dispatch, DAG and export', () => {
+    const implementedRemote = [
+        ['employee.code.test', 'candidate_remote'],
+        ['employee.flow.test', 'candidate_remote'],
+    ];
+    const contracts = index_1.commandContractRegistry.all().map((entry) => entry.contract);
+    const order = (0, index_1.buildImplementedCommandOrder)(contracts);
+    const exported = (0, index_1.exportCommandContracts)(contracts);
+    for (const [commandId, modeId] of implementedRemote) {
+        const contract = index_1.commandContractRegistry.find(commandId).contract;
+        strict_1.default.equal((0, index_1.resolveInternalDispatch)(contract, modeId).ok, true);
+        strict_1.default.equal(order.nodes.some((node) => node.nodeId === `${commandId}#${modeId}`), true);
+        strict_1.default.equal(exported.commands.some((candidate) => candidate.commandId === commandId &&
+            candidate.executionModes.some((mode) => mode.modeId === modeId)), true);
+        strict_1.default.equal(contract.nextCommands.some((next) => next.commandId === 'employee.bundle.approval_request' &&
+            next.whenModeIds.includes(modeId)), true);
+    }
+});
+(0, node_test_1.default)('machine-result: exit precedence 70 > 3 > 2 > 4 > 5 > 6 > 1 from diagnostics', () => {
+    const result = (0, index_1.buildCliResult)({
+        command: 'test',
+        phase: 'complete',
+        contractVersion: 'nexusclaw.cli-command-contract/v1',
+        ok: false,
+        diagnostics: [
+            { code: 'CODE_RUNTIME_ISOLATION_UNVERIFIED', severity: 'error', phase: 'p', message: 'm', retryable: false },
+            { code: 'CLI_COMMAND_NOT_IMPLEMENTED', severity: 'error', phase: 'p', message: 'm', retryable: false },
+        ],
+    });
+    strict_1.default.equal(result.exitCode, 70);
+    strict_1.default.equal(result.schemaVersion, 'nexusclaw.cli-result/v1');
+});
+(0, node_test_1.default)('machine-result: diagnostics are deterministically sorted by (file,jsonPath,ruleId,code)', () => {
+    const result = (0, index_1.buildCliResult)({
+        command: 'test',
+        phase: 'complete',
+        contractVersion: 'nexusclaw.cli-command-contract/v1',
+        ok: false,
+        diagnostics: [
+            { code: 'CODE_B', severity: 'error', phase: 'p', message: 'm', retryable: false, file: 'b.ts' },
+            { code: 'CODE_A', severity: 'error', phase: 'p', message: 'm', retryable: false, file: 'a.ts' },
+            { code: 'CODE_A', severity: 'error', phase: 'p', message: 'm', retryable: false, file: 'a.ts', jsonPath: '/z' },
+            { code: 'CODE_A', severity: 'error', phase: 'p', message: 'm', retryable: false, file: 'a.ts', jsonPath: '/a' },
+        ],
+    });
+    const files = result.diagnostics.map((d) => `${d.file ?? ''}|${d.jsonPath ?? ''}|${d.code}`);
+    strict_1.default.deepEqual(files, ['a.ts||CODE_A', 'a.ts|/a|CODE_A', 'a.ts|/z|CODE_A', 'b.ts||CODE_B']);
+});
+(0, node_test_1.default)('machine-result: renderCliResult emits a single JSON document with the envelope', () => {
+    const result = (0, index_1.buildCliResult)({
+        command: 'ai.help',
+        phase: 'complete',
+        contractVersion: 'nexusclaw.cli-command-contract/v1',
+        ok: true,
+        data: { commands: [] },
+    });
+    const rendered = (0, index_1.renderCliResult)(result);
+    const parsed = JSON.parse(rendered);
+    strict_1.default.equal(parsed.schemaVersion, 'nexusclaw.cli-result/v1');
+    strict_1.default.equal(parsed.ok, true);
+    strict_1.default.equal(parsed.exitCode, 0);
+    strict_1.default.ok(Array.isArray(parsed.diagnostics));
+    strict_1.default.ok(Array.isArray(parsed.evidence));
+    strict_1.default.ok(Array.isArray(parsed.nextCommands));
+});
+(0, node_test_1.default)('argv predicate: recursive AST and exact schema matchers resolve before dispatch', () => {
+    const help = index_1.commandContractRegistry.find('ai.help').contract;
+    const all = (0, index_1.resolveExecutionMode)(help.executionModes, { '--all': true, '--json': true });
+    strict_1.default.equal(all.ok, true);
+    if (all.ok)
+        strict_1.default.equal(all.mode.modeId, 'all');
+    strict_1.default.equal((0, index_1.evaluateArgvPredicate)({ kind: 'option_matches_schema', option: '--digest', matcher: 'sha256' }, { '--digest': `sha256:${'a'.repeat(64)}` }), true);
+    strict_1.default.equal((0, index_1.evaluateArgvPredicate)({ kind: 'option_matches_schema', option: '--digest', matcher: 'sha256' }, { '--digest': `sha256:${'A'.repeat(64)}` }), false);
+    strict_1.default.equal((0, index_1.evaluateArgvPredicate)({ kind: 'option_matches_schema', option: '--count', matcher: 'positive_integer' }, { '--count': '0' }), true);
+});
+(0, node_test_1.default)('argv predicate: zero and multiple matches return stable exit 64 diagnostics', () => {
+    const modes = index_1.commandContractRegistry.find('ai.help').contract.executionModes;
+    strict_1.default.deepEqual((0, index_1.resolveExecutionMode)(modes, {}), {
+        ok: false, code: 'CLI_MODE_UNMATCHED', exitCode: 64,
+    });
+    strict_1.default.deepEqual((0, index_1.resolveExecutionMode)(modes, { '--all': true, '--command': 'ai.help' }), {
+        ok: false, code: 'CLI_MODE_UNMATCHED', exitCode: 64,
+    });
+    strict_1.default.deepEqual((0, index_1.resolveExecutionMode)([modes[0], modes[0]], { '--all': true }), {
+        ok: false, code: 'CLI_MODE_AMBIGUOUS', exitCode: 64,
+    });
+});
+(0, node_test_1.default)('argv predicate: registry validation rejects empty, unknown and depth > 8 predicates', () => {
+    strict_1.default.throws(() => (0, index_1.validateArgvPredicate)({ kind: 'all_of', expressions: [] }, new Set()), /non-empty/);
+    strict_1.default.throws(() => (0, index_1.validateArgvPredicate)({ kind: 'option_present', option: '--missing' }, new Set()), /unknown option/);
+    let deep = { kind: 'option_present', option: '--x' };
+    for (let i = 0; i < 8; i += 1)
+        deep = { kind: 'not', expression: deep };
+    strict_1.default.throws(() => (0, index_1.validateArgvPredicate)(deep, new Set(['--x'])), /depth exceeds 8/);
+});
+(0, node_test_1.default)('command exporter is sorted, digest-stable and excludes planned modes by default', () => {
+    const allContracts = index_1.commandContractRegistry.all().map((entry) => entry.contract);
+    const first = (0, index_1.exportCommandContracts)(allContracts);
+    const second = (0, index_1.exportCommandContracts)([...allContracts].reverse());
+    strict_1.default.deepEqual(first, second);
+    strict_1.default.deepEqual(first.commands.map((command) => command.commandId), [
+        'ai.context.describe',
+        'ai.context.export',
+        'ai.context.install',
+        'ai.context.verify',
+        'ai.help',
+        'employee.bundle.approval_request',
+        'employee.bundle.approval_status',
+        'employee.bundle.deploy',
+        'employee.bundle.gate',
+        'employee.bundle.init',
+        'employee.bundle.lock',
+        'employee.bundle.promote',
+        'employee.bundle.revoke_action',
+        'employee.bundle.rollback',
+        'employee.bundle.test',
+        'employee.bundle.validate',
+        'employee.code.build',
+        'employee.code.describe',
+        'employee.code.scaffold',
+        'employee.code.test',
+        'employee.code.validate',
+        'employee.flow.describe',
+        'employee.flow.scaffold',
+        'employee.flow.test',
+        'employee.flow.validate',
+    ]);
+    const withPlanned = (0, index_1.exportCommandContracts)(allContracts, true);
+    strict_1.default.deepEqual(withPlanned.commands.map((command) => command.commandId), [
+        'ai.context.describe',
+        'ai.context.export',
+        'ai.context.install',
+        'ai.context.verify',
+        'ai.help',
+        'employee.bundle.approval_request',
+        'employee.bundle.approval_status',
+        'employee.bundle.deploy',
+        'employee.bundle.gate',
+        'employee.bundle.init',
+        'employee.bundle.lock',
+        'employee.bundle.promote',
+        'employee.bundle.revoke_action',
+        'employee.bundle.rollback',
+        'employee.bundle.test',
+        'employee.bundle.validate',
+        'employee.code.build',
+        'employee.code.describe',
+        'employee.code.scaffold',
+        'employee.code.test',
+        'employee.code.validate',
+        'employee.flow.describe',
+        'employee.flow.scaffold',
+        'employee.flow.test',
+        'employee.flow.validate',
+    ]);
+});
+(0, node_test_1.default)('implemented command order excludes planned nodes and remains acyclic', () => {
+    const order = (0, index_1.buildImplementedCommandOrder)(index_1.commandContractRegistry.all().map((entry) => entry.contract));
+    strict_1.default.equal(order.nodes.some((node) => node.nodeId === 'employee.bundle.promote#cas_head'), true);
+    strict_1.default.equal(order.edges.some((edge) => edge.from === 'ai.context.install#preview' &&
+        edge.to === 'ai.context.install#apply'), true);
+});
+(0, node_test_1.default)('Phase 8 DAG forces refreshed candidate context and approved status before gate', () => {
+    const order = (0, index_1.buildImplementedCommandOrder)(index_1.commandContractRegistry.all().map((entry) => entry.contract));
+    const outgoing = (nodeId) => order.edges.filter((edge) => edge.from === nodeId);
+    strict_1.default.deepEqual(outgoing('employee.bundle.deploy#stage').map((edge) => edge.to), ['ai.context.describe#online_agent_candidate']);
+    strict_1.default.equal(order.edges.some((edge) => edge.from === 'employee.bundle.deploy#stage' &&
+        /test#candidate_remote$/.test(edge.to)), false);
+    strict_1.default.deepEqual(outgoing('employee.bundle.approval_request#request').map((edge) => edge.to), ['employee.bundle.approval_status#read']);
+    strict_1.default.deepEqual(outgoing('employee.bundle.approval_status#read').map((edge) => ({
+        to: edge.to,
+        authorization: edge.authorization,
+        predicates: edge.when.allOf.map((predicate) => predicate.kind),
+    })), [{
+            to: 'employee.bundle.gate#evaluate_and_seal',
+            authorization: 'explicit_user',
+            predicates: ['release_approval_approved'],
+        }]);
+});
+(0, node_test_1.default)('machine-result scrubs secret keys, tokens, stacks and raw provider responses recursively', () => {
+    const result = (0, index_1.buildCliResult)({
+        command: 'employee.code.test',
+        phase: 'complete',
+        contractVersion: 'nexusclaw.cli-command-contract/v1',
+        ok: false,
+        data: {
+            nested: {
+                authorization: 'Bearer should-not-survive',
+                safe: 'Bearer abc.def.ghi',
+                providerResponse: { body: 'raw' },
+                stack: 'Error: leaked\n at secret.ts:1',
+            },
+        },
+        diagnostics: [{
+                code: 'CODE_RUNTIME_PROVIDER_UNAVAILABLE',
+                severity: 'error',
+                phase: 'runtime',
+                message: 'token=super-secret provider unavailable',
+                fixHint: 'use Bearer abcdefghijklmnop',
+                retryable: false,
+            }],
+    });
+    const rendered = (0, index_1.renderCliResult)(result);
+    strict_1.default.ok(!rendered.includes('should-not-survive'));
+    strict_1.default.ok(!rendered.includes('super-secret'));
+    strict_1.default.ok(!rendered.includes('abcdefghi'));
+    strict_1.default.ok(!rendered.includes('secret.ts'));
+    strict_1.default.ok(!rendered.includes('"providerResponse"'));
+    strict_1.default.ok(rendered.includes('[REDACTED]'));
+});
+(0, node_test_1.default)('machine-result scrubber fails closed on circular and non-JSON values', () => {
+    const circular = {};
+    circular.self = circular;
+    strict_1.default.throws(() => (0, index_1.scrubMachineValue)(circular), /circular data/);
+    strict_1.default.throws(() => (0, index_1.scrubMachineValue)({ value: Number.NaN }), /non-finite number/);
+    strict_1.default.throws(() => (0, index_1.scrubMachineValue)({ value: undefined }), /unsupported undefined/);
+});
+(0, node_test_1.default)('machine-result emitter writes exactly one JSON document and leaves stderr empty', () => {
+    let stdout = '';
+    let stderr = '';
+    const result = (0, index_1.buildCliResult)({
+        command: 'ai.help',
+        phase: 'complete',
+        contractVersion: 'nexusclaw.cli-command-contract/v1',
+        ok: true,
+    });
+    (0, index_1.emitCliResult)(result, {
+        stdout: { write: (chunk) => { stdout += String(chunk); return true; } },
+        stderr: { write: (chunk) => { stderr += String(chunk); return true; } },
+    });
+    strict_1.default.equal(stderr, '');
+    strict_1.default.equal(stdout.trim().split('\n').length, 1);
+    strict_1.default.equal(JSON.parse(stdout).schemaVersion, 'nexusclaw.cli-result/v1');
+});
+(0, node_test_1.default)('governance CI guard accepts the sealed registry and classifies facts by safe stage', () => {
+    const contracts = index_1.commandContractRegistry.all().map((entry) => entry.contract);
+    strict_1.default.doesNotThrow(() => (0, index_1.assertCommandContractGovernance)(contracts));
+    strict_1.default.ok(index_1.SAFE_LOCAL_PERMISSION_FACTS.has('safe_bundle_inventory_contains_flow'));
+    strict_1.default.ok(index_1.AUTHORITATIVE_SERVER_PERMISSION_FACTS.has('authoritative_candidate_contains_flow'));
+    for (const fact of index_1.SAFE_LOCAL_PERMISSION_FACTS) {
+        strict_1.default.ok(!index_1.AUTHORITATIVE_SERVER_PERMISSION_FACTS.has(fact));
+    }
+});
+(0, node_test_1.default)('governance CI guard blocks incomplete/idempotency/step-up/canDevelop/permission metadata drift', () => {
+    const source = index_1.commandContractRegistry.find('employee.bundle.promote').contract;
+    const invalidCases = [
+        (contract) => { contract.contractCompleteness = 'partial'; },
+        (contract) => { contract.executionModes[0].requiresIdempotencyKey = false; },
+        (contract) => { contract.executionModes[0].requiresStepUp = false; },
+        (contract) => { contract.executionModes[0].requiresCanDevelop = false; },
+        (contract) => { contract.executionModes[0].permissionProfileId = 'BUNDLE_GATE'; },
+        (contract) => { contract.executionModes[0].permissionRules[0].require = [{ capability: 'ai.manage', action: 'publish' }]; },
+        (contract) => { contract.executionModes[0].permissionRules[1].when = 'surface_contains_flow'; },
+    ];
+    for (const mutate of invalidCases) {
+        const contract = structuredClone(source);
+        mutate(contract);
+        strict_1.default.throws(() => (0, index_1.assertModeGovernance)(contract, contract.executionModes[0]), /CLI_COMMAND_GOVERNANCE_INVALID/);
+    }
+});
+//# sourceMappingURL=contracts.test.js.map

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

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

package/dist/nexus-cli/src/contracts/exit-codes.d.ts

@@ -0,0 +1,3 @@
+export { CliExitCode, CliDiagnosticV1, CliResultV1, CliCommandContractV1, CliExecutionModeV1, CliArgvPredicateExprV1, CliPermissionProfileId, CliEffectKind, CliNextCommandV1, CliEvidenceEntryV1, } from '@nexusclaw/shared';
+import { resolveExitCode, EXIT_PRECEDENCE } from '@nexusclaw/shared';
+export { resolveExitCode, EXIT_PRECEDENCE };

package/dist/nexus-cli/src/contracts/exit-codes.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXIT_PRECEDENCE = exports.resolveExitCode = void 0;
+const shared_1 = require("@nexusclaw/shared");
+Object.defineProperty(exports, "resolveExitCode", { enumerable: true, get: function () { return shared_1.resolveExitCode; } });
+Object.defineProperty(exports, "EXIT_PRECEDENCE", { enumerable: true, get: function () { return shared_1.EXIT_PRECEDENCE; } });
+//# sourceMappingURL=exit-codes.js.map

package/dist/nexus-cli/src/contracts/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../../../src/contracts/exit-codes.ts"],"names":[],"mappings":";;;AAoBA,8CAAqE;AAE5D,gGAFA,wBAAe,OAEA;AAAE,gGAFA,wBAAe,OAEA"}

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

@@ -0,0 +1,8 @@
+export { implementedModesOf, hasImplementedMode, CLI_COMMAND_NOT_IMPLEMENTED, resolveInternalDispatch, } from './command-contract';
+export { commandContractRegistry, } from './command-contract.registry';
+export { CLI_MODE_UNMATCHED, CLI_MODE_AMBIGUOUS, CLI_MODE_USAGE_EXIT, validateArgvPredicate, evaluateArgvPredicate, resolveExecutionMode, type CliParsedOptions, type CliModeResolution, } from './argv-predicate';
+export { exportCommandContracts, type CliCommandRegistryExportV1, } from './command-contract.exporter';
+export { buildImplementedCommandOrder } from './command-order';
+export { SAFE_LOCAL_PERMISSION_FACTS, AUTHORITATIVE_SERVER_PERMISSION_FACTS, assertModeGovernance, assertCommandContractGovernance, } from './command-contract.guard';
+export { buildCliResult, renderCliResult, emitCliResult, scrubMachineValue, type CliMachineOutputStreams, } from './machine-result';
+export { resolveExitCode, EXIT_PRECEDENCE, } from './exit-codes';

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

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXIT_PRECEDENCE = exports.resolveExitCode = exports.scrubMachineValue = exports.emitCliResult = exports.renderCliResult = exports.buildCliResult = exports.assertCommandContractGovernance = exports.assertModeGovernance = exports.AUTHORITATIVE_SERVER_PERMISSION_FACTS = exports.SAFE_LOCAL_PERMISSION_FACTS = exports.buildImplementedCommandOrder = exports.exportCommandContracts = exports.resolveExecutionMode = exports.evaluateArgvPredicate = exports.validateArgvPredicate = exports.CLI_MODE_USAGE_EXIT = exports.CLI_MODE_AMBIGUOUS = exports.CLI_MODE_UNMATCHED = exports.commandContractRegistry = exports.resolveInternalDispatch = exports.CLI_COMMAND_NOT_IMPLEMENTED = exports.hasImplementedMode = exports.implementedModesOf = void 0;
+var command_contract_1 = require("./command-contract");
+Object.defineProperty(exports, "implementedModesOf", { enumerable: true, get: function () { return command_contract_1.implementedModesOf; } });
+Object.defineProperty(exports, "hasImplementedMode", { enumerable: true, get: function () { return command_contract_1.hasImplementedMode; } });
+Object.defineProperty(exports, "CLI_COMMAND_NOT_IMPLEMENTED", { enumerable: true, get: function () { return command_contract_1.CLI_COMMAND_NOT_IMPLEMENTED; } });
+Object.defineProperty(exports, "resolveInternalDispatch", { enumerable: true, get: function () { return command_contract_1.resolveInternalDispatch; } });
+var command_contract_registry_1 = require("./command-contract.registry");
+Object.defineProperty(exports, "commandContractRegistry", { enumerable: true, get: function () { return command_contract_registry_1.commandContractRegistry; } });
+var argv_predicate_1 = require("./argv-predicate");
+Object.defineProperty(exports, "CLI_MODE_UNMATCHED", { enumerable: true, get: function () { return argv_predicate_1.CLI_MODE_UNMATCHED; } });
+Object.defineProperty(exports, "CLI_MODE_AMBIGUOUS", { enumerable: true, get: function () { return argv_predicate_1.CLI_MODE_AMBIGUOUS; } });
+Object.defineProperty(exports, "CLI_MODE_USAGE_EXIT", { enumerable: true, get: function () { return argv_predicate_1.CLI_MODE_USAGE_EXIT; } });
+Object.defineProperty(exports, "validateArgvPredicate", { enumerable: true, get: function () { return argv_predicate_1.validateArgvPredicate; } });
+Object.defineProperty(exports, "evaluateArgvPredicate", { enumerable: true, get: function () { return argv_predicate_1.evaluateArgvPredicate; } });
+Object.defineProperty(exports, "resolveExecutionMode", { enumerable: true, get: function () { return argv_predicate_1.resolveExecutionMode; } });
+var command_contract_exporter_1 = require("./command-contract.exporter");
+Object.defineProperty(exports, "exportCommandContracts", { enumerable: true, get: function () { return command_contract_exporter_1.exportCommandContracts; } });
+var command_order_1 = require("./command-order");
+Object.defineProperty(exports, "buildImplementedCommandOrder", { enumerable: true, get: function () { return command_order_1.buildImplementedCommandOrder; } });
+var command_contract_guard_1 = require("./command-contract.guard");
+Object.defineProperty(exports, "SAFE_LOCAL_PERMISSION_FACTS", { enumerable: true, get: function () { return command_contract_guard_1.SAFE_LOCAL_PERMISSION_FACTS; } });
+Object.defineProperty(exports, "AUTHORITATIVE_SERVER_PERMISSION_FACTS", { enumerable: true, get: function () { return command_contract_guard_1.AUTHORITATIVE_SERVER_PERMISSION_FACTS; } });
+Object.defineProperty(exports, "assertModeGovernance", { enumerable: true, get: function () { return command_contract_guard_1.assertModeGovernance; } });
+Object.defineProperty(exports, "assertCommandContractGovernance", { enumerable: true, get: function () { return command_contract_guard_1.assertCommandContractGovernance; } });
+var machine_result_1 = require("./machine-result");
+Object.defineProperty(exports, "buildCliResult", { enumerable: true, get: function () { return machine_result_1.buildCliResult; } });
+Object.defineProperty(exports, "renderCliResult", { enumerable: true, get: function () { return machine_result_1.renderCliResult; } });
+Object.defineProperty(exports, "emitCliResult", { enumerable: true, get: function () { return machine_result_1.emitCliResult; } });
+Object.defineProperty(exports, "scrubMachineValue", { enumerable: true, get: function () { return machine_result_1.scrubMachineValue; } });
+var exit_codes_1 = require("./exit-codes");
+Object.defineProperty(exports, "resolveExitCode", { enumerable: true, get: function () { return exit_codes_1.resolveExitCode; } });
+Object.defineProperty(exports, "EXIT_PRECEDENCE", { enumerable: true, get: function () { return exit_codes_1.EXIT_PRECEDENCE; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/contracts/index.ts"],"names":[],"mappings":";;;AAAA,uDAK4B;AAJ1B,sHAAA,kBAAkB,OAAA;AAClB,sHAAA,kBAAkB,OAAA;AAClB,+HAAA,2BAA2B,OAAA;AAC3B,2HAAA,uBAAuB,OAAA;AAEzB,yEAEqC;AADnC,oIAAA,uBAAuB,OAAA;AAEzB,mDAS0B;AARxB,oHAAA,kBAAkB,OAAA;AAClB,oHAAA,kBAAkB,OAAA;AAClB,qHAAA,mBAAmB,OAAA;AACnB,uHAAA,qBAAqB,OAAA;AACrB,uHAAA,qBAAqB,OAAA;AACrB,sHAAA,oBAAoB,OAAA;AAItB,yEAGqC;AAFnC,mIAAA,sBAAsB,OAAA;AAGxB,iDAA+D;AAAtD,6HAAA,4BAA4B,OAAA;AACrC,mEAKkC;AAJhC,qIAAA,2BAA2B,OAAA;AAC3B,+IAAA,qCAAqC,OAAA;AACrC,8HAAA,oBAAoB,OAAA;AACpB,yIAAA,+BAA+B,OAAA;AAEjC,mDAM0B;AALxB,gHAAA,cAAc,OAAA;AACd,iHAAA,eAAe,OAAA;AACf,+GAAA,aAAa,OAAA;AACb,mHAAA,iBAAiB,OAAA;AAGnB,2CAGsB;AAFpB,6GAAA,eAAe,OAAA;AACf,6GAAA,eAAe,OAAA"}

package/dist/nexus-cli/src/contracts/machine-result.d.ts

@@ -0,0 +1,21 @@
+import type { CliResultV1, CliDiagnosticV1, CliExitCode, CliEvidenceEntryV1, CliNextCommandV1, JsonValue } from '@nexusclaw/shared';
+import { CLI_RESULT_SCHEMA_VERSION } from '@nexusclaw/shared';
+export declare function scrubMachineValue(value: unknown): JsonValue;
+export declare function buildCliResult(args: {
+    command: string;
+    phase: string;
+    contractVersion: string;
+    ok: boolean;
+    data?: unknown;
+    diagnostics?: CliDiagnosticV1[];
+    evidence?: CliEvidenceEntryV1[];
+    nextCommands?: CliNextCommandV1[];
+    exitCode?: CliExitCode;
+}): CliResultV1;
+export declare function renderCliResult(result: CliResultV1): string;
+export interface CliMachineOutputStreams {
+    stdout: Pick<NodeJS.WriteStream, 'write'>;
+    stderr: Pick<NodeJS.WriteStream, 'write'>;
+}
+export declare function emitCliResult(result: CliResultV1, streams?: CliMachineOutputStreams): void;
+export { CLI_RESULT_SCHEMA_VERSION };