@nexusclawhq/cli 0.2.1

package/dist/nexus-cli/src/commands/workspace/workspace.e2e.test.js

@@ -0,0 +1,320 @@
+"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_fs_1 = __importDefault(require("node:fs"));
+const node_http_1 = __importDefault(require("node:http"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = __importDefault(require("node:test"));
+const commander_1 = require("commander");
+const index_1 = require("./index");
+const pack_registry_1 = require("../../services/pack-registry");
+async function captureLogs(run) {
+    const logs = [];
+    const originalLog = console.log;
+    console.log = (...args) => {
+        logs.push(args.map((value) => String(value)).join(' '));
+    };
+    try {
+        await run();
+    }
+    finally {
+        console.log = originalLog;
+    }
+    return logs;
+}
+async function runWorkspaceCommand(argv) {
+    const program = new commander_1.Command();
+    (0, index_1.registerWorkspaceCommands)(program);
+    return captureLogs(async () => {
+        await program.parseAsync(['node', 'workspace-test', ...argv], { from: 'node' });
+    });
+}
+async function createWorkspaceHealthServer() {
+    const server = node_http_1.default.createServer((req, res) => {
+        let body = '';
+        req.on('data', (chunk) => {
+            body += chunk.toString();
+        });
+        req.on('end', () => {
+            const payload = JSON.parse(body || '{}');
+            if (payload.query?.includes('InstalledMetadataPackages')) {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    data: {
+                        installedMetadataPackages: [
+                            {
+                                id: 'pkg-1',
+                                workspaceId: 'ws-1',
+                                packageName: 'core.baseline',
+                                version: '0.9.0',
+                                installSource: 'registry',
+                                status: 'installed',
+                                installedAt: '2026-04-18T00:00:00.000Z',
+                                updatedAt: '2026-04-18T00:00:00.000Z',
+                                manifest: {
+                                    schemaVersion: 'v1',
+                                    name: 'core.baseline',
+                                    packageType: 'core-baseline',
+                                    packageClass: 'metadata',
+                                    version: '0.9.0',
+                                    dependencies: [],
+                                    compatibleCoreVersion: '^1.0.0',
+                                    installOrder: 100,
+                                    includedMetadataKinds: ['objects'],
+                                    includedSeedKinds: [],
+                                    visibility: 'internal',
+                                    releaseChannel: 'stable',
+                                },
+                            },
+                        ],
+                    },
+                }));
+                return;
+            }
+            if (payload.query?.includes('SourceStatus')) {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    data: {
+                        sourceStatus: {
+                            remoteRevision: 'rev-1',
+                            baselineAvailable: false,
+                            baselineRevision: null,
+                            baselineHash: null,
+                            baselineSource: null,
+                            changedComponentCount: 1,
+                            files: [
+                                {
+                                    path: 'objects/Account/object.json',
+                                    hash: 'remote-hash',
+                                    componentKey: 'object:Account',
+                                },
+                            ],
+                            baselineFiles: [],
+                            drift: {
+                                baselineAvailable: false,
+                                totalChanges: 0,
+                                humanSummary: [],
+                            },
+                            tracking: null,
+                        },
+                    },
+                }));
+                return;
+            }
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                errors: [{ message: `Unhandled operation: ${payload.query}` }],
+            }));
+        });
+    });
+    await new Promise((resolve) => server.listen(0, '127.0.0.1', () => resolve()));
+    const address = server.address();
+    if (!address || typeof address === 'string') {
+        throw new Error('Unable to resolve workspace health test server address');
+    }
+    return {
+        baseUrl: `http://127.0.0.1:${address.port}`,
+        close: () => new Promise((resolve, reject) => {
+            server.close((error) => (error ? reject(error) : resolve()));
+        }),
+    };
+}
+async function withWorkspaceFixture(run) {
+    const workspaceDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'nexusclaw-workspace-e2e-'));
+    const envDir = node_path_1.default.join(workspaceDir, 'env');
+    const registryRoot = node_path_1.default.join(workspaceDir, 'workspace-packages');
+    const sourcePackageDir = node_path_1.default.join(workspaceDir, 'source-package');
+    node_fs_1.default.mkdirSync(envDir, { recursive: true });
+    node_fs_1.default.mkdirSync(registryRoot, { recursive: true });
+    node_fs_1.default.mkdirSync(sourcePackageDir, { recursive: true });
+    node_fs_1.default.writeFileSync(node_path_1.default.join(workspaceDir, 'nexus-project.yaml'), [
+        'schemaVersion: dx-workspace/v1',
+        'projectName: crm-demo',
+        'compatibleCoreVersion: 0.1.x',
+        'sourceRoots:',
+        '  - path: src/metadata',
+        '    kind: metadata-runtime',
+        '    writeTarget: true',
+        'localPackages: []',
+        'registry:',
+        '  rootDirectory: workspace-packages',
+        'defaultEnvironment: dev',
+        'environments:',
+        '  - name: dev',
+        '    path: env/dev.sandbox.yaml',
+        'packageRefs:',
+        '  - core.baseline@1.0.0',
+    ].join('\n'));
+    node_fs_1.default.writeFileSync(node_path_1.default.join(envDir, 'dev.sandbox.yaml'), [
+        'schemaVersion: dx-environment/v1',
+        'name: dev',
+        'type: dev-sandbox',
+        'target:',
+        '  workspaceId: ws-1',
+        'packageStack:',
+        '  baseline:',
+        '    packageName: core.baseline',
+        '    packageType: core-baseline',
+        '  genericOverlay:',
+        '    packageName: overlay.generic-crm',
+        '    packageType: generic-overlay',
+    ].join('\n'));
+    node_fs_1.default.writeFileSync(node_path_1.default.join(sourcePackageDir, 'package.yaml'), [
+        'schemaVersion: v1',
+        'name: core.baseline',
+        'packageType: core-baseline',
+        'packageClass: metadata',
+        'description: Core baseline metadata package for workspace command tests.',
+        'version: 1.0.0',
+        'dependencies: []',
+        'compatibleCoreVersion: ^1.0.0',
+        'installOrder: 100',
+        'includedMetadataKinds: [objects]',
+        'includedSeedKinds: []',
+        'visibility: internal',
+        'releaseChannel: stable',
+        'kindSupport:',
+        '  - kind: objects',
+        '    executionMode: installer-input-backed',
+    ].join('\n'));
+    (0, pack_registry_1.publishPackageToLocalRegistry)({
+        registryRoot,
+        packageDirectory: sourcePackageDir,
+        manifest: {
+            schemaVersion: 'v1',
+            name: 'core.baseline',
+            packageType: 'core-baseline',
+            packageClass: 'metadata',
+            description: 'Core baseline metadata package for workspace command tests.',
+            version: '1.0.0',
+            dependencies: [],
+            compatibleCoreVersion: '^1.0.0',
+            installOrder: 100,
+            includedMetadataKinds: ['objects'],
+            includedSeedKinds: [],
+            visibility: 'internal',
+            releaseChannel: 'stable',
+            kindSupport: [{ kind: 'objects', executionMode: 'installer-input-backed' }],
+        },
+    });
+    try {
+        await run(workspaceDir);
+    }
+    finally {
+        node_fs_1.default.rmSync(workspaceDir, { recursive: true, force: true });
+    }
+}
+(0, node_test_1.default)('workspace init supports industry aliases and creates a valid manifest', async () => {
+    const tempDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'nexusclaw-workspace-e2e-'));
+    try {
+        await runWorkspaceCommand([
+            'workspace',
+            'init',
+            '--name',
+            'healthcare-demo',
+            '--dir',
+            tempDir,
+            '--template',
+            'healthcare',
+        ]);
+        const manifest = JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.join(tempDir, 'healthcare-demo', 'nexus-project.json'), 'utf8'));
+        strict_1.default.equal(manifest.starterTemplate, 'industry-healthcare');
+        strict_1.default.deepEqual(manifest.packageRefs, [
+            'core.baseline@0.1.0',
+            'overlay.generic-crm@0.1.0',
+            'industry.healthcare@0.1.0',
+        ]);
+    }
+    finally {
+        node_fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('workspace health supports formatted output, JSON output, and audit trail persistence', async () => {
+    const server = await createWorkspaceHealthServer();
+    const previousBaseUrl = process.env.NEXUS_BASE_URL;
+    const previousToken = process.env.NEXUS_AUTH_TOKEN;
+    process.env.NEXUS_BASE_URL = server.baseUrl;
+    process.env.NEXUS_AUTH_TOKEN = 'test-token';
+    try {
+        await withWorkspaceFixture(async (workspaceDir) => {
+            const formattedLogs = await runWorkspaceCommand([
+                'workspace',
+                'health',
+                '--workspace',
+                workspaceDir,
+                '--environment',
+                'dev',
+                '--workspace-id',
+                'ws-1',
+                '--verbose',
+            ]);
+            strict_1.default.equal(formattedLogs.length, 1);
+            strict_1.default.match(formattedLogs[0] ?? '', /WORKSPACE HEALTH ERROR/);
+            strict_1.default.match(formattedLogs[0] ?? '', /\[ERROR\] package-drift/);
+            strict_1.default.match(formattedLogs[0] ?? '', /\[WARNING\] source-drift/);
+            strict_1.default.match(formattedLogs[0] ?? '', /\[HEALTHY\] environment-stack/);
+            const jsonLogs = await runWorkspaceCommand([
+                'workspace',
+                'health',
+                '--workspace',
+                workspaceDir,
+                '--environment',
+                'dev',
+                '--workspace-id',
+                'ws-1',
+                '--json',
+                '--audit',
+            ]);
+            strict_1.default.equal(jsonLogs.length, 1);
+            const report = JSON.parse(jsonLogs[0] ?? '{}');
+            strict_1.default.equal(report.overallStatus, 'error');
+            strict_1.default.equal(report.workspaceRoot, workspaceDir);
+            strict_1.default.equal(report.environmentName, 'dev');
+            strict_1.default.deepEqual(report.dimensions.map((dimension) => ({
+                dimensionName: dimension.dimensionName,
+                status: dimension.status,
+            })), [
+                { dimensionName: 'manifest', status: 'healthy' },
+                { dimensionName: 'package-drift', status: 'error' },
+                { dimensionName: 'source-drift', status: 'warning' },
+                { dimensionName: 'environment-stack', status: 'healthy' },
+            ]);
+            const auditTrail = JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.join(workspaceDir, '.nexus-workspace-health.json'), 'utf8'));
+            strict_1.default.equal(auditTrail.overallStatus, 'error');
+            strict_1.default.deepEqual(auditTrail.dimensions.map((dimension) => ({
+                dimensionName: dimension.dimensionName,
+                status: dimension.status,
+            })), [
+                { dimensionName: 'manifest', status: 'healthy' },
+                { dimensionName: 'package-drift', status: 'error' },
+                { dimensionName: 'source-drift', status: 'warning' },
+                { dimensionName: 'environment-stack', status: 'healthy' },
+            ]);
+        });
+    }
+    finally {
+        process.env.NEXUS_BASE_URL = previousBaseUrl;
+        process.env.NEXUS_AUTH_TOKEN = previousToken;
+        await server.close();
+    }
+});
+(0, node_test_1.default)('workspace status remains available as a separate backward-compatible command', async () => {
+    await withWorkspaceFixture(async (workspaceDir) => {
+        const logs = await runWorkspaceCommand([
+            'workspace',
+            'status',
+            '--workspace',
+            workspaceDir,
+        ]);
+        const joined = logs.join('\n');
+        strict_1.default.match(joined, /crm-demo/);
+        strict_1.default.match(joined, /manifest:/);
+        strict_1.default.match(joined, /registry:/);
+        strict_1.default.doesNotMatch(joined, /WORKSPACE HEALTH/);
+    });
+});
+//# sourceMappingURL=workspace.e2e.test.js.map

