@vee-stack/delta-cli 2.0.1

package/dist/packages/domain/src/core/analysis/engine.contract.js

@@ -0,0 +1,298 @@
+/**
+ * Core Analysis Engine - Contract v1 Implementation
+ * @description Stateless pipeline implementing AnalysisEngine contract
+ * @implements AnalysisEngine from @/contracts/analysis.contract.js
+ * @module core/analysis
+ * @version 1.0.0
+ */
+import { ANALYSIS_CONTRACT_VERSION, } from '../../contracts/analysis.contract.js';
+import { rulesRegistry } from '../../control/registry/rules.registry.js';
+// =============================================================================
+// ENGINE IMPLEMENTATION
+// =============================================================================
+/**
+ * Analysis Engine v1.0.0
+ * Implements AnalysisEngine contract
+ */
+export class AnalysisEngineV1 {
+    /** Engine version */
+    version = '1.0.0';
+    /** Supported languages */
+    supportedLanguages = [
+        'typescript',
+        'javascript',
+        'python',
+        'java',
+        'go',
+        'rust',
+        'c',
+        'cpp',
+        'csharp',
+        'php',
+        'ruby',
+        'swift',
+        'kotlin',
+        'sql',
+    ];
+    /**
+     * Analyze a complete project
+     */
+    async analyzeProject(input) {
+        const startTime = Date.now();
+        const fileResults = [];
+        for (const file of input.files) {
+            const result = await this.analyzeFile(file, input.config);
+            fileResults.push(result);
+        }
+        const duration = Date.now() - startTime;
+        const summary = this.summarizeFindings(fileResults);
+        return {
+            id: this.generateId(),
+            timestamp: new Date(),
+            projectId: input.projectId,
+            duration,
+            files: fileResults,
+            summary,
+            engineVersion: this.version,
+            contractVersion: ANALYSIS_CONTRACT_VERSION,
+        };
+    }
+    /**
+     * Analyze a single file
+     */
+    async analyzeFile(file, config) {
+        const startTime = Date.now();
+        // Validate language support
+        if (!this.supportsLanguage(file.language)) {
+            return {
+                filePath: file.path,
+                language: file.language,
+                lines: this.countLines(file.content),
+                findings: [],
+                duration: Date.now() - startTime,
+            };
+        }
+        // Convert to internal format
+        const policies = await this.loadPolicies(config);
+        const findings = this.runAnalysis(file, policies);
+        return {
+            filePath: file.path,
+            language: file.language,
+            lines: this.countLines(file.content),
+            findings,
+            duration: Date.now() - startTime,
+        };
+    }
+    /**
+     * Check if language is supported
+     */
+    supportsLanguage(language) {
+        return this.supportedLanguages.includes(language.toLowerCase());
+    }
+    /**
+     * Get supported languages
+     */
+    getSupportedLanguages() {
+        return [...this.supportedLanguages];
+    }
+    // =============================================================================
+    // INTERNAL METHODS (Private - not part of contract)
+    // =============================================================================
+    /**
+     * Load policies from config
+     */
+    async loadPolicies(config) {
+        void config;
+        // TODO: Load from policy registry based on config.policies
+        return [];
+    }
+    /**
+     * Run analysis with policies
+     */
+    runAnalysis(file, policies) {
+        const findings = [];
+        void file.content.split('\n');
+        const ruleInput = {
+            file: file.path,
+            content: file.content,
+            language: file.language,
+            project: {
+                root: file.path,
+                config: {},
+            },
+        };
+        // Apply enabled policies
+        for (const policy of policies) {
+            if (!policy.enabled)
+                continue;
+            try {
+                const ruleFindings = rulesRegistry.execute(policy.id, ruleInput, policy);
+                // Convert internal findings to contract format
+                for (const finding of ruleFindings) {
+                    findings.push({
+                        id: this.generateFindingId(),
+                        severity: this.mapSeverity(finding.severity || 'info'),
+                        category: this.mapCategory(policy.category || 'maintainability'),
+                        message: finding.message,
+                        filePath: file.path,
+                        line: finding.location?.line ?? 1,
+                        column: finding.location?.column ?? 0,
+                        endLine: finding.location?.endLine,
+                        endColumn: finding.location?.endColumn,
+                        ruleId: policy.id,
+                        ruleUrl: finding.documentation,
+                        suggestedFix: finding.suggestion
+                            ? {
+                                description: finding.suggestion,
+                            }
+                            : undefined,
+                        metadata: finding.metadata,
+                    });
+                }
+            }
+            catch (error) {
+                // Log but don't fail - one broken rule shouldn't stop analysis
+                console.error(`Policy ${policy.id} failed:`, error);
+            }
+        }
+        return findings;
+    }
+    /**
+     * Summarize findings across all files
+     */
+    summarizeFindings(files) {
+        const bySeverity = {
+            critical: 0,
+            high: 0,
+            medium: 0,
+            low: 0,
+            info: 0,
+        };
+        const byCategory = {
+            security: 0,
+            performance: 0,
+            architecture: 0,
+            maintainability: 0,
+            documentation: 0,
+            testing: 0,
+            style: 0,
+        };
+        let total = 0;
+        for (const file of files) {
+            for (const finding of file.findings) {
+                bySeverity[finding.severity]++;
+                byCategory[finding.category]++;
+                total++;
+            }
+        }
+        return { bySeverity, byCategory, total };
+    }
+    /**
+     * Count lines in content
+     */
+    countLines(content) {
+        return content.split('\n').length;
+    }
+    /**
+     * Map internal severity to contract severity
+     */
+    mapSeverity(severity) {
+        const mapping = {
+            critical: 'critical',
+            error: 'high',
+            warning: 'medium',
+            info: 'info',
+        };
+        return mapping[severity] || 'info';
+    }
+    /**
+     * Map internal category to contract category
+     */
+    mapCategory(category) {
+        const mapping = {
+            security: 'security',
+            performance: 'performance',
+            architecture: 'architecture',
+            maintainability: 'maintainability',
+            documentation: 'documentation',
+            testing: 'testing',
+            style: 'style',
+        };
+        return mapping[category] || 'maintainability';
+    }
+    /**
+     * Generate unique analysis ID
+     */
+    generateId() {
+        return `analysis_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Generate finding ID
+     */
+    generateFindingId() {
+        return `finding_${Date.now()}_${Math.random().toString(36).substr(2, 6)}`;
+    }
+}
+// =============================================================================
+// LEGACY COMPATIBILITY
+// =============================================================================
+/**
+ * Legacy analyze function (maintained for backward compatibility)
+ * @deprecated Use AnalysisEngineV1.analyzeProject instead
+ */
+export function analyze(files, config, policies) {
+    void config;
+    void new AnalysisEngineV1();
+    const startTime = Date.now();
+    const findings = [];
+    for (const file of files) {
+        // Simplified analysis - full implementation uses engine.analyzeFile
+        const fileFindings = runLegacyAnalysis(file.path, file.content, file.language, policies);
+        findings.push(...fileFindings);
+    }
+    return {
+        findings,
+        duration: Date.now() - startTime,
+        filesAnalyzed: files.length,
+    };
+}
+/**
+ * Legacy analysis helper
+ */
+function runLegacyAnalysis(path, content, language, policies) {
+    const findings = [];
+    const ruleInput = {
+        file: path,
+        content,
+        language,
+        project: { root: path, config: {} },
+    };
+    for (const policy of policies) {
+        if (!policy.enabled)
+            continue;
+        try {
+            const ruleFindings = rulesRegistry.execute(policy.id, ruleInput, policy);
+            for (const f of ruleFindings) {
+                findings.push({
+                    id: `legacy_${Date.now()}_${Math.random().toString(36).substr(2, 6)}`,
+                    severity: f.severity || 'info',
+                    category: 'maintainability',
+                    message: f.message,
+                    filePath: path,
+                    line: f.location?.line ?? 1,
+                    column: f.location?.column ?? 0,
+                    ruleId: policy.id,
+                });
+            }
+        }
+        catch {
+            // Ignore errors in legacy mode
+        }
+    }
+    return findings;
+}
+// =============================================================================
+// EXPORTS
+// =============================================================================
+export { ANALYSIS_CONTRACT_VERSION };
+//# sourceMappingURL=engine.contract.js.map

package/dist/packages/domain/src/core/analysis/engine.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.contract.js","sourceRoot":"","sources":["../../../../../../../../packages/domain/src/core/analysis/engine.contract.ts"],"names":[],"mappings":"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"}

package/dist/packages/domain/src/core/analysis/engine.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Core Analysis Engine
+ * Stateless pipeline for code analysis
+ * @see docs/architecture/OVERVIEW.md#data-flow
+ * @module core/analysis
+ */
+import type { Finding, Policy, AnalysisConfig } from '../../control/schemas/policies.js';
+/**
+ * Analysis Context
+ * Immutable context for analysis session
+ */
+export interface AnalysisContext {
+    readonly config: AnalysisConfig;
+    readonly policies: Policy[];
+    readonly startTime: number;
+    readonly version: string;
+}
+/**
+ * Analysis Session
+ * Manages a single analysis run with frozen configuration
+ */
+export declare class AnalysisSession {
+    private readonly context;
+    constructor(config: AnalysisConfig, policies: readonly Policy[]);
+    /**
+     * Get immutable context
+     */
+    getContext(): AnalysisContext;
+    /**
+     * Analyze a single file
+     */
+    analyzeFile(file: string, content: string, language: string): Finding[];
+}
+/**
+ * Analysis Pipeline
+ * Pure function: input -> rules -> output
+ */
+export declare function analyze(files: Array<{
+    path: string;
+    content: string;
+    language: string;
+}>, config: AnalysisConfig, policies: Policy[]): {
+    findings: Finding[];
+    duration: number;
+    filesAnalyzed: number;
+};
+/**
+ * Create analysis session with frozen snapshot
+ */
+export declare function createSession(config: AnalysisConfig, policies: Policy[]): AnalysisSession;
+//# sourceMappingURL=engine.d.ts.map

package/dist/packages/domain/src/core/analysis/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/domain/src/core/analysis/engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAa,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGpG;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAE9B,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE;IAS/D;;OAEG;IACH,UAAU,IAAI,eAAe;IAI7B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;CAuBxE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EACjE,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAAE,GACjB;IACD,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAiBA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,eAAe,CAEzF"}

package/dist/packages/domain/src/core/analysis/engine.js

@@ -0,0 +1,77 @@
+/**
+ * Core Analysis Engine
+ * Stateless pipeline for code analysis
+ * @see docs/architecture/OVERVIEW.md#data-flow
+ * @module core/analysis
+ */
+import { rulesRegistry } from '../../control/registry/rules.registry.js';
+/**
+ * Analysis Session
+ * Manages a single analysis run with frozen configuration
+ */
+export class AnalysisSession {
+    context;
+    constructor(config, policies) {
+        this.context = {
+            config: Object.freeze({ ...config }),
+            policies: [...policies],
+            startTime: Date.now(),
+            version: '1.0.0',
+        };
+    }
+    /**
+     * Get immutable context
+     */
+    getContext() {
+        return this.context;
+    }
+    /**
+     * Analyze a single file
+     */
+    analyzeFile(file, content, language) {
+        const ruleInput = {
+            file,
+            content,
+            language,
+            project: {
+                root: this.context.config.version,
+                config: {},
+            },
+        };
+        const findings = [];
+        // Apply all enabled policies
+        for (const policy of this.context.policies) {
+            if (!policy.enabled)
+                continue;
+            const ruleResult = rulesRegistry.execute(policy.id, ruleInput, policy);
+            findings.push(...ruleResult);
+        }
+        return findings;
+    }
+}
+/**
+ * Analysis Pipeline
+ * Pure function: input -> rules -> output
+ */
+export function analyze(files, config, policies) {
+    const startTime = Date.now();
+    const session = new AnalysisSession(config, policies);
+    const allFindings = [];
+    for (const file of files) {
+        const findings = session.analyzeFile(file.path, file.content, file.language);
+        allFindings.push(...findings);
+    }
+    const duration = Date.now() - startTime;
+    return {
+        findings: allFindings,
+        duration,
+        filesAnalyzed: files.length,
+    };
+}
+/**
+ * Create analysis session with frozen snapshot
+ */
+export function createSession(config, policies) {
+    return new AnalysisSession(config, policies);
+}
+//# sourceMappingURL=engine.js.map

package/dist/packages/domain/src/core/analysis/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../../../../../../packages/domain/src/core/analysis/engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAazE;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,OAAO,CAAkB;IAE1C,YAAY,MAAsB,EAAE,QAA2B;QAC7D,IAAI,CAAC,OAAO,GAAG;YACb,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;YACpC,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;YACvB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE,OAAO;SACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY,EAAE,OAAe,EAAE,QAAgB;QACzD,MAAM,SAAS,GAAc;YAC3B,IAAI;YACJ,OAAO;YACP,QAAQ;YACR,OAAO,EAAE;gBACP,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO;gBACjC,MAAM,EAAE,EAAE;aACX;SACF,CAAC;QAEF,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,6BAA6B;QAC7B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,SAAS;YAE9B,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACvE,QAAQ,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,KAAiE,EACjE,MAAsB,EACtB,QAAkB;IAMlB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,WAAW,GAAc,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7E,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,QAAQ;QACR,aAAa,EAAE,KAAK,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAsB,EAAE,QAAkB;IACtE,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC"}

package/dist/packages/domain/src/core/analysis/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Analysis core index
+ * @description Core analysis engine exports
+ * @version 1.0.0
+ */
+export { AnalysisEngineV1 } from './engine.contract.js';
+export { analyze, createSession } from './engine.js';
+export type { AnalysisEngine, AnalysisProjectInput, AnalysisFileInput, AnalysisConfig, AnalysisOutput, FileAnalysisResult, Finding, FindingsSummary, FindingSeverity, FindingCategory, } from '../../contracts/analysis.contract.js';
+export { discoverFiles, isValidProjectRoot, analyzeProjectTypes, type FileDiscoveryOptions, type FileDiscoveryResult, type DiscoveredFile, } from './discovery.js';
+export { runAnalysis, generateReport, saveReport, type AnalysisOptions, type AnalysisResult, type FileAnalysis, } from './orchestrator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/domain/src/core/analysis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/domain/src/core/analysis/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGrD,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,OAAO,EACP,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,cAAc,EACd,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/packages/domain/src/core/analysis/index.js

@@ -0,0 +1,14 @@
+/**
+ * Analysis core index
+ * @description Core analysis engine exports
+ * @version 1.0.0
+ */
+// Contract-based engine (recommended)
+export { AnalysisEngineV1 } from './engine.contract.js';
+// Legacy engine (backward compatibility)
+export { analyze, createSession } from './engine.js';
+// Discovery
+export { discoverFiles, isValidProjectRoot, analyzeProjectTypes, } from './discovery.js';
+// Orchestrator
+export { runAnalysis, generateReport, saveReport, } from './orchestrator.js';
+//# sourceMappingURL=index.js.map

package/dist/packages/domain/src/core/analysis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../packages/domain/src/core/analysis/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sCAAsC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,yCAAyC;AACzC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgBrD,YAAY;AACZ,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,gBAAgB,CAAC;AAExB,eAAe;AACf,OAAO,EACL,WAAW,EACX,cAAc,EACd,UAAU,GAIX,MAAM,mBAAmB,CAAC"}

package/dist/packages/domain/src/core/analysis/orchestrator.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Analysis Orchestrator
+ * Coordinates file discovery and AST parsing for complete project analysis
+ */
+import { DiscoveredFile } from './discovery.js';
+import { ParseResult } from '../parser/unified-parser.js';
+export interface AnalysisOptions {
+    /** Root directory to analyze */
+    rootDir: string;
+    /** Output format */
+    format?: 'json' | 'markdown' | 'html';
+    /** Include patterns */
+    include?: string[];
+    /** Exclude patterns */
+    exclude?: string[];
+    /** Maximum file size */
+    maxFileSize?: number;
+    /** Analysis depth (1-5) */
+    depth?: number;
+}
+export interface FileAnalysis {
+    /** File information */
+    file: DiscoveredFile;
+    /** Parse result */
+    parseResult: ParseResult;
+    /** Duration in milliseconds */
+    duration: number;
+}
+export interface AnalysisResult {
+    /** Analysis ID */
+    id: string;
+    /** When analysis started */
+    timestamp: string;
+    /** Project root directory */
+    rootDir: string;
+    /** Analysis options used */
+    options: AnalysisOptions;
+    /** Summary statistics */
+    summary: {
+        totalFiles: number;
+        successfulParses: number;
+        failedParses: number;
+        totalLines: number;
+        totalFunctions: number;
+        totalClasses: number;
+        totalImports: number;
+        totalExports: number;
+        averageComplexity: number;
+        totalDuration: number;
+    };
+    /** Analyzed files */
+    files: FileAnalysis[];
+    /** Errors encountered */
+    errors: {
+        file: string;
+        error: string;
+    }[];
+    /** Project type information */
+    projectType: {
+        hasJavaScript: boolean;
+        hasTypeScript: boolean;
+        hasReact: boolean;
+        hasVue: boolean;
+        hasSvelte: boolean;
+        isNodeProject: boolean;
+        isESM: boolean;
+    };
+}
+/**
+ * Run complete project analysis
+ */
+export declare function runAnalysis(options: AnalysisOptions): Promise<AnalysisResult>;
+/**
+ * Generate report from analysis result
+ */
+export declare function generateReport(result: AnalysisResult, format?: 'json' | 'markdown' | 'html'): {
+    id: string;
+    content: string;
+    format: string;
+};
+/**
+ * Save report to file
+ */
+export declare function saveReport(result: AnalysisResult, outputDir: string, format?: 'json' | 'markdown' | 'html'): Promise<string>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/packages/domain/src/core/analysis/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/domain/src/core/analysis/orchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAuC,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAe,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACtC,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,mBAAmB;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,yBAAyB;IACzB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,qBAAqB;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,yBAAyB;IACzB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,+BAA+B;IAC/B,WAAW,EAAE;QACX,aAAa,EAAE,OAAO,CAAC;QACvB,aAAa,EAAE,OAAO,CAAC;QACvB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAWD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAyGnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,GAAE,MAAM,GAAG,UAAU,GAAG,MAAe,GAC5C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0BjD;AAoGD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAM,GAAG,UAAU,GAAG,MAAe,GAC5C,OAAO,CAAC,MAAM,CAAC,CAUjB"}