@ankhorage/infra 5.1.5 → 5.1.6

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/infra
 
+## 5.1.6
+
+### Patch Changes
+
+- 57da4cf: Prove the released Hetzner, k3s, Supabase and R2 composition with independent object-storage ownership and privileged output isolation.
+
 ## 5.1.5
 
 ### Patch Changes

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/infra",
   "type": "module",
-  "version": "5.1.5",
+  "version": "5.1.6",
   "description": "Project-aware infrastructure generation library and executable Ankh provider for Ankhorage.",
   "homepage": "https://github.com/ankhorage/infra#readme",
   "bugs": {
@@ -119,7 +119,7 @@
     "@ankhorage/minikube": "^0.4.2",
     "@ankhorage/paradox": "^0.1.24",
     "@ankhorage/r2": "^0.2.0",
-    "@ankhorage/supabase": "^0.4.9",
+    "@ankhorage/supabase": "^0.5.5",
     "@ankhorage/supabase-vault": "^0.3.1",
     "@types/bun": "^1.4.1",
     "@types/node": "^25.6.0",

package/src/hetznerK3sSupabaseR2.test.ts

@@ -0,0 +1,482 @@
+import type { InfraManifest, InfraResult } from '@ankhorage/contracts/infra';
+import {
+  createInfraAdapter as createHetznerInfraAdapter,
+  type HetznerCloudApi,
+  type HetznerCloudObservation,
+  type HetznerDesiredCompute,
+  type HetznerHostKeyProbe,
+  type HetznerProjectIdentity,
+  type HetznerResourceId,
+  infraAdapterDescriptor as hetznerInfraAdapterDescriptor,
+} from '@ankhorage/hetzner';
+import {
+  createInfraAdapter as createK3sInfraAdapter,
+  infraAdapterDescriptor as k3sInfraAdapterDescriptor,
+  type K3sClusterObservation,
+  type K3sClusterSpec,
+  type K3sControlPlane,
+  type K3sNodeAccess,
+} from '@ankhorage/k3s';
+import {
+  createInfraAdapter as createR2InfraAdapter,
+  infraAdapterDescriptor as r2InfraAdapterDescriptor,
+  type R2BucketControlPlane,
+  type R2BucketObservation,
+  type R2CloudRequest,
+} from '@ankhorage/r2';
+import {
+  createInfraAdapter as createSupabaseInfraAdapter,
+  infraAdapterDescriptor as supabaseInfraAdapterDescriptor,
+  type SupabaseControlPlane,
+  type SupabaseControlPlaneRequest,
+} from '@ankhorage/supabase';
+import { expect, test } from 'bun:test';
+
+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 = 'infra163-production-r2';
+const publicBaseUrl = 'https://api.r2-production.example.test';
+const domain = 'api.r2-production.example.test';
+const r2AccountId = 'phase10-r2-account';
+const r2Bucket = 'media';
+
+const manifest = {
+  environments: {
+    production: {
+      deployment: {
+        compute: { provider: 'hetzner', location: 'fsn1', serverType: 'cx23' },
+        runtime: { provider: 'k3s', topology: { servers: 1, agents: 0 } },
+      },
+      database: { provider: 'supabase', tier: 'prod' },
+      auth: { provider: 'supabase' },
+      objectStorage: { provider: 'r2', accountId: r2AccountId, buckets: [r2Bucket] },
+      networking: {
+        domain,
+        publicBaseUrl,
+        tls: { mode: 'acme-http-01', contactEmail: 'infra@example.test' },
+      },
+    },
+  },
+  modules: [],
+} as const satisfies InfraManifest;
+
+test('composes Hetzner, k3s, Supabase database/auth and independent R2 object storage', async () => {
+  const fixture = new ProductionR2Fixture();
+  const dependencies = createDependencies(fixture);
+
+  const initialPlan = requireSuccess(
+    await planInfraEnvironmentAsync(
+      { projectId, manifest, environment: 'production' },
+      dependencies,
+    ),
+  );
+  const initialOwners = new Set(initialPlan.actions.map(({ owner }) => owner.adapter));
+  expect(initialOwners.has('supabase')).toBe(true);
+  expect(initialOwners.has('r2')).toBe(true);
+  expect(initialPlan.actions.some(({ operation }) => operation === 'create')).toBe(true);
+
+  const firstUp = requireSuccess(
+    await upInfraEnvironmentAsync({ projectId, manifest, environment: 'production' }, dependencies),
+  );
+  const serializedWorkloads = fixture.kubernetes.serializedResources();
+  expect(serializedWorkloads).toContain('supabase-db');
+  expect(serializedWorkloads).toContain('supabase-auth');
+  expect(serializedWorkloads).toContain('supabase-gateway');
+  expect(serializedWorkloads).not.toContain('supabase-storage');
+  expect(serializedWorkloads).not.toContain('supabase-imgproxy');
+  expect(serializedWorkloads).not.toContain('/storage/v1/');
+  expect(fixture.supabase.created).toEqual([]);
+  expect(fixture.r2.created).toEqual([r2Bucket]);
+
+  expect(
+    firstUp.resources.some(
+      ({ identity }) => identity.adapter === 'r2' && identity.resourceId === `bucket/${r2Bucket}`,
+    ),
+  ).toBe(true);
+  expect(
+    firstUp.resources.some(
+      ({ identity }) =>
+        identity.adapter === 'supabase' && identity.resourceId.startsWith('bucket/'),
+    ),
+  ).toBe(false);
+
+  const r2Outputs = firstUp.outputs.filter(({ owner }) => owner.adapter === 'r2');
+  expect(r2Outputs.map(({ name }) => name)).toEqual(['bucket', 'accountId', 's3Endpoint']);
+  expect(r2Outputs.every(({ visibility }) => visibility === 'public')).toBe(true);
+  expect(r2Outputs.map(({ value }) => value)).toEqual([
+    r2Bucket,
+    r2AccountId,
+    `https://${r2AccountId}.r2.cloudflarestorage.com`,
+  ]);
+
+  const serializedOutputs = JSON.stringify(firstUp.outputs);
+  expect(serializedOutputs).not.toContain('phase10-r2-api-token');
+  expect(serializedOutputs).not.toContain('phase10-private-key');
+  expect(serializedOutputs).not.toContain('phase10-postgres-password');
+  expect(serializedOutputs).not.toContain('phase10-jwt-secret');
+  expect(serializedOutputs).not.toContain('phase10-service-role-key');
+
+  const status = requireSuccess(
+    await statusInfraEnvironmentAsync(
+      { projectId, manifest, environment: 'production', previous: firstUp.ledger },
+      dependencies,
+    ),
+  );
+  expect(status.state).toBe('ready');
+
+  const converged = requireSuccess(
+    await planInfraEnvironmentAsync(
+      { projectId, manifest, environment: 'production', previous: firstUp.ledger },
+      dependencies,
+    ),
+  );
+  expect(converged.actions.every(({ operation }) => operation === 'noop')).toBe(true);
+
+  const secondUp = requireSuccess(
+    await upInfraEnvironmentAsync(
+      { projectId, manifest, environment: 'production', previous: firstUp.ledger },
+      dependencies,
+    ),
+  );
+  expect(fixture.r2.created).toEqual([r2Bucket]);
+  expect(secondUp.outputs.filter(({ owner }) => owner.adapter === 'r2')).toEqual(r2Outputs);
+});
+
+class ProductionR2Fixture {
+  readonly hetzner = new FakeHetznerCloudApi();
+  readonly hostKeyProbe = new FakeHostKeyProbe();
+  readonly k3s = new FakeK3sControlPlane();
+  readonly kubernetes = this.k3s.api;
+  readonly supabase = new FakeSupabaseControlPlane();
+  readonly r2 = new FakeR2ControlPlane();
+}
+
+function createDependencies(fixture: ProductionR2Fixture): InfraOrchestrationDependencies {
+  return {
+    adapterResolver: {
+      loadAsync: (packageName) => {
+        switch (packageName) {
+          case hetznerInfraAdapterDescriptor.package:
+            return Promise.resolve({
+              infraAdapterDescriptor: hetznerInfraAdapterDescriptor,
+              createInfraAdapter: () =>
+                createHetznerInfraAdapter({
+                  api: fixture.hetzner,
+                  hostKeyProbe: fixture.hostKeyProbe,
+                }),
+            });
+          case k3sInfraAdapterDescriptor.package:
+            return Promise.resolve({
+              infraAdapterDescriptor: k3sInfraAdapterDescriptor,
+              createInfraAdapter: () => createK3sInfraAdapter({ controlPlane: fixture.k3s }),
+            });
+          case supabaseInfraAdapterDescriptor.package:
+            return Promise.resolve({
+              infraAdapterDescriptor: supabaseInfraAdapterDescriptor,
+              createInfraAdapter: () =>
+                createSupabaseInfraAdapter({ controlPlane: fixture.supabase }),
+            });
+          case r2InfraAdapterDescriptor.package:
+            return Promise.resolve({
+              infraAdapterDescriptor: r2InfraAdapterDescriptor,
+              createInfraAdapter: () => createR2InfraAdapter({ cloud: fixture.r2 }),
+            });
+          default:
+            return Promise.reject(new Error(`Unexpected adapter package: ${packageName}`));
+        }
+      },
+    },
+    credentials: {
+      resolveAsync: ({ name }) => Promise.resolve(resolveCredential(name)),
+    },
+    secrets: {
+      resolveAsync: () =>
+        Promise.resolve({
+          ok: false,
+          diagnostics: [
+            { severity: 'error', code: 'unexpected-secret', message: 'No secret is expected.' },
+          ],
+        }),
+    },
+  };
+}
+
+function resolveCredential(name: string): InfraResult<Readonly<Record<string, string>>> {
+  if (name === 'HCLOUD_TOKEN') return success({ token: 'phase10-hcloud-token' });
+  if (name === 'HETZNER_SSH') {
+    return success({
+      publicKey: 'ssh-ed25519 AAAA phase10',
+      privateKey: 'phase10-private-key',
+    });
+  }
+  if (name === 'SUPABASE_BOOTSTRAP') {
+    return success({
+      postgresPassword: 'phase10-postgres-password',
+      jwtSecret: 'phase10-jwt-secret-0123456789abcdef',
+      anonKey: 'phase10-anon-key',
+      serviceRoleKey: 'phase10-service-role-key',
+      realtimeSecretKeyBase:
+        'phase10-realtime-secret-key-base-0123456789abcdefghijklmnopqrstuvwxyz',
+      realtimeDatabaseEncryptionKey: '1234567890abcdef',
+      pgMetaCryptoKey: 'phase10-pg-meta-crypto-key-0123456789abcdef',
+    });
+  }
+  if (name === 'CLOUDFLARE_R2') return success({ apiToken: 'phase10-r2-api-token' });
+  return {
+    ok: false,
+    diagnostics: [
+      {
+        severity: 'error',
+        code: 'unexpected-credential',
+        message: `Unexpected credential reference: ${name}`,
+      },
+    ],
+  };
+}
+
+class FakeHetznerCloudApi implements HetznerCloudApi {
+  observation: HetznerCloudObservation = { resources: [] };
+
+  validateAsync(): Promise<InfraResult<null>> {
+    return Promise.resolve(success(null));
+  }
+
+  inspectAsync(): Promise<InfraResult<HetznerCloudObservation>> {
+    return Promise.resolve(success(this.observation));
+  }
+
+  reconcileAsync(
+    _token: string,
+    desired: HetznerDesiredCompute,
+  ): Promise<InfraResult<HetznerCloudObservation>> {
+    this.observation = {
+      resources: [desired.network, desired.firewall, desired.sshKey, desired.server].map(
+        (resource, index) => ({
+          resourceId: resource.owner.identity.resourceId as HetznerResourceId,
+          externalId: String(index + 1),
+          configurationHash: resource.configurationHash,
+          state: 'ready' as const,
+          ...(resource.owner.identity.resourceId === 'server'
+            ? { publicIpv4: '203.0.113.10', architecture: 'amd64' as const }
+            : {}),
+        }),
+      ),
+    };
+    return Promise.resolve(success(this.observation));
+  }
+
+  destroyAsync(
+    _token: string,
+    _identity: HetznerProjectIdentity,
+    resourceIds: readonly HetznerResourceId[],
+  ): Promise<InfraResult<HetznerCloudObservation>> {
+    this.observation = {
+      resources: this.observation.resources.filter(
+        ({ resourceId }) => !resourceIds.includes(resourceId),
+      ),
+    };
+    return Promise.resolve(success(this.observation));
+  }
+}
+
+class FakeHostKeyProbe implements HetznerHostKeyProbe {
+  fingerprintAsync(): Promise<InfraResult<string>> {
+    return Promise.resolve(success('SHA256:phase10-host'));
+  }
+}
+
+type KubernetesApi = NonNullable<K3sClusterObservation['api']>;
+type KubernetesOwnershipQuery = Parameters<KubernetesApi['listOwnedAsync']>[0];
+type KubernetesResource = Awaited<ReturnType<KubernetesApi['listOwnedAsync']>>[number];
+type KubernetesResourceReference = Parameters<KubernetesApi['deleteAsync']>[0];
+type KubernetesResourceObservation = Awaited<ReturnType<KubernetesApi['observeAsync']>>;
+
+class FakeK3sControlPlane implements K3sControlPlane {
+  readonly api = new FakeKubernetesApi();
+  lastAccess: readonly K3sNodeAccess[] = [];
+  lastSpec?: K3sClusterSpec;
+  state: K3sClusterObservation['state'] = 'absent';
+  nodes: K3sClusterObservation['nodes'] = [];
+
+  validateAsync(
+    _spec: K3sClusterSpec,
+    access: readonly K3sNodeAccess[],
+  ): Promise<InfraResult<null>> {
+    this.lastAccess = access;
+    return Promise.resolve(success(null));
+  }
+
+  inspectAsync(): Promise<InfraResult<K3sClusterObservation>> {
+    return Promise.resolve(success(this.observation()));
+  }
+
+  ensureAsync(
+    spec: K3sClusterSpec,
+    access: readonly K3sNodeAccess[],
+  ): Promise<InfraResult<K3sClusterObservation>> {
+    this.lastAccess = access;
+    this.lastSpec = spec;
+    this.state = 'ready';
+    this.nodes = spec.nodes.map(({ id }) => ({
+      id,
+      state: 'ready',
+      configurationMatches: true,
+    }));
+    return Promise.resolve(success(this.observation()));
+  }
+
+  waitUntilReadyAsync(): Promise<InfraResult<K3sClusterObservation>> {
+    return Promise.resolve(success(this.observation()));
+  }
+
+  loadImagesAsync(
+    _spec: K3sClusterSpec,
+    _access: readonly K3sNodeAccess[],
+    _images: readonly string[],
+  ): Promise<InfraResult<null>> {
+    return Promise.resolve(success(null));
+  }
+
+  suspendAsync(): Promise<InfraResult<null>> {
+    this.state = 'stopped';
+    this.nodes = this.nodes.map((node) => ({ ...node, state: 'stopped' }));
+    return Promise.resolve(success(null));
+  }
+
+  destroyAsync(): Promise<InfraResult<null>> {
+    this.state = 'absent';
+    this.nodes = [];
+    return Promise.resolve(success(null));
+  }
+
+  private observation(): K3sClusterObservation {
+    return {
+      state: this.state,
+      configurationMatches: true,
+      nodes: this.nodes,
+      ...(this.state === 'ready' ? { api: this.api } : {}),
+    };
+  }
+}
+
+class FakeKubernetesApi implements KubernetesApi {
+  readonly resources: KubernetesResource[] = [];
+
+  listOwnedAsync(query: KubernetesOwnershipQuery): Promise<readonly KubernetesResource[]> {
+    return Promise.resolve(
+      this.resources.filter(({ metadata }) => includesLabels(metadata.labels, query.labels)),
+    );
+  }
+
+  applyAsync(resource: KubernetesResource): Promise<void> {
+    const index = this.resources.findIndex((candidate) => sameResource(candidate, resource));
+    if (index === -1) this.resources.push(resource);
+    else this.resources.splice(index, 1, resource);
+    return Promise.resolve();
+  }
+
+  deleteAsync(reference: KubernetesResourceReference): Promise<void> {
+    const index = this.resources.findIndex((resource) => sameResource(resource, reference));
+    if (index >= 0) this.resources.splice(index, 1);
+    return Promise.resolve();
+  }
+
+  observeAsync(reference: KubernetesResourceReference): Promise<KubernetesResourceObservation> {
+    return Promise.resolve({
+      state: 'ready',
+      ...(reference.kind === 'Service' ? { publicOutputs: { endpoint: publicBaseUrl } } : {}),
+    });
+  }
+
+  waitUntilReadyAsync(): Promise<KubernetesResourceObservation> {
+    return Promise.resolve({ state: 'ready' });
+  }
+
+  serializedResources(): string {
+    return JSON.stringify(this.resources);
+  }
+}
+
+class FakeSupabaseControlPlane implements SupabaseControlPlane {
+  readonly created: string[] = [];
+
+  healthAsync(_request: SupabaseControlPlaneRequest): Promise<InfraResult<null>> {
+    return Promise.resolve(success(null));
+  }
+
+  listBucketsAsync(_request: SupabaseControlPlaneRequest): Promise<InfraResult<readonly string[]>> {
+    return Promise.resolve(success([]));
+  }
+
+  createBucketAsync(
+    request: SupabaseControlPlaneRequest & { readonly bucket: string },
+  ): Promise<InfraResult<null>> {
+    this.created.push(request.bucket);
+    return Promise.resolve(success(null));
+  }
+
+  deleteBucketAsync(
+    _request: SupabaseControlPlaneRequest & { readonly bucket: string },
+  ): Promise<InfraResult<null>> {
+    return Promise.resolve(success(null));
+  }
+}
+
+class FakeR2ControlPlane implements R2BucketControlPlane {
+  readonly created: string[] = [];
+  private readonly buckets = new Set<string>();
+
+  listBucketsAsync(): Promise<InfraResult<readonly R2BucketObservation[]>> {
+    return Promise.resolve(success([...this.buckets].map((name) => ({ name }))));
+  }
+
+  createBucketAsync(
+    request: R2CloudRequest & { readonly bucket: string },
+  ): Promise<InfraResult<R2BucketObservation>> {
+    this.created.push(request.bucket);
+    this.buckets.add(request.bucket);
+    return Promise.resolve(success({ name: request.bucket }));
+  }
+
+  deleteBucketAsync(
+    request: R2CloudRequest & { readonly bucket: string },
+  ): Promise<InfraResult<null>> {
+    this.buckets.delete(request.bucket);
+    return Promise.resolve(success(null));
+  }
+}
+
+function includesLabels(
+  actual: Readonly<Record<string, string>>,
+  expected: Readonly<Record<string, string>>,
+): boolean {
+  return Object.entries(expected).every(([expectedKey, expectedValue]) =>
+    Object.entries(actual).some(
+      ([actualKey, actualValue]) => actualKey === expectedKey && actualValue === expectedValue,
+    ),
+  );
+}
+
+function sameResource(
+  left: KubernetesResource,
+  right: KubernetesResource | KubernetesResourceReference,
+): boolean {
+  return (
+    left.apiVersion === right.apiVersion &&
+    left.kind === right.kind &&
+    left.metadata.name === ('metadata' in right ? right.metadata.name : right.name) &&
+    left.metadata.namespace === ('metadata' in right ? right.metadata.namespace : right.namespace)
+  );
+}
+
+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: [] };
+}

