@webpieces/nx-webpieces-rules 0.3.235 → 0.3.237

package/src/lib/di-graph/serializer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DI Graph Serializer
+ *
+ * Deterministic serialization for design.json: every collection sorted, no
+ * timestamps, workspace-relative posix paths only — so the committed file is
+ * byte-identical across regenerations of an unchanged graph.
+ */
+import { DiGraph } from './model';
+/** Sort all graph collections in place (stable output order). */
+export declare function sortGraph(graph: DiGraph): DiGraph;
+/** Serialize a (sorted) graph to the design.json file content. */
+export declare function toDesignJson(graph: DiGraph): string;

package/src/lib/di-graph/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/lib/di-graph/serializer.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAmBH,8BAMC;AAGD,oCAGC;AA3BD,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS;IACtC,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IACzB,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,iEAAiE;AACjE,SAAgB,SAAS,CAAC,KAAc;IACpC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACnB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,CAAC,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,kEAAkE;AAClE,SAAgB,YAAY,CAAC,KAAc;IACvC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AACjD,CAAC","sourcesContent":["/**\n * DI Graph Serializer\n *\n * Deterministic serialization for design.json: every collection sorted, no\n * timestamps, workspace-relative posix paths only — so the committed file is\n * byte-identical across regenerations of an unchanged graph.\n */\n\nimport { DiEdge, DiGraph, DiNode } from './model';\n\nfunction compareNodes(a: DiNode, b: DiNode): number {\n    return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;\n}\n\nfunction edgeKey(edge: DiEdge): string {\n    return `${edge.from}\u0000${edge.to}\u0000${edge.tokenKey}\u0000${edge.paramName}`;\n}\n\nfunction compareEdges(a: DiEdge, b: DiEdge): number {\n    const keyA = edgeKey(a);\n    const keyB = edgeKey(b);\n    return keyA < keyB ? -1 : keyA > keyB ? 1 : 0;\n}\n\n/** Sort all graph collections in place (stable output order). */\nexport function sortGraph(graph: DiGraph): DiGraph {\n    graph.roots.sort();\n    graph.nodes.sort(compareNodes);\n    graph.edges.sort(compareEdges);\n    graph.unresolved = [...new Set(graph.unresolved)].sort();\n    return graph;\n}\n\n/** Serialize a (sorted) graph to the design.json file content. */\nexport function toDesignJson(graph: DiGraph): string {\n    sortGraph(graph);\n    return JSON.stringify(graph, null, 4) + '\\n';\n}\n"]}

package/src/lib/di-graph/token-resolver.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Token Resolver
+ *
+ * Canonicalizes a DI token expression (the argument of @inject(...), @multiInject(...),
+ * @provideSingletonAs(...), or bind(...)) into a stable string key so that a token
+ * DEFINITION (e.g. `TYPES.Counter` in one file) and its BIND SITE (e.g.
+ * `bind(TYPES.Counter)` in another package) resolve to the same key.
+ *
+ * Key forms:
+ *   - Symbol.for('X')  → "symbol.for:X"       (global symbol registry — string key is identity)
+ *   - Symbol('X')      → "symbol:<file>#<name>" (per-declaration identity)
+ *   - class-as-token   → "class:<file>#<Name>"  (e.g. @inject(HeaderMethods), bind(X).toSelf())
+ *   - anything else    → "expr:<file>#<text>"   (best-effort fallback)
+ */
+import * as ts from 'typescript';
+import { TokenRef } from './model';
+/** Workspace-relative posix path for a source file. */
+export declare function relativeFile(workspaceRoot: string, sourceFile: ts.SourceFile): string;
+/**
+ * Resolve a token expression to its canonical key + display text.
+ *
+ * Uses the type checker to follow the expression (identifier or property access,
+ * possibly imported from another package) to its declaration, then inspects the
+ * declaration's initializer for Symbol.for / Symbol calls.
+ */
+export declare function resolveTokenKey(expr: ts.Expression, checker: ts.TypeChecker, workspaceRoot: string): TokenRef;
+/** Build the class-as-token key for a class declaration (bind(X).toSelf(), @provideSingleton). */
+export declare function classTokenKey(cls: ts.ClassDeclaration, workspaceRoot: string): TokenRef;

package/src/lib/di-graph/token-resolver.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Token Resolver
+ *
+ * Canonicalizes a DI token expression (the argument of @inject(...), @multiInject(...),
+ * @provideSingletonAs(...), or bind(...)) into a stable string key so that a token
+ * DEFINITION (e.g. `TYPES.Counter` in one file) and its BIND SITE (e.g.
+ * `bind(TYPES.Counter)` in another package) resolve to the same key.
+ *
+ * Key forms:
+ *   - Symbol.for('X')  → "symbol.for:X"       (global symbol registry — string key is identity)
+ *   - Symbol('X')      → "symbol:<file>#<name>" (per-declaration identity)
+ *   - class-as-token   → "class:<file>#<Name>"  (e.g. @inject(HeaderMethods), bind(X).toSelf())
+ *   - anything else    → "expr:<file>#<text>"   (best-effort fallback)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relativeFile = relativeFile;
+exports.resolveTokenKey = resolveTokenKey;
+exports.classTokenKey = classTokenKey;
+const tslib_1 = require("tslib");
+const ts = tslib_1.__importStar(require("typescript"));
+const path = tslib_1.__importStar(require("path"));
+const model_1 = require("./model");
+/** Workspace-relative posix path for a source file. */
+function relativeFile(workspaceRoot, sourceFile) {
+    return path.relative(workspaceRoot, sourceFile.fileName).split(path.sep).join('/');
+}
+/** Match a `Symbol.for('X')` or `Symbol('X')` call; returns the TokenRef key core, or null. */
+function symbolCallKey(init, declFile, declName) {
+    if (!ts.isCallExpression(init))
+        return null;
+    const callee = init.expression;
+    const arg = init.arguments[0];
+    const argText = arg && ts.isStringLiteralLike(arg) ? arg.text : null;
+    // Symbol.for('X')
+    if (ts.isPropertyAccessExpression(callee) &&
+        ts.isIdentifier(callee.expression) &&
+        callee.expression.text === 'Symbol' &&
+        callee.name.text === 'for') {
+        return argText !== null ? `symbol.for:${argText}` : `symbol.for:${declFile}#${declName}`;
+    }
+    // Symbol('X')
+    if (ts.isIdentifier(callee) && callee.text === 'Symbol') {
+        return `symbol:${declFile}#${argText ?? declName}`;
+    }
+    return null;
+}
+/** Extract the property/variable name a declaration binds. */
+function declaredName(decl) {
+    const named = decl;
+    if (named.name && (ts.isIdentifier(named.name) || ts.isStringLiteralLike(named.name))) {
+        return named.name.text;
+    }
+    return '<anonymous>';
+}
+/** Pull the initializer expression off a property-assignment or variable declaration. */
+function declarationInitializer(decl) {
+    if (ts.isPropertyAssignment(decl))
+        return decl.initializer;
+    if (ts.isVariableDeclaration(decl) && decl.initializer)
+        return decl.initializer;
+    if (ts.isPropertyDeclaration(decl) && decl.initializer)
+        return decl.initializer;
+    return null;
+}
+/**
+ * Resolve a token expression to its canonical key + display text.
+ *
+ * Uses the type checker to follow the expression (identifier or property access,
+ * possibly imported from another package) to its declaration, then inspects the
+ * declaration's initializer for Symbol.for / Symbol calls.
+ */
+function resolveTokenKey(expr, checker, workspaceRoot) {
+    const display = expr.getText();
+    let symbol = checker.getSymbolAtLocation(expr);
+    // For `TYPES.Counter` the symbol is on the property name; for a bare identifier it
+    // may be an import alias — follow aliases to the original declaration.
+    if (symbol && (symbol.flags & ts.SymbolFlags.Alias) !== 0) {
+        symbol = checker.getAliasedSymbol(symbol);
+    }
+    const decl = symbol?.declarations?.[0];
+    if (!decl) {
+        return new model_1.TokenRef(`expr:<unresolved>#${display}`, display);
+    }
+    const declFile = relativeFile(workspaceRoot, decl.getSourceFile());
+    const name = declaredName(decl);
+    if (ts.isClassDeclaration(decl)) {
+        return new model_1.TokenRef(`class:${declFile}#${name}`, display);
+    }
+    const init = declarationInitializer(decl);
+    if (init) {
+        const key = symbolCallKey(init, declFile, name);
+        if (key)
+            return new model_1.TokenRef(key, display);
+    }
+    return new model_1.TokenRef(`expr:${declFile}#${name}`, display);
+}
+/** Build the class-as-token key for a class declaration (bind(X).toSelf(), @provideSingleton). */
+function classTokenKey(cls, workspaceRoot) {
+    const file = relativeFile(workspaceRoot, cls.getSourceFile());
+    const name = cls.name ? cls.name.text : '<anonymous>';
+    return new model_1.TokenRef(`class:${file}#${name}`, name);
+}
+//# sourceMappingURL=token-resolver.js.map

