@pratik7368patil/anchor-core 0.1.11 → 0.1.13

package/dist/index.d.ts

@@ -6,6 +6,7 @@ type WisdomCategory = "architecture_decision" | "constraint" | "rejected_approac
 type ConfidenceLevel = "strong" | "moderate" | "weak";
 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 EvidenceRef = {
     prNumber: number;
     prUrl: string;
@@ -50,6 +51,49 @@ type CodeChunk = {
     contentHash: string;
     updatedAt: string;
 };
+type CodeImport = {
+    repo: string;
+    sourcePath: string;
+    specifier: string;
+    importedPath?: string;
+    importedSymbols: string[];
+    kind: "static" | "dynamic" | "require";
+};
+type ArchitectureComponent = {
+    repo: string;
+    path: string;
+    area: ArchitectureArea;
+    kind: string;
+    language?: string;
+    symbols: string[];
+    imports: string[];
+    relatedTests: string[];
+    confidence: number;
+    updatedAt: string;
+};
+type ArchitecturePattern = {
+    id: string;
+    repo: string;
+    area: ArchitectureArea;
+    name: string;
+    summary: string;
+    sanitizedSummary: string;
+    sourceFiles: string[];
+    symbols: string[];
+    evidence: EvidenceRef[];
+    confidence: number;
+    createdAt: string;
+};
+type RankedArchitecturePattern = ArchitecturePattern & {
+    score: number;
+    matchReasons: string[];
+    rankSignals: Record<string, number>;
+};
+type ArchitectureIndexData = {
+    components: ArchitectureComponent[];
+    patterns: ArchitecturePattern[];
+    imports: CodeImport[];
+};
 type RankedCodeChunk = CodeChunk & {
     score: number;
     scoreParts: {
@@ -200,6 +244,14 @@ type FetchPullRequestsProgress = {
     total: number;
     prNumber: number;
     detailConcurrency: number;
+} | {
+    stage: "github_rate_limited";
+    repo: string;
+    waitSeconds: number;
+    retryAt: string;
+    reason: string;
+    request: string;
+    attempt: number;
 };
 type IndexPullRequestsProgress = {
     stage: "indexing_pull_request";
@@ -236,6 +288,12 @@ type CodeIndexProgress = {
     total: number;
     filePath: string;
     chunks: number;
+} | {
+    stage: "indexed_architecture";
+    repo: string;
+    components: number;
+    patterns: number;
+    imports: number;
 };
 type IndexSummary = {
     indexedPrs: number;
@@ -251,6 +309,9 @@ type CodeIndexSummary = {
     codeChunksCreated: number;
     testFilesIndexed: number;
     testLinksCreated: number;
+    architectureComponentsIndexed: number;
+    architecturePatternsIndexed: number;
+    architectureImportsIndexed: number;
     skippedFiles: number;
     databasePath: string;
 };
@@ -353,12 +414,16 @@ type IndexStatus = {
     testFileCount: number;
     testLinkCount: number;
     regressionEventCount: number;
+    architectureComponentCount: number;
+    architecturePatternCount: number;
+    architectureImportCount: number;
     historyCoverage?: "limited" | "all" | "unknown";
     historyLimit?: number;
     staleEvidenceCount: number;
     teamRuleCount: number;
     lastSyncTime?: string;
     lastCodeIndexTime?: string;
+    lastArchitectureIndexTime?: string;
     lastRuleIndexTime?: string;
     lastSuccessfulRun?: string;
     lastFailedRun?: string;
@@ -456,7 +521,7 @@ declare function upsertPullRequest(db: AnchorDatabase, pr: PullRequestRecord, wi
     wisdom: number;
     regressions: number;
 };
-declare function replaceCodeIndex(db: AnchorDatabase, repo: string, codeFiles: CodeFileRecord[], codeChunks: CodeChunk[], skippedFiles: number, cwd: string): CodeIndexSummary;
+declare function replaceCodeIndex(db: AnchorDatabase, repo: string, codeFiles: CodeFileRecord[], codeChunks: CodeChunk[], skippedFiles: number, cwd: string, architecture?: ArchitectureIndexData): CodeIndexSummary;
 declare function recordIndexRun(db: AnchorDatabase, run: IndexRunRecord): void;
 declare function getIndexStatus(cwd: string, githubTokenConfigured?: boolean, databasePath?: string): IndexStatus;
 declare function getWisdomCategoryCounts(db: AnchorDatabase): Record<WisdomCategory, number>;
@@ -475,6 +540,10 @@ declare function chunkCodeFile(file: ChunkableCodeFile, options?: {
     overlapLines?: number;
 }): CodeChunk[];
 
+declare function classifyArchitectureArea(filePath: string, language?: string, content?: string): ArchitectureArea;
+declare function extractCodeImports(sourcePath: string, content: string, codePaths: Set<string>, repo?: string): CodeImport[];
+declare function buildArchitectureIndex(repo: string, files: ChunkableCodeFile[], chunks: CodeChunk[]): ArchitectureIndexData;
+
 declare const DEFAULT_MAX_CODE_FILE_BYTES: number;
 type DiscoveredCodeFile = CodeFileRecord & {
     absolutePath: string;
@@ -531,6 +600,11 @@ declare function rankWisdomUnits(db: AnchorDatabase, input: AnchorContextInput |
 
 declare function rankCodeChunks(db: AnchorDatabase, input: AnchorContextInput): RankedCodeChunk[];
 
+type ArchitectureQueryInput = AnchorContextInput & {
+    area?: ArchitectureArea;
+};
+declare function rankArchitecturePatterns(db: AnchorDatabase, input: ArchitectureQueryInput): RankedArchitecturePattern[];
+
 declare function rankRelevantTests(db: AnchorDatabase, input: AnchorContextInput): RankedTestFile[];
 
 declare function rankRegressionEvents(db: AnchorDatabase, input: AnchorContextInput | SearchHistoryInput): RankedRegressionEvent[];
@@ -539,7 +613,7 @@ 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 formatAnchorContext(units: RankedWisdomUnit[], input: AnchorContextInput, codeChunks?: RankedCodeChunk[], teamRules?: RankedTeamRule[], warnings?: string[], relevantTests?: RankedTestFile[], regressionEvents?: RankedRegressionEvent[], architecturePatterns?: RankedArchitecturePattern[], extraMetadata?: Record<string, unknown>): FormattedResult;
 declare function formatSearchHistory(units: RankedWisdomUnit[]): FormattedResult;
 declare function formatIndexStatus(status: IndexStatus): FormattedResult;
 
@@ -547,6 +621,21 @@ declare function buildAnchorContextResult(db: AnchorDatabase, cwd: string, input
 
 declare function explainFile(db: AnchorDatabase, cwd: string, input: AnchorExplainFileInput): FormattedResult;
 
+type ArchitectureContextInput = {
+    file?: string;
+    area?: ArchitectureArea;
+    query?: string;
+    maxResults?: number;
+};
+type ArchitectureCheckInput = {
+    diff: string;
+    files?: string[];
+    maxResults?: number;
+};
+declare function architectureFilesFromDiff(diff: string): string[];
+declare function getArchitectureContext(db: AnchorDatabase, _cwd: string, input?: ArchitectureContextInput): FormattedResult;
+declare function checkArchitecture(db: AnchorDatabase, _cwd: string, input: ArchitectureCheckInput): FormattedResult;
+
 declare function filesFromDiff(diff: string): string[];
 declare function reviewDiff(db: AnchorDatabase, cwd: string, input: AnchorReviewDiffInput): FormattedResult;
 
@@ -634,7 +723,7 @@ declare function countValidTeamRules(cwd: string): {
     lastRuleIndexTime?: string;
 };
 
-type CoverageInput = Pick<IndexStatus, "prCount" | "wisdomUnitCount" | "codeFileCount" | "codeChunkCount" | "testLinkCount" | "regressionEventCount" | "teamRuleCount" | "historyCoverage" | "staleEvidenceCount" | "staleCodeIndex">;
+type CoverageInput = Pick<IndexStatus, "prCount" | "wisdomUnitCount" | "codeFileCount" | "codeChunkCount" | "testLinkCount" | "regressionEventCount" | "architecturePatternCount" | "teamRuleCount" | "historyCoverage" | "staleEvidenceCount" | "staleCodeIndex">;
 type CoverageReport = {
     coverageScore: number;
     coverageGrade: CoverageGrade;
@@ -657,6 +746,45 @@ declare const DEMO_CODE_FILES: Record<string, string>;
 
 declare function createGitHubClient(token: string): Octokit;
 
+type GitHubRateLimitProgress = {
+    waitSeconds: number;
+    retryAt: string;
+    reason: string;
+    request: string;
+    attempt: number;
+};
+type GitHubRateLimitController = {
+    onRateLimit?: (progress: GitHubRateLimitProgress) => void;
+    sleep?: (milliseconds: number) => Promise<void>;
+    now?: () => number;
+    blockedUntilMs?: number;
+};
+type GitHubRateLimitErrorLike = {
+    status?: number;
+    message?: string;
+    response?: {
+        headers?: Record<string, string | number | undefined>;
+    };
+};
+type GitHubResponse<T> = {
+    data: T;
+    headers: Record<string, string | number | undefined>;
+};
+declare function isGitHubRateLimitError(error: unknown): error is GitHubRateLimitErrorLike;
+declare function getGitHubRateLimitDelayMs(error: GitHubRateLimitErrorLike, attempt: number, now?: number): {
+    delayMs: number;
+    reason: string;
+};
+declare function requestWithGitHubRateLimit<T>(request: () => Promise<T>, options: {
+    controller: GitHubRateLimitController;
+    requestName: string;
+    maxRetries?: number;
+}): Promise<T>;
+declare function paginateWithGitHubRateLimit<T>(requestPage: (page: number) => Promise<GitHubResponse<T[]>>, options: {
+    controller: GitHubRateLimitController;
+    requestName: string;
+}): Promise<T[]>;
+
 type FetchPullRequestsOptions = {
     token: string;
     repo: string;
@@ -670,7 +798,7 @@ declare function resolvePullRequestFetchLimit(options: Pick<FetchPullRequestsOpt
 declare function resolvePullRequestDetailConcurrency(options: Pick<FetchPullRequestsOptions, "detailConcurrency">): number;
 declare function fetchMergedPullRequests(options: FetchPullRequestsOptions): Promise<PullRequestRecord[]>;
 
-declare function fetchPullRequestDetails(octokit: Octokit, repoFullName: string, pullNumber: number): Promise<PullRequestRecord>;
+declare function fetchPullRequestDetails(octokit: Octokit, repoFullName: string, pullNumber: number, controller?: GitHubRateLimitController): Promise<PullRequestRecord>;
 
 type DoctorOptions = {
     cwd: string;
@@ -685,4 +813,4 @@ 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 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 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, type RulesSuggestOptions, SCHEMA_SQL, type SearchHistoryInput, type SemanticStatus, type SourceType, type SuggestedPrompt, TEAM_RULES_FILE, type TeamRule, type TeamRuleSuggestion, type TeamRulesValidationResult, type TestFileRecord, type TestLink, type WisdomCategory, type WisdomUnit, addTeamRule, anchorMcpEntry, buildAnchorContextResult, buildFtsQuery, buildQueryTerms, calculateCoverage, 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, getSuggestedPromptTexts, getSuggestedPrompts, getWisdomCategoryCounts, 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, suggestTeamRules, tokenizeSearchText, truncateText, uniqueStrings, updateSyncState, upsertPullRequest, validateTeamRulesFile };
+export { ANCHOR_CURSOR_RULE, type AnchorContextInput, type AnchorDatabase, type AnchorExplainFileInput, type AnchorIndexHealth, type AnchorReviewDiffInput, type ArchitectureArea, type ArchitectureCheckInput, type ArchitectureComponent, type ArchitectureContextInput, type ArchitectureIndexData, 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 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 PullRequestComment, type PullRequestCommit, type PullRequestFile, type PullRequestPerson, type PullRequestRecord, type RankedArchitecturePattern, type RankedCodeChunk, type RankedRegressionEvent, type RankedTeamRule, type RankedTestFile, type RankedWisdomUnit, type RegressionEvent, type RulesAddInput, type RulesAddResult, type RulesEvidenceCheckResult, type RulesInitResult, type RulesSuggestOptions, SCHEMA_SQL, type SearchHistoryInput, type SemanticStatus, type SourceType, type SuggestedPrompt, TEAM_RULES_FILE, type TeamRule, type TeamRuleSuggestion, type TeamRulesValidationResult, type TestFileRecord, type TestLink, type WisdomCategory, type WisdomUnit, addTeamRule, anchorMcpEntry, architectureFilesFromDiff, buildAnchorContextResult, buildArchitectureIndex, buildFtsQuery, buildQueryTerms, calculateCoverage, canonicalizeText, categorizeWisdom, checkArchitecture, checkSchema, checkTeamRuleEvidence, chunkCodeFile, chunkHistoricalText, claimKeyFor, clampMaxResults, classifyArchitectureArea, clipSentence, confidenceAtLeast, confidenceLevelFor, confidenceRank, confidenceReasonsFor, countValidTeamRules, createGitHubClient, defaultDatabasePath, detectGitHubRepo, detectGitRoot, discoverCodeFiles, emptyCodeIndexSummary, ensureAnchorGitExclude, ensureCursorConfig, ensureCursorRule, ensureRepository, ensureTeamRulesFile, evaluateFreshness, evaluateIndexHealth, evidenceForWisdom, explainFile, extractCodeImports, extractCodeSymbols, extractRegressionEvents, extractSymbols, extractWisdomUnits, fetchMergedPullRequests, fetchPullRequestDetails, filesFromDiff, formatAnchorContext, formatIndexStatus, formatSearchHistory, getAnchorIndexHealth, getArchitectureContext, getGitHubRateLimitDelayMs, getIndexStatus, getLastSyncTime, getSemanticStatus, getSuggestedPromptTexts, getSuggestedPrompts, getWisdomCategoryCounts, githubAuthFixMessage, hasHighSignalLanguage, indexCodebase, indexPullRequests, inferTestAwareness, initializeSchema, isGitHubRateLimitError, isHardExcludedCodePath, isTestFilePath, loadCurrentCodeSnapshot, loadTeamRulesFile, mergeAnchorMcpConfig, normalizePullRequest, openAnchorDatabase, paginateWithGitHubRateLimit, parseGitHubRemote, rankArchitecturePatterns, rankCodeChunks, rankRegressionEvents, rankRelevantTests, rankTeamRules, rankWisdomUnits, recordIndexRun, redactSecrets, redactedHistoricalText, replaceCodeIndex, requestWithGitHubRateLimit, resolveGitHubToken, resolvePullRequestDetailConcurrency, resolvePullRequestFetchLimit, reviewDiff, runDoctor, sanitizeHistoricalText, shouldSyncSince, sourceTypeLabel, stripPromptInjection, suggestTeamRules, tokenizeSearchText, truncateText, uniqueStrings, updateSyncState, upsertPullRequest, validateTeamRulesFile };