@pratik7368patil/anchor-core 0.1.15 → 0.1.18

package/dist/index.d.ts

@@ -8,6 +8,18 @@ type FreshnessStatus = "current" | "possibly_stale" | "stale";
 type CoverageGrade = "empty" | "poor" | "fair" | "good" | "excellent";
 type ArchitectureArea = "api" | "service" | "component" | "hook" | "route" | "store" | "test" | "schema" | "type" | "config" | "util" | "unknown";
 type ReliabilityGateStatus = "passed" | "weak" | "failed";
+type GitHubFetchBackend = "graphql" | "rest";
+type GitHubGraphQLFetchCheckpoint = {
+    repo: string;
+    scope: string;
+    cursor?: string | null;
+    scannedPullRequests: number;
+    matchedMergedPullRequests: number;
+    pageSize: number;
+    resetAt?: string | null;
+    reason: string;
+    updatedAt: string;
+};
 type EvidenceRef = {
     prNumber: number;
     prUrl: string;
@@ -306,6 +318,7 @@ type FetchPullRequestsProgress = {
     all: boolean;
     limit?: number;
     since?: string;
+    backend?: GitHubFetchBackend;
 } | {
     stage: "scanned_pull_request_page";
     repo: string;
@@ -313,6 +326,8 @@ type FetchPullRequestsProgress = {
     limit?: number;
     scannedPullRequests: number;
     matchedMergedPullRequests: number;
+    backend?: GitHubFetchBackend;
+    pageSize?: number;
 } | {
     stage: "discovered_pull_requests";
     repo: string;
@@ -320,6 +335,7 @@ type FetchPullRequestsProgress = {
     total: number;
     limit?: number;
     detailConcurrency: number;
+    backend?: GitHubFetchBackend;
 } | {
     stage: "fetching_pull_request_details";
     repo: string;
@@ -334,6 +350,61 @@ type FetchPullRequestsProgress = {
     total: number;
     prNumber: number;
     detailConcurrency: number;
+} | {
+    stage: "enriching_pull_request_patches";
+    repo: string;
+    current: number;
+    total: number;
+    prNumber: number;
+    detailConcurrency: number;
+} | {
+    stage: "enriched_pull_request_patches";
+    repo: string;
+    current: number;
+    total: number;
+    prNumber: number;
+    detailConcurrency: number;
+    patches: number;
+} | {
+    stage: "skipped_pull_request_patch_enrichment";
+    repo: string;
+    current: number;
+    total: number;
+    prNumber: number;
+    reason: string;
+} | {
+    stage: "github_fetch_backend_fallback";
+    repo: string;
+    from: GitHubFetchBackend;
+    to: GitHubFetchBackend;
+    reason: string;
+} | {
+    stage: "github_graphql_page_size_reduced";
+    repo: string;
+    previousPageSize: number;
+    nextPageSize: number;
+    reason: string;
+} | {
+    stage: "github_graphql_page_size_selected";
+    repo: string;
+    previousPageSize: number;
+    nextPageSize: number;
+    remaining?: number | null;
+    averageCostPerPr?: number;
+} | {
+    stage: "github_graphql_budget_deferred";
+    repo: string;
+    remaining?: number | null;
+    reserve: number;
+    resetAt?: string | null;
+    matchedMergedPullRequests: number;
+} | {
+    stage: "github_graphql_checkpoint_resumed";
+    repo: string;
+    scannedPullRequests: number;
+    matchedMergedPullRequests: number;
+    pageSize: number;
+    resetAt?: string | null;
 } | {
     stage: "github_rate_limited";
     repo: string;
@@ -632,6 +703,15 @@ declare function updateSyncState(db: AnchorDatabase, repo: string, lastIndexedPr
     historyLimit?: number;
     historySince?: string;
 }): void;
+declare function graphQLFetchCheckpointScope(input: {
+    repo: string;
+    all?: boolean;
+    limit?: number;
+    since?: string;
+}): string;
+declare function getGraphQLFetchCheckpoint(db: AnchorDatabase, repo: string, scope: string): GitHubGraphQLFetchCheckpoint | undefined;
+declare function saveGraphQLFetchCheckpoint(db: AnchorDatabase, checkpoint: GitHubGraphQLFetchCheckpoint): void;
+declare function clearGraphQLFetchCheckpoint(db: AnchorDatabase, repo: string, scope?: string): void;
 declare function upsertPullRequest(db: AnchorDatabase, pr: PullRequestRecord, wisdomUnits: WisdomUnit[], regressionEvents?: RegressionEvent[]): {
     files: number;
     comments: number;
@@ -954,6 +1034,11 @@ type GitHubRateLimitController = {
     now?: () => number;
     blockedUntilMs?: number;
 };
+type GitHubGraphQLRateLimitState = {
+    cost?: number | null;
+    remaining?: number | null;
+    resetAt?: string | null;
+};
 type GitHubRateLimitErrorLike = {
     status?: number;
     message?: string;
@@ -970,6 +1055,8 @@ declare function getGitHubRateLimitDelayMs(error: GitHubRateLimitErrorLike, atte
     delayMs: number;
     reason: string;
 };
+declare function isGitHubGraphQLResourceLimitError(error: unknown): boolean;
+declare function updateGitHubGraphQLRateLimitState(controller: GitHubRateLimitController, rateLimit: GitHubGraphQLRateLimitState | undefined, requestName: string): void;
 declare function requestWithGitHubRateLimit<T>(request: () => Promise<T>, options: {
     controller: GitHubRateLimitController;
     requestName: string;
@@ -978,8 +1065,35 @@ declare function requestWithGitHubRateLimit<T>(request: () => Promise<T>, option
 declare function paginateWithGitHubRateLimit<T>(requestPage: (page: number) => Promise<GitHubResponse<T[]>>, options: {
     controller: GitHubRateLimitController;
     requestName: string;
+    maxRetries?: number;
 }): Promise<T[]>;
 
+type GitHubGraphQLFetch = typeof fetch;
+type GitHubGraphQLResponse<T> = {
+    data: T;
+    headers: Record<string, string | number | undefined>;
+};
+declare class GitHubGraphQLError extends Error {
+    readonly status: number;
+    readonly response: {
+        headers: Record<string, string | number | undefined>;
+    };
+    constructor(message: string, options: {
+        status: number;
+        headers: Record<string, string | number | undefined>;
+    });
+}
+declare function createGitHubGraphQLRequester(options: {
+    token: string;
+    fetchImpl?: GitHubGraphQLFetch;
+}): <T extends {
+    rateLimit?: GitHubGraphQLRateLimitState;
+}>(query: string, variables: Record<string, unknown>, requestOptions: {
+    controller: GitHubRateLimitController;
+    requestName: string;
+    maxRetries?: number;
+}) => Promise<GitHubGraphQLResponse<T>>;
+
 type FetchPullRequestsOptions = {
     token: string;
     repo: string;
@@ -988,17 +1102,40 @@ type FetchPullRequestsOptions = {
     detailConcurrency?: number;
     since?: string;
     onProgress?: (progress: FetchPullRequestsProgress) => void;
+    fetchImpl?: GitHubGraphQLFetch;
+    restClient?: Octokit;
+    graphQLCheckpoint?: GitHubGraphQLFetchCheckpoint;
+    onGraphQLCheckpoint?: (checkpoint: GitHubGraphQLFetchCheckpoint | null) => void;
 };
 declare function resolvePullRequestFetchLimit(options: Pick<FetchPullRequestsOptions, "all" | "limit">): number | undefined;
 declare function resolvePullRequestDetailConcurrency(options: Pick<FetchPullRequestsOptions, "detailConcurrency">): number;
+declare function shouldFallbackToRestAfterGraphQLError(error: unknown): boolean;
 declare function fetchMergedPullRequests(options: FetchPullRequestsOptions): Promise<PullRequestRecord[]>;
 
+type FetchMergedPullRequestsGraphQLOptions = {
+    token: string;
+    repo: string;
+    limit?: number;
+    all?: boolean;
+    detailConcurrency: number;
+    since?: string;
+    controller: GitHubRateLimitController;
+    restController?: GitHubRateLimitController;
+    graphQLCheckpoint?: GitHubGraphQLFetchCheckpoint;
+    onGraphQLCheckpoint?: (checkpoint: GitHubGraphQLFetchCheckpoint | null) => void;
+    onProgress?: (progress: FetchPullRequestsProgress) => void;
+    fetchImpl?: GitHubGraphQLFetch;
+    restClient?: Octokit;
+};
+declare function fetchMergedPullRequestsWithGraphQL(options: FetchMergedPullRequestsGraphQLOptions): Promise<PullRequestRecord[]>;
+
 declare function fetchPullRequestDetails(octokit: Octokit, repoFullName: string, pullNumber: number, controller?: GitHubRateLimitController): Promise<PullRequestRecord>;
 
 type DoctorOptions = {
     cwd: string;
     env?: NodeJS.ProcessEnv;
     githubClientFactory?: (token: string) => Pick<Octokit, "repos">;
+    githubGraphQLCheck?: (token: string) => Promise<boolean> | boolean;
     mcpServerCheck?: () => Promise<boolean> | boolean;
 };
 declare function runDoctor(options: DoctorOptions): Promise<DoctorReport>;
@@ -1008,4 +1145,4 @@ declare function getAnchorIndexHealth(cwd: string): AnchorIndexHealth & {
     indexStatus: IndexStatus;
 };
 
-export { ANCHOR_CURSOR_RULE, ANCHOR_EVALS_FILE, ANCHOR_PLAYBOOKS_FILE, type AnchorCiInput, type AnchorContextInput, type AnchorDatabase, type AnchorExplainFileInput, type AnchorIndexHealth, type AnchorReviewDiffInput, type ArchitectureArea, type ArchitectureCheckInput, type ArchitectureComponent, type ArchitectureContextInput, type ArchitectureIndexData, type ArchitectureMap, type ArchitectureMapEdge, type ArchitectureMapFormat, type ArchitectureMapInput, type ArchitectureMapNode, type ArchitecturePattern, type ArchitectureQueryInput, type ChunkableCodeFile, type CodeChunk, type CodeFileDiscoveryResult, type CodeFileRecord, type CodeImport, type CodeIndexProgress, type CodeIndexSummary, type ConfidenceLevel, type CoverageGrade, type CoverageInput, type CoverageReport, type CurrentCodeSnapshot, type CursorMcpConfig, DEFAULT_MAX_CODE_FILE_BYTES, DEMO_CODE_FILES, DEMO_PULL_REQUESTS, DEMO_REPO, type DiscoveredCodeFile, type DoctorCheck, type DoctorOptions, type DoctorReport, type EvidenceRef, type FeedbackEvent, type FeedbackRating, type FetchPullRequestsOptions, type FetchPullRequestsProgress, type FormattedResult, type FreshnessResult, type FreshnessStatus, type GitHubRateLimitController, type GitHubRateLimitErrorLike, type GitHubRateLimitProgress, type GitHubRepo, type GitHubTokenResolution, type GitHubTokenResolverOptions, type GitHubTokenSource, type IndexPullRequestsProgress, type IndexRunRecord, type IndexStatus, type IndexSummary, type LocalEmbeddingProvider, type OnboardingInput, type OnboardingPack, type Playbook, type PullRequestComment, type PullRequestCommit, type PullRequestFile, type PullRequestPerson, type PullRequestRecord, type RankedArchitecturePattern, type RankedCodeChunk, type RankedRegressionEvent, type RankedTeamRule, type RankedTestFile, type RankedWisdomUnit, type RegressionEvent, type ReliabilityGate, type ReliabilityGateRejection, type ReliabilityGateResult, type ReliabilityGateStatus, type RetrievalEvalCase, type RetrievalEvalResult, type RetrievalEvalRunResult, type RulesAddInput, type RulesAddResult, type RulesEvidenceCheckResult, type RulesInitResult, type RulesSuggestOptions, SCHEMA_SQL, type SearchHistoryInput, type SemanticStatus, type SourceType, type SuggestedPrompt, TEAM_RULES_FILE, type TaskPlan, type TeamRule, type TeamRuleSuggestion, type TeamRulesValidationResult, type TestCommand, type TestFileRecord, type TestLink, type WatchRefreshInput, type WisdomCategory, type WisdomUnit, addRetrievalEval, addTeamRule, anchorMcpEntry, architectureFilesFromDiff, buildAnchorContextResult, buildArchitectureIndex, buildArchitectureMap, buildFtsQuery, buildOnboardingPack, buildQueryTerms, calculateCoverage, canonicalizeText, categorizeWisdom, checkArchitecture, checkSchema, checkTeamRuleEvidence, chunkCodeFile, chunkHistoricalText, claimKeyFor, clampMaxResults, classifyArchitectureArea, clipSentence, confidenceAtLeast, confidenceLevelFor, confidenceRank, confidenceReasonsFor, countValidTeamRules, createGitHubClient, defaultDatabasePath, detectGitHubRepo, detectGitRoot, detectTestCommands, detectTestCommandsForFile, discoverCodeFiles, emptyCodeIndexSummary, ensureAnchorGitExclude, ensureCursorConfig, ensureCursorRule, ensureRepository, ensureTeamRulesFile, evaluateFreshness, evaluateIndexHealth, evaluateReliabilityGate, evidenceForWisdom, explainFile, extractCodeImports, extractCodeSymbols, extractRegressionEvents, extractSymbols, extractWisdomUnits, feedbackAdjustedScore, fetchMergedPullRequests, fetchPullRequestDetails, filesFromDiff, formatAnchorContext, formatIndexStatus, formatSearchHistory, getAnchorIndexHealth, getArchitectureContext, getArchitectureMapContext, getGitHubRateLimitDelayMs, getIndexStatus, getLastSyncTime, getPlaybook, getSemanticStatus, getSuggestedPromptTexts, getSuggestedPrompts, getWisdomCategoryCounts, githubAuthFixMessage, hasHighSignalLanguage, indexCodebase, indexPullRequests, inferTestAwareness, initPlaybooks, initRetrievalEvals, initializeSchema, isGitHubRateLimitError, isHardExcludedCodePath, isTestFilePath, listFeedbackEvents, listPlaybooks, loadCurrentCodeSnapshot, loadTeamRulesFile, mergeAnchorMcpConfig, normalizePullRequest, openAnchorDatabase, paginateWithGitHubRateLimit, parseGitHubRemote, planTask, rankArchitecturePatterns, rankCodeChunks, rankRegressionEvents, rankRelevantTests, rankTeamRules, rankWisdomUnits, recordFeedback, recordIndexRun, redactSecrets, redactedHistoricalText, refreshTestCommands, refreshWatchIndex, replaceCodeIndex, requestWithGitHubRateLimit, resolveGitHubToken, resolvePullRequestDetailConcurrency, resolvePullRequestFetchLimit, reviewDiff, runAnchorCi, runDoctor, runRetrievalEvals, sanitizeHistoricalText, shouldSyncSince, sourceTypeLabel, stripPromptInjection, suggestPlaybooks, suggestTeamRules, syncPlaybooksToDatabase, tokenizeSearchText, truncateText, uniqueStrings, updateSyncState, upsertPullRequest, validateTeamRulesFile, watchCodebase };
+export { ANCHOR_CURSOR_RULE, ANCHOR_EVALS_FILE, ANCHOR_PLAYBOOKS_FILE, type AnchorCiInput, type AnchorContextInput, type AnchorDatabase, type AnchorExplainFileInput, type AnchorIndexHealth, type AnchorReviewDiffInput, type ArchitectureArea, type ArchitectureCheckInput, type ArchitectureComponent, type ArchitectureContextInput, type ArchitectureIndexData, type ArchitectureMap, type ArchitectureMapEdge, type ArchitectureMapFormat, type ArchitectureMapInput, type ArchitectureMapNode, type ArchitecturePattern, type ArchitectureQueryInput, type ChunkableCodeFile, type CodeChunk, type CodeFileDiscoveryResult, type CodeFileRecord, type CodeImport, type CodeIndexProgress, type CodeIndexSummary, type ConfidenceLevel, type CoverageGrade, type CoverageInput, type CoverageReport, type CurrentCodeSnapshot, type CursorMcpConfig, DEFAULT_MAX_CODE_FILE_BYTES, DEMO_CODE_FILES, DEMO_PULL_REQUESTS, DEMO_REPO, type DiscoveredCodeFile, type DoctorCheck, type DoctorOptions, type DoctorReport, type EvidenceRef, type FeedbackEvent, type FeedbackRating, type FetchMergedPullRequestsGraphQLOptions, type FetchPullRequestsOptions, type FetchPullRequestsProgress, type FormattedResult, type FreshnessResult, type FreshnessStatus, type GitHubFetchBackend, GitHubGraphQLError, type GitHubGraphQLFetch, type GitHubGraphQLFetchCheckpoint, type GitHubGraphQLRateLimitState, type GitHubGraphQLResponse, type GitHubRateLimitController, type GitHubRateLimitErrorLike, type GitHubRateLimitProgress, type GitHubRepo, type GitHubTokenResolution, type GitHubTokenResolverOptions, type GitHubTokenSource, type IndexPullRequestsProgress, type IndexRunRecord, type IndexStatus, type IndexSummary, type LocalEmbeddingProvider, type OnboardingInput, type OnboardingPack, type Playbook, type PullRequestComment, type PullRequestCommit, type PullRequestFile, type PullRequestPerson, type PullRequestRecord, type RankedArchitecturePattern, type RankedCodeChunk, type RankedRegressionEvent, type RankedTeamRule, type RankedTestFile, type RankedWisdomUnit, type RegressionEvent, type ReliabilityGate, type ReliabilityGateRejection, type ReliabilityGateResult, type ReliabilityGateStatus, type RetrievalEvalCase, type RetrievalEvalResult, type RetrievalEvalRunResult, type RulesAddInput, type RulesAddResult, type RulesEvidenceCheckResult, type RulesInitResult, type RulesSuggestOptions, SCHEMA_SQL, type SearchHistoryInput, type SemanticStatus, type SourceType, type SuggestedPrompt, TEAM_RULES_FILE, type TaskPlan, type TeamRule, type TeamRuleSuggestion, type TeamRulesValidationResult, type TestCommand, type TestFileRecord, type TestLink, type WatchRefreshInput, type WisdomCategory, type WisdomUnit, addRetrievalEval, addTeamRule, anchorMcpEntry, architectureFilesFromDiff, buildAnchorContextResult, buildArchitectureIndex, buildArchitectureMap, buildFtsQuery, buildOnboardingPack, buildQueryTerms, calculateCoverage, canonicalizeText, categorizeWisdom, checkArchitecture, checkSchema, checkTeamRuleEvidence, chunkCodeFile, chunkHistoricalText, claimKeyFor, clampMaxResults, classifyArchitectureArea, clearGraphQLFetchCheckpoint, clipSentence, confidenceAtLeast, confidenceLevelFor, confidenceRank, confidenceReasonsFor, countValidTeamRules, createGitHubClient, createGitHubGraphQLRequester, defaultDatabasePath, detectGitHubRepo, detectGitRoot, detectTestCommands, detectTestCommandsForFile, discoverCodeFiles, emptyCodeIndexSummary, ensureAnchorGitExclude, ensureCursorConfig, ensureCursorRule, ensureRepository, ensureTeamRulesFile, evaluateFreshness, evaluateIndexHealth, evaluateReliabilityGate, evidenceForWisdom, explainFile, extractCodeImports, extractCodeSymbols, extractRegressionEvents, extractSymbols, extractWisdomUnits, feedbackAdjustedScore, fetchMergedPullRequests, fetchMergedPullRequestsWithGraphQL, fetchPullRequestDetails, filesFromDiff, formatAnchorContext, formatIndexStatus, formatSearchHistory, getAnchorIndexHealth, getArchitectureContext, getArchitectureMapContext, getGitHubRateLimitDelayMs, getGraphQLFetchCheckpoint, getIndexStatus, getLastSyncTime, getPlaybook, getSemanticStatus, getSuggestedPromptTexts, getSuggestedPrompts, getWisdomCategoryCounts, githubAuthFixMessage, graphQLFetchCheckpointScope, hasHighSignalLanguage, indexCodebase, indexPullRequests, inferTestAwareness, initPlaybooks, initRetrievalEvals, initializeSchema, isGitHubGraphQLResourceLimitError, isGitHubRateLimitError, isHardExcludedCodePath, isTestFilePath, listFeedbackEvents, listPlaybooks, loadCurrentCodeSnapshot, loadTeamRulesFile, mergeAnchorMcpConfig, normalizePullRequest, openAnchorDatabase, paginateWithGitHubRateLimit, parseGitHubRemote, planTask, rankArchitecturePatterns, rankCodeChunks, rankRegressionEvents, rankRelevantTests, rankTeamRules, rankWisdomUnits, recordFeedback, recordIndexRun, redactSecrets, redactedHistoricalText, refreshTestCommands, refreshWatchIndex, replaceCodeIndex, requestWithGitHubRateLimit, resolveGitHubToken, resolvePullRequestDetailConcurrency, resolvePullRequestFetchLimit, reviewDiff, runAnchorCi, runDoctor, runRetrievalEvals, sanitizeHistoricalText, saveGraphQLFetchCheckpoint, shouldFallbackToRestAfterGraphQLError, shouldSyncSince, sourceTypeLabel, stripPromptInjection, suggestPlaybooks, suggestTeamRules, syncPlaybooksToDatabase, tokenizeSearchText, truncateText, uniqueStrings, updateGitHubGraphQLRateLimitState, updateSyncState, upsertPullRequest, validateTeamRulesFile, watchCodebase };