@pratik7368patil/anchor-core 0.1.9 → 0.1.11

package/dist/index.d.ts

@@ -5,6 +5,7 @@ type SourceType = "pr_body" | "review_comment" | "issue_comment" | "review_summa
 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 CoverageGrade = "empty" | "poor" | "fair" | "good" | "excellent";
 type EvidenceRef = {
     prNumber: number;
     prUrl: string;
@@ -70,6 +71,10 @@ type TeamRule = {
     evidence: EvidenceRef[];
     confidenceLevel: ConfidenceLevel;
 };
+type TeamRuleSuggestion = TeamRule & {
+    repeatedEvidenceCount: number;
+    reason: string;
+};
 type RankedTeamRule = TeamRule & {
     score: number;
     freshnessStatus: FreshnessStatus;
@@ -292,12 +297,14 @@ type AnchorExplainFileInput = {
     symbols?: string[];
     strict?: boolean;
     maxResults?: number;
+    share?: boolean;
 };
 type AnchorReviewDiffInput = {
     diff: string;
     files?: string[];
     strict?: boolean;
     maxResults?: number;
+    share?: boolean;
 };
 type IndexRunRecord = {
     id?: number;
@@ -323,6 +330,10 @@ type AnchorIndexHealth = {
     staleCodeIndex: boolean;
     lastSuccessfulRun?: string;
     lastFailedRun?: string;
+    coverageScore: number;
+    coverageGrade: CoverageGrade;
+    coverageReasons: string[];
+    suggestedPrompts: string[];
 };
 type SemanticStatus = {
     enabled: boolean;
@@ -353,6 +364,10 @@ type IndexStatus = {
     lastFailedRun?: string;
     staleCodeIndex?: boolean;
     suggestedNextCommand?: string;
+    coverageScore: number;
+    coverageGrade: CoverageGrade;
+    coverageReasons: string[];
+    suggestedPrompts: string[];
     githubTokenConfigured: boolean;
     health: "ok" | "missing_database" | "schema_invalid" | "empty_index";
 };
@@ -444,6 +459,7 @@ declare function upsertPullRequest(db: AnchorDatabase, pr: PullRequestRecord, wi
 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 function getWisdomCategoryCounts(db: AnchorDatabase): Record<WisdomCategory, number>;
 
 declare const SCHEMA_SQL: string;
 
@@ -599,6 +615,11 @@ type RulesEvidenceCheckResult = {
     }>;
     errors: string[];
 };
+type RulesSuggestOptions = {
+    category?: WisdomCategory;
+    minConfidence?: ConfidenceLevel;
+    maxResults?: number;
+};
 declare function ensureTeamRulesFile(cwd: string): RulesInitResult;
 declare function loadTeamRulesFile(cwd: string): TeamRulesValidationResult & {
     exists: boolean;
@@ -607,11 +628,33 @@ 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 suggestTeamRules(db: AnchorDatabase, cwd: string, options?: RulesSuggestOptions): TeamRuleSuggestion[];
 declare function countValidTeamRules(cwd: string): {
     count: number;
     lastRuleIndexTime?: string;
 };
 
+type CoverageInput = Pick<IndexStatus, "prCount" | "wisdomUnitCount" | "codeFileCount" | "codeChunkCount" | "testLinkCount" | "regressionEventCount" | "teamRuleCount" | "historyCoverage" | "staleEvidenceCount" | "staleCodeIndex">;
+type CoverageReport = {
+    coverageScore: number;
+    coverageGrade: CoverageGrade;
+    coverageReasons: string[];
+    suggestedPrompts: string[];
+};
+declare function calculateCoverage(input: CoverageInput): CoverageReport;
+
+type SuggestedPrompt = {
+    id: "before_edit" | "explain_file" | "strict_mode" | "review_diff";
+    title: string;
+    prompt: string;
+};
+declare function getSuggestedPrompts(): SuggestedPrompt[];
+declare function getSuggestedPromptTexts(): string[];
+
+declare const DEMO_REPO = "anchor/demo";
+declare const DEMO_PULL_REQUESTS: PullRequestRecord[];
+declare const DEMO_CODE_FILES: Record<string, string>;
+
 declare function createGitHubClient(token: string): Octokit;
 
 type FetchPullRequestsOptions = {
@@ -642,4 +685,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 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 };
+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 };