@ankhorage/infra 0.2.1 → 0.3.1

package/dist/runtime.js

@@ -0,0 +1,87 @@
+import { spawn } from 'child_process';
+import { promises as fs } from 'fs';
+import path from 'path';
+export class InfraScriptExecutionError extends Error {
+    exitCode;
+    stderr;
+    stdout;
+    constructor(args) {
+        super(args.message);
+        this.name = 'InfraScriptExecutionError';
+        this.exitCode = args.exitCode;
+        this.stderr = args.stderr;
+        this.stdout = args.stdout;
+    }
+}
+export async function runProjectInfraScript(args) {
+    const scriptPath = resolveProjectInfraScriptPath(args);
+    if (!(await pathExists(scriptPath))) {
+        throw new Error(`Infra script not found: ${scriptPath}. Run infra generate for project '${args.projectId}' first.`);
+    }
+    await runShellScript({
+        context: args.context,
+        scriptPath,
+    });
+}
+export function resolveProjectInfraScriptPath(args) {
+    return path.join(args.projectPath, getInfraScriptsDirectory(args.target), `${args.script}.sh`);
+}
+function getInfraScriptsDirectory(target) {
+    switch (target) {
+        case 'minikube':
+            return 'infra/minikube/scripts';
+        default:
+            throw new Error(`Unsupported deployment target for infra scripts: ${target}`);
+    }
+}
+async function runShellScript(args) {
+    await new Promise((resolve, reject) => {
+        const child = spawn('bash', [args.scriptPath], {
+            cwd: path.dirname(args.scriptPath),
+            env: { ...args.context.env },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => {
+            stdout += chunk;
+            args.context.writeStdout(chunk);
+        });
+        child.stderr.setEncoding('utf8');
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk;
+            args.context.writeStderr(chunk);
+        });
+        child.once('error', (error) => {
+            reject(new InfraScriptExecutionError({
+                exitCode: null,
+                message: `Failed to start infra script '${args.scriptPath}': ${error.message}`,
+                stderr,
+                stdout,
+            }));
+        });
+        child.once('close', (exitCode) => {
+            if (exitCode === 0) {
+                resolve();
+                return;
+            }
+            reject(new InfraScriptExecutionError({
+                exitCode,
+                message: `Infra script '${args.scriptPath}' exited with code ${exitCode ?? 'unknown'}.`,
+                stderr,
+                stdout,
+            }));
+        });
+    });
+}
+async function pathExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'child_process';\nimport { promises as fs } from 'fs';\nimport path from 'path';\n\nimport type { InfraCommandContext } from './commandContext.js';\n\nexport type InfraLifecycleScript = 'down' | 'status' | 'up';\n\nexport class InfraScriptExecutionError extends Error {\n  readonly exitCode: number | null;\n  readonly stderr: string;\n  readonly stdout: string;\n\n  constructor(args: {\n    readonly exitCode: number | null;\n    readonly message: string;\n    readonly stderr: string;\n    readonly stdout: string;\n  }) {\n    super(args.message);\n    this.name = 'InfraScriptExecutionError';\n    this.exitCode = args.exitCode;\n    this.stderr = args.stderr;\n    this.stdout = args.stdout;\n  }\n}\n\nexport async function runProjectInfraScript(args: {\n  readonly context: InfraCommandContext;\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly script: InfraLifecycleScript;\n  readonly target: string;\n}): Promise<void> {\n  const scriptPath = resolveProjectInfraScriptPath(args);\n  if (!(await pathExists(scriptPath))) {\n    throw new Error(\n      `Infra script not found: ${scriptPath}. Run infra generate for project '${args.projectId}' first.`,\n    );\n  }\n\n  await runShellScript({\n    context: args.context,\n    scriptPath,\n  });\n}\n\nexport function resolveProjectInfraScriptPath(args: {\n  readonly projectPath: string;\n  readonly script: InfraLifecycleScript;\n  readonly target: string;\n}): string {\n  return path.join(args.projectPath, getInfraScriptsDirectory(args.target), `${args.script}.sh`);\n}\n\nfunction getInfraScriptsDirectory(target: string): string {\n  switch (target) {\n    case 'minikube':\n      return 'infra/minikube/scripts';\n    default:\n      throw new Error(`Unsupported deployment target for infra scripts: ${target}`);\n  }\n}\n\nasync function runShellScript(args: {\n  readonly context: InfraCommandContext;\n  readonly scriptPath: string;\n}): Promise<void> {\n  await new Promise<void>((resolve, reject) => {\n    const child = spawn('bash', [args.scriptPath], {\n      cwd: path.dirname(args.scriptPath),\n      env: { ...args.context.env },\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    let stdout = '';\n    let stderr = '';\n\n    child.stdout.setEncoding('utf8');\n    child.stdout.on('data', (chunk: string) => {\n      stdout += chunk;\n      args.context.writeStdout(chunk);\n    });\n\n    child.stderr.setEncoding('utf8');\n    child.stderr.on('data', (chunk: string) => {\n      stderr += chunk;\n      args.context.writeStderr(chunk);\n    });\n\n    child.once('error', (error) => {\n      reject(\n        new InfraScriptExecutionError({\n          exitCode: null,\n          message: `Failed to start infra script '${args.scriptPath}': ${error.message}`,\n          stderr,\n          stdout,\n        }),\n      );\n    });\n\n    child.once('close', (exitCode) => {\n      if (exitCode === 0) {\n        resolve();\n        return;\n      }\n\n      reject(\n        new InfraScriptExecutionError({\n          exitCode,\n          message: `Infra script '${args.scriptPath}' exited with code ${exitCode ?? 'unknown'}.`,\n          stderr,\n          stdout,\n        }),\n      );\n    });\n  });\n}\n\nasync function pathExists(filePath: string): Promise<boolean> {\n  try {\n    await fs.access(filePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/testSupport.d.ts

@@ -0,0 +1,24 @@
+import type { AppManifest } from '@ankhorage/contracts';
+import type { InfraCommandContext } from './commandContext.js';
+export interface CapturedCommandContext {
+    readonly context: InfraCommandContext;
+    readonly stderr: {
+        value: string;
+    };
+    readonly stdout: {
+        value: string;
+    };
+}
+export declare function createCapturedCommandContext(cwd: string, version?: string): CapturedCommandContext;
+export declare function createWorkspaceFixture(args?: {
+    readonly manifest?: AppManifest;
+    readonly manifestFile?: 'invalid-json' | 'missing';
+    readonly projectId?: string;
+}): Promise<{
+    readonly appsRoot: string;
+    readonly projectId: string;
+    readonly projectPath: string;
+    readonly rootPath: string;
+}>;
+export declare function createAppManifest(projectId: string, infra?: AppManifest['infra']): AppManifest;
+//# sourceMappingURL=testSupport.d.ts.map

package/dist/testSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testSupport.d.ts","sourceRoot":"","sources":["../src/testSupport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,SAAU,GAChB,sBAAsB,CAmBxB;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE;IACJ,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CACxB,GACL,OAAO,CAAC;IACT,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC,CA6BD;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,WAAW,CAAC,OAAO,CAAmB,GAC5C,WAAW,CA6Bb"}

package/dist/testSupport.js

@@ -0,0 +1,73 @@
+import { promises as fs } from 'fs';
+import os from 'os';
+import path from 'path';
+export function createCapturedCommandContext(cwd, version = '0.2.1') {
+    const stdout = { value: '' };
+    const stderr = { value: '' };
+    return {
+        stdout,
+        stderr,
+        context: {
+            cwd,
+            env: process.env,
+            version,
+            writeStdout(text) {
+                stdout.value += text;
+            },
+            writeStderr(text) {
+                stderr.value += text;
+            },
+        },
+    };
+}
+export async function createWorkspaceFixture(args = {}) {
+    const rootPath = await fs.mkdtemp(path.join(os.tmpdir(), 'ankhorage-infra-'));
+    const appsRoot = path.join(rootPath, 'apps');
+    const projectId = args.projectId ?? 'shop';
+    const projectPath = path.join(appsRoot, projectId);
+    await fs.mkdir(projectPath, { recursive: true });
+    await fs.writeFile(path.join(projectPath, 'package.json'), JSON.stringify({ name: projectId, version: '1.0.0' }, null, 2), 'utf8');
+    if (args.manifestFile === 'invalid-json') {
+        await fs.writeFile(path.join(projectPath, 'ankh.config.json'), '{invalid', 'utf8');
+    }
+    else if (args.manifestFile !== 'missing') {
+        await fs.writeFile(path.join(projectPath, 'ankh.config.json'), `${JSON.stringify(args.manifest ?? createAppManifest(projectId), null, 2)}\n`, 'utf8');
+    }
+    return {
+        appsRoot,
+        projectId,
+        projectPath,
+        rootPath,
+    };
+}
+export function createAppManifest(projectId, infra = { plugins: [] }) {
+    return {
+        metadata: {
+            name: projectId,
+            slug: projectId,
+            version: '1.0.0',
+            themeId: 'default',
+        },
+        themes: [],
+        activeThemeId: 'default',
+        infra,
+        navigator: {
+            type: 'stack',
+            routes: [{ name: 'index', screenId: 'index' }],
+        },
+        screens: {},
+        settings: {
+            localization: {
+                defaultLocale: 'en',
+                locales: ['en'],
+            },
+            authFlow: {
+                signInRoute: '/sign-in',
+                signOutRoute: '/sign-out',
+                postSignInRoute: '/',
+                unauthorizedRoute: '/sign-in',
+            },
+        },
+    };
+}
+//# sourceMappingURL=testSupport.js.map

package/dist/testSupport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testSupport.js","sourceRoot":"","sources":["../src/testSupport.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AppManifest } from '@ankhorage/contracts';\nimport { promises as fs } from 'fs';\nimport os from 'os';\nimport path from 'path';\n\nimport type { InfraCommandContext } from './commandContext.js';\n\nexport interface CapturedCommandContext {\n  readonly context: InfraCommandContext;\n  readonly stderr: { value: string };\n  readonly stdout: { value: string };\n}\n\nexport function createCapturedCommandContext(\n  cwd: string,\n  version = '0.2.1',\n): CapturedCommandContext {\n  const stdout = { value: '' };\n  const stderr = { value: '' };\n\n  return {\n    stdout,\n    stderr,\n    context: {\n      cwd,\n      env: process.env,\n      version,\n      writeStdout(text: string) {\n        stdout.value += text;\n      },\n      writeStderr(text: string) {\n        stderr.value += text;\n      },\n    },\n  };\n}\n\nexport async function createWorkspaceFixture(\n  args: {\n    readonly manifest?: AppManifest;\n    readonly manifestFile?: 'invalid-json' | 'missing';\n    readonly projectId?: string;\n  } = {},\n): Promise<{\n  readonly appsRoot: string;\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly rootPath: string;\n}> {\n  const rootPath = await fs.mkdtemp(path.join(os.tmpdir(), 'ankhorage-infra-'));\n  const appsRoot = path.join(rootPath, 'apps');\n  const projectId = args.projectId ?? 'shop';\n  const projectPath = path.join(appsRoot, projectId);\n\n  await fs.mkdir(projectPath, { recursive: true });\n  await fs.writeFile(\n    path.join(projectPath, 'package.json'),\n    JSON.stringify({ name: projectId, version: '1.0.0' }, null, 2),\n    'utf8',\n  );\n\n  if (args.manifestFile === 'invalid-json') {\n    await fs.writeFile(path.join(projectPath, 'ankh.config.json'), '{invalid', 'utf8');\n  } else if (args.manifestFile !== 'missing') {\n    await fs.writeFile(\n      path.join(projectPath, 'ankh.config.json'),\n      `${JSON.stringify(args.manifest ?? createAppManifest(projectId), null, 2)}\\n`,\n      'utf8',\n    );\n  }\n\n  return {\n    appsRoot,\n    projectId,\n    projectPath,\n    rootPath,\n  };\n}\n\nexport function createAppManifest(\n  projectId: string,\n  infra: AppManifest['infra'] = { plugins: [] },\n): AppManifest {\n  return {\n    metadata: {\n      name: projectId,\n      slug: projectId,\n      version: '1.0.0',\n      themeId: 'default',\n    },\n    themes: [],\n    activeThemeId: 'default',\n    infra,\n    navigator: {\n      type: 'stack',\n      routes: [{ name: 'index', screenId: 'index' }],\n    },\n    screens: {},\n    settings: {\n      localization: {\n        defaultLocale: 'en',\n        locales: ['en'],\n      },\n      authFlow: {\n        signInRoute: '/sign-in',\n        signOutRoute: '/sign-out',\n        postSignInRoute: '/',\n        unauthorizedRoute: '/sign-in',\n      },\n    },\n  };\n}\n"]}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@ankhorage/infra",
   "type": "module",
-  "version": "0.2.1",
-  "description": "Provider-neutral infrastructure generation: turns app manifests, datasets, auth, state, storage, and deployment config into generated infra artifacts, migrations, seeds, APIs, and runtime dependencies.",
+  "version": "0.3.1",
+  "description": "Project-aware infrastructure generation library and executable Ankh provider for Ankhorage.",
   "homepage": "https://github.com/ankhorage/infra#readme",
   "bugs": {
     "url": "https://github.com/ankhorage/infra/issues"
@@ -33,7 +33,7 @@
     "openapi"
   ],
   "dependencies": {
-    "@ankhorage/contracts": "^1.18.0"
+    "@ankhorage/contracts": "^1.19.0"
   },
   "files": [
     "dist",
@@ -49,6 +49,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js",
+      "default": "./dist/cli/index.js"
+    },
     "./metadata": {
       "types": "./dist/metadata/index.d.ts",
       "import": "./dist/metadata/index.js",
@@ -56,6 +61,20 @@
     },
     "./package.json": "./package.json"
   },
+  "bin": {
+    "ankhorage-infra": "./dist/cli.js"
+  },
+  "ankh": {
+    "category": "infra",
+    "provider": "./dist/cli/index.js",
+    "capabilities": [
+      "infra.validate",
+      "infra.generate",
+      "infra.status",
+      "infra.up",
+      "infra.down"
+    ]
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -75,6 +94,7 @@
     "version-packages": "changeset version"
   },
   "devDependencies": {
+    "@ankhorage/ankh": "^0.4.0",
     "@ankhorage/devtools": "^1.0.6",
     "@ankhorage/paradox": "^0.1.10",
     "@changesets/cli": "^2.31.0",

package/src/cli/index.test.ts

@@ -0,0 +1,32 @@
+import type { AnkhRuntimeCommandProvider } from '@ankhorage/ankh';
+import { describe, expect, test } from 'bun:test';
+
+import { createProviderCommandDescriptors, INFRA_COMMANDS } from '../commands.js';
+import provider, { createInfraRuntimeProvider } from './index.js';
+
+describe('infra package cli provider', () => {
+  test('publishes the expected runtime provider shape', () => {
+    const expectedProvider = createInfraRuntimeProvider() satisfies AnkhRuntimeCommandProvider;
+
+    expect(expectedProvider.id).toBe('@ankhorage/infra');
+    expect(expectedProvider.category).toBe('infra');
+    expect(expectedProvider.capabilities).toEqual([
+      'infra.validate',
+      'infra.generate',
+      'infra.status',
+      'infra.up',
+      'infra.down',
+    ]);
+    expect(expectedProvider.commands).toEqual(createProviderCommandDescriptors());
+    expect(expectedProvider.handlers?.map((handler) => handler.path.join(' '))).toEqual(
+      INFRA_COMMANDS.map((command) => command.path.join(' ')),
+    );
+    expect(JSON.stringify(expectedProvider)).not.toContain('port-forward');
+  });
+
+  test('default export is the runtime provider', () => {
+    expect(provider.category).toBe('infra');
+    expect(provider.commands).toHaveLength(5);
+    expect(provider.handlers).toHaveLength(5);
+  });
+});

package/src/cli/index.ts

@@ -0,0 +1,53 @@
+import type { AnkhRuntimeCommandProvider } from '@ankhorage/ankh';
+
+import {
+  createProviderCommandDescriptors,
+  INFRA_COMMANDS,
+  type InfraCommandServices,
+  runInfraCommand,
+  type RunInfraCommandImpl,
+} from '../commands.js';
+import {
+  INFRA_CAPABILITIES,
+  INFRA_COMMAND_CATEGORY,
+  INFRA_PACKAGE_NAME,
+  INFRA_PACKAGE_VERSION,
+} from '../packageMetadata.js';
+
+export interface CreateInfraRuntimeProviderOptions {
+  readonly runCommandImpl?: RunInfraCommandImpl;
+  readonly services?: Partial<InfraCommandServices>;
+}
+
+export function createInfraRuntimeProvider(
+  options: CreateInfraRuntimeProviderOptions = {},
+): AnkhRuntimeCommandProvider {
+  const runCommandImpl = options.runCommandImpl ?? runInfraCommand;
+
+  return {
+    id: INFRA_PACKAGE_NAME,
+    category: INFRA_COMMAND_CATEGORY,
+    version: INFRA_PACKAGE_VERSION,
+    capabilities: [...INFRA_CAPABILITIES],
+    commands: createProviderCommandDescriptors(),
+    handlers: INFRA_COMMANDS.map((command) => ({
+      path: command.path,
+      handler(request) {
+        return runCommandImpl(
+          {
+            argv: request.argv,
+            command,
+            context: request.context,
+          },
+          {
+            services: options.services,
+          },
+        );
+      },
+    })),
+  } satisfies AnkhRuntimeCommandProvider;
+}
+
+const provider = createInfraRuntimeProvider();
+
+export default provider;

package/src/cli.test.ts

@@ -0,0 +1,137 @@
+import type { AnkhDiscoveredPackage, AnkhLoadedProvider } from '@ankhorage/ankh';
+import {
+  createPackageRegistry,
+  createProviderRegistry,
+  runCli as runAnkhCli,
+} from '@ankhorage/ankh';
+import { describe, expect, test } from 'bun:test';
+
+import { runCli } from './cli.js';
+import { createInfraRuntimeProvider } from './cli/index.js';
+import { createCapturedCommandContext } from './testSupport.js';
+
+describe('standalone cli and provider-backed dispatch', () => {
+  test('prints help and version for the standalone CLI', async () => {
+    const help = createCapturedCommandContext('/workspace', '9.9.9');
+    const version = createCapturedCommandContext('/workspace', '9.9.9');
+
+    expect((await runCli([], { context: help.context })).exitCode).toBe(0);
+    expect(help.stdout.value).toContain('ankhorage-infra <command> [project]');
+    expect(help.stdout.value).not.toContain('port-forward');
+
+    expect((await runCli(['--version'], { context: version.context })).exitCode).toBe(0);
+    expect(version.stdout.value).toBe('9.9.9\n');
+  });
+
+  test('uses the shared command runner for standalone CLI dispatch', async () => {
+    const captured = createCapturedCommandContext('/workspace');
+    const calls: string[] = [];
+
+    const result = await runCli(['validate', 'shop'], {
+      context: captured.context,
+      runCommandImpl(request) {
+        calls.push(request.command.standaloneName);
+        request.context.writeStdout(
+          `ran:${request.command.standaloneName}:${request.argv.join(',')}\n`,
+        );
+        return Promise.resolve({ exitCode: 0 });
+      },
+    });
+
+    expect(result.exitCode).toBe(0);
+    expect(calls).toEqual(['validate']);
+    expect(captured.stdout.value).toContain('ran:validate:shop');
+  });
+
+  test('routes provider-backed dispatch through @ankhorage/ankh', async () => {
+    const captured = createCapturedCommandContext('/workspace');
+    const calls: string[] = [];
+    const provider = createInfraRuntimeProvider({
+      runCommandImpl(request) {
+        calls.push(request.command.standaloneName);
+        request.context.writeStdout(`provider:${request.command.standaloneName}\n`);
+        return Promise.resolve({ exitCode: 0 });
+      },
+    });
+
+    const packageRegistry = createPackageRegistry([createDiscoveredPackage()]);
+    const providerRegistry = createProviderRegistry([createLoadedProvider(provider)]);
+
+    const result = await runAnkhCli(['infra', 'status', 'shop'], {
+      context: captured.context,
+      registry: packageRegistry,
+      providerRegistry,
+    });
+
+    expect(result.exitCode).toBe(0);
+    expect(calls).toEqual(['status']);
+    expect(captured.stdout.value).toContain('provider:status');
+  });
+
+  test('uses the same injected shared runner from both surfaces', async () => {
+    const standalone = createCapturedCommandContext('/workspace');
+    const providerContext = createCapturedCommandContext('/workspace');
+    const calls: string[] = [];
+
+    const runCommandImpl = (request: {
+      readonly argv: readonly string[];
+      readonly command: { readonly standaloneName: string };
+      readonly context: { writeStdout(text: string): void };
+    }) => {
+      calls.push(request.command.standaloneName);
+      request.context.writeStdout(`shared:${request.command.standaloneName}\n`);
+      return Promise.resolve({ exitCode: 0 });
+    };
+
+    await runCli(['generate', 'shop'], {
+      context: standalone.context,
+      runCommandImpl,
+    });
+
+    const provider = createInfraRuntimeProvider({ runCommandImpl });
+    const packageRegistry = createPackageRegistry([createDiscoveredPackage()]);
+    const providerRegistry = createProviderRegistry([createLoadedProvider(provider)]);
+
+    await runAnkhCli(['infra', 'generate', 'shop'], {
+      context: providerContext.context,
+      registry: packageRegistry,
+      providerRegistry,
+    });
+
+    expect(calls).toEqual(['generate', 'generate']);
+    expect(standalone.stdout.value).toContain('shared:generate');
+    expect(providerContext.stdout.value).toContain('shared:generate');
+  });
+});
+
+function createDiscoveredPackage(): AnkhDiscoveredPackage {
+  return {
+    metadata: {
+      category: 'infra',
+      provider: './dist/cli/index.js',
+      capabilities: ['infra.validate', 'infra.generate', 'infra.status', 'infra.up', 'infra.down'],
+    },
+    packageJsonPath: '/workspace/package.json',
+    packageName: '@ankhorage/infra',
+    packageRoot: '/workspace',
+    source: 'workspace',
+  };
+}
+
+function createLoadedProvider(
+  provider: ReturnType<typeof createInfraRuntimeProvider>,
+): AnkhLoadedProvider {
+  return {
+    discoveredPackage: createDiscoveredPackage(),
+    manifest: {
+      id: provider.id,
+      category: provider.category,
+      version: provider.version,
+      capabilities: provider.capabilities,
+      commands: provider.commands,
+    },
+    providerModuleDefaultExport: provider,
+    providerModulePath: '/workspace/dist/cli/index.js',
+    providerModuleUrl: 'file:///workspace/dist/cli/index.js',
+  };
+}

package/src/cli.ts

@@ -0,0 +1,67 @@
+#!/usr/bin/env bun
+
+import type { InfraCommandContext, InfraCommandRunResult } from './commandContext.js';
+import { createDefaultCommandContext } from './commandContext.js';
+import {
+  findInfraCommandByStandaloneName,
+  type InfraCommandServices,
+  renderRootHelp,
+  renderUnknownCommand,
+  runInfraCommand,
+  type RunInfraCommandImpl,
+} from './commands.js';
+
+export interface InfraCliOptions {
+  readonly context?: InfraCommandContext;
+  readonly runCommandImpl?: RunInfraCommandImpl;
+  readonly services?: Partial<InfraCommandServices>;
+}
+
+export async function runCli(
+  argv: readonly string[],
+  options: InfraCliOptions = {},
+): Promise<InfraCommandRunResult> {
+  const context = options.context ?? createDefaultCommandContext();
+  const runCommand = options.runCommandImpl ?? runInfraCommand;
+  const [firstToken, ...restTokens] = argv;
+
+  if (firstToken === undefined || isHelpToken(firstToken)) {
+    context.writeStdout(renderRootHelp(context.version));
+    return { exitCode: 0 };
+  }
+
+  if (isVersionToken(firstToken)) {
+    context.writeStdout(`${context.version}\n`);
+    return { exitCode: 0 };
+  }
+
+  const command = findInfraCommandByStandaloneName(firstToken);
+  if (command === null) {
+    context.writeStderr(renderUnknownCommand(firstToken));
+    return { exitCode: 1 };
+  }
+
+  return runCommand(
+    {
+      argv: restTokens,
+      command,
+      context,
+    },
+    {
+      services: options.services,
+    },
+  );
+}
+
+function isHelpToken(value: string): boolean {
+  return value === '--help' || value === '-h' || value === 'help';
+}
+
+function isVersionToken(value: string): boolean {
+  return value === '--version' || value === '-v' || value === 'version';
+}
+
+if (import.meta.main) {
+  const result = await runCli(process.argv.slice(2));
+  process.exit(result.exitCode);
+}

package/src/commandContext.ts

@@ -0,0 +1,27 @@
+import { INFRA_PACKAGE_VERSION } from './packageMetadata.js';
+
+export interface InfraCommandContext {
+  readonly cwd: string;
+  readonly env: Readonly<Record<string, string | undefined>>;
+  readonly version: string;
+  writeStdout(text: string): void;
+  writeStderr(text: string): void;
+}
+
+export interface InfraCommandRunResult {
+  readonly exitCode: number;
+}
+
+export function createDefaultCommandContext(): InfraCommandContext {
+  return {
+    cwd: process.cwd(),
+    env: process.env,
+    version: INFRA_PACKAGE_VERSION,
+    writeStdout(text: string) {
+      process.stdout.write(text);
+    },
+    writeStderr(text: string) {
+      process.stderr.write(text);
+    },
+  };
+}