@msn-control/liftoff 0.10.3 → 0.11.1

package/dist/application/update/planning.d.ts

@@ -0,0 +1,40 @@
+import { type ProjectFileMutation, type ProjectFileSnapshot } from '../../adapters/filesystem/project-transaction.js';
+import { readProjectFile } from '../../adapters/filesystem/project-files.js';
+import type { ReconcileEntry } from '../../reconcile.js';
+import type { GeneratedArtifact, LiftoffManifest, ManifestManagedArtifact, ManifestProjectArtifact, ProjectProvisioningGroup, ProjectPlan } from '../../domain/project/contracts.js';
+export declare function buildUpdateArtifacts(plan: ProjectPlan, manifest: LiftoffManifest): GeneratedArtifact[];
+type GeneratedProjectArtifact = Extract<GeneratedArtifact, {
+    lifecycle: 'project';
+}>;
+type ProvisioningEntryStatus = 'create' | 'adopt' | 'conflict';
+export interface ProvisioningEntry {
+    group: ProjectProvisioningGroup;
+    status: ProvisioningEntryStatus;
+    rendered: GeneratedProjectArtifact;
+    reason: string;
+}
+export interface ProvisioningGroupPlan {
+    group: ProjectProvisioningGroup;
+    entries: ProvisioningEntry[];
+    blocked: boolean;
+    reason?: string;
+}
+export interface ProvisioningGroupRequest {
+    group: ProjectProvisioningGroup;
+    status: 'ready' | 'migration-required';
+    reason?: string;
+}
+export declare function requestedProvisioningGroups(manifest: LiftoffManifest, plan: ProjectPlan): ProvisioningGroupRequest[];
+export declare function inspectProvisioningGroups(projectRoot: string, render: readonly GeneratedArtifact[], groups: readonly ProvisioningGroupRequest[], options?: {
+    readFile?: typeof readProjectFile;
+}): Promise<ProvisioningGroupPlan[]>;
+export declare function provisioningJson(plans: readonly ProvisioningGroupPlan[]): object[];
+export declare function appendProvisionedProjectArtifacts(existing: readonly ManifestProjectArtifact[], plans: readonly ProvisioningGroupPlan[]): ManifestProjectArtifact[];
+export declare function sameWorkloadIntent(left: LiftoffManifest['project']['workload'], right: LiftoffManifest['project']['workload']): boolean;
+export declare function planWithBlockedProvisioning(plan: ProjectPlan, recordedWorkload: LiftoffManifest['project']['workload'], provisioningPlans: readonly ProvisioningGroupPlan[]): ProjectPlan;
+export declare function isUnownedUpdateConflict(entry: ReconcileEntry, recordedByName: ReadonlyMap<string, ManifestManagedArtifact>): boolean;
+export declare function preflightUpdate(projectRoot: string, entries: ReconcileEntry[], force: boolean, recordedByName: ReadonlyMap<string, ManifestManagedArtifact>): Promise<void>;
+export declare function captureUpdateSnapshots(projectRoot: string, manifest: LiftoffManifest, render: readonly GeneratedArtifact[], initialSnapshots: readonly ProjectFileSnapshot[]): Promise<ProjectFileSnapshot[]>;
+export declare function selectUpdatePreconditions(snapshots: readonly ProjectFileSnapshot[], entries: readonly ReconcileEntry[], mutations: readonly ProjectFileMutation[], additionalPaths?: readonly string[][]): ProjectFileSnapshot[];
+export declare function assertAuthorizedUpdateMutations(mutations: readonly ProjectFileMutation[], entries: readonly ReconcileEntry[], provisioningPlans: readonly ProvisioningGroupPlan[], additionalAuthorizedPaths?: readonly string[][]): void;
+export {};

package/dist/application/update/planning.js