package/dist/nexus-cli/src/commands/workspace/workspace.e2e.test.js.map

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

package/dist/nexus-cli/src/config/metadata-type-map.json

@@ -0,0 +1,12 @@
+{
+  "CustomObject": "ObjectMetadata",
+  "CustomField": "FieldMetadata",
+  "ApexTrigger": "Trigger",
+  "ApexClass": "ServerlessFunction",
+  "CustomTab": "CustomPage",
+  "GlobalValueSet": "GlobalValueSet",
+  "CustomMetadata": "CustomMetadata",
+  "CustomLabels": "CustomLabel",
+  "Profile": "PermissionSet",
+  "PermissionSet": "PermissionSet"
+}

package/dist/nexus-cli/src/contracts/argv-predicate.d.ts

@@ -0,0 +1,17 @@
+import type { CliArgvPredicateExprV1, CliExecutionModeV1 } from '@nexusclaw/shared';
+export declare const CLI_MODE_UNMATCHED = "CLI_MODE_UNMATCHED";
+export declare const CLI_MODE_AMBIGUOUS = "CLI_MODE_AMBIGUOUS";
+export declare const CLI_MODE_USAGE_EXIT: 64;
+export type CliParsedOptionValue = string | number | boolean;
+export type CliParsedOptions = Readonly<Record<string, CliParsedOptionValue>>;
+export declare function validateArgvPredicate(expression: CliArgvPredicateExprV1, knownOptions: ReadonlySet<string>, depth?: number): void;
+export declare function evaluateArgvPredicate(expression: CliArgvPredicateExprV1, options: CliParsedOptions): boolean;
+export type CliModeResolution = {
+    ok: true;
+    mode: CliExecutionModeV1;
+} | {
+    ok: false;
+    code: typeof CLI_MODE_UNMATCHED | typeof CLI_MODE_AMBIGUOUS;
+    exitCode: typeof CLI_MODE_USAGE_EXIT;
+};
+export declare function resolveExecutionMode(modes: ReadonlyArray<CliExecutionModeV1>, options: CliParsedOptions): CliModeResolution;

