@ankhorage/infra 5.0.0 → 5.1.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/infra
 
+## 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.0",
   "description": "Project-aware infrastructure generation library and executable Ankh provider for Ankhorage.",
   "homepage": "https://github.com/ankhorage/infra#readme",
   "bugs": {

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/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>;
+}