@webpieces/dev-config 0.2.95 → 0.2.98

package/architecture/executors/validate-no-architecture-cycles/executor.ts

@@ -1,60 +0,0 @@
-/**
- * Validate No Architecture Cycles Executor
- *
- * Validates that the architecture dependency graph has no circular dependencies.
- * This is a fast check that only validates acyclicity at the project level.
- *
- * Usage:
- * nx run architecture:validate-no-architecture-cycles
- */
-
-import type { ExecutorContext } from '@nx/devkit';
-import { generateGraph } from '../../lib/graph-generator';
-import { sortGraphTopologically } from '../../lib/graph-sorter';
-
-export interface ValidateNoCyclesOptions {
-    // No options needed
-}
-
-export interface ExecutorResult {
-    success: boolean;
-}
-
-export default async function runExecutor(
-    _options: ValidateNoCyclesOptions,
-    _context: ExecutorContext
-): Promise<ExecutorResult> {
-    console.log('\n🔄 Validating No Circular Dependencies\n');
-
-    try {
-        // Step 1: Generate current graph from project.json files
-        console.log('📊 Generating dependency graph from project.json files...');
-        const rawGraph = await generateGraph();
-
-        // Step 2: Topological sort (validates acyclic)
-        console.log('🔄 Checking for cycles (topological sort)...');
-        try {
-            sortGraphTopologically(rawGraph);
-            console.log('✅ No circular dependencies detected!');
-
-            // Print summary
-            const projectCount = Object.keys(rawGraph).length;
-            console.log(`\n📈 Summary: ${projectCount} projects, all acyclic`);
-
-            return { success: true };
-        } catch (err: unknown) {
-            const error = err instanceof Error ? err : new Error(String(err));
-            console.error('❌ Circular dependency detected!');
-            console.error(error.message);
-            console.error('\nTo fix:');
-            console.error('  1. Review the cycle above');
-            console.error('  2. Break the cycle by refactoring dependencies');
-            console.error('  3. Run this check again');
-            return { success: false };
-        }
-    } catch (err: unknown) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        console.error('❌ Cycle validation failed:', error.message);
-        return { success: false };
-    }
-}

package/architecture/executors/validate-no-architecture-cycles/schema.json

@@ -1,8 +0,0 @@
-{
-    "$schema": "http://json-schema.org/schema",
-    "title": "Validate No Cycles Executor",
-    "description": "Validates that the architecture graph has no circular dependencies",
-    "type": "object",
-    "properties": {},
-    "required": []
-}

package/architecture/executors/validate-no-destructure/executor.d.ts

@@ -1,52 +0,0 @@
-/**
- * Validate No Destructure Executor
- *
- * Validates that destructuring patterns are not used in TypeScript code.
- * Uses LINE-BASED detection (not method-based) for git diff filtering.
- *
- * ============================================================================
- * VIOLATIONS (BAD) - These patterns are flagged:
- * ============================================================================
- *
- * - const { x, y } = obj          — object destructuring in variable declarations
- * - const [a, b] = fn()           — array destructuring (except Promise.all)
- * - for (const { email } of items) — object destructuring in for-of loops
- * - for (const [a, b] of items)   — array destructuring in for-of (except Object.entries)
- * - const { page = 0 } = opts     — destructuring with defaults
- * - const { done: streamDone } = obj — destructuring with renaming
- * - function foo({ x, y }: Type)  — function parameter destructuring
- *
- * ============================================================================
- * ALLOWED (skip — NOT violations)
- * ============================================================================
- *
- * - const [a, b] = await Promise.all([...]) — Promise.all array destructuring
- * - for (const [key, value] of Object.entries(obj)) — Object.entries in for-of
- * - const { extracted, ...rest } = obj — rest operator separation
- * - Lines with // webpieces-disable no-destructure -- [reason] (only when disableAllowed: true)
- *
- * ============================================================================
- * MODES (LINE-BASED)
- * ============================================================================
- * - OFF:            Skip validation entirely
- * - MODIFIED_CODE:  Flag destructuring on changed lines (lines in diff hunks)
- * - MODIFIED_FILES: Flag ALL destructuring in files that were modified
- *
- * ============================================================================
- * ESCAPE HATCH
- * ============================================================================
- * Add comment above the violation:
- *   // webpieces-disable no-destructure -- [your justification]
- *   const { x, y } = obj;
- */
-import type { ExecutorContext } from '@nx/devkit';
-export type NoDestructureMode = 'OFF' | 'MODIFIED_CODE' | 'MODIFIED_FILES';
-export interface ValidateNoDestructureOptions {
-    mode?: NoDestructureMode;
-    disableAllowed?: boolean;
-    ignoreModifiedUntilEpoch?: number;
-}
-export interface ExecutorResult {
-    success: boolean;
-}
-export default function runExecutor(options: ValidateNoDestructureOptions, context: ExecutorContext): Promise<ExecutorResult>;

