clinkx 1.0.0 → 1.1.1

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

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

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

@@ -0,0 +1,25 @@
+import type { ContextBuilderDiscoveryMetrics } from "./discovery.js";
+import type { ContextBuilderLifecycleController } from "./lifecycle-observer.js";
+/** Discovery invokes the progress sink at most once per this many file boundaries. */
+export declare const CONTEXT_BUILDER_SCAN_PROGRESS_EVERY_FILES = 250;
+/** Minimum wall-clock gap between two published mid-scan transitions. */
+export declare const CONTEXT_BUILDER_SCAN_PROGRESS_MIN_INTERVAL_MS = 2000;
+export type ContextBuilderScanProgressPublisher = (metrics: Readonly<ContextBuilderDiscoveryMetrics>) => void;
+/**
+ * Throttled mid-scan lifecycle publisher for the discovery walk: turns
+ * sampled discovery metrics into `scanning → scanning` count transitions so a
+ * long scan stays observable in `state.json` and `workflow_run_status`.
+ *
+ * Emits at most once per {@link CONTEXT_BUILDER_SCAN_PROGRESS_EVERY_FILES}
+ * newly seen files AND {@link CONTEXT_BUILDER_SCAN_PROGRESS_MIN_INTERVAL_MS}
+ * apart. No final emission: the handler's `searching` transition publishes the
+ * authoritative end-of-scan counts.
+ *
+ * Fire-and-forget: the walk never awaits publication, and a rejected
+ * transition is swallowed here so it never becomes an unhandled rejection. The
+ * controller's own fail-closed contract still applies — an observer rejection
+ * poisons the controller, so the next awaited transition fails the run.
+ */
+export declare function createScanProgressPublisher(lifecycle: Pick<ContextBuilderLifecycleController, "transition"> | undefined, options?: {
+    readonly now?: () => number;
+}): ContextBuilderScanProgressPublisher;

package/dist/context-builder/discovery-progress.js

@@ -0,0 +1,64 @@
+/** Discovery invokes the progress sink at most once per this many file boundaries. */
+export const CONTEXT_BUILDER_SCAN_PROGRESS_EVERY_FILES = 250;
+/** Minimum wall-clock gap between two published mid-scan transitions. */
+export const CONTEXT_BUILDER_SCAN_PROGRESS_MIN_INTERVAL_MS = 2_000;
+/**
+ * Throttled mid-scan lifecycle publisher for the discovery walk: turns
+ * sampled discovery metrics into `scanning → scanning` count transitions so a
+ * long scan stays observable in `state.json` and `workflow_run_status`.
+ *
+ * Emits at most once per {@link CONTEXT_BUILDER_SCAN_PROGRESS_EVERY_FILES}
+ * newly seen files AND {@link CONTEXT_BUILDER_SCAN_PROGRESS_MIN_INTERVAL_MS}
+ * apart. No final emission: the handler's `searching` transition publishes the
+ * authoritative end-of-scan counts.
+ *
+ * Fire-and-forget: the walk never awaits publication, and a rejected
+ * transition is swallowed here so it never becomes an unhandled rejection. The
+ * controller's own fail-closed contract still applies — an observer rejection
+ * poisons the controller, so the next awaited transition fails the run.
+ */
+export function createScanProgressPublisher(lifecycle, options = {}) {
+    if (lifecycle == null) {
+        return () => { };
+    }
+    const now = options.now ?? (() => performance.now());
+    let lastFilesSeen = 0;
+    let lastEmittedAt;
+    return (metrics) => {
+        if (metrics.files_seen - lastFilesSeen < CONTEXT_BUILDER_SCAN_PROGRESS_EVERY_FILES) {
+            return;
+        }
+        const at = now();
+        if (lastEmittedAt != null &&
+            at - lastEmittedAt < CONTEXT_BUILDER_SCAN_PROGRESS_MIN_INTERVAL_MS) {
+            return;
+        }
+        lastFilesSeen = metrics.files_seen;
+        lastEmittedAt = at;
+        try {
+            lifecycle
+                .transition("scanning", { counts: scanCountsFromMetrics(metrics) })
+                .catch(() => { });
+        }
+        catch {
+            // A synchronously throwing controller is equally non-fatal to discovery.
+        }
+    };
+}
+/**
+ * Mid-scan projection of the counts shape `lifecycleCountsFromDiscovery`
+ * publishes at `searching`. Omissions, search results, selection, and writes
+ * are not known until the walk ends, so they stay zero here.
+ */
+function scanCountsFromMetrics(metrics) {
+    return {
+        files_seen: metrics.files_seen,
+        files_considered: metrics.files_considered,
+        files_selected: 0,
+        files_omitted: 0,
+        search_results: 0,
+        bytes_read: metrics.bytes_read,
+        bytes_written: 0,
+    };
+}
+//# sourceMappingURL=discovery-progress.js.map

