@webpieces/dev-config 0.2.17 → 0.2.23

package/README.md

@@ -6,6 +6,7 @@ Development configuration, scripts, and patterns for WebPieces projects.
 
 This package provides shareable development tools for projects using the WebPieces framework:
 
+- **Nx Plugin** for automatic architecture validation and circular dependency checking
 - **Executable scripts** for common development tasks
 - **ESLint configuration** with WebPieces patterns and best practices
 - **Jest preset** for testing TypeScript projects
@@ -14,6 +15,14 @@ This package provides shareable development tools for projects using the WebPiec
 
 ## Installation
 
+For Nx workspaces (recommended):
+
+```bash
+nx add @webpieces/dev-config
+```
+
+For non-Nx projects:
+
 ```bash
 npm install --save-dev @webpieces/dev-config
 ```
@@ -73,7 +82,41 @@ To develop against a local copy of webpieces-ts:
    wp-use-published
    ```
 
-### 2. ESLint Configuration
+### 2. Nx Plugin (Architecture Validation)
+
+Automatically adds architecture validation and circular dependency checking to Nx workspaces.
+
+#### Quick Start
+
+```bash
+# Install and register the plugin
+nx add @webpieces/dev-config
+
+# Generate dependency graph
+nx run .:arch:generate
+
+# Validate architecture
+nx run .:arch:validate-no-cycles
+
+# Check project for circular dependencies
+nx run my-project:check-circular-deps
+```
+
+#### Available Targets
+
+**Workspace-level:**
+- `arch:generate` - Generate dependency graph
+- `arch:visualize` - Visualize dependency graph
+- `arch:validate-no-cycles` - Validate no circular dependencies
+- `arch:validate-no-skiplevel-deps` - Validate no redundant dependencies
+- `arch:validate-architecture-unchanged` - Validate against blessed graph
+
+**Per-project:**
+- `check-circular-deps` - Check for circular dependencies (auto-added to all projects)
+
+For detailed documentation, see [Plugin README](./plugin/README.md).
+
+### 3. ESLint Configuration
 
 Import the base configuration in your `eslint.config.mjs`:
 

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

@@ -0,0 +1,17 @@
+/**
+ * Generate Executor
+ *
+ * Generates the architecture dependency graph and saves it to architecture/dependencies.json.
+ * Also validates that package.json dependencies match project.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/architecture/executors/generate/executor.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Generate Executor
+ *
+ * Generates the architecture dependency graph and saves it to architecture/dependencies.json.
+ * Also validates that package.json dependencies match project.json.
+ *
+ * Usage:
+ * nx run architecture:generate
+ */
+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 package_validator_1 = require("../../lib/package-validator");
+const graph_loader_1 = require("../../lib/graph-loader");
+async function runExecutor(options, context) {
+    const { graphPath } = options;
+    const workspaceRoot = context.root;
+    console.log('\n📊 Architecture Graph Generator\n');
+    try {
+        // Step 1: Generate current graph from project.json files
+        console.log('📊 Generating dependency graph from project.json files...');
+        const rawGraph = await (0, graph_generator_1.generateGraph)();
+        // Step 2: Topological sort (validates acyclic and assigns levels)
+        console.log('🔄 Computing topological layers...');
+        let enhancedGraph;
+        try {
+            enhancedGraph = (0, graph_sorter_1.sortGraphTopologically)(rawGraph);
+            console.log('✅ Graph is acyclic');
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            console.error('❌ Circular dependency detected!');
+            console.error(error.message);
+            return { success: false };
+        }
+        // Step 3: Validate package.json dependencies match
+        console.log('📦 Validating package.json dependencies match project.json...');
+        const packageValidation = await (0, package_validator_1.validatePackageJsonDependencies)(enhancedGraph, workspaceRoot);
+        if (!packageValidation.valid) {
+            console.error('❌ Package.json validation failed!');
+            for (const error of packageValidation.errors) {
+                console.error(`  ${error}`);
+            }
+            return { success: false };
+        }
+        console.log('✅ Package.json dependencies match');
+        // Step 4: Save the graph
+        console.log('💾 Saving graph to architecture/dependencies.json...');
+        (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) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        console.error('❌ Graph generation failed:', error.message);
+        return { success: false };
+    }
+}
+//# sourceMappingURL=executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/architecture/executors/generate/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Generate Executor\n *\n * Generates the architecture dependency graph and saves it to architecture/dependencies.json.\n * Also validates that package.json dependencies match project.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 { validatePackageJsonDependencies } from '../../lib/package-validator';\nimport { saveGraph } from '../../lib/graph-loader';\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;\n    const workspaceRoot = context.root;\n\n    console.log('\\n📊 Architecture Graph Generator\\n');\n\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 (validates acyclic and assigns levels)\n        console.log('🔄 Computing topological layers...');\n        let enhancedGraph;\n        try {\n            enhancedGraph = sortGraphTopologically(rawGraph);\n            console.log('✅ Graph is acyclic');\n        } catch (err: unknown) {\n            const error = err instanceof Error ? err : new Error(String(err));\n            console.error('❌ Circular dependency detected!');\n            console.error(error.message);\n            return { success: false };\n        }\n\n        // Step 3: Validate package.json dependencies match\n        console.log('📦 Validating package.json dependencies match project.json...');\n        const packageValidation = await validatePackageJsonDependencies(enhancedGraph, workspaceRoot);\n\n        if (!packageValidation.valid) {\n            console.error('❌ Package.json validation failed!');\n            for (const error of packageValidation.errors) {\n                console.error(`  ${error}`);\n            }\n            return { success: false };\n        }\n        console.log('✅ Package.json dependencies match');\n\n        // Step 4: 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 = err instanceof Error ? err : new Error(String(err));\n        console.error('❌ Graph generation failed:', error.message);\n        return { success: false };\n    }\n}\n"]}

package/architecture/executors/generate/executor.ts

@@ -0,0 +1,83 @@
+/**
+ * Generate Executor
+ *
+ * Generates the architecture dependency graph and saves it to architecture/dependencies.json.
+ * Also validates that package.json dependencies match project.json.
+ *
+ * Usage:
+ * nx run architecture:generate
+ */
+
+import type { ExecutorContext } from '@nx/devkit';
+import { generateGraph } from '../../lib/graph-generator';
+import { sortGraphTopologically } from '../../lib/graph-sorter';
+import { validatePackageJsonDependencies } from '../../lib/package-validator';
+import { saveGraph } from '../../lib/graph-loader';
+
+export interface GenerateExecutorOptions {
+    graphPath?: string;
+}
+
+export interface ExecutorResult {
+    success: boolean;
+}
+
+export default async function runExecutor(
+    options: GenerateExecutorOptions,
+    context: ExecutorContext
+): Promise<ExecutorResult> {
+    const { graphPath } = options;
+    const workspaceRoot = context.root;
+
+    console.log('\n📊 Architecture Graph Generator\n');
+
+    try {
+        // Step 1: Generate current graph from project.json files
+        console.log('📊 Generating dependency graph from project.json files...');
+        const rawGraph = await generateGraph();
+
+        // Step 2: Topological sort (validates acyclic and assigns levels)
+        console.log('🔄 Computing topological layers...');
+        let enhancedGraph;
+        try {
+            enhancedGraph = sortGraphTopologically(rawGraph);
+            console.log('✅ Graph is acyclic');
+        } catch (err: unknown) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            console.error('❌ Circular dependency detected!');
+            console.error(error.message);
+            return { success: false };
+        }
+
+        // Step 3: Validate package.json dependencies match
+        console.log('📦 Validating package.json dependencies match project.json...');
+        const packageValidation = await validatePackageJsonDependencies(enhancedGraph, workspaceRoot);
+
+        if (!packageValidation.valid) {
+            console.error('❌ Package.json validation failed!');
+            for (const error of packageValidation.errors) {
+                console.error(`  ${error}`);
+            }
+            return { success: false };
+        }
+        console.log('✅ Package.json dependencies match');
+
+        // Step 4: Save the graph
+        console.log('💾 Saving graph to architecture/dependencies.json...');
+        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 = err instanceof Error ? err : new Error(String(err));
+        console.error('❌ Graph generation failed:', error.message);
+        return { success: false };
+    }
+}

package/architecture/executors/generate/schema.json

@@ -0,0 +1,14 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Generate Executor",
+    "description": "Generates the architecture dependency graph and saves it",
+    "type": "object",
+    "properties": {
+        "graphPath": {
+            "type": "string",
+            "description": "Path to the graph file (relative to workspace root)",
+            "default": "architecture/dependencies.json"
+        }
+    },
+    "required": []
+}

package/architecture/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/architecture/executors/validate-architecture-unchanged/executor.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * 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
+ */
+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_comparator_1 = require("../../lib/graph-comparator");
+const graph_loader_1 = require("../../lib/graph-loader");
+async function runExecutor(options, context) {
+    const { graphPath } = options;
+    const workspaceRoot = context.root;
+    console.log('\n🔍 Validating Architecture Unchanged\n');
+    try {
+        // Check if saved graph exists
+        if (!(0, graph_loader_1.graphFileExists)(workspaceRoot, graphPath)) {
+            console.error('❌ No saved graph found at architecture/dependencies.json');
+            console.error('   Run: nx run architecture:generate first');
+            return { success: false };
+        }
+        // Step 1: Generate current graph from project.json files
+        console.log('📊 Generating current dependency graph...');
+        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 = (0, graph_sorter_1.sortGraphTopologically)(rawGraph);
+        // Step 3: Load saved graph
+        console.log('📂 Loading saved graph...');
+        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 = (0, graph_comparator_1.compareGraphs)(currentGraph, savedGraph);
+        if (comparison.identical) {
+            console.log('✅ Architecture unchanged - current graph matches saved graph');
+            return { success: true };
+        }
+        else {
+            console.error('❌ Architecture has changed since last update!');
+            console.error('\nDifferences:');
+            console.error(comparison.summary);
+            console.error('\nTo fix:');
+            console.error('  1. Review the changes above');
+            console.error('  2. If intentional, run: nx run architecture:generate');
+            console.error('  3. Commit the updated architecture/dependencies.json');
+            return { success: false };
+        }
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        console.error('❌ Architecture validation failed:', error.message);
+        return { success: false };
+    }
+}
+//# sourceMappingURL=executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/architecture/executors/validate-architecture-unchanged/executor.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAgBH,8BAwDC;AArED,+DAA0D;AAC1D,yDAAgE;AAChE,iEAA2D;AAC3D,yDAA2E;AAU5D,KAAK,UAAU,WAAW,CACrC,OAA6C,EAC7C,OAAwB;IAExB,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC9B,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAExD,IAAI,CAAC;QACD,8BAA8B;QAC9B,IAAI,CAAC,IAAA,8BAAe,EAAC,aAAa,EAAE,SAAS,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;YAC1E,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,yDAAyD;QACzD,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAa,GAAE,CAAC;QAEvC,+DAA+D;QAC/D,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,MAAM,YAAY,GAAG,IAAA,qCAAsB,EAAC,QAAQ,CAAC,CAAC;QAEtD,2BAA2B;QAC3B,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,IAAA,+BAAgB,EAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAE9D,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAA,gCAAa,EAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAE3D,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;YAC5E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAC/D,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACxE,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACxE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAClE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;AACL,CAAC","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 { generateGraph } from '../../lib/graph-generator';\nimport { sortGraphTopologically } from '../../lib/graph-sorter';\nimport { compareGraphs } from '../../lib/graph-comparator';\nimport { loadBlessedGraph, graphFileExists } from '../../lib/graph-loader';\n\nexport interface ValidateArchitectureUnchangedOptions {\n    graphPath?: string;\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nexport default async function runExecutor(\n    options: ValidateArchitectureUnchangedOptions,\n    context: ExecutorContext\n): Promise<ExecutorResult> {\n    const { graphPath } = options;\n    const workspaceRoot = context.root;\n\n    console.log('\\n🔍 Validating Architecture Unchanged\\n');\n\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('   Run: nx run architecture:generate first');\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            console.error('❌ Architecture has changed since last update!');\n            console.error('\\nDifferences:');\n            console.error(comparison.summary);\n            console.error('\\nTo fix:');\n            console.error('  1. Review the changes above');\n            console.error('  2. If intentional, run: nx run architecture:generate');\n            console.error('  3. Commit the updated architecture/dependencies.json');\n            return { success: false };\n        }\n    } catch (err: unknown) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        console.error('❌ Architecture validation failed:', error.message);\n        return { success: false };\n    }\n}\n"]}

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

@@ -0,0 +1,81 @@
+/**
+ * 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';
+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';
+
+export interface ValidateArchitectureUnchangedOptions {
+    graphPath?: string;
+}
+
+export interface ExecutorResult {
+    success: boolean;
+}
+
+export default async function runExecutor(
+    options: ValidateArchitectureUnchangedOptions,
+    context: ExecutorContext
+): Promise<ExecutorResult> {
+    const { graphPath } = options;
+    const workspaceRoot = context.root;
+
+    console.log('\n🔍 Validating Architecture Unchanged\n');
+
+    try {
+        // Check if saved graph exists
+        if (!graphFileExists(workspaceRoot, graphPath)) {
+            console.error('❌ No saved graph found at architecture/dependencies.json');
+            console.error('   Run: nx run architecture:generate first');
+            return { success: false };
+        }
+
+        // Step 1: Generate current graph from project.json files
+        console.log('📊 Generating current dependency graph...');
+        const rawGraph = await generateGraph();
+
+        // Step 2: Topological sort (to get enhanced graph with levels)
+        console.log('🔄 Computing topological layers...');
+        const currentGraph = sortGraphTopologically(rawGraph);
+
+        // Step 3: Load saved graph
+        console.log('📂 Loading saved graph...');
+        const savedGraph = 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);
+
+        if (comparison.identical) {
+            console.log('✅ Architecture unchanged - current graph matches saved graph');
+            return { success: true };
+        } else {
+            console.error('❌ Architecture has changed since last update!');
+            console.error('\nDifferences:');
+            console.error(comparison.summary);
+            console.error('\nTo fix:');
+            console.error('  1. Review the changes above');
+            console.error('  2. If intentional, run: nx run architecture:generate');
+            console.error('  3. Commit the updated architecture/dependencies.json');
+            return { success: false };
+        }
+    } catch (err: unknown) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        console.error('❌ Architecture validation failed:', error.message);
+        return { success: false };
+    }
+}

package/architecture/executors/validate-architecture-unchanged/schema.json

@@ -0,0 +1,14 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate Architecture Unchanged Executor",
+    "description": "Validates that the current architecture matches the saved graph",
+    "type": "object",
+    "properties": {
+        "graphPath": {
+            "type": "string",
+            "description": "Path to the graph file (relative to workspace root)",
+            "default": "architecture/dependencies.json"
+        }
+    },
+    "required": []
+}

package/architecture/executors/validate-no-cycles/executor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Validate No Cycles Executor
+ *
+ * Validates that the architecture dependency graph has no circular dependencies.
+ * This is a fast check that only validates acyclicity.
+ *
+ * Usage:
+ * nx run architecture:validate-no-cycles
+ */
+import type { ExecutorContext } from '@nx/devkit';
+export interface ValidateNoCyclesOptions {
+}
+export interface ExecutorResult {
+    success: boolean;
+}
+export default function runExecutor(_options: ValidateNoCyclesOptions, _context: ExecutorContext): Promise<ExecutorResult>;

package/architecture/executors/validate-no-cycles/executor.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Validate No Cycles Executor
+ *
+ * Validates that the architecture dependency graph has no circular dependencies.
+ * This is a fast check that only validates acyclicity.
+ *
+ * Usage:
+ * nx run architecture:validate-no-cycles
+ */
+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");
+async function runExecutor(_options, _context) {
+    console.log('\n🔄 Validating No Circular Dependencies\n');
+    try {
+        // Step 1: Generate current graph from project.json files
+        console.log('📊 Generating dependency graph from project.json files...');
+        const rawGraph = await (0, graph_generator_1.generateGraph)();
+        // Step 2: Topological sort (validates acyclic)
+        console.log('🔄 Checking for cycles (topological sort)...');
+        try {
+            (0, graph_sorter_1.sortGraphTopologically)(rawGraph);
+            console.log('✅ No circular dependencies detected!');
+            // Print summary
+            const projectCount = Object.keys(rawGraph).length;
+            console.log(`\n📈 Summary: ${projectCount} projects, all acyclic`);
+            return { success: true };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            console.error('❌ Circular dependency detected!');
+            console.error(error.message);
+            console.error('\nTo fix:');
+            console.error('  1. Review the cycle above');
+            console.error('  2. Break the cycle by refactoring dependencies');
+            console.error('  3. Run this check again');
+            return { success: false };
+        }
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        console.error('❌ Cycle validation failed:', error.message);
+        return { success: false };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/architecture/executors/validate-no-cycles/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/architecture/executors/validate-no-cycles/executor.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAcH,8BAqCC;AAhDD,+DAA0D;AAC1D,yDAAgE;AAUjD,KAAK,UAAU,WAAW,CACrC,QAAiC,EACjC,QAAyB;IAEzB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAE1D,IAAI,CAAC;QACD,yDAAyD;QACzD,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAa,GAAE,CAAC;QAEvC,+CAA+C;QAC/C,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,IAAI,CAAC;YACD,IAAA,qCAAsB,EAAC,QAAQ,CAAC,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YAEpD,gBAAgB;YAChB,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,iBAAiB,YAAY,wBAAwB,CAAC,CAAC;YAEnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACjD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,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 * Validate No Cycles Executor\n *\n * Validates that the architecture dependency graph has no circular dependencies.\n * This is a fast check that only validates acyclicity.\n *\n * Usage:\n * nx run architecture:validate-no-cycles\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { generateGraph } from '../../lib/graph-generator';\nimport { sortGraphTopologically } from '../../lib/graph-sorter';\n\nexport interface ValidateNoCyclesOptions {\n    // No options needed\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nexport default async function runExecutor(\n    _options: ValidateNoCyclesOptions,\n    _context: ExecutorContext\n): Promise<ExecutorResult> {\n    console.log('\\n🔄 Validating No Circular Dependencies\\n');\n\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 (validates acyclic)\n        console.log('🔄 Checking for cycles (topological sort)...');\n        try {\n            sortGraphTopologically(rawGraph);\n            console.log('✅ No circular dependencies detected!');\n\n            // Print summary\n            const projectCount = Object.keys(rawGraph).length;\n            console.log(`\\n📈 Summary: ${projectCount} projects, all acyclic`);\n\n            return { success: true };\n        } catch (err: unknown) {\n            const error = err instanceof Error ? err : new Error(String(err));\n            console.error('❌ Circular dependency detected!');\n            console.error(error.message);\n            console.error('\\nTo fix:');\n            console.error('  1. Review the cycle above');\n            console.error('  2. Break the cycle by refactoring dependencies');\n            console.error('  3. Run this check again');\n            return { success: false };\n        }\n    } catch (err: unknown) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        console.error('❌ Cycle validation failed:', error.message);\n        return { success: false };\n    }\n}\n"]}

package/architecture/executors/validate-no-cycles/executor.ts

@@ -0,0 +1,60 @@
+/**
+ * Validate No Cycles Executor
+ *
+ * Validates that the architecture dependency graph has no circular dependencies.
+ * This is a fast check that only validates acyclicity.
+ *
+ * Usage:
+ * nx run architecture:validate-no-cycles
+ */
+
+import type { ExecutorContext } from '@nx/devkit';
+import { generateGraph } from '../../lib/graph-generator';
+import { sortGraphTopologically } from '../../lib/graph-sorter';
+
+export interface ValidateNoCyclesOptions {
+    // No options needed
+}
+
+export interface ExecutorResult {
+    success: boolean;
+}
+
+export default async function runExecutor(
+    _options: ValidateNoCyclesOptions,
+    _context: ExecutorContext
+): Promise<ExecutorResult> {
+    console.log('\n🔄 Validating No Circular Dependencies\n');
+
+    try {
+        // Step 1: Generate current graph from project.json files
+        console.log('📊 Generating dependency graph from project.json files...');
+        const rawGraph = await generateGraph();
+
+        // Step 2: Topological sort (validates acyclic)
+        console.log('🔄 Checking for cycles (topological sort)...');
+        try {
+            sortGraphTopologically(rawGraph);
+            console.log('✅ No circular dependencies detected!');
+
+            // Print summary
+            const projectCount = Object.keys(rawGraph).length;
+            console.log(`\n📈 Summary: ${projectCount} projects, all acyclic`);
+
+            return { success: true };
+        } catch (err: unknown) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            console.error('❌ Circular dependency detected!');
+            console.error(error.message);
+            console.error('\nTo fix:');
+            console.error('  1. Review the cycle above');
+            console.error('  2. Break the cycle by refactoring dependencies');
+            console.error('  3. Run this check again');
+            return { success: false };
+        }
+    } catch (err: unknown) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        console.error('❌ Cycle validation failed:', error.message);
+        return { success: false };
+    }
+}

package/architecture/executors/validate-no-cycles/schema.json

@@ -0,0 +1,8 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate No Cycles Executor",
+    "description": "Validates that the architecture graph has no circular dependencies",
+    "type": "object",
+    "properties": {},
+    "required": []
+}

package/architecture/executors/validate-no-skiplevel-deps/executor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Validate No Skip-Level Dependencies Executor
+ *
+ * Validates that no project has redundant transitive dependencies.
+ * If project A depends on B, and B transitively brings in C, then A should NOT
+ * also directly depend on C (it's redundant and clutters the dependency graph).
+ *
+ * This keeps the architecture graph clean for visualization and human understanding.
+ *
+ * Usage:
+ * nx run architecture:validate-no-skiplevel-deps
+ */
+import type { ExecutorContext } from '@nx/devkit';
+export interface ValidateNoSkipLevelDepsOptions {
+}
+export interface ExecutorResult {
+    success: boolean;
+}
+export default function runExecutor(_options: ValidateNoSkipLevelDepsOptions, context: ExecutorContext): Promise<ExecutorResult>;