@ankhorage/infra 5.0.0 → 5.1.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/infra
 
+## 5.1.1
+
+### Patch Changes
+
+- 0771f29: Add reproducible local Minikube + Supabase Phase 8 parity acceptance against the released provider-neutral adapters and runtime fixes.
+
+## 5.1.0
+
+### Minor Changes
+
+- 51a60f2: Expose a typed project lifecycle that applies the canonical Infra use cases while preserving environment-scoped state and generated artifact ownership.
+
 ## 5.0.0
 
 ### Major Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # INFRA
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v4.1.12](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v5.0.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Executable infra provider and standalone CLI for Ankhorage project workflows.
 

package/dist/features/environment-lifecycle/composition/createProjectInfraLifecycle.d.ts

@@ -0,0 +1,4 @@
+import type { CreateProjectInfraLifecycleOptions, ProjectInfraLifecycle } from '../../../types/infraProject.js';
+/*** Create the typed project-facing Infra lifecycle backed by canonical use cases and ownership state. */
+export declare function createProjectInfraLifecycle(options?: CreateProjectInfraLifecycleOptions): ProjectInfraLifecycle;
+//# sourceMappingURL=createProjectInfraLifecycle.d.ts.map

package/dist/features/environment-lifecycle/composition/createProjectInfraLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProjectInfraLifecycle.d.ts","sourceRoot":"","sources":["../../../../src/features/environment-lifecycle/composition/createProjectInfraLifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kCAAkC,EAClC,qBAAqB,EAEtB,MAAM,gCAAgC,CAAC;AAGxC,0GAA0G;AAC1G,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,kCAAuC,GAC/C,qBAAqB,CAiFvB"}

package/dist/features/environment-lifecycle/composition/createProjectInfraLifecycle.js

@@ -0,0 +1,123 @@
+import { INFRA_PACKAGE_VERSION } from '../../../constants.js';
+import { createInfraCommandServices } from './createInfraCommandServices.js';
+/*** Create the typed project-facing Infra lifecycle backed by canonical use cases and ownership state. */
+export function createProjectInfraLifecycle(options = {}) {
+    const services = createInfraCommandServices(options.services);
+    return {
+        async validateAsync(request) {
+            const prepared = await prepareProjectOperationAsync(request, services);
+            return services.operations.validate(prepared.operation, prepared.dependencies);
+        },
+        async planAsync(request) {
+            const prepared = await prepareProjectOperationAsync(request, services);
+            return services.operations.plan(prepared.operation, prepared.dependencies);
+        },
+        async generateAsync(request) {
+            const prepared = await prepareProjectOperationAsync(request, services);
+            const result = await services.operations.generate(prepared.operation, prepared.dependencies);
+            if (!result.ok)
+                return result;
+            await services.writeArtifacts(request.projectPath, result.value.artifacts, prepared.state?.ledger);
+            await services.writeState(request.projectPath, {
+                schemaVersion: 1,
+                desired: prepared.desired,
+                ledger: result.value.ledger,
+            });
+            return result;
+        },
+        async upAsync(request) {
+            const prepared = await prepareProjectOperationAsync(request, services);
+            const result = await services.operations.up(prepared.operation, prepared.dependencies);
+            if (!result.ok)
+                return result;
+            await services.writeState(request.projectPath, {
+                schemaVersion: 1,
+                desired: prepared.desired,
+                ledger: result.value.ledger,
+            });
+            return result;
+        },
+        async statusAsync(request) {
+            const prepared = await prepareProjectOperationAsync(request, services);
+            return services.operations.status(prepared.operation, prepared.dependencies);
+        },
+        async outputsAsync(request) {
+            const prepared = await prepareProjectOperationAsync(request, services);
+            return services.operations.outputs(prepared.operation);
+        },
+        async downAsync(request) {
+            const prepared = await prepareProjectOperationAsync(request, services);
+            const result = await services.operations.down(prepared.operation, prepared.dependencies);
+            if (!result.ok)
+                return result;
+            await services.writeState(request.projectPath, {
+                schemaVersion: 1,
+                desired: prepared.desired,
+                ledger: result.value.ledger,
+            });
+            return result;
+        },
+        async destroyAsync(request) {
+            const prepared = await prepareProjectOperationAsync(request, services, true);
+            const result = await services.operations.destroy({
+                ...prepared.operation,
+                confirmation: request.confirmation,
+                persistence: request.persistence,
+            }, prepared.dependencies);
+            if (!result.ok)
+                return result;
+            await services.writeArtifacts(request.projectPath, [], prepared.state?.ledger);
+            if (result.value.ledger === null)
+                await services.removeState(request.projectPath, request.environment);
+            else {
+                await services.writeState(request.projectPath, {
+                    schemaVersion: 1,
+                    desired: prepared.desired,
+                    ledger: result.value.ledger,
+                });
+            }
+            return result;
+        },
+    };
+}
+/*** Resolve one explicit project/environment request with its prior ownership state and dependencies. */
+async function prepareProjectOperationAsync(request, services, useStoredDesired = false) {
+    const state = await services.readState(request.projectPath, request.environment);
+    const currentDesired = readEnvironment(request.manifest, request.environment);
+    const desired = useStoredDesired && state !== null ? state.desired : currentDesired;
+    if (desired === undefined) {
+        throw new Error(`Infra environment "${request.environment}" is not configured.`);
+    }
+    const context = {
+        cwd: request.projectPath,
+        env: request.executionEnvironment ?? process.env,
+        version: INFRA_PACKAGE_VERSION,
+        writeStdout: () => undefined,
+        writeStderr: () => undefined,
+    };
+    return {
+        state,
+        desired,
+        operation: {
+            projectId: request.projectId,
+            manifest: replaceEnvironment(request.manifest, request.environment, desired),
+            environment: request.environment,
+            ...(state === null ? {} : { previous: state.ledger, previousDesired: state.desired }),
+            ...(request.signal === undefined ? {} : { signal: request.signal }),
+        },
+        dependencies: services.createDependencies(context),
+    };
+}
+/*** Read one exact environment without inventing a fallback. */
+function readEnvironment(manifest, environment) {
+    if (environment === 'local')
+        return manifest.environments.local;
+    if (environment === 'preview')
+        return manifest.environments.preview;
+    return manifest.environments.production;
+}
+/*** Replace one selected environment while preserving all other manifest state. */
+function replaceEnvironment(manifest, environment, desired) {
+    return { ...manifest, environments: { ...manifest.environments, [environment]: desired } };
+}
+//# sourceMappingURL=createProjectInfraLifecycle.js.map

package/dist/features/environment-lifecycle/composition/createProjectInfraLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProjectInfraLifecycle.js","sourceRoot":"","sources":["../../../../src/features/environment-lifecycle/composition/createProjectInfraLifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InfraEnvironmentSpec, InfraManifest } from '@ankhorage/contracts/infra';\n\nimport { INFRA_PACKAGE_VERSION } from '../../../constants.js';\nimport type { InfraOperationRequest, InfraStoredState } from '../../../types/infraOrchestration.js';\nimport type {\n  CreateProjectInfraLifecycleOptions,\n  ProjectInfraLifecycle,\n  ProjectInfraOperationRequest,\n} from '../../../types/infraProject.js';\nimport { createInfraCommandServices } from './createInfraCommandServices.js';\n\n/*** Create the typed project-facing Infra lifecycle backed by canonical use cases and ownership state. */\nexport function createProjectInfraLifecycle(\n  options: CreateProjectInfraLifecycleOptions = {},\n): ProjectInfraLifecycle {\n  const services = createInfraCommandServices(options.services);\n  return {\n    async validateAsync(request) {\n      const prepared = await prepareProjectOperationAsync(request, services);\n      return services.operations.validate(prepared.operation, prepared.dependencies);\n    },\n    async planAsync(request) {\n      const prepared = await prepareProjectOperationAsync(request, services);\n      return services.operations.plan(prepared.operation, prepared.dependencies);\n    },\n    async generateAsync(request) {\n      const prepared = await prepareProjectOperationAsync(request, services);\n      const result = await services.operations.generate(prepared.operation, prepared.dependencies);\n      if (!result.ok) return result;\n      await services.writeArtifacts(\n        request.projectPath,\n        result.value.artifacts,\n        prepared.state?.ledger,\n      );\n      await services.writeState(request.projectPath, {\n        schemaVersion: 1,\n        desired: prepared.desired,\n        ledger: result.value.ledger,\n      });\n      return result;\n    },\n    async upAsync(request) {\n      const prepared = await prepareProjectOperationAsync(request, services);\n      const result = await services.operations.up(prepared.operation, prepared.dependencies);\n      if (!result.ok) return result;\n      await services.writeState(request.projectPath, {\n        schemaVersion: 1,\n        desired: prepared.desired,\n        ledger: result.value.ledger,\n      });\n      return result;\n    },\n    async statusAsync(request) {\n      const prepared = await prepareProjectOperationAsync(request, services);\n      return services.operations.status(prepared.operation, prepared.dependencies);\n    },\n    async outputsAsync(request) {\n      const prepared = await prepareProjectOperationAsync(request, services);\n      return services.operations.outputs(prepared.operation);\n    },\n    async downAsync(request) {\n      const prepared = await prepareProjectOperationAsync(request, services);\n      const result = await services.operations.down(prepared.operation, prepared.dependencies);\n      if (!result.ok) return result;\n      await services.writeState(request.projectPath, {\n        schemaVersion: 1,\n        desired: prepared.desired,\n        ledger: result.value.ledger,\n      });\n      return result;\n    },\n    async destroyAsync(request) {\n      const prepared = await prepareProjectOperationAsync(request, services, true);\n      const result = await services.operations.destroy(\n        {\n          ...prepared.operation,\n          confirmation: request.confirmation,\n          persistence: request.persistence,\n        },\n        prepared.dependencies,\n      );\n      if (!result.ok) return result;\n      await services.writeArtifacts(request.projectPath, [], prepared.state?.ledger);\n      if (result.value.ledger === null)\n        await services.removeState(request.projectPath, request.environment);\n      else {\n        await services.writeState(request.projectPath, {\n          schemaVersion: 1,\n          desired: prepared.desired,\n          ledger: result.value.ledger,\n        });\n      }\n      return result;\n    },\n  };\n}\n\ninterface PreparedProjectOperation {\n  readonly operation: InfraOperationRequest;\n  readonly desired: InfraEnvironmentSpec;\n  readonly state: InfraStoredState | null;\n  readonly dependencies: ReturnType<\n    ReturnType<typeof createInfraCommandServices>['createDependencies']\n  >;\n}\n\n/*** Resolve one explicit project/environment request with its prior ownership state and dependencies. */\nasync function prepareProjectOperationAsync(\n  request: ProjectInfraOperationRequest,\n  services: ReturnType<typeof createInfraCommandServices>,\n  useStoredDesired = false,\n): Promise<PreparedProjectOperation> {\n  const state = await services.readState(request.projectPath, request.environment);\n  const currentDesired = readEnvironment(request.manifest, request.environment);\n  const desired = useStoredDesired && state !== null ? state.desired : currentDesired;\n  if (desired === undefined) {\n    throw new Error(`Infra environment \"${request.environment}\" is not configured.`);\n  }\n  const context = {\n    cwd: request.projectPath,\n    env: request.executionEnvironment ?? process.env,\n    version: INFRA_PACKAGE_VERSION,\n    writeStdout: () => undefined,\n    writeStderr: () => undefined,\n  };\n  return {\n    state,\n    desired,\n    operation: {\n      projectId: request.projectId,\n      manifest: replaceEnvironment(request.manifest, request.environment, desired),\n      environment: request.environment,\n      ...(state === null ? {} : { previous: state.ledger, previousDesired: state.desired }),\n      ...(request.signal === undefined ? {} : { signal: request.signal }),\n    },\n    dependencies: services.createDependencies(context),\n  };\n}\n\n/*** Read one exact environment without inventing a fallback. */\nfunction readEnvironment(\n  manifest: InfraManifest,\n  environment: ProjectInfraOperationRequest['environment'],\n): InfraEnvironmentSpec | undefined {\n  if (environment === 'local') return manifest.environments.local;\n  if (environment === 'preview') return manifest.environments.preview;\n  return manifest.environments.production;\n}\n\n/*** Replace one selected environment while preserving all other manifest state. */\nfunction replaceEnvironment(\n  manifest: InfraManifest,\n  environment: ProjectInfraOperationRequest['environment'],\n  desired: InfraEnvironmentSpec,\n): InfraManifest {\n  return { ...manifest, environments: { ...manifest.environments, [environment]: desired } };\n}\n"]}

