@msn-control/liftoff 0.3.3 → 0.4.0

package/dist/terminal.js

@@ -0,0 +1,182 @@
+import picocolors, { createColors } from 'picocolors';
+export const LIFTOFF_WORDMARK = [
+    ' _     ___ _____ _____ ___  _____ _____',
+    '| |   |_ _|  ___|_   _/ _ \\|  ___|  ___|',
+    '| |    | || |_    | || | | | |_  | |_',
+    '| |___ | ||  _|   | || |_| |  _| |  _|',
+    '|_____|___|_|     |_| \\___/|_|   |_|'
+];
+const ANSI_PATTERN = /\u001B\[[0-?]*[ -/]*[@-~]/g;
+export function visibleLength(value) {
+    return value.replace(ANSI_PATTERN, '').length;
+}
+function padVisible(value, width) {
+    return `${value}${' '.repeat(Math.max(0, width - visibleLength(value)))}`;
+}
+function wrapLine(value, width) {
+    if (value.length <= width) {
+        return [value];
+    }
+    const words = value.split(/\s+/);
+    const lines = [];
+    let current = '';
+    for (const word of words) {
+        if (word.length > width) {
+            if (current) {
+                lines.push(current);
+                current = '';
+            }
+            for (let index = 0; index < word.length; index += width) {
+                lines.push(word.slice(index, index + width));
+            }
+            continue;
+        }
+        if (!current) {
+            current = word;
+        }
+        else if (current.length + word.length + 1 <= width) {
+            current += ` ${word}`;
+        }
+        else {
+            lines.push(current);
+            current = word;
+        }
+    }
+    if (current) {
+        lines.push(current);
+    }
+    return lines.length > 0 ? lines : [''];
+}
+export class TerminalRenderer {
+    options;
+    columns;
+    layout;
+    colorEnabled;
+    jsonMode;
+    colors;
+    constructor(options) {
+        this.options = options;
+        const stream = options.stream;
+        const env = options.env ?? process.env;
+        this.columns = Math.max(20, options.columns ?? stream.columns ?? 80);
+        this.jsonMode = options.json ?? false;
+        const tty = stream.isTTY === true;
+        const noColor = Object.hasOwn(env, 'NO_COLOR');
+        this.colorEnabled = !this.jsonMode && !options.snapshot && !noColor &&
+            (options.color ?? (tty && !noColor && picocolors.isColorSupported));
+        this.colors = createColors(this.colorEnabled);
+        this.layout = this.jsonMode || (!tty && !options.snapshot)
+            ? 'plain'
+            : this.columns >= 96
+                ? 'full'
+                : this.columns >= 64
+                    ? 'compact'
+                    : 'plain';
+    }
+    write(value) {
+        if (value) {
+            this.options.stream.write(value);
+        }
+    }
+    json(value) {
+        return `${JSON.stringify(value, null, 2)}\n`;
+    }
+    banner(subtitle = 'Project workstation and scaffold initializer') {
+        if (this.jsonMode) {
+            return '';
+        }
+        if (this.layout === 'plain') {
+            return `${this.colors.bold('Liftoff')} - ${subtitle}\n`;
+        }
+        if (this.layout === 'compact') {
+            return `${this.colors.bold(this.colors.cyan('LIFTOFF'))}\n${this.colors.dim(subtitle)}\n`;
+        }
+        const contentWidth = Math.min(this.columns - 4, 92);
+        const border = `+${'-'.repeat(contentWidth + 2)}+`;
+        const lines = [
+            ...LIFTOFF_WORDMARK.map((line) => this.colors.cyan(this.colors.bold(line))),
+            '',
+            this.colors.dim(subtitle)
+        ];
+        return [
+            border,
+            ...lines.map((line) => `| ${padVisible(line, contentWidth)} |`),
+            border,
+            ''
+        ].join('\n');
+    }
+    heading(value) {
+        if (this.jsonMode) {
+            return '';
+        }
+        return this.layout === 'plain'
+            ? `${this.colors.bold(value)}\n`
+            : `${this.colors.bold(this.colors.cyan(value))}\n${this.colors.dim('-'.repeat(Math.min(visibleLength(value), this.columns)))}\n`;
+    }
+    panel(title, lines) {
+        if (this.jsonMode) {
+            return '';
+        }
+        if (this.layout !== 'full') {
+            return `${this.heading(title)}${lines.map((line) => `${line}\n`).join('')}`;
+        }
+        const width = Math.min(this.columns - 4, 92);
+        const body = lines.flatMap((line) => wrapLine(line, width));
+        const topLabel = ` ${title} `;
+        const top = `+${this.colors.bold(this.colors.cyan(topLabel))}${'-'.repeat(Math.max(0, width + 2 - topLabel.length))}+`;
+        return [
+            top,
+            ...body.map((line) => `| ${padVisible(line, width)} |`),
+            `+${'-'.repeat(width + 2)}+`,
+            ''
+        ].join('\n');
+    }
+    table(headers, rows) {
+        if (this.jsonMode) {
+            return '';
+        }
+        if (headers.length === 0) {
+            return '';
+        }
+        if (this.layout === 'plain' || this.columns < headers.length * 18) {
+            return rows.map((row) => row.map((cell, index) => `${headers[index] ?? `Column ${index + 1}`}: ${cell}`).join(' | ')).join('\n') + (rows.length ? '\n' : '');
+        }
+        const natural = headers.map((header, index) => Math.max(visibleLength(header), ...rows.map((row) => visibleLength(row[index] ?? ''))));
+        const separators = (headers.length - 1) * 3;
+        const available = Math.max(headers.length * 8, this.columns - separators);
+        const capped = natural.map((width) => Math.min(width, Math.floor(available / headers.length)));
+        const renderRow = (row) => row.map((cell, index) => padVisible(cell, capped[index] ?? 8)).join(' | ');
+        return [
+            this.colors.bold(renderRow(headers)),
+            renderRow(capped.map((width) => '-'.repeat(width))),
+            ...rows.map(renderRow),
+            ''
+        ].join('\n');
+    }
+    status(kind, label, detail) {
+        if (this.jsonMode) {
+            return '';
+        }
+        const tokens = {
+            success: this.colors.green('[ok]'),
+            info: this.colors.cyan('[info]'),
+            warning: this.colors.yellow('[warn]'),
+            error: this.colors.red('[error]'),
+            pending: this.colors.dim('[....]')
+        };
+        return `${tokens[kind]} ${this.colors.bold(label)}${detail ? ` - ${detail}` : ''}\n`;
+    }
+    command(value) {
+        return this.jsonMode ? '' : `${this.colors.magenta('$')} ${this.colors.bold(value)}\n`;
+    }
+    warning(value) {
+        return this.status('warning', 'Warning', value);
+    }
+    error(value) {
+        return this.status('error', 'Error', value);
+    }
+    confirmation(value) {
+        return this.jsonMode ? '' : `${this.colors.yellow('?')} ${this.colors.bold(value)}\n`;
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

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

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[];