@msn-control/liftoff 0.2.1 → 0.3.1

package/README.md

@@ -2,7 +2,7 @@
 
 Status: implemented.
 
-Liftoff is the Mission Control Launchpad Engine package under `tools/liftoff-cli`. It exposes the `liftoff` command and scaffolds enterprise GenAI applications with FastAPI, PydanticAI, Docker Compose, OpenTofu, and spec-driven governance assets.
+Liftoff is the Mission Control Launchpad Engine package under `tools/liftoff-cli`. It exposes the `liftoff` command and scaffolds governed GenAI applications or standard APIs with Docker Compose, OpenTofu, and spec-driven governance assets.
 
 ## Installation
 
@@ -12,20 +12,177 @@ Install the latest stable CLI globally:
 npm install -g @msn-control/liftoff@latest
 ```
 
-After installation, run:
+After installation, confirm the command is available:
 
 ```bash
 liftoff help
-liftoff create
 ```
 
-## Contract conventions
+## Quick Start
+
+Preview a generated project before writing files:
+
+```bash
+liftoff plan --pattern rag --cloud azure --region eastus --frontend
+```
+
+Create a project non-interactively:
+
+```bash
+liftoff create claims-copilot --pattern rag --cloud azure --region eastus --spec openspec --frontend --yes
+cd claims-copilot
+cp .env.example .env
+liftoff validate
+liftoff doctor
+```
+
+Create a standard Node.js API without GenAI components:
+
+```bash
+liftoff plan --no-genai --api node --cloud azure --region eastus
+liftoff create claims-api --no-genai --api node --cloud azure --region eastus --spec openspec --no-frontend --yes
+```
+
+Standard API choices are `python` (FastAPI), `node` (Fastify with TypeScript), and `go` (Huma v2 with Chi). Existing GenAI commands that provide `--pattern` continue to infer the GenAI project type and Python/FastAPI stack.
+
+Use the local development helper to print the Docker Compose command, then run the printed command:
+
+```bash
+liftoff dev up
+docker compose up --build
+```
+
+For an existing project, create a Liftoff-shaped sibling scaffold and staged migration plan without modifying the source project:
+
+```bash
+liftoff migrate ../legacy-app --region eastus --yes
+```
+
+## How Liftoff Works
+
+Liftoff turns a small set of project decisions into a deterministic scaffold and records what it wrote so future CLI versions can reconcile safely.
+
+```text
+plan -> create or migrate -> validate and doctor -> update -> dev and infra helpers
+```
+
+- `liftoff plan` resolves flags or config into a project plan, renders the artifact list, and writes nothing.
+- `liftoff create` first determines whether the project is GenAI or standard. GenAI projects select a pattern and use Python/FastAPI/PydanticAI; standard projects select an approved Python, Node.js, or Go API stack. Both flows collect cloud, region, frontend, environments, and spec workflow.
+- `liftoff migrate <path>` scans a legacy project, generates a fresh sibling Liftoff scaffold, stages a filtered legacy copy under `migration/legacy`, and emits an OpenSpec migration change or `MIGRATION.md`.
+- `liftoff validate` checks that `liftoff.manifest.json` can be loaded and every durable manifest artifact exists on disk.
+- `liftoff doctor` runs read-only readiness checks. Outside a generated project it checks the local environment; inside a generated project it also checks manifest health, scaffold drift, runtime configuration, cloud auth, and Azure Functions tooling for worker-enabled Azure projects.
+- `liftoff update` checks scaffold drift by default and writes nothing. It exits 0 when clean and 2 when drift exists, which makes it usable as a CI drift gate.
+- `liftoff update --apply` writes safe changes such as new, missing, moved, or untouched upgraded artifacts. It skips conflicts unless `--force` is also provided, and it reports orphaned files without deleting them automatically.
+- `liftoff dev` prints Docker Compose helper commands such as `docker compose up --build`, `docker compose logs -f`, and `docker compose down --volumes`.
+- `liftoff infra` prints OpenTofu helper commands such as `tofu init`, `tofu plan -var-file=environments/dev.tfvars`, and `tofu apply -var-file=environments/dev.tfvars`.
+
+Discovery commands are available for the catalogs that drive generation:
+
+```bash
+liftoff patterns
+liftoff providers
+liftoff regions
+liftoff regions search korea --cloud azure
+```
+
+Azure is the available V1 provider. AWS and GCP are listed as planned provider adapters and are rejected before generation.
+
+## Strict Commands And Safe Recovery
+
+Liftoff validates each command before running it. Unknown flags or subcommands, missing flag values, invalid booleans, incompatible duplicates, and extra positional arguments exit 1 without generating files or printing a fallback helper command. Use command-specific help to see the accepted syntax:
+
+```bash
+liftoff create --help
+liftoff update --help
+liftoff regions --help
+```
+
+`liftoff update --apply` preflights every path and destination before its first mutation. A new or moved artifact is adopted when the destination already contains the rendered bytes; different pre-existing bytes are reported as a conflict and skipped. `--force` overwrites reviewed conflicts. Orphans are reported but never deleted automatically. Any write, replacement, cleanup, or manifest failure exits 1 without a success summary or false manifest state, so fixing the filesystem issue and retrying is safe.
+
+Manifest paths must be portable path-part arrays confined to the project. Traversal, absolute, drive-qualified, UNC, embedded-separator, empty, and symlink-escaping paths are rejected before artifact access. If validation reports an unsafe or malformed manifest, restore `liftoff.manifest.json` from version control or regenerate a fresh project with the matching Liftoff version. Do not repair the issue by weakening path validation or by retaining a hand-edited unsafe path.
+
+## Generated Integration Configuration
+
+GenAI starters contain executable, offline-testable integration boundaries:
+
+- `PYDANTIC_AI_MODEL` selects the production PydanticAI model. Invoking an unconfigured production agent raises a clear configuration error rather than returning a successful placeholder.
+- Redis Streams publishing uses `REDIS_URL` and `REDIS_STREAM_NAME`.
+- Azure Service Bus publishing uses `SERVICE_BUS_QUEUE_NAME` and either `SERVICE_BUS_CONNECTION_STRING` or `SERVICE_BUS_FULLY_QUALIFIED_NAMESPACE`; `AZURE_CLIENT_ID` selects a user-assigned managed identity.
+- Langfuse tracing requires both `LANGFUSE_PUBLIC_KEY` and `LANGFUSE_SECRET_KEY`, with optional `LANGFUSE_HOST`. Without both keys, tracing is explicitly disabled and reports no remote trace ID.
+- Generated frontends read `VITE_API_BASE_URL` from `frontend/.env`, call the route selected by the project pattern or API stack, and expose loading, response, and failure states.
+- Generated backends allow the local frontend origin by default. Set the comma-separated `CORS_ALLOWED_ORIGINS` value whenever `VITE_API_BASE_URL` points at a frontend on another origin; generated Azure infrastructure sets it to the deployed frontend URL.
+
+Generated backend, messaging, tracing, and orchestration tests require no external model, Redis, Service Bus, or Langfuse service. Each generated README includes the fresh-project install, build, and test commands for its selected stack.
+
+## Azure Deployment Contracts
+
+Environment tfvars contain a deterministic 12-character lowercase alphanumeric `resource_suffix` for globally scoped Azure names. If Azure reports a collision, replace that environment's suffix with another unique value matching `^[a-z0-9]{12}$`; `tofu validate` rejects invalid overrides.
+
+Worker-enabled projects configure `ServiceBusConnection__fullyQualifiedNamespace` and `ServiceBusConnection__clientId` for the attached user-assigned identity, and grant that identity's principal the Service Bus Data Receiver role. `function_worker_queue_name` drives the provisioned queue, Function setting, and output. Function host storage uses one complete key-backed `AzureWebJobsStorage` configuration rather than mixed partial identity settings.
+
+## Generated Project Structure
+
+Generated paths below are logical project structure examples. The CLI writes them using platform-correct filesystem handling on macOS, Linux, and Windows, and machine-readable manifests store path parts rather than joined path strings.
+
+```text
+claims-copilot/
+|-- README.md
+|-- liftoff.config.json
+|-- liftoff.manifest.json
+|-- .env.example
+|-- Dockerfile
+|-- docker-compose.yml
+|-- backend/                  # internals depend on the selected API stack
+|-- database/
+|   |-- alembic.ini
+|   |-- migrations/
+|   `-- models/
+|-- environments/
+|   |-- dev/
+|   |-- test/
+|   `-- prod/
+|-- infrastructure/
+|   `-- opentofu/
+|       `-- azure/
+|-- openspec/ or .specify/
+|-- frontend/                  # only when frontend generation is selected
+|-- functions/<worker-name>/    # only for worker-enabled Azure patterns
+`-- migration/legacy/           # only for projects created by liftoff migrate
+```
+
+Core generated areas:
+
+- `backend` contains the selected API stack and Scalar/OpenAPI wiring. Python uses `backend/apis`, Node.js uses `backend/src`, and Go uses `backend/cmd/api` plus `backend/internal`.
+- `backend/orchestration` appears only in GenAI projects and contains PydanticAI agents, prompts, model configuration, and integration boundaries.
+- `database` contains stack-native migrations and SQL schema assets: SQLAlchemy/Alembic for Python, Drizzle for Node.js, or pgx/Goose for Go.
+- `environments/<env>` contains environment-specific backend settings, and Functions settings when a worker is generated.
+- `docker-compose.yml` starts the selected backend runtime, PostgreSQL, Redis, Azurite, and Mailpit. GenAI projects use pgvector when required and include the optional Langfuse observability profile.
+- `infrastructure/opentofu/azure` contains Azure OpenTofu modules, environment tfvars, local state configuration, and a remote state example.
+- `openspec` is generated for the OpenSpec workflow; `.specify` and `specs` are generated for the Spec Kit workflow.
+
+Conditional areas:
+
+- `frontend` is generated only when `--frontend` is selected. It uses Vue 3 and Tailwind with a generic API starter for standard projects or an experience matched to the selected GenAI pattern.
+- `functions/<worker-name>` is generated only for worker-enabled Azure GenAI patterns such as RAG, agent, multi-agent, and workflow. Azure Functions trigger adapters live there; reusable GenAI orchestration stays under `backend/orchestration`.
+- `backend/workers` appears for worker-backed patterns as backend-adjacent or containerized worker code, separate from Azure Functions runtime files.
+- `migration/legacy` appears only after `liftoff migrate` and contains a filtered copy of the source project for guided migration work.
+
+## Configuration And Manifest
+
+Generated projects contain two root files with different ownership models:
+
+- `liftoff.config.json` is user-owned desired state after creation. Liftoff writes it once during generation and does not machine-rewrite it afterwards. Supported changes, such as adding an environment or enabling frontend output, are reconciled by `liftoff update`. Project type, API stack, and GenAI pattern changes are migrations and should use `liftoff migrate`.
+- `liftoff.manifest.json` is the CLI-owned compatibility record. Manifest schema v2 records `artifactVersion`, the generating `liftoffVersion`, project type, API stack, applicable GenAI pattern, durable generated artifact `logicalName`s, categories, OS-neutral path parts, and `sha256:` content hashes.
+
+The manifest lets `liftoff validate`, `liftoff doctor`, and `liftoff update` distinguish clean generated files from local edits. Seed content, such as the initial OpenSpec bootstrap change, is written once and intentionally omitted from the durable manifest so it can follow its own lifecycle. Treat the manifest as CLI-owned: restore or regenerate it when validation fails rather than hand-editing artifact paths or hashes.
+
+## Contract Conventions
 
 Generated projects contain persistent files that outlive any CLI release. The following rules are the compatibility contract, enforced by `tests/contract.test.ts` where possible:
 
