@nexusclawhq/cli 0.2.1

package/dist/nexus-cli/src/services/package-self-containment.d.ts

@@ -0,0 +1,47 @@
+export interface PlatformSeedCapability {
+    id: string;
+    domain: string;
+    runtimeProvider: string;
+    legacyModuleIds?: string[];
+    inputContract: Record<string, unknown>;
+    outputContract: Record<string, unknown>;
+    stability: string;
+    notes?: string;
+}
+export interface PlatformSeedRegistry {
+    schemaVersion: string;
+    deprecationTimeline?: {
+        legacyCoreBackendRootSupport?: string;
+    };
+    capabilities: PlatformSeedCapability[];
+}
+export interface PackageSelfContainmentInventoryEntry {
+    moduleId: string;
+    modulePath: string;
+    classification: 'platform-seed' | 'package-owned' | 'unclear';
+    recommendation: string;
+    reason: string;
+}
+export interface PackageSelfContainmentResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    inventory: PackageSelfContainmentInventoryEntry[];
+}
+export declare function loadPlatformSeedRegistry(): PlatformSeedRegistry;
+export declare function validatePlatformSeedRegistry(registry: PlatformSeedRegistry): {
+    valid: boolean;
+    errors: string[];
+};
+export declare function validatePackageSelfContainment(manifest: {
+    name?: string;
+    version?: string;
+    packageClass?: string;
+    executableArtifacts?: Array<{
+        sourcePath?: string;
+        apiName?: string;
+    }>;
+}, options: {
+    packageDirectory: string;
+    strict?: boolean;
+}): PackageSelfContainmentResult;

package/dist/nexus-cli/src/services/package-self-containment.js

