test(integration,examples): migrate to M2.5 aggregate executeDbInit (M4)

executePerSpaceDbApply was retired in M2.5 in favour of the aggregate-pipeline CLI surface (executeDbInit / executeDbUpdate / executeDbVerify). Two e2e integration suites still imported the old symbol after the cascade rebase: extension-pgvector-scenario-a (test/integration) and multi-space.e2e (examples/multi-extension-monorepo).

Migrate both to executeDbInit:

* drop the per-space {extensionContractSpaces:[{id}], policy, action} options;

* pass the actual extension descriptors via extensionPacks; the loader resolves their declared spaces from the descriptor surface, so the test no longer enumerates space ids manually;

* add the required targetId option (M2.5 aggregate pipeline pins the target rather than inferring from the migrations registry);

* drop the now-unused INIT_ADDITIVE_POLICY import in pgvector (db init's policy is fixed by executeDbInit internally);

* refresh docblocks that named the old symbol.

Mirrors the same migration applied to packages/3-extensions/cipherstash/test/scenario-a.e2e.integration.test.ts on M3.

Author: wmadden

examples/multi-extension-monorepo/test/multi-space.e2e.integration.test.ts

@@ -2,7 +2,7 @@
  * Multi-extension monorepo end-to-end against PGlite — project:
  * extension-contract-spaces, M4 / T4.4 / TC-8 / spec AC4.
  *
- * Drives the CLI per-space `db init` flow (`executePerSpaceDbApply`)
+ * Drives the CLI aggregate `db init` flow (`executeDbInit`)
  * against a real Postgres (PGlite via `createDevDatabase`) with **two**
  * internal extension packages (`audit`, `feature-flags`) plus the
  * application's own contract. Mirrors the cipherstash + pgvector
@@ -22,7 +22,7 @@
  *      on-disk shape level.
  *
  *   2. **Multi-space planning across three spaces.** Calling
- *      `executePerSpaceDbApply` with `mode: 'plan'` produces a plan
+ *      `executeDbInit` with `mode: 'plan'` produces a plan
  *      whose ops are ordered alphabetically by space id (extensions
  *      first, app last) per `concatenateSpaceApplyInputs`. The audit
  *      `CREATE TABLE audit_event` op precedes the feature-flags
@@ -54,9 +54,9 @@ import { mkdir, mkdtemp, readFile, rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import postgresAdapterDescriptor from '@prisma-next/adapter-postgres/control';
-import { executePerSpaceDbApply } from '@prisma-next/cli/control-api';
+import { executeDbInit } from '@prisma-next/cli/control-api';
 import postgresDriverDescriptor from '@prisma-next/driver-postgres/control';
-import sqlFamilyDescriptor, { INIT_ADDITIVE_POLICY } from '@prisma-next/family-sql/control';
+import sqlFamilyDescriptor from '@prisma-next/family-sql/control';
 import { createControlStack } from '@prisma-next/framework-components/control';
 import { materialiseMigrationPackage } from '@prisma-next/migration-tools/io';
 import { emitContractSpaceArtefacts } from '@prisma-next/migration-tools/spaces';
@@ -223,17 +223,16 @@ describe.sequential(
     it('mode=plan produces a multi-space plan ordered alphabetically (extensions first, app last)', async () => {
       project = await setupTestProject();
 
-      const result = await executePerSpaceDbApply({
+      const result = await executeDbInit({
         driver: driver!,
         familyInstance: buildFamilyInstance('natural'),
         contract: appContract,
         mode: 'plan',
         migrations: postgresTargetDescriptor.migrations,
         frameworkComponents: [...frameworkComponents],
         migrationsDir: project.migrationsDir,
-        extensionContractSpaces: [{ id: AUDIT_SPACE_ID }, { id: FEATURE_FLAGS_SPACE_ID }],
-        policy: INIT_ADDITIVE_POLICY,
-        action: 'dbInit',
+        targetId: 'postgres',
+        extensionPacks: [auditExtensionDescriptor, featureFlagsExtensionDescriptor],
       });
 
       if (!result.ok) {
@@ -259,17 +258,16 @@ describe.sequential(
     it('mode=apply: three spaces apply atomically; markers + round-trips OK (TC-8 / AC5)', async () => {
       project = await setupTestProject();
 
-      const result = await executePerSpaceDbApply({
+      const result = await executeDbInit({
         driver: driver!,
         familyInstance: buildFamilyInstance('natural'),
         contract: appContract,
         mode: 'apply',
         migrations: postgresTargetDescriptor.migrations,
         frameworkComponents: [...frameworkComponents],
         migrationsDir: project.migrationsDir,
-        extensionContractSpaces: [{ id: AUDIT_SPACE_ID }, { id: FEATURE_FLAGS_SPACE_ID }],
-        policy: INIT_ADDITIVE_POLICY,
-        action: 'dbInit',
+        targetId: 'postgres',
+        extensionPacks: [auditExtensionDescriptor, featureFlagsExtensionDescriptor],
       });
 
       if (!result.ok) {
@@ -349,17 +347,16 @@ describe.sequential(
     it('marker hashes are independent of `extensionPacks` declaration order (NFR6)', async () => {
       project = await setupTestProject();
 
-      const result = await executePerSpaceDbApply({
+      const result = await executeDbInit({
         driver: driver!,
         familyInstance: buildFamilyInstance('reverse'),
         contract: appContract,
         mode: 'apply',
         migrations: postgresTargetDescriptor.migrations,
         frameworkComponents: [...frameworkComponents],
         migrationsDir: project.migrationsDir,
-        extensionContractSpaces: [{ id: FEATURE_FLAGS_SPACE_ID }, { id: AUDIT_SPACE_ID }],
-        policy: INIT_ADDITIVE_POLICY,
-        action: 'dbInit',
+        targetId: 'postgres',
+        extensionPacks: [featureFlagsExtensionDescriptor, auditExtensionDescriptor],
       });
 
       if (!result.ok) {

test/integration/test/extension-pgvector-scenario-a.e2e.integration.test.ts

@@ -22,7 +22,7 @@
  * inlined here with comments tying them to their source-of-truth
  * locations.
  *
- * Drives the CLI per-space `db init` flow (`executePerSpaceDbApply`,
+ * Drives the CLI aggregate `db init` flow (`executeDbInit`,
  * sub-spec § 6) against a real Postgres (PGlite via
  * `createDevDatabase`) with pgvector wired as an extension space and a
  * user `Doc` table that carries a `vector(N)` column. Three layers of
@@ -34,7 +34,7 @@
  *      `installVectorExtension.execute[0].sql` and is serialised
  *      byte-for-byte.
  *
- *   2. **Multi-space planning (real DDL).** `executePerSpaceDbApply`
+ *   2. **Multi-space planning (real DDL).** `executeDbInit`
  *      with `mode: 'plan'` against the real descriptor produces a plan
  *      that includes the pgvector baseline op AND the app-space
  *      `CREATE TABLE Doc` op, ordered first per
@@ -52,12 +52,11 @@ import { mkdir, mkdtemp, readFile, rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import postgresAdapterDescriptor from '@prisma-next/adapter-postgres/control';
-import { executePerSpaceDbApply } from '@prisma-next/cli/control-api';
+import { executeDbInit } from '@prisma-next/cli/control-api';
 import { type Contract, coreHash, profileHash } from '@prisma-next/contract/types';
 import postgresDriverDescriptor from '@prisma-next/driver-postgres/control';
 import pgvectorExtensionDescriptor from '@prisma-next/extension-pgvector/control';
 import sqlFamilyDescriptor, {
-  INIT_ADDITIVE_POLICY,
   type SqlMigrationPlanOperation,
 } from '@prisma-next/family-sql/control';
 import {
@@ -322,17 +321,16 @@ describe.sequential(
     it('mode=plan against the real install op produces a multi-space plan', async () => {
       project = await setupTestProject({ migration: pgvectorBaselineMigration });
 
-      const result = await executePerSpaceDbApply({
+      const result = await executeDbInit({
         driver: driver!,
         familyInstance,
         contract: buildAppContract({ withLength: true }),
         mode: 'plan',
         migrations: postgresTargetDescriptor.migrations,
         frameworkComponents: [...frameworkComponents],
         migrationsDir: project.migrationsDir,
-        extensionContractSpaces: [{ id: PGVECTOR_SPACE_ID }],
-        policy: INIT_ADDITIVE_POLICY,
-        action: 'dbInit',
+        targetId: 'postgres',
+        extensionPacks: [pgvectorExtensionDescriptor],
       });
 
       if (!result.ok) {
@@ -356,17 +354,16 @@ describe.sequential(
     it('synthetic vector stub: applies pgvector + app-space atomically; markers + round-trip OK', async () => {
       project = await setupTestProject({ migration: buildSyntheticBaselineMigration() });
 
-      const result = await executePerSpaceDbApply({
+      const result = await executeDbInit({
         driver: driver!,
         familyInstance,
         contract: buildAppContract({ withLength: false }),
         mode: 'apply',
         migrations: postgresTargetDescriptor.migrations,
         frameworkComponents: [...frameworkComponents],
         migrationsDir: project.migrationsDir,
-        extensionContractSpaces: [{ id: PGVECTOR_SPACE_ID }],
-        policy: INIT_ADDITIVE_POLICY,
-        action: 'dbInit',
+        targetId: 'postgres',
+        extensionPacks: [pgvectorExtensionDescriptor],
       });
 
       if (!result.ok) {