@hearsay-tools/squawk 0.0.0-stage → 0.17.0-pr3058.5683

package/dist/home/migration-boot.d.ts

@@ -0,0 +1,23 @@
+import type { Home } from './home.ts';
+export interface MigrationBootOptions {
+    enabled?: boolean;
+    legacy?: Home;
+    deferFresh?: boolean;
+}
+export type MigrationBootResult = {
+    kind: 'ready';
+} | {
+    kind: 'staged';
+} | {
+    kind: 'fresh';
+    prepare: () => void;
+} | {
+    kind: 'legacy';
+    home: Home;
+};
+/**
+ * A staged group reads the target without writes. A legacy home that records an installed server with group migration support
+ * keeps serving until `hsq server-migrate` commits the target: only that command stops the group,
+ * stages the home and rolls every instance back on failure (spec §4 "Server installs").
+ */
+export declare function prepareMigrationHome(home: Home, env: NodeJS.ProcessEnv, { deferFresh, enabled, legacy, }?: MigrationBootOptions): MigrationBootResult;

package/dist/home/migration-boot.js

@@ -0,0 +1,84 @@
+import { logPrefix } from './display.js';
+import { commandText } from './command.js';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { resolveHome } from './resolve.js';
+import { REBRAND_SWITCH } from './switch.js';
+import { assertNoMigration } from './migration-guard.js';
+import { migrationHolderLive } from './migration-claim.js';
+import { readInstallMarker } from './install-marker.js';
+import { readMigrationRecord } from './migration-record.js';
+import { migrateLegacyHome } from './migrate.js';
+import { finishDeferredAccounts } from './migration-accounts.js';
+import { listServerInstances } from '../server-install/state.js';
+import { getStrategy, supportsServerMigration } from '../server-install/strategies.js';
+/**
+ * A staged group reads the target without writes. A legacy home that records an installed server with group migration support
+ * keeps serving until `hsq server-migrate` commits the target: only that command stops the group,
+ * stages the home and rolls every instance back on failure (spec §4 "Server installs").
+ */
+export function prepareMigrationHome(home, env, { deferFresh = false, enabled = REBRAND_SWITCH, legacy = enabled ? resolveHome({ purpose: 'cli', env, layout: 'legacy' }) : undefined, } = {}) {
+    if (!enabled || !legacy)
+        return { kind: 'ready' };
+    if (migrationHolderLive(legacy.root))
+        assertNoMigration(legacy.root);
+    if (migrationHolderLive(home.config))
+        assertNoMigration(home.config);
+    // The serve lifecycle prepares the selected home again. Never migrate a legacy fallback into itself.
+    if (home.layout === 'legacy')
+        return { kind: 'ready' };
+    const marker = readInstallMarker(home.config);
+    legacy = recordedSource(legacy, marker);
+    // Only a finished commit:false copy is a staged server group. A crashed or failed run leaves a
+    // pending home without stagedAt, or a stale claim: restart it at step 4 (spec §4 step 3).
+    if (isStagedHome(home, legacy, marker))
+        return { kind: 'staged' };
+    if (marker?.state !== 'committed' && hasInstalledServer(legacy)) {
+        console.warn(commandText(existsSync(join(home.config, 'install.json.failed'))
+            ? `[hsq] server migration was rolled back; serving legacy home ${legacy.root}. Run hsq server-migrate to retry.`
+            : `[hsq] ${legacy.root} records a server install; using it until hsq server-migrate moves every instance and the home as one group. Run hsq server-migrate.`));
+        return { kind: 'legacy', home: legacy };
+    }
+    if (deferFresh && !marker && !existsSync(legacy.root)) {
+        return { kind: 'fresh', prepare: () => {
+                // A legacy server install or a staged group can appear before the first write. Never write the split home then.
+                if (prepareMigrationHome(home, env, { enabled, legacy }).kind === 'ready')
+                    return;
+                throw new Error(commandText(`[hsq] refusing to write home ${home.root}: a server install in ${legacy.root} must move first. Run hsq server-migrate.`));
+            } };
+    }
+    return migrateAtBoot(home, legacy, env);
+}
+/** A committed home names its source. A later launch may name only HSQ_HOME, so the env no longer selects it. */
+function recordedSource(legacy, marker) {
+    if (marker?.state !== 'committed' || !marker.migratedFrom || resolve(marker.migratedFrom) === resolve(legacy.root))
+        return legacy;
+    return resolveHome({ purpose: 'cli', env: { CEZ_HOME: marker.migratedFrom }, layout: 'legacy' });
+}
+const UNWRITABLE = new Set(['EROFS', 'EACCES', 'EPERM']);
+/** Zero config: a read-only home degrades the cockpit, never fails the boot. */
+function migrateAtBoot(home, legacy, env) {
+    try {
+        migrateLegacyHome(legacy, home, { env });
+        finishDeferredAccounts(legacy, home);
+        return { kind: 'ready' };
+    }
+    catch (error) {
+        if (!UNWRITABLE.has(error.code ?? ''))
+            throw error;
+        const committed = readInstallMarker(home.config)?.state === 'committed';
+        console.warn(`${logPrefix()} cannot finish the home migration from ${legacy.root} to ${home.root} (${error.message}); `
+            + (committed ? 'serving the migrated home.' : `serving ${legacy.root} until both homes are writable.`));
+        return committed ? { kind: 'ready' } : { kind: 'legacy', home: legacy };
+    }
+}
+/** Only a completed server install needs the explicit group migration command. */
+function hasInstalledServer(legacy) {
+    return listServerInstances(legacy).some(({ state }) => state.installed && !state.dryRun && supportsServerMigration(getStrategy(state.platform ?? '')));
+}
+/** A crash without stagedAt must restart migration instead of serving partial copies. */
+function isStagedHome(home, legacy, marker) {
+    return marker?.state === 'pending' && !existsSync(join(legacy.root, '.migrating'))
+        && readMigrationRecord(home)?.stagedAt !== undefined;
+}
+//# sourceMappingURL=migration-boot.js.map