@@ -0,0 +1,223 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPlatformSeedRegistry = loadPlatformSeedRegistry;
+exports.validatePlatformSeedRegistry = validatePlatformSeedRegistry;
+exports.validatePackageSelfContainment = validatePackageSelfContainment;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const PLATFORM_SEED_ID_PATTERN = /^platform:[a-z0-9-]+:[a-z0-9-]+$/;
+const IMPORT_SPECIFIER_PATTERNS = [
+    /from\s+['"]([^'"]+)['"]/g,
+    /require\(\s*['"]([^'"]+)['"]\s*\)/g,
+    /import\(\s*['"]([^'"]+)['"]\s*\)/g,
+];
+function isPackageRelativePath(candidate) {
+    if (!candidate.trim() || node_path_1.default.isAbsolute(candidate)) {
+        return false;
+    }
+    const normalized = candidate.replace(/\\/g, '/');
+    if (normalized === '..' || normalized.startsWith('../') || normalized.includes('/../')) {
+        return false;
+    }
+    return true;
+}
+function resolvePlatformSeedRegistryPath() {
+    const candidates = [
+        node_path_1.default.resolve(__dirname, '../../../../backend/src/modules/installer-input/contracts/platform-seed-registry.json'),
+        node_path_1.default.resolve(process.cwd(), '../backend/src/modules/installer-input/contracts/platform-seed-registry.json'),
+        node_path_1.default.resolve(process.cwd(), 'packages/backend/src/modules/installer-input/contracts/platform-seed-registry.json'),
+    ];
+    for (const candidate of candidates) {
+        if (node_fs_1.default.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error('Unable to locate platform-seed-registry.json');
+}
+function loadPlatformSeedRegistry() {
+    const registryPath = resolvePlatformSeedRegistryPath();
+    return JSON.parse(node_fs_1.default.readFileSync(registryPath, 'utf8'));
+}
+function validatePlatformSeedRegistry(registry) {
+    const errors = [];
+    const seenIds = new Set();
+    if (registry.schemaVersion !== 'platform-seed-registry/v1') {
+        errors.push('platform-seed-registry schemaVersion must be "platform-seed-registry/v1"');
+    }
+    if (!Array.isArray(registry.capabilities) || registry.capabilities.length === 0) {
+        errors.push('platform-seed-registry must declare a non-empty capabilities array');
+    }
+    for (const capability of registry.capabilities ?? []) {
+        if (!PLATFORM_SEED_ID_PATTERN.test(capability.id)) {
+            errors.push(`Invalid platform seed capability id: ${capability.id}`);
+        }
+        if (seenIds.has(capability.id)) {
+            errors.push(`Duplicate platform seed capability id: ${capability.id}`);
+        }
+        seenIds.add(capability.id);
+        if (!capability.domain?.trim()) {
+            errors.push(`Platform seed capability ${capability.id} is missing domain`);
+        }
+        if (!capability.runtimeProvider?.trim()) {
+            errors.push(`Platform seed capability ${capability.id} is missing runtimeProvider`);
+        }
+        if (!capability.inputContract || typeof capability.inputContract !== 'object') {
+            errors.push(`Platform seed capability ${capability.id} is missing inputContract`);
+        }
+        if (!capability.outputContract || typeof capability.outputContract !== 'object') {
+            errors.push(`Platform seed capability ${capability.id} is missing outputContract`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+function readSeedModulesManifest(packageDirectory) {
+    const manifestPath = node_path_1.default.join(packageDirectory, 'seed-modules.json');
+    if (!node_fs_1.default.existsSync(manifestPath)) {
+        return null;
+    }
+    return JSON.parse(node_fs_1.default.readFileSync(manifestPath, 'utf8'));
+}
+function classifyLegacyModule(moduleEntry, registry) {
+    const capability = registry.capabilities.find((candidate) => candidate.legacyModuleIds?.includes(moduleEntry.id));
+    if (capability) {
+        return {
+            moduleId: moduleEntry.id,
+            modulePath: moduleEntry.modulePath,
+            classification: 'platform-seed',
+            recommendation: `platform-seed:${capability.id}`,
+            reason: `Legacy module ${moduleEntry.id} maps to platform capability ${capability.id}.`,
+        };
+    }
+    const packageOwnedHints = [
+        '/fixtures/',
+        '/demo-',
+        '/installer-input/',
+        'permission',
+        'report-dashboard',
+        'partner-cloud',
+        'billing',
+        'pool-engine',
+        'knowledge',
+        'crm-demo',
+        'workflow-demo',
+        'approval-demo',
+    ];
+    if (packageOwnedHints.some((hint) => moduleEntry.modulePath.includes(hint) || moduleEntry.id.includes(hint))) {
+        return {
+            moduleId: moduleEntry.id,
+            modulePath: moduleEntry.modulePath,
+            classification: 'package-owned',
+            recommendation: 'package-owned-payload',
+            reason: `Legacy module ${moduleEntry.id} carries package-specific or demo-specific content.`,
+        };
+    }
+    return {
+        moduleId: moduleEntry.id,
+        modulePath: moduleEntry.modulePath,
+        classification: 'unclear',
+        recommendation: 'manual-review',
+        reason: `Legacy module ${moduleEntry.id} needs manual ownership review before migration.`,
+    };
+}
+function extractImportSpecifiers(source) {
+    const specifiers = new Set();
+    for (const pattern of IMPORT_SPECIFIER_PATTERNS) {
+        pattern.lastIndex = 0;
+        for (const match of source.matchAll(pattern)) {
+            if (match[1]) {
+                specifiers.add(match[1]);
+            }
+        }
+    }
+    return Array.from(specifiers);
+}
+function findCoreImportViolations(packageDirectory, sourceFile) {
+    const source = node_fs_1.default.readFileSync(sourceFile, 'utf8');
+    const violations = [];
+    const specifiers = extractImportSpecifiers(source);
+    for (const specifier of specifiers) {
+        if (specifier === '@nexusclaw/backend'
+            || specifier.startsWith('@nexusclaw/backend/')
+            || specifier.includes('nexusclaw-core/packages/backend')
+            || specifier.includes('/src/modules/')
+            || specifier.includes('/src/database/seeds/')) {
+            violations.push(`imports core backend internal module "${specifier}"`);
+            continue;
+        }
+        if (specifier.startsWith('.')) {
+            const resolved = node_path_1.default.resolve(node_path_1.default.dirname(sourceFile), specifier);
+            if (!resolved.startsWith(packageDirectory)) {
+                violations.push(`imports package-external path "${specifier}"`);
+            }
+        }
+    }
+    return violations;
+}
+function validateExecutableArtifacts(packageDirectory, executableArtifacts, errors) {
+    executableArtifacts.forEach((artifact, index) => {
+        if (!artifact.sourcePath || !isPackageRelativePath(artifact.sourcePath)) {
+            return;
+        }
+        const absolutePath = node_path_1.default.resolve(packageDirectory, artifact.sourcePath);
+        if (!node_fs_1.default.existsSync(absolutePath)) {
+            return;
+        }
+        for (const violation of findCoreImportViolations(packageDirectory, absolutePath)) {
+            errors.push(`executableArtifacts[${index}] (${artifact.apiName ?? artifact.sourcePath}) ${violation}`);
+        }
+    });
+}
+function validatePayloadFiles(packageDirectory, manifest, errors) {
+    const payloadDirectory = node_path_1.default.join(packageDirectory, 'payload');
+    if (!node_fs_1.default.existsSync(payloadDirectory)) {
+        return;
+    }
+    const payloadFiles = node_fs_1.default.readdirSync(payloadDirectory)
+        .filter((entry) => /\.(json|ya?ml)$/i.test(entry))
+        .map((entry) => node_path_1.default.join(payloadDirectory, entry));
+    for (const payloadFile of payloadFiles) {
+        const source = node_fs_1.default.readFileSync(payloadFile, 'utf8');
+        if (source.includes('{{coreBackendRoot}}')) {
+            errors.push(`payload file ${node_path_1.default.basename(payloadFile)} must not reference {{coreBackendRoot}}`);
+        }
+        if (manifest.name && !source.includes(`packageName: ${manifest.name}`)) {
+            errors.push(`payload file ${node_path_1.default.basename(payloadFile)} must declare metadata.packageName: ${manifest.name}`);
+        }
+        if (manifest.version && !source.includes(`packageVersion: ${manifest.version}`)) {
+            errors.push(`payload file ${node_path_1.default.basename(payloadFile)} must declare metadata.packageVersion: ${manifest.version}`);
+        }
+    }
+}
+function validatePackageSelfContainment(manifest, options) {
+    const registry = loadPlatformSeedRegistry();
+    const registryValidation = validatePlatformSeedRegistry(registry);
+    const errors = [...registryValidation.errors];
+    const warnings = [];
+    const inventory = [];
+    const seedModulesManifest = readSeedModulesManifest(options.packageDirectory);
+    if (seedModulesManifest) {
+        const label = manifest.name ?? options.packageDirectory;
+        errors.push(`legacy seed-modules.json detected in ${label}; live packages must ship payload/ only and keep migration evidence in historical tooling or docs.`);
+        warnings.push(`Historical note: ${label} still carries seed-modules.json inventory. Remove the file from active package content and retain any migration notes outside the package root.`);
+        for (const entry of seedModulesManifest.modules ?? []) {
+            inventory.push(classifyLegacyModule(entry, registry));
+        }
+    }
+    validatePayloadFiles(options.packageDirectory, manifest, errors);
+    if (manifest.packageClass === 'code-extension') {
+        validateExecutableArtifacts(options.packageDirectory, manifest.executableArtifacts ?? [], errors);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        inventory,
+    };
+}
+//# sourceMappingURL=package-self-containment.js.map

package/dist/nexus-cli/src/services/package-self-containment.js.map

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

package/dist/nexus-cli/src/services/page-source-file.d.ts

@@ -0,0 +1,14 @@
+export { serializePageSourceFile, parsePageSourceFile, DEPLOYABLE_FIELDS, PAGE_SOURCE_MAIN_SUFFIX, PAGE_SOURCE_SCHEMA_SUFFIX, type PageSourceFileBundle, type CustomPageLike, type PageSourceFileParseResult, type ParsePageSourceFileInput, } from '../../../shared/src/source-format/page-source-file';
+import { type PageSourceFileBundle } from '../../../shared/src/source-format/page-source-file';
+export interface ScannedPageEntry {
+    main: string;
+    sidecar: string | null;
+    apiName: string;
+}
+export declare function scanPageSourceRoot(rootAbsPath: string): ScannedPageEntry[];
+export declare function writePageBundleAtomic(rootAbsPath: string, bundle: PageSourceFileBundle): void;
+export interface BundleHash {
+    localHash: string;
+    sidecarHash: string;
+}
+export declare function hashBundle(bundle: PageSourceFileBundle): BundleHash;

package/dist/nexus-cli/src/services/page-source-file.js

@@ -0,0 +1,114 @@
+"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.PAGE_SOURCE_SCHEMA_SUFFIX = exports.PAGE_SOURCE_MAIN_SUFFIX = exports.DEPLOYABLE_FIELDS = exports.parsePageSourceFile = exports.serializePageSourceFile = void 0;
+exports.scanPageSourceRoot = scanPageSourceRoot;
+exports.writePageBundleAtomic = writePageBundleAtomic;
+exports.hashBundle = hashBundle;
+const crypto = __importStar(require("node:crypto"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+var page_source_file_1 = require("../../../shared/src/source-format/page-source-file");
+Object.defineProperty(exports, "serializePageSourceFile", { enumerable: true, get: function () { return page_source_file_1.serializePageSourceFile; } });
+Object.defineProperty(exports, "parsePageSourceFile", { enumerable: true, get: function () { return page_source_file_1.parsePageSourceFile; } });
+Object.defineProperty(exports, "DEPLOYABLE_FIELDS", { enumerable: true, get: function () { return page_source_file_1.DEPLOYABLE_FIELDS; } });
+Object.defineProperty(exports, "PAGE_SOURCE_MAIN_SUFFIX", { enumerable: true, get: function () { return page_source_file_1.PAGE_SOURCE_MAIN_SUFFIX; } });
+Object.defineProperty(exports, "PAGE_SOURCE_SCHEMA_SUFFIX", { enumerable: true, get: function () { return page_source_file_1.PAGE_SOURCE_SCHEMA_SUFFIX; } });
+const page_source_file_2 = require("../../../shared/src/source-format/page-source-file");
+function scanPageSourceRoot(rootAbsPath) {
+    if (!fs.existsSync(rootAbsPath)) {
+        return [];
+    }
+    const entries = fs.readdirSync(rootAbsPath);
+    const mainFiles = entries.filter((f) => f.endsWith(page_source_file_2.PAGE_SOURCE_MAIN_SUFFIX));
+    const result = [];
+    const seen = new Map();
+    for (const mainFile of mainFiles) {
+        const apiName = mainFile.slice(0, -page_source_file_2.PAGE_SOURCE_MAIN_SUFFIX.length);
+        const mainAbsPath = path.join(rootAbsPath, mainFile);
+        if (seen.has(apiName)) {
+            const firstPath = seen.get(apiName);
+            throw new Error(`Duplicate apiName "${apiName}" detected in page source root:\n`
+                + `  - ${firstPath}\n`
+                + `  - ${mainAbsPath}`);
+        }
+        seen.set(apiName, mainAbsPath);
+        const sidecarFile = `${apiName}${page_source_file_2.PAGE_SOURCE_SCHEMA_SUFFIX}`;
+        const sidecarAbsPath = path.join(rootAbsPath, sidecarFile);
+        const sidecarExists = entries.includes(sidecarFile);
+        result.push({
+            main: mainAbsPath,
+            sidecar: sidecarExists ? sidecarAbsPath : null,
+            apiName,
+        });
+    }
+    return result;
+}
+function writePageBundleAtomic(rootAbsPath, bundle) {
+    fs.mkdirSync(rootAbsPath, { recursive: true });
+    writeFileAtomic(path.join(rootAbsPath, bundle.mainFileName), ensureTrailingLF(bundle.mainContent));
+    writeFileAtomic(path.join(rootAbsPath, bundle.schemaFileName), ensureTrailingLF(bundle.schemaContent));
+}
+function writeFileAtomic(targetPath, content) {
+    const dir = path.dirname(targetPath);
+    const tmpPath = path.join(dir, `.tmp-${path.basename(targetPath)}-${process.pid}-${Date.now()}`);
+    try {
+        fs.writeFileSync(tmpPath, content, 'utf-8');
+        fs.renameSync(tmpPath, targetPath);
+    }
+    catch (err) {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { }
+        throw err;
+    }
+}
+function ensureTrailingLF(content) {
+    if (content.length === 0 || content[content.length - 1] !== '\n') {
+        return content + '\n';
+    }
+    return content;
+}
+function hashBundle(bundle) {
+    return {
+        localHash: sha256(bundle.mainContent),
+        sidecarHash: sha256(bundle.schemaContent),
+    };
+}
+function sha256(content) {
+    return `sha256:${crypto.createHash('sha256').update(content, 'utf-8').digest('hex')}`;
+}
+//# sourceMappingURL=page-source-file.js.map

package/dist/nexus-cli/src/services/page-source-file.js.map

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

package/dist/nexus-cli/src/services/page-source-file.test.d.ts

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

package/dist/nexus-cli/src/services/page-source-file.test.js

@@ -0,0 +1,154 @@
+"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_crypto_1 = __importDefault(require("node:crypto"));
+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"));
+const page_source_file_1 = require("./page-source-file");
+function withTempDir(run) {
+    const tempDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'nexus-page-source-'));
+    try {
+        run(tempDir);
+    }
+    finally {
+        node_fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+    }
+}
+(0, node_test_1.default)('scanPageSourceRoot returns empty array for non-existent directory', () => {
+    const result = (0, page_source_file_1.scanPageSourceRoot)('/tmp/does-not-exist-' + Date.now());
+    strict_1.default.deepEqual(result, []);
+});
+(0, node_test_1.default)('scanPageSourceRoot finds valid page files with sidecars', () => {
+    withTempDir((dir) => {
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'dashboard.page.json'), '{}');
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'dashboard.page.schema.json'), '{}');
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'lead_detail.page.json'), '{}');
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'lead_detail.page.schema.json'), '{}');
+        const result = (0, page_source_file_1.scanPageSourceRoot)(dir);
+        strict_1.default.equal(result.length, 2);
+        const dashboard = result.find((e) => e.apiName === 'dashboard');
+        strict_1.default.ok(dashboard);
+        strict_1.default.equal(dashboard.main, node_path_1.default.join(dir, 'dashboard.page.json'));
+        strict_1.default.equal(dashboard.sidecar, node_path_1.default.join(dir, 'dashboard.page.schema.json'));
+        const lead = result.find((e) => e.apiName === 'lead_detail');
+        strict_1.default.ok(lead);
+        strict_1.default.equal(lead.main, node_path_1.default.join(dir, 'lead_detail.page.json'));
+        strict_1.default.equal(lead.sidecar, node_path_1.default.join(dir, 'lead_detail.page.schema.json'));
+    });
+});
+(0, node_test_1.default)('scanPageSourceRoot returns sidecar as null when missing', () => {
+    withTempDir((dir) => {
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'orphan_page.page.json'), '{}');
+        const result = (0, page_source_file_1.scanPageSourceRoot)(dir);
+        strict_1.default.equal(result.length, 1);
+        strict_1.default.equal(result[0].apiName, 'orphan_page');
+        strict_1.default.equal(result[0].main, node_path_1.default.join(dir, 'orphan_page.page.json'));
+        strict_1.default.equal(result[0].sidecar, null);
+    });
+});
+(0, node_test_1.default)('scanPageSourceRoot throws on duplicate apiName', () => {
+    withTempDir((dir) => {
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'my_page.page.json'), '{}');
+        const result = (0, page_source_file_1.scanPageSourceRoot)(dir);
+        strict_1.default.equal(result.length, 1);
+        strict_1.default.equal(result[0].apiName, 'my_page');
+    });
+});
+(0, node_test_1.default)('scanPageSourceRoot ignores non-page.json files', () => {
+    withTempDir((dir) => {
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'dashboard.page.json'), '{}');
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'dashboard.page.schema.json'), '{}');
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'readme.md'), '# Pages');
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'config.json'), '{}');
+        node_fs_1.default.writeFileSync(node_path_1.default.join(dir, '.gitkeep'), '');
+        const result = (0, page_source_file_1.scanPageSourceRoot)(dir);
+        strict_1.default.equal(result.length, 1);
+        strict_1.default.equal(result[0].apiName, 'dashboard');
+    });
+});
+(0, node_test_1.default)('writePageBundleAtomic creates files with correct content', () => {
+    withTempDir((dir) => {
+        const bundle = {
+            mainFileName: 'test_page.page.json',
+            mainContent: '{\n  "apiName": "test_page"\n}\n',
+            schemaFileName: 'test_page.page.schema.json',
+            schemaContent: '{\n  "fields": []\n}\n',
+        };
+        (0, page_source_file_1.writePageBundleAtomic)(dir, bundle);
+        const mainContent = node_fs_1.default.readFileSync(node_path_1.default.join(dir, 'test_page.page.json'), 'utf-8');
+        const schemaContent = node_fs_1.default.readFileSync(node_path_1.default.join(dir, 'test_page.page.schema.json'), 'utf-8');
+        strict_1.default.equal(mainContent, bundle.mainContent);
+        strict_1.default.equal(schemaContent, bundle.schemaContent);
+    });
+});
+(0, node_test_1.default)('writePageBundleAtomic ensures trailing LF', () => {
+    withTempDir((dir) => {
+        const bundle = {
+            mainFileName: 'no_lf.page.json',
+            mainContent: '{"apiName": "no_lf"}',
+            schemaFileName: 'no_lf.page.schema.json',
+            schemaContent: '{}',
+        };
+        (0, page_source_file_1.writePageBundleAtomic)(dir, bundle);
+        const mainContent = node_fs_1.default.readFileSync(node_path_1.default.join(dir, 'no_lf.page.json'), 'utf-8');
+        const schemaContent = node_fs_1.default.readFileSync(node_path_1.default.join(dir, 'no_lf.page.schema.json'), 'utf-8');
+        strict_1.default.ok(mainContent.endsWith('\n'), 'main file should end with LF');
+        strict_1.default.ok(schemaContent.endsWith('\n'), 'schema file should end with LF');
+    });
+});
+(0, node_test_1.default)('writePageBundleAtomic creates directory if not exists', () => {
+    withTempDir((dir) => {
+        const nestedDir = node_path_1.default.join(dir, 'nested', 'pages');
+        const bundle = {
+            mainFileName: 'deep.page.json',
+            mainContent: '{"apiName": "deep"}\n',
+            schemaFileName: 'deep.page.schema.json',
+            schemaContent: '{}\n',
+        };
+        (0, page_source_file_1.writePageBundleAtomic)(nestedDir, bundle);
+        strict_1.default.ok(node_fs_1.default.existsSync(node_path_1.default.join(nestedDir, 'deep.page.json')));
+        strict_1.default.ok(node_fs_1.default.existsSync(node_path_1.default.join(nestedDir, 'deep.page.schema.json')));
+    });
+});
+(0, node_test_1.default)('hashBundle produces deterministic sha256 hashes', () => {
+    const bundle = {
+        mainFileName: 'test.page.json',
+        mainContent: '{\n  "apiName": "test"\n}\n',
+        schemaFileName: 'test.page.schema.json',
+        schemaContent: '{\n  "fields": []\n}\n',
+    };
+    const hash1 = (0, page_source_file_1.hashBundle)(bundle);
+    const hash2 = (0, page_source_file_1.hashBundle)(bundle);
+    strict_1.default.equal(hash1.localHash, hash2.localHash);
+    strict_1.default.equal(hash1.sidecarHash, hash2.sidecarHash);
+    strict_1.default.ok(hash1.localHash.startsWith('sha256:'));
+    strict_1.default.ok(hash1.sidecarHash.startsWith('sha256:'));
+    const expectedMain = 'sha256:' + node_crypto_1.default.createHash('sha256').update(bundle.mainContent, 'utf-8').digest('hex');
+    const expectedSchema = 'sha256:' + node_crypto_1.default.createHash('sha256').update(bundle.schemaContent, 'utf-8').digest('hex');
+    strict_1.default.equal(hash1.localHash, expectedMain);
+    strict_1.default.equal(hash1.sidecarHash, expectedSchema);
+});
+(0, node_test_1.default)('hashBundle produces different hashes for different content', () => {
+    const bundle1 = {
+        mainFileName: 'a.page.json',
+        mainContent: '{"apiName": "a"}\n',
+        schemaFileName: 'a.page.schema.json',
+        schemaContent: '{"x": 1}\n',
+    };
+    const bundle2 = {
+        mainFileName: 'b.page.json',
+        mainContent: '{"apiName": "b"}\n',
+        schemaFileName: 'b.page.schema.json',
+        schemaContent: '{"x": 2}\n',
+    };
+    const hash1 = (0, page_source_file_1.hashBundle)(bundle1);
+    const hash2 = (0, page_source_file_1.hashBundle)(bundle2);
+    strict_1.default.notEqual(hash1.localHash, hash2.localHash);
+    strict_1.default.notEqual(hash1.sidecarHash, hash2.sidecarHash);
+});
+//# sourceMappingURL=page-source-file.test.js.map

package/dist/nexus-cli/src/services/page-source-file.test.js.map

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

package/dist/nexus-cli/src/services/revision-ledger/baseline-service.d.ts

@@ -0,0 +1,8 @@
+import { LedgerStorage } from './ledger-storage';
+import { type BaselineRecord } from './types';
+export declare class BaselineService {
+    private readonly storage;
+    constructor(storage: LedgerStorage);
+    setBaseline(environment: string, revisionId?: string, setBy?: string): Promise<BaselineRecord>;
+    getBaseline(environment: string): Promise<BaselineRecord | null>;
+}