@webpieces/nx-webpieces-rules 0.4.893 → 0.4.895

package/src/lib/graph-loader.js

@@ -9,6 +9,7 @@
  * {
  *     "aiInstructions": "...how AI should use the per-project fields...",
  *     "apiContractFiles": { "<ApiName>": "apis/<ApiName>.json" },
+ *     "remoteServices": { "<serviceName>": { "label"?, "implements": [{ "api", "type" }] } },
  *     "projects": {
  *         "<project>": { level, framework, products, shortDescription,
  *                        responsibilitiesFile, designFile, dependsOn }
@@ -40,6 +41,7 @@ const fs = tslib_1.__importStar(require("fs"));
 const path = tslib_1.__importStar(require("path"));
 const rules_config_1 = require("@webpieces/rules-config");
 const api_contract_files_1 = require("./api-contract-files");
+const remote_services_1 = require("./remote-services");
 const toError_1 = require("../toError");
 /**
  * Default path for the dependencies file (relative to workspace root)
@@ -90,6 +92,7 @@ class DependenciesFile {
     projects;
     apiContractFiles;
     externalSystems;
+    remoteServices;
     constructor(aiInstructions, commands, projects, 
     /**
      * apiClassName -> its contract file (`apis/<ApiName>.json`, relative to this file's
@@ -102,12 +105,19 @@ class DependenciesFile {
      * the runtime graph is derived from the committed files, so a declaration that is scanned but
      * not written would make generate and validate disagree.
      */
-    externalSystems = {}) {
+    externalSystems = {}, 
+    /**
+     * REVIEWED out-of-workspace services a `uses` may target (#1203), keyed by service name. Like
+     * `apiContractFiles` it is approval metadata: generation reads it and writes it back verbatim,
+     * and never infers or adds an entry. See remote-services.ts.
+     */
+    remoteServices = {}) {
         this.aiInstructions = aiInstructions;
         this.commands = commands;
         this.projects = projects;
         this.apiContractFiles = apiContractFiles;
         this.externalSystems = externalSystems;
+        this.remoteServices = remoteServices;
     }
 }
 exports.DependenciesFile = DependenciesFile;
@@ -141,7 +151,7 @@ function loadBlessedGraph(workspaceRoot, graphPath = exports.DEFAULT_GRAPH_PATH)
             // table simply draws no shaped nodes, which is exactly the old rendering.
             parsed.externalSystems !== null && typeof parsed.externalSystems === 'object'
                 ? parsed.externalSystems
-                : {});
+                : {}, new remote_services_1.RemoteServicesCodec().decode(parsed.remoteServices, fullPath));
         }
         // Legacy flat format: the whole object is the project map
         return new DependenciesFile('', {}, parsed);
