@msn-control/liftoff 0.10.4 → 0.11.2

package/dist/application/update/transaction-approval.js

@@ -0,0 +1,82 @@
+import { canonicalSha256, isRecord } from '../../domain/governance/activation/canonical-json.js';
+import { normalizeUpdatePreviewProjectRoot, updatePreviewProjectKey } from './preview.js';
+export const updateTransactionApprovalSchemaVersion = 1;
+export class UpdateTransactionApprovalError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'UpdateTransactionApprovalError';
+    }
+}
+function invalid(message) {
+    throw new UpdateTransactionApprovalError(message);
+}
+export function validateUpdateTransactionApprovalDigests(planFingerprint, transactionDigest) {
+    if (typeof planFingerprint !== 'string' || !/^[0-9a-f]{64}$/u.test(planFingerprint) ||
+        typeof transactionDigest !== 'string' || !/^[0-9a-f]{64}$/u.test(transactionDigest)) {
+        invalid('Transaction approval requires complete lowercase SHA-256 plan and transaction digests.');
+    }
+}
+function bindingFields(binding) {
+    validateUpdateTransactionApprovalDigests(binding.planFingerprint, binding.transactionDigest);
+    const projectRoot = normalizeUpdatePreviewProjectRoot(binding.projectRoot);
+    return {
+        schemaVersion: updateTransactionApprovalSchemaVersion,
+        kind: 'liftoff-update-transaction-approval',
+        projectRoot,
+        projectKey: updatePreviewProjectKey(projectRoot),
+        planFingerprint: binding.planFingerprint,
+        transactionDigest: binding.transactionDigest
+    };
+}
+export function updateTransactionApprovalKey(binding) {
+    return canonicalSha256(bindingFields(binding));
+}
+export function createUpdateTransactionApprovalSeal(binding, issuance) {
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u.test(issuance.approvalId)) {
+        invalid('Transaction approvalId must be a lowercase UUID.');
+    }
+    const time = Date.parse(issuance.approvedAt);
+    if (!Number.isFinite(time) || new Date(time).toISOString() !== issuance.approvedAt) {
+        invalid('Transaction approvedAt must be an ISO UTC timestamp.');
+    }
+    return Object.freeze({
+        ...bindingFields(binding),
+        approvalId: issuance.approvalId,
+        approvedAt: issuance.approvedAt
+    });
+}
+export function validateUpdateTransactionApprovalSeal(value, expected, now) {
+    if (!isRecord(value))
+        invalid('Transaction approval seal must be an object.');
+    if (value.schemaVersion !== updateTransactionApprovalSchemaVersion) {
+        invalid('Unsupported or missing transaction approval schema; expected schema 1.');
+    }
+    const keys = [
+        'schemaVersion', 'kind', 'projectRoot', 'projectKey', 'planFingerprint', 'transactionDigest', 'approvalId', 'approvedAt'
+    ];
+    if (Object.keys(value).length !== keys.length || keys.some((key) => !Object.hasOwn(value, key))) {
+        invalid('Transaction approval seal has missing or unrecognized fields.');
+    }
+    if (value.kind !== 'liftoff-update-transaction-approval' || typeof value.projectRoot !== 'string' ||
+        typeof value.planFingerprint !== 'string' || typeof value.transactionDigest !== 'string' ||
+        typeof value.approvalId !== 'string' || typeof value.approvedAt !== 'string') {
+        invalid('Invalid transaction approval seal; a preview receipt is not approval.');
+    }
+    const seal = createUpdateTransactionApprovalSeal({
+        projectRoot: value.projectRoot,
+        planFingerprint: value.planFingerprint,
+        transactionDigest: value.transactionDigest
+    }, { approvalId: value.approvalId, approvedAt: value.approvedAt });
+    if (seal.projectRoot !== value.projectRoot || seal.projectKey !== value.projectKey) {
+        invalid('Transaction approval seal has an inconsistent canonical project identity.');
+    }
+    if (seal.projectRoot !== normalizeUpdatePreviewProjectRoot(expected.projectRoot) ||
+        seal.planFingerprint !== expected.planFingerprint || seal.transactionDigest !== expected.transactionDigest) {
+        invalid('Transaction approval seal does not match this project, plan, and exact transaction digest.');
+    }
+    if (!Number.isFinite(now.getTime()) || Date.parse(seal.approvedAt) > now.getTime()) {
+        invalid('Transaction approval is dated in the future or the current clock is invalid.');
+    }
+    return seal;
+}
+//# sourceMappingURL=transaction-approval.js.map

