@pratik7368patil/anchor-core 0.1.6 → 0.1.8

package/dist/index.d.ts

@@ -3,6 +3,16 @@ import { Octokit } from '@octokit/rest';
 
 type SourceType = "pr_body" | "review_comment" | "issue_comment" | "review_summary" | "commit_message" | "diff_context";
 type WisdomCategory = "architecture_decision" | "constraint" | "rejected_approach" | "bug_regression" | "testing_rule" | "api_contract" | "performance_note" | "security_note" | "style_convention" | "unknown";
+type ConfidenceLevel = "strong" | "moderate" | "weak";
+type FreshnessStatus = "current" | "possibly_stale" | "stale";
+type EvidenceRef = {
+    prNumber: number;
+    prUrl: string;
+    sourceType: SourceType;
+    author?: string;
+    filePath?: string;
+    note?: string;
+};
 type WisdomUnit = {
     id: string;
     repo: string;
@@ -19,6 +29,51 @@ type WisdomUnit = {
     mergedAt?: string;
     confidence: number;
 };
+type CodeFileRecord = {
+    repo: string;
+    path: string;
+    language?: string;
+    sizeBytes: number;
+    contentHash: string;
+    updatedAt: string;
+};
+type CodeChunk = {
+    id: string;
+    repo: string;
+    filePath: string;
+    language?: string;
+    startLine: number;
+    endLine: number;
+    sanitizedText: string;
+    symbols: string[];
+    contentHash: string;
+    updatedAt: string;
+};
+type RankedCodeChunk = CodeChunk & {
+    score: number;
+    scoreParts: {
+        filePathMatch: number;
+        symbolMatch: number;
+        textMatch: number;
+        recency: number;
+    };
+};
+type TeamRule = {
+    id: string;
+    category: WisdomCategory;
+    text: string;
+    sanitizedText: string;
+    filePaths: string[];
+    symbols: string[];
+    evidence: EvidenceRef[];
+    confidenceLevel: ConfidenceLevel;
+};
+type RankedTeamRule = TeamRule & {
+    score: number;
+    freshnessStatus: FreshnessStatus;
+    freshnessReason: string;
+    confidenceReasons: string[];
+};
 type PullRequestFile = {
     filename: string;
     patch?: string | null;
@@ -108,6 +163,28 @@ type IndexPullRequestsProgress = {
     prNumber: number;
     wisdomUnitsCreated: number;
 };
+type CodeIndexProgress = {
+    stage: "discovering_code_files";
+    repo: string;
+} | {
+    stage: "discovered_code_files";
+    repo: string;
+    files: number;
+    skippedFiles: number;
+} | {
+    stage: "indexing_code_file";
+    repo: string;
+    current: number;
+    total: number;
+    filePath: string;
+} | {
+    stage: "indexed_code_file";
+    repo: string;
+    current: number;
+    total: number;
+    filePath: string;
+    chunks: number;
+};
 type IndexSummary = {
     indexedPrs: number;
     indexedFiles: number;
@@ -116,6 +193,12 @@ type IndexSummary = {
     skippedItems: number;
     databasePath: string;
 };
+type CodeIndexSummary = {
+    indexedFiles: number;
+    codeChunksCreated: number;
+    skippedFiles: number;
+    databasePath: string;
+};
 type AnchorContextInput = {
     task: string;
     files?: string[];
@@ -123,6 +206,8 @@ type AnchorContextInput = {
     diff?: string;
     currentCode?: string;
     maxResults?: number;
+    strict?: boolean;
+    minConfidence?: ConfidenceLevel;
 };
 type SearchHistoryInput = {
     query: string;
@@ -141,6 +226,13 @@ type RankedWisdomUnit = WisdomUnit & {
         categoryPriority: number;
     };
     duplicateCount: number;
+    claimKey: string;
+    repeatedEvidenceCount: number;
+    confidenceLevel: ConfidenceLevel;
+    confidenceReasons: string[];
+    freshnessStatus: FreshnessStatus;
+    freshnessReason: string;
+    evidence: EvidenceRef;
 };
 type IndexStatus = {
     repo?: string;
@@ -149,7 +241,15 @@ type IndexStatus = {
     fileCount: number;
     commentCount: number;
     wisdomUnitCount: number;
+    codeFileCount: number;
+    codeChunkCount: number;
+    historyCoverage?: "limited" | "all" | "unknown";
+    historyLimit?: number;
+    staleEvidenceCount: number;
+    teamRuleCount: number;
     lastSyncTime?: string;
+    lastCodeIndexTime?: string;
+    lastRuleIndexTime?: string;
     githubTokenConfigured: boolean;
     health: "ok" | "missing_database" | "schema_invalid" | "empty_index";
 };
@@ -227,12 +327,17 @@ declare function initializeSchema(db: AnchorDatabase): void;
 declare function checkSchema(db: AnchorDatabase): boolean;
 declare function ensureRepository(db: AnchorDatabase, fullName: string): number;
 declare function getLastSyncTime(db: AnchorDatabase, repo: string): string | undefined;
-declare function updateSyncState(db: AnchorDatabase, repo: string, lastIndexedPr?: number): void;
+declare function updateSyncState(db: AnchorDatabase, repo: string, lastIndexedPr?: number, metadata?: {
+    historyCoverage?: "limited" | "all" | "unknown";
+    historyLimit?: number;
+    historySince?: string;
+}): void;
 declare function upsertPullRequest(db: AnchorDatabase, pr: PullRequestRecord, wisdomUnits: WisdomUnit[]): {
     files: number;
     comments: number;
     wisdom: number;
 };
+declare function replaceCodeIndex(db: AnchorDatabase, repo: string, codeFiles: CodeFileRecord[], codeChunks: CodeChunk[], skippedFiles: number, cwd: string): CodeIndexSummary;
 declare function getIndexStatus(cwd: string, githubTokenConfigured?: boolean, databasePath?: string): IndexStatus;
 
 declare const SCHEMA_SQL: string;
@@ -240,6 +345,37 @@ declare const SCHEMA_SQL: string;
 declare function hasHighSignalLanguage(text: string): boolean;
 declare function chunkHistoricalText(text: string, maxChunkLength?: number): string[];
 
+type ChunkableCodeFile = CodeFileRecord & {
+    content: string;
+};
+declare function extractCodeSymbols(text: string, filePath: string): string[];
+declare function chunkCodeFile(file: ChunkableCodeFile, options?: {
+    chunkLines?: number;
+    overlapLines?: number;
+}): CodeChunk[];
+
+declare const DEFAULT_MAX_CODE_FILE_BYTES: number;
+type DiscoveredCodeFile = CodeFileRecord & {
+    absolutePath: string;
+    content: string;
+};
+type CodeFileDiscoveryResult = {
+    files: DiscoveredCodeFile[];
+    skippedFiles: number;
+};
+declare function isHardExcludedCodePath(filePath: string): boolean;
+declare function discoverCodeFiles(cwd: string, repo: string, options?: {
+    maxFileBytes?: number;
+}): CodeFileDiscoveryResult;
+
+declare function indexCodebase(db: AnchorDatabase, options: {
+    cwd: string;
+    repo: string;
+    maxFileBytes?: number;
+    onProgress?: (progress: CodeIndexProgress) => void;
+}): CodeIndexSummary;
+declare function emptyCodeIndexSummary(cwd: string): CodeIndexSummary;
+
 declare function categorizeWisdom(text: string): WisdomCategory;
 declare function extractSymbols(text: string, filePaths: string[]): string[];
 declare function extractWisdomUnits(pr: PullRequestRecord): WisdomUnit[];
@@ -250,6 +386,9 @@ declare function indexPullRequests(db: AnchorDatabase, pullRequests: PullRequest
     cwd: string;
     repo: string;
     updateSyncStateAfter?: boolean;
+    historyCoverage?: "limited" | "all" | "unknown";
+    historyLimit?: number;
+    historySince?: string;
     onProgress?: (progress: IndexPullRequestsProgress) => void;
 }): IndexSummary;
 
@@ -260,14 +399,61 @@ declare function clampMaxResults(value: number | undefined, defaultValue: number
 
 declare function rankWisdomUnits(db: AnchorDatabase, input: AnchorContextInput | SearchHistoryInput): RankedWisdomUnit[];
 
+declare function rankCodeChunks(db: AnchorDatabase, input: AnchorContextInput): RankedCodeChunk[];
+
+type CurrentCodeSnapshot = {
+    hasCodeIndex: boolean;
+    filePaths: Set<string>;
+    symbolsByFile: Map<string, Set<string>>;
+    allSymbols: Set<string>;
+};
+type FreshnessResult = {
+    status: FreshnessStatus;
+    reason: string;
+};
+declare function claimKeyFor(category: WisdomCategory, sanitizedText: string): string;
+declare function confidenceLevelFor(confidence: number): ConfidenceLevel;
+declare function confidenceRank(level: ConfidenceLevel): number;
+declare function confidenceAtLeast(level: ConfidenceLevel, minimum: ConfidenceLevel): boolean;
+declare function evidenceForWisdom(unit: WisdomUnit): EvidenceRef;
+declare function confidenceReasonsFor(unit: WisdomUnit, repeatedEvidenceCount: number): string[];
+declare function sourceTypeLabel(sourceType: SourceType): string;
+declare function loadCurrentCodeSnapshot(db: AnchorDatabase): CurrentCodeSnapshot;
+declare function evaluateFreshness(subject: {
+    filePaths: string[];
+    symbols: string[];
+}, snapshot: CurrentCodeSnapshot): FreshnessResult;
+
 type FormattedResult = {
     markdown: string;
     metadata: Record<string, unknown>;
 };
-declare function formatAnchorContext(units: RankedWisdomUnit[], input: AnchorContextInput): FormattedResult;
+declare function formatAnchorContext(units: RankedWisdomUnit[], input: AnchorContextInput, codeChunks?: RankedCodeChunk[], teamRules?: RankedTeamRule[], warnings?: string[]): FormattedResult;
 declare function formatSearchHistory(units: RankedWisdomUnit[]): FormattedResult;
 declare function formatIndexStatus(status: IndexStatus): FormattedResult;
 
+declare const TEAM_RULES_FILE = "anchor.rules.json";
+type TeamRulesValidationResult = {
+    ok: boolean;
+    path: string;
+    errors: string[];
+    rules: TeamRule[];
+};
+type RulesInitResult = {
+    path: string;
+    created: boolean;
+};
+declare function ensureTeamRulesFile(cwd: string): RulesInitResult;
+declare function loadTeamRulesFile(cwd: string): TeamRulesValidationResult & {
+    exists: boolean;
+};
+declare function validateTeamRulesFile(cwd: string): TeamRulesValidationResult;
+declare function rankTeamRules(db: AnchorDatabase, cwd: string, input: AnchorContextInput): RankedTeamRule[];
+declare function countValidTeamRules(cwd: string): {
+    count: number;
+    lastRuleIndexTime?: string;
+};
+
 declare function createGitHubClient(token: string): Octokit;
 
 type FetchPullRequestsOptions = {
@@ -293,4 +479,4 @@ type DoctorOptions = {
 };
 declare function runDoctor(options: DoctorOptions): Promise<DoctorReport>;
 
-export { ANCHOR_CURSOR_RULE, type AnchorContextInput, type AnchorDatabase, type CursorMcpConfig, type DoctorCheck, type DoctorOptions, type DoctorReport, type FetchPullRequestsOptions, type FetchPullRequestsProgress, type FormattedResult, type GitHubRepo, type GitHubTokenResolution, type GitHubTokenResolverOptions, type GitHubTokenSource, type IndexPullRequestsProgress, type IndexStatus, type IndexSummary, type PullRequestComment, type PullRequestCommit, type PullRequestFile, type PullRequestPerson, type PullRequestRecord, type RankedWisdomUnit, SCHEMA_SQL, type SearchHistoryInput, type SourceType, type WisdomCategory, type WisdomUnit, anchorMcpEntry, buildFtsQuery, canonicalizeText, categorizeWisdom, checkSchema, chunkHistoricalText, clampMaxResults, clipSentence, createGitHubClient, defaultDatabasePath, detectGitHubRepo, detectGitRoot, ensureAnchorGitExclude, ensureCursorConfig, ensureCursorRule, ensureRepository, extractSymbols, extractWisdomUnits, fetchMergedPullRequests, fetchPullRequestDetails, formatAnchorContext, formatIndexStatus, formatSearchHistory, getIndexStatus, getLastSyncTime, githubAuthFixMessage, hasHighSignalLanguage, indexPullRequests, initializeSchema, mergeAnchorMcpConfig, normalizePullRequest, openAnchorDatabase, parseGitHubRemote, rankWisdomUnits, redactSecrets, redactedHistoricalText, resolveGitHubToken, resolvePullRequestDetailConcurrency, resolvePullRequestFetchLimit, runDoctor, sanitizeHistoricalText, shouldSyncSince, stripPromptInjection, tokenizeSearchText, truncateText, uniqueStrings, updateSyncState, upsertPullRequest };
+export { ANCHOR_CURSOR_RULE, type AnchorContextInput, type AnchorDatabase, type ChunkableCodeFile, type CodeChunk, type CodeFileDiscoveryResult, type CodeFileRecord, type CodeIndexProgress, type CodeIndexSummary, type ConfidenceLevel, type CurrentCodeSnapshot, type CursorMcpConfig, DEFAULT_MAX_CODE_FILE_BYTES, type DiscoveredCodeFile, type DoctorCheck, type DoctorOptions, type DoctorReport, type EvidenceRef, type FetchPullRequestsOptions, type FetchPullRequestsProgress, type FormattedResult, type FreshnessResult, type FreshnessStatus, type GitHubRepo, type GitHubTokenResolution, type GitHubTokenResolverOptions, type GitHubTokenSource, type IndexPullRequestsProgress, type IndexStatus, type IndexSummary, type PullRequestComment, type PullRequestCommit, type PullRequestFile, type PullRequestPerson, type PullRequestRecord, type RankedCodeChunk, type RankedTeamRule, type RankedWisdomUnit, type RulesInitResult, SCHEMA_SQL, type SearchHistoryInput, type SourceType, TEAM_RULES_FILE, type TeamRule, type TeamRulesValidationResult, type WisdomCategory, type WisdomUnit, anchorMcpEntry, buildFtsQuery, canonicalizeText, categorizeWisdom, checkSchema, chunkCodeFile, chunkHistoricalText, claimKeyFor, clampMaxResults, clipSentence, confidenceAtLeast, confidenceLevelFor, confidenceRank, confidenceReasonsFor, countValidTeamRules, createGitHubClient, defaultDatabasePath, detectGitHubRepo, detectGitRoot, discoverCodeFiles, emptyCodeIndexSummary, ensureAnchorGitExclude, ensureCursorConfig, ensureCursorRule, ensureRepository, ensureTeamRulesFile, evaluateFreshness, evidenceForWisdom, extractCodeSymbols, extractSymbols, extractWisdomUnits, fetchMergedPullRequests, fetchPullRequestDetails, formatAnchorContext, formatIndexStatus, formatSearchHistory, getIndexStatus, getLastSyncTime, githubAuthFixMessage, hasHighSignalLanguage, indexCodebase, indexPullRequests, initializeSchema, isHardExcludedCodePath, loadCurrentCodeSnapshot, loadTeamRulesFile, mergeAnchorMcpConfig, normalizePullRequest, openAnchorDatabase, parseGitHubRemote, rankCodeChunks, rankTeamRules, rankWisdomUnits, redactSecrets, redactedHistoricalText, replaceCodeIndex, resolveGitHubToken, resolvePullRequestDetailConcurrency, resolvePullRequestFetchLimit, runDoctor, sanitizeHistoricalText, shouldSyncSince, sourceTypeLabel, stripPromptInjection, tokenizeSearchText, truncateText, uniqueStrings, updateSyncState, upsertPullRequest, validateTeamRulesFile };