@@ -181,6 +191,7 @@ function formatGraphJson(file) {
     lines.push(`    },`);
     lines.push(...apiContractFilesLines(file.apiContractFiles));
     lines.push(...externalSystemsLines(file.externalSystems));
+    lines.push(...remoteServicesLines(file.remoteServices));
     lines.push(`    "projects": {`);
     const keys = Object.keys(file.projects).sort();
     keys.forEach((key, index) => {
@@ -232,6 +243,25 @@ function externalSystemsLines(systems) {
         return `    ${prefix}${line}${suffix}`;
     });
 }
+/**
+ * The reviewed `"remoteServices": {...}` block (4-space indent), with a trailing comma since `projects`
+ * always follows. Omitted entirely when empty, so a repo that declares none keeps its exact file shape.
+ * Service names are sorted; each entry is written as it was reviewed.
+ */
+// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling formatters here
+function remoteServicesLines(services) {
+    if (Object.keys(services).length === 0)
+        return [];
+    const sorted = {};
+    for (const name of Object.keys(services).sort())
+        sorted[name] = services[name];
+    const pretty = JSON.stringify(sorted, null, 4).split('\n');
+    return pretty.map((line, index) => {
+        const prefix = index === 0 ? '"remoteServices": ' : '';
+        const suffix = index === pretty.length - 1 ? ',' : '';
+        return `    ${prefix}${line}${suffix}`;
+    });
+}
 /**
  * Format one project entry's fields (12-space indent). Optional metadata
  * fields are only emitted when present.
@@ -337,7 +367,7 @@ function pushApiRelationsField(lines, value) {
  * @param workspaceRoot - Absolute path to workspace root
  * @param graphPath - Relative path to graph file (default: architecture/dependencies.json)
  */
-function saveGraph(graph, workspaceRoot, graphPath = exports.DEFAULT_GRAPH_PATH, apiContractFiles = {}, externalSystems = {}) {
+function saveGraph(graph, workspaceRoot, graphPath = exports.DEFAULT_GRAPH_PATH, apiContractFiles = {}, externalSystems = {}, remoteServices = {}) {
     const fullPath = path.join(workspaceRoot, graphPath);
     const dir = path.dirname(fullPath);
     // Ensure directory exists
@@ -350,7 +380,7 @@ function saveGraph(graph, workspaceRoot, graphPath = exports.DEFAULT_GRAPH_PATH,
     for (const key of sortedKeys) {
         sortedGraph[key] = graph[key];
     }
-    const content = formatGraphJson(new DependenciesFile(exports.AI_INSTRUCTIONS, exports.GRAPH_COMMANDS, sortedGraph, apiContractFiles, externalSystems));
+    const content = formatGraphJson(new DependenciesFile(exports.AI_INSTRUCTIONS, exports.GRAPH_COMMANDS, sortedGraph, apiContractFiles, externalSystems, remoteServices));
     fs.writeFileSync(fullPath, content, 'utf-8');
 }
 /**

package/src/lib/graph-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-loader.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/lib/graph-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;AAgGH,4CAyCC;AAqND,8BAgCC;AAKD,0CAMC;;AAvYD,+CAAyB;AACzB,mDAA6B;AAE7B,0DAAgE;AAEhE,6DAAkF;AAElF,wCAAqC;AAErC;;GAEG;AACU,QAAA,kBAAkB,GAAG,gCAAgC,CAAC;AAEnE;;;GAGG;AACU,QAAA,eAAe,GACxB,sFAAsF;IACtF,oFAAoF;IACpF,kFAAkF;IAClF,mFAAmF;IACnF,kFAAkF;IAClF,2EAA2E;IAC3E,mFAAmF;IACnF,yFAAyF;IACzF,6FAA6F;IAC7F,8FAA8F;IAC9F,+FAA+F;IAC/F,sFAAsF;IACtF,mGAAmG;IACnG,qDAAqD,CAAC;AAO1D;;;;GAIG;AACU,QAAA,cAAc,GAAe;IACtC,sBAAsB,EAClB,+EAA+E;QAC/E,yFAAyF;QACzF,wJAAwJ;IAC5J,qBAAqB,EACjB,uFAAuF;QACvF,6EAA6E;IACjF,4BAA4B,EACxB,yFAAyF;QACzF,6EAA6E;IACjF,iBAAiB,EACb,yEAAyE;QACzE,gEAAgE;IACpE,eAAe,EACX,wFAAwF;QACxF,6FAA6F;CACpG,CAAC;AAEF;;GAEG;AACH,MAAa,gBAAgB;IAEL;IACA;IACA;IAMA;IAMA;IAfpB,YACoB,cAAsB,EACtB,QAAoB,EACpB,QAAuB;IACvC;;;;OAIG;IACa,mBAAwC,EAAE;IAC1D;;;;OAIG;IACa,kBAAuC,EAAE;QAdzC,mBAAc,GAAd,cAAc,CAAQ;QACtB,aAAQ,GAAR,QAAQ,CAAY;QACpB,aAAQ,GAAR,QAAQ,CAAe;QAMvB,qBAAgB,GAAhB,gBAAgB,CAA0B;QAM1C,oBAAe,GAAf,eAAe,CAA0B;IAC1D,CAAC;CACP;AAlBD,4CAkBC;AAED;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAC5B,aAAqB,EACrB,YAAoB,0BAAkB;IAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAErD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,8DAA8D;IAC9D,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;YAC5E,MAAM,sBAAsB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACxE,OAAO,IAAI,gBAAgB,CACvB,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EACtE,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;gBAC3D,CAAC,CAAE,MAAM,CAAC,QAAuB;gBACjC,CAAC,CAAC,EAAE,EACR,MAAM,CAAC,QAAyB,EAChC,MAAM,CAAC,gBAAgB,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ;gBAC3E,CAAC,CAAE,MAAM,CAAC,gBAAwC;gBAClD,CAAC,CAAC,EAAE;YACR,iFAAiF;YACjF,0EAA0E;YAC1E,MAAM,CAAC,eAAe,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ;gBACzE,CAAC,CAAE,MAAM,CAAC,eAAuC;gBACjD,CAAC,CAAC,EAAE,CACX,CAAC;QACN,CAAC;QACD,0DAA0D;QAC1D,OAAO,IAAI,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,MAAuB,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,IAAA,iBAAO,EAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,YAAY,4BAAa;YAAE,MAAM,KAAK,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,oHAAoH;AACpH,SAAS,sBAAsB,CAAC,QAAgB,EAAE,SAAiB;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,sCAAiB,CAAC,CAAC;IACtE,OAAO,IAAI,4BAAa,CACpB,4CAAuB,EACvB,GAAG,QAAQ,sFAAsF;QAC7F,GAAG,OAAO,qFAAqF,EACnG,SAAS,EACT,SAAS,EACT;QACI,IAAI,qBAAM,CACN,gEAAgE,OAAO,0QAA0Q,EACjV,IAAI,CACP;KACJ,CACJ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAsB;IAC3C,MAAM,KAAK,GAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,YAAY,CAAC,OAAO,CAAC,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,KAAK,KAAK,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3D,KAAK,CAAC,IAAI,CACN,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,CACpF,CAAC;IACN,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAEhC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,KAAK,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAEhC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,6GAA6G;AAC7G,SAAS,qBAAqB,CAAC,IAAyB;IACpD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,KAAK,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO,OAAO,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;GAIG;AACH,6GAA6G;AAC7G,SAAS,oBAAoB,CAAC,OAA4B;IACtD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjD,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,KAAK,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO,OAAO,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,KAAiB;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;IAEnD,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5D,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,8FAA8F;IAC9F,2FAA2F;IAC3F,oEAAoE;IACpE,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC1E,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3D,6BAA6B,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IACzD,wBAAwB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAClE,iGAAiG;IACjG,mGAAmG;IACnG,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACtE,gGAAgG;IAChG,wEAAwE;IACxE,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1D,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrE,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC7E,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACzD,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IACjD,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACzE,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAEhF,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAW,EAAE,QAAgB,EAAE,EAAE;YACtD,MAAM,QAAQ,GAAG,QAAQ,KAAK,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YACpE,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAe,EAAE,KAAa,EAAE,KAAyB;IAChF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClF,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,qHAAqH;AACrH,SAAS,6BAA6B,CAClC,KAAe,EACf,KAAkD;IAElD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxE,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,qHAAqH;AACrH,SAAS,wBAAwB,CAC7B,KAAe,EACf,KAAa,EACb,KAA0B;IAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClF,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,KAAe,EAAE,KAAa,EAAE,KAA2B;IACvF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClF,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,qHAAqH;AACrH,SAAS,qBAAqB,CAAC,KAAe,EAAE,KAAsC;IAClF,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,KAAK,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CACrB,KAAoB,EACpB,aAAqB,EACrB,YAAoB,0BAAkB,EACtC,mBAAwC,EAAE,EAC1C,kBAAuC,EAAE;IAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnC,0BAA0B;IAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,qCAAqC;IACrC,MAAM,WAAW,GAAkB,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3B,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAC3B,IAAI,gBAAgB,CAChB,uBAAe,EACf,sBAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,CAClB,CACJ,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC3B,aAAqB,EACrB,YAAoB,0BAAkB;IAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACrD,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC","sourcesContent":["/**\n * Graph Loader\n *\n * Handles loading and saving the blessed dependency graph file.\n * The graph is stored at architecture/dependencies.json in the workspace root.\n *\n * File format (schema aimed at AI consumers):\n * {\n *     \"aiInstructions\": \"...how AI should use the per-project fields...\",\n *     \"apiContractFiles\": { \"<ApiName>\": \"apis/<ApiName>.json\" },\n *     \"projects\": {\n *         \"<project>\": { level, framework, products, shortDescription,\n *                        responsibilitiesFile, designFile, dependsOn }\n *     }\n * }\n *\n * `level` is the project's dependency depth, except that every server, client and app is pinned to\n * the TOP level (bundles above them), so the top row is exactly the entry points (#1179).\n *\n * `products` (#1179) is the sorted list of products whose `product:<name>`-tagged projects reach\n * this project over `dependsOn` — its blast radius. Absent when no product reaches it.\n *\n * `framework` is the project's libType — the SET of runtime environments it is\n * validated to run in, drawn from browser | react | angular | node | express\n * (e.g. [\"browser\",\"node\"]). It comes from the project's `framework:` nx tags\n * and is enforced across edges by the `library-types-match-client` rule.\n *\n * The legacy format (flat { \"<project>\": { level, dependsOn } } map) is still\n * readable so validation against a pre-upgrade file produces a clean\n * \"re-run architecture:generate\" diff instead of a parse failure.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport type { EnhancedGraph, GraphEntry } from './graph-sorter';\nimport { RuleFailError, Option } from '@webpieces/rules-config';\nimport type { ExternalSystemDecls, ProjectApiRelations } from './api-usage/api-relations';\nimport { API_CONTRACT_FILES_RULE, API_CONTRACTS_DIR } from './api-contract-files';\nimport type { ApiContractFileRefs } from './api-contract-files';\nimport { toError } from '../toError';\n\n/**\n * Default path for the dependencies file (relative to workspace root)\n */\nexport const DEFAULT_GRAPH_PATH = 'architecture/dependencies.json';\n\n/**\n * Top-level instructions embedded in dependencies.json telling AI how to use\n * the per-project metadata fields.\n */\nexport const AI_INSTRUCTIONS =\n    \"Each project's shortDescription is only a summary. BEFORE adding code to a project, \" +\n    'read its responsibilitiesFile for the full responsibilities (what belongs in that ' +\n    'project and what does not), and read its designFile to understand the DI design ' +\n    'before reading the code. Use the entries in `commands` to regenerate these files ' +\n    'or display any of the graphs in a browser. To hide a project (its box AND every ' +\n    'edge touching it) from BOTH rendered architecture graphs, add the nx tag ' +\n    \"'drawOnGraph:false' to that project's project.json tags and regenerate; it stays \" +\n    'in this file (marked \"drawOnGraph\": false) but is omitted from the HTML. A role:server ' +\n    'with no webpiecesRuntime package anywhere in its dependency closure and no apiRelations is ' +\n    'omitted from the RUNTIME drawing the same way — it speaks none of the webpieces runtime, so ' +\n    \"it can only ever draw as a disconnected box; it stays in both JSON files. An API's endpoints \" +\n    '(name, kind, path, httpMethod, parameters, queueName, caller) are NOT in this file: ' +\n    '`apiContractFiles` maps each API to its generated contract file, apis/<ApiName>.json relative to ' +\n    \"this file — read that file for the API's endpoints.\";\n\n/**\n * Named command → \"command — what it does\" map embedded in dependencies.json.\n */\nexport type CommandMap = Record<string, string>;\n\n/**\n * Commands embedded in dependencies.json so AI (and humans) know how to\n * regenerate and DISPLAY the architecture + design graphs. These work in any\n * repo consuming @webpieces/nx-webpieces-rules.\n */\nexport const GRAPH_COMMANDS: CommandMap = {\n    regenerateArchitecture:\n        'pnpm nx run architecture:generate — rewrites architecture/dependencies.json, ' +\n        'architecture/apis/<ApiName>.json and architecture/runtime-dependencies.json; run after ' +\n        'reviewing project runtime-deps.json and API contract candidates into architecture/apis; generation reads approvals and never approves endpoint changes',\n    visualizeArchitecture:\n        'pnpm nx run architecture:visualize — opens the monorepo dependency graph (this file) ' +\n        'as HTML in a browser from saved data, without refreshing; freshness unknown',\n    visualizeRuntimeArchitecture:\n        'pnpm nx run architecture:visualize-runtime — opens the runtime microservice call graph ' +\n        'as HTML in a browser from saved data, without refreshing; freshness unknown',\n    regenerateDesigns:\n        \"pnpm nx run-many --target=di-graph-generate — rewrites every project's \" +\n        'design.json/design.md (also runs automatically on every build)',\n    visualizeDesign:\n        \"pnpm wp-design-visualize <project> — opens a project's DI designs (its designFile) as \" +\n        'HTML, one graph per controller with the controller at the top; no args = interactive picker',\n};\n\n/**\n * The full contents of architecture/dependencies.json.\n */\nexport class DependenciesFile {\n    constructor(\n        public readonly aiInstructions: string,\n        public readonly commands: CommandMap,\n        public readonly projects: EnhancedGraph,\n        /**\n         * apiClassName -> its contract file (`apis/<ApiName>.json`, relative to this file's\n         * directory). Only the LINK lives here, so adding an endpoint never changes dependencies.json;\n         * the contract itself is read with ApiContractFiles.load.\n         */\n        public readonly apiContractFiles: ApiContractFileRefs = {},\n        /**\n         * Declared external systems (databases, buckets, ...) keyed by identity. MUST be persisted:\n         * the runtime graph is derived from the committed files, so a declaration that is scanned but\n         * not written would make generate and validate disagree.\n         */\n        public readonly externalSystems: ExternalSystemDecls = {},\n    ) {}\n}\n\n/**\n * Load the blessed graph from disk. Understands both the current wrapper\n * format and the legacy flat map (which loads with empty aiInstructions).\n *\n * @param workspaceRoot - Absolute path to workspace root\n * @param graphPath - Relative path to graph file (default: architecture/dependencies.json)\n * @returns The blessed graph file, or null if it doesn't exist\n */\nexport function loadBlessedGraph(\n    workspaceRoot: string,\n    graphPath: string = DEFAULT_GRAPH_PATH,\n): DependenciesFile | null {\n    const fullPath = path.join(workspaceRoot, graphPath);\n\n    if (!fs.existsSync(fullPath)) {\n        return null;\n    }\n\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        const content = fs.readFileSync(fullPath, 'utf-8');\n        const parsed = JSON.parse(content);\n        if (parsed !== null && typeof parsed === 'object' && 'apiContracts' in parsed) {\n            throw movedApiContractsError(fullPath, graphPath);\n        }\n        if (parsed !== null && typeof parsed === 'object' && 'projects' in parsed) {\n            return new DependenciesFile(\n                typeof parsed.aiInstructions === 'string' ? parsed.aiInstructions : '',\n                parsed.commands !== null && typeof parsed.commands === 'object'\n                    ? (parsed.commands as CommandMap)\n                    : {},\n                parsed.projects as EnhancedGraph,\n                parsed.apiContractFiles !== null && typeof parsed.apiContractFiles === 'object'\n                    ? (parsed.apiContractFiles as ApiContractFileRefs)\n                    : {},\n                // Absent in any file written before external systems could be declared; an empty\n                // table simply draws no shaped nodes, which is exactly the old rendering.\n                parsed.externalSystems !== null && typeof parsed.externalSystems === 'object'\n                    ? (parsed.externalSystems as ExternalSystemDecls)\n                    : {},\n            );\n        }\n        // Legacy flat format: the whole object is the project map\n        return new DependenciesFile('', {}, parsed as EnhancedGraph);\n    } catch (err: unknown) {\n        const error = toError(err);\n        if (error instanceof RuleFailError) throw error;\n        throw new Error(`Failed to load graph from ${fullPath}`, { cause: error });\n    }\n}\n\n/**\n * The endpoint table moved out of dependencies.json (#949). A file still carrying `apiContracts` was\n * written by an older generator; it is REJECTED rather than read, so there is one place a contract\n * lives and the runtime graph can never read a stale copy of it.\n */\n// webpieces-disable no-function-outside-class -- error builder for loadBlessedGraph, module-scope like its siblings\nfunction movedApiContractsError(fullPath: string, graphPath: string): RuleFailError {\n    const apisDir = path.join(path.dirname(graphPath), API_CONTRACTS_DIR);\n    return new RuleFailError(\n        API_CONTRACT_FILES_RULE,\n        `${fullPath} still carries the \\`apiContracts\\` key. It moved: each API's contract now lives in ` +\n            `${apisDir}/<ApiName>.json, and dependencies.json only links to it under \\`apiContractFiles\\`.`,\n        undefined,\n        undefined,\n        [\n            new Option(\n                `Explicitly move each saved apiContracts.<ApiName> value into ${apisDir}/<ApiName>.json, replace apiContracts with reviewed apiContractFiles entries mapping each name to apis/<ApiName>.json, preserve externalSystems, and approve runtime-deps.json for all runtime owners. Then run pnpm nx run architecture:generate and review the result.`,\n                true,\n            ),\n        ],\n    );\n}\n\n/**\n * Format the dependencies file as JSON with multi-line arrays for readability\n */\nfunction formatGraphJson(file: DependenciesFile): string {\n    const lines: string[] = ['{'];\n    lines.push(`    \"aiInstructions\": ${JSON.stringify(file.aiInstructions)},`);\n    lines.push(`    \"commands\": {`);\n    const commandNames = Object.keys(file.commands);\n    commandNames.forEach((name: string, index: number) => {\n        const comma = index === commandNames.length - 1 ? '' : ',';\n        lines.push(\n            `        ${JSON.stringify(name)}: ${JSON.stringify(file.commands[name])}${comma}`,\n        );\n    });\n    lines.push(`    },`);\n    lines.push(...apiContractFilesLines(file.apiContractFiles));\n    lines.push(...externalSystemsLines(file.externalSystems));\n    lines.push(`    \"projects\": {`);\n\n    const keys = Object.keys(file.projects).sort();\n    keys.forEach((key: string, index: number) => {\n        const entry = file.projects[key];\n        const isLast = index === keys.length - 1;\n        const comma = isLast ? '' : ',';\n\n        lines.push(`        ${JSON.stringify(key)}: {`);\n        lines.push(...formatEntryLines(entry));\n        lines.push(`        }${comma}`);\n    });\n\n    lines.push('    }');\n    lines.push('}');\n    return lines.join('\\n') + '\\n';\n}\n\n/**\n * The `\"apiContractFiles\": {...}` block (4-space indent), with a trailing comma since `projects`\n * always follows it. Omitted entirely when empty. Keys are sorted, so the output is deterministic.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling formatters here\nfunction apiContractFilesLines(refs: ApiContractFileRefs): string[] {\n    if (Object.keys(refs).length === 0) return [];\n    const sorted: ApiContractFileRefs = {};\n    for (const api of Object.keys(refs).sort()) sorted[api] = refs[api];\n    const pretty = JSON.stringify(sorted, null, 4).split('\\n');\n    return pretty.map((line: string, index: number) => {\n        const prefix = index === 0 ? '\"apiContractFiles\": ' : '';\n        const suffix = index === pretty.length - 1 ? ',' : '';\n        return `    ${prefix}${line}${suffix}`;\n    });\n}\n\n/**\n * The `\"externalSystems\": {...}` block (4-space indent), with a trailing comma since `projects`\n * always follows. Omitted entirely when empty, so a repo that declares none keeps the exact file\n * shape it had before this existed — which is what makes adopting it a no-op diff.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling formatters here\nfunction externalSystemsLines(systems: ExternalSystemDecls): string[] {\n    if (Object.keys(systems).length === 0) return [];\n    const sorted: ExternalSystemDecls = {};\n    for (const identity of Object.keys(systems).sort()) sorted[identity] = systems[identity];\n    const pretty = JSON.stringify(sorted, null, 4).split('\\n');\n    return pretty.map((line: string, index: number) => {\n        const prefix = index === 0 ? '\"externalSystems\": ' : '';\n        const suffix = index === pretty.length - 1 ? ',' : '';\n        return `    ${prefix}${line}${suffix}`;\n    });\n}\n\n/**\n * Format one project entry's fields (12-space indent). Optional metadata\n * fields are only emitted when present.\n */\nfunction formatEntryLines(entry: GraphEntry): string[] {\n    const lines: string[] = [];\n    lines.push(`            \"level\": ${entry.level},`);\n\n    pushOptionalArrayField(lines, 'framework', entry.framework);\n    pushOptionalField(lines, 'role', entry.role);\n    // Right after role — role says what the project IS, this says what runtime it speaks. MUST be\n    // persisted: validate re-derives the runtime graph from this file, so a field written only\n    // in-memory by generate would make the two derive different graphs.\n    pushOptionalArrayField(lines, 'webpiecesRuntime', entry.webpiecesRuntime);\n    pushOptionalField(lines, 'serviceName', entry.serviceName);\n    pushOptionalCallsServiceField(lines, entry.callsService);\n    pushOptionalBooleanField(lines, 'drawOnGraph', entry.drawOnGraph);\n    // MUST be persisted: validate re-derives the runtime graph from this file, so a cut written only\n    // in-memory by generate would make generate and validate level (and cycle-check) different graphs.\n    pushOptionalArrayField(lines, 'cutLegacyCycle', entry.cutLegacyCycle);\n    // MUST be persisted: the runtime graph's product membership is re-derived from this file during\n    // validate, and the page's Product filter / color mode read it (#1179).\n    pushOptionalArrayField(lines, 'products', entry.products);\n    pushOptionalField(lines, 'shortDescription', entry.shortDescription);\n    pushOptionalField(lines, 'responsibilitiesFile', entry.responsibilitiesFile);\n    pushOptionalField(lines, 'designFile', entry.designFile);\n    pushApiRelationsField(lines, entry.apiRelations);\n    pushOptionalField(lines, 'runtimeDeclaration', entry.runtimeDeclaration);\n    pushOptionalBooleanField(lines, 'runtimeComposition', entry.runtimeComposition);\n\n    if (entry.dependsOn.length === 0) {\n        lines.push(`            \"dependsOn\": []`);\n    } else {\n        lines.push(`            \"dependsOn\": [`);\n        entry.dependsOn.forEach((dep: string, depIndex: number) => {\n            const depComma = depIndex === entry.dependsOn.length - 1 ? '' : ',';\n            lines.push(`                ${JSON.stringify(dep)}${depComma}`);\n        });\n        lines.push(`            ]`);\n    }\n    return lines;\n}\n\n/**\n * Emit one optional string field (12-space indent), skipped when undefined.\n */\nfunction pushOptionalField(lines: string[], field: string, value: string | undefined): void {\n    if (value !== undefined) {\n        lines.push(`            ${JSON.stringify(field)}: ${JSON.stringify(value)},`);\n    }\n}\n\n/**\n * Emit the optional `callsService` field (12-space indent). Unlike serviceName it may be EITHER a\n * single service name (string) OR an { apiClassName: serviceName } map, so it is emitted with\n * JSON.stringify to cover both inline. MUST be persisted here: the runtime graph's target resolution\n * reads it back from the committed dependencies.json during validate — dropping it would make\n * generate (which enriches it in-memory) and validate (which loads this file) derive different graphs.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling push*Field helpers here\nfunction pushOptionalCallsServiceField(\n    lines: string[],\n    value: string | Record<string, string> | undefined,\n): void {\n    if (value !== undefined) {\n        lines.push(`            \"callsService\": ${JSON.stringify(value)},`);\n    }\n}\n\n/**\n * Emit one optional boolean field (12-space indent) as a raw JSON boolean\n * (e.g. `\"drawOnGraph\": false,`), skipped when undefined.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling push*Field helpers here\nfunction pushOptionalBooleanField(\n    lines: string[],\n    field: string,\n    value: boolean | undefined,\n): void {\n    if (value !== undefined) {\n        lines.push(`            ${JSON.stringify(field)}: ${JSON.stringify(value)},`);\n    }\n}\n\n/**\n * Emit one optional string-array field (12-space indent) as a compact inline\n * JSON array (e.g. `\"framework\": [\"browser\",\"node\"],`), skipped when undefined.\n */\nfunction pushOptionalArrayField(lines: string[], field: string, value: string[] | undefined): void {\n    if (value !== undefined) {\n        lines.push(`            ${JSON.stringify(field)}: ${JSON.stringify(value)},`);\n    }\n}\n\n/**\n * Emit the optional `apiRelations` object (pretty, multi-line, reindented under\n * the 12-space entry block) with a trailing comma, since `dependsOn` always\n * follows it. Skipped when absent/empty so plain-lib-only projects stay compact.\n * The scanner already sorts owners + refs, so the JSON is deterministic.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling push*Field helpers here\nfunction pushApiRelationsField(lines: string[], value: ProjectApiRelations | undefined): void {\n    if (value === undefined || Object.keys(value).length === 0) return;\n    const pretty = JSON.stringify(value, null, 4).split('\\n');\n    pretty.forEach((line: string, index: number) => {\n        const prefix = index === 0 ? '\"apiRelations\": ' : '';\n        const suffix = index === pretty.length - 1 ? ',' : '';\n        lines.push(`            ${prefix}${line}${suffix}`);\n    });\n}\n\n/**\n * Save the graph to disk in the wrapper format with the standard aiInstructions.\n *\n * @param graph - The enriched project graph to save\n * @param workspaceRoot - Absolute path to workspace root\n * @param graphPath - Relative path to graph file (default: architecture/dependencies.json)\n */\nexport function saveGraph(\n    graph: EnhancedGraph,\n    workspaceRoot: string,\n    graphPath: string = DEFAULT_GRAPH_PATH,\n    apiContractFiles: ApiContractFileRefs = {},\n    externalSystems: ExternalSystemDecls = {},\n): void {\n    const fullPath = path.join(workspaceRoot, graphPath);\n    const dir = path.dirname(fullPath);\n\n    // Ensure directory exists\n    if (!fs.existsSync(dir)) {\n        fs.mkdirSync(dir, { recursive: true });\n    }\n\n    // Sort keys for deterministic output\n    const sortedGraph: EnhancedGraph = {};\n    const sortedKeys = Object.keys(graph).sort();\n    for (const key of sortedKeys) {\n        sortedGraph[key] = graph[key];\n    }\n\n    const content = formatGraphJson(\n        new DependenciesFile(\n            AI_INSTRUCTIONS,\n            GRAPH_COMMANDS,\n            sortedGraph,\n            apiContractFiles,\n            externalSystems,\n        ),\n    );\n    fs.writeFileSync(fullPath, content, 'utf-8');\n}\n\n/**\n * Check if the graph file exists\n */\nexport function graphFileExists(\n    workspaceRoot: string,\n    graphPath: string = DEFAULT_GRAPH_PATH,\n): boolean {\n    const fullPath = path.join(workspaceRoot, graphPath);\n    return fs.existsSync(fullPath);\n}\n"]}
+{"version":3,"file":"graph-loader.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/lib/graph-loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Graph Loader\n *\n * Handles loading and saving the blessed dependency graph file.\n * The graph is stored at architecture/dependencies.json in the workspace root.\n *\n * File format (schema aimed at AI consumers):\n * {\n *     \"aiInstructions\": \"...how AI should use the per-project fields...\",\n *     \"apiContractFiles\": { \"<ApiName>\": \"apis/<ApiName>.json\" },\n *     \"remoteServices\": { \"<serviceName>\": { \"label\"?, \"implements\": [{ \"api\", \"type\" }] } },\n *     \"projects\": {\n *         \"<project>\": { level, framework, products, shortDescription,\n *                        responsibilitiesFile, designFile, dependsOn }\n *     }\n * }\n *\n * `level` is the project's dependency depth, except that every server, client and app is pinned to\n * the TOP level (bundles above them), so the top row is exactly the entry points (#1179).\n *\n * `products` (#1179) is the sorted list of products whose `product:<name>`-tagged projects reach\n * this project over `dependsOn` — its blast radius. Absent when no product reaches it.\n *\n * `framework` is the project's libType — the SET of runtime environments it is\n * validated to run in, drawn from browser | react | angular | node | express\n * (e.g. [\"browser\",\"node\"]). It comes from the project's `framework:` nx tags\n * and is enforced across edges by the `library-types-match-client` rule.\n *\n * The legacy format (flat { \"<project>\": { level, dependsOn } } map) is still\n * readable so validation against a pre-upgrade file produces a clean\n * \"re-run architecture:generate\" diff instead of a parse failure.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport type { EnhancedGraph, GraphEntry } from './graph-sorter';\nimport { RuleFailError, Option } from '@webpieces/rules-config';\nimport type { ExternalSystemDecls, ProjectApiRelations } from './api-usage/api-relations';\nimport { API_CONTRACT_FILES_RULE, API_CONTRACTS_DIR } from './api-contract-files';\nimport type { ApiContractFileRefs } from './api-contract-files';\nimport { RemoteServicesCodec } from './remote-services';\nimport type { RemoteServices } from './remote-services';\nimport { toError } from '../toError';\n\n/**\n * Default path for the dependencies file (relative to workspace root)\n */\nexport const DEFAULT_GRAPH_PATH = 'architecture/dependencies.json';\n\n/**\n * Top-level instructions embedded in dependencies.json telling AI how to use\n * the per-project metadata fields.\n */\nexport const AI_INSTRUCTIONS =\n    \"Each project's shortDescription is only a summary. BEFORE adding code to a project, \" +\n    'read its responsibilitiesFile for the full responsibilities (what belongs in that ' +\n    'project and what does not), and read its designFile to understand the DI design ' +\n    'before reading the code. Use the entries in `commands` to regenerate these files ' +\n    'or display any of the graphs in a browser. To hide a project (its box AND every ' +\n    'edge touching it) from BOTH rendered architecture graphs, add the nx tag ' +\n    \"'drawOnGraph:false' to that project's project.json tags and regenerate; it stays \" +\n    'in this file (marked \"drawOnGraph\": false) but is omitted from the HTML. A role:server ' +\n    'with no webpiecesRuntime package anywhere in its dependency closure and no apiRelations is ' +\n    'omitted from the RUNTIME drawing the same way — it speaks none of the webpieces runtime, so ' +\n    \"it can only ever draw as a disconnected box; it stays in both JSON files. An API's endpoints \" +\n    '(name, kind, path, httpMethod, parameters, queueName, caller) are NOT in this file: ' +\n    '`apiContractFiles` maps each API to its generated contract file, apis/<ApiName>.json relative to ' +\n    \"this file — read that file for the API's endpoints.\";\n\n/**\n * Named command → \"command — what it does\" map embedded in dependencies.json.\n */\nexport type CommandMap = Record<string, string>;\n\n/**\n * Commands embedded in dependencies.json so AI (and humans) know how to\n * regenerate and DISPLAY the architecture + design graphs. These work in any\n * repo consuming @webpieces/nx-webpieces-rules.\n */\nexport const GRAPH_COMMANDS: CommandMap = {\n    regenerateArchitecture:\n        'pnpm nx run architecture:generate — rewrites architecture/dependencies.json, ' +\n        'architecture/apis/<ApiName>.json and architecture/runtime-dependencies.json; run after ' +\n        'reviewing project runtime-deps.json and API contract candidates into architecture/apis; generation reads approvals and never approves endpoint changes',\n    visualizeArchitecture:\n        'pnpm nx run architecture:visualize — opens the monorepo dependency graph (this file) ' +\n        'as HTML in a browser from saved data, without refreshing; freshness unknown',\n    visualizeRuntimeArchitecture:\n        'pnpm nx run architecture:visualize-runtime — opens the runtime microservice call graph ' +\n        'as HTML in a browser from saved data, without refreshing; freshness unknown',\n    regenerateDesigns:\n        \"pnpm nx run-many --target=di-graph-generate — rewrites every project's \" +\n        'design.json/design.md (also runs automatically on every build)',\n    visualizeDesign:\n        \"pnpm wp-design-visualize <project> — opens a project's DI designs (its designFile) as \" +\n        'HTML, one graph per controller with the controller at the top; no args = interactive picker',\n};\n\n/**\n * The full contents of architecture/dependencies.json.\n */\nexport class DependenciesFile {\n    constructor(\n        public readonly aiInstructions: string,\n        public readonly commands: CommandMap,\n        public readonly projects: EnhancedGraph,\n        /**\n         * apiClassName -> its contract file (`apis/<ApiName>.json`, relative to this file's\n         * directory). Only the LINK lives here, so adding an endpoint never changes dependencies.json;\n         * the contract itself is read with ApiContractFiles.load.\n         */\n        public readonly apiContractFiles: ApiContractFileRefs = {},\n        /**\n         * Declared external systems (databases, buckets, ...) keyed by identity. MUST be persisted:\n         * the runtime graph is derived from the committed files, so a declaration that is scanned but\n         * not written would make generate and validate disagree.\n         */\n        public readonly externalSystems: ExternalSystemDecls = {},\n        /**\n         * REVIEWED out-of-workspace services a `uses` may target (#1203), keyed by service name. Like\n         * `apiContractFiles` it is approval metadata: generation reads it and writes it back verbatim,\n         * and never infers or adds an entry. See remote-services.ts.\n         */\n        public readonly remoteServices: RemoteServices = {},\n    ) {}\n}\n\n/**\n * Load the blessed graph from disk. Understands both the current wrapper\n * format and the legacy flat map (which loads with empty aiInstructions).\n *\n * @param workspaceRoot - Absolute path to workspace root\n * @param graphPath - Relative path to graph file (default: architecture/dependencies.json)\n * @returns The blessed graph file, or null if it doesn't exist\n */\nexport function loadBlessedGraph(\n    workspaceRoot: string,\n    graphPath: string = DEFAULT_GRAPH_PATH,\n): DependenciesFile | null {\n    const fullPath = path.join(workspaceRoot, graphPath);\n\n    if (!fs.existsSync(fullPath)) {\n        return null;\n    }\n\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        const content = fs.readFileSync(fullPath, 'utf-8');\n        const parsed = JSON.parse(content);\n        if (parsed !== null && typeof parsed === 'object' && 'apiContracts' in parsed) {\n            throw movedApiContractsError(fullPath, graphPath);\n        }\n        if (parsed !== null && typeof parsed === 'object' && 'projects' in parsed) {\n            return new DependenciesFile(\n                typeof parsed.aiInstructions === 'string' ? parsed.aiInstructions : '',\n                parsed.commands !== null && typeof parsed.commands === 'object'\n                    ? (parsed.commands as CommandMap)\n                    : {},\n                parsed.projects as EnhancedGraph,\n                parsed.apiContractFiles !== null && typeof parsed.apiContractFiles === 'object'\n                    ? (parsed.apiContractFiles as ApiContractFileRefs)\n                    : {},\n                // Absent in any file written before external systems could be declared; an empty\n                // table simply draws no shaped nodes, which is exactly the old rendering.\n                parsed.externalSystems !== null && typeof parsed.externalSystems === 'object'\n                    ? (parsed.externalSystems as ExternalSystemDecls)\n                    : {},\n                new RemoteServicesCodec().decode(parsed.remoteServices, fullPath),\n            );\n        }\n        // Legacy flat format: the whole object is the project map\n        return new DependenciesFile('', {}, parsed as EnhancedGraph);\n    } catch (err: unknown) {\n        const error = toError(err);\n        if (error instanceof RuleFailError) throw error;\n        throw new Error(`Failed to load graph from ${fullPath}`, { cause: error });\n    }\n}\n\n/**\n * The endpoint table moved out of dependencies.json (#949). A file still carrying `apiContracts` was\n * written by an older generator; it is REJECTED rather than read, so there is one place a contract\n * lives and the runtime graph can never read a stale copy of it.\n */\n// webpieces-disable no-function-outside-class -- error builder for loadBlessedGraph, module-scope like its siblings\nfunction movedApiContractsError(fullPath: string, graphPath: string): RuleFailError {\n    const apisDir = path.join(path.dirname(graphPath), API_CONTRACTS_DIR);\n    return new RuleFailError(\n        API_CONTRACT_FILES_RULE,\n        `${fullPath} still carries the \\`apiContracts\\` key. It moved: each API's contract now lives in ` +\n            `${apisDir}/<ApiName>.json, and dependencies.json only links to it under \\`apiContractFiles\\`.`,\n        undefined,\n        undefined,\n        [\n            new Option(\n                `Explicitly move each saved apiContracts.<ApiName> value into ${apisDir}/<ApiName>.json, replace apiContracts with reviewed apiContractFiles entries mapping each name to apis/<ApiName>.json, preserve externalSystems, and approve runtime-deps.json for all runtime owners. Then run pnpm nx run architecture:generate and review the result.`,\n                true,\n            ),\n        ],\n    );\n}\n\n/**\n * Format the dependencies file as JSON with multi-line arrays for readability\n */\nfunction formatGraphJson(file: DependenciesFile): string {\n    const lines: string[] = ['{'];\n    lines.push(`    \"aiInstructions\": ${JSON.stringify(file.aiInstructions)},`);\n    lines.push(`    \"commands\": {`);\n    const commandNames = Object.keys(file.commands);\n    commandNames.forEach((name: string, index: number) => {\n        const comma = index === commandNames.length - 1 ? '' : ',';\n        lines.push(\n            `        ${JSON.stringify(name)}: ${JSON.stringify(file.commands[name])}${comma}`,\n        );\n    });\n    lines.push(`    },`);\n    lines.push(...apiContractFilesLines(file.apiContractFiles));\n    lines.push(...externalSystemsLines(file.externalSystems));\n    lines.push(...remoteServicesLines(file.remoteServices));\n    lines.push(`    \"projects\": {`);\n\n    const keys = Object.keys(file.projects).sort();\n    keys.forEach((key: string, index: number) => {\n        const entry = file.projects[key];\n        const isLast = index === keys.length - 1;\n        const comma = isLast ? '' : ',';\n\n        lines.push(`        ${JSON.stringify(key)}: {`);\n        lines.push(...formatEntryLines(entry));\n        lines.push(`        }${comma}`);\n    });\n\n    lines.push('    }');\n    lines.push('}');\n    return lines.join('\\n') + '\\n';\n}\n\n/**\n * The `\"apiContractFiles\": {...}` block (4-space indent), with a trailing comma since `projects`\n * always follows it. Omitted entirely when empty. Keys are sorted, so the output is deterministic.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling formatters here\nfunction apiContractFilesLines(refs: ApiContractFileRefs): string[] {\n    if (Object.keys(refs).length === 0) return [];\n    const sorted: ApiContractFileRefs = {};\n    for (const api of Object.keys(refs).sort()) sorted[api] = refs[api];\n    const pretty = JSON.stringify(sorted, null, 4).split('\\n');\n    return pretty.map((line: string, index: number) => {\n        const prefix = index === 0 ? '\"apiContractFiles\": ' : '';\n        const suffix = index === pretty.length - 1 ? ',' : '';\n        return `    ${prefix}${line}${suffix}`;\n    });\n}\n\n/**\n * The `\"externalSystems\": {...}` block (4-space indent), with a trailing comma since `projects`\n * always follows. Omitted entirely when empty, so a repo that declares none keeps the exact file\n * shape it had before this existed — which is what makes adopting it a no-op diff.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling formatters here\nfunction externalSystemsLines(systems: ExternalSystemDecls): string[] {\n    if (Object.keys(systems).length === 0) return [];\n    const sorted: ExternalSystemDecls = {};\n    for (const identity of Object.keys(systems).sort()) sorted[identity] = systems[identity];\n    const pretty = JSON.stringify(sorted, null, 4).split('\\n');\n    return pretty.map((line: string, index: number) => {\n        const prefix = index === 0 ? '\"externalSystems\": ' : '';\n        const suffix = index === pretty.length - 1 ? ',' : '';\n        return `    ${prefix}${line}${suffix}`;\n    });\n}\n\n/**\n * The reviewed `\"remoteServices\": {...}` block (4-space indent), with a trailing comma since `projects`\n * always follows. Omitted entirely when empty, so a repo that declares none keeps its exact file shape.\n * Service names are sorted; each entry is written as it was reviewed.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling formatters here\nfunction remoteServicesLines(services: RemoteServices): string[] {\n    if (Object.keys(services).length === 0) return [];\n    const sorted: RemoteServices = {};\n    for (const name of Object.keys(services).sort()) sorted[name] = services[name];\n    const pretty = JSON.stringify(sorted, null, 4).split('\\n');\n    return pretty.map((line: string, index: number) => {\n        const prefix = index === 0 ? '\"remoteServices\": ' : '';\n        const suffix = index === pretty.length - 1 ? ',' : '';\n        return `    ${prefix}${line}${suffix}`;\n    });\n}\n\n/**\n * Format one project entry's fields (12-space indent). Optional metadata\n * fields are only emitted when present.\n */\nfunction formatEntryLines(entry: GraphEntry): string[] {\n    const lines: string[] = [];\n    lines.push(`            \"level\": ${entry.level},`);\n\n    pushOptionalArrayField(lines, 'framework', entry.framework);\n    pushOptionalField(lines, 'role', entry.role);\n    // Right after role — role says what the project IS, this says what runtime it speaks. MUST be\n    // persisted: validate re-derives the runtime graph from this file, so a field written only\n    // in-memory by generate would make the two derive different graphs.\n    pushOptionalArrayField(lines, 'webpiecesRuntime', entry.webpiecesRuntime);\n    pushOptionalField(lines, 'serviceName', entry.serviceName);\n    pushOptionalCallsServiceField(lines, entry.callsService);\n    pushOptionalBooleanField(lines, 'drawOnGraph', entry.drawOnGraph);\n    // MUST be persisted: validate re-derives the runtime graph from this file, so a cut written only\n    // in-memory by generate would make generate and validate level (and cycle-check) different graphs.\n    pushOptionalArrayField(lines, 'cutLegacyCycle', entry.cutLegacyCycle);\n    // MUST be persisted: the runtime graph's product membership is re-derived from this file during\n    // validate, and the page's Product filter / color mode read it (#1179).\n    pushOptionalArrayField(lines, 'products', entry.products);\n    pushOptionalField(lines, 'shortDescription', entry.shortDescription);\n    pushOptionalField(lines, 'responsibilitiesFile', entry.responsibilitiesFile);\n    pushOptionalField(lines, 'designFile', entry.designFile);\n    pushApiRelationsField(lines, entry.apiRelations);\n    pushOptionalField(lines, 'runtimeDeclaration', entry.runtimeDeclaration);\n    pushOptionalBooleanField(lines, 'runtimeComposition', entry.runtimeComposition);\n\n    if (entry.dependsOn.length === 0) {\n        lines.push(`            \"dependsOn\": []`);\n    } else {\n        lines.push(`            \"dependsOn\": [`);\n        entry.dependsOn.forEach((dep: string, depIndex: number) => {\n            const depComma = depIndex === entry.dependsOn.length - 1 ? '' : ',';\n            lines.push(`                ${JSON.stringify(dep)}${depComma}`);\n        });\n        lines.push(`            ]`);\n    }\n    return lines;\n}\n\n/**\n * Emit one optional string field (12-space indent), skipped when undefined.\n */\nfunction pushOptionalField(lines: string[], field: string, value: string | undefined): void {\n    if (value !== undefined) {\n        lines.push(`            ${JSON.stringify(field)}: ${JSON.stringify(value)},`);\n    }\n}\n\n/**\n * Emit the optional `callsService` field (12-space indent). Unlike serviceName it may be EITHER a\n * single service name (string) OR an { apiClassName: serviceName } map, so it is emitted with\n * JSON.stringify to cover both inline. MUST be persisted here: the runtime graph's target resolution\n * reads it back from the committed dependencies.json during validate — dropping it would make\n * generate (which enriches it in-memory) and validate (which loads this file) derive different graphs.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling push*Field helpers here\nfunction pushOptionalCallsServiceField(\n    lines: string[],\n    value: string | Record<string, string> | undefined,\n): void {\n    if (value !== undefined) {\n        lines.push(`            \"callsService\": ${JSON.stringify(value)},`);\n    }\n}\n\n/**\n * Emit one optional boolean field (12-space indent) as a raw JSON boolean\n * (e.g. `\"drawOnGraph\": false,`), skipped when undefined.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling push*Field helpers here\nfunction pushOptionalBooleanField(\n    lines: string[],\n    field: string,\n    value: boolean | undefined,\n): void {\n    if (value !== undefined) {\n        lines.push(`            ${JSON.stringify(field)}: ${JSON.stringify(value)},`);\n    }\n}\n\n/**\n * Emit one optional string-array field (12-space indent) as a compact inline\n * JSON array (e.g. `\"framework\": [\"browser\",\"node\"],`), skipped when undefined.\n */\nfunction pushOptionalArrayField(lines: string[], field: string, value: string[] | undefined): void {\n    if (value !== undefined) {\n        lines.push(`            ${JSON.stringify(field)}: ${JSON.stringify(value)},`);\n    }\n}\n\n/**\n * Emit the optional `apiRelations` object (pretty, multi-line, reindented under\n * the 12-space entry block) with a trailing comma, since `dependsOn` always\n * follows it. Skipped when absent/empty so plain-lib-only projects stay compact.\n * The scanner already sorts owners + refs, so the JSON is deterministic.\n */\n// webpieces-disable no-function-outside-class -- module-scope formatter, matches the sibling push*Field helpers here\nfunction pushApiRelationsField(lines: string[], value: ProjectApiRelations | undefined): void {\n    if (value === undefined || Object.keys(value).length === 0) return;\n    const pretty = JSON.stringify(value, null, 4).split('\\n');\n    pretty.forEach((line: string, index: number) => {\n        const prefix = index === 0 ? '\"apiRelations\": ' : '';\n        const suffix = index === pretty.length - 1 ? ',' : '';\n        lines.push(`            ${prefix}${line}${suffix}`);\n    });\n}\n\n/**\n * Save the graph to disk in the wrapper format with the standard aiInstructions.\n *\n * @param graph - The enriched project graph to save\n * @param workspaceRoot - Absolute path to workspace root\n * @param graphPath - Relative path to graph file (default: architecture/dependencies.json)\n */\nexport function saveGraph(\n    graph: EnhancedGraph,\n    workspaceRoot: string,\n    graphPath: string = DEFAULT_GRAPH_PATH,\n    apiContractFiles: ApiContractFileRefs = {},\n    externalSystems: ExternalSystemDecls = {},\n    remoteServices: RemoteServices = {},\n): void {\n    const fullPath = path.join(workspaceRoot, graphPath);\n    const dir = path.dirname(fullPath);\n\n    // Ensure directory exists\n    if (!fs.existsSync(dir)) {\n        fs.mkdirSync(dir, { recursive: true });\n    }\n\n    // Sort keys for deterministic output\n    const sortedGraph: EnhancedGraph = {};\n    const sortedKeys = Object.keys(graph).sort();\n    for (const key of sortedKeys) {\n        sortedGraph[key] = graph[key];\n    }\n\n    const content = formatGraphJson(\n        new DependenciesFile(\n            AI_INSTRUCTIONS,\n            GRAPH_COMMANDS,\n            sortedGraph,\n            apiContractFiles,\n            externalSystems,\n            remoteServices,\n        ),\n    );\n    fs.writeFileSync(fullPath, content, 'utf-8');\n}\n\n/**\n * Check if the graph file exists\n */\nexport function graphFileExists(\n    workspaceRoot: string,\n    graphPath: string = DEFAULT_GRAPH_PATH,\n): boolean {\n    const fullPath = path.join(workspaceRoot, graphPath);\n    return fs.existsSync(fullPath);\n}\n"]}