package/dist/home/migration-boot.js.map

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

package/dist/home/migration-claim.d.ts

@@ -0,0 +1,4 @@
+export declare function migrationHolderLive(root: string): boolean;
+/** A dead holder's claim is removable; a live one refuses. Takes the root write.lock. */
+export declare function removeStaleMigrationClaim(root: string): void;
+export declare function claimMigration(root: string): () => void;

package/dist/home/migration-claim.js

@@ -0,0 +1,69 @@
+import { closeSync, fsyncSync, openSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { recordedProcessLive } from '../delegation/process-liveness.js';
+import { assertHomePath } from './boundary.js';
+import { ownProcessStartToken } from './process-identity.js';
+import { privateDirectory, syncDirectory } from './private-files.js';
+import { migrationPrivacy } from './migration-files.js';
+import { withHomeLock } from './write-lock.js';
+const holderSchema = z.object({ pid: z.number().int().positive(), startToken: z.string().optional() });
+export function migrationHolderLive(root) {
+    const path = join(root, '.migrating');
+    try {
+        const holder = holderSchema.safeParse(JSON.parse(readFileSync(path, 'utf8')));
+        return holder.success ? recordedProcessLive(holder.data) : Date.now() - statSync(path).mtimeMs < 30_000;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        if (error instanceof SyntaxError)
+            return Date.now() - statSync(path).mtimeMs < 30_000;
+        throw error;
+    }
+}
+/** A dead holder's claim is removable; a live one refuses. Takes the root write.lock. */
+export function removeStaleMigrationClaim(root) {
+    const path = join(root, '.migrating');
+    assertHomePath(root, path);
+    withHomeLock(root, () => {
+        if (migrationHolderLive(root))
+            throw new Error(`Home migration already running: ${path}`);
+        rmSync(path, { force: true });
+    });
+}
+export function claimMigration(root) {
+    const path = join(root, '.migrating');
+    assertHomePath(root, path);
+    privateDirectory(root, migrationPrivacy);
+    const contents = JSON.stringify({ pid: process.pid, startToken: ownProcessStartToken() });
+    const claim = () => {
+        const fd = openSync(path, 'wx', 0o600);
+        try {
+            writeFileSync(fd, contents);
+            fsyncSync(fd);
+        }
+        finally {
+            closeSync(fd);
+        }
+        syncDirectory(root);
+    };
+    try {
+        claim();
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST')
+            throw error;
+        if (migrationHolderLive(root))
+            throw new Error(`Home migration already running: ${path}`);
+        // Serialize stale removal and exclusive create. A second reclaimer sees the new live holder.
+        withHomeLock(root, () => { removeStaleMigrationClaim(root); claim(); });
+    }
+    return () => {
+        if (readFileSync(path, 'utf8') !== contents)
+            throw new Error(`Migration claim changed: ${path}`);
+        rmSync(path);
+        syncDirectory(root);
+    };
+}
+//# sourceMappingURL=migration-claim.js.map

package/dist/home/migration-claim.js.map

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

package/dist/home/migration-cli.d.ts

@@ -0,0 +1,3 @@
+import type { Home } from './home.ts';
+export declare const LEGACY_RECOVERY_COMMAND: string;
+export declare function runMigrationCommand(argv: string[], env: NodeJS.ProcessEnv, target?: Home, legacy?: Home): Promise<number>;

package/dist/home/migration-cli.js

@@ -0,0 +1,64 @@
+import { commandText } from './command.js';
+import { parseArgs } from 'node:util';
+import { homeFileSchema } from '../contract/index.js';
+import { resolveHome } from './resolve.js';
+import { planLegacyMigration } from './migration-plan.js';
+import { acceptHomeRecovery } from './recovery.js';
+import { HomeStore } from './store.js';
+import { homeFileLocation } from './file-location.js';
+import { restorePinnedRecovery } from '../workspace/backup-cli.js';
+export const LEGACY_RECOVERY_COMMAND = commandText('hsq migrate --resolve-legacy <file> restore|accept');
+const HELP = commandText(`Usage: hsq migrate [--dry-run]
+       ${LEGACY_RECOVERY_COMMAND}
+Inspect or migrate the legacy home into the split layout.
+Resolve a legacy recovery incident before migration: restore its pinned version,
+or accept its current bytes. Use a supported home-relative file, such as config.json.
+Recovery does not migrate the home. Run hsq migrate again after recovery.
+--resolve-legacy cannot be combined with --dry-run.`);
+function recoveryAction(file, positionals, dryRun) {
+    if (file === undefined) {
+        if (positionals.length)
+            throw new Error(HELP);
+        return;
+    }
+    if (!homeFileSchema.safeParse(file).success)
+        throw new Error('File must be a supported home-relative HomeStore file');
+    const [action] = positionals;
+    if (dryRun || positionals.length !== 1 || (action !== 'restore' && action !== 'accept'))
+        throw new Error(HELP);
+    return action;
+}
+export async function runMigrationCommand(argv, env, target, legacy) {
+    try {
+        const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: {
+                'dry-run': { type: 'boolean' }, 'resolve-legacy': { type: 'string' }, help: { type: 'boolean', short: 'h' },
+            } });
+        if (values.help) {
+            console.log(HELP);
+            return 0;
+        }
+        const file = values['resolve-legacy'];
+        const action = recoveryAction(file, positionals, values['dry-run']);
+        legacy ??= resolveHome({ purpose: 'cli', env, layout: 'legacy' });
+        if (file !== undefined && action) {
+            // Migration inspections are report-only. Persist backup-derived resets before resolving them.
+            new HomeStore(legacy).recovery(homeFileLocation(legacy, file).path);
+            if (action === 'restore')
+                restorePinnedRecovery(file, legacy);
+            else
+                acceptHomeRecovery(legacy, file, undefined, false);
+            console.log(JSON.stringify({ file, action }, null, 2));
+            return 0;
+        }
+        target ??= resolveHome({ purpose: 'cli', env, layout: 'split' });
+        const { migrateLegacyHome } = await import('./migrate.js');
+        console.log(JSON.stringify(values['dry-run'] ? { dryRun: true, plan: planLegacyMigration(legacy, target) }
+            : migrateLegacyHome(legacy, target, { env }), null, 2));
+        return 0;
+    }
+    catch (error) {
+        console.error(`${commandText('[hsq] migration failed:')} ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=migration-cli.js.map

package/dist/home/migration-cli.js.map

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

package/dist/home/migration-files.d.ts

@@ -0,0 +1,14 @@
+/** All migration copies opt into private ACLs even before the release switch is enabled. */
+export declare const migrationPrivacy: {
+    readonly layout: 'split';
+};
+export declare function insideDirectory(root: string, path: string): boolean;
+/** Do not follow links while inventorying a home. The caller selects excluded subtrees. */
+export declare function migrationFiles(root: string, exclude?: (path: string) => boolean, directories?: boolean): string[];
+/** Preserve internal links, including versions/current; refuse links to outside data.
+ *  Files are 0600, or 0700 when the owner could execute the source (launchers, profile hooks). */
+export declare function copyPrivateTree(source: string, target: string, allowExternalLink?: (key: string, destination: string) => boolean, finalTarget?: string): void;
+/** A pending destination is disposable. Publish only a complete fresh copy, never merge trees. */
+export declare function replacePrivateTree(source: string, target: string, allowExternalLink?: (key: string, destination: string) => boolean): void;
+/** Synchronous so the migration never yields while it holds the legacy write lock. */
+export declare function writeLegacyArchive(root: string, path: string, files: readonly string[]): void;

package/dist/home/migration-files.js

@@ -0,0 +1,192 @@
+import { chmodSync, closeSync, fsyncSync, lstatSync, openSync, readdirSync, readFileSync, readlinkSync, realpathSync, renameSync, rmSync, symlinkSync, writeSync } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { gzipSync } from 'node:zlib';
+import { assertHomePath } from './boundary.js';
+import { atomicTmpPath, privateDirectory, replacePrivate, syncDirectory } from './private-files.js';
+/** All migration copies opt into private ACLs even before the release switch is enabled. */
+export const migrationPrivacy = { layout: 'split' };
+export function insideDirectory(root, path) {
+    const part = relative(resolve(root), resolve(path));
+    return part === '' || (!isAbsolute(part) && part !== '..' && !part.startsWith(`..${sep}`));
+}
+/** Do not follow links while inventorying a home. The caller selects excluded subtrees. */
+export function migrationFiles(root, exclude = () => false, directories = false) {
+    const found = [];
+    function visit(directory) {
+        let names;
+        try {
+            names = readdirSync(directory).sort();
+        }
+        catch (error) {
+            if (error.code === 'ENOENT' && directory === root)
+                return;
+            throw error;
+        }
+        for (const name of names) {
+            const path = join(directory, name);
+            const key = relative(root, path).split(sep).join('/');
+            if (exclude(key))
+                continue;
+            const stat = lstatSync(path);
+            if (stat.isDirectory()) {
+                if (directories)
+                    found.push(`${key}/`);
+                visit(path);
+            }
+            else if (stat.isFile() || stat.isSymbolicLink())
+                found.push(key);
+            else
+                throw new Error(`Cannot migrate special file ${path}`);
+        }
+    }
+    visit(root);
+    return found;
+}
+/** Preserve internal links, including versions/current; refuse links to outside data.
+ *  Files are 0600, or 0700 when the owner could execute the source (launchers, profile hooks). */
+export function copyPrivateTree(source, target, allowExternalLink = () => false, finalTarget = target) {
+    const canonical = realpathSync(source);
+    const finalRoot = resolve(finalTarget);
+    privateDirectory(target, migrationPrivacy);
+    for (const key of migrationFiles(source, () => false, true)) {
+        const from = join(source, key), to = join(target, key);
+        assertHomePath(target, dirname(to));
+        const stat = lstatSync(from);
+        if (stat.isDirectory()) {
+            assertHomePath(target, to);
+            privateDirectory(to, migrationPrivacy);
+        }
+        else if (stat.isSymbolicLink()) {
+            const link = existingLinkTarget(from);
+            if (link === undefined) {
+                copyDanglingLink(canonical, key, from, to, finalRoot);
+                continue;
+            }
+            const external = !insideDirectory(canonical, link);
+            if (external && !allowExternalLink(key, link))
+                throw new Error(`Migration link escapes source: ${from}`);
+            const destination = external ? link : join(finalRoot, relative(canonical, link));
+            privateDirectory(dirname(to), migrationPrivacy);
+            // The destination name belongs to a disposable pending copy, never the source.
+            rmSync(to, { force: true });
+            const directory = lstatSync(link).isDirectory();
+            const junction = directory && process.platform === 'win32';
+            const absolute = external || junction || isAbsolute(readlinkSync(from));
+            symlinkSync(absolute ? destination : relative(dirname(join(finalRoot, key)), destination), to, junction ? 'junction' : directory ? 'dir' : 'file');
+        }
+        else {
+            assertHomePath(target, to);
+            const bytes = readFileSync(from);
+            replacePrivate(to, bytes, migrationPrivacy);
+            if (!readFileSync(to).equals(bytes))
+                throw new Error(`Migration copy verification failed: ${from}`);
+            if (stat.mode & 0o100)
+                chmodSync(to, 0o700);
+        }
+    }
+}
+function existingLinkTarget(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+/** A dangling link inventories like any link. Keep it when its lexical target stays inside. */
+function copyDanglingLink(canonical, key, from, to, finalRoot) {
+    const written = readlinkSync(from);
+    const lexical = resolve(dirname(join(canonical, key)), written);
+    if (!insideDirectory(canonical, lexical))
+        throw new Error(`Migration link escapes source: ${from}`);
+    privateDirectory(dirname(to), migrationPrivacy);
+    rmSync(to, { force: true });
+    symlinkSync(isAbsolute(written) ? join(finalRoot, relative(canonical, lexical)) : written, to, 'file');
+}
+/** A pending destination is disposable. Publish only a complete fresh copy, never merge trees. */
+export function replacePrivateTree(source, target, allowExternalLink = () => false) {
+    assertHomePath(dirname(target), target);
+    const stage = atomicTmpPath(target);
+    try {
+        copyPrivateTree(source, stage, allowExternalLink, target);
+        rmSync(target, { recursive: true, force: true });
+        renameSync(stage, target);
+        syncDirectory(dirname(target));
+    }
+    finally {
+        rmSync(stage, { recursive: true, force: true });
+    }
+}
+/** ustar stores a UTF-8 name in 100 bytes and an optional 155-byte prefix. */
+function archiveName(header, key) {
+    if (Buffer.byteLength(key) <= 100) {
+        header.write(key);
+        return;
+    }
+    const splits = [...key.matchAll(/\//g)].map(match => match.index).reverse();
+    const split = splits.find(index => Buffer.byteLength(key.slice(0, index)) <= 155 && Buffer.byteLength(key.slice(index + 1)) <= 100);
+    if (split === undefined)
+        throw new Error(`Path too long for migration archive: ${key}`);
+    header.write(key.slice(split + 1), 0, 100);
+    header.write(key.slice(0, split), 345, 155);
+}
+function tarEntry(root, key) {
+    const path = join(root, key), stat = lstatSync(path);
+    const link = stat.isSymbolicLink() ? readlinkSync(path) : undefined;
+    const bytes = link === undefined && !stat.isDirectory() ? readFileSync(path) : Buffer.alloc(0);
+    if (link !== undefined && Buffer.byteLength(link) > 100)
+        throw new Error(`Link too long for migration archive: ${path}`);
+    const header = Buffer.alloc(512);
+    archiveName(header, key.replace(/\/$/, ''));
+    const octal = (value, at, width) => {
+        const valueText = value.toString(8);
+        if (valueText.length >= width)
+            throw new Error(`File too large for migration archive: ${path}`);
+        header.write(`${valueText.padStart(width - 1, '0')}\0`, at, width);
+    };
+    octal(stat.isDirectory() || (link === undefined && stat.mode & 0o100) ? 0o700 : 0o600, 100, 8);
+    octal(0, 108, 8);
+    octal(0, 116, 8);
+    octal(bytes.length, 124, 12);
+    octal(Math.floor(stat.mtimeMs / 1000), 136, 12);
+    header.fill(32, 148, 156);
+    header.write(stat.isDirectory() ? '5' : link === undefined ? '0' : '2', 156);
+    if (link !== undefined)
+        header.write(link, 157, 100);
+    header.write('ustar\0', 257);
+    header.write('00', 263);
+    const checksum = header.reduce((sum, byte) => sum + byte, 0);
+    header.write(`${checksum.toString(8).padStart(6, '0')}\0 `, 148, 8);
+    return [header, bytes, Buffer.alloc((512 - bytes.length % 512) % 512)];
+}
+/** Synchronous so the migration never yields while it holds the legacy write lock. */
+export function writeLegacyArchive(root, path, files) {
+    privateDirectory(dirname(path), migrationPrivacy);
+    const stage = atomicTmpPath(path);
+    try {
+        const fd = openSync(stage, 'wx', 0o600);
+        try {
+            // Concatenated gzip members decompress to one tar stream. Retain only one entry at a time.
+            const write = (bytes) => {
+                const member = gzipSync(bytes);
+                for (let offset = 0; offset < member.length;)
+                    offset += writeSync(fd, member, offset, member.length - offset);
+            };
+            for (const key of files)
+                write(Buffer.concat(tarEntry(root, key)));
+            write(Buffer.alloc(1024));
+            fsyncSync(fd);
+        }
+        finally {
+            closeSync(fd);
+        }
+        renameSync(stage, path);
+        syncDirectory(dirname(path));
+    }
+    finally {
+        rmSync(stage, { force: true });
+    }
+}
+//# sourceMappingURL=migration-files.js.map

package/dist/home/migration-files.js.map

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

package/dist/home/migration-guard.d.ts

@@ -0,0 +1,2 @@
+/** The absent-file fast path uses at most one stat before waiting for write.lock. */
+export declare function assertNoMigration(root: string, locked?: boolean): void;

package/dist/home/migration-guard.js

@@ -0,0 +1,20 @@
+import { logPrefix } from './display.js';
+import { lstatSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** The absent-file fast path uses at most one stat before waiting for write.lock. */
+export function assertNoMigration(root, locked = false) {
+    const path = join(root, '.migrating');
+    try {
+        if (locked)
+            readFileSync(path);
+        else
+            lstatSync(path);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+    throw new Error(`${logPrefix()} home migration in progress at ${path}; stop this writer and retry after migration`);
+}
+//# sourceMappingURL=migration-guard.js.map

package/dist/home/migration-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-guard.js","sourceRoot":"","sources":["../../src/home/migration-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAM,GAAG,KAAK;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,IAAI,MAAM;YAAE,YAAY,CAAC,IAAI,CAAC,CAAC;;YAC1B,SAAS,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QAC/D,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,EAAE,kCAAkC,IAAI,8CAA8C,CAAC,CAAC;AACtH,CAAC"}

package/dist/home/migration-plan.d.ts

@@ -0,0 +1,20 @@
+import type { Home } from './home.ts';
+import { type MigrationAccount } from './migration-accounts.ts';
+import { type MigrationFile, type MigrationRecord } from './migration-record.ts';
+export interface MigrationPlan {
+    legacyRoot: string;
+    roots: MigrationRecord['roots'];
+    files: MigrationFile[];
+    accounts: MigrationAccount[];
+    notMoved: MigrationRecord['notMoved'];
+    deferredAccounts: MigrationRecord['deferredAccounts'];
+    managedInstall: boolean;
+    backup: string;
+    empty: boolean;
+}
+export declare const archiveExcludes: RegExp;
+/** Parse live cezar-owned JSON only. Historical snapshots and vendor trees are opaque bytes. */
+export declare function isCezarMigrationJson(path: string): boolean;
+/** The dry-run and real migration share this filesystem-only planner. It never creates journals. */
+export declare function planLegacyMigration(legacy: Home, target: Home): MigrationPlan;
+export declare function migrationRecordFor(plan: MigrationPlan): MigrationRecord;

package/dist/home/migration-plan.js

@@ -0,0 +1,71 @@
+import { existsSync, lstatSync, readFileSync, readlinkSync } from 'node:fs';
+import { join, relative, resolve, sep } from 'node:path';
+import { homeFileSchema } from '../contract/index.js';
+import { registryFiles } from './entry-authorization.js';
+import { homeFileKind } from './file-location.js';
+import { digest } from './version-log.js';
+import { insideDirectory, migrationFiles } from './migration-files.js';
+import { accountInUse, accountMigrationPolicy, migrationAccountInventory } from './migration-accounts.js';
+import { migrationRoots } from './migration-record.js';
+const ignored = /^(?:install\.json(?:\.failed)?|MOVED\.json|\.locks|\.versions|\.migrating|tmp|dry-cache|dry-prefix)(?:\/|$)|(?:^|\/)[^/]*\.install\.lock$/;
+export const archiveExcludes = /^(?:versions|bin|dry-cache|dry-prefix|tmp|\.locks|\.migrating)(?:\/|$)/;
+/** Parse live cezar-owned JSON only. Historical snapshots and vendor trees are opaque bytes. */
+export function isCezarMigrationJson(path) {
+    if (path.split('/').includes('backups'))
+        return false;
+    return ['config.json', 'config.json.bak', 'agent-accounts.json', 'ui-state.json', 'server.json', 'migration.json'].includes(path)
+        || /^(?:remote-settings|tracker-connections|server-instances|application-updates)\/.+\.json(?:\.bak)?$/.test(path);
+}
+function destination(path) {
+    if (path.endsWith('.install.lock'))
+        return null;
+    if (homeFileSchema.safeParse(path).success)
+        return { kind: homeFileKind(path), path };
+    const nestedBackup = /^(remote-settings|server-instances)\/backups\/(.+)$/.exec(path);
+    if (nestedBackup)
+        return { kind: 'state', path: `backups/${nestedBackup[1]}/${nestedBackup[2]}` };
+    if (/^(?:remote-settings|tracker-connections)\//.test(path))
+        return { kind: 'config', path };
+    if (/^(?:backups|application-updates)\//.test(path))
+        return { kind: 'state', path };
+    if (path.startsWith('versions/'))
+        return { kind: 'data', path };
+    return null;
+}
+/** The dry-run and real migration share this filesystem-only planner. It never creates journals. */
+export function planLegacyMigration(legacy, target) {
+    if (target.layout !== 'split')
+        throw new Error('Legacy migration requires an explicit split target');
+    const legacyRoot = resolve(legacy.root);
+    if (resolve(target.config) === legacyRoot)
+        throw new Error('Migration target must differ from the legacy root');
+    const { accounts, notMoved } = migrationAccountInventory(legacy, target);
+    const targetRoots = Object.values(migrationRoots(target)).map(path => resolve(path));
+    const keys = migrationFiles(legacy.root, key => ignored.test(key)
+        || targetRoots.some(root => insideDirectory(legacyRoot, root) && insideDirectory(root, join(legacyRoot, key))));
+    const files = keys.map(path => {
+        const from = join(legacy.root, path), stat = lstatSync(from);
+        const bytes = stat.isSymbolicLink() ? Buffer.from(readlinkSync(from)) : readFileSync(from);
+        let mapped = destination(path);
+        if (!mapped) {
+            const account = accounts.find(account => accountMigrationPolicy(account) === 'copy' && insideDirectory(account.source, from));
+            if (account)
+                mapped = { kind: 'data', path: `accounts/${account.id}/${relative(account.source, from).split(sep).join('/')}` };
+        }
+        return { path, hash: digest(bytes), mtimeMs: stat.mtimeMs, target: mapped };
+    });
+    return { legacyRoot, roots: migrationRoots(target), files, accounts,
+        deferredAccounts: accounts.filter(account => accountMigrationPolicy(account) === 'copy' && accountInUse(legacy, account.id))
+            .map(account => ({ id: account.id, configDir: account.configDir })),
+        notMoved: [...notMoved, ...accounts.filter(account => accountMigrationPolicy(account) === 'keep')
+                .map(account => ({ id: account.id, configDir: account.configDir, reason: 'omp-profile-root-inside-legacy-home' }))],
+        managedInstall: existsSync(legacy.versions),
+        backup: join(target.backups, `legacy-cezar-home-${new Date().toISOString().replaceAll(':', '-')}.tar.gz`),
+        empty: !registryFiles(legacy).some(path => existsSync(path)) && !existsSync(legacy.backups)
+            && !existsSync(join(legacy.remoteSettings, 'backups')) && !existsSync(join(legacy.serverInstances, 'backups')) };
+}
+export function migrationRecordFor(plan) {
+    return { version: 1, legacyRoot: plan.legacyRoot, roots: plan.roots, files: plan.files,
+        backup: plan.backup, createdAt: new Date().toISOString(), deferredAccounts: plan.deferredAccounts, notMoved: plan.notMoved };
+}
+//# sourceMappingURL=migration-plan.js.map