clinkx 0.3.0 → 1.1.0

package/dist/context-builder/external-gaps.js

@@ -0,0 +1,248 @@
+import { lstatSync, realpathSync } from "node:fs";
+import path from "node:path";
+import { isSamePathOrDescendant } from "../allowed-roots.js";
+import { SANITIZE_BUDGET_EXHAUSTED_PROVENANCE } from "./secrets.js";
+import { compileContextBuilderGlobs, CONTEXT_BUILDER_DEFAULT_EXCLUDE_GLOBS, } from "./globs.js";
+const EXCLUDED_OMISSION_REASONS = new Set([
+    "exclude_glob",
+    "caller_include_glob",
+    "default_exclude",
+    "default_noisy_exclude",
+    "excluded",
+    "noisy_file",
+]);
+const TOO_LARGE_OMISSION_REASONS = new Set(["file_too_large"]);
+const SECRET_OMISSION_REASONS = new Set([
+    "secret_path",
+    "content_secret",
+    SANITIZE_BUDGET_EXHAUSTED_PROVENANCE,
+]);
+// `(` and `)` are legal in real filenames, so only the wildcard/class/brace
+// metacharacters mark a path as a glob rather than a path.
+const GLOB_CHARS_PATTERN = /[*?[\]{}]/;
+/**
+ * Classifies the finalizer's self-reported `external_gaps` against what the
+ * server actually knows. A gap is only accepted as EXTERNAL when it names an
+ * existing, root-contained path that the packet genuinely did not carry;
+ * anything the packet had (or the caller explicitly focused) is a finalizer
+ * error, not missing evidence, and is rejected so it cannot launder a real
+ * in-packet insufficiency into a soft "conditional" verdict.
+ *
+ * Source roots are the resolved context_builder roots; artifact-only (`/.`)
+ * entries never reach them, and `excludedRealRoots` (artifact dirs nested
+ * under a source root) are treated as outside every root.
+ *
+ * Focus/packet rejection also covers ANCESTORS (a directory that contains a
+ * focus path or packet candidate is not absent evidence), and is re-run on the
+ * canonical on-disk path after the existence check so a case variant or an
+ * in-root symlink alias cannot smuggle an in-packet file past the lexical
+ * comparison. Accepted gaps carry the canonical path. Results are deduped:
+ * external by (root_index, canonical path), rejected by (path, why), first
+ * occurrence wins.
+ */
+export function classifyFinalizerExternalGaps(input) {
+    // realpathSync.native returns the on-disk case (APFS/NTFS), the same domain
+    // as the fs/promises realpath that resolved the source roots in paths.ts.
+    const fs = input.fs ?? {
+        lstat: (p) => lstatSync(p),
+        realpath: (p) => realpathSync.native(p),
+    };
+    const matcher = compileMatcher(input.includeGlobs ?? [], input.excludeGlobs ?? []);
+    const external = [];
+    const rejected = [];
+    const seenExternal = new Set();
+    const seenRejected = new Set();
+    const reject = (entry) => {
+        const key = JSON.stringify([entry.path, entry.why]);
+        if (!seenRejected.has(key)) {
+            seenRejected.add(key);
+            rejected.push(entry);
+        }
+    };
+    const isInPacket = (rootIndex, relative) => input.packetCandidates.some((candidate) => candidate.root_index === rootIndex && isSameOrAncestor(relative, candidate.path));
+    for (const gap of input.gaps) {
+        const relative = normalizeGapPath(gap.path);
+        const roots = gap.root_index == null
+            ? input.sourceRoots
+            : input.sourceRoots.filter((root) => root.root_index === gap.root_index);
+        if (relative == null || roots.length === 0) {
+            reject({ path: gap.path, why: "invalid_path" });
+            continue;
+        }
+        if (roots.some((root) => isUnderFocusPath(root.root_index, relative, input.focusPaths))) {
+            reject({ path: relative, why: "required_focus" });
+            continue;
+        }
+        if (roots.some((root) => isInPacket(root.root_index, relative))) {
+            reject({ path: relative, why: "in_packet" });
+            continue;
+        }
+        let root;
+        let resolved = null;
+        for (const candidateRoot of roots) {
+            resolved = existsContained(candidateRoot, relative, input.excludedRealRoots ?? [], fs);
+            if (resolved != null) {
+                root = candidateRoot;
+                break;
+            }
+        }
+        if (root == null || resolved == null) {
+            reject({ path: relative, why: "nonexistent_or_outside_roots" });
+            continue;
+        }
+        const canonical = resolved.path;
+        // An in-root alias of the root itself canonicalizes to "": same as ".".
+        if (canonical === "") {
+            reject({ path: relative, why: "invalid_path" });
+            continue;
+        }
+        // Same checks against the canonical identity; the rejection still names
+        // the caller's path so the failure text matches what the finalizer wrote.
+        if (isUnderFocusPath(root.root_index, canonical, input.focusPaths)) {
+            reject({ path: relative, why: "required_focus" });
+            continue;
+        }
+        if (isInPacket(root.root_index, canonical)) {
+            reject({ path: relative, why: "in_packet" });
+            continue;
+        }
+        const externalKey = JSON.stringify([root.root_index, canonical]);
+        if (seenExternal.has(externalKey)) {
+            continue;
+        }
+        seenExternal.add(externalKey);
+        external.push({
+            path: canonical,
+            root_index: root.root_index,
+            reason: gap.reason,
+            provenance: gapProvenance(root.root_index, canonical, resolved.isDirectory, input.discovery, matcher),
+        });
+    }
+    return { external, rejected };
+}
+function normalizeGapPath(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0 ||
+        trimmed.includes("\u0000") ||
+        trimmed.includes("\\") ||
+        trimmed.startsWith("/") ||
+        trimmed.startsWith("~") ||
+        /^[A-Za-z]:/.test(trimmed) ||
+        /^[A-Za-z][A-Za-z0-9+.-]*:\/\//.test(trimmed) ||
+        GLOB_CHARS_PATTERN.test(trimmed)) {
+        return null;
+    }
+    if (trimmed.split("/").includes("..")) {
+        return null;
+    }
+    const normalized = path.posix
+        .normalize(trimmed)
+        .replace(/^\.\//, "")
+        .replace(/\/+$/, "");
+    return normalized.length === 0 || normalized === "." ? null : normalized;
+}
+function isUnderFocusPath(rootIndex, relative, focusPaths) {
+    return focusPaths.some((focus) => {
+        if (focus.root_index !== rootIndex) {
+            return false;
+        }
+        // Exact match, or the gap is an ancestor directory of the focus path.
+        if (isSameOrAncestor(relative, focus.root_relative_path)) {
+            return true;
+        }
+        return (focus.kind === "directory" &&
+            (focus.root_relative_path === "" ||
+                relative.startsWith(`${focus.root_relative_path}/`)));
+    });
+}
+/** True when `candidate` equals `ancestor` or lies under it ("" is the root). */
+function isSameOrAncestor(ancestor, candidate) {
+    return (ancestor === "" || candidate === ancestor || candidate.startsWith(`${ancestor}/`));
+}
+function existsContained(root, relative, excludedRealRoots, fs) {
+    const lexical = path.join(root.path, ...relative.split("/"));
+    try {
+        const stats = fs.lstat(lexical);
+        if (!stats.isFile() && !stats.isDirectory() && !stats.isSymbolicLink()) {
+            return null;
+        }
+        // lstat proves the entry itself exists without following it; realpath then
+        // resolves every symlink on the way (the leaf and any parent directory) so
+        // a link that escapes the root cannot pass as local evidence.
+        const real = fs.realpath(lexical);
+        if (!isSamePathOrDescendant(real, root.path) ||
+            excludedRealRoots.some((excluded) => isSamePathOrDescendant(real, excluded))) {
+            return null;
+        }
+        // Canonical root-relative POSIX identity (on-disk case, symlinks resolved).
+        return {
+            path: path.relative(root.path, real).split(path.sep).join("/"),
+            isDirectory: fs.lstat(real).isDirectory(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function gapProvenance(rootIndex, relative, isDirectory, discovery, matcher) {
+    const treeEntry = discovery.tree.find((file) => file.root_index === rootIndex && file.path === relative);
+    const omissionReason = treeEntry?.omission_reason;
+    if (omissionReason != null && TOO_LARGE_OMISSION_REASONS.has(omissionReason)) {
+        return "too_large";
+    }
+    if (omissionReason != null && SECRET_OMISSION_REASONS.has(omissionReason)) {
+        return "secret_filtered";
+    }
+    if ((omissionReason != null && EXCLUDED_OMISSION_REASONS.has(omissionReason)) ||
+        isUnderExcludedDirectoryOmission(rootIndex, relative, discovery.omissions) ||
+        isGlobExcluded(relative, isDirectory, matcher)) {
+        return "excluded_glob";
+    }
+    if (discovery.content_candidates.some((candidate) => candidate.root_index === rootIndex &&
+        (candidate.path === relative || candidate.path.startsWith(`${relative}/`)))) {
+        return "packet_cap";
+    }
+    // A directory whose descendants were walked was reached by the scan, so the
+    // scan cap did not keep it out.
+    if (treeEntry == null &&
+        discovery.metrics.scan_cap_hit &&
+        !discovery.tree.some((file) => file.root_index === rootIndex && file.path.startsWith(`${relative}/`))) {
+        return "scan_cap";
+    }
+    return "not_discovered";
+}
+function isUnderExcludedDirectoryOmission(rootIndex, relative, omissions) {
+    return omissions.some((omission) => EXCLUDED_OMISSION_REASONS.has(omission.reason) &&
+        (omission.root_index == null || omission.root_index === rootIndex) &&
+        (omission.paths ?? []).some((omitted) => omitted === relative || relative.startsWith(`${omitted}/`)));
+}
+function isGlobExcluded(relative, isDirectory, matcher) {
+    if (matcher == null) {
+        return false;
+    }
+    try {
+        // Directories use discovery's traversal predicate: `src/lib` never matches
+        // the file glob `src/**/*.ts`, but discovery still walks into it.
+        const included = isDirectory
+            ? matcher.canContainIncludedPath(relative)
+            : matcher.includes(relative);
+        return matcher.excludes(relative) || !included;
+    }
+    catch {
+        return false;
+    }
+}
+function compileMatcher(includeGlobs, excludeGlobs) {
+    // Mirrors discovery's matcher so provenance names the same rule that
+    // actually kept the path out of the candidate pool.
+    try {
+        return compileContextBuilderGlobs({
+            include: [...includeGlobs],
+            exclude: [...CONTEXT_BUILDER_DEFAULT_EXCLUDE_GLOBS, ...excludeGlobs],
+        });
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=external-gaps.js.map

package/dist/context-builder/external-gaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-gaps.js","sourceRoot":"","sources":["../../src/context-builder/external-gaps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oCAAoC,EAAE,MAAM,cAAc,CAAC;AAMpE,OAAO,EACL,0BAA0B,EAC1B,qCAAqC,GAEtC,MAAM,YAAY,CAAC;AAgDpB,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,cAAc;IACd,qBAAqB;IACrB,iBAAiB;IACjB,uBAAuB;IACvB,UAAU;IACV,YAAY;CACb,CAAC,CAAC;AACH,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAC/D,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,aAAa;IACb,gBAAgB;IAChB,oCAAoC;CACrC,CAAC,CAAC;AACH,4EAA4E;AAC5E,2DAA2D;AAC3D,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAe7C;IACC,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI;QACrB,KAAK,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QAClC,QAAQ,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;KAChD,CAAC;IACF,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACnF,MAAM,QAAQ,GAA0C,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAwC,EAAE,CAAC;IACzD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,MAAM,GAAG,CAAC,KAAwC,EAAQ,EAAE;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,QAAgB,EAAW,EAAE,CAClE,KAAK,CAAC,gBAAgB,CAAC,IAAI,CACzB,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,UAAU,KAAK,SAAS,IAAI,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CACnF,CAAC;IAEJ,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,KAAK,GACT,GAAG,CAAC,UAAU,IAAI,IAAI;YACpB,CAAC,CAAC,KAAK,CAAC,WAAW;YACnB,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7E,IAAI,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACxF,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;YAC7C,SAAS;QACX,CAAC;QACD,IAAI,IAA4C,CAAC;QACjD,IAAI,QAAQ,GAA8B,IAAI,CAAC;QAC/C,KAAK,MAAM,aAAa,IAAI,KAAK,EAAE,CAAC;YAClC,QAAQ,GAAG,eAAe,CAAC,aAAa,EAAE,QAAQ,EAAE,KAAK,CAAC,iBAAiB,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACvF,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,GAAG,aAAa,CAAC;gBACrB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,IAAI,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,8BAA8B,EAAE,CAAC,CAAC;YAChE,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC;QAChC,wEAAwE;QACxE,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;YACrB,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QACD,wEAAwE;QACxE,0EAA0E;QAC1E,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YACnE,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;YAC7C,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;QACjE,IAAI,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,SAAS;QACX,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,UAAU,EAAE,aAAa,CACvB,IAAI,CAAC,UAAU,EACf,SAAS,EACT,QAAQ,CAAC,WAAW,EACpB,KAAK,CAAC,SAAS,EACf,OAAO,CACR;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IACE,OAAO,CAAC,MAAM,KAAK,CAAC;QACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QACvB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QACvB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;QAC1B,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7C,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK;SAC1B,SAAS,CAAC,OAAO,CAAC;SAClB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,OAAO,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;AAC3E,CAAC;AAED,SAAS,gBAAgB,CACvB,SAAiB,EACjB,QAAgB,EAChB,UAAsD;IAEtD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/B,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,sEAAsE;QACtE,IAAI,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,WAAW;YAC1B,CAAC,KAAK,CAAC,kBAAkB,KAAK,EAAE;gBAC9B,QAAQ,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,kBAAkB,GAAG,CAAC,CAAC,CACvD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AACjF,SAAS,gBAAgB,CAAC,QAAgB,EAAE,SAAiB;IAC3D,OAAO,CACL,QAAQ,KAAK,EAAE,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,CAClF,CAAC;AACJ,CAAC;AASD,SAAS,eAAe,CACtB,IAAgC,EAChC,QAAgB,EAChB,iBAAoC,EACpC,EAAkC;IAElC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YACvE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,2EAA2E;QAC3E,2EAA2E;QAC3E,8DAA8D;QAC9D,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClC,IACE,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;YACxC,iBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAC5E,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,4EAA4E;QAC5E,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAC9D,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;SAC1C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,SAAiB,EACjB,QAAgB,EAChB,WAAoB,EACpB,SAKC,EACD,OAAyC;IAEzC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CACnC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAClE,CAAC;IACF,MAAM,cAAc,GAAG,SAAS,EAAE,eAAe,CAAC;IAClD,IAAI,cAAc,IAAI,IAAI,IAAI,0BAA0B,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7E,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,cAAc,IAAI,IAAI,IAAI,uBAAuB,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1E,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,IACE,CAAC,cAAc,IAAI,IAAI,IAAI,yBAAyB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACzE,gCAAgC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC;QAC1E,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAC9C,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IACE,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAC/B,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,UAAU,KAAK,SAAS;QAClC,CAAC,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,CAC7E,EACD,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,4EAA4E;IAC5E,gCAAgC;IAChC,IACE,SAAS,IAAI,IAAI;QACjB,SAAS,CAAC,OAAO,CAAC,YAAY;QAC9B,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAClB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,CAChF,EACD,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,SAAS,gCAAgC,CACvC,SAAiB,EACjB,QAAgB,EAChB,SAA4C;IAE5C,OAAO,SAAS,CAAC,IAAI,CACnB,CAAC,QAAQ,EAAE,EAAE,CACX,yBAAyB,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC9C,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC;QAClE,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CACzB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC,CACxE,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,QAAgB,EAChB,WAAoB,EACpB,OAAyC;IAEzC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,2EAA2E;QAC3E,kEAAkE;QAClE,MAAM,QAAQ,GAAG,WAAW;YAC1B,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC;YAC1C,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,YAA+B,EAC/B,YAA+B;IAE/B,qEAAqE;IACrE,oDAAoD;IACpD,IAAI,CAAC;QACH,OAAO,0BAA0B,CAAC;YAChC,OAAO,EAAE,CAAC,GAAG,YAAY,CAAC;YAC1B,OAAO,EAAE,CAAC,GAAG,qCAAqC,EAAE,GAAG,YAAY,CAAC;SACrE,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -7,6 +7,7 @@ export type ContextBuilderGlobMatcher = {
     canContainIncludedPath(path: string): boolean;
     excludes(path: string): boolean;
 };
+export declare const CONTEXT_BUILDER_VENDOR_DEFAULT_EXCLUDE_GLOBS: readonly string[];
 export declare const CONTEXT_BUILDER_DEFAULT_EXCLUDE_GLOBS: readonly string[];
 export declare function validateContextBuilderGlobs(globs: ContextBuilderGlobSet): void;
 export declare function compileContextBuilderGlobs(globs: ContextBuilderGlobSet): ContextBuilderGlobMatcher;

package/dist/context-builder/globs.js

@@ -3,10 +3,24 @@ import path from "node:path";
 import { InvalidParamsError } from "../errors.js";
 const require = createRequire(import.meta.url);
 const picomatch = require("picomatch");
+// Mobile/native vendor and build-cache trees. Android build output is already
+// covered by `**/build/**` in the default excludes below.
+export const CONTEXT_BUILDER_VENDOR_DEFAULT_EXCLUDE_GLOBS = Object.freeze([
+    "Pods/**",
+    "**/Pods/**",
+    ".cxx/**",
+    "**/.cxx/**",
+    ".gradle/**",
+    "**/.gradle/**",
+    "DerivedData/**",
+    "**/DerivedData/**",
+]);
 export const CONTEXT_BUILDER_DEFAULT_EXCLUDE_GLOBS = Object.freeze([
     ".claude/**",
     ".git/**",
     "**/.git/**",
+    ".worktrees/**",
+    "**/.worktrees/**",
     "node_modules/**",
     "**/node_modules/**",
     "dist/**",
@@ -33,6 +47,7 @@ export const CONTEXT_BUILDER_DEFAULT_EXCLUDE_GLOBS = Object.freeze([
     "**/*.pyc",
     ".venv/**",
     "**/.venv/**",
+    ...CONTEXT_BUILDER_VENDOR_DEFAULT_EXCLUDE_GLOBS,
 ]);
 const GLOB_META_PATTERN = /[*?\[\]{}()]/;
 const FIRST_SEGMENT_META_PATTERN = /[*?\[\]{}()!+@]/;
@@ -75,16 +90,16 @@ export function compileContextBuilderGlobs(globs) {
 }
 export function normalizeRootRelativePathForGlob(input) {
     if (isWindowsRootedOrDriveQualified(input)) {
-        throw new InvalidParamsError("context_builder glob paths must be root-relative");
+        throw new InvalidParamsError(`context_builder glob paths must be root-relative (got: "${input}")`);
     }
     const slashNormalized = input.replaceAll("\\", "/");
     if (path.posix.isAbsolute(slashNormalized)) {
-        throw new InvalidParamsError("context_builder glob paths must be root-relative");
+        throw new InvalidParamsError(`context_builder glob paths must be root-relative (got: "${input}")`);
     }
     const normalized = path.posix.normalize(slashNormalized).replace(/^\.\//, "");
     const segments = normalized.split("/");
     if (normalized === ".." || segments.includes("..")) {
-        throw new InvalidParamsError("context_builder glob path must not contain ..");
+        throw new InvalidParamsError(`context_builder glob path must not contain .. (got: "${input}")`);
     }
     return normalized === "." ? "" : normalized;
 }
@@ -96,27 +111,27 @@ export function isSelectiveIncludeGlob(pattern) {
 }
 function validateGlobPattern(pattern, fieldName) {
     if (pattern.trim() === "") {
-        throw new InvalidParamsError(`context_builder ${fieldName} must not be empty`);
+        throw new InvalidParamsError(`context_builder ${fieldName} must not be empty (got: "${pattern}")`);
     }
     if (pattern.startsWith("!")) {
-        throw new InvalidParamsError(`context_builder ${fieldName} does not support negation`);
+        throw new InvalidParamsError(`context_builder ${fieldName} does not support negation (got: "${pattern}")`);
     }
     const slashNormalized = pattern.replaceAll("\\", "/");
     if (path.posix.isAbsolute(slashNormalized) ||
         isWindowsRootedOrDriveQualified(pattern)) {
-        throw new InvalidParamsError(`context_builder ${fieldName} must be root-relative`);
+        throw new InvalidParamsError(`context_builder ${fieldName} must be root-relative (got: "${pattern}")`);
     }
     const normalized = normalizeGlobPattern(pattern);
     if (normalized === "." || normalized === "") {
-        throw new InvalidParamsError(`context_builder ${fieldName} must not be root shorthand`);
+        throw new InvalidParamsError(`context_builder ${fieldName} must not be root shorthand (got: "${pattern}")`);
     }
     if (isWholeRootGlobPattern(normalized)) {
-        throw new InvalidParamsError(`context_builder ${fieldName} must not match the whole root`);
+        throw new InvalidParamsError(`context_builder ${fieldName} must not match the whole root (got: "${pattern}")`);
     }
     if (normalized === ".." ||
         normalized.split("/").includes("..") ||
         slashNormalized.split("/").includes("..")) {
-        throw new InvalidParamsError(`context_builder ${fieldName} must not contain ..`);
+        throw new InvalidParamsError(`context_builder ${fieldName} must not contain .. (got: "${pattern}")`);
     }
 }
 function validateIncludeFirstSegment(pattern) {
@@ -127,7 +142,7 @@ function validateIncludeFirstSegment(pattern) {
         firstSegment === "*" ||
         firstSegment === "**" ||
         FIRST_SEGMENT_META_PATTERN.test(firstSegment)) {
-        throw new InvalidParamsError("context_builder include_globs first segment must be literal");
+        throw new InvalidParamsError(`context_builder include_globs first segment must be literal (got: "${pattern}"); use a literal first segment like "src/context-builder/**", not "**/src/context-builder/**" — use exclude_globs for "**/" carve-outs`);
     }
 }
 function normalizeGlobForPicomatch(pattern) {

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

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

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

@@ -1,8 +1,15 @@
 import type { AdapterRegistry } from "../registry.js";
 import { ContextBuilderSemaphore, type ContextBuilderInternalCaps } from "./config.js";
-import { type ContextBuilderDelegatePacketCaps } from "./delegate-packet.js";
+import { type ContextBuilderDelegatePacketCaps, type ContextBuilderDelegatePacketCandidate, type ContextBuilderDelegatePacketCoveragePolicy } from "./delegate-packet.js";
+import { type ContextBuilderContentCandidate } from "./discovery.js";
+import { type ContextBuilderWarning } from "./diagnostics.js";
+import { type ContextBuilderResolvedFocusPath } from "./paths.js";
 import { type ContextBuilderProgressTarget } from "./progress.js";
+import { ContextBuilderLifecycleController, type ContextBuilderLifecycleInjection, type ContextBuilderSessionLogContext } from "./lifecycle-observer.js";
 import { type ContextBuilderReceiptTextResponse } from "./receipt.js";
+import { type ContextReviewObligationModel } from "./review-coverage.js";
+import { type ContextBuilderSelectedFile } from "./selection.js";
+import { type ContextBuilderStorageOps, type ContextBuilderStoragePaths } from "./storage.js";
 export type ContextBuilderHandlerOptions = {
     signal?: AbortSignal;
     progress?: ContextBuilderProgressTarget;
@@ -12,6 +19,64 @@ export type ContextBuilderHandlerOptions = {
     now?: () => Date;
     internalCaps?: ContextBuilderInternalCaps;
     delegatePacketCaps?: Partial<ContextBuilderDelegatePacketCaps>;
+    allowRootWideDiscovery?: boolean;
+    lifecycle?: ContextBuilderLifecycleInjection;
+    /** Internal composition seam: workflow preflight owns this controller. */
+    lifecycleController?: ContextBuilderLifecycleController;
+    /**
+     * Session-log identity for the workflow preflight's curator/finalizer calls,
+     * sourced from the lifecycle router's run-dir generation sidecar. Honored
+     * only on the injected-lifecycle path (journal === undefined); the standalone
+     * path derives its own identity from the journal dir.
+     */
+    sessionLogContext?: ContextBuilderSessionLogContext;
+    /**
+     * Standalone MCP dispatch only: the raw tool args carried an explicit
+     * `delegate.finalizer.min_score` (see `finalizerMinScoreExplicit`). Never
+     * inferred here — the workflow runner also calls without a sessionLogContext
+     * (unbound lifecycle router or sidecar failure) while always forwarding a
+     * defaulted min_score, and workflow admission applies E5 at its own layer.
+     */
+    standaloneMinScoreExplicit?: boolean;
+    /** Internal workflow seam: continue consuming the committed run under lease. */
+    retainCommittedRun?: (response: ContextBuilderReceiptTextResponse, storage: ContextBuilderStoragePaths, ops: ContextBuilderStorageOps) => Promise<void>;
 };
 export declare function handleContextBuilder(args: unknown, options?: ContextBuilderHandlerOptions): Promise<ContextBuilderReceiptTextResponse>;
-export declare function renderDelegatePrompt(stage: "curator" | "finalizer", packet: unknown): string;
+declare function finalizerRequiredFocusEvictionFailure(input: {
+    focusPaths: readonly ContextBuilderResolvedFocusPath[];
+    candidates: readonly ContextBuilderDelegatePacketCandidate[];
+    contentCandidates: readonly Pick<ContextBuilderContentCandidate, "root_index" | "path" | "content">[];
+    selected: readonly ContextBuilderSelectedFile[];
+}): string | undefined;
+export declare const finalizerRequiredFocusEvictionFailureForTest: typeof finalizerRequiredFocusEvictionFailure;
+declare function postRepairRequiredFocusEvictionFailure(input: {
+    focusPaths: readonly ContextBuilderResolvedFocusPath[];
+    candidates: readonly ContextBuilderDelegatePacketCandidate[];
+    preRepairSelected: readonly ContextBuilderSelectedFile[];
+    postRepairSelected: readonly ContextBuilderSelectedFile[];
+}): string | undefined;
+export declare const postRepairRequiredFocusEvictionFailureForTest: typeof postRepairRequiredFocusEvictionFailure;
+export declare function isMaterialDelegateEvidenceWarningForTest(message: string): boolean;
+/**
+ * Renders the caller-anchored required-focus contract.
+ *
+ * Rendered only when the packet carries a candidate with focus_requested:true
+ * and non-empty required_focus_ranges, i.e. exactly the candidates
+ * requiredFocusEvidenceSelections enforces. Without it the finalizer had no
+ * signal that anchored files are mandatory and deduplicated near-duplicate
+ * anchors as a quality judgment.
+ *
+ * Phrasing guard: the finalizer may echo these lines into `warnings`, which
+ * isMaterialDelegateEvidenceWarning scans with a negation-blind proximity
+ * match. Keep gap vocabulary (missing, omitted, unavailable, not selected, ...)
+ * out of these lines; tests/context-builder/delegate-prompt.test.ts runs every
+ * rendered line through that matcher.
+ */
+export declare function packetRequiredFocusRules(stage: "curator" | "finalizer", packet: unknown): string[];
+export declare function renderDelegatePrompt(stage: "curator" | "finalizer", packet: unknown, options?: {
+    minScore?: number | undefined;
+    externalGapPolicy?: "fail" | "degrade" | undefined;
+}): string;
+declare function packetObligationTruncationWarning(fullObligations: ContextReviewObligationModel | undefined, packetPolicy: ContextBuilderDelegatePacketCoveragePolicy): ContextBuilderWarning | undefined;
+export declare const packetObligationTruncationWarningForTest: typeof packetObligationTruncationWarning;
+export {};