@webpieces/dev-config 0.2.25 → 0.2.27

package/executors/help/executor.d.ts

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

package/executors/help/executor.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = helpExecutor;
+async function helpExecutor(options, context) {
+    // ANSI color codes
+    const GREEN = '\x1b[32m\x1b[1m';
+    const BOLD = '\x1b[1m';
+    const RESET = '\x1b[0m';
+    console.log('');
+    console.log(`${GREEN}💡 @webpieces/dev-config - Available Commands${RESET}`);
+    console.log('');
+    console.log(`${BOLD}📝 Available npm scripts (convenient shortcuts):${RESET}`);
+    console.log('');
+    console.log('  Architecture graph:');
+    console.log('    npm run arch:generate                  # Generate dependency graph');
+    console.log('    npm run arch:visualize                 # Visualize dependency graph');
+    console.log('');
+    console.log('  Validation:');
+    console.log('    npm run arch:validate                  # Quick validation (no-cycles + no-skiplevel-deps)');
+    console.log('    npm run arch:validate-all              # Full arch validation (+ unchanged check)');
+    console.log('    npm run arch:check-circular            # Check all projects for circular deps');
+    console.log('    npm run arch:check-circular-affected   # Check affected projects only');
+    console.log('    npm run arch:validate-complete         # Complete validation (arch + circular)');
+    console.log('');
+    console.log(`${BOLD}📝 Available Nx targets:${RESET}`);
+    console.log('');
+    console.log('  Workspace-level architecture validation:');
+    console.log('    nx run .:arch:generate                         # Generate dependency graph');
+    console.log('    nx run .:arch:visualize                        # Visualize dependency graph');
+    console.log('    nx run .:arch:validate-no-cycles               # Check for circular dependencies');
+    console.log('    nx run .:arch:validate-no-skiplevel-deps       # Check for redundant dependencies');
+    console.log('    nx run .:arch:validate-architecture-unchanged  # Validate against blessed graph');
+    console.log('');
+    console.log('  Per-project circular dependency checking:');
+    console.log('    nx run <project>:check-circular-deps           # Check project for circular deps');
+    console.log('    nx affected --target=check-circular-deps       # Check all affected projects');
+    console.log('    nx run-many --target=check-circular-deps --all # Check all projects');
+    console.log('');
+    console.log(`${GREEN}💡 Quick start:${RESET}`);
+    console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the graph first`);
+    console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);
+    console.log('');
+    return { success: true };
+}
+//# sourceMappingURL=executor.js.map

package/executors/help/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../packages/tooling/dev-config/executors/help/executor.ts"],"names":[],"mappings":";;AAIA,+BA6CC;AA7Cc,KAAK,UAAU,YAAY,CACtC,OAA4B,EAC5B,OAAwB;IAExB,mBAAmB;IACnB,MAAM,KAAK,GAAG,iBAAiB,CAAC;IAChC,MAAM,IAAI,GAAG,SAAS,CAAC;IACvB,MAAM,KAAK,GAAG,SAAS,CAAC;IAExB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,gDAAgD,KAAK,EAAE,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,mDAAmD,KAAK,EAAE,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC;IACvF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,+FAA+F,CAAC,CAAC;IAC7G,OAAO,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;IACjG,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;IAC/F,OAAO,CAAC,GAAG,CAAC,sFAAsF,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,qFAAqF,CAAC,CAAC;IACnG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,sFAAsF,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;IAChG,OAAO,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC;IACvF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,kBAAkB,KAAK,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,wBAAwB,KAAK,uCAAuC,CAAC,CAAC;IAC5F,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,iCAAiC,KAAK,6BAA6B,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\n\nexport interface HelpExecutorOptions {}\n\nexport default async function helpExecutor(\n    options: HelpExecutorOptions,\n    context: ExecutorContext\n): Promise<{ success: true }> {\n    // ANSI color codes\n    const GREEN = '\\x1b[32m\\x1b[1m';\n    const BOLD = '\\x1b[1m';\n    const RESET = '\\x1b[0m';\n\n    console.log('');\n    console.log(`${GREEN}💡 @webpieces/dev-config - Available Commands${RESET}`);\n    console.log('');\n    console.log(`${BOLD}📝 Available npm scripts (convenient shortcuts):${RESET}`);\n    console.log('');\n    console.log('  Architecture graph:');\n    console.log('    npm run arch:generate                  # Generate dependency graph');\n    console.log('    npm run arch:visualize                 # Visualize dependency graph');\n    console.log('');\n    console.log('  Validation:');\n    console.log('    npm run arch:validate                  # Quick validation (no-cycles + no-skiplevel-deps)');\n    console.log('    npm run arch:validate-all              # Full arch validation (+ unchanged check)');\n    console.log('    npm run arch:check-circular            # Check all projects for circular deps');\n    console.log('    npm run arch:check-circular-affected   # Check affected projects only');\n    console.log('    npm run arch:validate-complete         # Complete validation (arch + circular)');\n    console.log('');\n    console.log(`${BOLD}📝 Available Nx targets:${RESET}`);\n    console.log('');\n    console.log('  Workspace-level architecture validation:');\n    console.log('    nx run .:arch:generate                         # Generate dependency graph');\n    console.log('    nx run .:arch:visualize                        # Visualize dependency graph');\n    console.log('    nx run .:arch:validate-no-cycles               # Check for circular dependencies');\n    console.log('    nx run .:arch:validate-no-skiplevel-deps       # Check for redundant dependencies');\n    console.log('    nx run .:arch:validate-architecture-unchanged  # Validate against blessed graph');\n    console.log('');\n    console.log('  Per-project circular dependency checking:');\n    console.log('    nx run <project>:check-circular-deps           # Check project for circular deps');\n    console.log('    nx affected --target=check-circular-deps       # Check all affected projects');\n    console.log('    nx run-many --target=check-circular-deps --all # Check all projects');\n    console.log('');\n    console.log(`${GREEN}💡 Quick start:${RESET}`);\n    console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the graph first`);\n    console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);\n    console.log('');\n\n    return { success: true };\n}\n"]}

