@msn-control/liftoff 0.3.4 → 0.4.1

package/dist/types.d.ts

@@ -2,6 +2,7 @@ export type PatternId = 'rag' | 'chatbot' | 'agent' | 'prompt' | 'multi-agent' |
 export type ProviderId = 'azure' | 'aws' | 'gcp';
 export type ProviderStatus = 'available' | 'planned';
 export type SpecWorkflowId = 'openspec' | 'spec-kit';
+export type CodingAgentId = 'github-copilot' | 'claude';
 export type EnvironmentId = 'dev' | 'test' | 'prod';
 export type ScaffoldStatus = 'full' | 'foundation' | 'integration-shell';
 export type ProjectTypeId = 'genai' | 'standard';
@@ -55,6 +56,27 @@ export interface SpecWorkflowDefinition {
     default: boolean;
     description: string;
 }
+export interface ExternalCommand {
+    executable: string;
+    args: string[];
+}
+export interface CodingAgentDefinition {
+    id: CodingAgentId;
+    inputName: string;
+    label: string;
+    aliases: string[];
+    executable: string;
+    integrationIds: Record<SpecWorkflowId, string>;
+}
+export interface FrameworkDefinition {
+    id: SpecWorkflowId;
+    executable: string;
+    version: string;
+    installCommand: ExternalCommand;
+    allowedRoots: string[];
+    baseMarkers: string[][];
+    agentMarkers: Record<CodingAgentId, string[][]>;
+}
 export interface ProjectOptions {
     projectName?: string;
     projectType?: string;
@@ -65,8 +87,13 @@ export interface ProjectOptions {
     includeFrontend?: boolean;
     environments?: string[];
     specWorkflow?: string;
+    agents?: string[];
+    defaultAgent?: string;
     configPath?: string;
     yes?: boolean;
+    force?: boolean;
+    installTools?: boolean;
+    installDependencies?: boolean;
 }
 export interface ProjectPlan {
     projectName: string;
@@ -81,6 +108,9 @@ export interface ProjectPlan {
     frontendStarter: string;
     environments: EnvironmentDefinition[];
     specWorkflow: SpecWorkflowDefinition;
+    agents: CodingAgentDefinition[];
+    defaultAgent?: CodingAgentDefinition;
+    framework: FrameworkDefinition;
     approvedStack: string[];
 }
 export interface GeneratedArtifact {
@@ -96,7 +126,7 @@ export interface ManifestArtifact {
     contentHash: string;
 }
 export interface LiftoffManifest {
-    artifactVersion: 2;
+    artifactVersion: 2 | 3;
     generatedBy: 'Mission Control Liftoff';
     liftoffVersion: string;
     project: {
@@ -108,8 +138,15 @@ export interface LiftoffManifest {
         region: string;
         frontend: boolean;
         specWorkflow: SpecWorkflowId;
+        agents: CodingAgentId[];
+        defaultAgent?: CodingAgentId;
         environments: EnvironmentId[];
     };
+    framework: {
+        state: 'initialized' | 'legacy';
+        adapter: SpecWorkflowId;
+        contractVersion?: string;
+    };
     artifacts: ManifestArtifact[];
 }
 export interface ParsedArgs {

package/dist/workstation-catalog.d.ts

@@ -0,0 +1,20 @@
+import type { ExternalCommand } from './types.js';
+export type WorkstationRequirementId = 'node' | 'python' | 'go' | 'uv' | 'docker' | 'opentofu' | 'azure-cli' | 'openspec' | 'spec-kit' | 'github-copilot' | 'claude';
+export type RequirementSeverity = 'blocking' | 'advisory';
+export type SupportedPlatform = 'darwin' | 'win32' | 'linux';
+export type LinuxFamily = 'debian' | 'fedora' | 'arch' | 'unknown';
+export interface InstallRecipe {
+    command: ExternalCommand;
+    manager: 'brew' | 'winget' | 'npm' | 'uv';
+}
+export interface WorkstationRequirementDefinition {
+    id: WorkstationRequirementId;
+    label: string;
+    severity: RequirementSeverity;
+    probes: ExternalCommand[];
+    minimumVersion?: string;
+    exactVersion?: string;
+    install: Partial<Record<SupportedPlatform, InstallRecipe>>;
+    linuxRemedies: Record<LinuxFamily, string>;
+}
+export declare const workstationRequirementCatalog: Record<WorkstationRequirementId, WorkstationRequirementDefinition>;

package/dist/workstation-catalog.js

@@ -0,0 +1,122 @@
+const linuxRemedies = (url) => ({
+    debian: `Follow the official Debian/Ubuntu installation guide: ${url}`,
+    fedora: `Follow the official Fedora/RHEL installation guide: ${url}`,
+    arch: `Follow the official Arch Linux installation guide: ${url}`,
+    unknown: `Follow the official Linux installation guide: ${url}`
+});
+const winget = (id) => ({
+    manager: 'winget',
+    command: { executable: 'winget', args: ['install', '--id', id, '--exact', '--accept-package-agreements', '--accept-source-agreements'] }
+});
+const brew = (name, cask = false) => ({
+    manager: 'brew',
+    command: { executable: 'brew', args: ['install', ...(cask ? ['--cask'] : []), name] }
+});
+export const workstationRequirementCatalog = {
+    node: {
+        id: 'node',
+        label: 'Node.js',
+        severity: 'blocking',
+        probes: [{ executable: 'node', args: ['--version'] }],
+        minimumVersion: '20.19.0',
+        install: { darwin: brew('node'), win32: winget('OpenJS.NodeJS.LTS') },
+        linuxRemedies: linuxRemedies('https://nodejs.org/en/download/package-manager')
+    },
+    python: {
+        id: 'python',
+        label: 'Python',
+        severity: 'blocking',
+        probes: [
+            { executable: 'python3', args: ['--version'] },
+            { executable: 'python', args: ['--version'] },
+            { executable: 'py', args: ['-3', '--version'] }
+        ],
+        minimumVersion: '3.11.0',
+        install: { darwin: brew('python@3.12'), win32: winget('Python.Python.3.12') },
+        linuxRemedies: linuxRemedies('https://www.python.org/downloads/')
+    },
+    go: {
+        id: 'go',
+        label: 'Go',
+        severity: 'blocking',
+        probes: [{ executable: 'go', args: ['version'] }],
+        minimumVersion: '1.23.0',
+        install: { darwin: brew('go'), win32: winget('GoLang.Go') },
+        linuxRemedies: linuxRemedies('https://go.dev/doc/install')
+    },
+    uv: {
+        id: 'uv',
+        label: 'uv',
+        severity: 'blocking',
+        probes: [{ executable: 'uv', args: ['--version'] }],
+        install: { darwin: brew('uv'), win32: winget('astral-sh.uv') },
+        linuxRemedies: linuxRemedies('https://docs.astral.sh/uv/getting-started/installation/')
+    },
+    docker: {
+        id: 'docker',
+        label: 'Docker',
+        severity: 'advisory',
+        probes: [{ executable: 'docker', args: ['--version'] }],
+        install: { darwin: brew('docker', true), win32: winget('Docker.DockerDesktop') },
+        linuxRemedies: linuxRemedies('https://docs.docker.com/engine/install/')
+    },
+    opentofu: {
+        id: 'opentofu',
+        label: 'OpenTofu',
+        severity: 'advisory',
+        probes: [{ executable: 'tofu', args: ['--version'] }],
+        install: { darwin: brew('opentofu'), win32: winget('OpenTofu.OpenTofu') },
+        linuxRemedies: linuxRemedies('https://opentofu.org/docs/intro/install/')
+    },
+    'azure-cli': {
+        id: 'azure-cli',
+        label: 'Azure CLI',
+        severity: 'advisory',
+        probes: [{ executable: 'az', args: ['version', '--output', 'json'] }],
+        install: { darwin: brew('azure-cli'), win32: winget('Microsoft.AzureCLI') },
+        linuxRemedies: linuxRemedies('https://learn.microsoft.com/cli/azure/install-azure-cli-linux')
+    },
+    openspec: {
+        id: 'openspec',
+        label: 'OpenSpec',
+        severity: 'blocking',
+        probes: [{ executable: 'openspec', args: ['--version'] }],
+        exactVersion: '1.6.0',
+        install: {
+            darwin: { manager: 'npm', command: { executable: 'npm', args: ['install', '-g', '@fission-ai/openspec@1.6.0'] } },
+            win32: { manager: 'npm', command: { executable: 'npm', args: ['install', '-g', '@fission-ai/openspec@1.6.0'] } },
+            linux: { manager: 'npm', command: { executable: 'npm', args: ['install', '-g', '@fission-ai/openspec@1.6.0'] } }
+        },
+        linuxRemedies: linuxRemedies('https://github.com/Fission-AI/OpenSpec')
+    },
+    'spec-kit': {
+        id: 'spec-kit',
+        label: 'Spec Kit',
+        severity: 'blocking',
+        probes: [{ executable: 'specify', args: ['--version'] }],
+        exactVersion: '0.14.1',
+        install: {
+            darwin: { manager: 'uv', command: { executable: 'uv', args: ['tool', 'install', 'specify-cli==0.14.1'] } },
+            win32: { manager: 'uv', command: { executable: 'uv', args: ['tool', 'install', 'specify-cli==0.14.1'] } },
+            linux: { manager: 'uv', command: { executable: 'uv', args: ['tool', 'install', 'specify-cli==0.14.1'] } }
+        },
+        linuxRemedies: linuxRemedies('https://github.com/github/spec-kit')
+    },
+    'github-copilot': {
+        id: 'github-copilot',
+        label: 'GitHub Copilot',
+        severity: 'blocking',
+        probes: [{ executable: 'copilot', args: ['--version'] }],
+        install: { darwin: brew('copilot-cli', true), win32: winget('GitHub.Copilot') },
+        linuxRemedies: linuxRemedies('https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli')
+    },
+    claude: {
+        id: 'claude',
+        label: 'Claude Code',
+        severity: 'blocking',
+        probes: [{ executable: 'claude', args: ['--version'] }],
+        install: { darwin: brew('claude-code', true), win32: winget('Anthropic.ClaudeCode') },
+        linuxRemedies: linuxRemedies('https://docs.anthropic.com/en/docs/claude-code/setup')
+    }
+};
+//# sourceMappingURL=workstation-catalog.js.map

package/dist/workstation-catalog.js.map

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

package/dist/workstation.d.ts

@@ -0,0 +1,76 @@
+import { type LinuxFamily, type RequirementSeverity, type SupportedPlatform, type WorkstationRequirementDefinition, type WorkstationRequirementId } from './workstation-catalog.js';
+import type { CommandRunner, RunCommandOptions } from './process-runner.js';
+import type { ApiStackId, CodingAgentId, ProviderId, ProjectPlan, SpecWorkflowId } from './types.js';
+export type RequirementState = 'ready' | 'missing' | 'outdated' | 'unhealthy' | 'not-observable';
+export interface SelectedRequirement {
+    id: WorkstationRequirementId;
+    definition: WorkstationRequirementDefinition;
+    severity: RequirementSeverity;
+    reasons: string[];
+    minimumVersion?: string;
+    exactVersion?: string;
+}
+export interface ReadinessNotice {
+    label: string;
+    state: 'ready' | 'unhealthy' | 'not-observable';
+    detail: string;
+    remedy?: string;
+}
+export interface RequirementProbeResult {
+    requirement: SelectedRequirement;
+    state: RequirementState;
+    detail: string;
+    detectedVersion?: string;
+    detectedBy?: string;
+    remedy?: string;
+    notices: ReadinessNotice[];
+}
+export interface WorkstationRequirementSelection {
+    apiStack: {
+        id: ApiStackId;
+    };
+    specWorkflow: {
+        id: SpecWorkflowId;
+    };
+    framework: {
+        version: string;
+    };
+    provider: {
+        id: ProviderId;
+    };
+    agents: Array<{
+        id: CodingAgentId;
+        label: string;
+    }>;
+}
+export interface RequirementSelectionOptions {
+    includeFramework?: boolean;
+}
+export interface HostEnvironment {
+    platform: SupportedPlatform;
+    linuxFamily: LinuxFamily;
+}
+export type InstallState = 'installed' | 'declined' | 'manual' | 'failed' | 'restart-required';
+export interface InstallResult {
+    requirement: SelectedRequirement;
+    state: InstallState;
+    detail: string;
+    command?: string;
+    probe: RequirementProbeResult;
+    remedy?: string;
+}
+export declare function extractVersion(output: string): string | undefined;
+export declare function selectLiftoffRuntimeRequirements(): SelectedRequirement[];
+export declare function selectWorkstationRequirements(plan: ProjectPlan | WorkstationRequirementSelection, options?: RequirementSelectionOptions): SelectedRequirement[];
+export declare function probeRequirement(requirement: SelectedRequirement, runner: CommandRunner, options?: Pick<RunCommandOptions, 'cwd'>): Promise<RequirementProbeResult>;
+export declare function probeWorkstation(requirements: SelectedRequirement[], runner: CommandRunner, options?: Pick<RunCommandOptions, 'cwd'>): Promise<RequirementProbeResult[]>;
+export declare function parseLinuxFamily(osRelease: string): LinuxFamily;
+export declare function detectHostEnvironment(platform?: NodeJS.Platform, osReleasePath?: string): Promise<HostEnvironment>;
+export declare function installRequirement(requirement: SelectedRequirement, currentProbe: RequirementProbeResult, context: {
+    authorized: boolean;
+    host: HostEnvironment;
+    runner: CommandRunner;
+    cwd?: string;
+    streamOptions?: Pick<RunCommandOptions, 'stdout' | 'stderr'>;
+}): Promise<InstallResult>;
+export declare function blockingReadinessFailures(results: RequirementProbeResult[]): RequirementProbeResult[];