@yalehwang/archguard 0.1.0

package/dist/scripts/migrate-to-mermaid.js

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+/**
+ * Migration Tool: PlantUML → Mermaid
+ *
+ * This script safely migrates ArchGuard configuration from PlantUML to Mermaid format.
+ *
+ * Features:
+ * - Automatic backup of existing config
+ * - Format conversion: plantuml/svg → mermaid
+ * - Adds default mermaid configuration
+ * - Preserves all other settings
+ * - Safe and reversible
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Migrate configuration file from PlantUML to Mermaid
+ */
+export async function migrateConfig(configPath) {
+    console.log(`🔄 Migrating ${configPath}...`);
+    try {
+        // Check if config exists
+        const exists = await fs.pathExists(configPath);
+        if (!exists) {
+            console.log(`ℹ️  Config file not found: ${configPath}`);
+            console.log('💡 To create a new config, run:');
+            console.log('  node dist/cli/index.js init');
+            return;
+        }
+        // Read old configuration
+        const oldConfig = await fs.readJson(configPath);
+        // Check if migration is needed
+        if (oldConfig.format === 'mermaid' || !oldConfig.format) {
+            console.log('✅ Already using Mermaid format or no format specified.');
+            console.log('💡 If you want to add mermaid-specific settings, edit the config manually.');
+            return;
+        }
+        if (oldConfig.format !== 'plantuml' && oldConfig.format !== 'svg') {
+            console.log(`ℹ️  Format is "${oldConfig.format}", no migration needed.`);
+            return;
+        }
+        // Backup
+        const backupPath = configPath + '.bak';
+        await fs.copy(configPath, backupPath);
+        console.log(`✅ Backup saved to: ${backupPath}`);
+        // Transform configuration
+        const newConfig = transformConfig(oldConfig);
+        // Save new configuration
+        await fs.writeJson(configPath, newConfig, { spaces: 2 });
+        console.log('✅ Migration complete!');
+        console.log('\n📝 New configuration:');
+        console.log(JSON.stringify(newConfig, null, 2));
+        console.log('\n💡 Next steps:');
+        console.log('  1. Review the new configuration');
+        console.log('  2. Test with: node dist/cli/index.js analyze -s ./src --no-llm-grouping');
+        console.log('  3. If satisfied, delete the backup: rm ' + backupPath);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            console.log(`ℹ️  Config file not found: ${configPath}`);
+            console.log('💡 To create a new config, run:');
+            console.log('  node dist/cli/index.js init');
+        }
+        else {
+            console.error('❌ Migration failed:', error.message);
+            throw error;
+        }
+    }
+}
+/**
+ * Transform old config to new config
+ */
+function transformConfig(oldConfig) {
+    const newConfig = {
+        ...oldConfig,
+        format: 'mermaid',
+        mermaid: {
+            enableLLMGrouping: true,
+            renderer: 'isomorphic',
+            theme: 'default',
+            transparentBackground: true,
+        },
+    };
+    // Preserve CLI settings if they exist
+    if (oldConfig.cli) {
+        newConfig.cli = {
+            ...oldConfig.cli,
+        };
+    }
+    return newConfig;
+}
+/**
+ * Rollback migration using backup file
+ */
+export async function rollbackMigration(configPath) {
+    const backupPath = configPath + '.bak';
+    console.log(`🔄 Rolling back ${configPath}...`);
+    try {
+        const backupExists = await fs.pathExists(backupPath);
+        if (!backupExists) {
+            console.log(`❌ Backup file not found: ${backupPath}`);
+            console.log('ℹ️  Cannot rollback without backup.');
+            return;
+        }
+        // Restore from backup
+        await fs.copy(backupPath, configPath, { overwrite: true });
+        console.log('✅ Rollback complete!');
+        console.log(`ℹ️  Backup preserved at: ${backupPath}`);
+        console.log('💡 Delete backup when satisfied: rm ' + backupPath);
+    }
+    catch (error) {
+        console.error('❌ Rollback failed:', error.message);
+        throw error;
+    }
+}
+/**
+ * Validate migrated configuration
+ */
+export async function validateConfig(configPath) {
+    console.log(`🔍 Validating ${configPath}...`);
+    try {
+        const config = await fs.readJson(configPath);
+        // Check format
+        if (config.format !== 'mermaid' && config.format !== 'json') {
+            console.log(`❌ Invalid format: ${config.format}`);
+            return false;
+        }
+        // Check mermaid config
+        if (config.mermaid) {
+            const { enableLLMGrouping, renderer, theme } = config.mermaid;
+            if (typeof enableLLMGrouping !== 'boolean') {
+                console.log('❌ mermaid.enableLLMGrouping must be a boolean');
+                return false;
+            }
+            if (renderer && !['isomorphic', 'cli'].includes(renderer)) {
+                console.log(`❌ Invalid renderer: ${renderer}`);
+                return false;
+            }
+            if (theme && !['default', 'forest', 'dark', 'neutral'].includes(theme)) {
+                console.log(`❌ Invalid theme: ${theme}`);
+                return false;
+            }
+        }
+        console.log('✅ Configuration is valid!');
+        return true;
+    }
+    catch (error) {
+        console.error('❌ Validation failed:', error.message);
+        return false;
+    }
+}
+// CLI interface
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    const configPath = args[1] || path.join(process.cwd(), 'archguard.config.json');
+    switch (command) {
+        case 'migrate':
+        case undefined:
+            await migrateConfig(configPath);
+            break;
+        case 'rollback':
+            await rollbackMigration(configPath);
+            break;
+        case 'validate':
+            const isValid = await validateConfig(configPath);
+            process.exit(isValid ? 0 : 1);
+            break;
+        case '--help':
+        case '-h':
+            console.log(`
+ArchGuard Migration Tool v2.0
+
+Usage:
+  node scripts/migrate-to-mermaid.js [command] [config-path]
+
+Commands:
+  migrate    Migrate config to Mermaid format (default)
+  rollback   Rollback to previous configuration using backup
+  validate   Validate migrated configuration
+
+Examples:
+  # Migrate default config
+  node scripts/migrate-to-mermaid.js migrate
+
+  # Migrate specific config
+  node scripts/migrate-to-mermaid.js migrate ./my-config.json
+
+  # Rollback migration
+  node scripts/migrate-to-mermaid.js rollback
+
+  # Validate configuration
+  node scripts/migrate-to-mermaid.js validate
+
+Config Path:
+  Default: archguard.config.json in current directory
+  Custom: Specify absolute or relative path
+
+For more information, see: docs/MIGRATION-v2.0.md
+      `);
+            break;
+        default:
+            console.log(`❌ Unknown command: ${command}`);
+            console.log('💡 Run with --help for usage information');
+            process.exit(1);
+    }
+}
+main().catch(error => {
+    console.error('❌ Fatal error:', error);
+    process.exit(1);
+});