package/src/lib/remote-service-node-id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The DOT/node identity of a reviewed remote service (#1203). Prefixed so it can never collide with a
+ * workspace service node (whose identity is its project key), and reduced to DOT-safe characters like
+ * every other synthetic node id. One owner so the drawing and the detail panel agree on the id.
+ */
+export declare class RemoteServiceNodeId {
+    of(name: string): string;
+}

package/src/lib/remote-service-node-id.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteServiceNodeId = void 0;
+/**
+ * The DOT/node identity of a reviewed remote service (#1203). Prefixed so it can never collide with a
+ * workspace service node (whose identity is its project key), and reduced to DOT-safe characters like
+ * every other synthetic node id. One owner so the drawing and the detail panel agree on the id.
+ */
+class RemoteServiceNodeId {
+    of(name) {
+        return `remote__${name.replace(/[^A-Za-z0-9_]/g, '_')}`;
+    }
+}
+exports.RemoteServiceNodeId = RemoteServiceNodeId;
+//# sourceMappingURL=remote-service-node-id.js.map

package/src/lib/remote-service-node-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-service-node-id.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/lib/remote-service-node-id.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,mBAAmB;IAC5B,EAAE,CAAC,IAAY;QACX,OAAO,WAAW,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC;IAC5D,CAAC;CACJ;AAJD,kDAIC","sourcesContent":["/**\n * The DOT/node identity of a reviewed remote service (#1203). Prefixed so it can never collide with a\n * workspace service node (whose identity is its project key), and reduced to DOT-safe characters like\n * every other synthetic node id. One owner so the drawing and the detail panel agree on the id.\n */\nexport class RemoteServiceNodeId {\n    of(name: string): string {\n        return `remote__${name.replace(/[^A-Za-z0-9_]/g, '_')}`;\n    }\n}\n"]}

package/src/lib/remote-services.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Remote services (#1203)
+ *
+ * The REVIEWED `remoteServices` table of architecture/dependencies.json: services this workspace calls
+ * that are NOT Nx projects in it — a service in another repo, a VM, partner endpoints whose host is set
+ * per call. Each is keyed by the service name a `uses` relation targets (`targetService`) and lists the
+ * contracts it implements, with their transport:
+ *
+ * ```json
+ * "remoteServices": {
+ *     "reporter-vm": { "label": "reporter VM", "implements": [{ "api": "ReporterTriggerApi", "type": "rpc" }] }
+ * }
+ * ```
+ *
+ * It is approval metadata, exactly like `apiContractFiles`: a human writes it, generation READS it and
+ * writes it back unchanged, and nothing ever infers or adds an entry. Absent means "this workspace calls
+ * no service outside itself", which is the only reading a repo that never wrote the key can have.
+ *
+ * The shape is decoded strictly at load time — an unknown key, an empty `implements`, a transport that
+ * is not rpc/pubsub — fails the load naming the entry, so a typo can never quietly widen what a `uses`
+ * may target.
+ */
+/** The transports a remote service can implement. A vendor (`external`) seam is an externalSystem. */
+export type RemoteServiceTransport = 'rpc' | 'pubsub';
+/** One contract a remote service implements, with the transport it is served over. */
+export declare class RemoteServiceApi {
+    readonly api: string;
+    readonly type: RemoteServiceTransport;
+    constructor(api: string, type: RemoteServiceTransport);
+}
+/** One out-of-workspace service: an optional display label and the contracts it implements. */
+export declare class RemoteService {
+    /** Display text only; the node identity is the table KEY (the name `uses` targets). */
+    readonly label: string | undefined;
+    /** Never empty: a remote service that implements nothing could be the target of nothing. */
+    readonly implements: RemoteServiceApi[];
+    constructor(
+    /** Display text only; the node identity is the table KEY (the name `uses` targets). */
+    label: string | undefined, implementations: RemoteServiceApi[]);
+    implementsApi(api: string, type: string): boolean;
+}
+/** service name -> its reviewed declaration. Serialized as the `remoteServices` key of dependencies.json. */
+export type RemoteServices = Record<string, RemoteService>;
+export declare const REMOTE_SERVICES_RULE = "validate-runtime-architecture";
+/** Strict decoder for the `remoteServices` value of a parsed dependencies.json. */
+export declare class RemoteServicesCodec {
+    decode(value: unknown, fullPath: string): RemoteServices;
+    private implementations;
+    private implementation;
+    private record;
+    private onlyKeys;
+    private fail;
+}

package/src/lib/remote-services.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Remote services (#1203)
+ *
+ * The REVIEWED `remoteServices` table of architecture/dependencies.json: services this workspace calls
+ * that are NOT Nx projects in it — a service in another repo, a VM, partner endpoints whose host is set
+ * per call. Each is keyed by the service name a `uses` relation targets (`targetService`) and lists the
+ * contracts it implements, with their transport:
+ *
+ * ```json
+ * "remoteServices": {
+ *     "reporter-vm": { "label": "reporter VM", "implements": [{ "api": "ReporterTriggerApi", "type": "rpc" }] }
+ * }
+ * ```
+ *
+ * It is approval metadata, exactly like `apiContractFiles`: a human writes it, generation READS it and
+ * writes it back unchanged, and nothing ever infers or adds an entry. Absent means "this workspace calls
+ * no service outside itself", which is the only reading a repo that never wrote the key can have.
+ *
+ * The shape is decoded strictly at load time — an unknown key, an empty `implements`, a transport that
+ * is not rpc/pubsub — fails the load naming the entry, so a typo can never quietly widen what a `uses`
+ * may target.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteServicesCodec = exports.REMOTE_SERVICES_RULE = exports.RemoteService = exports.RemoteServiceApi = void 0;
+const rules_config_1 = require("@webpieces/rules-config");
+/** One contract a remote service implements, with the transport it is served over. */
+class RemoteServiceApi {
+    api;
+    type;
+    constructor(api, type) {
+        this.api = api;
+        this.type = type;
+    }
+}
+exports.RemoteServiceApi = RemoteServiceApi;
+/** One out-of-workspace service: an optional display label and the contracts it implements. */
+class RemoteService {
+    label;
+    /** Never empty: a remote service that implements nothing could be the target of nothing. */
+    implements;
+    constructor(
+    /** Display text only; the node identity is the table KEY (the name `uses` targets). */
+    label, implementations) {
+        this.label = label;
+        this.implements = implementations;
+    }
+    implementsApi(api, type) {
+        return this.implements.some((entry) => entry.api === api && entry.type === type);
+    }
+}
+exports.RemoteService = RemoteService;
+exports.REMOTE_SERVICES_RULE = 'validate-runtime-architecture';
+const SERVICE_KEYS = ['label', 'implements'];
+const API_KEYS = ['api', 'type'];
+/** Strict decoder for the `remoteServices` value of a parsed dependencies.json. */
+class RemoteServicesCodec {
+    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary
+    decode(value, fullPath) {
+        if (value === undefined)
+            return {};
+        const table = this.record(value, fullPath, 'remoteServices');
+        const services = {};
+        for (const name of Object.keys(table).sort()) {
+            const where = `remoteServices.${name}`;
+            if (name.trim() === '' || name !== name.trim())
+                this.fail(fullPath, `${where}: a remote service name must be a non-empty name without surrounding spaces.`);
+            const entry = this.record(table[name], fullPath, where);
+            this.onlyKeys(entry, SERVICE_KEYS, fullPath, where);
+            const label = entry['label'];
+            if (label !== undefined && (typeof label !== 'string' || label.trim() === ''))
+                this.fail(fullPath, `${where}.label must be a non-empty string when present.`);
+            services[name] = new RemoteService(label, this.implementations(entry['implements'], fullPath, where));
+        }
+        return services;
+    }
+    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary
+    implementations(value, fullPath, where) {
+        if (!Array.isArray(value) || value.length === 0)
+            this.fail(fullPath, `${where}.implements must be a non-empty array of { "api": "<ApiName>", "type": "rpc" | "pubsub" }.`);
+        const seen = new Set();
+        const result = [];
+        for (let index = 0; index < value.length; index++) {
+            const entry = this.implementation(value[index], fullPath, `${where}.implements[${index}]`);
+            if (seen.has(entry.api))
+                this.fail(fullPath, `${where}.implements[${index}]: ${entry.api} is declared twice in ${where}.implements.`);
+            seen.add(entry.api);
+            result.push(entry);
+        }
+        return result;
+    }
+    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary
+    implementation(item, fullPath, at) {
+        const entry = this.record(item, fullPath, at);
+        this.onlyKeys(entry, API_KEYS, fullPath, at);
+        const api = entry['api'];
+        const type = entry['type'];
+        if (typeof api !== 'string' || api.trim() === '')
+            this.fail(fullPath, `${at}.api must be the contract's class name (e.g. "ReporterTriggerApi").`);
+        if (type !== 'rpc' && type !== 'pubsub')
+            this.fail(fullPath, `${at}.type must be "rpc" or "pubsub", got ${JSON.stringify(type)}. A vendor contract is an externalSystem, not a remote service.`);
+        return new RemoteServiceApi(api, type);
+    }
+    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary
+    record(value, fullPath, where) {
+        if (value === null || typeof value !== 'object' || Array.isArray(value))
+            this.fail(fullPath, `${where} must be a JSON object.`);
+        return value;
+    }
+    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary
+    onlyKeys(entry, allowed, fullPath, where) {
+        for (const key of Object.keys(entry))
+            if (!allowed.includes(key))
+                this.fail(fullPath, `${where}: unknown key "${key}" (allowed: ${allowed.join(', ')}).`);
+    }
+    fail(fullPath, message) {
+        throw new rules_config_1.RuleFailError(exports.REMOTE_SERVICES_RULE, `${fullPath}: ${message}`, undefined, undefined, [
+            new rules_config_1.Option('Fix the reviewed remoteServices entry in architecture/dependencies.json: each key is a service name outside this workspace, mapped to { "label"?: "<display text>", "implements": [{ "api": "<ApiName>", "type": "rpc" | "pubsub" }] }. Generation never writes or infers this table.', true),
+        ]);
+    }
+}
+exports.RemoteServicesCodec = RemoteServicesCodec;
+//# sourceMappingURL=remote-services.js.map

package/src/lib/remote-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-services.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/lib/remote-services.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Remote services (#1203)\n *\n * The REVIEWED `remoteServices` table of architecture/dependencies.json: services this workspace calls\n * that are NOT Nx projects in it — a service in another repo, a VM, partner endpoints whose host is set\n * per call. Each is keyed by the service name a `uses` relation targets (`targetService`) and lists the\n * contracts it implements, with their transport:\n *\n * ```json\n * \"remoteServices\": {\n *     \"reporter-vm\": { \"label\": \"reporter VM\", \"implements\": [{ \"api\": \"ReporterTriggerApi\", \"type\": \"rpc\" }] }\n * }\n * ```\n *\n * It is approval metadata, exactly like `apiContractFiles`: a human writes it, generation READS it and\n * writes it back unchanged, and nothing ever infers or adds an entry. Absent means \"this workspace calls\n * no service outside itself\", which is the only reading a repo that never wrote the key can have.\n *\n * The shape is decoded strictly at load time — an unknown key, an empty `implements`, a transport that\n * is not rpc/pubsub — fails the load naming the entry, so a typo can never quietly widen what a `uses`\n * may target.\n */\n\nimport { Option, RuleFailError } from '@webpieces/rules-config';\n\n/** The transports a remote service can implement. A vendor (`external`) seam is an externalSystem. */\nexport type RemoteServiceTransport = 'rpc' | 'pubsub';\n\n/** One contract a remote service implements, with the transport it is served over. */\nexport class RemoteServiceApi {\n    constructor(\n        public readonly api: string,\n        public readonly type: RemoteServiceTransport,\n    ) {}\n}\n\n/** One out-of-workspace service: an optional display label and the contracts it implements. */\nexport class RemoteService {\n    /** Never empty: a remote service that implements nothing could be the target of nothing. */\n    readonly implements: RemoteServiceApi[];\n\n    constructor(\n        /** Display text only; the node identity is the table KEY (the name `uses` targets). */\n        public readonly label: string | undefined,\n        implementations: RemoteServiceApi[],\n    ) {\n        this.implements = implementations;\n    }\n\n    implementsApi(api: string, type: string): boolean {\n        return this.implements.some(\n            (entry: RemoteServiceApi) => entry.api === api && entry.type === type,\n        );\n    }\n}\n\n/** service name -> its reviewed declaration. Serialized as the `remoteServices` key of dependencies.json. */\nexport type RemoteServices = Record<string, RemoteService>;\n\nexport const REMOTE_SERVICES_RULE = 'validate-runtime-architecture';\n\nconst SERVICE_KEYS = ['label', 'implements'];\nconst API_KEYS = ['api', 'type'];\n\n/** Strict decoder for the `remoteServices` value of a parsed dependencies.json. */\nexport class RemoteServicesCodec {\n    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary\n    decode(value: unknown, fullPath: string): RemoteServices {\n        if (value === undefined) return {};\n        const table = this.record(value, fullPath, 'remoteServices');\n        const services: RemoteServices = {};\n        for (const name of Object.keys(table).sort()) {\n            const where = `remoteServices.${name}`;\n            if (name.trim() === '' || name !== name.trim())\n                this.fail(fullPath, `${where}: a remote service name must be a non-empty name without surrounding spaces.`);\n            const entry = this.record(table[name], fullPath, where);\n            this.onlyKeys(entry, SERVICE_KEYS, fullPath, where);\n            const label = entry['label'];\n            if (label !== undefined && (typeof label !== 'string' || label.trim() === ''))\n                this.fail(fullPath, `${where}.label must be a non-empty string when present.`);\n            services[name] = new RemoteService(\n                label as string | undefined,\n                this.implementations(entry['implements'], fullPath, where),\n            );\n        }\n        return services;\n    }\n\n    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary\n    private implementations(value: unknown, fullPath: string, where: string): RemoteServiceApi[] {\n        if (!Array.isArray(value) || value.length === 0)\n            this.fail(\n                fullPath,\n                `${where}.implements must be a non-empty array of { \"api\": \"<ApiName>\", \"type\": \"rpc\" | \"pubsub\" }.`,\n            );\n        const seen = new Set<string>();\n        const result: RemoteServiceApi[] = [];\n        for (let index = 0; index < value.length; index++) {\n            const entry = this.implementation(value[index], fullPath, `${where}.implements[${index}]`);\n            if (seen.has(entry.api))\n                this.fail(fullPath, `${where}.implements[${index}]: ${entry.api} is declared twice in ${where}.implements.`);\n            seen.add(entry.api);\n            result.push(entry);\n        }\n        return result;\n    }\n\n    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary\n    private implementation(item: unknown, fullPath: string, at: string): RemoteServiceApi {\n        const entry = this.record(item, fullPath, at);\n        this.onlyKeys(entry, API_KEYS, fullPath, at);\n        const api = entry['api'];\n        const type = entry['type'];\n        if (typeof api !== 'string' || api.trim() === '')\n            this.fail(fullPath, `${at}.api must be the contract's class name (e.g. \"ReporterTriggerApi\").`);\n        if (type !== 'rpc' && type !== 'pubsub')\n            this.fail(\n                fullPath,\n                `${at}.type must be \"rpc\" or \"pubsub\", got ${JSON.stringify(type)}. A vendor contract is an externalSystem, not a remote service.`,\n            );\n        return new RemoteServiceApi(api, type);\n    }\n\n    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary\n    private record(value: unknown, fullPath: string, where: string): Record<string, unknown> {\n        if (value === null || typeof value !== 'object' || Array.isArray(value))\n            this.fail(fullPath, `${where} must be a JSON object.`);\n        return value as Record<string, unknown>;\n    }\n\n    // webpieces-disable no-any-unknown -- untrusted JSON is narrowed and validated at the input boundary\n    private onlyKeys(entry: Record<string, unknown>, allowed: string[], fullPath: string, where: string): void {\n        for (const key of Object.keys(entry))\n            if (!allowed.includes(key))\n                this.fail(fullPath, `${where}: unknown key \"${key}\" (allowed: ${allowed.join(', ')}).`);\n    }\n\n    private fail(fullPath: string, message: string): never {\n        throw new RuleFailError(REMOTE_SERVICES_RULE, `${fullPath}: ${message}`, undefined, undefined, [\n            new Option(\n                'Fix the reviewed remoteServices entry in architecture/dependencies.json: each key is a service name outside this workspace, mapped to { \"label\"?: \"<display text>\", \"implements\": [{ \"api\": \"<ApiName>\", \"type\": \"rpc\" | \"pubsub\" }] }. Generation never writes or infers this table.',\n                true,\n            ),\n        ]);\n    }\n}\n"]}

package/src/lib/runtime-details.d.ts

@@ -10,6 +10,13 @@ export declare class RuntimeDetails {
     readonly nodes: Record<string, RuntimeNodeDetails>;
     readonly edges: Record<string, string[]>;
     constructor(graph: RuntimeGraph, showExternalNodes: boolean, model?: GraphRenderModel | null);
+    /** A reviewed remote service's node details: the contracts its declaration says it implements. */
+    private remoteNodes;
+    /**
+     * The edge details for `name`'s calls into reviewed remote services (#1203), also appended to
+     * `used`; returns the contracts covered so they are not reported as an unknown target.
+     */
+    private remoteCalls;
     /** Bind detail facts to renderer-owned identities, including grouped queue hops. */
     private renderEdges;
     script(): string;

package/src/lib/runtime-details.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RuntimeDetails = exports.RuntimeNodeDetails = void 0;
+const remote_service_node_id_1 = require("./remote-service-node-id");
 class RuntimeNodeDetails {
     implemented;
     used;
@@ -29,9 +30,12 @@ class RuntimeDetails {
                 if (edge.type !== 'pubsub')
                     this.edges[`${edge.from}->${edge.to}`] = entries;
             }
+            const remoteApis = this.remoteCalls(graph, name, service.wiringUses === undefined ? used : []);
             for (const api of service.wiringUses === undefined ? service.uses : []) {
                 if (graph.runtimeEdges.some((edge) => edge.from === name && edge.via.includes(api)))
                     continue;
+                if (remoteApis.has(api))
+                    continue;
                 const contract = graph.apis[api];
                 const external = contract?.type === 'external' || contract?.implementedBy.length === 0;
                 used.push(`${contract?.owner ?? '?'}#${api} → ${external ? (contract?.externalSystem?.label ?? contract?.owner ?? 'unknown external') : 'unknown / inferred target'}` +
@@ -63,9 +67,32 @@ class RuntimeDetails {
             }
             this.nodes[name] = new RuntimeNodeDetails(implemented, [...new Set(used)]);
         }
+        this.remoteNodes(graph);
         if (model !== null)
             this.renderEdges(graph, model);
     }
+    /** A reviewed remote service's node details: the contracts its declaration says it implements. */
+    remoteNodes(graph) {
+        for (const [name, remote] of Object.entries(graph.remoteServices ?? {}))
+            this.nodes[new remote_service_node_id_1.RemoteServiceNodeId().of(name)] = new RuntimeNodeDetails(remote.implements.map((api) => `${api} — declared in remoteServices.${name}`), []);
+    }
+    /**
+     * The edge details for `name`'s calls into reviewed remote services (#1203), also appended to
+     * `used`; returns the contracts covered so they are not reported as an unknown target.
+     */
+    remoteCalls(graph, name, used) {
+        const covered = new Set();
+        for (const [remoteName, remote] of Object.entries(graph.remoteServices ?? {}))
+            for (const call of remote.calledBy.filter((entry) => entry.from === name)) {
+                const entries = call.via.map((api) => `${graph.apis[api]?.owner ?? '?'}#${api} → ${remoteName} (remote service, ${call.type})`);
+                for (const api of call.via)
+                    covered.add(api);
+                used.push(...entries);
+                const key = `${name}->${new remote_service_node_id_1.RemoteServiceNodeId().of(remoteName)}`;
+                this.edges[key] = [...(this.edges[key] ?? []), ...entries];
+            }
+        return covered;
+    }
     /** Bind detail facts to renderer-owned identities, including grouped queue hops. */
     renderEdges(graph, model) {
         for (const edge of model.edges) {