package/src/localK3sSupabase.test.ts

@@ -0,0 +1,448 @@
+import type {
+  InfraComputeTarget,
+  InfraLedger,
+  InfraManifest,
+  InfraResourceIdentity,
+  InfraResult,
+} from '@ankhorage/contracts/infra';
+import {
+  createInfraAdapter as createK3sInfraAdapter,
+  infraAdapterDescriptor as k3sInfraAdapterDescriptor,
+  type K3sClusterObservation,
+  type K3sClusterSpec,
+  type K3sControlPlane,
+  type K3sNodeAccess,
+} from '@ankhorage/k3s';
+import {
+  createInfraAdapter as createLocalInfraAdapter,
+  infraAdapterDescriptor as localInfraAdapterDescriptor,
+  type LocalHostObservation,
+  type LocalHostProbe,
+} from '@ankhorage/local';
+import {
+  createInfraAdapter as createSupabaseInfraAdapter,
+  infraAdapterDescriptor as supabaseInfraAdapterDescriptor,
+  type SupabaseControlPlane,
+  type SupabaseControlPlaneRequest,
+} from '@ankhorage/supabase';
+import { expect, test } from 'bun:test';
+
+import { destroyInfraEnvironmentAsync } from './features/environment-lifecycle/application/use-cases/destroyInfraEnvironmentAsync.js';
+import { downInfraEnvironmentAsync } from './features/environment-lifecycle/application/use-cases/downInfraEnvironmentAsync.js';
+import { getInfraEnvironmentOutputs } from './features/environment-lifecycle/application/use-cases/getInfraEnvironmentOutputs.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 = 'infra164-local-k3s-supabase';
+const publicBaseUrl = 'http://127.0.0.1:54321';
+const bucket = 'infra164-bucket';
+const target: Extract<InfraComputeTarget, { kind: 'local-host' }> = {
+  id: 'local',
+  kind: 'local-host',
+  os: 'linux',
+  architecture: 'amd64',
+};
+const manifest = {
+  environments: {
+    local: {
+      deployment: {
+        compute: { provider: 'local' },
+        runtime: { provider: 'k3s', topology: { servers: 1, agents: 0 } },
+      },
+      database: { provider: 'supabase', tier: 'dev' },
+      auth: { provider: 'supabase' },
+      objectStorage: { provider: 'supabase', buckets: [bucket] },
+      networking: { publicBaseUrl },
+    },
+  },
+  modules: [],
+} as const satisfies InfraManifest;
+
+test('runs local k3s and Supabase through the portable compute lifecycle', async () => {
+  const fixture = new LocalK3sFixture();
+  const dependencies = createDependencies(fixture);
+
+  const initialPlan = requireSuccess(
+    await planInfraEnvironmentAsync({ projectId, manifest }, dependencies),
+  );
+  expect(initialPlan.actions.some(({ operation }) => operation === 'create')).toBe(true);
+
+  const firstUp = requireSuccess(
+    await upInfraEnvironmentAsync({ projectId, manifest }, dependencies),
+  );
+  const firstLedger: InfraLedger = firstUp.ledger;
+  expect(firstUp.targets).toEqual([target]);
+  expect([...new Set(fixture.loadedPackages)].sort()).toEqual(
+    [
+      localInfraAdapterDescriptor.package,
+      k3sInfraAdapterDescriptor.package,
+      supabaseInfraAdapterDescriptor.package,
+    ].sort(),
+  );
+  expect(fixture.k3s.lastAccess).toHaveLength(1);
+  expect(fixture.k3s.lastAccess[0]?.transport).toEqual({ kind: 'local' });
+  expect(fixture.k3s.lastSpec?.nodes[0]?.target).toEqual(target);
+  expect(fixture.kubernetes.serializedResources()).toContain('PersistentVolumeClaim');
+  expect(fixture.kubernetes.serializedResources()).toContain('/etc/postgresql-custom');
+  expect(fixture.kubernetes.serializedResources()).toContain('.ankhorage-image-seeded');
+  expect(fixture.supabase.buckets.has(bucket)).toBe(true);
+  expect(JSON.stringify(firstUp)).not.toContain('infra164-service-role-key');
+  expect(JSON.stringify(firstUp)).not.toContain('infra164-postgres-password');
+
+  const outputs = requireSuccess(
+    getInfraEnvironmentOutputs({
+      projectId,
+      manifest,
+      environment: 'local',
+      previous: firstLedger,
+    }),
+  );
+  expect(outputs.outputs).toEqual(firstUp.outputs);
+  expect(
+    outputs.outputs.some(
+      ({ environmentVariable, value }) =>
+        environmentVariable === 'EXPO_PUBLIC_SUPABASE_URL' && value === publicBaseUrl,
+    ),
+  ).toBe(true);
+  expect(outputs.outputs.some(({ name, value }) => name === 'bucket' && value === bucket)).toBe(
+    true,
+  );
+
+  const status = requireSuccess(
+    await statusInfraEnvironmentAsync(
+      { projectId, manifest, environment: 'local', previous: firstLedger },
+      dependencies,
+    ),
+  );
+  expect(status.state).toBe('ready');
+
+  const converged = requireSuccess(
+    await planInfraEnvironmentAsync(
+      { projectId, manifest, environment: 'local', previous: firstLedger },
+      dependencies,
+    ),
+  );
+  expect(converged.actions.every(({ operation }) => operation === 'noop')).toBe(true);
+
+  const identitiesBeforeRestart = resourceIdentities(firstUp.resources);
+  const down = requireSuccess(
+    await downInfraEnvironmentAsync(
+      { projectId, manifest, environment: 'local', previous: firstLedger },
+      dependencies,
+    ),
+  );
+  expect(fixture.k3s.state).toBe('stopped');
+
+  const resumed = requireSuccess(
+    await upInfraEnvironmentAsync(
+      { projectId, manifest, environment: 'local', previous: down.ledger },
+      dependencies,
+    ),
+  );
+  expect(fixture.k3s.state).toBe('ready');
+  expect(resumed.targets).toEqual([target]);
+  expect(resourceIdentities(resumed.resources)).toEqual(identitiesBeforeRestart);
+
+  const destroyed = requireSuccess(
+    await destroyInfraEnvironmentAsync(
+      {
+        projectId,
+        manifest,
+        environment: 'local',
+        previous: resumed.ledger,
+        confirmation: { projectId, environment: 'local' },
+        persistence: {
+          policy: 'delete',
+          confirmedResources: persistentIdentities(resumed.ledger),
+        },
+      },
+      dependencies,
+    ),
+  );
+  expect(destroyed.ledger).toBeNull();
+  expect(fixture.k3s.state).toBe('absent');
+  expect(fixture.k3s.calls).toContain('destroy');
+});
+
+class LocalK3sFixture {
+  readonly local = new FakeLocalHostProbe();
+  readonly k3s = new FakeK3sControlPlane();
+  readonly kubernetes = this.k3s.api;
+  readonly supabase = new FakeSupabaseControlPlane();
+  readonly loadedPackages: string[] = [];
+}
+
+function createDependencies(fixture: LocalK3sFixture): InfraOrchestrationDependencies {
+  return {
+    adapterResolver: {
+      loadAsync: (packageName) => {
+        fixture.loadedPackages.push(packageName);
+        switch (packageName) {
+          case localInfraAdapterDescriptor.package:
+            return Promise.resolve({
+              infraAdapterDescriptor: localInfraAdapterDescriptor,
+              createInfraAdapter: () => createLocalInfraAdapter({ probe: fixture.local }),
+            });
+          case k3sInfraAdapterDescriptor.package:
+            return Promise.resolve({
+              infraAdapterDescriptor: k3sInfraAdapterDescriptor,
+              createInfraAdapter: () => createK3sInfraAdapter({ controlPlane: fixture.k3s }),
+            });
+          case supabaseInfraAdapterDescriptor.package:
+            return Promise.resolve({
+              infraAdapterDescriptor: supabaseInfraAdapterDescriptor,
+              createInfraAdapter: () =>
+                createSupabaseInfraAdapter({ controlPlane: fixture.supabase }),
+            });
+          default:
+            return Promise.reject(new Error(`Unexpected adapter package: ${packageName}`));
+        }
+      },
+    },
+    credentials: {
+      resolveAsync: ({ name }) => Promise.resolve(resolveCredential(name)),
+    },
+    secrets: {
+      resolveAsync: () =>
+        Promise.resolve({
+          ok: false,
+          diagnostics: [
+            { severity: 'error', code: 'unexpected-secret', message: 'No secret is expected.' },
+          ],
+        }),
+    },
+  };
+}
+
+function resolveCredential(name: string): InfraResult<Readonly<Record<string, string>>> {
+  if (name === 'SUPABASE_BOOTSTRAP') {
+    return success({
+      postgresPassword: 'infra164-postgres-password',
+      jwtSecret: 'infra164-jwt-secret-0123456789abcdef',
+      anonKey: 'infra164-anon-key',
+      serviceRoleKey: 'infra164-service-role-key',
+      realtimeSecretKeyBase:
+        'infra164-realtime-secret-key-base-0123456789abcdefghijklmnopqrstuvwxyz',
+      realtimeDatabaseEncryptionKey: '1234567890abcdef',
+      pgMetaCryptoKey: 'infra164-pg-meta-crypto-key-0123456789abcdef',
+    });
+  }
+  return {
+    ok: false,
+    diagnostics: [
+      {
+        severity: 'error',
+        code: 'unexpected-credential',
+        message: `Unexpected credential reference: ${name}`,
+      },
+    ],
+  };
+}
+
+class FakeLocalHostProbe implements LocalHostProbe {
+  inspectAsync(workingDirectory: string): Promise<InfraResult<LocalHostObservation>> {
+    return Promise.resolve(
+      success({
+        target,
+        workingDirectory,
+        exists: true,
+        readable: true,
+        writable: true,
+      }),
+    );
+  }
+}
+
+type KubernetesApi = NonNullable<K3sClusterObservation['api']>;
+type KubernetesOwnershipQuery = Parameters<KubernetesApi['listOwnedAsync']>[0];
+type KubernetesResource = Awaited<ReturnType<KubernetesApi['listOwnedAsync']>>[number];
+type KubernetesResourceReference = Parameters<KubernetesApi['deleteAsync']>[0];
+type KubernetesResourceObservation = Awaited<ReturnType<KubernetesApi['observeAsync']>>;
+
+class FakeK3sControlPlane implements K3sControlPlane {
+  readonly api = new FakeKubernetesApi();
+  readonly calls: string[] = [];
+  lastAccess: readonly K3sNodeAccess[] = [];
+  lastSpec?: K3sClusterSpec;
+  state: K3sClusterObservation['state'] = 'absent';
+  nodes: K3sClusterObservation['nodes'] = [];
+
+  validateAsync(
+    _spec: K3sClusterSpec,
+    access: readonly K3sNodeAccess[],
+  ): Promise<InfraResult<null>> {
+    this.calls.push('validate');
+    this.lastAccess = access;
+    return Promise.resolve(success(null));
+  }
+
+  inspectAsync(): Promise<InfraResult<K3sClusterObservation>> {
+    this.calls.push('inspect');
+    return Promise.resolve(success(this.observation()));
+  }
+
+  ensureAsync(
+    spec: K3sClusterSpec,
+    access: readonly K3sNodeAccess[],
+  ): Promise<InfraResult<K3sClusterObservation>> {
+    this.calls.push('ensure');
+    this.lastAccess = access;
+    this.lastSpec = spec;
+    this.state = 'ready';
+    this.nodes = spec.nodes.map(({ id }) => ({
+      id,
+      state: 'ready',
+      configurationMatches: true,
+    }));
+    return Promise.resolve(success(this.observation()));
+  }
+
+  waitUntilReadyAsync(): Promise<InfraResult<K3sClusterObservation>> {
+    this.calls.push('wait');
+    return Promise.resolve(success(this.observation()));
+  }
+
+  loadImagesAsync(
+    _spec: K3sClusterSpec,
+    _access: readonly K3sNodeAccess[],
+    images: readonly string[],
+  ): Promise<InfraResult<null>> {
+    this.calls.push(`images:${images.join(',')}`);
+    return Promise.resolve(success(null));
+  }
+
+  suspendAsync(): Promise<InfraResult<null>> {
+    this.calls.push('suspend');
+    this.state = 'stopped';
+    this.nodes = this.nodes.map((node) => ({ ...node, state: 'stopped' }));
+    return Promise.resolve(success(null));
+  }
+
+  destroyAsync(): Promise<InfraResult<null>> {
+    this.calls.push('destroy');
+    this.state = 'absent';
+    this.nodes = [];
+    return Promise.resolve(success(null));
+  }
+
+  private observation(): K3sClusterObservation {
+    return {
+      state: this.state,
+      configurationMatches: true,
+      nodes: this.nodes,
+      ...(this.state === 'ready' ? { api: this.api } : {}),
+    };
+  }
+}
+
+class FakeKubernetesApi implements KubernetesApi {
+  readonly resources: KubernetesResource[] = [];
+
+  listOwnedAsync(query: KubernetesOwnershipQuery): Promise<readonly KubernetesResource[]> {
+    return Promise.resolve(
+      this.resources.filter(({ metadata }) => includesLabels(metadata.labels, query.labels)),
+    );
+  }
+
+  applyAsync(resource: KubernetesResource): Promise<void> {
+    const index = this.resources.findIndex((candidate) => sameResource(candidate, resource));
+    if (index === -1) this.resources.push(resource);
+    else this.resources.splice(index, 1, resource);
+    return Promise.resolve();
+  }
+
+  deleteAsync(reference: KubernetesResourceReference): Promise<void> {
+    const index = this.resources.findIndex((resource) => sameResource(resource, reference));
+    if (index >= 0) this.resources.splice(index, 1);
+    return Promise.resolve();
+  }
+
+  observeAsync(reference: KubernetesResourceReference): Promise<KubernetesResourceObservation> {
+    return Promise.resolve({
+      state: 'ready',
+      ...(reference.kind === 'Service' ? { publicOutputs: { endpoint: publicBaseUrl } } : {}),
+    });
+  }
+
+  waitUntilReadyAsync(): Promise<KubernetesResourceObservation> {
+    return Promise.resolve({ state: 'ready' });
+  }
+
+  serializedResources(): string {
+    return JSON.stringify(this.resources);
+  }
+}
+
+class FakeSupabaseControlPlane implements SupabaseControlPlane {
+  readonly buckets = new Set<string>();
+
+  healthAsync(_request: SupabaseControlPlaneRequest): Promise<InfraResult<null>> {
+    return Promise.resolve(success(null));
+  }
+
+  listBucketsAsync(_request: SupabaseControlPlaneRequest): Promise<InfraResult<readonly string[]>> {
+    return Promise.resolve(success([...this.buckets]));
+  }
+
+  createBucketAsync(
+    request: SupabaseControlPlaneRequest & { readonly bucket: string },
+  ): Promise<InfraResult<null>> {
+    this.buckets.add(request.bucket);
+    return Promise.resolve(success(null));
+  }
+
+  deleteBucketAsync(
+    request: SupabaseControlPlaneRequest & { readonly bucket: string },
+  ): Promise<InfraResult<null>> {
+    this.buckets.delete(request.bucket);
+    return Promise.resolve(success(null));
+  }
+}
+
+function persistentIdentities(ledger: InfraLedger): readonly InfraResourceIdentity[] {
+  return ledger.resources.filter(({ persistent }) => persistent).map(({ identity }) => identity);
+}
+
+function resourceIdentities(
+  resources: readonly { readonly identity: InfraResourceIdentity }[],
+): readonly string[] {
+  return resources
+    .map(({ identity }) =>
+      [identity.projectId, identity.environment, identity.adapter, identity.resourceId].join(':'),
+    )
+    .sort();
+}
+
+function includesLabels(
+  actual: Readonly<Record<string, string>>,
+  expected: Readonly<Record<string, string>>,
+): boolean {
+  return Object.entries(expected).every(([expectedKey, expectedValue]) =>
+    Object.entries(actual).some(
+      ([actualKey, actualValue]) => actualKey === expectedKey && actualValue === expectedValue,
+    ),
+  );
+}
+
+function sameResource(
+  left: KubernetesResource,
+  right: KubernetesResource | KubernetesResourceReference,
+): boolean {
+  return (
+    left.apiVersion === right.apiVersion &&
+    left.kind === right.kind &&
+    left.metadata.name === ('metadata' in right ? right.metadata.name : right.name) &&
+    left.metadata.namespace === ('metadata' in right ? right.metadata.namespace : right.namespace)
+  );
+}
+
+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: [] };
+}

