@msn-control/liftoff 0.10.4 → 0.11.1

package/dist/application/diagnose/generated-project.js

@@ -0,0 +1,105 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { isRetiredManagedCoreLogicalName, managedCoreLogicalNames } from '../../domain/project/artifact-lifecycle.js';
+import { assessmentLogicalNames, preAssessmentManagedCoreLogicalNames } from '../../domain/project/manifest/governance.js';
+import { readProjectFile } from '../../adapters/filesystem/project-files.js';
+import { resolveProjectPath } from '../../adapters/filesystem/project-paths.js';
+import { errorCode, errorMessage } from '../../adapters/filesystem/errors.js';
+import { validateFrameworkInstallation } from '../../framework-validation.js';
+import { validateGovernanceCompatibilityMetadata } from '../../governance-activation/compatibility.js';
+import { loadManifest } from '../project/manifest.js';
+export async function validateGeneratedProject(projectRoot) {
+    let manifest;
+    try {
+        manifest = await loadManifest(projectRoot);
+    }
+    catch (error) {
+        return [error.message];
+    }
+    const issues = [];
+    for (const artifact of manifest.managedArtifacts) {
+        if (isRetiredManagedCoreLogicalName(artifact.logicalName)) {
+            try {
+                await resolveProjectPath(projectRoot, artifact.pathParts);
+            }
+            catch (error) {
+                issues.push(`Unsafe retired managed-core path for ${artifact.logicalName} at ${artifact.pathParts.join('/')}: ${errorMessage(error)}`);
+            }
+            continue;
+        }
+        try {
+            const targetPath = await resolveProjectPath(projectRoot, artifact.pathParts);
+            const bytes = await readFile(targetPath);
+            const actualHash = `sha256:${createHash('sha256').update(bytes).digest('hex')}`;
+            if (actualHash !== artifact.contentHash) {
+                issues.push(`Artifact hash mismatch for ${artifact.logicalName} at ${artifact.pathParts.join('/')}`);
+            }
+        }
+        catch (error) {
+            if (errorCode(error) === 'ENOENT') {
+                issues.push(`Missing artifact ${artifact.logicalName} at ${artifact.pathParts.join('/')}`);
+            }
+            else {
+                issues.push(`Unable to access artifact ${artifact.logicalName} at ${artifact.pathParts.join('/')}: ${errorMessage(error)}`);
+            }
+        }
+    }
+    const compatibilityArtifact = manifest.managedArtifacts.find((artifact) => artifact.logicalName === 'repository-governance-compatibility');
+    if (compatibilityArtifact &&
+        manifest.governance.profile !== 'none' &&
+        manifest.governance.profile !== 'unspecified') {
+        try {
+            const bytes = await readProjectFile(projectRoot, compatibilityArtifact.pathParts);
+            if (bytes === undefined) {
+                issues.push(`Missing artifact ${compatibilityArtifact.logicalName} at ${compatibilityArtifact.pathParts.join('/')}`);
+            }
+            else {
+                const hasRetiredManagedArtifacts = manifest.managedArtifacts.some((artifact) => isRetiredManagedCoreLogicalName(artifact.logicalName));
+                const currentManagedArtifacts = manifest.managedArtifacts.filter((artifact) => !isRetiredManagedCoreLogicalName(artifact.logicalName));
+                const expectedInventory = currentManagedArtifacts.map((artifact) => ({
+                    logicalName: artifact.logicalName,
+                    pathParts: artifact.pathParts,
+                    lifecycle: 'managed-core',
+                    contentHashAuthority: 'liftoff.manifest.json managedArtifacts[].contentHash'
+                }));
+                const compatibility = validateGovernanceCompatibilityMetadata(JSON.parse(bytes.toString('utf8')));
+                const predatesAssessment = !currentManagedArtifacts.some((artifact) => assessmentLogicalNames.some((logicalName) => artifact.logicalName === logicalName)) && compatibility.managedCore.logicalNameAllowlist.join('\0') ===
+                    preAssessmentManagedCoreLogicalNames.join('\0');
+                const logicalNameAllowlist = predatesAssessment
+                    ? preAssessmentManagedCoreLogicalNames
+                    : managedCoreLogicalNames;
+                validateGovernanceCompatibilityMetadata(compatibility, hasRetiredManagedArtifacts
+                    ? undefined
+                    : manifest.governance.state === 'handoff-generated'
+                        ? {
+                            logicalNameAllowlist,
+                            pathAllowlist: currentManagedArtifacts.map((artifact) => artifact.pathParts),
+                            inventory: expectedInventory
+                        }
+                        : {
+                            logicalNameAllowlist
+                        });
+            }
+        }
+        catch (error) {
+            issues.push(`Invalid repository-governance-compatibility at ${compatibilityArtifact.pathParts.join('/')}: ${errorMessage(error)}`);
+        }
+    }
+    for (const artifact of manifest.projectArtifacts) {
+        try {
+            await resolveProjectPath(projectRoot, artifact.pathParts);
+        }
+        catch (error) {
+            issues.push(`Unsafe project provenance path for ${artifact.logicalName} at ${artifact.pathParts.join('/')}: ${errorMessage(error)}`);
+        }
+    }
+    if (manifest.framework.state === 'initialized') {
+        issues.push(...await validateFrameworkInstallation(projectRoot, {
+            workflow: manifest.framework.adapter,
+            agents: manifest.project.agents,
+            ...(manifest.project.defaultAgent ? { defaultAgent: manifest.project.defaultAgent } : {})
+        }));
+    }
+    return issues;
+}
+//# sourceMappingURL=generated-project.js.map

