@webpieces/dev-config 0.2.94 → 0.2.97

package/architecture/executors/validate-dtos/schema.json

@@ -1,33 +0,0 @@
-{
-    "$schema": "http://json-schema.org/schema",
-    "title": "Validate DTOs Executor",
-    "description": "Validate DTO fields match Prisma Dbo model fields. Ensures AI agents don't invent field names.",
-    "type": "object",
-    "properties": {
-        "mode": {
-            "type": "string",
-            "enum": ["OFF", "MODIFIED_CLASS", "MODIFIED_FILES"],
-            "description": "OFF: skip validation. MODIFIED_CLASS: only validate Dto classes with changed lines. MODIFIED_FILES: validate all Dtos in modified files.",
-            "default": "OFF"
-        },
-        "prismaSchemaPath": {
-            "type": "string",
-            "description": "Relative path from workspace root to schema.prisma"
-        },
-        "dtoSourcePaths": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "Array of directories (relative to workspace root) containing Dto files"
-        },
-        "disableAllowed": {
-            "type": "boolean",
-            "description": "Whether @deprecated field exemption works. When false, all fields must match.",
-            "default": true
-        },
-        "ignoreModifiedUntilEpoch": {
-            "type": "number",
-            "description": "Epoch seconds. Until this time, skip DTO validation entirely. When expired, normal mode resumes. Omit when not needed."
-        }
-    },
-    "required": []
-}

package/architecture/executors/validate-modified-files/executor.d.ts

@@ -1,25 +0,0 @@
-/**
- * Validate Modified Files Executor
- *
- * Validates that modified files don't exceed a maximum line count (default 900).
- * This encourages keeping files small and focused - when you touch a file,
- * you must bring it under the limit.
- *
- * Usage:
- * nx affected --target=validate-modified-files --base=origin/main
- *
- * Escape hatch: Add webpieces-disable max-lines-modified-files comment with date and justification
- * Format: // webpieces-disable max-lines-modified-files 2025/01/15 -- [reason]
- * The disable expires after 1 month from the date specified.
- */
-import type { ExecutorContext } from '@nx/devkit';
-export type FileMaxLimitMode = 'OFF' | 'MODIFIED_FILES';
-export interface ValidateModifiedFilesOptions {
-    limit?: number;
-    mode?: FileMaxLimitMode;
-    disableAllowed?: boolean;
-}
-export interface ExecutorResult {
-    success: boolean;
-}
-export default function runExecutor(options: ValidateModifiedFilesOptions, context: ExecutorContext): Promise<ExecutorResult>;

package/architecture/executors/validate-modified-files/executor.js

