@topogram/cli 0.3.54 → 0.3.56

package/src/generator/context/domain-coverage.js

@@ -12,7 +12,7 @@ import {
 function projectionTypesFromProjections(projections) {
   const projectionTypes = new Set();
   for (const projection of projections) {
-    const projectionType = projection?.type || projection?.platform;
+    const projectionType = projection?.type || projection?.type;
     if (projectionType) {
       projectionTypes.add(projectionType);
     }
@@ -53,7 +53,7 @@ export function generateDomainCoverage(graph, options = {}) {
     for (const projectionType of projectionTypes) {
       const realized = projectionStatements.some(
         (projection) =>
-          (projection.type || projection.platform) === projectionType &&
+          (projection.type || projection.type) === projectionType &&
           (projection.realizes || []).some((entry) => entry.id === capabilityId)
       );
       matrix[capabilityId][projectionType] = realized;

package/src/generator/context/shared.js

@@ -58,11 +58,11 @@ function summarizeProjection(projection) {
     kind: projection.kind,
     name: projection.name || projection.id,
     description: projection.description || null,
-    platform: projection.platform || null,
+    type: projection.type || null,
     realizes: refIds(projection.realizes),
     outputs: stableSortedStrings(projection.outputs || []),
     uiScreens: stableSortedStrings((projection.uiScreens || []).map((screen) => screen.id)),
-    uiComponents: stableSortedStrings((projection.uiComponents || []).map((entry) => entry.component?.id).filter(Boolean)),
+    widgetBindings: stableSortedStrings((projection.widgetBindings || []).map((entry) => entry.widget?.id).filter(Boolean)),
     dbTables: stableSortedStrings((projection.dbTables || []).map((table) => table.table || table.entity?.id)),
     httpCapabilities: stableSortedStrings((projection.http || []).map((entry) => entry.capability?.id)),
     reviewBoundary: reviewBoundaryForProjectionPolicy(projection),
@@ -397,11 +397,7 @@ export function relatedProjectionsForShape(graph, shapeId) {
 }
 
 export function widgetById(graph, widgetId) {
-  return (graph?.byKind?.widget || graph?.byKind?.component || []).find((widget) => widget.id === widgetId) || null;
-}
-
-export function componentById(graph, componentId) {
-  return widgetById(graph, componentId);
+  return (graph?.byKind?.widget || []).find((widget) => widget.id === widgetId) || null;
 }
 
 function projectionById(graph, projectionId) {
@@ -435,7 +431,7 @@ function downstreamProjectionIds(graph, projectionIds) {
 }
 
 export function relatedWidgetsForProjection(graph, projection) {
-  const directIds = (projection?.uiComponents || []).map((entry) => entry.component?.id).filter(Boolean);
+  const directIds = (projection?.widgetBindings || []).map((entry) => entry.widget?.id).filter(Boolean);
   const inheritedIds = realizedProjectionIds(projection)
     .map((projectionId) => projectionById(graph, projectionId))
     .filter(Boolean)
@@ -443,10 +439,6 @@ export function relatedWidgetsForProjection(graph, projection) {
   return stableSortedStrings([...directIds, ...inheritedIds]);
 }
 
-export function relatedComponentsForProjection(graph, projection) {
-  return relatedWidgetsForProjection(graph, projection);
-}
-
 export function relatedShapesForWidget(widget) {
   if (!widget) return [];
   const ids = [
@@ -461,15 +453,11 @@ export function relatedShapesForWidget(widget) {
   return stableSortedStrings(ids);
 }
 
-export function relatedShapesForComponent(component) {
-  return relatedShapesForWidget(component);
-}
-
 export function relatedProjectionsForWidget(graph, widgetId) {
   const widget = widgetById(graph, widgetId);
   if (!widget) return [];
   const explicitProjectionIds = stableSortedStrings((graph?.byKind?.projection || [])
-    .filter((projection) => (projection.uiComponents || []).some((entry) => entry.component?.id === widgetId))
+    .filter((projection) => (projection.widgetBindings || []).some((entry) => entry.widget?.id === widgetId))
     .map((projection) => projection.id));
   const dependencyProjectionIds = stableSortedStrings((widget.dependencies || []).flatMap((dependency) => {
     const kind = referenceKind(dependency);
@@ -499,10 +487,6 @@ export function relatedProjectionsForWidget(graph, widgetId) {
   return downstreamProjectionIds(graph, stableSortedStrings([...explicitProjectionIds, ...dependencyProjectionIds, ...viaUiRegions]));
 }
 
-export function relatedProjectionsForComponent(graph, componentId) {
-  return relatedProjectionsForWidget(graph, componentId);
-}
-
 function referenceKind(reference) {
   if (reference?.target?.kind) {
     return reference.target.kind;
@@ -555,7 +539,7 @@ export function workspaceInventory(graph) {
     journeys: stableSortedStrings((graph.docs || []).filter((doc) => doc.kind === "journey").map((doc) => doc.id)),
     entities: stableSortedStrings((graph.byKind.entity || []).map((item) => item.id)),
     projections: stableSortedStrings((graph.byKind.projection || []).map((item) => item.id)),
-    widgets: stableSortedStrings((graph.byKind.widget || graph.byKind.component || []).map((item) => item.id)),
+    widgets: stableSortedStrings((graph.byKind.widget || []).map((item) => item.id)),
     verifications: stableSortedStrings((graph.byKind.verification || []).map((item) => item.id)),
     domains: stableSortedStrings((graph.byKind.domain || []).map((item) => item.id)),
     pitches: stableSortedStrings((graph.byKind.pitch || []).map((item) => item.id)),

package/src/generator/context/slice.js

@@ -337,7 +337,7 @@ function widgetDependencyKind(dependency) {
 }
 
 function uiAgentPacketForProjection(graph, projection) {
-  const projectionType = projection.type || projection.platform || null;
+  const projectionType = projection.type || projection.type || null;
   if (projectionType !== "ui_contract" && !String(projectionType || "").endsWith("_surface")) {
     return null;
   }
@@ -368,7 +368,7 @@ function uiAgentPacketForProjection(graph, projection) {
       screenId: route.screenId,
       path: route.path
     })),
-    widgets: (ownerProjection.uiComponents || []).map((usage) => widgetUsagePacket(usage)),
+    widgets: (ownerProjection.widgetBindings || []).map((usage) => widgetUsagePacket(usage)),
     designTokens: designIntentPacket(ownerProjection),
     requiredGates: uiRequiredGates(projection.id)
   };
@@ -378,9 +378,9 @@ function uiAgentPacketForWidget(graph, widget, projectionIds) {
   const projectionSet = new Set(projectionIds);
   const sourceUsages = [];
   for (const projection of graph.byKind.projection || []) {
-    for (const usage of projection.uiComponents || []) {
-      if (usage.component?.id !== widget.id) continue;
-      const projectionType = projection.type || projection.platform || null;
+    for (const usage of projection.widgetBindings || []) {
+      if (usage.widget?.id !== widget.id) continue;
+      const projectionType = projection.type || projection.type || null;
       sourceUsages.push({
         projection: {
           id: projection.id,
@@ -406,9 +406,9 @@ function uiAgentPacketForWidget(graph, widget, projectionIds) {
       id: widget.id,
       name: widget.name || widget.id,
       category: widget.category || null,
-      patterns: widget.widgetContract?.patterns || widget.componentContract?.patterns || [],
-      regions: widget.widgetContract?.regions || widget.componentContract?.regions || [],
-      behaviors: widget.widgetContract?.behaviors || widget.componentContract?.behaviors || []
+      patterns: widget.widgetContract?.patterns || [],
+      regions: widget.widgetContract?.regions || [],
+      behaviors: widget.widgetContract?.behaviors || []
     },
     sourceUsages,
     inheritedBy: [...projectionSet]
@@ -421,7 +421,7 @@ function uiAgentPacketForWidget(graph, widget, projectionIds) {
 function sharedUiProjectionFor(graph, projection) {
   for (const reference of projection.realizes || []) {
     const candidate = (graph.byKind.projection || []).find((entry) => entry.id === reference.id);
-    if ((candidate?.type || candidate?.platform) === "ui_contract") {
+    if ((candidate?.type || candidate?.type) === "ui_contract") {
       return candidate;
     }
   }
@@ -432,7 +432,7 @@ function widgetUsagePacket(usage) {
   return {
     screenId: usage.screenId || null,
     region: usage.region || null,
-    widgetId: usage.component?.id || null,
+    widgetId: usage.widget?.id || null,
     dataBindings: (usage.dataBindings || []).map((binding) => ({
       prop: binding.prop || null,
       source: binding.source?.id || binding.source || null

package/src/generator/docs.js

@@ -229,7 +229,7 @@ export function generateDocs(graph) {
       lines.push(projection.description);
       lines.push("");
     }
-    lines.push(`Platform: \`${projection.platform}\``);
+    lines.push(`Projection type: \`${projection.type}\``);
     lines.push(`Realizes: ${refList(projection.realizes)}`);
     lines.push(`Outputs: ${symbolList(projection.outputs)}`);
     lines.push("");

package/src/generator/registry.js

@@ -490,7 +490,7 @@ export function projectionCompatibilityKey(projection) {
   if (isApiProjection(projection)) {
     return "api_contract";
   }
-  return projection?.type || projection?.platform || "";
+  return projection?.type || projection?.type || "";
 }
 
 /**

package/src/generator/runtime/app-bundle.js

@@ -23,6 +23,7 @@ import {
 } from "./shared.js";
 import { getExampleImplementation } from "../../example-implementation.js";
 import { mergeNamedBundles, renderLoadEnvScript, renderNestedBundleShellScript } from "./bundle-shared.js";
+import { generateDbLifecyclePlan } from "../surfaces/databases/lifecycle-shared.js";
 
 function runtimeReferenceFor(graph, options = {}) {
   try {
@@ -47,6 +48,7 @@ function buildAppBundlePlan(graph, options = {}) {
   const runtimeReference = runtimeReferenceFor(graph, options);
   const topology = resolveRuntimeTopology(graph, options);
   const { apiProjection, uiProjection, dbProjection } = getDefaultEnvironmentProjections(graph, options);
+  const dbLifecycle = dbProjection ? generateDbLifecyclePlan(graph, { ...options, projectionId: dbProjection.id }) : null;
   const environmentProfile = options.profileId || "local_process";
   const deployProfile = options.deployProfileId || "fly_io";
   const smokeVerification = buildVerificationSummary(graph, ["smoke", "journey"]);
@@ -63,7 +65,9 @@ function buildAppBundlePlan(graph, options = {}) {
     projections: {
       api: apiProjection?.id || null,
       ui: uiProjection?.id || null,
-      db: dbProjection?.id || null
+      db: dbProjection?.id || null,
+      dbType: dbProjection?.type || null,
+      dbEngine: dbLifecycle?.engine || null
     },
     topology: {
       runtimes: topology.runtimes.map((runtime) => ({
@@ -113,7 +117,7 @@ function renderAppBundleEnvExample(plan) {
   };
   const ports = runtimePorts(plan.runtimeReference, topology);
   const urls = runtimeUrls(plan.runtimeReference, topology);
-  if (!plan.projections.dbPlatform) {
+  if (!plan.projections.dbType) {
     return `# App bundle defaults
 TOPOGRAM_ENVIRONMENT_PROFILE=${plan.profiles.environment}
 TOPOGRAM_DEPLOY_PROFILE=${plan.profiles.deployment}
@@ -126,7 +130,7 @@ ${plan.runtimeReference.environment.envExample || ""}
 # Smoke-test defaults
 ${plan.projections.api ? `TOPOGRAM_API_BASE_URL=${urls.api}\n` : ""}${plan.projections.ui ? `TOPOGRAM_WEB_BASE_URL=${urls.web}\n` : ""}`;
   }
-  if (plan.projections.dbPlatform === "db_contract") {
+  if (plan.projections.dbEngine === "sqlite") {
     return `# App bundle defaults
 TOPOGRAM_ENVIRONMENT_PROFILE=${plan.profiles.environment}
 TOPOGRAM_DEPLOY_PROFILE=${plan.profiles.deployment}
@@ -409,9 +413,7 @@ function noopBundle(name, message) {
 export function generateAppBundle(graph, options = {}) {
   const plan = buildAppBundlePlan(graph, options);
   const topology = resolveRuntimeTopology(graph, options);
-  const projections = getDefaultEnvironmentProjections(graph, options);
-  plan.projections.dbPlatform = projections.dbProjection?.platform || null;
-  const fullStack = topology.apiComponents.length > 0 && topology.webComponents.length > 0 && topology.dbComponents.length > 0;
+  const fullStack = topology.apiRuntimes.length > 0 && topology.webRuntimes.length > 0 && topology.dbRuntimes.length > 0;
   const envBundle = generateEnvironmentBundle(graph, { ...options, profileId: plan.profiles.environment });
   const deployBundle = fullStack
     ? generateDeploymentBundle(graph, { ...options, profileId: plan.profiles.deployment })

package/src/generator/runtime/compile-check.js

@@ -8,6 +8,7 @@ import {
 } from "./shared.js";
 import { getExampleImplementation } from "../../example-implementation.js";
 import { mergeBundleFiles } from "./bundle-shared.js";
+import { generateDbLifecyclePlan } from "../surfaces/databases/lifecycle-shared.js";
 
 function compileCheckName(graph, options = {}) {
   try {
@@ -28,13 +29,13 @@ function runtimeReferenceFor(graph, options = {}) {
 function buildCompileCheckPlan(graph, options = {}) {
   const topology = resolveRuntimeTopology(graph, options);
   const { apiProjection, uiProjection, dbProjection } = getDefaultEnvironmentProjections(graph, options);
-  const apiChecks = topology.apiComponents.map((component, index) => ({
+  const apiChecks = topology.apiRuntimes.map((component, index) => ({
     id: index === 0 ? "server_typecheck" : `server_typecheck_${component.id}`,
     cwd: topology.serviceDir(component),
     install: "npm install --no-audit --no-fund",
     command: "npm run check"
   }));
-  const webChecks = topology.webComponents.flatMap((component, index) => [
+  const webChecks = topology.webRuntimes.flatMap((component, index) => [
     {
       id: index === 0 ? "web_typecheck" : `web_typecheck_${component.id}`,
       cwd: topology.webDir(component),
@@ -72,8 +73,9 @@ function renderCompileCheckEnvExample(graph, options = {}) {
   const runtimeReference = runtimeReferenceFor(graph, options);
   const topology = resolveRuntimeTopology(graph, options);
   const { dbProjection } = getDefaultEnvironmentProjections(graph, options);
+  const dbLifecycle = dbProjection ? generateDbLifecyclePlan(graph, { ...options, projectionId: dbProjection.id }) : null;
   const urls = runtimeUrls(runtimeReference, topology);
-  if (dbProjection?.platform === "db_contract") {
+  if (dbLifecycle?.engine === "sqlite") {
     return `DATABASE_URL=./var/${runtimeReference.environment.databaseName || "topogram_app"}.sqlite
 PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}
 PUBLIC_TOPOGRAM_DEMO_USER_ID=${runtimeDemoUserId(runtimeReference)}
@@ -148,11 +150,11 @@ export function generateCompileCheckBundle(graph, options = {}) {
     "compile-check-plan.json": `${JSON.stringify(plan, null, 2)}\n`,
     "scripts/check.sh": renderCompileCheckScript(plan)
   };
-  for (const component of topology.apiComponents) {
+  for (const component of topology.apiRuntimes) {
     const serverBundle = generateServerBundle(graph, component.projection.id, { ...options, component });
     mergeBundleFiles(files, topology.serviceDir(component), serverBundle);
   }
-  for (const component of topology.webComponents) {
+  for (const component of topology.webRuntimes) {
     const webBundle = generateWebBundle(graph, component.projection.id, { ...options, component });
     mergeBundleFiles(files, topology.webDir(component), webBundle);
   }

package/src/generator/runtime/deployment.js

@@ -8,6 +8,7 @@ import {
 import { getExampleImplementation } from "../../example-implementation.js";
 import { mergeNamedBundles, renderRootEnvFileShellScript, renderRootShellScript } from "./bundle-shared.js";
 import { generatorProfile as manifestGeneratorProfile } from "../registry.js";
+import { generateDbLifecyclePlan } from "../surfaces/databases/lifecycle-shared.js";
 
 function projectionHintProfile(projection, fallback) {
   for (const entry of projection.generatorDefaults || []) {
@@ -33,7 +34,8 @@ function buildDeploymentPlan(graph, options = {}) {
   const profile = options.profileId || "fly_io";
   const supportedProfiles = ["fly_io", "railway"];
   const webProfile = manifestGeneratorProfile(topology.primaryWeb?.generator?.id, null) || projectionHintProfile(uiProjection, "sveltekit");
-  const databaseTarget = dbProjection.platform === "db_contract"
+  const dbLifecycle = dbProjection ? generateDbLifecyclePlan(graph, { ...options, projectionId: dbProjection.id }) : null;
+  const databaseTarget = dbLifecycle?.engine === "sqlite"
     ? "sqlite_file"
     : profile === "fly_io"
       ? "managed_postgres"
@@ -260,19 +262,19 @@ export function generateDeploymentBundle(graph, options = {}) {
     files["railway.json"] = renderRailwayJson(plan);
   }
 
-  for (const component of topology.apiComponents) {
+  for (const component of topology.apiRuntimes) {
     const serverBundle = generateServerBundle(graph, component.projection.id, { ...options, component });
     mergeNamedBundles(files, {
       [topology.serviceDir(component)]: serverBundle
     });
   }
-  for (const component of topology.webComponents) {
+  for (const component of topology.webRuntimes) {
     const webBundle = generateWebBundle(graph, component.projection.id, { ...options, component });
     mergeNamedBundles(files, {
       [topology.webDir(component)]: webBundle
     });
   }
-  for (const component of topology.dbComponents) {
+  for (const component of topology.dbRuntimes) {
     const dbBundle = generateDbBundle(graph, component.projection.id, { ...options, component });
     mergeNamedBundles(files, {
       [topology.dbDir(component)]: dbBundle

package/src/generator/runtime/environment.js

@@ -43,10 +43,11 @@ function buildEnvironmentPlan(graph, options = {}) {
   const topology = resolveRuntimeTopology(graph, options);
   const { apiProjection, uiProjection, dbProjection } = getDefaultEnvironmentProjections(graph, options);
   const dbLifecycle = dbProjection ? generateDbLifecyclePlan(graph, { ...options, projectionId: dbProjection.id }) : null;
-  const profile = options.profileId || (dbProjection?.platform === "db_contract" || !dbProjection ? "local_process" : "local_docker");
+  const dbEngine = dbLifecycle?.engine || null;
+  const profile = options.profileId || (dbEngine === "sqlite" || !dbProjection ? "local_process" : "local_docker");
   const usesDocker = profile === "local_docker";
   const webProfile = manifestGeneratorProfile(topology.primaryWeb?.generator?.id, null) || projectionHintProfile(uiProjection, "sveltekit");
-  const isSqlite = dbProjection?.platform === "db_contract";
+  const isSqlite = dbEngine === "sqlite";
   const ports = runtimePorts(runtimeReference, topology);
 
   return {
@@ -71,15 +72,16 @@ function buildEnvironmentPlan(graph, options = {}) {
     projections: {
       api: {
         id: apiProjection?.id || null,
-        platform: apiProjection?.platform || null
+        type: apiProjection?.type || null
       },
       ui: {
         id: uiProjection?.id || null,
-        platform: uiProjection?.platform || null
+        type: uiProjection?.type || null
       },
       db: {
         id: dbProjection?.id || null,
-        platform: dbProjection?.platform || null,
+        type: dbProjection?.type || null,
+        engine: dbEngine,
         profile: dbProjection?.generatorDefaults?.profile || dbProjection?.profile || null
       }
     },
@@ -111,27 +113,28 @@ function buildEnvironmentPlan(graph, options = {}) {
       scripts: "scripts"
     },
     runtimes: {
-      apis: topology.apiComponents.map((component) => ({
+      apis: topology.apiRuntimes.map((component) => ({
         id: component.id,
         projection: component.projection.id,
         port: component.port || ports.server,
         dir: topology.serviceDir(component),
-        database: component.database,
-        databaseEnv: component.databaseComponent
-          ? dbEnvVarsForComponent(component.databaseComponent, { primary: component.databaseComponent?.id === topology.primaryDb?.id })
+        uses_database: component.database,
+        databaseEnv: component.databaseRuntime
+          ? dbEnvVarsForComponent(component.databaseRuntime, { primary: component.databaseRuntime?.id === topology.primaryDb?.id })
           : null
       })),
-      webs: topology.webComponents.map((component) => ({
+      webs: topology.webRuntimes.map((component) => ({
         id: component.id,
         projection: component.projection.id,
         port: component.port || ports.web,
         dir: topology.webDir(component),
-        api: component.api
+        uses_api: component.api
       })),
-      databases: topology.dbComponents.map((component) => ({
+      databases: topology.dbRuntimes.map((component) => ({
         id: component.id,
         projection: component.projection.id,
-        platform: component.projection.platform,
+        type: component.projection.type,
+        engine: component.id === topology.primaryDb?.id ? dbEngine : null,
         port: component.port,
         dir: topology.dbDir(component),
         env: dbEnvVarsForComponent(component, { primary: component.id === topology.primaryDb?.id })
@@ -169,7 +172,7 @@ function renderEnvironmentEnvExample(plan) {
     .filter((component) => component.id !== plan.runtimes.databases[0]?.id)
     .map((component) => {
       const fallbackName = `${databaseName}_${component.id}`;
-      if (component.platform === "db_contract") {
+      if (component.engine === "sqlite") {
         return `${component.env.databaseUrl}=file:./var/${component.id}.sqlite`;
       }
       return [
@@ -190,10 +193,10 @@ TOPOGRAM_DEMO_USER_ID=${demoUserId}
 ${plan.runtimeReference.environment.envExample || ""}
 TOPOGRAM_SEED_DEMO=true
 `;
-  if (!plan.projections.db.platform) {
+  if (!plan.projections.db.type) {
     return commonLines;
   }
-  if (plan.projections.db.platform === "db_contract") {
+  if (plan.projections.db.engine === "sqlite") {
     return `# Environment profile
 TOPOGRAM_ENVIRONMENT_PROFILE=${plan.environment.profile}
 
@@ -272,7 +275,7 @@ function renderEnvironmentReadme(plan) {
   const hasWeb = plan.runtimes.webs.length > 0;
   const localProcessNotes = !hasDb
     ? "- This bundle has no generated database surface."
-    : plan.projections.db.platform === "db_contract"
+    : plan.projections.db.engine === "sqlite"
     ? "- SQLite is file-backed for this bundle; no separate DB server is required."
     : `- Make sure the Postgres server is already running before \`${plan.commands.bootstrapDb}\`.\n- \`DATABASE_URL\` and \`DATABASE_ADMIN_URL\` should point at your local or managed Postgres instance.`;
   const dockerSection = plan.orchestration.usesDocker
@@ -291,13 +294,13 @@ ${localProcessNotes}
 
 This bundle packages the generated runtime into one local environment:
 
-${hasApi ? "- `services/<api-id>/`: generated API service scaffolds\n" : ""}${hasWeb ? `- \`web/<web-id>/\`: generated ${plan.runtimeProfiles.web === "react" ? "Vite + React Router" : plan.runtimeProfiles.web === "vanilla" ? "vanilla HTML/CSS/JS" : "SvelteKit"} web scaffolds\n` : ""}${hasDb ? "- `db/<db-id>/`: generated DB lifecycle bundles\n" : ""}${plan.files.dockerCompose ? `- \`${plan.files.dockerCompose}\`: local Postgres container` : hasDb ? (plan.projections.db.platform === "db_contract" ? "- local SQLite file orchestration (no Docker files generated)" : "- local-process Postgres orchestration (no Docker files generated)") : "- no DB orchestration is generated"}
+${hasApi ? "- `services/<api-id>/`: generated API service scaffolds\n" : ""}${hasWeb ? `- \`web/<web-id>/\`: generated ${plan.runtimeProfiles.web === "react" ? "Vite + React Router" : plan.runtimeProfiles.web === "vanilla" ? "vanilla HTML/CSS/JS" : "SvelteKit"} web scaffolds\n` : ""}${hasDb ? "- `db/<db-id>/`: generated DB lifecycle bundles\n" : ""}${plan.files.dockerCompose ? `- \`${plan.files.dockerCompose}\`: local Postgres container` : hasDb ? (plan.projections.db.engine === "sqlite" ? "- local SQLite file orchestration (no Docker files generated)" : "- local-process Postgres orchestration (no Docker files generated)") : "- no DB orchestration is generated"}
 
 ## Quick Start
 
 1. Copy \`.env.example\` to \`.env\` if you want to customize defaults
 2. Start the database:
-   - ${!hasDb ? "not applicable" : plan.projections.db.platform === "db_contract" ? "no separate DB service is required" : plan.orchestration.usesDocker ? `\`${plan.commands.dockerDb}\`` : "use your local Postgres service"}
+   - ${!hasDb ? "not applicable" : plan.projections.db.engine === "sqlite" ? "no separate DB service is required" : plan.orchestration.usesDocker ? `\`${plan.commands.dockerDb}\`` : "use your local Postgres service"}
 3. Bootstrap or migrate the database:
    - \`${plan.commands.bootstrapDb}\`
 4. Start the stack:
@@ -313,7 +316,7 @@ ${dockerSection}
 
 ## Notes
 
-- ${hasApi && hasDb ? `The generated server expects ${plan.projections.db.platform === "db_contract" ? "SQLite plus Prisma." : "Postgres plus Prisma."}` : hasApi ? "The generated server is stateless." : "No server surface is generated."}
+- ${hasApi && hasDb ? `The generated server expects ${plan.projections.db.engine === "sqlite" ? "SQLite plus Prisma." : "Postgres plus Prisma."}` : hasApi ? "The generated server is stateless." : "No server surface is generated."}
 - ${hasWeb && hasApi ? "The generated web app talks to `PUBLIC_TOPOGRAM_API_BASE_URL`." : hasWeb ? "The generated web app is standalone." : "No web surface is generated."}
 - If \`.env\` is missing, generated scripts fall back to \`.env.example\`.
 - The DB lifecycle scripts remain the source of truth for greenfield bootstrap and brownfield migration.
@@ -327,7 +330,7 @@ function renderEnvironmentLoadEnvScript() {
 function renderEnvironmentBootstrapDbScript(plan) {
   const dbBootstrapLines = plan.runtimes.databases.map((component) => {
     const env = component.env;
-    const runtimeApi = plan.runtimes.apis.find((apiComponent) => apiComponent.database === component.id);
+    const runtimeApi = plan.runtimes.apis.find((apiRuntime) => apiRuntime.uses_database === component.id);
     const assignments = [
       `DATABASE_URL="\${${env.databaseUrl}:-}"`,
       `DATABASE_ADMIN_URL="\${${env.databaseAdminUrl}:-}"`,
@@ -353,7 +356,7 @@ function renderEnvironmentBootstrapDbScript(plan) {
     ...dbBootstrapLines,
     'if [[ "${TOPOGRAM_SEED_DEMO:-true}" != "false" ]]; then',
     ...apiDatabaseExportLines(primaryApi),
-    ...(primaryApi?.database
+    ...(primaryApi?.uses_database
       ? [`(cd "$ROOT_DIR/${primaryApi.dir}" && npm install && npm exec -- prisma generate --schema prisma/schema.prisma && npm exec -- prisma db push --schema prisma/schema.prisma --skip-generate && npm run seed:demo)`]
       : ['echo "No DB-backed API component is configured; skipping demo seed."']),
     "fi"
@@ -381,7 +384,7 @@ function renderEnvironmentServerDevScript(plan, component = plan.runtimes.apis[0
     "",
     `cd "$ROOT_DIR/${component.dir}"`,
     "npm install",
-    ...(component.database ? ["npm exec -- prisma generate --schema prisma/schema.prisma"] : []),
+    ...(component.uses_database ? ["npm exec -- prisma generate --schema prisma/schema.prisma"] : []),
     "npm run dev"
   ], options.componentScript ? componentScriptOptions() : {});
 }
@@ -390,12 +393,12 @@ function renderEnvironmentWebDevScript(plan, component = plan.runtimes.webs[0],
   if (!component) {
     return renderEnvAwareShellScript(['echo "No web runtimes are configured."']);
   }
-  const apiComponent = plan.runtimes.apis.find((entry) => entry.id === component.api) || plan.runtimes.apis[0];
+  const apiRuntime = plan.runtimes.apis.find((entry) => entry.id === component.uses_api) || plan.runtimes.apis[0];
   const guardPortsScript = options.componentScript ? '"$ROOT_DIR/scripts/guard-ports.mjs"' : '"$SCRIPT_DIR/guard-ports.mjs"';
   return renderEnvAwareShellScript([
     `node ${guardPortsScript} web`,
     "",
-    ...(apiComponent ? [`export PUBLIC_TOPOGRAM_API_BASE_URL="\${PUBLIC_TOPOGRAM_API_BASE_URL:-http://localhost:\${${apiComponent.id.toUpperCase()}_PORT:-\${SERVER_PORT:-${apiComponent.port}}}}"`] : []),
+    ...(apiRuntime ? [`export PUBLIC_TOPOGRAM_API_BASE_URL="\${PUBLIC_TOPOGRAM_API_BASE_URL:-http://localhost:\${${apiRuntime.id.toUpperCase()}_PORT:-\${SERVER_PORT:-${apiRuntime.port}}}}"`] : []),
     `export TOPOGRAM_CORS_ORIGINS="\${TOPOGRAM_CORS_ORIGINS:-http://localhost:\${${component.id.toUpperCase()}_PORT:-\${WEB_PORT:-${component.port}}},http://127.0.0.1:\${${component.id.toUpperCase()}_PORT:-\${WEB_PORT:-${component.port}}}}"`,
     "",
     `cd "$ROOT_DIR/${component.dir}"`,
@@ -609,19 +612,19 @@ export function generateEnvironmentBundle(graph, options = {}) {
     files["scripts/docker-stack.sh"] = renderEnvironmentDockerStackScript();
   }
 
-  for (const component of topology.apiComponents) {
+  for (const component of topology.apiRuntimes) {
     const serverBundle = generateServerBundle(graph, component.projection.id, { ...options, component });
     mergeNamedBundles(files, {
       [topology.serviceDir(component)]: serverBundle
     });
   }
-  for (const component of topology.webComponents) {
+  for (const component of topology.webRuntimes) {
     const webBundle = generateWebBundle(graph, component.projection.id, { ...options, component });
     mergeNamedBundles(files, {
       [topology.webDir(component)]: webBundle
     });
   }
-  for (const component of topology.dbComponents) {
+  for (const component of topology.dbRuntimes) {
     const dbBundle = generateDbBundle(graph, component.projection.id, { ...options, component });
     mergeNamedBundles(files, {
       [topology.dbDir(component)]: dbBundle