@agentskit/doc-bridge 1.6.3 → 1.7.44

package/dist/cli/program.js

@@ -474,8 +474,32 @@ var RulesConfigSchema = z.object({
   warningThresholds: z.record(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(),
+  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 +512,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 +587,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 +684,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(),
@@ -1448,7 +1483,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.6.3";
+var PACKAGE_VERSION = "1.7.44";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {
@@ -1505,9 +1540,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 = {}) => {
@@ -2556,9 +2591,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(),
@@ -2641,7 +2677,21 @@ 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(),
+    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(),
+      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 +2809,14 @@ var scalar = (value) => {
   }
   return trimmed;
 };
+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 +2833,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 +2857,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 +2875,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 = [];
@@ -2891,7 +2977,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 +3038,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);
@@ -3064,6 +3150,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 +3180,12 @@ 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(?:\/|$)/.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;
@@ -3233,29 +3327,67 @@ var exportedNames = (sourceFile) => {
   visit(sourceFile);
   return [...names].sort();
 };
-var moduleReferences = (root, path, sourceFile) => {
+var moduleReferences = (root, path, sourceFile, runtimeWiringMethods) => {
   const references = [];
   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 collectStaticStringBindings = (node) => {
+    if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.initializer && ts.isStringLiteralLike(node.initializer) && ts.isVariableDeclarationList(node.parent) && (node.parent.flags & ts.NodeFlags.Const) !== 0) {
+      const previous = staticStringBindings.get(node.name.text);
+      staticStringBindings.set(node.name.text, !staticStringBindings.has(node.name.text) || previous === node.initializer.text ? node.initializer.text : void 0);
+    }
+    ts.forEachChild(node, collectStaticStringBindings);
+  };
+  collectStaticStringBindings(sourceFile);
+  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;
+        if (node.arguments[0] && ts.isStringLiteralLike(node.arguments[0])) {
+          hasLiteralDynamic = true;
+          addReference(node.arguments[0], "imports", node, "dynamic-literal");
+        } else if (node.arguments[0] && ts.isIdentifier(node.arguments[0]) && staticStringBindings.get(node.arguments[0].text)) {
+          hasLiteralDynamic = true;
+          addReference({ text: staticStringBindings.get(node.arguments[0].text) }, "imports", node, "dynamic-literal");
+        } else hasDynamic = true;
       } 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 if (argument && ts.isIdentifier(argument) && staticStringBindings.get(argument.text)) addReference({ text: staticStringBindings.get(argument.text) }, "imports", node);
         else hasDynamic = true;
-      } else if (ts.isPropertyAccessExpression(node.expression) && node.expression.name.text === "register") {
+      } else if (ts.isPropertyAccessExpression(node.expression) && runtimeWiringMethods.has(node.expression.name.text)) {
         hasRuntimeWiring = true;
+        const before = references.length;
+        let hasPotentialTargetArgument = false;
+        for (const argument of node.arguments) {
+          if (ts.isIdentifier(argument)) {
+            hasPotentialTargetArgument = true;
+            const specifier = importedBindings.get(argument.text);
+            if (specifier) addReference({ text: specifier }, "runtime-wiring", node, "runtime-wiring-static");
+          } else if (ts.isPropertyAccessExpression(argument) || ts.isCallExpression(argument)) {
+            hasPotentialTargetArgument = true;
+          }
+        }
+        if (hasPotentialTargetArgument && references.length === before) hasUnresolvedRuntimeWiring = true;
       }
     }
     ts.forEachChild(node, visit);