package/executors/help/executor.ts

@@ -0,0 +1,50 @@
+import type { ExecutorContext } from '@nx/devkit';
+
+export interface HelpExecutorOptions {}
+
+export default async function helpExecutor(
+    options: HelpExecutorOptions,
+    context: ExecutorContext
+): Promise<{ success: true }> {
+    // ANSI color codes
+    const GREEN = '\x1b[32m\x1b[1m';
+    const BOLD = '\x1b[1m';
+    const RESET = '\x1b[0m';
+
+    console.log('');
+    console.log(`${GREEN}💡 @webpieces/dev-config - Available Commands${RESET}`);
+    console.log('');
+    console.log(`${BOLD}📝 Available npm scripts (convenient shortcuts):${RESET}`);
+    console.log('');
+    console.log('  Architecture graph:');
+    console.log('    npm run arch:generate                  # Generate dependency graph');
+    console.log('    npm run arch:visualize                 # Visualize dependency graph');
+    console.log('');
+    console.log('  Validation:');
+    console.log('    npm run arch:validate                  # Quick validation (no-cycles + no-skiplevel-deps)');
+    console.log('    npm run arch:validate-all              # Full arch validation (+ unchanged check)');
+    console.log('    npm run arch:check-circular            # Check all projects for circular deps');
+    console.log('    npm run arch:check-circular-affected   # Check affected projects only');
+    console.log('    npm run arch:validate-complete         # Complete validation (arch + circular)');
+    console.log('');
+    console.log(`${BOLD}📝 Available Nx targets:${RESET}`);
+    console.log('');
+    console.log('  Workspace-level architecture validation:');
+    console.log('    nx run .:arch:generate                         # Generate dependency graph');
+    console.log('    nx run .:arch:visualize                        # Visualize dependency graph');
+    console.log('    nx run .:arch:validate-no-cycles               # Check for circular dependencies');
+    console.log('    nx run .:arch:validate-no-skiplevel-deps       # Check for redundant dependencies');
+    console.log('    nx run .:arch:validate-architecture-unchanged  # Validate against blessed graph');
+    console.log('');
+    console.log('  Per-project circular dependency checking:');
+    console.log('    nx run <project>:check-circular-deps           # Check project for circular deps');
+    console.log('    nx affected --target=check-circular-deps       # Check all affected projects');
+    console.log('    nx run-many --target=check-circular-deps --all # Check all projects');
+    console.log('');
+    console.log(`${GREEN}💡 Quick start:${RESET}`);
+    console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the graph first`);
+    console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);
+    console.log('');
+
+    return { success: true };
+}

package/executors/help/schema.json

@@ -0,0 +1,7 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Help Executor",
+    "description": "Display help for @webpieces/dev-config commands and targets",
+    "type": "object",
+    "properties": {}
+}

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

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

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

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = validateEslintSyncExecutor;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const crypto_1 = require("crypto");
+function calculateHash(content) {
+    return (0, crypto_1.createHash)('sha256').update(content).digest('hex');
+}
+function normalizeContent(content) {
+    // Normalize line endings and trim whitespace
+    return content.replace(/\r\n/g, '\n').trim();
+}
+async function validateEslintSyncExecutor(options, context) {
+    const workspaceRoot = context.root;
+    const templatePath = (0, path_1.join)(workspaceRoot, 'packages/tooling/dev-config/templates/eslint.webpieces.config.mjs');
+    const workspacePath = (0, path_1.join)(workspaceRoot, 'eslint.webpieces.config.mjs');
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        const templateContent = (0, fs_1.readFileSync)(templatePath, 'utf-8');
+        const workspaceContent = (0, fs_1.readFileSync)(workspacePath, 'utf-8');
+        const templateRules = extractRulesSection(templateContent);
+        const workspaceRules = extractRulesSection(workspaceContent);
+        const templateHash = calculateHash(normalizeContent(templateRules));
+        const workspaceHash = calculateHash(normalizeContent(workspaceRules));
+        if (templateHash !== workspaceHash) {
+            printValidationError(templatePath, workspacePath);
+            return { success: false };
+        }
+        console.log('✅ ESLint configuration sync validated - rules match!');
+        return { success: true };
+    }
+    catch (err) {
+        // Error occurred during validation - log and fail
+        // eslint-disable-next-line @webpieces/catch-error-pattern
+        console.error('❌ Error validating ESLint sync:', err);
+        return { success: false };
+    }
+}
+function printValidationError(templatePath, workspacePath) {
+    console.error('');
+    console.error('❌ ESLint configuration sync validation FAILED');
+    console.error('');
+    console.error('The @webpieces ESLint rules must be identical in both files:');
+    console.error(`  1. ${templatePath}`);
+    console.error(`  2. ${workspacePath}`);
+    console.error('');
+    console.error('These files must have identical rules sections so that:');
+    console.error('  - External clients get the same rules we use internally');
+    console.error('  - We "eat our own dog food" - same rules for everyone');
+    console.error('');
+    console.error('To fix:');
+    console.error('  1. Modify the rules in ONE file (recommend: templates/eslint.webpieces.config.mjs)');
+    console.error('  2. Copy the rules section to the other file');
+    console.error('  3. Keep import statements different (template uses npm, workspace uses loadWorkspaceRules)');
+    console.error('');
+    console.error('Customization for webpieces workspace goes in: eslint.config.mjs');
+    console.error('');
+}
+function extractRulesSection(content) {
+    // Extract everything between "export default [" and the final "];"
+    // This includes the rules configuration
+    const match = content.match(/export default \[([\s\S]*)\];/);
+    if (!match) {
+        throw new Error('Could not extract rules section - export default not found');
+    }
+    return match[1].trim();
+}
+//# sourceMappingURL=executor.js.map

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

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

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

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

package/executors/validate-eslint-sync/schema.json

@@ -0,0 +1,7 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate ESLint Sync Executor",
+    "description": "Validates that workspace and template eslint.webpieces.config.mjs files have identical rules",
+    "type": "object",
+    "properties": {}
+}

package/executors.json

@@ -24,6 +24,16 @@
             "implementation": "./architecture/executors/validate-no-skiplevel-deps/executor",
             "schema": "./architecture/executors/validate-no-skiplevel-deps/schema.json",
             "description": "Validate no project has redundant transitive dependencies"
+        },
+        "help": {
+            "implementation": "./executors/help/executor",
+            "schema": "./executors/help/schema.json",
+            "description": "Display help for @webpieces/dev-config commands and targets"
+        },
+        "validate-eslint-sync": {
+            "implementation": "./executors/validate-eslint-sync/executor",
+            "schema": "./executors/validate-eslint-sync/schema.json",
+            "description": "Validate that workspace and template eslint.webpieces.config.mjs files have identical rules"
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/dev-config",
-  "version": "0.2.25",
+  "version": "0.2.27",
   "description": "Development configuration, scripts, and patterns for WebPieces projects",
   "type": "commonjs",
   "bin": {
@@ -34,6 +34,8 @@
     "plugins/**/*",
     "plugin/**/*",
     "plugin.js",
+    "templates/**/*",
+    "executors/**/*",
     "src/**/*",
     "generators.json",
     "architecture/**/*",

package/src/generators/init/generator.js

@@ -2,6 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = initGenerator;
 const devkit_1 = require("@nx/devkit");
+const crypto_1 = require("crypto");
+function calculateHash(content) {
+    return (0, crypto_1.createHash)('sha256').update(content).digest('hex');
+}
+function getPackageVersion(tree) {
+    const content = tree.read('node_modules/@webpieces/dev-config/package.json', 'utf-8');
+    if (!content) {
+        throw new Error('Could not read package.json from node_modules/@webpieces/dev-config');
+    }
+    const pkgJson = JSON.parse(content);
+    return pkgJson.version;
+}
 /**
  * Init generator for @webpieces/dev-config
  *
@@ -114,107 +126,70 @@ export default [
         console.log('✅ Created eslint.config.mjs with @webpieces/dev-config rules');
     }
 }
+function getWebpiecesEslintConfigTemplate(tree) {
+    // Read from canonical template file (single source of truth)
+    const templatePath = 'node_modules/@webpieces/dev-config/templates/eslint.webpieces.config.mjs';
+    const template = tree.read(templatePath, 'utf-8');
+    if (!template) {
+        throw new Error(`Could not read ESLint template from ${templatePath}`);
+    }
+    return template;
+}
+function warnConfigChanges(tree, configPath, newConfig) {
+    const version = getPackageVersion(tree);
+    const versionedFilename = `${configPath}.v${version}`;
+    tree.write(versionedFilename, newConfig);
+    console.log('');
+    console.log(`⚠️  ${configPath} has changes`);
+    console.log('');
+    console.log('   Either you modified the file OR @webpieces/dev-config has updates.');
+    console.log('');
+    console.log(`   Created: ${versionedFilename} with latest version`);
+    console.log('');
+    console.log('   Please review and merge if needed:');
+    console.log(`     - Your current: ${configPath}`);
+    console.log(`     - New version:  ${versionedFilename}`);
+    console.log('');
+}
 function createWebpiecesEslintConfig(tree, configPath) {
-    const webpiecesConfig = `// @webpieces/dev-config ESLint rules
-// This file contains the ESLint configuration provided by @webpieces/dev-config
-// You can modify or remove rules as needed for your project
-
-import webpiecesPlugin from '@webpieces/dev-config/eslint-plugin';
-import tseslint from '@typescript-eslint/eslint-plugin';
-import tsparser from '@typescript-eslint/parser';
-
-export default [
-    {
-        ignores: ['**/dist', '**/node_modules', '**/coverage', '**/.nx'],
-    },
-    {
-        files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
-        plugins: {
-            '@webpieces': webpiecesPlugin,
-            '@typescript-eslint': tseslint,
-        },
-        languageOptions: {
-            parser: tsparser,
-            ecmaVersion: 2021,
-            sourceType: 'module',
-        },
-        rules: {
-            // WebPieces custom 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/enforce-architecture': 'error',
-
-            // TypeScript rules
-            '@typescript-eslint/no-explicit-any': 'off',
-            '@typescript-eslint/explicit-function-return-type': 'off',
-            '@typescript-eslint/no-unused-vars': 'off',
-            '@typescript-eslint/no-empty-interface': 'off',
-            '@typescript-eslint/no-empty-function': 'off',
-
-            // General code quality
-            'no-console': 'off',
-            'no-debugger': 'off',
-            'no-var': 'error',
-            'prefer-const': 'off',
-        },
-    },
-    {
-        // Test files - relaxed rules
-        files: ['**/*.spec.ts', '**/*.test.ts'],
-        rules: {
-            '@typescript-eslint/no-explicit-any': 'off',
-            '@typescript-eslint/no-non-null-assertion': 'off',
-            '@webpieces/max-method-lines': 'off',
-        },
-    },
-];
-`;
-    tree.write(configPath, webpiecesConfig);
-    console.log('✅ Created eslint.webpieces.config.mjs with @webpieces/dev-config rules');
+    const webpiecesConfig = getWebpiecesEslintConfigTemplate(tree);
+    if (!tree.exists(configPath)) {
+        tree.write(configPath, webpiecesConfig);
+        console.log(`✅ Created ${configPath}`);
+        return;
+    }
+    const currentContent = tree.read(configPath, 'utf-8');
+    if (!currentContent) {
+        tree.write(configPath, webpiecesConfig);
+        console.log(`✅ Created ${configPath}`);
+        return;
+    }
+    const currentHash = calculateHash(currentContent);
+    const newHash = calculateHash(webpiecesConfig);
+    if (currentHash === newHash) {
+        console.log(`✅ ${configPath} is up to date`);
+        return;
+    }
+    warnConfigChanges(tree, configPath, webpiecesConfig);
 }
 function createSuccessCallback(installTask) {
     return async () => {
         await installTask();
+        // ANSI color codes for formatted output
+        const GREEN = '\x1b[32m\x1b[1m';
+        const BOLD = '\x1b[1m';
+        const RESET = '\x1b[0m';
+        console.log('');
         console.log('✅ Added madge to devDependencies');
         console.log('');
-        console.log('✅ @webpieces/dev-config plugin initialized!');
+        console.log(`${GREEN}✅ @webpieces/dev-config plugin initialized!${RESET}`);
+        console.log('');
+        console.log(`${GREEN}💡 Quick start:${RESET}`);
+        console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the dependency graph`);
+        console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);
+        console.log('');
+        console.log(`💡 For full documentation, run: ${BOLD}nx run .:webpieces:help${RESET}`);
         console.log('');
