@ankhorage/infra 4.1.12 → 5.1.0

package/dist/types/infraCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infraCli.js","sourceRoot":"","sources":["../../src/types/infraCli.ts"],"names":[],"mappings":"","sourcesContent":["import type { AnkhCapabilityId } from '@ankhorage/contracts/cli';\nimport type { AppEnvironmentId } from '@ankhorage/contracts/environments';\nimport type { InfraEnvironmentSpec } from '@ankhorage/contracts/infra';\n\nimport type { readStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/readStoredInfraStateAsync.js';\nimport type { removeStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/removeStoredInfraStateAsync.js';\nimport type { writeInfraGeneratedArtifactsAsync } from '../features/environment-lifecycle/adapters/outbound/writeInfraGeneratedArtifactsAsync.js';\nimport type { writeStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/writeStoredInfraStateAsync.js';\nimport type { destroyInfraEnvironmentAsync } from '../features/environment-lifecycle/application/use-cases/destroyInfraEnvironmentAsync.js';\nimport type { downInfraEnvironmentAsync } from '../features/environment-lifecycle/application/use-cases/downInfraEnvironmentAsync.js';\nimport type { generateInfraEnvironmentAsync } from '../features/environment-lifecycle/application/use-cases/generateInfraEnvironmentAsync.js';\nimport type { getInfraEnvironmentOutputs } from '../features/environment-lifecycle/application/use-cases/getInfraEnvironmentOutputs.js';\nimport type { planInfraEnvironmentAsync } from '../features/environment-lifecycle/application/use-cases/planInfraEnvironmentAsync.js';\nimport type { statusInfraEnvironmentAsync } from '../features/environment-lifecycle/application/use-cases/statusInfraEnvironmentAsync.js';\nimport type { upInfraEnvironmentAsync } from '../features/environment-lifecycle/application/use-cases/upInfraEnvironmentAsync.js';\nimport type { validateInfraEnvironmentAsync } from '../features/environment-lifecycle/application/use-cases/validateInfraEnvironmentAsync.js';\nimport type {\n  InfraOperationRequest,\n  InfraOrchestrationDependencies,\n  InfraStoredState,\n} from './infraOrchestration.js';\nimport type { ResolvedInfraProject } from './infraProject.js';\n\ntype InfraCommandName =\n  'validate' | 'plan' | 'generate' | 'up' | 'status' | 'outputs' | 'down' | 'destroy';\n\nexport interface InfraCommandContext {\n  readonly cwd: string;\n  readonly env: Readonly<Record<string, string | undefined>>;\n  readonly version: string;\n  writeStdout(text: string): void;\n  writeStderr(text: string): void;\n}\n\nexport interface InfraCommandRunResult {\n  readonly exitCode: number;\n}\n\nexport interface ParsedInfraArguments {\n  readonly projectId?: string;\n  readonly environment?: AppEnvironmentId;\n  readonly format: 'human' | 'json' | 'env';\n  readonly confirmation?: string;\n  readonly deleteResources: readonly string[];\n}\n\nexport interface InfraCommandRunRequest {\n  readonly context: InfraCommandContext;\n  readonly arguments: ParsedInfraArguments;\n}\n\ntype InfraCommandImplementation = (\n  request: InfraCommandRunRequest,\n  services: InfraCommandServices,\n) => Promise<InfraCommandRunResult>;\n\nexport interface InfraCommandDefinition {\n  readonly capability: AnkhCapabilityId;\n  readonly path: readonly [InfraCommandName];\n  readonly standaloneName: InfraCommandName;\n  readonly summary: string;\n  readonly run: InfraCommandImplementation;\n}\n\nexport interface InfraCommandInvocation {\n  readonly argv: readonly string[];\n  readonly command: InfraCommandDefinition;\n  readonly context: InfraCommandContext;\n}\n\nexport interface InfraLifecycleOperations {\n  readonly validate: typeof validateInfraEnvironmentAsync;\n  readonly plan: typeof planInfraEnvironmentAsync;\n  readonly generate: typeof generateInfraEnvironmentAsync;\n  readonly up: typeof upInfraEnvironmentAsync;\n  readonly status: typeof statusInfraEnvironmentAsync;\n  readonly outputs: typeof getInfraEnvironmentOutputs;\n  readonly down: typeof downInfraEnvironmentAsync;\n  readonly destroy: typeof destroyInfraEnvironmentAsync;\n}\n\nexport interface InfraCommandServices {\n  readonly resolveProject: (options: {\n    readonly cwd: string;\n    readonly projectId?: string;\n  }) => Promise<ResolvedInfraProject>;\n  readonly readState: typeof readStoredInfraStateAsync;\n  readonly writeState: typeof writeStoredInfraStateAsync;\n  readonly removeState: typeof removeStoredInfraStateAsync;\n  readonly writeArtifacts: typeof writeInfraGeneratedArtifactsAsync;\n  readonly operations: InfraLifecycleOperations;\n  readonly createDependencies: (context: InfraCommandContext) => InfraOrchestrationDependencies;\n}\n\nexport interface RunInfraCommandOptions {\n  readonly services?: Partial<InfraCommandServices>;\n}\n\nexport interface CreateInfraRuntimeProviderOptions {\n  readonly runCommandImpl?: RunInfraCommandImpl;\n  readonly services?: Partial<InfraCommandServices>;\n}\n\nexport type RunInfraCommandImpl = (\n  request: InfraCommandInvocation,\n  options?: RunInfraCommandOptions,\n) => Promise<InfraCommandRunResult>;\n\nexport interface PreparedInfraCommandOperation {\n  readonly project: ResolvedInfraProject;\n  readonly state: InfraStoredState | null;\n  readonly desired: InfraEnvironmentSpec;\n  readonly operation: InfraOperationRequest;\n  readonly dependencies: InfraOrchestrationDependencies;\n}\n"]}

package/dist/types/infraOrchestration.d.ts

@@ -0,0 +1,84 @@
+import type { AppEnvironmentId } from '@ankhorage/contracts/environments';
+import type { InfraComputeAdapter, InfraComputeSnapshot, InfraComputeTarget, InfraDestroyRequest, InfraEnvironmentSpec, InfraExecutionContext, InfraGeneratedArtifact, InfraLedger, InfraManifest, InfraOutput, InfraOwnedResource, InfraPlan, InfraResult, InfraRuntimeAdapter, InfraRuntimeDesiredState, InfraServiceAdapter, InfraStatus } from '@ankhorage/contracts/infra';
+import type { InfraAdapterPackageResolver } from '../features/environment-lifecycle/application/ports/outbound/infraAdapterPackage.js';
+export interface ResolvedInfraEnvironment {
+    readonly id: AppEnvironmentId;
+    readonly desired: InfraEnvironmentSpec;
+    readonly manifest: InfraManifest;
+}
+export interface InfraEnvironmentResolutionRequest {
+    readonly environment?: string;
+    readonly manifest: InfraManifest;
+    readonly operation: 'validate' | 'plan' | 'generate' | 'up' | 'status' | 'outputs' | 'down' | 'destroy';
+}
+export interface ResolvedInfraAdapters {
+    readonly compute: InfraComputeAdapter;
+    readonly runtime: InfraRuntimeAdapter;
+    readonly services: readonly InfraServiceAdapter[];
+}
+export interface InfraStoredState {
+    readonly schemaVersion: 1;
+    readonly desired: InfraEnvironmentSpec;
+    readonly ledger: InfraLedger;
+}
+export interface PreparedInfraOperation {
+    readonly environment: ResolvedInfraEnvironment;
+    readonly context: InfraExecutionContext;
+    readonly adapters: ResolvedInfraAdapters;
+    readonly compute: InfraComputeSnapshot;
+    readonly runtimeDesired: InfraRuntimeDesiredState;
+}
+export interface InfraOrchestrationDependencies {
+    readonly adapterResolver: InfraAdapterPackageResolver;
+    readonly credentials: InfraExecutionContext['credentials'];
+    readonly secrets: InfraExecutionContext['secrets'];
+}
+export interface InfraOperationRequest {
+    readonly projectId: string;
+    readonly manifest: InfraManifest;
+    readonly environment?: string;
+    readonly previous?: InfraLedger;
+    readonly previousDesired?: InfraEnvironmentSpec;
+    readonly signal?: AbortSignal;
+}
+export interface InfraDestroyOperationRequest extends InfraOperationRequest {
+    readonly confirmation: InfraDestroyRequest['confirmation'];
+    readonly persistence: InfraDestroyRequest['persistence'];
+}
+export interface InfraValidateResult {
+    readonly environment: AppEnvironmentId;
+}
+export type InfraValidateOperationResult = InfraResult<InfraValidateResult>;
+export type InfraUpRequest = InfraOperationRequest;
+export interface InfraUpResult {
+    readonly environment: AppEnvironmentId;
+    readonly targets: readonly InfraComputeTarget[];
+    readonly resources: readonly InfraOwnedResource[];
+    readonly outputs: readonly InfraOutput[];
+    readonly ledger: InfraLedger;
+}
+export type InfraUpOperationResult = InfraResult<InfraUpResult>;
+export type InfraPlanOperationResult = InfraResult<InfraPlan>;
+export interface InfraGenerateResult {
+    readonly environment: AppEnvironmentId;
+    readonly artifacts: readonly InfraGeneratedArtifact[];
+    readonly ledger: InfraLedger;
+}
+export type InfraGenerateOperationResult = InfraResult<InfraGenerateResult>;
+export type InfraStatusOperationResult = InfraResult<InfraStatus>;
+export interface InfraOutputsResult {
+    readonly environment: AppEnvironmentId;
+    readonly outputs: readonly InfraOutput[];
+}
+export type InfraOutputsOperationResult = InfraResult<InfraOutputsResult>;
+export interface InfraDownResult {
+    readonly environment: AppEnvironmentId;
+    readonly ledger: InfraLedger;
+}
+export type InfraDownOperationResult = InfraResult<InfraDownResult>;
+export interface InfraDestroyResult {
+    readonly environment: AppEnvironmentId;
+    readonly ledger: InfraLedger | null;
+}
+export type InfraDestroyOperationResult = InfraResult<InfraDestroyResult>;
+//# sourceMappingURL=infraOrchestration.d.ts.map

package/dist/types/infraOrchestration.d.ts.map

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

package/dist/types/infraOrchestration.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=infraOrchestration.js.map

package/dist/types/infraOrchestration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infraOrchestration.js","sourceRoot":"","sources":["../../src/types/infraOrchestration.ts"],"names":[],"mappings":"","sourcesContent":["import type { AppEnvironmentId } from '@ankhorage/contracts/environments';\nimport type {\n  InfraComputeAdapter,\n  InfraComputeSnapshot,\n  InfraComputeTarget,\n  InfraDestroyRequest,\n  InfraEnvironmentSpec,\n  InfraExecutionContext,\n  InfraGeneratedArtifact,\n  InfraLedger,\n  InfraManifest,\n  InfraOutput,\n  InfraOwnedResource,\n  InfraPlan,\n  InfraResult,\n  InfraRuntimeAdapter,\n  InfraRuntimeDesiredState,\n  InfraServiceAdapter,\n  InfraStatus,\n} from '@ankhorage/contracts/infra';\n\nimport type { InfraAdapterPackageResolver } from '../features/environment-lifecycle/application/ports/outbound/infraAdapterPackage.js';\n\nexport interface ResolvedInfraEnvironment {\n  readonly id: AppEnvironmentId;\n  readonly desired: InfraEnvironmentSpec;\n  readonly manifest: InfraManifest;\n}\n\nexport interface InfraEnvironmentResolutionRequest {\n  readonly environment?: string;\n  readonly manifest: InfraManifest;\n  readonly operation:\n    'validate' | 'plan' | 'generate' | 'up' | 'status' | 'outputs' | 'down' | 'destroy';\n}\n\nexport interface ResolvedInfraAdapters {\n  readonly compute: InfraComputeAdapter;\n  readonly runtime: InfraRuntimeAdapter;\n  readonly services: readonly InfraServiceAdapter[];\n}\n\nexport interface InfraStoredState {\n  readonly schemaVersion: 1;\n  readonly desired: InfraEnvironmentSpec;\n  readonly ledger: InfraLedger;\n}\n\nexport interface PreparedInfraOperation {\n  readonly environment: ResolvedInfraEnvironment;\n  readonly context: InfraExecutionContext;\n  readonly adapters: ResolvedInfraAdapters;\n  readonly compute: InfraComputeSnapshot;\n  readonly runtimeDesired: InfraRuntimeDesiredState;\n}\n\nexport interface InfraOrchestrationDependencies {\n  readonly adapterResolver: InfraAdapterPackageResolver;\n  readonly credentials: InfraExecutionContext['credentials'];\n  readonly secrets: InfraExecutionContext['secrets'];\n}\n\nexport interface InfraOperationRequest {\n  readonly projectId: string;\n  readonly manifest: InfraManifest;\n  readonly environment?: string;\n  readonly previous?: InfraLedger;\n  readonly previousDesired?: InfraEnvironmentSpec;\n  readonly signal?: AbortSignal;\n}\n\nexport interface InfraDestroyOperationRequest extends InfraOperationRequest {\n  readonly confirmation: InfraDestroyRequest['confirmation'];\n  readonly persistence: InfraDestroyRequest['persistence'];\n}\n\nexport interface InfraValidateResult {\n  readonly environment: AppEnvironmentId;\n}\n\nexport type InfraValidateOperationResult = InfraResult<InfraValidateResult>;\n\nexport type InfraUpRequest = InfraOperationRequest;\n\nexport interface InfraUpResult {\n  readonly environment: AppEnvironmentId;\n  readonly targets: readonly InfraComputeTarget[];\n  readonly resources: readonly InfraOwnedResource[];\n  readonly outputs: readonly InfraOutput[];\n  readonly ledger: InfraLedger;\n}\n\nexport type InfraUpOperationResult = InfraResult<InfraUpResult>;\n\nexport type InfraPlanOperationResult = InfraResult<InfraPlan>;\n\nexport interface InfraGenerateResult {\n  readonly environment: AppEnvironmentId;\n  readonly artifacts: readonly InfraGeneratedArtifact[];\n  readonly ledger: InfraLedger;\n}\n\nexport type InfraGenerateOperationResult = InfraResult<InfraGenerateResult>;\n\nexport type InfraStatusOperationResult = InfraResult<InfraStatus>;\n\nexport interface InfraOutputsResult {\n  readonly environment: AppEnvironmentId;\n  readonly outputs: readonly InfraOutput[];\n}\n\nexport type InfraOutputsOperationResult = InfraResult<InfraOutputsResult>;\n\nexport interface InfraDownResult {\n  readonly environment: AppEnvironmentId;\n  readonly ledger: InfraLedger;\n}\n\nexport type InfraDownOperationResult = InfraResult<InfraDownResult>;\n\nexport interface InfraDestroyResult {\n  readonly environment: AppEnvironmentId;\n  readonly ledger: InfraLedger | null;\n}\n\nexport type InfraDestroyOperationResult = InfraResult<InfraDestroyResult>;\n"]}

package/dist/types/infraProject.d.ts

@@ -0,0 +1,43 @@
+import type { AppManifest } from '@ankhorage/contracts';
+import type { AppEnvironmentId } from '@ankhorage/contracts/environments';
+import type { InfraDestroyRequest, InfraManifest } from '@ankhorage/contracts/infra';
+import type { InfraCommandServices } from './infraCli.js';
+import type { InfraDestroyOperationResult, InfraDownOperationResult, InfraGenerateOperationResult, InfraOutputsOperationResult, InfraPlanOperationResult, InfraStatusOperationResult, InfraUpOperationResult, InfraValidateOperationResult } from './infraOrchestration.js';
+export interface InfraArtifactWriteResult {
+    readonly written: number;
+    readonly removed: number;
+}
+export interface ResolvedInfraProject {
+    readonly appsRoot: string;
+    readonly manifest: AppManifest;
+    readonly manifestPath: string;
+    readonly projectId: string;
+    readonly projectPath: string;
+    readonly workspaceRoot: string;
+}
+export interface ProjectInfraOperationRequest {
+    readonly projectId: string;
+    readonly projectPath: string;
+    readonly manifest: InfraManifest;
+    readonly environment: AppEnvironmentId;
+    readonly executionEnvironment?: Readonly<Record<string, string | undefined>>;
+    readonly signal?: AbortSignal;
+}
+export interface ProjectInfraDestroyRequest extends ProjectInfraOperationRequest {
+    readonly confirmation: InfraDestroyRequest['confirmation'];
+    readonly persistence: InfraDestroyRequest['persistence'];
+}
+export interface ProjectInfraLifecycle {
+    validateAsync(request: ProjectInfraOperationRequest): Promise<InfraValidateOperationResult>;
+    planAsync(request: ProjectInfraOperationRequest): Promise<InfraPlanOperationResult>;
+    generateAsync(request: ProjectInfraOperationRequest): Promise<InfraGenerateOperationResult>;
+    upAsync(request: ProjectInfraOperationRequest): Promise<InfraUpOperationResult>;
+    statusAsync(request: ProjectInfraOperationRequest): Promise<InfraStatusOperationResult>;
+    outputsAsync(request: ProjectInfraOperationRequest): Promise<InfraOutputsOperationResult>;
+    downAsync(request: ProjectInfraOperationRequest): Promise<InfraDownOperationResult>;
+    destroyAsync(request: ProjectInfraDestroyRequest): Promise<InfraDestroyOperationResult>;
+}
+export interface CreateProjectInfraLifecycleOptions {
+    readonly services?: Partial<InfraCommandServices>;
+}
+//# sourceMappingURL=infraProject.d.ts.map

package/dist/types/infraProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infraProject.d.ts","sourceRoot":"","sources":["../../src/types/infraProject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EACV,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA2B,SAAQ,4BAA4B;IAC9E,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAC3D,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC5F,SAAS,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpF,aAAa,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC5F,OAAO,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAChF,WAAW,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACxF,YAAY,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1F,SAAS,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpF,YAAY,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnD"}

package/dist/types/infraProject.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=infraProject.js.map

package/dist/types/infraProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infraProject.js","sourceRoot":"","sources":["../../src/types/infraProject.ts"],"names":[],"mappings":"","sourcesContent":["import type { AppManifest } from '@ankhorage/contracts';\nimport type { AppEnvironmentId } from '@ankhorage/contracts/environments';\nimport type { InfraDestroyRequest, InfraManifest } from '@ankhorage/contracts/infra';\n\nimport type { InfraCommandServices } from './infraCli.js';\nimport type {\n  InfraDestroyOperationResult,\n  InfraDownOperationResult,\n  InfraGenerateOperationResult,\n  InfraOutputsOperationResult,\n  InfraPlanOperationResult,\n  InfraStatusOperationResult,\n  InfraUpOperationResult,\n  InfraValidateOperationResult,\n} from './infraOrchestration.js';\n\nexport interface InfraArtifactWriteResult {\n  readonly written: number;\n  readonly removed: number;\n}\n\nexport interface ResolvedInfraProject {\n  readonly appsRoot: string;\n  readonly manifest: AppManifest;\n  readonly manifestPath: string;\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly workspaceRoot: string;\n}\n\nexport interface ProjectInfraOperationRequest {\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly manifest: InfraManifest;\n  readonly environment: AppEnvironmentId;\n  readonly executionEnvironment?: Readonly<Record<string, string | undefined>>;\n  readonly signal?: AbortSignal;\n}\n\nexport interface ProjectInfraDestroyRequest extends ProjectInfraOperationRequest {\n  readonly confirmation: InfraDestroyRequest['confirmation'];\n  readonly persistence: InfraDestroyRequest['persistence'];\n}\n\nexport interface ProjectInfraLifecycle {\n  validateAsync(request: ProjectInfraOperationRequest): Promise<InfraValidateOperationResult>;\n  planAsync(request: ProjectInfraOperationRequest): Promise<InfraPlanOperationResult>;\n  generateAsync(request: ProjectInfraOperationRequest): Promise<InfraGenerateOperationResult>;\n  upAsync(request: ProjectInfraOperationRequest): Promise<InfraUpOperationResult>;\n  statusAsync(request: ProjectInfraOperationRequest): Promise<InfraStatusOperationResult>;\n  outputsAsync(request: ProjectInfraOperationRequest): Promise<InfraOutputsOperationResult>;\n  downAsync(request: ProjectInfraOperationRequest): Promise<InfraDownOperationResult>;\n  destroyAsync(request: ProjectInfraDestroyRequest): Promise<InfraDestroyOperationResult>;\n}\n\nexport interface CreateProjectInfraLifecycleOptions {\n  readonly services?: Partial<InfraCommandServices>;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/infra",
   "type": "module",
-  "version": "4.1.12",
+  "version": "5.1.0",
   "description": "Project-aware infrastructure generation library and executable Ankh provider for Ankhorage.",
   "homepage": "https://github.com/ankhorage/infra#readme",
   "bugs": {
@@ -35,8 +35,7 @@
     "openapi"
   ],
   "dependencies": {
-    "@ankhorage/contracts": "^11.1.0",
-    "@ankhorage/supabase-vault": "^0.2.12"
+    "@ankhorage/contracts": "^19.0.0"
   },
   "files": [
     "dist",
@@ -77,11 +76,13 @@
     "provider": "./dist/cli/index.js",
     "capabilities": [
       "infra.validate",
+      "infra.plan",
       "infra.generate",
-      "infra.status",
       "infra.up",
+      "infra.status",
+      "infra.outputs",
       "infra.down",
-      "infra.secret-store"
+      "infra.destroy"
     ]
   },
   "publishConfig": {
@@ -98,17 +99,26 @@
     "format:check": "ankhorage-prettier --check .",
     "prepack": "bun run build",
     "test": "bun test src",
-    "test:e2e": "bun run test:e2e:supabase",
-    "test:e2e:minikube": "ANKH_MINIKUBE_ISOLATION=1 bun test src/adapters/minikube/base/twoAppIsolation.integration.test.ts",
-    "test:e2e:supabase": "ANKH_MINIKUBE_SUPABASE_ISOLATION=1 bun test src/adapters/minikube/base/twoAppIsolation.integration.test.ts",
+    "test:e2e": "ANKH_INFRA_COMPOSITION_E2E=1 bun test src/infraComposition.integration.test.ts",
     "typecheck": "bun x tsc --noEmit -p tsconfig.json",
+    "check-types": "bun run typecheck",
     "version-packages": "ankhorage-changeset version",
-    "knip:check": "ankhorage-knip"
+    "knip:check": "ankhorage-knip",
+    "knip:test": "bun run knip:check"
   },
   "devDependencies": {
     "@ankhorage/ankh": "^0.8.11",
-    "@ankhorage/devtools": "^1.13.0",
+    "@ankhorage/cerbos": "^0.2.0",
+    "@ankhorage/devtools": "^1.14.0",
+    "@ankhorage/docker-compose": "^0.4.0",
+    "@ankhorage/hetzner": "^0.3.0",
+    "@ankhorage/k3s": "^0.3.0",
+    "@ankhorage/local": "^0.3.0",
+    "@ankhorage/minikube": "^0.3.0",
     "@ankhorage/paradox": "^0.1.24",
+    "@ankhorage/r2": "^0.2.0",
+    "@ankhorage/supabase": "^0.2.0",
+    "@ankhorage/supabase-vault": "^0.3.1",
     "@types/bun": "^1.4.1",
     "@types/node": "^25.6.0",
     "typescript": "^5.9.3"

package/src/adapterPackages.integration.test.ts

@@ -0,0 +1,79 @@
+import type { InfraEnvironmentSpec } from '@ankhorage/contracts/infra';
+import { expect, test } from 'bun:test';
+
+import { createNodeInfraAdapterPackageResolver } from './features/environment-lifecycle/adapters/outbound/createNodeInfraAdapterPackageResolver.js';
+import { resolveInfraAdaptersAsync } from './features/environment-lifecycle/application/use-cases/resolveInfraAdaptersAsync.js';
+
+test('loads every published package in the required provider composition matrix', async () => {
+  const environments = [
+    environment('local', 'minikube'),
+    environment('local', 'k3s'),
+    environment('local', 'docker-compose'),
+    production(false),
+    production(true),
+  ];
+  const resolved = await Promise.all(
+    environments.map((desired) =>
+      resolveInfraAdaptersAsync(desired, createNodeInfraAdapterPackageResolver()),
+    ),
+  );
+  expect(resolved.every(({ ok }) => ok)).toBe(true);
+  expect(
+    new Set(
+      resolved.flatMap((result) =>
+        result.ok
+          ? [
+              result.value.compute.descriptor.id,
+              result.value.runtime.descriptor.id,
+              ...result.value.services.map(({ descriptor }) => descriptor.id),
+            ]
+          : [],
+      ),
+    ),
+  ).toEqual(
+    new Set([
+      'local',
+      'hetzner',
+      'minikube',
+      'k3s',
+      'docker-compose',
+      'supabase',
+      'cerbos',
+      'r2',
+      'supabase-vault',
+    ]),
+  );
+});
+
+function environment(
+  compute: 'local',
+  runtime: 'minikube' | 'k3s' | 'docker-compose',
+): InfraEnvironmentSpec {
+  if (runtime === 'minikube') {
+    return {
+      deployment: { compute: { provider: compute }, runtime: { provider: runtime } },
+      database: { provider: 'supabase' },
+    };
+  }
+  return {
+    deployment: { compute: { provider: compute }, runtime: { provider: runtime } },
+    database: { provider: 'supabase' },
+  };
+}
+
+function production(withOptionalServices: boolean): InfraEnvironmentSpec {
+  return {
+    deployment: {
+      compute: { provider: 'hetzner', location: 'nbg1' },
+      runtime: { provider: 'k3s', topology: { servers: 1, agents: 0 } },
+    },
+    database: { provider: 'supabase' },
+    ...(withOptionalServices
+      ? {
+          objectStorage: { provider: 'r2' as const, buckets: ['media'] },
+          authz: { provider: 'cerbos' as const, kind: 'ABAC' as const },
+          secretStore: { provider: 'supabase-vault' as const },
+        }
+      : {}),
+  };
+}

package/src/cli/bin.ts

@@ -1,67 +1,8 @@
 #!/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';
-}
+import { runInfraCliAsync } from './runInfraCliAsync.js';
 
 if (import.meta.main) {
-  const result = await runCli(process.argv.slice(2));
+  const result = await runInfraCliAsync(process.argv.slice(2));
   process.exit(result.exitCode);
 }

package/src/cli/cli.test.ts

@@ -1,137 +1,46 @@
-import type { AnkhDiscoveredPackage, AnkhLoadedProvider } from '@ankhorage/ankh';
-import {
-  createPackageRegistry,
-  createProviderRegistry,
-  runCli as runAnkhCli,
-} from '@ankhorage/ankh';
 import { describe, expect, test } from 'bun:test';
 
 import { createCapturedCommandContext } from '../testSupport.js';
-import { runCli } from './bin.js';
-import { createInfraRuntimeProvider } from './index.js';
+import { runInfraCliAsync } from './runInfraCliAsync.js';
 
-describe('standalone cli and provider-backed dispatch', () => {
-  test('prints help and version for the standalone CLI', async () => {
+describe('standalone Infra CLI', () => {
+  test('prints help/version and dispatches all commands through the shared runner', 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((await runInfraCliAsync([], { context: help.context })).exitCode).toBe(0);
+    expect(help.stdout.value).toContain('ankhorage-infra <command>');
+    expect(help.stdout.value).toContain('destroy');
+    expect((await runInfraCliAsync(['--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');
+    for (const name of [
+      'validate',
+      'plan',
+      'generate',
+      'up',
+      'status',
+      'outputs',
+      'down',
+      'destroy',
+    ]) {
+      await runInfraCliAsync([name, 'shop'], {
+        context: createCapturedCommandContext('/workspace').context,
+        runCommandImpl(request) {
+          calls.push(request.command.standaloneName);
+          return Promise.resolve({ exitCode: 0 });
+        },
+      });
+    }
+    expect(calls).toEqual([
+      'validate',
+      'plan',
+      'generate',
+      'up',
+      'status',
+      'outputs',
+      'down',
+      'destroy',
+    ]);
   });
 });
-
-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/commands/destroy.ts

@@ -0,0 +1,57 @@
+import type { AppEnvironmentId } from '@ankhorage/contracts/environments';
+
+import { INFRA_CAPABILITIES } from '../../constants.js';
+import type { InfraCommandDefinition } from '../../types/infraCli.js';
+import type { InfraDestroyOperationRequest } from '../../types/infraOrchestration.js';
+import { prepareInfraCommandOperationAsync } from '../utils/prepareInfraCommandOperationAsync.js';
+import { requireInfraSuccess } from '../utils/requireInfraSuccess.js';
+import { resolveInfraPersistence } from '../utils/resolveInfraPersistence.js';
+import { writeInfraStructured } from '../utils/writeInfraStructured.js';
+
+/*** Define exact-scope destruction behind environment and persistent-resource confirmation. */
+export const destroy = {
+  standaloneName: 'destroy',
+  path: ['destroy'],
+  capability: INFRA_CAPABILITIES[7],
+  summary: 'Destroy exact owned resources behind explicit confirmation.',
+  async run(request, services) {
+    const operation = await prepareInfraCommandOperationAsync(request, services, true);
+    const environment = requireEnvironment(request.arguments.environment);
+    const confirmation = `${operation.project.projectId}:${environment}`;
+    if (request.arguments.confirmation !== confirmation) {
+      throw new Error(`Infra destroy requires --confirm ${confirmation}.`);
+    }
+    const destroyRequest: InfraDestroyOperationRequest = {
+      ...operation.operation,
+      environment,
+      confirmation: { projectId: operation.project.projectId, environment },
+      persistence: resolveInfraPersistence(
+        operation.state?.ledger,
+        request.arguments.deleteResources,
+      ),
+    };
+    const result = await services.operations.destroy(destroyRequest, operation.dependencies);
+    requireInfraSuccess(result, request.context);
+    await services.writeArtifacts(operation.project.projectPath, [], operation.state?.ledger);
+    if (result.value.ledger === null) {
+      await services.removeState(operation.project.projectPath, environment);
+    } else {
+      await services.writeState(operation.project.projectPath, {
+        schemaVersion: 1,
+        desired: operation.desired,
+        ledger: result.value.ledger,
+      });
+    }
+    writeInfraStructured(request.context, request.arguments.format, {
+      environment: result.value.environment,
+      retainedResources: result.value.ledger?.resources.length ?? 0,
+    });
+    return { exitCode: 0 };
+  },
+} as const satisfies InfraCommandDefinition;
+
+/*** Require the explicit destroy environment after CLI parsing. */
+function requireEnvironment(value: AppEnvironmentId | undefined): AppEnvironmentId {
+  if (value === undefined) throw new Error('Infra destroy requires an explicit environment.');
+  return value;
+}