@empire-builder-kit/nx 1.0.0-rc.38 → 1.0.0-rc.39

package/src/generators/slice/built-in-plan.js

@@ -4,6 +4,11 @@ exports.STANDARD_LOCAL_DEV_ADAPTER = exports.PRODUCT_PACKAGE_MANAGED_JSON_POINTE
 exports.isBuiltInSliceFormatSensitivePath = isBuiltInSliceFormatSensitivePath;
 exports.createBuiltInSlicePlan = createBuiltInSlicePlan;
 const deterministic_order_js_1 = require("../../deterministic-order.js");
+const capability_plan_js_1 = require("../../foundation/capability-plan.js");
+const persistence_contract_js_1 = require("./persistence-contract.js");
+const built_in_plan_key_value_files_js_1 = require("./built-in-plan-key-value-files.js");
+const built_in_plan_key_value_infrastructure_js_1 = require("./built-in-plan-key-value-infrastructure.js");
+const built_in_plan_sql_events_js_1 = require("./built-in-plan-sql-events.js");
 const index_js_1 = require("../../ownership/index.js");
 const built_in_plan_api_contract_files_js_1 = require("./built-in-plan-api-contract-files.js");
 const built_in_plan_api_files_js_1 = require("./built-in-plan-api-files.js");
@@ -61,7 +66,7 @@ function composeDisjointFileGroups(groups) {
     }
     return files;
 }