package/src/productionServerRuntimeEnvironment.integration.test.ts

@@ -0,0 +1,322 @@
+import type {
+  InfraComputeAdapter,
+  InfraComputeSnapshot,
+  InfraManifest,
+  InfraPlanAction,
+  InfraReconcileResult,
+  InfraResourceStatus,
+  InfraResult,
+} from '@ankhorage/contracts/infra';
+import { infraAdapterDescriptor as hetznerInfraAdapterDescriptor } from '@ankhorage/hetzner';
+import {
+  createInfraAdapter as createK3sInfraAdapter,
+  infraAdapterDescriptor as k3sInfraAdapterDescriptor,
+  type K3sClusterObservation,
+  type K3sClusterSpec,
+  type K3sControlPlane,
+  type K3sNodeAccess,
+} from '@ankhorage/k3s';
+import { expect, test } from 'bun:test';
+
+import { type InfraOrchestrationDependencies, upInfraEnvironmentAsync } from './index.js';
+
+const projectId = 'infra162-server-runtime-environment';
+const serverImage = 'example/server:production';
+
+const manifest = {
+  environments: {
+    local: {
+      deployment: {
+        compute: { provider: 'local' },
+        runtime: { provider: 'docker-compose' },
+      },
+    },
+    preview: {
+      deployment: {
+        compute: { provider: 'hetzner', location: 'fsn1' },
+        runtime: { provider: 'k3s', topology: { servers: 1, agents: 0 } },
+      },
+      workloads: [serverWorkload('development')],
+    },
+    production: {
+      deployment: {
+        compute: { provider: 'hetzner', location: 'fsn1' },
+        runtime: { provider: 'k3s', topology: { servers: 1, agents: 0 } },
+      },
+      workloads: [serverWorkload('production')],
+    },
+  },
+  modules: [],
+} as const satisfies InfraManifest;
+
+test('projects explicit production server environment through the generic k3s workload path', async () => {
+  const fixture = new ProductionServerFixture();
+  const dependencies = createDependencies(fixture);
+
+  const first = requireSuccess(
+    await upInfraEnvironmentAsync({ projectId, manifest, environment: 'production' }, dependencies),
+  );
+  const firstProjection = fixture.kubernetes.serializedResources();
+
+  expect(first.environment).toBe('production');
+  expect(firstProjection).toContain('"name":"NODE_ENV","value":"production"');
+  expect(fixture.k3s.loadedImages).toEqual([serverImage]);
+
+  requireSuccess(
+    await upInfraEnvironmentAsync(
+      {
+        projectId,
+        manifest,
+        environment: 'production',
+        previous: first.ledger,
+      },
+      dependencies,
+    ),
+  );
+
+  expect(fixture.kubernetes.serializedResources()).toBe(firstProjection);
+});
+
+test('preserves an explicitly non-production server environment without rewriting it', async () => {
+  const fixture = new ProductionServerFixture();
+
+  const result = requireSuccess(
+    await upInfraEnvironmentAsync(
+      { projectId, manifest, environment: 'preview' },
+      createDependencies(fixture),
+    ),
+  );
+  const projection = fixture.kubernetes.serializedResources();
+
+  expect(result.environment).toBe('preview');
+  expect(projection).toContain('"name":"NODE_ENV","value":"development"');
+  expect(projection).not.toContain('"name":"NODE_ENV","value":"production"');
+});
+
+function serverWorkload(nodeEnvironment: 'development' | 'production') {
+  return {
+    id: 'server',
+    artifact: { kind: 'image' as const, image: serverImage },
+    environment: {
+      NODE_ENV: { kind: 'literal' as const, value: nodeEnvironment },
+    },
+  };
+}
+
+class ProductionServerFixture {
+  readonly compute = new FakeHetznerComputeAdapter();
+  readonly k3s = new FakeK3sControlPlane();
+  readonly kubernetes = this.k3s.api;
+}
+
+function createDependencies(fixture: ProductionServerFixture): InfraOrchestrationDependencies {
+  return {
+    adapterResolver: {
+      loadAsync: (packageName) => {
+        switch (packageName) {
+          case hetznerInfraAdapterDescriptor.package:
+            return Promise.resolve({
+              infraAdapterDescriptor: hetznerInfraAdapterDescriptor,
+              createInfraAdapter: () => fixture.compute,
+            });
+          case k3sInfraAdapterDescriptor.package:
+            return Promise.resolve({
+              infraAdapterDescriptor: k3sInfraAdapterDescriptor,
+              createInfraAdapter: () => createK3sInfraAdapter({ controlPlane: fixture.k3s }),
+            });
+          default:
+            return Promise.reject(new Error(`Unexpected adapter package: ${packageName}`));
+        }
+      },
+    },
+    credentials: {
+      resolveAsync: () => Promise.resolve(success({ token: 'fixture-token' })),
+    },
+    secrets: {
+      resolveAsync: () =>
+        Promise.resolve({
+          ok: false,
+          diagnostics: [
+            { severity: 'error', code: 'unexpected-secret', message: 'No secret is expected.' },
+          ],
+        }),
+    },
+  };
+}
+
+class FakeHetznerComputeAdapter implements InfraComputeAdapter<'hetzner'> {
+  readonly descriptor = hetznerInfraAdapterDescriptor;
+  readonly snapshot: InfraComputeSnapshot = {
+    targets: [
+      {
+        id: 'server',
+        kind: 'ssh-host',
+        os: 'linux',
+        architecture: 'amd64',
+        host: '203.0.113.162',
+        port: 22,
+        user: 'root',
+        credential: { source: 'control-plane', name: 'SERVER_SSH' },
+        hostKeyFingerprint: 'SHA256:infra162-server',
+      },
+    ],
+    resources: [],
+    outputs: [],
+  };
+
+  validateAsync(): Promise<InfraResult<null>> {
+    return Promise.resolve(success(null));
+  }
+
+  inspectAsync(): Promise<InfraResult<InfraComputeSnapshot>> {
+    return Promise.resolve(success(this.snapshot));
+  }
+
+  planAsync(): Promise<InfraResult<readonly InfraPlanAction[]>> {
+    return Promise.resolve(success([]));
+  }
+
+  ensureAsync(): Promise<InfraResult<InfraComputeSnapshot>> {
+    return Promise.resolve(success(this.snapshot));
+  }
+
+  statusAsync(): Promise<InfraResult<readonly InfraResourceStatus[]>> {
+    return Promise.resolve(success([]));
+  }
+
+  destroyAsync(): Promise<InfraResult<InfraReconcileResult>> {
+    return Promise.resolve(success({ resources: [], outputs: [] }));
+  }
+}
+
+type KubernetesApi = NonNullable<K3sClusterObservation['api']>;
+type KubernetesOwnershipQuery = Parameters<KubernetesApi['listOwnedAsync']>[0];
+type KubernetesResource = Awaited<ReturnType<KubernetesApi['listOwnedAsync']>>[number];
+type KubernetesResourceReference = Parameters<KubernetesApi['deleteAsync']>[0];
+type KubernetesResourceObservation = Awaited<ReturnType<KubernetesApi['observeAsync']>>;
+
+class FakeK3sControlPlane implements K3sControlPlane {
+  readonly api = new FakeKubernetesApi();
+  loadedImages: readonly string[] = [];
+  state: K3sClusterObservation['state'] = 'absent';
+  nodes: K3sClusterObservation['nodes'] = [];
+
+  validateAsync(): Promise<InfraResult<null>> {
+    return Promise.resolve(success(null));
+  }
+
+  inspectAsync(): Promise<InfraResult<K3sClusterObservation>> {
+    return Promise.resolve(success(this.observation()));
+  }
+
+  ensureAsync(spec: K3sClusterSpec): Promise<InfraResult<K3sClusterObservation>> {
+    this.state = 'ready';
+    this.nodes = spec.nodes.map(({ id }) => ({
+      id,
+      state: 'ready',
+      configurationMatches: true,
+    }));
+    return Promise.resolve(success(this.observation()));
+  }
+
+  waitUntilReadyAsync(): Promise<InfraResult<K3sClusterObservation>> {
+    return Promise.resolve(success(this.observation()));
+  }
+
+  loadImagesAsync(
+    _spec: K3sClusterSpec,
+    _access: readonly K3sNodeAccess[],
+    images: readonly string[],
+  ): Promise<InfraResult<null>> {
+    this.loadedImages = [...images];
+    return Promise.resolve(success(null));
+  }
+
+  suspendAsync(): Promise<InfraResult<null>> {
+    this.state = 'stopped';
+    this.nodes = this.nodes.map((node) => ({ ...node, state: 'stopped' }));
+    return Promise.resolve(success(null));
+  }
+
+  destroyAsync(): Promise<InfraResult<null>> {
+    this.state = 'absent';
+    this.nodes = [];
+    return Promise.resolve(success(null));
+  }
+
+  private observation(): K3sClusterObservation {
+    return {
+      state: this.state,
+      configurationMatches: true,
+      nodes: this.nodes,
+      ...(this.state === 'ready' ? { api: this.api } : {}),
+    };
+  }
+}
+
+class FakeKubernetesApi implements KubernetesApi {
+  readonly resources: KubernetesResource[] = [];
+
+  listOwnedAsync(query: KubernetesOwnershipQuery): Promise<readonly KubernetesResource[]> {
+    return Promise.resolve(
+      this.resources.filter(({ metadata }) => includesLabels(metadata.labels, query.labels)),
+    );
+  }
+
+  applyAsync(resource: KubernetesResource): Promise<void> {
+    const index = this.resources.findIndex((candidate) => sameResource(candidate, resource));
+    if (index === -1) this.resources.push(resource);
+    else this.resources.splice(index, 1, resource);
+    return Promise.resolve();
+  }
+
+  deleteAsync(reference: KubernetesResourceReference): Promise<void> {
+    const index = this.resources.findIndex((resource) => sameResource(resource, reference));
+    if (index >= 0) this.resources.splice(index, 1);
+    return Promise.resolve();
+  }
+
+  observeAsync(): Promise<KubernetesResourceObservation> {
+    return Promise.resolve({ state: 'ready' });
+  }
+
+  waitUntilReadyAsync(): Promise<KubernetesResourceObservation> {
+    return Promise.resolve({ state: 'ready' });
+  }
+
+  serializedResources(): string {
+    return JSON.stringify(this.resources);
+  }
+}
+
+function includesLabels(
+  actual: Readonly<Record<string, string>>,
+  expected: Readonly<Record<string, string>>,
+): boolean {
+  return Object.entries(expected).every(([expectedKey, expectedValue]) =>
+    Object.entries(actual).some(
+      ([actualKey, actualValue]) => actualKey === expectedKey && actualValue === expectedValue,
+    ),
+  );
+}
+
+function sameResource(
+  left: KubernetesResource,
+  right: KubernetesResource | KubernetesResourceReference,
+): boolean {
+  return (
+    left.apiVersion === right.apiVersion &&
+    left.kind === right.kind &&
+    left.metadata.name === ('metadata' in right ? right.metadata.name : right.name) &&
+    left.metadata.namespace === ('metadata' in right ? right.metadata.namespace : right.namespace)
+  );
+}
+
+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: [] };
+}