package/dist/nexus-cli/src/contracts/argv-predicate.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_MODE_USAGE_EXIT = exports.CLI_MODE_AMBIGUOUS = exports.CLI_MODE_UNMATCHED = void 0;
+exports.validateArgvPredicate = validateArgvPredicate;
+exports.evaluateArgvPredicate = evaluateArgvPredicate;
+exports.resolveExecutionMode = resolveExecutionMode;
+exports.CLI_MODE_UNMATCHED = 'CLI_MODE_UNMATCHED';
+exports.CLI_MODE_AMBIGUOUS = 'CLI_MODE_AMBIGUOUS';
+exports.CLI_MODE_USAGE_EXIT = 64;
+const UUID_V1_TO_V5 = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const SHA256 = /^sha256:[0-9a-f]{64}$/;
+const NON_NEGATIVE_INTEGER = /^(?:0|[1-9][0-9]*)$/;
+const MAX_PREDICATE_DEPTH = 8;
+function hasOption(options, option) {
+    return Object.prototype.hasOwnProperty.call(options, option);
+}
+function matchesSchema(value, matcher) {
+    if (matcher === 'uuid')
+        return typeof value === 'string' && UUID_V1_TO_V5.test(value);
+    if (matcher === 'sha256')
+        return typeof value === 'string' && SHA256.test(value);
+    if (typeof value === 'number')
+        return Number.isSafeInteger(value) && value >= 0;
+    return typeof value === 'string' && NON_NEGATIVE_INTEGER.test(value);
+}
+function validateArgvPredicate(expression, knownOptions, depth = 1) {
+    if (depth > MAX_PREDICATE_DEPTH) {
+        throw new Error('CLI_COMMAND_CONTRACT_INVALID: argv predicate depth exceeds 8');
+    }
+    if (expression.kind === 'all_of' || expression.kind === 'any_of') {
+        if (expression.expressions.length === 0) {
+            throw new Error(`CLI_COMMAND_CONTRACT_INVALID: ${expression.kind} must be non-empty`);
+        }
+        for (const child of expression.expressions)
+            validateArgvPredicate(child, knownOptions, depth + 1);
+        return;
+    }
+    if (expression.kind === 'not') {
+        validateArgvPredicate(expression.expression, knownOptions, depth + 1);
+        return;
+    }
+    let referenced;
+    switch (expression.kind) {
+        case 'exactly_one':
+        case 'none_of':
+            referenced = expression.options;
+            break;
+        case 'option_present':
+        case 'option_absent':
+        case 'option_equals':
+        case 'option_matches_schema':
+            referenced = [expression.option];
+            break;
+    }
+    if (referenced.length === 0 || new Set(referenced).size !== referenced.length) {
+        throw new Error(`CLI_COMMAND_CONTRACT_INVALID: ${expression.kind} options must be non-empty and unique`);
+    }
+    for (const option of referenced) {
+        if (!knownOptions.has(option)) {
+            throw new Error(`CLI_COMMAND_CONTRACT_INVALID: predicate references unknown option ${option}`);
+        }
+    }
+}
+function evaluateArgvPredicate(expression, options) {
+    switch (expression.kind) {
+        case 'option_present': return hasOption(options, expression.option);
+        case 'option_absent': return !hasOption(options, expression.option);
+        case 'option_equals': return hasOption(options, expression.option) && options[expression.option] === expression.value;
+        case 'option_matches_schema': {
+            const value = options[expression.option];
+            return value !== undefined && matchesSchema(value, expression.matcher);
+        }
+        case 'exactly_one': return expression.options.filter((option) => hasOption(options, option)).length === 1;
+        case 'none_of': return expression.options.every((option) => !hasOption(options, option));
+        case 'all_of': return expression.expressions.every((child) => evaluateArgvPredicate(child, options));
+        case 'any_of': return expression.expressions.some((child) => evaluateArgvPredicate(child, options));
+        case 'not': return !evaluateArgvPredicate(expression.expression, options);
+    }
+}
+function resolveExecutionMode(modes, options) {
+    const matches = modes.filter((mode) => evaluateArgvPredicate(mode.when, options));
+    if (matches.length === 0)
+        return { ok: false, code: exports.CLI_MODE_UNMATCHED, exitCode: exports.CLI_MODE_USAGE_EXIT };
+    if (matches.length > 1)
+        return { ok: false, code: exports.CLI_MODE_AMBIGUOUS, exitCode: exports.CLI_MODE_USAGE_EXIT };
+    return { ok: true, mode: matches[0] };
+}
+//# sourceMappingURL=argv-predicate.js.map