package/dist/context-builder/discovery-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-progress.js","sourceRoot":"","sources":["../../src/context-builder/discovery-progress.ts"],"names":[],"mappings":"AAMA,sFAAsF;AACtF,MAAM,CAAC,MAAM,yCAAyC,GAAG,GAAG,CAAC;AAE7D,yEAAyE;AACzE,MAAM,CAAC,MAAM,6CAA6C,GAAG,KAAK,CAAC;AAMnE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAA4E,EAC5E,UAA2C,EAAE;IAE7C,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACtB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;IACrD,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,aAAiC,CAAC;IACtC,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,IAAI,OAAO,CAAC,UAAU,GAAG,aAAa,GAAG,yCAAyC,EAAE,CAAC;YACnF,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;QACjB,IACE,aAAa,IAAI,IAAI;YACrB,EAAE,GAAG,aAAa,GAAG,6CAA6C,EAClE,CAAC;YACD,OAAO;QACT,CAAC;QACD,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;QACnC,aAAa,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,SAAS;iBACN,UAAU,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;iBAClE,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;QAC3E,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAC5B,OAAiD;IAEjD,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,CAAC;KACjB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,15 @@
+/** Same window as the write watchdog and the dashboard write-phase stale overlay. */
+export declare const CONTEXT_BUILDER_DISCOVERY_WATCHDOG_MS: number;
+/**
+ * Bound the discovery/scanning phase wall clock. MCP cancel still wins when
+ * the caller signal aborts first; a watchdog-only abort becomes
+ * ExecutionError so the lifecycle records a failure, not a cancellation.
+ *
+ * The abort is observed at the walk's file-boundary checks and event-loop
+ * yields, so a single synchronous stretch (one sanitize call) runs to
+ * completion before the timer can take effect.
+ */
+export declare function withContextBuilderDiscoveryWatchdog<T>(work: (signal: AbortSignal) => Promise<T>, options?: {
+    readonly signal?: AbortSignal | undefined;
+    readonly timeoutMs?: number;
+}): Promise<T>;

package/dist/context-builder/discovery-watchdog.js

