@msn-control/liftoff 0.10.4 → 0.11.2

package/dist/adapters/filesystem/project-lock.js

@@ -0,0 +1,164 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { createHash, randomUUID } from 'node:crypto';
+import { lstat, open, readFile, realpath, unlink } from 'node:fs/promises';
+import path from 'node:path';
+export class ProjectMutationLockError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ProjectMutationLockError';
+    }
+}
+const activeLocks = new AsyncLocalStorage();
+function errorCode(error) {
+    return typeof error === 'object' && error !== null && 'code' in error ? error.code : undefined;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function canonicalProjectRoot(projectRoot) {
+    const root = path.resolve(projectRoot);
+    try {
+        const details = await lstat(root);
+        if (details.isSymbolicLink()) {
+            throw new ProjectMutationLockError(`Project mutation target is a symlink or junction: ${root}`);
+        }
+        if (!details.isDirectory()) {
+            throw new ProjectMutationLockError(`Project mutation target must be a regular directory: ${root}`);
+        }
+        return await realpath(root);
+    }
+    catch (error) {
+        if (errorCode(error) !== 'ENOENT')
+            throw error;
+        return path.join(await realpath(path.dirname(root)), path.basename(root));
+    }
+}
+function lockPathForRoot(root) {
+    // Missing paths have no canonical spelling yet; fold aliases conservatively on every filesystem.
+    const identity = root.normalize('NFC').toLowerCase();
+    const digest = createHash('sha256').update(identity).digest('hex');
+    // A sibling reservation also protects a new target before its directory exists.
+    return path.join(path.dirname(root), `.liftoff-mutation-${digest}.lock`);
+}
+export async function projectMutationLockPath(projectRoot) {
+    return lockPathForRoot(await canonicalProjectRoot(projectRoot));
+}
+async function assertLockIdentity(lock, allowPartialContent = false) {
+    const details = await lstat(lock.path);
+    if (!details.isFile() || details.dev !== lock.device || details.ino !== lock.inode) {
+        throw new ProjectMutationLockError(`Project mutation lock changed: ${lock.path}. The replacement was preserved.`);
+    }
+    const content = await readFile(lock.path, 'utf8');
+    if (allowPartialContent ? !lock.content.startsWith(content) : content !== lock.content) {
+        throw new ProjectMutationLockError(`Project mutation lock contents changed: ${lock.path}. The changed file was preserved.`);
+    }
+}
+async function assertHeld(lock) {
+    if (!lock.active) {
+        throw new ProjectMutationLockError(`Project mutation lock is no longer held for ${lock.root}.`);
+    }
+    try {
+        await assertLockIdentity(lock);
+    }
+    catch (error) {
+        throw new ProjectMutationLockError(`Unable to confirm project mutation lock for ${lock.root}: ${errorMessage(error)}`, { cause: error });
+    }
+}
+async function releaseLock(lock, allowPartialContent = false) {
+    lock.active = false;
+    const failures = [];
+    try {
+        await lock.handle.close();
+    }
+    catch (error) {
+        failures.push(`close: ${errorMessage(error)}`);
+    }
+    try {
+        await assertLockIdentity(lock, allowPartialContent);
+        await unlink(lock.path);
+    }
+    catch (error) {
+        failures.push(`release: ${errorMessage(error)}`);
+    }
+    if (failures.length) {
+        throw new ProjectMutationLockError(`Unable to release project mutation lock ${lock.path}: ${failures.join('; ')}`);
+    }
+}
+async function acquireLock(root, lockPath) {
+    try {
+        await lstat(path.join(root, '.liftoff-init.lock'));
+        throw new ProjectMutationLockError(`A legacy Liftoff initialization lock exists in ${root}. Verify its owner has stopped before reviewing the lock; it was not removed.`);
+    }
+    catch (error) {
+        if (errorCode(error) !== 'ENOENT')
+            throw error;
+    }
+    let handle;
+    try {
+        handle = await open(lockPath, 'wx', 0o600);
+    }
+    catch (error) {
+        throw new ProjectMutationLockError(errorCode(error) === 'EEXIST'
+            ? `Another cooperating Liftoff mutation is already in progress for ${root}. Lock: ${lockPath}. Verify the owner has stopped before reviewing a stale lock; Liftoff never removes an unowned lock.`
+            : `Unable to acquire project mutation lock ${lockPath}: ${errorMessage(error)}`, { cause: error });
+    }
+    let lock;
+    try {
+        const details = await handle.stat();
+        lock = {
+            root,
+            path: lockPath,
+            handle,
+            device: details.dev,
+            inode: details.ino,
+            content: `${JSON.stringify({ schemaVersion: 1, pid: process.pid, token: randomUUID() })}\n`,
+            active: true
+        };
+    }
+    catch (error) {
+        await handle.close();
+        throw new ProjectMutationLockError(`Unable to establish ownership of project mutation lock ${lockPath}; the file was preserved: ${errorMessage(error)}`, { cause: error });
+    }
+    try {
+        await handle.writeFile(lock.content, 'utf8');
+        await assertHeld(lock);
+        return lock;
+    }
+    catch (error) {
+        try {
+            await releaseLock(lock, true);
+        }
+        catch (cleanupError) {
+            throw new ProjectMutationLockError(`${errorMessage(error)} Lock cleanup also failed: ${errorMessage(cleanupError)}`, { cause: error });
+        }
+        throw error;
+    }
+}
+export async function withProjectMutationLock(projectRoot, operation) {
+    const root = await canonicalProjectRoot(projectRoot);
+    const lockPath = lockPathForRoot(root);
+    const inherited = activeLocks.getStore()?.get(lockPath);
+    if (inherited) {
+        await assertHeld(inherited);
+        return operation({ assertHeld: () => assertHeld(inherited) });
+    }
+    const lock = await acquireLock(root, lockPath);
+    const scope = new Map(activeLocks.getStore());
+    scope.set(lockPath, lock);
+    let result;
+    try {
+        result = await activeLocks.run(scope, () => operation({ assertHeld: () => assertHeld(lock) }));
+    }
+    catch (error) {
+        try {
+            await releaseLock(lock);
+        }
+        catch (cleanupError) {
+            throw new ProjectMutationLockError(`${errorMessage(error)} Lock cleanup also failed: ${errorMessage(cleanupError)}`, { cause: error });
+        }
+        throw error;
+    }
+    await releaseLock(lock);
+    return result;
+}
+//# sourceMappingURL=project-lock.js.map

package/dist/adapters/filesystem/project-lock.js.map

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

package/dist/adapters/filesystem/project-paths.d.ts

@@ -0,0 +1,2 @@
+export declare function artifactPath(root: string, pathParts: string[]): string;
+export declare function resolveProjectPath(projectRoot: string, pathParts: string[]): Promise<string>;

package/dist/adapters/filesystem/project-paths.js

@@ -0,0 +1,60 @@
+import { lstat, realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { FileSystemError } from '../../domain/project/errors.js';
+import { validateArtifactPathParts } from '../../domain/project/paths.js';
+import { errorCode, errorMessage } from './errors.js';
+function isPathWithin(root, candidate) {
+    const relative = path.relative(root, candidate);
+    return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
+}
+export function artifactPath(root, pathParts) {
+    const validated = validateArtifactPathParts(pathParts);
+    const joinedPath = path.join(root, ...validated);
+    const resolvedRoot = path.resolve(root);
+    const resolvedPath = path.resolve(joinedPath);
+    if (!isPathWithin(resolvedRoot, resolvedPath) || resolvedPath === resolvedRoot) {
+        throw new FileSystemError(`Artifact path escapes project root: ${validated.join('/')}`);
+    }
+    return joinedPath;
+}
+export async function resolveProjectPath(projectRoot, pathParts) {
+    const validated = validateArtifactPathParts(pathParts);
+    const resolvedRoot = path.resolve(projectRoot);
+    const targetPath = artifactPath(resolvedRoot, validated);
+    let realRoot;
+    try {
+        realRoot = await realpath(resolvedRoot);
+    }
+    catch (error) {
+        throw new FileSystemError(`Unable to resolve project root ${resolvedRoot}: ${errorMessage(error)}`);
+    }
+    let current = resolvedRoot;
+    for (const [index, part] of validated.entries()) {
+        current = path.join(current, part);
+        let details;
+        try {
+            details = await lstat(current);
+        }
+        catch (error) {
+            if (errorCode(error) === 'ENOENT') {
+                return targetPath;
+            }
+            throw new FileSystemError(`Unable to inspect artifact path ${validated.join('/')}: ${errorMessage(error)}`);
+        }
+        let resolvedExistingPath;
+        try {
+            resolvedExistingPath = await realpath(current);
+        }
+        catch (error) {
+            throw new FileSystemError(`Unable to resolve artifact path ${validated.join('/')}: ${errorMessage(error)}`);
+        }
+        if (!isPathWithin(realRoot, resolvedExistingPath)) {
+            throw new FileSystemError(`Artifact path escapes project root through a symlink: ${validated.join('/')}`);
+        }
+        if (index < validated.length - 1 && !details.isDirectory() && !details.isSymbolicLink()) {
+            throw new FileSystemError(`Artifact path parent is not a directory: ${validated.slice(0, index + 1).join('/')}`);
+        }
+    }
+    return targetPath;
+}
+//# sourceMappingURL=project-paths.js.map

package/dist/adapters/filesystem/project-paths.js.map

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

package/dist/adapters/filesystem/project-transaction.d.ts

@@ -0,0 +1,24 @@
+import { FileSystemError } from '../../domain/project/errors.js';
+export type ProjectFileMutation = {
+    type: 'write';
+    pathParts: string[];
+    content: string | Buffer;
+    mode?: number;
+} | {
+    type: 'delete';
+    pathParts: string[];
+};
+export declare class ProjectFileTransactionError extends FileSystemError {
+    readonly rollbackFailures: readonly string[];
+    constructor(message: string, rollbackFailures: readonly string[]);
+}
+export interface ProjectFileSnapshot {
+    pathParts: string[];
+    content?: Buffer;
+    mode?: number;
+}
+export declare function captureProjectFileSnapshot(projectRoot: string, pathParts: string[]): Promise<ProjectFileSnapshot>;
+export declare function applyProjectFileTransaction(projectRoot: string, mutations: readonly ProjectFileMutation[], options?: {
+    onBeforeMutation?: (mutation: ProjectFileMutation, index: number) => Promise<void>;
+    preconditions?: readonly ProjectFileSnapshot[];
+}): Promise<void>;

package/dist/adapters/filesystem/project-transaction.js

@@ -0,0 +1,177 @@
+import { chmod, lstat, readFile, rmdir } from 'node:fs/promises';
+import { FileSystemError } from '../../domain/project/errors.js';
+import { writeProjectFile, deleteProjectFile } from './project-files.js';
+import { resolveProjectPath } from './project-paths.js';
+import { withProjectMutationLock } from './project-lock.js';
+import { errorCode, errorMessage } from './errors.js';
+export class ProjectFileTransactionError extends FileSystemError {
+    rollbackFailures;
+    constructor(message, rollbackFailures) {
+        super(message);
+        this.rollbackFailures = rollbackFailures;
+        this.name = 'ProjectFileTransactionError';
+    }
+}
+export async function captureProjectFileSnapshot(projectRoot, pathParts) {
+    const targetPath = await resolveProjectPath(projectRoot, pathParts);
+    try {
+        const details = await lstat(targetPath);
+        if (!details.isFile()) {
+            throw new FileSystemError(`Project update target must be a regular file: ${pathParts.join('/')}`);
+        }
+        return {
+            pathParts,
+            content: await readFile(targetPath),
+            mode: details.mode & 0o7777
+        };
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT') {
+            return { pathParts };
+        }
+        throw error;
+    }
+}
+async function assertProjectFileSnapshot(projectRoot, snapshot) {
+    const current = await captureProjectFileSnapshot(projectRoot, snapshot.pathParts);
+    if ((snapshot.content === undefined) !== (current.content === undefined) ||
+        snapshot.mode !== current.mode ||
+        snapshot.content?.equals(current.content) === false) {
+        throw new FileSystemError(`Project update target changed after review: ${snapshot.pathParts.join('/')}`);
+    }
+}
+async function assertAppliedMutationCurrent(projectRoot, mutation, expectedMode) {
+    const current = await captureProjectFileSnapshot(projectRoot, mutation.pathParts);
+    if (mutation.type === 'delete') {
+        if (current.content !== undefined) {
+            throw new FileSystemError(`Project update target changed before rollback: ${mutation.pathParts.join('/')}`);
+        }
+        return;
+    }
+    if (current.content === undefined ||
+        !current.content.equals(typeof mutation.content === 'string' ? Buffer.from(mutation.content, 'utf8') : mutation.content) ||
+        expectedMode !== undefined && current.mode !== expectedMode) {
+        throw new FileSystemError(`Project update target changed before rollback: ${mutation.pathParts.join('/')}`);
+    }
+}
+async function missingMutationParents(projectRoot, pathParts) {
+    const missing = [];
+    for (let index = 1; index < pathParts.length; index += 1) {
+        const parentParts = pathParts.slice(0, index);
+        const parentPath = await resolveProjectPath(projectRoot, parentParts);
+        try {
+            const details = await lstat(parentPath);
+            if (!details.isDirectory() && !details.isSymbolicLink()) {
+                throw new FileSystemError(`Artifact path parent is not a directory: ${parentParts.join('/')}`);
+            }
+        }
+        catch (error) {
+            if (errorCode(error) === 'ENOENT') {
+                missing.push(parentParts);
+                continue;
+            }
+            throw error;
+        }
+    }
+    return missing;
+}
+export async function applyProjectFileTransaction(projectRoot, mutations, options = {}) {
+    return withProjectMutationLock(projectRoot, async (lease) => {
+        const snapshots = new Map();
+        const preconditions = new Map();
+        const missingParents = new Map();
+        for (const snapshot of options.preconditions ?? []) {
+            const key = snapshot.pathParts.join('\0');
+            if (preconditions.has(key)) {
+                throw new FileSystemError(`Project update contains duplicate preconditions for ${snapshot.pathParts.join('/')}.`);
+            }
+            preconditions.set(key, snapshot);
+        }
+        for (const mutation of mutations) {
+            if (mutation.type === 'write' && mutation.mode !== undefined &&
+                (!Number.isInteger(mutation.mode) || mutation.mode < 0 || mutation.mode > 0o7777)) {
+                throw new FileSystemError(`Invalid project update mode for ${mutation.pathParts.join('/')}.`);
+            }
+            const key = mutation.pathParts.join('\0');
+            if (snapshots.has(key)) {
+                throw new FileSystemError(`Project update contains duplicate mutations for ${mutation.pathParts.join('/')}.`);
+            }
+            snapshots.set(key, preconditions.get(key) ??
+                await captureProjectFileSnapshot(projectRoot, mutation.pathParts));
+            if (mutation.type === 'write') {
+                for (const parentParts of await missingMutationParents(projectRoot, mutation.pathParts)) {
+                    missingParents.set(parentParts.join('\0'), parentParts);
+                }
+            }
+        }
+        for (const snapshot of preconditions.values()) {
+            await assertProjectFileSnapshot(projectRoot, snapshot);
+        }
+        const applied = [];
+        try {
+            for (const [index, mutation] of mutations.entries()) {
+                await options.onBeforeMutation?.(mutation, index);
+                await lease.assertHeld();
+                await assertProjectFileSnapshot(projectRoot, snapshots.get(mutation.pathParts.join('\0')));
+                if (mutation.type === 'write') {
+                    const originalMode = snapshots.get(mutation.pathParts.join('\0')).mode;
+                    const createdMode = 0o666 & ~process.umask();
+                    const appliedMutation = {
+                        mutation,
+                        mode: originalMode ?? (mutation.mode === undefined ? undefined
+                            : process.platform === 'win32' ? (createdMode & 0o200 ? 0o666 : 0o444) : createdMode)
+                    };
+                    await writeProjectFile(projectRoot, mutation.pathParts, mutation.content);
+                    applied.push(appliedMutation);
+                    if (mutation.mode !== undefined) {
+                        await lease.assertHeld();
+                        await assertAppliedMutationCurrent(projectRoot, mutation, appliedMutation.mode);
+                        await chmod(await resolveProjectPath(projectRoot, mutation.pathParts), mutation.mode);
+                        appliedMutation.mode = process.platform === 'win32'
+                            ? (mutation.mode & 0o200 ? 0o666 : 0o444) : mutation.mode;
+                    }
+                }
+                else {
+                    await deleteProjectFile(projectRoot, mutation.pathParts);
+                    applied.push({ mutation });
+                }
+            }
+        }
+        catch (error) {
+            const rollbackFailures = [];
+            for (const { mutation, mode } of [...applied].reverse()) {
+                const snapshot = snapshots.get(mutation.pathParts.join('\0'));
+                try {
+                    await assertAppliedMutationCurrent(projectRoot, mutation, mode);
+                    if (snapshot.content === undefined) {
+                        await deleteProjectFile(projectRoot, mutation.pathParts);
+                    }
+                    else {
+                        await writeProjectFile(projectRoot, mutation.pathParts, snapshot.content);
+                        await chmod(await resolveProjectPath(projectRoot, mutation.pathParts), snapshot.mode);
+                    }
+                }
+                catch (rollbackError) {
+                    rollbackFailures.push(`${mutation.pathParts.join('/')}: ${errorMessage(rollbackError)}`);
+                }
+            }
+            const parents = [...missingParents.values()]
+                .sort((left, right) => right.length - left.length);
+            for (const parentParts of parents) {
+                try {
+                    await rmdir(await resolveProjectPath(projectRoot, parentParts));
+                }
+                catch (rollbackError) {
+                    if (errorCode(rollbackError) !== 'ENOENT') {
+                        rollbackFailures.push(`${parentParts.join('/')}: ${errorMessage(rollbackError)}`);
+                    }
+                }
+            }
+            const rollbackDetail = rollbackFailures.length === 0
+                ? 'All applied changes were rolled back.'
+                : `Rollback was incomplete:\n${rollbackFailures.map((failure) => `- ${failure}`).join('\n')}`;
+            throw new ProjectFileTransactionError(`Project update failed: ${errorMessage(error)} ${rollbackDetail}`, rollbackFailures);
+        }
+    });
+}
+//# sourceMappingURL=project-transaction.js.map

package/dist/adapters/filesystem/project-transaction.js.map

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

package/dist/adapters/filesystem/reviewed-update-transaction.d.ts

@@ -0,0 +1,53 @@
+import { ProjectFileTransactionError } from './project-transaction.js';
+import type { ProjectFileMutation, ProjectFileSnapshot } from './project-transaction.js';
+export { reviewedUpdateTransactionPathParts, reviewedUpdateTransactionSchemaVersion } from '../../domain/project/reviewed-update-artifacts.js';
+export interface ReviewedUpdateApprovalStore {
+    write(planFingerprint: string, transactionDigest: string): Promise<void>;
+    verify(planFingerprint: string, transactionDigest: string): Promise<boolean>;
+    remove(planFingerprint: string, transactionDigest: string): Promise<void>;
+}
+export interface ReviewedUpdateTransactionCheckpoint {
+    phase: 'prepared' | 'before-mutation' | 'staged' | 'after-mutation' | 'before-commit' | 'committed';
+    index?: number;
+}
+export interface ReviewedUpdateTransactionOptions {
+    planFingerprint: string;
+    approvalStore: ReviewedUpdateApprovalStore;
+    preconditions?: readonly ProjectFileSnapshot[];
+    validatePlan?: () => Promise<void>;
+    onBeforeMutation?: (mutation: ProjectFileMutation, index: number) => Promise<void>;
+    onCheckpoint?: (checkpoint: ReviewedUpdateTransactionCheckpoint) => Promise<void>;
+}
+export interface ReviewedUpdateRecoveryOptions {
+    approvalStore?: ReviewedUpdateApprovalStore;
+}
+export interface ReviewedUpdateTransactionDestination {
+    pathParts: string[];
+    attempted: boolean;
+    disposition: 'original' | 'target' | 'changed';
+}
+export interface ReviewedUpdateTransactionInspection {
+    status: 'absent' | 'interrupted' | 'committed' | 'blocked';
+    committed: boolean;
+    journalPath: string;
+    planFingerprint?: string;
+    transactionDigest?: string;
+    reason?: string;
+    destinations: ReviewedUpdateTransactionDestination[];
+}
+export interface ReviewedUpdateTransactionOutcome {
+    status: 'absent' | 'rolled-back' | 'committed' | 'blocked';
+    committed: boolean;
+    planFingerprint?: string;
+    transactionDigest?: string;
+    rollbackFailures: string[];
+    cleanupFailures: string[];
+}
+export declare class ReviewedUpdateTransactionError extends ProjectFileTransactionError {
+    readonly committed = false;
+    constructor(message: string, rollbackFailures?: readonly string[]);
+}
+export declare function reviewedUpdateTargetMode(mode: number | undefined, originalMode?: number): number;
+export declare function inspectReviewedUpdateTransaction(projectRoot: string, options?: ReviewedUpdateRecoveryOptions): Promise<ReviewedUpdateTransactionInspection>;
+export declare function recoverReviewedUpdateTransaction(projectRoot: string, options?: ReviewedUpdateRecoveryOptions): Promise<ReviewedUpdateTransactionOutcome>;
+export declare function applyReviewedUpdateTransaction(projectRoot: string, mutations: readonly ProjectFileMutation[], options: ReviewedUpdateTransactionOptions): Promise<ReviewedUpdateTransactionOutcome>;