package/dist/application/diagnose/generated-project.js.map

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

package/dist/application/diagnose/validate.d.ts

@@ -0,0 +1,6 @@
+import type { ExecutionContext } from '../context.js';
+export interface ValidationRequest {
+    json: boolean;
+    project?: string;
+}
+export declare function validateProject(request: ValidationRequest, context: ExecutionContext): Promise<number>;

package/dist/application/diagnose/validate.js

@@ -0,0 +1,27 @@
+import path from 'node:path';
+import { findProjectRoot } from '../../adapters/filesystem/project-discovery.js';
+import { validateGeneratedProject } from './generated-project.js';
+export async function validateProject(request, context) {
+    context.presentation.commandIdentity('validate', 'Validate a generated Liftoff project');
+    const { json: jsonMode, project: explicit } = request;
+    const projectRoot = explicit
+        ? path.resolve(context.cwd, explicit)
+        : (await findProjectRoot(context.cwd)) ?? context.cwd;
+    const issues = await validateGeneratedProject(projectRoot);
+    if (jsonMode) {
+        context.presentation.rawStdout(`${JSON.stringify({
+            schemaVersion: 1,
+            projectRoot,
+            valid: issues.length === 0,
+            issues
+        }, null, 2)}\n`);
+        return issues.length === 0 ? 0 : 1;
+    }
+    if (issues.length > 0) {
+        context.presentation.error(issues.join('\n'), 'Restore invalid generated files or the manifest from version control, then rerun validation.');
+        return 1;
+    }
+    context.presentation.status('success', 'Generated project manifest is valid', projectRoot);
+    return 0;
+}
+//# sourceMappingURL=validate.js.map

package/dist/application/diagnose/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/application/diagnose/validate.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,eAAe,EAChB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAShC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA0B,EAAE,OAAyB;IACzF,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,UAAU,EAAE,sCAAsC,CAAC,CAAC;IACzF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACtD,MAAM,WAAW,GAAG,QAAQ;QAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC;QACrC,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAC3D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,YAAY,CAAC,SAAS,CAC5B,GAAG,IAAI,CAAC,SAAS,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;SACP,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAChB,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,YAAY,CAAC,KAAK,CACxB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EACjB,8FAA8F,CAC/F,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,qCAAqC,EAAE,WAAW,CAAC,CAAC;IAC3F,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/application/initialize/fixture.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectOptions } from '../../domain/project/contracts.js';
+export declare function createFixtureProject(options: ProjectOptions): Promise<string>;

package/dist/application/initialize/fixture.js

