@webpieces/dev-config 0.2.95 → 0.2.97

package/config/eslint/base.mjs

@@ -1,7 +1,7 @@
 // @webpieces/dev-config base ESLint configuration
 // Consumer projects can extend this configuration
 
-import webpiecesPlugin from '../../eslint-plugin/index.js';
+import webpiecesPlugin from '@webpieces/eslint-plugin';
 
 /**
  * WebPieces base ESLint configuration using flat config format.

package/executors.json

@@ -1,104 +1,19 @@
 {
     "executors": {
-        "generate": {
-            "implementation": "./architecture/executors/generate/executor",
-            "schema": "./architecture/executors/generate/schema.json",
-            "description": "Generate the architecture dependency graph and save it"
-        },
-        "visualize": {
-            "implementation": "./architecture/executors/visualize/executor",
-            "schema": "./architecture/executors/visualize/schema.json",
-            "description": "Generate visual representations of the architecture graph"
-        },
-        "validate-no-architecture-cycles": {
-            "implementation": "./architecture/executors/validate-no-architecture-cycles/executor",
-            "schema": "./architecture/executors/validate-no-architecture-cycles/schema.json",
-            "description": "Validate the architecture graph has no circular project dependencies"
-        },
-        "validate-architecture-unchanged": {
-            "implementation": "./architecture/executors/validate-architecture-unchanged/executor",
-            "schema": "./architecture/executors/validate-architecture-unchanged/schema.json",
-            "description": "Validate the architecture graph matches the saved blessed graph"
-        },
-        "validate-no-skiplevel-deps": {
-            "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"
-        },
-        "validate-packagejson": {
-            "implementation": "./architecture/executors/validate-packagejson/executor",
-            "schema": "./architecture/executors/validate-packagejson/schema.json",
-            "description": "Validate package.json dependencies match project.json build dependencies"
-        },
-        "validate-new-methods": {
-            "implementation": "./architecture/executors/validate-new-methods/executor",
-            "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",
+            "implementation": "./src/executors/help/executor",
+            "schema": "./src/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",
+            "implementation": "./src/executors/validate-eslint-sync/executor",
+            "schema": "./src/executors/validate-eslint-sync/schema.json",
             "description": "Validate that workspace and template eslint.webpieces.config.mjs files have identical rules"
         },
         "validate-versions-locked": {
-            "implementation": "./executors/validate-versions-locked/executor",
-            "schema": "./executors/validate-versions-locked/schema.json",
+            "implementation": "./src/executors/validate-versions-locked/executor",
+            "schema": "./src/executors/validate-versions-locked/schema.json",
             "description": "Validate package.json versions are locked (no semver ranges) and npm ci compatible"
-        },
-        "validate-modified-files": {
-            "implementation": "./architecture/executors/validate-modified-files/executor",
-            "schema": "./architecture/executors/validate-modified-files/schema.json",
-            "description": "Validate modified files don't exceed max line count"
-        },
-        "validate-code": {
-            "implementation": "./architecture/executors/validate-code/executor",
-            "schema": "./architecture/executors/validate-code/schema.json",
-            "description": "Combined validation for new methods, modified methods, and file sizes"
-        },
-        "validate-return-types": {
-            "implementation": "./architecture/executors/validate-return-types/executor",
-            "schema": "./architecture/executors/validate-return-types/schema.json",
-            "description": "Validate methods have explicit return type annotations"
-        },
-        "validate-no-inline-types": {
-            "implementation": "./architecture/executors/validate-no-inline-types/executor",
-            "schema": "./architecture/executors/validate-no-inline-types/schema.json",
-            "description": "Validate no inline type literals are used - prefer named types"
-        },
-        "validate-no-any-unknown": {
-            "implementation": "./architecture/executors/validate-no-any-unknown/executor",
-            "schema": "./architecture/executors/validate-no-any-unknown/schema.json",
-            "description": "Validate no any/unknown keywords are used - use specific types instead"
-        },
-        "validate-dtos": {
-            "implementation": "./architecture/executors/validate-dtos/executor",
-            "schema": "./architecture/executors/validate-dtos/schema.json",
-            "description": "Validate DTO fields match Prisma Dbo model fields"
-        },
-        "validate-prisma-converters": {
-            "implementation": "./architecture/executors/validate-prisma-converters/executor",
-            "schema": "./architecture/executors/validate-prisma-converters/schema.json",
-            "description": "Validate Prisma converter method patterns and Dto creation locations"
-        },
-        "validate-no-destructure": {
-            "implementation": "./architecture/executors/validate-no-destructure/executor",
-            "schema": "./architecture/executors/validate-no-destructure/schema.json",
-            "description": "Validate no destructuring patterns are used - use explicit property access instead"
-        },
-        "validate-no-direct-api-resolver": {
-            "implementation": "./architecture/executors/validate-no-direct-api-resolver/executor",
-            "schema": "./architecture/executors/validate-no-direct-api-resolver/schema.json",
-            "description": "Validate resolvers use services (not APIs) and components subscribe to observables (not route.snapshot.data)"
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/dev-config",
-  "version": "0.2.95",
+  "version": "0.2.97",
   "description": "Development configuration, scripts, and patterns for WebPieces projects",
   "type": "commonjs",
   "bin": {
@@ -17,43 +17,30 @@
     ".": "./src/index.js",
     "./package.json": "./package.json",
     "./eslint": "./config/eslint/base.mjs",
-    "./eslint-plugin": "./eslint-plugin/index.js",
     "./jest": "./config/jest/preset.js",
     "./tsconfig": "./config/typescript/tsconfig.base.json",
-    "./plugin": "./plugin.js",
-    "./plugins/circular-deps": "./plugins/circular-deps/index.js",
-    "./architecture": "./architecture/index.js",
+    "./plugin": "./src/plugin.js",
     "./executors.json": "./executors.json",
     "./generators.json": "./generators.json"
   },
   "files": [
     "bin/**/*",
     "config/**/*",