package/dist/nexus-cli/src/contracts/argv-predicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv-predicate.js","sourceRoot":"","sources":["../../../../src/contracts/argv-predicate.ts"],"names":[],"mappings":";;;AA4BA,sDA0CC;AAED,sDAkBC;AAMD,oDAQC;AAnGY,QAAA,kBAAkB,GAAG,oBAAoB,CAAC;AAC1C,QAAA,kBAAkB,GAAG,oBAAoB,CAAC;AAC1C,QAAA,mBAAmB,GAAG,EAAW,CAAC;AAK/C,MAAM,aAAa,GAAG,4EAA4E,CAAC;AACnG,MAAM,MAAM,GAAG,uBAAuB,CAAC;AACvC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AACnD,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,SAAS,SAAS,CAAC,OAAyB,EAAE,MAAc;IAC1D,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,aAAa,CAAC,KAA2B,EAAE,OAA+C;IACjG,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtF,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAChF,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAgB,qBAAqB,CACnC,UAAkC,EAClC,YAAiC,EACjC,KAAK,GAAG,CAAC;IAET,IAAI,KAAK,GAAG,mBAAmB,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjE,IAAI,UAAU,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,iCAAiC,UAAU,CAAC,IAAI,oBAAoB,CAAC,CAAC;QACxF,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,WAAW;YAAE,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAClG,OAAO;IACT,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC9B,qBAAqB,CAAC,UAAU,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,IAAI,UAAiC,CAAC;IACtC,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,aAAa,CAAC;QACnB,KAAK,SAAS;YACZ,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC;YAChC,MAAM;QACR,KAAK,gBAAgB,CAAC;QACtB,KAAK,eAAe,CAAC;QACrB,KAAK,eAAe,CAAC;QACrB,KAAK,uBAAuB;YAC1B,UAAU,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM;IACV,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,iCAAiC,UAAU,CAAC,IAAI,uCAAuC,CAAC,CAAC;IAC3G,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,qEAAqE,MAAM,EAAE,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,qBAAqB,CACnC,UAAkC,EAClC,OAAyB;IAEzB,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,gBAAgB,CAAC,CAAC,OAAO,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACpE,KAAK,eAAe,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACpE,KAAK,eAAe,CAAC,CAAC,OAAO,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,KAAK,CAAC;QACtH,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,KAAK,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QACzE,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;QAC1G,KAAK,SAAS,CAAC,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACzF,KAAK,QAAQ,CAAC,CAAC,OAAO,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACrG,KAAK,QAAQ,CAAC,CAAC,OAAO,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACpG,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAMD,SAAgB,oBAAoB,CAClC,KAAwC,EACxC,OAAyB;IAEzB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAClF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,0BAAkB,EAAE,QAAQ,EAAE,2BAAmB,EAAE,CAAC;IACxG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,0BAAkB,EAAE,QAAQ,EAAE,2BAAmB,EAAE,CAAC;IACtG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { CliCommandContractV1, CliExecutionModeV1 } from '@nexusclaw/shared';
+export interface RegisteredCommandContract {
+    contract: CliCommandContractV1;
+    registeredAt: string;
+}
+export declare function implementedModesOf(contract: CliCommandContractV1): CliExecutionModeV1[];
+export declare function hasImplementedMode(contract: CliCommandContractV1): boolean;
+export declare const CLI_COMMAND_NOT_IMPLEMENTED = "CLI_COMMAND_NOT_IMPLEMENTED";
+export declare function resolveInternalDispatch(contract: CliCommandContractV1, modeId: string): {
+    readonly ok: true;
+    readonly implementationId: string;
+} | {
+    readonly ok: false;
+    readonly code: typeof CLI_COMMAND_NOT_IMPLEMENTED;
+};

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

