@topogram/cli 0.3.48 → 0.3.50

package/CHANGELOG.md

@@ -53,11 +53,12 @@
 ## 0.3.11 - 2026-05-01
 
 - Add `domain` statement kind for grouping the spec by business slice
-  (FIS, RNF, DrugTrac, etc.). Identifier prefix `dom_`. Required fields:
-  `name`, `description`, `status`. Optional: `in_scope`, `out_of_scope`,
-  `owners`, `parent_domain`, `aliases`. Validator enforces identifier
-  prefix, scope-list shapes, owner refs (`actor`|`role`), parent_domain
-  refs, and parent-domain cycle detection.
+  (order fulfillment, billing, support, reporting, etc.). Identifier
+  prefix `dom_`. Required fields: `name`, `description`, `status`.
+  Optional: `in_scope`, `out_of_scope`, `owners`, `parent_domain`,
+  `aliases`. Validator enforces identifier prefix, scope-list shapes,
+  owner refs (`actor`|`role`), parent_domain refs, and parent-domain
+  cycle detection.
 - Add optional singular `domain` field on `capability`, `entity`, `rule`,
   `verification`, `orchestration`, `operation`, and `decision`. Cross-kind
   validator hard-errors on unknown ids and wrong-kind references.
@@ -83,9 +84,9 @@
   with the `domain` row and the optional-field paragraph;
   `docs/topogram-workspace-layout.md` appends a "Domain organization"
   subsection.
-- New fixture `engine/tests/fixtures/domains/feedlot/` (3 domains,
-  10 capabilities, 12 entities, 4 cross-platform projections) and
-  golden tests at `engine/tests/active/domain-kind.test.js`.
+- New multi-domain fixture (3 domains, 10 capabilities, 12 entities, 4
+  cross-platform projections) and golden tests at
+  `engine/tests/active/domain-kind.test.js`.
 
 ### SDLC layer (Phase 2)
 

package/README.md

@@ -6,7 +6,7 @@ The active product workflow is authoring-to-generated-app. Engine development sh
 
 ## Package Shape
 
-The engine is the publishable private CLI package:
+The engine is the publishable CLI package:
 
 ```json
 {
@@ -17,7 +17,7 @@ The engine is the publishable private CLI package:
 }
 ```
 
-This lets source checkouts and private-package consumers call:
+This lets source checkouts and package consumers call:
 
 ```bash
 topogram new ../my-app
@@ -111,7 +111,7 @@ topogram new ../todo-demo --template @topogram/template-todo
 topogram new ../todo-demo --template todo
 ```
 
-Catalog aliases resolve through the private catalog index at
+Catalog aliases resolve through the public catalog index at
 `github:attebury/topograms/topograms.catalog.json`. The catalog is package
 backed; executable starter content still lives in template packages. Use
 `topogram catalog show <id>` to inspect an entry and get the correct `new` or
@@ -131,7 +131,7 @@ template update metadata while keeping normal check/generate behavior.
 Do not create generated projects under `engine/`. The CLI refuses paths inside the engine directory.
 
 Template pack authoring and trust policy are documented in `../docs/template-authoring.md`.
-Catalog layout and private access are documented in `../docs/catalog.md`.
+Catalog layout and optional private-source access are documented in `../docs/catalog.md`.
 Projects created from executable templates include `.topogram-template-trust.json`;
 regenerate it with `topogram trust template` after reviewing copied
 `implementation/` code. Use `topogram template status` for the lifecycle

package/package.json

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

package/src/generator/context/slice.js