@@ -0,0 +1,39 @@
+import { mkdir, mkdtemp, rm } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { artifactPath } from '../../adapters/filesystem/project-paths.js';
+import { assertNewOrEmptyDirectory, writeArtifacts, writeProjectFile } from '../../adapters/filesystem/project-files.js';
+import { buildProjectPlan } from '../project/planning.js';
+import { buildArtifacts } from '../../templates.js';
+export async function createFixtureProject(options) {
+    const tempRoot = await mkdtemp(path.join(os.tmpdir(), 'liftoff-'));
+    const plan = buildProjectPlan(options, { requireProjectName: true });
+    const target = artifactPath(tempRoot, [plan.safeProjectName]);
+    await mkdir(target, { recursive: true });
+    await assertNewOrEmptyDirectory(target);
+    await rm(target, { recursive: true, force: true });
+    await writeArtifacts(target, buildArtifacts(plan));
+    for (const marker of [
+        ...plan.framework.baseMarkers,
+        ...plan.agents.flatMap((agent) => plan.framework.agentMarkers[agent.id])
+    ]) {
+        let content = 'fixture marker\n';
+        if (marker.join('/') === '.specify/integration.json') {
+            const installed = plan.agents.map((agent) => agent.integrationIds['spec-kit']);
+            const defaultIntegration = plan.defaultAgent?.integrationIds['spec-kit'];
+            content = `${JSON.stringify({
+                integration_state_schema: 1,
+                integration: defaultIntegration,
+                default_integration: defaultIntegration,
+                installed_integrations: installed,
+                integration_settings: {}
+            }, null, 2)}\n`;
+        }
+        else if (marker.join('/') === '.specify/init-options.json') {
+            content = '{}\n';
+        }
+        await writeProjectFile(target, marker, content);
+    }
+    return target;
+}
+//# sourceMappingURL=fixture.js.map

package/dist/application/initialize/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../../src/application/initialize/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,OAAO,EACP,EAAE,EACH,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,YAAY,EACb,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,gBAAgB,EACjB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACf,MAAM,oBAAoB,CAAC;AAK5B,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAuB;IAChE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,KAAK,MAAM,MAAM,IAAI;QACnB,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW;QAC7B,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;KACzE,EAAE,CAAC;QACF,IAAI,OAAO,GAAG,kBAAkB,CAAC;QACjC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,2BAA2B,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;YAC/E,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;YACzE,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC1B,wBAAwB,EAAE,CAAC;gBAC3B,WAAW,EAAE,kBAAkB;gBAC/B,mBAAmB,EAAE,kBAAkB;gBACvC,sBAAsB,EAAE,SAAS;gBACjC,oBAAoB,EAAE,EAAE;aACzB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,4BAA4B,EAAE,CAAC;YAC7D,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;QACD,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/application/initialize/inputs.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectOptions } from '../../domain/project/contracts.js';
+export declare function assertSupportedProjectOptions(options: ProjectOptions): void;
+export declare function hasMissingInitInputs(rawOptions: ProjectOptions): boolean;

package/dist/application/initialize/inputs.js

@@ -0,0 +1,35 @@
+import { getCodingAgent, getProjectType, projectInputCatalog } from '../project/catalog.js';
+import { normalizeProjectOptions, resolveProjectTypeInput } from '../../domain/project/inputs.js';
+import { PlanValidationError } from '../../domain/project/planning.js';
+import { isRetiredPowerAppsWorkload, retiredPowerAppsMessage } from '../../domain/project/retired-workload.js';
+export function assertSupportedProjectOptions(options) {
+    if (isRetiredPowerAppsWorkload(options.projectType)) {
+        throw new PlanValidationError([retiredPowerAppsMessage(String(options.projectType))]);
+    }
+}
+export function hasMissingInitInputs(rawOptions) {
+    const options = normalizeProjectOptions(rawOptions, projectInputCatalog);
+    const projectType = resolveProjectTypeInput(options, getProjectType).projectType?.id;
+    const missingTypeSpecific = projectType === 'genai'
+        ? !options.pattern
+        : projectType === 'standard'
+            ? !options.apiStack
+            : true;
+    const missingDefaultAgent = options.specWorkflow === 'spec-kit' &&
+        (options.agents?.length ?? 0) > 1 &&
+        !options.defaultAgent;
+    const missingCopilotCloud = options.specWorkflow === 'openspec' &&
+        options.agents?.some((agent) => getCodingAgent(agent)?.id === 'github-copilot') === true &&
+        options.copilotCloud === undefined;
+    return !options.projectName ||
+        missingTypeSpecific ||
+        !options.cloud ||
+        options.includeFrontend === undefined ||
+        !options.specWorkflow ||
+        !options.agents ||
+        !options.governanceProfile ||
+        missingDefaultAgent ||
+        missingCopilotCloud ||
+        !options.environments;
+}
+//# sourceMappingURL=inputs.js.map