-function renderSliceFiles(name, scope, runtimeVersion, ownership, dataPolicyReviewedAt, deploymentProfile) {
+function renderSliceFiles(name, scope, runtimeVersion, ownership, dataPolicyReviewedAt, deploymentProfile, persistence) {
     const pascalName = name
         .split('-')
         .map((segment) => segment[0]?.toUpperCase() + segment.slice(1))
@@ -69,33 +74,47 @@ function renderSliceFiles(name, scope, runtimeVersion, ownership, dataPolicyRevi
     const protectedRuntimeStages = deploymentProfile === 'starter'
         ? ['development', 'production']
         : ['staging', 'production'];
+    const sql = ownership.foundation.capabilities.includes('postgres');
     return composeDisjointFileGroups([
-        ['background work', (0, built_in_plan_background_work_files_js_1.renderBackgroundWorkFiles)(deploymentProfile)],
+        [
+            'persistence declaration',
+            { 'data/persistence.json': JSON.stringify(persistence, null, 2) + '\n' },
+        ],
+        ['key-value runtime', (0, built_in_plan_key_value_files_js_1.renderKeyValueRuntimeFiles)(name)],
+        [
+            'key-value infrastructure',
+            (0, built_in_plan_key_value_infrastructure_js_1.renderKeyValueInfrastructureFiles)(name, pascalName),
+        ],
+        ['background work', (0, built_in_plan_background_work_files_js_1.renderBackgroundWorkFiles)(deploymentProfile, sql)],
+        ['SQL events', sql ? (0, built_in_plan_sql_events_js_1.renderSqlEventFiles)(name) : {}],
         [
             'Slice metadata',
-            (0, built_in_plan_metadata_files_js_1.renderSliceMetadataFiles)(name, scope, pascalName, ownership),
+            (0, built_in_plan_metadata_files_js_1.renderSliceMetadataFiles)(name, scope, pascalName, ownership, sql),
+        ],
+        [
+            'Foundation wiring',
+            (0, built_in_plan_foundation_files_js_1.renderSliceFoundationFiles)(name, pascalName, ownership.foundation.capabilities),
         ],
-        ['Foundation wiring', (0, built_in_plan_foundation_files_js_1.renderSliceFoundationFiles)(name, pascalName)],
         [
             'project configuration',
             (0, built_in_plan_project_files_js_1.renderSliceProjectFiles)(name, scope, runtimeVersion, ownership),
         ],
         [
             'operations',
-            (0, built_in_plan_operations_files_js_1.renderSliceOperationsFiles)(name, scope.slice(1), runtimeVersion),
+            (0, built_in_plan_operations_files_js_1.renderSliceOperationsFiles)(name, scope.slice(1), runtimeVersion, sql),
         ],
-        ['database lifecycle', (0, built_in_plan_database_lifecycle_files_js_1.renderDatabaseLifecycleFiles)(name)],
+        ['database lifecycle', sql ? (0, built_in_plan_database_lifecycle_files_js_1.renderDatabaseLifecycleFiles)(name) : {}],
         [
             'database retirement rehearsal',
-            (0, built_in_plan_database_retirement_rehearsal_files_js_1.renderDatabaseRetirementRehearsalFiles)(name),
+            sql ? (0, built_in_plan_database_retirement_rehearsal_files_js_1.renderDatabaseRetirementRehearsalFiles)(name) : {},
         ],
         [
             'native runtime authority',
-            (0, built_in_plan_native_runtime_authority_files_js_1.renderStandardSliceNativeRuntimeAuthorityFiles)(name, scope.slice(1)),
+            (0, built_in_plan_native_runtime_authority_files_js_1.renderStandardSliceNativeRuntimeAuthorityFiles)(name, scope.slice(1), sql),
         ],
         [
             'data contracts',
-            (0, built_in_plan_data_files_js_1.renderProductDataFiles)(name, pascalName, protectedRuntimeStages),
+            (0, built_in_plan_data_files_js_1.renderProductDataFiles)(name, pascalName, protectedRuntimeStages, sql),
         ],
         [
             'data deletion',
@@ -127,14 +146,14 @@ function renderSliceFiles(name, scope, runtimeVersion, ownership, dataPolicyRevi
             'authorization infrastructure',
             (0, built_in_plan_authorization_infrastructure_files_js_1.renderStandardSliceAuthorizationInfrastructureFiles)(name, pascalName),
         ],
-        ['API', (0, built_in_plan_api_files_js_1.renderProductApiFiles)(name, pascalName, scope.slice(1))],
+        ['API', (0, built_in_plan_api_files_js_1.renderProductApiFiles)(name, pascalName, scope.slice(1), sql)],
         [
             'reliability and incident response',
             (0, built_in_plan_reliability_files_js_1.renderProductReliabilityFiles)(name, pascalName, dataPolicyReviewedAt),
         ],
         [
             'product infrastructure',
-            (0, built_in_plan_infrastructure_files_js_1.renderProductInfrastructureFiles)(name, pascalName, scope.slice(1), protectedRuntimeStages),
+            (0, built_in_plan_infrastructure_files_js_1.renderProductInfrastructureFiles)(name, pascalName, scope.slice(1), protectedRuntimeStages, sql, ownership.foundation.capabilities.includes('network')),
         ],
         [
             'performance, capacity, and cost',
@@ -142,18 +161,18 @@ function renderSliceFiles(name, scope, runtimeVersion, ownership, dataPolicyRevi
         ],
         [
             'release and configuration',
-            (0, built_in_plan_thin_release_files_js_1.renderProductThinReleaseFiles)(name, dataPolicyReviewedAt, deploymentProfile),
+            (0, built_in_plan_thin_release_files_js_1.renderProductThinReleaseFiles)(name, dataPolicyReviewedAt, deploymentProfile, sql),
         ],
         [
             'frontend contract and evidence',
             (0, built_in_plan_frontend_files_js_1.renderProductFrontendFiles)(name, pascalName),
         ],
-        ['web', (0, built_in_plan_web_files_js_1.renderProductWebFiles)(name, pascalName, scope.slice(1))],
-        ['testing', (0, built_in_plan_testing_files_js_1.renderProductTestingFiles)(name, pascalName)],
+        ['web', (0, built_in_plan_web_files_js_1.renderProductWebFiles)(name, pascalName, scope.slice(1), sql)],
+        ['testing', (0, built_in_plan_testing_files_js_1.renderProductTestingFiles)(name, pascalName, sql)],
         ['verification', (0, built_in_plan_verification_files_js_1.renderProductVerificationFiles)(name, pascalName)],
     ]);
 }
-function classifyPaths(files) {
+function classifyPaths(files, sql) {
     const seededPaths = new Set([
         'operations/background-work.json',
         'README.md',
@@ -175,6 +194,7 @@ function classifyPaths(files) {
         'data/record-correction.ts',
         'data/record-export.ts',
         'data/record-holds.ts',
+        'data/records.ts',
         'data/restore-adapter.ts',
         'docs/reliability/exclusions.md',
         'docs/reliability/slo.json',
@@ -221,11 +241,15 @@ function classifyPaths(files) {
         'authorization/machine-authorization-proof.ts',
         'authorization/machine-client-provisioner.py',
         'authorization/runtime.ts',
+        'authorization/record-store.ts',
+        'authorization/groups.mjs',
+        'authorization/groups.d.mts',
         'data/runtime-policy.cts',
         'jobs/data-export-cleanup.ts',
         'jobs/data-retention-maintenance-launcher.ts',
         'testing/quarantine-runtime.mjs',
         'testing/strict-json-reporter.mjs',
+        'testing/local-key-value.ts',
         'e2e/frontend-accessibility.spec.ts',
     ]);
     for (const path of built_in_plan_performance_files_js_1.PRODUCT_PERFORMANCE_SEEDED_PATHS)
@@ -240,7 +264,7 @@ function classifyPaths(files) {
             ? 'seeded'
             : 'managed';
         const managedJsonPointers = path === 'package.json'
-            ? [...built_in_plan_shared_js_1.PRODUCT_PACKAGE_MANAGED_JSON_POINTERS]
+            ? (0, built_in_plan_shared_js_1.standardPackageManagedJsonPointers)(sql)
             : undefined;
         if (managedJsonPointers) {
             (0, index_js_1.assertManagedJsonPointersExist)(contents, managedJsonPointers, `Built-in Standard Blueprint ${path}`);
@@ -255,7 +279,11 @@ function classifyPaths(files) {
     })
         .sort((left, right) => (0, deterministic_order_js_1.compareUtf16)(left.path, right.path));
 }
-function createBuiltInSlicePlan(name, scope, runtimeVersion, manifest, inputs, dataPolicyReviewedAt = '2026-07-27T00:00:00.000Z', deploymentProfile = 'starter') {
+function createBuiltInSlicePlan(name, scope, runtimeVersion, manifest, inputs, dataPolicyReviewedAt = '2026-07-27T00:00:00.000Z', deploymentProfile = 'starter', persistenceSource = {}) {
+    const persistence = (0, persistence_contract_js_1.standardPersistenceContract)({
+        inputs,
+        ...persistenceSource,
+    });
     const provisionalOwnership = {
         blueprint: { name: manifest.name, version: manifest.version },
         compositions: [],
@@ -266,7 +294,7 @@ function createBuiltInSlicePlan(name, scope, runtimeVersion, manifest, inputs, d
                 `${scope}/${name}/contracts`,
             ],
         },
-        foundation: manifest.foundation,
+        foundation: (0, capability_plan_js_1.standardPersistenceRequirement)(inputs, persistenceSource.compositions),
         inputs,
         paths: [],
         projects: [name, `@${name}/job-data-retention`],
@@ -274,13 +302,13 @@ function createBuiltInSlicePlan(name, scope, runtimeVersion, manifest, inputs, d
         slice: name,
         verification: manifest.verification,
     };
-    const provisionalFiles = renderSliceFiles(name, scope, runtimeVersion, provisionalOwnership, dataPolicyReviewedAt, deploymentProfile);
+    const provisionalFiles = renderSliceFiles(name, scope, runtimeVersion, provisionalOwnership, dataPolicyReviewedAt, deploymentProfile, persistence);
     const ownership = {
         ...provisionalOwnership,
-        paths: classifyPaths(provisionalFiles),
+        paths: classifyPaths(provisionalFiles, provisionalOwnership.foundation.capabilities.includes('postgres')),
     };
     return {
-        files: renderSliceFiles(name, scope, runtimeVersion, ownership, dataPolicyReviewedAt, deploymentProfile),
+        files: renderSliceFiles(name, scope, runtimeVersion, ownership, dataPolicyReviewedAt, deploymentProfile, persistence),
         ownership,
     };
 }

package/src/generators/slice/data-policy-review-seed.d.ts

@@ -0,0 +1,2 @@
+import type { Tree } from '@nx/devkit';
+export declare function dataPolicyReviewSeed(tree: Tree, root: string): string;

package/src/generators/slice/data-policy-review-seed.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataPolicyReviewSeed = dataPolicyReviewSeed;
+const node_path_1 = require("node:path");
+function dataPolicyReviewSeed(tree, root) {
+    const path = node_path_1.posix.join(root, 'data/policy.json');
+    const existing = tree.read(path, 'utf8');
+    if (existing !== null) {
+        try {
+            const reviewedAt = JSON.parse(existing).governance?.reviewedAt;
+            if (typeof reviewedAt === 'string' &&
+                new Date(reviewedAt).toISOString() === reviewedAt) {
+                return reviewedAt;
+            }
+        }
+        catch {
+            // The generated ownership/reconciliation path reports malformed policy.
+        }
+    }
+    return new Date().toISOString();
+}
+//# sourceMappingURL=data-policy-review-seed.js.map

package/src/generators/slice/deployed-smoke-readiness.d.ts

@@ -0,0 +1,2 @@
+/** Managed post-deployment prerequisite, not a replacement for browser proof. */
+export declare const deployedSmokeReadinessScript: string;

package/src/generators/slice/deployed-smoke-readiness.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deployedSmokeReadinessScript = void 0;
+/** Managed post-deployment prerequisite, not a replacement for browser proof. */
+exports.deployedSmokeReadinessScript = String.raw `import { performance } from 'node:perf_hooks';
+import { setTimeout as delay } from 'node:timers/promises';
+
+const totalLimitMs = 30_000;
+// Only a CloudFront-generated Router fallthrough extends readiness. The pinned
+// SST Router reads routing from an eventually consistent CloudFront
+// KeyValueStore; until a new Slice's route is visible at the serving edge the
+// request reaches the placeholder origin. Every other failure keeps the
+// thirty-second bound above.
+const edgeRouteLimitMs = 300_000;
+const requestLimitMs = 5_000;
+const retryDelayMs = 2_000;
+// Edge hosts within one POP converge on new routing at different times. Admit
+// browser setup only after consecutive healthy rounds, each on a fresh
+// connection, span a sustained window; any fallthrough restarts the window.
+const confirmationWindowMs = 30_000;
+const confirmationDelayMs = 1_000;
+const confirmationLimitMs = confirmationWindowMs + 10_000;
+// Every round sleeps at least the shorter delay, so this cap is reached only
+// by a stalled fixture or clock, never before the time bounds below.
+const roundLimit = Math.ceil((edgeRouteLimitMs + confirmationLimitMs) / Math.min(retryDelayMs, confirmationDelayMs)) + 1;
+const bodyLimitBytes = 4_096;
+const transientStatuses = new Set([502, 503, 504]);
+const transientNetworkCodes = new Set([
+  'EAI_AGAIN', 'ECONNREFUSED', 'ECONNRESET', 'ETIMEDOUT',
+  'UND_ERR_CONNECT_TIMEOUT', 'UND_ERR_SOCKET',
+]);
+
+function endpoint(value, path) {
+  const url = new URL(value);
+  if (url.protocol !== 'https:' || url.username || url.password || url.search || url.hash || url.pathname.replace(/\/$/, '') !== path) {
+    throw new Error('invalid-output');
+  }
+  return url;
+}
+
+function responseCorrelation(response) {
+  const requestId = response.headers.get('x-amz-cf-id');
+  const pop = response.headers.get('x-amz-cf-pop');
+  const cache = /^(Hit|Miss|RefreshHit|Error) from cloudfront$/i.exec(response.headers.get('x-cache') ?? '');
+  return {
+    ...(typeof requestId === 'string' && /^[A-Za-z0-9_+=/-]{20,128}$/.test(requestId) ? { cloudfrontRequestId: requestId } : {}),
+    ...(typeof pop === 'string' && /^[A-Z]{3}[0-9]{1,3}-[A-Z][0-9]{1,3}$/.test(pop) ? { cloudfrontPop: pop } : {}),
+    ...(cache ? { cloudfrontCache: cache[1].toLowerCase() } : {}),
+  };
+}
+
+async function boundedBytes(response) {
+  const reader = response.body?.getReader();
+  if (!reader) throw new Error('invalid-health');
+  const chunks = [];
+  let length = 0;
+  try {
+    for (;;) {
+      const chunk = await reader.read();
+      if (chunk.done) break;
+      length += chunk.value.byteLength;
+      if (length > bodyLimitBytes) throw new Error('invalid-health');
+      chunks.push(chunk.value);
+    }
+    const bytes = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) { bytes.set(chunk, offset); offset += chunk.byteLength; }
+    return bytes;
+  } finally {
+    await reader.cancel().catch(() => {});
+    reader.releaseLock();
+  }
+}
+
+async function boundedJson(response) {
+  return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(await boundedBytes(response)));
+}
+
+// The Router answers a request it could not route with CloudFront's own error
+// page. Only that page is classified; origin-returned gateway errors are not.
+async function edgeRouteUnavailable(response) {
+  if (!/^Error from cloudfront$/i.test(response.headers.get('x-cache') ?? '')) return undefined;
+  if (!/^text\/html\b/i.test(response.headers.get('content-type') ?? '')) return undefined;
+  let page;
+  try { page = new TextDecoder('latin1').decode(await boundedBytes(response)); }
+  catch { return undefined; }
+  if (!/<title>\s*ERROR: The request could not be satisfied\s*<\/title>/i.test(page)) return undefined;
+  return { edgeRouting: 'unavailable', originDnsPage: /resolve the origin domain name/i.test(page) };
+}
+
+// Dependency injection is internal fixture support; the generated runner has
+// no environment/CLI override for endpoints, TLS, policy or timing.
+export async function waitForDeployedSmokeReadiness(input, runtime = {}) {
+  const request = runtime.fetch ?? globalThis.fetch;
+  const now = runtime.now ?? (() => performance.now());
+  const sleep = runtime.sleep ?? ((ms, signal) => delay(ms, undefined, { signal }));
+  const started = now();
+  const standardDeadline = started + totalLimitMs;
+  const edgeDeadline = started + edgeRouteLimitMs;
+  const observations = [];
+  let edgePending = false;
+  let edgeObservations = 0;
+  let consecutive = 0;
+  let confirmationDeadline = 0;
+  let firstReadyAt = 0;
+  let firstReadyMs;
+  const elapsed = () => Math.max(0, Math.round(now() - started));
+  const deadline = () => Math.max(
+    edgePending ? edgeDeadline : standardDeadline,
+    consecutive > 0 ? confirmationDeadline : 0,
+  );
+  const failed = (classification, summary) => ({
+    outcome: 'failed', classification, summary, elapsedMs: elapsed(), observations,
+  });
+  let targets;
+  try {
+    if (!/^[a-z][a-z0-9-]*$/.test(input.service) || !/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/.test(input.sourceCommit) || !['development', 'staging', 'production'].includes(input.stage)) throw new Error('invalid-identity');
+    const api = endpoint(input.apiUrl, '');
+    const web = endpoint(input.webUrl, '/' + input.service);
+    targets = [
+      { name: 'api', url: new URL('/health', api).href, service: input.service },
+      { name: 'web', url: new URL('/' + input.service + '/api/health', web.origin).href, service: input.service + '-web' },
+    ];
+  } catch {
+    return failed('environment-drift', 'Deployed readiness requires exact credential-free HTTPS outputs and service/stage/build identity.');
+  }
+  // The round cap also bounds receipts if a fixture or monotonic clock stalls.
+  for (let round = 0; round < roundLimit && now() < deadline(); round += 1) {
+    if (input.signal?.aborted) return failed('infrastructure-unavailable', 'Deployed readiness was interrupted before smoke setup.');
+    let ready = true;
+    for (const target of targets) {
+      if (input.signal?.aborted) return failed('infrastructure-unavailable', 'Deployed readiness was interrupted before smoke setup.');
+      const remaining = deadline() - now();
+      if (remaining <= 0) { ready = false; break; }
+      const timeout = AbortSignal.timeout(Math.max(1, Math.min(requestLimitMs, Math.ceil(remaining))));
+      const signal = input.signal ? AbortSignal.any([input.signal, timeout]) : timeout;
+      const startedAt = new Date().toISOString();
+      const requestStarted = now();
+      const timing = () => ({ startedAt, durationMs: Math.max(0, Math.round(now() - requestStarted)), elapsedMs: elapsed() });
+      let response;
+      let observation;
+      try {
+        // A fresh connection per request samples more than one edge host.
+        response = await request(target.url, {
+          method: 'GET', redirect: 'manual', credentials: 'omit', cache: 'no-store',
+          headers: { accept: 'application/json', connection: 'close' }, signal,
+        });
+        observation = { endpoint: target.name, status: response.status, ...timing(), ...responseCorrelation(response) };
+        observations.push(observation);
+        if (response.status !== 200) {
+          if (!transientStatuses.has(response.status)) {
+            await response.body?.cancel();
+            return failed('infrastructure-unavailable', 'Deployed ' + target.name + ' readiness refused HTTP ' + response.status + '; verify the native deployment and exact output before retrying.');
+          }
+          const edge = target.name === 'web' && response.status === 502 ? await edgeRouteUnavailable(response) : undefined;
+          if (edge) { Object.assign(observation, edge); edgeObservations += 1; }
+          else await response.body?.cancel().catch(() => {});
+          edgePending = Boolean(edge);
+          consecutive = 0;
+          ready = false;
+          break;
+        }
+        let payload;
+        try { payload = await boundedJson(response); }
+        catch (error) { if (signal.aborted) throw error; return failed('environment-drift', 'Deployed ' + target.name + ' health is malformed or exceeds its bounded contract.'); }
+        const health = target.name === 'api' ? payload?.data : payload;
+        if (!health || health.service !== target.service || health.stage !== input.stage || health.sourceCommit !== input.sourceCommit || health.status !== 'ok') {
+          return failed('environment-drift', 'Deployed ' + target.name + ' health differs from the expected service/stage/build; reconcile source and deployed outputs.');
+        }
+      } catch (error) {
+        if (input.signal?.aborted) return failed('infrastructure-unavailable', 'Deployed readiness was interrupted before smoke setup.');
+        const transient = signal.aborted || transientNetworkCodes.has(error?.cause?.code ?? error?.code);
+        // One row per request: a body failure after headers annotates that row.
+        if (observation) observation.body = signal.aborted ? 'timeout' : 'network-error';
+        else observations.push({ endpoint: target.name, status: signal.aborted ? 'timeout' : 'network-error', ...timing() });
+        if (!transient) return failed('infrastructure-unavailable', 'Deployed readiness transport failed; verify endpoint and certificate configuration before retrying.');
+        edgePending = false;
+        consecutive = 0;
+        ready = false;
+        break;
+      }
+    }
+    if (input.signal?.aborted) return failed('infrastructure-unavailable', 'Deployed readiness was interrupted before smoke setup.');
+    if (ready && now() < deadline()) {
+      edgePending = false;
+      consecutive += 1;
+      if (consecutive === 1) {
+        firstReadyAt = now();
+        firstReadyMs = elapsed();
+        confirmationDeadline = firstReadyAt + confirmationLimitMs;
+      }
+      if (consecutive > 1 && now() - firstReadyAt >= confirmationWindowMs) {
+        return {
+          outcome: 'ready', elapsedMs: elapsed(), observations,
+          confirmation: { windowMs: confirmationWindowMs, rounds: consecutive, firstReadyMs },
+          edgeRouting: { unavailableObservations: edgeObservations, limitMs: edgeRouteLimitMs },
+        };
+      }
+    }
+    const remaining = deadline() - now();
+    if (remaining <= 0) break;
+    try { await sleep(Math.min(consecutive > 0 ? confirmationDelayMs : retryDelayMs, remaining), input.signal); }
+    catch { return failed('infrastructure-unavailable', 'Deployed readiness was interrupted before smoke setup.'); }
+  }
+  if (now() < deadline()) {
+    return failed('infrastructure-unavailable', 'Deployed readiness reached its bounded attempt count before its time bound; inspect the readiness clock and native diagnostics before another governed attempt.');
+  }
+  if (edgePending) {
+    return failed('infrastructure-unavailable', 'The deployed web route was not served by the Router within 300 seconds: CloudFront answered with its own error page because routing fell through to the placeholder origin. Inspect Router KeyValueStore propagation before another governed attempt.');
+  }
+  return failed('infrastructure-unavailable', 'The expected deployed API and web build did not become ready within the 30-second bound for unavailability other than Router edge propagation; inspect native diagnostics before another governed attempt.');
+}
+`;
+//# sourceMappingURL=deployed-smoke-readiness.js.map

package/src/generators/slice/local-source-identity.d.ts

@@ -0,0 +1,2 @@
+/** Local checks may run before the first commit; deployment evidence may not. */
+export declare const localSourceCommitFunction = "function localSourceCommit() {\n  const supplied = process.env.EBK_SOURCE_COMMIT;\n  if (supplied !== undefined) {\n    if (!/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/.test(supplied)) {\n      throw new Error('EBK_SOURCE_COMMIT must be a full commit SHA.');\n    }\n    return supplied;\n  }\n  const git = (args) => spawnSync('git', args, {\n    cwd: workspaceRoot,\n    encoding: 'utf8',\n    shell: false,\n    windowsHide: true,\n  });\n  const head = git(['rev-parse', '--verify', 'HEAD^{commit}']);\n  if (!head.error && head.status === 0) return head.stdout.trim();\n  const worktree = git(['rev-parse', '--is-inside-work-tree']);\n  const symbolic = git(['symbolic-ref', '--quiet', 'HEAD']);\n  if (!worktree.error && worktree.status === 0 &&\n      worktree.stdout.trim() === 'true' && !symbolic.error &&\n      symbolic.status === 0 && symbolic.stdout.trim().startsWith('refs/heads/')) {\n    const branch = git(['show-ref', '--verify', '--quiet', symbolic.stdout.trim()]);\n    if (!branch.error && branch.status === 1) return null;\n  }\n  throw new Error('Local source identity requires a readable Git worktree or a full EBK_SOURCE_COMMIT.');\n}";

package/src/generators/slice/local-source-identity.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localSourceCommitFunction = void 0;
+/** Local checks may run before the first commit; deployment evidence may not. */
+exports.localSourceCommitFunction = `function localSourceCommit() {
+  const supplied = process.env.EBK_SOURCE_COMMIT;
+  if (supplied !== undefined) {
+    if (!/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/.test(supplied)) {
+      throw new Error('EBK_SOURCE_COMMIT must be a full commit SHA.');
+    }
+    return supplied;
+  }
+  const git = (args) => spawnSync('git', args, {
+    cwd: workspaceRoot,
+    encoding: 'utf8',
+    shell: false,
+    windowsHide: true,
+  });
+  const head = git(['rev-parse', '--verify', 'HEAD^{commit}']);
+  if (!head.error && head.status === 0) return head.stdout.trim();
+  const worktree = git(['rev-parse', '--is-inside-work-tree']);
+  const symbolic = git(['symbolic-ref', '--quiet', 'HEAD']);
+  if (!worktree.error && worktree.status === 0 &&
+      worktree.stdout.trim() === 'true' && !symbolic.error &&
+      symbolic.status === 0 && symbolic.stdout.trim().startsWith('refs/heads/')) {
+    const branch = git(['show-ref', '--verify', '--quiet', symbolic.stdout.trim()]);
+    if (!branch.error && branch.status === 1) return null;
+  }
+  throw new Error('Local source identity requires a readable Git worktree or a full EBK_SOURCE_COMMIT.');
+}`;
+//# sourceMappingURL=local-source-identity.js.map

package/src/generators/slice/persistence-contract.d.ts

@@ -0,0 +1,14 @@
+export declare const STANDARD_PERSISTENCE_PATH = "data/persistence.json";
+export interface StandardPersistenceContract {
+    kind: 'ebk-standard-persistence';
+    schemaVersion: 1;
+    defaultStore: 'dynamodb';
+}
+/** The framework core is DynamoDB. SQL is additive, never an alternate core. */
+export declare function standardPersistenceContract(options: {
+    inputs: Record<string, unknown>;
+    current?: unknown;
+    existingStandardRequirement?: {
+        capabilities: readonly string[];
+    };
+}): StandardPersistenceContract;

package/src/generators/slice/persistence-contract.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STANDARD_PERSISTENCE_PATH = void 0;
+exports.standardPersistenceContract = standardPersistenceContract;
+const validation_js_1 = require("../../validation.js");
+const capability_plan_js_1 = require("../../foundation/capability-plan.js");
+exports.STANDARD_PERSISTENCE_PATH = 'data/persistence.json';
+/** The framework core is DynamoDB. SQL is additive, never an alternate core. */
+function standardPersistenceContract(options) {
+    (0, capability_plan_js_1.readStandardSqlDeclaration)(options.inputs);
+    if (options.current !== undefined) {
+        const current = options.current;
+        if (!(0, validation_js_1.isRecord)(current) ||
+            current.kind !== 'ebk-standard-persistence' ||
+            current.schemaVersion !== 1 ||
+            (current.defaultStore !== 'dynamodb' &&
+                current.defaultStore !== 'postgres') ||
+            Object.keys(current).some((key) => !['kind', 'schemaVersion', 'defaultStore'].includes(key)))
+            throw new Error('Standard persistence declaration is invalid; no store may be inferred or reassigned.');
+        if (current.defaultStore === 'postgres')
+            throw new Error('This prerelease Standard Slice uses a PostgreSQL-backed framework core. Automatic upgrade is unsupported. Preserve its data and infrastructure, then complete an explicit repository-owned migration or rebuild before adopting the DynamoDB core. No files have been changed.');
+    }
+    else if (options.existingStandardRequirement) {
+        throw new Error('Existing Standard Slice is missing its persisted storage declaration. Automatic prerelease conversion is unsupported; preserve its data and infrastructure and complete an explicit repository-owned migration or rebuild. No files have been changed.');
+    }
+    return {
+        kind: 'ebk-standard-persistence',
+        schemaVersion: 1,
+        defaultStore: 'dynamodb',
+    };
+}
+//# sourceMappingURL=persistence-contract.js.map

package/src/generators/slice/slice.js

@@ -8,6 +8,9 @@ const node_path_1 = require("node:path");
 const node_util_1 = require("node:util");
 const index_js_1 = require("../../blueprints/index.js");
 const index_js_2 = require("../../foundation/index.js");
+const capability_plan_js_1 = require("../../foundation/capability-plan.js");
+const preview_changes_js_1 = require("../../developer-agent/preview-changes.js");
+const upgrade_js_1 = require("../upgrade/upgrade.js");
 const index_js_3 = require("../../ownership/index.js");
 const index_js_4 = require("../../repository-policy/index.js");
 const blueprint_verification_authority_js_1 = require("../../supply-chain/blueprint-verification-authority.js");
@@ -16,6 +19,7 @@ const post_generation_install_js_1 = require("../post-generation-install.js");
 const formatting_js_1 = require("../formatting.js");
 const workspace_files_js_1 = require("../preset/workspace-files.js");
 const built_in_plan_js_1 = require("./built-in-plan.js");
+const data_policy_review_seed_js_1 = require("./data-policy-review-seed.js");
 const tree_policy_js_1 = require("../repository-policy/tree-policy.js");
 var built_in_plan_js_2 = require("./built-in-plan.js");
 Object.defineProperty(exports, "PRODUCT_PACKAGE_MANAGED_JSON_POINTERS", { enumerable: true, get: function () { return built_in_plan_js_2.PRODUCT_PACKAGE_MANAGED_JSON_POINTERS; } });
@@ -53,6 +57,10 @@ function json(value) {
 async function formatSliceBeforeOwnershipRestamp(tree, root, preserveBuiltInFormatSensitiveFiles) {
     const prefix = `${root}/`;
     const restoreProtectedFiles = (0, formatting_js_1.createTreeFileRestorer)(tree, (path) => {
+        // Paired Foundation generation has already formatted and hashed its own
+        // output. A Slice formatter must not invalidate that completed ownership.
+        if (!path.startsWith(prefix))
+            return true;
         if ((0, workspace_files_js_1.isRawWorkspaceAuthorityPath)(path))
             return true;
         return (preserveBuiltInFormatSensitiveFiles &&
@@ -120,23 +128,6 @@ function assertExternalBlueprintVerificationProgram(input) {
         targets: rootProject.targets,
     });
 }
-function dataPolicyReviewSeed(tree, root) {
-    const path = node_path_1.posix.join(root, 'data/policy.json');
-    const existing = tree.read(path, 'utf8');
-    if (existing !== null) {
-        try {
-            const reviewedAt = JSON.parse(existing).governance?.reviewedAt;
-            if (typeof reviewedAt === 'string' &&
-                new Date(reviewedAt).toISOString() === reviewedAt) {
-                return reviewedAt;
-            }
-        }
-        catch {
-            // The generated ownership/reconciliation path reports malformed policy.
-        }
-    }
-    return new Date().toISOString();
-}
 function reportSlicePolicyPosture(tree, name) {
     const contents = tree.read(index_js_4.REPOSITORY_POLICY_FILE, 'utf8');
     if (contents === null) {
@@ -233,7 +224,15 @@ async function sliceGenerator(tree, options) {
             .join('\n')}`);
     }
     const foundationDescriptor = readJson(tree, 'packages/foundation/contracts/foundation.json', 'Standard Foundation descriptor');
-    const compatibility = (0, index_js_2.validateFoundationCompatibility)(blueprint.manifest.foundation, foundationDescriptor);
+    const foundationRequirement = blueprint.source === 'built-in'
+        ? (0, capability_plan_js_1.standardPersistenceRequirement)(inputResult.value)
+        : blueprint.manifest.foundation;
+    const compatibility = (0, index_js_2.validateFoundationCompatibility)(foundationRequirement, blueprint.source === 'built-in'
+        ? (0, capability_plan_js_1.planFoundationCapabilities)({
+            current: foundationDescriptor,
+            requirements: [foundationRequirement],
+        }).descriptor
+        : foundationDescriptor);
     if (!compatibility.valid) {
         throw new Error(`Standard Foundation is incompatible with this Blueprint:\n${compatibility.issues
             .map((issue) => `- ${issue.path}: ${issue.message}`)
@@ -242,7 +241,7 @@ async function sliceGenerator(tree, options) {
     const installScope = {
         exactPaths: ['package.json'],
         requiredPaths: [node_path_1.posix.join(root, '.ebk/ownership.json')],
-        roots: [root],
+        roots: blueprint.source === 'built-in' ? [root, 'packages/foundation'] : [root],
     };
     const installState = options.skipInstall
         ? undefined
@@ -352,21 +351,27 @@ async function sliceGenerator(tree, options) {
     if (!runtimeVersion) {
         throw new Error('Workspace package.json must depend on @empire-builder-kit/runtime before generating a Product Slice.');
     }
-    const plan = (0, built_in_plan_js_1.createBuiltInSlicePlan)(name, scope, runtimeVersion, blueprint.manifest, inputResult.value, dataPolicyReviewSeed(tree, root), requireRepositoryDeploymentProfile(tree));
+    const plan = (0, built_in_plan_js_1.createBuiltInSlicePlan)(name, scope, runtimeVersion, blueprint.manifest, inputResult.value, (0, data_policy_review_seed_js_1.dataPolicyReviewSeed)(tree, root), requireRepositoryDeploymentProfile(tree));
     const ownershipValidation = (0, index_js_3.validateGeneratedOwnershipRecord)(plan.ownership);
     if (!ownershipValidation.valid) {
         throw new Error(`Generated ownership metadata is invalid:\n${ownershipValidation.issues
             .map((issue) => `- ${issue.path}: ${issue.message}`)
             .join('\n')}`);
     }
+    // Foundation capability growth and Slice creation are one ownership-preserving
+    // source operation. A later validation/formatting failure must not leave half
+    // of a relational declaration applied to the caller's tree.
+    const deferred = new preview_changes_js_1.DeferredDeveloperAgentTree(tree);
+    await (0, upgrade_js_1.upgradeFoundationForRequirements)(deferred, [foundationRequirement], true);
     for (const [relativePath, contents] of Object.entries(plan.files)) {
-        tree.write(node_path_1.posix.join(root, relativePath), contents);
+        deferred.write(node_path_1.posix.join(root, relativePath), contents);
     }
     if (!options.skipFormat)
-        await formatSliceBeforeOwnershipRestamp(tree, root, true);
-    (0, index_js_3.restampProductSliceOwnership)(tree, name);
+        await formatSliceBeforeOwnershipRestamp(deferred, root, true);
+    (0, index_js_3.restampProductSliceOwnership)(deferred, name);
     if (!options.skipFormat)
-        await formatSliceOwnership(tree, root);
+        await formatSliceOwnership(deferred, root);
+    deferred.apply();
     reportSlicePolicyPosture(tree, name);
     if (options.skipInstall)
         return undefined;

package/src/generators/sql/schema.d.ts

@@ -0,0 +1,7 @@
+export interface SqlGeneratorSchema {
+  name: string;
+  reason: string;
+  apply?: boolean;
+  skipFormat?: boolean;
+  skipInstall?: boolean;
+}