clinkx 0.3.0 → 1.1.0

package/dist/context-builder/discovery.d.ts

@@ -2,6 +2,7 @@ import { lstat as fsLstat, open as fsOpen, readdir as fsReaddir, realpath as fsR
 import { type ContextBuilderInternalCaps } from "./config.js";
 import { type ContextBuilderOmission } from "./diagnostics.js";
 import { type ContextBuilderResolvedFocusPath, type ContextBuilderResolvedRoot } from "./paths.js";
+import { ContextCoveragePolicy, ContextEvidenceClass, type ContextReviewObligationModel } from "./review-coverage.js";
 import { type ContextBuilderPublicBudget } from "./schema.js";
 export type ContextBuilderTreeFile = {
     root_index: number;
@@ -20,6 +21,7 @@ export type ContextBuilderContentCandidate = {
     line_count: number;
     has_final_newline: boolean;
     selection_hint?: "local_dependency" | "project_support";
+    evidence_classes?: ContextEvidenceClass[];
 };
 export type ContextBuilderSearchRecord = {
     root_index: number;
@@ -39,6 +41,23 @@ export type ContextBuilderSliceRecord = {
     content: string;
     search_term_index?: number;
 };
+export type ContextBuilderCallerTermCoverage = {
+    term: string;
+    search_term_index: number;
+    hit_count: number;
+    scan_complete: boolean;
+};
+export type ContextBuilderSearchCoverage = {
+    eligible_candidate_count: number;
+    searched_candidate_count: number;
+    unsearched_candidate_count: number;
+    caller_term_count: number;
+    derived_term_count: number;
+    caller_record_count: number;
+    derived_record_count: number;
+    caller_coverage_complete: boolean;
+    caller_terms: ContextBuilderCallerTermCoverage[];
+};
 export type ContextBuilderDiscoveryMetrics = {
     files_seen: number;
     files_considered: number;
@@ -56,18 +75,29 @@ export type ContextBuilderDiscoveryResult = {
     slices: ContextBuilderSliceRecord[];
     omissions: ContextBuilderOmission[];
     metrics: ContextBuilderDiscoveryMetrics;
+    search_coverage: ContextBuilderSearchCoverage;
+    review_obligations?: ContextReviewObligationModel;
 };
 export type ContextBuilderDiscoveryOptions = {
     roots: readonly ContextBuilderResolvedRoot[];
     task?: string;
+    allowSecrets?: boolean;
     focus_paths?: readonly ContextBuilderResolvedFocusPath[];
     include_globs?: readonly string[];
     exclude_globs?: readonly string[];
     excluded_real_roots?: readonly string[];
     search_terms?: readonly string[];
+    coverage_policy?: ContextCoveragePolicy;
     budget: ContextBuilderPublicBudget;
     internal_caps?: ContextBuilderInternalCaps;
     signal?: AbortSignal;
+    /**
+     * Sampled mid-scan progress sink, invoked at file boundaries (throttled by
+     * the walk) with a snapshot of the running discovery metrics, so a long
+     * scanning phase stays observable before the `searching` transition
+     * publishes the first counts.
+     */
+    onProgress?: (metrics: Readonly<ContextBuilderDiscoveryMetrics>) => void;
     fs?: {
         readdir?: typeof fsReaddir;
         lstat?: typeof fsLstat;
@@ -82,11 +112,15 @@ type LineRange = {
     search_term_index?: number;
 };
 export declare function discoverContextBuilderCandidates(options: ContextBuilderDiscoveryOptions): Promise<ContextBuilderDiscoveryResult>;
+export declare function expandSearchTerms(searchTerms: readonly string[]): {
+    terms: string[];
+    callerTermCount: number;
+};
 export declare function buildCandidateSearchRecords(input: {
     candidates: readonly ContextBuilderContentCandidate[];
-    task?: string;
     focusPaths?: readonly ContextBuilderResolvedFocusPath[];
     searchTerms: readonly string[];
+    callerTermCount?: number;
     maxSearchResults: number;
     maxPreviewBytes?: number;
     maxCandidateBytes?: number;
@@ -95,6 +129,7 @@ export declare function buildCandidateSearchRecords(input: {
     records: ContextBuilderSearchRecord[];
     capHit: boolean;
     candidateBytes: number;
+    coverage: ContextBuilderSearchCoverage;
 };
 export declare function buildCandidateSliceRecords(input: {
     candidates: readonly ContextBuilderContentCandidate[];