@@ -0,0 +1,293 @@
+import { createHash } from 'node:crypto';
+import { getEnvironment } from '../project/catalog.js';
+import { captureProjectFileSnapshot } from '../../adapters/filesystem/project-transaction.js';
+import { manifestDisplayPath } from '../../domain/project/paths.js';
+import { readProjectFile } from '../../adapters/filesystem/project-files.js';
+import { resolveProjectPath } from '../../adapters/filesystem/project-paths.js';
+import { liftoffVersion } from '../../version.js';
+import { assessInfrastructureLayout, infrastructureProvisioningGate, sharedApplicationModuleIdentities } from '../../domain/project/infrastructure-layout.js';
+import { buildArtifacts } from '../../templates.js';
+import { renderGovernanceContext } from '../../repository-governance.js';
+export function buildUpdateArtifacts(plan, manifest) {
+    const infrastructureLayout = assessInfrastructureLayout(manifest).kind;
+    return buildArtifacts(plan).map((artifact) => artifact.logicalName === 'repository-governance-context'
+        ? {
+            ...artifact,
+            content: infrastructureLayout === 'independent'
+                ? renderGovernanceContext(plan)
+                : renderGovernanceContext(plan, { infrastructureLayout })
+        }
+        : artifact);
+}
+export function requestedProvisioningGroups(manifest, plan) {
+    const provisioned = new Set(manifest.projectArtifacts.map((artifact) => artifact.provisioningGroup));
+    const groups = [];
+    if (plan.includeFrontend &&
+        !manifest.project.workload.frontend &&
+        !provisioned.has('frontend')) {
+        groups.push({ group: 'frontend', status: 'ready' });
+    }
+    const recordedEnvironments = new Set(manifest.project.workload.environments);
+    for (const environment of plan.environments) {
+        const group = `environment:${environment.id}`;
+        if (!recordedEnvironments.has(environment.id) &&
+            !provisioned.has(group)) {
+            const gate = infrastructureProvisioningGate(manifest, environment.id);
+            groups.push({
+                group,
+                status: gate.status,
+                ...(gate.status === 'migration-required' ? { reason: gate.reason } : {})
+            });
+        }
+    }
+    return groups;
+}
+export async function inspectProvisioningGroups(projectRoot, render, groups, options = {}) {
+    const readFile = options.readFile ?? readProjectFile;
+    const projectArtifacts = render.filter((artifact) => artifact.lifecycle === 'project');
+    const plans = [];
+    for (const request of groups) {
+        const group = request.group;
+        const artifacts = projectArtifacts.filter((artifact) => artifact.provisioningGroup === group);
+        if (artifacts.length === 0) {
+            throw new Error(`Provisioning group ${group} did not render any project artifacts.`);
+        }
+        if (request.status === 'migration-required') {
+            plans.push({
+                group,
+                entries: [],
+                blocked: true,
+                reason: request.reason
+            });
+            continue;
+        }
+        if (group.startsWith('environment:')) {
+            const missingSharedModule = [];
+            for (const identity of sharedApplicationModuleIdentities) {
+                if (await readFile(projectRoot, [...identity.pathParts]) === undefined) {
+                    missingSharedModule.push(identity.pathParts.join('/'));
+                }
+            }
+            if (missingSharedModule.length > 0) {
+                plans.push({
+                    group,
+                    entries: [],
+                    blocked: true,
+                    reason: `Recorded shared application module files are missing: ${missingSharedModule.join(', ')}. An explicit reviewed infrastructure migration is required; no environment root was created.`
+                });
+                continue;
+            }
+        }
+        const entries = await Promise.all(artifacts.map(async (artifact) => {
+            const disk = await readFile(projectRoot, artifact.pathParts);
+            if (disk === undefined) {
+                return {
+                    group,
+                    status: 'create',
+                    rendered: artifact,
+                    reason: 'destination is absent'
+                };
+            }
+            if (disk.toString('utf8') === artifact.content) {
+                return {
+                    group,
+                    status: 'adopt',
+                    rendered: artifact,
+                    reason: 'destination already matches the selected component'
+                };
+            }
+            return {
+                group,
+                status: 'conflict',
+                rendered: artifact,
+                reason: 'destination contains project-owned bytes'
+            };
+        }));
+        plans.push({
+            group,
+            entries,
+            blocked: entries.some((entry) => entry.status === 'conflict')
+        });
+    }
+    return plans;
+}
+export function provisioningJson(plans) {
+    return plans.map((plan) => ({
+        group: plan.group,
+        status: plan.blocked ? 'blocked' : 'ready',
+        ...(plan.reason ? { reason: plan.reason } : {}),
+        entries: plan.entries.map((entry) => ({
+            status: entry.status,
+            path: manifestDisplayPath(entry.rendered.pathParts),
+            reason: entry.reason
+        }))
+    }));
+}
+function projectProvenanceFor(artifact) {
+    return {
+        logicalName: artifact.logicalName,
+        category: artifact.category,
+        pathParts: artifact.pathParts,
+        generatedBy: liftoffVersion,
+        generationHash: `sha256:${createHash('sha256').update(artifact.content, 'utf8').digest('hex')}`,
+        provisioningGroup: artifact.provisioningGroup
+    };
+}
+export function appendProvisionedProjectArtifacts(existing, plans) {
+    const byName = new Map(existing.map((artifact) => [artifact.logicalName, artifact]));
+    for (const plan of plans) {
+        if (plan.blocked) {
+            continue;
+        }
+        for (const entry of plan.entries) {
+            if (!byName.has(entry.rendered.logicalName)) {
+                byName.set(entry.rendered.logicalName, projectProvenanceFor(entry.rendered));
+            }
+        }
+    }
+    return [...byName.values()];
+}
+export function sameWorkloadIntent(left, right) {
+    if (left.kind !== right.kind) {
+        return false;
+    }
+    return left.apiStack === right.apiStack &&
+        left.cloud === right.cloud &&
+        left.region === right.region &&
+        left.frontend === right.frontend &&
+        left.environments.length === right.environments.length &&
+        left.environments.every((environment, index) => environment === right.environments[index]) &&
+        (left.kind !== 'genai' || right.kind !== 'genai' || left.pattern === right.pattern);
+}
+export function planWithBlockedProvisioning(plan, recordedWorkload, provisioningPlans) {
+    const blockedGroups = new Set(provisioningPlans
+        .filter((group) => group.blocked)
+        .map((group) => group.group));
+    const hasBlockedEnvironment = [...blockedGroups].some((group) => group.startsWith('environment:'));
+    const environments = hasBlockedEnvironment
+        ? recordedWorkload.environments.map((id) => {
+            const environment = getEnvironment(id);
+            if (!environment) {
+                throw new Error(`Recorded environment ${id} is no longer supported.`);
+            }
+            return environment;
+        })
+        : plan.environments;
+    return {
+        ...plan,
+        includeFrontend: blockedGroups.has('frontend')
+            ? recordedWorkload.frontend
+            : plan.includeFrontend,
+        environments
+    };
+}
+export function isUnownedUpdateConflict(entry, recordedByName) {
+    if (entry.status === 'moved') {
+        return entry.destinationOccupied === true && entry.destinationMatches !== true;
+    }
+    if (entry.status !== 'conflict') {
+        return false;
+    }
+    const recorded = recordedByName.get(entry.logicalName);
+    return !recorded ||
+        recorded.category !== entry.rendered?.category ||
+        recorded.pathParts.join('\0') !== entry.pathParts.join('\0');
+}
+export async function preflightUpdate(projectRoot, entries, force, recordedByName) {
+    for (const entry of entries) {
+        if (isUnownedUpdateConflict(entry, recordedByName)) {
+            continue;
+        }
+        const writesDestination = entry.status === 'new' ||
+            entry.status === 'missing' ||
+            entry.status === 'upgrade' ||
+            entry.status === 'moved' && (entry.cleanMove === true || force) ||
+            entry.status === 'conflict' && force;
+        const deletesDestination = entry.status === 'retired' ||
+            entry.status === 'retired-conflict' && force;
+        if (writesDestination) {
+            await resolveProjectPath(projectRoot, entry.pathParts);
+        }
+        if (deletesDestination) {
+            await resolveProjectPath(projectRoot, entry.pathParts);
+        }
+        if (entry.previousPathParts &&
+            (entry.status === 'moved' && (entry.cleanMove === true || force) || entry.status === 'conflict' && force)) {
+            await resolveProjectPath(projectRoot, entry.previousPathParts);
+        }
+    }
+    await resolveProjectPath(projectRoot, ['liftoff.manifest.json']);
+}
+function updateSnapshotKey(pathParts) {
+    return pathParts.join('\0');
+}
+export async function captureUpdateSnapshots(projectRoot, manifest, render, initialSnapshots) {
+    const snapshots = new Map(initialSnapshots.map((snapshot) => [updateSnapshotKey(snapshot.pathParts), snapshot]));
+    const seenKeys = new Set(snapshots.keys());
+    const candidates = [
+        ...manifest.managedArtifacts.map((artifact) => artifact.pathParts),
+        ...render.map((artifact) => artifact.pathParts)
+    ];
+    const uncaptured = [];
+    for (const pathParts of candidates) {
+        const key = updateSnapshotKey(pathParts);
+        if (!seenKeys.has(key)) {
+            seenKeys.add(key);
+            uncaptured.push(pathParts);
+        }
+    }
+    for (const snapshot of await Promise.all(uncaptured.map((pathParts) => captureProjectFileSnapshot(projectRoot, pathParts)))) {
+        snapshots.set(updateSnapshotKey(snapshot.pathParts), snapshot);
+    }
+    return [...snapshots.values()];
+}
+export function selectUpdatePreconditions(snapshots, entries, mutations, additionalPaths = []) {
+    const requiredKeys = new Set([
+        updateSnapshotKey(['liftoff.config.json']),
+        ...mutations.map((mutation) => updateSnapshotKey(mutation.pathParts)),
+        ...additionalPaths.map((pathParts) => updateSnapshotKey(pathParts))
+    ]);
+    for (const entry of entries) {
+        const adoptsExistingDestination = entry.status === 'moved' && entry.destinationMatches === true;
+        if (!(entry.status === 'unchanged' && entry.refreshHash) &&
+            !adoptsExistingDestination) {
+            continue;
+        }
+        requiredKeys.add(updateSnapshotKey(entry.pathParts));
+        if (entry.previousPathParts) {
+            requiredKeys.add(updateSnapshotKey(entry.previousPathParts));
+        }
+    }
+    return snapshots.filter((snapshot) => requiredKeys.has(updateSnapshotKey(snapshot.pathParts)));
+}
+export function assertAuthorizedUpdateMutations(mutations, entries, provisioningPlans, additionalAuthorizedPaths = []) {
+    const authorized = new Set([
+        updateSnapshotKey(['liftoff.manifest.json']),
+        ...additionalAuthorizedPaths.map((pathParts) => updateSnapshotKey(pathParts))
+    ]);
+    for (const entry of entries) {
+        if (entry.rendered && entry.rendered.lifecycle !== 'managed-core') {
+            throw new Error(`Update reconciliation produced a non-core mutation candidate: ${entry.logicalName}`);
+        }
+        authorized.add(updateSnapshotKey(entry.pathParts));
+        if (entry.previousPathParts) {
+            authorized.add(updateSnapshotKey(entry.previousPathParts));
+        }
+    }
+    for (const plan of provisioningPlans) {
+        if (plan.blocked) {
+            continue;
+        }
+        for (const entry of plan.entries) {
+            if (entry.status === 'create') {
+                authorized.add(updateSnapshotKey(entry.rendered.pathParts));
+            }
+        }
+    }
+    for (const mutation of mutations) {
+        if (!authorized.has(updateSnapshotKey(mutation.pathParts))) {
+            throw new Error(`Update mutation is outside managed-core or authorized provisioning scope: ${manifestDisplayPath(mutation.pathParts)}`);
+        }
+    }
+}
+//# sourceMappingURL=planning.js.map