-- **Manifest schema**: `liftoff.manifest.json` uses `artifactVersion` 2 — the first supported schema version — recording the generating CLI version (`liftoffVersion`) and a `sha256:`-prefixed `contentHash` per artifact. Readers accept every supported version and reject others with a remedy; writers always write the latest version.
-- **Append-only identifiers**: artifact `logicalName`s and catalog ids (patterns, providers, environments, spec workflows) are never renamed or removed, only added. The contract test snapshots the logical-name sets.
-- **Deterministic rendering**: artifact content depends only on the project plan and the template code — no timestamps, randomness, or environment leakage. Verified by a double-render byte-equality test.
+- **Manifest schema**: `liftoff.manifest.json` uses `artifactVersion` 2, the first supported schema version, recording the generating CLI version (`liftoffVersion`) and a `sha256:`-prefixed `contentHash` per artifact. Readers accept every supported version and reject others with a remedy; writers always write the latest version.
+- **Append-only identifiers**: artifact `logicalName`s and catalog ids (project types, API stacks, patterns, providers, environments, spec workflows) are never renamed or removed, only added. The contract test snapshots the logical-name sets.
+- **Deterministic rendering**: artifact content depends only on the project plan and the template code, with no timestamps, randomness, or environment leakage. Verified by a double-render byte-equality test.
 - **Reserved namespaces**: `.liftoff/` in generated projects is reserved for future CLI-managed state; no new CLI-managed root-level files beyond `liftoff.config.json` and `liftoff.manifest.json`. `liftoff.config.json` is written once at generation and never machine-written afterwards.
 - **Portable paths**: machine-readable files store OS-neutral path-part arrays, never joined path strings.
 - **Exit codes**: 0 = success or clean check, 1 = failure, 2 = a check mode found drift.
