@topogram/cli 0.3.54 → 0.3.56

package/CHANGELOG.md

@@ -5,6 +5,24 @@
 - Install package-backed generator dependencies during `topogram template check`
   before starter validation.
 
+## 0.3.55 - 2026-05-07
+
+- Complete the public DSL cleanup from `component` to `widget`: normalized
+  graph/context output now uses `widget`, `widgetBindings`, `widgetContract`,
+  and widget report target names without publishing component compatibility
+  aliases.
+- Reconcile/adoption import reports now emit `widgets` in candidate model
+  bundles, evidence, summaries, and promoted item plans. Existing imported
+  workspaces with `candidates.ui.components` are still accepted as a read-only
+  fallback, but new import output writes `candidates.ui.widgets`.
+- Old CLI names fail with explicit rename guidance instead of silently running:
+  `topogram component`, `--component`, `ui-component-contract`,
+  `component-conformance-report`, and `component-behavior-report`.
+- Generator policy diagnostics now describe topology entries as runtimes
+  (`runtimeId`) instead of components.
+- Tighten boundary tests so old public DSL vocabulary is allowed only in
+  migration guidance and explicit rename diagnostics.
+
 ## 0.3.16 - 2026-05-03
 
 - Install package-backed generator dependencies during `topogram template check`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topogram/cli",
-  "version": "0.3.54",
+  "version": "0.3.56",
   "description": "Topogram CLI for checking Topogram workspaces and generating app bundles.",
   "license": "Apache-2.0",
   "repository": {

package/src/adoption/review-groups.js

@@ -10,7 +10,7 @@ export function buildProjectionReviewGroups(items) {
           id: dependency.id,
           projection_id: dependency.projection_id,
           kind: dependency.kind,
-          platform: dependency.platform,
+          projection_type: dependency.projection_type,
           reason: dependency.reason,
           items: []
         });
@@ -47,7 +47,7 @@ export function buildUiReviewGroups(items) {
           id: dependency.id,
           projection_id: dependency.projection_id,
           kind: dependency.kind,
-          platform: dependency.platform,
+          projection_type: dependency.projection_type,
           reason: dependency.reason,
           items: []
         });
