@pratik7368patil/anchor-core 0.1.14 → 0.1.15

package/dist/index.d.ts

@@ -211,6 +211,95 @@ type RankedRegressionEvent = RegressionEvent & {
     matchReasons: string[];
     rankSignals: Record<string, number>;
 };
+type TestCommand = {
+    command: string;
+    reason: string;
+    confidence: ConfidenceLevel;
+    filePath?: string;
+};
+type TaskPlan = {
+    targetFiles: string[];
+    likelySymbols: string[];
+    implementationSteps: string[];
+    risks: string[];
+    recommendedTests: string[];
+    evidence: EvidenceRef[];
+    testCommands: TestCommand[];
+};
+type ArchitectureMapFormat = "mermaid" | "json";
+type ArchitectureMapNode = {
+    id: string;
+    label: string;
+    area: ArchitectureArea;
+    path?: string;
+};
+type ArchitectureMapEdge = {
+    source: string;
+    target: string;
+    relationship: string;
+    weight: number;
+};
+type ArchitectureMap = {
+    format: ArchitectureMapFormat;
+    nodes: ArchitectureMapNode[];
+    edges: ArchitectureMapEdge[];
+    mermaid?: string;
+};
+type RetrievalEvalCase = {
+    id: string;
+    task: string;
+    files: string[];
+    expectedPrs: number[];
+    expectedCategories: WisdomCategory[];
+};
+type RetrievalEvalResult = {
+    id: string;
+    task: string;
+    passed: boolean;
+    expectedPrs: number[];
+    foundPrs: number[];
+    missingPrs: number[];
+    expectedCategories: WisdomCategory[];
+    foundCategories: WisdomCategory[];
+    missingCategories: WisdomCategory[];
+};
+type RetrievalEvalRunResult = {
+    ok: boolean;
+    path: string;
+    total: number;
+    passed: number;
+    failed: number;
+    results: RetrievalEvalResult[];
+};
+type FeedbackRating = "useful" | "not-useful";
+type FeedbackEvent = {
+    resultId: string;
+    rating: FeedbackRating;
+    note?: string;
+    createdAt: string;
+};
+type Playbook = {
+    id: string;
+    title: string;
+    body: string;
+    evidence: EvidenceRef[];
+    createdAt: string;
+};
+type OnboardingPack = {
+    title: string;
+    areas: Array<{
+        area: ArchitectureArea;
+        files: string[];
+        patternCount: number;
+    }>;
+    importantFiles: string[];
+    riskyModules: string[];
+    relevantTests: string[];
+    topRules: TeamRule[];
+    playbooks: Playbook[];
+    starterPrompts: string[];
+    architectureMap: ArchitectureMap;
+};
 type FetchPullRequestsProgress = {
     stage: "discovering_pull_requests";
     repo: string;
@@ -439,6 +528,11 @@ type IndexStatus = {
     architectureComponentCount: number;
     architecturePatternCount: number;
     architectureImportCount: number;
+    architectureMapEdgeCount: number;
+    testCommandCount: number;
+    retrievalEvalCount: number;
+    feedbackEventCount: number;
+    playbookCount: number;
     historyCoverage?: "limited" | "all" | "unknown";
     historyLimit?: number;
     staleEvidenceCount: number;
@@ -447,6 +541,7 @@ type IndexStatus = {
     lastCodeIndexTime?: string;
     lastArchitectureIndexTime?: string;
     lastRuleIndexTime?: string;
+    lastWatchIndexTime?: string;
     lastSuccessfulRun?: string;
     lastFailedRun?: string;
     staleCodeIndex?: boolean;
@@ -635,7 +730,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[], architecturePatterns?: RankedArchitecturePattern[], 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>, testCommands?: TestCommand[]): FormattedResult;
 declare function formatSearchHistory(units: RankedWisdomUnit[]): FormattedResult;
 declare function formatIndexStatus(status: IndexStatus): FormattedResult;
 
@@ -643,11 +738,21 @@ declare function buildAnchorContextResult(db: AnchorDatabase, cwd: string, input
 
 declare function explainFile(db: AnchorDatabase, cwd: string, input: AnchorExplainFileInput): FormattedResult;
 
+type ArchitectureMapInput = {
+    file?: string;
+    area?: ArchitectureArea;
+    format?: ArchitectureMapFormat;
+    maxNodes?: number;
+};
+declare function buildArchitectureMap(db: AnchorDatabase, input?: ArchitectureMapInput): ArchitectureMap;
+
 type ArchitectureContextInput = {
     file?: string;
     area?: ArchitectureArea;
     query?: string;
     maxResults?: number;
+    map?: boolean;
+    format?: "mermaid" | "json";
 };
 type ArchitectureCheckInput = {
     diff: string;
@@ -655,12 +760,25 @@ type ArchitectureCheckInput = {
     maxResults?: number;
 };
 declare function architectureFilesFromDiff(diff: string): string[];
+declare function getArchitectureMapContext(db: AnchorDatabase, input?: ArchitectureMapInput): FormattedResult;
 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;
 
+declare function planTask(db: AnchorDatabase, cwd: string, input: AnchorContextInput): FormattedResult;
+
+declare function detectTestCommandsForFile(db: AnchorDatabase, cwd: string, filePath: string): TestCommand[];
+declare function detectTestCommands(db: AnchorDatabase, cwd: string, files?: string[]): TestCommand[];
+declare function refreshTestCommands(db: AnchorDatabase, cwd: string, repo: string, files?: string[]): TestCommand[];
+
+type OnboardingInput = {
+    file?: string;
+    area?: ArchitectureArea;
+};
+declare function buildOnboardingPack(db: AnchorDatabase, cwd: string, input?: OnboardingInput): FormattedResult;
+
 type LocalEmbeddingProvider = {
     name: string;
     isAvailable(): boolean;
@@ -753,7 +871,7 @@ declare function countValidTeamRules(cwd: string): {
     lastRuleIndexTime?: string;
 };
 
-type CoverageInput = Pick<IndexStatus, "prCount" | "wisdomUnitCount" | "codeFileCount" | "codeChunkCount" | "testLinkCount" | "regressionEventCount" | "architecturePatternCount" | "teamRuleCount" | "historyCoverage" | "staleEvidenceCount" | "staleCodeIndex">;
+type CoverageInput = Pick<IndexStatus, "prCount" | "wisdomUnitCount" | "codeFileCount" | "codeChunkCount" | "testLinkCount" | "testCommandCount" | "regressionEventCount" | "architecturePatternCount" | "architectureMapEdgeCount" | "teamRuleCount" | "retrievalEvalCount" | "playbookCount" | "historyCoverage" | "staleEvidenceCount" | "staleCodeIndex">;
 type CoverageReport = {
     coverageScore: number;
     coverageGrade: CoverageGrade;
@@ -763,13 +881,60 @@ type CoverageReport = {
 declare function calculateCoverage(input: CoverageInput): CoverageReport;
 
 type SuggestedPrompt = {
-    id: "before_edit" | "explain_file" | "strict_mode" | "review_diff";
+    id: "before_edit" | "plan_task" | "test_command" | "explain_file" | "strict_mode" | "review_diff" | "onboarding" | "playbook";
     title: string;
     prompt: string;
 };
 declare function getSuggestedPrompts(): SuggestedPrompt[];
 declare function getSuggestedPromptTexts(): string[];
 
+declare const ANCHOR_EVALS_FILE = "anchor.evals.json";
+declare function initRetrievalEvals(cwd: string): {
+    path: string;
+    created: boolean;
+};
+declare function addRetrievalEval(db: AnchorDatabase, cwd: string, input: {
+    task: string;
+    files?: string[];
+    expectedPrs?: number[];
+    expectedCategories?: WisdomCategory[];
+}): RetrievalEvalCase;
+declare function runRetrievalEvals(db: AnchorDatabase, cwd: string): RetrievalEvalRunResult;
+
+declare function recordFeedback(db: AnchorDatabase, input: {
+    resultId: string;
+    rating: FeedbackRating;
+    note?: string;
+}): FeedbackEvent;
+declare function feedbackAdjustedScore(db: AnchorDatabase, resultId: string, baseScore: number): number;
+declare function listFeedbackEvents(db: AnchorDatabase, limit?: number): FeedbackEvent[];
+
+declare const ANCHOR_PLAYBOOKS_FILE = "anchor.playbooks.json";
+declare function initPlaybooks(cwd: string): {
+    path: string;
+    created: boolean;
+};
+declare function listPlaybooks(cwd: string): Playbook[];
+declare function getPlaybook(cwd: string, id: string): Playbook | undefined;
+declare function suggestPlaybooks(db: AnchorDatabase, _cwd: string): Playbook[];
+declare function syncPlaybooksToDatabase(db: AnchorDatabase, cwd: string): number;
+
+type WatchRefreshInput = {
+    cwd: string;
+    repo?: string;
+};
+declare function refreshWatchIndex(db: AnchorDatabase, input: WatchRefreshInput): CodeIndexSummary;
+declare function watchCodebase(db: AnchorDatabase, input: WatchRefreshInput & {
+    intervalSeconds?: number;
+    onRefresh?: (summary: CodeIndexSummary) => void;
+}): () => void;
+
+type AnchorCiInput = {
+    strict?: boolean;
+    minCoverage?: number;
+};
+declare function runAnchorCi(db: AnchorDatabase, cwd: string, input?: AnchorCiInput): FormattedResult;
+
 declare const DEMO_REPO = "anchor/demo";
 declare const DEMO_PULL_REQUESTS: PullRequestRecord[];
 declare const DEMO_CODE_FILES: Record<string, string>;
@@ -843,4 +1008,4 @@ declare function getAnchorIndexHealth(cwd: string): AnchorIndexHealth & {
     indexStatus: IndexStatus;
 };
 
-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 ReliabilityGate, type ReliabilityGateRejection, type ReliabilityGateResult, type ReliabilityGateStatus, 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, evaluateReliabilityGate, 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 };
+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 };