@nexusclawhq/cli 0.2.1

package/dist/nexus-cli/src/services/code-extension-governance.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCodeExtensionGovernance = validateCodeExtensionGovernance;
+function isCodeExtensionManifest(manifest) {
+    return manifest.schemaVersion === 'v1' && manifest.packageClass === 'code-extension';
+}
+function detectCircularDependency(adjacency) {
+    const visiting = new Set();
+    const visited = new Set();
+    const stack = [];
+    const visit = (node) => {
+        if (visiting.has(node)) {
+            const cycleStart = stack.indexOf(node);
+            return stack.slice(cycleStart).concat(node);
+        }
+        if (visited.has(node)) {
+            return null;
+        }
+        visiting.add(node);
+        stack.push(node);
+        for (const dependency of adjacency.get(node) ?? []) {
+            const cycle = visit(dependency);
+            if (cycle) {
+                return cycle;
+            }
+        }
+        stack.pop();
+        visiting.delete(node);
+        visited.add(node);
+        return null;
+    };
+    for (const node of adjacency.keys()) {
+        const cycle = visit(node);
+        if (cycle) {
+            return cycle;
+        }
+    }
+    return [];
+}
+function collectEvidenceRefs(manifest) {
+    const refs = new Set();
+    for (const artifact of manifest.executableArtifacts ?? []) {
+        if (artifact.sourcePath?.trim()) {
+            refs.add(artifact.sourcePath.trim());
+        }
+    }
+    for (const evidenceRef of [
+        manifest.trialEvidence?.extensionRuntimeLogPath,
+        manifest.trialEvidence?.dependencyReportPath,
+        manifest.trialEvidence?.failedExtensionEvidencePath,
+        manifest.trialEvidence?.debugAttributionPath,
+        manifest.trialEvidence?.rollbackEvidencePath,
+    ]) {
+        if (typeof evidenceRef === 'string' && evidenceRef.trim().length > 0) {
+            refs.add(evidenceRef.trim());
+        }
+    }
+    return Array.from(refs);
+}
+function inferAttribution(message) {
+    const normalized = message.toLowerCase();
+    if (normalized.includes('runtimeapiversion') || normalized.includes('runtimeproviderrequirement')) {
+        return 'runtime';
+    }
+    if (normalized.includes('dependson')
+        || normalized.includes('dependency')
+        || normalized.includes('circular extension dependency')) {
+        return 'dependency';
+    }
+    if (normalized.includes('codeextensiongovernance') || normalized.includes('contractversion')) {
+        return 'config';
+    }
+    return 'extension';
+}
+function validateCodeExtensionGovernance(manifest, options) {
+    const checkedExtensions = [];
+    const errors = [];
+    const warnings = [];
+    if (!isCodeExtensionManifest(manifest)) {
+        return {
+            schemaVersion: 'code-extension-governance-validation/v1',
+            status: 'passed',
+            packageName: manifest.name,
+            packageVersion: manifest.version,
+            contractVersion: null,
+            runtimeApiVersion: null,
+            checkedExtensions,
+            errors,
+            warnings,
+            artifactRefs: [],
+            evidenceRefs: [],
+            comparedUpgradeFields: [],
+            attributionSummary: [],
+        };
+    }
+    const contractVersion = manifest.codeExtensionGovernance?.contractVersion ?? null;
+    const runtimeApiVersion = manifest.codeExtensionGovernance?.runtimeApiVersion ?? null;
+    if (!manifest.codeExtensionGovernance) {
+        errors.push('codeExtensionGovernance is required for code-extension packages.');
+    }
+    else {
+        if (!['code-extension-governance/v1', 'code-extension-governance/v2'].includes(contractVersion ?? '')) {
+            errors.push('codeExtensionGovernance.contractVersion is unsupported.');
+        }
+        if (!runtimeApiVersion?.trim()) {
+            errors.push('codeExtensionGovernance.runtimeApiVersion is required.');
+        }
+    }
+    const adjacency = new Map();
+    const extensionIds = new Set();
+    const artifactRefs = (manifest.executableArtifacts ?? []).map((artifact) => artifact.sourcePath);
+    const evidenceRefs = collectEvidenceRefs(manifest);
+    for (const artifact of manifest.executableArtifacts ?? []) {
+        const extensionErrors = [];
+        const extensionWarnings = [];
+        const extensionId = artifact.extensionId?.trim() ?? '';
+        const dependsOn = (artifact.dependsOn ?? [])
+            .map((dependency) => String(dependency).trim())
+            .filter(Boolean);
+        if (contractVersion === 'code-extension-governance/v2'
+            && (artifact.kind !== 'function'
+                || artifact.functionType !== 'ACTION'
+                || artifact.entrypoint !== 'default'
+                || artifact.actionContractVersion !== 'nexus-code-action/v1'
+                || artifact.runtimeApiVersion !== 'runtime/v2'
+                || 'dependsOn' in artifact)) {
+            extensionErrors.push('governance/v2 artifact must be an exact dependency-free default-export ACTION.');
+        }
+        if (!extensionId) {
+            extensionErrors.push('extensionId is required.');
+        }
+        else if (extensionIds.has(extensionId)) {
+            extensionErrors.push(`duplicate extensionId "${extensionId}".`);
+        }
+        else {
+            extensionIds.add(extensionId);
+            adjacency.set(extensionId, dependsOn);
+        }
+        checkedExtensions.push({
+            extensionId: extensionId || `${artifact.kind}:${artifact.apiName}`,
+            kind: artifact.kind,
+            apiName: artifact.apiName,
+            sourcePath: artifact.sourcePath,
+            dependsOn,
+            errors: extensionErrors,
+            warnings: extensionWarnings,
+        });
+    }
+    for (const extension of checkedExtensions) {
+        for (const dependency of extension.dependsOn) {
+            if (!adjacency.has(dependency)) {
+                extension.errors.push(`dependsOn references unknown extensionId "${dependency}".`);
+            }
+        }
+    }
+    const cycle = detectCircularDependency(adjacency);
+    if (cycle.length > 0) {
+        errors.push(`circular extension dependency detected: ${cycle.join(' -> ')}`);
+        const cycleMembers = new Set(cycle);
+        checkedExtensions.forEach((entry) => {
+            if (cycleMembers.has(entry.extensionId)) {
+                entry.errors.push('participates in a circular dependency.');
+            }
+        });
+    }
+    const comparedUpgradeFields = [];
+    if (options?.existingManifest && isCodeExtensionManifest(options.existingManifest)) {
+        const existing = options.existingManifest;
+        if (existing.codeExtensionGovernance?.contractVersion !== contractVersion) {
+            comparedUpgradeFields.push('codeExtensionGovernance.contractVersion');
+        }
+        if (existing.codeExtensionGovernance?.runtimeApiVersion !== runtimeApiVersion) {
+            comparedUpgradeFields.push('codeExtensionGovernance.runtimeApiVersion');
+        }
+        const previousIds = new Set((existing.executableArtifacts ?? [])
+            .map((artifact) => artifact.extensionId?.trim())
+            .filter((value) => Boolean(value)));
+        const nextIds = new Set(checkedExtensions.map((entry) => entry.extensionId));
+        for (const previousId of previousIds) {
+            if (!nextIds.has(previousId)) {
+                comparedUpgradeFields.push(`executableArtifacts.extensionId:${previousId}`);
+            }
+        }
+    }
+    const flattenedErrors = [
+        ...errors,
+        ...checkedExtensions.flatMap((entry) => entry.errors.map((message) => `${entry.extensionId}: ${message}`)),
+    ];
+    const flattenedWarnings = [
+        ...warnings,
+        ...(comparedUpgradeFields.length > 0
+            ? [`governed upgrade fields changed: ${comparedUpgradeFields.join(', ')}`]
+            : []),
+        ...checkedExtensions.flatMap((entry) => entry.warnings.map((message) => `${entry.extensionId}: ${message}`)),
+    ];
+    const attributionSummary = Array.from(new Set(flattenedErrors.concat(flattenedWarnings).map((message) => inferAttribution(message))));
+    return {
+        schemaVersion: 'code-extension-governance-validation/v1',
+        status: flattenedErrors.length > 0
+            ? 'failed'
+            : flattenedWarnings.length > 0
+                ? 'warning'
+                : 'passed',
+        packageName: manifest.name,
+        packageVersion: manifest.version,
+        contractVersion,
+        runtimeApiVersion,
+        checkedExtensions,
+        errors: flattenedErrors,
+        warnings: flattenedWarnings,
+        artifactRefs,
+        evidenceRefs,
+        comparedUpgradeFields,
+        attributionSummary,
+    };
+}
+//# sourceMappingURL=code-extension-governance.js.map

