opencroc 1.7.0 → 1.8.1

package/dist/index.d.ts

@@ -1828,4 +1828,382 @@ declare function writeOrchestrationSummary(summary: OrchestrationSummary, option
  */
 declare function printOrchestrationSummary(summary: OrchestrationSummary): string[];
 
-export { type AIAttributionResult, type ApiChainAnalysisResult, type ApiDependency, type ApiEndpoint, type ApiRecord, type ApiRecordForRules, type ApiRuleViolation, type AttemptRecord, type AutoFixPROptions, type AutoFixPRResult, type BackendAdapter, type BackendDomainItem, type BuildWorkordersOptions, type CandidateApiRequest, type ChainFailureResult, type ChainPlanResult, type ConfigFixer, type ConfigValidator, type ControlledFixOptions, type ControlledFixOutcome, type ControlledFixerOptions, type CriticalApiRule, type DTOFieldInfo, type DTOInfo, type DashboardData, type DashboardOutput, type DialogLoopConfig, type DialogLoopOptions, type DialogLoopSummary, type DirectedAcyclicGraph, type ERDiagramResult, type ExecutionConfig, type ExecutionMetrics, type FailureCategory, type FailureSummary, type FieldSchema, type FixApplier, type FixContext, type FixHistoryEntry, type FixOutcome, type FixResult, type FixScope, type ForeignKeyRelation, type FsOps, type GeneratedTestFile, type GitExecutor, type HookConfig, type ImpactReport, type IndexSchema, type IterationResult, type LayerValidationResult, type LlmProvider, type LogCompletionRecord, type LogCompletionResult, type LogCompletionSummary, type LogEntry, type LogPollerOptions, type ModuleConfigErrorType, type ModuleConfigValidationContext, type ModuleConfigValidationError, type ModuleConfigValidationResult, type ModuleConfigValidationWarning, type ModuleDefinition, type ModuleMetadata, type ModuleTestConfig, type NetworkError, NetworkMonitor, type NetworkMonitorOptions, type OpenCrocConfig, type OpenCrocPlugin, type OrchestrationOptions, type OrchestrationPhase, type OrchestrationReportOptions, type OrchestrationSummary, type PRGenerator, type PatchWriter, type PhaseResult, type PhaseStatus, type PipelineRunResult, type PluginRegistry, type ReportOutput, type ResilientFetchOptions, type ResilientFetchResult, type ResolvedConfig, type ResolvedRoute, type ResultParser, type RouteEntry, type RuntimeConfig, SYSTEM_PROMPTS, type SeedStep, type SelfHealingResult, type TableSchema, type TestChain, type TestFailureInfo, type TestResultRecord, type TestRunner, type TestStep, TokenTracker, type TokenUsageEntry, type TokenUsageSummary, COMMANDS as VSCODE_COMMANDS, type ValidationError, type ValidatorRule, type WorkorderItem, aggregateLogCompletion, analyzeFailureWithLLM, applyControlledFix, autoFix, buildBackendChecklist, buildClassToTableMap, buildDashboardDataFromPipeline, buildDashboardDataFromReportJson, buildFailureSummary, buildGraph, buildModuleTree, buildPath, buildStatusTree, buildTestRunSummary, buildWorkorders, categorizeFailure, classNameToTableName, classifyFailure, compareTestRuns, createAdapter, createApiChainAnalyzer, createAssociationParser, createChainPlanner, createControllerParser, createDrizzleAdapter, createERDiagramGenerator, createImpactReporter, createJsonResultParser, createLlmChainPlanner, createLlmProvider, createMockDataGenerator, createModelParser, createOllamaProvider, createOpenAIProvider, createOrchestrator, createPipeline, createPluginRegistry, createPrismaAdapter, createRulesEngine, createSelfHealingLoop, createSequelizeAdapter, createTestCodeGenerator, createTokenTracker, createTypeORMAdapter, defineConfig, definePlugin, detectAdapter, detectCycles, extractIdFromText, extractParamNames, extractParamsFromHref, formatComparisonReport, formatValidationResult, generateAllModuleConfigs, generateAuthSetup, generateCiTemplate, generateEnhancedConfig, generateExtensionEntrypoint, generateExtensionManifest, generateFixPR, generateGitHubActionsTemplate, generateGitLabCITemplate, generateGlobalSetup, generateGlobalTeardown, generateHtmlReport, generateJsonReport, generateMarkdownReport, generateModuleConfig, generatePlaywrightConfig, generateReports, generateVisualDashboard, generateVisualDashboardHtml, getModulePreset, inferDependencies, inferRelatedTables, listCiPlatforms, listModulePresets, loadModulePresets, mergeCandidates, parseApiDomain, parseAssociationFile, parseControllerDirectory, parseControllerFile, parseDTOs, parseDrizzleDirectory, parseDrizzleFile, parseModelFile, parseModuleModels, parsePlaywrightReport, parseValidatorRules, printOrchestrationSummary, recoverJSON, renderChecklistMarkdown, renderTokenReportMarkdown, renderWorkordersMarkdown, resilientFetch, resolveAdapter, resolveFromSeedData, runDialogLoop, scanModuleMetadata, selectCandidates, selectCandidatesFromLogs, topologicalSort, validateConfig, validateDryrun, validateModuleConfig, validateSchema, validateSemantic, waitForBackend, waitForLogCompletion, writeOrchestrationSummary };
+/**
+ * OpenCroc Studio — Universal Knowledge Graph Types
+ *
+ * Multi-layer knowledge graph for any project type and language.
+ */
+/** All possible node types in the knowledge graph */
+type GraphNodeType = 'module' | 'file' | 'class' | 'function' | 'api' | 'model' | 'field' | 'route' | 'middleware' | 'service' | 'config' | 'dependency' | 'database' | 'queue' | 'cache' | 'external-api' | 'event' | 'permission' | 'component' | 'page' | 'store' | 'test' | 'unknown';
+/** All possible edge relation types */
+type GraphEdgeRelation = 'imports' | 'exports' | 'calls' | 'extends' | 'implements' | 'reads' | 'writes' | 'depends-on' | 'has-field' | 'foreign-key' | 'middleware-of' | 'belongs-to' | 'triggers' | 'listens-to' | 'renders' | 'routes-to' | 'publishes' | 'consumes' | 'caches' | 'requires-permission' | 'cascade-delete' | 'associated-with';
+interface GraphNode {
+    id: string;
+    label: string;
+    type: GraphNodeType;
+    /** File path relative to project root */
+    filePath?: string;
+    /** Line number in source file */
+    line?: number;
+    /** Which module/package this belongs to */
+    module?: string;
+    /** Language of the source */
+    language?: string;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** Risk annotations attached by analysis */
+    risks?: RiskAnnotation[];
+    /** Status for visualization */
+    status?: 'idle' | 'scanning' | 'analyzed' | 'at-risk';
+}
+interface GraphEdge {
+    id: string;
+    source: string;
+    target: string;
+    relation: GraphEdgeRelation;
+    /** Weight/strength of the relationship (0-1) */
+    weight?: number;
+    /** Additional context */
+    metadata?: Record<string, unknown>;
+}
+interface KnowledgeGraph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    /** Project-level metadata */
+    projectInfo: ProjectMetadata;
+    /** Timestamp of last build */
+    builtAt: string;
+    /** Build duration in ms */
+    buildDuration: number;
+}
+interface ProjectMetadata {
+    name: string;
+    description?: string;
+    /** Source: 'local' | 'github' | 'gitlab' | 'url' */
+    source: 'local' | 'github' | 'gitlab' | 'url';
+    sourceUrl?: string;
+    rootPath: string;
+    /** Detected languages and their file counts */
+    languages: Record<string, number>;
+    /** Detected frameworks */
+    frameworks: string[];
+    /** Detected package manager */
+    packageManager?: string;
+    /** Project type classification */
+    projectType: ProjectType;
+    /** Statistics */
+    stats: ProjectStats;
+}
+type ProjectType = 'backend-api' | 'frontend-spa' | 'frontend-ssr' | 'fullstack' | 'monorepo' | 'library' | 'cli-tool' | 'mobile' | 'microservice' | 'unknown';
+interface ProjectStats {
+    totalFiles: number;
+    totalLines: number;
+    modules: number;
+    classes: number;
+    functions: number;
+    apiEndpoints: number;
+    dataModels: number;
+    dependencies: number;
+    /** Per-language line counts */
+    linesByLanguage: Record<string, number>;
+}
+type RiskSeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+type RiskCategory = 'security' | 'performance' | 'data-integrity' | 'logic' | 'maintainability' | 'reliability' | 'compliance';
+interface RiskAnnotation {
+    id: string;
+    category: RiskCategory;
+    severity: RiskSeverity;
+    title: string;
+    description: string;
+    /** Affected node IDs */
+    affectedNodes: string[];
+    /** Suggested fix */
+    suggestion?: string;
+    /** Confidence score 0-1 */
+    confidence: number;
+}
+interface ImpactAnalysis {
+    /** The changed node */
+    sourceNode: string;
+    /** Directly affected nodes */
+    directImpact: string[];
+    /** Transitively affected nodes (BFS from direct) */
+    transitiveImpact: string[];
+    /** Risk level of the change */
+    riskLevel: RiskSeverity;
+    /** Human-readable summary */
+    summary: string;
+    /** Mermaid diagram of impact */
+    mermaidText: string;
+}
+type ReportPerspective = 'developer' | 'architect' | 'tester' | 'product' | 'student' | 'executive';
+interface PerspectiveReport {
+    perspective: ReportPerspective;
+    title: string;
+    summary: string;
+    sections: ReportSection[];
+    generatedAt: string;
+}
+interface ReportSection {
+    heading: string;
+    content: string;
+    /** Optional visualization (mermaid, chart data) */
+    visualization?: {
+        type: 'mermaid' | 'chart' | 'table' | 'tree';
+        data: string;
+    };
+}
+interface SimulationScenario {
+    name: string;
+    description: string;
+    /** API call sequence to simulate */
+    steps: SimulationStep[];
+    /** Expected state changes */
+    expectedOutcome: string;
+}
+interface SimulationStep {
+    order: number;
+    action: string;
+    endpoint?: string;
+    input?: Record<string, unknown>;
+    /** AI-predicted response */
+    predictedResponse?: {
+        status: number;
+        body: Record<string, unknown>;
+    };
+    /** AI-predicted side effects */
+    predictedSideEffects?: string[];
+}
+interface SimulationResult {
+    scenario: SimulationScenario;
+    /** AI-predicted outcome */
+    prediction: string;
+    /** Detected anomalies */
+    anomalies: string[];
+    /** Risk score 0-100 */
+    riskScore: number;
+    confidence: number;
+}
+interface ScanResult {
+    /** Detected language breakdown */
+    languages: Record<string, number>;
+    /** Detected frameworks */
+    frameworks: FrameworkDetection[];
+    /** Discovered files by category */
+    files: DiscoveredFile[];
+    /** Extracted entities (pre-graph) */
+    entities: ExtractedEntity[];
+    /** Extracted relationships (pre-graph) */
+    relationships: ExtractedRelationship[];
+    /** Scan duration in ms */
+    duration: number;
+}
+interface FrameworkDetection {
+    name: string;
+    version?: string;
+    confidence: number;
+    evidence: string;
+}
+interface DiscoveredFile {
+    path: string;
+    language: string;
+    category: 'source' | 'config' | 'test' | 'docs' | 'build' | 'asset' | 'other';
+    lines: number;
+    size: number;
+}
+interface ExtractedEntity {
+    id: string;
+    name: string;
+    type: GraphNodeType;
+    filePath: string;
+    line?: number;
+    language: string;
+    metadata: Record<string, unknown>;
+}
+interface ExtractedRelationship {
+    sourceId: string;
+    targetId: string;
+    relation: GraphEdgeRelation;
+    metadata?: Record<string, unknown>;
+}
+
+/**
+ * Language Detector
+ *
+ * Detects programming languages, frameworks, and project type
+ * from a project directory without reading source code ASTs.
+ * Uses file extensions, config files, and package manifests.
+ */
+
+interface LanguageDetectionResult {
+    /** Language → file count */
+    languages: Record<string, number>;
+    /** Language → total line count */
+    linesByLanguage: Record<string, number>;
+    /** Total files found */
+    totalFiles: number;
+    /** Total lines of code */
+    totalLines: number;
+    /** Primary language */
+    primaryLanguage: string;
+    /** Detected frameworks */
+    frameworks: FrameworkDetection[];
+    /** Detected project type */
+    projectType: ProjectType;
+    /** Package manager */
+    packageManager?: string;
+    /** All discovered source files */
+    files: Array<{
+        path: string;
+        language: string;
+        lines: number;
+        size: number;
+    }>;
+}
+/**
+ * Detect languages, frameworks, and project type from a directory.
+ */
+declare function detectProject(rootDir: string): LanguageDetectionResult;
+
+/**
+ * Universal Project Scanner
+ *
+ * Scans any project directory and extracts entities (modules, classes,
+ * functions, APIs, models) and relationships. Works with any language
+ * by combining:
+ *   1. Static analysis (ts-morph for TS/JS)
+ *   2. Pattern matching (regex for Python/Go/Java/etc.)
+ *   3. Config file parsing (package.json, OpenAPI, etc.)
+ *   4. LLM fallback (for unknown patterns)
+ */
+
+interface ScanOptions {
+    /** Project root directory */
+    rootDir: string;
+    /** Max files to deeply analyze (default: 500) */
+    maxDeepScan?: number;
+    /** Enable LLM fallback for unknown patterns */
+    useLlm?: boolean;
+    /** Progress callback */
+    onProgress?: (phase: string, percent: number, detail?: string) => void;
+}
+/**
+ * Scan a project and extract all entities and relationships.
+ */
+declare function scanProject(options: ScanOptions): Promise<ScanResult>;
+
+/**
+ * GitHub Cloner
+ *
+ * Clone a GitHub/GitLab/any git repository and scan it.
+ * Supports: HTTPS URLs, shorthand (user/repo), and local paths.
+ */
+
+interface CloneOptions extends Omit<ScanOptions, 'rootDir'> {
+    /** GitHub URL, shorthand (user/repo), or local path */
+    target: string;
+    /** Where to clone into (default: os temp dir) */
+    cloneDir?: string;
+    /** Branch/tag to clone (default: default branch) */
+    branch?: string;
+    /** Shallow clone depth (default: 1) */
+    depth?: number;
+    /** Keep cloned repo after scan (default: false for remote, true for local) */
+    keepClone?: boolean;
+}
+/**
+ * Clone (if needed) and scan a project.
+ */
+declare function cloneAndScan(options: CloneOptions): Promise<ScanResult & {
+    clonedPath?: string;
+}>;
+
+/**
+ * Knowledge Graph Builder
+ *
+ * Transforms raw ScanResult entities and relationships into a
+ * fully connected KnowledgeGraph with deduplication, wildcard
+ * resolution, module grouping, and statistics.
+ */
+
+interface GraphBuildOptions {
+    /** Project name (from package.json or dir name) */
+    projectName: string;
+    /** Source type */
+    source: 'local' | 'github' | 'gitlab' | 'url';
+    sourceUrl?: string;
+    /** Project root path */
+    rootPath: string;
+}
+/**
+ * Build a KnowledgeGraph from scan results.
+ */
+declare function buildKnowledgeGraph(scanResult: ScanResult, options: GraphBuildOptions): KnowledgeGraph;
+/**
+ * Query the knowledge graph for nodes matching criteria.
+ */
+declare function queryNodes(graph: KnowledgeGraph, filter: Partial<Pick<GraphNode, 'type' | 'language' | 'module'>>): GraphNode[];
+/**
+ * Get all neighbors of a node (incoming + outgoing).
+ */
+declare function getNeighbors(graph: KnowledgeGraph, nodeId: string): {
+    incoming: GraphEdge[];
+    outgoing: GraphEdge[];
+};
+/**
+ * BFS traversal from a node, returning all reachable nodes within maxDepth.
+ */
+declare function bfsTraversal(graph: KnowledgeGraph, startNodeId: string, maxDepth?: number): string[];
+/**
+ * Find all paths between two nodes (up to maxPaths).
+ */
+declare function findPaths(graph: KnowledgeGraph, fromId: string, toId: string, maxPaths?: number, maxDepth?: number): string[][];
+/**
+ * Generate a Mermaid diagram from the knowledge graph.
+ */
+declare function toMermaid(graph: KnowledgeGraph, options?: {
+    maxNodes?: number;
+    nodeTypes?: string[];
+}): string;
+/**
+ * Get graph statistics summary.
+ */
+declare function getGraphStats(graph: KnowledgeGraph): Record<string, number>;
+
+/**
+ * AI Insight Engine
+ *
+ * Multi-perspective analysis powered by LLM. Generates:
+ *  - Risk reports (security, performance, data integrity, logic)
+ *  - Impact analysis (change blast radius)
+ *  - Multi-role reports (developer, architect, tester, product, student, executive)
+ *  - Digital twin simulation (AI-predicted test outcomes)
+ */
+
+interface InsightOptions {
+    /** LLM provider for AI-enhanced analysis */
+    llm?: LlmProvider;
+    /** Enable LLM-based analysis (requires llm provider) */
+    useLlm?: boolean;
+    /** Progress callback */
+    onProgress?: (phase: string, percent: number, detail?: string) => void;
+}
+/**
+ * Analyze a knowledge graph for risks across all categories.
+ * Combines rule-based static analysis with optional LLM enhancement.
+ */
+declare function analyzeRisks(graph: KnowledgeGraph, options?: InsightOptions): Promise<RiskAnnotation[]>;
+/**
+ * Analyze the impact of changing a specific node.
+ */
+declare function analyzeImpact(graph: KnowledgeGraph, nodeId: string): ImpactAnalysis;
+/**
+ * Generate a report from a specific perspective.
+ */
+declare function generateReport(graph: KnowledgeGraph, perspective: ReportPerspective, risks: RiskAnnotation[], options?: InsightOptions): Promise<PerspectiveReport>;
+/**
+ * Run AI-powered simulation on a scenario (requires LLM).
+ */
+declare function simulateScenario(graph: KnowledgeGraph, scenario: SimulationScenario, llm: LlmProvider): Promise<SimulationResult>;
+
+export { type AIAttributionResult, type ApiChainAnalysisResult, type ApiDependency, type ApiEndpoint, type ApiRecord, type ApiRecordForRules, type ApiRuleViolation, type AttemptRecord, type AutoFixPROptions, type AutoFixPRResult, type BackendAdapter, type BackendDomainItem, type BuildWorkordersOptions, type CandidateApiRequest, type ChainFailureResult, type ChainPlanResult, type CloneOptions, type ConfigFixer, type ConfigValidator, type ControlledFixOptions, type ControlledFixOutcome, type ControlledFixerOptions, type CriticalApiRule, type DTOFieldInfo, type DTOInfo, type DashboardData, type DashboardOutput, type DialogLoopConfig, type DialogLoopOptions, type DialogLoopSummary, type DirectedAcyclicGraph, type DiscoveredFile, type ERDiagramResult, type ExecutionConfig, type ExecutionMetrics, type ExtractedEntity, type ExtractedRelationship, type FailureCategory, type FailureSummary, type FieldSchema, type FixApplier, type FixContext, type FixHistoryEntry, type FixOutcome, type FixResult, type FixScope, type ForeignKeyRelation, type FrameworkDetection, type FsOps, type GeneratedTestFile, type GitExecutor, type GraphEdge, type GraphEdgeRelation, type GraphNode, type GraphNodeType, type HookConfig, type ImpactAnalysis, type ImpactReport, type IndexSchema, type IterationResult, type LanguageDetectionResult, type LayerValidationResult, type LlmProvider, type LogCompletionRecord, type LogCompletionResult, type LogCompletionSummary, type LogEntry, type LogPollerOptions, type ModuleConfigErrorType, type ModuleConfigValidationContext, type ModuleConfigValidationError, type ModuleConfigValidationResult, type ModuleConfigValidationWarning, type ModuleDefinition, type ModuleMetadata, type ModuleTestConfig, type NetworkError, NetworkMonitor, type NetworkMonitorOptions, type OpenCrocConfig, type OpenCrocPlugin, type OrchestrationOptions, type OrchestrationPhase, type OrchestrationReportOptions, type OrchestrationSummary, type PRGenerator, type PatchWriter, type PerspectiveReport, type PhaseResult, type PhaseStatus, type PipelineRunResult, type PluginRegistry, type ProjectMetadata, type ProjectStats, type ProjectType, type ReportOutput, type ReportPerspective, type ReportSection, type ResilientFetchOptions, type ResilientFetchResult, type ResolvedConfig, type ResolvedRoute, type ResultParser, type RiskAnnotation, type RiskCategory, type RiskSeverity, type RouteEntry, type RuntimeConfig, SYSTEM_PROMPTS, type ScanOptions, type ScanResult, type SeedStep, type SelfHealingResult, type SimulationResult, type SimulationScenario, type KnowledgeGraph as StudioKnowledgeGraph, type TableSchema, type TestChain, type TestFailureInfo, type TestResultRecord, type TestRunner, type TestStep, TokenTracker, type TokenUsageEntry, type TokenUsageSummary, COMMANDS as VSCODE_COMMANDS, type ValidationError, type ValidatorRule, type WorkorderItem, aggregateLogCompletion, analyzeFailureWithLLM, analyzeImpact, analyzeRisks, applyControlledFix, autoFix, bfsTraversal, buildBackendChecklist, buildClassToTableMap, buildDashboardDataFromPipeline, buildDashboardDataFromReportJson, buildFailureSummary, buildGraph, buildKnowledgeGraph, buildModuleTree, buildPath, buildStatusTree, buildTestRunSummary, buildWorkorders, categorizeFailure, classNameToTableName, classifyFailure, cloneAndScan, compareTestRuns, createAdapter, createApiChainAnalyzer, createAssociationParser, createChainPlanner, createControllerParser, createDrizzleAdapter, createERDiagramGenerator, createImpactReporter, createJsonResultParser, createLlmChainPlanner, createLlmProvider, createMockDataGenerator, createModelParser, createOllamaProvider, createOpenAIProvider, createOrchestrator, createPipeline, createPluginRegistry, createPrismaAdapter, createRulesEngine, createSelfHealingLoop, createSequelizeAdapter, createTestCodeGenerator, createTokenTracker, createTypeORMAdapter, defineConfig, definePlugin, detectAdapter, detectCycles, detectProject, extractIdFromText, extractParamNames, extractParamsFromHref, findPaths, formatComparisonReport, formatValidationResult, generateAllModuleConfigs, generateAuthSetup, generateCiTemplate, generateEnhancedConfig, generateExtensionEntrypoint, generateExtensionManifest, generateFixPR, generateGitHubActionsTemplate, generateGitLabCITemplate, generateGlobalSetup, generateGlobalTeardown, generateHtmlReport, generateReport as generateInsightReport, generateJsonReport, generateMarkdownReport, generateModuleConfig, generatePlaywrightConfig, generateReports, generateVisualDashboard, generateVisualDashboardHtml, getGraphStats, getModulePreset, getNeighbors, inferDependencies, inferRelatedTables, listCiPlatforms, listModulePresets, loadModulePresets, mergeCandidates, parseApiDomain, parseAssociationFile, parseControllerDirectory, parseControllerFile, parseDTOs, parseDrizzleDirectory, parseDrizzleFile, parseModelFile, parseModuleModels, parsePlaywrightReport, parseValidatorRules, printOrchestrationSummary, queryNodes, recoverJSON, renderChecklistMarkdown, renderTokenReportMarkdown, renderWorkordersMarkdown, resilientFetch, resolveAdapter, resolveFromSeedData, runDialogLoop, scanModuleMetadata, scanProject, selectCandidates, selectCandidatesFromLogs, simulateScenario, toMermaid, topologicalSort, validateConfig, validateDryrun, validateModuleConfig, validateSchema, validateSemantic, waitForBackend, waitForLogCompletion, writeOrchestrationSummary };