package/dist/types/config.d.ts

@@ -0,0 +1,140 @@
+export type DetailLevel = 'package' | 'class' | 'method';
+export interface MermaidConfig {
+    renderer?: 'isomorphic' | 'cli';
+    theme?: 'default' | 'forest' | 'dark' | 'neutral';
+    transparentBackground?: boolean;
+}
+export declare const defaultMermaidConfig: MermaidConfig;
+export type OutputFormat = 'mermaid' | 'json';
+export interface DiagramMetadata {
+    title?: string;
+    subtitle?: string;
+    purpose?: string;
+    primaryActors?: string[];
+    input?: {
+        type: string;
+        description?: string;
+        example?: string;
+    };
+    output?: {
+        description: string;
+        formats?: string[];
+        example?: string;
+    };
+}
+export interface DesignInfo {
+    architectureStyle?: 'layered' | 'event-driven' | 'microkernel' | 'serverless';
+    patterns?: DesignPatternInfo[];
+    principles?: string[];
+    decisions?: ArchitecturalDecision[];
+}
+export interface DesignPatternInfo {
+    name: string;
+    category: PatternCategory;
+    participants: string[];
+    description: string;
+    codeExample?: string;
+}
+export type PatternCategory = 'creational' | 'structural' | 'behavioral' | 'concurrency';
+export interface ArchitecturalDecision {
+    topic: string;
+    decision: string;
+    rationale: string;
+    alternatives?: string[];
+}
+export interface ProcessInfo {
+    stages?: number;
+    stageList?: ProcessStage[];
+    dataFlow?: string;
+    keyDependencies?: string[];
+}
+export interface ProcessStage {
+    order: number;
+    name: string;
+    description: string;
+    namespace?: string;
+    patterns?: string[];
+}
+export interface AnnotationConfig {
+    enableComments?: boolean;
+    highlightPatterns?: boolean;
+    showExternalDeps?: boolean;
+    includeUsageExample?: boolean;
+    enableVisibleTitle?: boolean;
+    visibleTitleSections?: ('title' | 'subtitle' | 'purpose' | 'input' | 'output' | 'patterns' | 'principles' | 'process')[];
+    titlePosition?: 'top' | 'bottom';
+}
+export interface ClassHighlightConfig {
+    highlightClasses?: string[];
+    annotateClasses?: ClassAnnotation[];
+    visibility?: {
+        show?: string[];
+        hide?: string[];
+    };
+}
+export interface ClassAnnotation {
+    className: string;
+    note?: string;
+    stereotypes?: string[];
+    responsibility?: string;
+}
+export interface DiagramConfig {
+    name: string;
+    sources: string[];
+    level: DetailLevel;
+    description?: string;
+    format?: OutputFormat;
+    exclude?: string[];
+    language?: string;
+    languageSpecific?: Record<string, unknown>;
+    metadata?: DiagramMetadata;
+    design?: DesignInfo;
+    process?: ProcessInfo;
+    annotations?: AnnotationConfig;
+    classes?: ClassHighlightConfig;
+}
+export interface GlobalConfig {
+    outputDir: string;
+    format: OutputFormat;
+    mermaid?: MermaidConfig;
+    exclude: string[];
+    cli: {
+        command: string;
+        args: string[];
+        timeout: number;
+    };
+    cache: {
+        enabled: boolean;
+        ttl: number;
+    };
+    concurrency: number;
+    verbose: boolean;
+    maxNodesPerDiagram?: number;
+}
+export interface ArchGuardConfig extends GlobalConfig {
+    diagrams: DiagramConfig[];
+}
+export interface CLIOptions {
+    config?: string;
+    diagrams?: string[];
+    sources?: string[];
+    lang?: string;
+    format?: OutputFormat;
+    outputDir?: string;
+    exclude?: string[];
+    cache?: boolean;
+    concurrency?: number;
+    verbose?: boolean;
+    cliCommand?: string;
+    cliArgs?: string;
+    mermaidTheme?: 'default' | 'forest' | 'dark' | 'neutral';
+    mermaidRenderer?: 'isomorphic' | 'cli';
+    atlas?: boolean;
+    noAtlas?: boolean;
+    atlasLayers?: string;
+    atlasStrategy?: string;
+    atlasNoTests?: boolean;
+    atlasIncludeTests?: boolean;
+    atlasProtocols?: string;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}

