opencroc 1.8.1 → 1.8.3

package/dist/index.d.ts

@@ -2206,4 +2206,131 @@ declare function generateReport(graph: KnowledgeGraph, perspective: ReportPerspe
  */
 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 };
+/**
+ * OpenCroc Dynamic Role Registry
+ *
+ * Manages an extensible pool of croc expert roles that can be
+ * dynamically summoned based on project characteristics.
+ *
+ * Architecture:
+ *   RoleDefinition → what a croc CAN do (template)
+ *   CrocAgent      → a live instance doing work (runtime)
+ *   TaskRouter      → decides WHICH roles to summon for a project
+ */
+type RoleCategory = 'core' | 'language' | 'framework' | 'domain' | 'community';
+interface RoleTrigger {
+    /** Match against detected languages (e.g. "python", "typescript") */
+    languages?: string[];
+    /** Match against detected frameworks (e.g. "Express", "Django", "React") */
+    frameworks?: string[];
+    /** Match against project type */
+    projectTypes?: string[];
+    /** Match against file patterns (glob-style) */
+    filePatterns?: string[];
+    /** Match against entity count thresholds */
+    minEntities?: number;
+    /** Match against risk categories found */
+    riskCategories?: string[];
+    /** Custom predicate for advanced matching */
+    custom?: (ctx: MatchContext) => boolean;
+}
+interface MatchContext {
+    languages: Record<string, number>;
+    frameworks: string[];
+    projectType: string;
+    fileCount: number;
+    entityCount: number;
+    riskCategories: string[];
+    hasModels: boolean;
+    hasAPIs: boolean;
+    hasFrontend: boolean;
+    hasDocker: boolean;
+    hasCI: boolean;
+}
+interface RoleDefinition {
+    /** Unique identifier, e.g. "security-auditor" */
+    id: string;
+    /** Display name in Chinese, e.g. "安全审计鳄" */
+    name: string;
+    /** English name for international display */
+    nameEn: string;
+    /** Role category */
+    category: RoleCategory;
+    /** Short description of expertise */
+    description: string;
+    /** Icon/sprite identifier for 3D rendering */
+    sprite: string;
+    /** Color theme (hex) for the croc's glow */
+    color: string;
+    /** Priority: lower = summoned first when multiple match (0-100) */
+    priority: number;
+    /** When should this role be summoned? */
+    triggers: RoleTrigger;
+    /** System prompt template for LLM analysis */
+    systemPrompt: string;
+    /** What this role outputs */
+    outputType: 'report' | 'analysis' | 'fix' | 'review' | 'diagram';
+    /** Tags for search/filtering */
+    tags: string[];
+    /** Author info (for community roles) */
+    author?: string;
+    /** Version string */
+    version?: string;
+}
+declare class RoleRegistry {
+    private roles;
+    constructor();
+    /** Register a new role (community or custom) */
+    register(role: RoleDefinition): void;
+    /** Unregister a role */
+    unregister(id: string): boolean;
+    /** Get a role by ID */
+    get(id: string): RoleDefinition | undefined;
+    /** List all registered roles */
+    list(): RoleDefinition[];
+    /** List roles by category */
+    listByCategory(category: RoleCategory): RoleDefinition[];
+    /** Search roles by tags */
+    search(query: string): RoleDefinition[];
+    /** Total number of registered roles */
+    get size(): number;
+}
+declare function getRoleRegistry(): RoleRegistry;
+
+/**
+ * OpenCroc Task Router
+ *
+ * Analyzes a scanned project and decides which croc roles to summon.
+ * Returns a prioritized list of roles matching the project's characteristics.
+ */
+
+interface SummonPlan {
+    /** Roles to summon, sorted by priority (lower = first) */
+    roles: SummonedRole[];
+    /** Summary of why each role was picked */
+    reasoning: string[];
+    /** Project context used for matching */
+    context: MatchContext;
+}
+interface SummonedRole {
+    role: RoleDefinition;
+    /** Why this role was summoned */
+    reason: string;
+    /** Match confidence 0-1 */
+    confidence: number;
+}
+/**
+ * Build a MatchContext from a ScanResult.
+ */
+declare function buildMatchContext(scan: ScanResult): MatchContext;
+/**
+ * Given a scan result, determine which roles should be summoned.
+ *
+ * @param scan - The scan result from the project scanner
+ * @param maxRoles - Maximum number of non-core roles to summon (default: 8)
+ * @param riskCategories - Risk categories detected (from insight engine)
+ * @returns A SummonPlan with prioritized roles
+ */
+declare function planSummon(scan: ScanResult, maxRoles?: number, riskCategories?: string[]): SummonPlan;
+
+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 MatchContext, 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 RoleCategory, type RoleDefinition, RoleRegistry, type RoleTrigger, type RouteEntry, type RuntimeConfig, SYSTEM_PROMPTS, type ScanOptions, type ScanResult, type SeedStep, type SelfHealingResult, type SimulationResult, type SimulationScenario, type KnowledgeGraph as StudioKnowledgeGraph, type SummonPlan, type SummonedRole, 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, buildMatchContext, 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, getRoleRegistry, inferDependencies, inferRelatedTables, listCiPlatforms, listModulePresets, loadModulePresets, mergeCandidates, parseApiDomain, parseAssociationFile, parseControllerDirectory, parseControllerFile, parseDTOs, parseDrizzleDirectory, parseDrizzleFile, parseModelFile, parseModuleModels, parsePlaywrightReport, parseValidatorRules, planSummon, 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 };