package/dist/application/initialize/inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../../../src/application/initialize/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAE/G,MAAM,UAAU,6BAA6B,CAAC,OAAuB;IACnE,IAAI,0BAA0B,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,mBAAmB,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAA0B;IAC7D,MAAM,OAAO,GAAG,uBAAuB,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IACrF,MAAM,mBAAmB,GAAG,WAAW,KAAK,OAAO;QACjD,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;QAClB,CAAC,CAAC,WAAW,KAAK,UAAU;YAC1B,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ;YACnB,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,mBAAmB,GAAG,OAAO,CAAC,YAAY,KAAK,UAAU;QAC7D,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACjC,CAAC,OAAO,CAAC,YAAY,CAAC;IACxB,MAAM,mBAAmB,GAAG,OAAO,CAAC,YAAY,KAAK,UAAU;QAC7D,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,gBAAgB,CAAC,KAAK,IAAI;QACxF,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC;IACrC,OAAO,CAAC,OAAO,CAAC,WAAW;QACzB,mBAAmB;QACnB,CAAC,OAAO,CAAC,KAAK;QACd,OAAO,CAAC,eAAe,KAAK,SAAS;QACrC,CAAC,OAAO,CAAC,YAAY;QACrB,CAAC,OAAO,CAAC,MAAM;QACf,CAAC,OAAO,CAAC,iBAAiB;QAC1B,mBAAmB;QACnB,mBAAmB;QACnB,CAAC,OAAO,CAAC,YAAY,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,23 @@
+import { InteractivePrompter } from '../../interactive.js';
+import { type CommandRunner } from '../../process-runner.js';
+import { PresentationSession } from '../../terminal.js';
+import type { ExecutionContext } from '../context.js';
+import type { ProjectOptions, ProjectPlan } from '../../domain/project/contracts.js';
+import { type RequirementProbeResult } from '../../workstation.js';
+export declare function initializeProject(input: ProjectOptions, context: ExecutionContext): Promise<number>;
+interface WorkstationReadinessResult {
+    ready: boolean;
+    deferred: string[];
+    probes: RequirementProbeResult[];
+}
+interface OpenSpecProfileReadinessResult {
+    ready: boolean;
+    changed: boolean;
+}
+export declare function ensureWorkstationReady(plan: ProjectPlan, options: ProjectOptions, context: ExecutionContext, runner: CommandRunner, presentation: PresentationSession, prompter?: InteractivePrompter, resumeInvocation?: string, commandCwd?: string): Promise<WorkstationReadinessResult>;
+export declare function ensureOpenSpecProfileReady(plan: ProjectPlan, options: ProjectOptions, context: ExecutionContext, runner: CommandRunner, presentation: PresentationSession, prompter?: InteractivePrompter, resumeInvocation?: string): Promise<OpenSpecProfileReadinessResult>;
+export declare function handleProjectDependencies(plan: ProjectPlan, projectRoot: string, options: ProjectOptions, probes: RequirementProbeResult[], context: ExecutionContext, runner: CommandRunner, presentation: PresentationSession, prompter?: InteractivePrompter): Promise<{
+    success: boolean;
+    deferred: string[];
+}>;
+export {};

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

