clinkx 0.3.0 → 1.0.0

package/dist/context-builder/delegate.js.map

@@ -1 +1 @@
-{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../src/context-builder/delegate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../src/context-builder/delegate.ts"],"names":[],"mappings":"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"}

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

@@ -11,7 +11,7 @@ export type ContextBuilderOmission = {
     omitted_path_count?: number;
 };
 export declare const CONTEXT_BUILDER_REQUESTED_EVIDENCE_OMISSION_REASON = "requested_evidence_omission";
-export type ContextBuilderRequestedEvidenceOmissionKind = "unavailable" | "too_large" | "candidate_cap" | "discovery_candidate_cap" | "packet_token_cap" | "pruned";
+export type ContextBuilderRequestedEvidenceOmissionKind = "unavailable" | "too_large" | "candidate_cap" | "discovery_candidate_cap" | "packet_token_cap";
 export declare function requestedEvidenceOmission(input: {
     root_index?: number;
     kind: ContextBuilderRequestedEvidenceOmissionKind;
@@ -22,6 +22,15 @@ export declare function isRequestedEvidenceOmission(omission: Pick<ContextBuilde
 export declare function boundContextBuilderWarnings(warnings: ContextBuilderWarning[], caps?: Pick<ContextBuilderInternalCaps, "max_warnings">): ContextBuilderWarning[];
 export declare function boundContextBuilderOmissions(omissions: ContextBuilderOmission[], caps?: Pick<ContextBuilderInternalCaps, "max_omissions" | "max_paths_per_omission">): ContextBuilderOmission[];
 export declare function boundContextBuilderPathList(paths: string[], maxPaths?: number): string[];
-export declare function sanitizeDiagnosticText(text: string): string;
+export declare function sanitizeDiagnosticText(text: string, allowSecrets?: boolean): string;
+/**
+ * Bounded sanitizer dedicated to delegate-failure reasons. Applies the exact
+ * redaction guarantees of sanitizeDiagnosticText (whitespace collapse,
+ * secret-material fail-closed redaction, embedded absolute-path redaction) but
+ * with a wider ceiling and an explicit truncation marker instead of a bare
+ * trailing "...", so a truncated failure reason is never mistaken for a
+ * complete one.
+ */
+export declare function sanitizeDelegateFailureText(text: string, maxLength?: number): string;
 export declare function hasEmbeddedAbsolutePath(text: string): boolean;
 export declare function sanitizeProgressMessage(message: string): string;

package/dist/context-builder/diagnostics.js

@@ -1,5 +1,5 @@
 import { CONTEXT_BUILDER_INTERNAL_CAP_DEFAULTS, } from "./config.js";
-import { hasHighConfidenceSecret, scanSecretPath } from "./secrets.js";
+import { hasDisallowedSecretMaterial, hasHighConfidenceSecret, scanSecretPath, } from "./secrets.js";
 export const CONTEXT_BUILDER_REQUESTED_EVIDENCE_OMISSION_REASON = "requested_evidence_omission";
 export function requestedEvidenceOmission(input) {
     return {
@@ -15,7 +15,17 @@ export function isRequestedEvidenceOmission(omission) {
 const MAX_DIAGNOSTIC_TEXT_LENGTH = 240;
 const MAX_PROGRESS_TEXT_LENGTH = 120;
 const MAX_PATH_TEXT_LENGTH = 300;
-const EMBEDDED_ABSOLUTE_PATH_PATTERN = /(^|[\s=:(\["'`])((?:~\/|\/(?!\/)|[A-Za-z]:[\\/]|\\\\)[^\s"'`,;)\]}]*)/g;
+// Dedicated ceiling for delegate-failure reasons. These messages aggregate
+// many per-omission entries, so the general 240-char diagnostic bound silently
+// dropped every entry past the first one or two. The wider bound is scoped to
+// this one error path; other callers keep MAX_DIAGNOSTIC_TEXT_LENGTH.
+const MAX_DELEGATE_FAILURE_TEXT_LENGTH = 2000;
+const DELEGATE_FAILURE_TRUNCATION_MARKER = " [truncated]";
+// Leading boundary is the negated class [^\w] to bias toward over-redaction: any
+// non-word char before an absolute-path start counts as a boundary, so delimiter-glued
+// paths can't slip through. Word-char glue is left unflagged on purpose (word/Users is a
+// relative path, not an absolute disclosure).
+const EMBEDDED_ABSOLUTE_PATH_PATTERN = /(^|[^\w])((?:~\/|\/(?!\/)|[A-Za-z]:[\\/]|\\\\)[^\s"'`,;)\]}]*)/g;
 export function boundContextBuilderWarnings(warnings, caps = CONTEXT_BUILDER_INTERNAL_CAP_DEFAULTS) {
     return warnings.slice(0, caps.max_warnings).map((warning) => ({
         code: sanitizeDiagnosticText(warning.code),
@@ -38,16 +48,39 @@ export function boundContextBuilderOmissions(omissions, caps = CONTEXT_BUILDER_I
 export function boundContextBuilderPathList(paths, maxPaths = CONTEXT_BUILDER_INTERNAL_CAP_DEFAULTS.max_paths_per_omission) {
     return paths.slice(0, maxPaths).map(sanitizePathText);
 }
-export function sanitizeDiagnosticText(text) {
-    const collapsed = redactEmbeddedAbsolutePaths(text.replace(/\s+/g, " ").trim());
-    if (hasHighConfidenceSecret(collapsed)) {
-        return "[redacted-sensitive]";
+export function sanitizeDiagnosticText(text, allowSecrets = false) {
+    if (allowSecrets === true) {
+        return text;
     }
+    const collapsed = collapseAndRedactDiagnosticText(text);
     const bounded = collapsed.length > MAX_DIAGNOSTIC_TEXT_LENGTH
         ? `${collapsed.slice(0, MAX_DIAGNOSTIC_TEXT_LENGTH - 3)}...`
         : collapsed;
     return bounded;
 }
+/**
+ * Bounded sanitizer dedicated to delegate-failure reasons. Applies the exact
+ * redaction guarantees of sanitizeDiagnosticText (whitespace collapse,
+ * secret-material fail-closed redaction, embedded absolute-path redaction) but
+ * with a wider ceiling and an explicit truncation marker instead of a bare
+ * trailing "...", so a truncated failure reason is never mistaken for a
+ * complete one.
+ */
+export function sanitizeDelegateFailureText(text, maxLength = MAX_DELEGATE_FAILURE_TEXT_LENGTH) {
+    const collapsed = collapseAndRedactDiagnosticText(text);
+    if (collapsed.length <= maxLength) {
+        return collapsed;
+    }
+    const sliceLength = Math.max(0, maxLength - DELEGATE_FAILURE_TRUNCATION_MARKER.length);
+    return `${collapsed.slice(0, sliceLength)}${DELEGATE_FAILURE_TRUNCATION_MARKER}`;
+}
+function collapseAndRedactDiagnosticText(text) {
+    const collapsedWhitespace = text.replace(/\s+/g, " ").trim();
+    if (hasDisallowedSecretMaterial(collapsedWhitespace, false)) {
+        return "[redacted-sensitive]";
+    }
+    return redactEmbeddedAbsolutePaths(collapsedWhitespace);
+}
 export function hasEmbeddedAbsolutePath(text) {
     EMBEDDED_ABSOLUTE_PATH_PATTERN.lastIndex = 0;
     return EMBEDDED_ABSOLUTE_PATH_PATTERN.test(text);

package/dist/context-builder/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/context-builder/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,GAEtC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAevE,MAAM,CAAC,MAAM,kDAAkD,GAC7D,6BAA6B,CAAC;AAUhC,MAAM,UAAU,yBAAyB,CAAC,KAKzC;IACC,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QACrE,MAAM,EAAE,kDAAkD;QAC1D,OAAO,EAAE,qCAAqC,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE;QAC7E,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,QAAgD;IAEhD,OAAO,QAAQ,CAAC,MAAM,KAAK,kDAAkD,CAAC;AAChF,CAAC;AAED,MAAM,0BAA0B,GAAG,GAAG,CAAC;AACvC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,8BAA8B,GAClC,wEAAwE,CAAC;AAE3E,MAAM,UAAU,2BAA2B,CACzC,QAAiC,EACjC,OACE,qCAAqC;IAEvC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,EAAE,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC;QAC1C,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC;KACjD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,SAAmC,EACnC,OAGI,qCAAqC;IAEzC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/D,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC3E,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/C,OAAO,EAAE,sBAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC;QACjD,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI;YACxB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,KAAK,EAAE,2BAA2B,CAChC,QAAQ,CAAC,KAAK,EACd,IAAI,CAAC,sBAAsB,CAC5B;gBACD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAC1B,CAAC,EACD,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,sBAAsB,CACpD;aACF,CAAC;KACP,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAe,EACf,QAAQ,GAAG,qCAAqC,CAAC,sBAAsB;IAEvE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,SAAS,GAAG,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,IAAI,uBAAuB,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,MAAM,OAAO,GACX,SAAS,CAAC,MAAM,GAAG,0BAA0B;QAC3C,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,0BAA0B,GAAG,CAAC,CAAC,KAAK;QAC5D,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,8BAA8B,CAAC,SAAS,GAAG,CAAC,CAAC;IAC7C,OAAO,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAY;IAC/C,8BAA8B,CAAC,SAAS,GAAG,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,OAAO,CACjB,8BAA8B,EAC9B,4BAA4B,CAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC,MAAM,GAAG,wBAAwB;QAChD,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,GAAG,CAAC,CAAC,KAAK;QAC1D,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACtD,IACE,cAAc,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC;QACrC,uBAAuB,CAAC,UAAU,CAAC,EACnC,CAAC;QACD,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAE1D,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/context-builder/diagnostics.ts"],"names":[],"mappings":"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"}

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,15 +75,19 @@ 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;
@@ -82,11 +105,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 +122,7 @@ export declare function buildCandidateSearchRecords(input: {
     records: ContextBuilderSearchRecord[];
     capHit: boolean;
     candidateBytes: number;
+    coverage: ContextBuilderSearchCoverage;
 };
 export declare function buildCandidateSliceRecords(input: {
     candidates: readonly ContextBuilderContentCandidate[];