-        printAvailableTargets();
     };
 }
-function printAvailableTargets() {
-    console.log('📝 Available npm scripts (convenient shortcuts):');
-    console.log('');
-    console.log('  Architecture graph:');
-    console.log('    npm run arch:generate                  # Generate dependency graph');
-    console.log('    npm run arch:visualize                 # Visualize dependency graph');
-    console.log('');
-    console.log('  Validation:');
-    console.log('    npm run arch:validate                  # Quick validation (no-cycles + no-skiplevel-deps)');
-    console.log('    npm run arch:validate-all              # Full arch validation (+ unchanged check)');
-    console.log('    npm run arch:check-circular            # Check all projects for circular deps');
-    console.log('    npm run arch:check-circular-affected   # Check affected projects only');
-    console.log('    npm run arch:validate-complete         # Complete validation (arch + circular)');
-    console.log('');
-    console.log('📝 Available Nx targets:');
-    console.log('');
-    console.log('  Workspace-level architecture validation:');
-    console.log('    nx run .:arch:generate                         # Generate dependency graph');
-    console.log('    nx run .:arch:visualize                        # Visualize dependency graph');
-    console.log('    nx run .:arch:validate-no-cycles               # Check for circular dependencies');
-    console.log('    nx run .:arch:validate-no-skiplevel-deps       # Check for redundant dependencies');
-    console.log('    nx run .:arch:validate-architecture-unchanged  # Validate against blessed graph');
-    console.log('');
-    console.log('  Per-project circular dependency checking:');
-    console.log('    nx run <project>:check-circular-deps           # Check project for circular deps');
-    console.log('    nx affected --target=check-circular-deps       # Check all affected projects');
-    console.log('    nx run-many --target=check-circular-deps --all # Check all projects');
-    console.log('');
-    console.log('💡 Quick start:');
-    console.log('   npm run arch:generate           # Generate the graph first');
-    console.log('   npm run arch:validate-complete  # Run complete validation');
-    console.log('');
-}
 //# sourceMappingURL=generator.js.map

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';\n\nexport interface InitGeneratorSchema {\n    skipFormat?: boolean;\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 * - 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    const installTask = addMadgeDependency(tree);\n    createArchitectureDirectory(tree);\n    addNpmScripts(tree);\n    createEslintConfig(tree);\n\n    if (!options.skipFormat) {\n        await formatFiles(tree);\n    }\n\n    return createSuccessCallback(installTask);\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 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 .:arch:generate';\n        pkgJson.scripts['arch:visualize'] = 'nx run .:arch:visualize';\n        pkgJson.scripts['arch:validate'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps';\n        pkgJson.scripts['arch:validate-all'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps && nx run .:arch:validate-architecture-unchanged';\n\n        // Add circular dependency checking scripts\n        pkgJson.scripts['arch:check-circular'] = 'nx run-many --target=check-circular-deps --all';\n        pkgJson.scripts['arch:check-circular-affected'] = 'nx affected --target=check-circular-deps';\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): void {\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    if (tree.exists(mainConfigPath)) {\n        // Existing config - show them how to import\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        console.log('');\n    } else {\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\nfunction createWebpiecesEslintConfig(tree: Tree, configPath: string): void {\n    const webpiecesConfig = `// @webpieces/dev-config ESLint rules\n// This file contains the ESLint configuration provided by @webpieces/dev-config\n// You can modify or remove rules as needed for your project\n\nimport webpiecesPlugin from '@webpieces/dev-config/eslint-plugin';\nimport tseslint from '@typescript-eslint/eslint-plugin';\nimport tsparser from '@typescript-eslint/parser';\n\nexport default [\n    {\n        ignores: ['**/dist', '**/node_modules', '**/coverage', '**/.nx'],\n    },\n    {\n        files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],\n        plugins: {\n            '@webpieces': webpiecesPlugin,\n            '@typescript-eslint': tseslint,\n        },\n        languageOptions: {\n            parser: tsparser,\n            ecmaVersion: 2021,\n            sourceType: 'module',\n        },\n        rules: {\n            // WebPieces custom rules\n            '@webpieces/catch-error-pattern': 'error',\n            '@webpieces/no-unmanaged-exceptions': 'error',\n            '@webpieces/max-method-lines': ['error', { max: 70 }],\n            '@webpieces/max-file-lines': ['error', { max: 700 }],\n            '@webpieces/enforce-architecture': 'error',\n\n            // TypeScript rules\n            '@typescript-eslint/no-explicit-any': 'off',\n            '@typescript-eslint/explicit-function-return-type': 'off',\n            '@typescript-eslint/no-unused-vars': 'off',\n            '@typescript-eslint/no-empty-interface': 'off',\n            '@typescript-eslint/no-empty-function': 'off',\n\n            // General code quality\n            'no-console': 'off',\n            'no-debugger': 'off',\n            'no-var': 'error',\n            'prefer-const': 'off',\n        },\n    },\n    {\n        // Test files - relaxed rules\n        files: ['**/*.spec.ts', '**/*.test.ts'],\n        rules: {\n            '@typescript-eslint/no-explicit-any': 'off',\n            '@typescript-eslint/no-non-null-assertion': 'off',\n            '@webpieces/max-method-lines': 'off',\n        },\n    },\n];\n`;\n\n    tree.write(configPath, webpiecesConfig);\n    console.log('✅ Created eslint.webpieces.config.mjs with @webpieces/dev-config rules');\n}\n\nfunction createSuccessCallback(installTask: ReturnType<typeof addDependenciesToPackageJson>) {\n    return async () => {\n        await installTask();\n        console.log('✅ Added madge to devDependencies');\n        console.log('');\n        console.log('✅ @webpieces/dev-config plugin initialized!');\n        console.log('');\n        printAvailableTargets();\n    };\n}\n\nfunction printAvailableTargets(): void {\n    console.log('📝 Available npm scripts (convenient shortcuts):');\n    console.log('');\n    console.log('  Architecture graph:');\n    console.log('    npm run arch:generate                  # Generate dependency graph');\n    console.log('    npm run arch:visualize                 # Visualize dependency graph');\n    console.log('');\n    console.log('  Validation:');\n    console.log('    npm run arch:validate                  # Quick validation (no-cycles + no-skiplevel-deps)');\n    console.log('    npm run arch:validate-all              # Full arch validation (+ unchanged check)');\n    console.log('    npm run arch:check-circular            # Check all projects for circular deps');\n    console.log('    npm run arch:check-circular-affected   # Check affected projects only');\n    console.log('    npm run arch:validate-complete         # Complete validation (arch + circular)');\n    console.log('');\n    console.log('📝 Available Nx targets:');\n    console.log('');\n    console.log('  Workspace-level architecture validation:');\n    console.log('    nx run .:arch:generate                         # Generate dependency graph');\n    console.log('    nx run .:arch:visualize                        # Visualize dependency graph');\n    console.log('    nx run .:arch:validate-no-cycles               # Check for circular dependencies');\n    console.log('    nx run .:arch:validate-no-skiplevel-deps       # Check for redundant dependencies');\n    console.log('    nx run .:arch:validate-architecture-unchanged  # Validate against blessed graph');\n    console.log('');\n    console.log('  Per-project circular dependency checking:');\n    console.log('    nx run <project>:check-circular-deps           # Check project for circular deps');\n    console.log('    nx affected --target=check-circular-deps       # Check all affected projects');\n    console.log('    nx run-many --target=check-circular-deps --all # Check all projects');\n    console.log('');\n    console.log('💡 Quick start:');\n    console.log('   npm run arch:generate           # Generate the graph first');\n    console.log('   npm run arch:validate-complete  # Run complete validation');\n    console.log('');\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 * - 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    const installTask = addMadgeDependency(tree);\n    createArchitectureDirectory(tree);\n    addNpmScripts(tree);\n    createEslintConfig(tree);\n\n    if (!options.skipFormat) {\n        await formatFiles(tree);\n    }\n\n    return createSuccessCallback(installTask);\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 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 .:arch:generate';\n        pkgJson.scripts['arch:visualize'] = 'nx run .:arch:visualize';\n        pkgJson.scripts['arch:validate'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps';\n        pkgJson.scripts['arch:validate-all'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps && nx run .:arch:validate-architecture-unchanged';\n\n        // Add circular dependency checking scripts\n        pkgJson.scripts['arch:check-circular'] = 'nx run-many --target=check-circular-deps --all';\n        pkgJson.scripts['arch:check-circular-affected'] = 'nx affected --target=check-circular-deps';\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): void {\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    if (tree.exists(mainConfigPath)) {\n        // Existing config - show them how to import\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        console.log('');\n    } else {\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\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(installTask: ReturnType<typeof addDependenciesToPackageJson>) {\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 .:webpieces:help${RESET}`);\n        console.log('');\n    };\n}\n"]}

package/templates/eslint.webpieces.config.mjs

@@ -0,0 +1,29 @@
+// @webpieces/dev-config ESLint Configuration
+// This is the canonical template for external clients
+//
+// IMPORTANT: When modifying rules here, also update:
+// - /eslint.webpieces.config.mjs (webpieces workspace version with loadWorkspaceRules)
+//
+// Only includes @webpieces custom rules
+// Configure your own TypeScript and general rules in your main eslint.config.mjs as needed
+
+import webpiecesPlugin from '@webpieces/dev-config/eslint-plugin';
+
+export default [
+    {
+        ignores: ['**/dist', '**/node_modules', '**/coverage', '**/.nx'],
+    },
+    {
+        files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+        plugins: {
+            '@webpieces': webpiecesPlugin,
+        },
+        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/enforce-architecture': 'error',
+        },
+    },
+];