cto-ai-cli 1.3.0

package/dist/core/index.d.ts

@@ -0,0 +1,717 @@
+import { Project } from 'ts-morph';
+import { EventEmitter } from 'node:events';
+
+type Tier = 'hot' | 'warm' | 'cold';
+type ModelPreference = 'opus' | 'sonnet' | 'haiku';
+interface FileInfo {
+    path: string;
+    relativePath: string;
+    size: number;
+    tokens: number;
+    extension: string;
+    lastModified: Date;
+    lastAccessed: Date;
+    tier: Tier;
+    lines: number;
+    imports?: string[];
+    importedBy?: string[];
+    importCount?: number;
+    importedByCount?: number;
+    isHub?: boolean;
+    complexity?: number;
+    modelSuggestion?: ModelPreference;
+}
+interface TierThresholds {
+    hotDays: number;
+    warmDays: number;
+    hotTokenLimit: number;
+    warmTokenLimit: number;
+}
+interface ProjectAnalysis {
+    projectPath: string;
+    projectName: string;
+    totalFiles: number;
+    totalTokens: number;
+    totalSize: number;
+    files: FileInfo[];
+    tiers: TierSummary;
+    analyzedAt: Date;
+    dependencyGraph?: DependencyGraph;
+    tokenEstimationMethod?: 'chars4' | 'tiktoken';
+}
+interface TierSummary {
+    hot: TierDetail;
+    warm: TierDetail;
+    cold: TierDetail;
+}
+interface TierDetail {
+    files: FileInfo[];
+    totalTokens: number;
+    totalSize: number;
+    count: number;
+    percentage: number;
+}
+interface CTOConfig {
+    version: string;
+    extensions: ExtensionConfig;
+    tiering: TierThresholds;
+    ignoreDirs: string[];
+    ignorePatterns: string[];
+    model: ModelPreference;
+    tokenEstimation: 'chars4' | 'tiktoken';
+}
+interface ExtensionConfig {
+    code: string[];
+    config: string[];
+    docs: string[];
+    ignore: string[];
+}
+interface ProjectConfig extends Partial<CTOConfig> {
+    projectPath: string;
+    customRules?: string[];
+}
+interface GeneratedArtifact {
+    type: 'claude-md' | 'claudeignore';
+    content: string;
+    targetPath: string;
+    projectPath: string;
+}
+interface BackupEntry {
+    id: string;
+    artifactType: 'claude-md' | 'claudeignore';
+    originalPath: string;
+    backupPath: string;
+    timestamp: Date;
+    projectPath: string;
+    hadOriginal: boolean;
+}
+interface ApplyResult {
+    success: boolean;
+    artifact: GeneratedArtifact;
+    backup?: BackupEntry;
+    error?: string;
+}
+interface RevertResult {
+    success: boolean;
+    backup: BackupEntry;
+    error?: string;
+}
+interface SessionInfo {
+    id: string;
+    projectPath: string;
+    startedAt: Date;
+    endedAt?: Date;
+    tokensEstimated: number;
+    filesRead: string[];
+    description?: string;
+    coldFilesRead: number;
+    warmFilesRead: number;
+    hotFilesRead: number;
+    suggestions: string[];
+}
+interface PromptTemplate {
+    id: string;
+    name: string;
+    description: string;
+    template: string;
+    category: 'task' | 'review' | 'debug' | 'refactor' | 'test';
+}
+interface DiffResult {
+    artifact: GeneratedArtifact;
+    currentContent: string | null;
+    diff: string;
+    hasChanges: boolean;
+}
+interface DependencyEdge {
+    from: string;
+    to: string;
+    type: 'import' | 'export' | 're-export';
+}
+interface DependencyGraph {
+    nodes: string[];
+    edges: DependencyEdge[];
+    hubs: HubFile[];
+    leaves: string[];
+}
+interface HubFile {
+    relativePath: string;
+    importedByCount: number;
+    importCount: number;
+    score: number;
+}
+interface FileComplexity {
+    relativePath: string;
+    cyclomaticComplexity: number;
+    functions: FunctionComplexity[];
+    modelSuggestion: ModelPreference;
+}
+interface FunctionComplexity {
+    name: string;
+    complexity: number;
+    startLine: number;
+    endLine: number;
+}
+interface WatchEvent {
+    type: 'add' | 'change' | 'unlink';
+    filePath: string;
+    relativePath: string;
+    timestamp: Date;
+}
+interface TierChangeEvent {
+    relativePath: string;
+    previousTier: Tier;
+    newTier: Tier;
+    reason: string;
+}
+interface SessionFileRead {
+    relativePath: string;
+    tier: Tier;
+    tokens: number;
+    timestamp: Date;
+}
+interface SessionMetrics {
+    totalSessions: number;
+    totalTokensConsumed: number;
+    totalTokensSaved: number;
+    savingsPercent: number;
+    averageSessionDuration: number;
+    mostReadFiles: Array<{
+        relativePath: string;
+        readCount: number;
+        tier: Tier;
+    }>;
+    wastePatterns: WastePattern[];
+}
+interface WastePattern {
+    type: 'cold-reads' | 'repeated-reads' | 'large-context';
+    description: string;
+    impact: number;
+    suggestion: string;
+}
+interface DashboardData {
+    projectName: string;
+    sessionsToday: number;
+    tokensConsumed: number;
+    tokensSaved: number;
+    savingsRatio: number;
+    mostReadFiles: Array<{
+        relativePath: string;
+        readCount: number;
+    }>;
+    suggestions: string[];
+    tiers: TierSummary;
+    recentSessions: SessionInfo[];
+}
+interface WeeklyReport {
+    projectPath: string;
+    projectName: string;
+    weekStart: Date;
+    weekEnd: Date;
+    sessions: SessionInfo[];
+    totalTokensConsumed: number;
+    totalTokensSaved: number;
+    trend: number;
+    topFiles: Array<{
+        relativePath: string;
+        readCount: number;
+    }>;
+    suggestions: string[];
+}
+interface MCPToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+interface SecurityConfig {
+    encryptionEnabled: boolean;
+    secretDetection: boolean;
+    auditLogging: boolean;
+    retentionDays: number;
+    securePermissions: boolean;
+    customSecretPatterns?: string[];
+}
+interface SecretFinding {
+    type: SecretType;
+    file: string;
+    line: number;
+    match: string;
+    redacted: string;
+    severity: 'critical' | 'high' | 'medium' | 'low';
+}
+type SecretType = 'api-key' | 'aws-key' | 'private-key' | 'password' | 'token' | 'connection-string' | 'env-variable' | 'custom';
+interface AuditEntry {
+    id: string;
+    timestamp: Date;
+    action: AuditAction;
+    user: string;
+    projectPath: string;
+    details: Record<string, unknown>;
+    integrityHash: string;
+}
+type AuditAction = 'analyze' | 'generate' | 'apply' | 'revert' | 'clean' | 'session-start' | 'session-end' | 'config-change' | 'secret-detected' | 'integrity-check' | 'data-purge';
+interface IntegrityManifest {
+    version: string;
+    createdAt: Date;
+    entries: IntegrityEntry[];
+}
+interface IntegrityEntry {
+    filePath: string;
+    hash: string;
+    size: number;
+    createdAt: Date;
+    type: 'artifact' | 'backup' | 'config' | 'session';
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    artifactsUpToDate: boolean;
+    integrityOk: boolean;
+    secretsClean: boolean;
+}
+interface DoctorCheck {
+    name: string;
+    status: 'pass' | 'warn' | 'fail';
+    message: string;
+}
+type PruneLevel = 'full' | 'signatures' | 'skeleton' | 'none';
+interface PrunedFile {
+    relativePath: string;
+    originalTokens: number;
+    prunedTokens: number;
+    pruneLevel: PruneLevel;
+    content: string;
+    savings: number;
+}
+interface PruneResult {
+    files: PrunedFile[];
+    totalOriginalTokens: number;
+    totalPrunedTokens: number;
+    totalSavings: number;
+    savingsPercent: number;
+}
+interface GitFileInfo {
+    relativePath: string;
+    lastCommitDate: Date;
+    lastAuthor: string;
+    commitCount: number;
+    isInDiff: boolean;
+    isNewFile: boolean;
+    linesChanged: number;
+}
+interface GitContext {
+    branch: string;
+    isGitRepo: boolean;
+    changedFiles: GitFileInfo[];
+    recentCommits: number;
+    activeDevelopers: string[];
+}
+interface ModelPricing {
+    model: ModelPreference;
+    inputPerMillion: number;
+    outputPerMillion: number;
+    cacheReadPerMillion: number;
+}
+interface CostEstimate {
+    model: ModelPreference;
+    withoutCTO: CostBreakdown;
+    withCTO: CostBreakdown;
+    saved: CostBreakdown;
+    savingsPercent: number;
+}
+interface CostBreakdown {
+    tokens: number;
+    cost: number;
+    formatted: string;
+}
+interface BudgetResult {
+    budget: number;
+    usedTokens: number;
+    remainingTokens: number;
+    includedFiles: BudgetFile[];
+    excludedFiles: BudgetFile[];
+    fillPercent: number;
+}
+interface BudgetFile {
+    relativePath: string;
+    tokens: number;
+    tier: Tier;
+    pruneLevel: PruneLevel;
+    included: boolean;
+    reason: string;
+}
+type AITarget = 'claude' | 'cursor' | 'copilot' | 'gemini' | 'windsurf';
+interface AIAdapter {
+    target: AITarget;
+    fileName: string;
+    generate: (analysis: ProjectAnalysis, config: CTOConfig) => string;
+}
+interface PRContext {
+    baseBranch: string;
+    changedFiles: string[];
+    dependencies: string[];
+    contextFiles: FileInfo[];
+    totalTokens: number;
+    generatedContent: string;
+}
+interface TierExplanation {
+    file: string;
+    tier: Tier;
+    factors: ExplainFactor[];
+    summary: string;
+}
+interface ExplainFactor {
+    name: string;
+    value: string;
+    impact: 'promotes' | 'neutral' | 'demotes';
+    weight: number;
+}
+type TaskType = 'debug' | 'review' | 'refactor' | 'test' | 'docs' | 'simple-edit' | 'feature' | 'architecture';
+interface ModelRecommendation {
+    task: TaskType;
+    recommended: ModelPreference;
+    reason: string;
+    estimatedTokens: number;
+    estimatedCost: string;
+    alternatives: Array<{
+        model: ModelPreference;
+        reason: string;
+    }>;
+}
+interface RoutingRule {
+    task: TaskType;
+    maxComplexity: number;
+    maxFiles: number;
+    defaultModel: ModelPreference;
+}
+interface LocalProjectConfig {
+    version: string;
+    model?: ModelPreference;
+    autoRouting?: boolean;
+    tiering?: Partial<TierThresholds>;
+    ignoreDirs?: string[];
+    extensions?: Partial<ExtensionConfig>;
+    security?: Partial<SecurityConfig>;
+}
+
+declare function estimateTokens(sizeInBytes: number): number;
+declare function analyzeProject(projectPath: string): Promise<ProjectAnalysis>;
+declare function loadAnalysis(projectPath: string): Promise<ProjectAnalysis | null>;
+declare function detectStack(files: FileInfo[]): string[];
+declare function detectTestFramework(files: FileInfo[]): string;
+
+interface WalkEntry {
+    path: string;
+    relativePath: string;
+    extension: string;
+    size: number;
+    lastModified: Date;
+    lastAccessed: Date;
+    lines: number;
+}
+
+declare function classifyFile(entry: WalkEntry, thresholds: TierThresholds): Tier;
+declare function classifyFileWithAST(file: FileInfo, thresholds: TierThresholds): Tier;
+declare function buildTierSummary(files: FileInfo[], totalTokens: number): TierSummary;
+declare function getTierFiles(files: FileInfo[], tier: Tier): FileInfo[];
+declare function getTokenSavings(files: FileInfo[]): {
+    withOptimization: number;
+    withoutOptimization: number;
+    saved: number;
+    savingsPercent: number;
+};
+
+declare function generateClaudeMd(analysis: ProjectAnalysis): Promise<GeneratedArtifact>;
+declare function generateClaudeignore(analysis: ProjectAnalysis): Promise<GeneratedArtifact>;
+declare function loadGeneratedArtifact(projectPath: string, type: 'claude-md' | 'claudeignore'): Promise<string | null>;
+
+declare function initCTODir(): Promise<void>;
+declare function loadGlobalConfig(): Promise<CTOConfig>;
+declare function saveGlobalConfig(config: CTOConfig): Promise<void>;
+declare function loadProjectConfig(projectPath: string): Promise<CTOConfig>;
+declare function saveProjectConfig(projectPath: string, config: Partial<ProjectConfig>): Promise<void>;
+declare function hasGlobalConfig(): Promise<boolean>;
+
+declare function applyArtifact(artifact: GeneratedArtifact): Promise<ApplyResult>;
+declare function revertArtifact(projectPath: string, artifactType?: 'claude-md' | 'claudeignore'): Promise<RevertResult>;
+declare function diffArtifact(artifact: GeneratedArtifact): Promise<DiffResult>;
+declare function listBackups(projectPath: string): Promise<BackupEntry[]>;
+
+interface CleanResult {
+    success: boolean;
+    projectPath: string;
+    removedDir: string;
+    error?: string;
+}
+declare function cleanProject(projectPath: string): Promise<CleanResult>;
+
+declare function getPromptTemplates(): PromptTemplate[];
+declare function getPromptById(id: string): PromptTemplate | undefined;
+declare function renderPrompt(template: PromptTemplate, analysis: ProjectAnalysis, taskDescription?: string): string;
+declare function listPromptCategories(): string[];
+
+declare function countTokensTiktoken(text: string): number;
+declare function countTokensChars4(sizeInBytes: number): number;
+declare function estimateFileTokens(filePath: string, method?: 'chars4' | 'tiktoken'): Promise<number>;
+declare function freeEncoder(): void;
+
+declare function createProject(projectPath: string, filePaths: string[]): Project;
+declare function buildDependencyGraph(project: Project, projectPath: string): DependencyGraph;
+declare function analyzeFileComplexity(project: Project, projectPath: string, filePath: string): FileComplexity | null;
+declare function analyzeAllComplexity(project: Project, projectPath: string): FileComplexity[];
+declare function enrichFilesWithAST(files: FileInfo[], graph: DependencyGraph, complexities: FileComplexity[]): FileInfo[];
+
+interface WatcherOptions {
+    debounceMs?: number;
+    autoRegenerate?: boolean;
+    verbose?: boolean;
+}
+declare class ProjectWatcher extends EventEmitter {
+    private watcher;
+    private projectPath;
+    private options;
+    private currentAnalysis;
+    private tierCache;
+    private debounceTimer;
+    private pendingChanges;
+    private extensions;
+    private running;
+    constructor(projectPath: string, options?: WatcherOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    getLastAnalysis(): ProjectAnalysis | null;
+    private handleEvent;
+    private processPendingChanges;
+}
+
+declare function startSession(projectPath: string, description?: string): Promise<SessionInfo>;
+declare function endSession(projectPath: string, analysis?: ProjectAnalysis): Promise<SessionInfo | null>;
+declare function getCurrentSession(projectPath: string): Promise<SessionInfo | null>;
+declare function logFileRead(projectPath: string, fileRead: SessionFileRead): Promise<void>;
+declare function listSessions(projectPath: string, limit?: number): Promise<SessionInfo[]>;
+declare function getSessionMetrics(projectPath: string, analysis?: ProjectAnalysis): Promise<SessionMetrics>;
+declare function getTodaySessions(projectPath: string): Promise<SessionInfo[]>;
+
+declare function getDashboardData(projectPath: string): Promise<DashboardData>;
+declare function renderDashboard(data: DashboardData): string;
+
+declare function generateWeeklyReport(projectPath: string): Promise<WeeklyReport>;
+declare function renderWeeklyReport(report: WeeklyReport): string;
+declare function generateProjectReport(projectPaths: string[]): Promise<string>;
+declare function exportMetrics(projectPath: string, format?: 'json' | 'csv'): Promise<string>;
+
+declare const DEFAULT_SECURITY_CONFIG: SecurityConfig;
+declare function scanContentForSecrets(content: string, filePath: string, customPatterns?: string[]): SecretFinding[];
+declare function scanFileForSecrets(filePath: string, projectPath: string, customPatterns?: string[]): Promise<SecretFinding[]>;
+declare function scanProjectForSecrets(projectPath: string, filePaths: string[], customPatterns?: string[]): Promise<SecretFinding[]>;
+declare function sanitizeContent(content: string, customPatterns?: string[]): string;
+
+declare function logAudit(action: AuditAction, projectPath: string, details?: Record<string, unknown>): Promise<AuditEntry>;
+declare function getAuditEntries(options?: {
+    projectPath?: string;
+    action?: AuditAction;
+    since?: Date;
+    limit?: number;
+}): Promise<AuditEntry[]>;
+declare function verifyAuditEntry(entry: AuditEntry): boolean;
+declare function verifyAuditIntegrity(): Promise<{
+    totalEntries: number;
+    validEntries: number;
+    invalidEntries: AuditEntry[];
+}>;
+declare function purgeOldAuditEntries(retentionDays: number): Promise<number>;
+
+declare function hashContent(content: string | Buffer): string;
+declare function hashFile(filePath: string): Promise<string | null>;
+declare function buildIntegrityManifest(projectPath: string): Promise<IntegrityManifest>;
+declare function verifyIntegrity(projectPath: string): Promise<{
+    valid: boolean;
+    total: number;
+    verified: number;
+    corrupted: string[];
+    missing: string[];
+}>;
+declare function secureFilePermissions(projectPath: string): Promise<number>;
+declare function purgeOldData(projectPath: string, retentionDays: number): Promise<{
+    purgedSessions: number;
+    purgedBackups: number;
+}>;
+
+declare function getPruneLevelForTier(tier: Tier): PruneLevel;
+declare function pruneFile(file: FileInfo, level?: PruneLevel): Promise<PrunedFile>;
+declare function pruneProject(files: FileInfo[]): Promise<PruneResult>;
+
+declare function isGitRepo(projectPath: string): Promise<boolean>;
+declare function getCurrentBranch(projectPath: string): Promise<string>;
+declare function getGitContext(projectPath: string, diffBase?: string): Promise<GitContext>;
+declare function getChangedFiles(projectPath: string, diffBase?: string): Promise<GitFileInfo[]>;
+declare function getFileGitInfo(projectPath: string, relativePath: string): Promise<GitFileInfo | null>;
+declare function getActiveDevelopers(projectPath: string, days: number): Promise<string[]>;
+declare function classifyFileWithGit(file: FileInfo, gitInfo: GitFileInfo | undefined, thresholds: TierThresholds): Tier;
+declare function enrichFilesWithGit(files: FileInfo[], projectPath: string, thresholds: TierThresholds): Promise<FileInfo[]>;
+
+declare const MODEL_PRICING: Record<ModelPreference, ModelPricing>;
+declare function estimateCost(tokens: number, model?: ModelPreference): CostBreakdown;
+declare function estimateSessionCost(files: FileInfo[], model?: ModelPreference): CostEstimate;
+declare function estimateWeeklyCost(sessions: SessionInfo[], totalProjectTokens: number, model?: ModelPreference): {
+    totalCost: CostBreakdown;
+    savedCost: CostBreakdown;
+    costWithoutCTO: CostBreakdown;
+    sessionsCount: number;
+    avgCostPerSession: string;
+};
+declare function estimateMonthlySavings(avgSessionsPerDay: number, avgTokensSaved: number, model?: ModelPreference): {
+    daily: string;
+    weekly: string;
+    monthly: string;
+    yearly: string;
+};
+declare function getModelPricingTable(): string;
+
+declare function optimizeBudget(files: FileInfo[], budget: number): Promise<BudgetResult>;
+
+declare const AI_ADAPTERS: Record<AITarget, AIAdapter>;
+declare const ALL_AI_TARGETS: AITarget[];
+declare function generateForTarget(target: AITarget, analysis: ProjectAnalysis, config: CTOConfig, options?: {
+    enhanced?: boolean;
+    task?: TaskType;
+}): {
+    fileName: string;
+    content: string;
+};
+declare function generateForAllTargets(analysis: ProjectAnalysis, config: CTOConfig, options?: {
+    enhanced?: boolean;
+    task?: TaskType;
+}): Array<{
+    target: AITarget;
+    fileName: string;
+    content: string;
+}>;
+
+declare function generatePRContext(analysis: ProjectAnalysis, baseBranch?: string): Promise<PRContext>;
+
+declare function explainTier(file: FileInfo, projectPath: string, thresholds: TierThresholds): Promise<TierExplanation>;
+declare function formatExplanation(explanation: TierExplanation): string;
+
+declare const ROUTING_RULES: RoutingRule[];
+declare const ALL_TASK_TYPES: TaskType[];
+declare function recommendModel(task: TaskType, analysis: ProjectAnalysis, targetFiles?: string[]): ModelRecommendation;
+declare function recommendModelForFiles(files: FileInfo[]): ModelPreference;
+declare function getTaskDescription(task: TaskType): string;
+
+declare function getLocalCTOPath(projectPath: string): string;
+declare function hasLocalConfig(projectPath: string): Promise<boolean>;
+declare function initLocalProject(projectPath: string, config?: Partial<LocalProjectConfig>): Promise<string>;
+declare function loadLocalConfig(projectPath: string): Promise<LocalProjectConfig | null>;
+declare function saveLocalConfig(projectPath: string, config: LocalProjectConfig): Promise<void>;
+declare function mergeLocalWithGlobal(globalConfig: CTOConfig, localConfig: LocalProjectConfig): CTOConfig;
+declare function detectProjectRoot(startPath: string): Promise<string>;
+
+interface EnhancedPromptOptions {
+    task?: TaskType;
+    stack?: string[];
+    testFramework?: string | null;
+    hotFiles?: FileInfo[];
+    totalTokens?: number;
+    enableCoT?: boolean;
+    enableConstraints?: boolean;
+    enableAntiHallucination?: boolean;
+    locale?: 'en' | 'es';
+}
+declare function buildRolePriming(stack: string[]): string;
+declare function buildChainOfThought(task?: TaskType): string;
+declare function buildConstraints(stack: string[], testFramework: string | null): string;
+declare function buildAntiHallucination(): string;
+declare function buildOutputFormat(task?: TaskType): string;
+declare function buildFilePriority(hotFiles: FileInfo[]): string;
+declare function buildEnhancedPrompt(analysis: ProjectAnalysis, opts?: EnhancedPromptOptions): string;
+declare function getTaskPromptBlock(task: TaskType): string;
+
+interface SpecEntry {
+    kind: 'interface' | 'type' | 'enum' | 'function' | 'class';
+    name: string;
+    file: string;
+    line: number;
+    exported: boolean;
+    signature: string;
+    properties?: SpecProperty[];
+    extends?: string[];
+    jsdoc?: string;
+}
+interface SpecProperty {
+    name: string;
+    type: string;
+    optional: boolean;
+}
+interface SpecMap {
+    projectName: string;
+    extractedAt: Date;
+    totalSpecs: number;
+    entries: SpecEntry[];
+    byFile: Record<string, SpecEntry[]>;
+    byKind: Record<string, SpecEntry[]>;
+}
+interface SpecValidation {
+    valid: boolean;
+    errors: SpecIssue[];
+    warnings: SpecIssue[];
+    stats: {
+        totalFunctions: number;
+        withReturnType: number;
+        totalInterfaces: number;
+        fullyDocumented: number;
+        exportedWithoutJSDoc: number;
+    };
+}
+interface SpecIssue {
+    file: string;
+    name: string;
+    line: number;
+    message: string;
+}
+declare function extractSpecs(projectPath: string, files: FileInfo[]): SpecMap;
+declare function generateSpecDocument(map: SpecMap): string;
+declare function validateSpecs(projectPath: string, files: FileInfo[]): SpecValidation;
+
+interface FocusResult {
+    targetFiles: FileInfo[];
+    dependencies: FileInfo[];
+    allFiles: FileInfo[];
+    totalTokens: number;
+    savedTokens: number;
+    savingsPercent: number;
+}
+declare function buildFocusContext(analysis: ProjectAnalysis, targetPaths: string[], depth?: number): FocusResult;
+declare function formatFocusDocument(analysis: ProjectAnalysis, focus: FocusResult): string;
+
+interface TodoItem {
+    file: string;
+    line: number;
+    type: 'TODO' | 'FIXME' | 'HACK' | 'XXX' | 'NOTE';
+    text: string;
+    tier: 'hot' | 'warm' | 'cold';
+    priority: 'high' | 'medium' | 'low';
+}
+interface TodoScanResult {
+    items: TodoItem[];
+    byType: Record<string, TodoItem[]>;
+    byPriority: Record<string, TodoItem[]>;
+    totalCount: number;
+}
+declare function scanTodos(files: FileInfo[]): Promise<TodoScanResult>;
+
+interface GitignoreResult {
+    ignoreDirs: string[];
+    ignorePatterns: string[];
+    raw: string[];
+}
+declare function parseGitignore(projectPath: string): Promise<GitignoreResult | null>;
+declare function mergeWithDefaults(gitignoreResult: GitignoreResult, defaultDirs: string[], defaultPatterns: string[]): {
+    ignoreDirs: string[];
+    ignorePatterns: string[];
+};
+
+export { type AIAdapter, type AITarget, AI_ADAPTERS, ALL_AI_TARGETS, ALL_TASK_TYPES, type ApplyResult, type AuditAction, type AuditEntry, type BackupEntry, type BudgetFile, type BudgetResult, type CTOConfig, type CostBreakdown, type CostEstimate, DEFAULT_SECURITY_CONFIG, type DashboardData, type DependencyEdge, type DependencyGraph, type DiffResult, type DoctorCheck, type ExplainFactor, type ExtensionConfig, type FileComplexity, type FileInfo, type FunctionComplexity, type GeneratedArtifact, type GitContext, type GitFileInfo, type HubFile, type IntegrityEntry, type IntegrityManifest, type LocalProjectConfig, type MCPToolResult, MODEL_PRICING, type ModelPreference, type ModelPricing, type ModelRecommendation, type PRContext, type ProjectAnalysis, type ProjectConfig, ProjectWatcher, type PromptTemplate, type PruneLevel, type PruneResult, type PrunedFile, ROUTING_RULES, type RevertResult, type RoutingRule, type SecretFinding, type SecretType, type SecurityConfig, type SessionFileRead, type SessionInfo, type SessionMetrics, type TaskType, type Tier, type TierChangeEvent, type TierDetail, type TierExplanation, type TierSummary, type TierThresholds, type ValidationResult, type WastePattern, type WatchEvent, type WeeklyReport, analyzeAllComplexity, analyzeFileComplexity, analyzeProject, applyArtifact, buildAntiHallucination, buildChainOfThought, buildConstraints, buildDependencyGraph, buildEnhancedPrompt, buildFilePriority, buildFocusContext, buildIntegrityManifest, buildOutputFormat, buildRolePriming, buildTierSummary, classifyFile, classifyFileWithAST, classifyFileWithGit, cleanProject, countTokensChars4, countTokensTiktoken, createProject, detectProjectRoot, detectStack, detectTestFramework, diffArtifact, endSession, enrichFilesWithAST, enrichFilesWithGit, estimateCost, estimateFileTokens, estimateMonthlySavings, estimateSessionCost, estimateTokens, estimateWeeklyCost, explainTier, exportMetrics, extractSpecs, formatExplanation, formatFocusDocument, freeEncoder, generateClaudeMd, generateClaudeignore, generateForAllTargets, generateForTarget, generatePRContext, generateProjectReport, generateSpecDocument, generateWeeklyReport, getActiveDevelopers, getAuditEntries, getChangedFiles, getCurrentBranch, getCurrentSession, getDashboardData, getFileGitInfo, getGitContext, getLocalCTOPath, getModelPricingTable, getPromptById, getPromptTemplates, getPruneLevelForTier, getSessionMetrics, getTaskDescription, getTaskPromptBlock, getTierFiles, getTodaySessions, getTokenSavings, hasGlobalConfig, hasLocalConfig, hashContent, hashFile, initCTODir, initLocalProject, isGitRepo, listBackups, listPromptCategories, listSessions, loadAnalysis, loadGeneratedArtifact, loadGlobalConfig, loadLocalConfig, loadProjectConfig, logAudit, logFileRead, mergeLocalWithGlobal, mergeWithDefaults, optimizeBudget, parseGitignore, pruneFile, pruneProject, purgeOldAuditEntries, purgeOldData, recommendModel, recommendModelForFiles, renderDashboard, renderPrompt, renderWeeklyReport, revertArtifact, sanitizeContent, saveGlobalConfig, saveLocalConfig, saveProjectConfig, scanContentForSecrets, scanFileForSecrets, scanProjectForSecrets, scanTodos, secureFilePermissions, startSession, validateSpecs, verifyAuditEntry, verifyAuditIntegrity, verifyIntegrity };