@webpieces/dev-config 0.2.46 → 0.2.51

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

@@ -1,11 +1,16 @@
 /**
- * Validate Versions Executor
+ * Validate Versions Locked Executor
  *
- * Validates package.json versions and checks npm ci compatibility.
- * This catches peer dependency conflicts that npm ci catches but npm install doesn't.
+ * Validates that package.json versions are LOCKED (exact versions, no semver ranges)
+ * and checks npm ci compatibility for peer dependency conflicts.
+ *
+ * Why locked versions matter:
+ * - Micro bugs ARE introduced via patch versions (1.4.5 → 1.4.6)
+ * - git bisect fails when software changes OUTSIDE of git
+ * - Library upgrades must be explicit via PR/commit, not implicit drift
  *
  * Usage:
- * nx run dev-config:validate-versions
+ * nx run architecture:validate-versions-locked
  */
 
 import type { ExecutorContext } from '@nx/devkit';
@@ -13,7 +18,7 @@ import { execSync } from 'child_process';
 import * as fs from 'fs';
 import * as path from 'path';
 
-export interface ValidateVersionsOptions {
+export interface ValidateVersionsLockedOptions {
     // No options needed
 }
 
@@ -21,6 +26,7 @@ export interface ExecutorResult {
     success: boolean;
 }
 
+// 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[] = [];
@@ -87,6 +93,7 @@ function hasSemverRange(version: string): boolean {
     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[] {
     // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
@@ -105,7 +112,7 @@ function validatePackageJson(filePath: string): string[] {
 
                 if (hasSemverRange(version as string)) {
                     errors.push(
-                        `dependencies.${name}: "${version}" uses semver range (should be fixed version)`,
+                        `dependencies.${name}: "${version}" uses semver range (must be locked to exact version)`,
                     );
                 }
             }
@@ -121,7 +128,7 @@ function validatePackageJson(filePath: string): string[] {
 
                 if (hasSemverRange(version as string)) {
                     errors.push(
-                        `devDependencies.${name}: "${version}" uses semver range (should be fixed version)`,
+                        `devDependencies.${name}: "${version}" uses semver range (must be locked to exact version)`,
                     );
                 }
             }
@@ -137,6 +144,7 @@ function validatePackageJson(filePath: string): string[] {
     }
 }
 
+// webpieces-disable max-lines-new-methods -- Existing method from renamed validate-versions file
 // Check npm ci compatibility
 function checkNpmCiCompatibility(workspaceRoot: string): string[] {
     // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
@@ -162,6 +170,13 @@ function checkNpmCiCompatibility(workspaceRoot: string): string[] {
         // Parse the error output to extract peer dependency conflicts
         const output = err.stdout || err.stderr || err.message;
 
+        // Ignore errors about internal @webpieces/* packages with 0.0.0-dev versions
+        // These don't exist on npm registry (only locally) but that's expected in development/CI
+        if (output.includes('npm error') && output.includes('@webpieces/') && output.includes('0.0.0-dev')) {
+            console.log('   ⏭️  Skipping npm ci check - internal @webpieces packages use local 0.0.0-dev versions');
+            return [];
+        }
+
         // Check if it's a peer dependency error (npm error, not npm warn)
         if (output.includes('npm error') && (output.includes('ERESOLVE') || output.includes('peer'))) {
             return [output];
@@ -177,39 +192,91 @@ function checkNpmCiCompatibility(workspaceRoot: string): string[] {
     }
 }
 
-// Check semver ranges in all package.json files
-function checkSemverRanges(workspaceRoot: string): { warnings: number } {
-    console.log('\n📋 Checking for semver ranges (warnings only):');
+/**
+ * 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 {
+    console.log(`
+❌ SEMVER RANGES DETECTED - BUILD FAILED
+
+Found ${semverErrors} package(s) using semver ranges (^, ~, *, etc.) instead of locked versions.
+
+WHY THIS IS A HARD FAILURE:
+═══════════════════════════════════════════════════════════════════════════════
+
+1. MICRO BUGS ARE REAL
+   Thinking that patch versions (1.4.5 → 1.4.6) don't introduce bugs is wrong.
+   They do. Sometimes what looks like an "easy fix" breaks things in subtle ways.
+
+2. GIT BISECT BECOMES USELESS
+   When you run "git bisect" to find when a bug was introduced, it fails if
+   software changed OUTSIDE of git. You checkout an old commit, but node_modules
+   has different versions than when that commit was made. The bug persists even
+   in "known good" commits because the library versions drifted.
+
+3. THE "MAGIC BUG" PROBLEM
+   You checkout code from 6 months ago to debug an issue. The bug is still there!
+   But it wasn't there 6 months ago... The culprit: a minor version upgrade that
+   happened silently without any PR or git commit. Impossible to track down.
+
+4. CHANGES OUTSIDE GIT = BAD
+   Every change to your software should be tracked in version control.
+   Implicit library upgrades via semver ranges violate this principle.
+
+THE SOLUTION:
+═══════════════════════════════════════════════════════════════════════════════
+
+Use LOCKED (exact) versions for all dependencies:
+  ❌ "lodash": "^4.17.21"    <- BAD: allows 4.17.22, 4.18.0, etc.
+  ❌ "lodash": "~4.17.21"    <- BAD: allows 4.17.22, 4.17.23, etc.
+  ✅ "lodash": "4.17.21"     <- GOOD: locked to this exact version
+
+To upgrade libraries, use an explicit process:
+  1. Run: npm update <package-name>
+  2. Test thoroughly
+  3. Commit the package.json AND package-lock.json changes
+  4. Create a PR so the upgrade is reviewed and tracked in git history
+
+This way, every library change is:
+  • Intentional (not accidental)
+  • Reviewed (via PR)
+  • Tracked (in git history)
+  • Bisectable (git bisect works correctly)
+
+`);
+}
+
+// Check semver ranges in all package.json files - FAILS if any found
+function checkSemverRanges(workspaceRoot: string): { errors: number } {
+    console.log('\n📋 Checking for unlocked versions (semver ranges):');
     const packageFiles = findPackageJsonFiles(workspaceRoot);
-    let semverWarnings = 0;
+    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}:`);
+            console.log(`   ❌ ${relativePath}:`);
             for (const error of errors) {
                 console.log(`      ${error}`);
             }
-            semverWarnings += errors.length;
+            semverErrors += errors.length;
         } else {
             console.log(`   ✅ ${relativePath}`);
         }
     }
 
-    if (semverWarnings > 0) {
-        console.log(`\n   ⚠️  Note: ${semverWarnings} semver ranges found (consider using fixed versions for reproducibility)`);
-    }
-
-    return { warnings: semverWarnings };
+    return { errors: semverErrors };
 }
 
 export default async function runExecutor(
-    _options: ValidateVersionsOptions,
+    _options: ValidateVersionsLockedOptions,
     context: ExecutorContext
 ): Promise<ExecutorResult> {
-    console.log('\n🔍 Validating Package Versions and npm ci Compatibility\n');
+    console.log('\n🔒 Validating Package Versions are LOCKED (no semver ranges)\n');
 
     const workspaceRoot = context.root;
 
@@ -233,23 +300,30 @@ export default async function runExecutor(
         console.log('   ✅ npm ci compatibility check passed');
     }
 
-    // Step 2: Check for semver ranges
-    const { warnings: semverWarnings } = checkSemverRanges(workspaceRoot);
+    // Step 2: Check for semver ranges (FAILS if any found)
+    const { errors: semverErrors } = checkSemverRanges(workspaceRoot);
     const packageFiles = findPackageJsonFiles(workspaceRoot);
 
     // Summary
     console.log(`\n📊 Summary:`);
     console.log(`   npm ci compatibility: ${npmCiErrors.length === 0 ? '✅' : '❌'}`);
     console.log(`   Files checked: ${packageFiles.length}`);
-    console.log(`   Semver warnings: ${semverWarnings}`);
-    console.log(`   Errors: ${npmCiErrors.length}`);
+    console.log(`   Unlocked versions: ${semverErrors}`);
+    console.log(`   Peer dep errors: ${npmCiErrors.length}`);
 
+    // Fail on npm ci errors
     if (npmCiErrors.length > 0) {
         console.log('\n❌ VALIDATION FAILED!');
         console.log('   Fix peer dependency conflicts to avoid CI failures.\n');
         return { success: false };
     }
 
-    console.log('\n✅ VALIDATION PASSED!');
+    // Fail on semver ranges with educational message
+    if (semverErrors > 0) {
+        printSemverRangeEducationalMessage(semverErrors);
+        return { success: false };
+    }
+
+    console.log('\n✅ VALIDATION PASSED! All versions are locked.');
     return { success: true };
 }

package/executors/validate-versions-locked/schema.json

@@ -0,0 +1,8 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate Versions Locked Executor",
+    "description": "Validates package.json versions are locked (no semver ranges) and npm ci compatible",
+    "type": "object",
+    "properties": {},
+    "required": []
+}

package/executors.json

@@ -35,6 +35,11 @@
             "schema": "./architecture/executors/validate-new-methods/schema.json",
             "description": "Validate new methods don't exceed max line count (only runs in affected mode)"
         },
+        "validate-modified-methods": {
+            "implementation": "./architecture/executors/validate-modified-methods/executor",
+            "schema": "./architecture/executors/validate-modified-methods/schema.json",
+            "description": "Validate modified methods don't exceed max line count (encourages gradual cleanup)"
+        },
         "help": {
             "implementation": "./executors/help/executor",
             "schema": "./executors/help/schema.json",
@@ -45,10 +50,10 @@
             "schema": "./executors/validate-eslint-sync/schema.json",
             "description": "Validate that workspace and template eslint.webpieces.config.mjs files have identical rules"
         },
-        "validate-versions": {
-            "implementation": "./executors/validate-versions/executor",
-            "schema": "./executors/validate-versions/schema.json",
-            "description": "Validate package.json versions and npm ci compatibility"
+        "validate-versions-locked": {
+            "implementation": "./executors/validate-versions-locked/executor",
+            "schema": "./executors/validate-versions-locked/schema.json",
+            "description": "Validate package.json versions are locked (no semver ranges) and npm ci compatible"
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/dev-config",
-  "version": "0.2.46",
+  "version": "0.2.51",
   "description": "Development configuration, scripts, and patterns for WebPieces projects",
   "type": "commonjs",
   "bin": {

package/plugin.js

@@ -36,6 +36,10 @@ const DEFAULT_OPTIONS = {
             architectureUnchanged: true,
             validatePackageJson: true,
             validateNewMethods: true,
+            validateModifiedMethods: true,
+            validateVersionsLocked: true,
+            newMethodsMaxLines: 30,
+            modifiedAndNewMethodsMaxLines: 80,
         },
         features: {
             generate: true,
@@ -112,8 +116,9 @@ function addPerProjectTargets(results, projectFiles, opts, context) {
                 targets[targetName] = createCircularDepsTarget(projectRoot, targetName);
             }
         }
-        // Add ci target - composite target that runs lint, build, test in parallel
-        // (with test depending on build via targetDefaults)
+        // Add ci target - composite target that runs lint, build, test, and typecheck
+        // The 'typecheck' target from @nx/js/typescript plugin already type-checks ALL files
+        // including *.spec.ts and *.test.ts via tsconfig.json references
         targets['ci'] = createCiTarget();
         if (Object.keys(targets).length === 0)
             continue;
@@ -137,6 +142,27 @@ exports.createNodesV2 = [
     // Inference function
     createNodesFunction,
 ];
+/**
+ * Build list of enabled validation target names for validate-complete dependency chain
+ */
+function buildValidationTargetsList(validations) {
+    const targets = [];
+    if (validations.noCycles)
+        targets.push('validate-no-architecture-cycles');
+    if (validations.architectureUnchanged)
+        targets.push('validate-architecture-unchanged');
+    if (validations.noSkipLevelDeps)
+        targets.push('validate-no-skiplevel-deps');
+    if (validations.validatePackageJson)
+        targets.push('validate-packagejson');
+    if (validations.validateNewMethods)
+        targets.push('validate-new-methods');
+    if (validations.validateModifiedMethods)
+        targets.push('validate-modified-methods');
+    if (validations.validateVersionsLocked)
+        targets.push('validate-versions-locked');
+    return targets;
+}
 /**
  * Create workspace-level architecture validation targets WITHOUT prefix
  * Used for virtual 'architecture' project
@@ -144,6 +170,7 @@ exports.createNodesV2 = [
 function createWorkspaceTargetsWithoutPrefix(opts) {
     const targets = {};
     const graphPath = opts.workspace.graphPath;
+    const validations = opts.workspace.validations;
     // Add help target (always available)
     targets['help'] = createHelpTarget();
     if (opts.workspace.features.generate) {
@@ -152,38 +179,29 @@ function createWorkspaceTargetsWithoutPrefix(opts) {
     if (opts.workspace.features.visualize) {
         targets['visualize'] = createVisualizeTargetWithoutPrefix(graphPath);
     }
-    if (opts.workspace.validations.noCycles) {
+    if (validations.noCycles) {
         targets['validate-no-architecture-cycles'] = createValidateNoCyclesTarget();
     }
-    if (opts.workspace.validations.architectureUnchanged) {
+    if (validations.architectureUnchanged) {
         targets['validate-architecture-unchanged'] = createValidateUnchangedTarget(graphPath);
     }
-    if (opts.workspace.validations.noSkipLevelDeps) {
+    if (validations.noSkipLevelDeps) {
         targets['validate-no-skiplevel-deps'] = createValidateNoSkipLevelTarget();
     }
-    if (opts.workspace.validations.validatePackageJson) {
+    if (validations.validatePackageJson) {
         targets['validate-packagejson'] = createValidatePackageJsonTarget();
     }
-    if (opts.workspace.validations.validateNewMethods) {
-        targets['validate-new-methods'] = createValidateNewMethodsTarget();
-    }
-    // Add validate-complete target that runs all validations
-    const validationTargets = [];
-    if (opts.workspace.validations.noCycles) {
-        validationTargets.push('validate-no-architecture-cycles');
+    if (validations.validateNewMethods) {
+        targets['validate-new-methods'] = createValidateNewMethodsTarget(validations.newMethodsMaxLines);
     }
-    if (opts.workspace.validations.architectureUnchanged) {
-        validationTargets.push('validate-architecture-unchanged');
+    if (validations.validateModifiedMethods) {
+        targets['validate-modified-methods'] = createValidateModifiedMethodsTarget(validations.modifiedAndNewMethodsMaxLines);
     }
-    if (opts.workspace.validations.noSkipLevelDeps) {
-        validationTargets.push('validate-no-skiplevel-deps');
-    }
-    if (opts.workspace.validations.validatePackageJson) {
-        validationTargets.push('validate-packagejson');
-    }
-    if (opts.workspace.validations.validateNewMethods) {
-        validationTargets.push('validate-new-methods');
+    if (validations.validateVersionsLocked) {
+        targets['validate-versions-locked'] = createValidateVersionsLockedTarget();
     }
+    // Add validate-complete target that runs all enabled validations
+    const validationTargets = buildValidationTargetsList(validations);
     if (validationTargets.length > 0) {
         targets['validate-complete'] = createValidateCompleteTarget(validationTargets);
     }
@@ -218,7 +236,10 @@ function createWorkspaceTargets(opts) {
         targets[`${prefix}validate-packagejson`] = createValidatePackageJsonTarget();
     }
     if (opts.workspace.validations.validateNewMethods) {
-        targets[`${prefix}validate-new-methods`] = createValidateNewMethodsTarget();
+        targets[`${prefix}validate-new-methods`] = createValidateNewMethodsTarget(opts.workspace.validations.newMethodsMaxLines);
+    }
+    if (opts.workspace.validations.validateModifiedMethods) {
+        targets[`${prefix}validate-modified-methods`] = createValidateModifiedMethodsTarget(opts.workspace.validations.modifiedAndNewMethodsMaxLines);
     }
     return targets;
 }
@@ -302,15 +323,38 @@ function createValidatePackageJsonTarget() {
         },
     };
 }
-function createValidateNewMethodsTarget() {
+function createValidateNewMethodsTarget(maxLines) {
     return {
         executor: '@webpieces/dev-config:validate-new-methods',
         cache: false, // Don't cache - depends on git state
         inputs: ['default'],
-        options: { max: 30 },
+        options: { max: maxLines },
         metadata: {
             technologies: ['nx'],
-            description: 'Validate new methods do not exceed max line count (only runs in affected mode)',
+            description: `Validate new methods do not exceed ${maxLines} lines (only runs in affected mode)`,
+        },
+    };
+}
+function createValidateModifiedMethodsTarget(maxLines) {
+    return {
+        executor: '@webpieces/dev-config:validate-modified-methods',
+        cache: false, // Don't cache - depends on git state
+        inputs: ['default'],
+        options: { max: maxLines },
+        metadata: {
+            technologies: ['nx'],
+            description: `Validate new and modified methods do not exceed ${maxLines} lines (encourages gradual cleanup)`,
+        },
+    };
+}
+function createValidateVersionsLockedTarget() {
+    return {
+        executor: '@webpieces/dev-config:validate-versions-locked',
+        cache: true,
+        inputs: ['default'],
+        metadata: {
+            technologies: ['nx'],
+            description: 'Validate package.json versions are locked (no semver ranges) and npm ci compatible',
         },
     };
 }
@@ -327,16 +371,20 @@ function createValidateCompleteTarget(validationTargets) {
 }
 /**
  * Create per-project ci target - Gradle-style composite target
- * Runs lint, build, and test in parallel (with test waiting for build via targetDefaults)
+ * Runs lint, build, test, and typecheck in parallel
+ * (with test depending on build via targetDefaults)
+ *
+ * The 'typecheck' target from @nx/js/typescript plugin type-checks ALL *.ts files
+ * including test files (*.spec.ts, *.test.ts) via tsconfig.json references.
  */
 function createCiTarget() {
     return {
         executor: 'nx:noop',
         cache: true,
-        dependsOn: ['lint', 'build', 'test'],
+        dependsOn: ['lint', 'build', 'test', 'typecheck'],
         metadata: {
             technologies: ['nx'],
-            description: 'Run all CI checks: lint, build, and test (Gradle-style composite target)',
+            description: 'Run all CI checks: lint, build, test, and typecheck (Gradle-style composite target)',
         },
     };
 }

package/src/generators/init/generator.js

@@ -53,9 +53,20 @@ function registerPlugin(tree) {
     const pluginName = '@webpieces/dev-config';
     const alreadyRegistered = nxJson.plugins.some((p) => typeof p === 'string' ? p === pluginName : p.plugin === pluginName);
     if (!alreadyRegistered) {
-        nxJson.plugins.push(pluginName);
+        // Register plugin with default options for method size validation
+        nxJson.plugins.push({
+            plugin: pluginName,
+            options: {
+                workspace: {
+                    validations: {
+                        newMethodsMaxLines: 30,
+                        modifiedAndNewMethodsMaxLines: 80,
+                    },
+                },
+            },
+        });
         (0, devkit_1.updateNxJson)(tree, nxJson);
-        console.log(`✅ Registered ${pluginName} plugin in nx.json`);
+        console.log(`✅ Registered ${pluginName} plugin in nx.json with default options`);
     }
     else {
         console.log(`ℹ️  ${pluginName} plugin is already registered`);
@@ -197,9 +208,11 @@ function addNpmScripts(tree) {
         pkgJson.scripts['arch:check-circular-affected'] = 'nx affected --target=validate-no-file-import-cycles';
         // Complete validation including circular deps
         pkgJson.scripts['arch:validate-complete'] = 'npm run arch:validate-all && npm run arch:check-circular';
+        // Add CI script that runs lint, build, test on affected projects
+        pkgJson.scripts['webpieces:ci'] = 'npx nx affected --target=ci';
         return pkgJson;
     });
-    console.log('✅ Added npm scripts for architecture validation and circular dependency checking');
+    console.log('✅ Added npm scripts for architecture validation, circular dependency checking, and CI');
 }
 function createEslintConfig(tree) {
     const webpiecesConfigPath = 'eslint.webpieces.config.mjs';

package/src/generators/init/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/src/generators/init/generator.ts"],"names":[],"mappings":"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","sourcesContent":["import { formatFiles, readNxJson, Tree, updateNxJson, updateJson, addDependenciesToPackageJson } from '@nx/devkit';\nimport { createHash } from 'crypto';\n\nexport interface InitGeneratorSchema {\n    skipFormat?: boolean;\n}\n\nfunction calculateHash(content: string): string {\n    return createHash('sha256').update(content).digest('hex');\n}\n\nfunction getPackageVersion(tree: Tree): string {\n    const content = tree.read('node_modules/@webpieces/dev-config/package.json', 'utf-8');\n    if (!content) {\n        throw new Error('Could not read package.json from node_modules/@webpieces/dev-config');\n    }\n    const pkgJson = JSON.parse(content);\n    return pkgJson.version;\n}\n\n/**\n * Init generator for @webpieces/dev-config\n *\n * Automatically runs when users execute: nx add @webpieces/dev-config\n *\n * Responsibilities:\n * - Registers the plugin in nx.json\n * - Adds architecture validation to targetDefaults (runs once before all builds)\n * - Creates architecture/ directory if needed\n * - Adds madge as a devDependency (required for circular dep checking)\n * - Adds convenient npm scripts to package.json\n * - Always creates eslint.webpieces.config.mjs with @webpieces rules\n * - Creates eslint.config.mjs (if not exists) that imports eslint.webpieces.config.mjs\n * - If eslint.config.mjs exists, shows user how to import eslint.webpieces.config.mjs\n * - Provides helpful output about available targets\n */\nexport default async function initGenerator(tree: Tree, options: InitGeneratorSchema) {\n    registerPlugin(tree);\n    addTargetDefaults(tree);\n    const installTask = addMadgeDependency(tree);\n    createArchitectureDirectory(tree);\n    addNpmScripts(tree);\n    const hasExistingEslintConfig = createEslintConfig(tree);\n\n    if (!options.skipFormat) {\n        await formatFiles(tree);\n    }\n\n    return createSuccessCallback(installTask, hasExistingEslintConfig);\n}\n\nfunction registerPlugin(tree: Tree): void {\n    const nxJson = readNxJson(tree);\n    if (!nxJson) {\n        throw new Error('Could not read nx.json. Are you in an Nx workspace?');\n    }\n\n    if (!nxJson.plugins) {\n        nxJson.plugins = [];\n    }\n\n    const pluginName = '@webpieces/dev-config';\n    const alreadyRegistered = nxJson.plugins.some(\n        (p) => typeof p === 'string' ? p === pluginName : p.plugin === pluginName\n    );\n\n    if (!alreadyRegistered) {\n        nxJson.plugins.push(pluginName);\n        updateNxJson(tree, nxJson);\n        console.log(`✅ Registered ${pluginName} plugin in nx.json`);\n    } else {\n        console.log(`ℹ️  ${pluginName} plugin is already registered`);\n    }\n}\n\nfunction addTargetDefaults(tree: Tree): void {\n    const nxJson = readNxJson(tree);\n    if (!nxJson) {\n        throw new Error('Could not read nx.json. Are you in an Nx workspace?');\n    }\n\n    if (!nxJson.targetDefaults) {\n        nxJson.targetDefaults = {};\n    }\n\n    // Find which executors are actually used in this workspace\n    const usedExecutors = findUsedExecutors(tree);\n\n    // Only add targetDefaults for executors that are actually used\n    let updated = false;\n\n    usedExecutors.forEach((executor) => {\n        if (!nxJson.targetDefaults![executor]) {\n            nxJson.targetDefaults![executor] = {};\n        }\n\n        const targetDef = nxJson.targetDefaults![executor];\n        let dependsOn = targetDef.dependsOn || [];\n\n        // Ensure dependsOn is an array\n        if (!Array.isArray(dependsOn)) {\n            dependsOn = [dependsOn];\n        }\n\n        // Check if architecture validation is already in dependsOn\n        const hasArchValidation = dependsOn.some((dep) => {\n            if (typeof dep === 'string') {\n                return dep === 'architecture:validate-complete';\n            }\n            return dep.target === 'architecture:validate-complete';\n        });\n\n        // Check if circular deps validation is already in dependsOn\n        const hasCircularDepsValidation = dependsOn.some((dep) => {\n            if (typeof dep === 'string') {\n                return dep === 'validate-no-file-import-cycles';\n            }\n            return dep.target === 'validate-no-file-import-cycles';\n        });\n\n        if (!hasCircularDepsValidation) {\n            // Add circular deps validation (per-project check)\n            dependsOn.unshift('validate-no-file-import-cycles');\n            targetDef.dependsOn = dependsOn;\n            updated = true;\n            console.log(`  ✅ Added circular deps validation to ${executor}`);\n        }\n\n        if (!hasArchValidation) {\n            // Add architecture validation before other dependencies\n            dependsOn.unshift('architecture:validate-complete');\n            targetDef.dependsOn = dependsOn;\n            updated = true;\n            console.log(`  ✅ Added architecture validation to ${executor}`);\n        }\n    });\n\n    if (updated) {\n        updateNxJson(tree, nxJson);\n        console.log('✅ Added architecture validation to targetDefaults for used executors');\n    } else {\n        console.log('ℹ️  Architecture validation already configured in targetDefaults');\n    }\n}\n\n/**\n * Scan all project.json files to find which build executors are actually used\n */\nfunction findUsedExecutors(tree: Tree): Set<string> {\n    const usedExecutors = new Set<string>();\n\n    // Known build executors we care about\n    const buildExecutors = new Set([\n        '@nx/js:tsc',\n        '@nx/esbuild:esbuild',\n        '@nx/webpack:webpack',\n        '@nx/rollup:rollup',\n        '@nx/vite:build',\n        '@angular/build:application',\n        '@angular-devkit/build-angular:browser',\n        '@angular-devkit/build-angular:application'\n    ]);\n\n    // Scan all project.json files\n    tree.listChanges(); // Force tree to be aware of all files\n\n    const scanDir = (dir: string) => {\n        for (const child of tree.children(dir)) {\n            const childPath = dir === '.' ? child : `${dir}/${child}`;\n\n            if (tree.isFile(childPath)) {\n                if (child === 'project.json') {\n                    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- Intentionally ignoring JSON parse errors for malformed project.json files\n                    try {\n                        const content = tree.read(childPath, 'utf-8');\n                        if (content) {\n                            const projectJson = JSON.parse(content);\n                            if (projectJson.targets) {\n                                for (const target of Object.values(projectJson.targets)) {\n                                    const executor = (target as { executor?: string })?.executor;\n                                    if (executor && buildExecutors.has(executor)) {\n                                        usedExecutors.add(executor);\n                                    }\n                                }\n                            }\n                        }\n                    } catch (err: any) {\n                        //const error = toError(err);\n                    }\n                }\n            } else {\n                // Skip node_modules and dist\n                if (child !== 'node_modules' && child !== 'dist' && child !== '.git') {\n                    scanDir(childPath);\n                }\n            }\n        }\n    };\n\n    scanDir('.');\n\n    console.log(`ℹ️  Found ${usedExecutors.size} build executors in use: ${[...usedExecutors].join(', ')}`);\n\n    return usedExecutors;\n}\n\nfunction addMadgeDependency(tree: Tree) {\n    return addDependenciesToPackageJson(tree, {}, { 'madge': '^8.0.0' });\n}\n\nfunction createArchitectureDirectory(tree: Tree): void {\n    if (!tree.exists('architecture')) {\n        tree.write('architecture/.gitkeep', '');\n        console.log('✅ Created architecture/ directory');\n    }\n}\n\nfunction addNpmScripts(tree: Tree): void {\n    updateJson(tree, 'package.json', (pkgJson) => {\n        pkgJson.scripts = pkgJson.scripts ?? {};\n\n        // Add architecture validation scripts\n        pkgJson.scripts['arch:generate'] = 'nx run architecture:generate';\n        pkgJson.scripts['arch:visualize'] = 'nx run architecture:visualize';\n        pkgJson.scripts['arch:validate'] = 'nx run architecture:validate-no-architecture-cycles && nx run architecture:validate-no-skiplevel-deps';\n        pkgJson.scripts['arch:validate-all'] = 'nx run architecture:validate-no-architecture-cycles && nx run architecture:validate-no-skiplevel-deps && nx run architecture:validate-architecture-unchanged';\n\n        // Add file import cycle checking scripts\n        pkgJson.scripts['arch:check-circular'] = 'nx run-many --target=validate-no-file-import-cycles --all';\n        pkgJson.scripts['arch:check-circular-affected'] = 'nx affected --target=validate-no-file-import-cycles';\n\n        // Complete validation including circular deps\n        pkgJson.scripts['arch:validate-complete'] = 'npm run arch:validate-all && npm run arch:check-circular';\n\n        return pkgJson;\n    });\n\n    console.log('✅ Added npm scripts for architecture validation and circular dependency checking');\n}\n\nfunction createEslintConfig(tree: Tree): boolean {\n    const webpiecesConfigPath = 'eslint.webpieces.config.mjs';\n    const mainConfigPath = 'eslint.config.mjs';\n\n    // Always create eslint.webpieces.config.mjs with our rules\n    createWebpiecesEslintConfig(tree, webpiecesConfigPath);\n\n    // Check if main eslint.config.mjs exists\n    const hasExistingConfig = tree.exists(mainConfigPath);\n\n    if (!hasExistingConfig) {\n        // No existing config - create one that imports webpieces config\n        const mainConfig = `// ESLint configuration\n// Imports @webpieces/dev-config rules\n\nimport webpiecesConfig from './eslint.webpieces.config.mjs';\n\n// Export the webpieces configuration\n// You can add your own rules after spreading webpiecesConfig\nexport default [\n    ...webpiecesConfig,\n    // Add your custom ESLint configuration here\n];\n`;\n\n        tree.write(mainConfigPath, mainConfig);\n        console.log('✅ Created eslint.config.mjs with @webpieces/dev-config rules');\n    }\n\n    return hasExistingConfig;\n}\n\nfunction getWebpiecesEslintConfigTemplate(tree: Tree): string {\n    // Read from canonical template file (single source of truth)\n    const templatePath = 'node_modules/@webpieces/dev-config/templates/eslint.webpieces.config.mjs';\n    const template = tree.read(templatePath, 'utf-8');\n\n    if (!template) {\n        throw new Error(`Could not read ESLint template from ${templatePath}`);\n    }\n\n    return template;\n}\n\nfunction warnConfigChanges(tree: Tree, configPath: string, newConfig: string): void {\n    const version = getPackageVersion(tree);\n    const versionedFilename = `${configPath}.v${version}`;\n\n    tree.write(versionedFilename, newConfig);\n\n    console.log('');\n    console.log(`⚠️  ${configPath} has changes`);\n    console.log('');\n    console.log('   Either you modified the file OR @webpieces/dev-config has updates.');\n    console.log('');\n    console.log(`   Created: ${versionedFilename} with latest version`);\n    console.log('');\n    console.log('   Please review and merge if needed:');\n    console.log(`     - Your current: ${configPath}`);\n    console.log(`     - New version:  ${versionedFilename}`);\n    console.log('');\n}\n\nfunction createWebpiecesEslintConfig(tree: Tree, configPath: string): void {\n    const webpiecesConfig = getWebpiecesEslintConfigTemplate(tree);\n\n    if (!tree.exists(configPath)) {\n        tree.write(configPath, webpiecesConfig);\n        console.log(`✅ Created ${configPath}`);\n        return;\n    }\n\n    const currentContent = tree.read(configPath, 'utf-8');\n    if (!currentContent) {\n        tree.write(configPath, webpiecesConfig);\n        console.log(`✅ Created ${configPath}`);\n        return;\n    }\n\n    const currentHash = calculateHash(currentContent);\n    const newHash = calculateHash(webpiecesConfig);\n\n    if (currentHash === newHash) {\n        console.log(`✅ ${configPath} is up to date`);\n        return;\n    }\n\n    warnConfigChanges(tree, configPath, webpiecesConfig);\n}\n\nfunction createSuccessCallback(\n    installTask: ReturnType<typeof addDependenciesToPackageJson>,\n    hasExistingEslintConfig: boolean\n) {\n    return async () => {\n        await installTask();\n\n        // ANSI color codes for formatted output\n        const GREEN = '\\x1b[32m\\x1b[1m';\n        const BOLD = '\\x1b[1m';\n        const RESET = '\\x1b[0m';\n\n        console.log('');\n        console.log('✅ Added madge to devDependencies');\n        console.log('');\n        console.log(`${GREEN}✅ @webpieces/dev-config plugin initialized!${RESET}`);\n        console.log('');\n        console.log(`${GREEN}💡 Quick start:${RESET}`);\n        console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the dependency graph`);\n        console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);\n        console.log('');\n        console.log(`💡 For full documentation, run: ${BOLD}nx run architecture:help${RESET}`);\n\n        // Show ESLint integration instructions if they have an existing config\n        if (hasExistingEslintConfig) {\n            console.log('');\n            console.log('📋 Existing eslint.config.mjs detected');\n            console.log('');\n            console.log('To use @webpieces/dev-config ESLint rules, add this import to your eslint.config.mjs:');\n            console.log('');\n            console.log('  import webpiecesConfig from \\'./eslint.webpieces.config.mjs\\';');\n            console.log('');\n            console.log('Then spread it into your config array:');\n            console.log('');\n            console.log('  export default [');\n            console.log('    ...webpiecesConfig,  // Add this line');\n            console.log('    // ... your existing config');\n            console.log('  ];');\n        }\n\n        console.log('');\n    };\n}\n"]}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/src/generators/init/generator.ts"],"names":[],"mappings":"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","sourcesContent":["import { formatFiles, readNxJson, Tree, updateNxJson, updateJson, addDependenciesToPackageJson } from '@nx/devkit';\nimport { createHash } from 'crypto';\n\nexport interface InitGeneratorSchema {\n    skipFormat?: boolean;\n}\n\nfunction calculateHash(content: string): string {\n    return createHash('sha256').update(content).digest('hex');\n}\n\nfunction getPackageVersion(tree: Tree): string {\n    const content = tree.read('node_modules/@webpieces/dev-config/package.json', 'utf-8');\n    if (!content) {\n        throw new Error('Could not read package.json from node_modules/@webpieces/dev-config');\n    }\n    const pkgJson = JSON.parse(content);\n    return pkgJson.version;\n}\n\n/**\n * Init generator for @webpieces/dev-config\n *\n * Automatically runs when users execute: nx add @webpieces/dev-config\n *\n * Responsibilities:\n * - Registers the plugin in nx.json\n * - Adds architecture validation to targetDefaults (runs once before all builds)\n * - Creates architecture/ directory if needed\n * - Adds madge as a devDependency (required for circular dep checking)\n * - Adds convenient npm scripts to package.json\n * - Always creates eslint.webpieces.config.mjs with @webpieces rules\n * - Creates eslint.config.mjs (if not exists) that imports eslint.webpieces.config.mjs\n * - If eslint.config.mjs exists, shows user how to import eslint.webpieces.config.mjs\n * - Provides helpful output about available targets\n */\nexport default async function initGenerator(tree: Tree, options: InitGeneratorSchema) {\n    registerPlugin(tree);\n    addTargetDefaults(tree);\n    const installTask = addMadgeDependency(tree);\n    createArchitectureDirectory(tree);\n    addNpmScripts(tree);\n    const hasExistingEslintConfig = createEslintConfig(tree);\n\n    if (!options.skipFormat) {\n        await formatFiles(tree);\n    }\n\n    return createSuccessCallback(installTask, hasExistingEslintConfig);\n}\n\nfunction registerPlugin(tree: Tree): void {\n    const nxJson = readNxJson(tree);\n    if (!nxJson) {\n        throw new Error('Could not read nx.json. Are you in an Nx workspace?');\n    }\n\n    if (!nxJson.plugins) {\n        nxJson.plugins = [];\n    }\n\n    const pluginName = '@webpieces/dev-config';\n    const alreadyRegistered = nxJson.plugins.some(\n        (p) => typeof p === 'string' ? p === pluginName : p.plugin === pluginName\n    );\n\n    if (!alreadyRegistered) {\n        // Register plugin with default options for method size validation\n        nxJson.plugins.push({\n            plugin: pluginName,\n            options: {\n                workspace: {\n                    validations: {\n                        newMethodsMaxLines: 30,\n                        modifiedAndNewMethodsMaxLines: 80,\n                    },\n                },\n            },\n        });\n        updateNxJson(tree, nxJson);\n        console.log(`✅ Registered ${pluginName} plugin in nx.json with default options`);\n    } else {\n        console.log(`ℹ️  ${pluginName} plugin is already registered`);\n    }\n}\n\nfunction addTargetDefaults(tree: Tree): void {\n    const nxJson = readNxJson(tree);\n    if (!nxJson) {\n        throw new Error('Could not read nx.json. Are you in an Nx workspace?');\n    }\n\n    if (!nxJson.targetDefaults) {\n        nxJson.targetDefaults = {};\n    }\n\n    // Find which executors are actually used in this workspace\n    const usedExecutors = findUsedExecutors(tree);\n\n    // Only add targetDefaults for executors that are actually used\n    let updated = false;\n\n    usedExecutors.forEach((executor) => {\n        if (!nxJson.targetDefaults![executor]) {\n            nxJson.targetDefaults![executor] = {};\n        }\n\n        const targetDef = nxJson.targetDefaults![executor];\n        let dependsOn = targetDef.dependsOn || [];\n\n        // Ensure dependsOn is an array\n        if (!Array.isArray(dependsOn)) {\n            dependsOn = [dependsOn];\n        }\n\n        // Check if architecture validation is already in dependsOn\n        const hasArchValidation = dependsOn.some((dep) => {\n            if (typeof dep === 'string') {\n                return dep === 'architecture:validate-complete';\n            }\n            return dep.target === 'architecture:validate-complete';\n        });\n\n        // Check if circular deps validation is already in dependsOn\n        const hasCircularDepsValidation = dependsOn.some((dep) => {\n            if (typeof dep === 'string') {\n                return dep === 'validate-no-file-import-cycles';\n            }\n            return dep.target === 'validate-no-file-import-cycles';\n        });\n\n        if (!hasCircularDepsValidation) {\n            // Add circular deps validation (per-project check)\n            dependsOn.unshift('validate-no-file-import-cycles');\n            targetDef.dependsOn = dependsOn;\n            updated = true;\n            console.log(`  ✅ Added circular deps validation to ${executor}`);\n        }\n\n        if (!hasArchValidation) {\n            // Add architecture validation before other dependencies\n            dependsOn.unshift('architecture:validate-complete');\n            targetDef.dependsOn = dependsOn;\n            updated = true;\n            console.log(`  ✅ Added architecture validation to ${executor}`);\n        }\n    });\n\n    if (updated) {\n        updateNxJson(tree, nxJson);\n        console.log('✅ Added architecture validation to targetDefaults for used executors');\n    } else {\n        console.log('ℹ️  Architecture validation already configured in targetDefaults');\n    }\n}\n\n/**\n * Scan all project.json files to find which build executors are actually used\n */\nfunction findUsedExecutors(tree: Tree): Set<string> {\n    const usedExecutors = new Set<string>();\n\n    // Known build executors we care about\n    const buildExecutors = new Set([\n        '@nx/js:tsc',\n        '@nx/esbuild:esbuild',\n        '@nx/webpack:webpack',\n        '@nx/rollup:rollup',\n        '@nx/vite:build',\n        '@angular/build:application',\n        '@angular-devkit/build-angular:browser',\n        '@angular-devkit/build-angular:application'\n    ]);\n\n    // Scan all project.json files\n    tree.listChanges(); // Force tree to be aware of all files\n\n    const scanDir = (dir: string) => {\n        for (const child of tree.children(dir)) {\n            const childPath = dir === '.' ? child : `${dir}/${child}`;\n\n            if (tree.isFile(childPath)) {\n                if (child === 'project.json') {\n                    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- Intentionally ignoring JSON parse errors for malformed project.json files\n                    try {\n                        const content = tree.read(childPath, 'utf-8');\n                        if (content) {\n                            const projectJson = JSON.parse(content);\n                            if (projectJson.targets) {\n                                for (const target of Object.values(projectJson.targets)) {\n                                    const executor = (target as { executor?: string })?.executor;\n                                    if (executor && buildExecutors.has(executor)) {\n                                        usedExecutors.add(executor);\n                                    }\n                                }\n                            }\n                        }\n                    } catch (err: any) {\n                        //const error = toError(err);\n                    }\n                }\n            } else {\n                // Skip node_modules and dist\n                if (child !== 'node_modules' && child !== 'dist' && child !== '.git') {\n                    scanDir(childPath);\n                }\n            }\n        }\n    };\n\n    scanDir('.');\n\n    console.log(`ℹ️  Found ${usedExecutors.size} build executors in use: ${[...usedExecutors].join(', ')}`);\n\n    return usedExecutors;\n}\n\nfunction addMadgeDependency(tree: Tree) {\n    return addDependenciesToPackageJson(tree, {}, { 'madge': '^8.0.0' });\n}\n\nfunction createArchitectureDirectory(tree: Tree): void {\n    if (!tree.exists('architecture')) {\n        tree.write('architecture/.gitkeep', '');\n        console.log('✅ Created architecture/ directory');\n    }\n}\n\nfunction addNpmScripts(tree: Tree): void {\n    updateJson(tree, 'package.json', (pkgJson) => {\n        pkgJson.scripts = pkgJson.scripts ?? {};\n\n        // Add architecture validation scripts\n        pkgJson.scripts['arch:generate'] = 'nx run architecture:generate';\n        pkgJson.scripts['arch:visualize'] = 'nx run architecture:visualize';\n        pkgJson.scripts['arch:validate'] = 'nx run architecture:validate-no-architecture-cycles && nx run architecture:validate-no-skiplevel-deps';\n        pkgJson.scripts['arch:validate-all'] = 'nx run architecture:validate-no-architecture-cycles && nx run architecture:validate-no-skiplevel-deps && nx run architecture:validate-architecture-unchanged';\n\n        // Add file import cycle checking scripts\n        pkgJson.scripts['arch:check-circular'] = 'nx run-many --target=validate-no-file-import-cycles --all';\n        pkgJson.scripts['arch:check-circular-affected'] = 'nx affected --target=validate-no-file-import-cycles';\n\n        // Complete validation including circular deps\n        pkgJson.scripts['arch:validate-complete'] = 'npm run arch:validate-all && npm run arch:check-circular';\n\n        // Add CI script that runs lint, build, test on affected projects\n        pkgJson.scripts['webpieces:ci'] = 'npx nx affected --target=ci';\n\n        return pkgJson;\n    });\n\n    console.log('✅ Added npm scripts for architecture validation, circular dependency checking, and CI');\n}\n\nfunction createEslintConfig(tree: Tree): boolean {\n    const webpiecesConfigPath = 'eslint.webpieces.config.mjs';\n    const mainConfigPath = 'eslint.config.mjs';\n\n    // Always create eslint.webpieces.config.mjs with our rules\n    createWebpiecesEslintConfig(tree, webpiecesConfigPath);\n\n    // Check if main eslint.config.mjs exists\n    const hasExistingConfig = tree.exists(mainConfigPath);\n\n    if (!hasExistingConfig) {\n        // No existing config - create one that imports webpieces config\n        const mainConfig = `// ESLint configuration\n// Imports @webpieces/dev-config rules\n\nimport webpiecesConfig from './eslint.webpieces.config.mjs';\n\n// Export the webpieces configuration\n// You can add your own rules after spreading webpiecesConfig\nexport default [\n    ...webpiecesConfig,\n    // Add your custom ESLint configuration here\n];\n`;\n\n        tree.write(mainConfigPath, mainConfig);\n        console.log('✅ Created eslint.config.mjs with @webpieces/dev-config rules');\n    }\n\n    return hasExistingConfig;\n}\n\nfunction getWebpiecesEslintConfigTemplate(tree: Tree): string {\n    // Read from canonical template file (single source of truth)\n    const templatePath = 'node_modules/@webpieces/dev-config/templates/eslint.webpieces.config.mjs';\n    const template = tree.read(templatePath, 'utf-8');\n\n    if (!template) {\n        throw new Error(`Could not read ESLint template from ${templatePath}`);\n    }\n\n    return template;\n}\n\nfunction warnConfigChanges(tree: Tree, configPath: string, newConfig: string): void {\n    const version = getPackageVersion(tree);\n    const versionedFilename = `${configPath}.v${version}`;\n\n    tree.write(versionedFilename, newConfig);\n\n    console.log('');\n    console.log(`⚠️  ${configPath} has changes`);\n    console.log('');\n    console.log('   Either you modified the file OR @webpieces/dev-config has updates.');\n    console.log('');\n    console.log(`   Created: ${versionedFilename} with latest version`);\n    console.log('');\n    console.log('   Please review and merge if needed:');\n    console.log(`     - Your current: ${configPath}`);\n    console.log(`     - New version:  ${versionedFilename}`);\n    console.log('');\n}\n\nfunction createWebpiecesEslintConfig(tree: Tree, configPath: string): void {\n    const webpiecesConfig = getWebpiecesEslintConfigTemplate(tree);\n\n    if (!tree.exists(configPath)) {\n        tree.write(configPath, webpiecesConfig);\n        console.log(`✅ Created ${configPath}`);\n        return;\n    }\n\n    const currentContent = tree.read(configPath, 'utf-8');\n    if (!currentContent) {\n        tree.write(configPath, webpiecesConfig);\n        console.log(`✅ Created ${configPath}`);\n        return;\n    }\n\n    const currentHash = calculateHash(currentContent);\n    const newHash = calculateHash(webpiecesConfig);\n\n    if (currentHash === newHash) {\n        console.log(`✅ ${configPath} is up to date`);\n        return;\n    }\n\n    warnConfigChanges(tree, configPath, webpiecesConfig);\n}\n\nfunction createSuccessCallback(\n    installTask: ReturnType<typeof addDependenciesToPackageJson>,\n    hasExistingEslintConfig: boolean\n) {\n    return async () => {\n        await installTask();\n\n        // ANSI color codes for formatted output\n        const GREEN = '\\x1b[32m\\x1b[1m';\n        const BOLD = '\\x1b[1m';\n        const RESET = '\\x1b[0m';\n\n        console.log('');\n        console.log('✅ Added madge to devDependencies');\n        console.log('');\n        console.log(`${GREEN}✅ @webpieces/dev-config plugin initialized!${RESET}`);\n        console.log('');\n        console.log(`${GREEN}💡 Quick start:${RESET}`);\n        console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the dependency graph`);\n        console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);\n        console.log('');\n        console.log(`💡 For full documentation, run: ${BOLD}nx run architecture:help${RESET}`);\n\n        // Show ESLint integration instructions if they have an existing config\n        if (hasExistingEslintConfig) {\n            console.log('');\n            console.log('📋 Existing eslint.config.mjs detected');\n            console.log('');\n            console.log('To use @webpieces/dev-config ESLint rules, add this import to your eslint.config.mjs:');\n            console.log('');\n            console.log('  import webpiecesConfig from \\'./eslint.webpieces.config.mjs\\';');\n            console.log('');\n            console.log('Then spread it into your config array:');\n            console.log('');\n            console.log('  export default [');\n            console.log('    ...webpiecesConfig,  // Add this line');\n            console.log('    // ... your existing config');\n            console.log('  ];');\n        }\n\n        console.log('');\n    };\n}\n"]}

package/templates/eslint.webpieces.config.mjs

@@ -21,8 +21,8 @@ export default [
         rules: {
             '@webpieces/catch-error-pattern': 'error',
             '@webpieces/no-unmanaged-exceptions': 'error',
-            '@webpieces/max-method-lines': ['error', { max: 70 }],
-            '@webpieces/max-file-lines': ['error', { max: 700 }],
+            // '@webpieces/max-method-lines': ['error', { max: 70 }],
+            // '@webpieces/max-file-lines': ['error', { max: 700 }],
             '@webpieces/enforce-architecture': 'error',
         },
     },

package/executors/validate-versions/executor.d.ts

@@ -1,16 +0,0 @@
-/**
- * Validate Versions Executor
- *
- * Validates package.json versions and checks npm ci compatibility.
- * This catches peer dependency conflicts that npm ci catches but npm install doesn't.
- *
- * Usage:
- * nx run dev-config:validate-versions
- */
-import type { ExecutorContext } from '@nx/devkit';
-export interface ValidateVersionsOptions {
-}
-export interface ExecutorResult {
-    success: boolean;
-}
-export default function runExecutor(_options: ValidateVersionsOptions, context: ExecutorContext): Promise<ExecutorResult>;