@topogram/cli 0.3.75 → 0.3.77

package/src/import/extractors/ui/swiftui.js

@@ -3,6 +3,7 @@ import {
   dedupeCandidateRecords,
   findImportFiles,
   idHintify,
+  isPrimaryImportSource,
   makeCandidateRecord,
   relativeTo,
   titleCase
@@ -117,7 +118,7 @@ export const swiftUiExtractor = {
   id: "ui.swiftui",
   track: "ui",
   detect(context) {
-    const files = findImportFiles(context.paths, (filePath) => /\.swift$/i.test(filePath))
+    const files = findImportFiles(context.paths, (filePath) => /\.swift$/i.test(filePath) && isPrimaryImportSource(context.paths, filePath))
       .filter((filePath) => /:\s*View\b/.test(context.helpers.readTextIfExists(filePath) || ""));
     return {
       score: files.length > 0 ? 84 : 0,
@@ -125,7 +126,7 @@ export const swiftUiExtractor = {
     };
   },
   extract(context) {
-    const files = findImportFiles(context.paths, (filePath) => /\.swift$/i.test(filePath))
+    const files = findImportFiles(context.paths, (filePath) => /\.swift$/i.test(filePath) && isPrimaryImportSource(context.paths, filePath))
       .filter((filePath) => /:\s*View\b/.test(context.helpers.readTextIfExists(filePath) || ""));
     const findings = [];
     const candidates = { screens: [], routes: [], actions: [], stacks: [] };

package/src/workflows/reconcile/bundle-core/index.js

@@ -39,6 +39,7 @@ export function getOrCreateCandidateBundle(bundles, conceptId, label) {
       screens: [],
       uiRoutes: [],
       uiActions: [],
+      uiFlows: [],
       workflows: [],
       verifications: [],
       workflowStates: [],
@@ -337,6 +338,7 @@ export function renderCandidateBundleReadme(bundle, proposalSurfaces = []) {
     `Screens: ${bundle.screens.length}`,
     `UI routes: ${bundle.uiRoutes.length}`,
     `UI actions: ${bundle.uiActions.length}`,
+    `UI flows: ${(bundle.uiFlows || []).length}`,
     `Workflows: ${bundle.workflows.length}`,
     `Verifications: ${bundle.verifications.length}`,
     `Workflow states: ${bundle.workflowStates.length}`,
@@ -455,6 +457,16 @@ export function renderCandidateBundleReadme(bundle, proposalSurfaces = []) {
         lines.push(`    - label ${candidate.label}`);
         lines.push(`    - kind ${candidate.kind}`);
         lines.push(`    - why matched ${candidate.match_reasons.length ? candidate.match_reasons.join("; ") : "dependency overlap with maintained seam evidence"}`);
+        lines.push(`    - missing decisions ${(candidate.missing_decisions || []).length ? candidate.missing_decisions.join("; ") : "none"}`);
+        lines.push(`    - project config target \`${candidate.project_config_target?.path || "topology.runtimes[].migration"}\``);
+        lines.push(`    - evidence ${(candidate.evidence || []).slice(0, 3).map((/** @type {string} */ item) => `\`${item}\``).join(", ") || "_none_"}`);
+        lines.push("    - proposed runtime migration");
+        lines.push("      ```json");
+        lines.push(`      ${JSON.stringify(candidate.proposed_runtime_migration || {}, null, 2).replace(/\n/g, "\n      ")}`);
+        lines.push("      ```");
+        for (const step of candidate.manual_next_steps || []) {
+          lines.push(`    - manual next: ${step}`);
+        }
       }
     }
   }
@@ -554,6 +566,13 @@ export function renderCandidateBundleReadme(bundle, proposalSurfaces = []) {
       lines.push(`- \`${entry.id_hint}\` ${entry.screen_kind} at \`${entry.route_path}\``);
     }
   }
+  if ((bundle.uiFlows || []).length > 0) {
+    lines.push("", "## UI Flow Evidence", "");
+    for (const entry of bundle.uiFlows) {
+      lines.push(`- \`${entry.id_hint}\` ${entry.flow_type || "flow"} routes ${(entry.route_paths || []).map((/** @type {string} */ item) => `\`${item}\``).join(", ") || "_none_"}`);
+      lines.push(`  - missing decisions ${(entry.missing_decisions || []).length ? entry.missing_decisions.join("; ") : "none"}`);
+    }
+  }
   if (bundle.workflows.length > 0) {
     lines.push("", "## Workflow Evidence", "");
     for (const entry of bundle.workflows) {
@@ -578,7 +597,7 @@ export function renderMaintainedSeamCandidatesInline(bundle) {
   return entries
     .map((/** @type {any} */ surface) => {
       const seams = (surface.maintained_seam_candidates || [])
-        .map((/** @type {any} */ candidate) => `\`${candidate.seam_id}\` (${candidate.status}, ${candidate.ownership_class}, confidence=${candidate.confidence})`)
+        .map((/** @type {any} */ candidate) => `\`${candidate.seam_id}\` (${candidate.status}, ${candidate.ownership_class}, confidence=${candidate.confidence}, missing decisions=${(candidate.missing_decisions || []).length})`)
         .join(", ");
       return `${surface.id}: ${seams}`;
     })

