@git.zone/cli 3.2.1 → 5.0.0

package/dist_ts_migration/002.runtime-config.js

@@ -0,0 +1,170 @@
+import * as plugins from '../dist_ts/plugins.js';
+import { deriveS3BucketName, isValidS3BucketName, } from '../dist_ts/mod_services/classes.serviceconfiguration.js';
+import { withInterProcessLock } from '../dist_ts/mod_services/classes.interprocesslock.js';
+const isPlainObject = (valueArg) => typeof valueArg === 'object' && valueArg !== null && !Array.isArray(valueArg);
+const stringFields = [
+    'PROJECT_NAME',
+    'MONGODB_HOST',
+    'MONGODB_NAME',
+    'MONGODB_PORT',
+    'MONGODB_USER',
+    'MONGODB_PASS',
+    'MONGODB_URL',
+    'S3_HOST',
+    'S3_PORT',
+    'S3_UI_PORT',
+    'S3_CONSOLE_PORT',
+    'S3_ACCESSKEY',
+    'S3_SECRETKEY',
+    'S3_ADMIN_PASSWORD',
+    'S3_REGION',
+    'S3_BUCKET',
+    'S3_ENDPOINT',
+    'ELASTICSEARCH_HOST',
+    'ELASTICSEARCH_PORT',
+    'ELASTICSEARCH_USER',
+    'ELASTICSEARCH_PASS',
+    'ELASTICSEARCH_URL',
+];
+const booleanFields = ['MONGODB_AUTH_ENABLED', 'S3_USESSL'];
+const portFields = [
+    'MONGODB_PORT',
+    'S3_PORT',
+    'S3_UI_PORT',
+    'S3_CONSOLE_PORT',
+    'ELASTICSEARCH_PORT',
+];
+const assertValidPort = (nameArg, valueArg) => {
+    if (typeof valueArg !== 'string' || !/^\d{1,5}$/u.test(valueArg)) {
+        throw new Error(`Cannot migrate .nogit/env.json: ${nameArg} must be a decimal port string.`);
+    }
+    const port = Number(valueArg);
+    if (!Number.isSafeInteger(port) || port < 1 || port > 65_535) {
+        throw new Error(`Cannot migrate .nogit/env.json: ${nameArg} is outside the TCP port range.`);
+    }
+};
+/** Validate every known persisted field before a migration is allowed to write. */
+export const assertServiceRuntimeConfigMigrationInput = (configArg) => {
+    if (!isPlainObject(configArg)) {
+        throw new Error('Cannot migrate .nogit/env.json: root must be a JSON object.');
+    }
+    for (const field of stringFields) {
+        if (Object.hasOwn(configArg, field) &&
+            (typeof configArg[field] !== 'string' || !configArg[field].trim())) {
+            throw new Error(`Cannot migrate .nogit/env.json: ${field} must be a non-empty string.`);
+        }
+    }
+    for (const field of booleanFields) {
+        if (Object.hasOwn(configArg, field) && typeof configArg[field] !== 'boolean') {
+            throw new Error(`Cannot migrate .nogit/env.json: ${field} must be a boolean.`);
+        }
+    }
+    for (const field of portFields) {
+        if (Object.hasOwn(configArg, field)) {
+            assertValidPort(field, configArg[field]);
+        }
+    }
+    const s3Port = configArg.S3_PORT;
+    const uiPort = configArg.S3_UI_PORT ?? configArg.S3_CONSOLE_PORT;
+    if (s3Port !== undefined && uiPort !== undefined && s3Port === uiPort) {
+        throw new Error('Cannot migrate .nogit/env.json: S3 API and UI ports must differ.');
+    }
+    return configArg;
+};
+/** Repair only the exact invalid bucket value generated by older GitZone releases. */
+export const repairLegacyGeneratedS3Bucket = (projectNameArg, bucketArg) => {
+    const legacyGeneratedBucket = `${projectNameArg}-documents`;
+    if (bucketArg !== legacyGeneratedBucket || isValidS3BucketName(bucketArg)) {
+        return { bucket: bucketArg, repaired: false };
+    }
+    return { bucket: deriveS3BucketName(projectNameArg), repaired: true };
+};
+/** Convert only shipped ObjectStorage predecessor fields and generated values. */
+export const migrateLegacyServiceRuntimeConfigValue = (configArg) => {
+    const source = assertServiceRuntimeConfigMigrationInput(configArg);
+    const config = { ...source };
+    let migrated = false;
+    if (Object.hasOwn(config, 'S3_CONSOLE_PORT')) {
+        const legacyPort = config.S3_CONSOLE_PORT;
+        if (Object.hasOwn(config, 'S3_UI_PORT') && config.S3_UI_PORT !== legacyPort) {
+            throw new Error('Cannot migrate .nogit/env.json: S3_CONSOLE_PORT and S3_UI_PORT contain different values. ' +
+                'Choose the intended management UI port explicitly, keep it as S3_UI_PORT, and remove S3_CONSOLE_PORT.');
+        }
+        config.S3_UI_PORT = legacyPort;
+        delete config.S3_CONSOLE_PORT;
+        migrated = true;
+    }
+    if (!Object.hasOwn(config, 'S3_ADMIN_PASSWORD')) {
+        config.S3_ADMIN_PASSWORD = plugins.crypto.randomBytes(24).toString('base64url');
+        migrated = true;
+    }
+    if (!Object.hasOwn(config, 'S3_REGION')) {
+        config.S3_REGION = 'us-east-1';
+        migrated = true;
+    }
+    if (typeof config.PROJECT_NAME === 'string' && typeof config.S3_BUCKET === 'string') {
+        const repair = repairLegacyGeneratedS3Bucket(config.PROJECT_NAME, config.S3_BUCKET);
+        if (repair.repaired) {
+            config.S3_BUCKET = repair.bucket;
+            migrated = true;
+        }
+    }
+    assertServiceRuntimeConfigMigrationInput(config);
+    return { config, migrated };
+};
+const readRuntimeConfig = async (projectPathArg) => {
+    const configPath = plugins.path.join(projectPathArg, '.nogit', 'env.json');
+    if (!(await plugins.smartfs.file(configPath).exists())) {
+        return undefined;
+    }
+    const content = (await plugins.smartfs.file(configPath).encoding('utf8').read());
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        throw new Error('Cannot migrate .nogit/env.json: file contains invalid JSON.');
+    }
+};
+const writeRuntimeConfigAtomic = async (projectPathArg, configArg) => {
+    const configPath = plugins.path.join(projectPathArg, '.nogit', 'env.json');
+    const tempPath = `${configPath}.tmp-${process.pid}-${plugins.crypto
+        .randomBytes(12)
+        .toString('hex')}`;
+    try {
+        await plugins.fs.writeFile(tempPath, `${JSON.stringify(configArg, null, 2)}\n`, {
+            encoding: 'utf8',
+            flag: 'wx',
+            mode: 0o600,
+        });
+        await plugins.fs.rename(tempPath, configPath);
+    }
+    catch (error) {
+        await plugins.fs.rm(tempPath, { force: true }).catch(() => { });
+        throw new Error('Cannot migrate .nogit/env.json atomically.', { cause: error });
+    }
+};
+export const preflightServiceRuntimeConfigMigration = async (projectPathArg) => {
+    const parsed = await readRuntimeConfig(projectPathArg);
+    if (parsed !== undefined) {
+        migrateLegacyServiceRuntimeConfigValue(parsed);
+    }
+};
+export const runServiceRuntimeConfigMigration = async (projectPathArg) => {
+    await preflightServiceRuntimeConfigMigration(projectPathArg);
+    const configPath = plugins.path.join(projectPathArg, '.nogit', 'env.json');
+    return withInterProcessLock({
+        lockPath: `${configPath}.lock`,
+        description: 'Service runtime configuration',
+    }, async () => {
+        const parsed = await readRuntimeConfig(projectPathArg);
+        if (parsed === undefined) {
+            return false;
+        }
+        const migration = migrateLegacyServiceRuntimeConfigValue(parsed);
+        if (migration.migrated) {
+            await writeRuntimeConfigAtomic(projectPathArg, migration.config);
+        }
+        return migration.migrated;
+    });
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDAyLnJ1bnRpbWUtY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHNfbWlncmF0aW9uLzAwMi5ydW50aW1lLWNvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBQzVDLE9BQU8sRUFDTCxrQkFBa0IsRUFDbEIsbUJBQW1CLEdBQ3BCLE1BQU0sb0RBQW9ELENBQUM7QUFDNUQsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sZ0RBQWdELENBQUM7QUFFdEYsTUFBTSxhQUFhLEdBQUcsQ0FBQyxRQUFpQixFQUF1QyxFQUFFLENBQy9FLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxRQUFRLEtBQUssSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FBQztBQUVoRixNQUFNLFlBQVksR0FBRztJQUNuQixjQUFjO0lBQ2QsY0FBYztJQUNkLGNBQWM7SUFDZCxjQUFjO0lBQ2QsY0FBYztJQUNkLGNBQWM7SUFDZCxhQUFhO0lBQ2IsU0FBUztJQUNULFNBQVM7SUFDVCxZQUFZO0lBQ1osaUJBQWlCO0lBQ2pCLGNBQWM7SUFDZCxjQUFjO0lBQ2QsbUJBQW1CO0lBQ25CLFdBQVc7SUFDWCxXQUFXO0lBQ1gsYUFBYTtJQUNiLG9CQUFvQjtJQUNwQixvQkFBb0I7SUFDcEIsb0JBQW9CO0lBQ3BCLG9CQUFvQjtJQUNwQixtQkFBbUI7Q0FDWCxDQUFDO0FBRVgsTUFBTSxhQUFhLEdBQUcsQ0FBQyxzQkFBc0IsRUFBRSxXQUFXLENBQVUsQ0FBQztBQUNyRSxNQUFNLFVBQVUsR0FBRztJQUNqQixjQUFjO0lBQ2QsU0FBUztJQUNULFlBQVk7SUFDWixpQkFBaUI7SUFDakIsb0JBQW9CO0NBQ1osQ0FBQztBQUVYLE1BQU0sZUFBZSxHQUFHLENBQUMsT0FBZSxFQUFFLFFBQWlCLEVBQVEsRUFBRTtJQUNuRSxJQUFJLE9BQU8sUUFBUSxLQUFL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

package/dist_ts_migration/003.service-data-marker.d.ts

@@ -0,0 +1,9 @@
+import { type IServiceDataMarker } from '../dist_ts/mod_services/classes.servicedatamarker.js';
+export interface IServiceDataMarkerMigrationResult {
+    marker?: IServiceDataMarker;
+    migrated: boolean;
+}
+/** Convert the exact shipped v1 marker without reinterpreting legacy storage data. */
+export declare const migrateServiceDataMarkerValue: (markerArg: unknown, projectPathArg: string) => IServiceDataMarkerMigrationResult;
+export declare const preflightServiceDataMarkerMigration: (projectPathArg: string) => Promise<IServiceDataMarker | undefined>;
+export declare const runServiceDataMarkerMigration: (projectPathArg: string) => Promise<IServiceDataMarker | undefined>;

package/dist_ts_migration/003.service-data-marker.js

@@ -0,0 +1,156 @@
+import * as plugins from '../dist_ts/plugins.js';
+import { getLegacyMinioDataDirectory, getServiceDataDirectory, getServiceDataMarkerLockPath, getServiceDataMarkerPath, isValidServiceDataMarker, serviceDataMarkerSchemaVersion, serviceDataOwner, } from '../dist_ts/mod_services/classes.servicedatamarker.js';
+import { withInterProcessLock } from '../dist_ts/mod_services/classes.interprocesslock.js';
+const isPlainObject = (valueArg) => typeof valueArg === 'object' && valueArg !== null && !Array.isArray(valueArg);
+const hasOnlyKeys = (valueArg, allowedKeysArg) => Object.keys(valueArg).every((keyArg) => allowedKeysArg.includes(keyArg));
+const isValidServiceDataMarkerV1 = (markerArg) => {
+    if (!isPlainObject(markerArg) ||
+        !hasOnlyKeys(markerArg, [
+            'owner',
+            'kind',
+            'schemaVersion',
+            'projectPath',
+            'safeToPrune',
+            'createdAt',
+            'dataDirectories',
+        ]) ||
+        markerArg.owner !== serviceDataOwner ||
+        markerArg.kind !== 'service-data' ||
+        markerArg.schemaVersion !== 1 ||
+        markerArg.safeToPrune !== true ||
+        typeof markerArg.projectPath !== 'string' ||
+        !markerArg.projectPath ||
+        typeof markerArg.createdAt !== 'string' ||
+        !markerArg.createdAt ||
+        !Array.isArray(markerArg.dataDirectories)) {
+        return false;
+    }
+    const projectPath = plugins.path.resolve(markerArg.projectPath);
+    const seenServices = new Set();
+    for (const entry of markerArg.dataDirectories) {
+        const service = isPlainObject(entry) ? entry.service : undefined;
+        if (!isPlainObject(entry) ||
+            !hasOnlyKeys(entry, ['service', 'path']) ||
+            typeof service !== 'string' ||
+            !['mongodb', 'minio', 'elasticsearch'].includes(service) ||
+            seenServices.has(service) ||
+            typeof entry.path !== 'string') {
+            return false;
+        }
+        const expectedPath = service === 'minio'
+            ? getLegacyMinioDataDirectory(projectPath)
+            : getServiceDataDirectory(projectPath, service);
+        if (plugins.path.resolve(entry.path) !== expectedPath) {
+            return false;
+        }
+        seenServices.add(service);
+    }
+    return true;
+};
+/** Convert the exact shipped v1 marker without reinterpreting legacy storage data. */
+export const migrateServiceDataMarkerValue = (markerArg, projectPathArg) => {
+    const projectPath = plugins.path.resolve(projectPathArg);
+    if (isValidServiceDataMarker(markerArg)) {
+        return {
+            marker: plugins.path.resolve(markerArg.projectPath) === projectPath ? markerArg : undefined,
+            migrated: false,
+        };
+    }
+    if (!isValidServiceDataMarkerV1(markerArg) ||
+        plugins.path.resolve(markerArg.projectPath) !== projectPath) {
+        return { migrated: false };
+    }
+    const dataDirectories = markerArg.dataDirectories
+        .filter((entry) => entry.service !== 'minio')
+        .map((entry) => ({
+        service: entry.service,
+        path: plugins.path.resolve(entry.path),
+    }))
+        .sort((entryA, entryB) => entryA.service.localeCompare(entryB.service));
+    const legacyEntry = markerArg.dataDirectories.find((entry) => entry.service === 'minio');
+    const marker = {
+        owner: serviceDataOwner,
+        kind: 'service-data',
+        schemaVersion: serviceDataMarkerSchemaVersion,
+        projectPath,
+        safeToPrune: true,
+        createdAt: markerArg.createdAt,
+        dataDirectories,
+        ...(legacyEntry
+            ? {
+                legacyDataDirectories: [
+                    {
+                        service: 'minio',
+                        path: plugins.path.resolve(legacyEntry.path),
+                        safeToPrune: false,
+                    },
+                ],
+            }
+            : {}),
+    };
+    return { marker, migrated: true };
+};
+const readServiceDataMarkerMigrationInput = async (projectPathArg) => {
+    const markerPath = getServiceDataMarkerPath(projectPathArg);
+    if (!(await plugins.smartfs.file(markerPath).exists())) {
+        return undefined;
+    }
+    let parsed;
+    try {
+        const content = (await plugins.smartfs.file(markerPath).encoding('utf8').read());
+        parsed = JSON.parse(content);
+    }
+    catch {
+        throw new Error(`Cannot migrate invalid service data marker: ${markerPath}`);
+    }
+    return parsed;
+};
+export const preflightServiceDataMarkerMigration = async (projectPathArg) => {
+    const markerPath = getServiceDataMarkerPath(projectPathArg);
+    const parsed = await readServiceDataMarkerMigrationInput(projectPathArg);
+    if (parsed === undefined) {
+        return undefined;
+    }
+    const result = migrateServiceDataMarkerValue(parsed, projectPathArg);
+    if (!result.marker) {
+        throw new Error(`Cannot migrate invalid or foreign service data marker: ${markerPath}`);
+    }
+    return result.marker;
+};
+export const runServiceDataMarkerMigration = async (projectPathArg) => {
+    await preflightServiceDataMarkerMigration(projectPathArg);
+    const markerPath = getServiceDataMarkerPath(projectPathArg);
+    return withInterProcessLock({
+        lockPath: getServiceDataMarkerLockPath(projectPathArg),
+        description: 'Service data marker',
+    }, async () => {
+        const parsed = await readServiceDataMarkerMigrationInput(projectPathArg);
+        if (parsed === undefined) {
+            return undefined;
+        }
+        const result = migrateServiceDataMarkerValue(parsed, projectPathArg);
+        if (!result.marker) {
+            throw new Error(`Cannot migrate invalid or foreign service data marker: ${markerPath}`);
+        }
+        if (result.migrated) {
+            const tempPath = `${markerPath}.tmp-${process.pid}-${plugins.crypto
+                .randomBytes(12)
+                .toString('hex')}`;
+            try {
+                await plugins.fs.writeFile(tempPath, `${JSON.stringify(result.marker, null, 2)}\n`, {
+                    encoding: 'utf8',
+                    flag: 'wx',
+                });
+                await plugins.fs.rename(tempPath, markerPath);
+            }
+            catch (error) {
+                await plugins.fs.rm(tempPath, { force: true }).catch(() => { });
+                throw new Error(`Cannot migrate service data marker atomically: ${markerPath}`, {
+                    cause: error,
+                });
+            }
+        }
+        return result.marker;
+    });
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDAzLnNlcnZpY2UtZGF0YS1tYXJrZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19taWdyYXRpb24vMDAzLnNlcnZpY2UtZGF0YS1tYXJrZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxrQkFBa0IsQ0FBQztBQUM1QyxPQUFPLEVBQ0wsMkJBQTJCLEVBQzNCLHVCQUF1QixFQUN2Qiw0QkFBNEIsRUFDNUIsd0JBQXdCLEVBQ3hCLHdCQUF3QixFQUN4Qiw4QkFBOEIsRUFDOUIsZ0JBQWdCLEdBS2pCLE1BQU0saURBQWlELENBQUM7QUFDekQsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sZ0RBQWdELENBQUM7QUFldEYsTUFBTSxhQUFhLEdBQUcsQ0FBQyxRQUFpQixFQUF1QyxFQUFFLENBQy9FLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxRQUFRLEtBQUssSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FBQztBQUVoRixNQUFNLFdBQVcsR0FBRyxDQUNsQixRQUFpQyxFQUNqQyxjQUFpQyxFQUN4QixFQUFFLENBQ1gsTUFBTSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLGNBQWMsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQztBQUUzRSxNQUFNLDBCQUEwQixHQUFHLENBQUMsU0FBa0IsRUFBcUMsRUFBRTtJQUMzRixJQUNFLENBQUMsYUFBYSxDQUFDLFNBQVMsQ0FBQztRQUN6QixDQUFDLFdBQVcsQ0FBQyxTQUFTLEVBQUU7WUFDdEIsT0FBTztZQUNQLE1BQU07WUFDTixlQUFlO1lBQ2YsYUFBYTtZQUNiLGFBQWE7WUFDYixXQUFXO1lBQ1gsaUJBQWlCO1NBQ2xCLENBQUM7UUFDRixTQUFTLENBQUMsS0FBSyxLQUFLLGdCQUFnQjtRQUNwQyxTQUFTLENB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

package/dist_ts_migration/004.global-registry.d.ts

@@ -0,0 +1,13 @@
+import { type IGlobalRegistryTransactionResult, type IGlobalRegistryData } from '../dist_ts/mod_services/classes.globalregistrystore.js';
+export interface IGlobalRegistryMigrationResult {
+    data: IGlobalRegistryData;
+    migrated: boolean;
+}
+export interface IGlobalRegistryMigrationStore {
+    readRaw(): Promise<unknown>;
+    transact<T>(operationArg: (rawDataArg: unknown) => Promise<IGlobalRegistryTransactionResult<T>> | IGlobalRegistryTransactionResult<T>): Promise<T>;
+}
+/** Convert the exact legacy registry fields without activating old provider resources. */
+export declare const migrateLegacyGlobalRegistryData: (dataArg: unknown) => IGlobalRegistryMigrationResult;
+export declare const preflightGlobalRegistryMigration: (storeArg?: IGlobalRegistryMigrationStore) => Promise<IGlobalRegistryData>;
+export declare const runGlobalRegistryMigration: (storeArg?: IGlobalRegistryMigrationStore) => Promise<IGlobalRegistryData>;

package/dist_ts_migration/004.global-registry.js

@@ -0,0 +1,165 @@
+import * as plugins from '../dist_ts/plugins.js';
+import { migratePersistedServiceNamesValue } from './001.service-selection.js';
+import { GlobalRegistryStore, } from '../dist_ts/mod_services/classes.globalregistrystore.js';
+const isPlainObject = (valueArg) => typeof valueArg === 'object' && valueArg !== null && !Array.isArray(valueArg);
+const assertAllowedKeys = (valueArg, allowedKeysArg, contextArg) => {
+    if (Object.keys(valueArg).some((keyArg) => !allowedKeysArg.includes(keyArg))) {
+        throw new Error(`Cannot migrate global services registry: ${contextArg} contains unsupported fields.`);
+    }
+};
+const assertOptionalStrings = (valueArg, keysArg, contextArg) => {
+    for (const key of keysArg) {
+        if (valueArg[key] !== undefined && (typeof valueArg[key] !== 'string' || !valueArg[key])) {
+            throw new Error(`Cannot migrate global services registry: ${contextArg}.${key} must be a non-empty string.`);
+        }
+    }
+};
+const assertOptionalNumbers = (valueArg, keysArg, contextArg) => {
+    for (const key of keysArg) {
+        if (valueArg[key] !== undefined && !Number.isFinite(valueArg[key])) {
+            throw new Error(`Cannot migrate global services registry: ${contextArg}.${key} must be a finite number.`);
+        }
+    }
+};
+/** Convert the exact legacy registry fields without activating old provider resources. */
+export const migrateLegacyGlobalRegistryData = (dataArg) => {
+    if (!isPlainObject(dataArg)) {
+        throw new Error('Cannot migrate global services registry: root must be a JSON object.');
+    }
+    const source = dataArg;
+    assertAllowedKeys(source, ['schemaVersion', 'projects'], 'root');
+    if (source.schemaVersion !== undefined && source.schemaVersion !== 2) {
+        throw new Error('Cannot migrate global services registry: unsupported schema version.');
+    }
+    if (source.projects === undefined) {
+        if (source.schemaVersion === 2) {
+            throw new Error('Cannot migrate global services registry: projects map is missing.');
+        }
+        return {
+            data: { schemaVersion: 2, projects: {} },
+            migrated: true,
+        };
+    }
+    if (!isPlainObject(source.projects)) {
+        throw new Error('Cannot migrate global services registry: projects must be a JSON object.');
+    }
+    let migrated = source.schemaVersion !== 2;
+    const projects = {};
+    for (const [projectPath, rawProject] of Object.entries(source.projects)) {
+        if (!isPlainObject(rawProject)) {
+            throw new Error(`Cannot migrate global services registry for ${projectPath}: project must be a JSON object.`);
+        }
+        assertAllowedKeys(rawProject, [
+            'projectPath',
+            'projectName',
+            'containers',
+            'ports',
+            'legacy',
+            'enabledServices',
+            'lastActive',
+        ], `project ${projectPath}`);
+        if (typeof rawProject.projectPath !== 'string' ||
+            !rawProject.projectPath ||
+            plugins.path.resolve(rawProject.projectPath) !== plugins.path.resolve(projectPath)) {
+            throw new Error(`Cannot migrate global services registry for ${projectPath}: project path is invalid or inconsistent.`);
+        }
+        if (typeof rawProject.projectName !== 'string' || !rawProject.projectName) {
+            throw new Error(`Cannot migrate global services registry for ${projectPath}: project name is invalid.`);
+        }
+        if (!isPlainObject(rawProject.containers) || !isPlainObject(rawProject.ports)) {
+            throw new Error(`Cannot migrate global services registry for ${projectPath}: containers and ports must be JSON objects.`);
+        }
+        if (!Array.isArray(rawProject.enabledServices)) {
+            throw new Error(`Cannot migrate global services registry for ${projectPath}: enabledServices must be an array.`);
+        }
+        if (typeof rawProject.lastActive !== 'number' ||
+            !Number.isFinite(rawProject.lastActive)) {
+            throw new Error(`Cannot migrate global services registry for ${projectPath}: lastActive must be a finite number.`);
+        }
+        const rawContainers = rawProject.containers;
+        const rawPorts = rawProject.ports;
+        assertAllowedKeys(rawContainers, ['mongo', 'minio', 'objectstorage', 'elasticsearch'], `project ${projectPath} containers`);
+        assertOptionalStrings(rawContainers, ['mongo', 'minio', 'objectstorage', 'elasticsearch'], `project ${projectPath}.containers`);
+        assertAllowedKeys(rawPorts, ['mongo', 's3', 's3Console', 's3Ui', 'elasticsearch'], `project ${projectPath} ports`);
+        assertOptionalNumbers(rawPorts, ['mongo', 's3', 's3Console', 's3Ui', 'elasticsearch'], `project ${projectPath}.ports`);
+        let rawLegacy = {};
+        if (rawProject.legacy !== undefined) {
+            if (!isPlainObject(rawProject.legacy)) {
+                throw new Error(`Cannot migrate global services registry for ${projectPath}: legacy must be a JSON object.`);
+            }
+            rawLegacy = rawProject.legacy;
+            assertAllowedKeys(rawLegacy, ['minioContainer'], `project ${projectPath} legacy`);
+            assertOptionalStrings(rawLegacy, ['minioContainer'], `project ${projectPath}.legacy`);
+            if (!rawLegacy.minioContainer) {
+                throw new Error(`Cannot migrate global services registry for ${projectPath}: empty legacy evidence is invalid.`);
+            }
+        }
+        if (rawLegacy.minioContainer !== undefined &&
+            rawContainers.minio !== undefined &&
+            rawLegacy.minioContainer !== rawContainers.minio) {
+            throw new Error(`Cannot migrate global services registry for ${projectPath}: legacy MinIO references differ.`);
+        }
+        const minioContainer = typeof rawLegacy.minioContainer === 'string'
+            ? rawLegacy.minioContainer
+            : typeof rawContainers.minio === 'string'
+                ? rawContainers.minio
+                : undefined;
+        if (typeof rawContainers.minio === 'string') {
+            migrated = true;
+        }
+        if (rawPorts.s3Ui !== undefined &&
+            rawPorts.s3Console !== undefined &&
+            rawPorts.s3Ui !== rawPorts.s3Console) {
+            throw new Error(`Cannot migrate global services registry for ${projectPath}: s3Ui and s3Console differ.`);
+        }
+        if (rawPorts.s3Console !== undefined) {
+            migrated = true;
+        }
+        const s3UiPort = rawPorts.s3Ui ?? rawPorts.s3Console;
+        const serviceMigration = migratePersistedServiceNamesValue(rawProject.enabledServices);
+        migrated ||= serviceMigration.migrated;
+        projects[projectPath] = {
+            projectPath: rawProject.projectPath,
+            projectName: rawProject.projectName,
+            containers: {
+                ...(typeof rawContainers.mongo === 'string' ? { mongo: rawContainers.mongo } : {}),
+                ...(typeof rawContainers.objectstorage === 'string'
+                    ? { objectstorage: rawContainers.objectstorage }
+                    : {}),
+                ...(typeof rawContainers.elasticsearch === 'string'
+                    ? { elasticsearch: rawContainers.elasticsearch }
+                    : {}),
+            },
+            ports: {
+                ...(typeof rawPorts.mongo === 'number' ? { mongo: rawPorts.mongo } : {}),
+                ...(typeof rawPorts.s3 === 'number' ? { s3: rawPorts.s3 } : {}),
+                ...(typeof s3UiPort === 'number' ? { s3Ui: s3UiPort } : {}),
+                ...(typeof rawPorts.elasticsearch === 'number'
+                    ? { elasticsearch: rawPorts.elasticsearch }
+                    : {}),
+            },
+            ...(minioContainer ? { legacy: { minioContainer } } : {}),
+            enabledServices: serviceMigration.services,
+            lastActive: rawProject.lastActive,
+        };
+    }
+    return {
+        data: { schemaVersion: 2, projects },
+        migrated,
+    };
+};
+const createDefaultStore = () => new GlobalRegistryStore();
+export const preflightGlobalRegistryMigration = async (storeArg = createDefaultStore()) => {
+    return migrateLegacyGlobalRegistryData(await storeArg.readRaw()).data;
+};
+export const runGlobalRegistryMigration = async (storeArg = createDefaultStore()) => {
+    await preflightGlobalRegistryMigration(storeArg);
+    return storeArg.transact((rawData) => {
+        const migration = migrateLegacyGlobalRegistryData(rawData);
+        return {
+            result: migration.data,
+            ...(migration.migrated ? { writeData: migration.data } : {}),
+        };
+    });
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDA0Lmdsb2JhbC1yZWdpc3RyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX21pZ3JhdGlvbi8wMDQuZ2xvYmFsLXJlZ2lzdHJ5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxFQUFFLGlDQUFpQyxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDL0UsT0FBTyxFQUNMLG1CQUFtQixHQUlwQixNQUFNLG1EQUFtRCxDQUFDO0FBZ0IzRCxNQUFNLGFBQWEsR0FBRyxDQUFDLFFBQWlCLEVBQXVDLEVBQUUsQ0FDL0UsT0FBTyxRQUFRLEtBQUssUUFBUSxJQUFJLFFBQVEsS0FBSyxJQUFJLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFDO0FBRWhGLE1BQU0saUJBQWlCLEdBQUcsQ0FDeEIsUUFBaUMsRUFDakMsY0FBaUMsRUFDakMsVUFBa0IsRUFDWixFQUFFO0lBQ1IsSUFBSSxNQUFNLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQyxjQUFjLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUM3RSxNQUFNLElBQUksS0FBSyxDQUNiLDRDQUE0QyxVQUFVLCtCQUErQixDQUN0RixDQUFDO0lBQ0osQ0FBQztBQUNILENBQUMsQ0FBQztBQUVGLE1BQU0scUJBQXFCLEdBQUcsQ0FDNUIsUUFBaUMsRUFDakMsT0FBMEIsRUFDMUIsVUFBa0IsRUFDWixFQUFFO0lBQ1IsS0FBSyxNQUFNLEdBQUcsSUFBSSxPQUFPLEVBQUUsQ0FBQztRQUMxQixJQUFJLFFBQVEsQ0FBQyxHQUFHLENBQUMsS0FBSyxTQUFTLElBQUksQ0FBQyxPQUFPLFFBQVEsQ0FBQyxHQUFHLENBQUMsS0FBSyxRQUFRLElBQUksQ0FBQyxRQUFRLENBQUMsR0FB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

package/dist_ts_migration/index.d.ts

@@ -0,0 +1,11 @@
+export type TServiceMigrationScope = 'global-registry' | 'service-selection' | 'runtime-config' | 'service-data-marker';
+export interface IServiceMigrationRunOptions {
+    projectPath?: string;
+    scopes: readonly TServiceMigrationScope[];
+}
+/** Run only the persisted-state migrations required by one command profile. */
+export declare const runServiceMigrations: (optionsArg: IServiceMigrationRunOptions) => Promise<void>;
+export * from './001.service-selection.js';
+export * from './002.runtime-config.js';
+export * from './003.service-data-marker.js';
+export * from './004.global-registry.js';

package/dist_ts_migration/index.js

@@ -0,0 +1,59 @@
+import { preflightServiceSelectionMigration, runServiceSelectionMigration, } from './001.service-selection.js';
+import { preflightServiceRuntimeConfigMigration, runServiceRuntimeConfigMigration, } from './002.runtime-config.js';
+import { preflightServiceDataMarkerMigration, runServiceDataMarkerMigration, } from './003.service-data-marker.js';
+import { preflightGlobalRegistryMigration, runGlobalRegistryMigration, } from './004.global-registry.js';
+const migrationOrder = [
+    'global-registry',
+    'service-selection',
+    'runtime-config',
+    'service-data-marker',
+];
+/** Run only the persisted-state migrations required by one command profile. */
+export const runServiceMigrations = async (optionsArg) => {
+    const scopes = new Set(optionsArg.scopes);
+    const needsProjectPath = [...scopes].some((scopeArg) => scopeArg !== 'global-registry');
+    if (needsProjectPath && !optionsArg.projectPath) {
+        throw new Error('Project-scoped service migrations require a project path.');
+    }
+    // Validate every selected store before the first migration is allowed to write.
+    for (const scope of migrationOrder) {
+        if (!scopes.has(scope)) {
+            continue;
+        }
+        if (scope === 'global-registry') {
+            await preflightGlobalRegistryMigration();
+        }
+        else if (scope === 'service-selection') {
+            await preflightServiceSelectionMigration(optionsArg.projectPath);
+        }
+        else if (scope === 'runtime-config') {
+            await preflightServiceRuntimeConfigMigration(optionsArg.projectPath);
+        }
+        else {
+            await preflightServiceDataMarkerMigration(optionsArg.projectPath);
+        }
+    }
+    for (const scope of migrationOrder) {
+        if (!scopes.has(scope)) {
+            continue;
+        }
+        if (scope === 'global-registry') {
+            await runGlobalRegistryMigration();
+            continue;
+        }
+        if (scope === 'service-selection') {
+            await runServiceSelectionMigration(optionsArg.projectPath);
+        }
+        else if (scope === 'runtime-config') {
+            await runServiceRuntimeConfigMigration(optionsArg.projectPath);
+        }
+        else {
+            await runServiceDataMarkerMigration(optionsArg.projectPath);
+        }
+    }
+};
+export * from './001.service-selection.js';
+export * from './002.runtime-config.js';
+export * from './003.service-data-marker.js';
+export * from './004.global-registry.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19taWdyYXRpb24vaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUNMLGtDQUFrQyxFQUNsQyw0QkFBNEIsR0FDN0IsTUFBTSw0QkFBNEIsQ0FBQztBQUNwQyxPQUFPLEVBQ0wsc0NBQXNDLEVBQ3RDLGdDQUFnQyxHQUNqQyxNQUFNLHlCQUF5QixDQUFDO0FBQ2pDLE9BQU8sRUFDTCxtQ0FBbUMsRUFDbkMsNkJBQTZCLEdBQzlCLE1BQU0sOEJBQThCLENBQUM7QUFDdEMsT0FBTyxFQUNMLGdDQUFnQyxFQUNoQywwQkFBMEIsR0FDM0IsTUFBTSwwQkFBMEIsQ0FBQztBQWFsQyxNQUFNLGNBQWMsR0FBNkI7SUFDL0MsaUJBQWlCO0lBQ2pCLG1CQUFtQjtJQUNuQixnQkFBZ0I7SUFDaEIscUJBQXFCO0NBQ3RCLENBQUM7QUFFRiwrRUFBK0U7QUFDL0UsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUcsS0FBSyxFQUN2QyxVQUF1QyxFQUN4QixFQUFFO0lBQ2pCLE1BQU0sTUFBTSxHQUFHLElBQUksR0FBRyxDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUMxQyxNQUFNLGdCQUFnQixHQUFHLENBQUMsR0FBRyxNQUFNLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxRQUFRLEVBQUUsRUFBRSxDQUFDLFFBQVEsS0FBSyxpQkFBaUIsQ0FBQyxDQUFDO0lBQ3hGLElBQUksZ0JBQWdCLElBQUksQ0FBQyxVQUFVLENBQUMsV0FBVyxFQUFFLENBQUM7UUFDaEQsTUFBTSxJQUFJLEtBQUssQ0FBQywyREFBMkQsQ0FBQyxDQUFDO0lBQy9FLENBQUM7SUFFRCxnRkFBZ0Y7SUFDaEYsS0FBSyxNQUFNLEtBQUssSUFBSSxjQUFjLEVBQUUsQ0FBQztRQUNuQyxJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1lBQ3ZCLFNBQVM7UUFDWCxDQUFDO1FBQ0QsSUFBSSxLQUFLLEtBQUssaUJBQWlCLEVBQUUsQ0FBQztZQUNoQyxNQUFNLGdDQUFnQyxFQUFFLENBQUM7UUFDM0MsQ0FBQzthQUFNLElBQUksS0FBSyxLQUFLLG1CQUFtQixFQUFFLENBQUM7WUFDekMsTUFBTSxrQ0FBa0MsQ0FBQyxVQUFVLENBQUMsV0FBWSxDQUFDLENBQUM7UUFDcEUsQ0FBQzthQUFNLElBQUksS0FBSyxLQUFLLGdCQUFnQixFQUFFLENBQUM7WUFDdEMsTUFBTSxzQ0FBc0MsQ0FBQyxVQUFVLENBQUMsV0FBWSxDQUFDLENBQUM7UUFDeEUsQ0FBQzthQUFNLENBQUM7WUFDTixNQUFNLG1DQUFtQyxDQUFDLFVBQVUsQ0FBQyxXQUFZLENBQUMsQ0FBQztRQUNyRSxDQUFDO0lBQ0gsQ0FBQztJQUVELEtBQUssTUFBTSxLQUFLLElBQUksY0FBYyxFQUFFLENBQUM7UUFDbkMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUN2QixTQUFTO1FBQ1gsQ0FBQztRQUNELElBQUksS0FBSyxLQUFLLGlCQUFpQixFQUFFLENBQUM7WUFDaEMsTUFBTSwwQkFBMEIsRUFBRSxDQUFDO1lBQ25DLFNBQVM7UUFDWCxDQUFDO1FBQ0QsSUFBSSxLQUFLLEtBQUssbUJBQW1CLEVBQUUsQ0FBQztZQUNsQyxNQUFNLDRCQUE0QixDQUFDLFVBQVUsQ0FBQyxXQUFZLENBQUMsQ0FBQztRQUM5RCxDQUFDO2FBQU0sSUFBSSxLQUFLLEtBQUssZ0JBQWdCLEVBQUUsQ0FBQztZQUN0QyxNQUFNLGdDQUFnQyxDQUFDLFVBQVUsQ0FBQyxXQUFZLENBQUMsQ0FBQztRQUNsRSxDQUFDO2FBQU0sQ0FBQztZQUNOLE1BQU0sNkJBQTZCLENBQUMsVUFBVSxDQUFDLFdBQVksQ0FBQyxDQUFDO1FBQy9ELENBQUM7SUFDSCxDQUFDO0FBQ0gsQ0FBQyxDQUFDO0FBRUYsY0FBYyw0QkFBNEIsQ0FBQztBQUMzQyxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsOEJBQThCLENBQUM7QUFDN0MsY0FBYywwQkFBMEIsQ0FBQyJ9