@msn-control/liftoff 0.9.8 → 0.10.0

package/dist/governance-activation/release-integrity.js

@@ -0,0 +1,49 @@
+import { canonicalSha256 } from './canonical-json.js';
+import { phaseContractDigests } from './graph.js';
+function digestEntries(graph) {
+    return Object.entries(phaseContractDigests(graph));
+}
+function equalDigestMaps(left, right) {
+    const leftEntries = digestEntries(left);
+    const rightEntries = digestEntries(right);
+    return leftEntries.length === rightEntries.length &&
+        leftEntries.every(([phaseId, digest]) => rightEntries.some(([otherPhaseId, otherDigest]) => otherPhaseId === phaseId && otherDigest === digest));
+}
+function changedPhaseDigests(left, right) {
+    const rightDigests = phaseContractDigests(right);
+    return digestEntries(left)
+        .filter(([phaseId, digest]) => rightDigests[phaseId] !== digest)
+        .map(([phaseId]) => phaseId);
+}
+export function validateReleaseIntegrity(input) {
+    if (input.currentIdentity.setupSkillVersion !== undefined) {
+        throw new Error('Setup wrapper content must not introduce an independent skill version.');
+    }
+    const previousHash = canonicalSha256(input.previousGraph);
+    const currentHash = canonicalSha256(input.currentGraph);
+    if (input.previousIdentity.phaseGraphHash !== previousHash) {
+        throw new Error('Previous activation identity does not match previous graph hash.');
+    }
+    if (input.currentIdentity.phaseGraphHash !== currentHash) {
+        throw new Error('Current activation identity does not match current graph hash.');
+    }
+    const graphBytesChanged = previousHash !== currentHash;
+    const schemaChanged = input.previousGraph.schemaVersion !== input.currentGraph.schemaVersion;
+    const behaviorChanged = changedPhaseDigests(input.previousGraph, input.currentGraph);
+    if (!graphBytesChanged && behaviorChanged.length === 0 && !schemaChanged) {
+        return;
+    }
+    if (schemaChanged && input.currentIdentity.phaseGraphSchemaVersion <= input.previousIdentity.phaseGraphSchemaVersion) {
+        throw new Error('Phase-graph schema drift requires a phaseGraphSchemaVersion bump.');
+    }
+    if (behaviorChanged.length > 0 && input.currentIdentity.activationContractVersion <= input.previousIdentity.activationContractVersion) {
+        throw new Error(`Phase behavior drift requires an activation-contract bump: ${behaviorChanged.join(', ')}.`);
+    }
+    if (graphBytesChanged && equalDigestMaps(input.previousGraph, input.currentGraph)) {
+        const mapped = input.compatibleGraphHashes.get(previousHash);
+        if (mapped !== currentHash) {
+            throw new Error('Nonsemantic phase-graph byte drift requires an explicit compatible hash mapping.');
+        }
+    }
+}
+//# sourceMappingURL=release-integrity.js.map

package/dist/governance-activation/release-integrity.js.map

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

package/dist/governance-activation/seed-lifecycle.d.ts