package/dist/application/update/planning.js.map

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

package/dist/application/update/reporting.d.ts

@@ -0,0 +1,42 @@
+import type { ReconcileEntry } from '../../reconcile.js';
+import { type ActivationStateMigrationPlan } from '../../governance-activation/migration.js';
+import type { LiftoffManifest } from '../../domain/project/contracts.js';
+interface UpdateSummary {
+    new: number;
+    missing: number;
+    upgrade: number;
+    conflict: number;
+    moved: number;
+    orphan: number;
+    retired: number;
+    retiredRemoved: number;
+    retiredAbsent: number;
+    retiredConflict: number;
+    refresh: number;
+    unchanged: number;
+}
+export declare function summarizeEntries(entries: ReconcileEntry[]): UpdateSummary;
+export declare function entryMarker(entry: ReconcileEntry): string;
+export declare function entryDisplay(entry: ReconcileEntry): string;
+export declare function isDirtyGitWorktree(projectRoot: string): boolean;
+interface ManifestChange {
+    field: string;
+    from: unknown;
+    to: unknown;
+}
+export interface ManagedUpdateReconciliationReport {
+    status: 'not-required' | 'reconciliation-required' | 'blocked';
+    changedIdentityFields: readonly ManifestChange[];
+    phaseImpact: {
+        preservedPhaseIds: readonly string[];
+        invalidPhaseIds: readonly string[];
+    };
+    issues: readonly string[];
+    remedy?: string;
+}
+export declare function manifestChanges(manifest: LiftoffManifest, plannedManifest: LiftoffManifest): ManifestChange[];
+export declare function stateMigrationReconciliation(stateMigration: ActivationStateMigrationPlan): ManagedUpdateReconciliationReport;
+export declare function activeChangeReconciliationReport(projectRoot: string): Promise<ManagedUpdateReconciliationReport>;
+export declare function combineReconciliationReports(reports: readonly ManagedUpdateReconciliationReport[]): ManagedUpdateReconciliationReport;
+export declare function maybeInjectUpdateFailure(env: NodeJS.ProcessEnv | undefined, stage: string): void;
+export {};