-    "eslint-plugin/**/*",
     "patterns/**/*",
-    "plugins/**/*",
-    "plugin/**/*",
-    "plugin.js",
     "templates/**/*",
-    "executors/**/*",
     "src/**/*",
     "generators.json",
-    "architecture/**/*",
     "executors.json",
     "README.md"
   ],
+  "dependencies": {
+    "@webpieces/eslint-plugin": "0.2.97",
+    "@webpieces/architecture-validators": "0.2.97"
+  },
   "peerDependencies": {
     "eslint": ">=8.0.0",
     "@nx/devkit": ">=18.0.0"
   },
-  "keywords": [
-    "webpieces",
-    "config",
-    "eslint",
-    "scripts",
-    "typescript",
-    "jest"
-  ],
   "author": "Dean Hiller",
   "license": "Apache-2.0",
   "repository": {

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/src/executors/help/executor.ts"],"names":[],"mappings":";;AAMA,+BAwDC;AAxDc,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,sFAAsF,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,oGAAoG,CAAC,CAAC;IAClH,OAAO,CAAC,GAAG,CAAC,6FAA6F,CAAC,CAAC;IAC3G,OAAO,CAAC,GAAG,CAAC,2FAA2F,CAAC,CAAC;IACzG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,sGAAsG,CAAC,CAAC;IACpH,OAAO,CAAC,GAAG,CAAC,6FAA6F,CAAC,CAAC;IAC3G,OAAO,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;IACpF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,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\ntype HelpExecutorResult = { success: true };\n\nexport default async function helpExecutor(\n    options: HelpExecutorOptions,\n    context: ExecutorContext\n): Promise<HelpExecutorResult> {\n    // ANSI color codes\n    const GREEN = '\\x1b[32m\\x1b[1m';\n    const BOLD = '\\x1b[1m';\n    const RESET = '\\x1b[0m';\n\n    console.log('');\n    console.log(`${GREEN}💡 @webpieces/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 architecture:generate                         # Generate dependency graph');\n    console.log('    nx run architecture:visualize                        # Visualize dependency graph');\n    console.log('    nx run architecture:validate-no-architecture-cycles  # Check for circular project dependencies');\n    console.log('    nx run architecture:validate-no-skiplevel-deps       # Check for redundant dependencies');\n    console.log('    nx run architecture:validate-architecture-unchanged  # Validate against blessed graph');\n    console.log('');\n    console.log('  Per-project file import cycle checking:');\n    console.log('    nx run <project>:validate-no-file-import-cycles           # Check project for file import cycles');\n    console.log('    nx affected --target=validate-no-file-import-cycles       # Check all affected projects');\n    console.log('    nx run-many --target=validate-no-file-import-cycles --all # Check all projects');\n    console.log('');\n    console.log('  Per-project CI target (lint + build + test):');\n    console.log('    nx run <project>:ci                    # Run lint, build, test together');\n    console.log('    nx run-many --target=ci --all          # Run ci for all projects');\n    console.log('');\n    console.log('    Execution order (test waits for build via targetDefaults):');\n    console.log('    ci (nx:noop)');\n    console.log('    ├── lint ─────────────────┐');\n    console.log('    ├── build ────────────────┼── run in parallel');\n    console.log('    └── test ─────────────────┘');\n    console.log('        └── depends on build (waits)');\n    console.log('');\n    console.log(`${GREEN}💡 Quick start:${RESET}`);\n    console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the graph first`);\n    console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);\n    console.log('');\n\n    return { success: true };\n}\n"]}

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/src/executors/validate-eslint-sync/executor.ts"],"names":[],"mappings":";;AAoBA,6CAkCC;AArDD,2BAAkC;AAClC,+BAA4B;AAC5B,mCAAoC;AAQpC,SAAS,aAAa,CAAC,OAAe;IAClC,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACrC,6CAA6C;IAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAEc,KAAK,UAAU,0BAA0B,CACpD,OAAkC,EAClC,OAAwB;IAExB,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnC,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,aAAa,EAAE,mEAAmE,CAAC,CAAC;IAC9G,MAAM,aAAa,GAAG,IAAA,WAAI,EAAC,aAAa,EAAE,6BAA6B,CAAC,CAAC;IAEzE,8DAA8D;IAC9D,IAAI,CAAC;QACD,MAAM,eAAe,GAAG,IAAA,iBAAY,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,gBAAgB,GAAG,IAAA,iBAAY,EAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAE9D,MAAM,aAAa,GAAG,mBAAmB,CAAC,eAAe,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;QAE7D,MAAM,YAAY,GAAG,aAAa,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;QACpE,MAAM,aAAa,GAAG,aAAa,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC;QAEtE,IAAI,YAAY,KAAK,aAAa,EAAE,CAAC;YACjC,oBAAoB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAE7B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,kDAAkD;QAClD,0DAA0D;QAC1D,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,YAAoB,EAAE,aAAqB;IACrE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC/D,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,QAAQ,YAAY,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,KAAK,CAAC,QAAQ,aAAa,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,CAAC,sFAAsF,CAAC,CAAC;IACtG,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC/D,OAAO,CAAC,KAAK,CAAC,8FAA8F,CAAC,CAAC;IAC9G,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAClF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IACxC,mEAAmE;IACnE,wCAAwC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { readFileSync } from 'fs';\nimport { join } from 'path';\nimport { createHash } from 'crypto';\n\nexport interface ValidateEslintSyncOptions {}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nfunction calculateHash(content: string): string {\n    return createHash('sha256').update(content).digest('hex');\n}\n\nfunction normalizeContent(content: string): string {\n    // Normalize line endings and trim whitespace\n    return content.replace(/\\r\\n/g, '\\n').trim();\n}\n\nexport default async function validateEslintSyncExecutor(\n    options: ValidateEslintSyncOptions,\n    context: ExecutorContext\n): Promise<ExecutorResult> {\n    const workspaceRoot = context.root;\n\n    const templatePath = join(workspaceRoot, 'packages/tooling/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: unknown) {\n        // Error occurred during validation - log and fail\n        // eslint-disable-next-line @webpieces/catch-error-pattern\n        console.error('❌ Error validating ESLint sync:', err);\n        return { success: false };\n    }\n}\n\nfunction printValidationError(templatePath: string, workspacePath: string): void {\n    console.error('');\n    console.error('❌ ESLint configuration sync validation FAILED');\n    console.error('');\n    console.error('The @webpieces ESLint rules must be identical in both files:');\n    console.error(`  1. ${templatePath}`);\n    console.error(`  2. ${workspacePath}`);\n    console.error('');\n    console.error('These files must have identical rules sections so that:');\n    console.error('  - External clients get the same rules we use internally');\n    console.error('  - We \"eat our own dog food\" - same rules for everyone');\n    console.error('');\n    console.error('To fix:');\n    console.error('  1. Modify the rules in ONE file (recommend: templates/eslint.webpieces.config.mjs)');\n    console.error('  2. Copy the rules section to the other file');\n    console.error('  3. Keep import statements different (template uses npm, workspace uses loadWorkspaceRules)');\n    console.error('');\n    console.error('Customization for webpieces workspace goes in: eslint.config.mjs');\n    console.error('');\n}\n\nfunction extractRulesSection(content: string): string {\n    // Extract everything between \"export default [\" and the final \"];\"\n    // This includes the rules configuration\n    const match = content.match(/export default \\[([\\s\\S]*)\\];/);\n    if (!match) {\n        throw new Error('Could not extract rules section - export default not found');\n    }\n\n    return match[1].trim();\n}\n"]}

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

@@ -277,7 +277,8 @@ async function runExecutor(_options, context) {
     console.log('\n🔒 Validating Package Versions are LOCKED and CONSISTENT\n');
     const workspaceRoot = context.root;
     // Step 1: Check for semver ranges (FAILS if any found)
-    const { errors: semverErrors } = checkSemverRanges(workspaceRoot);
+    const semverResult = checkSemverRanges(workspaceRoot);
+    const semverErrors = semverResult.errors;
     const packageFiles = findPackageJsonFiles(workspaceRoot);
     // Step 2: Check for version conflicts across package.json files
     const versionConflicts = checkVersionConflicts(workspaceRoot);

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

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

package/src/index.d.ts

@@ -29,6 +29,6 @@ export declare function getProjectRoot(): string;
  */
 declare const _default: {
     name: string;
-    createNodesV2: import("@nx/devkit").CreateNodesV2<import("../plugin").ArchitecturePluginOptions>;
+    createNodesV2: import("@nx/devkit").CreateNodesV2<import("./plugin").ArchitecturePluginOptions>;
 };
 export default _default;

package/src/index.js

@@ -18,7 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.packageName = exports.version = void 0;
 exports.isWebpiecesWorkspace = isWebpiecesWorkspace;
 exports.getProjectRoot = getProjectRoot;
-const plugin_1 = require("../plugin");
+const plugin_1 = require("./plugin");
 exports.version = '0.0.0-dev';
 exports.packageName = '@webpieces/dev-config';
 /**

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/dev-config/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAUH,oDAEC;AAKD,wCAGC;AAlBD,sCAA0C;AAE7B,QAAA,OAAO,GAAG,WAAW,CAAC;AACtB,QAAA,WAAW,GAAG,uBAAuB,CAAC;AAEnD;;GAEG;AACH,SAAgB,oBAAoB;IAChC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc;IAC1B,oEAAoE;IACpE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,kBAAe;IACX,IAAI,EAAE,uBAAuB;IAC7B,aAAa,EAAb,sBAAa;CAChB,CAAC","sourcesContent":["/**\n * @webpieces/dev-config\n *\n * Development configuration, scripts, and patterns for WebPieces projects.\n *\n * This package provides:\n * - Nx inference plugin for architecture validation and circular dependency checking\n * - Executable scripts (via bin commands: wp-start, wp-stop, etc.)\n * - Shareable ESLint configuration\n * - Jest preset\n * - Base TypeScript configuration\n * - Claude Code pattern documentation\n *\n * @packageDocumentation\n */\n\nimport { createNodesV2 } from '../plugin';\n\nexport const version = '0.0.0-dev';\nexport const packageName = '@webpieces/dev-config';\n\n/**\n * Check if running in webpieces-ts workspace\n */\nexport function isWebpiecesWorkspace(): boolean {\n    return process.cwd().includes('webpieces-ts');\n}\n\n/**\n * Get project root directory\n */\nexport function getProjectRoot(): string {\n    // This is a simple helper, actual path detection is in bash scripts\n    return process.cwd();\n}\n\n/**\n * Default export for Nx plugin system\n * This is what Nx loads when the package is registered as a plugin in nx.json\n */\nexport default {\n    name: '@webpieces/dev-config',\n    createNodesV2,\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/dev-config/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAUH,oDAEC;AAKD,wCAGC;AAlBD,qCAAyC;AAE5B,QAAA,OAAO,GAAG,WAAW,CAAC;AACtB,QAAA,WAAW,GAAG,uBAAuB,CAAC;AAEnD;;GAEG;AACH,SAAgB,oBAAoB;IAChC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc;IAC1B,oEAAoE;IACpE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,kBAAe;IACX,IAAI,EAAE,uBAAuB;IAC7B,aAAa,EAAb,sBAAa;CAChB,CAAC","sourcesContent":["/**\n * @webpieces/dev-config\n *\n * Development configuration, scripts, and patterns for WebPieces projects.\n *\n * This package provides:\n * - Nx inference plugin for architecture validation and circular dependency checking\n * - Executable scripts (via bin commands: wp-start, wp-stop, etc.)\n * - Shareable ESLint configuration\n * - Jest preset\n * - Base TypeScript configuration\n * - Claude Code pattern documentation\n *\n * @packageDocumentation\n */\n\nimport { createNodesV2 } from './plugin';\n\nexport const version = '0.0.0-dev';\nexport const packageName = '@webpieces/dev-config';\n\n/**\n * Check if running in webpieces-ts workspace\n */\nexport function isWebpiecesWorkspace(): boolean {\n    return process.cwd().includes('webpieces-ts');\n}\n\n/**\n * Get project root directory\n */\nexport function getProjectRoot(): string {\n    // This is a simple helper, actual path detection is in bash scripts\n    return process.cwd();\n}\n\n/**\n * Default export for Nx plugin system\n * This is what Nx loads when the package is registered as a plugin in nx.json\n */\nexport default {\n    name: '@webpieces/dev-config',\n    createNodesV2,\n};\n"]}

package/src/plugin.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Unified Nx Inference Plugin for @webpieces/dev-config
+ *
+ * This plugin automatically creates targets for:
+ * 1. Workspace-level architecture validation (generate, visualize, validate-*)
+ * 2. Per-project circular dependency checking
+ *
+ * Install with: nx add @webpieces/dev-config
+ *
+ * Usage:
+ * Add to nx.json plugins array:
+ * {
+ *   "plugins": ["@webpieces/dev-config"]
+ * }
+ *
+ * Then all targets appear automatically without manual project.json configuration.
+ */
+import type { CreateNodesV2 } from '@nx/devkit';
+/**
+ * Circular dependency checking options
+ */
+export interface CircularDepsOptions {
+    enabled?: boolean;
+    targetName?: string;
+    excludePatterns?: string[];
+}
+/**
+ * Validation options for architecture checks
+ */
+export interface ValidationOptions {
+    noCycles?: boolean;
+    noSkipLevelDeps?: boolean;
+    architectureUnchanged?: boolean;
+    validatePackageJson?: boolean;
+    validateNewMethods?: boolean;
+    validateModifiedMethods?: boolean;
+    validateModifiedFiles?: boolean;
+    validateVersionsLocked?: boolean;
+    validateTsInSrc?: boolean;
+    newMethodsMaxLines?: number;
+    modifiedAndNewMethodsMaxLines?: number;
+    modifiedFilesMaxLines?: number;
+    /**
+     * Validation mode for method/file size limits:
+     * - STRICT: All limits enforced, disable comments ignored
+     * - NORMAL: Limits enforced, disable comments with dates work
+     * - OFF: Skip size validations entirely (for fast iteration)
+     */
+    validationMode?: 'STRICT' | 'NORMAL' | 'OFF';
+}
+/**
+ * Feature flags for workspace targets
+ */
+export interface FeatureOptions {
+    generate?: boolean;
+    visualize?: boolean;
+}
+/**
+ * Workspace-level configuration options
+ */
+export interface WorkspaceOptions {
+    enabled?: boolean;
+    targetPrefix?: string;
+    graphPath?: string;
+    validations?: ValidationOptions;
+    features?: FeatureOptions;
+}
+/**
+ * Configuration for @webpieces/dev-config Nx plugin
+ */
+export interface ArchitecturePluginOptions {
+    circularDeps?: CircularDepsOptions;
+    workspace?: WorkspaceOptions;
+}
+/**
+ * Nx V2 Inference Plugin
+ * Matches project.json and package.json files to create targets
+ */
+export declare const createNodesV2: CreateNodesV2<ArchitecturePluginOptions>;
+/**
+ * Export plugin as default for Nx
+ */
+declare const _default: {
+    createNodesV2: CreateNodesV2<ArchitecturePluginOptions>;
+};
+export default _default;

package/{plugin.js → src/plugin.js}

@@ -39,6 +39,7 @@ const DEFAULT_OPTIONS = {
             validateModifiedMethods: true,
             validateModifiedFiles: true,
             validateVersionsLocked: true,
+            validateTsInSrc: true,
             newMethodsMaxLines: 30,
             modifiedAndNewMethodsMaxLines: 80,
             modifiedFilesMaxLines: 900,
@@ -181,6 +182,8 @@ function buildValidationTargetsList(validations) {
     }
     if (validations.validateVersionsLocked)
         targets.push('validate-versions-locked');
+    if (validations.validateTsInSrc)
+        targets.push('validate-ts-in-src');
     return targets;
 }
 /**
@@ -221,6 +224,9 @@ function createWorkspaceTargetsWithoutPrefix(opts) {
     if (validations.validateVersionsLocked) {
         targets['validate-versions-locked'] = createValidateVersionsLockedTarget();
     }
+    if (validations.validateTsInSrc) {
+        targets['validate-ts-in-src'] = createValidateTsInSrcTarget();
+    }
     // Add validate-complete target that runs all enabled validations
     const validationTargets = buildValidationTargetsList(validations);
     if (validationTargets.length > 0) {
@@ -268,7 +274,7 @@ function createWorkspaceTargets(opts) {
 }
 function createGenerateTarget(graphPath) {
     return {
-        executor: '@webpieces/dev-config:generate',
+        executor: '@webpieces/architecture-validators:generate',
         cache: false,
         outputs: ['{workspaceRoot}/architecture/dependencies.json'],
         options: { graphPath },
@@ -280,7 +286,7 @@ function createGenerateTarget(graphPath) {
 }
 function createVisualizeTargetWithoutPrefix(graphPath) {
     return {
-        executor: '@webpieces/dev-config:visualize',
+        executor: '@webpieces/architecture-validators:visualize',
         dependsOn: ['generate'],
         options: { graphPath },
         metadata: {
@@ -291,7 +297,7 @@ function createVisualizeTargetWithoutPrefix(graphPath) {
 }
 function createVisualizeTarget(prefix, graphPath) {
     return {
-        executor: '@webpieces/dev-config:visualize',
+        executor: '@webpieces/architecture-validators:visualize',
         dependsOn: [`${prefix}generate`],
         options: { graphPath },
         metadata: {
@@ -302,9 +308,9 @@ function createVisualizeTarget(prefix, graphPath) {
 }
 function createValidateNoCyclesTarget() {
     return {
-        executor: '@webpieces/dev-config:validate-no-architecture-cycles',
+        executor: '@webpieces/architecture-validators:validate-no-architecture-cycles',
         cache: true,
-        inputs: ['default'],
+        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],
         metadata: {
             technologies: ['nx'],
             description: 'Validate the architecture has no circular project dependencies',
@@ -313,7 +319,7 @@ function createValidateNoCyclesTarget() {
 }
 function createValidateUnchangedTarget(graphPath) {
     return {
-        executor: '@webpieces/dev-config:validate-architecture-unchanged',
+        executor: '@webpieces/architecture-validators:validate-architecture-unchanged',
         cache: false,
         inputs: ['default', '{workspaceRoot}/architecture/dependencies.json'],
         options: { graphPath },
@@ -325,9 +331,9 @@ function createValidateUnchangedTarget(graphPath) {
 }
 function createValidateNoSkipLevelTarget() {
     return {
-        executor: '@webpieces/dev-config:validate-no-skiplevel-deps',
+        executor: '@webpieces/architecture-validators:validate-no-skiplevel-deps',
         cache: true,
-        inputs: ['default'],
+        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],
         metadata: {
             technologies: ['nx'],
             description: 'Validate no project has redundant transitive dependencies',
@@ -336,9 +342,9 @@ function createValidateNoSkipLevelTarget() {
 }
 function createValidatePackageJsonTarget() {
     return {
-        executor: '@webpieces/dev-config:validate-packagejson',
+        executor: '@webpieces/architecture-validators:validate-packagejson',
         cache: true,
-        inputs: ['default'],
+        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/**/package.json'],
         metadata: {
             technologies: ['nx'],
             description: 'Validate package.json dependencies match project.json build dependencies',
@@ -347,7 +353,7 @@ function createValidatePackageJsonTarget() {
 }
 function createValidateNewMethodsTarget(maxLines, mode) {
     return {
-        executor: '@webpieces/dev-config:validate-new-methods',
+        executor: '@webpieces/architecture-validators:validate-new-methods',
         cache: false, // Don't cache - depends on git state
         inputs: ['default'],
         options: { max: maxLines, mode },
@@ -359,7 +365,7 @@ function createValidateNewMethodsTarget(maxLines, mode) {
 }
 function createValidateModifiedMethodsTarget(maxLines, mode) {
     return {
-        executor: '@webpieces/dev-config:validate-modified-methods',
+        executor: '@webpieces/architecture-validators:validate-modified-methods',
         cache: false, // Don't cache - depends on git state
         inputs: ['default'],
         options: { max: maxLines, mode },
@@ -371,7 +377,7 @@ function createValidateModifiedMethodsTarget(maxLines, mode) {
 }
 function createValidateModifiedFilesTarget(maxLines, mode) {
     return {
-        executor: '@webpieces/dev-config:validate-modified-files',
+        executor: '@webpieces/architecture-validators:validate-modified-files',
         cache: false, // Don't cache - depends on git state
         inputs: ['default'],
         options: { max: maxLines, mode },
@@ -387,7 +393,7 @@ function createValidateModifiedFilesTarget(maxLines, mode) {
  */
 function createValidateCodeTarget() {
     return {
-        executor: '@webpieces/dev-config:validate-code',
+        executor: '@webpieces/architecture-validators:validate-code',
         cache: false, // Don't cache - depends on git state
         inputs: ['default'],
         // No options here - they come from targetDefaults at runtime
@@ -401,13 +407,23 @@ function createValidateVersionsLockedTarget() {
     return {
         executor: '@webpieces/dev-config:validate-versions-locked',
         cache: true,
-        inputs: ['default'],
+        inputs: ['{workspaceRoot}/**/package.json'],
         metadata: {
             technologies: ['nx'],
             description: 'Validate package.json versions are locked (no semver ranges) and consistent across projects',
         },
     };
 }
+function createValidateTsInSrcTarget() {
+    return {
+        executor: '@webpieces/architecture-validators:validate-ts-in-src',
+        cache: false,
+        metadata: {
+            technologies: ['nx'],
+            description: 'Validate all .ts files in projects are inside the src/ directory',
+        },
+    };
+}
 function createValidateCompleteTarget(validationTargets) {
     return {
         executor: 'nx:noop',