@@ -172,7 +172,7 @@ export function buildBundleAdoptionPriorities(report, confidenceRank) {
         enums: bundle.enums.length,
         capabilities: bundle.capabilities.length,
         shapes: bundle.shapes.length,
-        components: bundle.components?.length || 0,
+        widgets: bundle.widgets?.length || 0,
         screens: bundle.screens.length,
         workflows: bundle.workflows.length,
         docs: bundle.docs.length

package/src/agent-ops/query-builders.js

@@ -2,16 +2,16 @@ import fs from "node:fs";
 import path from "node:path";
 
 import {
-  componentById,
   getJourneyDoc,
   getStatement,
   summarizeById,
   getWorkflowDoc,
-  relatedComponentsForProjection,
   relatedProjectionsForCapability,
-  relatedProjectionsForComponent,
   relatedProjectionsForEntity,
-  relatedShapesForProjection
+  relatedProjectionsForWidget,
+  relatedShapesForProjection,
+  relatedWidgetsForProjection,
+  widgetById
 } from "../generator/context/shared.js";
 import { generatorDefaultsMap } from "../generator/surfaces/shared.js";
 
@@ -1337,7 +1337,7 @@ function buildMaintainedOutputGroups(outputs = [], seams = [], {
 
 function projectionKindForImpact(projection) {
   if (!projection) return "unknown";
-  if ((projection.http || []).length > 0 || projection.platform === "api" || projection.platform === "backend") {
+  if ((projection.http || []).length > 0 || projection.type === "api" || projection.type === "backend") {
     return "api";
   }
   if (
@@ -1345,9 +1345,9 @@ function projectionKindForImpact(projection) {
     (projection.uiWeb || []).length > 0 ||
     (projection.uiIos || []).length > 0 ||
     (projection.uiScreens || []).length > 0 ||
-    projection.platform === "web_surface" ||
-    projection.platform === "ios_surface" ||
-    projection.platform === "ui_contract"
+    projection.type === "web_surface" ||
+    projection.type === "ios_surface" ||
+    projection.type === "ui_contract"
   ) {
     return "ui";
   }
@@ -1355,7 +1355,7 @@ function projectionKindForImpact(projection) {
     (projection.dbTables || []).length > 0 ||
     (projection.dbColumns || []).length > 0 ||
     (projection.dbRelations || []).length > 0 ||
-    String(projection.platform || "").startsWith("db_")
+    String(projection.type || "").startsWith("db_")
   ) {
     return "db";
   }
@@ -1367,7 +1367,7 @@ function projectionSummaryForImpact(projection) {
   return {
     projection_id: projection.id,
     kind: projectionKindForImpact(projection),
-    platform: projection.platform || null,
+    type: projection.type || null,
     outputs: stableSortedStrings(projection.outputs || [])
   };
 }
@@ -1408,7 +1408,7 @@ function addImpact(map, impact) {
     "changed_capability",
     "changed_entity",
     "changed_shape",
-    "changed_component",
+    "changed_widget",
     "changed_rule",
     "changed_workflow",
     "changed_journey",
@@ -1551,20 +1551,20 @@ function projectionImpactsFromShape(graph, shapeId) {
   ];
 }
 
-function projectionImpactsFromComponent(graph, componentId) {
-  const component = componentById(graph, componentId);
-  if (!component) {
+function projectionImpactsFromWidget(graph, widgetId) {
+  const widget = widgetById(graph, widgetId);
+  if (!widget) {
     return [];
   }
 
   return impactsFromProjectionIds(
     graph,
-    relatedProjectionsForComponent(graph, componentId),
-    "changed_component",
-    (projection) => `Projection ${projection.id} is affected because component ${componentId} is used by that UI surface.`
+    relatedProjectionsForWidget(graph, widgetId),
+    "changed_widget",
+    (projection) => `Projection ${projection.id} is affected because widget ${widgetId} is used by that UI surface.`
   ).map((impact) => ({
     ...impact,
-    component_ids: stableSortedStrings([componentId])
+    widget_ids: stableSortedStrings([widgetId])
   }));
 }
 
@@ -1602,8 +1602,8 @@ function buildProjectionImpacts(graph, { sliceArtifact, diffArtifact }) {
       for (const impact of projectionImpactsFromShape(graph, entry.id)) addImpact(impactMap, impact);
     }
 
-    for (const entry of diffArtifact.components || []) {
-      for (const impact of projectionImpactsFromComponent(graph, entry.id)) addImpact(impactMap, impact);
+    for (const entry of diffArtifact.widgets || diffArtifact.components || []) {
+      for (const impact of projectionImpactsFromWidget(graph, entry.id)) addImpact(impactMap, impact);
     }
 
     for (const entry of diffArtifact.rules || []) {
@@ -1640,7 +1640,7 @@ function buildProjectionImpacts(graph, { sliceArtifact, diffArtifact }) {
         (projection) => `Projection ${projection.id} is in scope because selected entity ${id} participates in that projection.`
       )) addImpact(impactMap, impact);
     } else if (kind === "widget") {
-      for (const impact of projectionImpactsFromComponent(graph, id)) addImpact(impactMap, impact);
+      for (const impact of projectionImpactsFromWidget(graph, id)) addImpact(impactMap, impact);
     } else if (kind === "workflow") {
       for (const impact of projectionImpactsFromWorkflow(graph, id, true)) addImpact(impactMap, impact);
     } else if (kind === "journey") {
@@ -1675,7 +1675,7 @@ function buildGeneratorTargets(graph, projectionImpacts = [], diffArtifact = nul
     }
   };
 
-  for (const entry of diffArtifact?.components || []) {
+  for (const entry of diffArtifact?.widgets || diffArtifact?.components || []) {
     addTarget({
       target: "ui-widget-contract",
       widget_id: entry.id,
@@ -1717,7 +1717,7 @@ function buildGeneratorTargets(graph, projectionImpacts = [], diffArtifact = nul
       });
     }
 
-    if (projection.platform === "ui_contract") {
+    if (projection.type === "ui_contract") {
       addTarget({
         target: "ui-contract-graph",
         projection_id: impact.projection_id,
@@ -1732,29 +1732,29 @@ function buildGeneratorTargets(graph, projectionImpacts = [], diffArtifact = nul
       });
     }
 
-    const componentIds = stableSortedStrings([
-      ...(impact.component_ids || []),
-      ...(impact.kind === "ui" ? relatedComponentsForProjection(graph, projection) : [])
+    const widgetIds = stableSortedStrings([
+      ...(impact.widget_ids || []),
+      ...(impact.kind === "ui" ? relatedWidgetsForProjection(graph, projection) : [])
     ]);
 
-    for (const componentId of componentIds) {
+    for (const widgetId of widgetIds) {
       addTarget({
         target: "ui-widget-contract",
-        widget_id: componentId,
+        widget_id: widgetId,
         projection_id: impact.projection_id,
         required: true,
-        reason: `Projection ${impact.projection_id} is affected by widget ${componentId}, so the widget contract should be refreshed.`
+        reason: `Projection ${impact.projection_id} is affected by widget ${widgetId}, so the widget contract should be refreshed.`
       });
       addTarget({
         target: "widget-behavior-report",
-        widget_id: componentId,
+        widget_id: widgetId,
         projection_id: impact.projection_id,
         required: true,
-        reason: `Projection ${impact.projection_id} is affected by widget ${componentId}, so behavior data/event/action wiring should be reviewed.`
+        reason: `Projection ${impact.projection_id} is affected by widget ${widgetId}, so behavior data/event/action wiring should be reviewed.`
       });
     }
 
-    if (projection.platform === "web_surface") {
+    if (projection.type === "web_surface") {
       addTarget({
         target: "ui-surface-contract",
         projection_id: impact.projection_id,
@@ -1777,7 +1777,7 @@ function buildGeneratorTargets(graph, projectionImpacts = [], diffArtifact = nul
       }
     }
 
-    if (projection.platform === "ios_surface") {
+    if (projection.type === "ios_surface") {
       addTarget({
         target: "swiftui-app",
         projection_id: impact.projection_id,
@@ -1786,7 +1786,7 @@ function buildGeneratorTargets(graph, projectionImpacts = [], diffArtifact = nul
       });
     }
 
-    if (String(projection.platform || "").startsWith("db_")) {
+    if (String(projection.type || "").startsWith("db_")) {
       addTarget({
         target: "db-contract-graph",
         projection_id: impact.projection_id,

package/src/archive/schema.js

@@ -53,7 +53,7 @@ function serializeFields(statement) {
     "plan",
     "monitoring",
     "vocabulary",
-    "componentContract",
+    "widgetContract",
     "record",
     "flow",
     "affectedByPitches",

package/src/cli.js

@@ -771,7 +771,7 @@ function printReleaseHelp() {
   console.log("  topogram release status");
   console.log("  topogram release status --json");
   console.log("  topogram release status --strict");
-  console.log("  topogram release status --strict --write-report ./release-baseline.md");
+  console.log("  topogram release status --strict --write-report ./docs/release-matrix.md");
   console.log("  topogram release roll-consumers 0.3.46 --watch");
   console.log("  topogram release roll-consumers --latest --watch");
   console.log("");
@@ -1037,8 +1037,8 @@ function targetRequiresImplementationProvider(target) {
 
 function topologyComponentReferences(component) {
   return {
-    uses_api: component.uses_api || component.api || null,
-    uses_database: component.uses_database || component.database || null
+    uses_api: component.uses_api || null,
+    uses_database: component.uses_database || null
   };
 }
 
@@ -1054,10 +1054,10 @@ function summarizeProjectTopology(config) {
       ownership: output?.ownership || null
     }))
     .sort((left, right) => left.name.localeCompare(right.name));
-  const runtimes = (config?.topology?.runtimes || config?.topology?.components || [])
+  const runtimes = (config?.topology?.runtimes || [])
     .map((component) => ({
       id: component.id,
-      kind: component.kind || component.type,
+      kind: component.kind,
       projection: component.projection,
       generator: {
         id: component.generator?.id || null,
@@ -1097,7 +1097,7 @@ function publicProjectTopology(topology) {
     return topology || null;
   }
   return {
-    ...Object.fromEntries(Object.entries(topology).filter(([key]) => !["components", "__normalizedRuntimeAliases"].includes(key))),
+    ...Object.fromEntries(Object.entries(topology).filter(([key]) => key !== "components")),
     runtimes: topology.runtimes || []
   };
 }
@@ -1818,7 +1818,7 @@ function annotateGeneratorPolicyDiagnostics(diagnostics, bindings) {
   return diagnostics.map((diagnostic) => {
     const binding = bindings.find((item) => (
       item.packageName === diagnostic.packageName &&
-      (!diagnostic.componentId || item.componentId === diagnostic.componentId)
+      (!diagnostic.runtimeId || item.runtimeId === diagnostic.runtimeId)
     ));
     if (!binding) {
       return diagnostic;
@@ -1846,11 +1846,11 @@ function generatorPolicyPackageMetadataDiagnostics(bindings) {
       diagnostics.push({
         code: "generator_package_dependency_missing",
         severity: "warning",
-        message: `Component '${binding.componentId}' generator package '${binding.packageName}' is not declared in package.json dependencies.`,
+        message: `Runtime '${binding.runtimeId}' generator package '${binding.packageName}' is not declared in package.json dependencies.`,
         path: binding.packageInfo.installedPackageJsonPath,
         suggestedFix: `Declare '${binding.packageName}' in package.json devDependencies so generator adoption is visible in package review.`,
         step: "generator-policy",
-        componentId: binding.componentId,
+        runtimeId: binding.runtimeId,
         generatorId: binding.generatorId,
         packageName: binding.packageName,
         version: binding.version,
@@ -1870,11 +1870,11 @@ function generatorPolicyPackageMetadataDiagnostics(bindings) {
       diagnostics.push({
         code: "generator_package_version_drift",
         severity: "warning",
-        message: `Component '${binding.componentId}' generator package '${binding.packageName}' is installed at '${binding.packageInfo.installedVersion}', but package-lock records '${binding.packageInfo.lockfileVersion}'.`,
+        message: `Runtime '${binding.runtimeId}' generator package '${binding.packageName}' is installed at '${binding.packageInfo.installedVersion}', but package-lock records '${binding.packageInfo.lockfileVersion}'.`,
         path: binding.packageInfo.lockfilePath,
         suggestedFix: "Run the package manager install command and review the resulting lockfile before pinning generator policy.",
         step: "generator-policy",
-        componentId: binding.componentId,
+        runtimeId: binding.runtimeId,
         generatorId: binding.generatorId,
         packageName: binding.packageName,
         version: binding.version,
@@ -1975,7 +1975,7 @@ function buildGeneratorPolicyExplainPayload(projectPath) {
         `scopes=${policy.allowedPackageScopes.join(", ") || "(none)"}`,
         `packages=${policy.allowedPackages.join(", ") || "(none)"}`
       ].join("; "),
-      `Component '${binding.componentId}' package-backed generator must be from an allowed package or scope.`,
+      `Runtime '${binding.runtimeId}' package-backed generator must be from an allowed package or scope.`,
       `Run \`topogram generator policy pin ${binding.packageName}@${binding.version}\` after reviewing the generator package.`
     ));
     const pinnedVersion = policy.pinnedVersions[binding.packageName] || policy.pinnedVersions[binding.generatorId] || null;
@@ -1984,7 +1984,7 @@ function buildGeneratorPolicyExplainPayload(projectPath) {
       !pinnedVersion || pinnedVersion === binding.version,
       binding.version,
       pinnedVersion || "(unpinned)",
-      `Component '${binding.componentId}' generator version must match its policy pin when one exists.`,
+      `Runtime '${binding.runtimeId}' generator version must match its policy pin when one exists.`,
       `Run \`topogram generator policy pin ${binding.packageName}@${binding.version}\` after review.`
     ));
   }
@@ -2024,7 +2024,7 @@ function printGeneratorPolicyCheckPayload(payload) {
   console.log(`Defaulted: ${payload.defaulted ? "yes" : "no"}`);
   console.log(`Package-backed generators: ${payload.bindings.length}`);
   for (const binding of payload.bindings) {
-    console.log(`- ${binding.componentId}: ${binding.generatorId}@${binding.version} via ${binding.packageName}`);
+    console.log(`- ${binding.runtimeId}: ${binding.generatorId}@${binding.version} via ${binding.packageName}`);
     console.log(`  npm package: ${binding.packageInfo.installedVersion || "(not installed)"}`);
     if (binding.packageInfo.dependencySpec) {
       console.log(`  dependency: ${binding.packageInfo.dependencyField} ${binding.packageInfo.dependencySpec}`);
@@ -2066,7 +2066,7 @@ function printGeneratorPolicyStatusPayload(payload) {
     console.log("Generator packages:");
   }
   for (const binding of payload.bindings) {
-    console.log(`- ${binding.componentId}: ${binding.generatorId}@${binding.version} via ${binding.packageName}`);
+    console.log(`- ${binding.runtimeId}: ${binding.generatorId}@${binding.version} via ${binding.packageName}`);
     console.log(`  allowed: ${binding.allowed ? "yes" : "no"}`);
     console.log(`  npm package: ${binding.packageInfo.installedVersion || "(not installed)"}`);
     console.log(`  dependency: ${binding.packageInfo.dependencyField && binding.packageInfo.dependencySpec ? `${binding.packageInfo.dependencyField} ${binding.packageInfo.dependencySpec}` : "(not declared)"}`);
@@ -2107,7 +2107,7 @@ function printGeneratorPolicyExplainPayload(payload) {
     console.log("");
     console.log("Package-backed generators:");
     for (const binding of payload.bindings) {
-      console.log(`- ${binding.componentId}: ${binding.generatorId}@${binding.version} via ${binding.packageName}`);
+      console.log(`- ${binding.runtimeId}: ${binding.generatorId}@${binding.version} via ${binding.packageName}`);
       console.log(`  npm package: ${binding.packageInfo.installedVersion || "(not installed)"}`);
       if (binding.packageInfo.dependencySpec) {
         console.log(`  dependency: ${binding.packageInfo.dependencyField} ${binding.packageInfo.dependencySpec}`);
@@ -2944,10 +2944,15 @@ function printReleaseStatus(payload) {
  * @returns {string}
  */
 function renderReleaseStatusMarkdown(payload) {
+  const matrix = buildReleaseMatrixCatalogPayload();
+  const catalogConsumer = payload.consumers.find((consumer) => consumer.name === "topograms");
+  const demoConsumer = payload.consumers.find((consumer) => consumer.name === "topogram-demo-todo");
   const lines = [
-    `# Topogram CLI release ${payload.localVersion}`,
+    "# Known-Good Release Matrix",
     "",
-    `Date checked: ${new Date().toISOString().slice(0, 10)}`,
+    "This matrix is generated by `topogram release status --strict --write-report`.",
+    `Date checked: ${new Date().toISOString().slice(0, 10)}.`,
+    "Treat it as a dated release audit, not a floating compatibility promise.",
     "",
     "## Summary",
     "",
@@ -2957,12 +2962,48 @@ function renderReleaseStatusMarkdown(payload) {
     `- Consumer pins: ${payload.consumerPins.matching}/${payload.consumerPins.known} matching`,
     `- Consumer CI: ${payload.consumerCi.passing}/${payload.consumerCi.checked} passing`,
     `- Strict status: ${payload.ok ? "passed" : "failed"}`,
+    "",
+    "## Core",
+    "",
+    "| Package or Repo | Version or Commit | Verification |",
+    "| --- | --- | --- |",
+    `| \`${payload.packageName}\` | \`${payload.localVersion}\` | Publish CLI Package, strict release status, fresh npmjs smoke, and installed CLI smoke passed |`,
+    `| \`attebury/topograms\` catalog | \`${releaseMatrixConsumerCommit(catalogConsumer)}\` | ${releaseMatrixConsumerVerification(catalogConsumer, "Catalog Verification", payload.localVersion)} |`,
+    `| \`topogram-demo-todo\` | \`${releaseMatrixConsumerCommit(demoConsumer)}\` | ${releaseMatrixConsumerVerification(demoConsumer, "Demo Verification", payload.localVersion)} |`,
+    "",
+    "## Catalog Entries",
+    "",
+    "| Catalog ID | Kind | Package | Version | Stack |",
+    "| --- | --- | --- | --- | --- |"
+  ];
+  if (matrix.entries.length > 0) {
+    for (const entry of matrix.entries) {
+      lines.push(`| \`${entry.id}\` | ${entry.kind} | \`${entry.package}\` | \`${entry.defaultVersion}\` | ${escapeMarkdownTableCell(entry.stack || "not declared")} |`);
+    }
+  } else {
+    lines.push("| unavailable | unavailable | unavailable | unavailable | Catalog could not be loaded for this report |");
+  }
+  lines.push(
+    "",
+    "## Generator Packages",
+    "",
+    "| Generator Package | Surface | Catalog usage |",
+    "| --- | --- | --- |"
+  );
+  if (matrix.generators.length > 0) {
+    for (const generator of matrix.generators) {
+      lines.push(`| \`${generator.package}\` | ${escapeMarkdownTableCell(generator.surface)} | ${escapeMarkdownTableCell(generator.catalogIds.join(", "))} |`);
+    }
+  } else {
+    lines.push("| unavailable | unavailable | Catalog generator metadata could not be loaded for this report |");
+  }
+  lines.push(
     "",
     "## Consumers",
     "",
     "| Repo | Pin | Workflow | Status | Run |",
     "| --- | --- | --- | --- | --- |"
-  ];
+  );
   for (const consumer of payload.consumers) {
     const workflow = consumer.workflow || consumer.ci?.expectedWorkflow || "";
     const run = consumer.ci?.run;
@@ -2970,6 +3011,32 @@ function renderReleaseStatusMarkdown(payload) {
     const url = run?.url ? `[${run.databaseId || "run"}](${run.url})` : "";
     lines.push(`| \`${consumer.name}\` | \`${consumer.version || "missing"}\` | ${escapeMarkdownTableCell(workflow)} | ${escapeMarkdownTableCell(status)} | ${url} |`);
   }
+  lines.push(
+    "",
+    "## Consumer Proofs",
+    "",
+    "The external Todo demo is the canonical end-to-end consumer proof for the current catalog-backed workflow:",
+    "",
+    "```bash",
+    "topogram new ./todo-demo --template todo",
+    "cd ./todo-demo",
+    "npm install",
+    "npm run check",
+    "npm run generate",
+    "npm run app:compile",
+    "npm run verify",
+    "npm run app:runtime",
+    "```",
+    "",
+    "The demo CI also verifies `topogram new` from the default public catalog and from the repo-local catalog fixture. That prevents local fixtures from masking a broken published catalog alias."
+  );
+  const reportDiagnostics = [...matrix.diagnostics];
+  if (reportDiagnostics.length > 0) {
+    lines.push("", "## Report Diagnostics", "");
+    for (const diagnostic of reportDiagnostics) {
+      lines.push(`- **${diagnostic.severity || "warning"}** \`${diagnostic.code || "release_report_catalog_unavailable"}\`: ${diagnostic.message}`);
+    }
+  }
   if (payload.diagnostics.length > 0) {
     lines.push("", "## Diagnostics", "");
     for (const diagnostic of payload.diagnostics) {
@@ -2987,6 +3054,92 @@ function renderReleaseStatusMarkdown(payload) {
   return `${lines.join("\n")}\n`;
 }
 
+/**
+ * @returns {{ entries: any[], generators: Array<{ package: string, surface: string, catalogIds: string[] }>, diagnostics: Array<Record<string, any>> }}
+ */
+function buildReleaseMatrixCatalogPayload() {
+  try {
+    const loaded = loadCatalog(null);
+    const entries = [...loaded.catalog.entries].sort((left, right) => {
+      if (left.kind !== right.kind) {
+        return left.kind === "template" ? -1 : 1;
+      }
+      return left.id.localeCompare(right.id);
+    });
+    const generatorMap = new Map();
+    for (const entry of entries) {
+      for (const packageName of Array.isArray(entry.generators) ? entry.generators : []) {
+        if (!generatorMap.has(packageName)) {
+          generatorMap.set(packageName, {
+            package: packageName,
+            surface: releaseMatrixGeneratorSurface(packageName),
+            catalogIds: []
+          });
+        }
+        generatorMap.get(packageName).catalogIds.push(entry.id);
+      }
+    }
+    const generators = [...generatorMap.values()].sort((left, right) => left.package.localeCompare(right.package));
+    return {
+      entries,
+      generators,
+      diagnostics: loaded.diagnostics || []
+    };
+  } catch (error) {
+    return {
+      entries: [],
+      generators: [],
+      diagnostics: [{
+        code: "release_report_catalog_unavailable",
+        severity: "warning",
+        message: messageFromError(error)
+      }]
+    };
+  }
+}
+
+/**
+ * @param {string} packageName
+ * @returns {string}
+ */
+function releaseMatrixGeneratorSurface(packageName) {
+  if (packageName.includes("-web")) return "web";
+  if (packageName.includes("-api")) return "api";
+  if (packageName.includes("-db")) return "database";
+  if (packageName.includes("-native")) return "native";
+  return "not declared";
+}
+
+/**
+ * @param {any} consumer
+ * @returns {string}
+ */
+function releaseMatrixConsumerCommit(consumer) {
+  return shortSha(consumer?.ci?.headSha || consumer?.ci?.run?.headSha || null) || "unknown";
+}
+
+/**
+ * @param {any} consumer
+ * @param {string} workflowName
+ * @param {string} version
+ * @returns {string}
+ */
+function releaseMatrixConsumerVerification(consumer, workflowName, version) {
+  const status = consumer?.ci?.run
+    ? `${consumer.ci.run.status || "unknown"}/${consumer.ci.run.conclusion || "unknown"}`
+    : "not checked";
+  return `${workflowName}: ${status}; pinned ${CLI_PACKAGE_NAME}@${version}`;
+}
+
+/**
+ * @param {string|null|undefined} value
+ * @returns {string|null}
+ */
+function shortSha(value) {
+  const text = String(value || "").trim();
+  return text ? text.slice(0, 7) : null;
+}
+
 /**
  * @param {string|null|undefined} value
  * @returns {string}
@@ -5533,7 +5686,7 @@ function importCandidateCounts(summary) {
     apiRoutes: candidates.api?.routes?.length || 0,
     uiScreens: candidates.ui?.screens?.length || 0,
     uiRoutes: candidates.ui?.routes?.length || 0,
-    uiComponents: candidates.ui?.components?.length || 0,
+    uiWidgets: candidates.ui?.widgets?.length || candidates.ui?.components?.length || 0,
     workflows: candidates.workflows?.workflows?.length || 0,
     verifications: candidates.verification?.verifications?.length || 0
   };

package/src/generator/adapters.js

@@ -41,7 +41,7 @@ import { generateVanillaWebApp } from "./surfaces/web/vanilla.js";
  * @property {Record<string, any>} graph
  * @property {Record<string, any>} projection
  * @property {Record<string, any>} runtime
- * @property {Record<string, any>} component Internal runtime alias.
+ * @property {Record<string, any>} [component] Legacy runtime alias for existing generator packages.
  * @property {Record<string, any>|null} [topology]
  * @property {Record<string, any>} [contracts]
  * @property {Record<string, any>|null} [implementation]
@@ -88,7 +88,23 @@ function requiredManifest(generatorId) {
  * @returns {string}
  */
 function runtimeFor(context) {
-  return context.runtime || context.component || {};
+  return normalizeRuntimeForGenerator(context.runtime || context.component || {});
+}
+
+/**
+ * Keep package-backed generator context canonical while preserving aliases for already-published adapters.
+ *
+ * @param {Record<string, any>} runtime
+ * @returns {Record<string, any>}
+ */
+function normalizeRuntimeForGenerator(runtime) {
+  const apiRuntime = runtime.apiRuntime || runtime.apiComponent || null;
+  const databaseRuntime = runtime.databaseRuntime || runtime.databaseComponent || null;
+  return {
+    ...runtime,
+    ...(apiRuntime ? { apiRuntime, apiComponent: apiRuntime } : {}),
+    ...(databaseRuntime ? { databaseRuntime, databaseComponent: databaseRuntime } : {})
+  };
 }
 
 /**
@@ -108,7 +124,7 @@ function projectionIdFor(context) {
 function serverOptions(context, profile) {
   const projectionId = projectionIdFor(context);
   const runtime = runtimeFor(context);
-  const dbProjectionId = runtime.databaseComponent?.projection?.id || context.options?.dbProjectionId;
+  const dbProjectionId = runtime.databaseRuntime?.projection?.id || runtime.databaseComponent?.projection?.id || context.options?.dbProjectionId;
   return {
     ...(context.options || {}),
     projectionId,
@@ -178,7 +194,7 @@ export const BUNDLED_GENERATOR_ADAPTERS = [
     manifest: requiredManifest("topogram/hono"),
     generate(context) {
       const runtime = runtimeFor(context);
-      if (runtime && !runtime.databaseComponent) {
+      if (runtime && !runtime.databaseRuntime) {
         return fileResult(generateStatelessServer(context.graph, serverOptions(context, "hono")));
       }
       return fileResult(generateHonoServer(context.graph, serverOptions(context, "hono")));
@@ -188,7 +204,7 @@ export const BUNDLED_GENERATOR_ADAPTERS = [
     manifest: requiredManifest("topogram/express"),
     generate(context) {
       const runtime = runtimeFor(context);
-      if (runtime && !runtime.databaseComponent) {
+      if (runtime && !runtime.databaseRuntime) {
         return fileResult(generateStatelessServer(context.graph, serverOptions(context, "express")));
       }
       return fileResult(generateExpressServer(context.graph, serverOptions(context, "express")));
@@ -277,8 +293,8 @@ function loadPackageGeneratorAdapter(manifest, runtime, options = {}) {
   const diagnostics = generatorPolicyDiagnosticsForBindings(
     loadGeneratorPolicy(rootDir),
     [{
-      componentId: String(runtime?.id || "unknown"),
-      componentType: String(runtime?.kind || runtime?.type || manifest.surface || "unknown"),
+      runtimeId: String(runtime?.id || "unknown"),
+      runtimeKind: String(runtime?.kind || runtime?.type || manifest.surface || "unknown"),
       projection: String(runtime?.projection?.id || runtime?.projection || "unknown"),
       generatorId: String(runtime?.generator?.id || manifest.id),
       version: String(runtime?.generator?.version || manifest.version),