package/src/lib/di-graph/token-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-resolver.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/lib/di-graph/token-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Token Resolver\n *\n * Canonicalizes a DI token expression (the argument of @inject(...), @multiInject(...),\n * @provideSingletonAs(...), or bind(...)) into a stable string key so that a token\n * DEFINITION (e.g. `TYPES.Counter` in one file) and its BIND SITE (e.g.\n * `bind(TYPES.Counter)` in another package) resolve to the same key.\n *\n * Key forms:\n *   - Symbol.for('X')  → \"symbol.for:X\"       (global symbol registry — string key is identity)\n *   - Symbol('X')      → \"symbol:<file>#<name>\" (per-declaration identity)\n *   - class-as-token   → \"class:<file>#<Name>\"  (e.g. @inject(HeaderMethods), bind(X).toSelf())\n *   - anything else    → \"expr:<file>#<text>\"   (best-effort fallback)\n */\n\nimport * as ts from 'typescript';\nimport * as path from 'path';\nimport { TokenRef } from './model';\n\n/** Workspace-relative posix path for a source file. */\nexport function relativeFile(workspaceRoot: string, sourceFile: ts.SourceFile): string {\n    return path.relative(workspaceRoot, sourceFile.fileName).split(path.sep).join('/');\n}\n\n/** Match a `Symbol.for('X')` or `Symbol('X')` call; returns the TokenRef key core, or null. */\nfunction symbolCallKey(init: ts.Expression, declFile: string, declName: string): string | null {\n    if (!ts.isCallExpression(init)) return null;\n    const callee = init.expression;\n    const arg = init.arguments[0];\n    const argText = arg && ts.isStringLiteralLike(arg) ? arg.text : null;\n\n    // Symbol.for('X')\n    if (\n        ts.isPropertyAccessExpression(callee) &&\n        ts.isIdentifier(callee.expression) &&\n        callee.expression.text === 'Symbol' &&\n        callee.name.text === 'for'\n    ) {\n        return argText !== null ? `symbol.for:${argText}` : `symbol.for:${declFile}#${declName}`;\n    }\n\n    // Symbol('X')\n    if (ts.isIdentifier(callee) && callee.text === 'Symbol') {\n        return `symbol:${declFile}#${argText ?? declName}`;\n    }\n\n    return null;\n}\n\n/** Extract the property/variable name a declaration binds. */\nfunction declaredName(decl: ts.Declaration): string {\n    const named = decl as ts.NamedDeclaration;\n    if (named.name && (ts.isIdentifier(named.name) || ts.isStringLiteralLike(named.name))) {\n        return named.name.text;\n    }\n    return '<anonymous>';\n}\n\n/** Pull the initializer expression off a property-assignment or variable declaration. */\nfunction declarationInitializer(decl: ts.Declaration): ts.Expression | null {\n    if (ts.isPropertyAssignment(decl)) return decl.initializer;\n    if (ts.isVariableDeclaration(decl) && decl.initializer) return decl.initializer;\n    if (ts.isPropertyDeclaration(decl) && decl.initializer) return decl.initializer;\n    return null;\n}\n\n/**\n * Resolve a token expression to its canonical key + display text.\n *\n * Uses the type checker to follow the expression (identifier or property access,\n * possibly imported from another package) to its declaration, then inspects the\n * declaration's initializer for Symbol.for / Symbol calls.\n */\nexport function resolveTokenKey(\n    expr: ts.Expression,\n    checker: ts.TypeChecker,\n    workspaceRoot: string,\n): TokenRef {\n    const display = expr.getText();\n\n    let symbol = checker.getSymbolAtLocation(expr);\n    // For `TYPES.Counter` the symbol is on the property name; for a bare identifier it\n    // may be an import alias — follow aliases to the original declaration.\n    if (symbol && (symbol.flags & ts.SymbolFlags.Alias) !== 0) {\n        symbol = checker.getAliasedSymbol(symbol);\n    }\n\n    const decl = symbol?.declarations?.[0];\n    if (!decl) {\n        return new TokenRef(`expr:<unresolved>#${display}`, display);\n    }\n\n    const declFile = relativeFile(workspaceRoot, decl.getSourceFile());\n    const name = declaredName(decl);\n\n    if (ts.isClassDeclaration(decl)) {\n        return new TokenRef(`class:${declFile}#${name}`, display);\n    }\n\n    const init = declarationInitializer(decl);\n    if (init) {\n        const key = symbolCallKey(init, declFile, name);\n        if (key) return new TokenRef(key, display);\n    }\n\n    return new TokenRef(`expr:${declFile}#${name}`, display);\n}\n\n/** Build the class-as-token key for a class declaration (bind(X).toSelf(), @provideSingleton). */\nexport function classTokenKey(\n    cls: ts.ClassDeclaration,\n    workspaceRoot: string,\n): TokenRef {\n    const file = relativeFile(workspaceRoot, cls.getSourceFile());\n    const name = cls.name ? cls.name.text : '<anonymous>';\n    return new TokenRef(`class:${file}#${name}`, name);\n}\n"]}

package/src/lib/graph-visualizer.js

