@webpieces/nx-webpieces-rules 0.0.1 → 0.2.113

package/src/executors/validate-prisma-converters/executor.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const code_rules_1 = require("@webpieces/code-rules");
+async function runExecutor(
+// webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+options, context) {
+    return (0, code_rules_1.validatePrismaConverters)(options, context.root);
+}
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-prisma-converters/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-prisma-converters/executor.ts"],"names":[],"mappings":";;AAIA,8BAMC;AARD,sDAAiE;AAElD,KAAK,UAAU,WAAW;AACrC,0FAA0F;AAC1F,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAA,qCAAwB,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { validatePrismaConverters } from '@webpieces/code-rules';\n\nexport default async function runExecutor(\n    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators\n    options: Record<string, unknown>,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return validatePrismaConverters(options, context.root);\n}\n"]}

package/src/executors/validate-return-types/executor.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+export default function runExecutor(options: Record<string, unknown>, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-return-types/executor.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const code_rules_1 = require("@webpieces/code-rules");
+async function runExecutor(
+// webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+options, context) {
+    return (0, code_rules_1.validateReturnTypes)(options, context.root);
+}
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-return-types/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-return-types/executor.ts"],"names":[],"mappings":";;AAIA,8BAMC;AARD,sDAA4D;AAE7C,KAAK,UAAU,WAAW;AACrC,0FAA0F;AAC1F,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAA,gCAAmB,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { validateReturnTypes } from '@webpieces/code-rules';\n\nexport default async function runExecutor(\n    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators\n    options: Record<string, unknown>,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return validateReturnTypes(options, context.root);\n}\n"]}

package/src/executors/validate-ts-in-src/executor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Validate TypeScript Files in src/ Executor
+ *
+ * Two-layer rule:
+ *   Layer 1: every .ts file inside an Nx project must live under src/
+ *            (jest.config.ts at project root is the only exception)
+ *   Layer 2: every .ts file anywhere in the workspace must belong to some
+ *            Nx project. Orphan files (at workspace root or in a non-project
+ *            directory) fail the rule unless explicitly allowlisted.
+ *
+ * Configurable via nx.json targetDefaults:
+ *   "validate-ts-in-src": {
+ *       "options": {
+ *           "mode": "ON",
+ *           "excludePaths": [...],
+ *           "allowedRootFiles": [...]
+ *       }
+ *   }
+ *
+ * Usage: nx run architecture:validate-ts-in-src
+ */
+import type { ExecutorContext } from '@nx/devkit';
+export type ValidateTsInSrcMode = 'ON' | 'OFF';
+export interface ValidateTsInSrcOptions {
+    mode?: ValidateTsInSrcMode;
+    excludePaths?: string[];
+    allowedRootFiles?: string[];
+}
+export interface ExecutorResult {
+    success: boolean;
+}
+export default function runExecutor(_nxOptions: ValidateTsInSrcOptions, context: ExecutorContext): Promise<ExecutorResult>;

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

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Validate TypeScript Files in src/ Executor
  *
@@ -19,139 +20,117 @@
  *
  * Usage: nx run architecture:validate-ts-in-src
  */
-
-import type { ExecutorContext } from '@nx/devkit';
-import { createProjectGraphAsync, readProjectsConfigurationFromProjectGraph } from '@nx/devkit';
-import { loadConfig } from '@webpieces/rules-config';
-import * as fs from 'fs';
-import * as path from 'path';
-
-export type ValidateTsInSrcMode = 'ON' | 'OFF';
-
-export interface ValidateTsInSrcOptions {
-    mode?: ValidateTsInSrcMode;
-    excludePaths?: string[];
-    allowedRootFiles?: string[];
-}
-
-export interface ExecutorResult {
-    success: boolean;
-}
-
-const DEFAULT_EXCLUDE_PATHS: string[] = [
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const rules_config_1 = require("@webpieces/rules-config");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const DEFAULT_EXCLUDE_PATHS = [
     'node_modules', 'dist', '.nx', '.git',
     'architecture', 'tmp', 'scripts',
 ];
-
-const DEFAULT_ALLOWED_ROOT_FILES: string[] = ['jest.setup.ts'];
-
+const DEFAULT_ALLOWED_ROOT_FILES = ['jest.setup.ts'];
 class LayerOneViolation {
-    filePath: string;
-    projectName: string;
-
-    constructor(filePath: string, projectName: string) {
+    constructor(filePath, projectName) {
         this.filePath = filePath;
         this.projectName = projectName;
     }
 }
-
 class LayerTwoViolation {
-    filePath: string;
-
-    constructor(filePath: string) {
+    constructor(filePath) {
         this.filePath = filePath;
     }
 }
-
-function isNodeModulesDir(name: string): boolean {
+function isNodeModulesDir(name) {
     return name === 'node_modules' || name.startsWith('node_modules_');
 }
-
-function shouldSkipTopLevelDir(name: string, excludePaths: string[]): boolean {
-    if (isNodeModulesDir(name)) return true;
+function shouldSkipTopLevelDir(name, excludePaths) {
+    if (isNodeModulesDir(name))
+        return true;
     return excludePaths.includes(name);
 }
-
-async function getProjectRoots(workspaceRoot: string): Promise<string[]> {
-    const projectGraph = await createProjectGraphAsync();
-    const projectsConfig = readProjectsConfigurationFromProjectGraph(projectGraph);
-    const roots: string[] = [];
+async function getProjectRoots(workspaceRoot) {
+    const projectGraph = await (0, devkit_1.createProjectGraphAsync)();
+    const projectsConfig = (0, devkit_1.readProjectsConfigurationFromProjectGraph)(projectGraph);
+    const roots = [];
     for (const cfg of Object.values(projectsConfig.projects)) {
-        if (cfg.root === '' || cfg.root === '.') continue;
-        if (cfg.root === 'architecture') continue;
+        if (cfg.root === '' || cfg.root === '.')
+            continue;
+        if (cfg.root === 'architecture')
+            continue;
         roots.push(path.join(workspaceRoot, cfg.root));
     }
     return roots;
 }
-
-function findTsFilesOutsideSrc(projectDir: string): string[] {
-    const violations: string[] = [];
-    if (!fs.existsSync(projectDir)) return violations;
+function findTsFilesOutsideSrc(projectDir) {
+    const violations = [];
+    if (!fs.existsSync(projectDir))
+        return violations;
     const entries = fs.readdirSync(projectDir, { withFileTypes: true });
-
     for (const entry of entries) {
-        if (entry.name === 'src') continue;
-        if (isNodeModulesDir(entry.name)) continue;
-        if (entry.name === 'dist') continue;
-
+        if (entry.name === 'src')
+            continue;
+        if (isNodeModulesDir(entry.name))
+            continue;
+        if (entry.name === 'dist')
+            continue;
         if (entry.isFile() && entry.name.endsWith('.ts')) {
-            if (entry.name === 'jest.config.ts') continue;
+            if (entry.name === 'jest.config.ts')
+                continue;
             violations.push(path.join(projectDir, entry.name));
         }
-
         if (entry.isDirectory()) {
             const tsFiles = findTsFilesRecursively(path.join(projectDir, entry.name));
             violations.push(...tsFiles);
         }
     }
-
     return violations;
 }
-
-function findTsFilesRecursively(dir: string): string[] {
-    const results: string[] = [];
-    if (!fs.existsSync(dir)) return results;
-
+function findTsFilesRecursively(dir) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
     const entries = fs.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
-        if (isNodeModulesDir(entry.name)) continue;
-        if (entry.name === 'dist') continue;
+        if (isNodeModulesDir(entry.name))
+            continue;
+        if (entry.name === 'dist')
+            continue;
         const fullPath = path.join(dir, entry.name);
         if (entry.isFile() && entry.name.endsWith('.ts')) {
             results.push(fullPath);
-        } else if (entry.isDirectory()) {
+        }
+        else if (entry.isDirectory()) {
             results.push(...findTsFilesRecursively(fullPath));
         }
     }
     return results;
 }
-
-function findOrphanTsFiles(
-    dir: string,
-    projectRootSet: Set<string>,
-    workspaceRoot: string,
-    results: string[],
-): void {
-    if (!fs.existsSync(dir)) return;
-
+function findOrphanTsFiles(dir, projectRootSet, workspaceRoot, results) {
+    if (!fs.existsSync(dir))
+        return;
     const relDir = path.relative(workspaceRoot, dir);
-    if (projectRootSet.has(relDir)) return;
-
+    if (projectRootSet.has(relDir))
+        return;
     const entries = fs.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
-        if (isNodeModulesDir(entry.name)) continue;
-        if (entry.name === 'dist') continue;
+        if (isNodeModulesDir(entry.name))
+            continue;
+        if (entry.name === 'dist')
+            continue;
         const fullPath = path.join(dir, entry.name);
         if (entry.isFile() && entry.name.endsWith('.ts')) {
             results.push(fullPath);
-        } else if (entry.isDirectory()) {
+        }
+        else if (entry.isDirectory()) {
             findOrphanTsFiles(fullPath, projectRootSet, workspaceRoot, results);
         }
     }
 }
-
-function checkLayerOne(projectRoots: string[], workspaceRoot: string): LayerOneViolation[] {
-    const violations: LayerOneViolation[] = [];
+function checkLayerOne(projectRoots, workspaceRoot) {
+    const violations = [];
     for (const projectDir of projectRoots) {
         const projectName = path.relative(workspaceRoot, projectDir);
         const tsFiles = findTsFilesOutsideSrc(projectDir);
@@ -162,46 +141,32 @@ function checkLayerOne(projectRoots: string[], workspaceRoot: string): LayerOneV
     }
     return violations;
 }
-
-function checkLayerTwo(
-    workspaceRoot: string,
-    projectRoots: string[],
-    excludePaths: string[],
-    allowedRootFiles: string[],
-): LayerTwoViolation[] {
-    const violations: LayerTwoViolation[] = [];
-    const projectRootSet = new Set(
-        projectRoots.map((p) => path.relative(workspaceRoot, p)),
-    );
-
+function checkLayerTwo(workspaceRoot, projectRoots, excludePaths, allowedRootFiles) {
+    const violations = [];
+    const projectRootSet = new Set(projectRoots.map((p) => path.relative(workspaceRoot, p)));
     const entries = fs.readdirSync(workspaceRoot, { withFileTypes: true });
-
     for (const entry of entries) {
         if (entry.isFile()) {
-            if (!entry.name.endsWith('.ts')) continue;
-            if (allowedRootFiles.includes(entry.name)) continue;
+            if (!entry.name.endsWith('.ts'))
+                continue;
+            if (allowedRootFiles.includes(entry.name))
+                continue;
             violations.push(new LayerTwoViolation(entry.name));
             continue;
         }
-        if (!entry.isDirectory()) continue;
-        if (shouldSkipTopLevelDir(entry.name, excludePaths)) continue;
-
-        const orphans: string[] = [];
-        findOrphanTsFiles(
-            path.join(workspaceRoot, entry.name),
-            projectRootSet,
-            workspaceRoot,
-            orphans,
-        );
+        if (!entry.isDirectory())
+            continue;
+        if (shouldSkipTopLevelDir(entry.name, excludePaths))
+            continue;
+        const orphans = [];
+        findOrphanTsFiles(path.join(workspaceRoot, entry.name), projectRootSet, workspaceRoot, orphans);
         for (const orphan of orphans) {
             violations.push(new LayerTwoViolation(path.relative(workspaceRoot, orphan)));
         }
     }
-
     return violations;
 }
-
-function reportLayerOneFailure(violations: LayerOneViolation[]): void {
+function reportLayerOneFailure(violations) {
     console.error('❌ TypeScript files found outside src/ directory!\n');
     console.error('All .ts source files must be inside the project\'s src/ directory.');
     console.error('This enforces the standard project structure:\n');
@@ -210,25 +175,20 @@ function reportLayerOneFailure(violations: LayerOneViolation[]): void {
     console.error('  ├── package.json');
     console.error('  ├── project.json');
     console.error('  └── tsconfig.json\n');
-
     for (const v of violations) {
         console.error(`  ❌ ${v.filePath}`);
     }
-
     console.error('\nTo fix: Move the .ts file(s) into the src/ directory');
     console.error('Only exception: jest.config.ts at project root\n');
 }
-
-function reportLayerTwoFailure(violations: LayerTwoViolation[]): void {
+function reportLayerTwoFailure(violations) {
     console.error('❌ TypeScript files found outside any Nx project!\n');
     console.error('Every .ts file must belong to an Nx project so it is compiled,');
     console.error('linted, and tested under a known project config. Orphan files are');
     console.error('invisible to the build graph and will rot.\n');
-
     for (const v of violations) {
         console.error(`  ❌ ${v.filePath}`);
     }
-
     console.error('\nTo fix, pick one:');
     console.error('  (a) Move the file into an existing project\'s src/ directory');
     console.error('  (b) Create a new project (add project.json) that owns the directory');
@@ -236,48 +196,33 @@ function reportLayerTwoFailure(violations: LayerTwoViolation[]): void {
     console.error('      in nx.json targetDefaults, or add the filename to allowedRootFiles');
     console.error('      if it is a legitimate workspace-root file (e.g., jest.setup.ts)\n');
 }
-
-export default async function runExecutor(
-    _nxOptions: ValidateTsInSrcOptions,
-    context: ExecutorContext,
-): Promise<ExecutorResult> {
+async function runExecutor(_nxOptions, context) {
     // Config comes from webpieces.config.json — same source as ai-hooks
     // and validate-code — via @webpieces/rules-config.
-    const shared = loadConfig(context.root);
+    const shared = (0, rules_config_1.loadConfig)(context.root);
     const rule = shared.rules.get('validate-ts-in-src');
-
     if (rule && rule.enabled === false) {
         console.log('\n⏭️  Skipping validate-ts-in-src (enabled: false)\n');
         return { success: true };
     }
-
     const workspaceRoot = context.root;
-    const excludePaths =
-        (rule?.options['excludePaths'] as string[] | undefined) ?? DEFAULT_EXCLUDE_PATHS;
-    const allowedRootFiles =
-        (rule?.options['allowedRootFiles'] as string[] | undefined) ?? DEFAULT_ALLOWED_ROOT_FILES;
-
+    const excludePaths = rule?.options['excludePaths'] ?? DEFAULT_EXCLUDE_PATHS;
+    const allowedRootFiles = rule?.options['allowedRootFiles'] ?? DEFAULT_ALLOWED_ROOT_FILES;
     console.log('\n📁 Validating TypeScript files are in src/ and owned by a project\n');
-
     const projectRoots = await getProjectRoots(workspaceRoot);
-
     const layerOneViolations = checkLayerOne(projectRoots, workspaceRoot);
-    const layerTwoViolations = checkLayerTwo(
-        workspaceRoot, projectRoots, excludePaths, allowedRootFiles,
-    );
-
+    const layerTwoViolations = checkLayerTwo(workspaceRoot, projectRoots, excludePaths, allowedRootFiles);
     if (layerOneViolations.length === 0 && layerTwoViolations.length === 0) {
         console.log('✅ All .ts files are inside a project\'s src/ directory\n');
         return { success: true };
     }
-
     if (layerOneViolations.length > 0) {
         reportLayerOneFailure(layerOneViolations);
     }
     if (layerTwoViolations.length > 0) {
         reportLayerTwoFailure(layerTwoViolations);
     }
-
     console.error('To disable: set rules["validate-ts-in-src"].enabled to false in webpieces.config.json\n');
     return { success: false };
 }
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-ts-in-src/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-ts-in-src/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Validate TypeScript Files in src/ Executor\n *\n * Two-layer rule:\n *   Layer 1: every .ts file inside an Nx project must live under src/\n *            (jest.config.ts at project root is the only exception)\n *   Layer 2: every .ts file anywhere in the workspace must belong to some\n *            Nx project. Orphan files (at workspace root or in a non-project\n *            directory) fail the rule unless explicitly allowlisted.\n *\n * Configurable via nx.json targetDefaults:\n *   \"validate-ts-in-src\": {\n *       \"options\": {\n *           \"mode\": \"ON\",\n *           \"excludePaths\": [...],\n *           \"allowedRootFiles\": [...]\n *       }\n *   }\n *\n * Usage: nx run architecture:validate-ts-in-src\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { createProjectGraphAsync, readProjectsConfigurationFromProjectGraph } from '@nx/devkit';\nimport { loadConfig } from '@webpieces/rules-config';\nimport * as fs from 'fs';\nimport * as path from 'path';\n\nexport type ValidateTsInSrcMode = 'ON' | 'OFF';\n\nexport interface ValidateTsInSrcOptions {\n    mode?: ValidateTsInSrcMode;\n    excludePaths?: string[];\n    allowedRootFiles?: string[];\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nconst DEFAULT_EXCLUDE_PATHS: string[] = [\n    'node_modules', 'dist', '.nx', '.git',\n    'architecture', 'tmp', 'scripts',\n];\n\nconst DEFAULT_ALLOWED_ROOT_FILES: string[] = ['jest.setup.ts'];\n\nclass LayerOneViolation {\n    filePath: string;\n    projectName: string;\n\n    constructor(filePath: string, projectName: string) {\n        this.filePath = filePath;\n        this.projectName = projectName;\n    }\n}\n\nclass LayerTwoViolation {\n    filePath: string;\n\n    constructor(filePath: string) {\n        this.filePath = filePath;\n    }\n}\n\nfunction isNodeModulesDir(name: string): boolean {\n    return name === 'node_modules' || name.startsWith('node_modules_');\n}\n\nfunction shouldSkipTopLevelDir(name: string, excludePaths: string[]): boolean {\n    if (isNodeModulesDir(name)) return true;\n    return excludePaths.includes(name);\n}\n\nasync function getProjectRoots(workspaceRoot: string): Promise<string[]> {\n    const projectGraph = await createProjectGraphAsync();\n    const projectsConfig = readProjectsConfigurationFromProjectGraph(projectGraph);\n    const roots: string[] = [];\n    for (const cfg of Object.values(projectsConfig.projects)) {\n        if (cfg.root === '' || cfg.root === '.') continue;\n        if (cfg.root === 'architecture') continue;\n        roots.push(path.join(workspaceRoot, cfg.root));\n    }\n    return roots;\n}\n\nfunction findTsFilesOutsideSrc(projectDir: string): string[] {\n    const violations: string[] = [];\n    if (!fs.existsSync(projectDir)) return violations;\n    const entries = fs.readdirSync(projectDir, { withFileTypes: true });\n\n    for (const entry of entries) {\n        if (entry.name === 'src') continue;\n        if (isNodeModulesDir(entry.name)) continue;\n        if (entry.name === 'dist') continue;\n\n        if (entry.isFile() && entry.name.endsWith('.ts')) {\n            if (entry.name === 'jest.config.ts') continue;\n            violations.push(path.join(projectDir, entry.name));\n        }\n\n        if (entry.isDirectory()) {\n            const tsFiles = findTsFilesRecursively(path.join(projectDir, entry.name));\n            violations.push(...tsFiles);\n        }\n    }\n\n    return violations;\n}\n\nfunction findTsFilesRecursively(dir: string): string[] {\n    const results: string[] = [];\n    if (!fs.existsSync(dir)) return results;\n\n    const entries = fs.readdirSync(dir, { withFileTypes: true });\n    for (const entry of entries) {\n        if (isNodeModulesDir(entry.name)) continue;\n        if (entry.name === 'dist') continue;\n        const fullPath = path.join(dir, entry.name);\n        if (entry.isFile() && entry.name.endsWith('.ts')) {\n            results.push(fullPath);\n        } else if (entry.isDirectory()) {\n            results.push(...findTsFilesRecursively(fullPath));\n        }\n    }\n    return results;\n}\n\nfunction findOrphanTsFiles(\n    dir: string,\n    projectRootSet: Set<string>,\n    workspaceRoot: string,\n    results: string[],\n): void {\n    if (!fs.existsSync(dir)) return;\n\n    const relDir = path.relative(workspaceRoot, dir);\n    if (projectRootSet.has(relDir)) return;\n\n    const entries = fs.readdirSync(dir, { withFileTypes: true });\n    for (const entry of entries) {\n        if (isNodeModulesDir(entry.name)) continue;\n        if (entry.name === 'dist') continue;\n        const fullPath = path.join(dir, entry.name);\n        if (entry.isFile() && entry.name.endsWith('.ts')) {\n            results.push(fullPath);\n        } else if (entry.isDirectory()) {\n            findOrphanTsFiles(fullPath, projectRootSet, workspaceRoot, results);\n        }\n    }\n}\n\nfunction checkLayerOne(projectRoots: string[], workspaceRoot: string): LayerOneViolation[] {\n    const violations: LayerOneViolation[] = [];\n    for (const projectDir of projectRoots) {\n        const projectName = path.relative(workspaceRoot, projectDir);\n        const tsFiles = findTsFilesOutsideSrc(projectDir);\n        for (const tsFile of tsFiles) {\n            const relativePath = path.relative(workspaceRoot, tsFile);\n            violations.push(new LayerOneViolation(relativePath, projectName));\n        }\n    }\n    return violations;\n}\n\nfunction checkLayerTwo(\n    workspaceRoot: string,\n    projectRoots: string[],\n    excludePaths: string[],\n    allowedRootFiles: string[],\n): LayerTwoViolation[] {\n    const violations: LayerTwoViolation[] = [];\n    const projectRootSet = new Set(\n        projectRoots.map((p) => path.relative(workspaceRoot, p)),\n    );\n\n    const entries = fs.readdirSync(workspaceRoot, { withFileTypes: true });\n\n    for (const entry of entries) {\n        if (entry.isFile()) {\n            if (!entry.name.endsWith('.ts')) continue;\n            if (allowedRootFiles.includes(entry.name)) continue;\n            violations.push(new LayerTwoViolation(entry.name));\n            continue;\n        }\n        if (!entry.isDirectory()) continue;\n        if (shouldSkipTopLevelDir(entry.name, excludePaths)) continue;\n\n        const orphans: string[] = [];\n        findOrphanTsFiles(\n            path.join(workspaceRoot, entry.name),\n            projectRootSet,\n            workspaceRoot,\n            orphans,\n        );\n        for (const orphan of orphans) {\n            violations.push(new LayerTwoViolation(path.relative(workspaceRoot, orphan)));\n        }\n    }\n\n    return violations;\n}\n\nfunction reportLayerOneFailure(violations: LayerOneViolation[]): void {\n    console.error('❌ TypeScript files found outside src/ directory!\\n');\n    console.error('All .ts source files must be inside the project\\'s src/ directory.');\n    console.error('This enforces the standard project structure:\\n');\n    console.error('  packages/{category}/{name}/');\n    console.error('  ├── src/          ← ALL .ts files here');\n    console.error('  ├── package.json');\n    console.error('  ├── project.json');\n    console.error('  └── tsconfig.json\\n');\n\n    for (const v of violations) {\n        console.error(`  ❌ ${v.filePath}`);\n    }\n\n    console.error('\\nTo fix: Move the .ts file(s) into the src/ directory');\n    console.error('Only exception: jest.config.ts at project root\\n');\n}\n\nfunction reportLayerTwoFailure(violations: LayerTwoViolation[]): void {\n    console.error('❌ TypeScript files found outside any Nx project!\\n');\n    console.error('Every .ts file must belong to an Nx project so it is compiled,');\n    console.error('linted, and tested under a known project config. Orphan files are');\n    console.error('invisible to the build graph and will rot.\\n');\n\n    for (const v of violations) {\n        console.error(`  ❌ ${v.filePath}`);\n    }\n\n    console.error('\\nTo fix, pick one:');\n    console.error('  (a) Move the file into an existing project\\'s src/ directory');\n    console.error('  (b) Create a new project (add project.json) that owns the directory');\n    console.error('  (c) Add the containing top-level directory to validate-ts-in-src.excludePaths');\n    console.error('      in nx.json targetDefaults, or add the filename to allowedRootFiles');\n    console.error('      if it is a legitimate workspace-root file (e.g., jest.setup.ts)\\n');\n}\n\nexport default async function runExecutor(\n    _nxOptions: ValidateTsInSrcOptions,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    // Config comes from webpieces.config.json — same source as ai-hooks\n    // and validate-code — via @webpieces/rules-config.\n    const shared = loadConfig(context.root);\n    const rule = shared.rules.get('validate-ts-in-src');\n\n    if (rule && rule.enabled === false) {\n        console.log('\\n⏭️  Skipping validate-ts-in-src (enabled: false)\\n');\n        return { success: true };\n    }\n\n    const workspaceRoot = context.root;\n    const excludePaths =\n        (rule?.options['excludePaths'] as string[] | undefined) ?? DEFAULT_EXCLUDE_PATHS;\n    const allowedRootFiles =\n        (rule?.options['allowedRootFiles'] as string[] | undefined) ?? DEFAULT_ALLOWED_ROOT_FILES;\n\n    console.log('\\n📁 Validating TypeScript files are in src/ and owned by a project\\n');\n\n    const projectRoots = await getProjectRoots(workspaceRoot);\n\n    const layerOneViolations = checkLayerOne(projectRoots, workspaceRoot);\n    const layerTwoViolations = checkLayerTwo(\n        workspaceRoot, projectRoots, excludePaths, allowedRootFiles,\n    );\n\n    if (layerOneViolations.length === 0 && layerTwoViolations.length === 0) {\n        console.log('✅ All .ts files are inside a project\\'s src/ directory\\n');\n        return { success: true };\n    }\n\n    if (layerOneViolations.length > 0) {\n        reportLayerOneFailure(layerOneViolations);\n    }\n    if (layerTwoViolations.length > 0) {\n        reportLayerTwoFailure(layerTwoViolations);\n    }\n\n    console.error('To disable: set rules[\"validate-ts-in-src\"].enabled to false in webpieces.config.json\\n');\n    return { success: false };\n}\n"]}

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

@@ -0,0 +1,22 @@
+/**
+ * Validate Versions Locked Executor
+ *
+ * Validates that package.json versions are:
+ * 1. LOCKED (exact versions, no semver ranges like ^, ~, *)
+ * 2. CONSISTENT across all package.json files (no version conflicts)
+ *
+ * Why locked versions matter:
+ * - Micro bugs ARE introduced via patch versions (1.4.5 → 1.4.6)
+ * - git bisect fails when software changes OUTSIDE of git
+ * - Library upgrades must be explicit via PR/commit, not implicit drift
+ *
+ * Usage:
+ * nx run architecture:validate-versions-locked
+ */
+import type { ExecutorContext } from '@nx/devkit';
+export interface ValidateVersionsLockedOptions {
+}
+export interface ExecutorResult {
+    success: boolean;
+}
+export default function runExecutor(_options: ValidateVersionsLockedOptions, context: ExecutorContext): Promise<ExecutorResult>;