package/dist/application/update/transaction-approval.js.map

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

package/dist/application/update/use-case.d.ts

@@ -0,0 +1,9 @@
+import type { ExecutionContext } from '../context.js';
+export interface UpdateRequest {
+    check: boolean;
+    force: boolean;
+    jsonMode: boolean;
+    project?: string;
+    approvePlan?: string;
+}
+export declare function updateProject(request: UpdateRequest, context: ExecutionContext): Promise<number>;

package/dist/application/update/use-case.js

@@ -0,0 +1,271 @@
+import path from 'node:path';
+import { consumeUpdatePreviewReceipt, createUpdateTransactionApprovalStore, issueUpdatePreviewReceipt, loadUpdatePreviewReceipt, resolveUpdatePreviewLocation } from '../../adapters/filesystem/update-previews.js';
+import { applyReviewedUpdateTransaction, inspectReviewedUpdateTransaction, recoverReviewedUpdateTransaction } from '../../adapters/filesystem/reviewed-update-transaction.js';
+import { findProjectRoot } from '../../adapters/filesystem/project-discovery.js';
+import { manifestDisplayPath } from '../../domain/project/paths.js';
+import { loadManifest } from '../project/manifest.js';
+import { requestUpdateApproval } from './approval.js';
+import { formatUpdateCommand, formatUpdateValidationCommands } from './command-guidance.js';
+import { inspectProjectUpdate, UpdatePlanError } from './inspection.js';
+import { buildUpdateReport, renderUpdateApprovalScope, renderUpdatePreview, renderUpdateSkipped } from './output.js';
+import { assertAuthorizedUpdateMutations, preflightUpdate } from './planning.js';
+import { matchUpdatePreviewReceipt, UpdatePreviewError } from './preview.js';
+import { prepareUpdateReview } from './review-plan.js';
+import { entryDisplay, maybeInjectUpdateFailure } from './reporting.js';
+import { describeUpdateMigration, describeUpdateRevalidation, materializeUpdateMutations, runUpdateRevalidation, verifyHistoryBeforeReplacement } from './migration-runtime.js';
+function storeOptions(context, inspection) {
+    return {
+        ...context.updatePreview,
+        env: context.updatePreview?.env ?? context.env,
+        clock: context.updatePreview?.clock ?? context.updateNow,
+        ...(inspection?.repositoryRoot ? { repositoryRoot: inspection.repositoryRoot } : {})
+    };
+}
+function emit(context, jsonMode, report, inspection, review) {
+    if (jsonMode) {
+        context.presentation.rawStdout(`${JSON.stringify(buildUpdateReport(report, inspection, review?.writePlan), null, 2)}\n`);
+    }
+    else if (report.message) {
+        if (report.status === 'blocked' || report.status === 'failed') {
+            context.presentation.error(report.message, report.remedy);
+        }
+        else {
+            context.presentation.status(report.status === 'partial' ? 'warning' : 'success', 'Project update', report.message);
+            if (report.remedy)
+                context.presentation.remedy(report.remedy);
+        }
+    }
+}
+export async function updateProject(request, context) {
+    const { presentation } = context;
+    const { check, force, jsonMode } = request;
+    presentation.commandIdentity('update', 'Preview and explicitly approve scoped project updates');
+    let projectRoot = request.project ? path.resolve(context.cwd, request.project) : context.cwd;
+    let inspection;
+    let selected;
+    let committed = false;
+    let migration;
+    let revalidation;
+    try {
+        if (check && (force || request.approvePlan !== undefined)) {
+            throw new UpdatePlanError('--check cannot be combined with --force or --approve-plan.', 'invalid-update-options', `Run ${formatUpdateCommand(projectRoot, 'check')} before explicitly approving an apply plan.`);
+        }
+        const discovered = request.project ? projectRoot : await findProjectRoot(context.cwd);
+        if (!discovered) {
+            throw new UpdatePlanError(`No liftoff.manifest.json found in ${context.cwd} or any parent directory.`, 'project-not-found', 'Run inside a Liftoff project or supply its path.');
+        }
+        projectRoot = discovered;
+        await loadManifest(projectRoot);
+        const initialOptions = storeOptions(context);
+        const approvalStore = createUpdateTransactionApprovalStore(projectRoot, initialOptions);
+        const recovery = await inspectReviewedUpdateTransaction(projectRoot, { approvalStore });
+        if (recovery.status !== 'absent') {
+            if (check || recovery.status === 'blocked') {
+                emit(context, jsonMode, {
+                    mode: check ? 'check' : 'apply', status: 'blocked',
+                    reasonCode: 'transaction-recovery-required', projectRoot, committed: recovery.committed,
+                    message: recovery.reason ?? 'An interrupted approved update requires bounded recovery.',
+                    remedy: `Review the reported transaction and run ${formatUpdateCommand(projectRoot)} for recovery; then run ${formatUpdateCommand(projectRoot, 'check')}.`
+                });
+                return 1;
+            }
+            const outcome = await recoverReviewedUpdateTransaction(projectRoot, { approvalStore });
+            emit(context, jsonMode, {
+                mode: 'apply', status: outcome.status === 'blocked' ? 'failed' : 'partial',
+                reasonCode: 'transaction-recovery', projectRoot, committed: outcome.committed,
+                message: outcome.status === 'blocked'
+                    ? outcome.rollbackFailures.join('; ')
+                    : 'Recovered the previously approved transaction; no new update was started.',
+                warnings: outcome.cleanupFailures,
+                remedy: `Run ${formatUpdateCommand(projectRoot, 'check')} before approving new work.`
+            });
+            return outcome.status === 'blocked' ? 1 : 2;
+        }
+        inspection = await inspectProjectUpdate(projectRoot, { runner: context.runner });
+        projectRoot = inspection.projectRoot;
+        const options = storeOptions(context, inspection);
+        const reviewOptions = { runner: context.runner, now: context.updateNow?.() ?? new Date() };
+        const normal = await prepareUpdateReview(inspection, false, reviewOptions);
+        const forced = await prepareUpdateReview(inspection, true, reviewOptions);
+        const variants = [normal, forced];
+        const hasWork = inspection.hasDrift || variants.some((entry) => entry.requiresApproval);
+        const plans = hasWork ? variants.map((entry) => entry.summary) : [];
+        selected = force ? forced : normal;
+        migration = describeUpdateMigration(inspection);
+        committed = migration.status === 'committed';
+        revalidation = describeUpdateRevalidation(selected);
+        const base = {
+            mode: check ? 'check' : 'apply', projectRoot,
+            plans, selectedPlanFingerprint: selected.descriptor.fingerprint, migration, revalidation
+        };
+        if (!selected.summary.eligible && (!check || !variants.some((entry) => entry.summary.eligible))) {
+            emit(context, jsonMode, {
+                ...base, status: 'blocked', reasonCode: 'incompatible-update',
+                message: selected.summary.blockers.join('; '),
+                remedy: inspection.reconciliation.remedy
+            }, inspection, selected);
+            return 1;
+        }
+        if (check) {
+            const stored = hasWork
+                ? await issueUpdatePreviewReceipt(projectRoot, variants.filter((entry) => entry.summary.eligible).map((entry) => entry.descriptor), options)
+                : undefined;
+            if (!jsonMode) {
+                renderUpdatePreview(presentation, inspection, plans, migration, revalidation, stored?.location.receiptPath);
+                if (!hasWork) {
+                    presentation.status('success', 'Liftoff core is current', `${inspection.summary.unchanged} managed-core artifacts match; project files are not compared`);
+                }
+                else {
+                    presentation.status('warning', 'Liftoff core maintenance available', `${inspection.summary.conflict + inspection.summary.retiredConflict} core conflict(s); review the exact plans before approval`);
+                }
+            }
+            emit(context, jsonMode, {
+                ...base,
+                status: hasWork ? 'update-available' : 'current',
+                reasonCode: hasWork ? 'review-required' : 'no-update',
+                receipt: stored ? { status: 'issued', path: stored.location.receiptPath } : { status: 'not-required' }
+            }, inspection, selected);
+            return hasWork ? 2 : 0;
+        }
+        if (!selected.requiresApproval) {
+            if (!jsonMode)
+                renderUpdateSkipped(presentation, inspection, selected.writePlan);
+            emit(context, jsonMode, {
+                ...base, status: selected.writePlan.skipped.length ? 'partial' : 'current', reasonCode: 'no-update',
+                message: selected.writePlan.skipped.length
+                    ? 'No safe update writes are required; listed conflicts remain protected.'
+                    : 'Liftoff core is current; project files were not changed.'
+            }, inspection, selected);
+            return 0;
+        }
+        const location = await resolveUpdatePreviewLocation(projectRoot, options);
+        const stored = await loadUpdatePreviewReceipt(projectRoot, options);
+        matchUpdatePreviewReceipt(stored.receipt, selected.descriptor);
+        if (inspection.repositoryRoot) {
+            const warning = 'If this worktree has uncommitted changes, consider committing or copying them before applying. Liftoff does not commit automatically.';
+            if (jsonMode)
+                presentation.rawStderr(`Warning: ${warning}\n`);
+            else
+                presentation.warning(warning);
+        }
+        renderUpdateApprovalScope(presentation, jsonMode, selected.summary, selected.writePlan, migration, revalidation);
+        const approval = await requestUpdateApproval({
+            fingerprint: selected.descriptor.fingerprint, approvePlan: request.approvePlan
+        }, context);
+        if (approval.status !== 'approved') {
+            emit(context, jsonMode, {
+                ...base, status: 'blocked', reasonCode: `approval-${approval.status}`,
+                receipt: { status: 'matched', path: location.receiptPath }, approval,
+                message: approval.status === 'required'
+                    ? 'Explicit approval of this exact update plan is required.'
+                    : approval.status === 'mismatch'
+                        ? 'The approved fingerprint does not match the current effective plan.'
+                        : 'Update approval was declined or cancelled; no project files changed.',
+                remedy: `Review ${formatUpdateCommand(projectRoot, 'check')}, then approve interactively or use --approve-plan with its exact fingerprint.`
+            }, inspection, selected);
+            return 1;
+        }
+        presentation.stage('Apply safe Liftoff core changes', projectRoot);
+        await preflightUpdate(projectRoot, inspection.entries, force, inspection.oldByName);
+        maybeInjectUpdateFailure(context.env, 'after-preflight');
+        const materialized = materializeUpdateMutations(inspection, selected, context.updateNow?.() ?? new Date());
+        const migrationPaths = inspection.historyMigration.status === 'eligible'
+            ? [
+                ...inspection.historyMigration.index.files.map((file) => file.copyPathParts),
+                ...inspection.historyMigration.requiredRetirements.map((entry) => entry.pathParts),
+                ['governance', 'history', inspection.historyMigration.index.snapshotId, 'index.json'],
+                ['governance', 'activation-state.json'], ['governance', 'migration-state.json']
+            ]
+            : [];
+        assertAuthorizedUpdateMutations(materialized.mutations, inspection.entries, inspection.provisioningPlans, [
+            ...inspection.stateMigration.mutations.map((mutation) => mutation.pathParts),
+            ...migrationPaths
+        ]);
+        const approvedFingerprint = selected.descriptor.fingerprint;
+        const validateReview = async () => {
+            const current = await prepareUpdateReview(await inspectProjectUpdate(projectRoot, { runner: context.runner }), force, { runner: context.runner, now: context.updateNow?.() ?? new Date() });
+            if (!current.summary.eligible || current.descriptor.fingerprint !== approvedFingerprint) {
+                throw new UpdatePlanError('The effective update plan changed after review.', 'preview-mismatch', `Run ${formatUpdateCommand(projectRoot, 'check')} again.`);
+            }
+        };
+        const cleanupFailures = [];
+        if (materialized.mutations.length) {
+            const activeInspection = inspection;
+            const outcome = await applyReviewedUpdateTransaction(projectRoot, materialized.mutations, {
+                planFingerprint: approvedFingerprint,
+                approvalStore: createUpdateTransactionApprovalStore(projectRoot, options),
+                preconditions: selected.preconditions,
+                validatePlan: validateReview,
+                onBeforeMutation: async (mutation, index) => {
+                    maybeInjectUpdateFailure(context.env, `before-mutation:${index}`);
+                    maybeInjectUpdateFailure(context.env, `before-path:${mutation.pathParts.join('/')}`);
+                    await verifyHistoryBeforeReplacement(activeInspection, mutation);
+                }
+            });
+            committed = outcome.committed;
+            cleanupFailures.push(...outcome.cleanupFailures);
+            if (!committed) {
+                throw new UpdatePlanError(outcome.rollbackFailures.join('; ') || 'The approved update did not commit.', 'transaction-failed', 'Review the recovery details before running a new check.');
+            }
+            if (migration.status === 'available')
+                migration = { ...migration, status: 'committed' };
+        }
+        if (selected.needsRevalidation && !cleanupFailures.length) {
+            revalidation = await runUpdateRevalidation(inspection, selected, context, materialized.mutations.length ? undefined : validateReview);
+        }
+        await consumeUpdatePreviewReceipt(projectRoot, stored.receipt, options);
+        const revalidationBlocked = revalidation.status === 'blocked';
+        const partial = revalidationBlocked || selected.writePlan.skipped.length > 0 ||
+            inspection.provisioningPlans.some((group) => group.blocked);
+        emit(context, jsonMode, {
+            ...base, migration, revalidation,
+            status: cleanupFailures.length ? 'failed' : partial ? 'partial' : 'applied',
+            reasonCode: cleanupFailures.length ? 'transaction-cleanup' :
+                revalidationBlocked ? 'revalidation-blocked' : 'approved-update-applied',
+            receipt: { status: 'consumed', path: location.receiptPath }, approval, committed,
+            warnings: cleanupFailures
+        }, inspection, selected);
+        if (!jsonMode) {
+            if (selected.writePlan.written.length) {
+                presentation.bullets('Applied Liftoff core changes', selected.writePlan.written.map((entry) => `wrote ${entryDisplay(entry)}`));
+            }
+            if (selected.writePlan.retired.length) {
+                presentation.bullets('Removed retired Liftoff aliases', selected.writePlan.retired.map((entry) => `removed ${manifestDisplayPath(entry.pathParts)}`));
+            }
+            renderUpdateSkipped(presentation, inspection, selected.writePlan);
+            if (migration.status === 'committed') {
+                presentation.status('success', 'Activation migration committed', 'Original v1 history remains preserved; active v2 readiness is reported separately.');
+            }
+            if (revalidationBlocked) {
+                presentation.bullets('V2 revalidation is blocked and resumable', [
+                    ...revalidation.issues,
+                    ...(revalidation.nextPhase ? [`Next incomplete phase: ${revalidation.nextPhase}`] : []),
+                    `Repair the blocker, run ${formatUpdateCommand(projectRoot, 'check')}, and approve the remaining local work.`
+                ]);
+            }
+            for (const failure of cleanupFailures)
+                presentation.error(failure);
+            if (!cleanupFailures.length && !revalidationBlocked) {
+                presentation.completion('Updated project', `${selected.writePlan.written.length} core written, ${selected.writePlan.skipped.length} core skipped`, [], formatUpdateValidationCommands(projectRoot));
+            }
+        }
+        return cleanupFailures.length ? 1 : revalidationBlocked ? 2 : 0;
+    }
+    catch (error) {
+        const reasonCode = error instanceof UpdatePlanError ? error.reasonCode :
+            error instanceof UpdatePreviewError ? error.code : 'update-failed';
+        const detail = error instanceof Error ? error.message : String(error);
+        const message = error instanceof UpdatePreviewError && !committed
+            ? `${detail} No new project update was performed.` : detail;
+        const remedy = error instanceof UpdatePlanError ? error.remedy :
+            error instanceof UpdatePreviewError
+                ? `Repair any reported preview-storage issue, then run ${formatUpdateCommand(projectRoot, 'check')} before applying.`
+                : `Review the reported failure. Preserve concurrent edits and run ${formatUpdateCommand(projectRoot, 'check')} after repair.`;
+        emit(context, jsonMode, {
+            mode: check ? 'check' : 'apply', status: 'failed', reasonCode, projectRoot,
+            committed, message, remedy, migration, revalidation
+        }, inspection, selected);
+        return 1;
+    }
+}
+//# sourceMappingURL=use-case.js.map

