@pratik7368patil/anchor-core 0.1.8 → 0.1.9

package/dist/index.d.ts

@@ -57,6 +57,8 @@ type RankedCodeChunk = CodeChunk & {
         textMatch: number;
         recency: number;
     };
+    matchReasons: string[];
+    rankSignals: Record<string, number>;
 };
 type TeamRule = {
     id: string;
@@ -73,6 +75,8 @@ type RankedTeamRule = TeamRule & {
     freshnessStatus: FreshnessStatus;
     freshnessReason: string;
     confidenceReasons: string[];
+    matchReasons: string[];
+    rankSignals: Record<string, number>;
 };
 type PullRequestFile = {
     filename: string;
@@ -114,6 +118,49 @@ type PullRequestRecord = {
     issueComments?: PullRequestComment[];
     commits?: PullRequestCommit[];
 };
+type TestFileRecord = {
+    repo: string;
+    path: string;
+    language?: string;
+    sizeBytes: number;
+    contentHash: string;
+    updatedAt: string;
+};
+type TestLink = {
+    repo: string;
+    sourcePath: string;
+    testPath: string;
+    reason: string;
+    strength: number;
+};
+type RankedTestFile = TestFileRecord & {
+    sourcePath?: string;
+    reason: string;
+    strength: number;
+    score: number;
+    matchedSymbols: string[];
+};
+type RegressionEvent = {
+    id: string;
+    repo: string;
+    prNumber: number;
+    prUrl: string;
+    summary: string;
+    filePaths: string[];
+    symbols: string[];
+    testPaths: string[];
+    authors: string[];
+    labels: string[];
+    signals: string[];
+    createdAt: string;
+    mergedAt?: string;
+    confidence: number;
+};
+type RankedRegressionEvent = RegressionEvent & {
+    score: number;
+    matchReasons: string[];
+    rankSignals: Record<string, number>;
+};
 type FetchPullRequestsProgress = {
     stage: "discovering_pull_requests";
     repo: string;
@@ -190,12 +237,15 @@ type IndexSummary = {
     indexedFiles: number;
     indexedComments: number;
     wisdomUnitsCreated: number;
+    regressionEventsCreated: number;
     skippedItems: number;
     databasePath: string;
 };
 type CodeIndexSummary = {
     indexedFiles: number;
     codeChunksCreated: number;
+    testFilesIndexed: number;
+    testLinksCreated: number;
     skippedFiles: number;
     databasePath: string;
 };
@@ -213,6 +263,7 @@ type SearchHistoryInput = {
     query: string;
     files?: string[];
     categories?: WisdomCategory[];
+    regressionsOnly?: boolean;
     maxResults?: number;
 };
 type RankedWisdomUnit = WisdomUnit & {
@@ -233,6 +284,51 @@ type RankedWisdomUnit = WisdomUnit & {
     freshnessStatus: FreshnessStatus;
     freshnessReason: string;
     evidence: EvidenceRef;
+    matchReasons: string[];
+    rankSignals: Record<string, number>;
+};
+type AnchorExplainFileInput = {
+    file: string;
+    symbols?: string[];
+    strict?: boolean;
+    maxResults?: number;
+};
+type AnchorReviewDiffInput = {
+    diff: string;
+    files?: string[];
+    strict?: boolean;
+    maxResults?: number;
+};
+type IndexRunRecord = {
+    id?: number;
+    command: string;
+    repo?: string;
+    startedAt: string;
+    finishedAt?: string;
+    historyCoverage?: "limited" | "all" | "unknown";
+    historyLimit?: number;
+    prsFetched?: number;
+    prsSkipped?: number;
+    commentsIndexed?: number;
+    codeFilesIndexed?: number;
+    testFilesIndexed?: number;
+    failures?: string[];
+    status: "success" | "failed";
+};
+type AnchorIndexHealth = {
+    status: "ok" | "warning" | "error";
+    warnings: string[];
+    suggestedNextCommand?: string;
+    historyCoverage: "limited" | "all" | "unknown";
+    staleCodeIndex: boolean;
+    lastSuccessfulRun?: string;
+    lastFailedRun?: string;
+};
+type SemanticStatus = {
+    enabled: boolean;
+    mode: "disabled" | "local";
+    available: boolean;
+    reason: string;
 };
 type IndexStatus = {
     repo?: string;
@@ -243,6 +339,9 @@ type IndexStatus = {
     wisdomUnitCount: number;
     codeFileCount: number;
     codeChunkCount: number;
+    testFileCount: number;
+    testLinkCount: number;
+    regressionEventCount: number;
     historyCoverage?: "limited" | "all" | "unknown";
     historyLimit?: number;
     staleEvidenceCount: number;
@@ -250,6 +349,10 @@ type IndexStatus = {
     lastSyncTime?: string;
     lastCodeIndexTime?: string;
     lastRuleIndexTime?: string;
+    lastSuccessfulRun?: string;
+    lastFailedRun?: string;
+    staleCodeIndex?: boolean;
+    suggestedNextCommand?: string;
     githubTokenConfigured: boolean;
     health: "ok" | "missing_database" | "schema_invalid" | "empty_index";
 };
@@ -332,12 +435,14 @@ declare function updateSyncState(db: AnchorDatabase, repo: string, lastIndexedPr
     historyLimit?: number;
     historySince?: string;
 }): void;
-declare function upsertPullRequest(db: AnchorDatabase, pr: PullRequestRecord, wisdomUnits: WisdomUnit[]): {
+declare function upsertPullRequest(db: AnchorDatabase, pr: PullRequestRecord, wisdomUnits: WisdomUnit[], regressionEvents?: RegressionEvent[]): {
     files: number;
     comments: number;
     wisdom: number;
+    regressions: number;
 };
 declare function replaceCodeIndex(db: AnchorDatabase, repo: string, codeFiles: CodeFileRecord[], codeChunks: CodeChunk[], skippedFiles: number, cwd: string): CodeIndexSummary;
+declare function recordIndexRun(db: AnchorDatabase, run: IndexRunRecord): void;
 declare function getIndexStatus(cwd: string, githubTokenConfigured?: boolean, databasePath?: string): IndexStatus;
 
 declare const SCHEMA_SQL: string;
@@ -376,6 +481,14 @@ declare function indexCodebase(db: AnchorDatabase, options: {
 }): CodeIndexSummary;
 declare function emptyCodeIndexSummary(cwd: string): CodeIndexSummary;
 
+declare function isTestFilePath(filePath: string): boolean;
+declare function inferTestAwareness(repo: string, codeFiles: CodeFileRecord[], codeChunks: CodeChunk[]): {
+    testFiles: TestFileRecord[];
+    testLinks: TestLink[];
+};
+
+declare function extractRegressionEvents(pr: PullRequestRecord): RegressionEvent[];
+
 declare function categorizeWisdom(text: string): WisdomCategory;
 declare function extractSymbols(text: string, filePaths: string[]): string[];
 declare function extractWisdomUnits(pr: PullRequestRecord): WisdomUnit[];
@@ -394,6 +507,7 @@ declare function indexPullRequests(db: AnchorDatabase, pullRequests: PullRequest
 
 declare function shouldSyncSince(db: AnchorDatabase, repo: string, fallbackSince?: string): string | undefined;
 
+declare function buildQueryTerms(input: AnchorContextInput | SearchHistoryInput): string[];
 declare function buildFtsQuery(input: AnchorContextInput | SearchHistoryInput): string;
 declare function clampMaxResults(value: number | undefined, defaultValue: number): number;
 
@@ -401,6 +515,32 @@ declare function rankWisdomUnits(db: AnchorDatabase, input: AnchorContextInput |
 
 declare function rankCodeChunks(db: AnchorDatabase, input: AnchorContextInput): RankedCodeChunk[];
 
+declare function rankRelevantTests(db: AnchorDatabase, input: AnchorContextInput): RankedTestFile[];
+
+declare function rankRegressionEvents(db: AnchorDatabase, input: AnchorContextInput | SearchHistoryInput): RankedRegressionEvent[];
+
+type FormattedResult = {
+    markdown: string;
+    metadata: Record<string, unknown>;
+};
+declare function formatAnchorContext(units: RankedWisdomUnit[], input: AnchorContextInput, codeChunks?: RankedCodeChunk[], teamRules?: RankedTeamRule[], warnings?: string[], relevantTests?: RankedTestFile[], regressionEvents?: RankedRegressionEvent[], extraMetadata?: Record<string, unknown>): FormattedResult;
+declare function formatSearchHistory(units: RankedWisdomUnit[]): FormattedResult;
+declare function formatIndexStatus(status: IndexStatus): FormattedResult;
+
+declare function buildAnchorContextResult(db: AnchorDatabase, cwd: string, input: AnchorContextInput, warnings?: string[]): FormattedResult;
+
+declare function explainFile(db: AnchorDatabase, cwd: string, input: AnchorExplainFileInput): FormattedResult;
+
+declare function filesFromDiff(diff: string): string[];
+declare function reviewDiff(db: AnchorDatabase, cwd: string, input: AnchorReviewDiffInput): FormattedResult;
+
+type LocalEmbeddingProvider = {
+    name: string;
+    isAvailable(): boolean;
+    embed(texts: string[]): Promise<number[][]>;
+};
+declare function getSemanticStatus(env?: NodeJS.ProcessEnv, provider?: LocalEmbeddingProvider): SemanticStatus;
+
 type CurrentCodeSnapshot = {
     hasCodeIndex: boolean;
     filePaths: Set<string>;
@@ -424,14 +564,6 @@ declare function evaluateFreshness(subject: {
     symbols: string[];
 }, snapshot: CurrentCodeSnapshot): FreshnessResult;
 
-type FormattedResult = {
-    markdown: string;
-    metadata: Record<string, unknown>;
-};
-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;
@@ -443,11 +575,37 @@ type RulesInitResult = {
     path: string;
     created: boolean;
 };
+type RulesAddInput = {
+    id: string;
+    category: WisdomCategory;
+    text: string;
+    filePaths?: string[];
+    symbols?: string[];
+    prNumber: number;
+    prUrl: string;
+    sourceType?: SourceType;
+};
+type RulesAddResult = {
+    path: string;
+    rule: TeamRule;
+};
+type RulesEvidenceCheckResult = {
+    ok: boolean;
+    path: string;
+    checked: number;
+    missing: Array<{
+        ruleId: string;
+        prNumber: number;
+    }>;
+    errors: string[];
+};
 declare function ensureTeamRulesFile(cwd: string): RulesInitResult;
 declare function loadTeamRulesFile(cwd: string): TeamRulesValidationResult & {
     exists: boolean;
 };
 declare function validateTeamRulesFile(cwd: string): TeamRulesValidationResult;
+declare function addTeamRule(cwd: string, input: RulesAddInput): RulesAddResult;
+declare function checkTeamRuleEvidence(cwd: string): RulesEvidenceCheckResult;
 declare function rankTeamRules(db: AnchorDatabase, cwd: string, input: AnchorContextInput): RankedTeamRule[];
 declare function countValidTeamRules(cwd: string): {
     count: number;
@@ -479,4 +637,9 @@ type DoctorOptions = {
 };
 declare function runDoctor(options: DoctorOptions): Promise<DoctorReport>;
 
-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 };
+declare function evaluateIndexHealth(status: IndexStatus, rulesOk: boolean): AnchorIndexHealth;
+declare function getAnchorIndexHealth(cwd: string): AnchorIndexHealth & {
+    indexStatus: IndexStatus;
+};
+
+export { ANCHOR_CURSOR_RULE, type AnchorContextInput, type AnchorDatabase, type AnchorExplainFileInput, type AnchorIndexHealth, type AnchorReviewDiffInput, 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 IndexRunRecord, type IndexStatus, type IndexSummary, type LocalEmbeddingProvider, type PullRequestComment, type PullRequestCommit, type PullRequestFile, type PullRequestPerson, type PullRequestRecord, type RankedCodeChunk, type RankedRegressionEvent, type RankedTeamRule, type RankedTestFile, type RankedWisdomUnit, type RegressionEvent, type RulesAddInput, type RulesAddResult, type RulesEvidenceCheckResult, type RulesInitResult, SCHEMA_SQL, type SearchHistoryInput, type SemanticStatus, type SourceType, TEAM_RULES_FILE, type TeamRule, type TeamRulesValidationResult, type TestFileRecord, type TestLink, type WisdomCategory, type WisdomUnit, addTeamRule, anchorMcpEntry, buildAnchorContextResult, buildFtsQuery, buildQueryTerms, canonicalizeText, categorizeWisdom, checkSchema, checkTeamRuleEvidence, chunkCodeFile, chunkHistoricalText, claimKeyFor, clampMaxResults, clipSentence, confidenceAtLeast, confidenceLevelFor, confidenceRank, confidenceReasonsFor, countValidTeamRules, createGitHubClient, defaultDatabasePath, detectGitHubRepo, detectGitRoot, discoverCodeFiles, emptyCodeIndexSummary, ensureAnchorGitExclude, ensureCursorConfig, ensureCursorRule, ensureRepository, ensureTeamRulesFile, evaluateFreshness, evaluateIndexHealth, evidenceForWisdom, explainFile, extractCodeSymbols, extractRegressionEvents, extractSymbols, extractWisdomUnits, fetchMergedPullRequests, fetchPullRequestDetails, filesFromDiff, formatAnchorContext, formatIndexStatus, formatSearchHistory, getAnchorIndexHealth, getIndexStatus, getLastSyncTime, getSemanticStatus, githubAuthFixMessage, hasHighSignalLanguage, indexCodebase, indexPullRequests, inferTestAwareness, initializeSchema, isHardExcludedCodePath, isTestFilePath, loadCurrentCodeSnapshot, loadTeamRulesFile, mergeAnchorMcpConfig, normalizePullRequest, openAnchorDatabase, parseGitHubRemote, rankCodeChunks, rankRegressionEvents, rankRelevantTests, rankTeamRules, rankWisdomUnits, recordIndexRun, redactSecrets, redactedHistoricalText, replaceCodeIndex, resolveGitHubToken, resolvePullRequestDetailConcurrency, resolvePullRequestFetchLimit, reviewDiff, runDoctor, sanitizeHistoricalText, shouldSyncSince, sourceTypeLabel, stripPromptInjection, tokenizeSearchText, truncateText, uniqueStrings, updateSyncState, upsertPullRequest, validateTeamRulesFile };