@webpieces/dev-config 0.2.94 → 0.2.97

package/architecture/executors/validate-no-any-unknown/executor.ts

@@ -1,540 +0,0 @@
-/**
- * Validate No Any Unknown Executor
- *
- * Validates that `any` and `unknown` TypeScript keywords are not used.
- * Uses LINE-BASED detection (not method-based) for git diff filtering.
- *
- * ============================================================================
- * VIOLATIONS (BAD) - These patterns are flagged:
- * ============================================================================
- *
- * - const x: any = ...
- * - function foo(arg: any): any { }
- * - const data = response as any;
- * - type T = any;
- * - const x: unknown = ...
- * - function foo(arg: unknown): unknown { }
- *
- * ============================================================================
- * MODES (LINE-BASED)
- * ============================================================================
- * - OFF:            Skip validation entirely
- * - MODIFIED_CODE:  Flag any/unknown on changed lines (lines in diff hunks)
- * - MODIFIED_FILES: Flag ALL any/unknown in files that were modified
- *
- * ============================================================================
- * ESCAPE HATCH
- * ============================================================================
- * Add comment above the violation:
- *   // webpieces-disable no-any-unknown -- [your justification]
- *   const x: any = ...;
- */
-
-import type { ExecutorContext } from '@nx/devkit';
-import { execSync } from 'child_process';
-import * as fs from 'fs';
-import * as path from 'path';
-import * as ts from 'typescript';
-
-export type NoAnyUnknownMode = 'OFF' | 'MODIFIED_CODE' | 'MODIFIED_FILES';
-
-export interface ValidateNoAnyUnknownOptions {
-    mode?: NoAnyUnknownMode;
-    disableAllowed?: boolean;
-    ignoreModifiedUntilEpoch?: number;
-}
-
-export interface ExecutorResult {
-    success: boolean;
-}
-
-interface AnyUnknownViolation {
-    file: string;
-    line: number;
-    column: number;
-    keyword: 'any' | 'unknown';
-    context: string;
-}
-
-/**
- * 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: string, base: string, head?: string): string[] {
-    try {
-        const diffTarget = head ? `${base} ${head}` : base;
-        const output = 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 = 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: string, file: string, base: string, head?: string): string {
-    try {
-        const diffTarget = head ? `${base} ${head}` : base;
-        const diff = 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 = 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: string): Set<number> {
-    const changedLines = new Set<number>();
-    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-any-unknown.
- */
-function hasDisableComment(lines: string[], lineNumber: number): boolean {
-    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-any-unknown')) {
-            return true;
-        }
-    }
-    return false;
-}
-
-/**
- * Get a description of the context where the any/unknown keyword appears.
- */
-// webpieces-disable max-lines-new-methods -- Context detection requires checking many AST node types
-function getViolationContext(node: ts.Node, sourceFile: ts.SourceFile): string {
-    try {
-        let current: ts.Node = node;
-        while (current.parent) {
-            const parent = current.parent;
-            if (ts.isParameter(parent)) {
-                return 'parameter type';
-            }
-            if (ts.isFunctionDeclaration(parent) || ts.isMethodDeclaration(parent) || ts.isArrowFunction(parent)) {
-                if (parent.type === current) {
-                    return 'return type';
-                }
-            }
-            if (ts.isVariableDeclaration(parent)) {
-                return 'variable type';
-            }
-            if (ts.isPropertyDeclaration(parent) || ts.isPropertySignature(parent)) {
-                return 'property type';
-            }
-            if (ts.isAsExpression(parent)) {
-                return 'type assertion';
-            }
-            if (ts.isTypeAliasDeclaration(parent)) {
-                return 'type alias';
-            }
-            if (ts.isTypeReferenceNode(parent)) {
-                return 'generic argument';
-            }
-            if (ts.isArrayTypeNode(parent)) {
-                return 'array element type';
-            }
-            if (ts.isUnionTypeNode(parent) || ts.isIntersectionTypeNode(parent)) {
-                return 'union/intersection type';
-            }
-            current = parent;
-        }
-        return 'type position';
-    } catch {
-        return 'type position';
-    }
-}
-
-interface AnyUnknownInfo {
-    line: number;
-    column: number;
-    keyword: 'any' | 'unknown';
-    context: string;
-    hasDisableComment: boolean;
-}
-
-/**
- * Check if a node is in a catch clause variable declaration.
- * This allows `catch (err: any)` and `catch (err: unknown)` patterns.
- */
-function isInCatchClause(node: ts.Node): boolean {
-    let current: ts.Node | undefined = node.parent;
-    while (current) {
-        if (ts.isCatchClause(current)) {
-            // We're somewhere in a catch clause - check if we're in the variable declaration
-            const catchClause = current as ts.CatchClause;
-            if (catchClause.variableDeclaration) {
-                // Walk back up from the original node to see if we're part of the variable declaration
-                let checkNode: ts.Node | undefined = node.parent;
-                while (checkNode && checkNode !== current) {
-                    if (checkNode === catchClause.variableDeclaration) {
-                        return true;
-                    }
-                    checkNode = checkNode.parent;
-                }
-            }
-        }
-        current = current.parent;
-    }
-    return false;
-}
-
-/**
- * Find all `any` and `unknown` keywords in a file using AST.
- */
-// webpieces-disable max-lines-new-methods -- AST traversal with nested visitor function for keyword detection
-function findAnyUnknownInFile(filePath: string, workspaceRoot: string): AnyUnknownInfo[] {
-    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: AnyUnknownInfo[] = [];
-
-    // webpieces-disable max-lines-new-methods -- AST visitor needs to handle both any and unknown keywords with full context detection
-    function visit(node: ts.Node): void {
-        try {
-            // Detect `any` keyword
-            if (node.kind === ts.SyntaxKind.AnyKeyword) {
-                // Skip catch clause variable types: catch (err: any) is allowed
-                if (isInCatchClause(node)) {
-                    ts.forEachChild(node, visit);
-                    return;
-                }
-
-                const startPos = node.getStart(sourceFile);
-                if (startPos >= 0) {
-                    const pos = sourceFile.getLineAndCharacterOfPosition(startPos);
-                    const line = pos.line + 1;
-                    const column = pos.character + 1;
-                    const context = getViolationContext(node, sourceFile);
-                    const disabled = hasDisableComment(fileLines, line);
-
-                    violations.push({
-                        line,
-                        column,
-                        keyword: 'any',
-                        context,
-                        hasDisableComment: disabled,
-                    });
-                }
-            }
-
-            // Detect `unknown` keyword
-            if (node.kind === ts.SyntaxKind.UnknownKeyword) {
-                // Skip catch clause variable types: catch (err: unknown) is allowed
-                if (isInCatchClause(node)) {
-                    ts.forEachChild(node, visit);
-                    return;
-                }
-
-                const startPos = node.getStart(sourceFile);
-                if (startPos >= 0) {
-                    const pos = sourceFile.getLineAndCharacterOfPosition(startPos);
-                    const line = pos.line + 1;
-                    const column = pos.character + 1;
-                    const context = getViolationContext(node, sourceFile);
-                    const disabled = hasDisableComment(fileLines, line);
-
-                    violations.push({
-                        line,
-                        column,
-                        keyword: 'unknown',
-                        context,
-                        hasDisableComment: disabled,
-                    });
-                }
-            }
-        } catch {
-            // Skip nodes that cause errors during analysis
-        }
-
-        ts.forEachChild(node, visit);
-    }
-
-    visit(sourceFile);
-    return violations;
-}
-
-/**
- * MODIFIED_CODE mode: Flag violations on changed lines in diff hunks.
- * This is LINE-BASED detection.
- */
-// webpieces-disable max-lines-new-methods -- File iteration with diff parsing and line filtering
-function findViolationsForModifiedCode(
-    workspaceRoot: string,
-    changedFiles: string[],
-    base: string,
-    head: string | undefined,
-    disableAllowed: boolean
-): AnyUnknownViolation[] {
-    const violations: AnyUnknownViolation[] = [];
-
-    for (const file of changedFiles) {
-        const diff = getFileDiff(workspaceRoot, file, base, head);
-        const changedLines = getChangedLineNumbers(diff);
-
-        if (changedLines.size === 0) continue;
-
-        const allViolations = findAnyUnknownInFile(file, workspaceRoot);
-
-        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,
-                keyword: v.keyword,
-                context: v.context,
-            });
-        }
-    }
-
-    return violations;
-}
-
-/**
- * MODIFIED_FILES mode: Flag ALL violations in files that were modified.
- */
-function findViolationsForModifiedFiles(workspaceRoot: string, changedFiles: string[], disableAllowed: boolean): AnyUnknownViolation[] {
-    const violations: AnyUnknownViolation[] = [];
-
-    for (const file of changedFiles) {
-        const allViolations = findAnyUnknownInFile(file, workspaceRoot);
-
-        for (const v of allViolations) {
-            if (disableAllowed && v.hasDisableComment) continue;
-
-            violations.push({
-                file,
-                line: v.line,
-                column: v.column,
-                keyword: v.keyword,
-                context: v.context,
-            });
-        }
-    }
-
-    return violations;
-}
-
-/**
- * Auto-detect the base branch by finding the merge-base with origin/main.
- */
-function detectBase(workspaceRoot: string): string | null {
-    try {
-        const mergeBase = 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 = 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.
- */
-function reportViolations(violations: AnyUnknownViolation[], mode: NoAnyUnknownMode): void {
-    console.error('');
-    console.error('❌ `any` and `unknown` keywords found! Use specific types instead.');
-    console.error('');
-    console.error('📚 Avoiding any/unknown improves type safety:');
-    console.error('');
-    console.error('   BAD:  const data: any = fetchData();');
-    console.error('   GOOD: const data: UserData = fetchData();');
-    console.error('');
-    console.error('   BAD:  function process(input: unknown): unknown { }');
-    console.error('   GOOD: function process(input: ValidInput): ValidOutput { }');
-    console.error('');
-
-    for (const v of violations) {
-        console.error(`  ❌ ${v.file}:${v.line}:${v.column}`);
-        console.error(`     \`${v.keyword}\` keyword in ${v.context}`);
-    }
-    console.error('');
-
-    console.error('   To fix: Replace with specific types or interfaces');
-    console.error('');
-    console.error('   Escape hatch (use sparingly):');
-    console.error('   // webpieces-disable no-any-unknown -- [your reason]');
-    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 resolveMode(normalMode: NoAnyUnknownMode, epoch: number | undefined): NoAnyUnknownMode {
-    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⏭️  Skipping no-any-unknown validation (ignoreModifiedUntilEpoch active, expires: ${expiresDate})`);
-        console.log('');
-        return 'OFF';
-    }
-    return normalMode;
-}
-
-export default async function runExecutor(
-    options: ValidateNoAnyUnknownOptions,
-    context: ExecutorContext
-): Promise<ExecutorResult> {
-    const workspaceRoot = context.root;
-    const mode: NoAnyUnknownMode = resolveMode(options.mode ?? 'OFF', options.ignoreModifiedUntilEpoch);
-    const disableAllowed = options.disableAllowed ?? true;
-
-    if (mode === 'OFF') {
-        console.log('\n⏭️  Skipping no-any-unknown validation (mode: OFF)');
-        console.log('');
-        return { success: true };
-    }
-
-    console.log('\n📏 Validating No Any/Unknown\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⏭️  Skipping no-any-unknown 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('✅ No TypeScript files changed');
-        return { success: true };
-    }
-
-    console.log(`📂 Checking ${changedFiles.length} changed file(s)...`);
-
-    let violations: AnyUnknownViolation[] = [];
-
-    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('✅ No any/unknown keywords found');
-        return { success: true };
-    }
-
-    reportViolations(violations, mode);
-
-    return { success: false };
-}

package/architecture/executors/validate-no-any-unknown/schema.json

@@ -1,24 +0,0 @@
-{
-    "$schema": "http://json-schema.org/schema",
-    "title": "Validate No Any Unknown Executor",
-    "description": "Validates that `any` and `unknown` TypeScript keywords are not used. Uses LINE-BASED detection for git diff filtering.",
-    "type": "object",
-    "properties": {
-        "mode": {
-            "type": "string",
-            "enum": ["OFF", "MODIFIED_CODE", "MODIFIED_FILES"],
-            "description": "OFF: skip validation. MODIFIED_CODE: only changed lines in diff. MODIFIED_FILES: all in modified files. Disallows `any` and `unknown` TypeScript keywords.",
-            "default": "OFF"
-        },
-        "disableAllowed": {
-            "type": "boolean",
-            "description": "Whether disable comments work. When false, no escape hatch.",
-            "default": true
-        },
-        "ignoreModifiedUntilEpoch": {
-            "type": "number",
-            "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
-        }
-    },
-    "required": []
-}

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

@@ -1,16 +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';
-export interface ValidateNoCyclesOptions {
-}
-export interface ExecutorResult {
-    success: boolean;
-}
-export default function runExecutor(_options: ValidateNoCyclesOptions, _context: ExecutorContext): Promise<ExecutorResult>;

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

@@ -1,48 +0,0 @@
-"use strict";
-/**
- * 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
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = runExecutor;
-const graph_generator_1 = require("../../lib/graph-generator");
-const graph_sorter_1 = require("../../lib/graph-sorter");
-async function runExecutor(_options, _context) {
-    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 (0, graph_generator_1.generateGraph)();
-        // Step 2: Topological sort (validates acyclic)
-        console.log('🔄 Checking for cycles (topological sort)...');
-        try {
-            (0, graph_sorter_1.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) {
-            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) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        console.error('❌ Cycle validation failed:', error.message);
-        return { success: false };
-    }
-}
-//# sourceMappingURL=executor.js.map

package/architecture/executors/validate-no-architecture-cycles/executor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/architecture/executors/validate-no-architecture-cycles/executor.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAcH,8BAqCC;AAhDD,+DAA0D;AAC1D,yDAAgE;AAUjD,KAAK,UAAU,WAAW,CACrC,QAAiC,EACjC,QAAyB;IAEzB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAE1D,IAAI,CAAC;QACD,yDAAyD;QACzD,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAa,GAAE,CAAC;QAEvC,+CAA+C;QAC/C,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,IAAI,CAAC;YACD,IAAA,qCAAsB,EAAC,QAAQ,CAAC,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YAEpD,gBAAgB;YAChB,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,iBAAiB,YAAY,wBAAwB,CAAC,CAAC;YAEnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACjD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;AACL,CAAC","sourcesContent":["/**\n * Validate No Architecture Cycles Executor\n *\n * Validates that the architecture dependency graph has no circular dependencies.\n * This is a fast check that only validates acyclicity at the project level.\n *\n * Usage:\n * nx run architecture:validate-no-architecture-cycles\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { generateGraph } from '../../lib/graph-generator';\nimport { sortGraphTopologically } from '../../lib/graph-sorter';\n\nexport interface ValidateNoCyclesOptions {\n    // No options needed\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nexport default async function runExecutor(\n    _options: ValidateNoCyclesOptions,\n    _context: ExecutorContext\n): Promise<ExecutorResult> {\n    console.log('\\n🔄 Validating No Circular Dependencies\\n');\n\n    try {\n        // Step 1: Generate current graph from project.json files\n        console.log('📊 Generating dependency graph from project.json files...');\n        const rawGraph = await generateGraph();\n\n        // Step 2: Topological sort (validates acyclic)\n        console.log('🔄 Checking for cycles (topological sort)...');\n        try {\n            sortGraphTopologically(rawGraph);\n            console.log('✅ No circular dependencies detected!');\n\n            // Print summary\n            const projectCount = Object.keys(rawGraph).length;\n            console.log(`\\n📈 Summary: ${projectCount} projects, all acyclic`);\n\n            return { success: true };\n        } catch (err: unknown) {\n            const error = err instanceof Error ? err : new Error(String(err));\n            console.error('❌ Circular dependency detected!');\n            console.error(error.message);\n            console.error('\\nTo fix:');\n            console.error('  1. Review the cycle above');\n            console.error('  2. Break the cycle by refactoring dependencies');\n            console.error('  3. Run this check again');\n            return { success: false };\n        }\n    } catch (err: unknown) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        console.error('❌ Cycle validation failed:', error.message);\n        return { success: false };\n    }\n}\n"]}