@@ -37,7 +37,7 @@ function getShortName(name) {
 /**
  * Generate Graphviz DOT format from the graph
  */
-function generateDot(graph, title = 'WebPieces Architecture') {
+function generateDot(graph, title = 'Monorepo Dependency Architecture') {
     let dot = 'digraph Architecture {\n';
     dot += '  rankdir=TB;\n';
     dot += '  node [shape=box, style=filled, fontname="Arial"];\n';
@@ -83,7 +83,7 @@ function generateDot(graph, title = 'WebPieces Architecture') {
 /**
  * Generate interactive HTML with embedded SVG using viz.js
  */
-function generateHTML(dot, title = 'WebPieces Architecture') {
+function generateHTML(dot, title = 'Monorepo Dependency Architecture') {
     const styles = generateHTMLStyles();
     const legend = generateHTMLLegend();
     const script = generateHTMLScript(dot);
@@ -184,7 +184,7 @@ function generateHTMLScript(dot) {
 /**
  * Write visualization files to tmp/webpieces/
  */
-function writeVisualization(graph, workspaceRoot, title = 'WebPieces Architecture') {
+function writeVisualization(graph, workspaceRoot, title = 'Monorepo Dependency Architecture') {
     const outputDir = path.join(workspaceRoot, 'tmp', 'webpieces');
     // Ensure directory exists
     if (!fs.existsSync(outputDir)) {

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

@@ -1 +1 @@
-{"version":3,"file":"graph-visualizer.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/lib/graph-visualizer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Graph Visualizer\n *\n * Generates visual representations of the architecture graph:\n * - DOT format (for Graphviz)\n * - Interactive HTML (using viz.js)\n *\n * Output files go to tmp/webpieces/ for easy viewing without committing.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { execSync } from 'child_process';\nimport type { EnhancedGraph } from './graph-sorter';\nimport { toError } from '../toError';\n\n/**\n * Level colors for visualization\n */\nconst LEVEL_COLORS: Record<number, string> = {\n    0: '#E8F5E9', // Light green - foundation\n    1: '#E3F2FD', // Light blue - middleware\n    2: '#FFF3E0', // Light orange - applications\n    3: '#FCE4EC', // Light pink - higher level\n};\n\n/**\n * Remove scope from name for display\n * '@scope/name' → 'name'\n * 'name' → 'name'\n */\nfunction getShortName(name: string): string {\n    return name.includes('/') ? name.split('/').pop()! : name;\n}\n\n/**\n * Generate Graphviz DOT format from the graph\n */\nexport function generateDot(graph: EnhancedGraph, title: string = 'WebPieces Architecture'): string {\n    let dot = 'digraph Architecture {\\n';\n    dot += '  rankdir=TB;\\n';\n    dot += '  node [shape=box, style=filled, fontname=\"Arial\"];\\n';\n    dot += '  edge [fontname=\"Arial\"];\\n\\n';\n\n    // Group projects by level\n    const levels: Record<number, string[]> = {};\n    for (const [project, info] of Object.entries(graph)) {\n        if (!levels[info.level]) levels[info.level] = [];\n        levels[info.level].push(project);\n    }\n\n    // Create nodes with level-based colors\n    for (const [project, info] of Object.entries(graph)) {\n        const shortName = getShortName(project);\n        const color = LEVEL_COLORS[info.level] || '#F5F5F5';\n        dot += `  \"${shortName}\" [fillcolor=\"${color}\", label=\"${shortName}\\\\n(L${info.level})\"];\\n`;\n    }\n\n    dot += '\\n';\n\n    // Create same-rank subgraphs for each level\n    for (const [level, projects] of Object.entries(levels)) {\n        dot += `  { rank=same; `;\n        projects.forEach((p) => {\n            const shortName = getShortName(p);\n            dot += `\"${shortName}\"; `;\n        });\n        dot += '}\\n';\n    }\n\n    dot += '\\n';\n\n    // Create edges (dependencies)\n    for (const [project, info] of Object.entries(graph)) {\n        const shortName = getShortName(project);\n        for (const dep of info.dependsOn || []) {\n            const depShortName = getShortName(dep);\n            dot += `  \"${shortName}\" -> \"${depShortName}\";\\n`;\n        }\n    }\n\n    dot += '\\n  labelloc=\"t\";\\n';\n    dot += `  label=\"${title}\\\\n(from architecture/dependencies.json)\";\\n`;\n    dot += '  fontsize=20;\\n';\n    dot += '}\\n';\n\n    return dot;\n}\n\n/**\n * Generate interactive HTML with embedded SVG using viz.js\n */\nexport function generateHTML(dot: string, title: string = 'WebPieces Architecture'): string {\n    const styles = generateHTMLStyles();\n    const legend = generateHTMLLegend();\n    const script = generateHTMLScript(dot);\n\n    return `<!DOCTYPE html>\n<html>\n<head>\n    <title>${title}</title>\n    <script src=\"https://cdn.jsdelivr.net/npm/viz.js@2.1.2/viz.js\"></script>\n    <script src=\"https://cdn.jsdelivr.net/npm/viz.js@2.1.2/full.render.js\"></script>\n    <style>${styles}</style>\n</head>\n<body>\n    <h1>${title}</h1>\n    ${legend}\n    <div id=\"graph\"></div>\n    <script>${script}</script>\n</body>\n</html>`;\n}\n\nfunction generateHTMLStyles(): string {\n    return `\n        body {\n            margin: 0;\n            padding: 20px;\n            font-family: Arial, sans-serif;\n            background: #f5f5f5;\n        }\n        h1 {\n            text-align: center;\n            color: #333;\n        }\n        #graph {\n            text-align: center;\n            background: white;\n            padding: 20px;\n            border-radius: 8px;\n            box-shadow: 0 2px 4px rgba(0,0,0,0.1);\n        }\n        .legend {\n            margin: 20px auto;\n            max-width: 600px;\n            padding: 15px;\n            background: white;\n            border-radius: 8px;\n            box-shadow: 0 2px 4px rgba(0,0,0,0.1);\n        }\n        .legend h2 {\n            margin-top: 0;\n        }\n        .legend-item {\n            margin: 8px 0;\n        }\n        .legend-box {\n            display: inline-block;\n            width: 20px;\n            height: 20px;\n            border: 1px solid #ccc;\n            margin-right: 10px;\n            vertical-align: middle;\n        }\n    `;\n}\n\nfunction generateHTMLLegend(): string {\n    return `<div class=\"legend\">\n        <h2>Legend</h2>\n        <div class=\"legend-item\">\n            <span class=\"legend-box\" style=\"background: #E8F5E9;\"></span>\n            <strong>Level 0:</strong> Foundation libraries (no dependencies)\n        </div>\n        <div class=\"legend-item\">\n            <span class=\"legend-box\" style=\"background: #E3F2FD;\"></span>\n            <strong>Level 1:</strong> Middleware libraries (depend on Level 0)\n        </div>\n        <div class=\"legend-item\">\n            <span class=\"legend-box\" style=\"background: #FFF3E0;\"></span>\n            <strong>Level 2:</strong> Applications (depend on Level 1)\n        </div>\n        <div class=\"legend-item\" style=\"margin-top: 15px;\">\n            <em>Note: Transitive dependencies are allowed but not shown in the graph.</em>\n        </div>\n    </div>`;\n}\n\nfunction generateHTMLScript(dot: string): string {\n    return `\n        const dot = ${JSON.stringify(dot)};\n        const viz = new Viz();\n\n        viz.renderSVGElement(dot)\n            .then(element => {\n                document.getElementById('graph').appendChild(element);\n            })\n            .catch(err => {\n                console.error(err);\n                document.getElementById('graph').innerHTML = '<pre>' + err + '</pre>';\n            });\n    `;\n}\n\ninterface VisualizationPaths {\n    dotPath: string;\n    htmlPath: string;\n}\n\n/**\n * Write visualization files to tmp/webpieces/\n */\nexport function writeVisualization(\n    graph: EnhancedGraph,\n    workspaceRoot: string,\n    title: string = 'WebPieces Architecture'\n): VisualizationPaths {\n    const outputDir = path.join(workspaceRoot, 'tmp', 'webpieces');\n\n    // Ensure directory exists\n    if (!fs.existsSync(outputDir)) {\n        fs.mkdirSync(outputDir, { recursive: true });\n    }\n\n    // Generate DOT\n    const dot = generateDot(graph, title);\n    const dotPath = path.join(outputDir, 'architecture.dot');\n    fs.writeFileSync(dotPath, dot, 'utf-8');\n\n    // Generate HTML\n    const html = generateHTML(dot, title);\n    const htmlPath = path.join(outputDir, 'architecture.html');\n    fs.writeFileSync(htmlPath, html, 'utf-8');\n\n    return { dotPath, htmlPath };\n}\n\n/**\n * Open the HTML visualization in the default browser\n */\nexport function openVisualization(htmlPath: string): boolean {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        const platform = process.platform;\n        let openCommand: string;\n\n        if (platform === 'darwin') {\n            openCommand = `open \"${htmlPath}\"`;\n        } else if (platform === 'win32') {\n            openCommand = `start \"\" \"${htmlPath}\"`;\n        } else {\n            openCommand = `xdg-open \"${htmlPath}\"`;\n        }\n\n        execSync(openCommand, { stdio: 'ignore' });\n        return true;\n    } catch (err: unknown) {\n        //const error = toError(err);\n        void err;\n        return false;\n    }\n}\n"]}
+{"version":3,"file":"graph-visualizer.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/lib/graph-visualizer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Graph Visualizer\n *\n * Generates visual representations of the architecture graph:\n * - DOT format (for Graphviz)\n * - Interactive HTML (using viz.js)\n *\n * Output files go to tmp/webpieces/ for easy viewing without committing.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { execSync } from 'child_process';\nimport type { EnhancedGraph } from './graph-sorter';\nimport { toError } from '../toError';\n\n/**\n * Level colors for visualization\n */\nconst LEVEL_COLORS: Record<number, string> = {\n    0: '#E8F5E9', // Light green - foundation\n    1: '#E3F2FD', // Light blue - middleware\n    2: '#FFF3E0', // Light orange - applications\n    3: '#FCE4EC', // Light pink - higher level\n};\n\n/**\n * Remove scope from name for display\n * '@scope/name' → 'name'\n * 'name' → 'name'\n */\nfunction getShortName(name: string): string {\n    return name.includes('/') ? name.split('/').pop()! : name;\n}\n\n/**\n * Generate Graphviz DOT format from the graph\n */\nexport function generateDot(graph: EnhancedGraph, title: string = 'Monorepo Dependency Architecture'): string {\n    let dot = 'digraph Architecture {\\n';\n    dot += '  rankdir=TB;\\n';\n    dot += '  node [shape=box, style=filled, fontname=\"Arial\"];\\n';\n    dot += '  edge [fontname=\"Arial\"];\\n\\n';\n\n    // Group projects by level\n    const levels: Record<number, string[]> = {};\n    for (const [project, info] of Object.entries(graph)) {\n        if (!levels[info.level]) levels[info.level] = [];\n        levels[info.level].push(project);\n    }\n\n    // Create nodes with level-based colors\n    for (const [project, info] of Object.entries(graph)) {\n        const shortName = getShortName(project);\n        const color = LEVEL_COLORS[info.level] || '#F5F5F5';\n        dot += `  \"${shortName}\" [fillcolor=\"${color}\", label=\"${shortName}\\\\n(L${info.level})\"];\\n`;\n    }\n\n    dot += '\\n';\n\n    // Create same-rank subgraphs for each level\n    for (const [level, projects] of Object.entries(levels)) {\n        dot += `  { rank=same; `;\n        projects.forEach((p) => {\n            const shortName = getShortName(p);\n            dot += `\"${shortName}\"; `;\n        });\n        dot += '}\\n';\n    }\n\n    dot += '\\n';\n\n    // Create edges (dependencies)\n    for (const [project, info] of Object.entries(graph)) {\n        const shortName = getShortName(project);\n        for (const dep of info.dependsOn || []) {\n            const depShortName = getShortName(dep);\n            dot += `  \"${shortName}\" -> \"${depShortName}\";\\n`;\n        }\n    }\n\n    dot += '\\n  labelloc=\"t\";\\n';\n    dot += `  label=\"${title}\\\\n(from architecture/dependencies.json)\";\\n`;\n    dot += '  fontsize=20;\\n';\n    dot += '}\\n';\n\n    return dot;\n}\n\n/**\n * Generate interactive HTML with embedded SVG using viz.js\n */\nexport function generateHTML(dot: string, title: string = 'Monorepo Dependency Architecture'): string {\n    const styles = generateHTMLStyles();\n    const legend = generateHTMLLegend();\n    const script = generateHTMLScript(dot);\n\n    return `<!DOCTYPE html>\n<html>\n<head>\n    <title>${title}</title>\n    <script src=\"https://cdn.jsdelivr.net/npm/viz.js@2.1.2/viz.js\"></script>\n    <script src=\"https://cdn.jsdelivr.net/npm/viz.js@2.1.2/full.render.js\"></script>\n    <style>${styles}</style>\n</head>\n<body>\n    <h1>${title}</h1>\n    ${legend}\n    <div id=\"graph\"></div>\n    <script>${script}</script>\n</body>\n</html>`;\n}\n\nfunction generateHTMLStyles(): string {\n    return `\n        body {\n            margin: 0;\n            padding: 20px;\n            font-family: Arial, sans-serif;\n            background: #f5f5f5;\n        }\n        h1 {\n            text-align: center;\n            color: #333;\n        }\n        #graph {\n            text-align: center;\n            background: white;\n            padding: 20px;\n            border-radius: 8px;\n            box-shadow: 0 2px 4px rgba(0,0,0,0.1);\n        }\n        .legend {\n            margin: 20px auto;\n            max-width: 600px;\n            padding: 15px;\n            background: white;\n            border-radius: 8px;\n            box-shadow: 0 2px 4px rgba(0,0,0,0.1);\n        }\n        .legend h2 {\n            margin-top: 0;\n        }\n        .legend-item {\n            margin: 8px 0;\n        }\n        .legend-box {\n            display: inline-block;\n            width: 20px;\n            height: 20px;\n            border: 1px solid #ccc;\n            margin-right: 10px;\n            vertical-align: middle;\n        }\n    `;\n}\n\nfunction generateHTMLLegend(): string {\n    return `<div class=\"legend\">\n        <h2>Legend</h2>\n        <div class=\"legend-item\">\n            <span class=\"legend-box\" style=\"background: #E8F5E9;\"></span>\n            <strong>Level 0:</strong> Foundation libraries (no dependencies)\n        </div>\n        <div class=\"legend-item\">\n            <span class=\"legend-box\" style=\"background: #E3F2FD;\"></span>\n            <strong>Level 1:</strong> Middleware libraries (depend on Level 0)\n        </div>\n        <div class=\"legend-item\">\n            <span class=\"legend-box\" style=\"background: #FFF3E0;\"></span>\n            <strong>Level 2:</strong> Applications (depend on Level 1)\n        </div>\n        <div class=\"legend-item\" style=\"margin-top: 15px;\">\n            <em>Note: Transitive dependencies are allowed but not shown in the graph.</em>\n        </div>\n    </div>`;\n}\n\nfunction generateHTMLScript(dot: string): string {\n    return `\n        const dot = ${JSON.stringify(dot)};\n        const viz = new Viz();\n\n        viz.renderSVGElement(dot)\n            .then(element => {\n                document.getElementById('graph').appendChild(element);\n            })\n            .catch(err => {\n                console.error(err);\n                document.getElementById('graph').innerHTML = '<pre>' + err + '</pre>';\n            });\n    `;\n}\n\ninterface VisualizationPaths {\n    dotPath: string;\n    htmlPath: string;\n}\n\n/**\n * Write visualization files to tmp/webpieces/\n */\nexport function writeVisualization(\n    graph: EnhancedGraph,\n    workspaceRoot: string,\n    title: string = 'Monorepo Dependency Architecture'\n): VisualizationPaths {\n    const outputDir = path.join(workspaceRoot, 'tmp', 'webpieces');\n\n    // Ensure directory exists\n    if (!fs.existsSync(outputDir)) {\n        fs.mkdirSync(outputDir, { recursive: true });\n    }\n\n    // Generate DOT\n    const dot = generateDot(graph, title);\n    const dotPath = path.join(outputDir, 'architecture.dot');\n    fs.writeFileSync(dotPath, dot, 'utf-8');\n\n    // Generate HTML\n    const html = generateHTML(dot, title);\n    const htmlPath = path.join(outputDir, 'architecture.html');\n    fs.writeFileSync(htmlPath, html, 'utf-8');\n\n    return { dotPath, htmlPath };\n}\n\n/**\n * Open the HTML visualization in the default browser\n */\nexport function openVisualization(htmlPath: string): boolean {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        const platform = process.platform;\n        let openCommand: string;\n\n        if (platform === 'darwin') {\n            openCommand = `open \"${htmlPath}\"`;\n        } else if (platform === 'win32') {\n            openCommand = `start \"\" \"${htmlPath}\"`;\n        } else {\n            openCommand = `xdg-open \"${htmlPath}\"`;\n        }\n\n        execSync(openCommand, { stdio: 'ignore' });\n        return true;\n    } catch (err: unknown) {\n        //const error = toError(err);\n        void err;\n        return false;\n    }\n}\n"]}

package/src/plugin.d.ts

@@ -39,6 +39,7 @@ export interface ValidationOptions {
     validateTsInSrc?: boolean;
     validateNxWiring?: boolean;
     runtimeArchitecture?: boolean;
+    diGraph?: boolean;
     newMethodsMaxLines?: number;
     modifiedAndNewMethodsMaxLines?: number;
     modifiedFilesMaxLines?: number;

package/src/plugin.js

@@ -22,6 +22,7 @@ exports.isInsideNestedGitRepo = isInsideNestedGitRepo;
 const path_1 = require("path");
 const fs_1 = require("fs");
 const runtime_targets_1 = require("./runtime-targets");
+const di_graph_targets_1 = require("./di-graph-targets");
 const DEFAULT_OPTIONS = {
     circularDeps: {
         enabled: true,
@@ -47,6 +48,7 @@ const DEFAULT_OPTIONS = {
             validateTsInSrc: true,
             validateNxWiring: true,
             runtimeArchitecture: true,
+            diGraph: true,
             newMethodsMaxLines: 30,
             modifiedAndNewMethodsMaxLines: 80,
             modifiedFilesMaxLines: 900,
@@ -156,22 +158,7 @@ function addPerProjectTargets(results, projectFiles, opts, context) {
                 continue;
         }
         processedRoots.add(projectRoot);
-        const targets = {};
-        // Add circular-deps target ONLY for project.json projects
-        // (package.json-only projects may not have TypeScript source)
-        if (isProjectJson && opts.circularDeps.enabled) {
-            if (!isExcluded(projectRoot, opts.circularDeps.excludePatterns)) {
-                const targetName = opts.circularDeps.targetName;
-                targets[targetName] = createCircularDepsTarget(projectRoot, targetName);
-            }
-        }
-        // Add per-project runtime-marker validation (validates this project's
-        // service-contract.json against its own api-project deps, independently).
-        if (isProjectJson && opts.workspace.validations.runtimeArchitecture) {
-            targets['validate-runtime-markers'] = (0, runtime_targets_1.createValidateRuntimeMarkersTarget)();
-        }
-        // Add ci target to ALL projects (both project.json and package.json)
-        targets['ci'] = createCiTarget();
+        const targets = buildPerProjectTargets(isProjectJson, projectRoot, opts);
         if (Object.keys(targets).length === 0)
             continue;
         const result = {
@@ -184,6 +171,34 @@ function addPerProjectTargets(results, projectFiles, opts, context) {
         results.push([projectFile, result]);
     }
 }
+/**
+ * Build the target map for one project. Most targets are project.json-only
+ * (package.json-only projects may not have TypeScript source); `ci` goes on all.
+ */
+function buildPerProjectTargets(isProjectJson, projectRoot, opts) {
+    const targets = {};
+    // Add circular-deps target ONLY for project.json projects
+    if (isProjectJson && opts.circularDeps.enabled) {
+        if (!isExcluded(projectRoot, opts.circularDeps.excludePatterns)) {
+            const targetName = opts.circularDeps.targetName;
+            targets[targetName] = createCircularDepsTarget(projectRoot, targetName);
+        }
+    }
+    // Add per-project runtime-marker validation (validates this project's
+    // service-contract.json against its own api-project deps, independently).
+    if (isProjectJson && opts.workspace.validations.runtimeArchitecture) {
+        targets['validate-runtime-markers'] = (0, runtime_targets_1.createValidateRuntimeMarkersTarget)();
+    }
+    // Per-project DI design DAG: regenerate design.json/design.md on every build,
+    // then gate the build on the committed copies being current.
+    if (isProjectJson && opts.workspace.validations.diGraph) {
+        targets['di-graph-generate'] = (0, di_graph_targets_1.createDiGraphGenerateTarget)();
+        targets['validate-di-graph-unchanged'] = (0, di_graph_targets_1.createValidateDiGraphUnchangedTarget)();
+    }
+    // Add ci target to ALL projects (both project.json and package.json)
+    targets['ci'] = createCiTarget();
+    return targets;
+}
 /**
  * Nx V2 Inference Plugin
  * Matches project.json and package.json files to create targets

package/src/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../../packages/tooling/nx-webpieces-rules/src/plugin.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAsMH,sDASC;AA7MD,+BAAqC;AACrC,2BAAgC;AAQhC,uDAI2B;AAkE3B,MAAM,eAAe,GAAwC;IACzD,YAAY,EAAE;QACV,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,gCAAgC;QAC5C,eAAe,EAAE,EAAE;KACtB;IACD,SAAS,EAAE;QACP,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,OAAO;QACrB,SAAS,EAAE,gCAAgC;QAC3C,WAAW,EAAE;YACT,QAAQ,EAAE,IAAI;YACd,4EAA4E;YAC5E,yEAAyE;YACzE,4EAA4E;YAC5E,eAAe,EAAE,KAAK;YACtB,qBAAqB,EAAE,IAAI;YAC3B,mBAAmB,EAAE,IAAI;YACzB,kBAAkB,EAAE,IAAI;YACxB,uBAAuB,EAAE,IAAI;YAC7B,qBAAqB,EAAE,IAAI;YAC3B,sBAAsB,EAAE,IAAI;YAC5B,eAAe,EAAE,IAAI;YACrB,gBAAgB,EAAE,IAAI;YACtB,mBAAmB,EAAE,IAAI;YACzB,kBAAkB,EAAE,EAAE;YACtB,6BAA6B,EAAE,EAAE;YACjC,qBAAqB,EAAE,GAAG;YAC1B,cAAc,EAAE,QAAQ;SAC3B;QACD,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;YACf,gBAAgB,EAAE,IAAI;SACzB;KACJ;CACJ,CAAC;AAEF,SAAS,gBAAgB,CACrB,OAA8C;IAE9C,MAAM,YAAY,GAAG;QACjB,GAAG,eAAe,CAAC,YAAY;QAC/B,GAAG,OAAO,EAAE,YAAY;KAC3B,CAAC;IAEF,MAAM,SAAS,GAAG;QACd,GAAG,eAAe,CAAC,SAAS;QAC5B,GAAG,OAAO,EAAE,SAAS;QACrB,WAAW,EAAE;YACT,GAAG,eAAe,CAAC,SAAS,CAAC,WAAW;YACxC,GAAG,OAAO,EAAE,SAAS,EAAE,WAAW;SACrC;QACD,QAAQ,EAAE;YACN,GAAG,eAAe,CAAC,SAAS,CAAC,QAAQ;YACrC,GAAG,OAAO,EAAE,SAAS,EAAE,QAAQ;SAClC;KACJ,CAAC;IAEF,OAAO;QACH,YAAY;QACZ,SAAS;KAC2B,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,mBAAmB,CAC9B,YAA+B,EAC/B,OAA8C,EAC9C,OAA6B;IAE7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,2CAA2C;IAC3C,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE7D,+DAA+D;IAC/D,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE3D,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,sBAAsB,CAC3B,OAA4B,EAC5B,YAA+B,EAC/B,IAAyC,EACzC,OAA6B;IAE7B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO;IAEpC,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAChE,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC;QAAE,OAAO;IAErC,MAAM,gBAAgB,GAAG,mCAAmC,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEvD,MAAM,MAAM,GAAsB;QAC9B,QAAQ,EAAE;YACN,YAAY,EAAE;gBACV,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,gBAAgB;aAC5B;SACJ;KACJ,CAAC;IAEF,MAAM,gBAAgB,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,gBAAgB,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,MAAM,CAAU,CAAC,CAAC;IACtD,CAAC;AACL,CAAC;AAGD,6FAA6F;AAC7F,oGAAoG;AACpG,qGAAqG;AACrG,8FAA8F;AAC9F,SAAgB,qBAAqB,CAAC,aAAqB,EAAE,WAAmB;IAC5E,IAAI,GAAG,GAAG,WAAW,CAAC;IACtB,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QACvC,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,aAAa,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,oBAAoB,CACzB,OAA4B,EAC5B,YAA+B,EAC/B,IAAyC,EACzC,OAA6B;IAE7B,0EAA0E;IAC1E,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACrC,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAE3D,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa;YAAE,SAAS;QAE/C,MAAM,WAAW,GAAG,IAAA,cAAO,EAAC,WAAW,CAAC,CAAC;QAEzC,gDAAgD;QAChD,IAAI,WAAW,KAAK,GAAG;YAAE,SAAS;QAElC,yFAAyF;QACzF,kFAAkF;QAClF,IAAI,qBAAqB,CAAC,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC;YAAE,SAAS;QAExE,oDAAoD;QACpD,IAAI,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,SAAS;QAE9C,uEAAuE;QACvE,0DAA0D;QAC1D,IAAI,aAAa,EAAE,CAAC;YAChB,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,aAAa,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;YACjF,IAAI,IAAA,eAAU,EAAC,eAAe,CAAC;gBAAE,SAAS;QAC9C,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAEhC,MAAM,OAAO,GAAwC,EAAE,CAAC;QAExD,0DAA0D;QAC1D,8DAA8D;QAC9D,IAAI,aAAa,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,eAAgB,CAAC,EAAE,CAAC;gBAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,UAAW,CAAC;gBACjD,OAAO,CAAC,UAAU,CAAC,GAAG,wBAAwB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YAC5E,CAAC;QACL,CAAC;QAED,sEAAsE;QACtE,0EAA0E;QAC1E,IAAI,aAAa,IAAI,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC,mBAAmB,EAAE,CAAC;YACnE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAA,oDAAkC,GAAE,CAAC;QAC/E,CAAC;QAED,qEAAqE;QACrE,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,EAAE,CAAC;QAEjC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEhD,MAAM,MAAM,GAAsB;YAC9B,QAAQ,EAAE;gBACN,CAAC,WAAW,CAAC,EAAE;oBACX,OAAO;iBACV;aACJ;SACJ,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,CAAU,CAAC,CAAC;IACjD,CAAC;AACL,CAAC;AAED;;;GAGG;AACU,QAAA,aAAa,GAA6C;IACnE,uDAAuD;IACvD,2BAA2B;IAE3B,qBAAqB;IACrB,mBAAmB;CACtB,CAAC;AAEF;;GAEG;AACH,SAAS,0BAA0B,CAC/B,WAA4E;IAE5E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,WAAY,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC3E,IAAI,WAAY,CAAC,qBAAqB;QAAE,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACxF,IAAI,WAAY,CAAC,eAAe;QAAE,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC7E,IAAI,WAAY,CAAC,mBAAmB;QAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC3E,2DAA2D;IAC3D,IACI,WAAY,CAAC,kBAAkB;QAC/B,WAAY,CAAC,uBAAuB;QACpC,WAAY,CAAC,qBAAqB,EACpC,CAAC;QACC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,WAAY,CAAC,sBAAsB;QAAE,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAClF,IAAI,WAAY,CAAC,eAAe;QAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,IAAI,WAAY,CAAC,gBAAgB;QAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACtE,IAAI,WAAY,CAAC,mBAAmB;QAAE,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACpF,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAS,mCAAmC,CACxC,IAAyC;IAEzC,MAAM,OAAO,GAAwC,EAAE,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,SAAU,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC;IAEhD,qCAAqC;IACrC,OAAO,CAAC,MAAM,CAAC,GAAG,gBAAgB,EAAE,CAAC;IAErC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAS,CAAC,QAAQ,EAAE,CAAC;QACpC,OAAO,CAAC,UAAU,CAAC,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,CAAC,QAAS,CAAC,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,WAAW,CAAC,GAAG,kCAAkC,CAAC,SAAS,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,CAAC,QAAS,CAAC,gBAAgB,EAAE,CAAC;QAC5C,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAA,8CAA4B,GAAE,CAAC;IAClE,CAAC;IACD,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACvB,OAAO,CAAC,iCAAiC,CAAC,GAAG,4BAA4B,EAAE,CAAC;IAChF,CAAC;IACD,IAAI,WAAW,CAAC,qBAAqB,EAAE,CAAC;QACpC,OAAO,CAAC,iCAAiC,CAAC,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;QAC9B,OAAO,CAAC,4BAA4B,CAAC,GAAG,+BAA+B,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,WAAW,CAAC,mBAAmB,EAAE,CAAC;QAClC,OAAO,CAAC,sBAAsB,CAAC,GAAG,+BAA+B,EAAE,CAAC;IACxE,CAAC;IACD,2DAA2D;IAC3D,gEAAgE;IAChE,yFAAyF;IACzF,IACI,WAAW,CAAC,kBAAkB;QAC9B,WAAW,CAAC,uBAAuB;QACnC,WAAW,CAAC,qBAAqB,EACnC,CAAC;QACC,OAAO,CAAC,eAAe,CAAC,GAAG,wBAAwB,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,WAAW,CAAC,sBAAsB,EAAE,CAAC;QACrC,OAAO,CAAC,0BAA0B,CAAC,GAAG,kCAAkC,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;QAC9B,OAAO,CAAC,oBAAoB,CAAC,GAAG,2BAA2B,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;QAC/B,OAAO,CAAC,oBAAoB,CAAC,GAAG,4BAA4B,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,WAAW,CAAC,mBAAmB,EAAE,CAAC;QAClC,OAAO,CAAC,+BAA+B,CAAC,GAAG,IAAA,yDAAuC,GAAE,CAAC;IACzF,CAAC;IAED,iEAAiE;IACjE,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAClE,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,mBAAmB,CAAC,GAAG,4BAA4B,CAAC,iBAAiB,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB;IAC3C,OAAO;QACH,QAAQ,EAAE,wCAAwC;QAClD,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE;YACL,gDAAgD;YAChD,wDAAwD;SAC3D;QACD,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EACP,+EAA+E;SACtF;KACJ,CAAC;AACN,CAAC;AAED,SAAS,kCAAkC,CAAC,SAAiB;IACzD,OAAO;QACH,QAAQ,EAAE,yCAAyC;QACnD,SAAS,EAAE,CAAC,UAAU,CAAC;QACvB,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,2DAA2D;SAC3E;KACJ,CAAC;AACN,CAAC;AAED,SAAS,4BAA4B;IACjC,OAAO;QACH,QAAQ,EAAE,+DAA+D;QACzE,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,iCAAiC,EAAE,gDAAgD,CAAC;QAC7F,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,gEAAgE;SAChF;KACJ,CAAC;AACN,CAAC;AAED,SAAS,6BAA6B,CAAC,SAAiB;IACpD,OAAO;QACH,QAAQ,EAAE,+DAA+D;QACzE,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,CAAC,SAAS,EAAE,gDAAgD,CAAC;QACrE,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,2DAA2D;SAC3E;KACJ,CAAC;AACN,CAAC;AAED,SAAS,+BAA+B;IACpC,OAAO;QACH,QAAQ,EAAE,0DAA0D;QACpE,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,iCAAiC,EAAE,gDAAgD,CAAC;QAC7F,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,2DAA2D;SAC3E;KACJ,CAAC;AACN,CAAC;AAED,SAAS,+BAA+B;IACpC,OAAO;QACH,QAAQ,EAAE,oDAAoD;QAC9D,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,iCAAiC,EAAE,iCAAiC,CAAC;QAC9E,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,0EAA0E;SAC1F;KACJ,CAAC;AACN,CAAC;AAED,SAAS,8BAA8B,CACnC,QAAgB,EAChB,IAAiC;IAEjC,OAAO;QACH,QAAQ,EAAE,oDAAoD;QAC9D,KAAK,EAAE,KAAK,EAAE,qCAAqC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChC,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,sCAAsC,QAAQ,qCAAqC;SACnG;KACJ,CAAC;AACN,CAAC;AAED,SAAS,mCAAmC,CACxC,QAAgB,EAChB,IAAiC;IAEjC,OAAO;QACH,QAAQ,EAAE,yDAAyD;QACnE,KAAK,EAAE,KAAK,EAAE,qCAAqC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChC,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,mDAAmD,QAAQ,qCAAqC;SAChH;KACJ,CAAC;AACN,CAAC;AAED,SAAS,iCAAiC,CACtC,QAAgB,EAChB,IAAiC;IAEjC,OAAO;QACH,QAAQ,EAAE,uDAAuD;QACjE,KAAK,EAAE,KAAK,EAAE,qCAAqC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChC,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,yCAAyC,QAAQ,yCAAyC;SAC1G;KACJ,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,wBAAwB;IAC7B,OAAO;QACH,QAAQ,EAAE,6CAA6C;QACvD,KAAK,EAAE,KAAK,EAAE,qCAAqC;QACnD,MAAM,EAAE,CAAC,SAAS,EAAE,uCAAuC,EAAE,EAAC,SAAS,EAAE,uDAAuD,EAAC,CAAC;QAClI,oEAAoE;QACpE,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,uEAAuE;SACvF;KACJ,CAAC;AACN,CAAC;AAED,SAAS,kCAAkC;IACvC,OAAO;QACH,QAAQ,EAAE,wDAAwD;QAClE,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,iCAAiC,CAAC;QAC3C,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EACP,6FAA6F;SACpG;KACJ,CAAC;AACN,CAAC;AAED,SAAS,2BAA2B;IAChC,OAAO;QACH,QAAQ,EAAE,kDAAkD;QAC5D,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,CAAC,SAAS,EAAE,uCAAuC,EAAE,EAAC,SAAS,EAAE,uDAAuD,EAAC,CAAC;QAClI,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,kEAAkE;SAClF;KACJ,CAAC;AACN,CAAC;AAED,SAAS,4BAA4B;IACjC,OAAO;QACH,QAAQ,EAAE,kDAAkD;QAC5D,KAAK,EAAE,KAAK,EAAE,+DAA+D;QAC7E,MAAM,EAAE,CAAC,yBAAyB,CAAC;QACnC,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,kFAAkF;SAClG;KACJ,CAAC;AACN,CAAC;AAED,SAAS,4BAA4B,CAAC,iBAA2B;IAC7D,OAAO;QACH,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,uEAAuE;SACvF;KACJ,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc;IACnB,OAAO;QACH,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QACpC,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,0EAA0E;SAC1F;KACJ,CAAC;AACN,CAAC;AAED,SAAS,gBAAgB;IACrB,OAAO;QACH,QAAQ,EAAE,oCAAoC;QAC9C,KAAK,EAAE,KAAK,EAAE,wCAAwC;QACtD,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,qEAAqE;SACrF;KACJ,CAAC;AACN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,wBAAwB,CAAC,YAAoB,EAAE,WAAmB;IACvE,OAAO;QACH,QAAQ,EAAE,8DAA8D;QACxE,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,OAAO,EAAE,EAAc;QACvB,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,OAAO,CAAC;YACvB,WAAW,EAAE,yDAAyD;SACzE;KACJ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,WAAmB,EAAE,eAAyB;IAC9D,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,oEAAoE;IACpE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QACpC,gCAAgC;QAChC,MAAM,YAAY,GAAG,OAAO;aACvB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,sBAAsB;aAC7C,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,gCAAgC;QAE9D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,kBAAe,EAAE,aAAa,EAAb,qBAAa,EAAE,CAAC","sourcesContent":["/**\n * Unified Nx Inference Plugin for @webpieces/nx-webpieces-rules\n *\n * This plugin automatically creates targets for:\n * 1. Workspace-level architecture validation (generate, visualize, validate-*)\n * 2. Per-project circular dependency checking\n *\n * Install with: nx add @webpieces/nx-webpieces-rules\n *\n * Usage:\n * Add to nx.json plugins array:\n * {\n *   \"plugins\": [\"@webpieces/nx-webpieces-rules\"]\n * }\n *\n * Then all targets appear automatically without manual project.json configuration.\n */\n\nimport { dirname, join } from 'path';\nimport { existsSync } from 'fs';\nimport type {\n    CreateNodesV2,\n    CreateNodesContextV2,\n    CreateNodesResultV2,\n    CreateNodesResult,\n    TargetConfiguration,\n} from '@nx/devkit';\nimport {\n    createVisualizeRuntimeTarget,\n    createValidateRuntimeArchitectureTarget,\n    createValidateRuntimeMarkersTarget,\n} from './runtime-targets';\n\n/**\n * Circular dependency checking options\n */\nexport interface CircularDepsOptions {\n    enabled?: boolean;\n    targetName?: string;\n    excludePatterns?: string[];\n}\n\n/**\n * Validation options for architecture checks\n */\nexport interface ValidationOptions {\n    noCycles?: boolean;\n    noSkipLevelDeps?: boolean;\n    architectureUnchanged?: boolean;\n    validatePackageJson?: boolean;\n    validateNewMethods?: boolean;\n    validateModifiedMethods?: boolean;\n    validateModifiedFiles?: boolean;\n    validateVersionsLocked?: boolean;\n    validateTsInSrc?: boolean;\n    validateNxWiring?: boolean;\n    runtimeArchitecture?: boolean;\n    newMethodsMaxLines?: number;\n    modifiedAndNewMethodsMaxLines?: number;\n    modifiedFilesMaxLines?: number;\n    /**\n     * Validation mode for method/file size limits:\n     * - STRICT: All limits enforced, disable comments ignored\n     * - NORMAL: Limits enforced, disable comments with dates work\n     * - OFF: Skip size validations entirely (for fast iteration)\n     */\n    validationMode?: 'STRICT' | 'NORMAL' | 'OFF';\n}\n\n/**\n * Feature flags for workspace targets\n */\nexport interface FeatureOptions {\n    generate?: boolean;\n    visualize?: boolean;\n    visualizeRuntime?: boolean;\n}\n\n/**\n * Workspace-level configuration options\n */\nexport interface WorkspaceOptions {\n    enabled?: boolean;\n    targetPrefix?: string;\n    graphPath?: string;\n    validations?: ValidationOptions;\n    features?: FeatureOptions;\n}\n\n/**\n * Configuration for @webpieces/nx-webpieces-rules Nx plugin\n */\nexport interface ArchitecturePluginOptions {\n    circularDeps?: CircularDepsOptions;\n    workspace?: WorkspaceOptions;\n}\n\nconst DEFAULT_OPTIONS: Required<ArchitecturePluginOptions> = {\n    circularDeps: {\n        enabled: true,\n        targetName: 'validate-no-file-import-cycles',\n        excludePatterns: [],\n    },\n    workspace: {\n        enabled: true,\n        targetPrefix: 'arch:',\n        graphPath: 'architecture/dependencies.json',\n        validations: {\n            noCycles: true,\n            // Retired: the architecture graph is now auto-reduced in `generate`, so the\n            // committed graph can never contain a skip-level edge. Defaults off; the\n            // executor is a no-op kept for one release. See validate-no-skiplevel-deps.\n            noSkipLevelDeps: false,\n            architectureUnchanged: true,\n            validatePackageJson: true,\n            validateNewMethods: true,\n            validateModifiedMethods: true,\n            validateModifiedFiles: true,\n            validateVersionsLocked: true,\n            validateTsInSrc: true,\n            validateNxWiring: true,\n            runtimeArchitecture: true,\n            newMethodsMaxLines: 30,\n            modifiedAndNewMethodsMaxLines: 80,\n            modifiedFilesMaxLines: 900,\n            validationMode: 'NORMAL',\n        },\n        features: {\n            generate: true,\n            visualize: true,\n            visualizeRuntime: true,\n        },\n    },\n};\n\nfunction normalizeOptions(\n    options: ArchitecturePluginOptions | undefined,\n): Required<ArchitecturePluginOptions> {\n    const circularDeps = {\n        ...DEFAULT_OPTIONS.circularDeps,\n        ...options?.circularDeps,\n    };\n\n    const workspace = {\n        ...DEFAULT_OPTIONS.workspace,\n        ...options?.workspace,\n        validations: {\n            ...DEFAULT_OPTIONS.workspace.validations,\n            ...options?.workspace?.validations,\n        },\n        features: {\n            ...DEFAULT_OPTIONS.workspace.features,\n            ...options?.workspace?.features,\n        },\n    };\n\n    return {\n        circularDeps,\n        workspace,\n    } as Required<ArchitecturePluginOptions>;\n}\n\nasync function createNodesFunction(\n    projectFiles: readonly string[],\n    options: ArchitecturePluginOptions | undefined,\n    context: CreateNodesContextV2,\n): Promise<CreateNodesResultV2> {\n    const opts = normalizeOptions(options);\n    const results: CreateNodesResultV2 = [];\n\n    // Add workspace-level architecture targets\n    addArchitectureProject(results, projectFiles, opts, context);\n\n    // Add per-project targets (circular-deps, ci, runtime-markers)\n    addPerProjectTargets(results, projectFiles, opts, context);\n\n    return results;\n}\n\nfunction addArchitectureProject(\n    results: CreateNodesResultV2,\n    projectFiles: readonly string[],\n    opts: Required<ArchitecturePluginOptions>,\n    context: CreateNodesContextV2,\n): void {\n    if (!opts.workspace.enabled) return;\n\n    const archDirPath = join(context.workspaceRoot, 'architecture');\n    if (!existsSync(archDirPath)) return;\n\n    const workspaceTargets = createWorkspaceTargetsWithoutPrefix(opts);\n    if (Object.keys(workspaceTargets).length === 0) return;\n\n    const result: CreateNodesResult = {\n        projects: {\n            architecture: {\n                name: 'architecture',\n                root: 'architecture',\n                targets: workspaceTargets,\n            },\n        },\n    };\n\n    const firstProjectFile = projectFiles[0];\n    if (firstProjectFile) {\n        results.push([firstProjectFile, result] as const);\n    }\n}\n\n\n// A project sits inside a NESTED git repo (e.g. a clone under repositories/) when any of its\n// ancestor dirs — up to but NOT including the workspace root — contains a `.git`. Such projects are\n// separate repos, not part of THIS workspace's graph, so they must not get inferred targets (that is\n// what drags foreign clones into `nx affected`). Same repo-boundary signal the AI guards use.\nexport function isInsideNestedGitRepo(workspaceRoot: string, projectRoot: string): boolean {\n    let dir = projectRoot;\n    while (dir && dir !== '.' && dir !== '/') {\n        if (existsSync(join(workspaceRoot, dir, '.git'))) return true;\n        const parent = dirname(dir);\n        if (parent === dir) break;\n        dir = parent;\n    }\n    return false;\n}\n\nfunction addPerProjectTargets(\n    results: CreateNodesResultV2,\n    projectFiles: readonly string[],\n    opts: Required<ArchitecturePluginOptions>,\n    context: CreateNodesContextV2,\n): void {\n    // Track processed project roots to avoid duplicates when both files exist\n    const processedRoots = new Set<string>();\n\n    for (const projectFile of projectFiles) {\n        const isProjectJson = projectFile.endsWith('project.json');\n        const isPackageJson = projectFile.endsWith('package.json');\n\n        if (!isProjectJson && !isPackageJson) continue;\n\n        const projectRoot = dirname(projectFile);\n\n        // Skip root (workspace manifest, not a project)\n        if (projectRoot === '.') continue;\n\n        // Skip projects inside a nested git repo (vendored clones under repositories/): they are\n        // separate repos and must not be swept into this workspace's `nx affected` graph.\n        if (isInsideNestedGitRepo(context.workspaceRoot, projectRoot)) continue;\n\n        // Skip if we've already processed this project root\n        if (processedRoots.has(projectRoot)) continue;\n\n        // For package.json, skip if project.json also exists in same directory\n        // (prefer project.json - it will be processed separately)\n        if (isPackageJson) {\n            const projectJsonPath = join(context.workspaceRoot, projectRoot, 'project.json');\n            if (existsSync(projectJsonPath)) continue;\n        }\n\n        processedRoots.add(projectRoot);\n\n        const targets: Record<string, TargetConfiguration> = {};\n\n        // Add circular-deps target ONLY for project.json projects\n        // (package.json-only projects may not have TypeScript source)\n        if (isProjectJson && opts.circularDeps.enabled) {\n            if (!isExcluded(projectRoot, opts.circularDeps.excludePatterns!)) {\n                const targetName = opts.circularDeps.targetName!;\n                targets[targetName] = createCircularDepsTarget(projectRoot, targetName);\n            }\n        }\n\n        // Add per-project runtime-marker validation (validates this project's\n        // service-contract.json against its own api-project deps, independently).\n        if (isProjectJson && opts.workspace.validations!.runtimeArchitecture) {\n            targets['validate-runtime-markers'] = createValidateRuntimeMarkersTarget();\n        }\n\n        // Add ci target to ALL projects (both project.json and package.json)\n        targets['ci'] = createCiTarget();\n\n        if (Object.keys(targets).length === 0) continue;\n\n        const result: CreateNodesResult = {\n            projects: {\n                [projectRoot]: {\n                    targets,\n                },\n            },\n        };\n\n        results.push([projectFile, result] as const);\n    }\n}\n\n/**\n * Nx V2 Inference Plugin\n * Matches project.json and package.json files to create targets\n */\nexport const createNodesV2: CreateNodesV2<ArchitecturePluginOptions> = [\n    // Pattern to match project.json and package.json files\n    '**/{project,package}.json',\n\n    // Inference function\n    createNodesFunction,\n];\n\n/**\n * Build list of enabled validation target names for validate-complete dependency chain\n */\nfunction buildValidationTargetsList(\n    validations: Required<ArchitecturePluginOptions>['workspace']['validations'],\n): string[] {\n    const targets: string[] = [];\n    if (validations!.noCycles) targets.push('validate-no-architecture-cycles');\n    if (validations!.architectureUnchanged) targets.push('validate-architecture-unchanged');\n    if (validations!.noSkipLevelDeps) targets.push('validate-no-skiplevel-deps');\n    if (validations!.validatePackageJson) targets.push('validate-packagejson');\n    // Use combined validate-code instead of 3 separate targets\n    if (\n        validations!.validateNewMethods ||\n        validations!.validateModifiedMethods ||\n        validations!.validateModifiedFiles\n    ) {\n        targets.push('validate-code');\n    }\n    if (validations!.validateVersionsLocked) targets.push('validate-versions-locked');\n    if (validations!.validateTsInSrc) targets.push('validate-ts-in-src');\n    if (validations!.validateNxWiring) targets.push('validate-nx-wiring');\n    if (validations!.runtimeArchitecture) targets.push('validate-runtime-architecture');\n    return targets;\n}\n\n/**\n * Create workspace-level architecture validation targets WITHOUT prefix\n * Used for virtual 'architecture' project\n */\nfunction createWorkspaceTargetsWithoutPrefix(\n    opts: Required<ArchitecturePluginOptions>,\n): Record<string, TargetConfiguration> {\n    const targets: Record<string, TargetConfiguration> = {};\n    const graphPath = opts.workspace.graphPath!;\n    const validations = opts.workspace.validations!;\n\n    // Add help target (always available)\n    targets['help'] = createHelpTarget();\n\n    if (opts.workspace.features!.generate) {\n        targets['generate'] = createGenerateTarget(graphPath);\n    }\n    if (opts.workspace.features!.visualize) {\n        targets['visualize'] = createVisualizeTargetWithoutPrefix(graphPath);\n    }\n    if (opts.workspace.features!.visualizeRuntime) {\n        targets['visualize-runtime'] = createVisualizeRuntimeTarget();\n    }\n    if (validations.noCycles) {\n        targets['validate-no-architecture-cycles'] = createValidateNoCyclesTarget();\n    }\n    if (validations.architectureUnchanged) {\n        targets['validate-architecture-unchanged'] = createValidateUnchangedTarget(graphPath);\n    }\n    if (validations.noSkipLevelDeps) {\n        targets['validate-no-skiplevel-deps'] = createValidateNoSkipLevelTarget();\n    }\n    if (validations.validatePackageJson) {\n        targets['validate-packagejson'] = createValidatePackageJsonTarget();\n    }\n    // Use combined validate-code instead of 3 separate targets\n    // Options come from webpieces.config.json at the workspace root\n    // (loaded via @webpieces/rules-config; same source of truth as @webpieces/ai-hook-rules)\n    if (\n        validations.validateNewMethods ||\n        validations.validateModifiedMethods ||\n        validations.validateModifiedFiles\n    ) {\n        targets['validate-code'] = createValidateCodeTarget();\n    }\n    if (validations.validateVersionsLocked) {\n        targets['validate-versions-locked'] = createValidateVersionsLockedTarget();\n    }\n    if (validations.validateTsInSrc) {\n        targets['validate-ts-in-src'] = createValidateTsInSrcTarget();\n    }\n    if (validations.validateNxWiring) {\n        targets['validate-nx-wiring'] = createValidateNxWiringTarget();\n    }\n    if (validations.runtimeArchitecture) {\n        targets['validate-runtime-architecture'] = createValidateRuntimeArchitectureTarget();\n    }\n\n    // Add validate-complete target that runs all enabled validations\n    const validationTargets = buildValidationTargetsList(validations);\n    if (validationTargets.length > 0) {\n        targets['validate-complete'] = createValidateCompleteTarget(validationTargets);\n    }\n\n    return targets;\n}\n\nfunction createGenerateTarget(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:generate',\n        cache: false,\n        outputs: [\n            '{workspaceRoot}/architecture/dependencies.json',\n            '{workspaceRoot}/architecture/runtime-dependencies.json',\n        ],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description:\n                'Generate the architecture dependency graph and the runtime microservice graph',\n        },\n    };\n}\n\nfunction createVisualizeTargetWithoutPrefix(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:visualize',\n        dependsOn: ['generate'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Generate visual representations of the architecture graph',\n        },\n    };\n}\n\nfunction createValidateNoCyclesTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-architecture-cycles',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the architecture has no circular project dependencies',\n        },\n    };\n}\n\nfunction createValidateUnchangedTarget(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-architecture-unchanged',\n        cache: false,\n        inputs: ['default', '{workspaceRoot}/architecture/dependencies.json'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the architecture matches the saved blessed graph',\n        },\n    };\n}\n\nfunction createValidateNoSkipLevelTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-skiplevel-deps',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate no project has redundant transitive dependencies',\n        },\n    };\n}\n\nfunction createValidatePackageJsonTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-packagejson',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/**/package.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate package.json dependencies match project.json build dependencies',\n        },\n    };\n}\n\nfunction createValidateNewMethodsTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-new-methods',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate new methods do not exceed ${maxLines} lines (only runs in affected mode)`,\n        },\n    };\n}\n\nfunction createValidateModifiedMethodsTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-modified-methods',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate new and modified methods do not exceed ${maxLines} lines (encourages gradual cleanup)`,\n        },\n    };\n}\n\nfunction createValidateModifiedFilesTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-modified-files',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate modified files do not exceed ${maxLines} lines (encourages keeping files small)`,\n        },\n    };\n}\n\n/**\n * Create combined validate-code target\n * Options come from webpieces.config.json at the workspace root\n * (loaded by the executor via @webpieces/rules-config — same source of truth as @webpieces/ai-hook-rules)\n */\nfunction createValidateCodeTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-code',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default', '{workspaceRoot}/webpieces.config.json', {'runtime': 'node -e \"process.stdout.write(String(Math.random()))\"'}],\n        // No options here - they come from webpieces.config.json at runtime\n        metadata: {\n            technologies: ['nx'],\n            description: 'Combined validation for new methods, modified methods, and file sizes',\n        },\n    };\n}\n\nfunction createValidateVersionsLockedTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-versions-locked',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/package.json'],\n        metadata: {\n            technologies: ['nx'],\n            description:\n                'Validate package.json versions are locked (no semver ranges) and consistent across projects',\n        },\n    };\n}\n\nfunction createValidateTsInSrcTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-ts-in-src',\n        cache: false,\n        inputs: ['default', '{workspaceRoot}/webpieces.config.json', {'runtime': 'node -e \"process.stdout.write(String(Math.random()))\"'}],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate all .ts files in projects are inside the src/ directory',\n        },\n    };\n}\n\nfunction createValidateNxWiringTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-nx-wiring',\n        cache: false, // Cheap; depends on nx.json + project graph, not worth caching\n        inputs: ['{workspaceRoot}/nx.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the webpieces validators are wired into the build via nx.json dependsOn',\n        },\n    };\n}\n\nfunction createValidateCompleteTarget(validationTargets: string[]): TargetConfiguration {\n    return {\n        executor: 'nx:noop',\n        cache: true,\n        dependsOn: validationTargets,\n        metadata: {\n            technologies: ['nx'],\n            description: 'Run all architecture validations (cycles, unchanged, skip-level deps)',\n        },\n    };\n}\n\n/**\n * Create per-project ci target - Gradle-style composite target\n * Runs lint, build, and test in parallel\n * (with test depending on build via targetDefaults)\n *\n * NOTE: Type checking is done by the build target (@nx/js:tsc) during compilation.\n */\nfunction createCiTarget(): TargetConfiguration {\n    return {\n        executor: 'nx:noop',\n        cache: true,\n        dependsOn: ['lint', 'build', 'test'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Run all CI checks: lint, build, and test (Gradle-style composite target)',\n        },\n    };\n}\n\nfunction createHelpTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:help',\n        cache: false, // Never cache - always show help output\n        metadata: {\n            technologies: ['nx'],\n            description: 'Display help for @webpieces/nx-webpieces-rules commands and targets',\n        },\n    };\n}\n\n/**\n * Create per-project circular dependency checking target.\n *\n * Uses the `validate-no-file-import-cycles` executor (which bundles madge as a\n * dependency) rather than a runtime `npx madge` fetch. The executor reads\n * webpieces.config.json so the gate can be turned on/off (`mode`) and\n * time-boxed (`ignoreModifiedUntilEpoch`) like every other webpieces rule.\n *\n * Note `projectRoot` is intentionally unused now — the executor derives the\n * project root from the Nx context — but the param is kept for call-site\n * symmetry with the rest of the per-project target factories.\n */\nfunction createCircularDepsTarget(_projectRoot: string, _targetName: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-file-import-cycles',\n        cache: true,\n        inputs: ['default'],\n        outputs: [] as string[],\n        metadata: {\n            technologies: ['madge'],\n            description: 'Check for circular file-import dependencies using madge',\n        },\n    };\n}\n\n/**\n * Check if a project should be excluded based on patterns\n */\nfunction isExcluded(projectRoot: string, excludePatterns: string[]): boolean {\n    if (excludePatterns.length === 0) {\n        return false;\n    }\n\n    // Simple glob matching (could be enhanced with minimatch if needed)\n    return excludePatterns.some((pattern) => {\n        // Convert glob pattern to regex\n        const regexPattern = pattern\n            .replace(/\\*\\*/g, '.*') // ** matches any path\n            .replace(/\\*/g, '[^/]*'); // * matches any string except /\n\n        const regex = new RegExp(`^${regexPattern}$`);\n        return regex.test(projectRoot);\n    });\n}\n\n/**\n * Export plugin as default for Nx\n */\nexport default { createNodesV2 };\n"]}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../../packages/tooling/nx-webpieces-rules/src/plugin.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Unified Nx Inference Plugin for @webpieces/nx-webpieces-rules\n *\n * This plugin automatically creates targets for:\n * 1. Workspace-level architecture validation (generate, visualize, validate-*)\n * 2. Per-project circular dependency checking\n *\n * Install with: nx add @webpieces/nx-webpieces-rules\n *\n * Usage:\n * Add to nx.json plugins array:\n * {\n *   \"plugins\": [\"@webpieces/nx-webpieces-rules\"]\n * }\n *\n * Then all targets appear automatically without manual project.json configuration.\n */\n\nimport { dirname, join } from 'path';\nimport { existsSync } from 'fs';\nimport type {\n    CreateNodesV2,\n    CreateNodesContextV2,\n    CreateNodesResultV2,\n    CreateNodesResult,\n    TargetConfiguration,\n} from '@nx/devkit';\nimport {\n    createVisualizeRuntimeTarget,\n    createValidateRuntimeArchitectureTarget,\n    createValidateRuntimeMarkersTarget,\n} from './runtime-targets';\nimport {\n    createDiGraphGenerateTarget,\n    createValidateDiGraphUnchangedTarget,\n} from './di-graph-targets';\n\n/**\n * Circular dependency checking options\n */\nexport interface CircularDepsOptions {\n    enabled?: boolean;\n    targetName?: string;\n    excludePatterns?: string[];\n}\n\n/**\n * Validation options for architecture checks\n */\nexport interface ValidationOptions {\n    noCycles?: boolean;\n    noSkipLevelDeps?: boolean;\n    architectureUnchanged?: boolean;\n    validatePackageJson?: boolean;\n    validateNewMethods?: boolean;\n    validateModifiedMethods?: boolean;\n    validateModifiedFiles?: boolean;\n    validateVersionsLocked?: boolean;\n    validateTsInSrc?: boolean;\n    validateNxWiring?: boolean;\n    runtimeArchitecture?: boolean;\n    diGraph?: boolean;\n    newMethodsMaxLines?: number;\n    modifiedAndNewMethodsMaxLines?: number;\n    modifiedFilesMaxLines?: number;\n    /**\n     * Validation mode for method/file size limits:\n     * - STRICT: All limits enforced, disable comments ignored\n     * - NORMAL: Limits enforced, disable comments with dates work\n     * - OFF: Skip size validations entirely (for fast iteration)\n     */\n    validationMode?: 'STRICT' | 'NORMAL' | 'OFF';\n}\n\n/**\n * Feature flags for workspace targets\n */\nexport interface FeatureOptions {\n    generate?: boolean;\n    visualize?: boolean;\n    visualizeRuntime?: boolean;\n}\n\n/**\n * Workspace-level configuration options\n */\nexport interface WorkspaceOptions {\n    enabled?: boolean;\n    targetPrefix?: string;\n    graphPath?: string;\n    validations?: ValidationOptions;\n    features?: FeatureOptions;\n}\n\n/**\n * Configuration for @webpieces/nx-webpieces-rules Nx plugin\n */\nexport interface ArchitecturePluginOptions {\n    circularDeps?: CircularDepsOptions;\n    workspace?: WorkspaceOptions;\n}\n\nconst DEFAULT_OPTIONS: Required<ArchitecturePluginOptions> = {\n    circularDeps: {\n        enabled: true,\n        targetName: 'validate-no-file-import-cycles',\n        excludePatterns: [],\n    },\n    workspace: {\n        enabled: true,\n        targetPrefix: 'arch:',\n        graphPath: 'architecture/dependencies.json',\n        validations: {\n            noCycles: true,\n            // Retired: the architecture graph is now auto-reduced in `generate`, so the\n            // committed graph can never contain a skip-level edge. Defaults off; the\n            // executor is a no-op kept for one release. See validate-no-skiplevel-deps.\n            noSkipLevelDeps: false,\n            architectureUnchanged: true,\n            validatePackageJson: true,\n            validateNewMethods: true,\n            validateModifiedMethods: true,\n            validateModifiedFiles: true,\n            validateVersionsLocked: true,\n            validateTsInSrc: true,\n            validateNxWiring: true,\n            runtimeArchitecture: true,\n            diGraph: true,\n            newMethodsMaxLines: 30,\n            modifiedAndNewMethodsMaxLines: 80,\n            modifiedFilesMaxLines: 900,\n            validationMode: 'NORMAL',\n        },\n        features: {\n            generate: true,\n            visualize: true,\n            visualizeRuntime: true,\n        },\n    },\n};\n\nfunction normalizeOptions(\n    options: ArchitecturePluginOptions | undefined,\n): Required<ArchitecturePluginOptions> {\n    const circularDeps = {\n        ...DEFAULT_OPTIONS.circularDeps,\n        ...options?.circularDeps,\n    };\n\n    const workspace = {\n        ...DEFAULT_OPTIONS.workspace,\n        ...options?.workspace,\n        validations: {\n            ...DEFAULT_OPTIONS.workspace.validations,\n            ...options?.workspace?.validations,\n        },\n        features: {\n            ...DEFAULT_OPTIONS.workspace.features,\n            ...options?.workspace?.features,\n        },\n    };\n\n    return {\n        circularDeps,\n        workspace,\n    } as Required<ArchitecturePluginOptions>;\n}\n\nasync function createNodesFunction(\n    projectFiles: readonly string[],\n    options: ArchitecturePluginOptions | undefined,\n    context: CreateNodesContextV2,\n): Promise<CreateNodesResultV2> {\n    const opts = normalizeOptions(options);\n    const results: CreateNodesResultV2 = [];\n\n    // Add workspace-level architecture targets\n    addArchitectureProject(results, projectFiles, opts, context);\n\n    // Add per-project targets (circular-deps, ci, runtime-markers)\n    addPerProjectTargets(results, projectFiles, opts, context);\n\n    return results;\n}\n\nfunction addArchitectureProject(\n    results: CreateNodesResultV2,\n    projectFiles: readonly string[],\n    opts: Required<ArchitecturePluginOptions>,\n    context: CreateNodesContextV2,\n): void {\n    if (!opts.workspace.enabled) return;\n\n    const archDirPath = join(context.workspaceRoot, 'architecture');\n    if (!existsSync(archDirPath)) return;\n\n    const workspaceTargets = createWorkspaceTargetsWithoutPrefix(opts);\n    if (Object.keys(workspaceTargets).length === 0) return;\n\n    const result: CreateNodesResult = {\n        projects: {\n            architecture: {\n                name: 'architecture',\n                root: 'architecture',\n                targets: workspaceTargets,\n            },\n        },\n    };\n\n    const firstProjectFile = projectFiles[0];\n    if (firstProjectFile) {\n        results.push([firstProjectFile, result] as const);\n    }\n}\n\n\n// A project sits inside a NESTED git repo (e.g. a clone under repositories/) when any of its\n// ancestor dirs — up to but NOT including the workspace root — contains a `.git`. Such projects are\n// separate repos, not part of THIS workspace's graph, so they must not get inferred targets (that is\n// what drags foreign clones into `nx affected`). Same repo-boundary signal the AI guards use.\nexport function isInsideNestedGitRepo(workspaceRoot: string, projectRoot: string): boolean {\n    let dir = projectRoot;\n    while (dir && dir !== '.' && dir !== '/') {\n        if (existsSync(join(workspaceRoot, dir, '.git'))) return true;\n        const parent = dirname(dir);\n        if (parent === dir) break;\n        dir = parent;\n    }\n    return false;\n}\n\nfunction addPerProjectTargets(\n    results: CreateNodesResultV2,\n    projectFiles: readonly string[],\n    opts: Required<ArchitecturePluginOptions>,\n    context: CreateNodesContextV2,\n): void {\n    // Track processed project roots to avoid duplicates when both files exist\n    const processedRoots = new Set<string>();\n\n    for (const projectFile of projectFiles) {\n        const isProjectJson = projectFile.endsWith('project.json');\n        const isPackageJson = projectFile.endsWith('package.json');\n\n        if (!isProjectJson && !isPackageJson) continue;\n\n        const projectRoot = dirname(projectFile);\n\n        // Skip root (workspace manifest, not a project)\n        if (projectRoot === '.') continue;\n\n        // Skip projects inside a nested git repo (vendored clones under repositories/): they are\n        // separate repos and must not be swept into this workspace's `nx affected` graph.\n        if (isInsideNestedGitRepo(context.workspaceRoot, projectRoot)) continue;\n\n        // Skip if we've already processed this project root\n        if (processedRoots.has(projectRoot)) continue;\n\n        // For package.json, skip if project.json also exists in same directory\n        // (prefer project.json - it will be processed separately)\n        if (isPackageJson) {\n            const projectJsonPath = join(context.workspaceRoot, projectRoot, 'project.json');\n            if (existsSync(projectJsonPath)) continue;\n        }\n\n        processedRoots.add(projectRoot);\n\n        const targets = buildPerProjectTargets(isProjectJson, projectRoot, opts);\n\n        if (Object.keys(targets).length === 0) continue;\n\n        const result: CreateNodesResult = {\n            projects: {\n                [projectRoot]: {\n                    targets,\n                },\n            },\n        };\n\n        results.push([projectFile, result] as const);\n    }\n}\n\n/**\n * Build the target map for one project. Most targets are project.json-only\n * (package.json-only projects may not have TypeScript source); `ci` goes on all.\n */\nfunction buildPerProjectTargets(\n    isProjectJson: boolean,\n    projectRoot: string,\n    opts: Required<ArchitecturePluginOptions>,\n): Record<string, TargetConfiguration> {\n    const targets: Record<string, TargetConfiguration> = {};\n\n    // Add circular-deps target ONLY for project.json projects\n    if (isProjectJson && opts.circularDeps.enabled) {\n        if (!isExcluded(projectRoot, opts.circularDeps.excludePatterns!)) {\n            const targetName = opts.circularDeps.targetName!;\n            targets[targetName] = createCircularDepsTarget(projectRoot, targetName);\n        }\n    }\n\n    // Add per-project runtime-marker validation (validates this project's\n    // service-contract.json against its own api-project deps, independently).\n    if (isProjectJson && opts.workspace.validations!.runtimeArchitecture) {\n        targets['validate-runtime-markers'] = createValidateRuntimeMarkersTarget();\n    }\n\n    // Per-project DI design DAG: regenerate design.json/design.md on every build,\n    // then gate the build on the committed copies being current.\n    if (isProjectJson && opts.workspace.validations!.diGraph) {\n        targets['di-graph-generate'] = createDiGraphGenerateTarget();\n        targets['validate-di-graph-unchanged'] = createValidateDiGraphUnchangedTarget();\n    }\n\n    // Add ci target to ALL projects (both project.json and package.json)\n    targets['ci'] = createCiTarget();\n\n    return targets;\n}\n\n/**\n * Nx V2 Inference Plugin\n * Matches project.json and package.json files to create targets\n */\nexport const createNodesV2: CreateNodesV2<ArchitecturePluginOptions> = [\n    // Pattern to match project.json and package.json files\n    '**/{project,package}.json',\n\n    // Inference function\n    createNodesFunction,\n];\n\n/**\n * Build list of enabled validation target names for validate-complete dependency chain\n */\nfunction buildValidationTargetsList(\n    validations: Required<ArchitecturePluginOptions>['workspace']['validations'],\n): string[] {\n    const targets: string[] = [];\n    if (validations!.noCycles) targets.push('validate-no-architecture-cycles');\n    if (validations!.architectureUnchanged) targets.push('validate-architecture-unchanged');\n    if (validations!.noSkipLevelDeps) targets.push('validate-no-skiplevel-deps');\n    if (validations!.validatePackageJson) targets.push('validate-packagejson');\n    // Use combined validate-code instead of 3 separate targets\n    if (\n        validations!.validateNewMethods ||\n        validations!.validateModifiedMethods ||\n        validations!.validateModifiedFiles\n    ) {\n        targets.push('validate-code');\n    }\n    if (validations!.validateVersionsLocked) targets.push('validate-versions-locked');\n    if (validations!.validateTsInSrc) targets.push('validate-ts-in-src');\n    if (validations!.validateNxWiring) targets.push('validate-nx-wiring');\n    if (validations!.runtimeArchitecture) targets.push('validate-runtime-architecture');\n    return targets;\n}\n\n/**\n * Create workspace-level architecture validation targets WITHOUT prefix\n * Used for virtual 'architecture' project\n */\nfunction createWorkspaceTargetsWithoutPrefix(\n    opts: Required<ArchitecturePluginOptions>,\n): Record<string, TargetConfiguration> {\n    const targets: Record<string, TargetConfiguration> = {};\n    const graphPath = opts.workspace.graphPath!;\n    const validations = opts.workspace.validations!;\n\n    // Add help target (always available)\n    targets['help'] = createHelpTarget();\n\n    if (opts.workspace.features!.generate) {\n        targets['generate'] = createGenerateTarget(graphPath);\n    }\n    if (opts.workspace.features!.visualize) {\n        targets['visualize'] = createVisualizeTargetWithoutPrefix(graphPath);\n    }\n    if (opts.workspace.features!.visualizeRuntime) {\n        targets['visualize-runtime'] = createVisualizeRuntimeTarget();\n    }\n    if (validations.noCycles) {\n        targets['validate-no-architecture-cycles'] = createValidateNoCyclesTarget();\n    }\n    if (validations.architectureUnchanged) {\n        targets['validate-architecture-unchanged'] = createValidateUnchangedTarget(graphPath);\n    }\n    if (validations.noSkipLevelDeps) {\n        targets['validate-no-skiplevel-deps'] = createValidateNoSkipLevelTarget();\n    }\n    if (validations.validatePackageJson) {\n        targets['validate-packagejson'] = createValidatePackageJsonTarget();\n    }\n    // Use combined validate-code instead of 3 separate targets\n    // Options come from webpieces.config.json at the workspace root\n    // (loaded via @webpieces/rules-config; same source of truth as @webpieces/ai-hook-rules)\n    if (\n        validations.validateNewMethods ||\n        validations.validateModifiedMethods ||\n        validations.validateModifiedFiles\n    ) {\n        targets['validate-code'] = createValidateCodeTarget();\n    }\n    if (validations.validateVersionsLocked) {\n        targets['validate-versions-locked'] = createValidateVersionsLockedTarget();\n    }\n    if (validations.validateTsInSrc) {\n        targets['validate-ts-in-src'] = createValidateTsInSrcTarget();\n    }\n    if (validations.validateNxWiring) {\n        targets['validate-nx-wiring'] = createValidateNxWiringTarget();\n    }\n    if (validations.runtimeArchitecture) {\n        targets['validate-runtime-architecture'] = createValidateRuntimeArchitectureTarget();\n    }\n\n    // Add validate-complete target that runs all enabled validations\n    const validationTargets = buildValidationTargetsList(validations);\n    if (validationTargets.length > 0) {\n        targets['validate-complete'] = createValidateCompleteTarget(validationTargets);\n    }\n\n    return targets;\n}\n\nfunction createGenerateTarget(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:generate',\n        cache: false,\n        outputs: [\n            '{workspaceRoot}/architecture/dependencies.json',\n            '{workspaceRoot}/architecture/runtime-dependencies.json',\n        ],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description:\n                'Generate the architecture dependency graph and the runtime microservice graph',\n        },\n    };\n}\n\nfunction createVisualizeTargetWithoutPrefix(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:visualize',\n        dependsOn: ['generate'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Generate visual representations of the architecture graph',\n        },\n    };\n}\n\nfunction createValidateNoCyclesTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-architecture-cycles',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the architecture has no circular project dependencies',\n        },\n    };\n}\n\nfunction createValidateUnchangedTarget(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-architecture-unchanged',\n        cache: false,\n        inputs: ['default', '{workspaceRoot}/architecture/dependencies.json'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the architecture matches the saved blessed graph',\n        },\n    };\n}\n\nfunction createValidateNoSkipLevelTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-skiplevel-deps',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate no project has redundant transitive dependencies',\n        },\n    };\n}\n\nfunction createValidatePackageJsonTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-packagejson',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/**/package.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate package.json dependencies match project.json build dependencies',\n        },\n    };\n}\n\nfunction createValidateNewMethodsTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-new-methods',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate new methods do not exceed ${maxLines} lines (only runs in affected mode)`,\n        },\n    };\n}\n\nfunction createValidateModifiedMethodsTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-modified-methods',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate new and modified methods do not exceed ${maxLines} lines (encourages gradual cleanup)`,\n        },\n    };\n}\n\nfunction createValidateModifiedFilesTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-modified-files',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate modified files do not exceed ${maxLines} lines (encourages keeping files small)`,\n        },\n    };\n}\n\n/**\n * Create combined validate-code target\n * Options come from webpieces.config.json at the workspace root\n * (loaded by the executor via @webpieces/rules-config — same source of truth as @webpieces/ai-hook-rules)\n */\nfunction createValidateCodeTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-code',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default', '{workspaceRoot}/webpieces.config.json', {'runtime': 'node -e \"process.stdout.write(String(Math.random()))\"'}],\n        // No options here - they come from webpieces.config.json at runtime\n        metadata: {\n            technologies: ['nx'],\n            description: 'Combined validation for new methods, modified methods, and file sizes',\n        },\n    };\n}\n\nfunction createValidateVersionsLockedTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-versions-locked',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/package.json'],\n        metadata: {\n            technologies: ['nx'],\n            description:\n                'Validate package.json versions are locked (no semver ranges) and consistent across projects',\n        },\n    };\n}\n\nfunction createValidateTsInSrcTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-ts-in-src',\n        cache: false,\n        inputs: ['default', '{workspaceRoot}/webpieces.config.json', {'runtime': 'node -e \"process.stdout.write(String(Math.random()))\"'}],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate all .ts files in projects are inside the src/ directory',\n        },\n    };\n}\n\nfunction createValidateNxWiringTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-nx-wiring',\n        cache: false, // Cheap; depends on nx.json + project graph, not worth caching\n        inputs: ['{workspaceRoot}/nx.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the webpieces validators are wired into the build via nx.json dependsOn',\n        },\n    };\n}\n\nfunction createValidateCompleteTarget(validationTargets: string[]): TargetConfiguration {\n    return {\n        executor: 'nx:noop',\n        cache: true,\n        dependsOn: validationTargets,\n        metadata: {\n            technologies: ['nx'],\n            description: 'Run all architecture validations (cycles, unchanged, skip-level deps)',\n        },\n    };\n}\n\n/**\n * Create per-project ci target - Gradle-style composite target\n * Runs lint, build, and test in parallel\n * (with test depending on build via targetDefaults)\n *\n * NOTE: Type checking is done by the build target (@nx/js:tsc) during compilation.\n */\nfunction createCiTarget(): TargetConfiguration {\n    return {\n        executor: 'nx:noop',\n        cache: true,\n        dependsOn: ['lint', 'build', 'test'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Run all CI checks: lint, build, and test (Gradle-style composite target)',\n        },\n    };\n}\n\nfunction createHelpTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:help',\n        cache: false, // Never cache - always show help output\n        metadata: {\n            technologies: ['nx'],\n            description: 'Display help for @webpieces/nx-webpieces-rules commands and targets',\n        },\n    };\n}\n\n/**\n * Create per-project circular dependency checking target.\n *\n * Uses the `validate-no-file-import-cycles` executor (which bundles madge as a\n * dependency) rather than a runtime `npx madge` fetch. The executor reads\n * webpieces.config.json so the gate can be turned on/off (`mode`) and\n * time-boxed (`ignoreModifiedUntilEpoch`) like every other webpieces rule.\n *\n * Note `projectRoot` is intentionally unused now — the executor derives the\n * project root from the Nx context — but the param is kept for call-site\n * symmetry with the rest of the per-project target factories.\n */\nfunction createCircularDepsTarget(_projectRoot: string, _targetName: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-file-import-cycles',\n        cache: true,\n        inputs: ['default'],\n        outputs: [] as string[],\n        metadata: {\n            technologies: ['madge'],\n            description: 'Check for circular file-import dependencies using madge',\n        },\n    };\n}\n\n/**\n * Check if a project should be excluded based on patterns\n */\nfunction isExcluded(projectRoot: string, excludePatterns: string[]): boolean {\n    if (excludePatterns.length === 0) {\n        return false;\n    }\n\n    // Simple glob matching (could be enhanced with minimatch if needed)\n    return excludePatterns.some((pattern) => {\n        // Convert glob pattern to regex\n        const regexPattern = pattern\n            .replace(/\\*\\*/g, '.*') // ** matches any path\n            .replace(/\\*/g, '[^/]*'); // * matches any string except /\n\n        const regex = new RegExp(`^${regexPattern}$`);\n        return regex.test(projectRoot);\n    });\n}\n\n/**\n * Export plugin as default for Nx\n */\nexport default { createNodesV2 };\n"]}