package/dist/types/config.js

@@ -0,0 +1,6 @@
+export const defaultMermaidConfig = {
+    renderer: 'isomorphic',
+    theme: 'default',
+    transparentBackground: false,
+};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAsCA,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD,QAAQ,EAAE,YAAY;IACtB,KAAK,EAAE,SAAS;IAChB,qBAAqB,EAAE,KAAK;CAC7B,CAAC"}

package/dist/types/extensions.d.ts

@@ -0,0 +1,224 @@
+export interface ArchJSONExtensions {
+    goAtlas?: GoAtlasExtension;
+    tsAnalysis?: TsAnalysis;
+}
+export declare const GO_ATLAS_EXTENSION_VERSION = "2.0";
+export interface GoAtlasExtension {
+    version: string;
+    layers: GoAtlasLayers;
+    metadata: GoAtlasMetadata;
+}
+export interface GoAtlasLayers {
+    package?: PackageGraph;
+    capability?: CapabilityGraph;
+    goroutine?: GoroutineTopology;
+    flow?: FlowGraph;
+}
+export interface GoAtlasMetadata {
+    generatedAt: string;
+    generationStrategy: {
+        functionBodyStrategy: 'none' | 'selective' | 'full';
+        selectiveConfig?: {
+            triggerNodeTypes: string[];
+            excludedTestFiles: boolean;
+            extractedFunctionCount: number;
+            totalFunctionCount: number;
+        };
+        detectedFrameworks: string[];
+        protocols?: string[];
+        followIndirectCalls: boolean;
+        goplsEnabled: boolean;
+    };
+    completeness: {
+        package: number;
+        capability: number;
+        goroutine: number;
+        flow: number;
+    };
+    performance: {
+        fileCount: number;
+        parseTime: number;
+        totalTime: number;
+        memoryUsage: number;
+    };
+    warnings?: string[];
+}
+export interface PackageGraph {
+    nodes: PackageNode[];
+    edges: PackageDependency[];
+    cycles: PackageCycle[];
+}
+export interface PackageCycle {
+    packages: string[];
+    severity: 'warning' | 'error';
+}
+export interface PackageNode {
+    id: string;
+    name: string;
+    type: 'internal' | 'external' | 'vendor' | 'std' | 'cmd' | 'tests' | 'examples' | 'testutil';
+    fileCount: number;
+    stats?: PackageStats;
+}
+export interface PackageStats {
+    structs: number;
+    interfaces: number;
+    functions: number;
+}
+export interface PackageDependency {
+    from: string;
+    to: string;
+    strength: number;
+    transitive?: boolean;
+}
+export interface CapabilityGraph {
+    nodes: CapabilityNode[];
+    edges: CapabilityRelation[];
+    concreteUsageRisks?: ConcreteUsageRisk[];
+}
+export interface CapabilityNode {
+    id: string;
+    name: string;
+    type: 'interface' | 'struct';
+    package: string;
+    exported: boolean;
+    methodCount?: number;
+    fieldCount?: number;
+    fanIn?: number;
+    fanOut?: number;
+}
+export interface CapabilityRelation {
+    id: string;
+    type: 'implements' | 'uses';
+    source: string;
+    target: string;
+    confidence: number;
+    concreteUsage?: boolean;
+    context?: {
+        fieldType?: boolean;
+        parameterType?: boolean;
+        returnType?: boolean;
+        usageLocations: string[];
+    };
+}
+export interface ConcreteUsageRisk {
+    owner: string;
+    fieldType: string;
+    concreteType: string;
+    location: string;
+}
+export interface GoroutineLifecycleSummary {
+    nodeId: string;
+    spawnTargetName: string;
+    receivesContext: boolean;
+    cancellationCheckAvailable: boolean;
+    hasCancellationCheck?: boolean;
+    cancellationMechanism?: 'context' | 'channel';
+    orphan: boolean;
+}
+export interface GoroutineTopology {
+    nodes: GoroutineNode[];
+    edges: SpawnRelation[];
+    channels: ChannelInfo[];
+    channelEdges: ChannelEdge[];
+    lifecycle?: GoroutineLifecycleSummary[];
+}
+export interface GoroutineNode {
+    id: string;
+    name: string;
+    type: 'main' | 'spawned';
+    spawnType?: 'named_func' | 'anonymous_func' | 'method';
+    package: string;
+    location: {
+        file: string;
+        line: number;
+    };
+    pattern?: GoroutinePattern;
+}
+export type GoroutinePattern = 'worker-pool' | 'pipeline' | 'fan-out' | 'fan-in' | 'orchestrator' | 'unknown';
+export interface SpawnRelation {
+    from: string;
+    to: string;
+    spawnType: 'go-func' | 'go-stmt';
+}
+export interface ChannelInfo {
+    id: string;
+    name: string;
+    type: string;
+    direction: 'send' | 'receive' | 'bidirectional';
+    bufferSize?: number;
+    location: {
+        file: string;
+        line: number;
+    };
+}
+export interface ChannelEdge {
+    from: string;
+    to: string;
+    edgeType: 'make' | 'send' | 'recv';
+}
+export interface FlowGraph {
+    entryPoints: EntryPoint[];
+    callChains: CallChain[];
+}
+export interface EntryPoint {
+    id: string;
+    protocol: EntryPointProtocol;
+    method?: HttpMethod;
+    framework: string;
+    path: string;
+    handler: string;
+    middleware: string[];
+    package?: string;
+    location: {
+        file: string;
+        line: number;
+    };
+}
+export type EntryPointProtocol = string;
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'ANY';
+export type EntryPointType = string;
+export interface CallChain {
+    id: string;
+    entryPoint: string;
+    calls: CallEdge[];
+    errorPath?: CallEdge[];
+}
+export interface CallEdge {
+    from: string;
+    to: string;
+    type: 'direct' | 'interface' | 'indirect';
+    confidence: number;
+}
+export declare const TS_ANALYSIS_EXTENSION_VERSION = "1.0";
+export interface TsAnalysis {
+    version: string;
+    moduleGraph?: TsModuleGraph;
+}
+export interface TsModuleGraph {
+    nodes: TsModuleNode[];
+    edges: TsModuleDependency[];
+    cycles: TsModuleCycle[];
+}
+export interface TsModuleNode {
+    id: string;
+    name: string;
+    type: 'internal' | 'external' | 'node_modules';
+    fileCount: number;
+    stats: {
+        classes: number;
+        interfaces: number;
+        functions: number;
+        enums: number;
+    };
+}
+export interface TsModuleDependency {
+    from: string;
+    to: string;
+    strength: number;
+    importedNames: string[];
+}
+export interface TsModuleCycle {
+    modules: string[];
+    severity: 'warning' | 'error';
+}
+//# sourceMappingURL=extensions.d.ts.map

package/dist/types/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/types/extensions.ts"],"names":[],"mappings":"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"}

package/dist/types/extensions.js

@@ -0,0 +1,3 @@
+export const GO_ATLAS_EXTENSION_VERSION = '2.0';
+export const TS_ANALYSIS_EXTENSION_VERSION = '1.0';
+//# sourceMappingURL=extensions.js.map

package/dist/types/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/types/extensions.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAuPhD,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC"}