@webpieces/nx-webpieces-rules 0.0.1 → 0.2.113

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/nx-webpieces-rules",
-  "version": "0.0.1",
+  "version": "0.2.113",
   "description": "Nx-specific webpieces validation rules. Includes all rules from @webpieces/webpieces-rules plus Nx graph validators and inference plugin.",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -17,8 +17,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@webpieces/webpieces-rules": "0.0.1",
-    "@webpieces/code-rules": "0.0.1"
+    "@webpieces/webpieces-rules": "0.2.113",
+    "@webpieces/code-rules": "0.2.113"
   },
   "peerDependencies": {
     "@nx/devkit": ">=18.0.0"
@@ -32,5 +32,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "types": "./src/index.d.ts"
 }

package/src/executor-result.d.ts

@@ -0,0 +1,4 @@
+export declare class ExecutorResult {
+    success: boolean;
+    constructor(success: boolean);
+}

package/src/executor-result.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutorResult = void 0;
+class ExecutorResult {
+    constructor(success) {
+        this.success = success;
+    }
+}
+exports.ExecutorResult = ExecutorResult;
+//# sourceMappingURL=executor-result.js.map

package/src/executor-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-result.js","sourceRoot":"","sources":["../../../../../packages/tooling/nx-webpieces-rules/src/executor-result.ts"],"names":[],"mappings":";;;AAAA,MAAa,cAAc;IAGvB,YAAY,OAAgB;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CACJ;AAND,wCAMC","sourcesContent":["export class ExecutorResult {\n    success: boolean;\n\n    constructor(success: boolean) {\n        this.success = success;\n    }\n}\n"]}