package/architecture/executors/validate-no-destructure/executor.js

@@ -1,491 +0,0 @@
-"use strict";
-/**
- * Validate No Destructure Executor
- *
- * Validates that destructuring patterns are not used in TypeScript code.
- * Uses LINE-BASED detection (not method-based) for git diff filtering.
- *
- * ============================================================================
- * VIOLATIONS (BAD) - These patterns are flagged:
- * ============================================================================
- *
- * - const { x, y } = obj          — object destructuring in variable declarations
- * - const [a, b] = fn()           — array destructuring (except Promise.all)
- * - for (const { email } of items) — object destructuring in for-of loops
- * - for (const [a, b] of items)   — array destructuring in for-of (except Object.entries)
- * - const { page = 0 } = opts     — destructuring with defaults
- * - const { done: streamDone } = obj — destructuring with renaming
- * - function foo({ x, y }: Type)  — function parameter destructuring
- *
- * ============================================================================
- * ALLOWED (skip — NOT violations)
- * ============================================================================
- *
- * - const [a, b] = await Promise.all([...]) — Promise.all array destructuring
- * - for (const [key, value] of Object.entries(obj)) — Object.entries in for-of
- * - const { extracted, ...rest } = obj — rest operator separation
- * - Lines with // webpieces-disable no-destructure -- [reason] (only when disableAllowed: true)
- *
- * ============================================================================
- * MODES (LINE-BASED)
- * ============================================================================
- * - OFF:            Skip validation entirely
- * - MODIFIED_CODE:  Flag destructuring on changed lines (lines in diff hunks)
- * - MODIFIED_FILES: Flag ALL destructuring in files that were modified
- *
- * ============================================================================
- * ESCAPE HATCH
- * ============================================================================
- * Add comment above the violation:
- *   // webpieces-disable no-destructure -- [your justification]
- *   const { x, y } = obj;
- */
-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 ts = tslib_1.__importStar(require("typescript"));
-/**
- * Get changed TypeScript files between base and head (or working tree if head not specified).
- */
-// webpieces-disable max-lines-new-methods -- Git command handling with untracked files requires multiple code paths
-function getChangedTypeScriptFiles(workspaceRoot, base, head) {
-    try {
-        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'));
-        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'));
-                const allFiles = new Set([...changedFiles, ...untrackedFiles]);
-                return Array.from(allFiles);
-            }
-            catch {
-                return changedFiles;
-            }
-        }
-        return changedFiles;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Get the diff content for a specific file.
- */
-function getFileDiff(workspaceRoot, file, base, head) {
-    try {
-        const diffTarget = head ? `${base} ${head}` : base;
-        const diff = (0, child_process_1.execSync)(`git diff ${diffTarget} -- "${file}"`, {
-            cwd: workspaceRoot,
-            encoding: 'utf-8',
-        });
-        if (!diff && !head) {
-            const fullPath = path.join(workspaceRoot, file);
-            if (fs.existsSync(fullPath)) {
-                const isUntracked = (0, child_process_1.execSync)(`git ls-files --others --exclude-standard "${file}"`, {
-                    cwd: workspaceRoot,
-                    encoding: 'utf-8',
-                }).trim();
-                if (isUntracked) {
-                    const content = fs.readFileSync(fullPath, 'utf-8');
-                    const lines = content.split('\n');
-                    return lines.map((line) => `+${line}`).join('\n');
-                }
-            }
-        }
-        return diff;
-    }
-    catch {
-        return '';
-    }
-}
-/**
- * Parse diff to extract changed line numbers (additions only - lines starting with +).
- */
-function getChangedLineNumbers(diffContent) {
-    const changedLines = new Set();
-    const lines = diffContent.split('\n');
-    let currentLine = 0;
-    for (const line of lines) {
-        const hunkMatch = line.match(/^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/);
-        if (hunkMatch) {
-            currentLine = parseInt(hunkMatch[1], 10);
-            continue;
-        }
-        if (line.startsWith('+') && !line.startsWith('+++')) {
-            changedLines.add(currentLine);
-            currentLine++;
-        }
-        else if (line.startsWith('-') && !line.startsWith('---')) {
-            // Deletions don't increment line number
-        }
-        else {
-            currentLine++;
-        }
-    }
-    return changedLines;
-}
-/**
- * Check if a line contains a webpieces-disable comment for no-destructure.
- */
-function hasDisableComment(lines, lineNumber) {
-    const startCheck = Math.max(0, lineNumber - 5);
-    for (let i = lineNumber - 2; i >= startCheck; i--) {
-        const line = lines[i]?.trim() ?? '';
-        if (line.startsWith('function ') || line.startsWith('class ') || line.endsWith('}')) {
-            break;
-        }
-        if (line.includes('webpieces-disable') && line.includes('no-destructure')) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Check if an ArrayBindingPattern's initializer is `await Promise.all(...)`.
- */
-function isPromiseAllDestructure(node) {
-    const parent = node.parent;
-    if (!ts.isVariableDeclaration(parent))
-        return false;
-    const initializer = parent.initializer;
-    if (!initializer)
-        return false;
-    // Handle: const [a, b] = await Promise.all([...])
-    if (ts.isAwaitExpression(initializer)) {
-        const awaitedExpr = initializer.expression;
-        if (ts.isCallExpression(awaitedExpr)) {
-            const callExpr = awaitedExpr.expression;
-            // Promise.all(...)
-            if (ts.isPropertyAccessExpression(callExpr) && callExpr.name.text === 'all') {
-                const obj = callExpr.expression;
-                if (ts.isIdentifier(obj) && obj.text === 'Promise') {
-                    return true;
-                }
-            }
-        }
-    }
-    return false;
-}
-/**
- * Check if an ArrayBindingPattern in a for-of loop iterates over Object.entries(...).
- */
-function isObjectEntriesForOf(node) {
-    // Walk up: ArrayBindingPattern -> VariableDeclaration -> VariableDeclarationList -> ForOfStatement
-    const varDecl = node.parent;
-    if (!ts.isVariableDeclaration(varDecl))
-        return false;
-    const varDeclList = varDecl.parent;
-    if (!ts.isVariableDeclarationList(varDeclList))
-        return false;
-    const forOfStmt = varDeclList.parent;
-    if (!ts.isForOfStatement(forOfStmt))
-        return false;
-    // Check iterable expression ends with .entries()
-    const iterable = forOfStmt.expression;
-    if (ts.isCallExpression(iterable)) {
-        const callExpr = iterable.expression;
-        if (ts.isPropertyAccessExpression(callExpr) && callExpr.name.text === 'entries') {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Check if an ObjectBindingPattern contains a rest element (...rest).
- */
-function hasRestElement(node) {
-    for (const element of node.elements) {
-        if (element.dotDotDotToken) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Find all destructuring patterns in a file using AST.
- */
-// webpieces-disable max-lines-new-methods -- AST traversal with multiple destructuring pattern checks and exception detection
-function findDestructuringInFile(filePath, workspaceRoot, disableAllowed) {
-    const fullPath = path.join(workspaceRoot, filePath);
-    if (!fs.existsSync(fullPath))
-        return [];
-    const content = fs.readFileSync(fullPath, 'utf-8');
-    const fileLines = content.split('\n');
-    const sourceFile = ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true);
-    const violations = [];
-    // webpieces-disable max-lines-new-methods -- AST visitor needs to handle object/array binding patterns in declarations, for-of, and parameters
-    function visit(node) {
-        try {
-            // Check ObjectBindingPattern
-            if (ts.isObjectBindingPattern(node)) {
-                // Exception: rest operator separation
-                if (hasRestElement(node)) {
-                    ts.forEachChild(node, visit);
-                    return;
-                }
-                const context = getDestructureContext(node);
-                recordViolation(node, context, fileLines, sourceFile, violations, disableAllowed);
-            }
-            // Check ArrayBindingPattern
-            if (ts.isArrayBindingPattern(node)) {
-                // Exception: Promise.all destructure
-                if (isPromiseAllDestructure(node)) {
-                    ts.forEachChild(node, visit);
-                    return;
-                }
-                // Exception: Object.entries in for-of
-                if (isObjectEntriesForOf(node)) {
-                    ts.forEachChild(node, visit);
-                    return;
-                }
-                const context = getDestructureContext(node);
-                recordViolation(node, context, fileLines, sourceFile, violations, disableAllowed);
-            }
-        }
-        catch {
-            // Skip nodes that cause errors during analysis
-        }
-        ts.forEachChild(node, visit);
-    }
-    visit(sourceFile);
-    return violations;
-}
-function recordViolation(node, context, fileLines, sourceFile, violations, disableAllowed) {
-    const startPos = node.getStart(sourceFile);
-    if (startPos >= 0) {
-        const pos = sourceFile.getLineAndCharacterOfPosition(startPos);
-        const line = pos.line + 1;
-        const column = pos.character + 1;
-        const disabled = hasDisableComment(fileLines, line);
-        if (!disableAllowed && disabled) {
-            // When disableAllowed is false, ignore disable comments — still a violation
-            violations.push({ line, column, context, hasDisableComment: false });
-        }
-        else {
-            violations.push({ line, column, context, hasDisableComment: disabled });
-        }
-    }
-}
-/**
- * Get a description of where the destructuring pattern appears.
- */
-function getDestructureContext(node) {
-    const parent = node.parent;
-    if (ts.isParameter(parent)) {
-        return 'function parameter destructuring';
-    }
-    if (ts.isVariableDeclaration(parent)) {
-        const grandparent = parent.parent;
-        if (grandparent && ts.isVariableDeclarationList(grandparent)) {
-            const forOfParent = grandparent.parent;
-            if (forOfParent && ts.isForOfStatement(forOfParent)) {
-                return ts.isObjectBindingPattern(node)
-                    ? 'object destructuring in for-of loop'
-                    : 'array destructuring in for-of loop';
-            }
-        }
-        return ts.isObjectBindingPattern(node)
-            ? 'object destructuring in variable declaration'
-            : 'array destructuring in variable declaration';
-    }
-    return ts.isObjectBindingPattern(node)
-        ? 'object destructuring'
-        : 'array destructuring';
-}
-/**
- * MODIFIED_CODE mode: Flag violations on changed lines in diff hunks.
- */
-// webpieces-disable max-lines-new-methods -- File iteration with diff parsing and line filtering
-function findViolationsForModifiedCode(workspaceRoot, changedFiles, base, head, disableAllowed) {
-    const violations = [];
-    for (const file of changedFiles) {
-        const diff = getFileDiff(workspaceRoot, file, base, head);
-        const changedLines = getChangedLineNumbers(diff);
-        if (changedLines.size === 0)
-            continue;
-        const allViolations = findDestructuringInFile(file, workspaceRoot, disableAllowed);
-        for (const v of allViolations) {
-            if (disableAllowed && v.hasDisableComment)
-                continue;
-            // LINE-BASED: Only include if the violation is on a changed line
-            if (!changedLines.has(v.line))
-                continue;
-            violations.push({
-                file,
-                line: v.line,
-                column: v.column,
-                context: v.context,
-            });
-        }
-    }
-    return violations;
-}
-/**
- * MODIFIED_FILES mode: Flag ALL violations in files that were modified.
- */
-function findViolationsForModifiedFiles(workspaceRoot, changedFiles, disableAllowed) {
-    const violations = [];
-    for (const file of changedFiles) {
-        const allViolations = findDestructuringInFile(file, workspaceRoot, disableAllowed);
-        for (const v of allViolations) {
-            if (disableAllowed && v.hasDisableComment)
-                continue;
-            violations.push({
-                file,
-                line: v.line,
-                column: v.column,
-                context: v.context,
-            });
-        }
-    }
-    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;
-}
-/**
- * Report violations to console.
- */
-// webpieces-disable max-lines-new-methods -- Console output with examples and escape hatch information
-function reportViolations(violations, mode, disableAllowed) {
-    console.error('');
-    console.error('\u274c Destructuring patterns found! Use explicit property access instead.');
-    console.error('');
-    console.error('\ud83d\udcda Avoiding destructuring improves code traceability:');
-    console.error('');
-    console.error('   BAD:  const { name, age } = user;');
-    console.error('   GOOD: const name = user.name;');
-    console.error('         const age = user.age;');
-    console.error('');
-    console.error('   BAD:  function process({ x, y }: Point) { }');
-    console.error('   GOOD: function process(point: Point) { point.x; point.y; }');
-    console.error('');
-    for (const v of violations) {
-        console.error(`  \u274c ${v.file}:${v.line}:${v.column}`);
-        console.error(`     ${v.context}`);
-    }
-    console.error('');
-    console.error('   Allowed exceptions:');
-    console.error('   - const [a, b] = await Promise.all([...])');
-    console.error('   - for (const [key, value] of Object.entries(obj))');
-    console.error('   - const { extracted, ...rest } = obj  (rest operator separation)');
-    console.error('');
-    if (disableAllowed) {
-        console.error('   Escape hatch (use sparingly):');
-        console.error('   // webpieces-disable no-destructure -- [your reason]');
-    }
-    else {
-        console.error('   Escape hatch: DISABLED (disableAllowed: false)');
-        console.error('   Disable comments are ignored. Fix the destructuring directly.');
-    }
-    console.error('');
-    console.error(`   Current mode: ${mode}`);
-    console.error('');
-}
-/**
- * Resolve mode considering ignoreModifiedUntilEpoch override.
- * When active, downgrades to OFF. When expired, logs a warning.
- */
-function resolveNoDestructureMode(normalMode, epoch) {
-    if (epoch === undefined || normalMode === 'OFF') {
-        return normalMode;
-    }
-    const nowSeconds = Date.now() / 1000;
-    if (nowSeconds < epoch) {
-        const expiresDate = new Date(epoch * 1000).toISOString().split('T')[0];
-        console.log(`\n\u23ed\ufe0f  Skipping no-destructure validation (ignoreModifiedUntilEpoch active, expires: ${expiresDate})`);
-        console.log('');
-        return 'OFF';
-    }
-    return normalMode;
-}
-async function runExecutor(options, context) {
-    const workspaceRoot = context.root;
-    const mode = resolveNoDestructureMode(options.mode ?? 'OFF', options.ignoreModifiedUntilEpoch);
-    const disableAllowed = options.disableAllowed ?? true;
-    if (mode === 'OFF') {
-        console.log('\n\u23ed\ufe0f  Skipping no-destructure validation (mode: OFF)');
-        console.log('');
-        return { success: true };
-    }
-    console.log('\n\ud83d\udccf Validating No Destructuring\n');
-    console.log(`   Mode: ${mode}`);
-    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 no-destructure validation (could not detect base branch)');
-            console.log('');
-            return { success: true };
-        }
-    }
-    console.log(`   Base: ${base}`);
-    console.log(`   Head: ${head ?? 'working tree (includes uncommitted changes)'}`);
-    console.log('');
-    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)...`);
-    let violations = [];
-    if (mode === 'MODIFIED_CODE') {
-        violations = findViolationsForModifiedCode(workspaceRoot, changedFiles, base, head, disableAllowed);
-    }
-    else if (mode === 'MODIFIED_FILES') {
-        violations = findViolationsForModifiedFiles(workspaceRoot, changedFiles, disableAllowed);
-    }
-    if (violations.length === 0) {
-        console.log('\u2705 No destructuring patterns found');
-        return { success: true };
-    }
-    reportViolations(violations, mode, disableAllowed);
-    return { success: false };
-}
-//# sourceMappingURL=executor.js.map