@webpieces/nx-webpieces-rules 0.0.1 → 0.2.114

package/src/executors/validate-versions-locked/{executor.ts → executor.js}

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Validate Versions Locked Executor
  *
@@ -13,72 +14,52 @@
  * Usage:
  * nx run architecture:validate-versions-locked
  */
-
-import type { ExecutorContext } from '@nx/devkit';
-import * as fs from 'fs';
-import * as path from 'path';
-import { toError } from '../../toError';
-
-export interface ValidateVersionsLockedOptions {
-    // No options needed
-}
-
-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 toError_1 = require("../../toError");
 // webpieces-disable max-lines-new-methods -- Existing method from renamed validate-versions file
 // Find all package.json files except node_modules, dist, .nx, .angular
-function findPackageJsonFiles(dir: string, basePath = ''): string[] {
-    const files: string[] = [];
+function findPackageJsonFiles(dir, basePath = '') {
+    const files = [];
     const items = fs.readdirSync(dir);
-
     for (const item of items) {
         const fullPath = path.join(dir, item);
         const relativePath = path.join(basePath, item);
-
         // Skip these directories
-        if (
-            ['node_modules', 'dist', '.nx', '.angular', 'tmp', '.git'].includes(
-                item,
-            )
-        ) {
+        if (['node_modules', 'dist', '.nx', '.angular', 'tmp', '.git'].includes(item)) {
             continue;
         }
-
         // Skip platform-specific node_modules backups (node_modules_mac, node_modules_linux, etc.)
         if (item.startsWith('node_modules_')) {
             continue;
         }
-
         // Skip all hidden directories (starting with .)
         if (item.startsWith('.')) {
             continue;
         }
-
         const stat = fs.statSync(fullPath);
         if (stat.isDirectory()) {
             files.push(...findPackageJsonFiles(fullPath, relativePath));
-        } else if (item === 'package.json') {
+        }
+        else if (item === 'package.json') {
             files.push(fullPath);
         }
     }
-
     return files;
 }
-
 // Check if a version string uses semver ranges
-function hasSemverRange(version: string): boolean {
+function hasSemverRange(version) {
     // Allow workspace protocol
     if (version.startsWith('workspace:')) {
         return false;
     }
-
     // Allow file: protocol (for local packages)
     if (version.startsWith('file:')) {
         return false;
     }
-
     // Check for common semver range patterns
     const semverPatterns = [
         /^\^/, // ^1.2.3
@@ -95,19 +76,16 @@ function hasSemverRange(version: string): boolean {
         /^latest$/, // latest
         /^next$/, // next
     ];
-
     return semverPatterns.some((pattern) => pattern.test(version));
 }
-
 // webpieces-disable max-lines-new-methods -- Existing method from renamed validate-versions file
 // Validate a single package.json file for semver ranges
-function validatePackageJson(filePath: string): string[] {
+function validatePackageJson(filePath) {
     // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
     try {
         const content = fs.readFileSync(filePath, 'utf-8');
         const pkg = JSON.parse(content);
-        const errors: string[] = [];
-
+        const errors = [];
         // Check dependencies
         if (pkg.dependencies) {
             for (const [name, version] of Object.entries(pkg.dependencies)) {
@@ -115,15 +93,11 @@ function validatePackageJson(filePath: string): string[] {
                 if (name.startsWith('@webpieces/')) {
                     continue;
                 }
-
-                if (hasSemverRange(version as string)) {
-                    errors.push(
-                        `dependencies.${name}: "${version}" uses semver range (must be locked to exact version)`,
-                    );
+                if (hasSemverRange(version)) {
+                    errors.push(`dependencies.${name}: "${version}" uses semver range (must be locked to exact version)`);
                 }
             }
         }
-
         // Check devDependencies
         if (pkg.devDependencies) {
             for (const [name, version] of Object.entries(pkg.devDependencies)) {
@@ -131,134 +105,108 @@ function validatePackageJson(filePath: string): string[] {
                 if (name.startsWith('@webpieces/')) {
                     continue;
                 }
-
-                if (hasSemverRange(version as string)) {
-                    errors.push(
-                        `devDependencies.${name}: "${version}" uses semver range (must be locked to exact version)`,
-                    );
+                if (hasSemverRange(version)) {
+                    errors.push(`devDependencies.${name}: "${version}" uses semver range (must be locked to exact version)`);
                 }
             }
         }
-
         // Check peerDependencies (these can have ranges for compatibility)
         // We don't validate peerDependencies for semver ranges since they're meant to be flexible
-
         return errors;
-    } catch (err: unknown) {
-        const error = toError(err);
+    }
+    catch (err) {
+        const error = (0, toError_1.toError)(err);
         return [`Failed to parse ${filePath}: ${error.message}`];
     }
 }
-
-// Track all dependency versions across the monorepo
-interface DependencyUsage {
-    version: string;
-    file: string;
-    type: 'dependencies' | 'devDependencies';
-}
-
 // webpieces-disable max-lines-new-methods -- Collecting dependencies from all package.json files
 // Collect all dependency versions from all package.json files
-function collectAllDependencies(workspaceRoot: string): Map<string, DependencyUsage[]> {
-    const dependencyMap = new Map<string, DependencyUsage[]>();
+function collectAllDependencies(workspaceRoot) {
+    const dependencyMap = new Map();
     const packageFiles = findPackageJsonFiles(workspaceRoot);
-
     for (const filePath of packageFiles) {
         // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
         try {
             const content = fs.readFileSync(filePath, 'utf-8');
             const pkg = JSON.parse(content);
             const relativePath = path.relative(workspaceRoot, filePath);
-
             // Collect dependencies
             if (pkg.dependencies) {
                 for (const [name, version] of Object.entries(pkg.dependencies)) {
                     // Skip internal workspace packages
-                    if (name.startsWith('@webpieces/')) continue;
-
-                    const usage: DependencyUsage = {
-                        version: version as string,
+                    if (name.startsWith('@webpieces/'))
+                        continue;
+                    const usage = {
+                        version: version,
                         file: relativePath,
                         type: 'dependencies'
                     };
-
                     if (!dependencyMap.has(name)) {
                         dependencyMap.set(name, []);
                     }
-                    dependencyMap.get(name)!.push(usage);
+                    dependencyMap.get(name).push(usage);
                 }
             }
-
             // Collect devDependencies
             if (pkg.devDependencies) {
                 for (const [name, version] of Object.entries(pkg.devDependencies)) {
                     // Skip internal workspace packages
-                    if (name.startsWith('@webpieces/')) continue;
-
-                    const usage: DependencyUsage = {
-                        version: version as string,
+                    if (name.startsWith('@webpieces/'))
+                        continue;
+                    const usage = {
+                        version: version,
                         file: relativePath,
                         type: 'devDependencies'
                     };
-
                     if (!dependencyMap.has(name)) {
                         dependencyMap.set(name, []);
                     }
-                    dependencyMap.get(name)!.push(usage);
+                    dependencyMap.get(name).push(usage);
                 }
             }
-        } catch (err: unknown) {
+        }
+        catch (err) {
             // const error = toError(err);
             // Intentionally skip files that can't be parsed - this is expected for some package.json files
         }
     }
-
     return dependencyMap;
 }
-
 // webpieces-disable max-lines-new-methods -- Simple iteration logic, splitting would reduce clarity
 // Check for version conflicts across package.json files
-function checkVersionConflicts(workspaceRoot: string): string[] {
+function checkVersionConflicts(workspaceRoot) {
     console.log('\n🔍 Checking for version conflicts across package.json files:');
-
     const dependencyMap = collectAllDependencies(workspaceRoot);
-    const conflicts: string[] = [];
-
+    const conflicts = [];
     for (const [packageName, usages] of dependencyMap.entries()) {
         // Get unique versions (ignoring workspace: and file: protocols)
-        const versions = new Set(
-            usages
-                .map(u => u.version)
-                .filter(v => !v.startsWith('workspace:') && !v.startsWith('file:'))
-        );
-
+        const versions = new Set(usages
+            .map(u => u.version)
+            .filter(v => !v.startsWith('workspace:') && !v.startsWith('file:')));
         if (versions.size > 1) {
             const conflictDetails = usages
                 .filter(u => !u.version.startsWith('workspace:') && !u.version.startsWith('file:'))
                 .map(u => `      ${u.file} (${u.type}): ${u.version}`)
                 .join('\n');
-
             conflicts.push(`   ❌ ${packageName} has ${versions.size} different versions:\n${conflictDetails}`);
         }
     }
-
     if (conflicts.length === 0) {
         console.log('   ✅ No version conflicts found');
-    } else {
+    }
+    else {
         for (const conflict of conflicts) {
             console.log(conflict);
         }
     }
-
     return conflicts;
 }
-
 /**
  * Prints the educational message explaining why semver ranges are forbidden.
  * This helps developers understand the rationale behind locked versions.
  */
 // webpieces-disable max-lines-new-methods -- Educational message template, splitting reduces clarity
-function printSemverRangeEducationalMessage(semverErrors: number): void {
+function printSemverRangeEducationalMessage(semverErrors) {
     console.log(`
 ❌ SEMVER RANGES DETECTED - BUILD FAILED
 
@@ -308,61 +256,46 @@ This way, every library change is:
 
 `);
 }
-
-type SemverRangeResult = { errors: number };
-
 // Check semver ranges in all package.json files - FAILS if any found
-function checkSemverRanges(workspaceRoot: string): SemverRangeResult {
+function checkSemverRanges(workspaceRoot) {
     console.log('\n📋 Checking for unlocked versions (semver ranges):');
     const packageFiles = findPackageJsonFiles(workspaceRoot);
     let semverErrors = 0;
-
     for (const filePath of packageFiles) {
         const relativePath = path.relative(workspaceRoot, filePath);
         const errors = validatePackageJson(filePath);
-
         if (errors.length > 0) {
             console.log(`   ❌ ${relativePath}:`);
             for (const error of errors) {
                 console.log(`      ${error}`);
             }
             semverErrors += errors.length;
-        } else {
+        }
+        else {
             console.log(`   ✅ ${relativePath}`);
         }
     }
-
     return { errors: semverErrors };
 }
-
-export default async function runExecutor(
-    _options: ValidateVersionsLockedOptions,
-    context: ExecutorContext
-): Promise<ExecutorResult> {
+async function runExecutor(_options, context) {
     console.log('\n🔒 Validating Package Versions are LOCKED and CONSISTENT\n');
-
     const workspaceRoot = context.root;
-
     // Step 1: Check for semver ranges (FAILS if any found)
     const semverResult = checkSemverRanges(workspaceRoot);
     const semverErrors = semverResult.errors;
     const packageFiles = findPackageJsonFiles(workspaceRoot);
-
     // Step 2: Check for version conflicts across package.json files
     const versionConflicts = checkVersionConflicts(workspaceRoot);
-
     // Summary
     console.log(`\n📊 Summary:`);
     console.log(`   Files checked: ${packageFiles.length}`);
     console.log(`   Unlocked versions (semver ranges): ${semverErrors}`);
     console.log(`   Version conflicts: ${versionConflicts.length}`);
-
     // Fail on semver ranges with educational message
     if (semverErrors > 0) {
         printSemverRangeEducationalMessage(semverErrors);
         return { success: false };
     }
-
     // Fail on version conflicts
     if (versionConflicts.length > 0) {
         console.log('\n❌ VALIDATION FAILED!');
@@ -370,7 +303,7 @@ export default async function runExecutor(
         console.log('   This prevents "works on my machine" bugs where different projects use different library versions.\n');
         return { success: false };
     }
-
     console.log('\n✅ VALIDATION PASSED! All versions are locked and consistent.');
     return { success: true };
 }
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-versions-locked/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-versions-locked/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Validate Versions Locked Executor\n *\n * Validates that package.json versions are:\n * 1. LOCKED (exact versions, no semver ranges like ^, ~, *)\n * 2. CONSISTENT across all package.json files (no version conflicts)\n *\n * Why locked versions matter:\n * - Micro bugs ARE introduced via patch versions (1.4.5 → 1.4.6)\n * - git bisect fails when software changes OUTSIDE of git\n * - Library upgrades must be explicit via PR/commit, not implicit drift\n *\n * Usage:\n * nx run architecture:validate-versions-locked\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { toError } from '../../toError';\n\nexport interface ValidateVersionsLockedOptions {\n    // No options needed\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\n// webpieces-disable max-lines-new-methods -- Existing method from renamed validate-versions file\n// Find all package.json files except node_modules, dist, .nx, .angular\nfunction findPackageJsonFiles(dir: string, basePath = ''): string[] {\n    const files: string[] = [];\n    const items = fs.readdirSync(dir);\n\n    for (const item of items) {\n        const fullPath = path.join(dir, item);\n        const relativePath = path.join(basePath, item);\n\n        // Skip these directories\n        if (\n            ['node_modules', 'dist', '.nx', '.angular', 'tmp', '.git'].includes(\n                item,\n            )\n        ) {\n            continue;\n        }\n\n        // Skip platform-specific node_modules backups (node_modules_mac, node_modules_linux, etc.)\n        if (item.startsWith('node_modules_')) {\n            continue;\n        }\n\n        // Skip all hidden directories (starting with .)\n        if (item.startsWith('.')) {\n            continue;\n        }\n\n        const stat = fs.statSync(fullPath);\n        if (stat.isDirectory()) {\n            files.push(...findPackageJsonFiles(fullPath, relativePath));\n        } else if (item === 'package.json') {\n            files.push(fullPath);\n        }\n    }\n\n    return files;\n}\n\n// Check if a version string uses semver ranges\nfunction hasSemverRange(version: string): boolean {\n    // Allow workspace protocol\n    if (version.startsWith('workspace:')) {\n        return false;\n    }\n\n    // Allow file: protocol (for local packages)\n    if (version.startsWith('file:')) {\n        return false;\n    }\n\n    // Check for common semver range patterns\n    const semverPatterns = [\n        /^\\^/, // ^1.2.3\n        /^~/, // ~1.2.3\n        /^\\+/, // +1.2.3\n        /^\\*/, // *\n        /^>/, // >1.2.3\n        /^</, // <1.2.3\n        /^>=/, // >=1.2.3\n        /^<=/, // <=1.2.3\n        /\\|\\|/, // 1.2.3 || 2.x\n        / - /, // 1.2.3 - 2.3.4\n        /^\\d+\\.x/, // 1.x, 1.2.x\n        /^latest$/, // latest\n        /^next$/, // next\n    ];\n\n    return semverPatterns.some((pattern) => pattern.test(version));\n}\n\n// webpieces-disable max-lines-new-methods -- Existing method from renamed validate-versions file\n// Validate a single package.json file for semver ranges\nfunction validatePackageJson(filePath: string): string[] {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        const content = fs.readFileSync(filePath, 'utf-8');\n        const pkg = JSON.parse(content);\n        const errors: string[] = [];\n\n        // Check dependencies\n        if (pkg.dependencies) {\n            for (const [name, version] of Object.entries(pkg.dependencies)) {\n                // Skip internal workspace packages\n                if (name.startsWith('@webpieces/')) {\n                    continue;\n                }\n\n                if (hasSemverRange(version as string)) {\n                    errors.push(\n                        `dependencies.${name}: \"${version}\" uses semver range (must be locked to exact version)`,\n                    );\n                }\n            }\n        }\n\n        // Check devDependencies\n        if (pkg.devDependencies) {\n            for (const [name, version] of Object.entries(pkg.devDependencies)) {\n                // Skip internal workspace packages\n                if (name.startsWith('@webpieces/')) {\n                    continue;\n                }\n\n                if (hasSemverRange(version as string)) {\n                    errors.push(\n                        `devDependencies.${name}: \"${version}\" uses semver range (must be locked to exact version)`,\n                    );\n                }\n            }\n        }\n\n        // Check peerDependencies (these can have ranges for compatibility)\n        // We don't validate peerDependencies for semver ranges since they're meant to be flexible\n\n        return errors;\n    } catch (err: unknown) {\n        const error = toError(err);\n        return [`Failed to parse ${filePath}: ${error.message}`];\n    }\n}\n\n// Track all dependency versions across the monorepo\ninterface DependencyUsage {\n    version: string;\n    file: string;\n    type: 'dependencies' | 'devDependencies';\n}\n\n// webpieces-disable max-lines-new-methods -- Collecting dependencies from all package.json files\n// Collect all dependency versions from all package.json files\nfunction collectAllDependencies(workspaceRoot: string): Map<string, DependencyUsage[]> {\n    const dependencyMap = new Map<string, DependencyUsage[]>();\n    const packageFiles = findPackageJsonFiles(workspaceRoot);\n\n    for (const filePath of packageFiles) {\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            const content = fs.readFileSync(filePath, 'utf-8');\n            const pkg = JSON.parse(content);\n            const relativePath = path.relative(workspaceRoot, filePath);\n\n            // Collect dependencies\n            if (pkg.dependencies) {\n                for (const [name, version] of Object.entries(pkg.dependencies)) {\n                    // Skip internal workspace packages\n                    if (name.startsWith('@webpieces/')) continue;\n\n                    const usage: DependencyUsage = {\n                        version: version as string,\n                        file: relativePath,\n                        type: 'dependencies'\n                    };\n\n                    if (!dependencyMap.has(name)) {\n                        dependencyMap.set(name, []);\n                    }\n                    dependencyMap.get(name)!.push(usage);\n                }\n            }\n\n            // Collect devDependencies\n            if (pkg.devDependencies) {\n                for (const [name, version] of Object.entries(pkg.devDependencies)) {\n                    // Skip internal workspace packages\n                    if (name.startsWith('@webpieces/')) continue;\n\n                    const usage: DependencyUsage = {\n                        version: version as string,\n                        file: relativePath,\n                        type: 'devDependencies'\n                    };\n\n                    if (!dependencyMap.has(name)) {\n                        dependencyMap.set(name, []);\n                    }\n                    dependencyMap.get(name)!.push(usage);\n                }\n            }\n        } catch (err: unknown) {\n            // const error = toError(err);\n            // Intentionally skip files that can't be parsed - this is expected for some package.json files\n        }\n    }\n\n    return dependencyMap;\n}\n\n// webpieces-disable max-lines-new-methods -- Simple iteration logic, splitting would reduce clarity\n// Check for version conflicts across package.json files\nfunction checkVersionConflicts(workspaceRoot: string): string[] {\n    console.log('\\n🔍 Checking for version conflicts across package.json files:');\n\n    const dependencyMap = collectAllDependencies(workspaceRoot);\n    const conflicts: string[] = [];\n\n    for (const [packageName, usages] of dependencyMap.entries()) {\n        // Get unique versions (ignoring workspace: and file: protocols)\n        const versions = new Set(\n            usages\n                .map(u => u.version)\n                .filter(v => !v.startsWith('workspace:') && !v.startsWith('file:'))\n        );\n\n        if (versions.size > 1) {\n            const conflictDetails = usages\n                .filter(u => !u.version.startsWith('workspace:') && !u.version.startsWith('file:'))\n                .map(u => `      ${u.file} (${u.type}): ${u.version}`)\n                .join('\\n');\n\n            conflicts.push(`   ❌ ${packageName} has ${versions.size} different versions:\\n${conflictDetails}`);\n        }\n    }\n\n    if (conflicts.length === 0) {\n        console.log('   ✅ No version conflicts found');\n    } else {\n        for (const conflict of conflicts) {\n            console.log(conflict);\n        }\n    }\n\n    return conflicts;\n}\n\n/**\n * Prints the educational message explaining why semver ranges are forbidden.\n * This helps developers understand the rationale behind locked versions.\n */\n// webpieces-disable max-lines-new-methods -- Educational message template, splitting reduces clarity\nfunction printSemverRangeEducationalMessage(semverErrors: number): void {\n    console.log(`\n❌ SEMVER RANGES DETECTED - BUILD FAILED\n\nFound ${semverErrors} package(s) using semver ranges (^, ~, *, etc.) instead of locked versions.\n\nWHY THIS IS A HARD FAILURE:\n═══════════════════════════════════════════════════════════════════════════════\n\n1. MICRO BUGS ARE REAL\n   Thinking that patch versions (1.4.5 → 1.4.6) don't introduce bugs is wrong.\n   They do. Sometimes what looks like an \"easy fix\" breaks things in subtle ways.\n\n2. GIT BISECT BECOMES USELESS\n   When you run \"git bisect\" to find when a bug was introduced, it fails if\n   software changed OUTSIDE of git. You checkout an old commit, but node_modules\n   has different versions than when that commit was made. The bug persists even\n   in \"known good\" commits because the library versions drifted.\n\n3. THE \"MAGIC BUG\" PROBLEM\n   You checkout code from 6 months ago to debug an issue. The bug is still there!\n   But it wasn't there 6 months ago... The culprit: a minor version upgrade that\n   happened silently without any PR or git commit. Impossible to track down.\n\n4. CHANGES OUTSIDE GIT = BAD\n   Every change to your software should be tracked in version control.\n   Implicit library upgrades via semver ranges violate this principle.\n\nTHE SOLUTION:\n═══════════════════════════════════════════════════════════════════════════════\n\nUse LOCKED (exact) versions for all dependencies:\n  ❌ \"lodash\": \"^4.17.21\"    <- BAD: allows 4.17.22, 4.18.0, etc.\n  ❌ \"lodash\": \"~4.17.21\"    <- BAD: allows 4.17.22, 4.17.23, etc.\n  ✅ \"lodash\": \"4.17.21\"     <- GOOD: locked to this exact version\n\nTo upgrade libraries, use an explicit process:\n  1. Run: npm update <package-name>\n  2. Test thoroughly\n  3. Commit the package.json AND package-lock.json changes\n  4. Create a PR so the upgrade is reviewed and tracked in git history\n\nThis way, every library change is:\n  • Intentional (not accidental)\n  • Reviewed (via PR)\n  • Tracked (in git history)\n  • Bisectable (git bisect works correctly)\n\n`);\n}\n\ntype SemverRangeResult = { errors: number };\n\n// Check semver ranges in all package.json files - FAILS if any found\nfunction checkSemverRanges(workspaceRoot: string): SemverRangeResult {\n    console.log('\\n📋 Checking for unlocked versions (semver ranges):');\n    const packageFiles = findPackageJsonFiles(workspaceRoot);\n    let semverErrors = 0;\n\n    for (const filePath of packageFiles) {\n        const relativePath = path.relative(workspaceRoot, filePath);\n        const errors = validatePackageJson(filePath);\n\n        if (errors.length > 0) {\n            console.log(`   ❌ ${relativePath}:`);\n            for (const error of errors) {\n                console.log(`      ${error}`);\n            }\n            semverErrors += errors.length;\n        } else {\n            console.log(`   ✅ ${relativePath}`);\n        }\n    }\n\n    return { errors: semverErrors };\n}\n\nexport default async function runExecutor(\n    _options: ValidateVersionsLockedOptions,\n    context: ExecutorContext\n): Promise<ExecutorResult> {\n    console.log('\\n🔒 Validating Package Versions are LOCKED and CONSISTENT\\n');\n\n    const workspaceRoot = context.root;\n\n    // Step 1: Check for semver ranges (FAILS if any found)\n    const semverResult = checkSemverRanges(workspaceRoot);\n    const semverErrors = semverResult.errors;\n    const packageFiles = findPackageJsonFiles(workspaceRoot);\n\n    // Step 2: Check for version conflicts across package.json files\n    const versionConflicts = checkVersionConflicts(workspaceRoot);\n\n    // Summary\n    console.log(`\\n📊 Summary:`);\n    console.log(`   Files checked: ${packageFiles.length}`);\n    console.log(`   Unlocked versions (semver ranges): ${semverErrors}`);\n    console.log(`   Version conflicts: ${versionConflicts.length}`);\n\n    // Fail on semver ranges with educational message\n    if (semverErrors > 0) {\n        printSemverRangeEducationalMessage(semverErrors);\n        return { success: false };\n    }\n\n    // Fail on version conflicts\n    if (versionConflicts.length > 0) {\n        console.log('\\n❌ VALIDATION FAILED!');\n        console.log('   Fix version conflicts - all package.json files must use the same version for each dependency.');\n        console.log('   This prevents \"works on my machine\" bugs where different projects use different library versions.\\n');\n        return { success: false };\n    }\n\n    console.log('\\n✅ VALIDATION PASSED! All versions are locked and consistent.');\n    return { success: true };\n}\n"]}

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

@@ -0,0 +1,17 @@
+/**
+ * Visualize Executor
+ *
+ * Generates visual representations of the architecture graph (DOT + HTML)
+ * and opens the visualization in a browser.
+ *
+ * Usage:
+ * nx run architecture:visualize
+ */
+import type { ExecutorContext } from '@nx/devkit';
+export interface VisualizeExecutorOptions {
+    graphPath?: string;
+}
+export interface ExecutorResult {
+    success: boolean;
+}
+export default function runExecutor(options: VisualizeExecutorOptions, context: ExecutorContext): Promise<ExecutorResult>;

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

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Visualize Executor
  *
@@ -7,59 +8,44 @@
  * Usage:
  * nx run architecture:visualize
  */
-
-import type { ExecutorContext } from '@nx/devkit';
-import { loadBlessedGraph } from '../../lib/graph-loader';
-import { writeVisualization, openVisualization } from '../../lib/graph-visualizer';
-import { toError } from '../../toError';
-
-export interface VisualizeExecutorOptions {
-    graphPath?: string;
-}
-
-export interface ExecutorResult {
-    success: boolean;
-}
-
-export default async function runExecutor(
-    options: VisualizeExecutorOptions,
-    context: ExecutorContext
-): Promise<ExecutorResult> {
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const graph_loader_1 = require("../../lib/graph-loader");
+const graph_visualizer_1 = require("../../lib/graph-visualizer");
+const toError_1 = require("../../toError");
+async function runExecutor(options, context) {
     const graphPath = options.graphPath;
     const workspaceRoot = context.root;
-
     console.log('\n🎨 Architecture Visualization\n');
-
     // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
     try {
         // Load the saved graph
         console.log('📂 Loading saved graph...');
-        const graph = loadBlessedGraph(workspaceRoot, graphPath);
-
+        const graph = (0, graph_loader_1.loadBlessedGraph)(workspaceRoot, graphPath);
         if (!graph) {
             console.error('❌ No saved graph found at architecture/dependencies.json');
             console.error('   Run: nx run architecture:generate first');
             return { success: false };
         }
-
         // Generate visualization
         console.log('🎨 Generating visualization...');
-        const vizPaths = writeVisualization(graph, workspaceRoot);
+        const vizPaths = (0, graph_visualizer_1.writeVisualization)(graph, workspaceRoot);
         console.log(`✅ Generated: ${vizPaths.dotPath}`);
         console.log(`✅ Generated: ${vizPaths.htmlPath}`);
-
         // Try to open in browser
         console.log('\n🌐 Opening visualization in browser...');
-        if (openVisualization(vizPaths.htmlPath)) {
+        if ((0, graph_visualizer_1.openVisualization)(vizPaths.htmlPath)) {
             console.log('✅ Browser opened');
-        } else {
+        }
+        else {
             console.log(`⚠️  Could not auto-open. Open manually: ${vizPaths.htmlPath}`);
         }
-
         return { success: true };
-    } catch (err: unknown) {
-        const error = toError(err);
+    }
+    catch (err) {
+        const error = (0, toError_1.toError)(err);
         console.error('❌ Visualization failed:', error.message);
         return { success: false };
     }
 }
+//# sourceMappingURL=executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/visualize/executor.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAeH,8BAyCC;AArDD,yDAA0D;AAC1D,iEAAmF;AACnF,2CAAwC;AAUzB,KAAK,UAAU,WAAW,CACrC,OAAiC,EACjC,OAAwB;IAExB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IAEjD,8DAA8D;IAC9D,IAAI,CAAC;QACD,uBAAuB;QACvB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAA,+BAAgB,EAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAEzD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,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,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAA,qCAAkB,EAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEjD,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,IAAI,IAAA,oCAAiB,EAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,2CAA2C,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,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,yBAAyB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;AACL,CAAC","sourcesContent":["/**\n * Visualize Executor\n *\n * Generates visual representations of the architecture graph (DOT + HTML)\n * and opens the visualization in a browser.\n *\n * Usage:\n * nx run architecture:visualize\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { loadBlessedGraph } from '../../lib/graph-loader';\nimport { writeVisualization, openVisualization } from '../../lib/graph-visualizer';\nimport { toError } from '../../toError';\n\nexport interface VisualizeExecutorOptions {\n    graphPath?: string;\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nexport default async function runExecutor(\n    options: VisualizeExecutorOptions,\n    context: ExecutorContext\n): Promise<ExecutorResult> {\n    const graphPath = options.graphPath;\n    const workspaceRoot = context.root;\n\n    console.log('\\n🎨 Architecture Visualization\\n');\n\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        // Load the saved graph\n        console.log('📂 Loading saved graph...');\n        const graph = loadBlessedGraph(workspaceRoot, graphPath);\n\n        if (!graph) {\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        // Generate visualization\n        console.log('🎨 Generating visualization...');\n        const vizPaths = writeVisualization(graph, workspaceRoot);\n        console.log(`✅ Generated: ${vizPaths.dotPath}`);\n        console.log(`✅ Generated: ${vizPaths.htmlPath}`);\n\n        // Try to open in browser\n        console.log('\\n🌐 Opening visualization in browser...');\n        if (openVisualization(vizPaths.htmlPath)) {\n            console.log('✅ Browser opened');\n        } else {\n            console.log(`⚠️  Could not auto-open. Open manually: ${vizPaths.htmlPath}`);\n        }\n\n        return { success: true };\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error('❌ Visualization failed:', error.message);\n        return { success: false };\n    }\n}\n"]}

package/src/{index.ts → index.d.ts}

@@ -6,4 +6,8 @@ export * from './lib/graph-loader';
 export * from './lib/graph-visualizer';
 import { createNodesV2 } from './plugin';
 export { createNodesV2 };
-export default { name: '@webpieces/nx-webpieces-rules', createNodesV2 };
+declare const _default: {
+    name: string;
+    createNodesV2: import("@nx/devkit").CreateNodesV2<import("./plugin").ArchitecturePluginOptions>;
+};
+export default _default;

package/src/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodesV2 = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/graph-generator"), exports);
+tslib_1.__exportStar(require("./lib/graph-sorter"), exports);
+tslib_1.__exportStar(require("./lib/graph-comparator"), exports);
+tslib_1.__exportStar(require("./lib/package-validator"), exports);
+tslib_1.__exportStar(require("./lib/graph-loader"), exports);
+tslib_1.__exportStar(require("./lib/graph-visualizer"), exports);
+const plugin_1 = require("./plugin");
+Object.defineProperty(exports, "createNodesV2", { enumerable: true, get: function () { return plugin_1.createNodesV2; } });
+exports.default = { name: '@webpieces/nx-webpieces-rules', createNodesV2: plugin_1.createNodesV2 };
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/nx-webpieces-rules/src/index.ts"],"names":[],"mappings":";;;;AAAA,gEAAsC;AACtC,6DAAmC;AACnC,iEAAuC;AACvC,kEAAwC;AACxC,6DAAmC;AACnC,iEAAuC;AACvC,qCAAyC;AAChC,8FADA,sBAAa,OACA;AACtB,kBAAe,EAAE,IAAI,EAAE,+BAA+B,EAAE,aAAa,EAAb,sBAAa,EAAE,CAAC","sourcesContent":["export * from './lib/graph-generator';\nexport * from './lib/graph-sorter';\nexport * from './lib/graph-comparator';\nexport * from './lib/package-validator';\nexport * from './lib/graph-loader';\nexport * from './lib/graph-visualizer';\nimport { createNodesV2 } from './plugin';\nexport { createNodesV2 };\nexport default { name: '@webpieces/nx-webpieces-rules', createNodesV2 };\n"]}

package/src/lib/graph-comparator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Graph Comparator
+ *
+ * Compares the current generated graph with the saved (blessed) graph.
+ * Used in validate mode to ensure developers have updated the graph file.
+ */
+import type { EnhancedGraph } from './graph-sorter';
+/**
+ * Difference between two graphs
+ */
+export interface GraphDiff {
+    added: string[];
+    removed: string[];
+    modified: {
+        project: string;
+        addedDeps: string[];
+        removedDeps: string[];
+        levelChanged: {
+            from: number;
+            to: number;
+        } | null;
+    }[];
+}
+/**
+ * Comparison result
+ */
+export interface ComparisonResult {
+    identical: boolean;
+    diff: GraphDiff;
+    summary: string;
+}
+/**
+ * Compare two graphs and return the differences
+ *
+ * @param current - Currently generated graph
+ * @param saved - Previously saved (blessed) graph
+ * @returns Comparison result with detailed diff
+ */
+export declare function compareGraphs(current: EnhancedGraph, saved: EnhancedGraph): ComparisonResult;