@msn-control/liftoff 0.11.3 → 0.12.0

package/dist/domain/repair/stateful.js

@@ -0,0 +1,26 @@
+export const statefulRecipeVersion = 'opentofu-state-migration/1';
+export const stateFailureCodes = [
+    'invalid-binding', 'duplicate-binding', 'unsupported-backend', 'unsupported-encryption',
+    'live-scope-required', 'state-read-approval-required', 'approval-mismatch', 'expired',
+    'protected-workspace-required', 'key-unavailable', 'unsafe-path', 'storage-limit',
+    'artifact-integrity', 'artifact-purpose', 'access-denied', 'incomplete-observation',
+    'stale-state', 'lock-unavailable', 'lock-lost', 'native-lock-provider-required',
+    'invalid-state', 'unsupported-state', 'mapping-incomplete', 'mapping-conflict',
+    'resource-change', 'resource-identity-changed', 'destination-conflict',
+    'configuration-changed', 'unsafe-planning-contract', 'unqualified-combination',
+    'tool-unavailable', 'native-command-failed', 'timeout', 'cancelled',
+    'writers-not-quiesced', 'verification-incomplete', 'recovery-required',
+    'recovery-conflict', 'not-due', 'ownership-mismatch', 'operation-failed',
+    'unsupported-local-state-operation', 'unsupported-native-platform',
+    'process-tree-termination-unproven'
+];
+export class StateMigrationError extends Error {
+    code;
+    constructor(code) {
+        const safe = stateFailureCodes.includes(code) ? code : 'operation-failed';
+        super(`Protected state operation blocked: ${safe}.`);
+        this.code = safe;
+        this.name = 'StateMigrationError';
+    }
+}
+//# sourceMappingURL=stateful.js.map

package/dist/domain/repair/stateful.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateful.js","sourceRoot":"","sources":["../../../src/domain/repair/stateful.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAAqC,CAAC;AAiD3E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,iBAAiB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,wBAAwB;IACvF,qBAAqB,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,SAAS;IACrF,8BAA8B,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe;IACjF,oBAAoB,EAAE,kBAAkB,EAAE,eAAe,EAAE,wBAAwB;IACnF,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,+BAA+B;IAC/E,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB;IAC9E,iBAAiB,EAAE,2BAA2B,EAAE,sBAAsB;IACtE,uBAAuB,EAAE,0BAA0B,EAAE,yBAAyB;IAC9E,kBAAkB,EAAE,uBAAuB,EAAE,SAAS,EAAE,WAAW;IACnE,sBAAsB,EAAE,yBAAyB,EAAE,mBAAmB;IACtE,mBAAmB,EAAE,SAAS,EAAE,oBAAoB,EAAE,kBAAkB;IACxE,mCAAmC,EAAE,6BAA6B;IAClE,mCAAmC;CAC3B,CAAC;AAQX,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,CAAmB;IAChC,YAAY,IAAsB;QAChC,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAC1E,KAAK,CAAC,sCAAsC,IAAI,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/domain/workstation/constraints.d.ts

@@ -2,5 +2,6 @@ export interface VersionConstraint {
     exactVersion?: string;
     minimumVersion?: string;
     releaseLine?: string;
+    allowPrerelease?: boolean;
 }
 export declare function formatRequirementVersion(requirement: VersionConstraint): string;

package/dist/domain/workstation/constraints.js.map

