@webpieces/dev-config 0.2.94 → 0.2.97

package/architecture/executors/validate-return-types/executor.ts

@@ -1,524 +0,0 @@
-/**
- * Validate Return Types Executor
- *
- * Validates that methods have explicit return type annotations for better code readability.
- * Instead of relying on TypeScript's type inference, explicit return types make code clearer:
- *
- * BAD:  method() { return new MyClass(); }
- * GOOD: method(): MyClass { return new MyClass(); }
- * GOOD: async method(): Promise<MyType> { ... }
- *
- * Modes:
- * - OFF: Skip validation entirely
- * - NEW_METHODS: Only validate new methods (detected via git diff)
- * - NEW_AND_MODIFIED_METHODS: Validate new methods + methods with changes in their line range
- * - MODIFIED_FILES: Validate all methods in modified files
- *
- * Escape hatch: Add webpieces-disable require-return-type comment with justification
- */
-
-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 ReturnTypeMode = 'OFF' | 'NEW_METHODS' | 'NEW_AND_MODIFIED_METHODS' | 'MODIFIED_FILES';
-
-export interface ValidateReturnTypesOptions {
-    mode?: ReturnTypeMode;
-    disableAllowed?: boolean;
-    ignoreModifiedUntilEpoch?: number;
-}
-
-export interface ExecutorResult {
-    success: boolean;
-}
-
-interface MethodViolation {
-    file: string;
-    methodName: string;
-    line: number;
-}
-
-/**
- * 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 find newly added method signatures.
- */
-function findNewMethodSignaturesInDiff(diffContent: string): Set<string> {
-    const newMethods = new Set<string>();
-    const lines = diffContent.split('\n');
-
-    const patterns = [
-        /^\+\s*(?:export\s+)?(?:async\s+)?function\s+(\w+)\s*\(/,
-        /^\+\s*(?:export\s+)?(?:const|let)\s+(\w+)\s*=\s*(?:async\s*)?\(/,
-        /^\+\s*(?:export\s+)?(?:const|let)\s+(\w+)\s*=\s*(?:async\s+)?function/,
-        /^\+\s*(?:(?:public|private|protected)\s+)?(?:static\s+)?(?:async\s+)?(\w+)\s*\(/,
-    ];
-
-    for (const line of lines) {
-        if (line.startsWith('+') && !line.startsWith('+++')) {
-            for (const pattern of patterns) {
-                const match = line.match(pattern);
-                if (match) {
-                    const methodName = match[1];
-                    if (methodName && !['if', 'for', 'while', 'switch', 'catch', 'constructor'].includes(methodName)) {
-                        newMethods.add(methodName);
-                    }
-                    break;
-                }
-            }
-        }
-    }
-
-    return newMethods;
-}
-
-/**
- * Check if a line contains a webpieces-disable comment for return type.
- */
-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('require-return-type')) {
-            return true;
-        }
-    }
-    return false;
-}
-
-/**
- * Check if a method has an explicit return type annotation.
- */
-function hasExplicitReturnType(node: ts.MethodDeclaration | ts.FunctionDeclaration | ts.ArrowFunction): boolean {
-    return node.type !== undefined;
-}
-
-interface MethodInfo {
-    name: string;
-    line: number;
-    endLine: number;
-    hasReturnType: boolean;
-    hasDisableComment: boolean;
-}
-
-/**
- * Parse a TypeScript file and find methods with their return type status.
- */
-// webpieces-disable max-lines-new-methods -- AST traversal requires inline visitor function
-function findMethodsInFile(filePath: string, workspaceRoot: string): MethodInfo[] {
-    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 methods: MethodInfo[] = [];
-
-    // webpieces-disable max-lines-new-methods -- AST visitor pattern requires handling multiple node types
-    function visit(node: ts.Node): void {
-        let methodName: string | undefined;
-        let startLine: number | undefined;
-        let endLine: number | undefined;
-        let hasReturnType = false;
-
-        if (ts.isMethodDeclaration(node) && node.name) {
-            methodName = node.name.getText(sourceFile);
-            const start = sourceFile.getLineAndCharacterOfPosition(node.getStart());
-            const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
-            startLine = start.line + 1;
-            endLine = end.line + 1;
-            hasReturnType = hasExplicitReturnType(node);
-        } else if (ts.isFunctionDeclaration(node) && node.name) {
-            methodName = node.name.getText(sourceFile);
-            const start = sourceFile.getLineAndCharacterOfPosition(node.getStart());
-            const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
-            startLine = start.line + 1;
-            endLine = end.line + 1;
-            hasReturnType = hasExplicitReturnType(node);
-        } else if (ts.isArrowFunction(node)) {
-            if (ts.isVariableDeclaration(node.parent) && ts.isIdentifier(node.parent.name)) {
-                methodName = node.parent.name.getText(sourceFile);
-                const start = sourceFile.getLineAndCharacterOfPosition(node.getStart());
-                const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
-                startLine = start.line + 1;
-                endLine = end.line + 1;
-                hasReturnType = hasExplicitReturnType(node);
-            }
-        }
-
-        if (methodName && startLine !== undefined && endLine !== undefined) {
-            methods.push({
-                name: methodName,
-                line: startLine,
-                endLine,
-                hasReturnType,
-                hasDisableComment: hasDisableComment(fileLines, startLine),
-            });
-        }
-
-        ts.forEachChild(node, visit);
-    }
-
-    visit(sourceFile);
-    return methods;
-}
-
-/**
- * Parse diff to extract changed line numbers (both additions and modifications).
- */
-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 method has any changed lines within its range.
- */
-function methodHasChanges(method: MethodInfo, changedLines: Set<number>): boolean {
-    for (let line = method.line; line <= method.endLine; line++) {
-        if (changedLines.has(line)) {
-            return true;
-        }
-    }
-    return false;
-}
-
-/**
- * Find NEW methods without explicit return types (NEW_METHODS mode).
- */
-// webpieces-disable max-lines-new-methods -- File iteration with diff parsing and method matching
-function findViolationsForNewMethods(
-    workspaceRoot: string,
-    changedFiles: string[],
-    base: string,
-    head: string | undefined,
-    disableAllowed: boolean
-): MethodViolation[] {
-    const violations: MethodViolation[] = [];
-
-    for (const file of changedFiles) {
-        const diff = getFileDiff(workspaceRoot, file, base, head);
-        const newMethodNames = findNewMethodSignaturesInDiff(diff);
-
-        if (newMethodNames.size === 0) continue;
-
-        const methods = findMethodsInFile(file, workspaceRoot);
-
-        for (const method of methods) {
-            if (!newMethodNames.has(method.name)) continue;
-            if (method.hasReturnType) continue;
-            if (disableAllowed && method.hasDisableComment) continue;
-
-            violations.push({
-                file,
-                methodName: method.name,
-                line: method.line,
-            });
-        }
-    }
-
-    return violations;
-}
-
-/**
- * Find NEW methods AND methods with changes (NEW_AND_MODIFIED_METHODS mode).
- */
-// webpieces-disable max-lines-new-methods -- Combines new method detection with change detection
-function findViolationsForModifiedAndNewMethods(
-    workspaceRoot: string,
-    changedFiles: string[],
-    base: string,
-    head: string | undefined,
-    disableAllowed: boolean
-): MethodViolation[] {
-    const violations: MethodViolation[] = [];
-
-    for (const file of changedFiles) {
-        const diff = getFileDiff(workspaceRoot, file, base, head);
-        const newMethodNames = findNewMethodSignaturesInDiff(diff);
-        const changedLines = getChangedLineNumbers(diff);
-
-        const methods = findMethodsInFile(file, workspaceRoot);
-
-        for (const method of methods) {
-            if (method.hasReturnType) continue;
-            if (disableAllowed && method.hasDisableComment) continue;
-
-            const isNewMethod = newMethodNames.has(method.name);
-            const isModifiedMethod = methodHasChanges(method, changedLines);
-
-            if (!isNewMethod && !isModifiedMethod) continue;
-
-            violations.push({
-                file,
-                methodName: method.name,
-                line: method.line,
-            });
-        }
-    }
-
-    return violations;
-}
-
-/**
- * Find all methods without explicit return types in modified files (MODIFIED_FILES mode).
- */
-function findViolationsForModifiedFiles(workspaceRoot: string, changedFiles: string[], disableAllowed: boolean): MethodViolation[] {
-    const violations: MethodViolation[] = [];
-
-    for (const file of changedFiles) {
-        const methods = findMethodsInFile(file, workspaceRoot);
-
-        for (const method of methods) {
-            if (method.hasReturnType) continue;
-            if (disableAllowed && method.hasDisableComment) continue;
-
-            violations.push({
-                file,
-                methodName: method.name,
-                line: method.line,
-            });
-        }
-    }
-
-    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: MethodViolation[], mode: ReturnTypeMode): void {
-    console.error('');
-    console.error('❌ Methods missing explicit return types!');
-    console.error('');
-    console.error('📚 Explicit return types improve code readability:');
-    console.error('');
-    console.error('   BAD:  method() { return new MyClass(); }');
-    console.error('   GOOD: method(): MyClass { return new MyClass(); }');
-    console.error('   GOOD: async method(): Promise<MyType> { ... }');
-    console.error('');
-
-    for (const v of violations) {
-        console.error(`  ❌ ${v.file}:${v.line}`);
-        console.error(`     Method: ${v.methodName} - missing return type annotation`);
-    }
-    console.error('');
-
-    console.error('   To fix: Add explicit return type after the parameter list');
-    console.error('');
-    console.error('   Escape hatch (use sparingly):');
-    console.error('   // webpieces-disable require-return-type -- [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: ReturnTypeMode, epoch: number | undefined): ReturnTypeMode {
-    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 require-return-type validation (ignoreModifiedUntilEpoch active, expires: ${expiresDate})`);
-        console.log('');
-        return 'OFF';
-    }
-    return normalMode;
-}
-
-export default async function runExecutor(
-    options: ValidateReturnTypesOptions,
-    context: ExecutorContext
-): Promise<ExecutorResult> {
-    const workspaceRoot = context.root;
-    const mode: ReturnTypeMode = resolveMode(options.mode ?? 'NEW_METHODS', options.ignoreModifiedUntilEpoch);
-    const disableAllowed = options.disableAllowed ?? true;
-
-    if (mode === 'OFF') {
-        console.log('\n⏭️  Skipping return type validation (mode: OFF)');
-        console.log('');
-        return { success: true };
-    }
-
-    console.log('\n📏 Validating Return Types\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 return type 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: MethodViolation[] = [];
-
-    if (mode === 'NEW_METHODS') {
-        violations = findViolationsForNewMethods(workspaceRoot, changedFiles, base, head, disableAllowed);
-    } else if (mode === 'NEW_AND_MODIFIED_METHODS') {
-        violations = findViolationsForModifiedAndNewMethods(workspaceRoot, changedFiles, base, head, disableAllowed);
-    } else if (mode === 'MODIFIED_FILES') {
-        violations = findViolationsForModifiedFiles(workspaceRoot, changedFiles, disableAllowed);
-    }
-
-    if (violations.length === 0) {
-        console.log('✅ All methods have explicit return types');
-        return { success: true };
-    }
-
-    reportViolations(violations, mode);
-
-    return { success: false };
-}

package/architecture/executors/validate-return-types/schema.json

@@ -1,24 +0,0 @@
-{
-    "$schema": "http://json-schema.org/schema",
-    "title": "Validate Return Types Executor",
-    "description": "Validates that methods have explicit return type annotations for better code readability.",
-    "type": "object",
-    "properties": {
-        "mode": {
-            "type": "string",
-            "enum": ["OFF", "NEW_METHODS", "NEW_AND_MODIFIED_METHODS", "MODIFIED_FILES"],
-            "description": "OFF: skip validation. NEW_METHODS: only new methods in diff. NEW_AND_MODIFIED_METHODS: new methods + methods with changes. MODIFIED_FILES: all methods in modified files.",
-            "default": "NEW_METHODS"
-        },
-        "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/visualize/executor.d.ts

@@ -1,17 +0,0 @@
-/**
- * Visualize Executor
- *
- * Generates visual representations of the architecture graph (DOT + HTML)
- * and opens the visualization in a browser.
- *
- * Usage:
- * nx run architecture:visualize
- */
-import type { ExecutorContext } from '@nx/devkit';
-export interface VisualizeExecutorOptions {
-    graphPath?: string;
-}
-export interface ExecutorResult {
-    success: boolean;
-}
-export default function runExecutor(options: VisualizeExecutorOptions, context: ExecutorContext): Promise<ExecutorResult>;

package/architecture/executors/visualize/executor.js

@@ -1,49 +0,0 @@
-"use strict";
-/**
- * Visualize Executor
- *
- * Generates visual representations of the architecture graph (DOT + HTML)
- * and opens the visualization in a browser.
- *
- * Usage:
- * nx run architecture:visualize
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = runExecutor;
-const graph_loader_1 = require("../../lib/graph-loader");
-const graph_visualizer_1 = require("../../lib/graph-visualizer");
-async function runExecutor(options, context) {
-    const { graphPath } = options;
-    const workspaceRoot = context.root;
-    console.log('\n🎨 Architecture Visualization\n');
-    try {
-        // Load the saved graph
-        console.log('📂 Loading saved graph...');
-        const graph = (0, graph_loader_1.loadBlessedGraph)(workspaceRoot, graphPath);
-        if (!graph) {
-            console.error('❌ No saved graph found at architecture/dependencies.json');
-            console.error('   Run: nx run architecture:generate first');
-            return { success: false };
-        }
-        // Generate visualization
-        console.log('🎨 Generating visualization...');
-        const { dotPath, htmlPath } = (0, graph_visualizer_1.writeVisualization)(graph, workspaceRoot);
-        console.log(`✅ Generated: ${dotPath}`);
-        console.log(`✅ Generated: ${htmlPath}`);
-        // Try to open in browser
-        console.log('\n🌐 Opening visualization in browser...');
-        if ((0, graph_visualizer_1.openVisualization)(htmlPath)) {
-            console.log('✅ Browser opened');
-        }
-        else {
-            console.log(`⚠️  Could not auto-open. Open manually: ${htmlPath}`);
-        }
-        return { success: true };
-    }
-    catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        console.error('❌ Visualization failed:', error.message);
-        return { success: false };
-    }
-}
-//# sourceMappingURL=executor.js.map

package/architecture/executors/visualize/executor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/architecture/executors/visualize/executor.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAcH,8BAwCC;AAnDD,yDAA0D;AAC1D,iEAAmF;AAUpE,KAAK,UAAU,WAAW,CACrC,OAAiC,EACjC,OAAwB;IAExB,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC9B,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IAEjD,IAAI,CAAC;QACD,uBAAuB;QACvB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAA,+BAAgB,EAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAEzD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;YAC1E,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC9C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAA,qCAAkB,EAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC;QAExC,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,IAAI,IAAA,oCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,2CAA2C,QAAQ,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,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,yBAAyB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;AACL,CAAC","sourcesContent":["/**\n * Visualize Executor\n *\n * Generates visual representations of the architecture graph (DOT + HTML)\n * and opens the visualization in a browser.\n *\n * Usage:\n * nx run architecture:visualize\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { loadBlessedGraph } from '../../lib/graph-loader';\nimport { writeVisualization, openVisualization } from '../../lib/graph-visualizer';\n\nexport interface VisualizeExecutorOptions {\n    graphPath?: string;\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nexport default async function runExecutor(\n    options: VisualizeExecutorOptions,\n    context: ExecutorContext\n): Promise<ExecutorResult> {\n    const { graphPath } = options;\n    const workspaceRoot = context.root;\n\n    console.log('\\n🎨 Architecture Visualization\\n');\n\n    try {\n        // Load the saved graph\n        console.log('📂 Loading saved graph...');\n        const graph = loadBlessedGraph(workspaceRoot, graphPath);\n\n        if (!graph) {\n            console.error('❌ No saved graph found at architecture/dependencies.json');\n            console.error('   Run: nx run architecture:generate first');\n            return { success: false };\n        }\n\n        // Generate visualization\n        console.log('🎨 Generating visualization...');\n        const { dotPath, htmlPath } = writeVisualization(graph, workspaceRoot);\n        console.log(`✅ Generated: ${dotPath}`);\n        console.log(`✅ Generated: ${htmlPath}`);\n\n        // Try to open in browser\n        console.log('\\n🌐 Opening visualization in browser...');\n        if (openVisualization(htmlPath)) {\n            console.log('✅ Browser opened');\n        } else {\n            console.log(`⚠️  Could not auto-open. Open manually: ${htmlPath}`);\n        }\n\n        return { success: true };\n    } catch (err: unknown) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        console.error('❌ Visualization failed:', error.message);\n        return { success: false };\n    }\n}\n"]}

package/architecture/executors/visualize/executor.ts

@@ -1,63 +0,0 @@
-/**
- * Visualize Executor
- *
- * Generates visual representations of the architecture graph (DOT + HTML)
- * and opens the visualization in a browser.
- *
- * Usage:
- * nx run architecture:visualize
- */
-
-import type { ExecutorContext } from '@nx/devkit';
-import { loadBlessedGraph } from '../../lib/graph-loader';
-import { writeVisualization, openVisualization } from '../../lib/graph-visualizer';
-
-export interface VisualizeExecutorOptions {
-    graphPath?: string;
-}
-
-export interface ExecutorResult {
-    success: boolean;
-}
-
-export default async function runExecutor(
-    options: VisualizeExecutorOptions,
-    context: ExecutorContext
-): Promise<ExecutorResult> {
-    const { graphPath } = options;
-    const workspaceRoot = context.root;
-
-    console.log('\n🎨 Architecture Visualization\n');
-
-    try {
-        // Load the saved graph
-        console.log('📂 Loading saved graph...');
-        const graph = loadBlessedGraph(workspaceRoot, graphPath);
-
-        if (!graph) {
-            console.error('❌ No saved graph found at architecture/dependencies.json');
-            console.error('   Run: nx run architecture:generate first');
-            return { success: false };
-        }
-
-        // Generate visualization
-        console.log('🎨 Generating visualization...');
-        const { dotPath, htmlPath } = writeVisualization(graph, workspaceRoot);
-        console.log(`✅ Generated: ${dotPath}`);
-        console.log(`✅ Generated: ${htmlPath}`);
-
-        // Try to open in browser
-        console.log('\n🌐 Opening visualization in browser...');
-        if (openVisualization(htmlPath)) {
-            console.log('✅ Browser opened');
-        } else {
-            console.log(`⚠️  Could not auto-open. Open manually: ${htmlPath}`);
-        }
-
-        return { success: true };
-    } catch (err: unknown) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        console.error('❌ Visualization failed:', error.message);
-        return { success: false };
-    }
-}