archctx 0.9.2 → 0.9.3

package/assets/catalog.yaml

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "archcontext.practice-catalog-manifest/v1",
   "catalogVersion": "2026.06.0",
-  "productVersion": "0.9.2",
+  "productVersion": "0.9.3",
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "entries": [
     {
@@ -389,5 +389,5 @@
     "structurizr.dsl",
     "twelve-factor"
   ],
-  "catalogDigest": "sha256:2902680bd3732b42edd01c1dc899acff71768f03782c1747a4a53017dbb3730d"
+  "catalogDigest": "sha256:4fdfbd8668e8d00e0d6f46f094a86e8e0a43075927b20b7dd5e554eab899fdcf"
 }

package/bin/archctx.mjs

@@ -3462,6 +3462,9 @@ var PROJECTION_PUBLISH_RUN_SCHEMA_VERSION = "archcontext.projection-publish-run/
 var init_projection_writer = () => {};
 
 // packages/contracts/src/projection-manifest.ts
+function isRuntimeTopologyTargetType(type) {
+  return typeof type === "string" && RUNTIME_TOPOLOGY_TARGET_TYPES.includes(type);
+}
 function architectureDocsProjectionManifestIssues(value) {
   const issues = [];
   const manifest = record3(value);
@@ -3497,6 +3500,7 @@ function architectureDocsProjectionManifestIssues(value) {
   }
   const paths = new Set;
   const stampOwners = new Map;
+  let topologyStamps;
   for (const [targetId, row] of Object.entries(targets)) {
     const prefix = `manifest.targets[${JSON.stringify(targetId)}]`;
     if (!isNonEmptyString(targetId))
@@ -3508,7 +3512,23 @@ function architectureDocsProjectionManifestIssues(value) {
         issues.push(`${prefix}.path is recorded by another target`);
       paths.add(path);
     }
-    for (const nodeId of Object.keys(record3(record3(row)?.sourceStamps) ?? {})) {
+    const stamps = record3(record3(row)?.sourceStamps) ?? {};
+    if (isRuntimeTopologyTargetType(record3(row)?.type)) {
+      const serialized = JSON.stringify(Object.keys(stamps).sort(compareStrings).map((nodeId) => [nodeId, stamps[nodeId]]));
+      if (topologyStamps === undefined)
+        topologyStamps = { targetId, stamps: serialized };
+      else if (topologyStamps.stamps !== serialized)
+        issues.push(`${prefix}.sourceStamps must equal the sourceStamps of ${topologyStamps.targetId}`);
+      for (const nodeId of Object.keys(stamps)) {
+        const owner = stampOwners.get(nodeId);
+        if (owner !== undefined && !isRuntimeTopologyTargetType(record3(targets[owner])?.type))
+          issues.push(`${prefix}.sourceStamps.${nodeId} is already stamped on ${owner}`);
+        else if (owner === undefined)
+          stampOwners.set(nodeId, targetId);
+      }
+      continue;
+    }
+    for (const nodeId of Object.keys(stamps)) {
       const owner = stampOwners.get(nodeId);
       if (owner !== undefined)
         issues.push(`${prefix}.sourceStamps.${nodeId} is already stamped on ${owner}`);
@@ -3763,9 +3783,11 @@ function manifestTargetIssues(value, prefix) {
     issues.push(`${prefix}.format is unsupported`);
   if (!isDigest(target.outputDigest))
     issues.push(`${prefix}.outputDigest must be a SHA-256 digest`);
-  if ((target.sourceStamps !== undefined || target.scale !== undefined) && target.type !== "entity-summary") {
-    issues.push(`${prefix}.sourceStamps and scale are only allowed on entity-summary targets`);
+  if (target.sourceStamps !== undefined && target.type !== "entity-summary" && !isRuntimeTopologyTargetType(target.type)) {
+    issues.push(`${prefix}.sourceStamps are only allowed on entity-summary and runtime topology targets`);
   }
+  if (target.scale !== undefined && target.type !== "entity-summary")
+    issues.push(`${prefix}.scale is only allowed on entity-summary targets`);
   if (target.sourceStamps !== undefined) {
     const stamps = record3(target.sourceStamps);
     if (!stamps || Object.keys(stamps).length === 0)
@@ -3854,7 +3876,7 @@ function architectureDocsProjectionCompatibilityIssues(value, engine = {
   }
   return issues;
 }
-var ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION = "archcontext.architecture-docs-projection-manifest/v3", SUPERSEDED_ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSIONS, PROJECTION_MANIFEST_UPGRADE_REQUIRED = "projection-manifest-upgrade-required", PROJECTION_MANIFEST_INVALID = "projection-manifest-invalid", PROJECTION_FOOTPRINT_UNCOVERED = "projection-footprint-uncovered", ARCHITECTURE_DOCS_PROJECTION_PROVENANCE_SCHEMA_VERSION = "archcontext.architecture-docs-projection-provenance/v3", ARCHITECTURE_DOCS_LAYOUT_VERSION_V1 = "archcontext.docs-layout/v1", ARCHITECTURE_SEMANTIC_STATE_SCHEMA_VERSION = "archcontext.architecture-semantic-state/v1", ARCHITECTURE_DOCS_PROJECTION_PROFILES, SHA256, TARGET_TYPES, SCOPE_KINDS, OWNERSHIPS, FORMATS;
+var ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION = "archcontext.architecture-docs-projection-manifest/v3", SUPERSEDED_ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSIONS, PROJECTION_MANIFEST_UPGRADE_REQUIRED = "projection-manifest-upgrade-required", PROJECTION_MANIFEST_INVALID = "projection-manifest-invalid", PROJECTION_FOOTPRINT_UNCOVERED = "projection-footprint-uncovered", ARCHITECTURE_DOCS_PROJECTION_PROVENANCE_SCHEMA_VERSION = "archcontext.architecture-docs-projection-provenance/v3", ARCHITECTURE_DOCS_LAYOUT_VERSION_V1 = "archcontext.docs-layout/v1", ARCHITECTURE_SEMANTIC_STATE_SCHEMA_VERSION = "archcontext.architecture-semantic-state/v1", ARCHITECTURE_DOCS_PROJECTION_PROFILES, SHA256, TARGET_TYPES, RUNTIME_TOPOLOGY_TARGET_TYPES, SCOPE_KINDS, OWNERSHIPS, FORMATS;
 var init_projection_manifest = __esm(() => {
   init_projection();
   init_schema();
@@ -3877,6 +3899,7 @@ var init_projection_manifest = __esm(() => {
     "runtime-topology-summary": true,
     "agent-context": true
   };
+  RUNTIME_TOPOLOGY_TARGET_TYPES = ["diagram-runtime-topology", "runtime-topology-summary"];
   SCOPE_KINDS = { repository: true, entity: true, relation: true, decision: true, diagram: true, changelog: true };
   OWNERSHIPS = { generated: true, mixed: true };
   FORMATS = { markdown: true, mermaid: true, "structurizr-json": true, likec4: true };
@@ -3967,7 +3990,7 @@ function compareVersionTriples(left, right) {
   }
   return 0;
 }
-var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.9.2", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.4.3", ARCHCONTEXT_NODE_RANGE = ">=22.22 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v2", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-07-11.explorer-view-v2";
+var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.9.3", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.4.3", ARCHCONTEXT_NODE_RANGE = ">=22.22 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v2", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-07-11.explorer-view-v2";
 
 // packages/contracts/src/refactor.ts
 function refactorNamespaceIssues(value, label = "product.id") {
@@ -17788,9 +17811,10 @@ var FIXED_TARGETS = [
 ];
 var RUNTIME_TOPOLOGY_DIAGRAM_PATH = "docs/architecture/diagrams/runtime-topology.mmd";
 var RUNTIME_TOPOLOGY_SUMMARY_PATH = "docs/architecture/runtime-topology.md";
+var RUNTIME_TOPOLOGY_SCOPE_ID = "runtime-topology";
 var RUNTIME_TOPOLOGY_TARGETS = [
-  layoutTarget("projection_target.diagram.runtime-topology", "diagram-runtime-topology", { kind: "diagram", id: "runtime-topology" }, RUNTIME_TOPOLOGY_DIAGRAM_PATH, "generated", "mermaid"),
-  layoutTarget("projection_target.runtime-topology.summary", "runtime-topology-summary", { kind: "diagram", id: "runtime-topology" }, RUNTIME_TOPOLOGY_SUMMARY_PATH, "generated", "markdown")
+  layoutTarget("projection_target.diagram.runtime-topology", "diagram-runtime-topology", { kind: "diagram", id: RUNTIME_TOPOLOGY_SCOPE_ID }, RUNTIME_TOPOLOGY_DIAGRAM_PATH, "generated", "mermaid"),
+  layoutTarget("projection_target.runtime-topology.summary", "runtime-topology-summary", { kind: "diagram", id: RUNTIME_TOPOLOGY_SCOPE_ID }, RUNTIME_TOPOLOGY_SUMMARY_PATH, "generated", "markdown")
 ];
 function hasRuntimeTopologyNodes(nodes) {
   return nodes.some((node) => isRuntimeTopologyNodeKind(node.kind));
@@ -19471,6 +19495,7 @@ function renderArchitectureDocumentationProjection(input) {
   const rendered = targetDrafts.map((draft) => {
     const existing = existingByPath.get(draft.path);
     const nodeId = draft.type === "entity-summary" ? draft.scope.id : undefined;
+    const topology = isRuntimeTopologyTargetType(draft.type);
     const generatedBody = renderTargetGeneratedBody(draft, model, {
       scaleSignalsByNodeId,
       scaleByNodeId,
@@ -19494,6 +19519,10 @@ function renderArchitectureDocumentationProjection(input) {
         if (scale === undefined)
           throw new Error(`architecture-docs-projection-scale-signal-missing: ${nodeId}`);
       }
+    } else if (topology) {
+      const owned = Object.keys(sourceStamps).filter((stamped) => footprintOwners.get(stamped) === RUNTIME_TOPOLOGY_SCOPE_ID);
+      if (owned.length > 0)
+        targetStamps = Object.fromEntries(owned.map((stamped) => [stamped, sourceStamps[stamped]]));
     }
     const generatedBodyDigest = digestJson({ targetId: draft.targetId, body: generatedBody });
     const target = projectionTarget({
@@ -19859,6 +19888,10 @@ function architectureProjectionFootprintOwners(model, profile = "default") {
   for (const node of [...model.nodes].sort((left, right) => compareStrings3(left.id, right.id))) {
     if ((nativeNodeSource(node)?.include ?? []).length === 0)
       continue;
+    if (isRuntimeTopologyNodeKind(node.kind)) {
+      owners.set(node.id, RUNTIME_TOPOLOGY_SCOPE_ID);
+      continue;
+    }
     const seen = new Set;
     let current = node;
     while (current && !targetNodeIds.has(current.id) && !seen.has(current.id)) {
@@ -20522,7 +20555,7 @@ function renderRuntimeTopologySummary(model, summaryPath) {
   const lines = [
     "# Runtime Topology",
     "",
-    "The architecture model declares this topology. No code facts verify it.",
+    "The architecture model declares this topology. No code facts verify it: archctx never reads the configuration it describes. A change to a file a node lists in `source.include` marks this page and its diagram stale.",
     "",
     `- Diagram: [Mermaid](${posix.relative(posix.dirname(summaryPath), RUNTIME_TOPOLOGY_DIAGRAM_PATH)})`,
     "",
@@ -20573,6 +20606,11 @@ function renderRuntimeTopologySummary(model, summaryPath) {
     for (const relation of otherDeployments)
       lines.push(`- \`${relation.source}\` -> \`${relation.target}\` — ${relation.intent}`);
   }
+  lines.push("", "## Source Anchors", "", "| Node | Source |", "| --- | --- |");
+  for (const node of [...view.nodesById.values()].filter((entry) => isRuntimeTopologyNodeKind(entry.kind)).sort((left, right) => compareStrings3(left.id, right.id))) {
+    const include = nativeNodeSource(node)?.include ?? [];
+    lines.push(`| ${named(node.id)} | ${include.length === 0 ? "model-authored, no source anchor" : include.map((pattern) => `\`${cell(pattern)}\``).join(", ")} |`);
+  }
   return `${lines.join(`
 `)}
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archctx",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Local architecture context CLI for agentic coding workflows.",
   "private": false,
   "type": "module",

package/schemas/runtime/projection-manifest.schema.json

@@ -332,7 +332,7 @@
         },
         "sourceStamps": {
           "type": "object",
-          "description": "entity-summary targets only: the content digest of every declared source footprint this target documents, by node id. Each footprint belongs to its node's nearest ancestor-or-self with an entity-summary target, so each node is stamped on exactly one row.",
+          "description": "entity-summary and runtime topology targets only: the content digest of every declared source footprint this target documents, by node id. A footprint belongs to its node's nearest ancestor-or-self with an entity-summary target, so it is stamped on exactly one entity-summary row; a runtime topology node's footprint is stamped on every runtime topology row instead, and those rows carry identical stamps (ADR-0049).",
           "additionalProperties": {
             "$ref": "#/$defs/digest"
           }
@@ -360,24 +360,37 @@
             "properties": {
               "type": {
                 "not": {
-                  "const": "entity-summary"
+                  "enum": [
+                    "entity-summary",
+                    "diagram-runtime-topology",
+                    "runtime-topology-summary"
+                  ]
                 }
               }
             }
           },
           "then": {
             "not": {
-              "anyOf": [
-                {
-                  "required": [
-                    "sourceStamps"
-                  ]
-                },
-                {
-                  "required": [
-                    "scale"
-                  ]
+              "required": [
+                "sourceStamps"
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "not": {
+                  "const": "entity-summary"
                 }
+              }
+            }
+          },
+          "then": {
+            "not": {
+              "required": [
+                "scale"
               ]
             }
           }