@@ -1 +1 @@
-{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../../src/domain/workstation/constraints.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,wBAAwB,CAAC,WAA8B;IACrE,IAAI,WAAW,CAAC,YAAY;QAAE,OAAO,WAAW,WAAW,CAAC,YAAY,EAAE,CAAC;IAC3E,IAAI,CAAC,WAAW,CAAC,cAAc;QAAE,OAAO,WAAW,CAAC;IACpD,OAAO,GAAG,WAAW,CAAC,cAAc,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC7G,CAAC"}
+{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../../src/domain/workstation/constraints.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,wBAAwB,CAAC,WAA8B;IACrE,IAAI,WAAW,CAAC,YAAY;QAAE,OAAO,WAAW,WAAW,CAAC,YAAY,EAAE,CAAC;IAC3E,IAAI,CAAC,WAAW,CAAC,cAAc;QAAE,OAAO,WAAW,CAAC;IACpD,OAAO,GAAG,WAAW,CAAC,cAAc,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC7G,CAAC"}

package/dist/domain/workstation/contracts.d.ts

@@ -0,0 +1,42 @@
+import type { ExternalCommand } from '../project/contracts.js';
+export type RequirementReasonCode = 'compatible' | 'missing-executable' | 'observation-unavailable' | 'probe-failed' | 'version-unparseable' | 'unsupported-constraint' | 'below-minimum' | 'release-line-mismatch' | 'exact-version-mismatch' | 'incompatible-channel';
+export type InstallationOrigin = 'brew' | 'winget' | 'npm' | 'uv' | 'standalone' | 'unknown';
+export type RemediationOperation = 'install' | 'upgrade' | 'change-version' | 'change-channel';
+export type WorkstationScope = 'initialization' | 'local' | 'activation' | 'migration' | 'lifecycle';
+export interface ExecutableIdentity {
+    executable: string;
+    resolution: 'resolved' | 'missing' | 'not-observable';
+    resolvedPath?: string;
+    realPath?: string;
+    kind?: 'executable' | 'shim';
+    origin: InstallationOrigin;
+    evidence: 'path-search' | 'version-probe' | 'documented-location' | 'unavailable';
+}
+export interface ToolProbeObservation {
+    command: ExternalCommand;
+    identity: ExecutableIdentity;
+    status: number | null;
+    timedOut: boolean;
+    errorCode?: string;
+    reasonCode: RequirementReasonCode;
+    detectedVersion?: string;
+}
+export type RemediationProgress = 'ready' | 'improved' | 'unchanged' | 'changed' | 'indeterminate';
+export interface RemediationAttempt {
+    recipeId: string;
+    inputFingerprint: string;
+    outputFingerprint?: string;
+    outcome: RemediationProgress | 'failed';
+}
+export interface NoProgressRemediationAttempt extends RemediationAttempt {
+    outputFingerprint: string;
+    outcome: 'unchanged';
+}
+export interface WorkstationNoProgressStore {
+    find(recipeId: string, inputFingerprint: string): Promise<RemediationAttempt | null>;
+    record(attempt: NoProgressRemediationAttempt): Promise<void>;
+}
+export interface ToolUpdateObservation {
+    version: string;
+    source: string;
+}

package/dist/domain/workstation/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/domain/workstation/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/domain/workstation/contracts.ts"],"names":[],"mappings":""}

package/dist/domain/workstation/executables.d.ts

@@ -0,0 +1,19 @@
+import path from 'node:path';
+import type { SupportedPlatform, WorkstationRequirementDefinition } from '../../workstation-catalog.js';
+import type { ExecutableIdentity, InstallationOrigin } from './contracts.js';
+export interface ExecutableObservationContext {
+    platform: SupportedPlatform;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    definition: WorkstationRequirementDefinition;
+}
+export interface ExecutableObserver {
+    resolve(executable: string, context: ExecutableObservationContext): Promise<ExecutableIdentity>;
+    inspect(candidate: string, context: ExecutableObservationContext): Promise<ExecutableIdentity>;
+}
+export declare const unavailableExecutableObserver: ExecutableObserver;
+export declare function hostPath(platform: SupportedPlatform): typeof path.win32;
+export declare function environmentValue(env: NodeJS.ProcessEnv, name: string, platform: SupportedPlatform): string | undefined;
+export declare function executableCandidates(executable: string, context: ExecutableObservationContext): string[];
+export declare function originFromPath(target: string, context: ExecutableObservationContext): InstallationOrigin;
+export declare function unavailable(executable: string, resolution: 'missing' | 'not-observable'): ExecutableIdentity;

package/dist/domain/workstation/executables.js

@@ -0,0 +1,68 @@
+import path from 'node:path';
+export const unavailableExecutableObserver = {
+    async resolve(executable) {
+        return unavailable(executable, 'not-observable');
+    },
+    async inspect(candidate) {
+        return unavailable(candidate, 'not-observable');
+    }
+};
+export function hostPath(platform) {
+    return platform === 'win32' ? path.win32 : path.posix;
+}
+export function environmentValue(env, name, platform) {
+    const key = platform === 'win32'
+        ? Object.keys(env).find((entry) => entry.toLowerCase() === name.toLowerCase())
+        : name;
+    return key === undefined ? undefined : env[key];
+}
+export function executableCandidates(executable, context) {
+    const nativePath = hostPath(context.platform);
+    const hasPath = /[/\\]/.test(executable);
+    if (!hasPath && !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(executable))
+        return [];
+    const extensionList = (environmentValue(context.env, 'PATHEXT', context.platform) ?? '.COM;.EXE;.BAT;.CMD')
+        .split(';')
+        .filter((extension) => /^\.(?:exe|com|cmd|bat)$/i.test(extension));
+    const extensions = context.platform === 'win32' && !nativePath.extname(executable)
+        ? extensionList
+        : [''];
+    const directories = hasPath
+        ? ['']
+        : [
+            ...(context.platform === 'win32' ? [context.cwd] : []),
+            ...(environmentValue(context.env, 'PATH', context.platform) ?? '')
+                .slice(0, 32_768).split(nativePath.delimiter).slice(0, 256)
+        ];
+    return [...new Set(directories.flatMap((directory) => {
+            const root = directory.replace(/^"(.*)"$/, '$1');
+            const candidate = hasPath
+                ? nativePath.resolve(context.cwd, executable)
+                : nativePath.resolve(context.cwd, root, executable);
+            return extensions.map((extension) => `${candidate}${extension}`);
+        }))];
+}
+export function originFromPath(target, context) {
+    const normalized = target.replaceAll('\\', '/');
+    const value = context.platform === 'win32' ? normalized.toLowerCase() : normalized;
+    const identities = context.definition.packageIdentities;
+    const npm = identities?.npm;
+    if (npm && value.includes(`/node_modules/${context.platform === 'win32' ? npm.toLowerCase() : npm}/`))
+        return 'npm';
+    const brew = identities?.brew;
+    if (brew && (value.includes(`/Cellar/${brew}/`) || value.includes(`/Caskroom/${brew}/`)))
+        return 'brew';
+    const uv = identities?.uv;
+    if (uv && value.includes(`/uv/tools/${uv}/`))
+        return 'uv';
+    const winget = identities?.winget?.toLowerCase();
+    if (winget && value.includes(`/microsoft/winget/packages/${winget}_`))
+        return 'winget';
+    if (context.definition.id === 'claude' && value.includes('/.local/share/claude/versions/'))
+        return 'standalone';
+    return 'unknown';
+}
+export function unavailable(executable, resolution) {
+    return { executable, resolution, origin: 'unknown', evidence: 'unavailable' };
+}
+//# sourceMappingURL=executables.js.map

package/dist/domain/workstation/executables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executables.js","sourceRoot":"","sources":["../../../src/domain/workstation/executables.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAgB7B,MAAM,CAAC,MAAM,6BAA6B,GAAuB;IAC/D,KAAK,CAAC,OAAO,CAAC,UAAU;QACtB,OAAO,WAAW,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,SAAS;QACrB,OAAO,WAAW,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAClD,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,QAA2B;IAClD,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAsB,EAAE,IAAY,EAAE,QAA2B;IAChG,MAAM,GAAG,GAAG,QAAQ,KAAK,OAAO;QAC9B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9E,CAAC,CAAC,IAAI,CAAC;IACT,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,OAAqC;IAC5F,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5E,MAAM,aAAa,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC;SACxG,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;QAChF,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,WAAW,GAAG,OAAO;QACzB,CAAC,CAAC,CAAC,EAAE,CAAC;QACN,CAAC,CAAC;YACE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;iBAC/D,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SAC9D,CAAC;IACN,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YACnD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACjD,MAAM,SAAS,GAAG,OAAO;gBACvB,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC;gBAC7C,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YACtD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,OAAqC;IAClF,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IACnF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;IACxD,MAAM,GAAG,GAAG,UAAU,EAAE,GAAG,CAAC;IAC5B,IAAI,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACpH,MAAM,IAAI,GAAG,UAAU,EAAE,IAAI,CAAC;IAC9B,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACxG,MAAM,EAAE,GAAG,UAAU,EAAE,EAAE,CAAC;IAC1B,IAAI,EAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjD,IAAI,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,8BAA8B,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvF,IAAI,OAAO,CAAC,UAAU,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAAE,OAAO,YAAY,CAAC;IAChH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,UAAwC;IACtF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AAChF,CAAC"}

package/dist/domain/workstation/versions.d.ts

@@ -0,0 +1,8 @@
+import type { WorkstationRequirementId } from '../../workstation-catalog.js';
+/** Only registered version lines count; update announcements and dependency versions do not. */
+export declare function extractVersion(output: string, tool?: WorkstationRequirementId): string | undefined;
+export declare function versionCore(value: string): string;
+export declare function isPrereleaseVersion(value: string): boolean;
+export declare function compareVersionCores(left: string, right: string): number;
+export declare function compareVersions(left: string, right: string): number;
+export declare function matchesReleaseLine(value: string, releaseLine: string): boolean;

package/dist/domain/workstation/versions.js

@@ -0,0 +1,145 @@
+const NUMBER = '(?:0|[1-9][0-9]*)';
+const CORE = `${NUMBER}\\.${NUMBER}(?:\\.${NUMBER})?`;
+const IDENTIFIER = '[0-9A-Za-z-]+';
+const VERSION = new RegExp(`^${CORE}(?:-${IDENTIFIER}(?:\\.${IDENTIFIER})*|(?:a|b|rc|alpha|beta|dev)[0-9]+)?` +
+    `(?:\\+${IDENTIFIER}(?:\\.${IDENTIFIER})*)?$`);
+const TOKEN = '([0-9][0-9A-Za-z.+-]*)';
+const MAX_VERSION_OUTPUT = 16_384;
+function validatedToken(value, punctuation = false) {
+    const token = punctuation && value.endsWith('.') ? value.slice(0, -1) : value;
+    if (token.length > 128 || !VERSION.test(token))
+        return undefined;
+    const prerelease = token.split('+', 1)[0].match(/^[0-9.]+-(.+)$/)?.[1];
+    if (prerelease?.split('.').some((part) => /^0[0-9]+$/.test(part)))
+        return undefined;
+    return token;
+}
+const labelledFormats = {
+    node: [new RegExp(`^Node(?:\\.js)?(?: version)?\\s+v?${TOKEN}$`, 'i')],
+    npm: [new RegExp(`^npm(?: version)?\\s+v?${TOKEN}$`, 'i')],
+    python: [new RegExp(`^Python\\s+${TOKEN}$`, 'i')],
+    go: [new RegExp(`^go version go${TOKEN}(?:\\s+[A-Za-z0-9_]+/[A-Za-z0-9_]+)?$`)],
+    uv: [new RegExp(`^uv\\s+${TOKEN}(?:\\s+\\([^\\r\\n]*\\))?$`, 'i')],
+    docker: [new RegExp(`^Docker version\\s+${TOKEN}(?:,\\s+build\\s+\\S+)?$`, 'i')],
+    opentofu: [new RegExp(`^OpenTofu\\s+v?${TOKEN}$`, 'i')],
+    openspec: [new RegExp(`^OpenSpec(?: CLI)?(?: version)?\\s+v?${TOKEN}$`, 'i')],
+    'github-cli': [new RegExp(`^gh version\\s+${TOKEN}(?:\\s+\\([^\\r\\n]*\\))?$`, 'i')],
+    'spec-kit': [
+        new RegExp(`^(?:specify(?:-cli)?|Spec Kit)(?: CLI)?(?:,? version)?\\s+v?${TOKEN}$`, 'i')
+    ],
+    'github-copilot': [
+        new RegExp(`^(?:GitHub Copilot(?: CLI)?|copilot)(?: version)?\\s+v?${TOKEN}$`, 'i')
+    ],
+    claude: [
+        new RegExp(`^Claude(?: Code)?(?: version)?\\s+v?${TOKEN}$`, 'i'),
+        new RegExp(`^v?${TOKEN}\\s+\\(Claude Code\\)$`, 'i')
+    ],
+    codex: [new RegExp(`^(?:codex-cli|Codex(?: CLI)?)(?: version)?\\s+v?${TOKEN}$`, 'i')]
+};
+const agentIds = new Set(['github-copilot', 'claude', 'codex']);
+/** Only registered version lines count; update announcements and dependency versions do not. */
+export function extractVersion(output, tool) {
+    if (output.length > MAX_VERSION_OUTPUT)
+        return undefined;
+    const text = output.replace(/\u001b\[[0-?]*[ -/]*[@-~]/g, '').trim();
+    if (tool === 'azure-cli') {
+        try {
+            const value = JSON.parse(text);
+            return value && typeof value === 'object' && 'azure-cli' in value &&
+                typeof value['azure-cli'] === 'string'
+                ? validatedToken(value['azure-cli'])
+                : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const formats = tool
+        ? (labelledFormats[tool] ?? []).map((format) => ({ format, punctuation: agentIds.has(tool) }))
+        : Object.entries(labelledFormats).flatMap(([id, patterns]) => patterns.map((format) => ({
+            format,
+            punctuation: id === 'github-copilot' || id === 'claude' || id === 'codex'
+        })));
+    const versions = new Set();
+    for (const line of text.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        const bare = trimmed.match(new RegExp(`^v?${TOKEN}$`))?.[1];
+        if (bare) {
+            const version = validatedToken(bare, tool === undefined || agentIds.has(tool));
+            if (!version)
+                return undefined;
+            if (tool && tool !== 'go' && versionCore(version).split('.').length !== 3)
+                return undefined;
+            versions.add(version);
+            continue;
+        }
+        for (const { format, punctuation } of formats) {
+            const token = trimmed.match(format)?.[1];
+            if (token === undefined)
+                continue;
+            const version = validatedToken(token, punctuation);
+            if (!version)
+                return undefined;
+            if (tool && tool !== 'go' && versionCore(version).split('.').length !== 3)
+                return undefined;
+            versions.add(version);
+        }
+    }
+    return versions.size === 1 ? [...versions][0] : undefined;
+}
+export function versionCore(value) {
+    return value.match(/^\d+\.\d+(?:\.\d+)?/)?.[0] ?? value;
+}
+export function isPrereleaseVersion(value) {
+    return value.split('+', 1)[0].slice(versionCore(value).length).length > 0;
+}
+export function compareVersionCores(left, right) {
+    const leftParts = versionCore(left).split('.').map(BigInt);
+    const rightParts = versionCore(right).split('.').map(BigInt);
+    for (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {
+        const a = leftParts[index] ?? 0n;
+        const b = rightParts[index] ?? 0n;
+        if (a !== b)
+            return a < b ? -1 : 1;
+    }
+    return 0;
+}
+export function compareVersions(left, right) {
+    const core = compareVersionCores(left, right);
+    if (core !== 0)
+        return core;
+    const suffix = (version) => version.split('+', 1)[0].slice(versionCore(version).length).replace(/^-/, '');
+    const a = suffix(left);
+    const b = suffix(right);
+    if (a === b)
+        return 0;
+    if (!a)
+        return 1;
+    if (!b)
+        return -1;
+    const leftParts = a.split('.');
+    const rightParts = b.split('.');
+    for (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {
+        const l = leftParts[index];
+        const r = rightParts[index];
+        if (l === r)
+            continue;
+        if (l === undefined)
+            return -1;
+        if (r === undefined)
+            return 1;
+        if (/^\d+$/.test(l) && /^\d+$/.test(r))
+            return BigInt(l) < BigInt(r) ? -1 : 1;
+        if (/^\d+$/.test(l))
+            return -1;
+        if (/^\d+$/.test(r))
+            return 1;
+        return l < r ? -1 : 1;
+    }
+    return 0;
+}
+export function matchesReleaseLine(value, releaseLine) {
+    const parts = versionCore(value).split('.');
+    return releaseLine.split('.').every((part, index) => parts[index] === part);
+}
+//# sourceMappingURL=versions.js.map

package/dist/domain/workstation/versions.js.map

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

package/dist/framework-adapters.d.ts

@@ -15,4 +15,6 @@ export interface FrameworkAdapter {
 export declare function buildOpenSpecInitCommand(plan: ProjectPlan): ExternalCommand;
 export declare function buildSpecKitInitCommands(plan: ProjectPlan): ExternalCommand[];
 export declare const frameworkAdapters: Record<ProjectPlan['specWorkflow']['id'], FrameworkAdapter>;
+export declare function withFrameworkExecutionEnvironment<T>(area: StagingArea, plan: ProjectPlan, environment: NodeJS.ProcessEnv | undefined, operation: (env: NodeJS.ProcessEnv) => Promise<T>): Promise<T>;
+export declare function executeFrameworkCommands(area: StagingArea, plan: ProjectPlan, commands: readonly ExternalCommand[], runner: CommandRunner, options?: FrameworkInitializationOptions): Promise<FrameworkInitializationResult>;
 export declare function initializeFramework(area: StagingArea, plan: ProjectPlan, runner: CommandRunner, options?: FrameworkInitializationOptions): Promise<FrameworkInitializationResult>;

package/dist/framework-adapters.js

@@ -1,8 +1,8 @@
-import { lstat } from 'node:fs/promises';
+import { lstat, mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { captureTreeState, claimFrameworkChanges, InitFileSystemError, validateStagedTree } from './init-filesystem.js';
-import { frameworkSelectionFromPlan, validateFrameworkInitialization } from './framework-validation.js';
-import { OPEN_SPEC_PROFILE } from './openspec-profile.js';
+import { frameworkSelectionFromPlan, frameworkOutputPaths, validateFrameworkInitialization } from './framework-validation.js';
+import { OPEN_SPEC_DELIVERY, OPEN_SPEC_PROFILE, OPEN_SPEC_WORKFLOW_IDS } from './openspec-profile.js';
 import { formatCommand } from './process-runner.js';
 function errorCode(error) {
     return typeof error === 'object' && error !== null && 'code' in error &&
@@ -74,6 +74,26 @@ export const frameworkAdapters = {
         buildCommands: buildSpecKitInitCommands
     }
 };
+function assertRegisteredFrameworkCommands(plan, commands) {
+    const registered = frameworkAdapters[plan.specWorkflow.id].buildCommands(plan);
+    if (plan.specWorkflow.id === 'spec-kit') {
+        registered.push(...plan.agents.map((agent) => ({
+            executable: plan.framework.executable,
+            args: ['integration', 'install', agent.integrationIds['spec-kit'], '--force', ...specKitIntegrationArgs(agent)]
+        })));
+        registered.push({
+            executable: plan.framework.executable,
+            args: ['integration', 'use', plan.defaultAgent.integrationIds['spec-kit']]
+        });
+    }
+    for (const command of commands) {
+        if (!registered.some((expected) => expected.executable === command.executable &&
+            expected.args.length === command.args.length &&
+            expected.args.every((argument, index) => argument === command.args[index]))) {
+            throw new InitFileSystemError('Framework execution requires a registered official operation for the selected integrations.');
+        }
+    }
+}
 async function assertNoFrameworkGitMetadata(root) {
     try {
         await lstat(path.join(root, '.git'));
@@ -88,29 +108,132 @@ async function assertNoFrameworkGitMetadata(root) {
         }
     }
 }
-export async function initializeFramework(area, plan, runner, options = {}) {
+function assertSafeFrameworkTree(state, inventory) {
+    const expectedCase = new Map();
+    for (const parts of inventory) {
+        for (let size = 1; size <= parts.length; size++) {
+            const value = parts.slice(0, size).join('/');
+            expectedCase.set(value.toLowerCase(), value);
+        }
+    }
+    const observedCase = new Map();
+    for (const [name, entry] of state) {
+        if (entry.type === 'symlink' || entry.type === 'other') {
+            throw new InitFileSystemError(`Staged output contains a forbidden ${entry.type}: ${name}`);
+        }
+        const folded = name.toLowerCase();
+        const expected = expectedCase.get(folded) ?? observedCase.get(folded);
+        if (expected && expected !== name) {
+            throw new InitFileSystemError(`Framework output has a case collision: ${name} and ${expected}`);
+        }
+        observedCase.set(folded, name);
+    }
+}
+function assertInventoriedNativeChanges(before, after, inventory) {
+    const files = new Set(inventory.map((parts) => parts.join('/')));
+    const directories = new Set(inventory.flatMap((parts) => parts.slice(0, -1).map((_part, index) => parts.slice(0, index + 1).join('/'))));
+    for (const name of new Set([...before.keys(), ...after.keys()])) {
+        const previous = before.get(name);
+        const next = after.get(name);
+        if (previous?.type === next?.type &&
+            previous?.contentHash === next?.contentHash &&
+            previous?.mode === next?.mode) {
+            continue;
+        }
+        const entry = next ?? previous;
+        if (!['.agents', '.codex'].includes(entry.pathParts[0])) {
+            continue;
+        }
+        if (!(entry.type === 'directory' ? directories : files).has(name)) {
+            throw new InitFileSystemError(`Framework initializer changed a path outside its explicit native inventory: ${name}`);
+        }
+    }
+}
+export async function withFrameworkExecutionEnvironment(area, plan, environment, operation) {
+    const home = await mkdtemp(path.join(path.dirname(path.resolve(area.root)), 'liftoff-framework-home-'));
+    try {
+        const config = path.join(home, 'config');
+        const scratch = path.join(home, 'scratch');
+        const overrides = {
+            HOME: home,
+            USERPROFILE: home,
+            HOMEDRIVE: path.parse(home).root.replace(/[\\/]$/, ''),
+            HOMEPATH: home.slice(path.parse(home).root.replace(/[\\/]$/, '').length),
+            APPDATA: path.join(home, 'appdata'),
+            LOCALAPPDATA: path.join(home, 'localappdata'),
+            XDG_CONFIG_HOME: config,
+            XDG_DATA_HOME: path.join(home, 'data'),
+            XDG_CACHE_HOME: path.join(home, 'cache'),
+            XDG_STATE_HOME: path.join(home, 'state'),
+            CODEX_HOME: path.join(home, '.codex'),
+            CLAUDE_CONFIG_DIR: path.join(home, '.claude'),
+            TMPDIR: scratch,
+            TMP: scratch,
+            TEMP: scratch,
+            GIT_CONFIG_GLOBAL: path.join(home, 'gitconfig'),
+            GIT_CONFIG_SYSTEM: path.join(home, 'gitconfig-system'),
+            GIT_CONFIG_NOSYSTEM: '1',
+            OPENSPEC_TELEMETRY: '0',
+            OPENSPEC_NO_UPDATE_CHECK: '1'
+        };
+        const env = { ...process.env, ...environment };
+        for (const key of Object.keys(env)) {
+            if (Object.hasOwn(overrides, key.toUpperCase())) {
+                env[key] = overrides[key.toUpperCase()];
+            }
+        }
+        Object.assign(env, overrides);
+        await Promise.all([
+            config, scratch, overrides.APPDATA, overrides.LOCALAPPDATA,
+            overrides.XDG_DATA_HOME, overrides.XDG_CACHE_HOME, overrides.XDG_STATE_HOME,
+            overrides.CODEX_HOME, overrides.CLAUDE_CONFIG_DIR
+        ].map((directory) => mkdir(directory, { recursive: true, mode: 0o700 })));
+        if (plan.specWorkflow.id === 'openspec') {
+            // Global-profile consent is checked by the caller; stage only its required public fields.
+            const profileRoot = path.join(config, 'openspec');
+            await mkdir(profileRoot, { recursive: true, mode: 0o700 });
+            await writeFile(path.join(profileRoot, 'config.json'), `${JSON.stringify({
+                profile: OPEN_SPEC_PROFILE,
+                delivery: OPEN_SPEC_DELIVERY,
+                workflows: OPEN_SPEC_WORKFLOW_IDS
+            }, null, 2)}\n`, { mode: 0o600 });
+        }
+        return await operation(env);
+    }
+    finally {
+        await rm(home, { recursive: true, force: true });
+    }
+}
+export async function executeFrameworkCommands(area, plan, commands, runner, options = {}) {
+    assertRegisteredFrameworkCommands(plan, commands);
     const before = await captureTreeState(area.root);
-    const commands = frameworkAdapters[plan.specWorkflow.id].buildCommands(plan);
+    const inventory = frameworkOutputPaths(frameworkSelectionFromPlan(plan));
+    assertSafeFrameworkTree(before, inventory);
     const displayed = [];
-    for (const command of commands) {
-        options.onCommand?.(formatCommand(command));
-        const result = await runner.run(command, {
-            cwd: area.root,
-            env: options.env,
-            timeoutMs: 5 * 60_000,
-            stream: true,
-            stdout: options.stdout,
-            stderr: options.stderr
-        });
-        displayed.push(result.displayCommand);
-        if (result.status !== 0 || result.timedOut) {
-            const detail = result.timedOut
-                ? 'command timed out'
-                : result.stderr.trim().split(/\r?\n/)[0] || `exit status ${result.status}`;
-            throw new InitFileSystemError(`Framework initializer failed: ${result.displayCommand}: ${detail}`);
+    await withFrameworkExecutionEnvironment(area, plan, options.env, async (env) => {
+        for (const command of commands) {
+            options.onCommand?.(formatCommand(command));
+            const result = await runner.run(command, {
+                cwd: area.root,
+                env,
+                timeoutMs: 5 * 60_000,
+                stream: true,
+                stdout: options.stdout,
+                stderr: options.stderr
+            });
+            displayed.push(result.displayCommand);
+            if (result.status !== 0 || result.timedOut) {
+                const detail = result.timedOut
+                    ? 'command timed out'
+                    : result.stderr.trim().split(/\r?\n/)[0] || `exit status ${result.status}`;
+                throw new InitFileSystemError(`Framework initializer failed: ${result.displayCommand}: ${detail}`);
+            }
         }
-    }
+    });
     await assertNoFrameworkGitMetadata(area.root);
+    const after = await captureTreeState(area.root);
+    assertSafeFrameworkTree(after, inventory);
+    assertInventoriedNativeChanges(before, after, inventory);
     const changedPaths = await claimFrameworkChanges(area, before, plan.framework.allowedRoots);
     await validateStagedTree(area);
     const issues = await validateFrameworkInitialization(area.root, frameworkSelectionFromPlan(plan), plan.copilotCloud);
@@ -119,4 +242,7 @@ export async function initializeFramework(area, plan, runner, options = {}) {
     }
     return { commands: displayed, changedPaths };
 }
+export async function initializeFramework(area, plan, runner, options = {}) {
+    return executeFrameworkCommands(area, plan, frameworkAdapters[plan.specWorkflow.id].buildCommands(plan), runner, options);
+}
 //# sourceMappingURL=framework-adapters.js.map

package/dist/framework-adapters.js.map

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

package/dist/framework-validation.d.ts

@@ -4,6 +4,12 @@ export interface FrameworkSelection {
     agents: CodingAgentId[];
     defaultAgent?: CodingAgentId;
 }
+export declare function frameworkMarkerIssue(root: string, pathParts: readonly string[]): Promise<string | undefined>;
+export declare function specKitIntegrationPaths(agent: CodingAgentId): string[][];
+export declare function frameworkIntegrationPaths(workflow: SpecWorkflowId, agent: CodingAgentId): string[][];
+export declare const OPEN_SPEC_CODEX_TARGET_PATH: readonly ['.agents', 'skills', '.openspec-target'];
+export declare const SPEC_KIT_CODEX_CONFIG_PATH: readonly ['.codex', 'config.toml'];
+export declare function frameworkOutputPaths(selection: FrameworkSelection): string[][];
 export declare function validateFrameworkInstallation(root: string, selection: FrameworkSelection): Promise<string[]>;
 export declare function validateFrameworkInitialization(root: string, selection: FrameworkSelection, copilotCloud: boolean): Promise<string[]>;
 export declare function frameworkSelectionFromPlan(plan: ProjectPlan): FrameworkSelection;