@agentskit/doc-bridge 1.6.4 → 1.7.45

package/dist/cli/program.js

@@ -1,6 +1,6 @@
 // src/cli/program.ts
-import { existsSync as existsSync21, mkdirSync as mkdirSync8, readFileSync as readFileSync21, renameSync as renameSync3, rmSync as rmSync3, writeFileSync as writeFileSync8 } from "fs";
-import { dirname as dirname10, relative as relative10, resolve as resolve18 } from "path";
+import { closeSync as closeSync3, existsSync as existsSync21, mkdirSync as mkdirSync7, openSync as openSync3, readFileSync as readFileSync21, renameSync as renameSync3, rmSync as rmSync3, writeFileSync as writeFileSync8 } from "fs";
+import { dirname as dirname9, relative as relative10, resolve as resolve18 } from "path";
 import { createInterface } from "readline/promises";
 
 // src/config/load-config.ts
@@ -467,15 +467,41 @@ var RuleIdSchema = z.enum([
 var RuleSeveritySchema = z.enum(["off", "info", "warn", "error"]);
 var RulesConfigSchema = z.object({
   mode: z.enum(["default", "recommended", "strict"]).optional(),
-  severity: z.record(RuleIdSchema, RuleSeveritySchema).optional(),
+  severity: z.partialRecord(RuleIdSchema, RuleSeveritySchema).optional(),
   ignore: z.array(RuleIdSchema).max(128).optional(),
   criticalEntities: z.array(z.string().min(1).max(256)).max(128).optional(),
   criticalPaths: z.array(z.string().min(1).max(512)).max(128).optional(),
-  warningThresholds: z.record(RuleIdSchema, z.number().int().min(1).max(1e5)).optional()
+  warningThresholds: z.partialRecord(RuleIdSchema, z.number().int().min(1).max(1e5)).optional()
 }).strict();
 var ReconciliationConfigSchema = z.object({
+  /** Semantic comparison level. Raw discovery always keeps file-level relations. */
+  scope: z.enum(["file", "module", "package"]).optional(),
   /** Relation kinds that must have documentation declarations. Omit to require all observed kinds; [] disables this signal. */
-  requiredRelationKinds: z.array(z.string().min(1).max(128)).max(128).optional()
+  requiredRelationKinds: z.array(z.string().min(1).max(128)).max(128).optional(),
+  /** Limit missing-declaration findings to relations whose endpoints are internal project entities. */
+  requiredRelationTargets: z.enum(["all", "internal"]).optional(),
+  includeOrphanedDocuments: z.boolean().optional()
+}).strict();
+var AnalysisConfigSchema = z.object({
+  plugins: z.array(
+    z.object({
+      id: z.string().regex(/^[a-z][a-z0-9-]*$/).max(128),
+      enabled: z.boolean().optional(),
+      order: z.number().int().nonnegative().optional(),
+      options: z.record(z.string(), z.unknown()).optional(),
+      reason: z.string().min(1).max(1024).optional()
+    }).strict()
+  ).max(128).optional(),
+  jsTs: z.object({
+    runtimeWiringMethods: z.array(z.string().regex(/^[A-Za-z_$][A-Za-z0-9_$]*$/).max(64)).max(64).optional(),
+    runtimeWiringAdapters: z.array(
+      z.object({
+        id: z.string().min(1).max(128),
+        methods: z.array(z.string().regex(/^[A-Za-z_$][A-Za-z0-9_$]*$/).max(64)).min(1).max(64)
+      }).strict()
+    ).max(32).optional(),
+    includeTestRuntimeWiring: z.boolean().optional()
+  }).strict().optional()
 }).strict();
 var WorkflowConfigSchema = z.object({
   stateDir: z.string().min(1).max(512).optional()
@@ -488,6 +514,10 @@ var RepositorySafetyConfigSchema = z.object({
   maxMemoryMb: z.number().int().positive().max(1048576).optional(),
   redactSecrets: z.boolean().optional()
 }).strict();
+var ReportConfigSchema = z.object({
+  /** Public report privacy mode. Private is the default; anonymized preserves topology without project identity. */
+  privacy: z.enum(["private", "anonymized"]).optional()
+}).strict();
 var SurfacesConfigSchema = z.object({
   cli: z.object({
     bin: z.string().min(1).max(64).optional(),
@@ -559,7 +589,12 @@ var IntelligenceConfigSchema = z.object({
     enabled: z.boolean().optional(),
     agentId: z.string().min(1).max(256).optional(),
     agentRoot: z.string().min(1).max(512).optional(),
-    runnerModule: z.string().min(1).max(512).optional()
+    runnerModule: z.string().min(1).max(512).optional(),
+    deterministic: z.boolean().optional(),
+    timeoutMs: z.number().int().positive().max(6e5).optional(),
+    maxTokens: z.number().int().positive().max(1e6).optional(),
+    maxResponseBytes: z.number().int().positive().max(1e7).optional(),
+    maxConcurrency: z.number().int().positive().max(64).optional()
   }).strict().optional()
 }).strict();
 var FederationConfigSchema = z.object({
@@ -651,9 +686,11 @@ var DocBridgeConfigV1Schema = z.object({
   routing: RoutingConfigSchema.optional(),
   gates: GatesConfigSchema.optional(),
   reconciliation: ReconciliationConfigSchema.optional(),
+  analysis: AnalysisConfigSchema.optional(),
   rules: RulesConfigSchema.optional(),
   workflow: WorkflowConfigSchema.optional(),
   safety: RepositorySafetyConfigSchema.optional(),
+  report: ReportConfigSchema.optional(),
   surfaces: SurfacesConfigSchema.optional(),
   intelligence: IntelligenceConfigSchema.optional(),
   federation: FederationConfigSchema.optional(),
@@ -721,7 +758,7 @@ var parseConfig = (input) => {
   throw new Error(
     `Invalid doc-bridge config:
 ${result.error.issues.map(
-      (issue) => `  - ${issue.path.join(".") || "(root)"}: ${issue.message}`
+      (issue) => `  - ${issue.path.join(".") || "(root)"}: ${issue.code === "invalid_type" && issue.message.endsWith("received undefined") ? "Required" : issue.code === "invalid_value" && "values" in issue ? "Invalid enum value" : issue.message}`
     ).join("\n")}`
   );
 };
@@ -745,7 +782,7 @@ var projectRootFromConfigPath = (configFilePath, projectRootField) => {
 };
 
 // src/conformance/documentation-standard-v1.ts
-import { existsSync as existsSync9, readFileSync as readFileSync8, realpathSync as realpathSync6, statSync as statSync3 } from "fs";
+import { closeSync as closeSync2, existsSync as existsSync9, fstatSync as fstatSync2, openSync as openSync2, readFileSync as readFileSync8, realpathSync as realpathSync6 } from "fs";
 import { isAbsolute as isAbsolute4, relative as relative4, resolve as resolve6, sep as sep5 } from "path";
 
 // src/conformance/ecosystem-contract.ts
@@ -925,7 +962,7 @@ var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
 
 // src/index-builder/build-index.ts
 import { mkdirSync, readFileSync as readFileSync7, writeFileSync } from "fs";
-import { dirname as dirname4, join as join7 } from "path";
+import { dirname as dirname3, join as join7 } from "path";
 
 // src/lib/paths.ts
 import { existsSync as existsSync2, realpathSync } from "fs";
@@ -1009,22 +1046,27 @@ var defaultChecksForTarget = (root, opts) => {
 import { minimatch } from "minimatch";
 
 // src/lib/bounded-text.ts
-import { readFileSync as readFileSync3, statSync } from "fs";
+import { closeSync, fstatSync, openSync, readFileSync as readFileSync3 } from "fs";
 var MAX_DOCUMENT_BYTES = 4 * 1024 * 1024;
 var MAX_CORPUS_BYTES = 64 * 1024 * 1024;
 var readBoundedText = (path, budget, limits) => {
   const maxFileBytes = limits?.maxFileBytes ?? MAX_DOCUMENT_BYTES;
   const maxCorpusBytes = limits?.maxCorpusBytes ?? MAX_CORPUS_BYTES;
-  const stat = statSync(path);
-  if (!stat.isFile()) throw new Error(`Documentation path is not a regular file: ${path}`);
-  if (stat.size > maxFileBytes) {
-    throw new Error(`Documentation file exceeds the ${maxFileBytes} byte limit: ${path}`);
-  }
-  if (budget.used + stat.size > maxCorpusBytes) {
-    throw new Error(`Documentation corpus exceeds the ${maxCorpusBytes} byte read budget.`);
+  const fd = openSync(path, "r");
+  try {
+    const stat = fstatSync(fd);
+    if (!stat.isFile()) throw new Error(`Documentation path is not a regular file: ${path}`);
+    if (stat.size > maxFileBytes) {
+      throw new Error(`Documentation file exceeds the ${maxFileBytes} byte limit: ${path}`);
+    }
+    if (budget.used + stat.size > maxCorpusBytes) {
+      throw new Error(`Documentation corpus exceeds the ${maxCorpusBytes} byte read budget.`);
+    }
+    budget.used += stat.size;
+    return readFileSync3(fd, "utf8");
+  } finally {
+    closeSync(fd);
   }
-  budget.used += stat.size;
-  return readFileSync3(path, "utf8");
 };
 
 // src/lib/markdown.ts
@@ -1448,7 +1490,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.6.4";
+var PACKAGE_VERSION = "1.7.45";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {
@@ -1505,9 +1547,9 @@ var contentHashForArtifactV1 = (artifact2) => {
 
 // src/index-builder/llms-txt.ts
 var routePath = (path, pathPrefix) => {
-  const normalizedPath = path.replaceAll("\\", "/").replace(/\.(?:md|mdx)$/, "");
+  const normalizedPath2 = path.replaceAll("\\", "/").replace(/\.(?:md|mdx)$/, "");
   const normalizedPrefix = pathPrefix?.replaceAll("\\", "/").replace(/\/$/, "");
-  const relativePath3 = normalizedPrefix && normalizedPath.startsWith(`${normalizedPrefix}/`) ? normalizedPath.slice(normalizedPrefix.length + 1) : normalizedPath;
+  const relativePath3 = normalizedPrefix && normalizedPath2.startsWith(`${normalizedPrefix}/`) ? normalizedPath2.slice(normalizedPrefix.length + 1) : normalizedPath2;
   return relativePath3.replace(/^\/+/, "");
 };
 var knowledgeUrl = (path, options = {}) => {
@@ -1879,7 +1921,7 @@ var scanHumanDocs = (root, config) => Object.fromEntries(scanHumanDocRecords(roo
 
 // src/index-builder/plugins/nx.ts
 import { existsSync as existsSync6, lstatSync as lstatSync2, readFileSync as readFileSync5, realpathSync as realpathSync5 } from "fs";
-import { basename as basename2, dirname as dirname3, isAbsolute as isAbsolute3, relative as relative3, resolve as resolve5, sep as sep4 } from "path";
+import { basename as basename2, dirname as dirname2, isAbsolute as isAbsolute3, relative as relative3, resolve as resolve5, sep as sep4 } from "path";
 var NX_SCAN_SKIP = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
@@ -1943,7 +1985,7 @@ var discoverNxProjects = (root, config) => {
   for (const manifest of manifests) {
     const json = readJsonRecord(manifest);
     if (!json) continue;
-    const manifestDir = dirname3(manifest);
+    const manifestDir = dirname2(manifest);
     const manifestName = basename2(manifest);
     const isProjectJson = manifestName === "project.json";
     if (!isProjectJson && manifestName !== "package.json") continue;
@@ -1991,7 +2033,7 @@ import { existsSync as existsSync8, readFileSync as readFileSync6 } from "fs";
 import { basename as basename3, join as join6 } from "path";
 
 // src/lib/glob-expand.ts
-import { existsSync as existsSync7, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { existsSync as existsSync7, readdirSync as readdirSync2, statSync } from "fs";
 import { join as join5 } from "path";
 var expandWorkspaceGlobs = (root, patterns) => {
   const dirs = /* @__PURE__ */ new Set();
@@ -2008,7 +2050,7 @@ var expandWorkspaceGlobs = (root, patterns) => {
     for (const name of readdirSync2(base)) {
       const abs = join5(base, name);
       try {
-        if (statSync2(abs).isDirectory()) dirs.add(toPosix(abs));
+        if (statSync(abs).isDirectory()) dirs.add(toPosix(abs));
       } catch {
       }
     }
@@ -2118,7 +2160,7 @@ var buildDocBridgeIndex = (opts) => {
     lookup
   };
   if (write) {
-    mkdirSync(dirname4(indexPath), { recursive: true });
+    mkdirSync(dirname3(indexPath), { recursive: true });
     writeFileSync(indexPath, `${JSON.stringify(index, null, 2)}
 `, "utf8");
   }
@@ -2141,7 +2183,7 @@ var buildDocBridgeIndex = (opts) => {
     const capabilitiesOut = config.index?.capabilities?.outFile ?? ".doc-bridge/capabilities.json";
     capabilitiesPath = join7(root, capabilitiesOut);
     if (write) {
-      mkdirSync(dirname4(capabilitiesPath), { recursive: true });
+      mkdirSync(dirname3(capabilitiesPath), { recursive: true });
       writeFileSync(
         capabilitiesPath,
         renderCapabilitiesJson(config, index, {
@@ -2187,11 +2229,10 @@ var fileEvidence = (root, path, options) => {
       evidence: { path, detail: "Path escapes the project root." }
     };
   }
-  if (!existsSync9(abs)) {
-    return { exists: false, content: "", evidence: { path, detail: "File does not exist." } };
-  }
+  let fd;
   try {
-    const stat = statSync3(abs);
+    fd = openSync2(abs, "r");
+    const stat = fstatSync2(fd);
     if (!stat.isFile()) {
       return { exists: false, content: "", evidence: { path, detail: "Path is not a regular file." } };
     }
@@ -2212,7 +2253,7 @@ var fileEvidence = (root, path, options) => {
         evidence: { path, detail: `Text evidence exceeds ${MAX_TEXT_EVIDENCE_BYTES} bytes.` }
       };
     }
-    const content = readFileSync8(abs, "utf8");
+    const content = readFileSync8(fd, "utf8");
     return {
       exists: content.trim().length > 0,
       content,
@@ -2221,8 +2262,15 @@ var fileEvidence = (root, path, options) => {
         detail: content.trim().length > 0 ? "File exists and is non-empty." : "File is empty."
       }
     };
-  } catch {
-    return { exists: false, content: "", evidence: { path, detail: "File is not readable text." } };
+  } catch (error) {
+    const code = error && typeof error === "object" && "code" in error ? error.code : void 0;
+    return {
+      exists: false,
+      content: "",
+      evidence: { path, detail: code === "ENOENT" ? "File does not exist." : "File is not readable text." }
+    };
+  } finally {
+    if (fd !== void 0) closeSync2(fd);
   }
 };
 var resultWithException = (draft, options) => {
@@ -2556,9 +2604,10 @@ var EvidenceSchema2 = z3.object({
     });
   }
 });
-var CoverageStatusSchema = z3.enum(["complete", "partial", "not-analyzed"]);
+var CoverageStatusSchema = z3.enum(["complete", "partial", "not-analyzed", "not-applicable"]);
 var CoverageSchema = z3.object({
   analyzer: boundedString(128),
+  analyzerVersion: boundedString(64).optional(),
   scope: boundedString(512),
   status: CoverageStatusSchema,
   reason: z3.string().max(1024).optional(),
@@ -2587,7 +2636,7 @@ var EntitySchema = z3.object({
   aliases: z3.array(boundedString(256)).max(32).optional(),
   provenance: ProvenanceSchema,
   evidence: z3.array(EvidenceSchema2).max(64),
-  metadata: z3.record(z3.unknown()).optional()
+  metadata: z3.record(z3.string(), z3.unknown()).optional()
 }).strict();
 var RelationSchema = z3.object({
   id: boundedString(256),
@@ -2597,7 +2646,7 @@ var RelationSchema = z3.object({
   discriminator: boundedString(256).optional(),
   provenance: ProvenanceSchema,
   evidence: z3.array(EvidenceSchema2).max(64),
-  metadata: z3.record(z3.unknown()).optional()
+  metadata: z3.record(z3.string(), z3.unknown()).optional()
 }).strict();
 var DiscoverySnapshotV1Schema = z3.object({
   type: z3.literal("discovery-snapshot"),
@@ -2641,7 +2690,24 @@ var ReconciliationReportV1Schema = z3.object({
     entityCount: z3.number().int().nonnegative(),
     relationCount: z3.number().int().nonnegative(),
     diagnosticCount: z3.number().int().nonnegative(),
-    requiredRelationKinds: z3.array(boundedString(128)).max(128).optional()
+    scope: z3.enum(["file", "module", "package"]).optional(),
+    requiredRelationKinds: z3.array(boundedString(128)).max(128).optional(),
+    requiredRelationTargets: z3.enum(["all", "internal"]).optional(),
+    diagnosticsByCode: z3.record(z3.string().max(128), z3.number().int().nonnegative()).optional(),
+    diagnosticsByStatus: z3.record(z3.string().max(128), z3.number().int().nonnegative()).optional(),
+    documentation: z3.object({
+      documentCount: z3.number().int().nonnegative(),
+      documentedDocumentCount: z3.number().int().nonnegative(),
+      documentClassificationCounts: z3.record(z3.string().max(128), z3.number().int().nonnegative()),
+      documentedDocumentClassificationCounts: z3.record(z3.string().max(128), z3.number().int().nonnegative()),
+      packageCount: z3.number().int().nonnegative(),
+      packageStatus: z3.object({
+        fresh: z3.number().int().nonnegative(),
+        stale: z3.number().int().nonnegative(),
+        missing: z3.number().int().nonnegative(),
+        unverified: z3.number().int().nonnegative()
+      }).strict()
+    }).strict().optional()
   }).strict()
 }).strict();
 var WorkflowStateSchema = z3.enum([
@@ -2759,6 +2825,37 @@ var scalar = (value) => {
   }
   return trimmed;
 };
+var isFieldName = (value) => {
+  if (!/^[A-Za-z]/.test(value)) return false;
+  for (const character of value.slice(1)) {
+    if (!/[A-Za-z0-9_-]/.test(character)) return false;
+  }
+  return true;
+};
+var parseIndentedField = (raw, indentation) => {
+  const prefix = " ".repeat(indentation);
+  if (!raw.startsWith(prefix) || raw[indentation] === " ") return void 0;
+  const body = raw.slice(indentation);
+  const separator = body.indexOf(":");
+  if (separator <= 0) return void 0;
+  const key = body.slice(0, separator).trim();
+  return isFieldName(key) ? { key, value: body.slice(separator + 1).trim() } : void 0;
+};
+var parseListItem = (raw, indentation) => {
+  const prefix = `${" ".repeat(indentation)}-`;
+  if (!raw.startsWith(prefix)) return void 0;
+  const rest = raw.slice(prefix.length);
+  if (rest && !/\s/.test(rest[0] ?? "")) return void 0;
+  return rest.trim();
+};
+var conventionalPackageReference = (path, agentRoot) => {
+  const prefix = `${agentRoot.replace(/\/$/, "")}/`;
+  if (!path.startsWith(prefix)) return void 0;
+  const relative11 = path.slice(prefix.length);
+  const [scope, file] = relative11.split("/");
+  if (scope !== "packages" && scope !== "apps" || !file) return void 0;
+  return file.replace(/\.mdx?$/, "");
+};
 var list = (value) => {
   const trimmed = value.trim();
   if (!trimmed.startsWith("[") || !trimmed.endsWith("]")) return void 0;
@@ -2775,7 +2872,15 @@ var addDiagnostic = (diagnostics, input, code, message, line, endLine = line) =>
   diagnostics.push(diagnostic(input.path, code, message, line, endLine));
 };
 var resolveEntity = (reference, entities, input, lineStart, unresolved) => {
-  const resolved = entities.find((entity2) => entity2.id === reference || entity2.aliases?.includes(reference));
+  const direct = entities.find((entity2) => entity2.id === reference || entity2.aliases?.includes(reference));
+  if (direct) return direct;
+  const packageReference = reference.replace(/^package:/, "");
+  const packageCandidates = entities.filter((entity2) => {
+    if (entity2.kind !== "package") return false;
+    const pathName = entity2.path?.split("/").pop();
+    return entity2.name === reference || entity2.path === reference || pathName === packageReference || entity2.name.endsWith(`/${packageReference}`);
+  });
+  const resolved = packageCandidates.length === 1 ? packageCandidates[0] : void 0;
   if (resolved) return resolved;
   const id = `unresolved:${reference}`;
   const existing = unresolved.get(id);
@@ -2791,9 +2896,13 @@ var resolveEntity = (reference, entities, input, lineStart, unresolved) => {
   return entity;
 };
 var relationKey = (from, to, kind) => `${from}\0${to}\0${kind}`;
-var parseBlock = (input) => {
+var parseBlock = (input, options = {}) => {
+  const conventionalPath = conventionalPackageReference(input.path, options.agentRoot ?? "docs/for-agents");
   const frontmatter = findFrontmatter(input.content);
   if (!frontmatter) {
+    if (conventionalPath && !input.content.replace(/^\uFEFF/, "").startsWith("---")) {
+      return { covers: [{ value: conventionalPath, line: 1 }], relations: [], diagnostics: [], hasDocbridge: true };
+    }
     if (input.content.replace(/^\uFEFF/, "").startsWith("---")) {
       return {
         covers: [],
@@ -2805,8 +2914,24 @@ var parseBlock = (input) => {
     return { covers: [], relations: [], diagnostics: [], hasDocbridge: false };
   }
   const { lines, end } = frontmatter;
-  const docbridgeLine = lines.findIndex((line, index) => index > 0 && index < end && /^docbridge\s*:/.test(line));
-  if (docbridgeLine < 0) return { covers: [], relations: [], diagnostics: [], hasDocbridge: false };
+  let docbridgeLine = -1;
+  let typeLine = -1;
+  let packageLine = -1;
+  let humanDocLine = -1;
+  for (let index = 1; index < end; index += 1) {
+    const line = lines[index] ?? "";
+    if (docbridgeLine < 0 && /^docbridge\s*:/.test(line)) docbridgeLine = index;
+    if (typeLine < 0 && /^type\s*:/.test(line)) typeLine = index;
+    if (packageLine < 0 && /^package\s*:/.test(line)) packageLine = index;
+    if (humanDocLine < 0 && /^humanDoc\s*:/.test(line)) humanDocLine = index;
+  }
+  if (docbridgeLine < 0) {
+    const type = typeLine >= 0 ? scalar(lines[typeLine]?.slice("type:".length) ?? "") : "";
+    const packageReference = packageLine >= 0 ? scalar(lines[packageLine]?.slice("package:".length) ?? "") : conventionalPath ?? "";
+    if (type === "package" && packageReference) return { covers: [{ value: packageReference, line: packageLine >= 0 ? packageLine + 1 : typeLine + 1 }], relations: [], diagnostics: [], hasDocbridge: true };
+    if (conventionalPath) return { covers: [{ value: packageReference, line: humanDocLine >= 0 ? humanDocLine + 1 : 1 }], relations: [], diagnostics: [], hasDocbridge: true };
+    return { covers: [], relations: [], diagnostics: [], hasDocbridge: false };
+  }
   const diagnostics = [];
   const covers = [];
   const relations = [];
@@ -2832,11 +2957,10 @@ var parseBlock = (input) => {
       section = void 0;
       continue;
     }
-    if (/^ {2}[A-Za-z][A-Za-z0-9_-]*\s*:/.test(raw)) {
+    const sectionField = parseIndentedField(raw, 2);
+    if (sectionField) {
       finishRelation();
-      const match = /^ {2}([A-Za-z][A-Za-z0-9_-]*)\s*:\s*(.*)$/.exec(raw);
-      const key = match?.[1];
-      const value = match?.[2] ?? "";
+      const { key, value } = sectionField;
       if (key !== "covers" && key !== "relations") {
         addDiagnostic(diagnostics, input, "DOCBRIDGE_FIELD_UNKNOWN", `Unknown docbridge field: ${key ?? "(missing)"}.`, line);
         section = void 0;
@@ -2853,35 +2977,36 @@ var parseBlock = (input) => {
       }
       continue;
     }
-    if (section === "covers" && /^ {4}-\s*/.test(raw)) {
-      const value = scalar(raw.replace(/^ {4}-\s*/, ""));
+    const listValue = parseListItem(raw, 4);
+    if (section === "covers" && listValue !== void 0) {
+      const value = scalar(listValue);
       if (!value) addDiagnostic(diagnostics, input, "DOCBRIDGE_REFERENCE_MISSING", "covers entries must not be empty.", line);
       else covers.push({ value, line });
       continue;
     }
-    if (section === "relations" && /^ {4}-\s*/.test(raw)) {
+    if (section === "relations" && listValue !== void 0) {
       finishRelation();
-      const firstField = /^ {4}-\s*([A-Za-z][A-Za-z0-9_-]*)\s*:\s*(.*)$/.exec(raw);
+      const firstField = parseIndentedField(`    ${listValue}`, 4);
       current = { startLine: line, endLine: line, fields: /* @__PURE__ */ new Set() };
-      if (firstField?.[1]) {
-        current.fields.add(firstField[1]);
-        current[firstField[1]] = scalar(firstField[2] ?? "");
-      } else if (raw.replace(/^ {4}-\s*/, "").trim()) {
+      if (firstField?.key) {
+        current.fields.add(firstField.key);
+        current[firstField.key] = scalar(firstField.value);
+      } else if (listValue) {
         addDiagnostic(diagnostics, input, "DOCBRIDGE_RELATION_INVALID", "Relation entries must be field mappings.", line);
       }
       continue;
     }
-    if (section === "relations" && current && /^ {6}[A-Za-z][A-Za-z0-9_-]*\s*:/.test(raw)) {
-      const field = /^ {6}([A-Za-z][A-Za-z0-9_-]*)\s*:\s*(.*)$/.exec(raw);
-      const key = field?.[1];
+    const field = parseIndentedField(raw, 6);
+    if (section === "relations" && current && field) {
+      const { key, value } = field;
       current.endLine = line;
-      if (!key || !["from", "to", "kind", "detection"].includes(key)) {
-        addDiagnostic(diagnostics, input, "DOCBRIDGE_FIELD_UNKNOWN", `Unknown relation field: ${key ?? "(missing)"}.`, line);
+      if (!["from", "to", "kind", "detection"].includes(key)) {
+        addDiagnostic(diagnostics, input, "DOCBRIDGE_FIELD_UNKNOWN", `Unknown relation field: ${key}.`, line);
       } else if (current.fields.has(key)) {
         addDiagnostic(diagnostics, input, "DOCBRIDGE_FIELD_DUPLICATE", `Duplicate relation field: ${key}.`, line);
       } else {
         current.fields.add(key);
-        current[key] = scalar(field?.[2] ?? "");
+        current[key] = scalar(value);
       }
       continue;
     }
@@ -2891,7 +3016,7 @@ var parseBlock = (input) => {
   return { covers, relations, diagnostics, hasDocbridge: true };
 };
 var parseDocumentationDeclarations = (input, options) => {
-  const parsed = parseBlock(input);
+  const parsed = parseBlock(input, options);
   if (!parsed.hasDocbridge) return { hasDocbridge: false, entities: [], relations: [], diagnostics: [] };
   const diagnostics = [...parsed.diagnostics];
   const unresolved = /* @__PURE__ */ new Map();
@@ -2952,12 +3077,12 @@ var parseDocumentationDeclarations = (input, options) => {
     diagnostics
   };
 };
-var applyDocumentationDeclarations = (snapshot, documents) => {
+var applyDocumentationDeclarations = (snapshot, documents, options = {}) => {
   const entities = new Map(snapshot.entities.map((entity) => [entity.id, entity]));
   const relations = new Map(snapshot.relations.map((relation) => [relation.id, relation]));
   const diagnostics = [];
   for (const document of documents) {
-    const result = parseDocumentationDeclarations(document, { snapshot });
+    const result = parseDocumentationDeclarations(document, { snapshot, ...options });
     diagnostics.push(...result.diagnostics);
     for (const entity of result.entities) entities.set(entity.id, entity);
     for (const relation of result.relations) relations.set(relation.id, relation);
@@ -2972,14 +3097,14 @@ var applyDocumentationDeclarations = (snapshot, documents) => {
 // src/discovery/repository.ts
 import { execFileSync } from "child_process";
 import { existsSync as existsSync10, readFileSync as readFileSync9 } from "fs";
-import { basename as basename4, dirname as dirname5, extname, join as join8, relative as relative6, resolve as resolve8, sep as sep7 } from "path";
+import { basename as basename4, dirname as dirname4, extname, join as join8, relative as relative6, resolve as resolve8, sep as sep7 } from "path";
 import * as ts from "typescript";
 
 // src/safety/repository.ts
-import { lstatSync as lstatSync3, readdirSync as readdirSync3, realpathSync as realpathSync7, statSync as statSync4 } from "fs";
+import { lstatSync as lstatSync3, readdirSync as readdirSync3, realpathSync as realpathSync7, statSync as statSync2 } from "fs";
 import { isAbsolute as isAbsolute5, relative as relative5, resolve as resolve7, sep as sep6 } from "path";
 import { minimatch as minimatch4 } from "minimatch";
-var DEFAULT_SAFETY_EXCLUDES = ["**/.git/**", "**/node_modules/**", "**/dist/**", "**/build/**", "**/coverage/**", "**/.doc-bridge/**", "**/.turbo/**", "**/.env", "**/.env.*", "**/*secret*", "**/*credential*", "**/*.pem", "**/*.key"];
+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 = realpathSync7.native(resolve7(root));
   const unresolved = resolve7(projectRoot, candidate);
@@ -3039,7 +3164,7 @@ var safeWalkFiles = (root, options = {}) => {
         reason = `Repository scan exceeded the ${options.maxFiles ?? 1e4} file limit.`;
         return;
       }
-      bytes += statSync4(absolute).size;
+      bytes += statSync2(absolute).size;
       if (options.maxBytes !== void 0 && bytes > options.maxBytes) {
         reason = `Repository scan exceeded the ${options.maxBytes} byte limit.`;
         return;
@@ -3064,6 +3189,8 @@ var SOURCE_EXTENSIONS = [".js", ".jsx", ".mjs", ".cjs", ".ts", ".tsx", ".mts", "
 var DOCUMENT_EXTENSIONS = [".md", ".mdx"];
 var DEFAULT_MAX_FILES2 = 1e4;
 var EMPTY_HASH = "0".repeat(64);
+var DEFAULT_RUNTIME_WIRING_METHODS = ["register", "use", "mount", "attach"];
+var TEST_MODULE_PATTERN = /(?:\.test|\.spec|__tests__)/;
 var isRecord2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var readJson = (path) => {
   try {
@@ -3092,6 +3219,13 @@ var firstLineContaining = (text, pattern) => {
   const line = text.split(/\r?\n/).findIndex((value) => value.includes(pattern));
   return line >= 0 ? line + 1 : void 0;
 };
+var documentClassification = (path) => {
+  if (/(^|\/)docs\/for-agents(?:\/|$)/.test(path)) return "agent";
+  if (/(^|\/)docs-archive(?:\/|$)/.test(path)) return "archive";
+  if (/(^|\/)docs(?:\/|$)/.test(path)) return "human";
+  if (/(^|\/)(README|CONTRIBUTING|SECURITY|CHANGELOG)(?:\.|$)/i.test(path)) return "project";
+  return "unclassified";
+};
 var packageName = (manifest, fallback) => typeof manifest.name === "string" && manifest.name.length > 0 ? manifest.name : fallback || void 0;
 var workspacePatterns = (root, rootManifest) => {
   const fromPackageJson = rootManifest?.workspaces;
@@ -3166,7 +3300,7 @@ var readCompilerOptions = (root) => {
   if (!configPath) return { options: {} };
   const parsed = ts.readConfigFile(configPath, ts.sys.readFile);
   if (parsed.error) return { options: {}, error: ts.flattenDiagnosticMessageText(parsed.error.messageText, "\n") };
-  const config = ts.parseJsonConfigFileContent(parsed.config, ts.sys, dirname5(configPath));
+  const config = ts.parseJsonConfigFileContent(parsed.config, ts.sys, dirname4(configPath));
   if (config.errors.length) {
     return {
       options: config.options,
@@ -3233,29 +3367,106 @@ var exportedNames = (sourceFile) => {
   visit(sourceFile);
   return [...names].sort();
 };
-var moduleReferences = (root, path, sourceFile) => {
+var moduleReferences = (root, path, sourceFile, runtimeWiringMethods) => {
   const references = [];
+  const dynamicEvidence = [];
   let hasDynamic = false;
+  let hasLiteralDynamic = false;
   let hasRuntimeWiring = false;
-  const addReference = (specifier, kind, node) => {
-    references.push({ specifier: specifier.text, kind, evidence: nodeEvidence(root, path, sourceFile, node) });
+  let hasUnresolvedRuntimeWiring = false;
+  const importedBindings = /* @__PURE__ */ new Map();
+  const staticStringBindings = /* @__PURE__ */ new Map();
+  const localBindings = /* @__PURE__ */ new Set();
+  const resolveStaticString = (expression) => {
+    if (ts.isStringLiteralLike(expression)) return expression.text;
+    if (ts.isIdentifier(expression)) return staticStringBindings.get(expression.text);
+    if (ts.isParenthesizedExpression(expression)) return resolveStaticString(expression.expression);
+    if (ts.isBinaryExpression(expression) && expression.operatorToken.kind === ts.SyntaxKind.PlusToken) {
+      const left = resolveStaticString(expression.left);
+      const right = resolveStaticString(expression.right);
+      return left !== void 0 && right !== void 0 ? left + right : void 0;
+    }
+    return void 0;
+  };
+  const collectStaticStringBindings = (node) => {
+    if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.initializer && ts.isVariableDeclarationList(node.parent) && (node.parent.flags & ts.NodeFlags.Const) !== 0) {
+      const value = resolveStaticString(node.initializer);
+      const previous = staticStringBindings.get(node.name.text);
+      staticStringBindings.set(node.name.text, !staticStringBindings.has(node.name.text) || previous === value ? value : void 0);
+    }
+    if ((ts.isVariableDeclaration(node) || ts.isParameter(node) || ts.isBindingElement(node)) && ts.isIdentifier(node.name)) localBindings.add(node.name.text);
+    if ((ts.isFunctionDeclaration(node) || ts.isClassDeclaration(node) || ts.isEnumDeclaration(node)) && node.name) localBindings.add(node.name.text);
+    ts.forEachChild(node, collectStaticStringBindings);
+  };
+  collectStaticStringBindings(sourceFile);
+  const addImportedBindingReference = (expression, node) => {
+    if (ts.isIdentifier(expression)) {
+      const specifier = importedBindings.get(expression.text);
+      if (specifier) {
+        addReference({ text: specifier }, "runtime-wiring", node, "runtime-wiring-static");
+        return true;
+      }
+      return false;
+    }
+    if (ts.isPropertyAccessExpression(expression)) return addImportedBindingReference(expression.expression, node);
+    if (ts.isCallExpression(expression)) return addImportedBindingReference(expression.expression, node);
+    return false;
+  };
+  const isKnownLocal = (expression) => {
+    if (ts.isIdentifier(expression)) return localBindings.has(expression.text) || importedBindings.has(expression.text);
+    if (expression.kind === ts.SyntaxKind.ThisKeyword) return true;
+    if (ts.isPropertyAccessExpression(expression)) return isKnownLocal(expression.expression);
+    if (ts.isCallExpression(expression)) return isKnownLocal(expression.expression);
+    return ts.isStringLiteralLike(expression);
+  };
+  const addReference = (specifier, kind, node, detection) => {
+    references.push({ specifier: specifier.text, kind, evidence: nodeEvidence(root, path, sourceFile, node), ...detection ? { detection } : {} });
   };
   const visit = (node) => {
     if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
       addReference(node.moduleSpecifier, "imports", node);
+      const clause = node.importClause;
+      if (clause?.name) importedBindings.set(clause.name.text, node.moduleSpecifier.text);
+      if (clause?.namedBindings && ts.isNamespaceImport(clause.namedBindings)) importedBindings.set(clause.namedBindings.name.text, node.moduleSpecifier.text);
+      if (clause?.namedBindings && ts.isNamedImports(clause.namedBindings)) {
+        for (const element of clause.namedBindings.elements) importedBindings.set((element.name ?? element.propertyName)?.text ?? "", node.moduleSpecifier.text);
+      }
     } else if (ts.isExportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier)) {
       addReference(node.moduleSpecifier, "re-exports", node);
     } else if (ts.isImportEqualsDeclaration(node) && ts.isExternalModuleReference(node.moduleReference) && ts.isStringLiteral(node.moduleReference.expression)) {
       addReference(node.moduleReference.expression, "imports", node);
+      importedBindings.set(node.name.text, node.moduleReference.expression.text);
     } else if (ts.isCallExpression(node)) {
       if (node.expression.kind === ts.SyntaxKind.ImportKeyword) {
-        if (!node.arguments[0] || !ts.isStringLiteralLike(node.arguments[0])) hasDynamic = true;
+        const specifier = node.arguments[0] ? resolveStaticString(node.arguments[0]) : void 0;
+        if (specifier !== void 0) {
+          hasLiteralDynamic = true;
+          dynamicEvidence.push(nodeEvidence(root, path, sourceFile, node));
+          addReference({ text: specifier }, "imports", node, "dynamic-literal");
+        } else {
+          hasDynamic = true;
+          dynamicEvidence.push(nodeEvidence(root, path, sourceFile, node));
+        }
       } else if (ts.isIdentifier(node.expression) && node.expression.text === "require") {
         const argument = node.arguments[0];
-        if (argument && ts.isStringLiteralLike(argument)) addReference(argument, "imports", node);
-        else hasDynamic = true;
-      } else if (ts.isPropertyAccessExpression(node.expression) && node.expression.name.text === "register") {
+        const specifier = argument ? resolveStaticString(argument) : void 0;
+        if (specifier !== void 0) {
+          dynamicEvidence.push(nodeEvidence(root, path, sourceFile, node));
+          addReference({ text: specifier }, "imports", node);
+        } else {
+          hasDynamic = true;
+          dynamicEvidence.push(nodeEvidence(root, path, sourceFile, node));
+        }
+      } else if (ts.isPropertyAccessExpression(node.expression) && runtimeWiringMethods.has(node.expression.name.text)) {
         hasRuntimeWiring = true;
+        let hasUnresolvedTarget = false;
+        for (const argument of node.arguments) {
+          if (ts.isStringLiteralLike(argument)) continue;
+          if (addImportedBindingReference(argument, node)) continue;
+          if (!isKnownLocal(argument)) hasUnresolvedTarget = true;
+        }
+        const receiver = node.expression.expression;
+        if (hasUnresolvedTarget && !isKnownLocal(receiver)) hasUnresolvedRuntimeWiring = true;
       }
     }
     ts.forEachChild(node, visit);
@@ -3264,12 +3475,15 @@ var moduleReferences = (root, path, sourceFile) => {
   return {
     references,
     exports: exportedNames(sourceFile),
+    dynamicEvidence,
     hasDynamic,
-    hasRuntimeWiring
+    hasLiteralDynamic,
+    hasRuntimeWiring,
+    hasUnresolvedRuntimeWiring
   };
 };
 var resolveRelativeModule = (specifier, containingFile, modulePaths) => {
-  const base = resolve8(dirname5(containingFile), specifier);
+  const base = resolve8(dirname4(containingFile), specifier);
   const extension = extname(base);
   const extensionlessBase = extension ? base.slice(0, -extension.length) : base;
   const candidates = [
@@ -3338,11 +3552,11 @@ var artifact = (root, config, files, entities, relations, coverage) => {
     sourceRevision: revision.value,
     sourceRevisionKind: revision.kind,
     configurationHash: sha256NormalizedV1(config ?? {}),
-    pipelineVersion: "1.0.0",
-    analyzerVersions: { repository: "1.0.0", "js-ts": "1.0.0" },
+    pipelineVersion: "1.1.8",
+    analyzerVersions: { repository: "1.1.1", "js-ts": "1.3.4" },
     entities: [...entities].sort((a, b) => a.id.localeCompare(b.id)),
     relations: [...relations].sort((a, b) => a.id.localeCompare(b.id)),
-    coverage: [...coverage]
+    coverage: coverage.map((entry) => ({ ...entry, analyzerVersion: entry.analyzerVersion ?? ({ repository: "1.1.1", "js-ts": "1.3.4" }[entry.analyzer] ?? "1.0.0") }))
   };
   return DiscoverySnapshotV1Schema.parse({ ...base, contentHash: contentHashForArtifactV1(base) });
 };
@@ -3402,12 +3616,12 @@ var discoverRepository = (opts = {}) => {
     const sourceFile = ts.createSourceFile(absPath, text, ts.ScriptTarget.Latest, true, scriptKind(absPath));
     const exports = exportedNames(sourceFile);
     modules.set(resolve8(absPath), { absPath, path, entityId: id, ...pkg ? { packageId: pkg.id } : {} });
-    addEntity({ id, kind: "module", name: basename4(absPath), path, provenance: "observed", evidence: [lineEvidence("code", root, absPath, 1, sourceFile.getLineAndCharacterOfPosition(sourceFile.getEnd()).line + 1)], ...exports.length ? { metadata: { exports, test: /(?:\.test|\.spec|__tests__)/.test(path) } } : {} });
+    addEntity({ id, kind: "module", name: basename4(absPath), path, provenance: "observed", evidence: [lineEvidence("code", root, absPath, 1, sourceFile.getLineAndCharacterOfPosition(sourceFile.getEnd()).line + 1)], ...exports.length ? { metadata: { exports, test: TEST_MODULE_PATTERN.test(path) } } : {} });
     if (pkg) addRelation({ id: entityId("relation", `${pkg.id}:contains:${id}`), kind: "contains", from: pkg.id, to: id, provenance: "observed", evidence: [lineEvidence("code", root, absPath, 1)] });
   }
   for (const absPath of documentPaths) {
     const path = relativePath(root, absPath);
-    addEntity({ id: entityId("document", path), kind: "document", name: basename4(absPath), path, provenance: "observed", evidence: [lineEvidence("documentation", root, absPath, 1)] });
+    addEntity({ id: entityId("document", path), kind: "document", name: basename4(absPath), path, provenance: "observed", evidence: [lineEvidence("documentation", root, absPath, 1)], metadata: { classification: documentClassification(path) } });
   }
   const compiler = readCompilerOptions(root);
   const coverage = [
@@ -3415,8 +3629,8 @@ var discoverRepository = (opts = {}) => {
     { analyzer: "repository", scope: "package-manager", status: hasPackageManagerMetadata(root, rootManifest) ? "complete" : "partial", ...!hasPackageManagerMetadata(root, rootManifest) ? { reason: `No package manager metadata found; default helper would fall back to ${detectPackageManager(root)}.` } : {} },
     { analyzer: "repository", scope: "workspace-packages", status: packageResult.coverage.some((item) => item.status === "partial") ? "partial" : "complete", ...packageResult.coverage.find((item) => item.reason)?.reason ? { reason: packageResult.coverage.find((item) => item.reason)?.reason } : {} },
     { analyzer: "js-ts", scope: "static-imports-and-exports", status: compiler.error ? "partial" : "complete", ...compiler.error ? { reason: compiler.error } : {} },
-    { analyzer: "js-ts", scope: "dynamic-imports", status: "not-analyzed", reason: "Dynamic import expressions and non-literal require calls are not resolved." },
-    { analyzer: "js-ts", scope: "runtime-wiring", status: "not-analyzed", reason: "Reflection, dependency injection and runtime wiring are not inferred." },
+    { analyzer: "js-ts", scope: "dynamic-imports", status: "not-applicable", reason: "No dynamic loading expression was observed." },
+    { analyzer: "js-ts", scope: "runtime-wiring", status: "not-applicable", reason: "No configured runtime-wiring call was observed." },
     { analyzer: "js-ts", scope: "generated-code", status: "not-analyzed", reason: "Generated code is not interpreted as source architecture." }
   ];
   for (const pkg of packageResult.packages) {
@@ -3427,10 +3641,28 @@ var discoverRepository = (opts = {}) => {
       addRelation({ id: entityId("relation", `${pkg.id}:depends-on:${target}:${dependency.type}`), kind: "depends-on", from: pkg.id, to: target, provenance: "observed", evidence: [lineEvidence("configuration", root, pkg.manifestPath, firstLineContaining(text, `"${dependency.name}"`))], metadata: { dependencyType: dependency.type } });
     }
   }
+  const dynamicCoverageIndex = coverage.findIndex((entry) => entry.scope === "dynamic-imports");
+  const configuredRuntimeWiringMethods = /* @__PURE__ */ new Set([
+    ...opts.config?.analysis?.jsTs?.runtimeWiringMethods ?? [],
+    ...opts.config?.analysis?.jsTs?.runtimeWiringAdapters?.flatMap((adapter) => adapter.methods) ?? []
+  ]);
+  if (!configuredRuntimeWiringMethods.size) for (const method of DEFAULT_RUNTIME_WIRING_METHODS) configuredRuntimeWiringMethods.add(method);
+  const includeTestRuntimeWiring = opts.config?.analysis?.jsTs?.includeTestRuntimeWiring ?? false;
+  let observedLiteralDynamic = false;
+  let observedUnresolvedDynamic = false;
+  const observedDynamicEvidence = [];
+  let observedRuntimeWiring = false;
+  let observedUnresolvedRuntimeWiring = false;
   for (const module of modules.values()) {
     const text = readFileSync9(module.absPath, "utf8");
     const sourceFile = ts.createSourceFile(module.absPath, text, ts.ScriptTarget.Latest, true, scriptKind(module.absPath));
-    const references = moduleReferences(root, module.absPath, sourceFile);
+    const runtimeWiringMethods = includeTestRuntimeWiring || !TEST_MODULE_PATTERN.test(module.path) ? configuredRuntimeWiringMethods : /* @__PURE__ */ new Set();
+    const references = moduleReferences(root, module.absPath, sourceFile, runtimeWiringMethods);
+    observedLiteralDynamic ||= references.hasLiteralDynamic;
+    observedUnresolvedDynamic ||= references.hasDynamic;
+    observedDynamicEvidence.push(...references.dynamicEvidence);
+    observedRuntimeWiring ||= references.hasRuntimeWiring;
+    observedUnresolvedRuntimeWiring ||= references.hasUnresolvedRuntimeWiring;
     for (const reference of references.references) {
       const target = resolveReference(reference, module.absPath, modules, packageResult.packages, compiler.options);
       if (!target) continue;
@@ -3438,11 +3670,14 @@ var discoverRepository = (opts = {}) => {
         const externalName = target.targetId.replace(/^external:/, "");
         addEntity({ id: target.targetId, kind: "external", name: externalName, provenance: "observed", evidence: [reference.evidence] });
       }
-      addRelation({ id: entityId("relation", `${module.entityId}:${reference.kind}:${target.targetId}`), kind: reference.kind, from: module.entityId, to: target.targetId, provenance: "observed", evidence: [reference.evidence] });
+      addRelation({ id: entityId("relation", `${module.entityId}:${reference.kind}:${target.targetId}`), kind: reference.kind, from: module.entityId, to: target.targetId, provenance: "observed", evidence: [reference.evidence], ...reference.detection ? { metadata: { detection: reference.detection } } : {} });
     }
-    if (references.hasDynamic) coverage.push({ analyzer: "js-ts", scope: `dynamic-imports:${module.path}`, status: "not-analyzed", reason: "A dynamic import or non-literal require was found.", evidence: [lineEvidence("code", root, module.absPath)] });
-    if (references.hasRuntimeWiring) coverage.push({ analyzer: "js-ts", scope: `runtime-wiring:${module.path}`, status: "not-analyzed", reason: "A possible runtime registration/wiring call was found.", evidence: [lineEvidence("code", root, module.absPath)] });
+    if (references.hasLiteralDynamic || references.hasDynamic) coverage.push({ analyzer: "js-ts", scope: `dynamic-imports:${module.path}`, status: references.hasDynamic ? "not-analyzed" : "complete", reason: references.hasDynamic ? "A non-literal dynamic import was found; the target is unresolved." : "Literal dynamic imports were resolved.", evidence: [...references.dynamicEvidence.slice(0, 32)] });
+    if (references.hasUnresolvedRuntimeWiring) coverage.push({ analyzer: "js-ts", scope: `runtime-wiring:${module.path}`, status: "not-analyzed", reason: "A runtime registration/wiring call was found without a statically imported target.", evidence: [lineEvidence("code", root, module.absPath)] });
   }
+  if (dynamicCoverageIndex >= 0) coverage[dynamicCoverageIndex] = observedUnresolvedDynamic ? { analyzer: "js-ts", scope: "dynamic-imports", status: "partial", reason: "Literal dynamic imports are resolved; non-literal import expressions and require calls remain unresolved. Evidence lists representative dynamic loading sites.", evidence: [...observedDynamicEvidence.slice(0, 32)] } : observedLiteralDynamic ? { analyzer: "js-ts", scope: "dynamic-imports", status: "complete", reason: "All observed dynamic imports used literal targets and were resolved.", evidence: [...observedDynamicEvidence.slice(0, 32)] } : { analyzer: "js-ts", scope: "dynamic-imports", status: "not-applicable", reason: "No dynamic loading expression was observed." };
+  const runtimeCoverageIndex = coverage.findIndex((entry) => entry.scope === "runtime-wiring");
+  if (runtimeCoverageIndex >= 0) coverage[runtimeCoverageIndex] = observedUnresolvedRuntimeWiring ? { analyzer: "js-ts", scope: "runtime-wiring", status: "partial", reason: "Some configured runtime-wiring calls remain unresolved after static binding analysis." } : observedRuntimeWiring ? { analyzer: "js-ts", scope: "runtime-wiring", status: "complete", reason: "All observed configured runtime-wiring calls resolved to static bindings." } : { analyzer: "js-ts", scope: "runtime-wiring", status: "not-applicable", reason: "No configured runtime-wiring call was observed." };
   return artifact(root, opts.config, allFiles, [...entities.values()], [...relations.values()], coverage);
 };
 
@@ -3574,9 +3809,20 @@ var defaultFetchText = async (url) => {
   if (!res.ok) throw new Error(`Failed to fetch ${url}: ${res.status}`);
   return res.text();
 };
+var httpUrl = (value) => {
+  try {
+    const parsed = new URL(value);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return void 0;
+    if (parsed.username || parsed.password) return void 0;
+    return parsed.href;
+  } catch {
+    return void 0;
+  }
+};
 var sourceText = async (root, source, fetchText) => {
   try {
-    if (/^https?:\/\//.test(source)) return await fetchText(source);
+    const remote = httpUrl(source);
+    if (remote) return await fetchText(remote);
     const path = resolve9(root, source);
     if (!existsSync11(path)) return null;
     return readFileSync10(path, "utf8");
@@ -3589,22 +3835,57 @@ var sameOrigin = (base, target) => {
   return new URL(base).origin === new URL(target).origin;
 };
 var parseLlmsTxtLinks = (raw) => {
-  const links = [...raw.matchAll(/\[([^\]]+)\]\(([^)]+)\)(?::\s*([^\n]+))?/g)].map((match) => ({
-    title: match[1] ?? match[2] ?? "link",
-    url: match[2] ?? "",
-    ...match[3]?.trim() ? { description: match[3].trim() } : {}
-  })).filter((link) => link.url);
-  for (const match of raw.matchAll(/(?:^|\s)(?:Raw|llms\.txt|Full bundle|ZIP bundle)?:?\s*(https?:\/\/\S+)/gi)) {
-    const url = match[1]?.replace(/[),.;]+$/, "");
-    if (url && !links.some((link) => link.url === url)) links.push({ title: slugFromPath(url), url });
+  const links = [];
+  for (const line of raw.split(/\r?\n/)) {
+    let cursor = 0;
+    while (cursor < line.length) {
+      const open = line.indexOf("[", cursor);
+      if (open < 0) break;
+      const titleEnd = line.indexOf("]", open + 1);
+      const urlStart = titleEnd < 0 ? -1 : line.indexOf("(", titleEnd + 1);
+      const urlEnd = urlStart < 0 ? -1 : line.indexOf(")", urlStart + 1);
+      if (titleEnd < 0 || urlStart !== titleEnd + 1 || urlEnd < 0) {
+        cursor = open + 1;
+        continue;
+      }
+      const title = line.slice(open + 1, titleEnd).trim();
+      const url = line.slice(urlStart + 1, urlEnd).trim();
+      const description = line.slice(urlEnd + 1).trim().replace(/^:\s*/, "");
+      if (url) links.push({ title: title || url, url, ...description ? { description } : {} });
+      cursor = urlEnd + 1;
+    }
+    for (const token of line.split(/\s+/)) {
+      let end = token.length;
+      while (end > 0 && "),.;:".includes(token[end - 1] ?? "")) end -= 1;
+      const url = token.slice(0, end);
+      if (!/^https?:\/\//i.test(url) || links.some((link) => link.url === url)) continue;
+      links.push({ title: slugFromPath(url), url });
+    }
   }
   return links;
 };
+var firstMatchingLine = (section, predicate) => section.split(/\r?\n/).find((line) => predicate(line.trim()))?.trim();
+var sectionTitle = (section, sourceUrl) => {
+  const titleLine = firstMatchingLine(section, (line) => line.startsWith("title:"));
+  if (titleLine) return titleLine.slice("title:".length).trim();
+  const urlLine = firstMatchingLine(section, (line) => /^https?:\/\//i.test(line));
+  if (urlLine) {
+    try {
+      return new URL(urlLine).pathname.split("/").filter(Boolean).at(-1) ?? slugFromPath(sourceUrl);
+    } catch {
+      return slugFromPath(sourceUrl);
+    }
+  }
+  const heading = firstMatchingLine(section, (line) => line.startsWith("#"));
+  if (heading) return heading.replace(/^#+\s*/, "").trim();
+  return slugFromPath(sourceUrl);
+};
 var chunksFromMarkdown = (property, raw, sourceUrl) => {
-  const searchable = raw.includes("\n==== ") ? raw : raw.replace(/^---\n[\s\S]*?\n---\n?/, "");
+  const frontmatterEnd = raw.startsWith("---\n") ? raw.indexOf("\n---", 4) : -1;
+  const searchable = raw.includes("\n==== ") ? raw : frontmatterEnd >= 0 ? raw.slice(frontmatterEnd + "\n---".length).replace(/^\n/, "") : raw;
   const sections = searchable.includes("\n==== ") ? searchable.split(/\n====\s+/).filter((section) => section.trim()) : searchable.split(/\n(?=##?\s+)/);
   return sections.map((section, index) => {
-    const title = /^title:\s*(.+)$/m.exec(section)?.[1]?.trim() ?? /^https?:\/\/\S+\/([^/\s]+)$/m.exec(section)?.[1]?.trim() ?? /^#+\s+(.+)$/m.exec(section)?.[1]?.trim() ?? slugFromPath(sourceUrl);
+    const title = sectionTitle(section, sourceUrl);
     const id = slugFromPath(title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")) || `${index}`;
     return {
       chunkKey: `${property}:federated:${id}`,
@@ -3632,8 +3913,15 @@ var loadFederatedChunks = async (root, config, options = {}) => {
     chunks.push(...chunksFromMarkdown(source.id, llms, source.llmsTxt));
     const links = parseLlmsTxtLinks(llms);
     for (const link of links) {
-      const url = !/^https?:\/\//.test(link.url) && source.rawBaseUrl ? `${source.rawBaseUrl.replace(/\/$/, "")}/${link.url.replace(/^\//, "")}` : link.url;
-      if (!/\.(md|txt)(?:$|\?)/.test(url)) continue;
+      const linkUrl = httpUrl(link.url);
+      const baseUrl = source.rawBaseUrl ? httpUrl(source.rawBaseUrl) : void 0;
+      const url = linkUrl ?? (baseUrl ? new URL(link.url, baseUrl).href : link.url);
+      let pathname = url;
+      try {
+        pathname = new URL(url).pathname;
+      } catch {
+      }
+      if (!/\.(md|txt)$/i.test(pathname)) continue;
       if (!sameOrigin(source.llmsTxt, url)) continue;
       const raw = await sourceText(root, url, fetchText);
       if (raw) chunks.push(...chunksFromMarkdown(source.id, raw, url));
@@ -3839,9 +4127,14 @@ var MemoryCandidateV1Schema = z6.object({
 }).strict();
 
 // src/validate.ts
+var zodMessage = (issue) => {
+  if (issue.code === "invalid_type" && issue.message.endsWith("received undefined")) return "Required";
+  if (issue.code === "invalid_value" && "values" in issue) return "Invalid enum value";
+  return issue.message;
+};
 var zodIssues = (error) => error.issues.map((issue) => ({
   path: issue.path.join(".") || "(root)",
-  message: issue.message
+  message: zodMessage(issue)
 }));
 var safeParseAgentHandoff = (input) => {
   const legacy = AgentHandoffLegacySchema.safeParse(input);
@@ -4183,8 +4476,20 @@ var evaluateRules = (report, options = {}) => {
   const sortedFindings = [...findings].sort((a, b) => a.id.localeCompare(b.id));
   return { mode: resolved.mode, findings: sortedFindings, exitCode: sortedFindings.some((finding) => finding.severity === "error") ? 1 : 0 };
 };
-var parseRuleId = (value) => RuleIdSchema.parse(value);
-var parseRuleSeverity = (value) => RuleSeveritySchema.parse(value);
+var parseRuleId = (value) => {
+  try {
+    return RuleIdSchema.parse(value);
+  } catch {
+    throw new Error(`Invalid enum value: ${value}`);
+  }
+};
+var parseRuleSeverity = (value) => {
+  try {
+    return RuleSeveritySchema.parse(value);
+  } catch {
+    throw new Error(`Invalid enum value: ${value}`);
+  }
+};
 
 // src/query/query.ts
 var handoffForPackage = (index, id, config) => {
@@ -4855,7 +5160,7 @@ ${auth.out}`
 
 // src/index-builder/watch-index.ts
 import { existsSync as existsSync15, watch } from "fs";
-import { dirname as dirname6, resolve as resolve11 } from "path";
+import { dirname as dirname5, resolve as resolve11 } 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) => {
@@ -4869,7 +5174,7 @@ var collectWatchRoots = (root, config, configPath) => {
       if (typeof value === "string" && value.length) roots.add(resolve11(root, value));
     }
   }
-  if (configPath) roots.add(dirname6(resolve11(configPath)));
+  if (configPath) roots.add(dirname5(resolve11(configPath)));
   return [...roots].filter((dir) => existsSync15(dir));
 };
 var watchDocBridgeIndex = (opts) => {
@@ -4938,7 +5243,7 @@ var watchDocBridgeIndex = (opts) => {
 
 // src/workflow/engine.ts
 import { appendFileSync, existsSync as existsSync16, mkdirSync as mkdirSync3, readFileSync as readFileSync15, renameSync, rmSync, writeFileSync as writeFileSync3 } from "fs";
-import { join as join15, relative as relative7, resolve as resolve12 } from "path";
+import { join as join14, relative as relative7, resolve as resolve12 } from "path";
 var WORKFLOW_STAGES = ["collect", "normalize", "reconcile", "evaluate", "report"];
 var stageState = {
   collect: "discovering",
@@ -4947,7 +5252,7 @@ var stageState = {
   evaluate: "proposed",
   report: "delivered"
 };
-var defaultStateDir = (root) => join15(root, ".doc-bridge", "workflow");
+var defaultStateDir = (root) => join14(root, ".doc-bridge", "workflow");
 var atomicWrite = (path, value) => {
   const temp = `${path}.tmp-${process.pid}-${Date.now()}`;
   writeFileSync3(temp, `${JSON.stringify(value, null, 2)}
@@ -4955,13 +5260,29 @@ var atomicWrite = (path, value) => {
   renameSync(temp, path);
 };
 var writeManifest = (stateDir, run2) => {
-  atomicWrite(join15(stateDir, "manifest.json"), run2);
+  atomicWrite(join14(stateDir, "manifest.json"), run2);
 };
 var appendTransition = (stateDir, transition2) => {
-  appendFileSync(join15(stateDir, "transitions.jsonl"), `${JSON.stringify(transition2)}
+  appendFileSync(join14(stateDir, "transitions.jsonl"), `${JSON.stringify(transition2)}
 `, "utf8");
 };
 var transition = (run2, to, reason) => {
+  const allowed = {
+    created: ["created", "discovering", "failed", "cancelled"],
+    discovering: ["discovering", "analyzed", "failed", "cancelled", "stale"],
+    analyzed: ["analyzed", "compared", "failed", "cancelled", "stale"],
+    compared: ["compared", "proposed", "failed", "cancelled", "stale"],
+    "awaiting-agent": ["awaiting-agent", "proposed", "failed", "cancelled", "stale"],
+    proposed: ["proposed", "validating", "delivered", "failed", "cancelled", "stale"],
+    "awaiting-approval": ["awaiting-approval", "validating", "failed", "cancelled", "stale"],
+    validating: ["validating", "delivered", "failed", "cancelled", "stale"],
+    delivered: ["delivered", "stale", "failed", "cancelled"],
+    failed: ["failed", "discovering", "analyzed", "compared", "proposed", "validating", "delivered", "cancelled"],
+    cancelled: ["cancelled", "discovering", "analyzed", "compared", "proposed", "validating", "delivered"],
+    stale: [],
+    superseded: []
+  };
+  if (!allowed[run2.state].includes(to)) throw new Error(`Illegal workflow transition ${run2.state} -> ${to}.`);
   const item = {
     from: run2.state,
     to,
@@ -4971,21 +5292,32 @@ var transition = (run2, to, reason) => {
   return { ...run2, state: to, transitions: [...run2.transitions, item] };
 };
 var runId = () => `${Date.now()}-${process.pid}`;
-var stageInputHash = (options, stage, input) => sha256NormalizedV1({ stage, input, sourceRevision: options.sourceRevision, configurationHash: options.configurationHash, toolVersion: options.toolVersion ?? "1.0.0" });
-var stageArtifactPath = (stateDir, stage, inputHash) => join15(stateDir, "artifacts", `${stage}-${inputHash}.json`);
+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) => join14(stateDir, "artifacts", `${stage}-${inputHash}.json`);
 var readArtifact = (path) => JSON.parse(readFileSync15(path, "utf8"));
-var stepArtifactPath = (stateDir, step) => resolve12(stateDir, step.artifactRefs?.[0] ?? "");
+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}".`);
+  if (sha256NormalizedV1(artifact2.value) !== artifact2.outputHash || artifact2.outputHash !== step.outputHash) throw new Error(`Workflow artifact hash mismatch for stage "${stage}".`);
+  return artifact2;
+};
+var stepArtifactPath = (stateDir, step) => {
+  const path = resolve12(stateDir, step.artifactRefs?.[0] ?? "");
+  const pathRelativeToState = relative7(stateDir, path);
+  if (pathRelativeToState.startsWith("..") || pathRelativeToState.startsWith("/")) throw new Error(`Workflow artifact escapes state directory for stage "${step.name}".`);
+  return path;
+};
 var stepOutput = (stateDir, run2, stage) => {
   const step = run2.steps.find((item) => item.name === stage);
   if (!step || step.status !== "completed" || !step.artifactRefs?.[0]) return null;
-  return readArtifact(stepArtifactPath(stateDir, step)).value;
+  return readVerifiedArtifact(stepArtifactPath(stateDir, step), stage, step).value;
 };
 var acquireLock = (stateDir) => {
-  const lock = join15(stateDir, ".lock");
+  const lock = join14(stateDir, ".lock");
   try {
     mkdirSync3(lock);
   } catch {
-    const ownerPath = join15(lock, "owner.json");
+    const ownerPath = join14(lock, "owner.json");
     try {
       const owner = JSON.parse(readFileSync15(ownerPath, "utf8"));
       if (typeof owner.pid === "number") process.kill(owner.pid, 0);
@@ -4996,16 +5328,16 @@ var acquireLock = (stateDir) => {
       mkdirSync3(lock);
     }
   }
-  writeFileSync3(join15(lock, "owner.json"), JSON.stringify({ pid: process.pid, startedAt: (/* @__PURE__ */ new Date()).toISOString() }), "utf8");
+  writeFileSync3(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 = join15(stateDir, "manifest.json");
+  const path = join14(stateDir, "manifest.json");
   if (!existsSync16(path)) return void 0;
   return WorkflowRunV1Schema.parse(JSON.parse(readFileSync15(path, "utf8")));
 };
 var baseRun = (options, stateDir, supersedes) => {
-  const inputHash = sha256NormalizedV1({ sourceRevision: options.sourceRevision, configurationHash: options.configurationHash, toolVersion: options.toolVersion ?? "1.0.0" });
+  const inputHash = sha256NormalizedV1({ sourceRevision: options.sourceRevision, configurationHash: options.configurationHash, pipelineVersion: options.pipelineVersion ?? "1.0.0", analyzerVersions: options.analyzerVersions ?? {}, toolVersion: options.toolVersion ?? "1.0.0" });
   return WorkflowRunV1Schema.parse({
     type: "workflow-run",
     schemaVersion: 1,
@@ -5015,8 +5347,8 @@ var baseRun = (options, stateDir, supersedes) => {
     sourceRevision: options.sourceRevision,
     sourceRevisionKind: "content",
     configurationHash: options.configurationHash,
-    pipelineVersion: "1.0.0",
-    analyzerVersions: { workflow: options.toolVersion ?? "1.0.0" },
+    pipelineVersion: options.pipelineVersion ?? "1.0.0",
+    analyzerVersions: { ...options.analyzerVersions ?? {}, workflow: options.toolVersion ?? "1.0.0" },
     runId: options.runId ?? runId(),
     state: "created",
     steps: WORKFLOW_STAGES.map((name) => ({ name, status: "pending", inputHash })),
@@ -5025,12 +5357,12 @@ var baseRun = (options, stateDir, supersedes) => {
   });
 };
 var withHash = (run2) => WorkflowRunV1Schema.parse({ ...run2, contentHash: contentHashForArtifactV1(run2) });
-var sameInputs = (run2, options) => run2.sourceRevision === options.sourceRevision && run2.configurationHash === options.configurationHash && run2.analyzerVersions.workflow === (options.toolVersion ?? "1.0.0");
+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 = resolve12(options.root);
   const stateDir = resolve12(root, options.stateDir ?? defaultStateDir(root));
-  mkdirSync3(join15(stateDir, "artifacts"), { recursive: true });
+  mkdirSync3(join14(stateDir, "artifacts"), { recursive: true });
   const release = acquireLock(stateDir);
   try {
     let run2 = loadManifest(stateDir);
@@ -5050,7 +5382,17 @@ var runWorkflow = (options) => {
     if (!run2) throw new Error("Workflow manifest was not initialized.");
     const firstSelectedStage = selectedStages(options.stage)[0];
     const previousStageIndex = firstSelectedStage ? WORKFLOW_STAGES.indexOf(firstSelectedStage) - 1 : -1;
-    let previousOutput = previousStageIndex >= 0 ? stepOutput(stateDir, run2, WORKFLOW_STAGES[previousStageIndex]) : null;
+    let previousOutput = null;
+    if (previousStageIndex >= 0) {
+      try {
+        previousOutput = stepOutput(stateDir, run2, WORKFLOW_STAGES[previousStageIndex]);
+      } catch (error) {
+        run2 = withHash(transition(run2, "failed", error instanceof Error ? error.message : String(error)));
+        appendTransition(stateDir, run2.transitions[run2.transitions.length - 1]);
+        writeManifest(stateDir, run2);
+        throw error;
+      }
+    }
     const reusedStages = [];
     for (const stage of selectedStages(options.stage)) {
       const input = options.inputs?.[stage] ?? previousOutput;
@@ -5058,10 +5400,23 @@ var runWorkflow = (options) => {
       const existing = run2.steps.find((step) => step.name === stage);
       const artifactPath = existing?.artifactRefs?.[0] ? resolve12(stateDir, existing.artifactRefs[0]) : stageArtifactPath(stateDir, stage, inputHash);
       if (existing?.status === "completed" && existing.inputHash === inputHash && existing.outputHash && existsSync16(artifactPath)) {
-        previousOutput = readArtifact(artifactPath).value;
+        try {
+          previousOutput = readVerifiedArtifact(artifactPath, stage, existing).value;
+        } catch (error) {
+          run2 = withHash(transition(run2, "failed", error instanceof Error ? error.message : String(error)));
+          appendTransition(stateDir, run2.transitions[run2.transitions.length - 1]);
+          writeManifest(stateDir, run2);
+          throw error;
+        }
         reusedStages.push(stage);
         continue;
       }
+      if (options.shouldCancel?.()) {
+        run2 = withHash(transition(run2, "cancelled", `Workflow cancellation requested before stage "${stage}".`));
+        appendTransition(stateDir, run2.transitions[run2.transitions.length - 1]);
+        writeManifest(stateDir, run2);
+        return { run: run2, stateDir, reusedStages };
+      }
       const handler = options.handlers[stage];
       if (!handler) throw new Error(`No handler configured for workflow stage "${stage}".`);
       run2 = withHash(transition(run2, stageState[stage]));
@@ -5073,7 +5428,7 @@ var runWorkflow = (options) => {
         const value = handler({ root, stage, input, previousOutput });
         const outputHash = sha256NormalizedV1(value);
         const artifact2 = { type: "workflow-step-artifact", stage, inputHash, outputHash, value };
-        mkdirSync3(join15(stateDir, "artifacts"), { recursive: true });
+        mkdirSync3(join14(stateDir, "artifacts"), { recursive: true });
         if (existsSync16(artifactPath)) {
           const existingArtifact = readArtifact(artifactPath);
           if (existingArtifact.outputHash !== outputHash) throw new Error(`Immutable workflow artifact collision for stage "${stage}".`);
@@ -5099,14 +5454,14 @@ var runWorkflow = (options) => {
         run2 = complete;
       }
       writeManifest(stateDir, run2);
-      if (run2.state === "delivered") atomicWrite(join15(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(join15(resolve12(stateDir), "manifest.json"), "utf8")));
+var loadWorkflowManifest = (stateDir) => WorkflowRunV1Schema.parse(JSON.parse(readFileSync15(join14(resolve12(stateDir), "manifest.json"), "utf8")));
 var loadWorkflowStepOutput = (stateDir, stage) => stepOutput(resolve12(stateDir), loadWorkflowManifest(stateDir), stage);
 
 // src/doctor/badge.ts
@@ -5270,13 +5625,13 @@ var docBridgePatternPayload = () => ({
 // src/cli/demo.ts
 import { cpSync, existsSync as existsSync18, mkdtempSync, readFileSync as readFileSync17, rmSync as rmSync2 } from "fs";
 import { tmpdir } from "os";
-import { dirname as dirname8, join as join17, resolve as resolve14 } from "path";
+import { dirname as dirname7, join as join16, resolve as resolve14 } from "path";
 import { fileURLToPath } from "url";
 
 // src/mcp/install.ts
 import { existsSync as existsSync17, mkdirSync as mkdirSync4, readFileSync as readFileSync16, writeFileSync as writeFileSync4 } from "fs";
 import { homedir } from "os";
-import { dirname as dirname7, join as join16, resolve as resolve13 } from "path";
+import { dirname as dirname6, join as join15, resolve as resolve13 } from "path";
 var SERVER_NAME = "ak-docs";
 var mcpServerEntry = (root) => ({
   command: "npx",
@@ -5293,13 +5648,13 @@ var readJson2 = (path) => {
   }
 };
 var writeJson = (path, value) => {
-  mkdirSync4(dirname7(path), { recursive: true });
+  mkdirSync4(dirname6(path), { recursive: true });
   writeFileSync4(path, `${JSON.stringify(value, null, 2)}
 `, "utf8");
 };
 var resolveTargetPath = (target, root) => {
   if (target === "cursor") return resolve13(root, ".cursor", "mcp.json");
-  return join16(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+  return join15(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
 };
 var installMcpConfig = (root, target) => {
   const configPath = resolveTargetPath(target, root);
@@ -5328,12 +5683,12 @@ var installMcpConfig = (root, target) => {
 var mcpSnippet = (root) => JSON.stringify({ mcpServers: { [SERVER_NAME]: mcpServerEntry(root) } }, null, 2);
 
 // src/cli/demo.ts
-var packageRoot = resolve14(dirname8(fileURLToPath(import.meta.url)), "..", "..");
+var packageRoot = resolve14(dirname7(fileURLToPath(import.meta.url)), "..", "..");
 var fixturePath = (fixture) => {
   if (fixture === "monorepo") {
-    return join17(packageRoot, "examples", "demo-monorepo");
+    return join16(packageRoot, "examples", "demo-monorepo");
   }
-  return join17(packageRoot, "examples", "demo-example");
+  return join16(packageRoot, "examples", "demo-example");
 };
 var formatHandoffText = (handoff) => {
   const bridge = handoff.bridge?.humanDoc === "missing" ? `human guide: missing \u2192 ${handoff.bridge.action ?? "ak-docs bootstrap agent-docs"}` : handoff.humanDoc ? `human guide: ${handoff.humanDoc}` : "human guide: (none)";
@@ -5351,9 +5706,9 @@ var runDemo = (root, config, fixture = "example", options = {}) => {
   const fixtureDir = fixturePath(fixture);
   if (options.copyFixture && existsSync18(fixtureDir)) {
     for (const rel of ["doc-bridge.config.json", "docs", "packages", "pnpm-workspace.yaml", "package.json"]) {
-      const src = join17(fixtureDir, rel);
+      const src = join16(fixtureDir, rel);
       if (!existsSync18(src)) continue;
-      const dest = join17(root, rel);
+      const dest = join16(root, rel);
       cpSync(src, dest, { recursive: true });
     }
   }
@@ -5408,14 +5763,14 @@ var formatDemoText = (result) => {
   return lines;
 };
 var withDemoWorkspace = (fixture, fn) => {
-  const dir = mkdtempSync(join17(tmpdir(), "ak-docs-demo-"));
+  const dir = mkdtempSync(join16(tmpdir(), "ak-docs-demo-"));
   try {
     const fixtureDir = fixturePath(fixture);
     if (!existsSync18(fixtureDir)) {
       throw new Error(`Demo fixture "${fixture}" not found at ${fixtureDir}`);
     }
     cpSync(fixtureDir, dir, { recursive: true });
-    const config = JSON.parse(readFileSync17(join17(dir, "doc-bridge.config.json"), "utf8"));
+    const config = JSON.parse(readFileSync17(join16(dir, "doc-bridge.config.json"), "utf8"));
     return fn(dir, config);
   } finally {
     rmSync2(dir, { recursive: true, force: true });
@@ -5430,16 +5785,6 @@ var gradeForScore = (score) => {
   if (score >= 40) return "D";
   return "F";
 };
-var agentDocPaths = (index) => {
-  const paths = /* @__PURE__ */ new Set();
-  for (const owner of Object.values(index.lookup?.ownership ?? {})) {
-    if (owner.agentDoc) paths.add(owner.agentDoc);
-  }
-  for (const handoff of Object.values(index.handoffs ?? {})) {
-    if (handoff.startHere) paths.add(handoff.startHere);
-  }
-  return paths;
-};
 var computeScore = (coverage) => {
   let score = 0;
   if (coverage.freshness.hasIndex) score += 15;
@@ -5527,7 +5872,7 @@ var runDoctor = (root, config) => {
   let index;
   let hasIndex = true;
   let freshnessOk = false;
-  let freshnessMessage = "Index is fresh";
+  let freshnessMessage;
   try {
     index = loadDocBridgeIndex(root, config);
     const next = buildDocBridgeIndex({ root, config, write: false }).index.contentHash;
@@ -5547,8 +5892,6 @@ var runDoctor = (root, config) => {
   const missingAgentDoc = ownership.filter(([, owner]) => !owner.agentDoc || owner.agentDoc === config.corpus.agent.index).map(([id]) => id);
   const missingHumanDoc = ownership.filter(([, owner]) => !owner.humanDoc).map(([id]) => id);
   const indexedPaths = new Set(index.knowledge.map((entry) => entry.path));
-  const expectedAgentDocs = agentDocPaths(index);
-  const unindexed = [...expectedAgentDocs].filter((path) => !indexedPaths.has(path));
   const corpusDocs = scanAgentCorpus(root, config).filter(
     (doc) => doc.path !== config.corpus.agent.index
   );
@@ -5626,13 +5969,13 @@ var formatDoctorText = (report) => {
 };
 
 // src/mcp/server.ts
-import { mkdirSync as mkdirSync7, readFileSync as readFileSync20, realpathSync as realpathSync9, writeFileSync as writeFileSync7 } from "fs";
-import { join as join20, relative as relative9, resolve as resolve17 } from "path";
+import { mkdirSync as mkdirSync6, readFileSync as readFileSync20, realpathSync as realpathSync9, writeFileSync as writeFileSync7 } from "fs";
+import { join as join19, relative as relative9, resolve as resolve17 } from "path";
 import { z as z8, ZodError } from "zod";
 
 // src/fixes/proposals.ts
-import { existsSync as existsSync19, readdirSync as readdirSync4, readFileSync as readFileSync18, realpathSync as realpathSync8, renameSync as renameSync2, statSync as statSync5, unlinkSync, writeFileSync as writeFileSync5 } from "fs";
-import { basename as basename5, dirname as dirname9, extname as extname2, join as join18, relative as relative8, resolve as resolve15, sep as sep8 } from "path";
+import { existsSync as existsSync19, readdirSync as readdirSync4, readFileSync as readFileSync18, realpathSync as realpathSync8, renameSync as renameSync2, unlinkSync, writeFileSync as writeFileSync5 } from "fs";
+import { basename as basename5, dirname as dirname8, extname as extname2, join as join17, relative as relative8, resolve as resolve15, sep as sep8 } from "path";
 var hash2 = (value) => sha256NormalizedV1(value);
 var artifactMetadata = (root, options) => ({
   schemaVersion: 1,
@@ -5671,7 +6014,7 @@ var makeProposal = (root, options, changes, preconditions, postconditions) => {
 };
 var walkMarkdown = (root, directory = root) => readdirSync4(directory, { withFileTypes: true }).flatMap((entry) => {
   if (entry.name === ".git" || entry.name === "node_modules" || entry.name === "dist" || entry.name === "build") return [];
-  const path = join18(directory, entry.name);
+  const path = join17(directory, entry.name);
   if (entry.isDirectory()) return walkMarkdown(root, path);
   return entry.isFile() && [".md", ".mdx"].includes(extname2(entry.name).toLowerCase()) ? [relative8(root, path).split(sep8).join("/")] : [];
 });
@@ -5682,18 +6025,18 @@ var createMarkdownLinkFixProposal = (root, options) => {
   const paths = walkMarkdown(projectRoot);
   const changes = [];
   for (const path of paths) {
-    const content = readFileSync18(join18(projectRoot, path), "utf8");
+    const content = readFileSync18(join17(projectRoot, path), "utf8");
     let next = content;
     for (const match of content.matchAll(localLink)) {
       const target = match[3];
       if (!target || match[1] === "!" || /^(?:[a-z]+:|\/|#)/i.test(target)) continue;
       const targetPath = target.split("#")[0]?.split("?")[0];
-      if (!targetPath || existsSync19(resolve15(projectRoot, dirname9(path), targetPath))) continue;
+      if (!targetPath || existsSync19(resolve15(projectRoot, dirname8(path), targetPath))) continue;
       const targetStem = basename5(targetPath, extname2(targetPath)).toLowerCase();
       const labelStem = (match[2] ?? "").trim().toLowerCase().replace(/[^a-z0-9]+/g, "");
       const candidates = paths.filter((candidate) => basename5(candidate, extname2(candidate)).toLowerCase() === targetStem || basename5(candidate, extname2(candidate)).toLowerCase().replace(/[^a-z0-9]+/g, "") === labelStem);
       if (candidates.length !== 1) continue;
-      let replacement = relative8(dirname9(path), candidates[0]).split(sep8).join("/");
+      let replacement = relative8(dirname8(path), candidates[0]).split(sep8).join("/");
       if (target.startsWith("./") && !replacement.startsWith(".")) replacement = `./${replacement}`;
       next = next.replace(match[0], match[0].replace(target, replacement));
     }
@@ -5705,8 +6048,13 @@ var createArtifactNormalizationProposal = (root, artifactPath, options) => {
   const projectRoot = realpathSync8.native(resolve15(root));
   const path = artifactPath.split(sep8).join("/");
   const absolute = containedPath(projectRoot, path);
-  if (!absolute || !existsSync19(absolute) || !statSync5(absolute).isFile()) return void 0;
-  const before = readFileSync18(absolute, "utf8");
+  if (!absolute) return void 0;
+  let before;
+  try {
+    before = readFileSync18(absolute, "utf8");
+  } catch {
+    return void 0;
+  }
   let after;
   try {
     after = `${JSON.stringify(sortJson(JSON.parse(before)), null, 2)}
@@ -5771,8 +6119,8 @@ var applyFixProposal = (root, proposalInput, options = {}) => {
 };
 
 // src/agents/registry-adapter.ts
-import { existsSync as existsSync20, readFileSync as readFileSync19, writeFileSync as writeFileSync6, mkdirSync as mkdirSync6 } from "fs";
-import { join as join19, resolve as resolve16 } from "path";
+import { existsSync as existsSync20, readFileSync as readFileSync19, writeFileSync as writeFileSync6, mkdirSync as mkdirSync5 } from "fs";
+import { join as join18, resolve as resolve16 } from "path";
 import { pathToFileURL } from "url";
 import { z as z7 } from "zod";
 var DEFAULT_REGISTRY_AGENT_ID = "ecosystem-doc-bridge-corpus-scanner";
@@ -5794,7 +6142,7 @@ var registryConfig = (config) => config.intelligence?.registry;
 var loadRegistryAgentRunner = async (root, config) => {
   const metadata = loadRegistryAgentMetadata(root, config);
   const configured = registryConfig(config)?.runnerModule;
-  const modulePath = configured ? containedPath(root, configured) : containedPath(root, join19(metadata.root, "doc-bridge-adapter.js"));
+  const modulePath = configured ? containedPath(root, configured) : containedPath(root, join18(metadata.root, "doc-bridge-adapter.js"));
   if (!modulePath || !existsSync20(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;
@@ -5805,9 +6153,9 @@ 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, join19(agentRoot, id));
-  if (!agentPath || !existsSync20(agentPath)) throw new Error(`AgentsKit Registry agent "${id}" is not installed at ${join19(agentRoot, id)}. Install it with: npx agentskit add ${id}`);
-  const metadataPath = [join19(agentPath, "agent.json"), join19(agentPath, "manifest.json")].find(existsSync20);
+  const agentPath = containedPath(root, join18(agentRoot, id));
+  if (!agentPath || !existsSync20(agentPath)) throw new Error(`AgentsKit Registry agent "${id}" is not installed at ${join18(agentRoot, id)}. Install it with: npx agentskit add ${id}`);
+  const metadataPath = [join18(agentPath, "agent.json"), join18(agentPath, "manifest.json")].find(existsSync20);
   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(readFileSync19(metadataPath, "utf8")));
   if (metadata.id !== id) throw new Error(`Installed Registry agent metadata id "${metadata.id}" does not match configured id "${id}".`);
@@ -5816,15 +6164,40 @@ var loadRegistryAgentMetadata = (root, config) => {
 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(resolve16(root), config);
+  const settings = registryConfig(config) ?? {};
+  const timeoutMs = settings.timeoutMs ?? 12e4;
+  const maxResponseBytes = settings.maxResponseBytes ?? 256e3;
+  const maxTokens = settings.maxTokens ?? Math.ceil(maxResponseBytes / 4);
+  const maxConcurrency = settings.maxConcurrency ?? 1;
+  let active = 0;
+  const deterministicCache = /* @__PURE__ */ new Map();
   return {
     metadata,
     run: async (snapshot, report, evidence2 = report.diagnostics.flatMap((diagnostic2) => diagnostic2.evidence).slice(0, 64)) => {
-      const context = deepFreeze({ snapshot: redactValue(snapshot), report: redactValue(report), evidence: redactValue(evidence2), capabilities: ["snapshot.read", "evidence.read", "proposal.write"], network: false, shell: false });
-      const proposal = AgentProposalV1Schema.parse(await runner(context));
-      if (proposal.contentHash !== contentHashForArtifactV1(proposal)) throw new Error("Registry agent proposal contentHash does not match its canonical contents.");
-      if (proposal.baseSnapshotHash !== snapshot.contentHash || proposal.baseReportHash !== report.contentHash) throw new Error("Registry agent proposal is not based on the supplied snapshot/report hashes.");
-      if (proposal.origin.kind !== "registry-agent" || proposal.origin.id !== metadata.id) throw new Error(`Registry agent proposal origin must be ${metadata.id}.`);
-      return proposal;
+      if (active >= maxConcurrency) throw new Error(`Registry agent concurrency limit ${maxConcurrency} exceeded.`);
+      const cacheKey = sha256NormalizedV1({ snapshotHash: snapshot.contentHash, reportHash: report.contentHash, agentId: metadata.id, agentVersion: metadata.version, evidence: evidence2 });
+      if (settings.deterministic && deterministicCache.has(cacheKey)) return deterministicCache.get(cacheKey);
+      active += 1;
+      let timer;
+      try {
+        const context = deepFreeze({ snapshot: redactValue(snapshot), report: redactValue(report), evidence: redactValue(evidence2), capabilities: ["snapshot.read", "evidence.read", "proposal.write"], network: false, shell: false, deterministic: settings.deterministic ?? true });
+        const timeout = new Promise((_, reject) => {
+          timer = setTimeout(() => reject(new Error(`Registry agent timed out after ${timeoutMs}ms.`)), timeoutMs);
+        });
+        const raw = await Promise.race([Promise.resolve(runner(context)), timeout]);
+        const responseBytes = Buffer.byteLength(JSON.stringify(raw));
+        if (responseBytes > maxResponseBytes) throw new Error(`Registry agent response limit ${maxResponseBytes} bytes exceeded.`);
+        if (Math.ceil(responseBytes / 4) > maxTokens) throw new Error(`Registry agent token budget ${maxTokens} exceeded.`);
+        const proposal = AgentProposalV1Schema.parse(raw);
+        if (proposal.contentHash !== contentHashForArtifactV1(proposal)) throw new Error("Registry agent proposal contentHash does not match its canonical contents.");
+        if (proposal.baseSnapshotHash !== snapshot.contentHash || proposal.baseReportHash !== report.contentHash) throw new Error("Registry agent proposal is not based on the supplied snapshot/report hashes.");
+        if (proposal.origin.kind !== "registry-agent" || proposal.origin.id !== metadata.id) throw new Error(`Registry agent proposal origin must be ${metadata.id}.`);
+        if (settings.deterministic) deterministicCache.set(cacheKey, proposal);
+        return proposal;
+      } finally {
+        if (timer) clearTimeout(timer);
+        active -= 1;
+      }
     }
   };
 };
@@ -5832,8 +6205,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);
-  mkdirSync6(join19(resolve16(stateDir), "agents"), { recursive: true });
-  const path = join19(resolve16(stateDir), "agents", `${proposal.origin.id}-${safeHash}.json`);
+  mkdirSync5(join18(resolve16(stateDir), "agents"), { recursive: true });
+  const path = join18(resolve16(stateDir), "agents", `${proposal.origin.id}-${safeHash}.json`);
   writeFileSync6(path, `${JSON.stringify(proposal, null, 2)}
 `, "utf8");
   return path;
@@ -6030,7 +6403,7 @@ var workflowReport = (ctx, runId2) => {
   ensureLatestRun(ctx, runId2);
   return parseReconciliationReport(loadWorkflowStepOutput(workflowStateDir(ctx), "reconcile"));
 };
-var proposalPath = (ctx) => join20(ctx.root, ".doc-bridge", "proposal.json");
+var proposalPath = (ctx) => join19(ctx.root, ".doc-bridge", "proposal.json");
 var readSavedProposal = (ctx, input) => {
   if (input !== void 0) return FixProposalV1Schema.parse(input);
   try {
@@ -6040,7 +6413,7 @@ var readSavedProposal = (ctx, input) => {
   }
 };
 var saveProposal = (ctx, proposal) => {
-  mkdirSync7(join20(ctx.root, ".doc-bridge"), { recursive: true });
+  mkdirSync6(join19(ctx.root, ".doc-bridge"), { recursive: true });
   writeFileSync7(proposalPath(ctx), `${JSON.stringify(proposal, null, 2)}
 `, "utf8");
 };
@@ -6257,11 +6630,13 @@ var startMcpStdioServer = (ctx) => {
 
 // src/reconciliation/reconcile.ts
 var ignoredDocumentationRelations = /* @__PURE__ */ new Set(["covers"]);
+var isInternalEntity = (id) => !id.startsWith("external:") && !id.startsWith("unresolved:");
 var metadataDetection = (relation) => {
   const detection = relation.metadata?.detection;
   return typeof detection === "string" ? detection : void 0;
 };
-var relationDetection = (relation) => relation.discriminator ?? metadataDetection(relation) ?? "static";
+var normalizeDetection = (value) => value === "dynamic-literal" ? "dynamic" : value;
+var relationDetection = (relation) => normalizeDetection(relation.discriminator ?? metadataDetection(relation) ?? "static");
 var entityResolver = (snapshots) => {
   const references = /* @__PURE__ */ new Map();
   const entities = snapshots.flatMap((snapshot) => snapshot.entities).sort((a, b) => a.id.localeCompare(b.id));
@@ -6282,6 +6657,25 @@ var mergeEvidence = (...relations) => {
   }
   return [...merged.values()].sort((a, b) => evidenceKey(a).localeCompare(evidenceKey(b)));
 };
+var boundedEvidence = (evidence2) => [...evidence2].slice(0, 64);
+var diagnosticCounts = (values) => {
+  const counts = /* @__PURE__ */ new Map();
+  for (const value of values) counts.set(value, (counts.get(value) ?? 0) + 1);
+  return Object.fromEntries([...counts.entries()].sort(([a], [b]) => a.localeCompare(b)));
+};
+var documentClass = (entity) => {
+  const classification = entity.metadata?.classification;
+  return typeof classification === "string" && classification.length > 0 ? classification : "unclassified";
+};
+var countDocumentClasses = (documents, selectedIds) => {
+  const counts = /* @__PURE__ */ new Map();
+  for (const document of documents) {
+    if (selectedIds && !selectedIds.has(document.id)) continue;
+    const classification = documentClass(document);
+    counts.set(classification, (counts.get(classification) ?? 0) + 1);
+  }
+  return Object.fromEntries([...counts.entries()].sort(([a], [b]) => a.localeCompare(b)));
+};
 var diagnosticId = (code, value) => `reconciliation:${code}:${sha256NormalizedV1(value).slice(0, 32)}`;
 var coverageAvailable = (snapshot, relation) => {
   const status = snapshot.coverage.find(
@@ -6297,6 +6691,62 @@ var entityById = (snapshots) => {
   return entities;
 };
 var isUnresolved = (id, entities) => id.startsWith("unresolved:") || entities.get(id)?.kind === "unresolved-reference";
+var normalizedPath = (path) => path.replaceAll("\\", "/").replace(/^\.\//, "");
+var semanticEntityId = (id, scope, entities, packageByModule) => {
+  if (scope === "file" || id.startsWith("external:") || id.startsWith("unresolved:")) return id;
+  const entity = entities.get(id);
+  if (!entity || entity.kind !== "module" || !entity.path) return id;
+  if (scope === "module") return id;
+  return packageByModule.get(id) ?? id;
+};
+var packageLookup = (scope, entities) => {
+  if (scope !== "package") return /* @__PURE__ */ new Map();
+  const packages = [...entities.values()].filter((entity) => entity.kind === "package" && entity.path).map((entity) => ({ id: entity.id, path: normalizedPath(entity.path) })).sort((a, b) => b.path.length - a.path.length || a.id.localeCompare(b.id));
+  const result = /* @__PURE__ */ new Map();
+  for (const entity of entities.values()) {
+    if (entity.kind !== "module" || !entity.path) continue;
+    const modulePath = normalizedPath(entity.path);
+    const packageEntity = packages.find(({ path }) => path === "." || modulePath === path || modulePath.startsWith(`${path}/`));
+    if (packageEntity) result.set(entity.id, packageEntity.id);
+  }
+  return result;
+};
+var aggregatedRelations = (relations, scope, entities, packageByModule) => {
+  if (scope === "file") return [...relations];
+  const groups = /* @__PURE__ */ new Map();
+  for (const relation of relations) {
+    const from = semanticEntityId(relation.from, scope, entities, packageByModule);
+    const to = semanticEntityId(relation.to, scope, entities, packageByModule);
+    const detection = relationDetection(relation);
+    const key = `${from}\0${to}\0${relation.kind}\0${detection}`;
+    const group = groups.get(key) ?? [];
+    group.push(relation);
+    groups.set(key, group);
+  }
+  return [...groups.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([key, group]) => {
+    const first = group[0];
+    const parts = key.split("\0");
+    const from = parts[0] ?? first.from;
+    const to = parts[1] ?? first.to;
+    const detection = parts[3] ?? relationDetection(first);
+    const mergedEvidence = mergeEvidence(...group);
+    return {
+      ...first,
+      id: `relation:aggregated:${scope}:${sha256NormalizedV1(key).slice(0, 32)}`,
+      from,
+      to,
+      ...detection === "static" && !first.discriminator ? {} : { discriminator: detection },
+      evidence: boundedEvidence(mergedEvidence),
+      metadata: {
+        ...first.metadata ?? {},
+        aggregationScope: scope,
+        aggregatedRelationCount: group.length,
+        aggregatedEvidenceCount: mergedEvidence.length,
+        ...mergedEvidence.length > 64 ? { evidenceTruncated: true } : {}
+      }
+    };
+  });
+};
 var relationMatches = (observed, declared, resolveEntity2) => {
   if (relationBase(observed, resolveEntity2) !== relationBase(declared, resolveEntity2)) return false;
   return relationDetection(declared) === relationDetection(observed);
@@ -6307,7 +6757,7 @@ var reportDiagnostic = (code, status, severity, message, evidence2, value, entit
   status,
   severity,
   message,
-  evidence: [...evidence2],
+  evidence: boundedEvidence(evidence2),
   ...entityIds?.length ? { entityIds: [...entityIds] } : {},
   ...relationIds?.length ? { relationIds: [...relationIds] } : {},
   ...remediation ? { remediation } : {}
@@ -6315,10 +6765,30 @@ var reportDiagnostic = (code, status, severity, message, evidence2, value, entit
 var reconcileKnowledge = (observed, declared, options = {}) => {
   const resolveEntity2 = entityResolver([observed, declared]);
   const entities = entityById([observed, declared]);
-  const observedRelations = observed.relations.filter((relation) => relation.provenance === "observed" && !ignoredDocumentationRelations.has(relation.kind));
-  const declaredRelations = declared.relations.filter((relation) => relation.provenance === "declared" && !ignoredDocumentationRelations.has(relation.kind));
+  const scope = options.scope ?? "file";
+  const packageByModule = packageLookup(scope, entities);
+  const allDeclaredRelations = declared.relations.filter((relation) => relation.provenance === "declared");
+  const observedRelations = aggregatedRelations(observed.relations.filter((relation) => relation.provenance === "observed" && !ignoredDocumentationRelations.has(relation.kind)), scope, entities, packageByModule);
+  const declaredRelations = aggregatedRelations(declared.relations.filter((relation) => relation.provenance === "declared" && !ignoredDocumentationRelations.has(relation.kind)), scope, entities, packageByModule);
   const requiredRelationKinds = options.requiredRelationKinds === void 0 ? void 0 : new Set(options.requiredRelationKinds);
   const diagnostics = [];
+  if (options.includeOrphanedDocuments) {
+    const declaredDocumentIds = new Set(allDeclaredRelations.map((relation) => relation.from).filter((id) => id.startsWith("document:")));
+    for (const document of observed.entities.filter((entity) => entity.kind === "document").sort((a, b) => a.id.localeCompare(b.id))) {
+      if (declaredDocumentIds.has(document.id)) continue;
+      diagnostics.push(reportDiagnostic(
+        "DOCUMENTATION_ORPHANED",
+        "undocumented",
+        "info",
+        "Markdown document has no Doc Bridge declaration linking it to observed knowledge.",
+        document.evidence,
+        document.id,
+        [document.id],
+        void 0,
+        "Add a docbridge declaration or exclude this document from the documentation comparison scope."
+      ));
+    }
+  }
   for (const entity of declared.entities.filter((item) => isUnresolved(item.id, entities)).sort((a, b) => a.id.localeCompare(b.id))) {
     diagnostics.push(reportDiagnostic(
       "UNRESOLVED_ENTITY_REFERENCE",
@@ -6339,9 +6809,18 @@ var reconcileKnowledge = (observed, declared, options = {}) => {
     group.push(relation);
     declaredByBase.set(base2, group);
   }
+  const observedDetectionsByBase = /* @__PURE__ */ new Map();
+  for (const relation of observedRelations) {
+    const base2 = relationBase(relation, resolveEntity2);
+    const detections = observedDetectionsByBase.get(base2) ?? /* @__PURE__ */ new Set();
+    detections.add(relationDetection(relation));
+    observedDetectionsByBase.set(base2, detections);
+  }
   for (const group of declaredByBase.values()) {
     const detections = new Set(group.map(relationDetection));
     if (detections.size < 2) continue;
+    const observedDetections = observedDetectionsByBase.get(relationBase(group[0], resolveEntity2));
+    if (observedDetections && [...detections].every((detection) => observedDetections.has(detection))) continue;
     diagnostics.push(reportDiagnostic(
       "CONFLICTING_DECLARATIONS",
       "conflict",
@@ -6368,7 +6847,7 @@ var reconcileKnowledge = (observed, declared, options = {}) => {
         void 0,
         [relation.id, match.id]
       ));
-    } else if (coverageAvailable(observed, relation) && (requiredRelationKinds === void 0 || requiredRelationKinds.has(relation.kind))) {
+    } else if (coverageAvailable(observed, relation) && (requiredRelationKinds === void 0 || requiredRelationKinds.has(relation.kind)) && (options.requiredRelationTargets !== "internal" || relation.from !== relation.to && isInternalEntity(relation.from) && isInternalEntity(relation.to))) {
       diagnostics.push(reportDiagnostic(
         "RELATION_UNDOCUMENTED",
         "undocumented",
@@ -6414,6 +6893,33 @@ var reconcileKnowledge = (observed, declared, options = {}) => {
     }
   }
   const sortedDiagnostics = [...diagnostics].sort((a, b) => a.id.localeCompare(b.id));
+  const packageEntities = observed.entities.filter((entity) => entity.kind === "package");
+  const packageStatus = { fresh: 0, stale: 0, missing: 0, unverified: 0 };
+  const diagnosticStatusByEntity = /* @__PURE__ */ new Map();
+  const relationEndpoints = new Map([...observedRelations, ...declaredRelations].map((relation) => [relation.id, [relation.from, relation.to]]));
+  for (const diagnostic2 of sortedDiagnostics) for (const id of [...diagnostic2.entityIds ?? [], ...(diagnostic2.relationIds ?? []).flatMap((relationId) => relationEndpoints.get(relationId) ?? [])]) {
+    const statuses = diagnosticStatusByEntity.get(id) ?? /* @__PURE__ */ new Set();
+    statuses.add(diagnostic2.status);
+    diagnosticStatusByEntity.set(id, statuses);
+  }
+  for (const packageEntity of packageEntities) {
+    const docs = allDeclaredRelations.filter((relation) => relation.from.startsWith("document:") && relation.to === packageEntity.id);
+    const statuses = diagnosticStatusByEntity.get(packageEntity.id) ?? /* @__PURE__ */ new Set();
+    if (!docs.length) packageStatus.missing += 1;
+    else if (statuses.has("conflict") || statuses.has("stale-or-unverified")) packageStatus.stale += 1;
+    else if (statuses.has("undocumented") || statuses.has("unresolved") || statuses.has("not-analyzed")) packageStatus.unverified += 1;
+    else packageStatus.fresh += 1;
+  }
+  const documents = observed.entities.filter((entity) => entity.kind === "document");
+  const documentedDocumentIds = new Set(allDeclaredRelations.filter((relation) => relation.from.startsWith("document:")).map((relation) => relation.from));
+  const documentation = {
+    documentCount: documents.length,
+    documentedDocumentCount: documentedDocumentIds.size,
+    documentClassificationCounts: countDocumentClasses(documents),
+    documentedDocumentClassificationCounts: countDocumentClasses(documents, documentedDocumentIds),
+    packageCount: packageEntities.length,
+    packageStatus
+  };
   const base = {
     type: "reconciliation-report",
     schemaVersion: 1,
@@ -6431,7 +6937,12 @@ var reconcileKnowledge = (observed, declared, options = {}) => {
       entityCount: observed.entities.length,
       relationCount: observedRelations.length,
       diagnosticCount: sortedDiagnostics.length,
-      ...options.requiredRelationKinds === void 0 ? {} : { requiredRelationKinds: [...new Set(options.requiredRelationKinds)].sort() }
+      ...options.scope === void 0 ? {} : { scope: options.scope },
+      ...options.requiredRelationKinds === void 0 ? {} : { requiredRelationKinds: [...new Set(options.requiredRelationKinds)].sort() },
+      ...options.requiredRelationTargets === void 0 ? {} : { requiredRelationTargets: options.requiredRelationTargets },
+      diagnosticsByCode: diagnosticCounts(sortedDiagnostics.map((diagnostic2) => diagnostic2.code)),
+      diagnosticsByStatus: diagnosticCounts(sortedDiagnostics.map((diagnostic2) => diagnostic2.status)),
+      documentation
     }
   };
   return ReconciliationReportV1Schema.parse({ ...base, contentHash: contentHashForArtifactV1(base) });
@@ -6454,6 +6965,7 @@ var reportGroupKey = (entity, appLayout) => {
   return packageFamily(entity);
 };
 var titleCase = (value) => value.split(/[-_]/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+var levelChunkName = (scope, id) => `chunks/levels-${scope}-${sha256NormalizedV1(id).slice(0, 12)}.js`;
 var buildReportViewModel = (snapshot) => {
   const entities = new Map(snapshot.entities.map((entity) => [entity.id, entity]));
   const packages = snapshot.entities.filter((entity) => entity.kind === "package");
@@ -6467,6 +6979,7 @@ var buildReportViewModel = (snapshot) => {
   const appLayout = packages.some((entity) => pathParts(entity.path)[0] === "apps");
   const groups = /* @__PURE__ */ new Map();
   const entityGroup = {};
+  const groupModuleCounts = /* @__PURE__ */ new Map();
   for (const entity of packages) {
     const family = reportGroupKey(entity, appLayout);
     const id = `group:${family}`;
@@ -6483,6 +6996,7 @@ var buildReportViewModel = (snapshot) => {
   for (const [entityId2, packageId2] of packageForEntity) {
     const groupId = entityGroup[packageId2];
     if (groupId) entityGroup[entityId2] = groupId;
+    if (groupId && entities.get(entityId2)?.kind === "module") groupModuleCounts.set(groupId, (groupModuleCounts.get(groupId) ?? 0) + 1);
   }
   if (externalIds.size) {
     const externalGroupId = "group:external-dependencies";
@@ -6524,61 +7038,184 @@ var buildReportViewModel = (snapshot) => {
       nodes: overviewNodes.sort((left, right) => left.name.localeCompare(right.name) || left.id.localeCompare(right.id)),
       edges: [...edgeMap.values()].filter((edge) => overviewNodeIds.has(edge.from) && overviewNodeIds.has(edge.to)).map((edge) => ({ ...edge, kinds: [...edge.kinds].sort(), relationIds: [...edge.relationIds].sort() })).sort((left, right) => right.count - left.count || left.from.localeCompare(right.from) || left.to.localeCompare(right.to))
     },
-    groups: Object.fromEntries([...groups.entries()].map(([id, group]) => [id, { ...group, members: [...group.members].sort() }])),
-    entityGroup
+    groups: Object.fromEntries([...groups.entries()].map(([id, group]) => [id, { ...group, members: [...group.members].sort(), moduleCount: groupModuleCounts.get(id) ?? 0 }])),
+    entityGroup,
+    levelChunks: {
+      default: "chunks/levels-packages.js",
+      groups: Object.fromEntries([...groups.keys()].map((id) => [id, levelChunkName("group", id)])),
+      packages: [...packages].sort((left, right) => left.id.localeCompare(right.id)).map((entity) => levelChunkName("package", entity.id))
+    }
   };
 };
 var escapeHtml = (value) => String(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var anchor = (prefix, value) => `${prefix}-${value.replace(/[^A-Za-z0-9_-]+/g, "-")}`;
 var embeddedJson = (value) => JSON.stringify(value).replaceAll("<", "\\u003c");
-var reportData = (snapshot, report, includeSnippets) => ({
-  project: snapshot.project,
-  revision: snapshot.sourceRevision,
-  revisionKind: snapshot.sourceRevisionKind,
-  snapshotHash: snapshot.contentHash,
-  reportHash: report.contentHash,
-  configurationHash: snapshot.configurationHash,
-  pipelineVersion: snapshot.pipelineVersion,
-  analyzerVersions: snapshot.analyzerVersions,
-  diagnosticCount: report.diagnostics.length,
-  requiredRelationKinds: report.summary.requiredRelationKinds,
-  diagnosticSummary: {
-    errors: report.diagnostics.filter((diagnostic2) => diagnostic2.severity === "error").length,
-    warnings: report.diagnostics.filter((diagnostic2) => diagnostic2.severity === "warn").length,
-    undocumented: report.diagnostics.filter((diagnostic2) => diagnostic2.status === "undocumented").length,
-    drift: report.diagnostics.filter((diagnostic2) => diagnostic2.status === "stale-or-unverified" || diagnostic2.status === "conflict").length
-  },
-  entities: snapshot.entities.map((entity, index) => ({
-    id: entity.id,
-    anchor: entity.id.length > 64 ? `entity-n${index}` : anchor("entity", entity.id),
-    kind: entity.kind,
-    name: entity.name,
-    path: entity.path,
-    provenance: entity.provenance,
-    evidence: entity.evidence.map(({ context, ...item }) => includeSnippets && context ? { ...item, context: redactSecrets(context) } : item)
-  })),
-  relations: snapshot.relations.map((relation) => ({
-    id: relation.id,
-    kind: relation.kind,
-    from: relation.from,
-    to: relation.to,
-    provenance: relation.provenance,
-    evidence: relation.evidence.map(({ context, ...item }) => includeSnippets && context ? { ...item, context: redactSecrets(context) } : item)
-  })),
-  diagnostics: report.diagnostics.map((diagnostic2) => ({
-    id: diagnostic2.id,
-    code: diagnostic2.code,
-    status: diagnostic2.status,
-    severity: diagnostic2.severity,
-    message: diagnostic2.message,
-    entityIds: diagnostic2.entityIds ?? [],
-    relationIds: diagnostic2.relationIds ?? [],
-    remediation: diagnostic2.remediation,
-    evidence: diagnostic2.evidence.map(({ context, ...item }) => includeSnippets && context ? { ...item, context: redactSecrets(context) } : item)
-  })),
-  coverage: snapshot.coverage,
-  view: buildReportViewModel(snapshot)
-});
+var reportData = (snapshot, report, includeSnippets, privacy = "private") => {
+  const evidence2 = (items) => items.map(({ context, ...item }) => includeSnippets && context ? { ...item, context: redactSecrets(context) } : item);
+  const base = {
+    project: snapshot.project,
+    revision: snapshot.sourceRevision,
+    revisionKind: snapshot.sourceRevisionKind,
+    snapshotHash: snapshot.contentHash,
+    reportHash: report.contentHash,
+    configurationHash: snapshot.configurationHash,
+    pipelineVersion: snapshot.pipelineVersion,
+    analyzerVersions: snapshot.analyzerVersions,
+    diagnosticCount: report.diagnostics.length,
+    actionableCount: report.diagnostics.filter((diagnostic2) => diagnostic2.status !== "confirmed").length,
+    confirmedCount: report.diagnostics.filter((diagnostic2) => diagnostic2.status === "confirmed").length,
+    requiredRelationKinds: report.summary.requiredRelationKinds,
+    requiredRelationTargets: report.summary.requiredRelationTargets,
+    documentation: report.summary.documentation,
+    diagnosticSummary: {
+      errors: report.diagnostics.filter((diagnostic2) => diagnostic2.severity === "error").length,
+      warnings: report.diagnostics.filter((diagnostic2) => diagnostic2.severity === "warn").length,
+      undocumented: report.diagnostics.filter((diagnostic2) => diagnostic2.status === "undocumented").length,
+      drift: report.diagnostics.filter((diagnostic2) => diagnostic2.status === "stale-or-unverified" || diagnostic2.status === "conflict").length
+    },
+    entities: snapshot.entities.map((entity, index) => ({
+      id: entity.id,
+      anchor: entity.id.length > 64 ? `entity-n${index}` : anchor("entity", entity.id),
+      kind: entity.kind,
+      name: entity.name,
+      path: entity.path,
+      provenance: entity.provenance,
+      evidence: evidence2(entity.evidence)
+    })),
+    relations: snapshot.relations.map((relation) => ({
+      id: relation.id,
+      kind: relation.kind,
+      from: relation.from,
+      to: relation.to,
+      provenance: relation.provenance,
+      evidence: evidence2(relation.evidence)
+    })),
+    diagnostics: report.diagnostics.map((diagnostic2) => ({
+      id: diagnostic2.id,
+      code: diagnostic2.code,
+      status: diagnostic2.status,
+      severity: diagnostic2.severity,
+      message: diagnostic2.message,
+      entityIds: diagnostic2.entityIds ?? [],
+      relationIds: diagnostic2.relationIds ?? [],
+      remediation: diagnostic2.remediation,
+      evidence: evidence2(diagnostic2.evidence)
+    })),
+    coverage: snapshot.coverage,
+    view: buildReportViewModel(snapshot)
+  };
+  if (privacy !== "anonymized") return base;
+  const pad = (value) => String(value).padStart(3, "0");
+  const sortedEntities = [...base.entities].sort((left, right) => left.id.localeCompare(right.id));
+  const entityOrdinals = /* @__PURE__ */ new Map();
+  const entityIds = new Map(sortedEntities.map((entity) => {
+    const next = (entityOrdinals.get(entity.kind) ?? 0) + 1;
+    entityOrdinals.set(entity.kind, next);
+    return [entity.id, `entity:${entity.kind}-${pad(next)}`];
+  }));
+  const entityNames = /* @__PURE__ */ new Map();
+  const nameFor = (kind) => {
+    const prefix = kind === "external" ? "dependency" : kind;
+    const next = (entityNames.get(prefix) ?? 0) + 1;
+    entityNames.set(prefix, next);
+    return `${prefix}-${pad(next)}`;
+  };
+  const sortedRelations = [...base.relations].sort((left, right) => left.id.localeCompare(right.id));
+  const relationIds = new Map(sortedRelations.map((relation, index) => [relation.id, `relation:${pad(index + 1)}`]));
+  const sortedDiagnostics = [...base.diagnostics].sort((left, right) => left.id.localeCompare(right.id));
+  const diagnosticIds = new Map(sortedDiagnostics.map((diagnostic2, index) => [diagnostic2.id, `finding:${pad(index + 1)}`]));
+  const genericEvidence = (items) => items.map((item, index) => ({
+    source: item.source,
+    path: `evidence-${pad(index + 1)}`,
+    ...item.lineStart === void 0 ? {} : { lineStart: item.lineStart },
+    ...item.lineEnd === void 0 ? {} : { lineEnd: item.lineEnd }
+  }));
+  const groups = Object.entries(base.view.groups).sort(([left], [right]) => left.localeCompare(right));
+  const groupIds = new Map(groups.map(([id], index) => [id, `group:${pad(index + 1)}`]));
+  const groupNames = /* @__PURE__ */ new Map();
+  const groupName = (kind) => {
+    if (kind === "external") return "External dependencies";
+    if (kind === "shared") return "Shared packages";
+    if (kind === "workspace") return "Workspace";
+    const next = (groupNames.get(kind) ?? 0) + 1;
+    groupNames.set(kind, next);
+    return `${kind.charAt(0).toUpperCase()}${kind.slice(1)} ${next}`;
+  };
+  const sanitizedGroups = Object.fromEntries(groups.map(([id, group]) => [groupIds.get(id), {
+    kind: group.kind,
+    name: groupName(group.kind),
+    path: void 0,
+    members: group.members.map((member) => entityIds.get(member)),
+    moduleCount: group.moduleCount
+  }]));
+  const sanitizedOverviewNodes = base.view.overview.nodes.map((node) => ({
+    id: groupIds.get(node.id),
+    kind: node.kind,
+    name: sanitizedGroups[groupIds.get(node.id)]?.name ?? "Scope",
+    path: void 0,
+    memberCount: node.memberCount
+  }));
+  const sanitizedView = {
+    overview: {
+      nodes: sanitizedOverviewNodes,
+      edges: base.view.overview.edges.map((edge) => ({
+        from: groupIds.get(edge.from),
+        to: groupIds.get(edge.to),
+        count: edge.count,
+        kinds: edge.kinds,
+        relationIds: edge.relationIds.map((id) => relationIds.get(id))
+      }))
+    },
+    groups: sanitizedGroups,
+    entityGroup: Object.fromEntries(Object.entries(base.view.entityGroup).map(([id, group]) => [entityIds.get(id), groupIds.get(group)])),
+    levelChunks: {
+      default: base.view.levelChunks.default,
+      groups: Object.fromEntries([...groupIds.values()].map((id) => [id, levelChunkName("group", id)])),
+      packages: [...entityIds.values()].filter((id) => id.startsWith("entity:package-")).sort().map((id) => levelChunkName("package", id))
+    }
+  };
+  return {
+    ...base,
+    project: { name: "Anonymized repository" },
+    revision: "redacted",
+    entities: base.entities.map((entity) => ({
+      id: entityIds.get(entity.id),
+      anchor: anchor("entity", entityIds.get(entity.id)),
+      kind: entity.kind,
+      name: nameFor(entity.kind),
+      path: void 0,
+      provenance: entity.provenance,
+      evidence: genericEvidence(entity.evidence)
+    })),
+    relations: base.relations.map((relation) => ({
+      id: relationIds.get(relation.id),
+      kind: relation.kind,
+      from: entityIds.get(relation.from),
+      to: entityIds.get(relation.to),
+      provenance: relation.provenance,
+      evidence: genericEvidence(relation.evidence)
+    })),
+    diagnostics: base.diagnostics.map((diagnostic2) => ({
+      id: diagnosticIds.get(diagnostic2.id),
+      code: diagnostic2.code,
+      status: diagnostic2.status,
+      severity: diagnostic2.severity,
+      message: `Finding ${diagnostic2.code}`,
+      entityIds: diagnostic2.entityIds?.map((id) => entityIds.get(id)) ?? [],
+      relationIds: diagnostic2.relationIds?.map((id) => relationIds.get(id)) ?? [],
+      evidence: genericEvidence(diagnostic2.evidence)
+    })),
+    coverage: base.coverage.map((entry, index) => ({
+      analyzer: entry.analyzer,
+      analyzerVersion: entry.analyzerVersion,
+      scope: `scope-${pad(index + 1)}`,
+      status: entry.status,
+      ...entry.reason ? { reason: "Coverage boundary reported by analyzer." } : {},
+      ...entry.evidence ? { evidence: genericEvidence(entry.evidence) } : {}
+    })),
+    view: sanitizedView
+  };
+};
 var styles = String.raw`
 :root{color-scheme:light;--ink:#17251f;--muted:#60706a;--paper:#f5f7f3;--panel:#fff;--line:#d9e0da;--green:#18794e;--blue:#236b83;--amber:#a9640b;--red:#b33c35;--shadow:0 12px 32px rgba(23,37,31,.08)}
 *{box-sizing:border-box}body{margin:0;background:var(--paper);color:var(--ink);font:14px/1.5 Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif}button,input,select{font:inherit}button{cursor:pointer}a{color:var(--blue)}.shell{max-width:1500px;margin:auto;padding:24px}.masthead{display:flex;justify-content:space-between;gap:24px;align-items:flex-end;border-bottom:1px solid var(--line);padding:8px 0 24px}.eyebrow{color:var(--green);font-size:11px;font-weight:800;letter-spacing:.12em;text-transform:uppercase}.masthead h1{font:700 clamp(28px,4vw,52px)/1.03 Georgia,serif;letter-spacing:-.04em;margin:8px 0}.lede{color:var(--muted);font-size:16px;max-width:720px;margin:0}.run-meta{text-align:right;color:var(--muted);font-size:12px}.run-meta strong{display:block;color:var(--green);font-size:14px}.read-only{border:1px solid #b9d7c6;background:#edf8f0;color:#185b3b;border-radius:999px;display:inline-flex;padding:4px 10px;font-weight:700;font-size:12px}.summary{display:grid;grid-template-columns:repeat(5,minmax(0,1fr));gap:10px;margin:20px 0}.metric,.insight,.panel{background:var(--panel);border:1px solid var(--line);box-shadow:var(--shadow);border-radius:14px}.metric{padding:16px}.metric b{font-size:27px;display:block;line-height:1}.metric span{color:var(--muted);display:block;margin-top:7px}.metric.warn b{color:var(--amber)}.metric.bad b{color:var(--red)}.lens-bar{display:flex;align-items:center;justify-content:space-between;gap:14px;margin:22px 0 12px}.tabs{display:flex;gap:4px;flex-wrap:wrap}.tab,.level{border:1px solid transparent;background:transparent;border-radius:8px;padding:8px 11px;color:var(--muted)}.tab:hover,.level:hover{background:#e8eee9;color:var(--ink)}.tab[aria-selected=true],.level[aria-pressed=true]{background:var(--ink);color:#fff}.filters{display:flex;gap:8px;flex-wrap:wrap;margin:12px 0}.filters label{color:var(--muted);font-size:12px;display:flex;align-items:center;gap:6px}.filters input,.filters select,.filters button{border:1px solid var(--line);background:#fff;border-radius:8px;padding:8px 10px;color:var(--ink)}.filters input{min-width:220px}.filters button{color:var(--blue)}.insights{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:10px;margin:14px 0 20px}.insight{padding:14px}.insight h3{font-size:13px;margin:0 0 5px}.insight p{color:var(--muted);margin:0;font-size:12px}.tag{display:inline-block;border-radius:999px;padding:2px 7px;font-size:10px;font-weight:800;letter-spacing:.04em;text-transform:uppercase;background:#edf0ee;color:var(--muted)}.tag.heuristic{background:#fff3dc;color:#8a570a}.tag.error{background:#fde8e6;color:var(--red)}.tag.warn{background:#fff2d9;color:var(--amber)}.tag.info{background:#e6f1f5;color:var(--blue)}.workspace{display:grid;grid-template-columns:minmax(0,1fr) 320px;gap:14px}.panel{padding:18px}.panel h2{font:700 23px Georgia,serif;margin:0}.panel h3{font-size:14px;margin:0}.panel-head{display:flex;justify-content:space-between;gap:12px;align-items:flex-start;margin-bottom:14px}.subtle{color:var(--muted);font-size:12px}.map-wrap{border:1px solid var(--line);border-radius:10px;overflow:auto;background:linear-gradient(135deg,#fbfcfa,#f0f5f0)}#graph{display:block;width:100%;min-width:760px;height:560px}.edge{stroke:#b8c6bd;stroke-width:1.3;opacity:.65}.edge.alert{stroke:#d08a35;stroke-width:2}.edge-label{fill:var(--muted);font-size:10px}.graph-node{cursor:pointer}.graph-node rect{fill:#fff;stroke:#9eb0a4;stroke-width:1.2}.graph-node:hover rect,.graph-node:focus rect{stroke:var(--blue);stroke-width:2}.graph-node.selected rect{stroke:var(--green);stroke-width:3}.graph-node.issue rect{fill:#fffaf0;stroke:#c98a2c}.graph-node text{pointer-events:none}.node-label{font-size:12px;font-weight:750}.node-kind{font-size:10px;fill:var(--muted)}.node-count{font-size:10px;fill:var(--green);font-weight:800}.empty{padding:32px;text-align:center;color:var(--muted)}.side{position:sticky;top:14px;align-self:start}.detail-title{font:700 22px Georgia,serif;margin:4px 0}.detail-grid{display:grid;grid-template-columns:1fr 1fr;gap:10px;border-top:1px solid var(--line);border-bottom:1px solid var(--line);padding:12px 0;margin:14px 0}.detail-grid b{display:block;font-size:19px}.detail-grid span{color:var(--muted);font-size:11px}.path{overflow-wrap:anywhere;color:var(--muted);font-size:12px}.list{list-style:none;margin:10px 0 0;padding:0}.list li{border-top:1px solid var(--line);padding:8px 0;font-size:12px}.run{margin-top:14px}.run-summary{display:flex;gap:8px;flex-wrap:wrap;margin:12px 0}.chip{border:1px solid var(--line);border-radius:999px;padding:5px 9px;color:var(--muted);font-size:12px}.chip b{color:var(--ink)}.finding{border-top:1px solid var(--line);padding:14px 0}.finding-head{display:flex;justify-content:space-between;gap:10px}.finding h3{margin:0;font-size:14px}.finding p{margin:5px 0;color:var(--muted)}.finding ul{margin:8px 0 0;padding-left:18px;color:var(--muted);font-size:12px}.coverage-row{display:grid;grid-template-columns:170px 1fr 90px;gap:10px;align-items:center;border-top:1px solid var(--line);padding:10px 0;font-size:12px}.bar{height:7px;background:#e7ece8;border-radius:99px;overflow:hidden}.bar i{display:block;height:100%;background:var(--green)}.bar i.partial{background:var(--amber)}.bar i.none{background:var(--red)}.metadata{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:10px;margin-top:14px}.metadata div{border-top:1px solid var(--line);padding-top:8px;color:var(--muted);font-size:12px;overflow-wrap:anywhere}.metadata b{display:block;color:var(--ink);font-size:11px;text-transform:uppercase;letter-spacing:.08em;margin-bottom:3px}.hidden{display:none!important}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}@media(max-width:900px){.summary{grid-template-columns:repeat(3,minmax(0,1fr))}.insights{grid-template-columns:repeat(2,minmax(0,1fr))}.workspace{grid-template-columns:1fr}.side{position:static}.run-meta{display:none}}@media(max-width:560px){.shell{padding:14px}.summary{grid-template-columns:repeat(2,minmax(0,1fr))}.insights{grid-template-columns:1fr}.masthead{display:block}.filters input{min-width:0;width:100%}.filters label:first-child{width:100%}.metadata{grid-template-columns:1fr}}@media(prefers-reduced-motion:reduce){*{scroll-behavior:auto!important;transition:none!important}}@media(prefers-color-scheme:dark){:root{color-scheme:dark;--ink:#edf5ef;--muted:#a8b8ae;--paper:#111815;--panel:#18221d;--line:#304037;--green:#6dd19c;--blue:#7dc4dc;--amber:#efb866;--red:#f08a80;--shadow:0 12px 32px rgba(0,0,0,.24)}.map-wrap{background:linear-gradient(135deg,#19231d,#101611)}.filters input,.filters select,.filters button{background:#1d2922;color:var(--ink)}.graph-node rect{fill:#1b2820;stroke:#719080}.graph-node.issue rect{fill:#332c1d}}
@@ -6587,76 +7224,86 @@ styles += String.raw`
 :root{--ink:#182b2b;--muted:#536664;--paper:#efe9df;--panel:#f8f5ee;--line:#c8c8b9;--green:#176b51;--blue:#155a68;--amber:#93530b;--red:#9b302b;--shadow:none}
 *{box-sizing:border-box}body{background:var(--paper);font-family:"Avenir Next","Segoe UI",ui-sans-serif,system-ui,sans-serif;font-size:14px;line-height:1.5}.shell{max-width:1720px;padding:30px clamp(20px,4vw,64px) 56px}.masthead{align-items:flex-start;border-bottom:2px solid var(--ink);padding:4px 0 28px}.masthead>div:first-child{max-width:840px}.eyebrow{font-size:10px;letter-spacing:.16em}.masthead h1{font-family:"Iowan Old Style",Georgia,serif;font-size:clamp(3rem,7vw,7.2rem);letter-spacing:-.075em;line-height:.9;margin:16px 0 20px}.lede{font-size:17px;line-height:1.45;max-width:650px}.run-meta{padding-top:3px;min-width:210px}.read-only{border:0;border-radius:0;padding:0;background:none;color:var(--green);font-size:10px;letter-spacing:.1em;text-transform:uppercase}.run-meta strong{color:var(--ink);font-size:12px;overflow-wrap:anywhere;margin-top:16px}.summary{grid-template-columns:repeat(5,minmax(0,1fr));gap:0;margin:0;padding:18px 0 22px;border-bottom:1px solid var(--line)}.metric{border:0;border-left:1px solid var(--line);border-radius:0;background:none;box-shadow:none;padding:0 18px}.metric:first-child{border-left:0;padding-left:0}.metric b{font-family:"Iowan Old Style",Georgia,serif;font-size:38px;letter-spacing:-.05em}.metric span{font-size:11px;letter-spacing:.07em;text-transform:uppercase}.lens-bar{align-items:flex-end;margin:42px 0 6px}.tabs{gap:0}.tab,.level{border:0;border-bottom:2px solid transparent;border-radius:0;background:transparent;color:var(--muted);padding:8px 14px;min-height:38px;font-weight:700}.tab:first-child,.level:first-child{padding-left:0}.tab:hover,.level:hover{background:none;color:var(--ink);border-color:var(--line)}.tab[aria-selected=true],.level[aria-pressed=true]{background:none;color:var(--ink);border-color:var(--green)}.lens-bar>.subtle{max-width:430px;text-align:right}.filters{border-block:1px solid var(--line);padding:14px 0;margin:12px 0 24px}.filters input,.filters select,.filters button{border:1px solid var(--line);border-radius:3px;background:var(--panel);min-height:38px}.filters button{font-weight:700}.insights{grid-template-columns:repeat(4,minmax(0,1fr));gap:0;border-top:1px solid var(--line);border-bottom:1px solid var(--line);margin:18px 0 30px}.insight{border:0;border-left:1px solid var(--line);border-radius:0;background:none;box-shadow:none;padding:14px 16px 16px}.insight:first-child{border-left:0;padding-left:0}.insight h3{font-size:12px;letter-spacing:.02em}.insight p{font-size:13px}.tag{border-radius:2px;padding:2px 5px;font-size:9px}.workspace{grid-template-columns:minmax(0,1fr) 350px;gap:24px}.panel{border:1px solid var(--line);border-radius:3px;background:var(--panel);box-shadow:none;padding:24px}.panel h2{font-family:"Iowan Old Style",Georgia,serif;font-size:30px;letter-spacing:-.04em}.map-wrap{border:1px solid #aeb9ae;border-radius:2px;background-color:#e8eee7;background-image:linear-gradient(rgba(24,43,43,.07) 1px,transparent 1px),linear-gradient(90deg,rgba(24,43,43,.07) 1px,transparent 1px);background-size:24px 24px}.map-wrap::-webkit-scrollbar{height:10px}.map-wrap::-webkit-scrollbar-thumb{background:var(--line)}#graph{height:620px}.graph-node rect{fill:#f8f5ee;stroke:#274744;stroke-width:1.4;rx:2}.graph-node:hover rect,.graph-node:focus rect{stroke:var(--blue);stroke-width:2.5}.graph-node.selected rect{fill:#dceee1;stroke:var(--green);stroke-width:3}.graph-node.issue rect{fill:#fff0d4;stroke:var(--amber)}.edge{stroke:#69857d;stroke-width:1.5;opacity:.8}.edge.alert{stroke:var(--amber);stroke-width:2.5}.edge-label{fill:var(--ink);font-size:10px;font-weight:700}.node-label{font-size:12px;font-weight:800}.node-kind{font-size:10px;fill:var(--muted)}.node-count{font-size:10px;fill:var(--green);font-weight:800}.side{top:20px}.side .panel-head{border-bottom:1px solid var(--line);padding-bottom:14px}.detail-title{font-family:"Iowan Old Style",Georgia,serif;font-size:28px}.detail-grid{gap:0}.detail-grid>div{border-left:1px solid var(--line);padding-left:10px}.detail-grid>div:nth-child(odd){border-left:0;padding-left:0}.detail-grid b{font-family:"Iowan Old Style",Georgia,serif;font-size:26px}.run{margin-top:24px}.run-summary{border-bottom:1px solid var(--line);padding-bottom:12px}.chip{border:0;border-left:1px solid var(--line);border-radius:0;padding:2px 10px}.chip:first-child{border-left:0;padding-left:0}.finding-groups{grid-template-columns:repeat(2,minmax(0,1fr));gap:0}.finding-group{border:0;border-top:1px solid var(--line);border-radius:0;background:none;padding:16px 14px 16px 0}.finding-group:nth-child(even){padding-left:14px;border-left:1px solid var(--line)}.finding-group h3{font-size:13px;letter-spacing:.02em}.finding-detail{border-top:2px solid var(--ink)}.finding{padding:16px 0}.metadata{gap:24px;margin-top:26px}.metadata div{border-top:1px solid var(--line);padding-top:9px}.map-wrap,.panel,.finding-group,.insight{transition:background-color .16s ease,border-color .16s ease}@media(max-width:900px){.masthead{display:block}.run-meta{padding-top:24px;text-align:left}.summary{grid-template-columns:repeat(3,minmax(0,1fr));row-gap:18px}.metric:nth-child(4){border-left:0;padding-left:0}.workspace{grid-template-columns:1fr}.side{position:static}.lens-bar{display:block}.lens-bar>.subtle{text-align:left;margin-top:10px}.finding-groups{grid-template-columns:1fr}.finding-group:nth-child(even){padding-left:0;border-left:0}}@media(max-width:560px){.shell{padding:20px 16px 40px}.masthead h1{font-size:clamp(3rem,16vw,5rem)}.summary{grid-template-columns:repeat(2,minmax(0,1fr))}.metric:nth-child(odd){border-left:0;padding-left:0}.metric:nth-child(even){border-left:1px solid var(--line);padding-left:12px}.insights{grid-template-columns:1fr}.insight,.insight:first-child{border-left:0;border-top:1px solid var(--line);padding-left:0}.insight:first-child{border-top:0}.panel{padding:16px}.panel-head{display:block}.panel-head>.tabs{margin-top:12px}.filters label{width:100%}.filters input,.filters select{width:100%}.metadata{grid-template-columns:1fr}}@media(prefers-reduced-motion:reduce){.map-wrap,.panel,.finding-group,.insight{transition:none}}@media(prefers-color-scheme:dark){:root{--ink:#e8eee7;--muted:#b0beb3;--paper:#131c1a;--panel:#1b2824;--line:#42534b;--green:#72d09d;--blue:#86cfe1;--amber:#f0bc6b;--red:#ff9186}.map-wrap{background-color:#17231e;background-image:linear-gradient(rgba(232,238,231,.07) 1px,transparent 1px),linear-gradient(90deg,rgba(232,238,231,.07) 1px,transparent 1px)}.graph-node rect{fill:#1c2b25;stroke:#90aa99}.graph-node.selected rect{fill:#294936}.graph-node.issue rect{fill:#40321e}.filters input,.filters select,.filters button{background:#202f29;color:var(--ink)}}
 `;
-styles += String.raw`.graph-node .node-label,.graph-node text.node-label{fill:var(--ink)}.graph-node .node-kind{fill:var(--muted)}.edge-label{fill:var(--ink)}@media(max-width:1100px){.workspace{grid-template-columns:1fr}.side{position:static}.map-wrap #graph{min-width:0!important;width:100%!important}.panel-head>.tabs{margin-top:12px}}@media(max-width:700px){.summary{grid-template-columns:repeat(2,minmax(0,1fr))}.lens-bar{display:block}.lens-bar>.subtle{text-align:left;margin-top:10px}.filters label{width:100%}.filters input,.filters select{width:100%}.finding-groups{grid-template-columns:1fr}.finding-group:nth-child(even){padding-left:0;border-left:0}}`;
-styles += String.raw`.level{display:none!important}.report-tabs{display:flex;gap:0;align-items:flex-end;border-bottom:1px solid var(--line);margin:24px 0 0}.report-tabs .tab{font-size:13px}.breadcrumbs{display:flex;gap:6px;align-items:center;flex-wrap:wrap;margin:0 0 14px;color:var(--muted);font-size:12px}.breadcrumbs button{border:0;background:none;color:var(--blue);padding:3px 0;font-weight:700}.breadcrumbs button:hover{text-decoration:underline}.breadcrumbs .current{color:var(--ink);font-weight:700}.scope-note{margin:0 0 12px}.report-dashboard{display:grid;grid-template-columns:minmax(0,1.35fr) minmax(280px,1fr);gap:24px}.report-table{width:100%;border-collapse:collapse;font-size:12px}.report-table th,.report-table td{border-top:1px solid var(--line);padding:10px 8px;text-align:left;vertical-align:top}.report-table th{color:var(--muted);font-size:10px;letter-spacing:.08em;text-transform:uppercase}.report-table td:first-child{font-weight:750}.bar-list{display:grid;gap:10px}.bar-item{display:grid;grid-template-columns:minmax(120px,1fr) 2fr auto;gap:10px;align-items:center;font-size:12px}.bar-item i{height:8px;background:var(--line);display:block;overflow:hidden}.bar-item i b{display:block;height:100%;background:var(--green)}.map-wrap{touch-action:none;cursor:grab}.map-wrap.dragging{cursor:grabbing}@media(max-width:700px){.report-tabs{overflow:auto}.report-tabs .tab{white-space:nowrap}.report-dashboard{grid-template-columns:1fr}.bar-item{grid-template-columns:minmax(100px,1fr) 1fr auto}}`;
+styles += String.raw`.graph-node .node-label,.graph-node text.node-label{fill:var(--ink)}.graph-node .node-kind{fill:var(--muted)}.edge-label{fill:var(--ink)}.panel-head>div:first-child{min-width:0;flex:1 1 0}.panel-head>.tabs:not(.report-tabs){flex-wrap:nowrap;max-width:100%;overflow-x:auto}.panel-head>.tabs:not(.report-tabs) .level{flex:0 0 auto}@media(max-width:1100px){.workspace{grid-template-columns:1fr}.side{position:static}.map-wrap #graph{min-width:0!important;width:100%!important}.panel-head>.tabs{margin-top:12px}}@media(max-width:700px){.summary{grid-template-columns:repeat(2,minmax(0,1fr))}.lens-bar{display:block}.lens-bar>.subtle{text-align:left;margin-top:10px}.filters label{width:100%}.filters input,.filters select{width:100%}.finding-groups{grid-template-columns:1fr}.finding-group:nth-child(even){padding-left:0;border-left:0}}`;
+styles += String.raw`.report-tabs{display:flex;gap:0;align-items:flex-end;border-bottom:1px solid var(--line);margin:24px 0 0}.report-tabs .tab{font-size:13px}.breadcrumbs{display:flex;gap:6px;align-items:center;flex-wrap:wrap;margin:0 0 14px;color:var(--muted);font-size:12px}.breadcrumbs button{border:0;background:none;color:var(--blue);padding:3px 0;font-weight:700}.breadcrumbs button:hover{text-decoration:underline}.breadcrumbs .current{color:var(--ink);font-weight:700}.scope-note{margin:0 0 12px}.report-dashboard{display:grid;grid-template-columns:minmax(0,1.35fr) minmax(280px,1fr);gap:24px}.report-table{width:100%;border-collapse:collapse;font-size:12px}.report-table th,.report-table td{border-top:1px solid var(--line);padding:10px 8px;text-align:left;vertical-align:top}.report-table th{color:var(--muted);font-size:10px;letter-spacing:.08em;text-transform:uppercase}.report-table td:first-child{font-weight:750}.bar-list{display:grid;gap:10px}.bar-item{display:grid;grid-template-columns:minmax(120px,1fr) 2fr auto;gap:10px;align-items:center;font-size:12px}.bar-item i{height:8px;background:var(--line);display:block;overflow:hidden}.bar-item i b{display:block;height:100%;background:var(--green)}.map-wrap{touch-action:none;cursor:grab}.map-wrap.dragging{cursor:grabbing}@media(max-width:700px){.report-tabs{overflow:auto}.report-tabs .tab{white-space:nowrap}.report-dashboard{grid-template-columns:1fr}.bar-item{grid-template-columns:minmax(100px,1fr) 1fr auto}}`;
 styles += String.raw`body[data-report-view="architecture"] #insights,body[data-report-view="architecture"] .filters,body[data-report-view="architecture"] .run,body[data-report-view="architecture"] .metadata{display:none}body[data-report-view="insights"] .workspace,body[data-report-view="insights"] .filters,body[data-report-view="insights"] .run,body[data-report-view="insights"] .metadata{display:none}body[data-report-view="findings"] .workspace,body[data-report-view="findings"] #insights,body[data-report-view="findings"] #report-dashboard,body[data-report-view="findings"] #coverage-title,body[data-report-view="findings"] #coverage-title~*{display:none}body[data-report-view="findings"] .run[aria-labelledby="coverage-title"]{display:none}body[data-report-view="coverage"] .workspace,body[data-report-view="coverage"] #insights,body[data-report-view="coverage"] #report-dashboard,body[data-report-view="coverage"] .filters,body[data-report-view="coverage"] .run[aria-labelledby="run-title"],body[data-report-view="coverage"] .metadata{display:none}body[data-report-view="insights"] #report-dashboard{display:block}body[data-report-view="map"] #report-dashboard{display:none}`;
 styles += String.raw`body[data-report-view="architecture"] #report-dashboard{display:none!important}.edge{fill:none}`;
 styles += String.raw`:root{--ink:#17251f;--muted:#586b63;--paper:#f2f5f1;--panel:#fbfcf9;--line:#c9d5cc;--green:#13734a;--blue:#155f78;--amber:#995d08;--red:#a52e2b}html,body{max-width:100%;overflow-x:hidden}body{font-size:15px;line-height:1.55}.shell{width:100%;max-width:1600px;margin:0 auto;padding:28px clamp(16px,3vw,48px) 56px}.masthead{gap:32px;padding:0 0 24px;align-items:flex-start}.masthead h1{font-size:clamp(2.8rem,5.5vw,5.4rem);line-height:.94;margin:12px 0 16px;max-width:100%;overflow-wrap:anywhere}.lede{max-width:60ch;font-size:16px}.run-meta{min-width:0;max-width:300px}.summary{margin:0;padding:18px 0 20px;grid-template-columns:repeat(5,minmax(0,1fr));gap:0}.metric{min-width:0;padding:0 16px;border-inline-start:1px solid var(--line)}.metric:first-child{padding-inline-start:0;border-inline-start:0}.metric b{font-size:clamp(1.8rem,3vw,3rem);max-width:100%;overflow-wrap:anywhere}.metric span{font-size:10px;letter-spacing:.06em;line-height:1.25}.lens-bar{margin:24px 0 4px;align-items:flex-end}.lens-bar>.subtle{max-width:52ch}.report-tabs{max-width:100%;overflow-x:auto}.tab,.level{min-height:40px;padding:8px 12px}.filters{max-width:100%;align-items:center}.filters label{min-width:0}.filters input,.filters select{max-width:100%;min-width:0}.workspace{min-width:0;grid-template-columns:minmax(0,1fr) minmax(280px,340px);gap:20px}.panel{min-width:0}.map-wrap{min-width:0;max-width:100%;width:100%;overflow:hidden;contain:layout paint}#graph{display:block;width:100%!important;min-width:0!important;max-width:100%;height:clamp(480px,60vh,680px)!important}.side{min-width:0}.detail-title,.path,.list,.finding,.finding-group,.report-table{min-width:0;overflow-wrap:anywhere}.report-dashboard{min-width:0}.report-table{table-layout:fixed}.report-table th,.report-table td{overflow-wrap:anywhere}.bar-item{min-width:0}.bar-item span{min-width:0;overflow-wrap:anywhere}.tab:focus-visible,.level:focus-visible,input:focus-visible,select:focus-visible{outline:3px solid var(--blue);outline-offset:2px}@media(max-width:1100px){.workspace{grid-template-columns:1fr}.side{position:static}.summary{grid-template-columns:repeat(3,minmax(0,1fr));row-gap:16px}.summary .metric:nth-child(4){border-inline-start:0;padding-inline-start:0}}@media(max-width:700px){.shell{padding:12px 16px 32px}.masthead{padding-bottom:14px}.masthead h1{font-size:clamp(2.2rem,11vw,3.4rem);margin:6px 0 10px}.lede{font-size:14px;line-height:1.35}.run-meta{display:none}.summary{padding:10px 0 12px;grid-template-columns:repeat(2,minmax(0,1fr));row-gap:8px}.summary .metric:nth-child(even){border-inline-start:1px solid var(--line);padding-inline-start:12px}.summary .metric:nth-child(odd){border-inline-start:0;padding-inline-start:0}.metric{padding-inline:10px}.metric b{font-size:1.65rem}.lens-bar{display:block;margin-top:14px}.lens-bar>.subtle{display:none}.filters{display:grid;grid-template-columns:1fr;gap:10px}.filters label{display:grid;grid-template-columns:1fr;gap:5px}.filters input,.filters select,.filters button{width:100%;min-height:44px}.panel{padding:16px}.panel-head{display:block}.panel-head>.tabs{margin-top:12px}.finding-groups{grid-template-columns:1fr}.report-dashboard{grid-template-columns:1fr}#graph{height:520px!important}.lens-bar + #lens-caption{margin:8px 0}.lens-bar + #lens-caption + #insights{margin-top:8px}}@media(prefers-color-scheme:dark){:root{--ink:#edf5ef;--muted:#b7c6ba;--paper:#111815;--panel:#1a2821;--line:#405248;--green:#73d19d;--blue:#8bd1e6;--amber:#f0bd70;--red:#ff9389}}`;
 styles += String.raw`@media(max-width:700px){.map-wrap{overflow:auto;contain:layout paint}#graph{width:720px!important;min-width:720px!important;max-width:none!important}}`;
+styles += String.raw`.map-wrap.dense{overflow:auto}.map-wrap.dense #graph{width:2000px!important;max-width:none!important}`;
 styles += String.raw`#lens-caption + p.subtle{display:none}`;
 var script = String.raw`
 const data=${"${DATA}"};
 data.entities=data.entities||[];data.relations=data.relations||[];data.diagnostics=data.diagnostics||[];
-const policySuffix=data.requiredRelationKinds===undefined?"Policy: all observed relation kinds require declarations.":data.requiredRelationKinds.length?"Policy: declarations required for "+data.requiredRelationKinds.join(", ")+".":"Policy: missing relation declarations disabled; stale, conflicting, and unresolved declarations remain checked.";
+globalThis.__DOC_BRIDGE_DATA__=data;
+const policySuffix=data.requiredRelationKinds===undefined?"Policy: all observed relation kinds require declarations.":data.requiredRelationKinds.length?"Policy: declarations required for "+data.requiredRelationKinds.join(", ")+(data.requiredRelationTargets==="internal"?" between internal entities":"")+".":"Policy: missing relation declarations disabled; stale, conflicting, and unresolved declarations remain checked.";
 const ensurePolicyNote=()=>{const note=document.querySelector("#map-note");if(note&&!note.textContent.includes(policySuffix))note.textContent=(note.textContent+" · "+policySuffix).trim()};
 new MutationObserver(ensurePolicyNote).observe(document.querySelector("#map-note"),{childList:true,characterData:true});
-const lazyChunks=globalThis.__DOC_BRIDGE_LAZY_CHUNKS__||[],loadedChunks=new Set(),loadingChunks=new Map();
+const lazyChunks=globalThis.__DOC_BRIDGE_LAZY_CHUNKS__||[],hasLevelChunks=globalThis.__DOC_BRIDGE_HAS_LEVEL_CHUNKS__===true,loadedChunks=new Set(),loadingChunks=new Map();
 const esc=(value)=>String(value??"").replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll("\"","&quot;").replaceAll("'","&#39;");
-const byId=new Map(),parent=new Map(),relationById=new Map(),packageMembers=new Map(),findingIndex=new Map(),relationFindingIndex=new Map(),relationsByEntity=new Map(),groupEntityIds=new Map(),groupFindingCounts=new Map(),packageCache=new Map(),nodeIssueCache=new Map();
+const byId=new Map(),parent=new Map(),relationById=new Map(),packageMembers=new Map(),findingIndex=new Map(),relationFindingIndex=new Map(),relationsByEntity=new Map(),groupEntityIds=new Map(),groupFindingIndex=new Map(),groupFindingCounts=new Map(),packageCache=new Map(),nodeIssueCache=new Map();let graphCacheKey="",graphCache;
+let activeLevelChunk="";
 const groupById=new Map(Object.entries(data.view?.groups||{}));
+const packageChunkNameById=new Map([...groupById.values()].flatMap((group)=>group.members).filter((id)=>data.entities.find((entity)=>entity.id===id)?.kind==="package").sort().map((id,index)=>[id,data.view?.levelChunks?.packages?.[index]]));
 const addFinding=(index,id,finding)=>{const values=index.get(id)||[];values.push(finding);index.set(id,values)};
 const addRelation=(id,relation)=>{const values=relationsByEntity.get(id)||[];values.push(relation);relationsByEntity.set(id,values)};
-const hydrate=()=>{byId.clear();parent.clear();relationById.clear();packageMembers.clear();findingIndex.clear();relationFindingIndex.clear();relationsByEntity.clear();groupEntityIds.clear();groupFindingCounts.clear();packageCache.clear();nodeIssueCache.clear();data.entities.forEach((entity)=>{byId.set(entity.id,entity);const groupId=data.view?.entityGroup?.[entity.id];if(groupId){const ids=groupEntityIds.get(groupId)||new Set();ids.add(entity.id);groupEntityIds.set(groupId,ids)}});data.relations.forEach((relation)=>{relationById.set(relation.id,relation);addRelation(relation.from,relation);addRelation(relation.to,relation);if(relation.kind==="contains"){if(!parent.has(relation.to))parent.set(relation.to,relation.from);const members=packageMembers.get(relation.from)||new Set();members.add(relation.to);packageMembers.set(relation.from,members)}});data.diagnostics.forEach((finding)=>{(finding.entityIds||[]).forEach((id)=>addFinding(findingIndex,id,finding));(finding.relationIds||[]).forEach((id)=>addFinding(relationFindingIndex,id,finding));const scopes=new Set();(finding.entityIds||[]).forEach((id)=>{const scope=data.view?.entityGroup?.[id];if(scope)scopes.add(scope)});(finding.relationIds||[]).forEach((id)=>{const relation=relationById.get(id);if(!relation)return;[relation.from,relation.to].forEach((endpoint)=>{const scope=data.view?.entityGroup?.[endpoint];if(scope)scopes.add(scope)})});scopes.forEach((scope)=>groupFindingCounts.set(scope,(groupFindingCounts.get(scope)||0)+1))})};
-const hasChunk=(name)=>!lazyChunks.includes(name)||loadedChunks.has(name);
-const loadChunk=(name)=>{if(hasChunk(name))return Promise.resolve();if(loadingChunks.has(name))return loadingChunks.get(name);const promise=new Promise((resolve,reject)=>{const element=document.createElement("script");element.src=name;element.onload=()=>{loadedChunks.add(name);hydrate();resolve()};element.onerror=()=>reject(new Error("Unable to load offline report chunk: "+name));document.head.append(element)});loadingChunks.set(name,promise);return promise};
+const hydrate=()=>{byId.clear();parent.clear();relationById.clear();packageMembers.clear();findingIndex.clear();relationFindingIndex.clear();relationsByEntity.clear();groupEntityIds.clear();groupFindingIndex.clear();groupFindingCounts.clear();packageCache.clear();nodeIssueCache.clear();data.entities.forEach((entity)=>{byId.set(entity.id,entity);const groupId=data.view?.entityGroup?.[entity.id];if(groupId){const ids=groupEntityIds.get(groupId)||new Set();ids.add(entity.id);groupEntityIds.set(groupId,ids)}});data.relations.forEach((relation)=>{relationById.set(relation.id,relation);addRelation(relation.from,relation);addRelation(relation.to,relation);if(relation.kind==="contains"){if(!parent.has(relation.to))parent.set(relation.to,relation.from);const members=packageMembers.get(relation.from)||new Set();members.add(relation.to);packageMembers.set(relation.from,members)}});data.diagnostics.forEach((finding)=>{(finding.entityIds||[]).forEach((id)=>addFinding(findingIndex,id,finding));(finding.relationIds||[]).forEach((id)=>addFinding(relationFindingIndex,id,finding));const scopes=data.view?.diagnosticGroup?.[finding.id]||[];if(finding.status!=="confirmed")scopes.forEach((scope)=>{addFinding(groupFindingIndex,scope,finding);groupFindingCounts.set(scope,(groupFindingCounts.get(scope)||0)+1)})})};
+const isLevelChunk=(name)=>name.startsWith("chunks/levels-");
+const isDetailChunk=(name)=>name.startsWith("chunks/details-");
+const hasChunk=(name)=>isLevelChunk(name)?activeLevelChunk===name:isDetailChunk(name)?loadedChunks.has(name):!lazyChunks.includes(name)||loadedChunks.has(name);
+const loadChunk=(name)=>{if(hasChunk(name))return Promise.resolve();if(loadingChunks.has(name))return loadingChunks.get(name);const promise=new Promise((resolve,reject)=>{const element=document.createElement("script");element.src=name;element.onload=()=>{try{if(isLevelChunk(name)){const payload=globalThis.__DOC_BRIDGE_LEVEL_PAYLOAD__;if(!payload)throw new Error("Offline report level payload is missing: "+name);data.entities=payload.entities||[];data.relations=payload.relations||[];activeLevelChunk=name;delete globalThis.__DOC_BRIDGE_LEVEL_PAYLOAD__}else if(isDetailChunk(name)){const payload=globalThis.__DOC_BRIDGE_DETAIL_PAYLOAD__;if(!payload)throw new Error("Offline report detail payload is missing: "+name);const entities=new Map((payload.entities||[]).map((entity)=>[entity.id,entity]));const relations=new Map((payload.relations||[]).map((relation)=>[relation.id,relation]));data.entities=data.entities.map((entity)=>entities.get(entity.id)||entity);data.relations=data.relations.map((relation)=>relations.get(relation.id)||relation);delete globalThis.__DOC_BRIDGE_DETAIL_PAYLOAD__}loadedChunks.add(name);hydrate();loadingChunks.delete(name);resolve()}catch(error){loadingChunks.delete(name);reject(error)}};element.onerror=()=>{loadingChunks.delete(name);reject(new Error("Unable to load offline report chunk: "+name))};document.head.append(element)});loadingChunks.set(name,promise);return promise};
 const readHash=()=>new URLSearchParams(location.hash.slice(1));
 const hash=readHash();
 const state={lens:hash.get("lens")||"architecture",level:hash.get("level")||"overview",selected:hash.get("selected"),query:hash.get("query")||"",status:hash.get("status")||"",severity:hash.get("severity")||"",findingGroup:hash.get("findingGroup"),findingPage:Number(hash.get("findingPage")||0)};
 const syncHash=()=>{const params=new URLSearchParams();[["lens",state.lens,"architecture"],["level",state.level,"overview"],["selected",state.selected,""],["query",state.query,""],["status",state.status,""],["severity",state.severity,""],["findingGroup",state.findingGroup,""],["findingPage",state.findingPage,"0"]].forEach(([key,value,defaultValue])=>{if(value&&value!==defaultValue)params.set(key,String(value))});const next=params.toString();try{if(location.hash.slice(1)!==next)history.replaceState(null,"",next?"#"+next:"")}catch{}};
 const rootOf=(id)=>{let current=id;const seen=new Set();while(parent.has(current)&&!seen.has(current)){seen.add(current);current=parent.get(current)}return current};
 const packageOf=(id)=>{if(packageCache.has(id))return packageCache.get(id);let current=id;const seen=new Set();while(current&&!seen.has(current)){seen.add(current);if(byId.get(current)?.kind==="package"){packageCache.set(id,current);return current}current=parent.get(current)}packageCache.set(id,id);return id};
-const groupFor=(id)=>data.view?.entityGroup?.[id]||id;
+const groupFor=(id)=>{const direct=data.view?.entityGroup?.[id];if(direct)return direct;const entity=byId.get(id);return entity?.kind==="module"||entity?.kind==="file"?groupFor(packageOf(id)):id};
 const packageNodes=()=>data.entities.filter((entity)=>entity.kind==="package");
 const viewLabels={architecture:"Architecture",drift:"Insights",risks:"Findings",evidence:"Coverage"};
 const ensureReportChrome=()=>{document.querySelectorAll(".tab[data-lens]").forEach((tab)=>{tab.textContent=viewLabels[tab.dataset.lens]||tab.dataset.lens;tab.closest(".tabs")?.classList.add("report-tabs")});let breadcrumbs=document.querySelector("#breadcrumbs");if(!breadcrumbs){breadcrumbs=document.createElement("nav");breadcrumbs.id="breadcrumbs";breadcrumbs.className="breadcrumbs";breadcrumbs.setAttribute("aria-label","Report location");document.querySelector(".workspace")?.before(breadcrumbs)}return breadcrumbs};
 const label=(entity)=>entity?.name||entity?.id||"Unknown";
 const short=(value,max)=>{const text=String(value??""),limit=text==="External dependencies"?16:max;return text.length>limit?text.slice(0,limit-1)+"…":text};
-const renderBreadcrumbs=()=>{const breadcrumbs=ensureReportChrome(),items=[{label:"Repository",selected:"",level:"overview"}];if(state.selected){const group=groupById.get(state.selected),entity=byId.get(state.selected);if(group)items.push({label:group.name,selected:group.id,level:"package"});else if(entity){const packageId=packageOf(entity.id),packageEntity=byId.get(packageId),groupId=groupFor(packageId);if(groupById.has(groupId))items.push({label:groupById.get(groupId).name,selected:groupId,level:"package"});if(packageEntity&&packageEntity.id!==entity.id)items.push({label:label(packageEntity),selected:packageEntity.id,level:"module"});items.push({label:label(entity),selected:entity.id,level:state.level})}}breadcrumbs.innerHTML=items.map((item,index)=>{const separator="<span aria-hidden=\"true\">"+(index?" / ":"")+"</span>";if(index===items.length-1)return separator+"<span class=\"current\">"+esc(item.label)+"</span>";return separator+"<button type=\"button\" data-breadcrumb-selected=\""+esc(item.selected)+"\" data-breadcrumb-level=\""+esc(item.level)+"\">"+esc(item.label)+"</button>"}).join("")};
+const renderBreadcrumbs=()=>{const breadcrumbs=ensureReportChrome(),items=[{label:"Repository",selected:"",level:"overview"}];if(state.selected){const group=groupById.get(state.selected),entity=byId.get(state.selected);if(group)items.push({label:group.name,selected:group.id,level:"package"});else if(entity){const packageId=packageOf(entity.id),packageEntity=byId.get(packageId),groupId=groupFor(packageId),group=groupById.get(groupId);if(group&&groupId!==packageId&&group.name!==label(packageEntity))items.push({label:group.name,selected:groupId,level:"package"});if(packageEntity&&packageEntity.id!==entity.id)items.push({label:label(packageEntity),selected:packageEntity.id,level:"module"});items.push({label:label(entity),selected:entity.id,level:state.level})}}breadcrumbs.innerHTML=items.map((item,index)=>{const separator="<span aria-hidden=\"true\">"+(index?" / ":"")+"</span>";if(index===items.length-1)return separator+"<span class=\"current\">"+esc(item.label)+"</span>";return separator+"<button type=\"button\" data-breadcrumb-selected=\""+esc(item.selected)+"\" data-breadcrumb-level=\""+esc(item.level)+"\">"+esc(item.label)+"</button>"}).join("")};
 const degreeMap=(relations)=>{const degrees=new Map();relations.forEach((relation)=>{degrees.set(relation.from,(degrees.get(relation.from)||0)+1);degrees.set(relation.to,(degrees.get(relation.to)||0)+1)});return degrees};
-const relationHealth=(relation)=>{if(!relation)return "";const findings=relationFindingIndex.get(relation.id)||[];return findings.some((finding)=>finding.severity==="error")?"error":findings.length?"warn":""};
-const nodeIssues=(nodeId)=>{if(nodeIssueCache.has(nodeId))return nodeIssueCache.get(nodeId);const ids=groupEntityIds.get(nodeId)||new Set([nodeId]),findings=new Set(),relations=new Set();for(const id of ids){(findingIndex.get(id)||[]).forEach((finding)=>findings.add(finding));(relationsByEntity.get(id)||[]).forEach((relation)=>relations.add(relation))}relations.forEach((relation)=>(relationFindingIndex.get(relation.id)||[]).forEach((finding)=>findings.add(finding)));const result=[...findings];nodeIssueCache.set(nodeId,result);return result};
+const relationHealth=(relation)=>{if(!relation)return "";const findings=relationFindings(relation.id);return findings.some((finding)=>finding.severity==="error")?"error":findings.length?"warn":""};
+const nodeIssues=(nodeId)=>{if(nodeIssueCache.has(nodeId))return nodeIssueCache.get(nodeId);const ids=groupEntityIds.get(nodeId)||new Set([nodeId]),findings=new Set(groupFindingIndex.get(nodeId)||[]),relations=new Set();for(const id of ids){(findingIndex.get(id)||[]).filter((finding)=>finding.status!=="confirmed").forEach((finding)=>findings.add(finding));(relationsByEntity.get(id)||[]).forEach((relation)=>relations.add(relation))}relations.forEach((relation)=>(relationFindingIndex.get(relation.id)||[]).filter((finding)=>finding.status!=="confirmed").forEach((finding)=>findings.add(finding)));const result=[...findings];nodeIssueCache.set(nodeId,result);return result};
 const findingInLens=(finding)=>state.lens==="architecture"||(state.lens==="drift"&&finding.status!=="confirmed")||(state.lens==="risks"&&(finding.severity==="error"||finding.severity==="warn"))||(state.lens==="evidence"&&finding.evidence.length>0);
-const relationInLens=(id)=>{const findings=relationFindingIndex.get(id)||[];return findings.some(findingInLens)};
+const relationFindings=(id)=>relationFindingIndex.get(id)||data.view?.diagnosticRelationFindings?.[id]||[];
+const relationInLens=(id)=>relationFindings(id).some(findingInLens);
 const externalFor=(ids)=>{const externalIds=new Set();for(const id of ids)for(const relation of relationsByEntity.get(id)||[]){const other=relation.from===id?relation.to:relation.from;if(byId.get(other)?.kind==="external")externalIds.add(other)}return [...externalIds].map((id)=>byId.get(id)).filter(Boolean)};
+const levelChunkName=()=>{if(state.selected&&groupById.has(state.selected))return data.view?.levelChunks?.groups?.[state.selected]||data.view?.levelChunks?.default;const selected=state.selected?byId.get(state.selected):null;const packageId=selected?.kind==="package"?selected.id:selected?packageOf(selected.id):state.selected?.startsWith("package:")?state.selected:null;const packageChunk=packageId&&packageChunkNameById.get(packageId);if(packageChunk)return packageChunk;const selectedGroup=state.selected?data.view?.entityGroup?.[state.selected]:null;if(selectedGroup&&data.view?.levelChunks?.groups?.[selectedGroup])return data.view.levelChunks.groups[selectedGroup];return data.view?.levelChunks?.default};
+const detailChunkName=()=>{const entity=state.selected?byId.get(state.selected):null;const packageId=entity?.kind==="package"?entity.id:entity?packageOf(entity.id):null;const levelName=packageId&&packageChunkNameById.get(packageId);return levelName?.replace("chunks/levels-package-","chunks/details-")||null};
 const nodesFor=()=>{if(state.level==="overview")return data.view?.overview?.nodes||[];const packages=packageNodes(),selectedEntity=state.selected?byId.get(state.selected):null,groupScope=state.selected&&groupById.has(state.selected)?state.selected:null,packageScope=selectedEntity?.kind==="package"?selectedEntity.id:state.selected&&!groupScope?packageOf(state.selected):null;if(state.level==="package"&&!state.selected){const packageIds=new Set(packages.map((node)=>node.id));return packages.concat(state.lens==="architecture"?[]:externalFor(packageIds))}if((state.level==="module"||state.level==="file")&&!state.selected)return[];let nodes=data.entities.filter((entity)=>{if(state.level==="package")return entity.kind==="package"&&(!groupScope||groupFor(entity.id)===groupScope)&&(!packageScope||entity.id===packageScope);if(state.level==="module")return entity.kind==="module"&&(groupScope?groupFor(entity.id)===groupScope:packageOf(entity.id)===packageScope);return Boolean(entity.path)&&(groupScope?groupFor(entity.id)===groupScope:packageOf(entity.id)===packageScope)});if(state.level==="module"&&selectedEntity?.kind==="module"){const neighborhood=new Set([selectedEntity.id]);(relationsByEntity.get(selectedEntity.id)||[]).forEach((relation)=>{if(!["imports","re-exports"].includes(relation.kind))return;if(relation.from===selectedEntity.id)neighborhood.add(relation.to);if(relation.to===selectedEntity.id)neighborhood.add(relation.from)});nodes=data.entities.filter((entity)=>entity.kind==="module"&&neighborhood.has(entity.id))}const scopedIds=new Set(nodes.map((node)=>node.id)),external=state.lens==="architecture"?[]:externalFor(scopedIds),degrees=degreeMap(data.relations);return nodes.concat(external).sort((a,b)=>(degrees.get(b.id)||0)-(degrees.get(a.id)||0)||a.id.localeCompare(b.id)).slice(0,state.level==="file"?80:60)};
-const graphModel=()=>{if(state.level==="overview"){const overviewNodes=data.view?.overview?.nodes||[],overviewNodeIds=new Set(overviewNodes.map((node)=>node.id)),base=(data.view?.overview?.edges||[]).filter((edge)=>overviewNodeIds.has(edge.from)&&overviewNodeIds.has(edge.to)),edges=state.lens==="architecture"?base:base.filter((edge)=>edge.relationIds.some(relationInLens)),visible=new Set(edges.flatMap((edge)=>[edge.from,edge.to]));return{nodes:state.lens==="architecture"?overviewNodes:overviewNodes.filter((node)=>visible.has(node.id)||nodeIssues(node.id).some((finding)=>findingInLens(finding))),edges:edges.map((edge)=>({...edge,health:edge.relationIds.some((id)=>relationHealth(relationById.get(id)))?"error":""}))}}const nodes=nodesFor(),ids=new Set(nodes.map((node)=>node.id)),aggregate=state.level==="package"&&(!state.selected||state.selected.startsWith("group:")),edges=new Map();data.relations.forEach((relation)=>{const essential=state.level==="package"?relation.kind==="depends-on":relation.kind==="imports"||relation.kind==="re-exports";if(relation.kind==="contains"|| (state.lens==="architecture"&&!essential)||(state.lens!=="architecture"&&!relationInLens(relation.id)))return;const from=aggregate?packageOf(relation.from):relation.from,to=aggregate?packageOf(relation.to):relation.to;if(from===to||!ids.has(from)||!ids.has(to))return;const key=from+"→"+to,current=edges.get(key)||{from,to,count:0,kinds:new Set(),relationIds:new Set(),health:""};current.count++;current.kinds.add(relation.kind);current.relationIds.add(relation.id);current.health=current.health==="error"||relationHealth(relation)==="error"?"error":current.health||relationHealth(relation);edges.set(key,current)});const visibleEdges=[...edges.values()].sort((a,b)=>b.count-a.count||a.from.localeCompare(b.from)||a.to.localeCompare(b.to));const visible=new Set(visibleEdges.flatMap((edge)=>[edge.from,edge.to]));return{nodes:state.lens==="architecture"?nodes:nodes.filter((node)=>visible.has(node.id)||nodeIssues(node.id).some((finding)=>findingInLens(finding))),edges:visibleEdges}};
-const renderInsights=()=>{const summary=data.diagnosticSummary||{},undocumented=summary.undocumented??data.diagnostics.filter((finding)=>finding.status==="undocumented").length,drift=summary.drift??data.diagnostics.filter((finding)=>finding.status==="stale-or-unverified"||finding.status==="conflict").length,unsupported=(data.coverage||[]).filter((entry)=>entry.status==="not-analyzed"||entry.status==="partial").length,model=graphModel(),degrees=degreeMap(model.edges),values=[...degrees.values()].sort((a,b)=>a-b),median=values.length?values[Math.floor(values.length/2)]:0,hot=[...degrees.values()].filter((value)=>value>=Math.max(4,median*2)).length,isolated=model.nodes.filter((node)=>!model.edges.some((edge)=>edge.from===node.id||edge.to===node.id)).length;document.querySelector("#insights").innerHTML=[["Documentation drift",undocumented+drift,"Relations or docs needing comparison.",""],["Unanalyzed scope",unsupported,"Coverage gaps are explicit.",""],["Connectivity hotspots",hot,"Heuristic: unusually connected nodes.","heuristic"],["Disconnected nodes",isolated,"Heuristic: no visible edge at this level.","heuristic"]].map(([title,count,copy,tag])=>"<article class=\"insight\"><h3>"+esc(title)+" <span class=\"tag "+tag+"\">"+(tag?"heuristic":"signal")+"</span></h3><p><strong>"+count+"</strong> · "+esc(copy)+"</p></article>").join("")};
-const renderInsightsDashboard=()=>{let dashboard=document.querySelector("#report-dashboard");if(!dashboard){dashboard=document.createElement("section");dashboard.id="report-dashboard";dashboard.className="report-dashboard";document.querySelector(".filters")?.before(dashboard)}if(!data.diagnostics.length){dashboard.innerHTML="<p class=\"empty\">Open Findings or load the findings data to calculate insights.</p>";return}const degrees=degreeMap(data.relations),groups=[...groupById.entries()].filter(([,group])=>group.kind!=="external"),rows=groups.map(([id,group])=>{const members=groupEntityIds.get(id)||new Set(),modules=[...members].filter((entityId)=>byId.get(entityId)?.kind==="module").length;return{name:group.name,packages:group.members.length,modules,findings:groupFindingCounts.get(id)||0}}).sort((a,b)=>b.findings-a.findings||a.name.localeCompare(b.name)),topPackages=[...data.entities].filter((entity)=>entity.kind==="package").map((entity)=>({name:label(entity),degree:degrees.get(entity.id)||0})).sort((a,b)=>b.degree-a.degree||a.name.localeCompare(b.name)).slice(0,10),max=Math.max(1,...topPackages.map((row)=>row.degree));dashboard.innerHTML="<section><div class=\"eyebrow\">Attention by scope</div><h2>Where the map needs a closer look</h2><table class=\"report-table\"><thead><tr><th>Scope</th><th>Packages</th><th>Modules</th><th>Findings</th></tr></thead><tbody>"+rows.map((row)=>"<tr><td>"+esc(row.name)+"</td><td>"+row.packages+"</td><td>"+row.modules+"</td><td><strong>"+row.findings+"</strong></td></tr>").join("")+"</tbody></table></section><section><div class=\"eyebrow\">Connectivity</div><h2>Most connected packages</h2><div class=\"bar-list\">"+topPackages.map((row)=>"<div class=\"bar-item\"><span>"+esc(row.name)+"</span><i><b style=\"width:"+Math.round(row.degree/max*100)+"%\"></b></i><strong>"+row.degree+"</strong></div>").join("")+"</div></section>"};
+const graphModelUncached=()=>{if(state.level==="overview"){const overviewNodes=data.view?.overview?.nodes||[],overviewNodeIds=new Set(overviewNodes.map((node)=>node.id)),base=(data.view?.overview?.edges||[]).filter((edge)=>overviewNodeIds.has(edge.from)&&overviewNodeIds.has(edge.to)),edges=state.lens==="architecture"?base:base.filter((edge)=>edge.relationIds.some(relationInLens)),visible=new Set(edges.flatMap((edge)=>[edge.from,edge.to]));return{nodes:state.lens==="architecture"?overviewNodes:overviewNodes.filter((node)=>visible.has(node.id)||nodeIssues(node.id).some((finding)=>findingInLens(finding))),edges:edges.map((edge)=>({...edge,health:edge.relationIds.some((id)=>relationHealth(relationById.get(id)))?"error":""}))}}const nodes=nodesFor(),ids=new Set(nodes.map((node)=>node.id)),aggregate=state.level==="package"&&(!state.selected||state.selected.startsWith("group:")),edges=new Map();data.relations.forEach((relation)=>{const essential=state.level==="package"?relation.kind==="depends-on":relation.kind==="imports"||relation.kind==="re-exports";if(relation.kind==="contains"|| (state.lens==="architecture"&&!essential)||(state.lens!=="architecture"&&!relationInLens(relation.id)))return;const from=aggregate?packageOf(relation.from):relation.from,to=aggregate?packageOf(relation.to):relation.to;if(from===to||!ids.has(from)||!ids.has(to))return;const key=from+"→"+to,current=edges.get(key)||{from,to,count:0,kinds:new Set(),relationIds:new Set(),health:""};current.count++;current.kinds.add(relation.kind);current.relationIds.add(relation.id);current.health=current.health==="error"||relationHealth(relation)==="error"?"error":current.health||relationHealth(relation);edges.set(key,current)});const visibleEdges=[...edges.values()].sort((a,b)=>b.count-a.count||a.from.localeCompare(b.from)||a.to.localeCompare(b.to));const visible=new Set(visibleEdges.flatMap((edge)=>[edge.from,edge.to]));return{nodes:state.lens==="architecture"?nodes:nodes.filter((node)=>visible.has(node.id)||nodeIssues(node.id).some((finding)=>findingInLens(finding))),edges:visibleEdges}};
+const graphModel=()=>{const key=state.lens+"|"+state.level+"|"+(state.selected||"");if(graphCacheKey===key&&graphCache)return graphCache;graphCacheKey=key;return graphCache=graphModelUncached()};
+const renderInsights=()=>{const summary=data.diagnosticSummary||{},documentation=data.documentation||{},classificationCounts=documentation.documentClassificationCounts||{},documentedCounts=documentation.documentedDocumentClassificationCounts||{},agentDocs=classificationCounts.agent??0,documentedAgentDocs=documentedCounts.agent??0,undocumented=summary.undocumented??data.diagnostics.filter((finding)=>finding.status==="undocumented").length,drift=summary.drift??data.diagnostics.filter((finding)=>finding.status==="stale-or-unverified"||finding.status==="conflict").length,unsupported=(data.coverage||[]).filter((entry)=>entry.status==="not-analyzed"||entry.status==="partial").length,model=graphModel(),degrees=degreeMap(model.edges),values=[...degrees.values()].sort((a,b)=>a-b),median=values.length?values[Math.floor(values.length/2)]:0,hot=[...degrees.values()].filter((value)=>value>=Math.max(4,median*2)).length,isolated=model.nodes.filter((node)=>!model.edges.some((edge)=>edge.from===node.id||edge.to===node.id)).length;document.querySelector("#insights").innerHTML=[["Documentation drift",undocumented+drift,"Relations or docs needing comparison.",""],["Agent documentation",documentedAgentDocs+"/"+agentDocs,"Configured agent-corpus documents linked to knowledge.",""],["Unanalyzed scope",unsupported,"Coverage gaps are explicit.",""],["Connectivity hotspots",hot,"Heuristic: unusually connected nodes.","heuristic"],["Disconnected nodes",isolated,"Heuristic: no visible edge at this level.","heuristic"]].map(([title,count,copy,tag])=>"<article class=\"insight\"><h3>"+esc(title)+" <span class=\"tag "+tag+"\">"+(tag?"heuristic":"signal")+"</span></h3><p><strong>"+count+"</strong> · "+esc(copy)+"</p></article>").join("")};
+const renderInsightsDashboard=()=>{let dashboard=document.querySelector("#report-dashboard");if(!dashboard){dashboard=document.createElement("section");dashboard.id="report-dashboard";dashboard.className="report-dashboard";document.querySelector(".filters")?.before(dashboard)}const actionable=data.diagnostics.filter((finding)=>finding.status!=="confirmed");if(!actionable.length){dashboard.innerHTML="<p class=\"empty\">No actionable findings. Confirmed checks are available in Evidence.</p>";return}const degrees=degreeMap(data.relations),groups=[...groupById.entries()].filter(([,group])=>group.kind!=="external"),rows=groups.map(([id,group])=>{const members=groupEntityIds.get(id)||new Set(),modules=group.moduleCount||[...members].filter((entityId)=>byId.get(entityId)?.kind==="module").length;return{name:group.name,packages:group.members.length,modules,findings:groupFindingCounts.get(id)||0}}).sort((a,b)=>b.findings-a.findings||a.name.localeCompare(b.name)),topPackages=[...data.entities].filter((entity)=>entity.kind==="package").map((entity)=>({name:label(entity),degree:degrees.get(entity.id)||0})).sort((a,b)=>b.degree-a.degree||a.name.localeCompare(b.name)).slice(0,10),max=Math.max(1,...topPackages.map((row)=>row.degree));dashboard.innerHTML="<section><div class=\"eyebrow\">Attention by scope</div><h2>Where the map needs a closer look</h2><table class=\"report-table\"><thead><tr><th>Scope</th><th>Packages</th><th>Modules</th><th>Findings</th></tr></thead><tbody>"+rows.map((row)=>"<tr><td>"+esc(row.name)+"</td><td>"+row.packages+"</td><td>"+row.modules+"</td><td><strong>"+row.findings+"</strong></td></tr>").join("")+"</tbody></table></section><section><div class=\"eyebrow\">Connectivity</div><h2>Most connected packages</h2><div class=\"bar-list\">"+topPackages.map((row)=>"<div class=\"bar-item\"><span>"+esc(row.name)+"</span><i><b style=\"width:"+Math.round(row.degree/max*100)+"%\"></b></i><strong>"+row.degree+"</strong></div>").join("")+"</div></section>"};
 const mapState={scale:1,dragging:false,x:0,y:0};
-const applyMapTransform=()=>{const svg=document.querySelector("#graph");if(!svg)return;svg.style.transform="translate("+mapState.x+"px,"+mapState.y+"px) scale("+mapState.scale+")";svg.style.transformOrigin="center center"};
+const applyMapTransform=()=>{const svg=document.querySelector("#graph");if(!svg)return;const dense=svg.closest(".map-wrap")?.classList.contains("dense");svg.setAttribute("preserveAspectRatio",dense?"xMinYMin meet":"xMidYMid meet");svg.style.transform="translate("+mapState.x+"px,"+mapState.y+"px) scale("+mapState.scale+")";svg.style.transformOrigin="center center"};
 const routeGraphEdges=()=>{const svg=document.querySelector("#graph");if(!svg)return;svg.querySelectorAll("line.edge").forEach((line,index)=>{const x1=Number(line.getAttribute("x1")),y1=Number(line.getAttribute("y1")),x2=Number(line.getAttribute("x2")),y2=Number(line.getAttribute("y2")),midX=(x1+x2)/2+((index%5)-2)*14,path=document.createElementNS("http://www.w3.org/2000/svg","path");path.setAttribute("class",line.getAttribute("class")||"edge");path.setAttribute("fill","none");path.setAttribute("marker-end",line.getAttribute("marker-end")||"url(#arrow)");path.setAttribute("d","M "+x1+" "+y1+" H "+midX+" V "+y2+" H "+x2);const label=line.parentElement?.querySelector("text.edge-label");if(label){label.setAttribute("x",String(midX+3));label.setAttribute("y",String((y1+y2)/2))}line.replaceWith(path)})};
 const enterNode=(id)=>{const group=groupById.get(id),entity=byId.get(id);if(group){state.selected=id;state.level="package"}else if(entity?.kind==="package"){state.selected=id;state.level="module"}else if(entity?.kind==="module"){state.selected=id;state.level="file"}else return;mapState.scale=1;mapState.x=0;mapState.y=0;render()};
 let nodeClickTimer;
 document.addEventListener("dblclick",(event)=>{const node=event.target.closest?.("[data-node]");if(!node)return;event.preventDefault();event.stopImmediatePropagation();clearTimeout(nodeClickTimer);enterNode(node.dataset.node)},true);
-document.addEventListener("click",(event)=>{const node=event.target.closest?.("[data-node]");if(!node)return;event.preventDefault();event.stopImmediatePropagation();clearTimeout(nodeClickTimer);if(event.detail>=2){enterNode(node.dataset.node);return}nodeClickTimer=setTimeout(()=>{state.selected=node.dataset.node;render()},380)},true);
+document.addEventListener("click",(event)=>{const node=event.target.closest?.("[data-node]");if(!node)return;event.preventDefault();event.stopImmediatePropagation();clearTimeout(nodeClickTimer);nodeClickTimer=setTimeout(async()=>{state.selected=node.dataset.node;render();const chunk=detailChunkName();if(chunk&&!hasChunk(chunk)){await loadChunk(chunk);render()}},380)},true);
 document.addEventListener("click",(event)=>{const crumb=event.target.closest?.("[data-breadcrumb-level]");if(!crumb)return;event.preventDefault();event.stopImmediatePropagation();state.level=crumb.dataset.breadcrumbLevel;state.selected=crumb.dataset.breadcrumbSelected||null;mapState.scale=1;mapState.x=0;mapState.y=0;render()},true);
-const diagnosticsFor=(id)=>findingIndex.get(id)||[];
+const diagnosticsFor=(id)=>(findingIndex.get(id)||[]).filter((finding)=>finding.status!=="confirmed");
 const renderDetails=()=>{const panel=document.querySelector("#details"),entity=state.selected?byId.get(state.selected):null,group=state.selected?groupById.get(state.selected):null;if(group){const members=group.members.map((id)=>byId.get(id)).filter(Boolean),relations=new Set(),ids=groupEntityIds.get(state.selected)||new Set();ids.forEach((id)=>(relationsByEntity.get(id)||[]).forEach((relation)=>relations.add(relation)));const findings=nodeIssues(state.selected),evidence=members.flatMap((member)=>member.evidence||[]).slice(0,8),unit=group.kind==="external"?"dependencies":"packages";panel.innerHTML="<div class=\"eyebrow\">Selected group</div><h2 class=\"detail-title\">"+esc(group.name)+"</h2><span class=\"tag\">"+esc(group.kind)+"</span><p class=\"path\">"+esc(group.path||"Derived from stable package identity and repository structure")+"</p><div class=\"detail-grid\"><div><b>"+members.length+"</b><span>"+unit+"</span></div><div><b>"+relations.size+"</b><span>relations</span></div><div><b>"+findings.length+"</b><span>findings</span></div><div><b>"+evidence.length+"</b><span>evidence items</span></div></div><h3>Members</h3><ul class=\"list\">"+(members.length?members.slice(0,8).map((member)=>"<li>"+esc(label(member))+"</li>").join(""):"<li>No members recorded.</li>")+(members.length>8?"<li class=\"subtle\">+"+(members.length-8)+" more — choose Package level to inspect all.</li>":"")+"</ul>"+(findings.length?"<h3 style=\"margin-top:16px\">Attention</h3><ul class=\"list\">"+findings.slice(0,5).map((finding)=>"<li><span class=\"tag "+esc(finding.severity)+"\">"+esc(finding.severity)+"</span> "+esc(finding.code)+"</li>").join("")+"</ul>":"");return}if(!entity){panel.innerHTML="<p class=\"subtle\">Select a node in the map to inspect its evidence, connectivity, and findings.</p>";return}const relations=relationsByEntity.get(entity.id)||[],incoming=relations.filter((relation)=>relation.to===entity.id),outgoing=relations.filter((relation)=>relation.from===entity.id),findings=diagnosticsFor(entity.id),evidence=[...(entity.evidence||[]),...incoming.flatMap((relation)=>relation.evidence||[]),...outgoing.flatMap((relation)=>relation.evidence||[])].slice(0,8);panel.innerHTML="<div class=\"eyebrow\">Selected entity</div><h2 class=\"detail-title\">"+esc(label(entity))+"</h2><span class=\"tag\">"+esc(entity.kind)+"</span><p class=\"path\">"+esc(entity.path||entity.id)+"</p><div class=\"detail-grid\"><div><b>"+incoming.length+"</b><span>incoming</span></div><div><b>"+outgoing.length+"</b><span>outgoing</span></div><div><b>"+findings.length+"</b><span>findings</span></div><div><b>"+evidence.length+"</b><span>evidence items</span></div></div><h3>Evidence</h3><ul class=\"list\">"+(evidence.length?evidence.map((item)=>"<li>"+esc(item.path+(item.lineStart?":"+item.lineStart:"")+(item.context?" — "+item.context:""))+"</li>").join(""):"<li>No evidence recorded.</li>")+"</ul>"+(findings.length?"<h3 style=\"margin-top:16px\">Attention</h3><ul class=\"list\">"+findings.slice(0,5).map((finding)=>"<li><span class=\"tag "+esc(finding.severity)+"\">"+esc(finding.severity)+"</span> "+esc(finding.code)+"</li>").join("")+"</ul>":"")};
-const renderGraph=()=>{const model=graphModel(),svg=document.querySelector("#graph");if(!model.nodes.length){svg.innerHTML="<text x=\"500\" y=\"270\" text-anchor=\"middle\" class=\"subtle\">Select an app or package to expand this view.</text>";return}const ids=new Set(model.nodes.map((node)=>node.id)),incoming=new Map(model.nodes.map((node)=>[node.id,0])),outgoing=new Map(model.nodes.map((node)=>[node.id,[]]));model.edges.forEach((edge)=>{if(!ids.has(edge.from)||!ids.has(edge.to))return;incoming.set(edge.to,(incoming.get(edge.to)||0)+1);outgoing.get(edge.from).push(edge.to)});const rank=new Map(),work=[];model.nodes.filter((node)=>(incoming.get(node.id)||0)===0).sort((a,b)=>label(a).localeCompare(label(b))||a.id.localeCompare(b.id)).forEach((node)=>{rank.set(node.id,0);work.push(node)});for(let index=0;index<work.length;index++){const node=work[index];for(const next of outgoing.get(node.id)||[]){const nextRank=Math.max(rank.get(next)||0,(rank.get(node.id)||0)+1);rank.set(next,nextRank);if(!work.some((item)=>item.id===next))work.push(byId.get(next)||{id:next,name:next})}}model.nodes.forEach((node)=>{if(!rank.has(node.id))rank.set(node.id,0)});const columns=new Map();model.nodes.forEach((node)=>{const items=columns.get(rank.get(node.id))||[];items.push(node);columns.set(rank.get(node.id),items)});for(const items of columns.values())items.sort((a,b)=>label(a).localeCompare(label(b))||a.id.localeCompare(b.id));const maxRows=Math.max(1,...[...columns.values()].map((items)=>items.length)),cellWidth=190,cellHeight=82,pad=28,columnCount=Math.max(1,...columns.keys())+1,width=Math.max(620,columnCount*cellWidth+pad*2,Math.min(1000,svg.clientWidth*1.05)),height=Math.max(520,maxRows*cellHeight+pad*2);svg.setAttribute("viewBox","0 0 "+width+" "+height);svg.style.width="100%";svg.style.minWidth="0";svg.style.height="100%";const positions=new Map();for(const [column,items] of columns)items.forEach((node,row)=>positions.set(node.id,{x:pad+column*cellWidth+78,y:pad+row*cellHeight+27}));const defs="<defs><marker id=\"arrow\" markerWidth=\"8\" markerHeight=\"8\" refX=\"7\" refY=\"3\" orient=\"auto\"><path d=\"M0,0 L0,6 L7,3 z\" fill=\"#789087\"/></marker></defs>",edges=model.edges.map((edge)=>{const from=positions.get(edge.from),to=positions.get(edge.to);if(!from||!to)return "";const midX=(from.x+to.x)/2,midY=(from.y+to.y)/2;return "<g><line class=\"edge "+(edge.health?"alert":"")+"\" x1=\""+from.x+"\" y1=\""+from.y+"\" x2=\""+to.x+"\" y2=\""+to.y+"\" marker-end=\"url(#arrow)\"/><text class=\"edge-label\" x=\""+midX+"\" y=\""+midY+"\">"+esc(edge.count>1?edge.count+"×":"")+"</text></g>"}).join(""),nodes=model.nodes.map((node)=>{const pos=positions.get(node.id),issues=nodeIssues(node.id),degree=degreeMap(model.edges).get(node.id)||0,selected=state.selected===node.id?" selected":"",issue=issues.length?" issue":"",nodeLabel=label(node),nodeKind=node.kind==="domain"?(node.memberCount||0)+" packages":node.kind;return "<g class=\"graph-node"+selected+issue+"\" transform=\"translate("+(pos.x-78)+","+(pos.y-27)+")\"><title>"+esc(nodeLabel)+" · "+esc(nodeKind)+"</title><rect width=\"156\" height=\"54\" rx=\"8\" role=\"button\" tabindex=\"0\" aria-label=\""+esc(nodeLabel+" "+nodeKind)+"\" data-node=\""+esc(node.id)+"\"></rect><text class=\"node-label\" x=\"10\" y=\"19\">"+esc(short(nodeLabel,22))+"</text><text class=\"node-kind\" x=\"10\" y=\"34\">"+esc(short(nodeKind,22))+"</text><text class=\"node-count\" x=\"144\" y=\"19\" text-anchor=\"end\">"+(degree||"")+"</text></g>"}).join("");svg.innerHTML=defs+edges+nodes;routeGraphEdges();applyMapTransform();document.querySelector("#map-note").textContent=(state.level==="overview"?"Bounded domain view. ":state.level+" view. ")+"Directional edges are aggregated from canonical relations; "+model.edges.length+" visible connection groups."};
+const renderGraph=()=>{const model=graphModel(),svg=document.querySelector("#graph"),dense=model.edges.length>64,edges=dense?[...model.edges].sort((a,b)=>(b.health?1:0)-(a.health?1:0)||b.count-a.count||a.from.localeCompare(b.from)||a.to.localeCompare(b.to)).slice(0,64):model.edges;if(!model.nodes.length){svg.innerHTML="<text x=\"500\" y=\"270\" text-anchor=\"middle\" class=\"subtle\">Select an app or package to expand this view.</text>";return}const ids=new Set(model.nodes.map((node)=>node.id)),incoming=new Map(model.nodes.map((node)=>[node.id,0])),outgoing=new Map(model.nodes.map((node)=>[node.id,[]]));edges.forEach((edge)=>{if(!ids.has(edge.from)||!ids.has(edge.to))return;incoming.set(edge.to,(incoming.get(edge.to)||0)+1);outgoing.get(edge.from).push(edge.to)});const rank=new Map(),work=[];model.nodes.filter((node)=>(incoming.get(node.id)||0)===0).sort((a,b)=>label(a).localeCompare(label(b))||a.id.localeCompare(b.id)).forEach((node)=>{rank.set(node.id,0);work.push(node)});for(let index=0;index<work.length;index++){const node=work[index];for(const next of outgoing.get(node.id)||[]){const nextRank=Math.max(rank.get(next)||0,(rank.get(node.id)||0)+1);rank.set(next,nextRank);if(!work.some((item)=>item.id===next))work.push(byId.get(next)||{id:next,name:next})}}model.nodes.forEach((node)=>{if(!rank.has(node.id))rank.set(node.id,0)});const columns=new Map();model.nodes.forEach((node)=>{const items=columns.get(rank.get(node.id))||[];items.push(node);columns.set(rank.get(node.id),items)});for(const items of columns.values())items.sort((a,b)=>label(a).localeCompare(label(b))||a.id.localeCompare(b.id));if(dense){columns.clear();model.nodes.forEach((node,index)=>{const column=Math.floor(index/8),items=columns.get(column)||[];items.push(node);columns.set(column,items)})}const maxRows=Math.max(1,...[...columns.values()].map((items)=>items.length)),cellWidth=190,cellHeight=82,pad=28,columnCount=Math.max(1,...columns.keys())+1,width=Math.max(620,columnCount*cellWidth+pad*2,Math.min(1000,svg.clientWidth*1.05)),height=Math.max(520,maxRows*cellHeight+pad*2);svg.setAttribute("viewBox","0 0 "+width+" "+height);svg.style.width=dense?Math.max(1000,width)+"px":"100%";svg.style.minWidth="0";svg.style.height="100%";document.querySelector(".map-wrap")?.classList.toggle("dense",dense);const positions=new Map();for(const [column,items] of columns)items.forEach((node,row)=>positions.set(node.id,{x:pad+column*cellWidth+78,y:pad+row*cellHeight+27}));const defs="<defs><marker id=\"arrow\" markerWidth=\"8\" markerHeight=\"8\" refX=\"7\" refY=\"3\" orient=\"auto\"><path d=\"M0,0 L0,6 L7,3 z\" fill=\"#789087\"/></marker></defs>",edgeMarkup=edges.map((edge)=>{const from=positions.get(edge.from),to=positions.get(edge.to);if(!from||!to)return "";const midX=(from.x+to.x)/2,midY=(from.y+to.y)/2;return "<g><line class=\"edge "+(edge.health?"alert":"")+"\" x1=\""+from.x+"\" y1=\""+from.y+"\" x2=\""+to.x+"\" y2=\""+to.y+"\" marker-end=\"url(#arrow)\"/><text class=\"edge-label\" x=\""+midX+"\" y=\""+midY+"\">"+esc(edge.count>1?edge.count+"×":"")+"</text></g>"}).join(""),nodes=model.nodes.map((node)=>{const pos=positions.get(node.id),issues=nodeIssues(node.id),degree=degreeMap(edges).get(node.id)||0,selected=state.selected===node.id?" selected":"",issue=issues.length?" issue":"",nodeLabel=label(node),nodeKind=node.kind==="domain"?(node.memberCount||0)+" packages":node.kind;return "<g class=\"graph-node"+selected+issue+"\" transform=\"translate("+(pos.x-78)+","+(pos.y-27)+")\"><title>"+esc(nodeLabel)+" · "+esc(nodeKind)+"</title><rect width=\"156\" height=\"54\" rx=\"8\" role=\"button\" tabindex=\"0\" aria-label=\""+esc(nodeLabel+" "+nodeKind)+"\" data-node=\""+esc(node.id)+"\"></rect><text class=\"node-label\" x=\"10\" y=\"19\">"+esc(short(nodeLabel,22))+"</text><text class=\"node-kind\" x=\"10\" y=\"34\">"+esc(short(nodeKind,22))+"</text><text class=\"node-count\" x=\"144\" y=\"19\" text-anchor=\"end\">"+(degree||"")+"</text></g>"}).join("");svg.innerHTML=defs+edgeMarkup+nodes;routeGraphEdges();applyMapTransform();document.querySelector("#map-note").textContent=(state.level==="overview"?"Bounded domain view. ":state.level+" view. ")+"Directional edges are aggregated from canonical relations; "+model.edges.length+" visible connection groups"+(dense?" (showing "+edges.length+" prioritized of "+model.edges.length+").":".");};
 const findingMatches=(finding)=>{const query=state.query.toLowerCase();return(!query||[finding.id,finding.code,finding.message,...finding.entityIds,...finding.relationIds].join(" ").toLowerCase().includes(query))&&(!state.status||finding.status===state.status)&&(!state.severity||finding.severity===state.severity)};
-const findingScope=(finding)=>{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 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 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+" findings · "+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> finding"+(group.findings.length===1?"":"s")+" · "+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+" total</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 findings 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 count=data.diagnosticCount||0;document.querySelector("#finding-count").textContent=count+" findings · available on demand";document.querySelector("#findings").innerHTML="<div class=\"empty\"><p>Findings stay out of the first paint so large repositories remain responsive.</p><button id=\"load-findings\" class=\"tab\" type=\"button\">Load findings</button></div>"};
+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>"}};
 const findingsLoaded=()=>!lazyChunks.includes("chunks/findings.js")||loadedChunks.has("chunks/findings.js");
-const levelsLoaded=()=>!lazyChunks.includes("chunks/levels.js")||loadedChunks.has("chunks/levels.js");
+const levelsLoaded=()=>!hasLevelChunks||state.level==="overview"||activeLevelChunk===levelChunkName();
 const setReportView=()=>{document.body.dataset.reportView={architecture:"architecture",drift:"insights",risks:"findings",evidence:"coverage"}[state.lens]||"architecture";ensureReportChrome()};
-const render=()=>{if(state.level!=="overview"&&!levelsLoaded()){document.querySelector("#map-note").textContent="Loading canonical entities…";loadChunk("chunks/levels.js").then(render).catch((error)=>{document.querySelector("#map-note").textContent=error.message});return}if(state.lens!=="architecture"&&!findingsLoaded()){document.querySelector("#lens-caption").textContent="Loading findings for this lens…";loadChunk("chunks/findings.js").then(render).catch((error)=>{document.querySelector("#lens-caption").textContent=error.message});return}syncHash();setReportView();renderBreadcrumbs();document.querySelectorAll(".tab[data-lens]").forEach((tab)=>tab.setAttribute("aria-selected",String(tab.dataset.lens===state.lens)));document.querySelectorAll(".level").forEach((button)=>button.setAttribute("aria-pressed",String(button.dataset.level===state.level)));document.querySelector("#lens-caption").textContent=state.lens==="architecture"?"The repository topology at the selected level.":state.lens==="drift"?"Where canonical code relations and documentation declarations need attention.":state.lens==="risks"?"Signals that deserve human review; connectivity warnings are heuristics, not architectural proof.":"What the analyzers observed, declared, or could not analyze.";renderInsights();renderInsightsDashboard();renderGraph();renderDetails();renderFindings();deferFindings();renderCoverage()};
-document.addEventListener("click",async(event)=>{const target=event.target.closest?.("[data-level],[data-lens],#load-findings");if(!target)return;if(target.id==="load-findings"){event.preventDefault();event.stopImmediatePropagation();await loadChunk("chunks/findings.js");render();return}if(target.dataset.level&&!levelsLoaded()){event.preventDefault();event.stopImmediatePropagation();state.level=target.dataset.level;await loadChunk("chunks/levels.js");render();return}if(target.dataset.lens&&target.dataset.lens!=="architecture"&&!findingsLoaded()){event.preventDefault();event.stopImmediatePropagation();state.lens=target.dataset.lens;state.findingGroup=null;await loadChunk("chunks/findings.js");render()}},true);
-document.addEventListener("click",(event)=>{const node=event.target.closest?.("[data-node]");if(!node)return;event.preventDefault();event.stopImmediatePropagation();clearTimeout(nodeClickTimer);if(event.detail>=2){enterNode(node.dataset.node);return}nodeClickTimer=setTimeout(()=>{state.selected=node.dataset.node;render()},380)},true);
+const measureRender=(name,renderFn)=>{const started=performance.now(),value=renderFn(),timings=JSON.parse(document.documentElement.dataset.docBridgeRenderTimings||"{}");timings[name]=Math.round(performance.now()-started);document.documentElement.dataset.docBridgeRenderTimings=JSON.stringify(timings);return value};
+const render=()=>{if(state.level!=="overview"&&!levelsLoaded()){document.querySelector("#map-note").textContent="Loading canonical entities…";loadChunk(levelChunkName()).then(render).catch((error)=>{document.querySelector("#map-note").textContent=error.message});return}if(state.lens!=="architecture"&&!findingsLoaded()){document.querySelector("#lens-caption").textContent="Loading findings for this lens…";loadChunk("chunks/findings.js").then(render).catch((error)=>{document.querySelector("#lens-caption").textContent=error.message});return}syncHash();setReportView();renderBreadcrumbs();document.querySelectorAll(".tab[data-lens]").forEach((tab)=>tab.setAttribute("aria-selected",String(tab.dataset.lens===state.lens)));document.querySelectorAll(".level").forEach((button)=>button.setAttribute("aria-pressed",String(button.dataset.level===state.level)));document.querySelector("#lens-caption").textContent=state.lens==="architecture"?"The repository topology at the selected level.":state.lens==="drift"?"Where canonical code relations and documentation declarations need attention.":state.lens==="risks"?"Signals that deserve human review; connectivity warnings are heuristics, not architectural proof.":"What the analyzers observed, declared, or could not analyze.";document.documentElement.dataset.docBridgeRenderTimings="{}";measureRender("insights",renderInsights);if(state.lens!=="architecture")measureRender("insightsDashboard",renderInsightsDashboard);measureRender("graph",renderGraph);measureRender("details",renderDetails);if(state.lens!=="architecture")measureRender("findings",renderFindings);else document.querySelector("#findings")?.replaceChildren();deferFindings();measureRender("coverage",renderCoverage)};
+document.addEventListener("click",async(event)=>{const target=event.target.closest?.("[data-level],[data-lens],#load-findings");if(!target)return;if(target.id==="load-findings"){event.preventDefault();event.stopImmediatePropagation();await loadChunk("chunks/findings.js");render();return}if(target.dataset.level&&!levelsLoaded()){event.preventDefault();event.stopImmediatePropagation();state.level=target.dataset.level;await loadChunk(levelChunkName());render();return}if(target.dataset.lens&&target.dataset.lens!=="architecture"&&!findingsLoaded()){event.preventDefault();event.stopImmediatePropagation();state.lens=target.dataset.lens;state.findingGroup=null;await loadChunk("chunks/findings.js");render()}},true);
 document.addEventListener("click",(event)=>{const crumb=event.target.closest?.("[data-breadcrumb-level]");if(!crumb)return;event.preventDefault();event.stopImmediatePropagation();state.level=crumb.dataset.breadcrumbLevel;state.selected=crumb.dataset.breadcrumbSelected||null;mapState.scale=1;mapState.x=0;mapState.y=0;render()},true);
 document.addEventListener("input",async(event)=>{const target=event.target;if(target?.id!=="search"||findingsLoaded())return;event.stopImmediatePropagation();state.query=target.value;state.findingGroup=null;await loadChunk("chunks/findings.js");render()},true);
 document.addEventListener("change",async(event)=>{const target=event.target;if(!["status","severity"].includes(target?.id)||findingsLoaded())return;event.stopImmediatePropagation();state[target.id]=target.value;state.findingGroup=null;await loadChunk("chunks/findings.js");render()},true);
@@ -6682,14 +7329,15 @@ hydrate();render();keepMobileGraphReadable();ensurePolicyNote();
 var render = (input, options) => {
   const { snapshot, report } = input;
   const includeSnippets = options.includeSnippets === true;
-  const data = reportData(snapshot, report, includeSnippets);
+  const data = reportData(snapshot, report, includeSnippets, options.privacy);
   const scriptBody = script.replace("${DATA}", options.dataExpression ?? embeddedJson(data));
   const largeNote = snapshot.entities.length > 500 || report.diagnostics.length > 1e3 ? "Large snapshots are rendered from compact canonical data with progressive graph levels." : "The viewer starts with a grouped topology and expands into canonical entities on demand.";
-  const issueCount = report.diagnostics.filter((diagnostic2) => diagnostic2.severity === "error" || diagnostic2.severity === "warn").length;
+  const actionableCount = report.diagnostics.filter((diagnostic2) => diagnostic2.status !== "confirmed").length;
+  const confirmedCount = report.diagnostics.filter((diagnostic2) => diagnostic2.status === "confirmed").length;
   const unsupportedCount = snapshot.coverage.filter((entry) => entry.status !== "complete").length;
-  const policyNote = report.summary.requiredRelationKinds === void 0 ? "Missing relation declarations are checked for every observed relation kind." : report.summary.requiredRelationKinds.length ? `Missing relation declarations are checked for: ${report.summary.requiredRelationKinds.join(", ")}.` : "Missing relation declarations are disabled by configuration; stale, conflicting, and unresolved declarations remain checked.";
+  const policyNote = report.summary.requiredRelationKinds === void 0 ? "Missing relation declarations are checked for every observed relation kind." : report.summary.requiredRelationKinds.length ? `Missing relation declarations are checked for: ${report.summary.requiredRelationKinds.join(", ")}${report.summary.requiredRelationTargets === "internal" ? " between internal entities" : ""}.` : "Missing relation declarations are disabled by configuration; stale, conflicting, and unresolved declarations remain checked.";
   const statusOptions = ["confirmed", "undocumented", "stale-or-unverified", "conflict", "unresolved", "not-analyzed"];
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Doc Bridge \u2014 ${escapeHtml(snapshot.project.name)}</title><style>${styles}</style></head><body>${options.dataScripts ?? ""}<main class="shell"><header class="masthead"><div><div class="eyebrow">Doc Bridge / Knowledge report</div><h1>${escapeHtml(snapshot.project.name)}</h1><p class="lede">A read-only architecture and documentation map. Start broad, then follow evidence to the exact entity, relation, or finding.</p></div><div class="run-meta"><span class="read-only">Read-only snapshot</span><strong>${escapeHtml(snapshot.sourceRevision)}</strong><span>${escapeHtml(snapshot.sourceRevisionKind)} \xB7 pipeline ${escapeHtml(snapshot.pipelineVersion)}</span></div></header><section class="summary" aria-label="Snapshot summary"><div class="metric"><b>${snapshot.entities.length}</b><span>entities</span></div><div class="metric"><b>${snapshot.relations.length}</b><span>canonical relations</span></div><div class="metric ${issueCount ? "warn" : ""}"><b>${issueCount}</b><span>warn/error findings</span></div><div class="metric ${report.diagnostics.length ? "warn" : ""}"><b>${report.diagnostics.length}</b><span>total findings</span></div><div class="metric ${unsupportedCount ? "bad" : ""}"><b>${unsupportedCount}</b><span>partial / unanalyzed scopes</span></div></section><div class="lens-bar"><nav class="tabs" aria-label="Report lenses"><button class="tab" data-lens="architecture" aria-selected="true">Architecture</button><button class="tab" data-lens="drift" aria-selected="false">Documentation drift</button><button class="tab" data-lens="risks" aria-selected="false">Risks &amp; hotspots</button><button class="tab" data-lens="evidence" aria-selected="false">Evidence</button></nav><span class="subtle">${escapeHtml(largeNote)}</span></div><p id="lens-caption" class="subtle">The repository topology at the selected level.</p><p class="subtle">${escapeHtml(policyNote)}</p><section id="insights" class="insights" aria-label="Attention signals"></section><section class="filters" aria-label="Finding filters"><label>Search <input id="search" type="search" placeholder="Press / to search findings"></label><label>Status <select id="status"><option value="">Any status</option>${statusOptions.map((value) => `<option>${escapeHtml(value)}</option>`).join("")}</select></label><label>Severity <select id="severity"><option value="">Any severity</option><option>error</option><option>warn</option><option>info</option></select></label><button id="reset" type="button">Reset filters</button></section><div class="workspace"><section class="panel" aria-labelledby="architecture-title"><div class="panel-head"><div><h2 id="architecture-title">Architecture map</h2><p id="map-note" class="subtle">Grouped package/external view.</p></div><div class="tabs" aria-label="Graph level"><button class="level" data-level="overview" aria-pressed="true">Overview</button><button class="level" data-level="package" aria-pressed="false">Package</button><button class="level" data-level="module" aria-pressed="false">Module</button><button class="level" data-level="file" aria-pressed="false">File</button></div></div><div class="map-wrap"><svg id="graph" viewBox="0 0 1000 560" role="img" aria-label="Interactive architecture graph"></svg></div><p class="subtle">Node number = visible connection degree. Amber nodes/edges have findings. Click or focus a node to inspect its evidence, connectivity, and findings. Grouped edges preserve canonical relation direction and count.</p></section><aside class="panel side" aria-labelledby="details-title"><div class="panel-head"><div><div class="eyebrow">Evidence trail</div><h2 id="details-title">Details</h2></div><button id="clear-selection" class="tab" type="button">Clear</button></div><div id="details"><p class="subtle">Select a node in the map to inspect its evidence, connectivity, and findings.</p></div></aside></div><section class="panel run" aria-labelledby="run-title"><div class="panel-head"><div><div class="eyebrow">Jest-like diagnostics</div><h2 id="run-title">Run report</h2></div><span id="finding-count" class="subtle">${report.diagnostics.length} shown</span></div><div class="run-summary"><span class="chip"><b>${report.diagnostics.filter((item) => item.severity === "error").length}</b> errors</span><span class="chip"><b>${report.diagnostics.filter((item) => item.severity === "warn").length}</b> warnings</span><span class="chip"><b>${report.diagnostics.filter((item) => item.status === "undocumented").length}</b> undocumented</span><span class="chip"><b>${report.diagnostics.filter((item) => item.status === "stale-or-unverified" || item.status === "conflict").length}</b> drift/conflict</span></div><div id="findings"></div></section><section class="panel run" aria-labelledby="coverage-title"><div class="panel-head"><div><div class="eyebrow">Analyzer boundaries</div><h2 id="coverage-title">Coverage &amp; unsupported areas</h2></div><span class="subtle">Explicit limits are part of the evidence</span></div><div id="coverage-list"></div></section><section class="metadata" aria-label="Run metadata"><div><b>Snapshot</b>${escapeHtml(snapshot.contentHash)}</div><div><b>Report</b>${escapeHtml(report.contentHash)}</div><div><b>Configuration</b>${escapeHtml(snapshot.configurationHash)}</div><div><b>Analyzers</b>${escapeHtml(Object.entries(snapshot.analyzerVersions).map(([name, version]) => `${name} ${version}`).join(", "))}</div><div><b>Source revision</b>${escapeHtml(snapshot.sourceRevision)} (${escapeHtml(snapshot.sourceRevisionKind)})</div><div><b>Mode</b>Read-only browser viewer; approvals and fixes remain outside this artifact.</div></section></main><script>${scriptBody}</script></body></html>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Doc Bridge \u2014 ${escapeHtml(data.project.name)}</title><style>${styles}</style></head><body>${options.dataScripts ?? ""}<main class="shell"><header class="masthead"><div><div class="eyebrow">Doc Bridge / Knowledge report</div><h1>${escapeHtml(data.project.name)}</h1><p class="lede">A read-only architecture and documentation map. Start broad, then follow evidence to the exact entity, relation, or finding.</p></div><div class="run-meta"><span class="read-only">Read-only snapshot</span><strong>${escapeHtml(data.revision)}</strong><span>${escapeHtml(data.revisionKind)} \xB7 pipeline ${escapeHtml(data.pipelineVersion)}</span></div></header><section class="summary" aria-label="Snapshot summary"><div class="metric"><b>${snapshot.entities.length}</b><span>entities</span></div><div class="metric"><b>${snapshot.relations.length}</b><span>canonical relations</span></div><div class="metric ${actionableCount ? "warn" : ""}"><b>${actionableCount}</b><span>actionable findings</span></div><div class="metric"><b>${confirmedCount}</b><span>confirmed checks</span></div><div class="metric ${unsupportedCount ? "bad" : ""}"><b>${unsupportedCount}</b><span>partial / unanalyzed scopes</span></div></section><div class="lens-bar"><nav class="tabs" aria-label="Report lenses"><button class="tab" data-lens="architecture" aria-selected="true">Architecture</button><button class="tab" data-lens="drift" aria-selected="false">Documentation drift</button><button class="tab" data-lens="risks" aria-selected="false">Risks &amp; hotspots</button><button class="tab" data-lens="evidence" aria-selected="false">Evidence</button></nav><span class="subtle">${escapeHtml(largeNote)}</span></div><p id="lens-caption" class="subtle">The repository topology at the selected level.</p><p class="subtle">${escapeHtml(policyNote)}</p><section id="insights" class="insights" aria-label="Attention signals"></section><section class="filters" aria-label="Finding filters"><label>Search <input id="search" type="search" placeholder="Press / to search findings"></label><label>Status <select id="status"><option value="">Any status</option>${statusOptions.map((value) => `<option>${escapeHtml(value)}</option>`).join("")}</select></label><label>Severity <select id="severity"><option value="">Any severity</option><option>error</option><option>warn</option><option>info</option></select></label><button id="reset" type="button">Reset filters</button></section><div class="workspace"><section class="panel" aria-labelledby="architecture-title"><div class="panel-head"><div><h2 id="architecture-title">Architecture map</h2><p id="map-note" class="subtle">Grouped package/external view.</p></div><div class="tabs" aria-label="Graph level"><button class="level" data-level="overview" aria-pressed="true">Overview</button><button class="level" data-level="package" aria-pressed="false">Package</button><button class="level" data-level="module" aria-pressed="false">Module</button><button class="level" data-level="file" aria-pressed="false">File</button></div></div><div class="map-wrap"><svg id="graph" viewBox="0 0 1000 560" role="img" aria-label="Interactive architecture graph"></svg></div><p class="subtle">Node number = visible connection degree. Amber nodes/edges have actionable findings. Click or focus a node to inspect its evidence, connectivity, and findings. Grouped edges preserve canonical relation direction and count.</p></section><aside class="panel side" aria-labelledby="details-title"><div class="panel-head"><div><div class="eyebrow">Evidence trail</div><h2 id="details-title">Details</h2></div><button id="clear-selection" class="tab" type="button">Clear</button></div><div id="details"><p class="subtle">Select a node in the map to inspect its evidence, connectivity, and findings.</p></div></aside></div><section class="panel run" aria-labelledby="run-title"><div class="panel-head"><div><div class="eyebrow">Jest-like diagnostics</div><h2 id="run-title">Run report</h2></div><span id="finding-count" class="subtle">${actionableCount} actionable findings \xB7 ${confirmedCount} confirmed checks</span></div><div class="run-summary"><span class="chip"><b>${report.diagnostics.filter((item) => item.severity === "error").length}</b> errors</span><span class="chip"><b>${report.diagnostics.filter((item) => item.severity === "warn").length}</b> warnings</span><span class="chip"><b>${report.diagnostics.filter((item) => item.status === "undocumented").length}</b> undocumented</span><span class="chip"><b>${report.diagnostics.filter((item) => item.status === "stale-or-unverified" || item.status === "conflict").length}</b> drift/conflict</span><span class="chip"><b>${confirmedCount}</b> confirmed checks</span></div><div id="findings"></div></section><section class="panel run" aria-labelledby="coverage-title"><div class="panel-head"><div><div class="eyebrow">Analyzer boundaries</div><h2 id="coverage-title">Coverage &amp; unsupported areas</h2></div><span class="subtle">Explicit limits are part of the evidence</span></div><div id="coverage-list"></div></section><section class="metadata" aria-label="Run metadata"><div><b>Snapshot</b>${escapeHtml(data.snapshotHash)}</div><div><b>Report</b>${escapeHtml(data.reportHash)}</div><div><b>Configuration</b>${escapeHtml(data.configurationHash)}</div><div><b>Analyzers</b>${escapeHtml(Object.entries(data.analyzerVersions).map(([name, version]) => `${name} ${version}`).join(", "))}</div><div><b>Source revision</b>${escapeHtml(data.revision)} (${escapeHtml(data.revisionKind)})</div><div><b>Mode</b>${options.privacy === "anonymized" ? "Anonymized read-only browser viewer; evidence paths and project identity are redacted." : "Read-only browser viewer; approvals and fixes remain outside this artifact."}</div></section></main><script>${scriptBody}</script></body></html>`;
 };
 var parseReportInput = (input) => {
   if (!input || typeof input !== "object") throw new Error("Input must contain snapshot and report artifacts.");
@@ -6700,31 +7348,186 @@ var parseReportInput = (input) => {
   return { snapshot, report };
 };
 var chunkScript = (payload) => `globalThis.__DOC_BRIDGE_DATA__=Object.assign(globalThis.__DOC_BRIDGE_DATA__||{},${embeddedJson(payload)});`;
+var levelChunkScript = (payload) => `globalThis.__DOC_BRIDGE_LEVEL_PAYLOAD__=${embeddedJson(payload)};`;
+var detailChunkScript = (payload) => `globalThis.__DOC_BRIDGE_DETAIL_PAYLOAD__=${embeddedJson(payload)};`;
 var byteLength = (value) => new TextEncoder().encode(value).byteLength;
 var renderOfflineReportArtifact = (input, options = {}) => {
   const parsed = parseReportInput(input);
   const thresholdBytes = options.thresholdBytes ?? DEFAULT_LARGE_REPORT_THRESHOLD_BYTES;
-  const renderOptions = { includeSnippets: options.includeSnippets === true, thresholdBytes };
+  const renderOptions = { includeSnippets: options.includeSnippets === true, privacy: options.privacy ?? "private", thresholdBytes };
   const singleFile = render(parsed, options);
   if (byteLength(singleFile) <= thresholdBytes) {
     const files2 = { "index.html": sha256NormalizedV1(singleFile) };
-    const manifestPayload2 = { schemaVersion: 1, mode: "single-file", generatedBy: "@agentskit/doc-bridge", snapshotHash: parsed.snapshot.contentHash, reportHash: parsed.report.contentHash, configurationHash: parsed.snapshot.configurationHash, sourceRevision: parsed.snapshot.sourceRevision, renderOptions, files: files2 };
+    const manifestPayload2 = { schemaVersion: 1, mode: "single-file", generatedBy: "@agentskit/doc-bridge", snapshotHash: parsed.snapshot.contentHash, reportHash: parsed.report.contentHash, configurationHash: parsed.snapshot.configurationHash, sourceRevision: options.privacy === "anonymized" ? "redacted" : parsed.snapshot.sourceRevision, renderOptions, files: files2 };
     const manifest2 = JSON.stringify({ ...manifestPayload2, artifactHash: sha256NormalizedV1(manifestPayload2) }, null, 2);
     return { mode: "single-file", indexHtml: singleFile, files: { "index.html": singleFile }, manifest: manifest2 };
   }
-  const data = reportData(parsed.snapshot, parsed.report, options.includeSnippets === true);
+  const data = reportData(parsed.snapshot, parsed.report, options.includeSnippets === true, options.privacy);
+  const entitiesById = new Map(data.entities.map((entity) => [entity.id, entity]));
+  const packageEntities = data.entities.filter((entity) => entity.kind === "package");
+  const packageIds = new Set(packageEntities.map((entity) => entity.id));
+  const packageRelations = data.relations.filter((relation) => packageIds.has(relation.from) && packageIds.has(relation.to));
+  const diagnosticGroup = Object.fromEntries(data.diagnostics.map((diagnostic2) => {
+    const groups = /* @__PURE__ */ new Set();
+    for (const entityId2 of diagnostic2.entityIds ?? []) {
+      const groupId = data.view.entityGroup[entityId2];
+      if (groupId) groups.add(groupId);
+    }
+    for (const relationId of diagnostic2.relationIds ?? []) {
+      const relation = data.relations.find((candidate) => candidate.id === relationId);
+      if (!relation) continue;
+      for (const endpoint of [relation.from, relation.to]) {
+        const groupId = data.view.entityGroup[endpoint];
+        if (groupId) groups.add(groupId);
+      }
+    }
+    return [diagnostic2.id, [...groups].sort()];
+  }));
+  const diagnosticRelationFindings = /* @__PURE__ */ new Map();
+  for (const diagnostic2 of data.diagnostics) {
+    for (const relationId of diagnostic2.relationIds ?? []) {
+      const findings = diagnosticRelationFindings.get(relationId) ?? [];
+      findings.push({ status: diagnostic2.status, severity: diagnostic2.severity });
+      diagnosticRelationFindings.set(relationId, findings);
+    }
+  }
+  const containsRelations = data.relations.filter((relation) => relation.kind === "contains");
+  const collectScope = (roots) => {
+    const ids = new Set(roots);
+    let changed = true;
+    while (changed) {
+      changed = false;
+      for (const relation of containsRelations) {
+        if (ids.has(relation.from) && !ids.has(relation.to)) {
+          ids.add(relation.to);
+          changed = true;
+        }
+      }
+    }
+    return ids;
+  };
+  const scopedPayload = (ids) => ({
+    entities: data.entities.filter((entity) => ids.has(entity.id)),
+    relations: data.relations.filter((relation) => ids.has(relation.from) && ids.has(relation.to))
+  });
+  const packagePayload = (ids) => ({
+    entities: data.entities.filter((entity) => ids.has(entity.id) && entity.kind === "package"),
+    relations: data.relations.filter((relation) => ids.has(relation.from) && ids.has(relation.to) && entitiesById.get(relation.from)?.kind === "package" && entitiesById.get(relation.to)?.kind === "package")
+  });
+  const compactPayload = (payload) => ({
+    entities: payload.entities.map(({ evidence: _evidence, anchor: _anchor, provenance: _provenance, ...entity }) => entity),
+    relations: payload.relations.map(({ evidence: _evidence, provenance: _provenance, ...relation }) => relation)
+  });
+  const levelFiles = {};
+  const detailFiles = {};
+  for (const [groupId, group] of Object.entries(data.view.groups)) {
+    const ids = new Set(group.members.filter((id) => entitiesById.get(id)?.kind === "package"));
+    const chunkName = data.view.levelChunks.groups[groupId];
+    if (chunkName) levelFiles[chunkName] = levelChunkScript(packagePayload(ids));
+  }
+  const packageIdList = packageEntities.map((entity) => entity.id);
+  const packageIdSet = new Set(packageIdList);
+  levelFiles[data.view.levelChunks.default] = levelChunkScript(scopedPayload(packageIdSet));
+  const sortedPackageIds = [...packageIds].sort();
+  for (const [index, packageId2] of sortedPackageIds.entries()) {
+    const chunkName = data.view.levelChunks.packages[index];
+    const packageScope = scopedPayload(collectScope([packageId2]));
+    if (chunkName) levelFiles[chunkName] = levelChunkScript(compactPayload(packageScope));
+    const detailName = chunkName?.replace("chunks/levels-package-", "chunks/details-");
+    if (detailName) detailFiles[detailName] = detailChunkScript(packageScope);
+  }
+  const overviewView = {
+    ...data.view,
+    entityGroup: Object.fromEntries(Object.entries(data.view.entityGroup).filter(([id]) => data.entities.find((entity) => entity.id === id)?.kind === "package")),
+    diagnosticGroup,
+    diagnosticRelationFindings: Object.fromEntries(diagnosticRelationFindings)
+  };
   const files = {
-    "chunks/overview.js": chunkScript({ project: data.project, revision: data.revision, revisionKind: data.revisionKind, snapshotHash: data.snapshotHash, reportHash: data.reportHash, configurationHash: data.configurationHash, pipelineVersion: data.pipelineVersion, analyzerVersions: data.analyzerVersions, coverage: data.coverage, diagnosticCount: data.diagnosticCount, diagnosticSummary: data.diagnosticSummary, requiredRelationKinds: data.requiredRelationKinds, view: data.view }),
-    "chunks/levels.js": chunkScript({ entities: data.entities, relations: data.relations }),
+    "chunks/overview.js": chunkScript({ project: data.project, revision: data.revision, revisionKind: data.revisionKind, snapshotHash: data.snapshotHash, reportHash: data.reportHash, configurationHash: data.configurationHash, pipelineVersion: data.pipelineVersion, analyzerVersions: data.analyzerVersions, coverage: data.coverage, diagnosticCount: data.diagnosticCount, actionableCount: data.actionableCount, confirmedCount: data.confirmedCount, diagnosticSummary: data.diagnosticSummary, documentation: data.documentation, requiredRelationKinds: data.requiredRelationKinds, entities: packageEntities, relations: packageRelations, view: overviewView }),
+    ...levelFiles,
+    ...detailFiles,
     "chunks/findings.js": chunkScript({ diagnostics: data.diagnostics })
   };
-  const indexHtml = render(parsed, { ...options, dataExpression: "globalThis.__DOC_BRIDGE_DATA__", dataScripts: `<script>globalThis.__DOC_BRIDGE_LAZY_CHUNKS__=${embeddedJson(["chunks/levels.js", "chunks/findings.js"])}</script><script src="chunks/overview.js"></script>` });
+  const indexHtml = render(parsed, { ...options, dataExpression: "globalThis.__DOC_BRIDGE_DATA__", dataScripts: `<script>globalThis.__DOC_BRIDGE_HAS_LEVEL_CHUNKS__=true;globalThis.__DOC_BRIDGE_LAZY_CHUNKS__=["chunks/findings.js"]</script><script src="chunks/overview.js"></script>` });
   const fileHashes = Object.fromEntries(Object.entries({ ...files, "index.html": indexHtml }).map(([file, content]) => [file, sha256NormalizedV1(content)]));
-  const manifestPayload = { schemaVersion: 1, mode: "directory", generatedBy: "@agentskit/doc-bridge", snapshotHash: parsed.snapshot.contentHash, reportHash: parsed.report.contentHash, configurationHash: parsed.snapshot.configurationHash, sourceRevision: parsed.snapshot.sourceRevision, renderOptions, files: fileHashes };
+  const manifestPayload = { schemaVersion: 1, mode: "directory", generatedBy: "@agentskit/doc-bridge", snapshotHash: parsed.snapshot.contentHash, reportHash: parsed.report.contentHash, configurationHash: parsed.snapshot.configurationHash, sourceRevision: options.privacy === "anonymized" ? "redacted" : parsed.snapshot.sourceRevision, renderOptions, files: fileHashes };
   const manifest = JSON.stringify({ ...manifestPayload, artifactHash: sha256NormalizedV1(manifestPayload) }, null, 2);
   return { mode: "directory", indexHtml, files: { ...files, "index.html": indexHtml }, manifest };
 };
 
+// src/metrics/benchmark.ts
+import { z as z9 } from "zod";
+var BENCHMARK_SCHEMA_VERSION = 1;
+var stringList = z9.array(z9.string().min(1).max(512)).max(1e5);
+var benchmarkSets = z9.object({
+  entities: stringList.default([]),
+  relations: stringList.default([]),
+  findings: stringList.default([])
+}).strict();
+var BenchmarkFixtureV1Schema = z9.object({
+  schemaVersion: z9.literal(BENCHMARK_SCHEMA_VERSION),
+  supported: benchmarkSets,
+  excluded: benchmarkSets.optional()
+}).strict();
+var unique = (values) => new Set(values);
+var ratio = (numerator, denominator) => denominator === 0 ? 1 : numerator / denominator;
+var setMetrics = (actualValues, expectedValues, excludedValues) => {
+  const excluded = unique(excludedValues);
+  const activeActualValues = actualValues.filter((value) => !excluded.has(value));
+  const actual = unique(activeActualValues);
+  const expected = unique(expectedValues.filter((value) => !excluded.has(value)));
+  const truePositives = [...actual].filter((value) => expected.has(value)).length;
+  const falsePositives = actual.size - truePositives;
+  const falseNegatives = expected.size - truePositives;
+  return {
+    truePositives,
+    falsePositives,
+    falseNegatives,
+    precision: ratio(truePositives, actual.size),
+    recall: ratio(truePositives, expected.size),
+    duplicateCount: activeActualValues.length - actual.size
+  };
+};
+var benchmarkFixture = (fixture) => BenchmarkFixtureV1Schema.parse(fixture);
+var measureBenchmark = (observation, fixture, thresholds = {}) => {
+  const excluded = fixture.excluded ?? { entities: [], relations: [], findings: [] };
+  const quality = {
+    entities: setMetrics(observation.entities, fixture.supported.entities, excluded.entities),
+    relations: setMetrics(observation.relations, fixture.supported.relations, excluded.relations),
+    findings: setMetrics(observation.findings, fixture.supported.findings, excluded.findings)
+  };
+  const actualEntities = unique(observation.entities);
+  const evidenced = unique(observation.evidenced ?? []);
+  const evidenceRatio = ratio([...actualEntities].filter((id) => evidenced.has(id)).length, actualEntities.size);
+  const findingDensity = ratio(unique(observation.findings).size, actualEntities.size);
+  const precisionThreshold = thresholds.precision ?? 0.95;
+  const recallThreshold = thresholds.recall ?? 1;
+  const regressions = [];
+  for (const [name, metrics] of Object.entries(quality)) {
+    if (metrics.precision < precisionThreshold) regressions.push(`${name}.precision below ${precisionThreshold}`);
+    if (metrics.recall < recallThreshold) regressions.push(`${name}.recall below ${recallThreshold}`);
+  }
+  return {
+    schemaVersion: BENCHMARK_SCHEMA_VERSION,
+    quality,
+    evidenceRatio,
+    findingDensity,
+    findingCategoryDistribution: Object.fromEntries(Object.entries(observation.findingCategories ?? {}).sort(([a], [b]) => a.localeCompare(b))),
+    excludedCaseCount: excluded.entities.length + excluded.relations.length + excluded.findings.length,
+    excludedCaseIds: { entities: excluded.entities.length, relations: excluded.relations.length, findings: excluded.findings.length },
+    thresholds: { precision: precisionThreshold, recall: recallThreshold },
+    regressions
+  };
+};
+var formatBenchmarkText = (result) => [
+  `Precision: entities ${result.quality.entities.precision.toFixed(3)}, relations ${result.quality.relations.precision.toFixed(3)}, findings ${result.quality.findings.precision.toFixed(3)}`,
+  `Recall: entities ${result.quality.entities.recall.toFixed(3)}, relations ${result.quality.relations.recall.toFixed(3)}, findings ${result.quality.findings.recall.toFixed(3)}`,
+  `Evidence ratio: ${result.evidenceRatio.toFixed(3)}`,
+  `Finding density: ${result.findingDensity.toFixed(3)}`,
+  `Excluded cases: ${result.excludedCaseCount}`,
+  `Regressions: ${result.regressions.length ? result.regressions.join("; ") : "none"}`
+].join("\n");
+
 // src/cli/program.ts
 var usage = `ak-docs \u2014 human\u2194agent documentation bridge (@agentskit/doc-bridge)
 
@@ -6734,6 +7537,7 @@ Core (no API key):
   ak-docs doctor [--text] [--badge] [--write-badge]
   ak-docs index [--watch]
   ak-docs discover [--text|--json]
+  ak-docs benchmark <fixture.json> <observation.json> [--text|--json]
   ak-docs scan | reconcile | check | map [--text|--json] [--html] [--report-threshold <bytes>]
   ak-docs fix propose links|normalize <artifact> [--output <file>]
   ak-docs fix approve|apply <proposal.json> [--by <name>]
@@ -6804,6 +7608,7 @@ var parseArgs = (argv) => {
   else if (positional[0] === "playbook") command = "playbook";
   else if (positional[0] === "registry") command = "registry";
   else if (positional[0] === "discover") command = "discover";
+  else if (positional[0] === "benchmark") command = "benchmark";
   else if (positional[0] === "scan") command = "scan";
   else if (positional[0] === "reconcile") command = "reconcile";
   else if (positional[0] === "check") command = "check";
@@ -7019,33 +7824,44 @@ var diagnosticNextCommands = (config, result) => {
     "ak-docs index"
   ];
 };
-var workflowOptions = (root, config, sourceRevision2, stage, handlers) => ({
+var workflowOptions = (root, config, sourceRevision2, stage, handlers, versions) => ({
   root,
   ...config.workflow?.stateDir ? { stateDir: config.workflow.stateDir } : {},
   sourceRevision: sourceRevision2,
   configurationHash: sha256NormalizedV1(config),
-  toolVersion: "1.0.1",
+  toolVersion: PACKAGE_VERSION,
+  ...versions?.pipelineVersion ? { pipelineVersion: versions.pipelineVersion } : {},
+  ...versions?.analyzerVersions ? { analyzerVersions: versions.analyzerVersions } : {},
   stage,
   handlers
 });
 var scanWorkflow = (root, config) => {
   const discovered = discoverRepository({ root, config });
-  runWorkflow(workflowOptions(root, config, discovered.sourceRevision, "collect", { collect: () => discovered }));
-  return runWorkflow(workflowOptions(root, config, discovered.sourceRevision, "normalize", { normalize: ({ input }) => input }));
+  const versions = { pipelineVersion: discovered.pipelineVersion, analyzerVersions: discovered.analyzerVersions };
+  runWorkflow(workflowOptions(root, config, discovered.sourceRevision, "collect", { collect: () => discovered }, versions));
+  return runWorkflow(workflowOptions(root, config, discovered.sourceRevision, "normalize", { normalize: ({ input }) => input }, versions));
 };
 var documentationInputs = (root, snapshot) => snapshot.entities.filter((entity) => entity.kind === "document" && entity.path).map((entity) => ({ path: entity.path, content: readFileSync21(resolve18(root, entity.path), "utf8") }));
 var reconcileWorkflow = (root, config) => {
   const scanned = scanWorkflow(root, config);
   const snapshot = parseDiscoverySnapshot(loadWorkflowStepOutput(scanned.stateDir, "normalize"));
-  const declared = applyDocumentationDeclarations(snapshot, documentationInputs(root, snapshot)).snapshot;
-  const report = reconcileKnowledge(snapshot, declared, config.reconciliation?.requiredRelationKinds === void 0 ? {} : { requiredRelationKinds: config.reconciliation.requiredRelationKinds });
-  return runWorkflow(workflowOptions(root, config, snapshot.sourceRevision, "reconcile", { reconcile: () => report }));
+  const declared = applyDocumentationDeclarations(snapshot, documentationInputs(root, snapshot), {
+    agentRoot: config.corpus.agent.root
+  }).snapshot;
+  const report = reconcileKnowledge(snapshot, declared, {
+    ...config.reconciliation?.scope === void 0 ? {} : { scope: config.reconciliation.scope },
+    ...config.reconciliation?.requiredRelationKinds === void 0 ? {} : { requiredRelationKinds: config.reconciliation.requiredRelationKinds },
+    ...config.reconciliation?.requiredRelationTargets === void 0 ? {} : { requiredRelationTargets: config.reconciliation.requiredRelationTargets },
+    ...config.reconciliation?.includeOrphanedDocuments === void 0 ? {} : { includeOrphanedDocuments: config.reconciliation.includeOrphanedDocuments }
+  });
+  return runWorkflow(workflowOptions(root, config, snapshot.sourceRevision, "reconcile", { reconcile: () => report }, { pipelineVersion: snapshot.pipelineVersion, analyzerVersions: snapshot.analyzerVersions }));
 };
 var checkWorkflow = (root, config) => {
   const reconciled = reconcileWorkflow(root, config);
   const report = parseReconciliationReport(loadWorkflowStepOutput(reconciled.stateDir, "reconcile"));
-  const evaluated = runWorkflow(workflowOptions(root, config, report.sourceRevision, "evaluate", { evaluate: () => evaluateRules(report, { ...config.rules ? { config: config.rules } : {} }) }));
-  return runWorkflow(workflowOptions(root, config, report.sourceRevision, "report", { report: ({ input }) => input }));
+  const versions = { pipelineVersion: report.pipelineVersion, analyzerVersions: report.analyzerVersions };
+  runWorkflow(workflowOptions(root, config, report.sourceRevision, "evaluate", { evaluate: () => evaluateRules(report, { ...config.rules ? { config: config.rules } : {} }) }, versions));
+  return runWorkflow(workflowOptions(root, config, report.sourceRevision, "report", { report: ({ input }) => input }, versions));
 };
 var workflowOutput = (result) => {
   const snapshot = (() => {
@@ -7089,7 +7905,7 @@ var writeAtomicFile = (path, content) => {
   renameSync3(temporaryPath, path);
 };
 var writeReportArtifact = (htmlPath, artifact2) => {
-  mkdirSync8(dirname10(htmlPath), { recursive: true });
+  mkdirSync7(dirname9(htmlPath), { recursive: true });
   if (artifact2.mode === "single-file") {
     writeAtomicFile(htmlPath, artifact2.indexHtml);
     const artifactDir2 = htmlPath.replace(/\.html?$/i, "");
@@ -7102,14 +7918,14 @@ var writeReportArtifact = (htmlPath, artifact2) => {
   const launcherTemp = `${htmlPath}.tmp-${process.pid}`;
   rmSync3(temporaryDir, { recursive: true, force: true });
   rmSync3(backupDir, { recursive: true, force: true });
-  mkdirSync8(temporaryDir, { recursive: true });
+  mkdirSync7(temporaryDir, { recursive: true });
   for (const [file, content] of Object.entries(artifact2.files)) {
     const filePath = resolve18(temporaryDir, file);
-    mkdirSync8(dirname10(filePath), { recursive: true });
+    mkdirSync7(dirname9(filePath), { recursive: true });
     writeFileSync8(filePath, content, "utf8");
   }
   writeFileSync8(resolve18(temporaryDir, "manifest.json"), artifact2.manifest, "utf8");
-  const frameSource = `${relative10(dirname10(htmlPath), artifactDir)}/index.html`;
+  const frameSource = `${relative10(dirname9(htmlPath), artifactDir)}/index.html`;
   const launcher = `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Doc Bridge report</title></head><body style="margin:0"><iframe title="Doc Bridge report" src="${frameSource}" style="border:0;width:100vw;height:100vh"></iframe></body></html>`;
   writeFileSync8(launcherTemp, launcher, "utf8");
   try {
@@ -7141,11 +7957,11 @@ var runWorkflowCommand = (command, flags, configPath, argv) => {
       const report = parseReconciliationReport(loadWorkflowStepOutput(result.stateDir, "reconcile"));
       const outputPath = optionValues(argv, "--output")[0] ?? ".doc-bridge/report.html";
       const htmlPath = resolve18(root, outputPath);
-      mkdirSync8(dirname10(htmlPath), { recursive: true });
+      mkdirSync7(dirname9(htmlPath), { recursive: true });
       const thresholdValue = optionValues(argv, "--report-threshold")[0];
       const thresholdBytes = thresholdValue === void 0 ? void 0 : Number(thresholdValue);
       if (thresholdBytes !== void 0 && (!Number.isSafeInteger(thresholdBytes) || thresholdBytes < 1)) throw new Error("--report-threshold must be a positive integer.");
-      const artifact2 = renderOfflineReportArtifact({ snapshot, report }, { ...thresholdBytes === void 0 ? {} : { thresholdBytes } });
+      const artifact2 = renderOfflineReportArtifact({ snapshot, report }, { ...config.report?.privacy ? { privacy: config.report.privacy } : {}, ...thresholdBytes === void 0 ? {} : { thresholdBytes } });
       output.htmlPath = writeReportArtifact(htmlPath, artifact2);
       output.htmlMode = artifact2.mode;
     }
@@ -7219,7 +8035,7 @@ var runFixCommand = (argv, positional, configPath) => {
       }
       const outputPath = optionValues(argv, "--output")[0];
       if (outputPath) {
-        mkdirSync8(dirname10(resolve18(root, outputPath)), { recursive: true });
+        mkdirSync7(dirname9(resolve18(root, outputPath)), { recursive: true });
         writeFileSync8(resolve18(root, outputPath), `${JSON.stringify(proposal2, null, 2)}
 `, "utf8");
       }
@@ -7259,10 +8075,19 @@ var runSuggestCommand = async (flags, configPath) => {
   }
 };
 var writeIfMissing = (path, contents) => {
-  if (existsSync21(path)) return false;
-  mkdirSync8(dirname10(path), { recursive: true });
-  writeFileSync8(path, contents, "utf8");
-  return true;
+  mkdirSync7(dirname9(path), { recursive: true });
+  try {
+    const fd = openSync3(path, "wx");
+    try {
+      writeFileSync8(fd, contents, "utf8");
+      return true;
+    } finally {
+      closeSync3(fd);
+    }
+  } catch (error) {
+    if (error.code === "EEXIST") return false;
+    throw error;
+  }
 };
 var demoOwnership = {
   example: {
@@ -7473,6 +8298,26 @@ var runCli = (argv) => {
       return 0;
     } catch (error) {
       process.stderr.write(`${error instanceof Error ? error.message : String(error)}
+`);
+      return 2;
+    }
+  }
+  if (command === "benchmark") {
+    const fixturePath2 = positional[1];
+    const observationPath = positional[2];
+    if (!fixturePath2 || !observationPath) {
+      process.stderr.write("Usage: ak-docs benchmark <fixture.json> <observation.json> [--text|--json]\n");
+      return 1;
+    }
+    try {
+      const fixture = benchmarkFixture(JSON.parse(readFileSync21(resolve18(fixturePath2), "utf8")));
+      const observation = JSON.parse(readFileSync21(resolve18(observationPath), "utf8"));
+      const result = measureBenchmark(observation, fixture);
+      if (flags.has("--text")) writeLines([formatBenchmarkText(result)]);
+      else writeJson2(result);
+      return result.regressions.length ? 1 : 0;
+    } catch (error) {
+      process.stderr.write(`${error instanceof Error ? error.message : String(error)}
 `);
       return 2;
     }
@@ -7741,7 +8586,7 @@ var runCli = (argv) => {
       const report = runDoctor(root, config);
       if (flags.has("--write-badge")) {
         const badgePath = resolve18(root, ".doc-bridge", "coverage-badge.json");
-        mkdirSync8(dirname10(badgePath), { recursive: true });
+        mkdirSync7(dirname9(badgePath), { recursive: true });
         writeFileSync8(badgePath, `${formatDoctorBadgeJson(report.badge)}
 `, "utf8");
       }