@@ -57,4 +214,4 @@ npm run smoke:package --workspace @msn-control/liftoff
 
 The `Release Liftoff` workflow builds, tests, packs, smoke-installs, and publishes only the `@msn-control/liftoff` workspace package. Stable versions publish with the `latest` npm dist-tag; prerelease versions publish with `next`.
 
-Prefer npm trusted publishing with provenance for release authentication. If trusted publishing is not configured for the repository and npm organization, create a scoped npm automation token and store it as the repository secret `NPM_TOKEN`.
+Prefer npm trusted publishing for release authentication. The workflow disables provenance while the source repository is private because npm accepts GitHub Actions provenance only from public repositories. If trusted publishing is not configured for the repository and npm organization, create a scoped npm automation token and store it as the repository secret `NPM_TOKEN`.

package/dist/args.d.ts

@@ -1,5 +1,24 @@
 import type { ParsedArgs } from './types.js';
+type FlagKind = 'boolean' | 'value';
+interface FlagDefinition {
+    kind: FlagKind;
+    negatable?: boolean;
+}
+export interface CommandDefinition {
+    description: string;
+    usage: string;
+    flags: Readonly<Record<string, FlagDefinition>>;
+    subcommands?: readonly string[];
+    defaultMaxPositionals: number;
+    subcommandMaxPositionals?: Readonly<Record<string, number>>;
+}
+export declare const commandDefinitions: Readonly<Record<string, CommandDefinition>>;
+export declare class UsageError extends Error {
+    constructor(message: string);
+}
 export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function formatCommandHelp(command: string): string;
 export declare function readStringFlag(flags: ParsedArgs['flags'], name: string): string | undefined;
 export declare function readBooleanFlag(flags: ParsedArgs['flags'], name: string): boolean | undefined;
 export declare function readListFlag(flags: ParsedArgs['flags'], name: string): string[] | undefined;