package/src/executors/generate/executor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generate Executor
+ *
+ * Generates the architecture dependency graph and saves it to architecture/dependencies.json.
+ *
+ * Usage:
+ * nx run architecture:generate
+ */
+import type { ExecutorContext } from '@nx/devkit';
+export interface GenerateExecutorOptions {
+    graphPath?: string;
+}
+export interface ExecutorResult {
+    success: boolean;
+}
+export default function runExecutor(options: GenerateExecutorOptions, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/generate/{executor.ts → executor.js}

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Generate Executor
  *
@@ -6,56 +7,40 @@
  * Usage:
  * nx run architecture:generate
  */
-
-import type { ExecutorContext } from '@nx/devkit';
-import { generateGraph } from '../../lib/graph-generator';
-import { sortGraphTopologically } from '../../lib/graph-sorter';
-import { saveGraph } from '../../lib/graph-loader';
-import { toError } from '../../toError';
-
-export interface GenerateExecutorOptions {
-    graphPath?: string;
-}
-
-export interface ExecutorResult {
-    success: boolean;
-}
-
-export default async function runExecutor(
-    options: GenerateExecutorOptions,
-    context: ExecutorContext
-): Promise<ExecutorResult> {
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const graph_generator_1 = require("../../lib/graph-generator");
+const graph_sorter_1 = require("../../lib/graph-sorter");
+const graph_loader_1 = require("../../lib/graph-loader");
+const toError_1 = require("../../toError");
+async function runExecutor(options, context) {
     const graphPath = options.graphPath;
     const workspaceRoot = context.root;
-
     console.log('\n📊 Architecture Graph Generator\n');
-
     // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
     try {
         // Step 1: Generate current graph from project.json files
         console.log('📊 Generating dependency graph from project.json files...');
-        const rawGraph = await generateGraph();
-
+        const rawGraph = await (0, graph_generator_1.generateGraph)();
         // Step 2: Topological sort (to assign levels for visualization)
         console.log('🔄 Computing topological layers...');
-        const enhancedGraph = sortGraphTopologically(rawGraph);
-
+        const enhancedGraph = (0, graph_sorter_1.sortGraphTopologically)(rawGraph);
         // Step 3: Save the graph
         console.log('💾 Saving graph to architecture/dependencies.json...');
-        saveGraph(enhancedGraph, workspaceRoot, graphPath);
+        (0, graph_loader_1.saveGraph)(enhancedGraph, workspaceRoot, graphPath);
         console.log('✅ Graph saved successfully');
-
         // Print summary
         const projectCount = Object.keys(enhancedGraph).length;
         const levels = new Set(Object.values(enhancedGraph).map((e) => e.level));
         console.log(`\n📈 Graph Summary:`);
         console.log(`   Projects: ${projectCount}`);
         console.log(`   Levels: ${levels.size} (0-${Math.max(...levels)})`);
-
         return { success: true };
-    } catch (err: unknown) {
-        const error = toError(err);
+    }
+    catch (err) {
+        const error = (0, toError_1.toError)(err);
         console.error('❌ Graph generation failed:', error.message);
         return { success: false };
     }
 }
+//# sourceMappingURL=executor.js.map

package/src/executors/generate/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/generate/executor.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAgBH,8BAqCC;AAlDD,+DAA0D;AAC1D,yDAAgE;AAChE,yDAAmD;AACnD,2CAAwC;AAUzB,KAAK,UAAU,WAAW,CACrC,OAAgC,EAChC,OAAwB;IAExB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IAEnD,8DAA8D;IAC9D,IAAI,CAAC;QACD,yDAAyD;QACzD,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAa,GAAE,CAAC;QAEvC,gEAAgE;QAChE,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,IAAA,qCAAsB,EAAC,QAAQ,CAAC,CAAC;QAEvD,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,IAAA,wBAAS,EAAC,aAAa,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAE1C,gBAAgB;QAChB,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,gBAAgB,YAAY,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAEpE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,IAAA,iBAAO,EAAC,GAAG,CAAC,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;AACL,CAAC","sourcesContent":["/**\n * Generate Executor\n *\n * Generates the architecture dependency graph and saves it to architecture/dependencies.json.\n *\n * Usage:\n * nx run architecture:generate\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { generateGraph } from '../../lib/graph-generator';\nimport { sortGraphTopologically } from '../../lib/graph-sorter';\nimport { saveGraph } from '../../lib/graph-loader';\nimport { toError } from '../../toError';\n\nexport interface GenerateExecutorOptions {\n    graphPath?: string;\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nexport default async function runExecutor(\n    options: GenerateExecutorOptions,\n    context: ExecutorContext\n): Promise<ExecutorResult> {\n    const graphPath = options.graphPath;\n    const workspaceRoot = context.root;\n\n    console.log('\\n📊 Architecture Graph Generator\\n');\n\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        // Step 1: Generate current graph from project.json files\n        console.log('📊 Generating dependency graph from project.json files...');\n        const rawGraph = await generateGraph();\n\n        // Step 2: Topological sort (to assign levels for visualization)\n        console.log('🔄 Computing topological layers...');\n        const enhancedGraph = sortGraphTopologically(rawGraph);\n\n        // Step 3: Save the graph\n        console.log('💾 Saving graph to architecture/dependencies.json...');\n        saveGraph(enhancedGraph, workspaceRoot, graphPath);\n        console.log('✅ Graph saved successfully');\n\n        // Print summary\n        const projectCount = Object.keys(enhancedGraph).length;\n        const levels = new Set(Object.values(enhancedGraph).map((e) => e.level));\n        console.log(`\\n📈 Graph Summary:`);\n        console.log(`   Projects: ${projectCount}`);\n        console.log(`   Levels: ${levels.size} (0-${Math.max(...levels)})`);\n\n        return { success: true };\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error('❌ Graph generation failed:', error.message);\n        return { success: false };\n    }\n}\n"]}

package/src/executors/help/executor.d.ts

@@ -0,0 +1,8 @@
+import type { ExecutorContext } from '@nx/devkit';
+export interface HelpExecutorOptions {
+}
+type HelpExecutorResult = {
+    success: true;
+};
+export default function helpExecutor(options: HelpExecutorOptions, context: ExecutorContext): Promise<HelpExecutorResult>;
+export {};

package/src/executors/help/{executor.ts → executor.js}

@@ -1,18 +1,11 @@
-import type { ExecutorContext } from '@nx/devkit';
-
-export interface HelpExecutorOptions {}
-
-type HelpExecutorResult = { success: true };
-
-export default async function helpExecutor(
-    options: HelpExecutorOptions,
-    context: ExecutorContext
-): Promise<HelpExecutorResult> {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = helpExecutor;
+async function helpExecutor(options, context) {
     // ANSI color codes
     const GREEN = '\x1b[32m\x1b[1m';
     const BOLD = '\x1b[1m';
     const RESET = '\x1b[0m';
-
     console.log('');
     console.log(`${GREEN}💡 @webpieces/nx-webpieces-rules - Available Commands${RESET}`);
     console.log('');
@@ -58,6 +51,6 @@ export default async function helpExecutor(
     console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the graph first`);
     console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);
     console.log('');
-
     return { success: true };
 }
+//# sourceMappingURL=executor.js.map

package/src/executors/help/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/help/executor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\n\nexport interface HelpExecutorOptions {}\n\ntype HelpExecutorResult = { success: true };\n\nexport default async function helpExecutor(\n    options: HelpExecutorOptions,\n    context: ExecutorContext\n): Promise<HelpExecutorResult> {\n    // ANSI color codes\n    const GREEN = '\\x1b[32m\\x1b[1m';\n    const BOLD = '\\x1b[1m';\n    const RESET = '\\x1b[0m';\n\n    console.log('');\n    console.log(`${GREEN}💡 @webpieces/nx-webpieces-rules - Available Commands${RESET}`);\n    console.log('');\n    console.log(`${BOLD}📝 Available npm scripts (convenient shortcuts):${RESET}`);\n    console.log('');\n    console.log('  Architecture graph:');\n    console.log('    npm run arch:generate                  # Generate dependency graph');\n    console.log('    npm run arch:visualize                 # Visualize dependency graph');\n    console.log('');\n    console.log('  Validation:');\n    console.log('    npm run arch:validate                  # Quick validation (no-cycles + no-skiplevel-deps)');\n    console.log('    npm run arch:validate-all              # Full arch validation (+ unchanged check)');\n    console.log('    npm run arch:check-circular            # Check all projects for circular deps');\n    console.log('    npm run arch:check-circular-affected   # Check affected projects only');\n    console.log('    npm run arch:validate-complete         # Complete validation (arch + circular)');\n    console.log('');\n    console.log(`${BOLD}📝 Available Nx targets:${RESET}`);\n    console.log('');\n    console.log('  Workspace-level architecture validation:');\n    console.log('    nx run architecture:generate                         # Generate dependency graph');\n    console.log('    nx run architecture:visualize                        # Visualize dependency graph');\n    console.log('    nx run architecture:validate-no-architecture-cycles  # Check for circular project dependencies');\n    console.log('    nx run architecture:validate-no-skiplevel-deps       # Check for redundant dependencies');\n    console.log('    nx run architecture:validate-architecture-unchanged  # Validate against blessed graph');\n    console.log('');\n    console.log('  Per-project file import cycle checking:');\n    console.log('    nx run <project>:validate-no-file-import-cycles           # Check project for file import cycles');\n    console.log('    nx affected --target=validate-no-file-import-cycles       # Check all affected projects');\n    console.log('    nx run-many --target=validate-no-file-import-cycles --all # Check all projects');\n    console.log('');\n    console.log('  Per-project CI target (lint + build + test):');\n    console.log('    nx run <project>:ci                    # Run lint, build, test together');\n    console.log('    nx run-many --target=ci --all          # Run ci for all projects');\n    console.log('');\n    console.log('    Execution order (test waits for build via targetDefaults):');\n    console.log('    ci (nx:noop)');\n    console.log('    ├── lint ─────────────────┐');\n    console.log('    ├── build ────────────────┼── run in parallel');\n    console.log('    └── test ─────────────────┘');\n    console.log('        └── depends on build (waits)');\n    console.log('');\n    console.log(`${GREEN}💡 Quick start:${RESET}`);\n    console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the graph first`);\n    console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);\n    console.log('');\n\n    return { success: true };\n}\n"]}

package/src/executors/validate-architecture-unchanged/executor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Validate Architecture Unchanged Executor
+ *
+ * Validates that the current architecture graph matches the saved blessed graph.
+ * This ensures no unapproved architecture changes have been made.
+ *
+ * Usage:
+ * nx run architecture:validate-architecture-unchanged
+ */
+import type { ExecutorContext } from '@nx/devkit';
+export interface ValidateArchitectureUnchangedOptions {
+    graphPath?: string;
+}
+export interface ExecutorResult {
+    success: boolean;
+}
+export default function runExecutor(options: ValidateArchitectureUnchangedOptions, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-architecture-unchanged/{executor.ts → executor.js}

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Validate Architecture Unchanged Executor
  *
@@ -7,27 +8,18 @@
  * Usage:
  * nx run architecture:validate-architecture-unchanged
  */
-
-import type { ExecutorContext } from '@nx/devkit';
-import * as fs from 'fs';
-import * as path from 'path';
-import { generateGraph } from '../../lib/graph-generator';
-import { sortGraphTopologically } from '../../lib/graph-sorter';
-import { compareGraphs } from '../../lib/graph-comparator';
-import { loadBlessedGraph, graphFileExists } from '../../lib/graph-loader';
-import { toError } from '../../toError';
-
-export interface ValidateArchitectureUnchangedOptions {
-    graphPath?: string;
-}
-
-export interface ExecutorResult {
-    success: boolean;
-}
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const graph_generator_1 = require("../../lib/graph-generator");
+const graph_sorter_1 = require("../../lib/graph-sorter");
+const graph_comparator_1 = require("../../lib/graph-comparator");
+const graph_loader_1 = require("../../lib/graph-loader");
+const toError_1 = require("../../toError");
 const TMP_DIR = '.webpieces/instruct-ai';
 const TMP_MD_FILE = 'webpieces.dependencies.md';
-
 const DEPENDENCIES_DOC_CONTENT = `# Instructions: Architecture Dependency Violation
 
 IN GENERAL, it is better to avoid these changes and find a different way by moving classes
@@ -165,36 +157,26 @@ Instead of importing, receive the dependency as a constructor or method paramete
 - The best dependency is the one you don't need
 - When in doubt, refactor rather than add dependencies
 `;
-
 /**
  * Write the instructions documentation to tmp directory
  */
-function writeTmpInstructionsFile(workspaceRoot: string): string {
+function writeTmpInstructionsFile(workspaceRoot) {
     const tmpDir = path.join(workspaceRoot, TMP_DIR);
     const mdPath = path.join(tmpDir, TMP_MD_FILE);
-
     // Ensure tmp directory exists
     fs.mkdirSync(tmpDir, { recursive: true });
-
     // Write documentation MD file
     fs.writeFileSync(mdPath, DEPENDENCIES_DOC_CONTENT);
-
     return mdPath;
 }
-
-export default async function runExecutor(
-    options: ValidateArchitectureUnchangedOptions,
-    context: ExecutorContext
-): Promise<ExecutorResult> {
+async function runExecutor(options, context) {
     const graphPath = options.graphPath;
     const workspaceRoot = context.root;
-
     console.log('\n🔍 Validating Architecture Unchanged\n');
-
     // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
     try {
         // Check if saved graph exists
-        if (!graphFileExists(workspaceRoot, graphPath)) {
+        if (!(0, graph_loader_1.graphFileExists)(workspaceRoot, graphPath)) {
             console.error('❌ No saved graph found at architecture/dependencies.json');
             console.error('');
             console.error('To initialize:');
@@ -204,35 +186,29 @@ export default async function runExecutor(
             console.error('  4. Commit architecture/dependencies.json');
             return { success: false };
         }
-
         // Step 1: Generate current graph from project.json files
         console.log('📊 Generating current dependency graph...');
-        const rawGraph = await generateGraph();
-
+        const rawGraph = await (0, graph_generator_1.generateGraph)();
         // Step 2: Topological sort (to get enhanced graph with levels)
         console.log('🔄 Computing topological layers...');
-        const currentGraph = sortGraphTopologically(rawGraph);
-
+        const currentGraph = (0, graph_sorter_1.sortGraphTopologically)(rawGraph);
         // Step 3: Load saved graph
         console.log('📂 Loading saved graph...');
-        const savedGraph = loadBlessedGraph(workspaceRoot, graphPath);
-
+        const savedGraph = (0, graph_loader_1.loadBlessedGraph)(workspaceRoot, graphPath);
         if (!savedGraph) {
             console.error('❌ Could not load saved graph');
             return { success: false };
         }
-
         // Step 4: Compare graphs
         console.log('🔍 Comparing current graph to saved graph...');
-        const comparison = compareGraphs(currentGraph, savedGraph);
-
+        const comparison = (0, graph_comparator_1.compareGraphs)(currentGraph, savedGraph);
         if (comparison.identical) {
             console.log('✅ Architecture unchanged - current graph matches saved graph');
             return { success: true };
-        } else {
+        }
+        else {
             // Write instructions file for AI agent
             const mdPath = writeTmpInstructionsFile(workspaceRoot);
-
             console.error('❌ Architecture has changed since last update!');
             console.error('\nDifferences:');
             console.error(comparison.summary);
@@ -245,9 +221,11 @@ export default async function runExecutor(
             console.error('  3. Commit the updated architecture/dependencies.json');
             return { success: false };
         }
-    } catch (err: unknown) {
-        const error = toError(err);
+    }
+    catch (err) {
+        const error = (0, toError_1.toError)(err);
         console.error('❌ Architecture validation failed:', error.message);
         return { success: false };
     }
 }
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-architecture-unchanged/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-architecture-unchanged/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Validate Architecture Unchanged Executor\n *\n * Validates that the current architecture graph matches the saved blessed graph.\n * This ensures no unapproved architecture changes have been made.\n *\n * Usage:\n * nx run architecture:validate-architecture-unchanged\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { generateGraph } from '../../lib/graph-generator';\nimport { sortGraphTopologically } from '../../lib/graph-sorter';\nimport { compareGraphs } from '../../lib/graph-comparator';\nimport { loadBlessedGraph, graphFileExists } from '../../lib/graph-loader';\nimport { toError } from '../../toError';\n\nexport interface ValidateArchitectureUnchangedOptions {\n    graphPath?: string;\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nconst TMP_DIR = '.webpieces/instruct-ai';\nconst TMP_MD_FILE = 'webpieces.dependencies.md';\n\nconst DEPENDENCIES_DOC_CONTENT = `# Instructions: Architecture Dependency Violation\n\nIN GENERAL, it is better to avoid these changes and find a different way by moving classes\naround to existing packages you already depend on. It is not always avoidable though.\nA clean dependency graph keeps you out of huge trouble later.\n\nIf you are a human, simply run these commands:\n* nx run architecture:visualize - to see the new dependencies and validate that change is desired\n* nx run architecture:generate - updates the dep graph\n* git diff architecture/dependencies.json - to see the deps changes you made\n\n**READ THIS FILE FIRST before making any changes!**\n\n## ⚠️ CRITICAL WARNING ⚠️\n\n**This is a VERY IMPORTANT change that has LARGE REPERCUSSIONS later!**\n\nAdding new dependencies creates technical debt that compounds over time:\n- Creates coupling between packages that may be hard to undo\n- Can create circular dependency tangles\n- Makes packages harder to test in isolation\n- Increases build times and bundle sizes\n- May force unnecessary upgrades across the codebase\n\n**DO NOT add dependencies without senior developer approval!**\n\n## Understanding the Error\n\nYou've attempted to import from a package that is not in your project's allowed dependencies.\nThe architecture enforces a layered dependency structure where:\n- Level 0 packages are foundation packages with NO dependencies on other @webpieces packages\n- Higher level packages can only depend on lower level packages\n- All dependencies must be explicitly declared\n\n## Steps to Resolve\n\n### Step 1: Generate Current Dependency Graph\nRun this command to see the current architecture:\n\\`\\`\\`bash\nnpx nx run architecture:generate\n\\`\\`\\`\nThis creates/updates \\`architecture/dependencies.json\\` showing all packages and their levels.\n\n### Step 2: Analyze the Proposed Change\nAsk yourself:\n1. **Is this import truly necessary?** Can you refactor to avoid it?\n2. **Should the code move instead?** Maybe the code belongs in a different package.\n3. **Will this create a cycle?** Use \\`npx nx graph\\` to visualize dependencies.\n4. **Can you use an interface/abstraction?** Define interface in lower-level package, implement in higher-level.\n\n### Step 3: Get Senior Developer Approval\n\n## 🛑 AI AGENTS: STOP HERE AND ASK FOR HUMAN APPROVAL! 🛑\n\n**YOU MUST NOT PROCEED TO STEP 4 WITHOUT EXPLICIT HUMAN APPROVAL!**\n\n**REQUIRED**: Discuss this architectural change with a senior developer before proceeding.\n- Explain why the dependency is needed\n- Show you've considered alternatives (Step 2)\n- **WAIT for explicit approval before making ANY changes to project.json or package.json**\n\n**AI Agent Instructions:**\n1. Present your analysis from Step 2 to the human\n2. Explain which package needs which dependency and why\n3. ASK: \"Do you approve adding this dependency?\"\n4. **DO NOT modify project.json or package.json until you receive explicit \"yes\" or approval**\n\n### Step 4: If Approved, Add the Dependency\n\n## ⛔ NEVER MODIFY THESE FILES WITHOUT HUMAN APPROVAL FROM STEP 3! ⛔\n\nOnly after receiving explicit human approval in Step 3, make these changes:\n\n1. **Update project.json** - Add to \\`build.dependsOn\\`:\n   \\`\\`\\`json\n   {\n     \"targets\": {\n       \"build\": {\n         \"dependsOn\": [\"^build\", \"dep1:build\", \"NEW_PACKAGE:build\"]\n       }\n     }\n   }\n   \\`\\`\\`\n\n2. **Update package.json** - Add to \\`dependencies\\`:\n   \\`\\`\\`json\n   {\n     \"dependencies\": {\n       \"@webpieces/NEW_PACKAGE\": \"*\"\n     }\n   }\n   \\`\\`\\`\n\n### Step 5: Update Architecture Definition\nRun this command to validate and update the architecture:\n\\`\\`\\`bash\nnpx nx run architecture:generate\n\\`\\`\\`\n\nThis will:\n- Detect any cycles (which MUST be fixed before proceeding)\n- Update \\`architecture/dependencies.json\\` with the new dependency\n- Recalculate package levels\n\n### Step 6: Verify No Cycles\n\\`\\`\\`bash\nnpx nx run architecture:validate-no-architecture-cycles\n\\`\\`\\`\n\nIf cycles are detected, you MUST refactor to break the cycle. Common strategies:\n- Move shared code to a lower-level package\n- Use dependency inversion (interfaces in low-level, implementations in high-level)\n- Restructure package boundaries\n\n## Alternative Solutions (Preferred over adding dependencies)\n\n### Option A: Move the Code\nIf you need functionality from another package, consider moving that code to a shared lower-level package.\n\n### Option B: Dependency Inversion\nDefine an interface in the lower-level package, implement it in the higher-level package:\n\\`\\`\\`typescript\n// In foundation package (level 0)\nexport interface Logger { log(msg: string): void; }\n\n// In higher-level package\nexport class ConsoleLogger implements Logger { ... }\n\\`\\`\\`\n\n### Option C: Pass Dependencies as Parameters\nInstead of importing, receive the dependency as a constructor or method parameter.\n\n## Remember\n- Every dependency you add today is technical debt for tomorrow\n- The best dependency is the one you don't need\n- When in doubt, refactor rather than add dependencies\n`;\n\n/**\n * Write the instructions documentation to tmp directory\n */\nfunction writeTmpInstructionsFile(workspaceRoot: string): string {\n    const tmpDir = path.join(workspaceRoot, TMP_DIR);\n    const mdPath = path.join(tmpDir, TMP_MD_FILE);\n\n    // Ensure tmp directory exists\n    fs.mkdirSync(tmpDir, { recursive: true });\n\n    // Write documentation MD file\n    fs.writeFileSync(mdPath, DEPENDENCIES_DOC_CONTENT);\n\n    return mdPath;\n}\n\nexport default async function runExecutor(\n    options: ValidateArchitectureUnchangedOptions,\n    context: ExecutorContext\n): Promise<ExecutorResult> {\n    const graphPath = options.graphPath;\n    const workspaceRoot = context.root;\n\n    console.log('\\n🔍 Validating Architecture Unchanged\\n');\n\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        // Check if saved graph exists\n        if (!graphFileExists(workspaceRoot, graphPath)) {\n            console.error('❌ No saved graph found at architecture/dependencies.json');\n            console.error('');\n            console.error('To initialize:');\n            console.error('  1. Run: nx run architecture:generate');\n            console.error('  2. Run: nx run architecture:visualize');\n            console.error('  3. Manually inspect the generated graph to confirm it is the desired architecture');\n            console.error('  4. Commit architecture/dependencies.json');\n            return { success: false };\n        }\n\n        // Step 1: Generate current graph from project.json files\n        console.log('📊 Generating current dependency graph...');\n        const rawGraph = await generateGraph();\n\n        // Step 2: Topological sort (to get enhanced graph with levels)\n        console.log('🔄 Computing topological layers...');\n        const currentGraph = sortGraphTopologically(rawGraph);\n\n        // Step 3: Load saved graph\n        console.log('📂 Loading saved graph...');\n        const savedGraph = loadBlessedGraph(workspaceRoot, graphPath);\n\n        if (!savedGraph) {\n            console.error('❌ Could not load saved graph');\n            return { success: false };\n        }\n\n        // Step 4: Compare graphs\n        console.log('🔍 Comparing current graph to saved graph...');\n        const comparison = compareGraphs(currentGraph, savedGraph);\n\n        if (comparison.identical) {\n            console.log('✅ Architecture unchanged - current graph matches saved graph');\n            return { success: true };\n        } else {\n            // Write instructions file for AI agent\n            const mdPath = writeTmpInstructionsFile(workspaceRoot);\n\n            console.error('❌ Architecture has changed since last update!');\n            console.error('\\nDifferences:');\n            console.error(comparison.summary);\n            console.error('');\n            console.error('⚠️  *** Refer to ' + mdPath + ' for instructions on how to fix *** ⚠️');\n            console.error('');\n            console.error('To fix:');\n            console.error('  1. Review the changes above');\n            console.error('  2. If intentional, ASK USER to run: nx run architecture:generate since this is a critical change');\n            console.error('  3. Commit the updated architecture/dependencies.json');\n            return { success: false };\n        }\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error('❌ Architecture validation failed:', error.message);\n        return { success: false };\n    }\n}\n"]}

package/src/executors/validate-catch-error-pattern/executor.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+export default function runExecutor(options: Record<string, unknown>, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-catch-error-pattern/executor.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const code_rules_1 = require("@webpieces/code-rules");
+async function runExecutor(
+// webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+options, context) {
+    return (0, code_rules_1.validateCatchErrorPattern)(options, context.root);
+}
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-catch-error-pattern/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-catch-error-pattern/executor.ts"],"names":[],"mappings":";;AAIA,8BAMC;AARD,sDAAkE;AAEnD,KAAK,UAAU,WAAW;AACrC,0FAA0F;AAC1F,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAA,sCAAyB,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { validateCatchErrorPattern } from '@webpieces/code-rules';\n\nexport default async function runExecutor(\n    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators\n    options: Record<string, unknown>,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return validateCatchErrorPattern(options, context.root);\n}\n"]}

package/src/executors/validate-code/executor.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+export default function runExecutor(options: Record<string, unknown>, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-code/executor.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const code_rules_1 = require("@webpieces/code-rules");
+async function runExecutor(
+// webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+options, context) {
+    return (0, code_rules_1.validateCode)(options, context.root);
+}
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-code/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-code/executor.ts"],"names":[],"mappings":";;AAIA,8BAMC;AARD,sDAAqD;AAEtC,KAAK,UAAU,WAAW;AACrC,0FAA0F;AAC1F,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAA,yBAAY,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { validateCode } from '@webpieces/code-rules';\n\nexport default async function runExecutor(\n    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators\n    options: Record<string, unknown>,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return validateCode(options, context.root);\n}\n"]}

package/src/executors/validate-dtos/executor.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+export default function runExecutor(options: Record<string, unknown>, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-dtos/executor.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const code_rules_1 = require("@webpieces/code-rules");
+async function runExecutor(
+// webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+options, context) {
+    return (0, code_rules_1.validateDtos)(options, context.root);
+}
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-dtos/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-dtos/executor.ts"],"names":[],"mappings":";;AAIA,8BAMC;AARD,sDAAqD;AAEtC,KAAK,UAAU,WAAW;AACrC,0FAA0F;AAC1F,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAA,yBAAY,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { validateDtos } from '@webpieces/code-rules';\n\nexport default async function runExecutor(\n    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators\n    options: Record<string, unknown>,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return validateDtos(options, context.root);\n}\n"]}

package/src/executors/validate-eslint-sync/executor.d.ts

@@ -0,0 +1,7 @@
+import type { ExecutorContext } from '@nx/devkit';
+export interface ValidateEslintSyncOptions {
+}
+export interface ExecutorResult {
+    success: boolean;
+}
+export default function validateEslintSyncExecutor(options: ValidateEslintSyncOptions, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-eslint-sync/{executor.ts → executor.js}

@@ -1,60 +1,43 @@
-import type { ExecutorContext } from '@nx/devkit';
-import { readFileSync } from 'fs';
-import { join } from 'path';
-import { createHash } from 'crypto';
-
-export interface ValidateEslintSyncOptions {}
-
-export interface ExecutorResult {
-    success: boolean;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = validateEslintSyncExecutor;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const crypto_1 = require("crypto");
+function calculateHash(content) {
+    return (0, crypto_1.createHash)('sha256').update(content).digest('hex');
 }
-
-function calculateHash(content: string): string {
-    return createHash('sha256').update(content).digest('hex');
-}
-
-function normalizeContent(content: string): string {
+function normalizeContent(content) {
     // Normalize line endings and trim whitespace
     return content.replace(/\r\n/g, '\n').trim();
 }
-
-export default async function validateEslintSyncExecutor(
-    options: ValidateEslintSyncOptions,
-    context: ExecutorContext
-): Promise<ExecutorResult> {
+async function validateEslintSyncExecutor(options, context) {
     const workspaceRoot = context.root;
-
-    const templatePath = join(workspaceRoot, 'packages/tooling/nx-webpieces-rules/templates/eslint.webpieces.config.mjs');
-    const workspacePath = join(workspaceRoot, 'eslint.webpieces.config.mjs');
-
+    const templatePath = (0, path_1.join)(workspaceRoot, 'packages/tooling/nx-webpieces-rules/templates/eslint.webpieces.config.mjs');
+    const workspacePath = (0, path_1.join)(workspaceRoot, 'eslint.webpieces.config.mjs');
     // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
     try {
-        const templateContent = readFileSync(templatePath, 'utf-8');
-        const workspaceContent = readFileSync(workspacePath, 'utf-8');
-
+        const templateContent = (0, fs_1.readFileSync)(templatePath, 'utf-8');
+        const workspaceContent = (0, fs_1.readFileSync)(workspacePath, 'utf-8');
         const templateRules = extractRulesSection(templateContent);
         const workspaceRules = extractRulesSection(workspaceContent);
-
         const templateHash = calculateHash(normalizeContent(templateRules));
         const workspaceHash = calculateHash(normalizeContent(workspaceRules));
-
         if (templateHash !== workspaceHash) {
             printValidationError(templatePath, workspacePath);
             return { success: false };
         }
-
         console.log('✅ ESLint configuration sync validated - rules match!');
         return { success: true };
-
-    } catch (err: unknown) {
+    }
+    catch (err) {
         // Error occurred during validation - log and fail
         // eslint-disable-next-line @webpieces/catch-error-pattern
         console.error('❌ Error validating ESLint sync:', err);
         return { success: false };
     }
 }
-
-function printValidationError(templatePath: string, workspacePath: string): void {
+function printValidationError(templatePath, workspacePath) {
     console.error('');
     console.error('❌ ESLint configuration sync validation FAILED');
     console.error('');
@@ -74,14 +57,13 @@ function printValidationError(templatePath: string, workspacePath: string): void
     console.error('Customization for webpieces workspace goes in: eslint.config.mjs');
     console.error('');
 }
-
-function extractRulesSection(content: string): string {
+function extractRulesSection(content) {
     // Extract everything between "export default [" and the final "];"
     // This includes the rules configuration
     const match = content.match(/export default \[([\s\S]*)\];/);
     if (!match) {
         throw new Error('Could not extract rules section - export default not found');
     }
-
     return match[1].trim();
 }
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-eslint-sync/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-eslint-sync/executor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { readFileSync } from 'fs';\nimport { join } from 'path';\nimport { createHash } from 'crypto';\n\nexport interface ValidateEslintSyncOptions {}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nfunction calculateHash(content: string): string {\n    return createHash('sha256').update(content).digest('hex');\n}\n\nfunction normalizeContent(content: string): string {\n    // Normalize line endings and trim whitespace\n    return content.replace(/\\r\\n/g, '\\n').trim();\n}\n\nexport default async function validateEslintSyncExecutor(\n    options: ValidateEslintSyncOptions,\n    context: ExecutorContext\n): Promise<ExecutorResult> {\n    const workspaceRoot = context.root;\n\n    const templatePath = join(workspaceRoot, 'packages/tooling/nx-webpieces-rules/templates/eslint.webpieces.config.mjs');\n    const workspacePath = join(workspaceRoot, 'eslint.webpieces.config.mjs');\n\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        const templateContent = readFileSync(templatePath, 'utf-8');\n        const workspaceContent = readFileSync(workspacePath, 'utf-8');\n\n        const templateRules = extractRulesSection(templateContent);\n        const workspaceRules = extractRulesSection(workspaceContent);\n\n        const templateHash = calculateHash(normalizeContent(templateRules));\n        const workspaceHash = calculateHash(normalizeContent(workspaceRules));\n\n        if (templateHash !== workspaceHash) {\n            printValidationError(templatePath, workspacePath);\n            return { success: false };\n        }\n\n        console.log('✅ ESLint configuration sync validated - rules match!');\n        return { success: true };\n\n    } catch (err: unknown) {\n        // Error occurred during validation - log and fail\n        // eslint-disable-next-line @webpieces/catch-error-pattern\n        console.error('❌ Error validating ESLint sync:', err);\n        return { success: false };\n    }\n}\n\nfunction printValidationError(templatePath: string, workspacePath: string): void {\n    console.error('');\n    console.error('❌ ESLint configuration sync validation FAILED');\n    console.error('');\n    console.error('The @webpieces ESLint rules must be identical in both files:');\n    console.error(`  1. ${templatePath}`);\n    console.error(`  2. ${workspacePath}`);\n    console.error('');\n    console.error('These files must have identical rules sections so that:');\n    console.error('  - External clients get the same rules we use internally');\n    console.error('  - We \"eat our own dog food\" - same rules for everyone');\n    console.error('');\n    console.error('To fix:');\n    console.error('  1. Modify the rules in ONE file (recommend: templates/eslint.webpieces.config.mjs)');\n    console.error('  2. Copy the rules section to the other file');\n    console.error('  3. Keep import statements different (template uses npm, workspace uses loadWorkspaceRules)');\n    console.error('');\n    console.error('Customization for webpieces workspace goes in: eslint.config.mjs');\n    console.error('');\n}\n\nfunction extractRulesSection(content: string): string {\n    // Extract everything between \"export default [\" and the final \"];\"\n    // This includes the rules configuration\n    const match = content.match(/export default \\[([\\s\\S]*)\\];/);\n    if (!match) {\n        throw new Error('Could not extract rules section - export default not found');\n    }\n\n    return match[1].trim();\n}\n"]}

package/src/executors/validate-modified-files/executor.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+export default function runExecutor(options: Record<string, unknown>, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-modified-files/executor.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const code_rules_1 = require("@webpieces/code-rules");
+async function runExecutor(
+// webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+options, context) {
+    return (0, code_rules_1.validateModifiedFiles)(options, context.root);
+}
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-modified-files/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-modified-files/executor.ts"],"names":[],"mappings":";;AAIA,8BAMC;AARD,sDAA8D;AAE/C,KAAK,UAAU,WAAW;AACrC,0FAA0F;AAC1F,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAA,kCAAqB,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { validateModifiedFiles } from '@webpieces/code-rules';\n\nexport default async function runExecutor(\n    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators\n    options: Record<string, unknown>,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return validateModifiedFiles(options, context.root);\n}\n"]}

package/src/executors/validate-modified-methods/executor.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+export default function runExecutor(options: Record<string, unknown>, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-modified-methods/executor.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const code_rules_1 = require("@webpieces/code-rules");
+async function runExecutor(
+// webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+options, context) {
+    return (0, code_rules_1.validateModifiedMethods)(options, context.root);
+}
+//# sourceMappingURL=executor.js.map