package/dist/project/index.d.ts

@@ -3,6 +3,7 @@ export { removeStoredInfraStateAsync } from '../features/environment-lifecycle/a
 export { resolveInfraProjectAsync } from '../features/environment-lifecycle/adapters/outbound/resolveInfraProjectAsync.js';
 export { writeInfraGeneratedArtifactsAsync } from '../features/environment-lifecycle/adapters/outbound/writeInfraGeneratedArtifactsAsync.js';
 export { writeStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/writeStoredInfraStateAsync.js';
+export { createProjectInfraLifecycle } from '../features/environment-lifecycle/composition/createProjectInfraLifecycle.js';
 export { resolveProjectFile } from '../features/environment-lifecycle/utils/resolveProjectFile.js';
-export type { InfraArtifactWriteResult, ResolvedInfraProject } from '../types/infraProject.js';
+export type { CreateProjectInfraLifecycleOptions, InfraArtifactWriteResult, ProjectInfraDestroyRequest, ProjectInfraLifecycle, ProjectInfraOperationRequest, ResolvedInfraProject, } from '../types/infraProject.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/project/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kFAAkF,CAAC;AAC7H,OAAO,EAAE,2BAA2B,EAAE,MAAM,oFAAoF,CAAC;AACjI,OAAO,EAAE,wBAAwB,EAAE,MAAM,iFAAiF,CAAC;AAC3H,OAAO,EAAE,iCAAiC,EAAE,MAAM,0FAA0F,CAAC;AAC7I,OAAO,EAAE,0BAA0B,EAAE,MAAM,mFAAmF,CAAC;AAC/H,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AACnG,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kFAAkF,CAAC;AAC7H,OAAO,EAAE,2BAA2B,EAAE,MAAM,oFAAoF,CAAC;AACjI,OAAO,EAAE,wBAAwB,EAAE,MAAM,iFAAiF,CAAC;AAC3H,OAAO,EAAE,iCAAiC,EAAE,MAAM,0FAA0F,CAAC;AAC7I,OAAO,EAAE,0BAA0B,EAAE,MAAM,mFAAmF,CAAC;AAC/H,OAAO,EAAE,2BAA2B,EAAE,MAAM,8EAA8E,CAAC;AAC3H,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AACnG,YAAY,EACV,kCAAkC,EAClC,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC"}

package/dist/project/index.js

@@ -3,5 +3,6 @@ export { removeStoredInfraStateAsync } from '../features/environment-lifecycle/a
 export { resolveInfraProjectAsync } from '../features/environment-lifecycle/adapters/outbound/resolveInfraProjectAsync.js';
 export { writeInfraGeneratedArtifactsAsync } from '../features/environment-lifecycle/adapters/outbound/writeInfraGeneratedArtifactsAsync.js';
 export { writeStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/writeStoredInfraStateAsync.js';
+export { createProjectInfraLifecycle } from '../features/environment-lifecycle/composition/createProjectInfraLifecycle.js';
 export { resolveProjectFile } from '../features/environment-lifecycle/utils/resolveProjectFile.js';
 //# sourceMappingURL=index.js.map

package/dist/project/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kFAAkF,CAAC;AAC7H,OAAO,EAAE,2BAA2B,EAAE,MAAM,oFAAoF,CAAC;AACjI,OAAO,EAAE,wBAAwB,EAAE,MAAM,iFAAiF,CAAC;AAC3H,OAAO,EAAE,iCAAiC,EAAE,MAAM,0FAA0F,CAAC;AAC7I,OAAO,EAAE,0BAA0B,EAAE,MAAM,mFAAmF,CAAC;AAC/H,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC","sourcesContent":["export { readStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/readStoredInfraStateAsync.js';\nexport { removeStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/removeStoredInfraStateAsync.js';\nexport { resolveInfraProjectAsync } from '../features/environment-lifecycle/adapters/outbound/resolveInfraProjectAsync.js';\nexport { writeInfraGeneratedArtifactsAsync } from '../features/environment-lifecycle/adapters/outbound/writeInfraGeneratedArtifactsAsync.js';\nexport { writeStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/writeStoredInfraStateAsync.js';\nexport { resolveProjectFile } from '../features/environment-lifecycle/utils/resolveProjectFile.js';\nexport type { InfraArtifactWriteResult, ResolvedInfraProject } from '../types/infraProject.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kFAAkF,CAAC;AAC7H,OAAO,EAAE,2BAA2B,EAAE,MAAM,oFAAoF,CAAC;AACjI,OAAO,EAAE,wBAAwB,EAAE,MAAM,iFAAiF,CAAC;AAC3H,OAAO,EAAE,iCAAiC,EAAE,MAAM,0FAA0F,CAAC;AAC7I,OAAO,EAAE,0BAA0B,EAAE,MAAM,mFAAmF,CAAC;AAC/H,OAAO,EAAE,2BAA2B,EAAE,MAAM,8EAA8E,CAAC;AAC3H,OAAO,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC","sourcesContent":["export { readStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/readStoredInfraStateAsync.js';\nexport { removeStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/removeStoredInfraStateAsync.js';\nexport { resolveInfraProjectAsync } from '../features/environment-lifecycle/adapters/outbound/resolveInfraProjectAsync.js';\nexport { writeInfraGeneratedArtifactsAsync } from '../features/environment-lifecycle/adapters/outbound/writeInfraGeneratedArtifactsAsync.js';\nexport { writeStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/writeStoredInfraStateAsync.js';\nexport { createProjectInfraLifecycle } from '../features/environment-lifecycle/composition/createProjectInfraLifecycle.js';\nexport { resolveProjectFile } from '../features/environment-lifecycle/utils/resolveProjectFile.js';\nexport type {\n  CreateProjectInfraLifecycleOptions,\n  InfraArtifactWriteResult,\n  ProjectInfraDestroyRequest,\n  ProjectInfraLifecycle,\n  ProjectInfraOperationRequest,\n  ResolvedInfraProject,\n} from '../types/infraProject.js';\n"]}

package/dist/types/infraProject.d.ts

@@ -1,4 +1,8 @@
 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;
@@ -11,4 +15,29 @@ export interface ResolvedInfraProject {
     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

@@ -1 +1 @@
-{"version":3,"file":"infraProject.d.ts","sourceRoot":"","sources":["../../src/types/infraProject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,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"}
+{"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.map

@@ -1 +1 @@
-{"version":3,"file":"infraProject.js","sourceRoot":"","sources":["../../src/types/infraProject.ts"],"names":[],"mappings":"","sourcesContent":["import type { AppManifest } from '@ankhorage/contracts';\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"]}
+{"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": "5.0.0",
+  "version": "5.1.1",
   "description": "Project-aware infrastructure generation library and executable Ankh provider for Ankhorage.",
   "homepage": "https://github.com/ankhorage/infra#readme",
   "bugs": {
@@ -35,7 +35,7 @@
     "openapi"
   ],
   "dependencies": {
-    "@ankhorage/contracts": "^19.0.0"
+    "@ankhorage/contracts": "^19.1.0"
   },
   "files": [
     "dist",
@@ -100,6 +100,7 @@
     "prepack": "bun run build",
     "test": "bun test src",
     "test:e2e": "ANKH_INFRA_COMPOSITION_E2E=1 bun test src/infraComposition.integration.test.ts",
+    "test:e2e:minikube-supabase": "ANKH_INFRA_MINIKUBE_SUPABASE_E2E=1 bun test src/localMinikubeSupabase.integration.test.ts",
     "typecheck": "bun x tsc --noEmit -p tsconfig.json",
     "check-types": "bun run typecheck",
     "version-packages": "ankhorage-changeset version",
@@ -114,10 +115,10 @@
     "@ankhorage/hetzner": "^0.3.0",
     "@ankhorage/k3s": "^0.3.0",
     "@ankhorage/local": "^0.3.0",
-    "@ankhorage/minikube": "^0.3.0",
+    "@ankhorage/minikube": "^0.4.1",
     "@ankhorage/paradox": "^0.1.24",
     "@ankhorage/r2": "^0.2.0",
-    "@ankhorage/supabase": "^0.2.0",
+    "@ankhorage/supabase": "^0.4.5",
     "@ankhorage/supabase-vault": "^0.3.1",
     "@types/bun": "^1.4.1",
     "@types/node": "^25.6.0",

package/src/features/environment-lifecycle/composition/createProjectInfraLifecycle.ts

@@ -0,0 +1,157 @@
+import type { InfraEnvironmentSpec, InfraManifest } from '@ankhorage/contracts/infra';
+
+import { INFRA_PACKAGE_VERSION } from '../../../constants.js';
+import type { InfraOperationRequest, InfraStoredState } from '../../../types/infraOrchestration.js';
+import type {
+  CreateProjectInfraLifecycleOptions,
+  ProjectInfraLifecycle,
+  ProjectInfraOperationRequest,
+} from '../../../types/infraProject.js';
+import { createInfraCommandServices } from './createInfraCommandServices.js';
+
+/*** Create the typed project-facing Infra lifecycle backed by canonical use cases and ownership state. */
+export function createProjectInfraLifecycle(
+  options: CreateProjectInfraLifecycleOptions = {},
+): ProjectInfraLifecycle {
+  const services = createInfraCommandServices(options.services);
+  return {
+    async validateAsync(request) {
+      const prepared = await prepareProjectOperationAsync(request, services);
+      return services.operations.validate(prepared.operation, prepared.dependencies);
+    },
+    async planAsync(request) {
+      const prepared = await prepareProjectOperationAsync(request, services);
+      return services.operations.plan(prepared.operation, prepared.dependencies);
+    },
+    async generateAsync(request) {
+      const prepared = await prepareProjectOperationAsync(request, services);
+      const result = await services.operations.generate(prepared.operation, prepared.dependencies);
+      if (!result.ok) return result;
+      await services.writeArtifacts(
+        request.projectPath,
+        result.value.artifacts,
+        prepared.state?.ledger,
+      );
+      await services.writeState(request.projectPath, {
+        schemaVersion: 1,
+        desired: prepared.desired,
+        ledger: result.value.ledger,
+      });
+      return result;
+    },
+    async upAsync(request) {
+      const prepared = await prepareProjectOperationAsync(request, services);
+      const result = await services.operations.up(prepared.operation, prepared.dependencies);
+      if (!result.ok) return result;
+      await services.writeState(request.projectPath, {
+        schemaVersion: 1,
+        desired: prepared.desired,
+        ledger: result.value.ledger,
+      });
+      return result;
+    },
+    async statusAsync(request) {
+      const prepared = await prepareProjectOperationAsync(request, services);
+      return services.operations.status(prepared.operation, prepared.dependencies);
+    },
+    async outputsAsync(request) {
+      const prepared = await prepareProjectOperationAsync(request, services);
+      return services.operations.outputs(prepared.operation);
+    },
+    async downAsync(request) {
+      const prepared = await prepareProjectOperationAsync(request, services);
+      const result = await services.operations.down(prepared.operation, prepared.dependencies);
+      if (!result.ok) return result;
+      await services.writeState(request.projectPath, {
+        schemaVersion: 1,
+        desired: prepared.desired,
+        ledger: result.value.ledger,
+      });
+      return result;
+    },
+    async destroyAsync(request) {
+      const prepared = await prepareProjectOperationAsync(request, services, true);
+      const result = await services.operations.destroy(
+        {
+          ...prepared.operation,
+          confirmation: request.confirmation,
+          persistence: request.persistence,
+        },
+        prepared.dependencies,
+      );
+      if (!result.ok) return result;
+      await services.writeArtifacts(request.projectPath, [], prepared.state?.ledger);
+      if (result.value.ledger === null)
+        await services.removeState(request.projectPath, request.environment);
+      else {
+        await services.writeState(request.projectPath, {
+          schemaVersion: 1,
+          desired: prepared.desired,
+          ledger: result.value.ledger,
+        });
+      }
+      return result;
+    },
+  };
+}
+
+interface PreparedProjectOperation {
+  readonly operation: InfraOperationRequest;
+  readonly desired: InfraEnvironmentSpec;
+  readonly state: InfraStoredState | null;
+  readonly dependencies: ReturnType<
+    ReturnType<typeof createInfraCommandServices>['createDependencies']
+  >;
+}
+
+/*** Resolve one explicit project/environment request with its prior ownership state and dependencies. */
+async function prepareProjectOperationAsync(
+  request: ProjectInfraOperationRequest,
+  services: ReturnType<typeof createInfraCommandServices>,
+  useStoredDesired = false,
+): Promise<PreparedProjectOperation> {
+  const state = await services.readState(request.projectPath, request.environment);
+  const currentDesired = readEnvironment(request.manifest, request.environment);
+  const desired = useStoredDesired && state !== null ? state.desired : currentDesired;
+  if (desired === undefined) {
+    throw new Error(`Infra environment "${request.environment}" is not configured.`);
+  }
+  const context = {
+    cwd: request.projectPath,
+    env: request.executionEnvironment ?? process.env,
+    version: INFRA_PACKAGE_VERSION,
+    writeStdout: () => undefined,
+    writeStderr: () => undefined,
+  };
+  return {
+    state,
+    desired,
+    operation: {
+      projectId: request.projectId,
+      manifest: replaceEnvironment(request.manifest, request.environment, desired),
+      environment: request.environment,
+      ...(state === null ? {} : { previous: state.ledger, previousDesired: state.desired }),
+      ...(request.signal === undefined ? {} : { signal: request.signal }),
+    },
+    dependencies: services.createDependencies(context),
+  };
+}
+
+/*** Read one exact environment without inventing a fallback. */
+function readEnvironment(
+  manifest: InfraManifest,
+  environment: ProjectInfraOperationRequest['environment'],
+): InfraEnvironmentSpec | undefined {
+  if (environment === 'local') return manifest.environments.local;
+  if (environment === 'preview') return manifest.environments.preview;
+  return manifest.environments.production;
+}
+
+/*** Replace one selected environment while preserving all other manifest state. */
+function replaceEnvironment(
+  manifest: InfraManifest,
+  environment: ProjectInfraOperationRequest['environment'],
+  desired: InfraEnvironmentSpec,
+): InfraManifest {
+  return { ...manifest, environments: { ...manifest.environments, [environment]: desired } };
+}

package/src/localMinikubeSupabase.integration.test.ts

@@ -0,0 +1,219 @@
+import { createHmac } from 'node:crypto';
+
+import type {
+  InfraLedger,
+  InfraManifest,
+  InfraResourceIdentity,
+  InfraResult,
+} from '@ankhorage/contracts/infra';
+import { expect, test } from 'bun:test';
+
+import { createNodeInfraAdapterPackageResolver } from './features/environment-lifecycle/adapters/outbound/createNodeInfraAdapterPackageResolver.js';
+import { destroyInfraEnvironmentAsync } from './features/environment-lifecycle/application/use-cases/destroyInfraEnvironmentAsync.js';
+import { downInfraEnvironmentAsync } from './features/environment-lifecycle/application/use-cases/downInfraEnvironmentAsync.js';
+import { planInfraEnvironmentAsync } from './features/environment-lifecycle/application/use-cases/planInfraEnvironmentAsync.js';
+import { statusInfraEnvironmentAsync } from './features/environment-lifecycle/application/use-cases/statusInfraEnvironmentAsync.js';
+import { upInfraEnvironmentAsync } from './features/environment-lifecycle/application/use-cases/upInfraEnvironmentAsync.js';
+import type { InfraOrchestrationDependencies } from './types/infraOrchestration.js';
+
+const projectId = 'infra145-minikube-supabase';
+const baseUrl = 'http://127.0.0.1:54321';
+const bucket = 'phase8-acceptance';
+const jwtSecret = 'phase8-jwt-secret-that-is-at-least-thirty-two-characters';
+const credentials = {
+  postgresPassword: 'phase8-postgres-password',
+  jwtSecret,
+  anonKey: createJwt('anon'),
+  serviceRoleKey: createJwt('service_role'),
+  realtimeSecretKeyBase: 'r'.repeat(64),
+  realtimeDatabaseEncryptionKey: '0123456789abcdef',
+  pgMetaCryptoKey: 'phase8-meta-crypto-key-that-is-at-least-32-characters',
+} as const;
+const manifest = {
+  environments: {
+    local: {
+      deployment: {
+        compute: { provider: 'local' },
+        runtime: {
+          provider: 'minikube',
+          profile: projectId,
+          driver: 'docker',
+          cpus: 2,
+          memoryMiB: 5_120,
+        },
+      },
+      database: { provider: 'supabase', tier: 'dev' },
+      auth: { provider: 'supabase' },
+      objectStorage: { provider: 'supabase', buckets: [bucket] },
+      networking: { publicBaseUrl: baseUrl },
+    },
+  },
+  modules: [],
+} as const satisfies InfraManifest;
+
+test.skipIf(process.env.ANKH_INFRA_MINIKUBE_SUPABASE_E2E !== '1')(
+  'runs local Minikube and Supabase through the provider-neutral lifecycle',
+  async () => {
+    const dependencies = createDependencies();
+    let ledger: InfraLedger | undefined;
+
+    try {
+      const initialPlan = requireSuccess(
+        await planInfraEnvironmentAsync({ projectId, manifest }, dependencies),
+      );
+      expect(initialPlan.actions.some(({ operation }) => operation === 'create')).toBe(true);
+
+      const { ledger: firstLedger, outputs: firstOutputs } = requireSuccess(
+        await upInfraEnvironmentAsync({ projectId, manifest }, dependencies),
+      );
+      ledger = firstLedger;
+      assertSafePublicOutputs(firstOutputs);
+      expect(
+        firstOutputs.some(
+          ({ owner, name, value }) =>
+            owner.adapter === 'minikube' && name === 'localUrl' && value === baseUrl,
+        ),
+      ).toBe(true);
+      expect(
+        firstOutputs.some(
+          ({ environmentVariable, value }) =>
+            environmentVariable === 'EXPO_PUBLIC_SUPABASE_URL' && value === baseUrl,
+        ),
+      ).toBe(true);
+      expect(firstOutputs.some(({ name, value }) => name === 'bucket' && value === bucket)).toBe(
+        true,
+      );
+
+      const status = requireSuccess(
+        await statusInfraEnvironmentAsync({ projectId, manifest, previous: ledger }, dependencies),
+      );
+      expect(status.state).toBe('ready');
+
+      const convergedPlan = requireSuccess(
+        await planInfraEnvironmentAsync({ projectId, manifest, previous: ledger }, dependencies),
+      );
+      expect(convergedPlan.actions.every(({ operation }) => operation === 'noop')).toBe(true);
+
+      const { ledger: downLedger } = requireSuccess(
+        await downInfraEnvironmentAsync({ projectId, manifest, previous: ledger }, dependencies),
+      );
+      ledger = downLedger;
+
+      const { ledger: resumedLedger, outputs: resumedOutputs } = requireSuccess(
+        await upInfraEnvironmentAsync({ projectId, manifest, previous: ledger }, dependencies),
+      );
+      ledger = resumedLedger;
+      assertSafePublicOutputs(resumedOutputs);
+
+      const health = await fetch(`${baseUrl}/auth/v1/health`);
+      expect(health.ok).toBe(true);
+
+      const destroyed = requireSuccess(
+        await destroyInfraEnvironmentAsync(
+          createDestroyRequest(ledger, persistentIdentities(ledger)),
+          dependencies,
+        ),
+      );
+      ledger = destroyed.ledger ?? undefined;
+      expect(destroyed.ledger).toBeNull();
+    } finally {
+      if (ledger !== undefined) {
+        await destroyInfraEnvironmentAsync(
+          createDestroyRequest(ledger, persistentIdentities(ledger)),
+          dependencies,
+        );
+      }
+    }
+  },
+  900_000,
+);
+
+function createDependencies(): InfraOrchestrationDependencies {
+  return {
+    adapterResolver: createNodeInfraAdapterPackageResolver(),
+    credentials: {
+      resolveAsync: (reference) =>
+        Promise.resolve(
+          reference.name === 'SUPABASE_BOOTSTRAP'
+            ? success(credentials)
+            : failure(
+                'unexpected-control-plane-credential',
+                `Unexpected control-plane credential ${reference.name}.`,
+              ),
+        ),
+    },
+    secrets: {
+      resolveAsync: (reference) =>
+        Promise.resolve(
+          failure(
+            'unexpected-managed-secret',
+            `Unexpected managed secret ${reference.ref}/${reference.key}.`,
+          ),
+        ),
+    },
+  };
+}
+
+function createDestroyRequest(
+  previous: InfraLedger,
+  confirmedResources: readonly InfraResourceIdentity[],
+) {
+  return {
+    projectId,
+    manifest,
+    environment: 'local' as const,
+    previous,
+    confirmation: { projectId, environment: 'local' as const },
+    persistence: { policy: 'delete' as const, confirmedResources },
+  };
+}
+
+function persistentIdentities(ledger: InfraLedger): readonly InfraResourceIdentity[] {
+  return ledger.resources.filter(({ persistent }) => persistent).map(({ identity }) => identity);
+}
+
+function assertSafePublicOutputs(outputs: InfraLedger['outputs']): void {
+  const serialized = JSON.stringify(outputs);
+  expect(serialized).not.toContain(credentials.serviceRoleKey);
+  expect(serialized).not.toContain(credentials.postgresPassword);
+  expect(serialized).not.toContain(credentials.jwtSecret);
+  expect(serialized).not.toContain(credentials.realtimeSecretKeyBase);
+  expect(serialized).not.toContain(credentials.realtimeDatabaseEncryptionKey);
+  expect(serialized).not.toContain(credentials.pgMetaCryptoKey);
+  expect(
+    outputs.some(
+      ({ environmentVariable, value }) =>
+        environmentVariable === 'EXPO_PUBLIC_SUPABASE_ANON_KEY' && value === credentials.anonKey,
+    ),
+  ).toBe(true);
+}
+
+function createJwt(role: 'anon' | 'service_role'): string {
+  const encodedHeader = encodeJwtPart({ alg: 'HS256', typ: 'JWT' });
+  const encodedPayload = encodeJwtPart({
+    role,
+    iss: 'supabase',
+    iat: 1_700_000_000,
+    exp: 4_102_444_800,
+  });
+  const unsigned = `${encodedHeader}.${encodedPayload}`;
+  const signature = createHmac('sha256', jwtSecret).update(unsigned).digest('base64url');
+  return `${unsigned}.${signature}`;
+}
+
+function encodeJwtPart(value: Readonly<Record<string, string | number>>): string {
+  return Buffer.from(JSON.stringify(value)).toString('base64url');
+}
+
+function requireSuccess<T>(result: InfraResult<T>): T {
+  if (!result.ok) throw new Error(result.diagnostics.map(({ message }) => message).join(' '));
+  return result.value;
+}
+
+function success<T>(value: T): InfraResult<T> {
+  return { ok: true, value, diagnostics: [] };
+}
+
+function failure(code: string, message: string): InfraResult<never> {
+  return { ok: false, diagnostics: [{ severity: 'error', code, message }] };
+}

package/src/project/index.test.ts

@@ -1,6 +1,7 @@
 import { describe, expect, test } from 'bun:test';
 
 import {
+  createProjectInfraLifecycle,
   readStoredInfraStateAsync,
   resolveInfraProjectAsync,
   writeInfraGeneratedArtifactsAsync,
@@ -8,6 +9,7 @@ import {
 
 describe('@ankhorage/infra/project', () => {
   test('exports project resolution, safe state and artifact owner APIs', () => {
+    expect(createProjectInfraLifecycle).toBeFunction();
     expect(resolveInfraProjectAsync).toBeFunction();
     expect(readStoredInfraStateAsync).toBeFunction();
     expect(writeInfraGeneratedArtifactsAsync).toBeFunction();

package/src/project/index.ts

@@ -3,5 +3,13 @@ export { removeStoredInfraStateAsync } from '../features/environment-lifecycle/a
 export { resolveInfraProjectAsync } from '../features/environment-lifecycle/adapters/outbound/resolveInfraProjectAsync.js';
 export { writeInfraGeneratedArtifactsAsync } from '../features/environment-lifecycle/adapters/outbound/writeInfraGeneratedArtifactsAsync.js';
 export { writeStoredInfraStateAsync } from '../features/environment-lifecycle/adapters/outbound/writeStoredInfraStateAsync.js';
+export { createProjectInfraLifecycle } from '../features/environment-lifecycle/composition/createProjectInfraLifecycle.js';
 export { resolveProjectFile } from '../features/environment-lifecycle/utils/resolveProjectFile.js';
-export type { InfraArtifactWriteResult, ResolvedInfraProject } from '../types/infraProject.js';
+export type {
+  CreateProjectInfraLifecycleOptions,
+  InfraArtifactWriteResult,
+  ProjectInfraDestroyRequest,
+  ProjectInfraLifecycle,
+  ProjectInfraOperationRequest,
+  ResolvedInfraProject,
+} from '../types/infraProject.js';

package/src/projectLifecycle.test.ts

@@ -0,0 +1,136 @@
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import type { InfraEnvironmentSpec, InfraLedger, InfraResult } from '@ankhorage/contracts/infra';
+import { afterEach, expect, test } from 'bun:test';
+
+import { createProjectInfraLifecycle, readStoredInfraStateAsync } from './project/index.js';
+import type { InfraLifecycleOperations } from './types/infraCli.js';
+import type { InfraDestroyOperationRequest } from './types/infraOrchestration.js';
+
+const temporaryPaths = new Set<string>();
+
+afterEach(async () => {
+  await Promise.all(
+    [...temporaryPaths].map((entry) => fs.rm(entry, { force: true, recursive: true })),
+  );
+  temporaryPaths.clear();
+});
+
+test('runs typed project lifecycle operations with canonical state and artifact ownership', async () => {
+  const projectPath = await fs.mkdtemp(path.join(os.tmpdir(), 'infra-project-lifecycle-'));
+  temporaryPaths.add(projectPath);
+  const destroyRequests: InfraDestroyOperationRequest[] = [];
+  const lifecycle = createProjectInfraLifecycle({
+    services: {
+      createDependencies: () => ({
+        adapterResolver: { loadAsync: () => Promise.resolve({}) },
+        credentials: { resolveAsync: () => Promise.resolve(success({})) },
+        secrets: { resolveAsync: () => Promise.resolve(success('secret')) },
+      }),
+      operations: createOperations(destroyRequests),
+    },
+  });
+  const request = {
+    projectId: 'sample',
+    projectPath,
+    manifest: { environments: { local: desired }, modules: [] },
+    environment: 'local' as const,
+  };
+
+  const generated = await lifecycle.generateAsync(request);
+  expect(generated.ok).toBe(true);
+  expect(await fs.readFile(path.join(projectPath, 'infra/example.txt'), 'utf8')).toBe('generated');
+  expect((await readStoredInfraStateAsync(projectPath, 'local'))?.ledger).toEqual(ledger);
+
+  const outputs = await lifecycle.outputsAsync(request);
+  expect(outputs.ok && outputs.value.outputs).toEqual(ledger.outputs);
+
+  const destroyed = await lifecycle.destroyAsync({
+    ...request,
+    confirmation: { projectId: 'sample', environment: 'local' },
+    persistence: { policy: 'retain' },
+  });
+  expect(destroyed.ok).toBe(true);
+  expect(destroyRequests[0]?.confirmation).toEqual({ projectId: 'sample', environment: 'local' });
+  expect(await readStoredInfraStateAsync(projectPath, 'local')).toBeNull();
+  expect(await fileExists(path.join(projectPath, 'infra/example.txt'))).toBe(false);
+});
+
+const desired = {
+  deployment: {
+    compute: { provider: 'local' },
+    runtime: { provider: 'docker-compose' },
+  },
+} as const satisfies InfraEnvironmentSpec;
+
+const owner = {
+  projectId: 'sample',
+  environment: 'local',
+  adapter: 'docker-compose',
+  resourceId: 'runtime',
+} as const;
+
+const ledger = {
+  schemaVersion: 1,
+  projectId: 'sample',
+  environment: 'local',
+  targets: [],
+  resources: [],
+  outputs: [{ owner, name: 'url', visibility: 'public', value: 'https://example.test' }],
+  artifacts: [{ owner, path: 'infra/example.txt' }],
+} as const satisfies InfraLedger;
+
+/*** Create deterministic operation fakes while recording destructive authorization. */
+function createOperations(
+  destroyRequests: InfraDestroyOperationRequest[],
+): InfraLifecycleOperations {
+  return {
+    validate: () => Promise.resolve(success({ environment: 'local' })),
+    plan: (request) =>
+      Promise.resolve(success({ projectId: request.projectId, environment: 'local', actions: [] })),
+    generate: () =>
+      Promise.resolve(
+        success({
+          environment: 'local',
+          artifacts: [{ owner, path: 'infra/example.txt', content: 'generated' }],
+          ledger,
+        }),
+      ),
+    up: () =>
+      Promise.resolve(
+        success({ environment: 'local', targets: [], resources: [], outputs: [], ledger }),
+      ),
+    status: (request) =>
+      Promise.resolve(
+        success({
+          projectId: request.projectId,
+          environment: 'local',
+          state: 'ready',
+          resources: [],
+        }),
+      ),
+    outputs: () => success({ environment: 'local', outputs: ledger.outputs }),
+    down: () => Promise.resolve(success({ environment: 'local', ledger })),
+    destroy: (request) => {
+      destroyRequests.push(request);
+      return Promise.resolve(success({ environment: 'local', ledger: null }));
+    },
+  };
+}
+
+/*** Create one successful Infra result for operation fakes. */
+function success<T>(value: T): InfraResult<T> {
+  return { ok: true, value, diagnostics: [] };
+}
+
+/*** Report whether a generated artifact still exists. */
+async function fileExists(filePath: string): Promise<boolean> {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/types/infraProject.ts

@@ -1,4 +1,18 @@
 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;
@@ -13,3 +27,32 @@ export interface ResolvedInfraProject {
   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>;
+}