package/src/workflows/reconcile/candidate-model.js

@@ -22,6 +22,7 @@ import {
   renderCandidateEntity,
   renderCandidateEnum,
   renderCandidateShape,
+  renderCandidateUiFlowDoc,
   renderCandidateUiReportDoc,
   renderCandidateVerification,
   renderCandidateWidget,
@@ -81,10 +82,11 @@ export function bestContextBundleForCandidate(bundles, candidate) {
 
 /** @param {ResolvedGraph} graph @param {ImportArtifacts} appImport @param {any} topogramRoot @returns {any} */
 export function buildCandidateModelBundles(graph, appImport, topogramRoot) {
-  const dbCandidates = appImport.candidates.db || { entities: [], enums: [] };
+  const dbCandidates = appImport.candidates.db || { entities: [], enums: [], maintained_seams: [] };
   const apiCandidates = appImport.candidates.api || { capabilities: [] };
-  const uiCandidates = appImport.candidates.ui || { screens: [], routes: [], actions: [], widgets: [], shapes: [] };
+  const uiCandidates = appImport.candidates.ui || { screens: [], routes: [], actions: [], flows: [], widgets: [], shapes: [] };
   const uiWidgetCandidates = uiCandidates.widgets || uiCandidates.components || [];
+  const uiFlowCandidates = uiCandidates.flows || [];
   const uiShapeCandidates = uiCandidates.shapes || [];
   const uiShapeCandidatesById = new Map(uiShapeCandidates.map((/** @type {any} */ shape) => [shape.id || shape.id_hint, shape]));
   const workflowCandidates = appImport.candidates.workflows || { workflows: [], workflow_states: [], workflow_transitions: [] };
@@ -151,6 +153,10 @@ export function buildCandidateModelBundles(graph, appImport, topogramRoot) {
       bundles.delete(`enum_${enumId}`);
     }
   }
+  for (const seam of dbCandidates.maintained_seams || []) {
+    const bundle = getOrCreateCandidateBundle(bundles, "database", "Database");
+    bundle.maintainedSeams = [...(bundle.maintainedSeams || []), seam];
+  }
   for (const entry of apiCandidates.capabilities || []) {
     const matchedCapability = graph ? matchImportedApiCapability(entry, topogramApiCapabilities) : null;
     if (matchedCapability) {
@@ -205,6 +211,11 @@ export function buildCandidateModelBundles(graph, appImport, topogramRoot) {
     const bundle = getOrCreateCandidateBundle(bundles, conceptId, bundleLabelFromConceptId(conceptId || entry.screen_id || entry.id_hint));
     bundle.uiActions.push(entry);
   }
+  for (const entry of uiFlowCandidates) {
+    const conceptId = entry.concept_id || `flow_${canonicalCandidateTerm(entry.flow_type || entry.id_hint)}`;
+    const bundle = getOrCreateCandidateBundle(bundles, conceptId, bundleLabelFromConceptId(conceptId || entry.id_hint));
+    bundle.uiFlows.push(entry);
+  }
   /** @param {WorkflowRecord} entry @returns {any} */
   function widgetConceptId(entry) {
     if (entry.entity_id || entry.concept_id) {
@@ -330,10 +341,12 @@ export function buildCandidateModelBundles(graph, appImport, topogramRoot) {
       bundle.screens.length > 0 ||
       bundle.uiRoutes.length > 0 ||
       bundle.uiActions.length > 0 ||
+      bundle.uiFlows.length > 0 ||
       bundle.workflows.length > 0 ||
       bundle.verifications.length > 0 ||
       bundle.workflowStates.length > 0 ||
-      bundle.workflowTransitions.length > 0
+      bundle.workflowTransitions.length > 0 ||
+      (bundle.maintainedSeams || []).length > 0
     )
     .map((/** @type {any} */ bundle) => {
       const sortedBundle = {
@@ -349,10 +362,12 @@ export function buildCandidateModelBundles(graph, appImport, topogramRoot) {
         screens: bundle.screens.sort((/** @type {any} */ a, /** @type {any} */ b) => a.id_hint.localeCompare(b.id_hint)),
         uiRoutes: bundle.uiRoutes.sort((/** @type {any} */ a, /** @type {any} */ b) => a.id_hint.localeCompare(b.id_hint)),
         uiActions: bundle.uiActions.sort((/** @type {any} */ a, /** @type {any} */ b) => a.id_hint.localeCompare(b.id_hint)),
+        uiFlows: bundle.uiFlows.sort((/** @type {any} */ a, /** @type {any} */ b) => a.id_hint.localeCompare(b.id_hint)),
         workflows: bundle.workflows.sort((/** @type {any} */ a, /** @type {any} */ b) => a.id_hint.localeCompare(b.id_hint)),
         verifications: bundle.verifications.sort((/** @type {any} */ a, /** @type {any} */ b) => a.id_hint.localeCompare(b.id_hint)),
         workflowStates: bundle.workflowStates.sort((/** @type {any} */ a, /** @type {any} */ b) => a.id_hint.localeCompare(b.id_hint)),
         workflowTransitions: bundle.workflowTransitions.sort((/** @type {any} */ a, /** @type {any} */ b) => a.id_hint.localeCompare(b.id_hint)),
+        maintainedSeams: (bundle.maintainedSeams || []).sort((/** @type {any} */ a, /** @type {any} */ b) => a.id_hint.localeCompare(b.id_hint)),
         docs: bundle.docs.sort((/** @type {any} */ a, /** @type {any} */ b) => a.id.localeCompare(b.id))
       };
       const mergeHints = buildBundleMergeHints(sortedBundle, canonicalEntityIds);
@@ -493,6 +508,9 @@ export function buildCandidateModelFiles(graph, appImport, topogramRoot) {
       const actions = bundle.uiActions.filter((/** @type {any} */ action) => action.screen_id === screen.id_hint);
       files[`${bundleRoot}/docs/reports/ui-${screen.id_hint}.md`] = renderCandidateUiReportDoc(screen, routes, actions);
     }
+    for (const flow of bundle.uiFlows || []) {
+      files[`${bundleRoot}/docs/reports/ui-flow-${flow.id_hint}.md`] = renderCandidateUiFlowDoc(flow);
+    }
     for (const patch of bundle.projectionPatches || []) {
       files[`${bundleRoot}/${patch.patch_rel_path}`] = renderProjectionPatchDoc(patch);
     }

package/src/workflows/reconcile/impacts/adoption-plan.js

@@ -156,6 +156,19 @@ export function buildBundleAdoptionPlan(bundle, canonicalShapeIndex) {
       canonical_rel_path: `docs/reports/ui-${screen.id_hint}.md`
     });
   }
+  for (const flow of bundle.uiFlows || []) {
+    steps.push({
+      action: "promote_ui_flow_report",
+      item: `ui_flow_${flow.id_hint}`,
+      target: null,
+      confidence: flow.confidence || "medium",
+      inference_summary: `Review non-resource UI flow candidate ${flow.id_hint}.`,
+      source_kind: flow.source_kind || "route_code",
+      source_path: `candidates/reconcile/model/bundles/${bundle.slug}/docs/reports/ui-flow-${flow.id_hint}.md`,
+      canonical_rel_path: `docs/reports/ui-flow-${flow.id_hint}.md`,
+      track: "ui"
+    });
+  }
   for (const patch of bundle.projectionPatches || []) {
     for (const hint of patch.missing_auth_permissions || []) {
       steps.push({

package/src/workflows/reconcile/renderers.js

@@ -283,6 +283,39 @@ export function renderCandidateUiReportDoc(screen, routes, actions) {
   return renderMarkdownDoc(metadata, body);
 }
 
+/** @param {WorkflowRecord} flow @returns {any} */
+export function renderCandidateUiFlowDoc(flow) {
+  /** @type {WorkflowRecord} */
+  const metadata = {
+    id: `ui_flow_${flow.id_hint}`,
+    kind: "report",
+    title: `${flow.label || flow.id_hint} Review`,
+    status: "inferred",
+    source_of_truth: "imported",
+    confidence: flow.confidence || "medium",
+    review_required: true,
+    provenance: flow.provenance || flow.evidence || [],
+    tags: ["import", "ui", "flow"]
+  };
+  const body = [
+    "Candidate non-resource UI flow imported from brownfield route evidence.",
+    "",
+    `Flow: \`${flow.id_hint}\` (${flow.flow_type || "unknown"})`,
+    `Screens: ${(flow.screen_ids || []).map((/** @type {string} */ item) => `\`${item}\``).join(", ") || "_none_"}`,
+    `Routes: ${(flow.route_paths || []).map((/** @type {string} */ item) => `\`${item}\``).join(", ") || "_none_"}`,
+    `Missing decisions: ${(flow.missing_decisions || []).length ? flow.missing_decisions.join("; ") : "none"}`,
+    "",
+    "Proposed UI contract additions:",
+    "",
+    "```json",
+    JSON.stringify(flow.proposed_ui_contract_additions || {}, null, 2),
+    "```",
+    "",
+    "Review this flow before promoting it into shared UI contract behavior."
+  ].join("\n");
+  return renderMarkdownDoc(metadata, body);
+}
+
 /** @param {WorkflowRecord} widget @returns {any} */
 export function renderCandidateWidget(widget) {
   const propName = widget.data_prop || "rows";

package/src/workflows/reconcile/workflow.js

@@ -91,6 +91,7 @@ export function reconcileWorkflow(inputPath, options = {}) {
     type: "reconcile_adoption_plan",
     workspace: paths.topogramRoot,
     approved_review_groups: [...new Set(existingPlan?.approved_review_groups || [])],
+    imported_maintained_db_seams: appImport.candidates?.db?.maintained_seams || [],
     items: mergedPlanItems,
     projection_review_groups: buildProjectionReviewGroups(mergedPlanItems),
     ui_review_groups: buildUiReviewGroups(mergedPlanItems),
@@ -261,6 +262,7 @@ export function reconcileWorkflow(inputPath, options = {}) {
       widgets: bundle.widgets.map((/** @type {any} */ entry) => entry.id_hint),
       cli_surfaces: (bundle.cliSurfaces || []).map((/** @type {any} */ entry) => entry.id_hint),
       screens: bundle.screens.map((/** @type {any} */ entry) => entry.id_hint),
+      ui_flows: (bundle.uiFlows || []).map((/** @type {any} */ entry) => entry.id_hint),
       workflows: bundle.workflows.map((/** @type {any} */ entry) => entry.id_hint),
       docs: bundle.docs.map((/** @type {any} */ entry) => entry.id),
       maintained_seam_candidates: (agentAdoptionPlan.imported_proposal_surfaces || [])
@@ -283,7 +285,7 @@ export function reconcileWorkflow(inputPath, options = {}) {
     : "## Promoted Canonical Items";
   files["candidates/reconcile/report.json"] = `${stableStringify(report)}\n`;
   const candidateModelBundlesMarkdown = report.candidate_model_bundles.length
-    ? report.candidate_model_bundles.map((/** @type {any} */ bundle) => `- \`${bundle.slug}\` (${bundle.actors.length} actors, ${bundle.roles.length} roles, ${bundle.entities.length} entities, ${bundle.enums.length} enums, ${bundle.capabilities.length} capabilities, ${bundle.shapes.length} shapes, ${bundle.widgets.length} widgets, ${bundle.cli_surfaces.length} CLI surfaces, ${bundle.screens.length} screens, ${bundle.workflows.length} workflows, ${bundle.docs.length} docs)
+    ? report.candidate_model_bundles.map((/** @type {any} */ bundle) => `- \`${bundle.slug}\` (${bundle.actors.length} actors, ${bundle.roles.length} roles, ${bundle.entities.length} entities, ${bundle.enums.length} enums, ${bundle.capabilities.length} capabilities, ${bundle.shapes.length} shapes, ${bundle.widgets.length} widgets, ${bundle.cli_surfaces.length} CLI surfaces, ${bundle.screens.length} screens, ${(bundle.ui_flows || []).length} UI flows, ${bundle.workflows.length} workflows, ${bundle.docs.length} docs)
   - primary concept \`${bundle.operator_summary.primaryConcept}\`${bundle.operator_summary.primaryEntityId ? `, primary entity \`${bundle.operator_summary.primaryEntityId}\`` : ""}
   - participants ${bundle.operator_summary.participants.label}
   - main capabilities ${summarizeBundleSurface(bundle, bundle.operator_summary.capabilityIds)}