@@ -0,0 +1,7 @@
+import { type CliCommandContractV1 } from '@nexusclaw/shared';
+export interface CliCommandRegistryExportV1 {
+    schemaVersion: 'nexusclaw.cli-command-registry/v1';
+    commands: CliCommandContractV1[];
+    registryDigest: `sha256:${string}`;
+}
+export declare function exportCommandContracts(contracts: ReadonlyArray<CliCommandContractV1>, includePlanned?: boolean): CliCommandRegistryExportV1;

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportCommandContracts = exportCommandContracts;
+const shared_1 = require("@nexusclaw/shared");
+const command_contract_1 = require("./command-contract");
+function executableProjection(contract) {
+    return { ...contract, executionModes: (0, command_contract_1.implementedModesOf)(contract) };
+}
+function exportCommandContracts(contracts, includePlanned = false) {
+    const commands = contracts
+        .map((contract) => includePlanned ? contract : executableProjection(contract))
+        .filter((contract) => contract.executionModes.length > 0)
+        .sort((a, b) => a.commandId.localeCompare(b.commandId));
+    const digestInput = {
+        schemaVersion: 'nexusclaw.cli-command-registry/v1',
+        commands,
+    };
+    return {
+        schemaVersion: 'nexusclaw.cli-command-registry/v1',
+        commands,
+        registryDigest: (0, shared_1.canonicalJsonDigest)(digestInput),
+    };
+}
+//# sourceMappingURL=command-contract.exporter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-contract.exporter.js","sourceRoot":"","sources":["../../../../src/contracts/command-contract.exporter.ts"],"names":[],"mappings":";;AAiBA,wDAiBC;AAlCD,8CAI2B;AAC3B,yDAAwD;AAQxD,SAAS,oBAAoB,CAAC,QAA8B;IAC1D,OAAO,EAAE,GAAG,QAAQ,EAAE,cAAc,EAAE,IAAA,qCAAkB,EAAC,QAAQ,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,SAAgB,sBAAsB,CACpC,SAA8C,EAC9C,cAAc,GAAG,KAAK;IAEtB,MAAM,QAAQ,GAAG,SAAS;SACvB,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;SAC7E,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;SACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG;QAClB,aAAa,EAAE,mCAAmC;QAClD,QAAQ;KACe,CAAC;IAC1B,OAAO;QACL,aAAa,EAAE,mCAAmC;QAClD,QAAQ;QACR,cAAc,EAAE,IAAA,4BAAmB,EAAC,WAAW,CAAC;KACjD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { CliCommandContractV1, CliExecutionModeV1, CliPermissionFactV1 } from '@nexusclaw/shared';
+export declare const SAFE_LOCAL_PERMISSION_FACTS: ReadonlySet<CliPermissionFactV1>;
+export declare const AUTHORITATIVE_SERVER_PERMISSION_FACTS: ReadonlySet<CliPermissionFactV1>;
+export declare function assertModeGovernance(contract: CliCommandContractV1, mode: CliExecutionModeV1): void;
+export declare function assertCommandContractGovernance(contracts: ReadonlyArray<CliCommandContractV1>): void;