package/dist/application/update/use-case.js.map

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

package/dist/application/update/write-plan.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectFileMutation } from '../../adapters/filesystem/project-transaction.js';
+import type { ReconcileEntry } from '../../reconcile.js';
+import { type ProvisioningEntry } from './planning.js';
+import { type UpdateInspection } from './inspection.js';
+export declare function planUpdateWrites(inspection: UpdateInspection, force: boolean): {
+    force: boolean;
+    mutations: ProjectFileMutation[];
+    nextManifest: import("../../types.js").LiftoffManifest;
+    written: ReconcileEntry[];
+    retired: ReconcileEntry[];
+    skipped: ReconcileEntry[];
+    provisioned: ProvisioningEntry[];
+    hasWrites: boolean;
+};
+export type UpdateWritePlan = ReturnType<typeof planUpdateWrites>;

package/dist/application/update/write-plan.js

@@ -0,0 +1,115 @@
+import { canonicalSha256 } from '../../domain/governance/activation/canonical-json.js';
+import { parseManifest } from '../project/manifest.js';
+import { buildManifest } from '../../templates.js';
+import { appendProvisionedProjectArtifacts, isUnownedUpdateConflict } from './planning.js';
+import { preserveDiagnosticGovernanceIdentity } from './inspection.js';
+export function planUpdateWrites(inspection, force) {
+    const { manifest, entries, oldByName, provisioningPlans, plan, renderPlan, render } = inspection;
+    const written = [];
+    const retired = [];
+    const skipped = [];
+    const mutations = [];
+    for (const entry of entries) {
+        switch (entry.status) {
+            case 'new':
+            case 'missing':
+            case 'upgrade':
+                mutations.push({ type: 'write', pathParts: entry.pathParts, content: entry.rendered.content });
+                written.push(entry);
+                break;
+            case 'moved':
+                if (!isUnownedUpdateConflict(entry, oldByName) && (entry.cleanMove || force)) {
+                    if (!entry.destinationMatches) {
+                        mutations.push({ type: 'write', pathParts: entry.pathParts, content: entry.rendered.content });
+                    }
+                    mutations.push({ type: 'delete', pathParts: entry.previousPathParts });
+                    written.push(entry);
+                }
+                else
+                    skipped.push(entry);
+                break;
+            case 'retired':
+            case 'retired-conflict':
+                if (entry.status === 'retired' || force) {
+                    if (entry.destinationOccupied !== false) {
+                        mutations.push({ type: 'delete', pathParts: entry.pathParts });
+                    }
+                    retired.push(entry);
+                }
+                else
+                    skipped.push(entry);
+                break;
+            case 'conflict':
+                if (force && !isUnownedUpdateConflict(entry, oldByName)) {
+                    mutations.push({ type: 'write', pathParts: entry.pathParts, content: entry.rendered.content });
+                    if (entry.previousPathParts)
+                        mutations.push({ type: 'delete', pathParts: entry.previousPathParts });
+                    written.push(entry);
+                }
+                else
+                    skipped.push(entry);
+                break;
+        }
+    }
+    const provisioned = [];
+    for (const group of provisioningPlans) {
+        if (group.blocked)
+            continue;
+        for (const entry of group.entries) {
+            if (entry.status === 'create') {
+                mutations.push({ type: 'write', pathParts: entry.rendered.pathParts, content: entry.rendered.content });
+            }
+            provisioned.push(entry);
+        }
+    }
+    mutations.push(...inspection.stateMigration.mutations);
+    const nextManifest = buildManifest(renderPlan, render.filter((artifact) => artifact.logicalName !== 'manifest'), {
+        frameworkState: manifest.framework.state,
+        projectArtifacts: appendProvisionedProjectArtifacts(manifest.projectArtifacts, provisioningPlans)
+    });
+    nextManifest.framework = manifest.framework;
+    nextManifest.project.specWorkflow = manifest.project.specWorkflow;
+    nextManifest.project.agents = manifest.project.agents;
+    if (manifest.project.defaultAgent)
+        nextManifest.project.defaultAgent = manifest.project.defaultAgent;
+    else
+        delete nextManifest.project.defaultAgent;
+    const partialHandoff = skipped.some((entry) => entry.status === 'retired-conflict' ||
+        entry.status === 'conflict' && entry.rendered?.category === 'governance' && !oldByName.has(entry.logicalName));
+    if (partialHandoff && nextManifest.governance.profile !== 'none') {
+        nextManifest.governance.state = 'handoff-partial';
+    }
+    if (inspection.stateMigration.report.diagnosticOnly === true && inspection.historyMigration.status !== 'eligible') {
+        preserveDiagnosticGovernanceIdentity(nextManifest, manifest);
+    }
+    const skippedNames = new Set(skipped.map((entry) => entry.logicalName));
+    nextManifest.managedArtifacts = nextManifest.managedArtifacts.flatMap((artifact) => {
+        if (!skippedNames.has(artifact.logicalName))
+            return [artifact];
+        const previous = oldByName.get(artifact.logicalName);
+        return previous ? [{ ...artifact, pathParts: previous.pathParts, contentHash: previous.contentHash }] : [];
+    });
+    for (const entry of entries) {
+        if (entry.status !== 'orphan' && !(entry.status === 'retired-conflict' && !force))
+            continue;
+        const previous = oldByName.get(entry.logicalName);
+        if (plan.governanceProfile.id !== 'none' || previous.category !== 'governance') {
+            nextManifest.managedArtifacts.push(previous);
+        }
+    }
+    parseManifest(nextManifest);
+    const manifestChanged = canonicalSha256(nextManifest) !== canonicalSha256(manifest);
+    const writesManifest = inspection.hasDrift &&
+        (mutations.length > 0 || manifestChanged || inspection.ownershipMigrationPending);
+    if (writesManifest) {
+        mutations.push({
+            type: 'write', pathParts: ['liftoff.manifest.json'],
+            content: `${JSON.stringify(nextManifest, null, 2)}\n`
+        });
+    }
+    return {
+        force, mutations, nextManifest: writesManifest ? nextManifest : manifest,
+        written, retired, skipped, provisioned, hasWrites: mutations.length > 0
+    };
+}
+//# sourceMappingURL=write-plan.js.map

