cto-ai-cli 4.0.0 → 5.1.0

package/dist/engine/index.d.ts

@@ -612,6 +612,8 @@ interface FeedbackEntry {
     outcome: FeedbackOutcome;
     model?: string;
     promptTokens?: number;
+    sessionId?: string;
+    strategy?: string;
 }
 interface FeedbackOutcome {
     accepted: boolean;
@@ -633,19 +635,34 @@ interface FeedbackModel {
         includedCount: number;
         acceptedCount: number;
         acceptRate: number;
+        ewmaAcceptRate: number;
         avgTimeToAccept: number;
+        lastSeen: string;
+        bayesianLower: number;
     }>;
     taskTypeAcceptance: Record<string, {
         totalCount: number;
         acceptedCount: number;
         acceptRate: number;
         avgCompilable: number;
+        ewmaAcceptRate: number;
     }>;
     pairAcceptance: Record<string, {
         count: number;
         acceptedCount: number;
         acceptRate: number;
     }>;
+    sessions: Record<string, {
+        strategy: string;
+        entries: number;
+        acceptRate: number;
+    }>;
+    strategyComparison: Record<string, {
+        totalCount: number;
+        acceptedCount: number;
+        acceptRate: number;
+        avgTimeToAccept: number;
+    }>;
     insights: FeedbackInsight[];
 }
 interface FeedbackInsight {
@@ -655,9 +672,33 @@ interface FeedbackInsight {
     impact: number;
 }
 declare function loadFeedbackModel(projectPath: string): Promise<FeedbackModel>;
+declare function wilsonLowerBound(successes: number, total: number, z?: number): number;
 declare function recordFeedback(projectPath: string, entry: Omit<FeedbackEntry, 'id' | 'timestamp' | 'taskType'>): Promise<FeedbackModel>;
 declare function getFeedbackBoosts(projectPath: string, task: string): Promise<Map<string, number>>;
+interface TeamFeedbackExport {
+    version: number;
+    exportedAt: string;
+    projectName: string;
+    model: FeedbackModel;
+    entrySummary: {
+        total: number;
+        accepted: number;
+        sessions: number;
+    };
+}
+declare function exportFeedbackForTeam(projectPath: string, projectName: string): Promise<TeamFeedbackExport>;
+declare function importTeamFeedback(projectPath: string, teamExport: TeamFeedbackExport): Promise<FeedbackModel>;
 declare function renderFeedbackReport(model: FeedbackModel): string;
+declare function renderCrossRepoReport(stats: {
+    totalProjects: number;
+    totalObservations: number;
+    archetypes: {
+        name: string;
+        projects: number;
+        observations: number;
+    }[];
+    universalPatterns: number;
+}): string;
 
 interface SemanticFingerprint {
     filePath: string;
@@ -807,6 +848,35 @@ declare function optimizeBudget(files: AnalyzedFile[], budget: number): Promise<
 declare function pruneFile(file: AnalyzedFile, level: PruneLevel): Promise<PrunedContent>;
 declare function pruneFiles(files: AnalyzedFile[], levelFn: (file: AnalyzedFile) => PruneLevel): Promise<PrunedContent[]>;
 
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+interface LogEntry {
+    level: LogLevel;
+    msg: string;
+    ts: string;
+    module?: string;
+    [key: string]: unknown;
+}
+declare function setLogLevel(level: LogLevel): void;
+declare function setJsonLogging(enabled: boolean): void;
+declare function createLogger(module: string): {
+    debug: (msg: string, data?: Record<string, unknown>) => void;
+    info: (msg: string, data?: Record<string, unknown>) => void;
+    warn: (msg: string, data?: Record<string, unknown>) => void;
+    error: (msg: string, data?: Record<string, unknown>) => void;
+};
+type Logger = ReturnType<typeof createLogger>;
+
+type CtoErrorCode = 'ANALYSIS_FAILED' | 'FILE_READ_ERROR' | 'FILE_WRITE_ERROR' | 'GRAPH_BUILD_FAILED' | 'SELECTION_FAILED' | 'PRUNING_FAILED' | 'SCORING_FAILED' | 'AUDIT_FAILED' | 'GATEWAY_ERROR' | 'CONFIG_INVALID' | 'GIT_ERROR' | 'REVIEW_FAILED' | 'PREDICTION_FAILED' | 'MONOREPO_ERROR' | 'MCP_ERROR' | 'INVALID_INPUT';
+declare class CtoError extends Error {
+    readonly code: CtoErrorCode;
+    readonly module: string;
+    readonly context?: Record<string, unknown>;
+    constructor(code: CtoErrorCode, message: string, module: string, context?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+}
+declare function isCtoError(err: unknown): err is CtoError;
+declare function wrapError(err: unknown, code: CtoErrorCode, module: string, context?: Record<string, unknown>): CtoError;
+
 declare function countTokensTiktoken(text: string): number;
 declare function countTokensChars4(sizeInBytes: number): number;
 declare function estimateTokens(content: string, sizeInBytes: number, method?: 'chars4' | 'tiktoken'): number;
@@ -897,4 +967,83 @@ declare function runQualityGate(score: ContextScore, analysis: ProjectAnalysis,
     severity: string;
 }[], config?: Partial<QualityGateConfig>): Promise<QualityGateResult>;
 
-export { type Baseline, type BenchmarkResult, type ChangeType, type ChangedFile, type CompilabilityMetrics, type CompilabilityResult, type CompileProofResult, type CompileProofStrategy, type ContextScore, type CrossPackageEdge, type CrossRepoModel, type CrossRepoPrediction, DEFAULT_GATE_CONFIG, type DimensionScore, type FeedbackEntry, type FeedbackInsight, type FeedbackModel, type FeedbackOutcome, type FileChangeEvent, type Grade, MODEL_REGISTRY, type ModelOptimization, type ModelProfile, type MonorepoAnalysis, type MonorepoTool, type MultiModelResult, type PRContextOptions, type PRContextResult, type PackageContextResult, type PackageInfo, type PredictionResult, type PredictorModel, type ProjectFingerprint, ProjectWatcher, type QualityBenchmarkResult, type QualityGateCheck, type QualityGateConfig, type QualityGateResult, type QualityMetrics, type ScoreInsight, type SelectionInput, type SemanticAnalysis, type SemanticDomain, type SemanticFingerprint, type StrategyResult, type WatcherOptions, analyzeMonorepo, analyzeProject, analyzeSemantics, bfsBidirectional, buildAdjacencyList, buildProjectGraph, calculateCoverage, classifyFileKind, computeContextScore, computeFingerprint, configureCache, countTokensChars4, countTokensTiktoken, createProject, detectMonorepoTool, detectStack, estimateFileTokens, estimateTokens, freeEncoder, generatePRContext, getActiveWatchers, getCTODir, getCacheStats, getCachedAnalysis, getConfigPath, getCrossRepoStats, getFeedbackBoosts, getModelStats, getPolicyPath, getPredictorBoosts, getPruneLevelForRisk, initProjectConfig, invalidateCache, loadBaseline, loadConfig, loadFeedbackModel, loadGlobalModel, loadModel, loadPolicyFromYAML, matchGlob, optimizeBudget, optimizeForModels, predictFromCrossRepo, predictRelevantFiles, pruneFile, pruneFiles, recordCrossRepoSelection, recordFeedback, recordSelection, renderBenchmark, renderCompilabilityBenchmark, renderCompileProof, renderContextScore, renderFeedbackReport, renderMonorepoAnalysis, renderMultiModelResult, renderPackageContext, renderQualityBenchmark, renderSemanticAnalysis, runBenchmark, runCompilabilityBenchmark, runCompileProof, runQualityBenchmark, runQualityGate, saveBaseline, saveConfig, scoreAllFiles, scoreFile, selectContext, selectPackageContext, semanticBoosts, unwatchAll, unwatchProject, walkProject, watchProject };
+interface ReviewResult {
+    branch: string;
+    baseBranch: string;
+    isGitRepo: boolean;
+    changedFiles: ReviewFile[];
+    totalLinesChanged: number;
+    breakingChanges: BreakingChange[];
+    missingFiles: MissingFile[];
+    impactRadius: ImpactRadius;
+    reviewQuality: ReviewQuality;
+    reviewPrompt: string;
+    renderedSummary: string;
+}
+interface ReviewFile {
+    relativePath: string;
+    changeType: 'added' | 'modified' | 'deleted' | 'renamed';
+    linesAdded: number;
+    linesRemoved: number;
+    riskScore: number;
+    kind: string;
+    hunks: DiffHunk[];
+    hasExportChanges: boolean;
+    hasTypeChanges: boolean;
+}
+interface DiffHunk {
+    startLine: number;
+    endLine: number;
+    header: string;
+    additions: string[];
+    deletions: string[];
+}
+interface BreakingChange {
+    file: string;
+    type: 'export-removed' | 'export-renamed' | 'type-changed' | 'interface-changed' | 'function-signature' | 'enum-modified' | 'default-export-changed';
+    severity: 'critical' | 'high' | 'medium';
+    description: string;
+    affectedFiles: string[];
+    line?: number;
+}
+interface MissingFile {
+    file: string;
+    reason: string;
+    severity: 'high' | 'medium' | 'low';
+    relatedChangedFile: string;
+    relationship: 'imports' | 'imported-by' | 'sibling-type' | 'test' | 'co-located';
+}
+interface ImpactRadius {
+    directlyAffected: number;
+    transitivelyAffected: number;
+    totalAffected: number;
+    affectedTests: number;
+    riskScore: number;
+    hotspots: {
+        file: string;
+        dependents: number;
+        riskScore: number;
+    }[];
+}
+interface ReviewQuality {
+    score: number;
+    grade: string;
+    factors: ReviewFactor[];
+}
+interface ReviewFactor {
+    name: string;
+    score: number;
+    weight: number;
+    detail: string;
+}
+interface ReviewOptions {
+    baseBranch?: string;
+    depth?: number;
+    includeTests?: boolean;
+    maxPromptFiles?: number;
+    maxPromptTokens?: number;
+}
+declare function analyzeForReview(analysis: ProjectAnalysis, options?: ReviewOptions): Promise<ReviewResult>;
+declare function renderReviewSummary(branch: string, baseBranch: string, changedFiles: ReviewFile[], breakingChanges: BreakingChange[], missingFiles: MissingFile[], impactRadius: ImpactRadius, reviewQuality: ReviewQuality): string;
+
+export { type Baseline, type BenchmarkResult, type BreakingChange, type ChangeType, type ChangedFile, type CompilabilityMetrics, type CompilabilityResult, type CompileProofResult, type CompileProofStrategy, type ContextScore, type CrossPackageEdge, type CrossRepoModel, type CrossRepoPrediction, CtoError, type CtoErrorCode, DEFAULT_GATE_CONFIG, type DiffHunk, type DimensionScore, type FeedbackEntry, type FeedbackInsight, type FeedbackModel, type FeedbackOutcome, type FileChangeEvent, type Grade, type ImpactRadius, type LogEntry, type LogLevel, type Logger, MODEL_REGISTRY, type MissingFile, type ModelOptimization, type ModelProfile, type MonorepoAnalysis, type MonorepoTool, type MultiModelResult, type PRContextOptions, type PRContextResult, type PackageContextResult, type PackageInfo, type PredictionResult, type PredictorModel, type ProjectFingerprint, ProjectWatcher, type QualityBenchmarkResult, type QualityGateCheck, type QualityGateConfig, type QualityGateResult, type QualityMetrics, type ReviewFactor, type ReviewFile, type ReviewOptions, type ReviewQuality, type ReviewResult, type ScoreInsight, type SelectionInput, type SemanticAnalysis, type SemanticDomain, type SemanticFingerprint, type StrategyResult, type TeamFeedbackExport, type WatcherOptions, analyzeForReview, analyzeMonorepo, analyzeProject, analyzeSemantics, bfsBidirectional, buildAdjacencyList, buildProjectGraph, calculateCoverage, classifyFileKind, computeContextScore, computeFingerprint, configureCache, countTokensChars4, countTokensTiktoken, createLogger, createProject, detectMonorepoTool, detectStack, estimateFileTokens, estimateTokens, exportFeedbackForTeam, freeEncoder, generatePRContext, getActiveWatchers, getCTODir, getCacheStats, getCachedAnalysis, getConfigPath, getCrossRepoStats, getFeedbackBoosts, getModelStats, getPolicyPath, getPredictorBoosts, getPruneLevelForRisk, importTeamFeedback, initProjectConfig, invalidateCache, isCtoError, loadBaseline, loadConfig, loadFeedbackModel, loadGlobalModel, loadModel, loadPolicyFromYAML, matchGlob, optimizeBudget, optimizeForModels, predictFromCrossRepo, predictRelevantFiles, pruneFile, pruneFiles, recordCrossRepoSelection, recordFeedback, recordSelection, renderBenchmark, renderCompilabilityBenchmark, renderCompileProof, renderContextScore, renderCrossRepoReport, renderFeedbackReport, renderMonorepoAnalysis, renderMultiModelResult, renderPackageContext, renderQualityBenchmark, renderReviewSummary, renderSemanticAnalysis, runBenchmark, runCompilabilityBenchmark, runCompileProof, runQualityBenchmark, runQualityGate, saveBaseline, saveConfig, scoreAllFiles, scoreFile, selectContext, selectPackageContext, semanticBoosts, setJsonLogging, setLogLevel, unwatchAll, unwatchProject, walkProject, watchProject, wilsonLowerBound, wrapError };