@@ -0,0 +1,39 @@
+import { ExecutionError } from "../errors.js";
+/** Same window as the write watchdog and the dashboard write-phase stale overlay. */
+export const CONTEXT_BUILDER_DISCOVERY_WATCHDOG_MS = 10 * 60 * 1_000;
+/**
+ * Bound the discovery/scanning phase wall clock. MCP cancel still wins when
+ * the caller signal aborts first; a watchdog-only abort becomes
+ * ExecutionError so the lifecycle records a failure, not a cancellation.
+ *
+ * The abort is observed at the walk's file-boundary checks and event-loop
+ * yields, so a single synchronous stretch (one sanitize call) runs to
+ * completion before the timer can take effect.
+ */
+export async function withContextBuilderDiscoveryWatchdog(work, options = {}) {
+    const timeoutMs = options.timeoutMs ?? CONTEXT_BUILDER_DISCOVERY_WATCHDOG_MS;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1) {
+        throw new ExecutionError("context_builder discovery watchdog timeout is invalid");
+    }
+    const watchdog = new AbortController();
+    const timer = setTimeout(() => {
+        watchdog.abort();
+    }, timeoutMs);
+    timer.unref();
+    const signal = options.signal == null
+        ? watchdog.signal
+        : AbortSignal.any([options.signal, watchdog.signal]);
+    try {
+        return await work(signal);
+    }
+    catch (error) {
+        if (watchdog.signal.aborted && options.signal?.aborted !== true) {
+            throw new ExecutionError(`context_builder discovery phase exceeded ${String(timeoutMs)}ms`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=discovery-watchdog.js.map

package/dist/context-builder/discovery-watchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-watchdog.js","sourceRoot":"","sources":["../../src/context-builder/discovery-watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,qFAAqF;AACrF,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,IAAyC,EACzC,UAGI,EAAE;IAEN,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,qCAAqC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,cAAc,CAAC,uDAAuD,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,EAAE,SAAS,CAAC,CAAC;IACd,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI;QACnC,CAAC,CAAC,QAAQ,CAAC,MAAM;QACjB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAChE,MAAM,IAAI,cAAc,CACtB,4CAA4C,MAAM,CAAC,SAAS,CAAC,IAAI,CAClE,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

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

@@ -91,6 +91,13 @@ export type ContextBuilderDiscoveryOptions = {
     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;

package/dist/context-builder/discovery.js

@@ -5,10 +5,11 @@ import { isSamePathOrDescendant } from "../allowed-roots.js";
 import { CancellationError } from "../errors.js";
 import { CONTEXT_BUILDER_INTERNAL_CAP_DEFAULTS, } from "./config.js";
 import { CONTEXT_BUILDER_REQUESTED_EVIDENCE_OMISSION_REASON, requestedEvidenceOmission, } from "./diagnostics.js";
+import { CONTEXT_BUILDER_SCAN_PROGRESS_EVERY_FILES } from "./discovery-progress.js";
 import { compileContextBuilderGlobs, CONTEXT_BUILDER_DEFAULT_EXCLUDE_GLOBS, } from "./globs.js";
 import { normalizeContextBuilderRootRelativePath, rootRelativePathForAbsolutePath, } from "./paths.js";
 import { directoryDistance, genericPathKind, isTestPath, normalizedPathStem, } from "./path-signals.js";
-import { buildContextReviewObligations, } from "./review-coverage.js";
+import { buildContextReviewObligations, planRegressionHeadSliceCandidates, } from "./review-coverage.js";
 import { sanitizeHighConfidenceSecretContent, scanSecretPath, } from "./secrets.js";
 import { CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS, } from "./schema.js";
 const SEARCH_WINDOW_LINES_BEFORE = 19;
@@ -28,6 +29,10 @@ const CONTEXT_BUILDER_FOCUS_SLICED_REASON = "focus_sliced";
 // We omit the file with this explicit material reason instead — honoring both
 // the byte bound and "never silently drop an explicitly-focused file".
 const CONTEXT_BUILDER_FOCUS_OVER_CAP_REASON = "focus_over_cap";
+// Secret sanitization can run multi-second synchronous stretches. The walk
+// yields a macrotask at least this often (and after every sanitize) so timers,
+// cancellation notifications, and lock heartbeats keep running mid-scan.
+const DISCOVERY_YIELD_EVERY_FILES = 32;
 const IMPORT_EXPANSION_PASSES = 3;
 const MAX_EXPANDED_SEARCH_TERMS = 128;
 const MAX_EXPANDED_SEARCH_TERM_BYTES = 16_384;
@@ -66,6 +71,9 @@ export async function discoverContextBuilderCandidates(options) {
             bytes_read: 0,
         },
         stopped: false,
+        onProgress: options.onProgress,
+        filesSinceYield: 0,
+        filesSinceProgress: 0,
     };
     for (const root of options.roots) {
         if (state.stopped) {
@@ -175,17 +183,43 @@ export async function discoverContextBuilderCandidates(options) {
     if (slices.capHit) {
         state.metrics.candidate_cap_hit = true;
     }
-    const reviewObligations = buildContextReviewObligations({
+    const reviewFocusPaths = (options.focus_paths ?? []).map((focus) => ({
+        root_index: focus.root_index,
+        path: focus.root_relative_path,
+        kind: focus.kind,
+    }));
+    let reviewObligations = buildContextReviewObligations({
         candidates: state.contentCandidates,
-        focusPaths: (options.focus_paths ?? []).map((focus) => ({
-            root_index: focus.root_index,
-            path: focus.root_relative_path,
-            kind: focus.kind,
-        })),
+        focusPaths: reviewFocusPaths,
         searchRecords: search.records,
         slices: slices.records,
         policy: options.coverage_policy,
     });
+    if (reviewObligations != null) {
+        const headSlices = buildRegressionHeadSliceRecords({
+            candidates: state.contentCandidates,
+            planned: planRegressionHeadSliceCandidates({
+                candidates: state.contentCandidates,
+                searchRecords: search.records,
+                slices: slices.records,
+                obligations: reviewObligations,
+            }),
+            existingRecords: slices.records,
+            maxCandidateSlices: internalCaps.max_candidate_slices,
+            maxCandidateBytes: Math.max(0, internalCaps.max_candidate_bytes - search.candidateBytes),
+            maxBytesPerFile: options.budget.max_bytes_per_file,
+        });
+        if (headSlices.length > 0) {
+            slices.records.push(...headSlices);
+            reviewObligations = buildContextReviewObligations({
+                candidates: state.contentCandidates,
+                focusPaths: reviewFocusPaths,
+                searchRecords: search.records,
+                slices: slices.records,
+                policy: options.coverage_policy,
+            });
+        }
+    }
     classifyContextEvidenceCandidates({
         candidates: state.contentCandidates,
         focusPaths: options.focus_paths ?? [],
@@ -1099,6 +1133,51 @@ export function buildCandidateSliceRecords(input) {
     }
     return { records, capHit, omissions };
 }
+// Head-slice line bound for synthesized regression evidence: enough to show a
+// test's imports and first cases without competing with real search windows.
+const REGRESSION_HEAD_SLICE_MAX_LINES = 60;
+/**
+ * Materializes the tests chosen by `planRegressionHeadSliceCandidates` as real
+ * slice records so selection, reconstruction, and rendering can carry them.
+ * Source is `search` WITHOUT `search_term_index`: every slice consumer already
+ * defaults a missing index to the lowest rank, and `focus` would wrongly mark
+ * the test as caller-requested evidence. Content comes from the already
+ * sanitized content candidate, so `allow_secrets:false` redaction applies
+ * exactly as for other slices. Candidate slice/byte caps still bound the
+ * total; a slice that does not fit is simply not synthesized.
+ */
+function buildRegressionHeadSliceRecords(input) {
+    const candidateByIdentity = new Map(input.candidates.map((candidate) => [candidateKey(candidate), candidate]));
+    let count = input.existingRecords.length;
+    let bytes = input.existingRecords.reduce((total, record) => total + Buffer.byteLength(`${JSON.stringify(record)}\n`, "utf8"), 0);
+    const records = [];
+    for (const planned of input.planned) {
+        const candidate = candidateByIdentity.get(candidateKey(planned));
+        if (candidate == null ||
+            candidate.line_count === 0 ||
+            firstLineExceedsCap(candidate.content, input.maxBytesPerFile)) {
+            continue;
+        }
+        const endLine = Math.min(candidate.line_count, REGRESSION_HEAD_SLICE_MAX_LINES, headSliceEndLine(candidate.content, input.maxBytesPerFile));
+        const record = {
+            root_index: candidate.root_index,
+            path: candidate.path,
+            start_line: 1,
+            end_line: endLine,
+            source: "search",
+            content: sliceContent(candidate.content, 1, endLine),
+        };
+        const recordBytes = Buffer.byteLength(`${JSON.stringify(record)}\n`, "utf8");
+        if (count >= input.maxCandidateSlices ||
+            bytes + recordBytes > input.maxCandidateBytes) {
+            continue;
+        }
+        records.push(record);
+        count++;
+        bytes += recordBytes;
+    }
+    return records;
+}
 export function splitTextLines(text) {
     if (text.length === 0) {
         return [];
@@ -1367,6 +1446,35 @@ function pushDirectoryOmission(input, omission) {
     });
 }
 async function processFile(input) {
+    await processFileEntry(input);
+    await settleDiscoveryFileBoundary(input.state, input.signal);
+}
+async function settleDiscoveryFileBoundary(state, signal) {
+    state.filesSinceProgress++;
+    if (state.onProgress != null &&
+        state.filesSinceProgress >= CONTEXT_BUILDER_SCAN_PROGRESS_EVERY_FILES) {
+        state.filesSinceProgress = 0;
+        try {
+            state.onProgress(Object.freeze({ ...state.metrics }));
+        }
+        catch {
+            // Progress is observability only; a failing sink must never stop the walk.
+        }
+    }
+    assertNotAborted(signal);
+    state.filesSinceYield++;
+    if (state.filesSinceYield >= DISCOVERY_YIELD_EVERY_FILES) {
+        await yieldDiscoveryToEventLoop(state, signal);
+    }
+}
+async function yieldDiscoveryToEventLoop(state, signal) {
+    state.filesSinceYield = 0;
+    await new Promise((resolve) => {
+        setImmediate(resolve);
+    });
+    assertNotAborted(signal);
+}
+async function processFileEntry(input) {
     const fileKey = candidateKey({
         root_index: input.root.root_index,
         path: input.relativePath,
@@ -1588,6 +1696,10 @@ async function processFile(input) {
     const sanitized = input.allowSecrets
         ? { status: "unchanged", content: rawContent, findings: [] }
         : sanitizeHighConfidenceSecretContent(rawContent);
+    if (!input.allowSecrets) {
+        assertNotAborted(input.signal);
+        await yieldDiscoveryToEventLoop(input.state, input.signal);
+    }
     if (sanitized.status === "blocked") {
         omitted("content_secret", `Content omitted due to high-confidence secret (${summarizeSecretFindings(sanitized.findings)})`, sanitized.findings);
         pushTree({