@@ -3265,7 +3397,9 @@ var moduleReferences = (root, path, sourceFile) => {
     references,
     exports: exportedNames(sourceFile),
     hasDynamic,
-    hasRuntimeWiring
+    hasLiteralDynamic,
+    hasRuntimeWiring,
+    hasUnresolvedRuntimeWiring
   };
 };
 var resolveRelativeModule = (specifier, containingFile, modulePaths) => {
@@ -3339,10 +3473,10 @@ var artifact = (root, config, files, entities, relations, coverage) => {
     sourceRevisionKind: revision.kind,
     configurationHash: sha256NormalizedV1(config ?? {}),
     pipelineVersion: "1.0.0",
-    analyzerVersions: { repository: "1.0.0", "js-ts": "1.0.0" },
+    analyzerVersions: { repository: "1.0.0", "js-ts": "1.3.0" },
     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.0.0", "js-ts": "1.3.0" }[entry.analyzer] ?? "1.0.0") }))
   };
   return DiscoverySnapshotV1Schema.parse({ ...base, contentHash: contentHashForArtifactV1(base) });
 };
@@ -3402,12 +3536,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 +3549,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 +3561,26 @@ 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;
+  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;
+    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 +3588,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: [lineEvidence("code", root, module.absPath)] });
+    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." } : observedLiteralDynamic ? { analyzer: "js-ts", scope: "dynamic-imports", status: "complete", reason: "All observed dynamic imports used literal targets and were resolved." } : { 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);
 };
 
@@ -4962,6 +5115,22 @@ var appendTransition = (stateDir, 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,14 +5140,25 @@ 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 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) => join15(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");
@@ -5005,7 +5185,7 @@ var loadManifest = (stateDir) => {
   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 +5195,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,7 +5205,7 @@ 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);
@@ -5050,7 +5230,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 +5248,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]));
@@ -5816,15 +6019,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;
+      }
     }
   };
 };
@@ -6282,6 +6510,12 @@ 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 diagnosticId = (code, value) => `reconciliation:${code}:${sha256NormalizedV1(value).slice(0, 32)}`;
 var coverageAvailable = (snapshot, relation) => {
   const status = snapshot.coverage.find(
@@ -6297,6 +6531,63 @@ 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 kind = parts[2] ?? first.kind;
+    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 +6598,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 +6606,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",
@@ -6414,6 +6725,29 @@ 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 documentation = {
+    documentCount: observed.entities.filter((entity) => entity.kind === "document").length,
+    documentedDocumentCount: new Set(allDeclaredRelations.filter((relation) => relation.from.startsWith("document:")).map((relation) => relation.from)).size,
+    packageCount: packageEntities.length,
+    packageStatus
+  };
   const base = {
     type: "reconciliation-report",
     schemaVersion: 1,
@@ -6431,7 +6765,11 @@ 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() },
+      diagnosticsByCode: diagnosticCounts(sortedDiagnostics.map((diagnostic2) => diagnostic2.code)),
+      diagnosticsByStatus: diagnosticCounts(sortedDiagnostics.map((diagnostic2) => diagnostic2.status)),
+      documentation
     }
   };
   return ReconciliationReportV1Schema.parse({ ...base, contentHash: contentHashForArtifactV1(base) });
@@ -6454,6 +6792,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 +6806,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 +6823,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 +6865,180 @@ 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,
+    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: 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}}
@@ -6593,6 +7053,7 @@ styles += String.raw`body[data-report-view="architecture"] #insights,body[data-r
 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}"};
@@ -6600,22 +7061,26 @@ data.entities=data.entities||[];data.relations=data.relations||[];data.diagnosti
 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.";
 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]||[];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};
@@ -6623,28 +7088,32 @@ 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 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)||[]).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 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 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||{},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 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=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 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>"};
@@ -6652,11 +7121,11 @@ const renderCoverage=()=>{document.querySelector("#coverage-list").innerHTML=(da
 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 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 +7151,14 @@ 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 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 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 ${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(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 +7169,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, diagnosticSummary: data.diagnosticSummary, 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 +7358,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 +7429,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 +7645,43 @@ 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?.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 = (() => {
@@ -7145,7 +7781,7 @@ var runWorkflowCommand = (command, flags, configPath, argv) => {
       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;
     }
@@ -7473,6 +8109,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;
     }