@@ -0,0 +1,116 @@
+import type { CommandResult, CommandRunner } from '../process-runner.js';
+import type { ExternalCommand, LiftoffManifest, ManifestWorkload } from '../types.js';
+export type SeedBaselineCheckId = 'liftoff-validate' | 'backend-tests' | 'worker-tests' | 'frontend-build' | 'docker-compose-config' | 'tofu-fmt' | 'tofu-init' | 'tofu-validate' | 'openspec-strict';
+export type SeedBaselineCheckApplicability = {
+    applicable: true;
+    command: ExternalCommand;
+    cwdPathParts: readonly string[];
+} | {
+    applicable: false;
+    reason: string;
+};
+export interface SeedBaselineCheck {
+    id: SeedBaselineCheckId;
+    taskId: string;
+    label: string;
+    applicability: SeedBaselineCheckApplicability;
+}
+export type SeedBaselineCheckOutcome = {
+    id: SeedBaselineCheckId;
+    taskId: string;
+    label: string;
+    status: 'passed';
+    command: ExternalCommand;
+    cwdPathParts: readonly string[];
+    result: CommandResult;
+} | {
+    id: SeedBaselineCheckId;
+    taskId: string;
+    label: string;
+    status: 'failed';
+    command: ExternalCommand;
+    cwdPathParts: readonly string[];
+    result: CommandResult;
+    detail: string;
+} | {
+    id: SeedBaselineCheckId;
+    taskId: string;
+    label: string;
+    status: 'inapplicable';
+    reason: string;
+};
+export type GeneratedSeedDiscovery = {
+    state: 'active';
+    changeName: string;
+    changePathParts: readonly string[];
+    capabilityId: string;
+} | {
+    state: 'archived';
+    changeName: string;
+    detail: string;
+} | {
+    state: 'blocked';
+    changeName: string;
+    issues: readonly string[];
+};
+export type GeneratedSeedLifecycleResult = {
+    status: 'archived';
+    changeName: string;
+    capabilityId: string;
+    checks: readonly SeedBaselineCheckOutcome[];
+    archive: CommandResult;
+    archiveSyncBehavior: string;
+} | {
+    status: 'blocked';
+    changeName: string;
+    issues: readonly string[];
+    checks: readonly SeedBaselineCheckOutcome[];
+} | {
+    status: 'already-archived';
+    changeName: string;
+    detail: string;
+};
+export type SeedPhaseValidationResult = {
+    status: 'passed';
+    changeName: string;
+    capabilityId?: string;
+    command?: CommandResult;
+    detail: string;
+} | {
+    status: 'blocked';
+    changeName: string;
+    issues: readonly string[];
+};
+export type SeedPhaseVerificationResult = {
+    status: 'passed';
+    changeName: string;
+    checks: readonly SeedBaselineCheckOutcome[];
+} | {
+    status: 'blocked';
+    changeName: string;
+    issues: readonly string[];
+    checks: readonly SeedBaselineCheckOutcome[];
+};
+export type SeedPhaseArchiveResult = {
+    status: 'archived' | 'already-archived';
+    changeName: string;
+    capabilityId?: string;
+    archive?: CommandResult;
+    archiveSyncBehavior?: string;
+    detail: string;
+} | {
+    status: 'blocked';
+    changeName: string;
+    issues: readonly string[];
+};
+export declare function generatedSeedChangeName(manifest: LiftoffManifest): string;
+export declare function generatedSeedCapabilityId(workload: ManifestWorkload): string;
+export declare function selectSeedBaselineChecks(manifest: LiftoffManifest, changeName?: string): SeedBaselineCheck[];
+export declare function discoverGeneratedSeed(projectRoot: string): Promise<GeneratedSeedDiscovery>;
+export declare function runSeedBaselineChecks(projectRoot: string, runner: CommandRunner, checks: readonly SeedBaselineCheck[]): Promise<SeedBaselineCheckOutcome[]>;
+export declare function markSuccessfulSeedTasks(markdown: string, outcomes: readonly SeedBaselineCheckOutcome[]): string;
+export declare function markAllSeedTasksForArchive(markdown: string): string;
+export declare function validateGeneratedSeedForPhase(projectRoot: string, runner: CommandRunner): Promise<SeedPhaseValidationResult>;
+export declare function verifyGeneratedSeedBaselineForPhase(projectRoot: string, runner: CommandRunner): Promise<SeedPhaseVerificationResult>;
+export declare function archiveGeneratedSeedForPhase(projectRoot: string, runner: CommandRunner): Promise<SeedPhaseArchiveResult>;
+export declare function completeGeneratedSeedLifecycle(projectRoot: string, runner: CommandRunner): Promise<GeneratedSeedLifecycleResult>;