+export {};

package/dist/args.js

@@ -1,65 +1,242 @@
-const commandsWithSubcommands = new Set(['regions', 'dev', 'infra']);
-const booleanFlags = new Set(['yes', 'frontend', 'help', 'json', 'print']);
-const valueFlags = new Set(['pattern', 'cloud', 'region', 'spec', 'environments', 'config', 'project', 'env', 'profile']);
+const booleanFlag = (negatable = false) => ({ kind: 'boolean', negatable });
+const valueFlag = () => ({ kind: 'value' });
+const helpFlag = { help: booleanFlag() };
+const projectFlags = {
+    project: valueFlag(),
+    genai: booleanFlag(true),
+    api: valueFlag(),
+    pattern: valueFlag(),
+    cloud: valueFlag(),
+    region: valueFlag(),
+    frontend: booleanFlag(true),
+    environments: valueFlag(),
+    spec: valueFlag(),
+    config: valueFlag()
+};
+export const commandDefinitions = {
+    help: {
+        description: 'Show general or command-specific help',
+        usage: '[command]',
+        flags: helpFlag,
+        defaultMaxPositionals: 1
+    },
+    create: {
+        description: 'Generate a new project',
+        usage: '[project-name]',
+        flags: { ...projectFlags, yes: booleanFlag(), ...helpFlag },
+        defaultMaxPositionals: 1
+    },
+    plan: {
+        description: 'Preview generated artifacts',
+        usage: '',
+        flags: { ...projectFlags, ...helpFlag },
+        defaultMaxPositionals: 0
+    },
+    patterns: {
+        description: 'List GenAI patterns',
+        usage: '',
+        flags: helpFlag,
+        defaultMaxPositionals: 0
+    },
+    providers: {
+        description: 'List cloud providers',
+        usage: '',
+        flags: helpFlag,
+        defaultMaxPositionals: 0
+    },
+    regions: {
+        description: 'List or search provider regions',
+        usage: '[search <query>]',
+        flags: { cloud: valueFlag(), region: valueFlag(), ...helpFlag },
+        subcommands: ['search'],
+        defaultMaxPositionals: 0,
+        subcommandMaxPositionals: { search: 1 }
+    },
+    validate: {
+        description: 'Validate a generated project manifest',
+        usage: '[project-path]',
+        flags: { project: valueFlag(), ...helpFlag },
+        defaultMaxPositionals: 1
+    },
+    update: {
+        description: 'Reconcile a project with current templates',
+        usage: '[project-path]',
+        flags: {
+            project: valueFlag(),
+            apply: booleanFlag(),
+            force: booleanFlag(),
+            json: booleanFlag(),
+            ...helpFlag
+        },
+        defaultMaxPositionals: 1
+    },
+    migrate: {
+        description: 'Adopt an existing project',
+        usage: '<source-path>',
+        flags: { ...projectFlags, yes: booleanFlag(), ...helpFlag },
+        defaultMaxPositionals: 1
+    },
+    doctor: {
+        description: 'Check local and project readiness',
+        usage: '',
+        flags: { cloud: valueFlag(), json: booleanFlag(), ...helpFlag },
+        defaultMaxPositionals: 0
+    },
+    dev: {
+        description: 'Print Docker Compose helper commands',
+        usage: '[up|down|logs|reset]',
+        flags: { profile: valueFlag(), ...helpFlag },
+        subcommands: ['up', 'down', 'logs', 'reset'],
+        defaultMaxPositionals: 0,
+        subcommandMaxPositionals: { up: 0, down: 0, logs: 0, reset: 0 }
+    },
+    infra: {
+        description: 'Print OpenTofu helper commands',
+        usage: '[init|plan|apply|output]',
+        flags: { env: valueFlag(), ...helpFlag },
+        subcommands: ['init', 'plan', 'apply', 'output'],
+        defaultMaxPositionals: 0,
+        subcommandMaxPositionals: { init: 0, plan: 0, apply: 0, output: 0 }
+    }
+};
+export class UsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UsageError';
+    }
+}
+function assignFlag(flags, name, value) {
+    if (Object.hasOwn(flags, name)) {
+        throw new UsageError(`Flag --${name} may be provided only once.`);
+    }
+    flags[name] = value;
+}
+function parseBooleanValue(name, value) {
+    if (value === 'true') {
+        return true;
+    }
+    if (value === 'false') {
+        return false;
+    }
+    throw new UsageError(`Flag --${name} expects true or false.`);
+}
 export function parseArgs(argv) {
-    const [command, maybeSubcommand, ...rest] = argv;
+    if (argv.length === 0) {
+        return { positional: [], flags: {} };
+    }
+    if (argv[0] === '--help') {
+        return { command: 'help', positional: [], flags: {} };
+    }
+    const command = argv[0];
+    if (command.startsWith('-')) {
+        throw new UsageError(`Unknown option: ${command}. Run \`liftoff help\` for usage.`);
+    }
+    const definition = commandDefinitions[command];
+    if (!definition) {
+        throw new UsageError(`Unknown command: ${command}. Run \`liftoff help\` for usage.`);
+    }
+    const tokens = argv.slice(1);
+    let subcommand;
+    if (definition.subcommands && tokens[0] && !tokens[0].startsWith('-')) {
+        const candidate = tokens.shift();
+        if (!definition.subcommands.includes(candidate)) {
+            throw new UsageError(`Unsupported ${command} subcommand: ${candidate}. Use one of: ${definition.subcommands.join(', ')}.`);
+        }
+        subcommand = candidate;
+    }
     const positional = [];
     const flags = {};
-    const hasSubcommand = Boolean(command && maybeSubcommand && !maybeSubcommand.startsWith('-') && commandsWithSubcommands.has(command));
-    const tokens = hasSubcommand ? rest : argv.slice(1);
-    const subcommand = hasSubcommand ? maybeSubcommand : undefined;
+    let positionalOnly = false;
     for (let index = 0; index < tokens.length; index += 1) {
         const token = tokens[index];
-        if (!token.startsWith('--')) {
-            positional.push(token);
+        if (token === '--') {
+            positionalOnly = true;
             continue;
         }
-        const withoutPrefix = token.slice(2);
-        if (withoutPrefix.startsWith('no-')) {
-            flags[withoutPrefix.slice(3)] = false;
+        if (positionalOnly || !token.startsWith('-')) {
+            positional.push(token);
             continue;
         }
+        if (!token.startsWith('--')) {
+            throw new UsageError(`Unknown option: ${token}. Liftoff options use --long-name syntax.`);
+        }
+        const withoutPrefix = token.slice(2);
         const equalsIndex = withoutPrefix.indexOf('=');
-        if (equalsIndex >= 0) {
-            const key = withoutPrefix.slice(0, equalsIndex);
-            flags[key] = withoutPrefix.slice(equalsIndex + 1);
+        const rawName = equalsIndex >= 0 ? withoutPrefix.slice(0, equalsIndex) : withoutPrefix;
+        const inlineValue = equalsIndex >= 0 ? withoutPrefix.slice(equalsIndex + 1) : undefined;
+        const negated = rawName.startsWith('no-');
+        const name = negated ? rawName.slice(3) : rawName;
+        const flagDefinition = definition.flags[name];
+        if (!flagDefinition) {
+            throw new UsageError(`Unknown flag for ${command}: --${rawName}.`);
+        }
+        if (negated) {
+            if (inlineValue !== undefined || flagDefinition.kind !== 'boolean' || !flagDefinition.negatable) {
+                throw new UsageError(`Flag --${name} does not support the --no-${name} form.`);
+            }
+            assignFlag(flags, name, false);
             continue;
         }
-        if (booleanFlags.has(withoutPrefix)) {
-            flags[withoutPrefix] = true;
+        if (flagDefinition.kind === 'boolean') {
+            assignFlag(flags, name, inlineValue === undefined ? true : parseBooleanValue(name, inlineValue));
             continue;
         }
-        if (valueFlags.has(withoutPrefix)) {
-            const next = tokens[index + 1];
-            if (!next || next.startsWith('--')) {
-                throw new Error(`Missing value for --${withoutPrefix}.`);
+        if (inlineValue !== undefined) {
+            if (inlineValue.length === 0) {
+                throw new UsageError(`Missing value for --${name}.`);
             }
-            flags[withoutPrefix] = next;
-            index += 1;
+            assignFlag(flags, name, inlineValue);
             continue;
         }
-        flags[withoutPrefix] = true;
-    }
-    return {
-        command,
-        subcommand,
-        positional,
-        flags
-    };
+        const next = tokens[index + 1];
+        if (!next || next.startsWith('-')) {
+            throw new UsageError(`Missing value for --${name}.`);
+        }
+        assignFlag(flags, name, next);
+        index += 1;
+    }
+    const maxPositionals = subcommand
+        ? definition.subcommandMaxPositionals?.[subcommand] ?? 0
+        : definition.defaultMaxPositionals;
+    if (positional.length > maxPositionals) {
+        throw new UsageError(`Too many positional arguments for ${command}${subcommand ? ` ${subcommand}` : ''}. ` +
+            `Usage: liftoff ${command}${definition.usage ? ` ${definition.usage}` : ''}`);
+    }
+    if (command === 'help' && positional[0] && !commandDefinitions[positional[0]]) {
+        throw new UsageError(`Unknown command for help: ${positional[0]}.`);
+    }
+    return { command, subcommand, positional, flags };
+}
+export function formatCommandHelp(command) {
+    const definition = commandDefinitions[command];
+    if (!definition) {
+        throw new UsageError(`Unknown command for help: ${command}.`);
+    }
+    const lines = [
+        `${command} - ${definition.description}`,
+        '',
+        `Usage: liftoff ${command}${definition.usage ? ` ${definition.usage}` : ''}`
+    ];
+    if (definition.subcommands) {
+        lines.push('', `Subcommands: ${definition.subcommands.join(', ')}`);
+    }
+    const flagNames = Object.entries(definition.flags).map(([name, flag]) => {
+        const value = flag.kind === 'value' ? ' <value>' : '';
+        const negated = flag.negatable ? ` / --no-${name}` : '';
+        return `  --${name}${value}${negated}`;
+    });
+    if (flagNames.length > 0) {
+        lines.push('', 'Options:', ...flagNames);
+    }
+    return `${lines.join('\n')}\n`;
 }
 export function readStringFlag(flags, name) {
     const value = flags[name];
-    if (typeof value === 'string') {
-        return value;
-    }
-    return undefined;
+    return typeof value === 'string' ? value : undefined;
 }
 export function readBooleanFlag(flags, name) {
     const value = flags[name];
-    if (typeof value === 'boolean') {
-        return value;
-    }
-    return undefined;
+    return typeof value === 'boolean' ? value : undefined;
 }
 export function readListFlag(flags, name) {
     const value = flags[name];

package/dist/args.js.map

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

package/dist/catalogs.d.ts

@@ -1,11 +1,15 @@
-import type { EnvironmentDefinition, EnvironmentId, PatternDefinition, PatternId, ProviderDefinition, ProviderId, RegionDefinition, SpecWorkflowDefinition, SpecWorkflowId } from './types.js';
+import type { ApiStackDefinition, ApiStackId, EnvironmentDefinition, EnvironmentId, PatternDefinition, PatternId, ProviderDefinition, ProviderId, ProjectTypeDefinition, ProjectTypeId, RegionDefinition, SpecWorkflowDefinition, SpecWorkflowId } from './types.js';
 export declare const approvedStack: string[];
+export declare const projectTypes: ProjectTypeDefinition[];
+export declare const apiStacks: ApiStackDefinition[];
 export declare const patterns: PatternDefinition[];
 export declare const providers: ProviderDefinition[];
 export declare const azureRegions: RegionDefinition[];
 export declare const environments: EnvironmentDefinition[];
 export declare const specWorkflows: SpecWorkflowDefinition[];
 export declare function getPattern(value: string): PatternDefinition | undefined;
+export declare function getProjectType(value: string): ProjectTypeDefinition | undefined;
+export declare function getApiStack(value: string): ApiStackDefinition | undefined;
 export declare function getProvider(value: string): ProviderDefinition | undefined;
 export declare function getSpecWorkflow(value: string): SpecWorkflowDefinition | undefined;
 export declare function getEnvironment(value: string): EnvironmentDefinition | undefined;
@@ -24,6 +28,8 @@ export type RegionResolution = {
 };
 export declare function resolveRegion(provider: ProviderId, input?: string): RegionResolution;
 export declare function isPatternId(value: string): value is PatternId;
+export declare function isProjectTypeId(value: string): value is ProjectTypeId;
+export declare function isApiStackId(value: string): value is ApiStackId;
 export declare function isProviderId(value: string): value is ProviderId;
 export declare function isEnvironmentId(value: string): value is EnvironmentId;
 export declare function isSpecWorkflowId(value: string): value is SpecWorkflowId;

package/dist/catalogs.js

@@ -14,6 +14,47 @@ export const approvedStack = [
     'Docker Compose',
     'OpenTofu'
 ];
+export const projectTypes = [
+    {
+        id: 'genai',
+        label: 'GenAI application',
+        description: 'Python/FastAPI application with PydanticAI and a selected GenAI pattern.'
+    },
+    {
+        id: 'standard',
+        label: 'Standard application',
+        description: 'Non-GenAI API application using an approved Python, Node.js, or Go stack.'
+    }
+];
+export const apiStacks = [
+    {
+        id: 'python-fastapi',
+        label: 'Python / FastAPI',
+        aliases: ['python', 'py', 'fastapi', 'python-fastapi'],
+        language: 'Python',
+        framework: 'FastAPI',
+        databaseTooling: 'SQLAlchemy + Alembic',
+        testFramework: 'pytest'
+    },
+    {
+        id: 'node-fastify',
+        label: 'Node.js / Fastify / TypeScript',
+        aliases: ['node', 'nodejs', 'node.js', 'fastify', 'typescript', 'node-fastify'],
+        language: 'Node.js',
+        framework: 'Fastify with TypeScript',
+        databaseTooling: 'Drizzle',
+        testFramework: 'Vitest'
+    },
+    {
+        id: 'go-huma',
+        label: 'Go / Huma / Chi',
+        aliases: ['go', 'golang', 'huma', 'chi', 'go-huma'],
+        language: 'Go',
+        framework: 'Huma v2 with Chi',
+        databaseTooling: 'pgx + Goose',
+        testFramework: 'go test'
+    }
+];
 export const patterns = [
     {
         id: 'rag',
@@ -191,6 +232,14 @@ export function getPattern(value) {
     const normalized = normalize(value);
     return patterns.find((pattern) => normalize(pattern.id) === normalized || pattern.aliases.some((alias) => normalize(alias) === normalized));
 }
+export function getProjectType(value) {
+    const normalized = normalize(value);
+    return projectTypes.find((projectType) => normalize(projectType.id) === normalized || normalize(projectType.label) === normalized);
+}
+export function getApiStack(value) {
+    const normalized = normalize(value);
+    return apiStacks.find((stack) => normalize(stack.id) === normalized || stack.aliases.some((alias) => normalize(alias) === normalized));
+}
 export function getProvider(value) {
     const normalized = normalize(value);
     return providers.find((provider) => normalize(provider.id) === normalized || normalize(provider.label) === normalized);
@@ -250,6 +299,12 @@ export function resolveRegion(provider, input) {
 export function isPatternId(value) {
     return patterns.some((pattern) => pattern.id === value);
 }
+export function isProjectTypeId(value) {
+    return projectTypes.some((projectType) => projectType.id === value);
+}
+export function isApiStackId(value) {
+    return apiStacks.some((stack) => stack.id === value);
+}
 export function isProviderId(value) {
     return providers.some((provider) => provider.id === value);
 }