package/dist/nexus-cli/src/services/code-extension-governance.js.map

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

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

@@ -0,0 +1,23 @@
+export interface AuthConfig {
+    token?: string;
+    baseUrl?: string;
+    username?: string;
+}
+export interface CliConfig {
+    defaultTarget?: string;
+    auth?: AuthConfig;
+    registryUrl?: string;
+    defaultReleaseChannel?: string;
+    workspaceRoot?: string;
+    defaultEnvironment?: string;
+    projectConfigPath?: string;
+}
+export declare function loadConfig(): CliConfig;
+export declare function saveConfig(config: CliConfig): void;
+export declare function getAuthToken(): string | undefined;
+export declare function getBaseUrl(): string;
+export declare function getRegistryUrl(): string | undefined;
+export declare function getDefaultReleaseChannel(): string;
+export declare function getWorkspaceRoot(): string;
+export declare function getDefaultEnvironment(): string | undefined;
+export declare function saveAuth(auth: AuthConfig): void;

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

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.getAuthToken = getAuthToken;
+exports.getBaseUrl = getBaseUrl;
+exports.getRegistryUrl = getRegistryUrl;
+exports.getDefaultReleaseChannel = getDefaultReleaseChannel;
+exports.getWorkspaceRoot = getWorkspaceRoot;
+exports.getDefaultEnvironment = getDefaultEnvironment;
+exports.saveAuth = saveAuth;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const CONFIG_DIR = path.join(os.homedir(), '.nexusclaw');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const DEFAULT_CONFIG = {
+    defaultReleaseChannel: 'stable',
+};
+function normalizeConfig(rawConfig) {
+    if (!rawConfig || typeof rawConfig !== 'object') {
+        return { ...DEFAULT_CONFIG };
+    }
+    const config = rawConfig;
+    return {
+        ...DEFAULT_CONFIG,
+        ...config,
+        auth: config.auth ? { ...config.auth } : undefined,
+    };
+}
+function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+function loadConfig() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const raw = fs.readFileSync(CONFIG_FILE, 'utf-8');
+            return normalizeConfig(JSON.parse(raw));
+        }
+    }
+    catch {
+    }
+    return { ...DEFAULT_CONFIG };
+}
+function saveConfig(config) {
+    ensureConfigDir();
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(normalizeConfig(config), null, 2), 'utf-8');
+}
+function getAuthToken() {
+    return process.env.NEXUS_AUTH_TOKEN || loadConfig().auth?.token;
+}
+function getBaseUrl() {
+    return (process.env.NEXUS_BASE_URL ||
+        loadConfig().auth?.baseUrl ||
+        'http://localhost:8000');
+}
+function getRegistryUrl() {
+    return process.env.NEXUS_REGISTRY_URL || loadConfig().registryUrl;
+}
+function getDefaultReleaseChannel() {
+    return process.env.NEXUS_RELEASE_CHANNEL || loadConfig().defaultReleaseChannel || 'stable';
+}
+function getWorkspaceRoot() {
+    return process.env.NEXUS_WORKSPACE_ROOT || loadConfig().workspaceRoot || process.cwd();
+}
+function getDefaultEnvironment() {
+    return process.env.NEXUS_DEFAULT_ENVIRONMENT || loadConfig().defaultEnvironment;
+}
+function saveAuth(auth) {
+    const config = loadConfig();
+    config.auth = { ...config.auth, ...auth };
+    saveConfig(config);
+}
+//# sourceMappingURL=config.js.map

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

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