@@ -1,501 +0,0 @@
-"use strict";
-/**
- * Validate Modified Files Executor
- *
- * Validates that modified files don't exceed a maximum line count (default 900).
- * This encourages keeping files small and focused - when you touch a file,
- * you must bring it under the limit.
- *
- * Usage:
- * nx affected --target=validate-modified-files --base=origin/main
- *
- * Escape hatch: Add webpieces-disable max-lines-modified-files comment with date and justification
- * Format: // webpieces-disable max-lines-modified-files 2025/01/15 -- [reason]
- * The disable expires after 1 month from the date specified.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = runExecutor;
-const tslib_1 = require("tslib");
-const child_process_1 = require("child_process");
-const fs = tslib_1.__importStar(require("fs"));
-const path = tslib_1.__importStar(require("path"));
-const TMP_DIR = 'tmp/webpieces';
-const TMP_MD_FILE = 'webpieces.filesize.md';
-const FILESIZE_DOC_CONTENT = `# AI Agent Instructions: File Too Long
-
-**READ THIS FILE to fix files that are too long**
-
-## Core Principle
-
-With **stateless systems + dependency injection, refactor is trivial**.
-Pick a method or a few and move to new class XXXXX, then inject XXXXX
-into all users of those methods via the constructor.
-Delete those methods from original class.
-
-**99% of files can be less than the configured max lines of code.**
-
-Files should contain a SINGLE COHESIVE UNIT.
-- One class per file (Java convention)
-- If class is too large, extract child responsibilities
-- Use dependency injection to compose functionality
-
-## Command: Reduce File Size
-
-### Step 1: Check for Multiple Classes
-If the file contains multiple classes, **SEPARATE each class into its own file**.
-
-\`\`\`typescript
-// BAD: UserController.ts (multiple classes)
-export class UserController { /* ... */ }
-export class UserValidator { /* ... */ }
-export class UserNotifier { /* ... */ }
-
-// GOOD: Three separate files
-// UserController.ts
-export class UserController { /* ... */ }
-
-// UserValidator.ts
-export class UserValidator { /* ... */ }
-
-// UserNotifier.ts
-export class UserNotifier { /* ... */ }
-\`\`\`
-
-### Step 2: Extract Child Responsibilities (if single class is too large)
-
-#### Pattern: Create New Service Class with Dependency Injection
-
-\`\`\`typescript
-// BAD: UserController.ts (800 lines, single class)
-@provideSingleton()
-@Controller()
-export class UserController {
-  // 200 lines: CRUD operations
-  // 300 lines: validation logic
-  // 200 lines: notification logic
-  // 100 lines: analytics logic
-}
-
-// GOOD: Extract validation service
-// 1. Create UserValidationService.ts
-@provideSingleton()
-export class UserValidationService {
-  validateUserData(data: UserData): ValidationResult {
-    // 300 lines of validation logic moved here
-  }
-
-  validateEmail(email: string): boolean { /* ... */ }
-  validatePassword(password: string): boolean { /* ... */ }
-}
-
-// 2. Inject into UserController.ts
-@provideSingleton()
-@Controller()
-export class UserController {
-  constructor(
-    @inject(TYPES.UserValidationService)
-    private validator: UserValidationService
-  ) {}
-
-  async createUser(data: UserData): Promise<User> {
-    const validation = this.validator.validateUserData(data);
-    if (!validation.isValid) {
-      throw new ValidationError(validation.errors);
-    }
-    // ... rest of logic
-  }
-}
-\`\`\`
-
-## AI Agent Action Steps
-
-1. **ANALYZE** the file structure:
-   - Count classes (if >1, separate immediately)
-   - Identify logical responsibilities within single class
-
-2. **IDENTIFY** "child code" to extract:
-   - Validation logic -> ValidationService
-   - Notification logic -> NotificationService
-   - Data transformation -> TransformerService
-   - External API calls -> ApiService
-   - Business rules -> RulesEngine
-
-3. **CREATE** new service file(s):
-   - Start with temporary name: \`XXXX.ts\` or \`ChildService.ts\`
-   - Add \`@provideSingleton()\` decorator
-   - Move child methods to new class
-
-4. **UPDATE** dependency injection:
-   - Add to \`TYPES\` constants (if using symbol-based DI)
-   - Inject new service into original class constructor
-   - Replace direct method calls with \`this.serviceName.method()\`
-
-5. **RENAME** extracted file:
-   - Read the extracted code to understand its purpose
-   - Rename \`XXXX.ts\` to logical name (e.g., \`UserValidationService.ts\`)
-
-6. **VERIFY** file sizes:
-   - Original file should now be under the limit
-   - Each extracted file should be under the limit
-   - If still too large, extract more services
-
-## Examples of Child Responsibilities to Extract
-
-| If File Contains | Extract To | Pattern |
-|-----------------|------------|---------|
-| Validation logic (200+ lines) | \`XValidator.ts\` or \`XValidationService.ts\` | Singleton service |
-| Notification logic (150+ lines) | \`XNotifier.ts\` or \`XNotificationService.ts\` | Singleton service |
-| Data transformation (200+ lines) | \`XTransformer.ts\` | Singleton service |
-| External API calls (200+ lines) | \`XApiClient.ts\` | Singleton service |
-| Complex business rules (300+ lines) | \`XRulesEngine.ts\` | Singleton service |
-| Database queries (200+ lines) | \`XRepository.ts\` | Singleton service |
-
-## WebPieces Dependency Injection Pattern
-
-\`\`\`typescript
-// 1. Define service with @provideSingleton
-import { provideSingleton } from '@webpieces/http-routing';
-
-@provideSingleton()
-export class MyService {
-  doSomething(): void { /* ... */ }
-}
-
-// 2. Inject into consumer
-import { inject } from 'inversify';
-import { TYPES } from './types';
-
-@provideSingleton()
-@Controller()
-export class MyController {
-  constructor(
-    @inject(TYPES.MyService) private service: MyService
-  ) {}
-}
-\`\`\`
-
-## Escape Hatch
-
-If refactoring is genuinely not feasible (generated files, complex algorithms, etc.),
-add a disable comment at the TOP of the file (within first 5 lines) with a DATE:
-
-\`\`\`typescript
-// webpieces-disable max-lines-modified-files 2025/01/15 -- Complex generated file, refactoring would break generation
-\`\`\`
-
-**IMPORTANT**: The date format is yyyy/mm/dd. The disable will EXPIRE after 1 month from this date.
-After expiration, you must either fix the file or update the date to get another month.
-This ensures that disable comments are reviewed periodically.
-
-Remember: Find the "child code" and pull it down into a new class. Once moved, the code's purpose becomes clear, making it easy to rename to a logical name.
-`;
-/**
- * Write the instructions documentation to tmp directory
- */
-function writeTmpInstructions(workspaceRoot) {
-    const tmpDir = path.join(workspaceRoot, TMP_DIR);
-    const mdPath = path.join(tmpDir, TMP_MD_FILE);
-    fs.mkdirSync(tmpDir, { recursive: true });
-    fs.writeFileSync(mdPath, FILESIZE_DOC_CONTENT);
-    return mdPath;
-}
-/**
- * Get changed TypeScript files between base and head (or working tree if head not specified).
- * Uses `git diff base [head]` to match what `nx affected` does.
- * When head is NOT specified, also includes untracked files (matching nx affected behavior).
- */
-function getChangedTypeScriptFiles(workspaceRoot, base, head) {
-    try {
-        // If head is specified, diff base to head; otherwise diff base to working tree
-        const diffTarget = head ? `${base} ${head}` : base;
-        const output = (0, child_process_1.execSync)(`git diff --name-only ${diffTarget} -- '*.ts' '*.tsx'`, {
-            cwd: workspaceRoot,
-            encoding: 'utf-8',
-        });
-        const changedFiles = output
-            .trim()
-            .split('\n')
-            .filter((f) => f && !f.includes('.spec.ts') && !f.includes('.test.ts'));
-        // When comparing to working tree (no head specified), also include untracked files
-        // This matches what nx affected does: "All modified files not yet committed or tracked will also be added"
-        if (!head) {
-            try {
-                const untrackedOutput = (0, child_process_1.execSync)(`git ls-files --others --exclude-standard '*.ts' '*.tsx'`, {
-                    cwd: workspaceRoot,
-                    encoding: 'utf-8',
-                });
-                const untrackedFiles = untrackedOutput
-                    .trim()
-                    .split('\n')
-                    .filter((f) => f && !f.includes('.spec.ts') && !f.includes('.test.ts'));
-                // Merge and dedupe
-                const allFiles = new Set([...changedFiles, ...untrackedFiles]);
-                return Array.from(allFiles);
-            }
-            catch {
-                // If ls-files fails, just return the changed files
-                return changedFiles;
-            }
-        }
-        return changedFiles;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Parse a date string in yyyy/mm/dd format and return a Date object.
- * Returns null if the format is invalid.
- */
-function parseDisableDate(dateStr) {
-    // Match yyyy/mm/dd format
-    const match = dateStr.match(/^(\d{4})\/(\d{2})\/(\d{2})$/);
-    if (!match)
-        return null;
-    const year = parseInt(match[1], 10);
-    const month = parseInt(match[2], 10) - 1; // JS months are 0-indexed
-    const day = parseInt(match[3], 10);
-    const date = new Date(year, month, day);
-    // Validate the date is valid (e.g., not Feb 30)
-    if (date.getFullYear() !== year || date.getMonth() !== month || date.getDate() !== day) {
-        return null;
-    }
-    return date;
-}
-/**
- * Check if a date is within the last month (not expired).
- */
-function isDateWithinMonth(date) {
-    const now = new Date();
-    const oneMonthAgo = new Date(now.getFullYear(), now.getMonth() - 1, now.getDate());
-    return date >= oneMonthAgo;
-}
-/**
- * Check if a file has a valid, non-expired disable comment at the top (within first 5 lines).
- * Returns status object with details about the disable comment.
- */
-// webpieces-disable max-lines-new-methods -- Date validation logic requires checking multiple conditions
-function checkDisableComment(content) {
-    const lines = content.split('\n').slice(0, 5);
-    for (const line of lines) {
-        if (line.includes('webpieces-disable') && line.includes('max-lines-modified-files')) {
-            // Found disable comment, now check for date
-            // Format: // webpieces-disable max-lines-modified-files yyyy/mm/dd -- reason
-            const dateMatch = line.match(/max-lines-modified-files\s+(\d{4}\/\d{2}\/\d{2}|XXXX\/XX\/XX)/);
-            if (!dateMatch) {
-                // No date found - invalid disable comment
-                return { hasDisable: true, isValid: false, isExpired: false };
-            }
-            const dateStr = dateMatch[1];
-            // Secret permanent disable
-            if (dateStr === 'XXXX/XX/XX') {
-                return { hasDisable: true, isValid: true, isExpired: false, date: dateStr };
-            }
-            const date = parseDisableDate(dateStr);
-            if (!date) {
-                // Invalid date format
-                return { hasDisable: true, isValid: false, isExpired: false, date: dateStr };
-            }
-            if (!isDateWithinMonth(date)) {
-                // Date is expired (older than 1 month)
-                return { hasDisable: true, isValid: true, isExpired: true, date: dateStr };
-            }
-            // Valid and not expired
-            return { hasDisable: true, isValid: true, isExpired: false, date: dateStr };
-        }
-    }
-    return { hasDisable: false, isValid: false, isExpired: false };
-}
-/**
- * Count lines in a file and check for violations
- */
-// webpieces-disable max-lines-new-methods -- File iteration with disable checking logic
-function findViolations(workspaceRoot, changedFiles, limit, disableAllowed) {
-    const violations = [];
-    for (const file of changedFiles) {
-        const fullPath = path.join(workspaceRoot, file);
-        if (!fs.existsSync(fullPath))
-            continue;
-        const content = fs.readFileSync(fullPath, 'utf-8');
-        const lineCount = content.split('\n').length;
-        // Skip files under the limit
-        if (lineCount <= limit)
-            continue;
-        // When disableAllowed is false, ignore all disable comments
-        if (!disableAllowed) {
-            violations.push({ file, lines: lineCount });
-            continue;
-        }
-        // Check for disable comment
-        const disableStatus = checkDisableComment(content);
-        if (disableStatus.hasDisable) {
-            if (disableStatus.isValid && !disableStatus.isExpired) {
-                // Valid, non-expired disable - skip this file
-                continue;
-            }
-            if (disableStatus.isExpired) {
-                // Expired disable - report as violation with expired info
-                violations.push({
-                    file,
-                    lines: lineCount,
-                    expiredDisable: true,
-                    expiredDate: disableStatus.date,
-                });
-                continue;
-            }
-            // Invalid disable (missing/bad date) - fall through to report as violation
-        }
-        violations.push({
-            file,
-            lines: lineCount,
-        });
-    }
-    return violations;
-}
-/**
- * Auto-detect the base branch by finding the merge-base with origin/main.
- */
-function detectBase(workspaceRoot) {
-    try {
-        const mergeBase = (0, child_process_1.execSync)('git merge-base HEAD origin/main', {
-            cwd: workspaceRoot,
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe'],
-        }).trim();
-        if (mergeBase) {
-            return mergeBase;
-        }
-    }
-    catch {
-        try {
-            const mergeBase = (0, child_process_1.execSync)('git merge-base HEAD main', {
-                cwd: workspaceRoot,
-                encoding: 'utf-8',
-                stdio: ['pipe', 'pipe', 'pipe'],
-            }).trim();
-            if (mergeBase) {
-                return mergeBase;
-            }
-        }
-        catch {
-            // Ignore
-        }
-    }
-    return null;
-}
-/**
- * Get today's date in yyyy/mm/dd format for error messages
- */
-function getTodayDateString() {
-    const now = new Date();
-    const year = now.getFullYear();
-    const month = String(now.getMonth() + 1).padStart(2, '0');
-    const day = String(now.getDate()).padStart(2, '0');
-    return `${year}/${month}/${day}`;
-}
-/**
- * Report violations to console
- */
-// webpieces-disable max-lines-new-methods -- Error output formatting with multiple message sections
-function reportViolations(violations, limit, disableAllowed) {
-    console.error('');
-    console.error('\u274c YOU MUST FIX THIS AND NOT be more than ' + limit + ' lines of code per file');
-    console.error('   as it slows down IDEs AND is VERY VERY EASY to refactor.');
-    console.error('');
-    console.error('\ud83d\udcda With stateless systems + dependency injection, refactor is trivial:');
-    console.error('   Pick a method or a few and move to new class XXXXX, then inject XXXXX');
-    console.error('   into all users of those methods via the constructor.');
-    console.error('   Delete those methods from original class.');
-    console.error('   99% of files can be less than ' + limit + ' lines of code.');
-    console.error('');
-    console.error('\u26a0\ufe0f  *** READ tmp/webpieces/webpieces.filesize.md for detailed guidance on how to fix this easily *** \u26a0\ufe0f');
-    console.error('');
-    for (const v of violations) {
-        if (v.expiredDisable) {
-            console.error(`  \u274c ${v.file} (${v.lines} lines, max: ${limit})`);
-            console.error(`     \u23f0 EXPIRED DISABLE: Your disable comment dated ${v.expiredDate} has expired (>1 month old).`);
-            console.error(`        You must either FIX the file or UPDATE the date to get another month.`);
-        }
-        else {
-            console.error(`  \u274c ${v.file} (${v.lines} lines, max: ${limit})`);
-        }
-    }
-    console.error('');
-    // Only show escape hatch instructions when disableAllowed is true
-    if (disableAllowed) {
-        console.error('   You can disable this error, but you will be forced to fix again in 1 month');
-        console.error('   since 99% of files can be less than ' + limit + ' lines of code.');
-        console.error('');
-        console.error('   Use escape with DATE (expires in 1 month):');
-        console.error(`   // webpieces-disable max-lines-modified-files ${getTodayDateString()} -- [your reason]`);
-        console.error('');
-    }
-    else {
-        console.error('   \u26a0\ufe0f  disableAllowed is false - disable comments are NOT allowed.');
-        console.error('   This rule must be met and cannot be disabled since nx.json disableAllowed is set to false.');
-        console.error('   You MUST refactor to reduce file size.');
-        console.error('');
-        console.error('   For a major refactor, a human can add "ignoreModifiedUntilEpoch" to nx.json validate-code options.');
-        console.error('   This is an expiry timestamp (epoch ms) for when we start forcing everyone to meet size rules again.');
-        console.error('   Sometimes for speed, we allow files to expand during a refactor and over time,');
-        console.error('   each PR reduces files as they get touched.');
-        console.error('   AI agents should NOT add ignoreModifiedUntilEpoch - ask a human to do it.');
-        console.error('');
-    }
-}
-async function runExecutor(options, context) {
-    const workspaceRoot = context.root;
-    const limit = options.limit ?? 900;
-    const mode = options.mode ?? 'MODIFIED_FILES';
-    const disableAllowed = options.disableAllowed ?? true;
-    // Skip validation entirely if mode is OFF
-    if (mode === 'OFF') {
-        console.log('\n\u23ed\ufe0f  Skipping modified files validation (mode: OFF)');
-        console.log('');
-        return { success: true };
-    }
-    // If NX_HEAD is set (via nx affected --head=X), use it; otherwise compare to working tree
-    let base = process.env['NX_BASE'];
-    const head = process.env['NX_HEAD'];
-    if (!base) {
-        base = detectBase(workspaceRoot) ?? undefined;
-        if (!base) {
-            console.log('\n\u23ed\ufe0f  Skipping modified files validation (could not detect base branch)');
-            console.log('   To run explicitly: nx affected --target=validate-modified-files --base=origin/main');
-            console.log('');
-            return { success: true };
-        }
-        console.log('\n\ud83d\udccf Validating Modified File Sizes (auto-detected base)\n');
-    }
-    else {
-        console.log('\n\ud83d\udccf Validating Modified File Sizes\n');
-    }
-    console.log(`   Base: ${base}`);
-    console.log(`   Head: ${head ?? 'working tree (includes uncommitted changes)'}`);
-    console.log(`   Mode: ${mode}`);
-    console.log(`   Max lines for modified files: ${limit}`);
-    console.log(`   Disable allowed: ${disableAllowed}${!disableAllowed ? ' (no escape hatch)' : ''}`);
-    console.log('');
-    try {
-        const changedFiles = getChangedTypeScriptFiles(workspaceRoot, base, head);
-        if (changedFiles.length === 0) {
-            console.log('\u2705 No TypeScript files changed');
-            return { success: true };
-        }
-        console.log(`\ud83d\udcc2 Checking ${changedFiles.length} changed file(s)...`);
-        const violations = findViolations(workspaceRoot, changedFiles, limit, disableAllowed);
-        if (violations.length === 0) {
-            console.log('\u2705 All modified files are under ' + limit + ' lines');
-            return { success: true };
-        }
-        writeTmpInstructions(workspaceRoot);
-        reportViolations(violations, limit, disableAllowed);
-        return { success: false };
-    }
-    catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        console.error('\u274c Modified files validation failed:', error.message);
-        return { success: false };
-    }
-}
-//# sourceMappingURL=executor.js.map

package/architecture/executors/validate-modified-files/executor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/architecture/executors/validate-modified-files/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Validate Modified Files Executor\n *\n * Validates that modified files don't exceed a maximum line count (default 900).\n * This encourages keeping files small and focused - when you touch a file,\n * you must bring it under the limit.\n *\n * Usage:\n * nx affected --target=validate-modified-files --base=origin/main\n *\n * Escape hatch: Add webpieces-disable max-lines-modified-files comment with date and justification\n * Format: // webpieces-disable max-lines-modified-files 2025/01/15 -- [reason]\n * The disable expires after 1 month from the date specified.\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { execSync } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\n\nexport type FileMaxLimitMode = 'OFF' | 'MODIFIED_FILES';\n\nexport interface ValidateModifiedFilesOptions {\n    limit?: number;\n    mode?: FileMaxLimitMode;\n    disableAllowed?: boolean;\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\ninterface FileViolation {\n    file: string;\n    lines: number;\n    expiredDisable?: boolean;\n    expiredDate?: string;\n}\n\nconst TMP_DIR = 'tmp/webpieces';\nconst TMP_MD_FILE = 'webpieces.filesize.md';\n\nconst FILESIZE_DOC_CONTENT = `# AI Agent Instructions: File Too Long\n\n**READ THIS FILE to fix files that are too long**\n\n## Core Principle\n\nWith **stateless systems + dependency injection, refactor is trivial**.\nPick a method or a few and move to new class XXXXX, then inject XXXXX\ninto all users of those methods via the constructor.\nDelete those methods from original class.\n\n**99% of files can be less than the configured max lines of code.**\n\nFiles should contain a SINGLE COHESIVE UNIT.\n- One class per file (Java convention)\n- If class is too large, extract child responsibilities\n- Use dependency injection to compose functionality\n\n## Command: Reduce File Size\n\n### Step 1: Check for Multiple Classes\nIf the file contains multiple classes, **SEPARATE each class into its own file**.\n\n\\`\\`\\`typescript\n// BAD: UserController.ts (multiple classes)\nexport class UserController { /* ... */ }\nexport class UserValidator { /* ... */ }\nexport class UserNotifier { /* ... */ }\n\n// GOOD: Three separate files\n// UserController.ts\nexport class UserController { /* ... */ }\n\n// UserValidator.ts\nexport class UserValidator { /* ... */ }\n\n// UserNotifier.ts\nexport class UserNotifier { /* ... */ }\n\\`\\`\\`\n\n### Step 2: Extract Child Responsibilities (if single class is too large)\n\n#### Pattern: Create New Service Class with Dependency Injection\n\n\\`\\`\\`typescript\n// BAD: UserController.ts (800 lines, single class)\n@provideSingleton()\n@Controller()\nexport class UserController {\n  // 200 lines: CRUD operations\n  // 300 lines: validation logic\n  // 200 lines: notification logic\n  // 100 lines: analytics logic\n}\n\n// GOOD: Extract validation service\n// 1. Create UserValidationService.ts\n@provideSingleton()\nexport class UserValidationService {\n  validateUserData(data: UserData): ValidationResult {\n    // 300 lines of validation logic moved here\n  }\n\n  validateEmail(email: string): boolean { /* ... */ }\n  validatePassword(password: string): boolean { /* ... */ }\n}\n\n// 2. Inject into UserController.ts\n@provideSingleton()\n@Controller()\nexport class UserController {\n  constructor(\n    @inject(TYPES.UserValidationService)\n    private validator: UserValidationService\n  ) {}\n\n  async createUser(data: UserData): Promise<User> {\n    const validation = this.validator.validateUserData(data);\n    if (!validation.isValid) {\n      throw new ValidationError(validation.errors);\n    }\n    // ... rest of logic\n  }\n}\n\\`\\`\\`\n\n## AI Agent Action Steps\n\n1. **ANALYZE** the file structure:\n   - Count classes (if >1, separate immediately)\n   - Identify logical responsibilities within single class\n\n2. **IDENTIFY** \"child code\" to extract:\n   - Validation logic -> ValidationService\n   - Notification logic -> NotificationService\n   - Data transformation -> TransformerService\n   - External API calls -> ApiService\n   - Business rules -> RulesEngine\n\n3. **CREATE** new service file(s):\n   - Start with temporary name: \\`XXXX.ts\\` or \\`ChildService.ts\\`\n   - Add \\`@provideSingleton()\\` decorator\n   - Move child methods to new class\n\n4. **UPDATE** dependency injection:\n   - Add to \\`TYPES\\` constants (if using symbol-based DI)\n   - Inject new service into original class constructor\n   - Replace direct method calls with \\`this.serviceName.method()\\`\n\n5. **RENAME** extracted file:\n   - Read the extracted code to understand its purpose\n   - Rename \\`XXXX.ts\\` to logical name (e.g., \\`UserValidationService.ts\\`)\n\n6. **VERIFY** file sizes:\n   - Original file should now be under the limit\n   - Each extracted file should be under the limit\n   - If still too large, extract more services\n\n## Examples of Child Responsibilities to Extract\n\n| If File Contains | Extract To | Pattern |\n|-----------------|------------|---------|\n| Validation logic (200+ lines) | \\`XValidator.ts\\` or \\`XValidationService.ts\\` | Singleton service |\n| Notification logic (150+ lines) | \\`XNotifier.ts\\` or \\`XNotificationService.ts\\` | Singleton service |\n| Data transformation (200+ lines) | \\`XTransformer.ts\\` | Singleton service |\n| External API calls (200+ lines) | \\`XApiClient.ts\\` | Singleton service |\n| Complex business rules (300+ lines) | \\`XRulesEngine.ts\\` | Singleton service |\n| Database queries (200+ lines) | \\`XRepository.ts\\` | Singleton service |\n\n## WebPieces Dependency Injection Pattern\n\n\\`\\`\\`typescript\n// 1. Define service with @provideSingleton\nimport { provideSingleton } from '@webpieces/http-routing';\n\n@provideSingleton()\nexport class MyService {\n  doSomething(): void { /* ... */ }\n}\n\n// 2. Inject into consumer\nimport { inject } from 'inversify';\nimport { TYPES } from './types';\n\n@provideSingleton()\n@Controller()\nexport class MyController {\n  constructor(\n    @inject(TYPES.MyService) private service: MyService\n  ) {}\n}\n\\`\\`\\`\n\n## Escape Hatch\n\nIf refactoring is genuinely not feasible (generated files, complex algorithms, etc.),\nadd a disable comment at the TOP of the file (within first 5 lines) with a DATE:\n\n\\`\\`\\`typescript\n// webpieces-disable max-lines-modified-files 2025/01/15 -- Complex generated file, refactoring would break generation\n\\`\\`\\`\n\n**IMPORTANT**: The date format is yyyy/mm/dd. The disable will EXPIRE after 1 month from this date.\nAfter expiration, you must either fix the file or update the date to get another month.\nThis ensures that disable comments are reviewed periodically.\n\nRemember: Find the \"child code\" and pull it down into a new class. Once moved, the code's purpose becomes clear, making it easy to rename to a logical name.\n`;\n\n/**\n * Write the instructions documentation to tmp directory\n */\nfunction writeTmpInstructions(workspaceRoot: string): string {\n    const tmpDir = path.join(workspaceRoot, TMP_DIR);\n    const mdPath = path.join(tmpDir, TMP_MD_FILE);\n\n    fs.mkdirSync(tmpDir, { recursive: true });\n    fs.writeFileSync(mdPath, FILESIZE_DOC_CONTENT);\n\n    return mdPath;\n}\n\n/**\n * Get changed TypeScript files between base and head (or working tree if head not specified).\n * Uses `git diff base [head]` to match what `nx affected` does.\n * When head is NOT specified, also includes untracked files (matching nx affected behavior).\n */\nfunction getChangedTypeScriptFiles(workspaceRoot: string, base: string, head?: string): string[] {\n    try {\n        // If head is specified, diff base to head; otherwise diff base to working tree\n        const diffTarget = head ? `${base} ${head}` : base;\n        const output = execSync(`git diff --name-only ${diffTarget} -- '*.ts' '*.tsx'`, {\n            cwd: workspaceRoot,\n            encoding: 'utf-8',\n        });\n        const changedFiles = output\n            .trim()\n            .split('\\n')\n            .filter((f) => f && !f.includes('.spec.ts') && !f.includes('.test.ts'));\n\n        // When comparing to working tree (no head specified), also include untracked files\n        // This matches what nx affected does: \"All modified files not yet committed or tracked will also be added\"\n        if (!head) {\n            try {\n                const untrackedOutput = execSync(`git ls-files --others --exclude-standard '*.ts' '*.tsx'`, {\n                    cwd: workspaceRoot,\n                    encoding: 'utf-8',\n                });\n                const untrackedFiles = untrackedOutput\n                    .trim()\n                    .split('\\n')\n                    .filter((f) => f && !f.includes('.spec.ts') && !f.includes('.test.ts'));\n                // Merge and dedupe\n                const allFiles = new Set([...changedFiles, ...untrackedFiles]);\n                return Array.from(allFiles);\n            } catch {\n                // If ls-files fails, just return the changed files\n                return changedFiles;\n            }\n        }\n\n        return changedFiles;\n    } catch {\n        return [];\n    }\n}\n\n/**\n * Parse a date string in yyyy/mm/dd format and return a Date object.\n * Returns null if the format is invalid.\n */\nfunction parseDisableDate(dateStr: string): Date | null {\n    // Match yyyy/mm/dd format\n    const match = dateStr.match(/^(\\d{4})\\/(\\d{2})\\/(\\d{2})$/);\n    if (!match) return null;\n\n    const year = parseInt(match[1], 10);\n    const month = parseInt(match[2], 10) - 1; // JS months are 0-indexed\n    const day = parseInt(match[3], 10);\n\n    const date = new Date(year, month, day);\n\n    // Validate the date is valid (e.g., not Feb 30)\n    if (date.getFullYear() !== year || date.getMonth() !== month || date.getDate() !== day) {\n        return null;\n    }\n\n    return date;\n}\n\n/**\n * Check if a date is within the last month (not expired).\n */\nfunction isDateWithinMonth(date: Date): boolean {\n    const now = new Date();\n    const oneMonthAgo = new Date(now.getFullYear(), now.getMonth() - 1, now.getDate());\n    return date >= oneMonthAgo;\n}\n\ninterface DisableStatus {\n    hasDisable: boolean;\n    isValid: boolean;\n    isExpired: boolean;\n    date?: string;\n}\n\n/**\n * Check if a file has a valid, non-expired disable comment at the top (within first 5 lines).\n * Returns status object with details about the disable comment.\n */\n// webpieces-disable max-lines-new-methods -- Date validation logic requires checking multiple conditions\nfunction checkDisableComment(content: string): DisableStatus {\n    const lines = content.split('\\n').slice(0, 5);\n\n    for (const line of lines) {\n        if (line.includes('webpieces-disable') && line.includes('max-lines-modified-files')) {\n            // Found disable comment, now check for date\n            // Format: // webpieces-disable max-lines-modified-files yyyy/mm/dd -- reason\n            const dateMatch = line.match(/max-lines-modified-files\\s+(\\d{4}\\/\\d{2}\\/\\d{2}|XXXX\\/XX\\/XX)/);\n\n            if (!dateMatch) {\n                // No date found - invalid disable comment\n                return { hasDisable: true, isValid: false, isExpired: false };\n            }\n\n            const dateStr = dateMatch[1];\n\n            // Secret permanent disable\n            if (dateStr === 'XXXX/XX/XX') {\n                return { hasDisable: true, isValid: true, isExpired: false, date: dateStr };\n            }\n\n            const date = parseDisableDate(dateStr);\n            if (!date) {\n                // Invalid date format\n                return { hasDisable: true, isValid: false, isExpired: false, date: dateStr };\n            }\n\n            if (!isDateWithinMonth(date)) {\n                // Date is expired (older than 1 month)\n                return { hasDisable: true, isValid: true, isExpired: true, date: dateStr };\n            }\n\n            // Valid and not expired\n            return { hasDisable: true, isValid: true, isExpired: false, date: dateStr };\n        }\n    }\n\n    return { hasDisable: false, isValid: false, isExpired: false };\n}\n\n/**\n * Count lines in a file and check for violations\n */\n// webpieces-disable max-lines-new-methods -- File iteration with disable checking logic\nfunction findViolations(workspaceRoot: string, changedFiles: string[], limit: number, disableAllowed: boolean): FileViolation[] {\n    const violations: FileViolation[] = [];\n\n    for (const file of changedFiles) {\n        const fullPath = path.join(workspaceRoot, file);\n\n        if (!fs.existsSync(fullPath)) continue;\n\n        const content = fs.readFileSync(fullPath, 'utf-8');\n        const lineCount = content.split('\\n').length;\n\n        // Skip files under the limit\n        if (lineCount <= limit) continue;\n\n        // When disableAllowed is false, ignore all disable comments\n        if (!disableAllowed) {\n            violations.push({ file, lines: lineCount });\n            continue;\n        }\n\n        // Check for disable comment\n        const disableStatus = checkDisableComment(content);\n\n        if (disableStatus.hasDisable) {\n            if (disableStatus.isValid && !disableStatus.isExpired) {\n                // Valid, non-expired disable - skip this file\n                continue;\n            }\n\n            if (disableStatus.isExpired) {\n                // Expired disable - report as violation with expired info\n                violations.push({\n                    file,\n                    lines: lineCount,\n                    expiredDisable: true,\n                    expiredDate: disableStatus.date,\n                });\n                continue;\n            }\n\n            // Invalid disable (missing/bad date) - fall through to report as violation\n        }\n\n        violations.push({\n            file,\n            lines: lineCount,\n        });\n    }\n\n    return violations;\n}\n\n/**\n * Auto-detect the base branch by finding the merge-base with origin/main.\n */\nfunction detectBase(workspaceRoot: string): string | null {\n    try {\n        const mergeBase = execSync('git merge-base HEAD origin/main', {\n            cwd: workspaceRoot,\n            encoding: 'utf-8',\n            stdio: ['pipe', 'pipe', 'pipe'],\n        }).trim();\n\n        if (mergeBase) {\n            return mergeBase;\n        }\n    } catch {\n        try {\n            const mergeBase = execSync('git merge-base HEAD main', {\n                cwd: workspaceRoot,\n                encoding: 'utf-8',\n                stdio: ['pipe', 'pipe', 'pipe'],\n            }).trim();\n\n            if (mergeBase) {\n                return mergeBase;\n            }\n        } catch {\n            // Ignore\n        }\n    }\n    return null;\n}\n\n/**\n * Get today's date in yyyy/mm/dd format for error messages\n */\nfunction getTodayDateString(): string {\n    const now = new Date();\n    const year = now.getFullYear();\n    const month = String(now.getMonth() + 1).padStart(2, '0');\n    const day = String(now.getDate()).padStart(2, '0');\n    return `${year}/${month}/${day}`;\n}\n\n/**\n * Report violations to console\n */\n// webpieces-disable max-lines-new-methods -- Error output formatting with multiple message sections\nfunction reportViolations(violations: FileViolation[], limit: number, disableAllowed: boolean): void {\n    console.error('');\n    console.error('\\u274c YOU MUST FIX THIS AND NOT be more than ' + limit + ' lines of code per file');\n    console.error('   as it slows down IDEs AND is VERY VERY EASY to refactor.');\n    console.error('');\n    console.error('\\ud83d\\udcda With stateless systems + dependency injection, refactor is trivial:');\n    console.error('   Pick a method or a few and move to new class XXXXX, then inject XXXXX');\n    console.error('   into all users of those methods via the constructor.');\n    console.error('   Delete those methods from original class.');\n    console.error('   99% of files can be less than ' + limit + ' lines of code.');\n    console.error('');\n    console.error('\\u26a0\\ufe0f  *** READ tmp/webpieces/webpieces.filesize.md for detailed guidance on how to fix this easily *** \\u26a0\\ufe0f');\n    console.error('');\n\n    for (const v of violations) {\n        if (v.expiredDisable) {\n            console.error(`  \\u274c ${v.file} (${v.lines} lines, max: ${limit})`);\n            console.error(`     \\u23f0 EXPIRED DISABLE: Your disable comment dated ${v.expiredDate} has expired (>1 month old).`);\n            console.error(`        You must either FIX the file or UPDATE the date to get another month.`);\n        } else {\n            console.error(`  \\u274c ${v.file} (${v.lines} lines, max: ${limit})`);\n        }\n    }\n    console.error('');\n\n    // Only show escape hatch instructions when disableAllowed is true\n    if (disableAllowed) {\n        console.error('   You can disable this error, but you will be forced to fix again in 1 month');\n        console.error('   since 99% of files can be less than ' + limit + ' lines of code.');\n        console.error('');\n        console.error('   Use escape with DATE (expires in 1 month):');\n        console.error(`   // webpieces-disable max-lines-modified-files ${getTodayDateString()} -- [your reason]`);\n        console.error('');\n    } else {\n        console.error('   \\u26a0\\ufe0f  disableAllowed is false - disable comments are NOT allowed.');\n        console.error('   This rule must be met and cannot be disabled since nx.json disableAllowed is set to false.');\n        console.error('   You MUST refactor to reduce file size.');\n        console.error('');\n        console.error('   For a major refactor, a human can add \"ignoreModifiedUntilEpoch\" to nx.json validate-code options.');\n        console.error('   This is an expiry timestamp (epoch ms) for when we start forcing everyone to meet size rules again.');\n        console.error('   Sometimes for speed, we allow files to expand during a refactor and over time,');\n        console.error('   each PR reduces files as they get touched.');\n        console.error('   AI agents should NOT add ignoreModifiedUntilEpoch - ask a human to do it.');\n        console.error('');\n    }\n}\n\nexport default async function runExecutor(\n    options: ValidateModifiedFilesOptions,\n    context: ExecutorContext\n): Promise<ExecutorResult> {\n    const workspaceRoot = context.root;\n    const limit = options.limit ?? 900;\n    const mode: FileMaxLimitMode = options.mode ?? 'MODIFIED_FILES';\n    const disableAllowed = options.disableAllowed ?? true;\n\n    // Skip validation entirely if mode is OFF\n    if (mode === 'OFF') {\n        console.log('\\n\\u23ed\\ufe0f  Skipping modified files validation (mode: OFF)');\n        console.log('');\n        return { success: true };\n    }\n\n    // If NX_HEAD is set (via nx affected --head=X), use it; otherwise compare to working tree\n    let base = process.env['NX_BASE'];\n    const head = process.env['NX_HEAD'];\n\n    if (!base) {\n        base = detectBase(workspaceRoot) ?? undefined;\n\n        if (!base) {\n            console.log('\\n\\u23ed\\ufe0f  Skipping modified files validation (could not detect base branch)');\n            console.log('   To run explicitly: nx affected --target=validate-modified-files --base=origin/main');\n            console.log('');\n            return { success: true };\n        }\n\n        console.log('\\n\\ud83d\\udccf Validating Modified File Sizes (auto-detected base)\\n');\n    } else {\n        console.log('\\n\\ud83d\\udccf Validating Modified File Sizes\\n');\n    }\n\n    console.log(`   Base: ${base}`);\n    console.log(`   Head: ${head ?? 'working tree (includes uncommitted changes)'}`);\n    console.log(`   Mode: ${mode}`);\n    console.log(`   Max lines for modified files: ${limit}`);\n    console.log(`   Disable allowed: ${disableAllowed}${!disableAllowed ? ' (no escape hatch)' : ''}`);\n    console.log('');\n\n    try {\n        const changedFiles = getChangedTypeScriptFiles(workspaceRoot, base, head);\n\n        if (changedFiles.length === 0) {\n            console.log('\\u2705 No TypeScript files changed');\n            return { success: true };\n        }\n\n        console.log(`\\ud83d\\udcc2 Checking ${changedFiles.length} changed file(s)...`);\n\n        const violations = findViolations(workspaceRoot, changedFiles, limit, disableAllowed);\n\n        if (violations.length === 0) {\n            console.log('\\u2705 All modified files are under ' + limit + ' lines');\n            return { success: true };\n        }\n\n        writeTmpInstructions(workspaceRoot);\n        reportViolations(violations, limit, disableAllowed);\n        return { success: false };\n    } catch (err: unknown) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        console.error('\\u274c Modified files validation failed:', error.message);\n        return { success: false };\n    }\n}\n"]}