@@ -194,6 +194,7 @@ function projectionSlice(graph, projectionId) {
     verification_targets: recommendedVerificationTargets(graph, [projectionId, ...capabilities, ...entities, ...shapes, ...components], {
       rationale: "Projection slices affect generated contract and runtime surfaces, so verification should follow the projection closure."
     }),
+    ui_agent_packet: uiAgentPacketForProjection(graph, projection),
     write_scope: buildDefaultWriteScope(),
     review_boundary: projection.reviewBoundary || {
       automation_class: "review_required",
@@ -286,6 +287,7 @@ function componentSlice(graph, componentId) {
     verification_targets: recommendedVerificationTargets(graph, verificationScope, {
       rationale: "Component changes affect every related projection — verification should follow the component contract closure."
     }),
+    ui_agent_packet: uiAgentPacketForComponent(graph, component, projections),
     write_scope: buildDefaultWriteScope(),
     review_boundary: {
       automation_class: "review_required",
@@ -331,6 +333,135 @@ function componentDependencyKind(dependency) {
   return prefix || null;
 }
 
+function uiAgentPacketForProjection(graph, projection) {
+  if (!String(projection.platform || "").startsWith("ui_")) {
+    return null;
+  }
+  const sharedProjection = projection.platform === "ui_shared"
+    ? projection
+    : sharedUiProjectionFor(graph, projection);
+  const ownerProjection = sharedProjection || projection;
+  return {
+    type: "ui_agent_packet",
+    version: 1,
+    ownership: {
+      componentPlacement: "ui_shared",
+      designIntent: "ui_shared",
+      concreteSurfaceOwns: ["routes", "surface_hints"]
+    },
+    sharedProjection: sharedProjection
+      ? {
+          id: sharedProjection.id,
+          name: sharedProjection.name || sharedProjection.id
+        }
+      : null,
+    screens: (ownerProjection.uiScreens || []).map((screen) => ({
+      id: screen.id,
+      kind: screen.kind,
+      title: screen.title || screen.id
+    })),
+    routes: (projection.uiRoutes || []).map((route) => ({
+      screenId: route.screenId,
+      path: route.path
+    })),
+    components: (ownerProjection.uiComponents || []).map((usage) => componentUsagePacket(usage)),
+    design: designIntentPacket(ownerProjection),
+    requiredGates: uiRequiredGates(projection.id)
+  };
+}
+
+function uiAgentPacketForComponent(graph, component, 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 !== component.id) continue;
+      sourceUsages.push({
+        projection: {
+          id: projection.id,
+          platform: projection.platform,
+          ownership: projection.platform === "ui_shared" ? "owner" : "concrete"
+        },
+        usage: componentUsagePacket(usage),
+        design: designIntentPacket(projection)
+      });
+      projectionSet.add(projection.id);
+    }
+  }
+
+  return {
+    type: "ui_agent_packet",
+    version: 1,
+    ownership: {
+      componentContract: "component",
+      componentPlacement: "ui_shared",
+      concreteSurfacesInherit: true
+    },
+    component: {
+      id: component.id,
+      name: component.name || component.id,
+      category: component.category || null,
+      patterns: component.componentContract?.patterns || [],
+      regions: component.componentContract?.regions || [],
+      behaviors: component.componentContract?.behaviors || []
+    },
+    sourceUsages,
+    inheritedBy: [...projectionSet]
+      .filter((projectionId) => !sourceUsages.some((entry) => entry.projection.id === projectionId))
+      .sort(),
+    requiredGates: uiRequiredGates(null, component.id)
+  };
+}
+
+function sharedUiProjectionFor(graph, projection) {
+  for (const reference of projection.realizes || []) {
+    const candidate = (graph.byKind.projection || []).find((entry) => entry.id === reference.id);
+    if (candidate?.platform === "ui_shared") {
+      return candidate;
+    }
+  }
+  return null;
+}
+
+function componentUsagePacket(usage) {
+  return {
+    screenId: usage.screenId || null,
+    region: usage.region || null,
+    componentId: usage.component?.id || null,
+    dataBindings: (usage.dataBindings || []).map((binding) => ({
+      prop: binding.prop || null,
+      source: binding.source?.id || binding.source || null
+    })),
+    eventBindings: (usage.eventBindings || []).map((binding) => ({
+      event: binding.event || null,
+      action: binding.action || null,
+      target: binding.target?.id || binding.target || null
+    }))
+  };
+}
+
+function designIntentPacket(projection) {
+  return (projection.uiDesign || []).map((entry) => ({
+    key: entry.key,
+    role: entry.role,
+    value: entry.value
+  }));
+}
+
+function uiRequiredGates(projectionId = null, componentId = null) {
+  return [
+    { command: "topogram check", reason: "Validate shared UI ownership, taxonomy, references, and topology." },
+    {
+      command: `topogram component check${projectionId ? ` --projection ${projectionId}` : ""}${componentId ? ` --component ${componentId}` : ""}`,
+      reason: "Validate component placement, props, events, regions, and patterns."
+    },
+    {
+      command: `topogram component behavior${projectionId ? ` --projection ${projectionId}` : ""}${componentId ? ` --component ${componentId}` : ""}`,
+      reason: "Inspect behavior realizations and partial bindings before code changes."
+    }
+  ];
+}
+
 function journeySlice(graph, journeyId) {
   const journey = getJourneyDoc(graph, journeyId);
   const capabilities = [...(journey.relatedCapabilities || [])].sort();

package/src/generator/registry.js

@@ -3,6 +3,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { createRequire } from "node:module";
+import { UI_GENERATOR_RENDERED_COMPONENT_PATTERNS } from "../ui/taxonomy.js";
 
 /**
  * @typedef {Object} GeneratorManifest
@@ -23,6 +24,8 @@ import { createRequire } from "node:module";
  * @property {boolean} [planned]
  */
 
+const RENDERED_COMPONENT_PATTERNS = [...UI_GENERATOR_RENDERED_COMPONENT_PATTERNS];
+
 /** @type {GeneratorManifest[]} */
 export const GENERATOR_MANIFESTS = [
   {
@@ -60,7 +63,7 @@ export const GENERATOR_MANIFESTS = [
     inputs: ["ui-web-contract"],
     outputs: ["web-app", "generation-coverage"],
     stack: { runtime: "browser", framework: "vanilla", language: "javascript" },
-    capabilities: { routes: true, components: false, coverage: false },
+    capabilities: { routes: true, components: false, coverage: true },
     componentSupport: { patterns: [], behaviors: [], unsupported: "contract-only" },
     source: "bundled",
     profile: "vanilla"
@@ -76,7 +79,7 @@ export const GENERATOR_MANIFESTS = [
     stack: { runtime: "node", framework: "sveltekit", language: "typescript" },
     capabilities: { routes: true, components: true, coverage: true },
     componentSupport: {
-      patterns: ["summary_stats", "board_view", "calendar_view", "resource_table", "data_grid_view"],
+      patterns: RENDERED_COMPONENT_PATTERNS,
       behaviors: ["selection", "sorting", "filtering", "search", "pagination", "bulk_action", "optimistic_update"],
       unsupported: "warning"
     },
@@ -94,7 +97,7 @@ export const GENERATOR_MANIFESTS = [
     stack: { runtime: "browser", framework: "react", language: "typescript" },
     capabilities: { routes: true, components: true, coverage: true },
     componentSupport: {
-      patterns: ["summary_stats", "board_view", "calendar_view", "resource_table", "data_grid_view"],
+      patterns: RENDERED_COMPONENT_PATTERNS,
       behaviors: ["selection", "sorting", "filtering", "search", "pagination", "bulk_action", "optimistic_update"],
       unsupported: "warning"
     },

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

@@ -17,6 +17,7 @@ import {
   buildVerificationSummary,
   getDefaultEnvironmentProjections,
   resolveRuntimeTopology,
+  runtimeDemoUserId,
   runtimePorts,
   runtimeUrls
 } from "./shared.js";
@@ -104,7 +105,7 @@ function buildAppBundlePlan(graph, options = {}) {
 }
 
 function renderAppBundleEnvExample(plan) {
-  const demo = plan.runtimeReference.demoEnv;
+  const demoUserId = runtimeDemoUserId(plan.runtimeReference);
   const databaseName = plan.runtimeReference.environment.databaseName || "topogram_app";
   const topology = {
     primaryApi: { port: plan.topology.components.find((component) => component.type === "api")?.port },
@@ -118,8 +119,8 @@ TOPOGRAM_ENVIRONMENT_PROFILE=${plan.profiles.environment}
 TOPOGRAM_DEPLOY_PROFILE=${plan.profiles.deployment}
 
 # Local runtime defaults
-${plan.projections.api ? `SERVER_PORT=${ports.server}\n` : ""}${plan.projections.ui ? `WEB_PORT=${ports.web}\n` : ""}${plan.projections.api && plan.projections.ui ? `PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}\n` : ""}PUBLIC_TOPOGRAM_DEMO_USER_ID=${demo.userId}
-TOPOGRAM_DEMO_USER_ID=${demo.userId}
+${plan.projections.api ? `SERVER_PORT=${ports.server}\n` : ""}${plan.projections.ui ? `WEB_PORT=${ports.web}\n` : ""}${plan.projections.api && plan.projections.ui ? `PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}\n` : ""}PUBLIC_TOPOGRAM_DEMO_USER_ID=${demoUserId}
+TOPOGRAM_DEMO_USER_ID=${demoUserId}
 ${plan.runtimeReference.environment.envExample || ""}
 
 # Smoke-test defaults
@@ -135,8 +136,8 @@ SERVER_PORT=${ports.server}
 WEB_PORT=${ports.web}
 DATABASE_URL=file:./var/${databaseName}.sqlite
 PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}
-PUBLIC_TOPOGRAM_DEMO_USER_ID=${demo.userId}
-TOPOGRAM_DEMO_USER_ID=${demo.userId}
+PUBLIC_TOPOGRAM_DEMO_USER_ID=${demoUserId}
+TOPOGRAM_DEMO_USER_ID=${demoUserId}
 ${plan.runtimeReference.environment.envExample || ""}
 TOPOGRAM_SEED_DEMO=true
 
@@ -159,8 +160,8 @@ POSTGRES_PASSWORD=postgres
 DATABASE_URL=postgresql://\${POSTGRES_USER}@localhost:5432/${databaseName}
 DATABASE_ADMIN_URL=postgresql://\${POSTGRES_USER}@localhost:5432/postgres
 PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}
-PUBLIC_TOPOGRAM_DEMO_USER_ID=${demo.userId}
-TOPOGRAM_DEMO_USER_ID=${demo.userId}
+PUBLIC_TOPOGRAM_DEMO_USER_ID=${demoUserId}
+TOPOGRAM_DEMO_USER_ID=${demoUserId}
 ${plan.runtimeReference.environment.envExample || ""}
 TOPOGRAM_SEED_DEMO=true
 

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

@@ -3,6 +3,7 @@ import {
   generateWebBundle,
   getDefaultEnvironmentProjections,
   resolveRuntimeTopology,
+  runtimeDemoUserId,
   runtimeUrls
 } from "./shared.js";
 import { getExampleImplementation } from "../../example-implementation.js";
@@ -75,13 +76,13 @@ function renderCompileCheckEnvExample(graph, options = {}) {
   if (dbProjection?.platform === "db_sqlite") {
     return `DATABASE_URL=./var/${runtimeReference.environment.databaseName || "topogram_app"}.sqlite
 PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}
-PUBLIC_TOPOGRAM_DEMO_USER_ID=${runtimeReference.demoEnv.userId}
+PUBLIC_TOPOGRAM_DEMO_USER_ID=${runtimeDemoUserId(runtimeReference)}
 ${runtimeReference.environment.envExample || ""}
 `;
   }
   return `DATABASE_URL=postgresql://postgres:postgres@localhost:5432/${runtimeReference.environment.databaseName || "topogram_app"}?schema=public
 PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}
-PUBLIC_TOPOGRAM_DEMO_USER_ID=${runtimeReference.demoEnv.userId}
+PUBLIC_TOPOGRAM_DEMO_USER_ID=${runtimeDemoUserId(runtimeReference)}
 ${runtimeReference.environment.envExample || ""}
 `;
 }

package/src/generator/runtime/environment.js

@@ -7,6 +7,7 @@ import {
   dbEnvVarsForComponent,
   getDefaultEnvironmentProjections,
   resolveRuntimeTopology,
+  runtimeDemoUserId,
   runtimePorts,
   runtimeUrls
 } from "./shared.js";
@@ -158,7 +159,7 @@ function buildEnvironmentPlan(graph, options = {}) {
 }
 
 function renderEnvironmentEnvExample(plan) {
-  const demo = plan.runtimeReference.demoEnv;
+  const demoUserId = runtimeDemoUserId(plan.runtimeReference);
   const databaseName = plan.runtimeReference.environment.databaseName || "topogram_app";
   const urls = runtimeUrls(plan.runtimeReference, {
     primaryApi: { port: plan.ports.server },
@@ -184,8 +185,8 @@ function renderEnvironmentEnvExample(plan) {
 TOPOGRAM_ENVIRONMENT_PROFILE=${plan.environment.profile}
 
 # Local stack ports
-${plan.components.apis.length ? `SERVER_PORT=${plan.ports.server}\n` : ""}${plan.components.webs.length ? `WEB_PORT=${plan.ports.web}\n` : ""}${plan.components.webs.length && plan.components.apis.length ? `PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}\n` : ""}${plan.components.webs.length ? `TOPOGRAM_CORS_ORIGINS=${urls.web},http://127.0.0.1:${plan.ports.web}\n` : ""}PUBLIC_TOPOGRAM_DEMO_USER_ID=${demo.userId}
-TOPOGRAM_DEMO_USER_ID=${demo.userId}
+${plan.components.apis.length ? `SERVER_PORT=${plan.ports.server}\n` : ""}${plan.components.webs.length ? `WEB_PORT=${plan.ports.web}\n` : ""}${plan.components.webs.length && plan.components.apis.length ? `PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}\n` : ""}${plan.components.webs.length ? `TOPOGRAM_CORS_ORIGINS=${urls.web},http://127.0.0.1:${plan.ports.web}\n` : ""}PUBLIC_TOPOGRAM_DEMO_USER_ID=${demoUserId}
+TOPOGRAM_DEMO_USER_ID=${demoUserId}
 ${plan.runtimeReference.environment.envExample || ""}
 TOPOGRAM_SEED_DEMO=true
 `;
@@ -204,8 +205,8 @@ WEB_PORT=${plan.ports.web}
 DATABASE_URL=file:./var/${databaseName}.sqlite
 ${extraDatabaseLines ? `${extraDatabaseLines}\n` : ""}PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}
 TOPOGRAM_CORS_ORIGINS=${urls.web},http://127.0.0.1:${plan.ports.web}
-PUBLIC_TOPOGRAM_DEMO_USER_ID=${demo.userId}
-TOPOGRAM_DEMO_USER_ID=${demo.userId}
+PUBLIC_TOPOGRAM_DEMO_USER_ID=${demoUserId}
+TOPOGRAM_DEMO_USER_ID=${demoUserId}
 ${plan.runtimeReference.environment.envExample || ""}
 TOPOGRAM_SEED_DEMO=true
 `;
@@ -229,8 +230,8 @@ DATABASE_URL=postgresql://\${POSTGRES_USER}@localhost:${plan.ports.database || 5
 DATABASE_ADMIN_URL=postgresql://\${POSTGRES_USER}@localhost:${plan.ports.database || 5432}/postgres
 ${extraDatabaseLines ? `${extraDatabaseLines}\n` : ""}PUBLIC_TOPOGRAM_API_BASE_URL=${urls.api}
 TOPOGRAM_CORS_ORIGINS=${urls.web},http://127.0.0.1:${plan.ports.web}
-PUBLIC_TOPOGRAM_DEMO_USER_ID=${demo.userId}
-TOPOGRAM_DEMO_USER_ID=${demo.userId}
+PUBLIC_TOPOGRAM_DEMO_USER_ID=${demoUserId}
+TOPOGRAM_DEMO_USER_ID=${demoUserId}
 ${plan.runtimeReference.environment.envExample || ""}
 TOPOGRAM_SEED_DEMO=true
 `;

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

@@ -3,6 +3,7 @@ import {
   buildVerificationSummary,
   getDefaultEnvironmentProjections,
   resolveRuntimeTopology,
+  runtimeDemoUserId,
   selectChecksByVerification,
   runtimePorts,
   runtimeUrls
@@ -74,11 +75,10 @@ function buildRuntimeCheckPlan(graph, options = {}) {
 
 function renderRuntimeCheckEnvExample(graph, options = {}) {
   const runtimeReference = getExampleImplementation(graph, options).runtime.reference;
-  const demo = runtimeReference.demoEnv;
   const urls = runtimeUrls(runtimeReference, resolveRuntimeTopology(graph, options));
   return `TOPOGRAM_API_BASE_URL=${urls.api}
 TOPOGRAM_WEB_BASE_URL=${urls.web}
-TOPOGRAM_DEMO_USER_ID=${demo.userId}
+TOPOGRAM_DEMO_USER_ID=${runtimeDemoUserId(runtimeReference)}
 ${runtimeReference.environment.envExample || ""}
 `;
 }
@@ -166,9 +166,9 @@ function envValue(name) {
   const fallbackMap = {
     TOPOGRAM_API_BASE_URL: process.env.PUBLIC_TOPOGRAM_API_BASE_URL || "http://localhost:${ports.server}",
     TOPOGRAM_WEB_BASE_URL: process.env.PUBLIC_TOPOGRAM_WEB_BASE_URL || \`http://localhost:\${process.env.WEB_PORT || "${ports.web}"}\`,
-    ${runtimeReference.runtimeCheck.demoContainerEnvVar}: process.env.PUBLIC_TOPOGRAM_DEMO_CONTAINER_ID || process.env.PUBLIC_TOPOGRAM_DEMO_PROJECT_ID || "",
-    ${runtimeReference.runtimeCheck.demoPrimaryEnvVar}: process.env.PUBLIC_TOPOGRAM_DEMO_PRIMARY_ID || process.env.PUBLIC_TOPOGRAM_DEMO_TASK_ID || process.env.PUBLIC_TOPOGRAM_DEMO_ISSUE_ID || "",
-    TOPOGRAM_DEMO_USER_ID: process.env.PUBLIC_TOPOGRAM_DEMO_USER_ID || "",
+    ${runtimeReference.runtimeCheck.demoContainerEnvVar}: process.env.PUBLIC_TOPOGRAM_DEMO_CONTAINER_ID || "",
+    ${runtimeReference.runtimeCheck.demoPrimaryEnvVar}: process.env.PUBLIC_TOPOGRAM_DEMO_PRIMARY_ID || "",
+    TOPOGRAM_DEMO_USER_ID: process.env.PUBLIC_TOPOGRAM_AUTH_USER_ID || process.env.PUBLIC_TOPOGRAM_DEMO_USER_ID || "",
     TOPOGRAM_AUTH_USER_ID: process.env.TOPOGRAM_DEMO_USER_ID || ""
   };
 

package/src/generator/runtime/shared.js

@@ -513,3 +513,12 @@ export function runtimeUrls(runtimeReference, topology = null) {
     web: `http://localhost:${ports.web}`
   };
 }
+
+/**
+ * @param {Record<string, any>|null|undefined} runtimeReference
+ * @returns {string}
+ */
+export function runtimeDemoUserId(runtimeReference) {
+  const demo = runtimeReference?.demoEnv || {};
+  return demo.userId || demo.memberId || demo.ownerId || demo.primaryActorId || "";
+}

package/src/generator/runtime/smoke.js

@@ -2,6 +2,7 @@ import {
   buildVerificationSummary,
   getDefaultEnvironmentProjections,
   resolveRuntimeTopology,
+  runtimeDemoUserId,
   runtimeUrls,
   selectChecksByVerification
 } from "./shared.js";
@@ -126,7 +127,7 @@ process.on("unhandledRejection", reportFatal);
 const apiBase = process.env.TOPOGRAM_API_BASE_URL || "";
 const webBase = process.env.TOPOGRAM_WEB_BASE_URL || "";
 const demoContainerId = process.env.${runtimeReference.smoke.defaultContainerEnvVar} || "${runtimeReference.demoEnv.containerId}";
-const demoUserId = process.env.TOPOGRAM_DEMO_USER_ID || "${runtimeReference.demoEnv.userId}";
+const demoUserId = process.env.TOPOGRAM_AUTH_USER_ID || process.env.TOPOGRAM_DEMO_USER_ID || "${runtimeDemoUserId(runtimeReference)}";
 const authToken = process.env.TOPOGRAM_AUTH_TOKEN || "";
 
 if (!apiBase || !webBase) {

package/src/generator/surfaces/shared.js

@@ -38,7 +38,8 @@ export function uiProjectionCandidates(graph) {
       (projection.uiAppShell || []).length > 0 ||
       (projection.uiNavigation || []).length > 0 ||
       (projection.uiScreenRegions || []).length > 0 ||
-      (projection.uiComponents || []).length > 0
+      (projection.uiComponents || []).length > 0 ||
+      (projection.uiDesign || []).length > 0
   );
 }