@@ -0,0 +1,360 @@
+import path from 'node:path';
+import { withProjectMutationLock } from '../../adapters/filesystem/project-lock.js';
+import { formatRequirementVersion } from '../../domain/workstation/constraints.js';
+import { initializeFramework } from '../../framework-adapters.js';
+import { validateGeneratedProject } from '../diagnose/generated-project.js';
+import { InteractiveCancelledError, InteractivePrompter } from '../../interactive.js';
+import { applyMergePreflight, assertSafeInitTarget, authorizeMergePreflight, buildMergePreflight, discoverGitRoot, resolveInitTargetFromDiscovery, validateStagedTree, withStagingArea, writeStagedArtifacts } from '../../init-filesystem.js';
+import { buildOpenSpecProfileWriteCommands, configureOpenSpecProfile, inspectOpenSpecProfile, OPEN_SPEC_DELIVERY, OPEN_SPEC_PROFILE, OPEN_SPEC_WORKFLOW_IDS } from '../../openspec-profile.js';
+import { buildProjectPlan } from '../project/planning.js';
+import { projectPlanEntries } from '../../domain/project/planning.js';
+import { buildDependencySetupPlan, dependencyResumeCommand, dependencyResumeShell, runDependencySetup } from '../../project-dependencies.js';
+import { formatCommand, NodeCommandRunner } from '../../process-runner.js';
+import { buildArtifacts, partitionGeneratedArtifacts } from '../../templates.js';
+import { blockingReadinessFailures, detectHostEnvironment, installRequirement, probeWorkstation, selectWorkstationRequirements } from '../../workstation.js';
+import { assertSupportedProjectOptions, hasMissingInitInputs } from './inputs.js';
+export async function initializeProject(input, context) {
+    const { presentation } = context;
+    assertSupportedProjectOptions(input);
+    const runner = context.runner ?? new NodeCommandRunner();
+    let initial = input;
+    presentation.stage('Discover project context');
+    const git = await discoverGitRoot(context.cwd, runner);
+    if (!initial.projectName && git.exact && git.root) {
+        initial = { ...initial, projectName: path.basename(git.root) };
+    }
+    const interactive = initial.yes !== true;
+    const prompter = interactive
+        ? new InteractivePrompter({
+            input: context.stdin,
+            output: context.stdout,
+            presentation,
+            cwd: context.cwd,
+            configuredRoot: git.exact ? git.root : undefined,
+            runner
+        })
+        : undefined;
+    try {
+        const needsPrompts = interactive && hasMissingInitInputs(initial);
+        if (needsPrompts) {
+            presentation.stage('Configure project');
+        }
+        let options;
+        let plan;
+        let confirmed;
+        try {
+            options = needsPrompts ? await prompter.promptForInitOptions(initial) : initial;
+            plan = buildProjectPlan(options, { requireProjectName: true });
+            presentation.stage('Review resolved plan');
+            confirmed = options.yes === true
+                ? (presentation.definitions('Resolved project plan', projectPlanEntries(plan)), true)
+                : await prompter.confirmPlan(plan);
+        }
+        catch (error) {
+            if (error instanceof InteractiveCancelledError) {
+                presentation.cancellation('Initialization stopped; no destination files were changed.');
+                return 0;
+            }
+            throw error;
+        }
+        if (!confirmed) {
+            presentation.cancellation('Initialization stopped; no destination files were changed.');
+            return 0;
+        }
+        presentation.stage('Resolve destination');
+        const target = resolveInitTargetFromDiscovery(git, plan.safeProjectName);
+        await assertSafeInitTarget(target, target.mode === 'named-child' ? git.canonicalCwd : undefined);
+        presentation.stage('Check workstation readiness');
+        const readiness = await ensureWorkstationReady(plan, options, context, runner, presentation, prompter);
+        if (!readiness.ready) {
+            return 1;
+        }
+        const profileReadiness = await ensureOpenSpecProfileReady(plan, options, context, runner, presentation, prompter);
+        if (!profileReadiness.ready) {
+            return 1;
+        }
+        return await withProjectMutationLock(target.root, async () => {
+            presentation.stage('Stage project files');
+            const staged = await withStagingArea(async (area) => {
+                const partition = partitionGeneratedArtifacts(buildArtifacts(plan));
+                await writeStagedArtifacts(area, partition.liftoff, 'liftoff');
+                presentation.stage('Initialize spec-driven framework', `${plan.specWorkflow.label} ${plan.framework.version}`);
+                await initializeFramework(area, plan, runner, {
+                    env: context.env,
+                    ...presentation.childStreams(),
+                    onCommand: (command) => presentation.command(command)
+                });
+                await writeStagedArtifacts(area, partition.seed, 'seed');
+                await writeStagedArtifacts(area, [partition.manifest], 'liftoff');
+                presentation.stage('Validate staged project');
+                await validateStagedTree(area);
+                const stagedIssues = await validateGeneratedProject(area.root);
+                if (stagedIssues.length > 0) {
+                    throw new Error(`Staged project validation failed:\n${stagedIssues.join('\n')}`);
+                }
+                const preflight = await buildMergePreflight(area, target.root);
+                const authorized = await authorizeMergePreflight(preflight, options.force === true, interactive ? (paths) => prompter.confirmFileReplacements(paths) : undefined);
+                if (!authorized) {
+                    return {
+                        status: interactive ? 'declined' : 'authorization-required'
+                    };
+                }
+                presentation.stage('Merge staged project', target.root);
+                return { status: 'applied', merge: await applyMergePreflight(authorized) };
+            });
+            if (staged.status === 'declined') {
+                presentation.cancellation('No destination files were changed.');
+                return 0;
+            }
+            if (staged.status === 'authorization-required') {
+                presentation.error('Existing regular-file conflicts require --force in non-interactive mode.', 'Review the listed conflicts, then rerun with `--force` only if every replacement is intended.');
+                return 1;
+            }
+            const issues = await validateGeneratedProject(target.root);
+            if (issues.length > 0) {
+                presentation.error(`Initialized project validation failed:\n${issues.join('\n')}`);
+                return 1;
+            }
+            const dependencyPhase = await handleProjectDependencies(plan, target.root, options, readiness.probes, context, runner, presentation, prompter);
+            if (!dependencyPhase.success) {
+                return 1;
+            }
+            presentation.bullets('Configured integrations', [
+                `${plan.specWorkflow.label} ${plan.framework.version}`,
+                ...plan.agents.map((agent) => `${agent.label}${plan.defaultAgent?.id === agent.id ? ' (default)' : ''}`),
+                ...(plan.specWorkflow.id === 'openspec'
+                    ? [
+                        `OpenSpec global profile: ${profileReadiness.changed ? 'configured' : 'verified'}; ` +
+                            `${OPEN_SPEC_WORKFLOW_IDS.length} workflows; skills and commands`,
+                        ...(plan.agents.some((agent) => agent.id === 'github-copilot')
+                            ? [`GitHub Copilot cloud agent: ${plan.copilotCloud ? 'enabled' : 'disabled'}`]
+                            : [])
+                    ]
+                    : []),
+                plan.governanceProfile.id === 'none'
+                    ? 'Repository governance: disabled'
+                    : `Repository governance: ${plan.governanceProfile.label} policy ${plan.governanceProfile.policyVersion}; local handoff generated, live activation deferred`
+            ]);
+            if (readiness.deferred.length > 0) {
+                presentation.bullets('Deferred advisory checks', readiness.deferred);
+            }
+            if (dependencyPhase.deferred.length > 0) {
+                presentation.bullets('Deferred project dependencies', dependencyPhase.deferred);
+            }
+            presentation.completion(`Initialized ${plan.projectName}`, target.root, [
+                { label: 'Target', value: target.root },
+                { label: 'Spec workflow', value: plan.specWorkflow.label },
+                { label: 'Coding agents', value: plan.agents.map((agent) => agent.label).join(', ') },
+                {
+                    label: 'Repository governance',
+                    value: plan.governanceProfile.id === 'none'
+                        ? 'Disabled'
+                        : 'Deterministic setup generated; run /liftoff-setup next'
+                }
+            ], plan.governanceProfile.id === 'none'
+                ? `liftoff validate ${JSON.stringify(target.root)}`
+                : '/liftoff-setup');
+            return 0;
+        });
+    }
+    finally {
+        prompter?.close();
+    }
+}
+export async function ensureWorkstationReady(plan, options, context, runner, presentation, prompter, resumeInvocation = 'liftoff init', commandCwd) {
+    const requirements = selectWorkstationRequirements(plan);
+    const initialProbes = await probeWorkstation(requirements, runner, { cwd: commandCwd });
+    let probes = initialProbes;
+    presentation.table('Workstation readiness', ['Requirement', 'Level', 'State', 'Detail'], probes.map((probe) => [
+        probe.requirement.definition.label,
+        probe.requirement.severity,
+        probe.state,
+        probe.detail
+    ]));
+    const actionable = probes.filter((probe) => probe.state !== 'ready');
+    const host = await detectHostEnvironment();
+    const installInstruction = (probe) => {
+        const recipe = probe.requirement.definition.install[host.platform];
+        const automatic = recipe && (host.platform !== 'linux' || recipe.manager === 'npm' || recipe.manager === 'uv');
+        if (automatic) {
+            return formatCommand(recipe.command);
+        }
+        if (host.platform === 'linux') {
+            return probe.requirement.definition.linuxRemedies[host.linuxFamily];
+        }
+        return `Install ${probe.requirement.definition.label} manually, then retry.`;
+    };
+    const authorizedInstallations = new Set();
+    if (options.installTools === true) {
+        for (const probe of actionable) {
+            authorizedInstallations.add(probe.requirement.id);
+        }
+    }
+    if (options.installTools === undefined &&
+        options.yes !== true &&
+        actionable.length > 0) {
+        for (const probe of actionable) {
+            const recipe = probe.requirement.definition.install[host.platform];
+            const automatic = recipe && (host.platform !== 'linux' || recipe.manager === 'npm' || recipe.manager === 'uv');
+            const constraint = probe.requirement.exactVersion || probe.requirement.minimumVersion
+                ? `required ${formatRequirementVersion(probe.requirement)}`
+                : 'required to be available';
+            if (await prompter.confirmToolInstallation({
+                label: probe.requirement.definition.label,
+                severity: probe.requirement.severity,
+                purpose: probe.requirement.reasons.join('; '),
+                requirement: constraint,
+                observed: `${probe.state} - ${probe.detail}`,
+                ...(automatic
+                    ? { command: formatCommand(recipe.command) }
+                    : { remedy: installInstruction(probe) })
+            })) {
+                authorizedInstallations.add(probe.requirement.id);
+            }
+        }
+    }
+    if (authorizedInstallations.size > 0) {
+        const updates = new Map();
+        for (const probe of actionable) {
+            if (!authorizedInstallations.has(probe.requirement.id)) {
+                continue;
+            }
+            presentation.stage(`Install ${probe.requirement.definition.label}`, `${probe.state} - ${probe.detail}`);
+            const recipe = probe.requirement.definition.install[host.platform];
+            if (recipe && (host.platform !== 'linux' || recipe.manager === 'npm' || recipe.manager === 'uv')) {
+                presentation.command(formatCommand(recipe.command));
+            }
+            const installation = await installRequirement(probe.requirement, probe, {
+                authorized: true,
+                host,
+                runner,
+                cwd: commandCwd,
+                streamOptions: presentation.childStreams()
+            });
+            updates.set(probe.requirement.id, installation.probe);
+            const kind = installation.state === 'installed'
+                ? 'success'
+                : probe.requirement.severity === 'blocking'
+                    ? 'error'
+                    : 'warning';
+            presentation.status(kind, probe.requirement.definition.label, installation.detail);
+            if (installation.remedy) {
+                presentation.command(installation.remedy);
+            }
+        }
+        probes = probes.map((probe) => updates.get(probe.requirement.id) ?? probe);
+    }
+    const blockers = blockingReadinessFailures(probes);
+    if (blockers.length > 0) {
+        for (const blocker of blockers) {
+            presentation.error(`${blocker.requirement.definition.label}: ${blocker.detail}`, installInstruction(blocker));
+        }
+        presentation.error('Workstation readiness is incomplete.', options.installTools
+            ? `Open a new terminal if PATH changed, then rerun \`${resumeInvocation}\` with the same project options.`
+            : `Resume with \`${resumeInvocation} --install-tools\` plus the same project options after reviewing the commands.`);
+        return { ready: false, deferred: [], probes };
+    }
+    const deferred = [
+        ...probes
+            .filter((probe) => probe.requirement.severity === 'advisory' && probe.state !== 'ready')
+            .map((probe) => `${probe.requirement.definition.label}: ${probe.detail} Remedy: ${installInstruction(probe)}`),
+        ...probes.flatMap((probe) => probe.notices
+            .filter((notice) => notice.state !== 'ready')
+            .map((notice) => `${notice.label}: ${notice.detail}${notice.remedy ? ` Remedy: ${notice.remedy}` : ''}`))
+    ];
+    return { ready: true, deferred, probes };
+}
+export async function ensureOpenSpecProfileReady(plan, options, context, runner, presentation, prompter, resumeInvocation = 'liftoff init') {
+    if (plan.specWorkflow.id !== 'openspec') {
+        return { ready: true, changed: false };
+    }
+    presentation.stage('Check OpenSpec global profile');
+    const inspection = await inspectOpenSpecProfile(plan.framework.executable, runner, {
+        cwd: context.cwd,
+        env: context.env
+    });
+    if (inspection.compatible) {
+        presentation.status('success', 'OpenSpec global profile', `${OPEN_SPEC_PROFILE}; ${OPEN_SPEC_DELIVERY}; ${OPEN_SPEC_WORKFLOW_IDS.length} workflows`);
+        return { ready: true, changed: false };
+    }
+    const commands = buildOpenSpecProfileWriteCommands(plan.framework.executable);
+    const authorized = options.configureOpenSpecProfile === true ||
+        (options.configureOpenSpecProfile === undefined &&
+            prompter !== undefined &&
+            await prompter.confirmOpenSpecProfileConfiguration({
+                observed: [
+                    { label: 'Profile', value: inspection.state.profile },
+                    { label: 'Delivery', value: inspection.state.delivery },
+                    {
+                        label: 'Workflows',
+                        value: inspection.state.workflows.length > 0
+                            ? inspection.state.workflows.join(', ')
+                            : '(none)'
+                    }
+                ],
+                required: [
+                    { label: 'Profile', value: OPEN_SPEC_PROFILE },
+                    { label: 'Delivery', value: OPEN_SPEC_DELIVERY },
+                    { label: 'Workflows', value: OPEN_SPEC_WORKFLOW_IDS.join(', ') }
+                ],
+                differences: inspection.differences,
+                commands: commands.map((command) => formatCommand(command))
+            }));
+    if (!authorized) {
+        presentation.error('The global OpenSpec profile does not satisfy the Liftoff template contract.', `Run ${commands.map((command) => `\`${formatCommand(command)}\``).join(', then ')}, ` +
+            `then rerun \`${resumeInvocation}\`; or authorize those commands with ` +
+            '`--configure-openspec-profile`.');
+        return { ready: false, changed: false };
+    }
+    presentation.stage('Configure OpenSpec global profile');
+    await configureOpenSpecProfile(plan.framework.executable, runner, {
+        cwd: context.cwd,
+        env: context.env,
+        ...presentation.childStreams(),
+        onCommand: (command) => presentation.command(formatCommand(command))
+    });
+    presentation.status('success', 'OpenSpec global profile', `${OPEN_SPEC_PROFILE}; ${OPEN_SPEC_DELIVERY}; ${OPEN_SPEC_WORKFLOW_IDS.length} workflows (configured)`);
+    return { ready: true, changed: true };
+}
+export async function handleProjectDependencies(plan, projectRoot, options, probes, context, runner, presentation, prompter) {
+    const dependencyPlan = buildDependencySetupPlan(plan, projectRoot, probes);
+    let installDependencies = options.installDependencies === true;
+    if (options.installDependencies === undefined &&
+        options.yes !== true &&
+        dependencyPlan.commands.length > 0) {
+        installDependencies = await prompter.confirmDependencyInstallation(dependencyPlan.commands);
+    }
+    if (!installDependencies) {
+        return {
+            success: true,
+            deferred: dependencyPlan.commands.map((command) => `${command.label} (${dependencyResumeShell()}): ${dependencyResumeCommand(command)}`)
+        };
+    }
+    presentation.stage('Install project dependencies');
+    const result = await runDependencySetup(dependencyPlan, projectRoot, runner, {
+        ...presentation.childStreams(),
+        onCommand: (command) => {
+            presentation.status('pending', command.label, command.cwd);
+            presentation.command(formatCommand(command.command));
+        }
+    });
+    if (!result.success) {
+        presentation.error('Project dependencies failed', `${result.failed?.label ?? 'dependency command'}: ${result.detail ?? 'unknown failure'}`);
+        presentation.status('info', 'Dependency metadata inspected', 'Changed metadata is preserved for review; no uncertain edits were restored.');
+        presentation.warning('Dependency scripts may have changed other project files; review the working tree before retrying.');
+        if (result.restoredMutations.length > 0) {
+            presentation.warning(`Restored protected files: ${result.restoredMutations.join(', ')}`);
+        }
+        if (result.preservedMutations.length > 0) {
+            presentation.warning(`Preserved metadata changes: ${result.preservedMutations.join(', ')}`);
+        }
+        if (result.resumeCommand) {
+            presentation.status('info', 'Recovery shell', result.resumeShell ?? dependencyResumeShell());
+            presentation.command(result.resumeCommand);
+        }
+        return { success: false, deferred: [] };
+    }
+    presentation.status('success', 'Project dependencies', `${result.completed.length} command${result.completed.length === 1 ? '' : 's'} completed`);
+    return { success: true, deferred: [] };
+}
+//# sourceMappingURL=use-case.js.map