@agentskit/doc-bridge 1.11.1 → 1.12.0

package/dist/index.js

@@ -1716,8 +1716,8 @@ ${zodIssues(result.error).map((i) => `  - ${i.path}: ${i.message}`).join("\n")}`
 };
 
 // src/index-builder/build-index.ts
-import { mkdirSync as mkdirSync2, readFileSync as readFileSync11, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname4, join as join10 } from "path";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync12, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname5, join as join11 } from "path";
 
 // src/discovery/documentation.ts
 import { parseDocument } from "yaml";
@@ -1831,8 +1831,8 @@ var nodeStart = (node) => {
 var conventionalPackageReference = (path, agentRoot) => {
   const prefix = `${agentRoot.replace(/\/$/, "")}/`;
   if (!path.startsWith(prefix)) return void 0;
-  const relative12 = path.slice(prefix.length);
-  const [scope, file] = relative12.split("/");
+  const relative13 = path.slice(prefix.length);
+  const [scope, file] = relative13.split("/");
   if (scope !== "packages" && scope !== "apps" || !file) return void 0;
   return file.replace(/\.mdx?$/, "");
 };
@@ -2145,9 +2145,9 @@ var applyDocumentationDeclarations = (snapshot, documents, options = {}) => {
 };
 
 // src/discovery/repository.ts
-import { execFileSync } from "child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync3 } from "fs";
-import { basename as basename2, dirname as dirname2, extname as extname2, join as join5, relative as relative3, resolve as resolve4, sep as sep3 } from "path";
+import { execFileSync as execFileSync2 } from "child_process";
+import { existsSync as existsSync6, readFileSync as readFileSync4 } from "fs";
+import { basename as basename2, dirname as dirname3, extname as extname2, join as join6, relative as relative4, resolve as resolve5, sep as sep4 } from "path";
 import * as ts2 from "typescript";
 
 // src/lib/glob-expand.ts
@@ -2163,9 +2163,9 @@ var containedProjectPath = (root, path) => {
   const unresolved = resolve2(projectRoot, path);
   const unresolvedRelative = relative(projectRoot, unresolved);
   if (isAbsolute(unresolvedRelative) || unresolvedRelative === ".." || unresolvedRelative.startsWith(`..${sep}`)) return void 0;
-  const canonical = existsSync2(unresolved) ? realpathSync.native(unresolved) : unresolved;
-  const canonicalRelative = relative(projectRoot, canonical);
-  return isAbsolute(canonicalRelative) || canonicalRelative === ".." || canonicalRelative.startsWith(`..${sep}`) ? void 0 : canonical;
+  const canonical2 = existsSync2(unresolved) ? realpathSync.native(unresolved) : unresolved;
+  const canonicalRelative = relative(projectRoot, canonical2);
+  return isAbsolute(canonicalRelative) || canonicalRelative === ".." || canonicalRelative.startsWith(`..${sep}`) ? void 0 : canonical2;
 };
 
 // src/lib/glob-expand.ts
@@ -2257,25 +2257,140 @@ var defaultChecksForTarget = (root, opts) => {
 };
 
 // src/safety/repository.ts
-import { lstatSync, readdirSync as readdirSync2, realpathSync as realpathSync2, statSync as statSync2 } from "fs";
-import { isAbsolute as isAbsolute2, relative as relative2, resolve as resolve3, sep as sep2 } from "path";
+import { lstatSync, readdirSync as readdirSync2, realpathSync as realpathSync3, statSync as statSync2 } from "fs";
+import { isAbsolute as isAbsolute3, relative as relative3, resolve as resolve4, sep as sep3 } from "path";
 import { minimatch } from "minimatch";
+
+// src/lib/ignore-filter.ts
+import { execFileSync } from "child_process";
+import { existsSync as existsSync5, readFileSync as readFileSync3, realpathSync as realpathSync2 } from "fs";
+import { dirname as dirname2, isAbsolute as isAbsolute2, join as join4, relative as relative2, resolve as resolve3, sep as sep2 } from "path";
+import ignore from "ignore";
+var toPosix2 = (value) => value.split(sep2).join("/");
+var canonical = (path) => {
+  try {
+    return realpathSync2.native(resolve3(path));
+  } catch {
+    return resolve3(path);
+  }
+};
+var below = (root, candidate) => {
+  const rel = relative2(root, candidate);
+  if (rel === "") return "";
+  if (isAbsolute2(rel) || rel === ".." || rel.startsWith(`..${sep2}`)) return void 0;
+  return toPosix2(rel);
+};
+var gitVisibleFiles = (root) => {
+  try {
+    const inside = execFileSync("git", ["rev-parse", "--is-inside-work-tree"], {
+      cwd: root,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    if (inside !== "true") return void 0;
+    const output = execFileSync("git", ["ls-files", "-z", "--cached", "--others", "--exclude-standard", "--", "."], {
+      cwd: root,
+      encoding: "utf8",
+      maxBuffer: 256 * 1024 * 1024,
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    return output.split("\0").filter(Boolean);
+  } catch {
+    return void 0;
+  }
+};
+var gitFilter = (root, canonicalRoot, visible) => {
+  const files = new Set(visible.filter((path) => !path.endsWith("/")));
+  const directories = /* @__PURE__ */ new Set([""]);
+  for (const file of visible) {
+    let parent = file;
+    for (; ; ) {
+      const slash = parent.lastIndexOf("/");
+      if (slash === -1) break;
+      parent = parent.slice(0, slash);
+      if (directories.has(parent)) break;
+      directories.add(parent);
+    }
+  }
+  return {
+    mode: "git",
+    isIgnored: (absolutePath, isDirectory) => {
+      const rel = below(root, resolve3(absolutePath)) ?? below(canonicalRoot, canonical(absolutePath));
+      if (rel === void 0) return false;
+      return isDirectory ? !directories.has(rel) : !files.has(rel);
+    }
+  };
+};
+var gitignoreFilter = (root) => {
+  const rules = /* @__PURE__ */ new Map();
+  const rulesFor = (directory) => {
+    if (rules.has(directory)) return rules.get(directory);
+    const file = join4(directory, ".gitignore");
+    let matcher;
+    if (existsSync5(file)) {
+      try {
+        matcher = ignore().add(readFileSync3(file, "utf8"));
+      } catch {
+        matcher = void 0;
+      }
+    }
+    rules.set(directory, matcher);
+    return matcher;
+  };
+  const ignoredCache = /* @__PURE__ */ new Map();
+  const isIgnored = (absolutePath, isDirectory) => {
+    const target2 = resolve3(absolutePath);
+    const rel = below(root, target2);
+    if (rel === void 0 || rel === "") return false;
+    const key = `${isDirectory ? "d" : "f"}:${rel}`;
+    const cached = ignoredCache.get(key);
+    if (cached !== void 0) return cached;
+    const parent = dirname2(target2);
+    let result = parent !== root && below(root, parent) !== void 0 ? isIgnored(parent, true) : false;
+    if (!result) {
+      let decided;
+      let directory = root;
+      const segments = below(root, parent)?.split("/").filter(Boolean) ?? [];
+      for (let index = 0; index <= segments.length; index += 1) {
+        if (index > 0) directory = join4(directory, segments[index - 1]);
+        const matcher = rulesFor(directory);
+        if (!matcher) continue;
+        const local = toPosix2(relative2(directory, target2)) + (isDirectory ? "/" : "");
+        const verdict = matcher.test(local);
+        if (verdict.ignored) decided = true;
+        else if (verdict.unignored) decided = false;
+      }
+      result = decided ?? false;
+    }
+    ignoredCache.set(key, result);
+    return result;
+  };
+  return { mode: "gitignore", isIgnored };
+};
+var createIgnoreFilter = (root) => {
+  const base = resolve3(root);
+  const canonicalRoot = canonical(root);
+  const visible = gitVisibleFiles(canonicalRoot);
+  return visible ? gitFilter(base, canonicalRoot, visible) : gitignoreFilter(base);
+};
+
+// src/safety/repository.ts
 var DEFAULT_SAFETY_EXCLUDES = ["**/.git/**", "**/node_modules/**", "**/dist/**", "**/build/**", "**/coverage/**", "**/.doc-bridge/**", "**/.next/**", "**/out/**", "**/.turbo/**", "**/.svelte-kit/**", "**/.mcpb-build/**", "**/.mcpb-output/**", "**/.env", "**/.env.*", "**/*secret*", "**/*credential*", "**/*.pem", "**/*.key"];
 var containedPath = (root, candidate) => {
-  const projectRoot = realpathSync2.native(resolve3(root));
-  const unresolved = resolve3(projectRoot, candidate);
-  const unresolvedRelative = relative2(projectRoot, unresolved);
-  if (isAbsolute2(unresolvedRelative) || unresolvedRelative === ".." || unresolvedRelative.startsWith(`..${sep2}`)) return void 0;
+  const projectRoot = realpathSync3.native(resolve4(root));
+  const unresolved = resolve4(projectRoot, candidate);
+  const unresolvedRelative = relative3(projectRoot, unresolved);
+  if (isAbsolute3(unresolvedRelative) || unresolvedRelative === ".." || unresolvedRelative.startsWith(`..${sep3}`)) return void 0;
   try {
-    const canonical = realpathSync2.native(unresolved);
-    const canonicalRelative = relative2(projectRoot, canonical);
-    return isAbsolute2(canonicalRelative) || canonicalRelative === ".." || canonicalRelative.startsWith(`..${sep2}`) ? void 0 : canonical;
+    const canonical2 = realpathSync3.native(unresolved);
+    const canonicalRelative = relative3(projectRoot, canonical2);
+    return isAbsolute3(canonicalRelative) || canonicalRelative === ".." || canonicalRelative.startsWith(`..${sep3}`) ? void 0 : canonical2;
   } catch {
     return unresolved;
   }
 };
 var safeWalkFiles = (root, options = {}) => {
-  const projectRoot = resolve3(root);
+  const projectRoot = resolve4(root);
   const extensions = options.extensions ?? [];
   const excludes = options.exclude ?? DEFAULT_SAFETY_EXCLUDES;
   const files = [];
@@ -2283,6 +2398,7 @@ var safeWalkFiles = (root, options = {}) => {
   let reason;
   const started = Date.now();
   const matchesExclude = (path) => excludes.some((pattern) => minimatch(path, pattern, { dot: true }));
+  const ignored = options.respectIgnore === false ? void 0 : createIgnoreFilter(projectRoot);
   const visit2 = (directory) => {
     if (reason) return;
     if (options.maxTimeMs !== void 0 && Date.now() - started >= options.maxTimeMs) {
@@ -2300,8 +2416,8 @@ var safeWalkFiles = (root, options = {}) => {
       return;
     }
     for (const name of entries.sort()) {
-      const absolute = resolve3(directory, name);
-      const relativePath3 = relative2(projectRoot, absolute).split(sep2).join("/");
+      const absolute = resolve4(directory, name);
+      const relativePath3 = relative3(projectRoot, absolute).split(sep3).join("/");
       if (matchesExclude(relativePath3) || name === ".git") continue;
       let stats;
       try {
@@ -2310,6 +2426,7 @@ var safeWalkFiles = (root, options = {}) => {
         continue;
       }
       if (stats.isSymbolicLink()) continue;
+      if (ignored?.isIgnored(absolute, stats.isDirectory())) continue;
       if (stats.isDirectory()) {
         visit2(absolute);
         if (reason) return;
@@ -2546,11 +2663,11 @@ var relativeToPackage = (modulePath, packagePath) => {
   const prefix = `${packagePath}/`;
   return modulePath.startsWith(prefix) ? modulePath.slice(prefix.length) : void 0;
 };
-var join4 = (...parts) => parts.filter(Boolean).join("/");
+var join5 = (...parts) => parts.filter(Boolean).join("/");
 var conventionalAreaPath = (module, depth = DEFAULT_AREA_DEPTH, roots = DEFAULT_AREA_ROOTS) => {
-  const relative12 = relativeToPackage(normalize(module.path), normalize(module.packagePath));
-  if (relative12 === void 0) return void 0;
-  const segments = relative12.split("/");
+  const relative13 = relativeToPackage(normalize(module.path), normalize(module.packagePath));
+  if (relative13 === void 0) return void 0;
+  const segments = relative13.split("/");
   segments.pop();
   if (!segments.length) return void 0;
   const rootPrefix = [];
@@ -2562,7 +2679,7 @@ var conventionalAreaPath = (module, depth = DEFAULT_AREA_DEPTH, roots = DEFAULT_
   const taken = rest.slice(0, Math.max(1, depth));
   if (!taken.length) return void 0;
   const packagePath = normalize(module.packagePath);
-  return join4(packagePath === "." ? "" : packagePath, ...rootPrefix, ...taken);
+  return join5(packagePath === "." ? "" : packagePath, ...rootPrefix, ...taken);
 };
 var encloses = (candidate, path) => path === candidate || path.startsWith(`${candidate}/`);
 var deriveAreas = (options) => {
@@ -3246,13 +3363,13 @@ var MAX_MARKDOWN_NOTES = 32;
 var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var readJson = (path) => {
   try {
-    const value = JSON.parse(readFileSync3(path, "utf8"));
+    const value = JSON.parse(readFileSync4(path, "utf8"));
     return isRecord(value) ? { value } : { error: "JSON root is not an object" };
   } catch (error) {
     return { error: error instanceof Error ? error.message : String(error) };
   }
 };
-var relativePath = (root, path) => toPosix(relative3(root, path)) || ".";
+var relativePath = (root, path) => toPosix(relative4(root, path)) || ".";
 var lineEvidence = (source, root, path, lineStart, lineEnd) => ({
   source,
   path: relativePath(root, path),
@@ -3270,11 +3387,11 @@ var workspacePatterns = (root, rootManifest) => {
   if (isRecord(fromPackageJson) && Array.isArray(fromPackageJson.packages)) {
     return fromPackageJson.packages.filter((value) => typeof value === "string");
   }
-  const workspacePath = join5(root, "pnpm-workspace.yaml");
-  if (!existsSync5(workspacePath)) return [];
+  const workspacePath = join6(root, "pnpm-workspace.yaml");
+  if (!existsSync6(workspacePath)) return [];
   const patterns = [];
   let inPackages = false;
-  for (const line of readFileSync3(workspacePath, "utf8").split(/\r?\n/)) {
+  for (const line of readFileSync4(workspacePath, "utf8").split(/\r?\n/)) {
     const trimmed = line.trim();
     if (trimmed === "packages:") {
       inPackages = true;
@@ -3292,7 +3409,7 @@ var workspacePatterns = (root, rootManifest) => {
 var discoverPackages = (root, rootManifest, config) => {
   const packages = [];
   const coverage = [];
-  const rootManifestPath = join5(root, "package.json");
+  const rootManifestPath = join6(root, "package.json");
   if (rootManifest) {
     const name = packageName(rootManifest, "");
     packages.push({
@@ -3312,8 +3429,8 @@ var discoverPackages = (root, rootManifest, config) => {
   }
   const dirs = expandWorkspaceGlobs(root, patterns);
   for (const absPath of dirs) {
-    const manifestPath = join5(absPath, "package.json");
-    if (!existsSync5(manifestPath)) continue;
+    const manifestPath = join6(absPath, "package.json");
+    if (!existsSync6(manifestPath)) continue;
     const parsed = readJson(manifestPath);
     if (!parsed.value) {
       coverage.push({ status: "partial", reason: `${relativePath(root, manifestPath)}: ${parsed.error ?? "invalid package.json"}` });
@@ -3323,7 +3440,7 @@ var discoverPackages = (root, rootManifest, config) => {
     const name = packageName(parsed.value, path);
     const id = entityId("package", name ?? path);
     const duplicate = packages.find((pkg) => pkg.id === id);
-    if (duplicate && duplicate.absPath !== absPath) {
+    if (duplicate && toPosix(duplicate.absPath) !== toPosix(absPath)) {
       throw new Error(`Package identity collision for "${id}": "${duplicate.path}" and "${path}".`);
     }
     if (!duplicate) packages.push({ id, ...name ? { name } : {}, path, absPath, manifestPath, manifest: parsed.value });
@@ -3331,13 +3448,13 @@ var discoverPackages = (root, rootManifest, config) => {
   coverage.push({ status: "complete" });
   return { packages: packages.sort((a, b) => a.id.localeCompare(b.id)), coverage };
 };
-var packageForModule = (packages, absPath) => [...packages].filter((pkg) => absPath === pkg.absPath || absPath.startsWith(`${pkg.absPath}${sep3}`)).sort((a, b) => b.absPath.length - a.absPath.length)[0];
+var packageForModule = (packages, absPath) => [...packages].filter((pkg) => absPath === pkg.absPath || absPath.startsWith(`${pkg.absPath}${sep4}`)).sort((a, b) => b.absPath.length - a.absPath.length)[0];
 var readCompilerOptions = (root) => {
   const configPath = ts2.findConfigFile(root, ts2.sys.fileExists, "tsconfig.json");
   if (!configPath) return { options: {} };
   const parsed = ts2.readConfigFile(configPath, ts2.sys.readFile);
   if (parsed.error) return { options: {}, error: ts2.flattenDiagnosticMessageText(parsed.error.messageText, "\n") };
-  const config = ts2.parseJsonConfigFileContent(parsed.config, ts2.sys, dirname2(configPath));
+  const config = ts2.parseJsonConfigFileContent(parsed.config, ts2.sys, dirname3(configPath));
   if (config.errors.length) {
     return {
       options: config.options,
@@ -3468,17 +3585,17 @@ var moduleReferences = (root, path, sourceFile, runtimeWiringMethods) => {
   };
 };
 var resolveRelativeModule = (specifier, containingFile, modulePaths) => {
-  const base = resolve4(dirname2(containingFile), specifier);
+  const base = resolve5(dirname3(containingFile), specifier);
   const extension = extname2(base);
   const extensionlessBase = extension ? base.slice(0, -extension.length) : base;
   const candidates = [
     base,
     ...SOURCE_EXTENSIONS.map((extension2) => `${base}${extension2}`),
-    ...SOURCE_EXTENSIONS.map((extension2) => join5(base, `index${extension2}`)),
+    ...SOURCE_EXTENSIONS.map((extension2) => join6(base, `index${extension2}`)),
     ...SOURCE_EXTENSIONS.map((extension2) => `${extensionlessBase}${extension2}`),
-    ...SOURCE_EXTENSIONS.map((extension2) => join5(extensionlessBase, `index${extension2}`))
+    ...SOURCE_EXTENSIONS.map((extension2) => join6(extensionlessBase, `index${extension2}`))
   ];
-  return candidates.map((candidate) => modulePaths.get(resolve4(candidate))).find(Boolean);
+  return candidates.map((candidate) => modulePaths.get(resolve5(candidate))).find(Boolean);
 };
 var resolveReference = (reference8, containingFile, modules, packages, compilerOptions) => {
   if (reference8.specifier.startsWith(".") || reference8.specifier.startsWith("/")) {
@@ -3488,7 +3605,7 @@ var resolveReference = (reference8, containingFile, modules, packages, compilerO
   const packageTarget = [...packages].filter((pkg) => pkg.name && (reference8.specifier === pkg.name || reference8.specifier.startsWith(`${pkg.name}/`))).sort((a, b) => (b.name?.length ?? 0) - (a.name?.length ?? 0))[0];
   if (packageTarget) return { targetId: packageTarget.id };
   const resolved = ts2.resolveModuleName(reference8.specifier, containingFile, compilerOptions, ts2.sys).resolvedModule?.resolvedFileName;
-  const resolvedTarget = resolved ? modules.get(resolve4(resolved)) : void 0;
+  const resolvedTarget = resolved ? modules.get(resolve5(resolved)) : void 0;
   if (resolvedTarget) return { targetId: resolvedTarget.entityId };
   return { targetId: entityId("external", reference8.specifier) };
 };
@@ -3505,26 +3622,26 @@ var sourceRevision = (root, files) => {
     value: sha256NormalizedV1(
       files.map((path) => ({
         path: relativePath(root, path),
-        contentHash: sha256NormalizedV1(readFileSync3(path, "utf8"))
+        contentHash: sha256NormalizedV1(readFileSync4(path, "utf8"))
       }))
     ),
     kind: "content"
   });
   try {
-    const status = execFileSync("git", ["status", "--porcelain", "--untracked-files=all"], {
+    const status = execFileSync2("git", ["status", "--porcelain", "--untracked-files=all"], {
       cwd: root,
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"]
     }).trim();
     if (status) return contentRevision();
-    const value = execFileSync("git", ["rev-parse", "HEAD"], { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    const value = execFileSync2("git", ["rev-parse", "HEAD"], { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
     if (value) return { value, kind: "git" };
   } catch {
   }
   return contentRevision();
 };
 var hasPackageManagerMetadata = (root, rootManifest) => Boolean(
-  rootManifest?.packageManager || existsSync5(join5(root, "pnpm-lock.yaml")) || existsSync5(join5(root, "pnpm-workspace.yaml")) || existsSync5(join5(root, "yarn.lock")) || existsSync5(join5(root, "bun.lock")) || existsSync5(join5(root, "bun.lockb")) || existsSync5(join5(root, "package-lock.json"))
+  rootManifest?.packageManager || existsSync6(join6(root, "pnpm-lock.yaml")) || existsSync6(join6(root, "pnpm-workspace.yaml")) || existsSync6(join6(root, "yarn.lock")) || existsSync6(join6(root, "bun.lock")) || existsSync6(join6(root, "bun.lockb")) || existsSync6(join6(root, "package-lock.json"))
 );
 var PIPELINE_VERSION = "1.5.0";
 var ANALYZER_VERSIONS = { repository: "1.3.0", "js-ts": "1.3.5", markdown: MARKDOWN_ANALYZER_VERSION, graph: GRAPH_ANALYZER_VERSION };
@@ -3549,12 +3666,12 @@ var artifact = (root, config, files, entities, relations, coverage) => {
   return DiscoverySnapshotV1Schema.parse({ ...base, contentHash: contentHashForArtifactV1(base) });
 };
 var discoverRepository = (opts = {}) => {
-  const root = resolve4(opts.root ?? process.cwd());
+  const root = resolve5(opts.root ?? process.cwd());
   const safeOptions = safeWalkOptions(opts.config, {
     maxFiles: opts.maxFiles ?? opts.config?.safety?.maxFiles ?? DEFAULT_MAX_FILES,
     ...opts.maxBytes !== void 0 ? { maxBytes: opts.maxBytes } : {}
   });
-  const rootManifestPath = join5(root, "package.json");
+  const rootManifestPath = join6(root, "package.json");
   const rootManifest = readJson(rootManifestPath).value;
   const packageResult = discoverPackages(root, rootManifest, opts.config);
   const sourceWalk = safeWalkFiles(root, { extensions: SOURCE_EXTENSIONS, ...safeOptions });
@@ -3563,7 +3680,7 @@ var discoverRepository = (opts = {}) => {
   const sourcePaths = sourceWalk.files;
   const documentPaths = documentWalk.files;
   const configPaths = configWalk.files.filter((path) => /(?:^|\/)(?:tsconfig|jsconfig|vite\.config|webpack\.config|rollup\.config|next\.config|jest\.config|eslint\.config|vitest\.config)/.test(relativePath(root, path)));
-  const allFiles = [...new Set([rootManifestPath, ...sourcePaths, ...documentPaths, ...configPaths].filter(existsSync5))].sort();
+  const allFiles = [...new Set([rootManifestPath, ...sourcePaths, ...documentPaths, ...configPaths].filter(existsSync6))].sort();
   const entities = /* @__PURE__ */ new Map();
   const relations = /* @__PURE__ */ new Map();
   const addEntity = (entity) => {
@@ -3586,7 +3703,7 @@ var discoverRepository = (opts = {}) => {
     relations.set(relation.id, { ...existing, evidence: [...evidence2.values()] });
   };
   for (const pkg of packageResult.packages) {
-    const text = readFileSync3(pkg.manifestPath, "utf8");
+    const text = readFileSync4(pkg.manifestPath, "utf8");
     addEntity({
       id: pkg.id,
       kind: "package",
@@ -3634,9 +3751,9 @@ var discoverRepository = (opts = {}) => {
     const path = relativePath(root, absPath);
     const pkg = packageForModule(packageResult.packages, absPath);
     const id = entityId("module", path);
-    const text = readFileSync3(absPath, "utf8");
+    const text = readFileSync4(absPath, "utf8");
     const contentHash = fileContentHash(text);
-    modules.set(resolve4(absPath), { absPath, path, entityId: id, ...pkg ? { packageId: pkg.id } : {} });
+    modules.set(resolve5(absPath), { absPath, path, entityId: id, ...pkg ? { packageId: pkg.id } : {} });
     modulesByPath.set(path, id);
     if (pkg) areaModules.push({ moduleId: id, path, packageId: pkg.id, packagePath: pkg.path });
     const priorModule = reuseModuleRelations ? prior?.modules.get(path) : void 0;
@@ -3759,7 +3876,7 @@ var discoverRepository = (opts = {}) => {
   for (const [path, absPath] of documentFiles) {
     let text;
     try {
-      text = readFileSync3(absPath, "utf8");
+      text = readFileSync4(absPath, "utf8");
     } catch {
       unreadableDocuments.push(path);
       ledger.parsedFiles.push(path);
@@ -3878,7 +3995,7 @@ var discoverRepository = (opts = {}) => {
     });
   }
   for (const pkg of packageResult.packages) {
-    const text = readFileSync3(pkg.manifestPath, "utf8");
+    const text = readFileSync4(pkg.manifestPath, "utf8");
     for (const dependency of dependencyEntries(pkg.manifest)) {
       const target2 = packageResult.packages.find((candidate) => candidate.name === dependency.name)?.id ?? entityId("external", dependency.name);
       if (!entities.has(target2)) addEntity({ id: target2, kind: "external", name: dependency.name, provenance: "observed", evidence: [lineEvidence("configuration", root, pkg.manifestPath, firstLineContaining(text, `"${dependency.name}"`))] });
@@ -3917,7 +4034,7 @@ var discoverRepository = (opts = {}) => {
       ledger.skippedFiles.push(module.path);
       continue;
     }
-    const text = readFileSync3(module.absPath, "utf8");
+    const text = readFileSync4(module.absPath, "utf8");
     const sourceFile = ts2.createSourceFile(module.absPath, text, ts2.ScriptTarget.Latest, true, scriptKind(module.absPath));
     const runtimeWiringMethods = includeTestRuntimeWiring || !TEST_MODULE_PATTERN.test(module.path) ? configuredRuntimeWiringMethods : /* @__PURE__ */ new Set();
     const references = moduleReferences(root, module.absPath, sourceFile, runtimeWiringMethods);
@@ -3950,7 +4067,7 @@ var discoverRepository = (opts = {}) => {
 };
 
 // src/lib/bounded-text.ts
-import { closeSync, fstatSync, openSync, readFileSync as readFileSync4 } from "fs";
+import { closeSync, fstatSync, openSync, readFileSync as readFileSync5 } from "fs";
 var MAX_DOCUMENT_BYTES = 4 * 1024 * 1024;
 var MAX_CORPUS_BYTES = 64 * 1024 * 1024;
 var readBoundedText = (path, budget, limits) => {
@@ -3967,7 +4084,7 @@ var readBoundedText = (path, budget, limits) => {
       throw new Error(`Documentation corpus exceeds the ${maxCorpusBytes} byte read budget.`);
     }
     budget.used += stat.size;
-    return readFileSync4(fd, "utf8");
+    return readFileSync5(fd, "utf8");
   } finally {
     closeSync(fd);
   }
@@ -4069,8 +4186,8 @@ var slugFromPath = (relPath) => {
 };
 
 // src/lib/walk.ts
-import { lstatSync as lstatSync2, readdirSync as readdirSync3, realpathSync as realpathSync3 } from "fs";
-import { join as join6 } from "path";
+import { lstatSync as lstatSync2, readdirSync as readdirSync3, realpathSync as realpathSync4 } from "fs";
+import { join as join7 } from "path";
 var DEFAULT_SKIP = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "coverage", ".doc-bridge"]);
 var DEFAULT_MAX_FILES2 = 1e4;
 var walkFiles = (root, opts) => {
@@ -4078,10 +4195,11 @@ var walkFiles = (root, opts) => {
   const skip = opts?.skipDirs ?? DEFAULT_SKIP;
   const out = [];
   const visited = /* @__PURE__ */ new Set();
+  const ignored = opts?.respectIgnore === false ? void 0 : createIgnoreFilter(root);
   const visit2 = (dir) => {
     let canonicalDir;
     try {
-      canonicalDir = realpathSync3.native(dir);
+      canonicalDir = realpathSync4.native(dir);
     } catch {
       return;
     }
@@ -4094,7 +4212,7 @@ var walkFiles = (root, opts) => {
       return;
     }
     for (const name of entries) {
-      const abs = join6(dir, name);
+      const abs = join7(dir, name);
       let st;
       try {
         st = lstatSync2(abs);
@@ -4103,12 +4221,12 @@ var walkFiles = (root, opts) => {
       }
       if (st.isSymbolicLink()) continue;
       if (st.isDirectory()) {
-        if (skip.has(name)) continue;
+        if (skip.has(name) || ignored?.isIgnored(abs, true)) continue;
         visit2(abs);
         continue;
       }
       if (!st.isFile()) continue;
-      if (extensions.some((ext) => name.endsWith(ext))) {
+      if (extensions.some((ext) => name.endsWith(ext)) && !ignored?.isIgnored(abs, false)) {
         if (out.length >= (opts?.maxFiles ?? DEFAULT_MAX_FILES2)) {
           throw new Error(`Documentation corpus exceeds the ${opts?.maxFiles ?? DEFAULT_MAX_FILES2} file limit.`);
         }
@@ -4400,7 +4518,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.11.1";
+var PACKAGE_VERSION = "1.12.0";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {
@@ -4434,8 +4552,8 @@ var renderCapabilitiesJson = (config, index, paths) => {
 };
 
 // src/render/template-source.ts
-import { readFileSync as readFileSync5 } from "fs";
-import { resolve as resolve5 } from "path";
+import { readFileSync as readFileSync6 } from "fs";
+import { resolve as resolve6 } from "path";
 
 // src/render/engine.ts
 import {
@@ -4992,10 +5110,10 @@ var BUNDLED_TEMPLATES = {
 var resolveTemplateSource = (name, config, root) => {
   const override = config.render?.templates?.[name];
   if (!override) return { name, source: BUNDLED_TEMPLATES[name], origin: "bundled" };
-  const path = root ? resolve5(root, override) : resolve5(override);
+  const path = root ? resolve6(root, override) : resolve6(override);
   let source;
   try {
-    source = readFileSync5(path, "utf8");
+    source = readFileSync6(path, "utf8");
   } catch (error) {
     throw new Error(`render.templates["${name}"] points at ${toPosix(override)}, which could not be read: ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -5014,8 +5132,8 @@ var compile = (template2) => {
 var renderNamedTemplate = (name, variables, config, root) => renderCompiledTemplate(compile(resolveTemplateSource(name, config, root)), variables);
 
 // src/index-builder/project-corpus.ts
-import { basename as basename3, extname as extname3, relative as relative4, resolve as resolve6, sep as sep4 } from "path";
-import { readFileSync as readFileSync6 } from "fs";
+import { basename as basename3, extname as extname3, relative as relative5, resolve as resolve7, sep as sep5 } from "path";
+import { readFileSync as readFileSync7 } from "fs";
 var CORPUS_PROJECTION_VERSION = 2;
 var PROJECTED_ENTRY_TYPES = ["document", "module"];
 var isProjectedEntry = (entry) => PROJECTED_ENTRY_TYPES.includes(entry.type);
@@ -5034,14 +5152,14 @@ var isInput = (path, name) => {
   return CONFIG_INPUT_PATTERN.test(path);
 };
 var repositoryInputs = (root, config) => {
-  const projectRoot = resolve6(root);
+  const projectRoot = resolve7(root);
   const walk = safeWalkFiles(projectRoot, { extensions: INPUT_EXTENSIONS, ...safeWalkOptions(config) });
   const fingerprints = [];
   for (const absPath of walk.files) {
-    const path = toPosix(relative4(projectRoot, absPath).split(sep4).join("/"));
+    const path = toPosix(relative5(projectRoot, absPath).split(sep5).join("/"));
     if (!isInput(path, basename3(absPath))) continue;
     try {
-      fingerprints.push([path, sha256NormalizedV1(readFileSync6(absPath, "utf8"))]);
+      fingerprints.push([path, sha256NormalizedV1(readFileSync7(absPath, "utf8"))]);
     } catch {
       fingerprints.push([path, "unreadable"]);
     }
@@ -5086,15 +5204,15 @@ var llmsTxtVariables = (config, knowledge, projectName2) => {
 var renderLlmsTxt = (config, knowledge, projectName2, options = {}) => renderNamedTemplate("llms.txt", llmsTxtVariables(config, knowledge, projectName2), config, options.root);
 
 // src/index-builder/human-adapters/index.ts
-import { realpathSync as realpathSync5 } from "fs";
-import { resolve as resolve8, sep as sep6 } from "path";
+import { realpathSync as realpathSync6 } from "fs";
+import { resolve as resolve9, sep as sep7 } from "path";
 
 // src/index-builder/human-adapters/docusaurus.ts
-import { existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 
 // src/index-builder/human-adapters/core.ts
-import { realpathSync as realpathSync4 } from "fs";
-import { isAbsolute as isAbsolute3, relative as relative5, resolve as resolve7, sep as sep5 } from "path";
+import { realpathSync as realpathSync5 } from "fs";
+import { isAbsolute as isAbsolute4, relative as relative6, resolve as resolve8, sep as sep6 } from "path";
 var optionString = (options, keys) => {
   for (const key of keys) {
     const value = options?.[key];
@@ -5103,11 +5221,12 @@ var optionString = (options, keys) => {
   return void 0;
 };
 var parseFrontmatter2 = (raw) => {
-  if (!raw.startsWith("---\n")) return {};
-  const end = raw.indexOf("\n---", 4);
+  const normalized = raw.includes("\r\n") ? raw.replace(/\r\n/g, "\n") : raw;
+  if (!normalized.startsWith("---\n")) return {};
+  const end = normalized.indexOf("\n---", 4);
   if (end === -1) return {};
   const out = {};
-  for (const line of raw.slice(4, end).split("\n")) {
+  for (const line of normalized.slice(4, end).split("\n")) {
     const match = /^([A-Za-z0-9_-]+):\s*(.+?)\s*$/.exec(line);
     if (match?.[1] && match[2]) out[match[1]] = match[2].replace(/^['"]|['"]$/g, "");
   }
@@ -5125,15 +5244,15 @@ var humanUrl = (slug2, urlPrefix) => {
 };
 var scanMarkdownDocs = (root, humanRoot, options) => {
   const out = [];
-  const projectRoot = realpathSync4.native(resolve7(root));
+  const projectRoot = realpathSync5.native(resolve8(root));
   const absRoot = containedProjectPath(root, humanRoot);
   if (!absRoot) return out;
   const budget = { used: 0 };
   for (const abs of walkFiles(absRoot, { extensions: [".md", ".mdx"] })) {
-    const canonical = realpathSync4.native(abs);
-    const fileRelative = relative5(projectRoot, canonical);
-    if (isAbsolute3(fileRelative) || fileRelative === ".." || fileRelative.startsWith(`..${sep5}`)) continue;
-    const relToHumanRoot = toPosix(abs.replace(`${toPosix(absRoot)}/`, ""));
+    const canonical2 = realpathSync5.native(abs);
+    const fileRelative = relative6(projectRoot, canonical2);
+    if (isAbsolute4(fileRelative) || fileRelative === ".." || fileRelative.startsWith(`..${sep6}`)) continue;
+    const relToHumanRoot = toPosix(abs).replace(`${toPosix(absRoot)}/`, "");
     const raw = readBoundedText(abs, budget);
     if (options?.includeRelPath && !options.includeRelPath(relToHumanRoot, raw)) continue;
     out.push({
@@ -5174,7 +5293,7 @@ var docusaurusRecordId = (relPath, raw) => {
 };
 var readSidebars = (sidebarsFile) => {
   if (!sidebarsFile) return { enabled: false, ids: /* @__PURE__ */ new Set(), autogenDirs: [] };
-  if (!existsSync6(sidebarsFile)) return { enabled: false, ids: /* @__PURE__ */ new Set(), autogenDirs: [] };
+  if (!existsSync7(sidebarsFile)) return { enabled: false, ids: /* @__PURE__ */ new Set(), autogenDirs: [] };
   const raw = readBoundedText(sidebarsFile, { used: 0 }, { maxFileBytes: 1048576, maxCorpusBytes: 1048576 });
   const filter = { ids: /* @__PURE__ */ new Set(), autogenDirs: [] };
   const visit2 = (value) => {
@@ -5224,13 +5343,13 @@ var docusaurusAdapter = {
 };
 
 // src/index-builder/human-adapters/fumadocs.ts
-import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync8, readFileSync as readFileSync8 } from "fs";
+import { join as join8 } from "path";
 var readMetaPages = (dir) => {
-  const file = join7(dir, "meta.json");
-  if (!existsSync7(file)) return void 0;
+  const file = join8(dir, "meta.json");
+  if (!existsSync8(file)) return void 0;
   try {
-    const meta = JSON.parse(readFileSync7(file, "utf8"));
+    const meta = JSON.parse(readFileSync8(file, "utf8"));
     return Array.isArray(meta.pages) ? meta.pages.filter((page) => typeof page === "string") : void 0;
   } catch {
     return void 0;
@@ -5245,7 +5364,7 @@ var isListedByMeta = (contentRoot, relPath) => {
   if (isDotFile(relPath)) return false;
   const parts = relPath.split("/");
   for (let i = 0; i < parts.length; i += 1) {
-    const dir = join7(contentRoot, ...parts.slice(0, i));
+    const dir = join8(contentRoot, ...parts.slice(0, i));
     const pages = readMetaPages(dir);
     if (!pages?.length || pages.includes("...")) continue;
     const key = pageKey(parts[i] ?? "");
@@ -5258,7 +5377,7 @@ var fumadocsAdapter = {
   scan: ({ root, config }) => {
     const contentDir = optionString(config.options, ["contentDir", "root"]);
     if (!contentDir) return [];
-    const contentRoot = join7(root, contentDir);
+    const contentRoot = join8(root, contentDir);
     const excludePrefixes = Array.isArray(config.options?.excludePrefixes) ? config.options.excludePrefixes.filter((v) => typeof v === "string") : typeof config.options?.excludePrefix === "string" ? [config.options.excludePrefix] : [];
     if (!excludePrefixes.includes("for-agents")) excludePrefixes.push("for-agents");
     return scanMarkdownDocs(root, contentDir, {
@@ -5402,21 +5521,21 @@ var humanConfigs = (config) => {
 };
 var canonicalPath = (path) => {
   try {
-    return realpathSync5.native(path);
+    return realpathSync6.native(path);
   } catch {
-    return resolve8(path);
+    return resolve9(path);
   }
 };
 var scanHumanDocRecords = (root, config) => {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
-  const agentRoot = canonicalPath(resolve8(root, config.corpus.agent.root));
+  const agentRoot = canonicalPath(resolve9(root, config.corpus.agent.root));
   for (const human of humanConfigs(config)) {
     const adapter = ADAPTERS.find((candidate) => candidate.plugin === human.plugin);
     if (!adapter) continue;
     for (const record of adapter.scan({ root, config: human })) {
       const recordPath = canonicalPath(record.path);
-      if (recordPath === agentRoot || recordPath.startsWith(`${agentRoot}${sep6}`) || record.path.includes("/for-agents/") || record.path.endsWith("/for-agents")) {
+      if (recordPath === agentRoot || recordPath.startsWith(`${agentRoot}${sep7}`) || record.path.includes("/for-agents/") || record.path.endsWith("/for-agents")) {
         continue;
       }
       if (seen.has(record.id)) continue;
@@ -5429,8 +5548,8 @@ var scanHumanDocRecords = (root, config) => {
 var scanHumanDocs = (root, config) => Object.fromEntries(scanHumanDocRecords(root, config).map((doc) => [doc.id, doc.url]));
 
 // src/index-builder/plugins/nx.ts
-import { existsSync as existsSync8, lstatSync as lstatSync3, readFileSync as readFileSync8, realpathSync as realpathSync6 } from "fs";
-import { basename as basename4, dirname as dirname3, isAbsolute as isAbsolute4, relative as relative6, resolve as resolve9, sep as sep7 } from "path";
+import { existsSync as existsSync9, lstatSync as lstatSync3, readFileSync as readFileSync9, realpathSync as realpathSync7 } from "fs";
+import { basename as basename4, dirname as dirname4, isAbsolute as isAbsolute5, relative as relative7, resolve as resolve10, sep as sep8 } from "path";
 var NX_SCAN_SKIP = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
@@ -5443,22 +5562,22 @@ var NX_PROJECT_NAME = /^(?:@[A-Za-z0-9._-]+\/)?[A-Za-z0-9][A-Za-z0-9._-]*$/;
 var isRecord2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var readJsonRecord = (path) => {
   try {
-    const parsed = JSON.parse(readFileSync8(path, "utf8"));
+    const parsed = JSON.parse(readFileSync9(path, "utf8"));
     return isRecord2(parsed) ? parsed : void 0;
   } catch {
     return void 0;
   }
 };
 var safeProjectPath = (root, manifestDir, declaredRoot) => {
-  const candidate = typeof declaredRoot === "string" ? resolve9(root, declaredRoot) : manifestDir;
-  const rel = toPosix(relative6(root, candidate)) || ".";
-  if (isAbsolute4(rel) || rel === ".." || rel.startsWith("../")) return void 0;
+  const candidate = typeof declaredRoot === "string" ? resolve10(root, declaredRoot) : manifestDir;
+  const rel = toPosix(relative7(root, candidate)) || ".";
+  if (isAbsolute5(rel) || rel === ".." || rel.startsWith("../")) return void 0;
   try {
     if (!lstatSync3(candidate).isDirectory()) return void 0;
-    const canonicalRoot = realpathSync6.native(root);
-    const canonicalCandidate = realpathSync6.native(candidate);
-    const canonicalRel = relative6(canonicalRoot, canonicalCandidate);
-    if (isAbsolute4(canonicalRel) || canonicalRel === ".." || canonicalRel.startsWith(`..${sep7}`)) {
+    const canonicalRoot = realpathSync7.native(root);
+    const canonicalCandidate = realpathSync7.native(candidate);
+    const canonicalRel = relative7(canonicalRoot, canonicalCandidate);
+    if (isAbsolute5(canonicalRel) || canonicalRel === ".." || canonicalRel.startsWith(`..${sep8}`)) {
       return void 0;
     }
   } catch {
@@ -5484,7 +5603,7 @@ var inferredChecks = (root, config, projectName2, targets) => {
   return checks.length ? checks : void 0;
 };
 var discoverNxProjects = (root, config) => {
-  if (!existsSync8(resolve9(root, "nx.json"))) return [];
+  if (!existsSync9(resolve10(root, "nx.json"))) return [];
   const manifests = walkFiles(root, {
     extensions: ["project.json", "package.json"],
     skipDirs: NX_SCAN_SKIP,
@@ -5494,7 +5613,7 @@ var discoverNxProjects = (root, config) => {
   for (const manifest of manifests) {
     const json = readJsonRecord(manifest);
     if (!json) continue;
-    const manifestDir = dirname3(manifest);
+    const manifestDir = dirname4(manifest);
     const manifestName = basename4(manifest);
     const isProjectJson = manifestName === "project.json";
     if (!isProjectJson && manifestName !== "package.json") continue;
@@ -5502,7 +5621,7 @@ var discoverNxProjects = (root, config) => {
     if (!isProjectJson && !isRecord2(nx)) continue;
     const path = safeProjectPath(root, manifestDir, isProjectJson ? json.root : void 0);
     if (!path) continue;
-    const projectPackage = isProjectJson ? readJsonRecord(resolve9(root, path, "package.json")) : void 0;
+    const projectPackage = isProjectJson ? readJsonRecord(resolve10(root, path, "package.json")) : void 0;
     const projectName2 = typeof json.name === "string" ? json.name : typeof projectPackage?.name === "string" ? projectPackage.name : basename4(path === "." ? root : path);
     if (!NX_PROJECT_NAME.test(projectName2)) continue;
     const targets = /* @__PURE__ */ new Set();
@@ -5538,8 +5657,8 @@ var discoverNxProjects = (root, config) => {
 };
 
 // src/index-builder/plugins/pnpm-monorepo.ts
-import { existsSync as existsSync9, readFileSync as readFileSync9 } from "fs";
-import { basename as basename5, join as join8 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync10 } from "fs";
+import { basename as basename5, join as join9 } from "path";
 var parsePnpmWorkspace = (yaml) => {
   const lines = yaml.split("\n");
   const patterns = [];
@@ -5561,10 +5680,10 @@ var parsePnpmWorkspace = (yaml) => {
   return patterns;
 };
 var readPackageJson = (dir) => {
-  const file = join8(dir, "package.json");
-  if (!existsSync9(file)) return null;
+  const file = join9(dir, "package.json");
+  if (!existsSync10(file)) return null;
   try {
-    return JSON.parse(readFileSync9(file, "utf8"));
+    return JSON.parse(readFileSync10(file, "utf8"));
   } catch {
     return null;
   }
@@ -5573,9 +5692,9 @@ var discoverPnpmPackages = (root, config) => {
   const explicit = config.routing?.options?.packages;
   let patterns = explicit;
   if (!patterns?.length) {
-    const workspaceFile = join8(root, "pnpm-workspace.yaml");
-    if (existsSync9(workspaceFile)) {
-      patterns = parsePnpmWorkspace(readFileSync9(workspaceFile, "utf8"));
+    const workspaceFile = join9(root, "pnpm-workspace.yaml");
+    if (existsSync10(workspaceFile)) {
+      patterns = parsePnpmWorkspace(readFileSync10(workspaceFile, "utf8"));
     }
   }
   if (!patterns?.length) return [];
@@ -6276,8 +6395,8 @@ var toKnowledgeEntry = (entry) => ({
 });
 
 // src/enrich/overlay.ts
-import { existsSync as existsSync10, mkdirSync, readFileSync as readFileSync10, renameSync, writeFileSync } from "fs";
-import { join as join9, resolve as resolve10 } from "path";
+import { existsSync as existsSync11, mkdirSync, readFileSync as readFileSync11, renameSync, writeFileSync } from "fs";
+import { join as join10, resolve as resolve11 } from "path";
 
 // src/schemas/enrichment.ts
 import { z as z9 } from "zod";
@@ -6785,14 +6904,14 @@ var EnrichmentProposalListSchema = z10.array(z10.unknown()).max(1024);
 // src/enrich/overlay.ts
 var ENRICHMENT_DIR = ".doc-bridge/enrich";
 var ENRICHMENT_OVERLAY_FILE = "overlay.json";
-var enrichmentDir = (root) => join9(resolve10(root), ENRICHMENT_DIR);
-var enrichmentOverlayPath = (root) => join9(enrichmentDir(root), ENRICHMENT_OVERLAY_FILE);
-var enrichmentCacheDir = (root) => join9(enrichmentDir(root), "cache");
+var enrichmentDir = (root) => join10(resolve11(root), ENRICHMENT_DIR);
+var enrichmentOverlayPath = (root) => join10(enrichmentDir(root), ENRICHMENT_OVERLAY_FILE);
+var enrichmentCacheDir = (root) => join10(enrichmentDir(root), "cache");
 var readEnrichmentOverlay = (root) => {
   const path = enrichmentOverlayPath(root);
-  if (!existsSync10(path)) return void 0;
+  if (!existsSync11(path)) return void 0;
   try {
-    const parsed = EnrichmentOverlayV1Schema.parse(JSON.parse(readFileSync10(path, "utf8")));
+    const parsed = EnrichmentOverlayV1Schema.parse(JSON.parse(readFileSync11(path, "utf8")));
     return parsed.contentHash === enrichmentOverlayContentHash(parsed) ? parsed : void 0;
   } catch {
     return void 0;
@@ -6870,7 +6989,7 @@ var projectEnrichmentOverlay = (overlay, snapshot) => {
   const signals = /* @__PURE__ */ new Map();
   const aliases = /* @__PURE__ */ new Map();
   const summaries = /* @__PURE__ */ new Map();
-  const canonical = /* @__PURE__ */ new Map();
+  const canonical2 = /* @__PURE__ */ new Map();
   const intents = [];
   const relations = [];
   const paths = new Map(snapshot.entities.map((entity) => [entity.id, entity.path]));
@@ -6895,7 +7014,7 @@ var projectEnrichmentOverlay = (overlay, snapshot) => {
         });
         break;
       case "mark-canonical":
-        canonical.set(proposal.entity, proposal.payload.scope);
+        canonical2.set(proposal.entity, proposal.payload.scope);
         bump(proposal.entity, SIGNAL_CANONICAL);
         break;
       case "rank-hint":
@@ -6916,7 +7035,7 @@ var projectEnrichmentOverlay = (overlay, snapshot) => {
     ...signals.size ? { signals } : {},
     ...aliases.size ? { aliases } : {},
     ...summaries.size ? { summaries } : {},
-    ...canonical.size ? { canonical } : {},
+    ...canonical2.size ? { canonical: canonical2 } : {},
     ...intents.length ? { intents } : {},
     ...relations.length ? { relations } : {}
   };
@@ -6944,7 +7063,7 @@ var enrichmentFindings = (overlay) => overlay.accepted.filter((entry) => ENRICHM
 var projectName = (root, config) => {
   if (config.project?.name) return config.project.name;
   try {
-    const pkg = JSON.parse(readFileSync11(join10(root, "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync12(join11(root, "package.json"), "utf8"));
     if (pkg.name) return pkg.name;
   } catch {
   }
@@ -6957,7 +7076,7 @@ var projectFromSnapshot = (root, config, given, lookup, curated, requested) => {
   for (const entity of observed.entities) {
     if (entity.kind !== "document" || !entity.path) continue;
     try {
-      contents.set(entity.path, readBoundedText(join10(root, entity.path), budget));
+      contents.set(entity.path, readBoundedText(join11(root, entity.path), budget));
     } catch {
     }
   }
@@ -6980,7 +7099,7 @@ var projectFromSnapshot = (root, config, given, lookup, curated, requested) => {
 };
 var existingGeneratedAt = (indexPath, contentHash) => {
   try {
-    const index = JSON.parse(readFileSync11(indexPath, "utf8"));
+    const index = JSON.parse(readFileSync12(indexPath, "utf8"));
     return index.contentHash === contentHash && typeof index.generatedAt === "string" ? index.generatedAt : void 0;
   } catch {
     return void 0;
@@ -6991,7 +7110,7 @@ var buildDocBridgeIndex = (opts) => {
   const config = opts.config;
   const write = opts.write ?? true;
   const outFile = config.index?.outFile ?? ".doc-bridge/index.json";
-  const indexPath = join10(root, outFile);
+  const indexPath = join11(root, outFile);
   const corpus = scanAgentCorpus(root, config);
   const curated = corpus.map(({ absPath: _a, relPath: _r, frontmatter: _f, ...entry }) => entry);
   const retrieval = {
@@ -7041,7 +7160,7 @@ var buildDocBridgeIndex = (opts) => {
     );
   }
   if (write) {
-    mkdirSync2(dirname4(indexPath), { recursive: true });
+    mkdirSync2(dirname5(indexPath), { recursive: true });
     writeFileSync2(indexPath, `${JSON.stringify(index, null, 2)}
 `, "utf8");
   }
@@ -7050,7 +7169,7 @@ var buildDocBridgeIndex = (opts) => {
   if (config.index?.llmsTxt?.enabled !== false) {
     const llmsOut = config.index?.llmsTxt?.outFile ?? "llms.txt";
     llmsTxtRelPath = toPosix(llmsOut);
-    llmsTxtPath = join10(root, llmsOut);
+    llmsTxtPath = join11(root, llmsOut);
     if (write) {
       writeFileSync2(
         llmsTxtPath,
@@ -7062,9 +7181,9 @@ var buildDocBridgeIndex = (opts) => {
   let capabilitiesPath;
   if (config.index?.capabilities?.enabled !== false) {
     const capabilitiesOut = config.index?.capabilities?.outFile ?? ".doc-bridge/capabilities.json";
-    capabilitiesPath = join10(root, capabilitiesOut);
+    capabilitiesPath = join11(root, capabilitiesOut);
     if (write) {
-      mkdirSync2(dirname4(capabilitiesPath), { recursive: true });
+      mkdirSync2(dirname5(capabilitiesPath), { recursive: true });
       writeFileSync2(
         capabilitiesPath,
         renderCapabilitiesJson(config, index, {
@@ -7084,7 +7203,7 @@ var buildDocBridgeIndex = (opts) => {
 };
 
 // src/discovery/reproducibility.ts
-import { execFileSync as execFileSync2 } from "child_process";
+import { execFileSync as execFileSync3 } from "child_process";
 var NOT_CHECKED = (skipped) => ({
   checked: false,
   skipped,
@@ -7092,7 +7211,7 @@ var NOT_CHECKED = (skipped) => ({
 });
 var git = (root, args, options = {}) => {
   try {
-    return execFileSync2("git", args, {
+    return execFileSync3("git", args, {
       cwd: root,
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"],
@@ -7441,9 +7560,9 @@ var createDocBridgeGraphMemory = (snapshot, overlay = {}) => {
 };
 
 // src/agents/registry-adapter.ts
-import { existsSync as existsSync11, readFileSync as readFileSync12, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync13, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
 import { spawn } from "child_process";
-import { join as join11, resolve as resolve11 } from "path";
+import { join as join12, resolve as resolve12 } from "path";
 import { pathToFileURL } from "url";
 import { z as z11 } from "zod";
 var DEFAULT_REGISTRY_AGENT_ID = "ecosystem-doc-bridge-corpus-scanner";
@@ -7478,7 +7597,7 @@ var validateGrounding = (proposal, snapshot, report, documentation) => {
   if (proposal.relatedDiagnosticIds.some((id) => !diagnosticIds.has(id))) throw new Error("Registry agent proposal references an unknown diagnostic.");
   if (proposal.evidence.some((item) => !evidenceKeys.has(evidenceKey2(item)))) throw new Error("Registry agent proposal contains evidence outside the supplied snapshot/report.");
 };
-var runCli = (root, cli, context, timeoutMs, maxInputBytes, maxResponseBytes) => new Promise((resolve32, reject) => {
+var runCli = (root, cli, context, timeoutMs, maxInputBytes, maxResponseBytes) => new Promise((resolve33, reject) => {
   const v2 = "protocol" in context;
   const input = JSON.stringify(
     v2 ? { protocol: REGISTRY_AGENT_PROTOCOL_V2, response: 'Return exactly one JSON object { "proposals": [...] } on stdout. Do not emit markdown or logs on stdout.', context } : { protocol: "doc-bridge.registry-agent.v1", response: "Return exactly one AgentProposalV1 JSON object on stdout. Do not emit markdown or logs on stdout.", context }
@@ -7530,7 +7649,7 @@ var runCli = (root, cli, context, timeoutMs, maxInputBytes, maxResponseBytes) =>
         return;
       }
       try {
-        resolve32(JSON.parse(stdout));
+        resolve33(JSON.parse(stdout));
       } catch (error) {
         reject(new Error(`Registry agent CLI must return one JSON object on stdout: ${error instanceof Error ? error.message : String(error)}`));
       }
@@ -7546,8 +7665,8 @@ var runCli = (root, cli, context, timeoutMs, maxInputBytes, maxResponseBytes) =>
 var loadRegistryAgentRunner = async (root, config) => {
   const metadata = loadRegistryAgentMetadata(root, config);
   const configured = registryConfig(config)?.runnerModule;
-  const modulePath = configured ? containedPath(root, configured) : containedPath(root, join11(metadata.root, "doc-bridge-adapter.js"));
-  if (!modulePath || !existsSync11(modulePath)) throw new Error(`Registry agent "${metadata.id}" has no local runner module. Configure intelligence.registry.runnerModule or add doc-bridge-adapter.js to the installed agent.`);
+  const modulePath = configured ? containedPath(root, configured) : containedPath(root, join12(metadata.root, "doc-bridge-adapter.js"));
+  if (!modulePath || !existsSync12(modulePath)) throw new Error(`Registry agent "${metadata.id}" has no local runner module. Configure intelligence.registry.runnerModule or add doc-bridge-adapter.js to the installed agent.`);
   const loaded = await import(pathToFileURL(modulePath).href);
   const runner = typeof loaded.run === "function" ? loaded.run : typeof loaded.default === "function" ? loaded.default : loaded.default && typeof loaded.default === "object" && "run" in loaded.default && typeof loaded.default.run === "function" ? loaded.default.run : void 0;
   if (!runner) throw new Error(`Registry agent runner at ${modulePath} must export a function or { run }. `);
@@ -7557,17 +7676,17 @@ var loadRegistryAgentMetadata = (root, config) => {
   const settings = registryConfig(config);
   const id = settings?.agentId ?? DEFAULT_REGISTRY_AGENT_ID;
   const agentRoot = settings?.agentRoot ?? "agents";
-  const agentPath = containedPath(root, join11(agentRoot, id));
-  if (!agentPath || !existsSync11(agentPath)) throw new Error(`AgentsKit Registry agent "${id}" is not installed at ${join11(agentRoot, id)}. Install it with: npx agentskit add ${id}`);
-  const metadataPath = [join11(agentPath, "agent.json"), join11(agentPath, "manifest.json")].find(existsSync11);
+  const agentPath = containedPath(root, join12(agentRoot, id));
+  if (!agentPath || !existsSync12(agentPath)) throw new Error(`AgentsKit Registry agent "${id}" is not installed at ${join12(agentRoot, id)}. Install it with: npx agentskit add ${id}`);
+  const metadataPath = [join12(agentPath, "agent.json"), join12(agentPath, "manifest.json")].find(existsSync12);
   if (!metadataPath) throw new Error(`Registry agent "${id}" is installed but has no agent.json or manifest.json metadata.`);
-  const metadata = RegistryAgentMetadataSchema.parse(JSON.parse(readFileSync12(metadataPath, "utf8")));
+  const metadata = RegistryAgentMetadataSchema.parse(JSON.parse(readFileSync13(metadataPath, "utf8")));
   if (metadata.id !== id) throw new Error(`Installed Registry agent metadata id "${metadata.id}" does not match configured id "${id}".`);
   return { ...metadata, root: agentPath };
 };
 var createRegistryAgentAdapter = (root, config, runner) => {
   if (!registryConfig(config)?.enabled) throw new Error("Registry agents are disabled. Set intelligence.registry.enabled: true to run an assisted workflow.");
-  const metadata = loadRegistryAgentMetadata(resolve11(root), config);
+  const metadata = loadRegistryAgentMetadata(resolve12(root), config);
   const settings = registryConfig(config) ?? {};
   const timeoutMs = settings.timeoutMs ?? 12e4;
   const maxInputBytes = settings.maxInputBytes ?? 8e6;
@@ -7584,7 +7703,7 @@ var createRegistryAgentAdapter = (root, config, runner) => {
     try {
       let raw;
       if (settings.cli) {
-        raw = await runCli(resolve11(root), settings.cli, context, timeoutMs, maxInputBytes, maxResponseBytes);
+        raw = await runCli(resolve12(root), settings.cli, context, timeoutMs, maxInputBytes, maxResponseBytes);
       } else {
         const localRunner = runner;
         const timeout = new Promise((_, reject) => {
@@ -7662,8 +7781,8 @@ var persistRegistryAgentProposal = (stateDir, proposal) => {
   AgentProposalV1Schema.parse(proposal);
   if (proposal.contentHash !== contentHashForArtifactV1(proposal)) throw new Error("Cannot persist a Registry agent proposal with an invalid contentHash.");
   const safeHash = contentHashForArtifactV1(proposal);
-  mkdirSync3(join11(resolve11(stateDir), "agents"), { recursive: true });
-  const path = join11(resolve11(stateDir), "agents", `${proposal.origin.id}-${safeHash}.json`);
+  mkdirSync3(join12(resolve12(stateDir), "agents"), { recursive: true });
+  const path = join12(resolve12(stateDir), "agents", `${proposal.origin.id}-${safeHash}.json`);
   writeFileSync3(path, `${JSON.stringify(proposal, null, 2)}
 `, "utf8");
   return path;
@@ -8040,15 +8159,15 @@ var reconcileKnowledge = (observed, declared, options = {}) => {
 };
 
 // src/audit/documentation.ts
-import { readFileSync as readFileSync13 } from "fs";
-import { resolve as resolve12 } from "path";
+import { readFileSync as readFileSync14 } from "fs";
+import { resolve as resolve13 } from "path";
 import { minimatch as minimatch6 } from "minimatch";
 
 // src/query/handoff.ts
 var MAX_RELATED = 3;
 var MAX_READ_BEFORE = 2;
 var MAX_RELATED_EVIDENCE = 3;
-var dirname5 = (path) => path.split("/").slice(0, -1).join("/") || ".";
+var dirname6 = (path) => path.split("/").slice(0, -1).join("/") || ".";
 var isHttp = (value) => /^https?:\/\//.test(value);
 var bridgeFor = (config, id, humanDoc) => humanDoc ? { humanDoc: isHttp(humanDoc) ? "external" : "linked" } : config.corpus.human ? { humanDoc: "missing", action: "ak-docs bootstrap agent-docs", bootstrap: `docs/for-agents/human/${id}.md` } : void 0;
 var legacyHandoff = (index, id, config) => {
@@ -8184,7 +8303,7 @@ var handoffForEntity = (index, id, config, options = {}) => {
   const area = target2.graph.areaId ? byId.get(target2.graph.areaId) : void 0;
   const packageEntry = target2.graph.packageId ? byId.get(target2.graph.packageId) : target2.kind === "package" ? target2 : void 0;
   const explain = {};
-  const unit = target2.kind === "module" ? area ? { path: area.path, reason: `contained by area ${area.id}` } : packageEntry ? { path: packageEntry.path, reason: `contained by package ${packageEntry.id}` } : { path: dirname5(target2.path), reason: "the directory of the module; no area or package contains it" } : { path: ownership?.path ?? target2.path, reason: ownership ? `ownership ${ownership.id} path` : `the ${target2.kind} itself` };
+  const unit = target2.kind === "module" ? area ? { path: area.path, reason: `contained by area ${area.id}` } : packageEntry ? { path: packageEntry.path, reason: `contained by package ${packageEntry.id}` } : { path: dirname6(target2.path), reason: "the directory of the module; no area or package contains it" } : { path: ownership?.path ?? target2.path, reason: ownership ? `ownership ${ownership.id} path` : `the ${target2.kind} itself` };
   explain.editRoots = [unit.reason];
   const documents = documentsFor(projection, byId, target2, ownership);
   const startHere = documents[0]?.path ?? config.corpus.agent.index ?? target2.path;
@@ -8652,7 +8771,7 @@ var auditDocumentation = (options) => {
   const generatedPaths = config.generatedPaths ?? [];
   const criticalPaths = config.criticalPaths ?? [];
   const requiredSections = config.requiredSections ?? [];
-  const documents = options.snapshot.entities.filter((entity) => entity.kind === "document" && entity.path).map((entity) => ({ path: normalizedPath2(entity.path), content: readFileSync13(resolve12(options.root, entity.path), "utf8") })).filter((document) => !matches(document.path, excluded)).sort((a, b) => a.path.localeCompare(b.path));
+  const documents = options.snapshot.entities.filter((entity) => entity.kind === "document" && entity.path).map((entity) => ({ path: normalizedPath2(entity.path), content: readFileSync14(resolve13(options.root, entity.path), "utf8") })).filter((document) => !matches(document.path, excluded)).sort((a, b) => a.path.localeCompare(b.path));
   const findings = [];
   const generated = documents.filter((document) => matches(document.path, generatedPaths));
   const analyzed = documents.filter((document) => !matches(document.path, generatedPaths));
@@ -9220,7 +9339,7 @@ const findingMatches=(finding)=>{const query=state.query.toLowerCase();return(!q
 const findingScope=(finding)=>data.view?.diagnosticGroup?.[finding.id]?.[0]||(()=>{const ids=[...(finding.entityIds||[])];(finding.relationIds||[]).forEach((id)=>{const relation=relationById.get(id);if(relation)ids.push(relation.from,relation.to)});return ids.map(groupFor).sort()[0]||"repository"})();
 const findingGroups=(findings)=>{const groups=new Map();findings.forEach((finding)=>{const scope=findingScope(finding),key=[scope,finding.code,finding.status,finding.severity].join("|"),group=groups.get(key)||{key,scope,code:finding.code,status:finding.status,severity:finding.severity,findings:[]};group.findings.push(finding);groups.set(key,group)});return[...groups.values()].sort((left,right)=>right.findings.length-left.findings.length||left.code.localeCompare(right.code)||left.key.localeCompare(right.key))};
 const renderFinding=(finding)=>"<article class=\"finding\" id=\""+esc("diagnostic-"+finding.id.replace(/[^A-Za-z0-9_-]+/g,"-"))+"\"><div class=\"finding-head\"><h3>"+esc(finding.code)+"</h3><span><span class=\"tag "+esc(finding.severity)+"\">"+esc(finding.severity)+"</span> <span class=\"tag\">"+esc(finding.status)+"</span></span></div><p>"+esc(finding.message)+"</p>"+(finding.evidence.length?"<ul>"+finding.evidence.slice(0,4).map((item)=>"<li>"+esc(item.path+(item.lineStart?":"+item.lineStart:"")+(item.context?" — "+item.context:""))+"</li>").join("")+"</ul>":"")+(finding.remediation?"<p><strong>Next check:</strong> "+esc(finding.remediation)+"</p>":"")+"</article>";
-const renderFindings=()=>{let findings=data.diagnostics.filter(findingMatches);if(state.lens==="risks")findings=findings.filter((finding)=>finding.severity==="error"||finding.severity==="warn");if(state.lens==="evidence")findings=findings.filter((finding)=>finding.evidence.length);if(state.lens==="drift")findings=findings.filter((finding)=>finding.status!=="confirmed");const itemLabel=state.lens==="evidence"?"evidence checks":"findings",groups=findingGroups(findings),active=groups.find((group)=>group.key===state.findingGroup);if(!active){state.findingGroup=null;state.findingPage=0}syncHash();const selected=active||null,pageSize=40,pageCount=selected?Math.ceil(selected.findings.length/pageSize):0,page=Math.max(0,Math.min(state.findingPage,Math.max(0,pageCount-1))),start=page*pageSize;document.querySelector("#finding-count").textContent=findings.length+" "+itemLabel+" · "+groups.length+" groups";document.querySelector("#findings").innerHTML=findings.length?"<div class=\"finding-groups\">"+groups.map((group)=>"<article class=\"finding-group\"><div class=\"finding-head\"><h3>"+esc(group.code)+"</h3><span><span class=\"tag "+esc(group.severity)+"\">"+esc(group.severity)+"</span> <span class=\"tag\">"+esc(group.status)+"</span></span></div><p><strong>"+group.findings.length+"</strong> "+itemLabel+" · "+esc(groupById.get(group.scope)?.name||group.scope)+"</p><p>"+esc(group.findings[0].message)+"</p><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(group.key)+"\" aria-expanded=\""+String(selected?.key===group.key)+"\">Inspect group</button></article>").join("")+"</div>"+(selected?"<div class=\"finding-detail\"><div class=\"finding-head\"><h3>"+esc(selected.code)+" · "+esc(groupById.get(selected.scope)?.name||selected.scope)+"</h3><span class=\"subtle\">"+selected.findings.length+" "+itemLabel+"</span></div>"+selected.findings.slice(start,start+pageSize).map(renderFinding).join("")+"<div class=\"finding-actions\"><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(selected.key)+"\" data-finding-page=\""+(page-1)+"\" "+(page===0?"disabled":"")+">Previous</button><span class=\"subtle\">Showing "+(start+1)+"–"+Math.min(start+pageSize,selected.findings.length)+" of "+selected.findings.length+" · page "+(page+1)+"/"+pageCount+"</span><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(selected.key)+"\" data-finding-page=\""+(page+1)+"\" "+(page+1>=pageCount?"disabled":"")+">Next</button></div></div>":""):"<p class=\"empty\">No "+itemLabel+" match the current lens and filters.</p>"};
+const renderFindings=()=>{let findings=data.diagnostics.filter(findingMatches);if(state.lens==="risks")findings=findings.filter((finding)=>finding.severity==="error"||finding.severity==="warn");if(state.lens==="evidence")findings=findings.filter((finding)=>finding.evidence.length);if(state.lens==="drift")findings=findings.filter((finding)=>finding.status!=="confirmed");const itemLabel=state.lens==="evidence"?"evidence checks":"findings",groups=findingGroups(findings),active=groups.find((group)=>group.key===state.findingGroup);if(!active){state.findingGroup=null;state.findingPage=0}syncHash();const selected=active||null,pageSize=40,pageCount=selected?Math.ceil(selected.findings.length/pageSize):0,page=Math.max(0,Math.min(state.findingPage,Math.max(0,pageCount-1))),start=page*pageSize;document.querySelector("#finding-count").textContent=findings.length+" "+itemLabel+" · "+groups.length+" groups";document.querySelector("#findings").innerHTML=findings.length?"<div class=\"finding-groups\">"+groups.map((group)=>"<article class=\"finding-group\"><div class=\"finding-head\"><h3>"+esc(group.code)+"</h3><span><span class=\"tag "+esc(group.severity)+"\">"+esc(group.severity)+"</span> <span class=\"tag\">"+esc(group.status)+"</span></span></div><p><strong>"+group.findings.length+"</strong> "+itemLabel+" · "+esc(groupById.get(group.scope)?.name||group.scope)+"</p><p>"+esc(group.findings[0].message)+"</p><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(group.key)+"\" aria-expanded=\""+String(selected?.key===group.key)+"\">Inspect group</button></article>").join("")+"</div>"+(selected?"<div class=\"finding-detail\"><div class=\"finding-head\"><h3>"+esc(selected.code)+" · "+esc(groupById.get(selected.scope)?.name||selected.scope)+"</h3><span class=\"subtle\">"+selected.findings.length+" "+itemLabel+"</span></div>"+selected.findings.slice(start,start+pageSize).map(renderFinding).join("")+"<div class=\"finding-actions\"><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(selected.key)+"\" data-finding-page=\""+(page - 1)+"\" "+(page===0?"disabled":"")+">Previous</button><span class=\"subtle\">Showing "+(start+1)+"–"+Math.min(start+pageSize,selected.findings.length)+" of "+selected.findings.length+" · page "+(page+1)+"/"+pageCount+"</span><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(selected.key)+"\" data-finding-page=\""+(page+1)+"\" "+(page+1>=pageCount?"disabled":"")+">Next</button></div></div>":""):"<p class=\"empty\">No "+itemLabel+" match the current lens and filters.</p>"};
 const renderCoverage=()=>{document.querySelector("#coverage-list").innerHTML=(data.coverage||[]).map((entry)=>{const width=entry.status==="complete"?100:entry.status==="partial"?55:12;return"<div class=\"coverage-row\"><div><b>"+esc(entry.analyzer)+"</b><br><span class=\"subtle\">"+esc(entry.scope)+"</span></div><div class=\"bar\"><i class=\""+(entry.status==="complete"?"":entry.status==="partial"?"partial":"none")+"\" style=\"width:"+width+"%\"></i></div><div>"+esc(entry.status)+"</div></div>"}).join("")||"<p class=\"empty\">No coverage metadata.</p>"};
 const deferFindings=()=>{if(findingsLoaded())return;const actionable=data.actionableCount??data.diagnosticCount??0,confirmed=data.confirmedCount??0;document.querySelector("#finding-count").textContent=actionable+" actionable findings · "+confirmed+" confirmed checks available on demand";document.querySelector("#findings").innerHTML="<div class=\"empty\"><p>Findings stay out of the first paint so large repositories remain responsive. Confirmed checks are evidence, not issues.</p><button id=\"load-findings\" class=\"tab\" type=\"button\">Load findings</button></div>"};
 const scopePrompt=()=>{if((state.level==="module"||state.level==="file")&&!state.selected){document.querySelector("#map-note").textContent="Select an app or package to inspect this level.";document.querySelector("#graph").innerHTML="<text x=\"500\" y=\"270\" text-anchor=\"middle\" class=\"subtle\">Select an app or package to expand this view.</text>"}};
@@ -9389,14 +9508,14 @@ var renderOfflineReportArtifact = (input, options = {}) => {
 };
 
 // src/fixes/proposals.ts
-import { existsSync as existsSync12, readdirSync as readdirSync4, readFileSync as readFileSync14, realpathSync as realpathSync7, renameSync as renameSync2, unlinkSync, writeFileSync as writeFileSync4 } from "fs";
-import { basename as basename7, dirname as dirname6, extname as extname5, join as join12, relative as relative7, resolve as resolve13, sep as sep8 } from "path";
+import { existsSync as existsSync13, readdirSync as readdirSync4, readFileSync as readFileSync15, realpathSync as realpathSync8, renameSync as renameSync2, unlinkSync, writeFileSync as writeFileSync4 } from "fs";
+import { basename as basename7, dirname as dirname7, extname as extname5, join as join13, relative as relative8, resolve as resolve14, sep as sep9 } from "path";
 var hash4 = (value) => sha256NormalizedV1(value);
 var artifactMetadata = (root, options) => ({
   schemaVersion: 1,
   contentHash: "0".repeat(64),
   contentHashAlgo: "sha256-normalized-v1",
-  project: { name: options.projectName ?? basename7(resolve13(root)), root: "." },
+  project: { name: options.projectName ?? basename7(resolve14(root)), root: "." },
   sourceRevision: options.baseRevision,
   sourceRevisionKind: options.baseRevision.length === 40 ? "git" : "content",
   configurationHash: options.configurationHash,
@@ -9427,31 +9546,32 @@ var makeProposal = (root, options, changes, preconditions, postconditions) => {
   };
   return FixProposalV1Schema.parse({ ...draft, contentHash: contentHashForArtifactV1(draft) });
 };
-var walkMarkdown = (root, directory = root) => readdirSync4(directory, { withFileTypes: true }).flatMap((entry) => {
+var walkMarkdown = (root, directory = root, ignored = createIgnoreFilter(root)) => readdirSync4(directory, { withFileTypes: true }).flatMap((entry) => {
   if (entry.name === ".git" || entry.name === "node_modules" || entry.name === "dist" || entry.name === "build") return [];
-  const path = join12(directory, entry.name);
-  if (entry.isDirectory()) return walkMarkdown(root, path);
-  return entry.isFile() && [".md", ".mdx"].includes(extname5(entry.name).toLowerCase()) ? [relative7(root, path).split(sep8).join("/")] : [];
+  const path = join13(directory, entry.name);
+  if (ignored.isIgnored(path, entry.isDirectory())) return [];
+  if (entry.isDirectory()) return walkMarkdown(root, path, ignored);
+  return entry.isFile() && [".md", ".mdx"].includes(extname5(entry.name).toLowerCase()) ? [relative8(root, path).split(sep9).join("/")] : [];
 });
 var localLink = /(!?)\[([^\]]*)\]\(([^)\s]+)(?:\s+["'][^)]*["'])?\)/g;
 var sortJson = (value) => Array.isArray(value) ? value.map(sortJson) : value && typeof value === "object" ? Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => [key, sortJson(item)])) : value;
 var createMarkdownLinkFixProposal = (root, options) => {
-  const projectRoot = realpathSync7.native(resolve13(root));
+  const projectRoot = realpathSync8.native(resolve14(root));
   const paths = walkMarkdown(projectRoot);
   const changes = [];
   for (const path of paths) {
-    const content = readFileSync14(join12(projectRoot, path), "utf8");
+    const content = readFileSync15(join13(projectRoot, path), "utf8");
     let next = content;
     for (const match of content.matchAll(localLink)) {
       const target2 = match[3];
       if (!target2 || match[1] === "!" || /^(?:[a-z]+:|\/|#)/i.test(target2)) continue;
       const targetPath = target2.split("#")[0]?.split("?")[0];
-      if (!targetPath || existsSync12(resolve13(projectRoot, dirname6(path), targetPath))) continue;
+      if (!targetPath || existsSync13(resolve14(projectRoot, dirname7(path), targetPath))) continue;
       const targetStem = basename7(targetPath, extname5(targetPath)).toLowerCase();
       const labelStem = (match[2] ?? "").trim().toLowerCase().replace(/[^a-z0-9]+/g, "");
       const candidates = paths.filter((candidate) => basename7(candidate, extname5(candidate)).toLowerCase() === targetStem || basename7(candidate, extname5(candidate)).toLowerCase().replace(/[^a-z0-9]+/g, "") === labelStem);
       if (candidates.length !== 1) continue;
-      let replacement = relative7(dirname6(path), candidates[0]).split(sep8).join("/");
+      let replacement = relative8(dirname7(path), candidates[0]).split(sep9).join("/");
       if (target2.startsWith("./") && !replacement.startsWith(".")) replacement = `./${replacement}`;
       next = next.replace(match[0], match[0].replace(target2, replacement));
     }
@@ -9460,13 +9580,13 @@ var createMarkdownLinkFixProposal = (root, options) => {
   return changes.length ? makeProposal(projectRoot, options, changes, ["Each replacement has exactly one Markdown target."], ["All corrected local Markdown links resolve."]) : void 0;
 };
 var createArtifactNormalizationProposal = (root, artifactPath, options) => {
-  const projectRoot = realpathSync7.native(resolve13(root));
-  const path = artifactPath.split(sep8).join("/");
+  const projectRoot = realpathSync8.native(resolve14(root));
+  const path = artifactPath.split(sep9).join("/");
   const absolute = containedPath(projectRoot, path);
   if (!absolute) return void 0;
   let before;
   try {
-    before = readFileSync14(absolute, "utf8");
+    before = readFileSync15(absolute, "utf8");
   } catch {
     return void 0;
   }
@@ -9477,7 +9597,7 @@ var createArtifactNormalizationProposal = (root, artifactPath, options) => {
   } catch {
     return void 0;
   }
-  return after === before ? void 0 : makeProposal(projectRoot, options, [{ path: relative7(projectRoot, absolute).split(sep8).join("/"), before, after }], ["The artifact contains valid JSON."], ["The artifact is valid canonical JSON with one trailing newline."]);
+  return after === before ? void 0 : makeProposal(projectRoot, options, [{ path: relative8(projectRoot, absolute).split(sep9).join("/"), before, after }], ["The artifact contains valid JSON."], ["The artifact is valid canonical JSON with one trailing newline."]);
 };
 var approveFixProposal = (proposalInput, approvedBy, approvedAt = (/* @__PURE__ */ new Date()).toISOString()) => {
   const proposal = FixProposalV1Schema.parse(proposalInput);
@@ -9495,7 +9615,7 @@ var applyFixProposal = (root, proposalInput, options = {}) => {
   if (proposal.approval.proposalHash !== bindingHash(proposal)) throw new Error("Approval is not bound to the exact proposal content.");
   if (options.currentRevision && options.currentRevision !== proposal.baseRevision) throw new Error("The repository revision changed since this proposal was created.");
   if (!proposal.changes?.length) throw new Error("This proposal has no executable changes.");
-  const projectRoot = realpathSync7.native(resolve13(root));
+  const projectRoot = realpathSync8.native(resolve14(root));
   const originals = /* @__PURE__ */ new Map();
   const affected = new Map(proposal.affectedFiles.map((file) => [file.path, file]));
   if (proposal.changes.some((change) => !affected.has(change.path) || affected.get(change.path)?.contentHash !== sha256NormalizedV1(change.before)) || affected.size !== proposal.changes.length) {
@@ -9503,29 +9623,29 @@ var applyFixProposal = (root, proposalInput, options = {}) => {
   }
   for (const file of proposal.affectedFiles) {
     const absolute = containedPath(projectRoot, file.path);
-    if (!absolute || !existsSync12(absolute)) throw new Error(`Affected file is unavailable or escapes the repository root: ${file.path}`);
-    const current = readFileSync14(absolute, "utf8");
+    if (!absolute || !existsSync13(absolute)) throw new Error(`Affected file is unavailable or escapes the repository root: ${file.path}`);
+    const current = readFileSync15(absolute, "utf8");
     if (sha256NormalizedV1(current) !== file.contentHash) throw new Error(`Affected file changed since proposal creation: ${file.path}`);
     originals.set(absolute, current);
   }
   try {
     for (const change of proposal.changes) {
-      const absolute = resolve13(projectRoot, change.path);
+      const absolute = resolve14(projectRoot, change.path);
       writeFileSync4(`${absolute}.docbridge-${process.pid}.tmp`, change.after, "utf8");
     }
     for (const change of proposal.changes) {
-      const absolute = resolve13(projectRoot, change.path);
+      const absolute = resolve14(projectRoot, change.path);
       renameSync2(`${absolute}.docbridge-${process.pid}.tmp`, absolute);
     }
     for (const change of proposal.changes) {
-      if (readFileSync14(resolve13(projectRoot, change.path), "utf8") !== change.after) throw new Error(`Postcondition failed for ${change.path}`);
+      if (readFileSync15(resolve14(projectRoot, change.path), "utf8") !== change.after) throw new Error(`Postcondition failed for ${change.path}`);
     }
     options.verify?.(proposal.changes.map((change) => change.path));
   } catch (error) {
     for (const [absolute, content] of originals) writeFileSync4(absolute, content, "utf8");
     for (const change of proposal.changes) {
-      const temp = `${resolve13(projectRoot, change.path)}.docbridge-${process.pid}.tmp`;
-      if (existsSync12(temp)) unlinkSync(temp);
+      const temp = `${resolve14(projectRoot, change.path)}.docbridge-${process.pid}.tmp`;
+      if (existsSync13(temp)) unlinkSync(temp);
     }
     throw error;
   }
@@ -9534,8 +9654,8 @@ var applyFixProposal = (root, proposalInput, options = {}) => {
 };
 
 // src/workflow/engine.ts
-import { appendFileSync, existsSync as existsSync13, mkdirSync as mkdirSync4, readFileSync as readFileSync15, renameSync as renameSync3, rmSync, writeFileSync as writeFileSync5 } from "fs";
-import { join as join13, relative as relative8, resolve as resolve14 } from "path";
+import { appendFileSync, existsSync as existsSync14, mkdirSync as mkdirSync4, readFileSync as readFileSync16, renameSync as renameSync3, rmSync, writeFileSync as writeFileSync5 } from "fs";
+import { join as join14, relative as relative9, resolve as resolve15 } from "path";
 var WORKFLOW_STAGES = ["collect", "normalize", "reconcile", "enrich", "evaluate", "report"];
 var OPTIONAL_WORKFLOW_STAGES = ["enrich"];
 var stageState = {
@@ -9546,7 +9666,7 @@ var stageState = {
   evaluate: "proposed",
   report: "delivered"
 };
-var defaultStateDir = (root) => join13(root, ".doc-bridge", "workflow");
+var defaultStateDir = (root) => join14(root, ".doc-bridge", "workflow");
 var atomicWrite = (path, value) => {
   const temp = `${path}.tmp-${process.pid}-${Date.now()}`;
   writeFileSync5(temp, `${JSON.stringify(value, null, 2)}
@@ -9554,10 +9674,10 @@ var atomicWrite = (path, value) => {
   renameSync3(temp, path);
 };
 var writeManifest = (stateDir, run2) => {
-  atomicWrite(join13(stateDir, "manifest.json"), run2);
+  atomicWrite(join14(stateDir, "manifest.json"), run2);
 };
 var appendTransition = (stateDir, transition2) => {
-  appendFileSync(join13(stateDir, "transitions.jsonl"), `${JSON.stringify(transition2)}
+  appendFileSync(join14(stateDir, "transitions.jsonl"), `${JSON.stringify(transition2)}
 `, "utf8");
 };
 var transition = (run2, to, reason) => {
@@ -9588,8 +9708,8 @@ var transition = (run2, to, reason) => {
 };
 var runId = () => `${Date.now()}-${process.pid}`;
 var stageInputHash = (options, stage, input) => sha256NormalizedV1({ stage, input, sourceRevision: options.sourceRevision, configurationHash: options.configurationHash, pipelineVersion: options.pipelineVersion ?? "1.0.0", analyzerVersions: options.analyzerVersions ?? {}, toolVersion: options.toolVersion ?? "1.0.0" });
-var stageArtifactPath = (stateDir, stage, inputHash) => join13(stateDir, "artifacts", `${stage}-${inputHash}.json`);
-var readArtifact = (path) => JSON.parse(readFileSync15(path, "utf8"));
+var stageArtifactPath = (stateDir, stage, inputHash) => join14(stateDir, "artifacts", `${stage}-${inputHash}.json`);
+var readArtifact = (path) => JSON.parse(readFileSync16(path, "utf8"));
 var readVerifiedArtifact = (path, stage, step) => {
   const artifact2 = readArtifact(path);
   if (artifact2.type !== "workflow-step-artifact" || artifact2.stage !== stage || artifact2.inputHash !== step.inputHash) throw new Error(`Invalid workflow artifact for stage "${stage}".`);
@@ -9597,8 +9717,8 @@ var readVerifiedArtifact = (path, stage, step) => {
   return artifact2;
 };
 var stepArtifactPath = (stateDir, step) => {
-  const path = resolve14(stateDir, step.artifactRefs?.[0] ?? "");
-  const pathRelativeToState = relative8(stateDir, path);
+  const path = resolve15(stateDir, step.artifactRefs?.[0] ?? "");
+  const pathRelativeToState = relative9(stateDir, path);
   if (pathRelativeToState.startsWith("..") || pathRelativeToState.startsWith("/")) throw new Error(`Workflow artifact escapes state directory for stage "${step.name}".`);
   return path;
 };
@@ -9608,13 +9728,13 @@ var stepOutput = (stateDir, run2, stage) => {
   return readVerifiedArtifact(stepArtifactPath(stateDir, step), stage, step).value;
 };
 var acquireLock = (stateDir) => {
-  const lock = join13(stateDir, ".lock");
+  const lock = join14(stateDir, ".lock");
   try {
     mkdirSync4(lock);
   } catch {
-    const ownerPath = join13(lock, "owner.json");
+    const ownerPath = join14(lock, "owner.json");
     try {
-      const owner = JSON.parse(readFileSync15(ownerPath, "utf8"));
+      const owner = JSON.parse(readFileSync16(ownerPath, "utf8"));
       if (typeof owner.pid === "number") process.kill(owner.pid, 0);
       throw new Error(`Workflow is already running (pid ${owner.pid ?? "unknown"}).`);
     } catch (error) {
@@ -9623,13 +9743,13 @@ var acquireLock = (stateDir) => {
       mkdirSync4(lock);
     }
   }
-  writeFileSync5(join13(lock, "owner.json"), JSON.stringify({ pid: process.pid, startedAt: (/* @__PURE__ */ new Date()).toISOString() }), "utf8");
+  writeFileSync5(join14(lock, "owner.json"), JSON.stringify({ pid: process.pid, startedAt: (/* @__PURE__ */ new Date()).toISOString() }), "utf8");
   return () => rmSync(lock, { recursive: true, force: true });
 };
 var loadManifest = (stateDir) => {
-  const path = join13(stateDir, "manifest.json");
-  if (!existsSync13(path)) return void 0;
-  return WorkflowRunV1Schema.parse(JSON.parse(readFileSync15(path, "utf8")));
+  const path = join14(stateDir, "manifest.json");
+  if (!existsSync14(path)) return void 0;
+  return WorkflowRunV1Schema.parse(JSON.parse(readFileSync16(path, "utf8")));
 };
 var baseRun = (options, stateDir, supersedes) => {
   const inputHash = sha256NormalizedV1({ sourceRevision: options.sourceRevision, configurationHash: options.configurationHash, pipelineVersion: options.pipelineVersion ?? "1.0.0", analyzerVersions: options.analyzerVersions ?? {}, toolVersion: options.toolVersion ?? "1.0.0" });
@@ -9638,7 +9758,7 @@ var baseRun = (options, stateDir, supersedes) => {
     schemaVersion: 1,
     contentHash: "0".repeat(64),
     contentHashAlgo: "sha256-normalized-v1",
-    project: { name: resolve14(options.root).split("/").pop() ?? "project", root: "." },
+    project: { name: resolve15(options.root).split("/").pop() ?? "project", root: "." },
     sourceRevision: options.sourceRevision,
     sourceRevisionKind: "content",
     configurationHash: options.configurationHash,
@@ -9649,16 +9769,16 @@ var baseRun = (options, stateDir, supersedes) => {
     state: "created",
     steps: WORKFLOW_STAGES.map((name) => ({ name, status: "pending", inputHash })),
     transitions: [{ from: null, to: "created", at: (/* @__PURE__ */ new Date()).toISOString() }],
-    artifactRefs: [relative8(resolve14(options.root), stateDir), ...supersedes ? [`supersedes:${supersedes}`] : []]
+    artifactRefs: [relative9(resolve15(options.root), stateDir), ...supersedes ? [`supersedes:${supersedes}`] : []]
   });
 };
 var withHash = (run2) => WorkflowRunV1Schema.parse({ ...run2, contentHash: contentHashForArtifactV1(run2) });
 var sameInputs = (run2, options) => run2.sourceRevision === options.sourceRevision && run2.configurationHash === options.configurationHash && run2.pipelineVersion === (options.pipelineVersion ?? "1.0.0") && sha256NormalizedV1(run2.analyzerVersions) === sha256NormalizedV1({ ...options.analyzerVersions ?? {}, workflow: options.toolVersion ?? "1.0.0" });
 var selectedStages = (stage) => stage && stage !== "all" ? [stage] : WORKFLOW_STAGES;
 var runWorkflow = (options) => {
-  const root = resolve14(options.root);
-  const stateDir = resolve14(root, options.stateDir ?? defaultStateDir(root));
-  mkdirSync4(join13(stateDir, "artifacts"), { recursive: true });
+  const root = resolve15(options.root);
+  const stateDir = resolve15(root, options.stateDir ?? defaultStateDir(root));
+  mkdirSync4(join14(stateDir, "artifacts"), { recursive: true });
   const release = acquireLock(stateDir);
   try {
     let run2 = loadManifest(stateDir);
@@ -9697,8 +9817,8 @@ var runWorkflow = (options) => {
       const input = options.inputs?.[stage] ?? previousOutput;
       const inputHash = stageInputHash(options, stage, input);
       const existing = run2.steps.find((step) => step.name === stage);
-      const artifactPath = existing?.artifactRefs?.[0] && existing.inputHash === inputHash ? resolve14(stateDir, existing.artifactRefs[0]) : stageArtifactPath(stateDir, stage, inputHash);
-      if (existing?.status === "completed" && existing.inputHash === inputHash && existing.outputHash && existsSync13(artifactPath)) {
+      const artifactPath = existing?.artifactRefs?.[0] && existing.inputHash === inputHash ? resolve15(stateDir, existing.artifactRefs[0]) : stageArtifactPath(stateDir, stage, inputHash);
+      if (existing?.status === "completed" && existing.inputHash === inputHash && existing.outputHash && existsSync14(artifactPath)) {
         try {
           previousOutput = readVerifiedArtifact(artifactPath, stage, existing).value;
         } catch (error) {
@@ -9728,14 +9848,14 @@ var runWorkflow = (options) => {
         const value = handler({ root, stage, input, previousOutput });
         const outputHash = sha256NormalizedV1(value);
         const artifact2 = { type: "workflow-step-artifact", stage, inputHash, outputHash, value };
-        mkdirSync4(join13(stateDir, "artifacts"), { recursive: true });
-        if (existsSync13(artifactPath)) {
+        mkdirSync4(join14(stateDir, "artifacts"), { recursive: true });
+        if (existsSync14(artifactPath)) {
           const existingArtifact = readArtifact(artifactPath);
           if (existingArtifact.outputHash !== outputHash) throw new Error(`Immutable workflow artifact collision for stage "${stage}".`);
         } else {
           atomicWrite(artifactPath, artifact2);
         }
-        const ref = relative8(stateDir, artifactPath);
+        const ref = relative9(stateDir, artifactPath);
         const completedStep = { name: stage, status: "completed", inputHash, outputHash, artifactRefs: [ref] };
         run2 = withHash({ ...run2, steps: run2.steps.map((step) => step.name === stage ? completedStep : step) });
         writeManifest(stateDir, run2);
@@ -9755,15 +9875,15 @@ var runWorkflow = (options) => {
         run2 = complete;
       }
       writeManifest(stateDir, run2);
-      if (run2.state === "delivered") atomicWrite(join13(stateDir, "last-known-good.json"), { runId: run2.runId, manifestHash: run2.contentHash, report: run2.steps.find((step) => step.name === "report")?.artifactRefs?.[0] });
+      if (run2.state === "delivered") atomicWrite(join14(stateDir, "last-known-good.json"), { runId: run2.runId, manifestHash: run2.contentHash, report: run2.steps.find((step) => step.name === "report")?.artifactRefs?.[0] });
     }
     return { run: run2, stateDir, reusedStages };
   } finally {
     release();
   }
 };
-var loadWorkflowManifest = (stateDir) => WorkflowRunV1Schema.parse(JSON.parse(readFileSync15(join13(resolve14(stateDir), "manifest.json"), "utf8")));
-var loadWorkflowStepOutput = (stateDir, stage) => stepOutput(resolve14(stateDir), loadWorkflowManifest(stateDir), stage);
+var loadWorkflowManifest = (stateDir) => WorkflowRunV1Schema.parse(JSON.parse(readFileSync16(join14(resolve15(stateDir), "manifest.json"), "utf8")));
+var loadWorkflowStepOutput = (stateDir, stage) => stepOutput(resolve15(stateDir), loadWorkflowManifest(stateDir), stage);
 
 // src/study/metrics.ts
 import { z as z13 } from "zod";
@@ -10367,11 +10487,11 @@ var resolvedOptions = (options) => {
   const config = RulesConfigSchema.parse(options.config ?? {});
   const mode = options.preset ?? config.mode ?? "default";
   const severity = { ...config.severity, ...options.severity };
-  const ignore = /* @__PURE__ */ new Set([...config.ignore ?? [], ...options.ignore ?? []]);
+  const ignore2 = /* @__PURE__ */ new Set([...config.ignore ?? [], ...options.ignore ?? []]);
   return {
     mode,
     severity,
-    ignore,
+    ignore: ignore2,
     criticalEntities: options.criticalEntities ?? config.criticalEntities ?? [],
     criticalPaths: options.criticalPaths ?? config.criticalPaths ?? [],
     warningThresholds: { ...config.warningThresholds, ...options.warningThresholds }
@@ -10486,11 +10606,11 @@ function formatEcosystemLlmsSection(options) {
 }
 
 // src/gates/run-gates.ts
-import { readFileSync as readFileSync18 } from "fs";
+import { readFileSync as readFileSync19 } from "fs";
 
 // src/conformance/documentation-standard-v1.ts
-import { closeSync as closeSync2, existsSync as existsSync14, fstatSync as fstatSync2, openSync as openSync2, readFileSync as readFileSync16, realpathSync as realpathSync8 } from "fs";
-import { isAbsolute as isAbsolute5, relative as relative9, resolve as resolve15, sep as sep9 } from "path";
+import { closeSync as closeSync2, existsSync as existsSync15, fstatSync as fstatSync2, openSync as openSync2, readFileSync as readFileSync17, realpathSync as realpathSync9 } from "fs";
+import { isAbsolute as isAbsolute6, relative as relative10, resolve as resolve16, sep as sep10 } from "path";
 
 // src/conformance/ecosystem-contract.ts
 import { z as z15 } from "zod";
@@ -10540,10 +10660,9 @@ var ManifestSchema = z15.object({
   schemaVersion: z15.literal(2),
   parentBrand: z15.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema }).passthrough(),
   products: z15.array(ProductSchema).min(1),
-  // Historical four-product shim or full seven-product projection of products[].
-  properties: z15.array(LegacyPropertySchema).refine((value) => value.length === 4 || value.length === 7, {
-    message: "must project either the legacy four products or the full seven-product catalog"
-  }),
+  // Deprecated compatibility shim: when present, every entry projects one products[] record.
+  // Membership is whatever the canonical manifest lists; no product is required by name.
+  properties: z15.array(LegacyPropertySchema).optional(),
   builder: z15.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema, url: HttpsUrlSchema }).passthrough().optional()
 }).passthrough();
 var EvidenceSchema2 = z15.discriminatedUnion("type", [
@@ -10577,16 +10696,6 @@ var ClaimsSchema = z15.object({
   manifestSchemaVersion: z15.literal(2),
   products: z15.array(ClaimProductSchema)
 }).passthrough();
-var LEGACY_FOUR_PRODUCT_IDS = ["agentskit", "akos", "playbook", "registry"];
-var FULL_SEVEN_PRODUCT_IDS = [
-  "agentskit",
-  "registry",
-  "agentskit-chat",
-  "playbook",
-  "doc-bridge",
-  "code-review",
-  "akos"
-];
 var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
   const manifest = ManifestSchema.parse(manifestInput);
   const claims = ClaimsSchema.parse(claimsInput);
@@ -10612,12 +10721,14 @@ var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
       if (!products.has(nextId)) throw new Error(`Product ${product.id} references unknown product ${nextId}.`);
     }
   }
-  const propertyIds = manifest.properties.length === 7 ? FULL_SEVEN_PRODUCT_IDS : LEGACY_FOUR_PRODUCT_IDS;
-  for (const [index, id] of propertyIds.entries()) {
-    const legacy = manifest.properties[index];
+  const propertyIds = /* @__PURE__ */ new Set();
+  for (const [index, legacy] of (manifest.properties ?? []).entries()) {
+    const id = legacy.id;
     const product = products.get(id);
-    if (!legacy || !product || legacy.id !== id || !product.surfaces.home) {
-      throw new Error(`Legacy property ${index} must project product ${id}.`);
+    if (propertyIds.has(id)) throw new Error(`Legacy property ${id} is listed more than once.`);
+    propertyIds.add(id);
+    if (!product || !product.surfaces.home) {
+      throw new Error(`Legacy property ${index} (${id}) must project a manifest product with a home surface.`);
     }
     const expected = {
       name: product.name,
@@ -10672,15 +10783,15 @@ var DOCUMENTATION_STANDARD_V1_ID = "documentation-standard-v1";
 var DOCUMENTATION_STANDARD_V1_STATUS = "stable";
 var MAX_TEXT_EVIDENCE_BYTES = 4 * 1024 * 1024;
 var safePath = (root, path) => {
-  const rootAbs = realpathSync8.native(resolve15(root));
-  const unresolved = resolve15(rootAbs, path);
-  const unresolvedRel = relative9(rootAbs, unresolved);
-  if (isAbsolute5(unresolvedRel) || unresolvedRel === ".." || unresolvedRel.startsWith(`..${sep9}`)) return void 0;
-  if (!existsSync14(unresolved)) return unresolved;
+  const rootAbs = realpathSync9.native(resolve16(root));
+  const unresolved = resolve16(rootAbs, path);
+  const unresolvedRel = relative10(rootAbs, unresolved);
+  if (isAbsolute6(unresolvedRel) || unresolvedRel === ".." || unresolvedRel.startsWith(`..${sep10}`)) return void 0;
+  if (!existsSync15(unresolved)) return unresolved;
   try {
-    const abs = realpathSync8.native(unresolved);
-    const rel = relative9(rootAbs, abs);
-    return !isAbsolute5(rel) && rel !== ".." && !rel.startsWith(`..${sep9}`) ? abs : void 0;
+    const abs = realpathSync9.native(unresolved);
+    const rel = relative10(rootAbs, abs);
+    return !isAbsolute6(rel) && rel !== ".." && !rel.startsWith(`..${sep10}`) ? abs : void 0;
   } catch {
     return void 0;
   }
@@ -10708,7 +10819,7 @@ var fileEvidence = (root, path, options) => {
       return {
         exists: true,
         content: "",
-        evidence: { path: toPosix(relative9(resolve15(root), abs)) || ".", detail: "File exists and is non-empty." }
+        evidence: { path: toPosix(relative10(resolve16(root), abs)) || ".", detail: "File exists and is non-empty." }
       };
     }
     if (stat.size > MAX_TEXT_EVIDENCE_BYTES) {
@@ -10718,12 +10829,12 @@ var fileEvidence = (root, path, options) => {
         evidence: { path, detail: `Text evidence exceeds ${MAX_TEXT_EVIDENCE_BYTES} bytes.` }
       };
     }
-    const content = readFileSync16(fd, "utf8");
+    const content = readFileSync17(fd, "utf8");
     return {
       exists: content.trim().length > 0,
       content,
       evidence: {
-        path: toPosix(relative9(resolve15(root), abs)) || ".",
+        path: toPosix(relative10(resolve16(root), abs)) || ".",
         detail: content.trim().length > 0 ? "File exists and is non-empty." : "File is empty."
       }
     };
@@ -10765,7 +10876,7 @@ var humanDocsRule = (root, config) => {
     passed: docs.length > 0,
     message: docs.length > 0 ? `Found ${docs.length} human document(s).` : "No human documentation was discovered.",
     evidence: docs.slice(0, 10).map((doc) => ({
-      path: toPosix(relative9(resolve15(root), doc.path)),
+      path: toPosix(relative10(resolve16(root), doc.path)),
       detail: `Human route: ${doc.url}`
     })),
     remediation: {
@@ -10776,10 +10887,10 @@ var humanDocsRule = (root, config) => {
 };
 var llmsRule = (root, config, options, generated) => {
   const llmsPath = config.index?.llmsTxt?.outFile ?? "llms.txt";
-  const llmsKey = safePath(root, llmsPath) ?? resolve15(root, llmsPath);
+  const llmsKey = safePath(root, llmsPath) ?? resolve16(root, llmsPath);
   const rawSources = /* @__PURE__ */ new Map();
   for (const path of options.rawSources ?? []) {
-    const key = safePath(root, path) ?? resolve15(root, path);
+    const key = safePath(root, path) ?? resolve16(root, path);
     if (key !== llmsKey && !rawSources.has(key)) rawSources.set(key, path);
   }
   const paths = [llmsPath, ...rawSources.values()];
@@ -10918,11 +11029,11 @@ var linksRule = (root, options) => {
   for (const link of links) {
     const sources = link.paths.map((path) => ({ path, file: fileEvidence(root, path) }));
     const matches2 = sources.filter(({ file }) => file.exists && file.content.includes(link.url));
-    const canonical = contract.urls.has(normalizedUrl(link.url));
-    if (matches2.length === 0 || !canonical) passed = false;
+    const canonical2 = contract.urls.has(normalizedUrl(link.url));
+    if (matches2.length === 0 || !canonical2) passed = false;
     evidence2.push({
       path: sources.map((source) => source.path).join(", "),
-      detail: matches2.length === 0 ? `Missing ${link.url}` : canonical ? `Found canonical ecosystem URL ${link.url}` : `Found ${link.url}, but it is absent from the canonical ecosystem manifest.`
+      detail: matches2.length === 0 ? `Missing ${link.url}` : canonical2 ? `Found canonical ecosystem URL ${link.url}` : `Found ${link.url}, but it is absent from the canonical ecosystem manifest.`
     });
   }
   return {
@@ -11030,8 +11141,8 @@ var formatDocumentationStandardText = (report) => [
 ];
 
 // src/query/load-index.ts
-import { existsSync as existsSync15, readFileSync as readFileSync17 } from "fs";
-import { join as join14, resolve as resolve16 } from "path";
+import { existsSync as existsSync16, readFileSync as readFileSync18 } from "fs";
+import { join as join15, resolve as resolve17 } from "path";
 var IndexNotFoundError = class extends Error {
   constructor(path) {
     super(`Missing index at ${path}. Run: ak-docs index`);
@@ -11052,11 +11163,11 @@ var IndexStaleError = class extends Error {
   actual;
   expected;
 };
-var indexFilePath = (root, config) => join14(root, config.index?.outFile ?? ".doc-bridge/index.json");
+var indexFilePath = (root, config) => join15(root, config.index?.outFile ?? ".doc-bridge/index.json");
 var loadDocBridgeIndex = (root, config) => {
   const path = indexFilePath(root, config);
-  if (!existsSync15(path)) throw new IndexNotFoundError(path);
-  const raw = JSON.parse(readFileSync17(path, "utf8"));
+  if (!existsSync16(path)) throw new IndexNotFoundError(path);
+  const raw = JSON.parse(readFileSync18(path, "utf8"));
   return parseDocBridgeIndex(raw);
 };
 var loadFreshDocBridgeIndex = (root, config) => {
@@ -11074,7 +11185,7 @@ var loadFreshDocBridgeIndex = (root, config) => {
   }
   return index;
 };
-var resolveRoot = (cwd) => resolve16(cwd ?? process.cwd());
+var resolveRoot = (cwd) => resolve17(cwd ?? process.cwd());
 
 // src/gates/run-gates.ts
 var RESERVED_GATE_IDS = /* @__PURE__ */ new Set(["link-rot", "routing-currency", "bootstrap-size"]);
@@ -11120,7 +11231,7 @@ var runGate = (root, config, id) => {
     return {
       id,
       ok: false,
-      message: `${result.ignored.length} indexed path(s) are ignored by Git, so a clean checkout builds a different index. Add them to safety.exclude.`,
+      message: `${result.ignored.length} indexed path(s) are ignored by Git, so a clean checkout builds a different index. Rebuild the index (scans skip ignored paths) or add them to safety.exclude.`,
       expected: "every indexed path is committed",
       actual: sample.join(", ")
     };
@@ -11179,7 +11290,7 @@ var runOkfTypeGate = (root, config) => {
   const required = config.corpus.agent.okf?.requireType ?? config.gates?.preset === "strict";
   if (!required) return { id: "okf-type", ok: true, message: "OKF type frontmatter not required" };
   const allowed = config.corpus.agent.okf?.allowedTypes;
-  const bad = scanAgentCorpus(root, config).filter((doc) => doc.path !== config.corpus.agent.index).map((doc) => ({ path: doc.path, type: frontmatterType(readFileSync18(doc.absPath, "utf8")) })).filter((doc) => !doc.type || allowed && !allowed.includes(doc.type));
+  const bad = scanAgentCorpus(root, config).filter((doc) => doc.path !== config.corpus.agent.index).map((doc) => ({ path: doc.path, type: frontmatterType(readFileSync19(doc.absPath, "utf8")) })).filter((doc) => !doc.type || allowed && !allowed.includes(doc.type));
   if (bad.length) {
     return {
       id: "okf-type",
@@ -11253,7 +11364,7 @@ var runDocsStyleGate = (root, config) => {
   }
   const bad = scanAgentCorpus(root, config).filter((doc) => doc.path !== config.corpus.agent.index).map((doc) => ({
     path: doc.path,
-    missing: missingStyleRules(readFileSync18(doc.absPath, "utf8"), required)
+    missing: missingStyleRules(readFileSync19(doc.absPath, "utf8"), required)
   })).filter((doc) => doc.missing.length > 0);
   if (bad.length) {
     return {
@@ -11298,8 +11409,8 @@ var resolveGateIds = (config) => {
 };
 
 // src/mcp/server.ts
-import { mkdirSync as mkdirSync6, readFileSync as readFileSync21, realpathSync as realpathSync9, writeFileSync as writeFileSync7 } from "fs";
-import { join as join17, relative as relative10, resolve as resolve18 } from "path";
+import { mkdirSync as mkdirSync6, readFileSync as readFileSync22, realpathSync as realpathSync10, writeFileSync as writeFileSync7 } from "fs";
+import { join as join18, relative as relative11, resolve as resolve19 } from "path";
 import { z as z16, ZodError } from "zod";
 
 // src/query/search.ts
@@ -11570,15 +11681,15 @@ ${document.source ? `Source: ${document.source}
 ` : ""}${document.content}`).join("\n\n");
 
 // src/memory/ingest.ts
-import { existsSync as existsSync16, readFileSync as readFileSync19 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync20 } from "fs";
+import { join as join16 } from "path";
 var memoryFact = (raw, id) => firstParagraph(raw) ?? firstHeading(raw) ?? id;
 var relativePath2 = (root, abs) => toPosix(abs).replace(`${toPosix(root)}/`, "");
 var ingestMarkdownDir = (root, dir, source, confidence) => {
-  if (!existsSync16(dir)) return [];
-  return walkFiles(dir, { extensions: [".md", ".mdc"] }).map((abs) => {
+  if (!existsSync17(dir)) return [];
+  return walkFiles(dir, { extensions: [".md", ".mdc"], respectIgnore: false }).map((abs) => {
     const rel = relativePath2(root, abs);
-    const raw = readFileSync19(abs, "utf8");
+    const raw = readFileSync20(abs, "utf8");
     const id = slugFromPath(rel);
     return {
       schemaVersion: 1,
@@ -11593,10 +11704,10 @@ var ingestMarkdownDir = (root, dir, source, confidence) => {
   });
 };
 var ingestCursorRules = (root) => {
-  const dir = join15(root, ".cursor", "rules");
+  const dir = join16(root, ".cursor", "rules");
   return ingestMarkdownDir(root, dir, "cursor", 0.6);
 };
-var ingestAgentMemory = (root) => ingestMarkdownDir(root, join15(root, ".agent-memory"), "agent-memory", 0.7);
+var ingestAgentMemory = (root) => ingestMarkdownDir(root, join16(root, ".agent-memory"), "agent-memory", 0.7);
 var ingestMemoryCandidates = (root) => [
   ...ingestAgentMemory(root),
   ...ingestCursorRules(root)
@@ -12234,8 +12345,8 @@ var formatKnowledgeLookupText = (response) => {
 };
 
 // src/enrich/approvals.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync5, readFileSync as readFileSync20, readdirSync as readdirSync5, renameSync as renameSync4, writeFileSync as writeFileSync6 } from "fs";
-import { join as join16, resolve as resolve17 } from "path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync5, readFileSync as readFileSync21, readdirSync as readdirSync5, renameSync as renameSync4, writeFileSync as writeFileSync6 } from "fs";
+import { join as join17, resolve as resolve18 } from "path";
 
 // src/intelligence/peers.ts
 var PeerMissingError = class extends Error {
@@ -12287,7 +12398,7 @@ var layer1InstallHint = () => LAYER1_INSTALL;
 var APPROVALS_DIR = ".doc-bridge/approvals";
 var ENRICHMENT_APPROVAL_GATE = "doc-bridge.enrichment";
 var FIX_APPROVAL_GATE = "doc-bridge.fix";
-var approvalsDir = (root) => join16(resolve17(root), APPROVALS_DIR);
+var approvalsDir = (root) => join17(resolve18(root), APPROVALS_DIR);
 var safeId = (id) => {
   if (!/^[a-f0-9]{16,64}$/.test(id)) throw new Error(`Approval ids are content hashes; received "${id}".`);
   return id;
@@ -12295,7 +12406,7 @@ var safeId = (id) => {
 var enrichmentApprovalId = (proposalId, targetContentHash) => sha256NormalizedV1({ proposalId, targetContentHash });
 var fixApprovalId = (proposalId, proposalHash) => sha256NormalizedV1({ proposalId, proposalHash });
 var createFileApprovalStore = (dir) => {
-  const pathFor = (id) => join16(dir, `${safeId(id)}.json`);
+  const pathFor = (id) => join17(dir, `${safeId(id)}.json`);
   const write = (approval) => {
     mkdirSync5(dir, { recursive: true });
     const path = pathFor(approval.id);
@@ -12306,9 +12417,9 @@ var createFileApprovalStore = (dir) => {
   };
   const read = (id) => {
     const path = pathFor(id);
-    if (!existsSync17(path)) return null;
+    if (!existsSync18(path)) return null;
     try {
-      return JSON.parse(readFileSync20(path, "utf8"));
+      return JSON.parse(readFileSync21(path, "utf8"));
     } catch {
       return null;
     }
@@ -12330,10 +12441,10 @@ var createFileApprovalStore = (dir) => {
   };
 };
 var listApprovals = (dir) => {
-  if (!existsSync17(dir)) return [];
+  if (!existsSync18(dir)) return [];
   return readdirSync5(dir).filter((name) => /^[a-f0-9]{16,64}\.json$/.test(name)).sort().flatMap((name) => {
     try {
-      return [JSON.parse(readFileSync20(join16(dir, name), "utf8"))];
+      return [JSON.parse(readFileSync21(join17(dir, name), "utf8"))];
     } catch {
       return [];
     }
@@ -12664,16 +12775,16 @@ var findDocPath = (index, args) => {
   return doc.path;
 };
 var resolveDocPath = (root, relPath) => {
-  const rootAbs = realpathSync9.native(root);
-  const unresolved = resolve18(rootAbs, relPath);
-  const unresolvedRel = relative10(rootAbs, unresolved);
+  const rootAbs = realpathSync10.native(root);
+  const unresolved = resolve19(rootAbs, relPath);
+  const unresolvedRel = relative11(rootAbs, unresolved);
   if (unresolvedRel.startsWith("..")) throw new Error("doc.get path escapes project root");
-  const abs = realpathSync9.native(unresolved);
-  const rel = relative10(rootAbs, abs);
+  const abs = realpathSync10.native(unresolved);
+  const rel = relative11(rootAbs, abs);
   if (rel.startsWith("..")) throw new Error("doc.get path escapes project root");
   return abs;
 };
-var workflowStateDir = (ctx) => resolve18(ctx.root, ctx.config.workflow?.stateDir ?? ".doc-bridge/workflow");
+var workflowStateDir = (ctx) => resolve19(ctx.root, ctx.config.workflow?.stateDir ?? ".doc-bridge/workflow");
 var workflowRun = (ctx) => loadWorkflowManifest(workflowStateDir(ctx));
 var ensureLatestRun = (ctx, runId2) => {
   const run2 = workflowRun(ctx);
@@ -12689,17 +12800,17 @@ var workflowReport = (ctx, runId2) => {
   ensureLatestRun(ctx, runId2);
   return parseReconciliationReport(loadWorkflowStepOutput(workflowStateDir(ctx), "reconcile"));
 };
-var proposalPath = (ctx) => join17(ctx.root, ".doc-bridge", "proposal.json");
+var proposalPath = (ctx) => join18(ctx.root, ".doc-bridge", "proposal.json");
 var readSavedProposal = (ctx, input) => {
   if (input !== void 0) return FixProposalV1Schema.parse(input);
   try {
-    return FixProposalV1Schema.parse(JSON.parse(readFileSync21(proposalPath(ctx), "utf8")));
+    return FixProposalV1Schema.parse(JSON.parse(readFileSync22(proposalPath(ctx), "utf8")));
   } catch {
     throw new Error(`No saved fix proposal at ${proposalPath(ctx)}.`);
   }
 };
 var saveProposal = (ctx, proposal) => {
-  mkdirSync6(join17(ctx.root, ".doc-bridge"), { recursive: true });
+  mkdirSync6(join18(ctx.root, ".doc-bridge"), { recursive: true });
   writeFileSync7(proposalPath(ctx), `${JSON.stringify(proposal, null, 2)}
 `, "utf8");
 };
@@ -12762,7 +12873,7 @@ var handleMcpRequest = (ctx, request) => {
     }
     if (name === "doc.get") {
       const relPath = findDocPath(index(), parseToolArgs("doc.get", DocGetArgsSchema, args));
-      return textResult(readFileSync21(resolveDocPath(ctx.root, relPath), "utf8"));
+      return textResult(readFileSync22(resolveDocPath(ctx.root, relPath), "utf8"));
     }
     if (name === "gate.status") return textResult(runGates(ctx.root, ctx.config));
     if (name === "retriever.query") {
@@ -12951,9 +13062,9 @@ var startMcpStdioServer = (ctx) => {
 };
 
 // src/mcp/install.ts
-import { existsSync as existsSync18, mkdirSync as mkdirSync7, readFileSync as readFileSync22, writeFileSync as writeFileSync8 } from "fs";
+import { existsSync as existsSync19, mkdirSync as mkdirSync7, readFileSync as readFileSync23, writeFileSync as writeFileSync8 } from "fs";
 import { homedir } from "os";
-import { dirname as dirname7, join as join18, resolve as resolve19 } from "path";
+import { dirname as dirname8, join as join19, resolve as resolve20 } from "path";
 var SERVER_NAME = "ak-docs";
 var mcpServerEntry = (root) => ({
   command: "npx",
@@ -12961,26 +13072,26 @@ var mcpServerEntry = (root) => ({
   cwd: root
 });
 var readJson2 = (path) => {
-  if (!existsSync18(path)) return {};
+  if (!existsSync19(path)) return {};
   try {
-    const parsed = JSON.parse(readFileSync22(path, "utf8"));
+    const parsed = JSON.parse(readFileSync23(path, "utf8"));
     return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
   } catch {
     return {};
   }
 };
 var writeJson = (path, value) => {
-  mkdirSync7(dirname7(path), { recursive: true });
+  mkdirSync7(dirname8(path), { recursive: true });
   writeFileSync8(path, `${JSON.stringify(value, null, 2)}
 `, "utf8");
 };
 var resolveTargetPath = (target2, root) => {
-  if (target2 === "cursor") return resolve19(root, ".cursor", "mcp.json");
-  return join18(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+  if (target2 === "cursor") return resolve20(root, ".cursor", "mcp.json");
+  return join19(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
 };
 var installMcpConfig = (root, target2) => {
   const configPath = resolveTargetPath(target2, root);
-  const created = !existsSync18(configPath);
+  const created = !existsSync19(configPath);
   const existing = readJson2(configPath);
   const servers = existing.mcpServers && typeof existing.mcpServers === "object" && !Array.isArray(existing.mcpServers) ? { ...existing.mcpServers } : {};
   servers[SERVER_NAME] = mcpServerEntry(root);
@@ -13005,8 +13116,8 @@ var installMcpConfig = (root, target2) => {
 var mcpSnippet = (root) => JSON.stringify({ mcpServers: { [SERVER_NAME]: mcpServerEntry(root) } }, null, 2);
 
 // src/doctor/run-doctor.ts
-import { existsSync as existsSync19, readFileSync as readFileSync23 } from "fs";
-import { resolve as resolve20 } from "path";
+import { existsSync as existsSync20, readFileSync as readFileSync24 } from "fs";
+import { resolve as resolve21 } from "path";
 
 // src/bench/retrieval.ts
 import { z as z17 } from "zod";
@@ -13333,11 +13444,11 @@ var measureConnectivity = (index) => {
 };
 var measureBenchmark = (root, config, index) => {
   const suite = config.retrieval?.benchmark?.suite ?? DEFAULT_RETRIEVAL_SUITE;
-  const suitePath = resolve20(root, suite);
-  if (!existsSync19(suitePath)) return { status: "not-analyzed", suite, reason: `No retrieval suite at ${suite}` };
+  const suitePath = resolve21(root, suite);
+  if (!existsSync20(suitePath)) return { status: "not-analyzed", suite, reason: `No retrieval suite at ${suite}` };
   if (!index.projection) return { status: "not-analyzed", suite, reason: "The index carries no retrieval projection. Run: ak-docs index" };
   try {
-    const parsed = parseRetrievalSuite(JSON.parse(readFileSync23(suitePath, "utf8")));
+    const parsed = parseRetrievalSuite(JSON.parse(readFileSync24(suitePath, "utf8")));
     const result = runRetrievalBench({ index, suite: parsed });
     return {
       status: "measured",
@@ -13585,23 +13696,23 @@ var formatDoctorText = (report) => {
 };
 
 // src/index-builder/watch-index.ts
-import { existsSync as existsSync20, watch } from "fs";
-import { dirname as dirname8, resolve as resolve21 } from "path";
+import { existsSync as existsSync21, watch } from "fs";
+import { dirname as dirname9, resolve as resolve22 } from "path";
 var WATCH_PATTERN = /\.(md|mdx|json|ya?ml|mdc)$/i;
 var NX_MANIFEST_PATTERN = /(^|[/\\])(project|package)\.json$/i;
 var collectWatchRoots = (root, config, configPath) => {
   const roots = /* @__PURE__ */ new Set();
-  roots.add(resolve21(root, config.corpus.agent.root));
+  roots.add(resolve22(root, config.corpus.agent.root));
   const humanSources = config.corpus.human ? Array.isArray(config.corpus.human) ? config.corpus.human : [config.corpus.human] : [];
   for (const source of humanSources) {
     const humanOpts = source.options ?? {};
     for (const key of ["contentDir", "docsDir", "root", "srcDir"]) {
       const value = humanOpts[key];
-      if (typeof value === "string" && value.length) roots.add(resolve21(root, value));
+      if (typeof value === "string" && value.length) roots.add(resolve22(root, value));
     }
   }
-  if (configPath) roots.add(dirname8(resolve21(configPath)));
-  return [...roots].filter((dir) => existsSync20(dir));
+  if (configPath) roots.add(dirname9(resolve22(configPath)));
+  return [...roots].filter((dir) => existsSync21(dir));
 };
 var watchDocBridgeIndex = (opts) => {
   const debounceMs = opts.debounceMs ?? 350;
@@ -13642,15 +13753,15 @@ var watchDocBridgeIndex = (opts) => {
       rebuild();
     });
   }
-  const nxRoot = resolve21(opts.root);
-  if (opts.config.routing?.plugin === "nx" && existsSync20(nxRoot)) {
+  const nxRoot = resolve22(opts.root);
+  if (opts.config.routing?.plugin === "nx" && existsSync21(nxRoot)) {
     watch(nxRoot, { recursive: true }, (_event, filename) => {
       if (!filename || !NX_MANIFEST_PATTERN.test(filename)) return;
       rebuild();
     });
   }
-  const configDir = resolve21(opts.root);
-  if (existsSync20(configDir)) {
+  const configDir = resolve22(opts.root);
+  if (existsSync21(configDir)) {
     watch(configDir, (_event, filename) => {
       if (!filename || !/doc-bridge\.config/.test(filename)) return;
       rebuild();
@@ -13717,9 +13828,9 @@ var evaluateQualityScorecard = (input) => {
 };
 
 // src/memory/github-pr.ts
-import { execFileSync as execFileSync3, spawnSync } from "child_process";
-import { existsSync as existsSync21, mkdirSync as mkdirSync8, writeFileSync as writeFileSync9 } from "fs";
-import { join as join19 } from "path";
+import { execFileSync as execFileSync4, spawnSync } from "child_process";
+import { existsSync as existsSync22, mkdirSync as mkdirSync8, writeFileSync as writeFileSync9 } from "fs";
+import { join as join20 } from "path";
 var run = (cmd, args, cwd) => {
   const result = spawnSync(cmd, [...args], { cwd, encoding: "utf8" });
   const out = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
@@ -13727,10 +13838,10 @@ var run = (cmd, args, cwd) => {
 };
 var hasGh = () => run("gh", ["--version"], process.cwd()).ok;
 var slug = () => (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
-var defaultPromotionDraftPath = (root) => join19(root, ".doc-bridge", "drafts", `memory-promotion-${slug()}.md`);
+var defaultPromotionDraftPath = (root) => join20(root, ".doc-bridge", "drafts", `memory-promotion-${slug()}.md`);
 var writePromotionDraft = (root, draft, path) => {
   const draftPath = path ?? defaultPromotionDraftPath(root);
-  mkdirSync8(join19(root, ".doc-bridge", "drafts"), { recursive: true });
+  mkdirSync8(join20(root, ".doc-bridge", "drafts"), { recursive: true });
   writeFileSync9(draftPath, `${draft.body}
 `, "utf8");
   return draftPath;
@@ -13766,7 +13877,7 @@ var promoteMemoryToGithubPr = (root, draft, options = {}) => {
       message: `Wrote draft to ${relDraft}. Run the printed git/gh commands to open a draft PR.`
     };
   }
-  if (!existsSync21(join19(root, ".git"))) {
+  if (!existsSync22(join20(root, ".git"))) {
     return {
       ok: false,
       dryRun: false,
@@ -13844,7 +13955,7 @@ ${auth.out}`
   ];
   let prUrl = "";
   try {
-    prUrl = execFileSync3("gh", prArgs, { cwd: root, encoding: "utf8" }).trim();
+    prUrl = execFileSync4("gh", prArgs, { cwd: root, encoding: "utf8" }).trim();
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     return {
@@ -14634,12 +14745,12 @@ var formatStudyTaskSuiteText = (suite) => [
 import { spawn as spawn2 } from "child_process";
 import { createHash as createHash3 } from "crypto";
 import { mkdirSync as mkdirSync9, writeFileSync as writeFileSync10 } from "fs";
-import { dirname as dirname9, resolve as resolve23 } from "path";
+import { dirname as dirname10, resolve as resolve24 } from "path";
 import { z as z24 } from "zod";
 
 // src/study/provider-cli.ts
-import { accessSync, constants, existsSync as existsSync22, statSync as statSync3 } from "fs";
-import { isAbsolute as isAbsolute6, resolve as resolve22 } from "path";
+import { accessSync, constants, existsSync as existsSync23, statSync as statSync3 } from "fs";
+import { isAbsolute as isAbsolute7, resolve as resolve23 } from "path";
 import { z as z23 } from "zod";
 var STUDY_PROVIDER_CLI_SCHEMA_VERSION = 1;
 var STUDY_PROVIDER_CLI_CONTENT_HASH_ALGO = "sha256-normalized-v1";
@@ -14714,9 +14825,9 @@ var calculateStudyCostUsd = (pricing2, usage) => {
   return Number(((uncachedInputTokens * pricing2.inputPerMillionUsd + cachedInputTokens * pricing2.cachedInputPerMillionUsd + usage.outputTokens * pricing2.outputPerMillionUsd) / 1e6).toFixed(8));
 };
 var validateStudyProviderCommand = (provider, cwd) => {
-  if (isAbsolute6(provider.command) || provider.command.includes("/")) {
-    const resolvedPath = isAbsolute6(provider.command) ? provider.command : resolve22(cwd, provider.command);
-    if (!existsSync22(resolvedPath) || !statSync3(resolvedPath).isFile()) throw new Error(`Provider CLI command is not executable at ${resolvedPath}.`);
+  if (isAbsolute7(provider.command) || provider.command.includes("/")) {
+    const resolvedPath = isAbsolute7(provider.command) ? provider.command : resolve23(cwd, provider.command);
+    if (!existsSync23(resolvedPath) || !statSync3(resolvedPath).isFile()) throw new Error(`Provider CLI command is not executable at ${resolvedPath}.`);
     try {
       accessSync(resolvedPath, constants.X_OK);
     } catch {
@@ -14727,7 +14838,7 @@ var validateStudyProviderCommand = (provider, cwd) => {
   const pathEntries = (process.env.PATH ?? "").split(":").filter(Boolean);
   if (pathEntries.some((entry) => {
     try {
-      accessSync(resolve22(entry, provider.command), constants.X_OK);
+      accessSync(resolve23(entry, provider.command), constants.X_OK);
       return true;
     } catch {
       return false;
@@ -14994,7 +15105,7 @@ var runAttempt = (request, sessionId) => new Promise((resolveAttempt) => {
   const maxRuntimeMs = request.maxRuntimeMs ?? request.plan.budget.maxRuntimeMs;
   const maxOutputBytes = request.maxOutputBytes ?? request.plan.budget.maxOutputBytes;
   const child = spawn2(request.command, [...request.args ?? []], {
-    cwd: resolve23(request.cwd),
+    cwd: resolve24(request.cwd),
     shell: false,
     detached: true,
     env: { ...env, DOC_BRIDGE_STUDY_SESSION_ID: sessionId },
@@ -15122,10 +15233,10 @@ var runControlledCommand = async (request) => {
 };
 var persistControlledStudyLedger = (path, ledger) => {
   parseControlledStudyLedger(ledger);
-  mkdirSync9(dirname9(resolve23(path)), { recursive: true });
-  writeFileSync10(resolve23(path), `${JSON.stringify(ledger, null, 2)}
+  mkdirSync9(dirname10(resolve24(path)), { recursive: true });
+  writeFileSync10(resolve24(path), `${JSON.stringify(ledger, null, 2)}
 `, "utf8");
-  return resolve23(path);
+  return resolve24(path);
 };
 var formatControlledStudyRunPlanText = (plan) => [
   `Run plan: ${plan.planVersion}`,
@@ -15141,7 +15252,7 @@ var formatControlledStudyRunPlanText = (plan) => [
 import { spawn as spawn3 } from "child_process";
 import { createHash as createHash4 } from "crypto";
 import { mkdirSync as mkdirSync10, writeFileSync as writeFileSync11 } from "fs";
-import { dirname as dirname10, resolve as resolve24 } from "path";
+import { dirname as dirname11, resolve as resolve25 } from "path";
 import { z as z25 } from "zod";
 var STUDY_ADJUDICATION_METHOD = "independent-rubric-v1";
 var outcome2 = z25.enum(["success", "partial", "incorrect", "incomplete", "blocked"]);
@@ -15168,7 +15279,7 @@ var terminate = (child) => {
 var runAdjudicatorProcess = (config, cwd, input, maxRuntimeMs) => new Promise((resolveResult) => {
   const env = Object.fromEntries([.../* @__PURE__ */ new Set(["PATH", "HOME", "TMPDIR", ...config.envAllowlist])].flatMap((name) => process.env[name] === void 0 ? [] : [[name, process.env[name]]]));
   const started = Date.now();
-  const child = spawn3(config.command, [...config.args], { cwd: resolve24(cwd), shell: false, detached: true, env, stdio: ["pipe", "pipe", "pipe"] });
+  const child = spawn3(config.command, [...config.args], { cwd: resolve25(cwd), shell: false, detached: true, env, stdio: ["pipe", "pipe", "pipe"] });
   let stdout = "";
   let stderrBytes = 0;
   let settled = false;
@@ -15306,10 +15417,10 @@ var independentlyAdjudicateStudyLedger = async (options) => {
 };
 var persistIndependentlyAdjudicatedLedger = (path, ledger) => {
   parseControlledStudyLedger(ledger);
-  mkdirSync10(dirname10(resolve24(path)), { recursive: true });
-  writeFileSync11(resolve24(path), `${JSON.stringify(ledger, null, 2)}
+  mkdirSync10(dirname11(resolve25(path)), { recursive: true });
+  writeFileSync11(resolve25(path), `${JSON.stringify(ledger, null, 2)}
 `, "utf8");
-  return resolve24(path);
+  return resolve25(path);
 };
 var adjudicatedLedgerInputHash = (task, observation) => createHash4("sha256").update(adjudicatorInput(task, observation)).digest("hex");
 
@@ -15351,8 +15462,8 @@ var measureProviderToolTelemetry = (events) => {
 };
 
 // src/study/execution.ts
-import { existsSync as existsSync23, readFileSync as readFileSync24, statSync as statSync4 } from "fs";
-import { resolve as resolve25 } from "path";
+import { existsSync as existsSync24, readFileSync as readFileSync25, statSync as statSync4 } from "fs";
+import { resolve as resolve26 } from "path";
 import { z as z26 } from "zod";
 var PROVIDER_RESPONSE_CONTRACT = "Return one JSON object matching the output schema. Required keys: taskOutcome, evidenceQuality, safetyOutcome, evidenceIds, clarificationRequests, reworkCount, and measurements. Each measurement is {name:string,value:number>=0}. Run every available acceptance check and report observed acceptanceChecksPassed, acceptanceChecksTotal, and acceptanceChecksExecuted; include firstEvidenceLatencyMs only when observed. Use canonical names when observed: tokensToFirstEvidence (tokens consumed before correct grounded evidence was in hand), registryAgentInputTokens, registryAgentOutputTokens, registryAgentCostUsd, registryAgentRuns (the enrichment agent of the assisted arm, reported apart from your own cost), searchHitRate, acceptanceChecksPassed, acceptanceChecksTotal, acceptanceChecksExecuted, entrypointEvidenceCount, ownershipEvidenceCount, architectureRelationCount, documentationClaimEvidenceCount, sourceComparisonEvidenceCount, verificationEvidenceCount, errorRate, documentationFindingCount, documentationExampleRate, documentationFreshnessRate, documentationCorrectnessRate, documentationCompletenessRate, documentationClarityRate, documentationMaintainabilityRate, timeToFirstEvidenceMs, analysisCostUsd, and agentCostUsd. Omit unknown values; never invent. Output no markdown, prose, logs, token counts, or extra keys; stdout must contain only the JSON object.";
 var STUDY_REPOSITORY_CONFIG_SCHEMA_VERSION = 1;
@@ -15391,8 +15502,8 @@ var emptyLedger2 = () => createControlledStudyLedger({
   observations: []
 });
 var loadLedger = (path) => {
-  if (!existsSync23(path)) return emptyLedger2();
-  return parseControlledStudyLedger(JSON.parse(readFileSync24(path, "utf8")));
+  if (!existsSync24(path)) return emptyLedger2();
+  return parseControlledStudyLedger(JSON.parse(readFileSync25(path, "utf8")));
 };
 var executionKey = (execution) => sha256NormalizedV1({
   taskId: execution.taskId,
@@ -15473,8 +15584,8 @@ var assertRunInputs = (options) => {
     throw new Error("Study repository config must contain exactly one root for every task-suite population id.");
   }
   for (const repository of options.repositories.repositories) {
-    const root = resolve25(repository.root);
-    if (!existsSync23(root) || !statSync4(root).isDirectory()) throw new Error(`Study repository ${repository.id} is not available at the configured root.`);
+    const root = resolve26(repository.root);
+    if (!existsSync24(root) || !statSync4(root).isDirectory()) throw new Error(`Study repository ${repository.id} is not available at the configured root.`);
   }
   const executions = selectTaskExecutions(options.suite, options.plan.sampling.sampleSize, options.plan.sampling);
   const assisted = assistedArmReadiness(options.plan, options.providers, options.suite);
@@ -15520,7 +15631,7 @@ var runControlledStudy = async (options) => {
     repositoryConfigHash: repositories.contentHash,
     assistedArm: { ...assisted, recorded: 0 }
   };
-  let ledger = loadLedger(resolve25(options.ledgerPath));
+  let ledger = loadLedger(resolve26(options.ledgerPath));
   if (ledger.observations.some((observation) => observation.runId === plan.runId && observation.planHash !== plan.contentHash)) throw new Error(`Ledger already contains run ${plan.runId} with a different plan hash.`);
   let executed = 0;
   let skipped = 0;
@@ -15579,7 +15690,7 @@ var runControlledStudy = async (options) => {
     planned: executions.length,
     executed,
     skipped,
-    ledgerPath: resolve25(options.ledgerPath),
+    ledgerPath: resolve26(options.ledgerPath),
     ledgerHash: ledger.contentHash,
     providerConfigHash: providers.contentHash,
     repositoryConfigHash: repositories.contentHash,
@@ -15600,8 +15711,8 @@ var formatControlledStudyRunText = (summary) => [
 ];
 
 // src/federation/llms.ts
-import { existsSync as existsSync24, readFileSync as readFileSync25 } from "fs";
-import { resolve as resolve26 } from "path";
+import { existsSync as existsSync25, readFileSync as readFileSync26 } from "fs";
+import { resolve as resolve27 } from "path";
 var scoreText = (query, text) => {
   const hay = text.toLowerCase();
   return tokenizeSearchText(query).reduce((score, token) => score + (hasSearchToken(hay, token) ? token.length : 0), 0);
@@ -15626,9 +15737,9 @@ var sourceText = async (root, source, fetchText) => {
   try {
     const remote = httpUrl(source);
     if (remote) return await fetchText(remote);
-    const path = resolve26(root, source);
-    if (!existsSync24(path)) return null;
-    return readFileSync25(path, "utf8");
+    const path = resolve27(root, source);
+    if (!existsSync25(path)) return null;
+    return readFileSync26(path, "utf8");
   } catch {
     return null;
   }
@@ -15755,11 +15866,11 @@ var retrieveHybridChunks = async (root, config, index, query, options = {}) => {
 };
 
 // src/intelligence/rag.ts
-import { readFileSync as readFileSync26 } from "fs";
-import { join as join21 } from "path";
+import { readFileSync as readFileSync27 } from "fs";
+import { join as join22 } from "path";
 
 // src/intelligence/adapter.ts
-import { join as join20 } from "path";
+import { join as join21 } from "path";
 var readEnv = (name) => {
   if (!name) return void 0;
   const value = process.env[name];
@@ -15838,7 +15949,7 @@ var resolveIntelligenceRuntime = async (config) => {
   }
   return { adapter, embed, provider, ...model ? { model } : {} };
 };
-var defaultVectorStorePath = (root) => join20(root, ".doc-bridge", "vectors");
+var defaultVectorStorePath = (root) => join21(root, ".doc-bridge", "vectors");
 
 // src/intelligence/rag.ts
 var loadDocuments = (root, index, sources) => {
@@ -15846,10 +15957,10 @@ var loadDocuments = (root, index, sources) => {
   const docs = [];
   if (includeAgent) {
     for (const entry of index.knowledge) {
-      const abs = join21(root, entry.path);
+      const abs = join22(root, entry.path);
       let content = "";
       try {
-        content = readFileSync26(abs, "utf8");
+        content = readFileSync27(abs, "utf8");
       } catch {
         content = [entry.title, entry.description].filter(Boolean).join("\n\n");
       }
@@ -15867,7 +15978,7 @@ var createDocBridgeRag = async (root, config, index) => {
   const { embed } = await resolveIntelligenceRuntime(config);
   const ragMod = await importPeer("@agentskit/rag");
   const memoryMod = await importPeer("@agentskit/memory");
-  const storePath = typeof config.intelligence?.retriever?.options?.storePath === "string" ? join21(root, config.intelligence.retriever.options.storePath) : defaultVectorStorePath(root);
+  const storePath = typeof config.intelligence?.retriever?.options?.storePath === "string" ? join22(root, config.intelligence.retriever.options.storePath) : defaultVectorStorePath(root);
   const store = memoryMod.fileVectorMemory({ path: storePath });
   const rag = ragMod.createRAG({
     embed,
@@ -16122,8 +16233,8 @@ var docBridgePatternPayload = () => ({
 });
 
 // src/render/render.ts
-import { existsSync as existsSync25, mkdirSync as mkdirSync11, readFileSync as readFileSync27, writeFileSync as writeFileSync12 } from "fs";
-import { dirname as dirname11, join as join22, relative as relative11, resolve as resolve27 } from "path";
+import { existsSync as existsSync26, mkdirSync as mkdirSync11, readFileSync as readFileSync28, writeFileSync as writeFileSync12 } from "fs";
+import { dirname as dirname12, join as join23, relative as relative12, resolve as resolve28 } from "path";
 var OPEN_PLACEHOLDER = "@@doc-bridge:generated-open@@";
 var CLOSE_PLACEHOLDER = "@@doc-bridge:generated-close@@";
 var REGION_VARIABLES = { open: OPEN_PLACEHOLDER, close: CLOSE_PLACEHOLDER };
@@ -16156,8 +16267,8 @@ var renderPage = (name, variables, config, root) => {
   const output = renderNamedTemplate(name, { ...variables, region: REGION_VARIABLES }, config, root);
   return RENDER_TEMPLATES[name].generatedRegion ? applyGeneratedRegions(output, name) : output;
 };
-var readJson3 = (root, path) => JSON.parse(readFileSync27(resolve27(root, path), "utf8"));
-var stateDirOf = (root, config) => resolve27(root, config.workflow?.stateDir ?? ".doc-bridge/workflow");
+var readJson3 = (root, path) => JSON.parse(readFileSync28(resolve28(root, path), "utf8"));
+var stateDirOf = (root, config) => resolve28(root, config.workflow?.stateDir ?? ".doc-bridge/workflow");
 var loadIndex = (options) => options.dataPath ? parseDocBridgeIndex(readJson3(options.root, options.dataPath)) : buildDocBridgeIndex({ root: options.root, config: options.config, write: false }).index;
 var loadReconciliation = (root, config) => {
   try {
@@ -16180,7 +16291,7 @@ var loadPreviousSnapshot = (options) => {
 };
 var DEFAULT_OVERLAY_PATH = ".doc-bridge/enrich/overlay.json";
 var loadOverlay = (options) => {
-  const path = options.dataPath ?? (existsSync25(resolve27(options.root, DEFAULT_OVERLAY_PATH)) ? DEFAULT_OVERLAY_PATH : void 0);
+  const path = options.dataPath ?? (existsSync26(resolve28(options.root, DEFAULT_OVERLAY_PATH)) ? DEFAULT_OVERLAY_PATH : void 0);
   if (!path) return { overlay: void 0 };
   const value = readJson3(options.root, path);
   if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${path} is not an overlay object.`);
@@ -16231,28 +16342,28 @@ var writeRenderedPages = (result, target2, root) => {
   const single = result.pages.length === 1 && !RENDER_TEMPLATES[result.template].multiPage;
   const written = [];
   const write = (path, content) => {
-    mkdirSync11(dirname11(path), { recursive: true });
+    mkdirSync11(dirname12(path), { recursive: true });
     writeFileSync12(path, content, "utf8");
-    return toPosix(relative11(root, path));
+    return toPosix(relative12(root, path));
   };
   for (const page of result.pages) {
     if (!single) {
-      written.push(write(join22(target2, page.path), page.content));
+      written.push(write(join23(target2, page.path), page.content));
       continue;
     }
     try {
       written.push(write(target2, page.content));
     } catch (error) {
       if (error.code !== "EISDIR") throw error;
-      written.push(write(join22(target2, page.path), page.content));
+      written.push(write(join23(target2, page.path), page.content));
     }
   }
   return written;
 };
 
 // src/enrich/context-pack.ts
-import { readFileSync as readFileSync28 } from "fs";
-import { join as join23, resolve as resolve28 } from "path";
+import { readFileSync as readFileSync29 } from "fs";
+import { join as join24, resolve as resolve29 } from "path";
 var CONTEXT_PACK_VERSION = 1;
 var DEFAULT_PACK_BYTES = 64 * 1024;
 var MAX_PACK_NEIGHBOURS = 32;
@@ -16276,7 +16387,7 @@ var boundedMetadata = (metadata) => {
 var defaultReader = (root) => (path) => {
   if (!root) return void 0;
   try {
-    return readFileSync28(join23(resolve28(root), path), "utf8");
+    return readFileSync29(join24(resolve29(root), path), "utf8");
   } catch {
     return void 0;
   }
@@ -16400,8 +16511,8 @@ var batchContextPacks = (packs) => {
 };
 
 // src/enrich/cache.ts
-import { existsSync as existsSync26, mkdirSync as mkdirSync12, readFileSync as readFileSync29, renameSync as renameSync5, writeFileSync as writeFileSync13 } from "fs";
-import { join as join24 } from "path";
+import { existsSync as existsSync27, mkdirSync as mkdirSync12, readFileSync as readFileSync30, renameSync as renameSync5, writeFileSync as writeFileSync13 } from "fs";
+import { join as join25 } from "path";
 import { z as z27 } from "zod";
 var enrichmentCacheKey = (input) => sha256NormalizedV1({ task: input.task, agentId: input.agentId, agentVersion: input.agentVersion, promptVersion: input.promptVersion, packHash: input.packHash });
 var CacheEntrySchema = z27.object({
@@ -16416,14 +16527,14 @@ var CacheEntrySchema = z27.object({
 }).strict();
 var createEnrichmentCache = (root) => {
   const dir = enrichmentCacheDir(root);
-  const pathFor = (key) => join24(dir, `${key}.json`);
+  const pathFor = (key) => join25(dir, `${key}.json`);
   return {
     read: (input) => {
       const key = enrichmentCacheKey(input);
       const path = pathFor(key);
-      if (!existsSync26(path)) return void 0;
+      if (!existsSync27(path)) return void 0;
       try {
-        const entry = CacheEntrySchema.parse(JSON.parse(readFileSync29(path, "utf8")));
+        const entry = CacheEntrySchema.parse(JSON.parse(readFileSync30(path, "utf8")));
         return entry.key === key && entry.packHash === input.packHash && entry.agentId === input.agentId ? entry.proposals : void 0;
       } catch {
         return void 0;
@@ -16455,7 +16566,7 @@ var createMemoryEnrichmentCache = () => {
 };
 
 // src/enrich/stage.ts
-import { basename as basename8, resolve as resolve29 } from "path";
+import { basename as basename8, resolve as resolve30 } from "path";
 
 // src/enrich/stats.ts
 var inventedReferenceCount = (rejected) => rejected.filter((entry) => INVENTED_RELATION_REASONS.includes(entry.reason)).length;
@@ -16552,7 +16663,7 @@ var registryAgent = async (root, config) => {
   };
   return {
     call: async ({ role, task, packs }) => (await adapterFor(role.agentId)).enrich(task, packs, { role: role.role, promptVersion: role.promptVersion }),
-    version: (role) => loadRegistryAgentMetadata(resolve29(root), configWithAgent(config, role.agentId)).version
+    version: (role) => loadRegistryAgentMetadata(resolve30(root), configWithAgent(config, role.agentId)).version
   };
 };
 var overlayBase = (options) => ({
@@ -16870,7 +16981,7 @@ var studyRetrievalSuite = (options) => {
       continue;
     }
     const targets = byRepository.get(task.repositoryId);
-    const resolve32 = (references, kind) => references.flatMap((item) => {
+    const resolve33 = (references, kind) => references.flatMap((item) => {
       const resolved = targets?.[item];
       if (!resolved?.length) {
         unresolved.push({ taskId: task.id, repositoryId: task.repositoryId, reference: item, kind });
@@ -16879,7 +16990,7 @@ var studyRetrievalSuite = (options) => {
       return resolved;
     });
     const expectedTargets = [
-      .../* @__PURE__ */ new Set([...resolve32(task.expectedEntities ?? [], "entity"), ...resolve32(task.expectedDocuments ?? [], "document")])
+      .../* @__PURE__ */ new Set([...resolve33(task.expectedEntities ?? [], "entity"), ...resolve33(task.expectedDocuments ?? [], "document")])
     ].sort();
     if (!expectedTargets.length) continue;
     const queries = taskRetrievalQueries(task);
@@ -17089,8 +17200,8 @@ var claimPattern = (claim, surface) => {
 var renderClaim = (claim, value, surface) => (surface === void 0 ? claim.template ?? "{value}" : templateFor(claim, surface)).replace("{value}", value);
 
 // src/parity/resolve.ts
-import { existsSync as existsSync27, readFileSync as readFileSync30 } from "fs";
-import { resolve as resolve30 } from "path";
+import { existsSync as existsSync28, readFileSync as readFileSync31 } from "fs";
+import { resolve as resolve31 } from "path";
 
 // src/cli/usage.ts
 var CLI_COMMAND_USAGE = `ak-docs \u2014 human\u2194agent documentation bridge (@agentskit/doc-bridge)
@@ -17159,7 +17270,7 @@ Global flags:
 `;
 
 // src/parity/resolve.ts
-var readJson4 = (path) => JSON.parse(readFileSync30(path, "utf8"));
+var readJson4 = (path) => JSON.parse(readFileSync31(path, "utf8"));
 var dotted = (value, field) => field.split(".").reduce((current, key) => {
   if (current === null || typeof current !== "object") return void 0;
   return current[key];
@@ -17211,20 +17322,20 @@ var resolveClaim = (claim, context) => {
   const evidence2 = claim.evidence;
   switch (evidence2.kind) {
     case "package-field": {
-      const path = resolve30(context.root, "package.json");
-      if (!existsSync27(path)) return { status: "not-analyzed", reason: "package.json is not present." };
+      const path = resolve31(context.root, "package.json");
+      if (!existsSync28(path)) return { status: "not-analyzed", reason: "package.json is not present." };
       const value = scalar2(dotted(readJson4(path), evidence2.field), void 0);
       return value === void 0 ? { status: "not-analyzed", reason: `package.json has no scalar field "${evidence2.field}".` } : { status: "resolved", value };
     }
     case "artifact-field": {
-      const path = resolve30(context.root, evidence2.path);
-      if (!existsSync27(path)) return { status: "not-analyzed", reason: `${evidence2.path} is not present.` };
+      const path = resolve31(context.root, evidence2.path);
+      if (!existsSync28(path)) return { status: "not-analyzed", reason: `${evidence2.path} is not present.` };
       const value = scalar2(dotted(readJson4(path), evidence2.field), evidence2.transform);
       return value === void 0 ? { status: "not-analyzed", reason: `${evidence2.path} has no scalar field "${evidence2.field}" that renders under ${evidence2.transform ?? "identity"}.` } : { status: "resolved", value };
     }
     case "artifact-sum": {
-      const path = resolve30(context.root, evidence2.path);
-      if (!existsSync27(path)) return { status: "not-analyzed", reason: `${evidence2.path} is not present.` };
+      const path = resolve31(context.root, evidence2.path);
+      if (!existsSync28(path)) return { status: "not-analyzed", reason: `${evidence2.path} is not present.` };
       const array = dotted(readJson4(path), evidence2.arrayField);
       if (!Array.isArray(array) || array.length === 0) {
         return { status: "not-analyzed", reason: `${evidence2.path} has no non-empty array at "${evidence2.arrayField}".` };
@@ -17259,8 +17370,8 @@ var resolveClaim = (claim, context) => {
 };
 
 // src/parity/check.ts
-import { existsSync as existsSync28, readFileSync as readFileSync31 } from "fs";
-import { resolve as resolve31 } from "path";
+import { existsSync as existsSync29, readFileSync as readFileSync32 } from "fs";
+import { resolve as resolve32 } from "path";
 import { z as z30 } from "zod";
 var PUBLIC_PARITY_SCHEMA_VERSION = 1;
 var PARITY_EXCERPT_LIMIT = 160;
@@ -17336,8 +17447,8 @@ var occurrences = (claim, surface, content) => {
 var checkPublicParity = (options) => {
   const { registry } = options;
   const read = options.readSurface ?? ((path) => {
-    const absolute = resolve31(options.root, path);
-    return existsSync28(absolute) ? readFileSync31(absolute, "utf8") : void 0;
+    const absolute = resolve32(options.root, path);
+    return existsSync29(absolute) ? readFileSync32(absolute, "utf8") : void 0;
   });
   const surfaces2 = claimSurfaces(registry);
   const contents = new Map(surfaces2.map((surface) => [surface, read(surface)]));