package/dist/nexus-cli/src/services/config.test.d.ts

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

package/dist/nexus-cli/src/services/config.test.js

@@ -0,0 +1,120 @@
+"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_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = __importDefault(require("node:test"));
+function withTempHome(callback) {
+    const originalHome = process.env.HOME;
+    const originalUserProfile = process.env.USERPROFILE;
+    const tempHome = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'nexus-cli-config-'));
+    process.env.HOME = tempHome;
+    process.env.USERPROFILE = tempHome;
+    try {
+        return callback(tempHome);
+    }
+    finally {
+        if (originalHome === undefined) {
+            delete process.env.HOME;
+        }
+        else {
+            process.env.HOME = originalHome;
+        }
+        if (originalUserProfile === undefined) {
+            delete process.env.USERPROFILE;
+        }
+        else {
+            process.env.USERPROFILE = originalUserProfile;
+        }
+        delete process.env.NEXUS_AUTH_TOKEN;
+        delete process.env.NEXUS_BASE_URL;
+        node_fs_1.default.rmSync(tempHome, { recursive: true, force: true });
+    }
+}
+function loadConfigModule() {
+    const modulePath = require.resolve('./config');
+    delete require.cache[modulePath];
+    return require(modulePath);
+}
+(0, node_test_1.default)('saveConfig and loadConfig persist CLI configuration under the user home', () => {
+    withTempHome((tempHome) => {
+        const configModule = loadConfigModule();
+        configModule.saveConfig({
+            defaultTarget: 'prod',
+            registryUrl: 'https://registry.nexusclaw.com',
+            defaultReleaseChannel: 'preview',
+            workspaceRoot: '/tmp/nexus-workspace',
+            defaultEnvironment: 'trial',
+            projectConfigPath: '/tmp/nexus-workspace/nexus-project.yaml',
+            auth: {
+                token: 'stored-token',
+                baseUrl: 'https://api.nexusclaw.com',
+                username: 'bill@nexusclaw.com',
+            },
+        });
+        const configPath = node_path_1.default.join(tempHome, '.nexusclaw', 'config.json');
+        strict_1.default.ok(node_fs_1.default.existsSync(configPath));
+        strict_1.default.deepEqual(configModule.loadConfig(), {
+            defaultTarget: 'prod',
+            registryUrl: 'https://registry.nexusclaw.com',
+            defaultReleaseChannel: 'preview',
+            workspaceRoot: '/tmp/nexus-workspace',
+            defaultEnvironment: 'trial',
+            projectConfigPath: '/tmp/nexus-workspace/nexus-project.yaml',
+            auth: {
+                token: 'stored-token',
+                baseUrl: 'https://api.nexusclaw.com',
+                username: 'bill@nexusclaw.com',
+            },
+        });
+    });
+});
+(0, node_test_1.default)('getAuthToken and getBaseUrl prefer environment overrides', () => {
+    withTempHome(() => {
+        const configModule = loadConfigModule();
+        configModule.saveAuth({
+            token: 'stored-token',
+            baseUrl: 'https://stored.nexusclaw.com',
+            username: 'bill@nexusclaw.com',
+        });
+        process.env.NEXUS_AUTH_TOKEN = 'env-token';
+        process.env.NEXUS_BASE_URL = 'https://env.nexusclaw.com';
+        strict_1.default.equal(configModule.getAuthToken(), 'env-token');
+        strict_1.default.equal(configModule.getBaseUrl(), 'https://env.nexusclaw.com');
+    });
+});
+(0, node_test_1.default)('loadConfig applies default CLI preferences for newly added config fields', () => {
+    withTempHome(() => {
+        const configModule = loadConfigModule();
+        strict_1.default.deepEqual(configModule.loadConfig(), {
+            defaultReleaseChannel: 'stable',
+        });
+        strict_1.default.equal(configModule.getDefaultReleaseChannel(), 'stable');
+        strict_1.default.equal(configModule.getWorkspaceRoot(), process.cwd());
+        strict_1.default.equal(configModule.getDefaultEnvironment(), undefined);
+        strict_1.default.equal(configModule.getRegistryUrl(), undefined);
+    });
+});
+(0, node_test_1.default)('saveAuth merges auth fields into the existing config', () => {
+    withTempHome(() => {
+        const configModule = loadConfigModule();
+        configModule.saveConfig({ defaultTarget: 'sandbox' });
+        configModule.saveAuth({
+            token: 'stored-token',
+            baseUrl: 'https://api.nexusclaw.com',
+        });
+        strict_1.default.deepEqual(configModule.loadConfig(), {
+            defaultReleaseChannel: 'stable',
+            defaultTarget: 'sandbox',
+            auth: {
+                token: 'stored-token',
+                baseUrl: 'https://api.nexusclaw.com',
+            },
+        });
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/nexus-cli/src/services/config.test.js.map

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

package/dist/nexus-cli/src/services/core-version.d.ts

@@ -0,0 +1,14 @@
+export declare const CLI_SUPPORTED_CORE_VERSION_RANGE = ">=0.1.0 <1.0.0";
+export declare function satisfiesRange(version: string, versionRange: string): boolean;
+export interface CoreVersionError {
+    command: string;
+    phase: 'startup';
+    metadataKind: null;
+    reason: 'incompatible-core-version';
+    detail: string;
+}
+export declare function ensureCompatibleCore(manifest: {
+    compatibleCoreVersion?: string;
+}): void;
+export declare function normalizeCoreVersionArg(raw: string | undefined): string | undefined;
+export declare function normalizeCoreShaArg(raw: string | undefined): string | undefined;

package/dist/nexus-cli/src/services/core-version.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_SUPPORTED_CORE_VERSION_RANGE = void 0;
+exports.satisfiesRange = satisfiesRange;
+exports.ensureCompatibleCore = ensureCompatibleCore;
+exports.normalizeCoreVersionArg = normalizeCoreVersionArg;
+exports.normalizeCoreShaArg = normalizeCoreShaArg;
+exports.CLI_SUPPORTED_CORE_VERSION_RANGE = '>=0.1.0 <1.0.0';
+function compareVersions(left, right) {
+    const leftParts = left.split('.').map((part) => Number(part));
+    const rightParts = right.split('.').map((part) => Number(part));
+    for (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {
+        const delta = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
+        if (delta !== 0) {
+            return delta;
+        }
+    }
+    return 0;
+}
+function matchesToken(version, token) {
+    if (!token || token === '*' || token.toLowerCase() === 'latest') {
+        return true;
+    }
+    if (token.includes('x') || token.includes('X')) {
+        const parts = token.split('.');
+        const versionParts = version.split('.');
+        for (let i = 0; i < parts.length; i++) {
+            if (parts[i] === 'x' || parts[i] === 'X') {
+                continue;
+            }
+            if (versionParts[i] !== parts[i]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    if (token.startsWith('^')) {
+        const base = token.slice(1);
+        const [major] = base.split('.');
+        return version.startsWith(`${major}.`) && compareVersions(version, base) >= 0;
+    }
+    if (token.startsWith('~')) {
+        const base = token.slice(1);
+        const [major, minor] = base.split('.');
+        return version.startsWith(`${major}.${minor}.`) && compareVersions(version, base) >= 0;
+    }
+    for (const operator of ['>=', '<=', '>', '<']) {
+        if (token.startsWith(operator)) {
+            const target = token.slice(operator.length);
+            const delta = compareVersions(version, target);
+            switch (operator) {
+                case '>=':
+                    return delta >= 0;
+                case '<=':
+                    return delta <= 0;
+                case '>':
+                    return delta > 0;
+                case '<':
+                    return delta < 0;
+                default:
+                    return false;
+            }
+        }
+    }
+    return compareVersions(version, token) === 0;
+}
+function satisfiesRange(version, versionRange) {
+    return versionRange
+        .split(/\s+/)
+        .filter(Boolean)
+        .every((token) => matchesToken(version, token));
+}
+function ensureCompatibleCore(manifest) {
+    const manifestVersion = manifest.compatibleCoreVersion;
+    if (!manifestVersion) {
+        return;
+    }
+    const concreteVersion = extractConcreteVersion(manifestVersion);
+    if (!concreteVersion) {
+        throw createIncompatibleError(manifestVersion);
+    }
+    if (!satisfiesRange(concreteVersion, exports.CLI_SUPPORTED_CORE_VERSION_RANGE)) {
+        throw createIncompatibleError(manifestVersion);
+    }
+}
+function extractConcreteVersion(versionDecl) {
+    const trimmed = versionDecl.trim();
+    const stripped = trimmed.replace(/^[~^>=<]+/, '');
+    const concrete = stripped.replace(/[xX]/g, '0');
+    if (!/^\d+(\.\d+)*$/.test(concrete)) {
+        return null;
+    }
+    const parts = concrete.split('.');
+    while (parts.length < 3) {
+        parts.push('0');
+    }
+    return parts.slice(0, 3).join('.');
+}
+function createIncompatibleError(manifestVersion) {
+    const error = new Error(`Workspace compatibleCoreVersion "${manifestVersion}" is not compatible with this CLI `
+        + `(supported range: ${exports.CLI_SUPPORTED_CORE_VERSION_RANGE}). `
+        + `Please upgrade the CLI or adjust the workspace manifest.`);
+    error.structured = {
+        command: 'dx',
+        phase: 'startup',
+        metadataKind: null,
+        reason: 'incompatible-core-version',
+        detail: `manifest declares "${manifestVersion}", CLI supports "${exports.CLI_SUPPORTED_CORE_VERSION_RANGE}"`,
+    };
+    error.exitCode = 1;
+    return error;
+}
+const CORE_VERSION_TOKEN_PATTERN = /^(\^|~|>=|<=|>|<)?\d+(\.[\dxX]+){0,2}$/;
+function normalizeCoreVersionArg(raw) {
+    if (raw === undefined || raw.trim() === '') {
+        return undefined;
+    }
+    const trimmed = raw.trim();
+    const tokens = trimmed.split(/\s+/).filter(Boolean);
+    if (tokens.length === 0) {
+        throw new Error(`--core-version "${raw}" is not a valid semver range. ` +
+            'Use a version like "0.1.0" or a range like "^0.1.0", "0.1.x", ">=0.1.0 <1.0.0". ' +
+            'For Git SHA provenance use --core-sha instead.');
+    }
+    for (const token of tokens) {
+        if (token === '*' || token.toLowerCase() === 'latest') {
+            continue;
+        }
+        if (!CORE_VERSION_TOKEN_PATTERN.test(token)) {
+            throw new Error(`--core-version token "${token}" is not a valid semver range. ` +
+                'Use a version like "0.1.0" or a range like "^0.1.0", "0.1.x", ">=0.1.0 <1.0.0". ' +
+                'For Git SHA provenance use --core-sha instead.');
+        }
+    }
+    return trimmed;
+}
+const CORE_SHA_PATTERN = /^[0-9a-f]{7,40}$/i;
+function normalizeCoreShaArg(raw) {
+    if (raw === undefined || raw.trim() === '') {
+        return undefined;
+    }
+    const trimmed = raw.trim();
+    if (!CORE_SHA_PATTERN.test(trimmed)) {
+        throw new Error(`--core-sha "${raw}" is not a valid Git SHA. ` +
+            'Use a 7-40 character hex string (e.g. "94a9bda9" or the full 40-char SHA).');
+    }
+    return trimmed;
+}
+//# sourceMappingURL=core-version.js.map