package/dist/application/update/write-plan.js.map

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

package/dist/application/upgrade/use-case.d.ts

@@ -0,0 +1,6 @@
+import type { ExecutionContext } from '../context.js';
+export interface UpgradeRequest {
+    mode: 'check' | 'apply';
+    json: boolean;
+}
+export declare function upgradeLiftoff(request: UpgradeRequest, context: ExecutionContext): Promise<number>;

package/dist/application/upgrade/use-case.js

@@ -0,0 +1,82 @@
+import { formatCommand } from '../../process-runner.js';
+import { runSelfUpgrade, selfUpgradeExitCode, selfUpgradeRemedy, selfUpgradeSummary } from '../../self-upgrade.js';
+import { liftoffVersion } from '../../version.js';
+function renderSelfUpgradeResult(value, presentation) {
+    const details = [
+        { label: 'Current CLI', value: value.currentVersion },
+        ...('targetVersion' in value && value.targetVersion
+            ? [{ label: 'Canonical target', value: value.targetVersion }]
+            : []),
+        ...('registryKind' in value && value.registryKind
+            ? [{ label: 'Delivery registry', value: value.registryKind }]
+            : [])
+    ];
+    presentation.definitions('CLI upgrade result', details);
+    switch (value.status) {
+        case 'current':
+            presentation.status('success', 'CLI is current', selfUpgradeSummary(value));
+            return;
+        case 'update-available':
+            presentation.status('warning', 'CLI update available', selfUpgradeSummary(value));
+            presentation.command('liftoff upgrade');
+            return;
+        case 'upgraded':
+            presentation.completion('Liftoff CLI upgraded', selfUpgradeSummary(value), [{ label: 'Installed version', value: value.targetVersion }], 'liftoff update --check');
+            return;
+        case 'blocked':
+        case 'failed': {
+            presentation.status(value.status === 'blocked' ? 'warning' : 'error', value.status === 'blocked' ? 'CLI upgrade blocked' : 'CLI upgrade failed', selfUpgradeSummary(value));
+            const remedy = selfUpgradeRemedy(value);
+            if (remedy) {
+                presentation.remedy(remedy);
+            }
+            return;
+        }
+        default: {
+            const exhaustive = value;
+            throw new Error(`Unhandled self-upgrade result: ${String(exhaustive)}`);
+        }
+    }
+}
+export async function upgradeLiftoff(request, context) {
+    const { mode, json } = request;
+    if (!json) {
+        context.presentation.commandIdentity('upgrade', 'Replace the supported global Liftoff CLI installation');
+    }
+    const execute = context.selfUpgrade ?? ((request) => runSelfUpgrade(request, {
+        environment: context.env ?? process.env
+    }));
+    let value;
+    try {
+        value = await execute({
+            mode,
+            currentVersion: liftoffVersion,
+            stdout: context.stdout,
+            stderr: context.stderr,
+            json,
+            ...(!json
+                ? {
+                    onStage: (stage, detail) => context.presentation.stage(stage, detail),
+                    onInstallCommand: (command) => context.presentation.command(formatCommand(command))
+                }
+                : {})
+        });
+    }
+    catch {
+        value = {
+            schemaVersion: 1,
+            mode,
+            status: 'failed',
+            currentVersion: liftoffVersion,
+            reasonCode: 'verification_failed'
+        };
+    }
+    if (json) {
+        context.presentation.rawStdout(`${JSON.stringify(value, null, 2)}\n`);
+    }
+    else {
+        renderSelfUpgradeResult(value, context.presentation);
+    }
+    return selfUpgradeExitCode(value);
+}
+//# sourceMappingURL=use-case.js.map