@agentskit/doc-bridge 1.7.44 → 1.7.45

package/dist/index.js

@@ -198,17 +198,19 @@ var RuleIdSchema = z.enum([
 var RuleSeveritySchema = z.enum(["off", "info", "warn", "error"]);
 var RulesConfigSchema = z.object({
   mode: z.enum(["default", "recommended", "strict"]).optional(),
-  severity: z.record(RuleIdSchema, RuleSeveritySchema).optional(),
+  severity: z.partialRecord(RuleIdSchema, RuleSeveritySchema).optional(),
   ignore: z.array(RuleIdSchema).max(128).optional(),
   criticalEntities: z.array(z.string().min(1).max(256)).max(128).optional(),
   criticalPaths: z.array(z.string().min(1).max(512)).max(128).optional(),
-  warningThresholds: z.record(RuleIdSchema, z.number().int().min(1).max(1e5)).optional()
+  warningThresholds: z.partialRecord(RuleIdSchema, z.number().int().min(1).max(1e5)).optional()
 }).strict();
 var ReconciliationConfigSchema = z.object({
   /** Semantic comparison level. Raw discovery always keeps file-level relations. */
   scope: z.enum(["file", "module", "package"]).optional(),
   /** Relation kinds that must have documentation declarations. Omit to require all observed kinds; [] disables this signal. */
   requiredRelationKinds: z.array(z.string().min(1).max(128)).max(128).optional(),
+  /** Limit missing-declaration findings to relations whose endpoints are internal project entities. */
+  requiredRelationTargets: z.enum(["all", "internal"]).optional(),
   includeOrphanedDocuments: z.boolean().optional()
 }).strict();
 var AnalysisConfigSchema = z.object({
@@ -754,7 +756,7 @@ var parseConfig = (input) => {
   throw new Error(
     `Invalid doc-bridge config:
 ${result.error.issues.map(
-      (issue) => `  - ${issue.path.join(".") || "(root)"}: ${issue.message}`
+      (issue) => `  - ${issue.path.join(".") || "(root)"}: ${issue.code === "invalid_type" && issue.message.endsWith("received undefined") ? "Required" : issue.code === "invalid_value" && "values" in issue ? "Invalid enum value" : issue.message}`
     ).join("\n")}`
   );
 };
@@ -1177,7 +1179,7 @@ var EntitySchema = z5.object({
   aliases: z5.array(boundedString(256)).max(32).optional(),
   provenance: ProvenanceSchema,
   evidence: z5.array(EvidenceSchema).max(64),
-  metadata: z5.record(z5.unknown()).optional()
+  metadata: z5.record(z5.string(), z5.unknown()).optional()
 }).strict();
 var RelationSchema = z5.object({
   id: boundedString(256),
@@ -1187,7 +1189,7 @@ var RelationSchema = z5.object({
   discriminator: boundedString(256).optional(),
   provenance: ProvenanceSchema,
   evidence: z5.array(EvidenceSchema).max(64),
-  metadata: z5.record(z5.unknown()).optional()
+  metadata: z5.record(z5.string(), z5.unknown()).optional()
 }).strict();
 var DiscoverySnapshotV1Schema = z5.object({
   type: z5.literal("discovery-snapshot"),
@@ -1233,11 +1235,14 @@ var ReconciliationReportV1Schema = z5.object({
     diagnosticCount: z5.number().int().nonnegative(),
     scope: z5.enum(["file", "module", "package"]).optional(),
     requiredRelationKinds: z5.array(boundedString(128)).max(128).optional(),
+    requiredRelationTargets: z5.enum(["all", "internal"]).optional(),
     diagnosticsByCode: z5.record(z5.string().max(128), z5.number().int().nonnegative()).optional(),
     diagnosticsByStatus: z5.record(z5.string().max(128), z5.number().int().nonnegative()).optional(),
     documentation: z5.object({
       documentCount: z5.number().int().nonnegative(),
       documentedDocumentCount: z5.number().int().nonnegative(),
+      documentClassificationCounts: z5.record(z5.string().max(128), z5.number().int().nonnegative()),
+      documentedDocumentClassificationCounts: z5.record(z5.string().max(128), z5.number().int().nonnegative()),
       packageCount: z5.number().int().nonnegative(),
       packageStatus: z5.object({
         fresh: z5.number().int().nonnegative(),
@@ -1348,9 +1353,14 @@ var FixProposalV1Schema = z5.object({
 });
 
 // src/validate.ts
+var zodMessage = (issue) => {
+  if (issue.code === "invalid_type" && issue.message.endsWith("received undefined")) return "Required";
+  if (issue.code === "invalid_value" && "values" in issue) return "Invalid enum value";
+  return issue.message;
+};
 var zodIssues = (error) => error.issues.map((issue) => ({
   path: issue.path.join(".") || "(root)",
-  message: issue.message
+  message: zodMessage(issue)
 }));
 var safeParseAgentHandoff = (input) => {
   const legacy = AgentHandoffLegacySchema.safeParse(input);
@@ -1390,7 +1400,7 @@ ${zodIssues(result.error).map((i) => `  - ${i.path}: ${i.message}`).join("\n")}`
 
 // src/index-builder/build-index.ts
 import { mkdirSync, readFileSync as readFileSync7, writeFileSync } from "fs";
-import { dirname as dirname4, join as join7 } from "path";
+import { dirname as dirname3, join as join7 } from "path";
 
 // src/lib/paths.ts
 import { existsSync as existsSync2, realpathSync } from "fs";
@@ -1474,22 +1484,27 @@ var defaultChecksForTarget = (root, opts) => {
 import { minimatch } from "minimatch";
 
 // src/lib/bounded-text.ts
-import { readFileSync as readFileSync3, statSync } from "fs";
+import { closeSync, fstatSync, openSync, readFileSync as readFileSync3 } from "fs";
 var MAX_DOCUMENT_BYTES = 4 * 1024 * 1024;
 var MAX_CORPUS_BYTES = 64 * 1024 * 1024;
 var readBoundedText = (path, budget, limits) => {
   const maxFileBytes = limits?.maxFileBytes ?? MAX_DOCUMENT_BYTES;
   const maxCorpusBytes = limits?.maxCorpusBytes ?? MAX_CORPUS_BYTES;
-  const stat = statSync(path);
-  if (!stat.isFile()) throw new Error(`Documentation path is not a regular file: ${path}`);
-  if (stat.size > maxFileBytes) {
-    throw new Error(`Documentation file exceeds the ${maxFileBytes} byte limit: ${path}`);
-  }
-  if (budget.used + stat.size > maxCorpusBytes) {
-    throw new Error(`Documentation corpus exceeds the ${maxCorpusBytes} byte read budget.`);
+  const fd = openSync(path, "r");
+  try {
+    const stat = fstatSync(fd);
+    if (!stat.isFile()) throw new Error(`Documentation path is not a regular file: ${path}`);
+    if (stat.size > maxFileBytes) {
+      throw new Error(`Documentation file exceeds the ${maxFileBytes} byte limit: ${path}`);
+    }
+    if (budget.used + stat.size > maxCorpusBytes) {
+      throw new Error(`Documentation corpus exceeds the ${maxCorpusBytes} byte read budget.`);
+    }
+    budget.used += stat.size;
+    return readFileSync3(fd, "utf8");
+  } finally {
+    closeSync(fd);
   }
-  budget.used += stat.size;
-  return readFileSync3(path, "utf8");
 };
 
 // src/lib/markdown.ts
@@ -1913,7 +1928,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.7.44";
+var PACKAGE_VERSION = "1.7.45";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {
@@ -2344,7 +2359,7 @@ var scanHumanDocs = (root, config) => Object.fromEntries(scanHumanDocRecords(roo
 
 // src/index-builder/plugins/nx.ts
 import { existsSync as existsSync6, lstatSync as lstatSync2, readFileSync as readFileSync5, realpathSync as realpathSync5 } from "fs";
-import { basename as basename2, dirname as dirname3, isAbsolute as isAbsolute3, relative as relative3, resolve as resolve5, sep as sep4 } from "path";
+import { basename as basename2, dirname as dirname2, isAbsolute as isAbsolute3, relative as relative3, resolve as resolve5, sep as sep4 } from "path";
 var NX_SCAN_SKIP = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
@@ -2408,7 +2423,7 @@ var discoverNxProjects = (root, config) => {
   for (const manifest of manifests) {
     const json = readJsonRecord(manifest);
     if (!json) continue;
-    const manifestDir = dirname3(manifest);
+    const manifestDir = dirname2(manifest);
     const manifestName = basename2(manifest);
     const isProjectJson = manifestName === "project.json";
     if (!isProjectJson && manifestName !== "package.json") continue;
@@ -2456,7 +2471,7 @@ import { existsSync as existsSync8, readFileSync as readFileSync6 } from "fs";
 import { basename as basename3, join as join6 } from "path";
 
 // src/lib/glob-expand.ts
-import { existsSync as existsSync7, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { existsSync as existsSync7, readdirSync as readdirSync2, statSync } from "fs";
 import { join as join5 } from "path";
 var expandWorkspaceGlobs = (root, patterns) => {
   const dirs = /* @__PURE__ */ new Set();
@@ -2473,7 +2488,7 @@ var expandWorkspaceGlobs = (root, patterns) => {
     for (const name of readdirSync2(base)) {
       const abs = join5(base, name);
       try {
-        if (statSync2(abs).isDirectory()) dirs.add(toPosix(abs));
+        if (statSync(abs).isDirectory()) dirs.add(toPosix(abs));
       } catch {
       }
     }
@@ -2583,7 +2598,7 @@ var buildDocBridgeIndex = (opts) => {
     lookup
   };
   if (write) {
-    mkdirSync(dirname4(indexPath), { recursive: true });
+    mkdirSync(dirname3(indexPath), { recursive: true });
     writeFileSync(indexPath, `${JSON.stringify(index, null, 2)}
 `, "utf8");
   }
@@ -2606,7 +2621,7 @@ var buildDocBridgeIndex = (opts) => {
     const capabilitiesOut = config.index?.capabilities?.outFile ?? ".doc-bridge/capabilities.json";
     capabilitiesPath = join7(root, capabilitiesOut);
     if (write) {
-      mkdirSync(dirname4(capabilitiesPath), { recursive: true });
+      mkdirSync(dirname3(capabilitiesPath), { recursive: true });
       writeFileSync(
         capabilitiesPath,
         renderCapabilitiesJson(config, index, {
@@ -2628,14 +2643,14 @@ var buildDocBridgeIndex = (opts) => {
 // src/discovery/repository.ts
 import { execFileSync } from "child_process";
 import { existsSync as existsSync9, readFileSync as readFileSync8 } from "fs";
-import { basename as basename4, dirname as dirname5, extname, join as join8, relative as relative5, resolve as resolve7, sep as sep6 } from "path";
+import { basename as basename4, dirname as dirname4, extname, join as join8, relative as relative5, resolve as resolve7, sep as sep6 } from "path";
 import * as ts from "typescript";
 
 // src/safety/repository.ts
-import { lstatSync as lstatSync3, readdirSync as readdirSync3, realpathSync as realpathSync6, statSync as statSync3 } from "fs";
+import { lstatSync as lstatSync3, readdirSync as readdirSync3, realpathSync as realpathSync6, statSync as statSync2 } from "fs";
 import { isAbsolute as isAbsolute4, relative as relative4, resolve as resolve6, sep as sep5 } from "path";
 import { minimatch as minimatch4 } from "minimatch";
-var DEFAULT_SAFETY_EXCLUDES = ["**/.git/**", "**/node_modules/**", "**/dist/**", "**/build/**", "**/coverage/**", "**/.doc-bridge/**", "**/.turbo/**", "**/.env", "**/.env.*", "**/*secret*", "**/*credential*", "**/*.pem", "**/*.key"];
+var DEFAULT_SAFETY_EXCLUDES = ["**/.git/**", "**/node_modules/**", "**/dist/**", "**/build/**", "**/coverage/**", "**/.doc-bridge/**", "**/.next/**", "**/out/**", "**/.turbo/**", "**/.svelte-kit/**", "**/.mcpb-build/**", "**/.mcpb-output/**", "**/.env", "**/.env.*", "**/*secret*", "**/*credential*", "**/*.pem", "**/*.key"];
 var containedPath = (root, candidate) => {
   const projectRoot = realpathSync6.native(resolve6(root));
   const unresolved = resolve6(projectRoot, candidate);
@@ -2695,7 +2710,7 @@ var safeWalkFiles = (root, options = {}) => {
         reason = `Repository scan exceeded the ${options.maxFiles ?? 1e4} file limit.`;
         return;
       }
-      bytes += statSync3(absolute).size;
+      bytes += statSync2(absolute).size;
       if (options.maxBytes !== void 0 && bytes > options.maxBytes) {
         reason = `Repository scan exceeded the ${options.maxBytes} byte limit.`;
         return;
@@ -2752,6 +2767,7 @@ var firstLineContaining = (text, pattern) => {
 };
 var documentClassification = (path) => {
   if (/(^|\/)docs\/for-agents(?:\/|$)/.test(path)) return "agent";
+  if (/(^|\/)docs-archive(?:\/|$)/.test(path)) return "archive";
   if (/(^|\/)docs(?:\/|$)/.test(path)) return "human";
   if (/(^|\/)(README|CONTRIBUTING|SECURITY|CHANGELOG)(?:\.|$)/i.test(path)) return "project";
   return "unclassified";
@@ -2830,7 +2846,7 @@ var readCompilerOptions = (root) => {
   if (!configPath) return { options: {} };
   const parsed = ts.readConfigFile(configPath, ts.sys.readFile);
   if (parsed.error) return { options: {}, error: ts.flattenDiagnosticMessageText(parsed.error.messageText, "\n") };
-  const config = ts.parseJsonConfigFileContent(parsed.config, ts.sys, dirname5(configPath));
+  const config = ts.parseJsonConfigFileContent(parsed.config, ts.sys, dirname4(configPath));
   if (config.errors.length) {
     return {
       options: config.options,
@@ -2899,20 +2915,56 @@ var exportedNames = (sourceFile) => {
 };
 var moduleReferences = (root, path, sourceFile, runtimeWiringMethods) => {
   const references = [];
+  const dynamicEvidence = [];
   let hasDynamic = false;
   let hasLiteralDynamic = false;
   let hasRuntimeWiring = false;
   let hasUnresolvedRuntimeWiring = false;
   const importedBindings = /* @__PURE__ */ new Map();
   const staticStringBindings = /* @__PURE__ */ new Map();
+  const localBindings = /* @__PURE__ */ new Set();
+  const resolveStaticString = (expression) => {
+    if (ts.isStringLiteralLike(expression)) return expression.text;
+    if (ts.isIdentifier(expression)) return staticStringBindings.get(expression.text);
+    if (ts.isParenthesizedExpression(expression)) return resolveStaticString(expression.expression);
+    if (ts.isBinaryExpression(expression) && expression.operatorToken.kind === ts.SyntaxKind.PlusToken) {
+      const left = resolveStaticString(expression.left);
+      const right = resolveStaticString(expression.right);
+      return left !== void 0 && right !== void 0 ? left + right : void 0;
+    }
+    return void 0;
+  };
   const collectStaticStringBindings = (node) => {
-    if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.initializer && ts.isStringLiteralLike(node.initializer) && ts.isVariableDeclarationList(node.parent) && (node.parent.flags & ts.NodeFlags.Const) !== 0) {
+    if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.initializer && ts.isVariableDeclarationList(node.parent) && (node.parent.flags & ts.NodeFlags.Const) !== 0) {
+      const value = resolveStaticString(node.initializer);
       const previous = staticStringBindings.get(node.name.text);
-      staticStringBindings.set(node.name.text, !staticStringBindings.has(node.name.text) || previous === node.initializer.text ? node.initializer.text : void 0);
+      staticStringBindings.set(node.name.text, !staticStringBindings.has(node.name.text) || previous === value ? value : void 0);
     }
+    if ((ts.isVariableDeclaration(node) || ts.isParameter(node) || ts.isBindingElement(node)) && ts.isIdentifier(node.name)) localBindings.add(node.name.text);
+    if ((ts.isFunctionDeclaration(node) || ts.isClassDeclaration(node) || ts.isEnumDeclaration(node)) && node.name) localBindings.add(node.name.text);
     ts.forEachChild(node, collectStaticStringBindings);
   };
   collectStaticStringBindings(sourceFile);
+  const addImportedBindingReference = (expression, node) => {
+    if (ts.isIdentifier(expression)) {
+      const specifier = importedBindings.get(expression.text);
+      if (specifier) {
+        addReference({ text: specifier }, "runtime-wiring", node, "runtime-wiring-static");
+        return true;
+      }
+      return false;
+    }
+    if (ts.isPropertyAccessExpression(expression)) return addImportedBindingReference(expression.expression, node);
+    if (ts.isCallExpression(expression)) return addImportedBindingReference(expression.expression, node);
+    return false;
+  };
+  const isKnownLocal = (expression) => {
+    if (ts.isIdentifier(expression)) return localBindings.has(expression.text) || importedBindings.has(expression.text);
+    if (expression.kind === ts.SyntaxKind.ThisKeyword) return true;
+    if (ts.isPropertyAccessExpression(expression)) return isKnownLocal(expression.expression);
+    if (ts.isCallExpression(expression)) return isKnownLocal(expression.expression);
+    return ts.isStringLiteralLike(expression);
+  };
   const addReference = (specifier, kind, node, detection) => {
     references.push({ specifier: specifier.text, kind, evidence: nodeEvidence(root, path, sourceFile, node), ...detection ? { detection } : {} });
   };
@@ -2932,32 +2984,35 @@ var moduleReferences = (root, path, sourceFile, runtimeWiringMethods) => {
       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])) {
+        const specifier = node.arguments[0] ? resolveStaticString(node.arguments[0]) : void 0;
+        if (specifier !== void 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;
+          dynamicEvidence.push(nodeEvidence(root, path, sourceFile, node));
+          addReference({ text: specifier }, "imports", node, "dynamic-literal");
+        } else {
+          hasDynamic = true;
+          dynamicEvidence.push(nodeEvidence(root, path, sourceFile, node));
+        }
       } else if (ts.isIdentifier(node.expression) && node.expression.text === "require") {
         const argument = node.arguments[0];
-        if (argument && ts.isStringLiteralLike(argument)) addReference(argument, "imports", node);
-        else if (argument && ts.isIdentifier(argument) && staticStringBindings.get(argument.text)) addReference({ text: staticStringBindings.get(argument.text) }, "imports", node);
-        else hasDynamic = true;
+        const specifier = argument ? resolveStaticString(argument) : void 0;
+        if (specifier !== void 0) {
+          dynamicEvidence.push(nodeEvidence(root, path, sourceFile, node));
+          addReference({ text: specifier }, "imports", node);
+        } else {
+          hasDynamic = true;
+          dynamicEvidence.push(nodeEvidence(root, path, sourceFile, node));
+        }
       } else if (ts.isPropertyAccessExpression(node.expression) && runtimeWiringMethods.has(node.expression.name.text)) {
         hasRuntimeWiring = true;
-        const before = references.length;
-        let hasPotentialTargetArgument = false;
+        let hasUnresolvedTarget = 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 (ts.isStringLiteralLike(argument)) continue;
+          if (addImportedBindingReference(argument, node)) continue;
+          if (!isKnownLocal(argument)) hasUnresolvedTarget = true;
         }
-        if (hasPotentialTargetArgument && references.length === before) hasUnresolvedRuntimeWiring = true;
+        const receiver = node.expression.expression;
+        if (hasUnresolvedTarget && !isKnownLocal(receiver)) hasUnresolvedRuntimeWiring = true;
       }
     }
     ts.forEachChild(node, visit);
@@ -2966,6 +3021,7 @@ var moduleReferences = (root, path, sourceFile, runtimeWiringMethods) => {
   return {
     references,
     exports: exportedNames(sourceFile),
+    dynamicEvidence,
     hasDynamic,
     hasLiteralDynamic,
     hasRuntimeWiring,
@@ -2973,7 +3029,7 @@ var moduleReferences = (root, path, sourceFile, runtimeWiringMethods) => {
   };
 };
 var resolveRelativeModule = (specifier, containingFile, modulePaths) => {
-  const base = resolve7(dirname5(containingFile), specifier);
+  const base = resolve7(dirname4(containingFile), specifier);
   const extension = extname(base);
   const extensionlessBase = extension ? base.slice(0, -extension.length) : base;
   const candidates = [
@@ -3042,11 +3098,11 @@ var artifact = (root, config, files, entities, relations, coverage) => {
     sourceRevision: revision.value,
     sourceRevisionKind: revision.kind,
     configurationHash: sha256NormalizedV1(config ?? {}),
-    pipelineVersion: "1.0.0",
-    analyzerVersions: { repository: "1.0.0", "js-ts": "1.3.0" },
+    pipelineVersion: "1.1.8",
+    analyzerVersions: { repository: "1.1.1", "js-ts": "1.3.4" },
     entities: [...entities].sort((a, b) => a.id.localeCompare(b.id)),
     relations: [...relations].sort((a, b) => a.id.localeCompare(b.id)),
-    coverage: coverage.map((entry) => ({ ...entry, analyzerVersion: entry.analyzerVersion ?? ({ repository: "1.0.0", "js-ts": "1.3.0" }[entry.analyzer] ?? "1.0.0") }))
+    coverage: coverage.map((entry) => ({ ...entry, analyzerVersion: entry.analyzerVersion ?? ({ repository: "1.1.1", "js-ts": "1.3.4" }[entry.analyzer] ?? "1.0.0") }))
   };
   return DiscoverySnapshotV1Schema.parse({ ...base, contentHash: contentHashForArtifactV1(base) });
 };
@@ -3140,6 +3196,7 @@ var discoverRepository = (opts = {}) => {
   const includeTestRuntimeWiring = opts.config?.analysis?.jsTs?.includeTestRuntimeWiring ?? false;
   let observedLiteralDynamic = false;
   let observedUnresolvedDynamic = false;
+  const observedDynamicEvidence = [];
   let observedRuntimeWiring = false;
   let observedUnresolvedRuntimeWiring = false;
   for (const module of modules.values()) {
@@ -3149,6 +3206,7 @@ var discoverRepository = (opts = {}) => {
     const references = moduleReferences(root, module.absPath, sourceFile, runtimeWiringMethods);
     observedLiteralDynamic ||= references.hasLiteralDynamic;
     observedUnresolvedDynamic ||= references.hasDynamic;
+    observedDynamicEvidence.push(...references.dynamicEvidence);
     observedRuntimeWiring ||= references.hasRuntimeWiring;
     observedUnresolvedRuntimeWiring ||= references.hasUnresolvedRuntimeWiring;
     for (const reference of references.references) {
@@ -3160,10 +3218,10 @@ var discoverRepository = (opts = {}) => {
       }
       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.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.hasLiteralDynamic || references.hasDynamic) coverage.push({ analyzer: "js-ts", scope: `dynamic-imports:${module.path}`, status: references.hasDynamic ? "not-analyzed" : "complete", reason: references.hasDynamic ? "A non-literal dynamic import was found; the target is unresolved." : "Literal dynamic imports were resolved.", evidence: [...references.dynamicEvidence.slice(0, 32)] });
     if (references.hasUnresolvedRuntimeWiring) coverage.push({ analyzer: "js-ts", scope: `runtime-wiring:${module.path}`, status: "not-analyzed", reason: "A runtime registration/wiring call was found without a statically imported target.", evidence: [lineEvidence("code", root, module.absPath)] });
   }
-  if (dynamicCoverageIndex >= 0) coverage[dynamicCoverageIndex] = observedUnresolvedDynamic ? { analyzer: "js-ts", scope: "dynamic-imports", status: "partial", reason: "Literal dynamic imports are resolved; non-literal import expressions and require calls remain unresolved." } : 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." };
+  if (dynamicCoverageIndex >= 0) coverage[dynamicCoverageIndex] = observedUnresolvedDynamic ? { analyzer: "js-ts", scope: "dynamic-imports", status: "partial", reason: "Literal dynamic imports are resolved; non-literal import expressions and require calls remain unresolved. Evidence lists representative dynamic loading sites.", evidence: [...observedDynamicEvidence.slice(0, 32)] } : observedLiteralDynamic ? { analyzer: "js-ts", scope: "dynamic-imports", status: "complete", reason: "All observed dynamic imports used literal targets and were resolved.", evidence: [...observedDynamicEvidence.slice(0, 32)] } : { analyzer: "js-ts", scope: "dynamic-imports", status: "not-applicable", reason: "No dynamic loading expression was observed." };
   const runtimeCoverageIndex = coverage.findIndex((entry) => entry.scope === "runtime-wiring");
   if (runtimeCoverageIndex >= 0) coverage[runtimeCoverageIndex] = observedUnresolvedRuntimeWiring ? { analyzer: "js-ts", scope: "runtime-wiring", status: "partial", reason: "Some configured runtime-wiring calls remain unresolved after static binding analysis." } : observedRuntimeWiring ? { analyzer: "js-ts", scope: "runtime-wiring", status: "complete", reason: "All observed configured runtime-wiring calls resolved to static bindings." } : { analyzer: "js-ts", scope: "runtime-wiring", status: "not-applicable", reason: "No configured runtime-wiring call was observed." };
   return artifact(root, opts.config, allFiles, [...entities.values()], [...relations.values()], coverage);
@@ -3279,6 +3337,29 @@ var scalar = (value) => {
   }
   return trimmed;
 };
+var isFieldName = (value) => {
+  if (!/^[A-Za-z]/.test(value)) return false;
+  for (const character of value.slice(1)) {
+    if (!/[A-Za-z0-9_-]/.test(character)) return false;
+  }
+  return true;
+};
+var parseIndentedField = (raw, indentation) => {
+  const prefix = " ".repeat(indentation);
+  if (!raw.startsWith(prefix) || raw[indentation] === " ") return void 0;
+  const body = raw.slice(indentation);
+  const separator = body.indexOf(":");
+  if (separator <= 0) return void 0;
+  const key = body.slice(0, separator).trim();
+  return isFieldName(key) ? { key, value: body.slice(separator + 1).trim() } : void 0;
+};
+var parseListItem = (raw, indentation) => {
+  const prefix = `${" ".repeat(indentation)}-`;
+  if (!raw.startsWith(prefix)) return void 0;
+  const rest = raw.slice(prefix.length);
+  if (rest && !/\s/.test(rest[0] ?? "")) return void 0;
+  return rest.trim();
+};
 var conventionalPackageReference = (path, agentRoot) => {
   const prefix = `${agentRoot.replace(/\/$/, "")}/`;
   if (!path.startsWith(prefix)) return void 0;
@@ -3388,11 +3469,10 @@ var parseBlock = (input, options = {}) => {
       section = void 0;
       continue;
     }
-    if (/^ {2}[A-Za-z][A-Za-z0-9_-]*\s*:/.test(raw)) {
+    const sectionField = parseIndentedField(raw, 2);
+    if (sectionField) {
       finishRelation();
-      const match = /^ {2}([A-Za-z][A-Za-z0-9_-]*)\s*:\s*(.*)$/.exec(raw);
-      const key = match?.[1];
-      const value = match?.[2] ?? "";
+      const { key, value } = sectionField;
       if (key !== "covers" && key !== "relations") {
         addDiagnostic(diagnostics, input, "DOCBRIDGE_FIELD_UNKNOWN", `Unknown docbridge field: ${key ?? "(missing)"}.`, line);
         section = void 0;
@@ -3409,35 +3489,36 @@ var parseBlock = (input, options = {}) => {
       }
       continue;
     }
-    if (section === "covers" && /^ {4}-\s*/.test(raw)) {
-      const value = scalar(raw.replace(/^ {4}-\s*/, ""));
+    const listValue = parseListItem(raw, 4);
+    if (section === "covers" && listValue !== void 0) {
+      const value = scalar(listValue);
       if (!value) addDiagnostic(diagnostics, input, "DOCBRIDGE_REFERENCE_MISSING", "covers entries must not be empty.", line);
       else covers.push({ value, line });
       continue;
     }
-    if (section === "relations" && /^ {4}-\s*/.test(raw)) {
+    if (section === "relations" && listValue !== void 0) {
       finishRelation();
-      const firstField = /^ {4}-\s*([A-Za-z][A-Za-z0-9_-]*)\s*:\s*(.*)$/.exec(raw);
+      const firstField = parseIndentedField(`    ${listValue}`, 4);
       current = { startLine: line, endLine: line, fields: /* @__PURE__ */ new Set() };
-      if (firstField?.[1]) {
-        current.fields.add(firstField[1]);
-        current[firstField[1]] = scalar(firstField[2] ?? "");
-      } else if (raw.replace(/^ {4}-\s*/, "").trim()) {
+      if (firstField?.key) {
+        current.fields.add(firstField.key);
+        current[firstField.key] = scalar(firstField.value);
+      } else if (listValue) {
         addDiagnostic(diagnostics, input, "DOCBRIDGE_RELATION_INVALID", "Relation entries must be field mappings.", line);
       }
       continue;
     }
-    if (section === "relations" && current && /^ {6}[A-Za-z][A-Za-z0-9_-]*\s*:/.test(raw)) {
-      const field = /^ {6}([A-Za-z][A-Za-z0-9_-]*)\s*:\s*(.*)$/.exec(raw);
-      const key = field?.[1];
+    const field = parseIndentedField(raw, 6);
+    if (section === "relations" && current && field) {
+      const { key, value } = field;
       current.endLine = line;
-      if (!key || !["from", "to", "kind", "detection"].includes(key)) {
-        addDiagnostic(diagnostics, input, "DOCBRIDGE_FIELD_UNKNOWN", `Unknown relation field: ${key ?? "(missing)"}.`, line);
+      if (!["from", "to", "kind", "detection"].includes(key)) {
+        addDiagnostic(diagnostics, input, "DOCBRIDGE_FIELD_UNKNOWN", `Unknown relation field: ${key}.`, line);
       } else if (current.fields.has(key)) {
         addDiagnostic(diagnostics, input, "DOCBRIDGE_FIELD_DUPLICATE", `Duplicate relation field: ${key}.`, line);
       } else {
         current.fields.add(key);
-        current[key] = scalar(field?.[2] ?? "");
+        current[key] = scalar(value);
       }
       continue;
     }
@@ -3527,11 +3608,13 @@ var applyDocumentationDeclarations = (snapshot, documents, options = {}) => {
 
 // src/reconciliation/reconcile.ts
 var ignoredDocumentationRelations = /* @__PURE__ */ new Set(["covers"]);
+var isInternalEntity = (id) => !id.startsWith("external:") && !id.startsWith("unresolved:");
 var metadataDetection = (relation) => {
   const detection = relation.metadata?.detection;
   return typeof detection === "string" ? detection : void 0;
 };
-var relationDetection = (relation) => relation.discriminator ?? metadataDetection(relation) ?? "static";
+var normalizeDetection = (value) => value === "dynamic-literal" ? "dynamic" : value;
+var relationDetection = (relation) => normalizeDetection(relation.discriminator ?? metadataDetection(relation) ?? "static");
 var entityResolver = (snapshots) => {
   const references = /* @__PURE__ */ new Map();
   const entities = snapshots.flatMap((snapshot) => snapshot.entities).sort((a, b) => a.id.localeCompare(b.id));
@@ -3558,6 +3641,19 @@ var diagnosticCounts = (values) => {
   for (const value of values) counts.set(value, (counts.get(value) ?? 0) + 1);
   return Object.fromEntries([...counts.entries()].sort(([a], [b]) => a.localeCompare(b)));
 };
+var documentClass = (entity) => {
+  const classification = entity.metadata?.classification;
+  return typeof classification === "string" && classification.length > 0 ? classification : "unclassified";
+};
+var countDocumentClasses = (documents, selectedIds) => {
+  const counts = /* @__PURE__ */ new Map();
+  for (const document of documents) {
+    if (selectedIds && !selectedIds.has(document.id)) continue;
+    const classification = documentClass(document);
+    counts.set(classification, (counts.get(classification) ?? 0) + 1);
+  }
+  return Object.fromEntries([...counts.entries()].sort(([a], [b]) => a.localeCompare(b)));
+};
 var diagnosticId = (code, value) => `reconciliation:${code}:${sha256NormalizedV1(value).slice(0, 32)}`;
 var coverageAvailable = (snapshot, relation) => {
   const status = snapshot.coverage.find(
@@ -3610,7 +3706,6 @@ var aggregatedRelations = (relations, scope, entities, packageByModule) => {
     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 {
@@ -3692,9 +3787,18 @@ var reconcileKnowledge = (observed, declared, options = {}) => {
     group.push(relation);
     declaredByBase.set(base2, group);
   }
+  const observedDetectionsByBase = /* @__PURE__ */ new Map();
+  for (const relation of observedRelations) {
+    const base2 = relationBase(relation, resolveEntity2);
+    const detections = observedDetectionsByBase.get(base2) ?? /* @__PURE__ */ new Set();
+    detections.add(relationDetection(relation));
+    observedDetectionsByBase.set(base2, detections);
+  }
   for (const group of declaredByBase.values()) {
     const detections = new Set(group.map(relationDetection));
     if (detections.size < 2) continue;
+    const observedDetections = observedDetectionsByBase.get(relationBase(group[0], resolveEntity2));
+    if (observedDetections && [...detections].every((detection) => observedDetections.has(detection))) continue;
     diagnostics.push(reportDiagnostic(
       "CONFLICTING_DECLARATIONS",
       "conflict",
@@ -3721,7 +3825,7 @@ var reconcileKnowledge = (observed, declared, options = {}) => {
         void 0,
         [relation.id, match.id]
       ));
-    } else if (coverageAvailable(observed, relation) && (requiredRelationKinds === void 0 || requiredRelationKinds.has(relation.kind))) {
+    } else if (coverageAvailable(observed, relation) && (requiredRelationKinds === void 0 || requiredRelationKinds.has(relation.kind)) && (options.requiredRelationTargets !== "internal" || relation.from !== relation.to && isInternalEntity(relation.from) && isInternalEntity(relation.to))) {
       diagnostics.push(reportDiagnostic(
         "RELATION_UNDOCUMENTED",
         "undocumented",
@@ -3784,9 +3888,13 @@ var reconcileKnowledge = (observed, declared, options = {}) => {
     else if (statuses.has("undocumented") || statuses.has("unresolved") || statuses.has("not-analyzed")) packageStatus.unverified += 1;
     else packageStatus.fresh += 1;
   }
+  const documents = observed.entities.filter((entity) => entity.kind === "document");
+  const documentedDocumentIds = new Set(allDeclaredRelations.filter((relation) => relation.from.startsWith("document:")).map((relation) => relation.from));
   const documentation = {
-    documentCount: observed.entities.filter((entity) => entity.kind === "document").length,
-    documentedDocumentCount: new Set(allDeclaredRelations.filter((relation) => relation.from.startsWith("document:")).map((relation) => relation.from)).size,
+    documentCount: documents.length,
+    documentedDocumentCount: documentedDocumentIds.size,
+    documentClassificationCounts: countDocumentClasses(documents),
+    documentedDocumentClassificationCounts: countDocumentClasses(documents, documentedDocumentIds),
     packageCount: packageEntities.length,
     packageStatus
   };
@@ -3809,6 +3917,7 @@ var reconcileKnowledge = (observed, declared, options = {}) => {
       diagnosticCount: sortedDiagnostics.length,
       ...options.scope === void 0 ? {} : { scope: options.scope },
       ...options.requiredRelationKinds === void 0 ? {} : { requiredRelationKinds: [...new Set(options.requiredRelationKinds)].sort() },
+      ...options.requiredRelationTargets === void 0 ? {} : { requiredRelationTargets: options.requiredRelationTargets },
       diagnosticsByCode: diagnosticCounts(sortedDiagnostics.map((diagnostic2) => diagnostic2.code)),
       diagnosticsByStatus: diagnosticCounts(sortedDiagnostics.map((diagnostic2) => diagnostic2.status)),
       documentation
@@ -3932,7 +4041,11 @@ var reportData = (snapshot, report, includeSnippets, privacy = "private") => {
     pipelineVersion: snapshot.pipelineVersion,
     analyzerVersions: snapshot.analyzerVersions,
     diagnosticCount: report.diagnostics.length,
+    actionableCount: report.diagnostics.filter((diagnostic2) => diagnostic2.status !== "confirmed").length,
+    confirmedCount: report.diagnostics.filter((diagnostic2) => diagnostic2.status === "confirmed").length,
     requiredRelationKinds: report.summary.requiredRelationKinds,
+    requiredRelationTargets: report.summary.requiredRelationTargets,
+    documentation: report.summary.documentation,
     diagnosticSummary: {
       errors: report.diagnostics.filter((diagnostic2) => diagnostic2.severity === "error").length,
       warnings: report.diagnostics.filter((diagnostic2) => diagnostic2.severity === "warn").length,
@@ -4090,8 +4203,8 @@ styles += String.raw`
 :root{--ink:#182b2b;--muted:#536664;--paper:#efe9df;--panel:#f8f5ee;--line:#c8c8b9;--green:#176b51;--blue:#155a68;--amber:#93530b;--red:#9b302b;--shadow:none}
 *{box-sizing:border-box}body{background:var(--paper);font-family:"Avenir Next","Segoe UI",ui-sans-serif,system-ui,sans-serif;font-size:14px;line-height:1.5}.shell{max-width:1720px;padding:30px clamp(20px,4vw,64px) 56px}.masthead{align-items:flex-start;border-bottom:2px solid var(--ink);padding:4px 0 28px}.masthead>div:first-child{max-width:840px}.eyebrow{font-size:10px;letter-spacing:.16em}.masthead h1{font-family:"Iowan Old Style",Georgia,serif;font-size:clamp(3rem,7vw,7.2rem);letter-spacing:-.075em;line-height:.9;margin:16px 0 20px}.lede{font-size:17px;line-height:1.45;max-width:650px}.run-meta{padding-top:3px;min-width:210px}.read-only{border:0;border-radius:0;padding:0;background:none;color:var(--green);font-size:10px;letter-spacing:.1em;text-transform:uppercase}.run-meta strong{color:var(--ink);font-size:12px;overflow-wrap:anywhere;margin-top:16px}.summary{grid-template-columns:repeat(5,minmax(0,1fr));gap:0;margin:0;padding:18px 0 22px;border-bottom:1px solid var(--line)}.metric{border:0;border-left:1px solid var(--line);border-radius:0;background:none;box-shadow:none;padding:0 18px}.metric:first-child{border-left:0;padding-left:0}.metric b{font-family:"Iowan Old Style",Georgia,serif;font-size:38px;letter-spacing:-.05em}.metric span{font-size:11px;letter-spacing:.07em;text-transform:uppercase}.lens-bar{align-items:flex-end;margin:42px 0 6px}.tabs{gap:0}.tab,.level{border:0;border-bottom:2px solid transparent;border-radius:0;background:transparent;color:var(--muted);padding:8px 14px;min-height:38px;font-weight:700}.tab:first-child,.level:first-child{padding-left:0}.tab:hover,.level:hover{background:none;color:var(--ink);border-color:var(--line)}.tab[aria-selected=true],.level[aria-pressed=true]{background:none;color:var(--ink);border-color:var(--green)}.lens-bar>.subtle{max-width:430px;text-align:right}.filters{border-block:1px solid var(--line);padding:14px 0;margin:12px 0 24px}.filters input,.filters select,.filters button{border:1px solid var(--line);border-radius:3px;background:var(--panel);min-height:38px}.filters button{font-weight:700}.insights{grid-template-columns:repeat(4,minmax(0,1fr));gap:0;border-top:1px solid var(--line);border-bottom:1px solid var(--line);margin:18px 0 30px}.insight{border:0;border-left:1px solid var(--line);border-radius:0;background:none;box-shadow:none;padding:14px 16px 16px}.insight:first-child{border-left:0;padding-left:0}.insight h3{font-size:12px;letter-spacing:.02em}.insight p{font-size:13px}.tag{border-radius:2px;padding:2px 5px;font-size:9px}.workspace{grid-template-columns:minmax(0,1fr) 350px;gap:24px}.panel{border:1px solid var(--line);border-radius:3px;background:var(--panel);box-shadow:none;padding:24px}.panel h2{font-family:"Iowan Old Style",Georgia,serif;font-size:30px;letter-spacing:-.04em}.map-wrap{border:1px solid #aeb9ae;border-radius:2px;background-color:#e8eee7;background-image:linear-gradient(rgba(24,43,43,.07) 1px,transparent 1px),linear-gradient(90deg,rgba(24,43,43,.07) 1px,transparent 1px);background-size:24px 24px}.map-wrap::-webkit-scrollbar{height:10px}.map-wrap::-webkit-scrollbar-thumb{background:var(--line)}#graph{height:620px}.graph-node rect{fill:#f8f5ee;stroke:#274744;stroke-width:1.4;rx:2}.graph-node:hover rect,.graph-node:focus rect{stroke:var(--blue);stroke-width:2.5}.graph-node.selected rect{fill:#dceee1;stroke:var(--green);stroke-width:3}.graph-node.issue rect{fill:#fff0d4;stroke:var(--amber)}.edge{stroke:#69857d;stroke-width:1.5;opacity:.8}.edge.alert{stroke:var(--amber);stroke-width:2.5}.edge-label{fill:var(--ink);font-size:10px;font-weight:700}.node-label{font-size:12px;font-weight:800}.node-kind{font-size:10px;fill:var(--muted)}.node-count{font-size:10px;fill:var(--green);font-weight:800}.side{top:20px}.side .panel-head{border-bottom:1px solid var(--line);padding-bottom:14px}.detail-title{font-family:"Iowan Old Style",Georgia,serif;font-size:28px}.detail-grid{gap:0}.detail-grid>div{border-left:1px solid var(--line);padding-left:10px}.detail-grid>div:nth-child(odd){border-left:0;padding-left:0}.detail-grid b{font-family:"Iowan Old Style",Georgia,serif;font-size:26px}.run{margin-top:24px}.run-summary{border-bottom:1px solid var(--line);padding-bottom:12px}.chip{border:0;border-left:1px solid var(--line);border-radius:0;padding:2px 10px}.chip:first-child{border-left:0;padding-left:0}.finding-groups{grid-template-columns:repeat(2,minmax(0,1fr));gap:0}.finding-group{border:0;border-top:1px solid var(--line);border-radius:0;background:none;padding:16px 14px 16px 0}.finding-group:nth-child(even){padding-left:14px;border-left:1px solid var(--line)}.finding-group h3{font-size:13px;letter-spacing:.02em}.finding-detail{border-top:2px solid var(--ink)}.finding{padding:16px 0}.metadata{gap:24px;margin-top:26px}.metadata div{border-top:1px solid var(--line);padding-top:9px}.map-wrap,.panel,.finding-group,.insight{transition:background-color .16s ease,border-color .16s ease}@media(max-width:900px){.masthead{display:block}.run-meta{padding-top:24px;text-align:left}.summary{grid-template-columns:repeat(3,minmax(0,1fr));row-gap:18px}.metric:nth-child(4){border-left:0;padding-left:0}.workspace{grid-template-columns:1fr}.side{position:static}.lens-bar{display:block}.lens-bar>.subtle{text-align:left;margin-top:10px}.finding-groups{grid-template-columns:1fr}.finding-group:nth-child(even){padding-left:0;border-left:0}}@media(max-width:560px){.shell{padding:20px 16px 40px}.masthead h1{font-size:clamp(3rem,16vw,5rem)}.summary{grid-template-columns:repeat(2,minmax(0,1fr))}.metric:nth-child(odd){border-left:0;padding-left:0}.metric:nth-child(even){border-left:1px solid var(--line);padding-left:12px}.insights{grid-template-columns:1fr}.insight,.insight:first-child{border-left:0;border-top:1px solid var(--line);padding-left:0}.insight:first-child{border-top:0}.panel{padding:16px}.panel-head{display:block}.panel-head>.tabs{margin-top:12px}.filters label{width:100%}.filters input,.filters select{width:100%}.metadata{grid-template-columns:1fr}}@media(prefers-reduced-motion:reduce){.map-wrap,.panel,.finding-group,.insight{transition:none}}@media(prefers-color-scheme:dark){:root{--ink:#e8eee7;--muted:#b0beb3;--paper:#131c1a;--panel:#1b2824;--line:#42534b;--green:#72d09d;--blue:#86cfe1;--amber:#f0bc6b;--red:#ff9186}.map-wrap{background-color:#17231e;background-image:linear-gradient(rgba(232,238,231,.07) 1px,transparent 1px),linear-gradient(90deg,rgba(232,238,231,.07) 1px,transparent 1px)}.graph-node rect{fill:#1c2b25;stroke:#90aa99}.graph-node.selected rect{fill:#294936}.graph-node.issue rect{fill:#40321e}.filters input,.filters select,.filters button{background:#202f29;color:var(--ink)}}
 `;
-styles += String.raw`.graph-node .node-label,.graph-node text.node-label{fill:var(--ink)}.graph-node .node-kind{fill:var(--muted)}.edge-label{fill:var(--ink)}@media(max-width:1100px){.workspace{grid-template-columns:1fr}.side{position:static}.map-wrap #graph{min-width:0!important;width:100%!important}.panel-head>.tabs{margin-top:12px}}@media(max-width:700px){.summary{grid-template-columns:repeat(2,minmax(0,1fr))}.lens-bar{display:block}.lens-bar>.subtle{text-align:left;margin-top:10px}.filters label{width:100%}.filters input,.filters select{width:100%}.finding-groups{grid-template-columns:1fr}.finding-group:nth-child(even){padding-left:0;border-left:0}}`;
-styles += String.raw`.level{display:none!important}.report-tabs{display:flex;gap:0;align-items:flex-end;border-bottom:1px solid var(--line);margin:24px 0 0}.report-tabs .tab{font-size:13px}.breadcrumbs{display:flex;gap:6px;align-items:center;flex-wrap:wrap;margin:0 0 14px;color:var(--muted);font-size:12px}.breadcrumbs button{border:0;background:none;color:var(--blue);padding:3px 0;font-weight:700}.breadcrumbs button:hover{text-decoration:underline}.breadcrumbs .current{color:var(--ink);font-weight:700}.scope-note{margin:0 0 12px}.report-dashboard{display:grid;grid-template-columns:minmax(0,1.35fr) minmax(280px,1fr);gap:24px}.report-table{width:100%;border-collapse:collapse;font-size:12px}.report-table th,.report-table td{border-top:1px solid var(--line);padding:10px 8px;text-align:left;vertical-align:top}.report-table th{color:var(--muted);font-size:10px;letter-spacing:.08em;text-transform:uppercase}.report-table td:first-child{font-weight:750}.bar-list{display:grid;gap:10px}.bar-item{display:grid;grid-template-columns:minmax(120px,1fr) 2fr auto;gap:10px;align-items:center;font-size:12px}.bar-item i{height:8px;background:var(--line);display:block;overflow:hidden}.bar-item i b{display:block;height:100%;background:var(--green)}.map-wrap{touch-action:none;cursor:grab}.map-wrap.dragging{cursor:grabbing}@media(max-width:700px){.report-tabs{overflow:auto}.report-tabs .tab{white-space:nowrap}.report-dashboard{grid-template-columns:1fr}.bar-item{grid-template-columns:minmax(100px,1fr) 1fr auto}}`;
+styles += String.raw`.graph-node .node-label,.graph-node text.node-label{fill:var(--ink)}.graph-node .node-kind{fill:var(--muted)}.edge-label{fill:var(--ink)}.panel-head>div:first-child{min-width:0;flex:1 1 0}.panel-head>.tabs:not(.report-tabs){flex-wrap:nowrap;max-width:100%;overflow-x:auto}.panel-head>.tabs:not(.report-tabs) .level{flex:0 0 auto}@media(max-width:1100px){.workspace{grid-template-columns:1fr}.side{position:static}.map-wrap #graph{min-width:0!important;width:100%!important}.panel-head>.tabs{margin-top:12px}}@media(max-width:700px){.summary{grid-template-columns:repeat(2,minmax(0,1fr))}.lens-bar{display:block}.lens-bar>.subtle{text-align:left;margin-top:10px}.filters label{width:100%}.filters input,.filters select{width:100%}.finding-groups{grid-template-columns:1fr}.finding-group:nth-child(even){padding-left:0;border-left:0}}`;
+styles += String.raw`.report-tabs{display:flex;gap:0;align-items:flex-end;border-bottom:1px solid var(--line);margin:24px 0 0}.report-tabs .tab{font-size:13px}.breadcrumbs{display:flex;gap:6px;align-items:center;flex-wrap:wrap;margin:0 0 14px;color:var(--muted);font-size:12px}.breadcrumbs button{border:0;background:none;color:var(--blue);padding:3px 0;font-weight:700}.breadcrumbs button:hover{text-decoration:underline}.breadcrumbs .current{color:var(--ink);font-weight:700}.scope-note{margin:0 0 12px}.report-dashboard{display:grid;grid-template-columns:minmax(0,1.35fr) minmax(280px,1fr);gap:24px}.report-table{width:100%;border-collapse:collapse;font-size:12px}.report-table th,.report-table td{border-top:1px solid var(--line);padding:10px 8px;text-align:left;vertical-align:top}.report-table th{color:var(--muted);font-size:10px;letter-spacing:.08em;text-transform:uppercase}.report-table td:first-child{font-weight:750}.bar-list{display:grid;gap:10px}.bar-item{display:grid;grid-template-columns:minmax(120px,1fr) 2fr auto;gap:10px;align-items:center;font-size:12px}.bar-item i{height:8px;background:var(--line);display:block;overflow:hidden}.bar-item i b{display:block;height:100%;background:var(--green)}.map-wrap{touch-action:none;cursor:grab}.map-wrap.dragging{cursor:grabbing}@media(max-width:700px){.report-tabs{overflow:auto}.report-tabs .tab{white-space:nowrap}.report-dashboard{grid-template-columns:1fr}.bar-item{grid-template-columns:minmax(100px,1fr) 1fr auto}}`;
 styles += String.raw`body[data-report-view="architecture"] #insights,body[data-report-view="architecture"] .filters,body[data-report-view="architecture"] .run,body[data-report-view="architecture"] .metadata{display:none}body[data-report-view="insights"] .workspace,body[data-report-view="insights"] .filters,body[data-report-view="insights"] .run,body[data-report-view="insights"] .metadata{display:none}body[data-report-view="findings"] .workspace,body[data-report-view="findings"] #insights,body[data-report-view="findings"] #report-dashboard,body[data-report-view="findings"] #coverage-title,body[data-report-view="findings"] #coverage-title~*{display:none}body[data-report-view="findings"] .run[aria-labelledby="coverage-title"]{display:none}body[data-report-view="coverage"] .workspace,body[data-report-view="coverage"] #insights,body[data-report-view="coverage"] #report-dashboard,body[data-report-view="coverage"] .filters,body[data-report-view="coverage"] .run[aria-labelledby="run-title"],body[data-report-view="coverage"] .metadata{display:none}body[data-report-view="insights"] #report-dashboard{display:block}body[data-report-view="map"] #report-dashboard{display:none}`;
 styles += String.raw`body[data-report-view="architecture"] #report-dashboard{display:none!important}.edge{fill:none}`;
 styles += String.raw`:root{--ink:#17251f;--muted:#586b63;--paper:#f2f5f1;--panel:#fbfcf9;--line:#c9d5cc;--green:#13734a;--blue:#155f78;--amber:#995d08;--red:#a52e2b}html,body{max-width:100%;overflow-x:hidden}body{font-size:15px;line-height:1.55}.shell{width:100%;max-width:1600px;margin:0 auto;padding:28px clamp(16px,3vw,48px) 56px}.masthead{gap:32px;padding:0 0 24px;align-items:flex-start}.masthead h1{font-size:clamp(2.8rem,5.5vw,5.4rem);line-height:.94;margin:12px 0 16px;max-width:100%;overflow-wrap:anywhere}.lede{max-width:60ch;font-size:16px}.run-meta{min-width:0;max-width:300px}.summary{margin:0;padding:18px 0 20px;grid-template-columns:repeat(5,minmax(0,1fr));gap:0}.metric{min-width:0;padding:0 16px;border-inline-start:1px solid var(--line)}.metric:first-child{padding-inline-start:0;border-inline-start:0}.metric b{font-size:clamp(1.8rem,3vw,3rem);max-width:100%;overflow-wrap:anywhere}.metric span{font-size:10px;letter-spacing:.06em;line-height:1.25}.lens-bar{margin:24px 0 4px;align-items:flex-end}.lens-bar>.subtle{max-width:52ch}.report-tabs{max-width:100%;overflow-x:auto}.tab,.level{min-height:40px;padding:8px 12px}.filters{max-width:100%;align-items:center}.filters label{min-width:0}.filters input,.filters select{max-width:100%;min-width:0}.workspace{min-width:0;grid-template-columns:minmax(0,1fr) minmax(280px,340px);gap:20px}.panel{min-width:0}.map-wrap{min-width:0;max-width:100%;width:100%;overflow:hidden;contain:layout paint}#graph{display:block;width:100%!important;min-width:0!important;max-width:100%;height:clamp(480px,60vh,680px)!important}.side{min-width:0}.detail-title,.path,.list,.finding,.finding-group,.report-table{min-width:0;overflow-wrap:anywhere}.report-dashboard{min-width:0}.report-table{table-layout:fixed}.report-table th,.report-table td{overflow-wrap:anywhere}.bar-item{min-width:0}.bar-item span{min-width:0;overflow-wrap:anywhere}.tab:focus-visible,.level:focus-visible,input:focus-visible,select:focus-visible{outline:3px solid var(--blue);outline-offset:2px}@media(max-width:1100px){.workspace{grid-template-columns:1fr}.side{position:static}.summary{grid-template-columns:repeat(3,minmax(0,1fr));row-gap:16px}.summary .metric:nth-child(4){border-inline-start:0;padding-inline-start:0}}@media(max-width:700px){.shell{padding:12px 16px 32px}.masthead{padding-bottom:14px}.masthead h1{font-size:clamp(2.2rem,11vw,3.4rem);margin:6px 0 10px}.lede{font-size:14px;line-height:1.35}.run-meta{display:none}.summary{padding:10px 0 12px;grid-template-columns:repeat(2,minmax(0,1fr));row-gap:8px}.summary .metric:nth-child(even){border-inline-start:1px solid var(--line);padding-inline-start:12px}.summary .metric:nth-child(odd){border-inline-start:0;padding-inline-start:0}.metric{padding-inline:10px}.metric b{font-size:1.65rem}.lens-bar{display:block;margin-top:14px}.lens-bar>.subtle{display:none}.filters{display:grid;grid-template-columns:1fr;gap:10px}.filters label{display:grid;grid-template-columns:1fr;gap:5px}.filters input,.filters select,.filters button{width:100%;min-height:44px}.panel{padding:16px}.panel-head{display:block}.panel-head>.tabs{margin-top:12px}.finding-groups{grid-template-columns:1fr}.report-dashboard{grid-template-columns:1fr}#graph{height:520px!important}.lens-bar + #lens-caption{margin:8px 0}.lens-bar + #lens-caption + #insights{margin-top:8px}}@media(prefers-color-scheme:dark){:root{--ink:#edf5ef;--muted:#b7c6ba;--paper:#111815;--panel:#1a2821;--line:#405248;--green:#73d19d;--blue:#8bd1e6;--amber:#f0bd70;--red:#ff9389}}`;
@@ -4101,7 +4214,8 @@ styles += String.raw`#lens-caption + p.subtle{display:none}`;
 var script = String.raw`
 const data=${"${DATA}"};
 data.entities=data.entities||[];data.relations=data.relations||[];data.diagnostics=data.diagnostics||[];
-const policySuffix=data.requiredRelationKinds===undefined?"Policy: all observed relation kinds require declarations.":data.requiredRelationKinds.length?"Policy: declarations required for "+data.requiredRelationKinds.join(", ")+".":"Policy: missing relation declarations disabled; stale, conflicting, and unresolved declarations remain checked.";
+globalThis.__DOC_BRIDGE_DATA__=data;
+const policySuffix=data.requiredRelationKinds===undefined?"Policy: all observed relation kinds require declarations.":data.requiredRelationKinds.length?"Policy: declarations required for "+data.requiredRelationKinds.join(", ")+(data.requiredRelationTargets==="internal"?" between internal entities":"")+".":"Policy: missing relation declarations disabled; stale, conflicting, and unresolved declarations remain checked.";
 const ensurePolicyNote=()=>{const note=document.querySelector("#map-note");if(note&&!note.textContent.includes(policySuffix))note.textContent=(note.textContent+" · "+policySuffix).trim()};
 new MutationObserver(ensurePolicyNote).observe(document.querySelector("#map-note"),{childList:true,characterData:true});
 const lazyChunks=globalThis.__DOC_BRIDGE_LAZY_CHUNKS__||[],hasLevelChunks=globalThis.__DOC_BRIDGE_HAS_LEVEL_CHUNKS__===true,loadedChunks=new Set(),loadingChunks=new Map();
@@ -4112,7 +4226,7 @@ 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();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 hydrate=()=>{byId.clear();parent.clear();relationById.clear();packageMembers.clear();findingIndex.clear();relationFindingIndex.clear();relationsByEntity.clear();groupEntityIds.clear();groupFindingIndex.clear();groupFindingCounts.clear();packageCache.clear();nodeIssueCache.clear();data.entities.forEach((entity)=>{byId.set(entity.id,entity);const groupId=data.view?.entityGroup?.[entity.id];if(groupId){const ids=groupEntityIds.get(groupId)||new Set();ids.add(entity.id);groupEntityIds.set(groupId,ids)}});data.relations.forEach((relation)=>{relationById.set(relation.id,relation);addRelation(relation.from,relation);addRelation(relation.to,relation);if(relation.kind==="contains"){if(!parent.has(relation.to))parent.set(relation.to,relation.from);const members=packageMembers.get(relation.from)||new Set();members.add(relation.to);packageMembers.set(relation.from,members)}});data.diagnostics.forEach((finding)=>{(finding.entityIds||[]).forEach((id)=>addFinding(findingIndex,id,finding));(finding.relationIds||[]).forEach((id)=>addFinding(relationFindingIndex,id,finding));const scopes=data.view?.diagnosticGroup?.[finding.id]||[];if(finding.status!=="confirmed")scopes.forEach((scope)=>{addFinding(groupFindingIndex,scope,finding);groupFindingCounts.set(scope,(groupFindingCounts.get(scope)||0)+1)})})};
 const isLevelChunk=(name)=>name.startsWith("chunks/levels-");
 const isDetailChunk=(name)=>name.startsWith("chunks/details-");
 const hasChunk=(name)=>isLevelChunk(name)?activeLevelChunk===name:isDetailChunk(name)?loadedChunks.has(name):!lazyChunks.includes(name)||loadedChunks.has(name);
@@ -4129,10 +4243,10 @@ const viewLabels={architecture:"Architecture",drift:"Insights",risks:"Findings",
 const ensureReportChrome=()=>{document.querySelectorAll(".tab[data-lens]").forEach((tab)=>{tab.textContent=viewLabels[tab.dataset.lens]||tab.dataset.lens;tab.closest(".tabs")?.classList.add("report-tabs")});let breadcrumbs=document.querySelector("#breadcrumbs");if(!breadcrumbs){breadcrumbs=document.createElement("nav");breadcrumbs.id="breadcrumbs";breadcrumbs.className="breadcrumbs";breadcrumbs.setAttribute("aria-label","Report location");document.querySelector(".workspace")?.before(breadcrumbs)}return breadcrumbs};
 const label=(entity)=>entity?.name||entity?.id||"Unknown";
 const short=(value,max)=>{const text=String(value??""),limit=text==="External dependencies"?16:max;return text.length>limit?text.slice(0,limit-1)+"…":text};
-const renderBreadcrumbs=()=>{const breadcrumbs=ensureReportChrome(),items=[{label:"Repository",selected:"",level:"overview"}];if(state.selected){const group=groupById.get(state.selected),entity=byId.get(state.selected);if(group)items.push({label:group.name,selected:group.id,level:"package"});else if(entity){const packageId=packageOf(entity.id),packageEntity=byId.get(packageId),groupId=groupFor(packageId);if(groupById.has(groupId))items.push({label:groupById.get(groupId).name,selected:groupId,level:"package"});if(packageEntity&&packageEntity.id!==entity.id)items.push({label:label(packageEntity),selected:packageEntity.id,level:"module"});items.push({label:label(entity),selected:entity.id,level:state.level})}}breadcrumbs.innerHTML=items.map((item,index)=>{const separator="<span aria-hidden=\"true\">"+(index?" / ":"")+"</span>";if(index===items.length-1)return separator+"<span class=\"current\">"+esc(item.label)+"</span>";return separator+"<button type=\"button\" data-breadcrumb-selected=\""+esc(item.selected)+"\" data-breadcrumb-level=\""+esc(item.level)+"\">"+esc(item.label)+"</button>"}).join("")};
+const renderBreadcrumbs=()=>{const breadcrumbs=ensureReportChrome(),items=[{label:"Repository",selected:"",level:"overview"}];if(state.selected){const group=groupById.get(state.selected),entity=byId.get(state.selected);if(group)items.push({label:group.name,selected:group.id,level:"package"});else if(entity){const packageId=packageOf(entity.id),packageEntity=byId.get(packageId),groupId=groupFor(packageId),group=groupById.get(groupId);if(group&&groupId!==packageId&&group.name!==label(packageEntity))items.push({label:group.name,selected:groupId,level:"package"});if(packageEntity&&packageEntity.id!==entity.id)items.push({label:label(packageEntity),selected:packageEntity.id,level:"module"});items.push({label:label(entity),selected:entity.id,level:state.level})}}breadcrumbs.innerHTML=items.map((item,index)=>{const separator="<span aria-hidden=\"true\">"+(index?" / ":"")+"</span>";if(index===items.length-1)return separator+"<span class=\"current\">"+esc(item.label)+"</span>";return separator+"<button type=\"button\" data-breadcrumb-selected=\""+esc(item.selected)+"\" data-breadcrumb-level=\""+esc(item.level)+"\">"+esc(item.label)+"</button>"}).join("")};
 const degreeMap=(relations)=>{const degrees=new Map();relations.forEach((relation)=>{degrees.set(relation.from,(degrees.get(relation.from)||0)+1);degrees.set(relation.to,(degrees.get(relation.to)||0)+1)});return degrees};
 const relationHealth=(relation)=>{if(!relation)return "";const findings=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 nodeIssues=(nodeId)=>{if(nodeIssueCache.has(nodeId))return nodeIssueCache.get(nodeId);const ids=groupEntityIds.get(nodeId)||new Set([nodeId]),findings=new Set(groupFindingIndex.get(nodeId)||[]),relations=new Set();for(const id of ids){(findingIndex.get(id)||[]).filter((finding)=>finding.status!=="confirmed").forEach((finding)=>findings.add(finding));(relationsByEntity.get(id)||[]).forEach((relation)=>relations.add(relation))}relations.forEach((relation)=>(relationFindingIndex.get(relation.id)||[]).filter((finding)=>finding.status!=="confirmed").forEach((finding)=>findings.add(finding)));const result=[...findings];nodeIssueCache.set(nodeId,result);return result};
 const findingInLens=(finding)=>state.lens==="architecture"||(state.lens==="drift"&&finding.status!=="confirmed")||(state.lens==="risks"&&(finding.severity==="error"||finding.severity==="warn"))||(state.lens==="evidence"&&finding.evidence.length>0);
 const relationFindings=(id)=>relationFindingIndex.get(id)||data.view?.diagnosticRelationFindings?.[id]||[];
 const relationInLens=(id)=>relationFindings(id).some(findingInLens);
@@ -4142,8 +4256,8 @@ const detailChunkName=()=>{const entity=state.selected?byId.get(state.selected):
 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 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=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 renderInsights=()=>{const summary=data.diagnosticSummary||{},documentation=data.documentation||{},classificationCounts=documentation.documentClassificationCounts||{},documentedCounts=documentation.documentedDocumentClassificationCounts||{},agentDocs=classificationCounts.agent??0,documentedAgentDocs=documentedCounts.agent??0,undocumented=summary.undocumented??data.diagnostics.filter((finding)=>finding.status==="undocumented").length,drift=summary.drift??data.diagnostics.filter((finding)=>finding.status==="stale-or-unverified"||finding.status==="conflict").length,unsupported=(data.coverage||[]).filter((entry)=>entry.status==="not-analyzed"||entry.status==="partial").length,model=graphModel(),degrees=degreeMap(model.edges),values=[...degrees.values()].sort((a,b)=>a-b),median=values.length?values[Math.floor(values.length/2)]:0,hot=[...degrees.values()].filter((value)=>value>=Math.max(4,median*2)).length,isolated=model.nodes.filter((node)=>!model.edges.some((edge)=>edge.from===node.id||edge.to===node.id)).length;document.querySelector("#insights").innerHTML=[["Documentation drift",undocumented+drift,"Relations or docs needing comparison.",""],["Agent documentation",documentedAgentDocs+"/"+agentDocs,"Configured agent-corpus documents linked to knowledge.",""],["Unanalyzed scope",unsupported,"Coverage gaps are explicit.",""],["Connectivity hotspots",hot,"Heuristic: unusually connected nodes.","heuristic"],["Disconnected nodes",isolated,"Heuristic: no visible edge at this level.","heuristic"]].map(([title,count,copy,tag])=>"<article class=\"insight\"><h3>"+esc(title)+" <span class=\"tag "+tag+"\">"+(tag?"heuristic":"signal")+"</span></h3><p><strong>"+count+"</strong> · "+esc(copy)+"</p></article>").join("")};
+const renderInsightsDashboard=()=>{let dashboard=document.querySelector("#report-dashboard");if(!dashboard){dashboard=document.createElement("section");dashboard.id="report-dashboard";dashboard.className="report-dashboard";document.querySelector(".filters")?.before(dashboard)}const actionable=data.diagnostics.filter((finding)=>finding.status!=="confirmed");if(!actionable.length){dashboard.innerHTML="<p class=\"empty\">No actionable findings. Confirmed checks are available in Evidence.</p>";return}const degrees=degreeMap(data.relations),groups=[...groupById.entries()].filter(([,group])=>group.kind!=="external"),rows=groups.map(([id,group])=>{const members=groupEntityIds.get(id)||new Set(),modules=group.moduleCount||[...members].filter((entityId)=>byId.get(entityId)?.kind==="module").length;return{name:group.name,packages:group.members.length,modules,findings:groupFindingCounts.get(id)||0}}).sort((a,b)=>b.findings-a.findings||a.name.localeCompare(b.name)),topPackages=[...data.entities].filter((entity)=>entity.kind==="package").map((entity)=>({name:label(entity),degree:degrees.get(entity.id)||0})).sort((a,b)=>b.degree-a.degree||a.name.localeCompare(b.name)).slice(0,10),max=Math.max(1,...topPackages.map((row)=>row.degree));dashboard.innerHTML="<section><div class=\"eyebrow\">Attention by scope</div><h2>Where the map needs a closer look</h2><table class=\"report-table\"><thead><tr><th>Scope</th><th>Packages</th><th>Modules</th><th>Findings</th></tr></thead><tbody>"+rows.map((row)=>"<tr><td>"+esc(row.name)+"</td><td>"+row.packages+"</td><td>"+row.modules+"</td><td><strong>"+row.findings+"</strong></td></tr>").join("")+"</tbody></table></section><section><div class=\"eyebrow\">Connectivity</div><h2>Most connected packages</h2><div class=\"bar-list\">"+topPackages.map((row)=>"<div class=\"bar-item\"><span>"+esc(row.name)+"</span><i><b style=\"width:"+Math.round(row.degree/max*100)+"%\"></b></i><strong>"+row.degree+"</strong></div>").join("")+"</div></section>"};
 const mapState={scale:1,dragging:false,x:0,y:0};
 const applyMapTransform=()=>{const svg=document.querySelector("#graph");if(!svg)return;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)})};
@@ -4152,16 +4266,16 @@ 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);nodeClickTimer=setTimeout(async()=>{state.selected=node.dataset.node;render();const chunk=detailChunkName();if(chunk&&!hasChunk(chunk)){await loadChunk(chunk);render()}},380)},true);
 document.addEventListener("click",(event)=>{const crumb=event.target.closest?.("[data-breadcrumb-level]");if(!crumb)return;event.preventDefault();event.stopImmediatePropagation();state.level=crumb.dataset.breadcrumbLevel;state.selected=crumb.dataset.breadcrumbSelected||null;mapState.scale=1;mapState.x=0;mapState.y=0;render()},true);
-const diagnosticsFor=(id)=>findingIndex.get(id)||[];
+const diagnosticsFor=(id)=>(findingIndex.get(id)||[]).filter((finding)=>finding.status!=="confirmed");
 const renderDetails=()=>{const panel=document.querySelector("#details"),entity=state.selected?byId.get(state.selected):null,group=state.selected?groupById.get(state.selected):null;if(group){const members=group.members.map((id)=>byId.get(id)).filter(Boolean),relations=new Set(),ids=groupEntityIds.get(state.selected)||new Set();ids.forEach((id)=>(relationsByEntity.get(id)||[]).forEach((relation)=>relations.add(relation)));const findings=nodeIssues(state.selected),evidence=members.flatMap((member)=>member.evidence||[]).slice(0,8),unit=group.kind==="external"?"dependencies":"packages";panel.innerHTML="<div class=\"eyebrow\">Selected group</div><h2 class=\"detail-title\">"+esc(group.name)+"</h2><span class=\"tag\">"+esc(group.kind)+"</span><p class=\"path\">"+esc(group.path||"Derived from stable package identity and repository structure")+"</p><div class=\"detail-grid\"><div><b>"+members.length+"</b><span>"+unit+"</span></div><div><b>"+relations.size+"</b><span>relations</span></div><div><b>"+findings.length+"</b><span>findings</span></div><div><b>"+evidence.length+"</b><span>evidence items</span></div></div><h3>Members</h3><ul class=\"list\">"+(members.length?members.slice(0,8).map((member)=>"<li>"+esc(label(member))+"</li>").join(""):"<li>No members recorded.</li>")+(members.length>8?"<li class=\"subtle\">+"+(members.length-8)+" more — choose Package level to inspect all.</li>":"")+"</ul>"+(findings.length?"<h3 style=\"margin-top:16px\">Attention</h3><ul class=\"list\">"+findings.slice(0,5).map((finding)=>"<li><span class=\"tag "+esc(finding.severity)+"\">"+esc(finding.severity)+"</span> "+esc(finding.code)+"</li>").join("")+"</ul>":"");return}if(!entity){panel.innerHTML="<p class=\"subtle\">Select a node in the map to inspect its evidence, connectivity, and findings.</p>";return}const relations=relationsByEntity.get(entity.id)||[],incoming=relations.filter((relation)=>relation.to===entity.id),outgoing=relations.filter((relation)=>relation.from===entity.id),findings=diagnosticsFor(entity.id),evidence=[...(entity.evidence||[]),...incoming.flatMap((relation)=>relation.evidence||[]),...outgoing.flatMap((relation)=>relation.evidence||[])].slice(0,8);panel.innerHTML="<div class=\"eyebrow\">Selected entity</div><h2 class=\"detail-title\">"+esc(label(entity))+"</h2><span class=\"tag\">"+esc(entity.kind)+"</span><p class=\"path\">"+esc(entity.path||entity.id)+"</p><div class=\"detail-grid\"><div><b>"+incoming.length+"</b><span>incoming</span></div><div><b>"+outgoing.length+"</b><span>outgoing</span></div><div><b>"+findings.length+"</b><span>findings</span></div><div><b>"+evidence.length+"</b><span>evidence items</span></div></div><h3>Evidence</h3><ul class=\"list\">"+(evidence.length?evidence.map((item)=>"<li>"+esc(item.path+(item.lineStart?":"+item.lineStart:"")+(item.context?" — "+item.context:""))+"</li>").join(""):"<li>No evidence recorded.</li>")+"</ul>"+(findings.length?"<h3 style=\"margin-top:16px\">Attention</h3><ul class=\"list\">"+findings.slice(0,5).map((finding)=>"<li><span class=\"tag "+esc(finding.severity)+"\">"+esc(finding.severity)+"</span> "+esc(finding.code)+"</li>").join("")+"</ul>":"")};
 const renderGraph=()=>{const model=graphModel(),svg=document.querySelector("#graph"),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)=>data.view?.diagnosticGroup?.[finding.id]?.[0]||(()=>{const ids=[...(finding.entityIds||[])];(finding.relationIds||[]).forEach((id)=>{const relation=relationById.get(id);if(relation)ids.push(relation.from,relation.to)});return ids.map(groupFor).sort()[0]||"repository"})();
 const findingGroups=(findings)=>{const groups=new Map();findings.forEach((finding)=>{const scope=findingScope(finding),key=[scope,finding.code,finding.status,finding.severity].join("|"),group=groups.get(key)||{key,scope,code:finding.code,status:finding.status,severity:finding.severity,findings:[]};group.findings.push(finding);groups.set(key,group)});return[...groups.values()].sort((left,right)=>right.findings.length-left.findings.length||left.code.localeCompare(right.code)||left.key.localeCompare(right.key))};
 const renderFinding=(finding)=>"<article class=\"finding\" id=\""+esc("diagnostic-"+finding.id.replace(/[^A-Za-z0-9_-]+/g,"-"))+"\"><div class=\"finding-head\"><h3>"+esc(finding.code)+"</h3><span><span class=\"tag "+esc(finding.severity)+"\">"+esc(finding.severity)+"</span> <span class=\"tag\">"+esc(finding.status)+"</span></span></div><p>"+esc(finding.message)+"</p>"+(finding.evidence.length?"<ul>"+finding.evidence.slice(0,4).map((item)=>"<li>"+esc(item.path+(item.lineStart?":"+item.lineStart:"")+(item.context?" — "+item.context:""))+"</li>").join("")+"</ul>":"")+(finding.remediation?"<p><strong>Next check:</strong> "+esc(finding.remediation)+"</p>":"")+"</article>";
-const renderFindings=()=>{let findings=data.diagnostics.filter(findingMatches);if(state.lens==="risks")findings=findings.filter((finding)=>finding.severity==="error"||finding.severity==="warn");if(state.lens==="evidence")findings=findings.filter((finding)=>finding.evidence.length);if(state.lens==="drift")findings=findings.filter((finding)=>finding.status!=="confirmed");const groups=findingGroups(findings),active=groups.find((group)=>group.key===state.findingGroup);if(!active){state.findingGroup=null;state.findingPage=0}syncHash();const selected=active||null,pageSize=40,pageCount=selected?Math.ceil(selected.findings.length/pageSize):0,page=Math.max(0,Math.min(state.findingPage,Math.max(0,pageCount-1))),start=page*pageSize;document.querySelector("#finding-count").textContent=findings.length+" findings · "+groups.length+" groups";document.querySelector("#findings").innerHTML=findings.length?"<div class=\"finding-groups\">"+groups.map((group)=>"<article class=\"finding-group\"><div class=\"finding-head\"><h3>"+esc(group.code)+"</h3><span><span class=\"tag "+esc(group.severity)+"\">"+esc(group.severity)+"</span> <span class=\"tag\">"+esc(group.status)+"</span></span></div><p><strong>"+group.findings.length+"</strong> finding"+(group.findings.length===1?"":"s")+" · "+esc(groupById.get(group.scope)?.name||group.scope)+"</p><p>"+esc(group.findings[0].message)+"</p><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(group.key)+"\" aria-expanded=\""+String(selected?.key===group.key)+"\">Inspect group</button></article>").join("")+"</div>"+(selected?"<div class=\"finding-detail\"><div class=\"finding-head\"><h3>"+esc(selected.code)+" · "+esc(groupById.get(selected.scope)?.name||selected.scope)+"</h3><span class=\"subtle\">"+selected.findings.length+" total</span></div>"+selected.findings.slice(start,start+pageSize).map(renderFinding).join("")+"<div class=\"finding-actions\"><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(selected.key)+"\" data-finding-page=\""+(page-1)+"\" "+(page===0?"disabled":"")+">Previous</button><span class=\"subtle\">Showing "+(start+1)+"–"+Math.min(start+pageSize,selected.findings.length)+" of "+selected.findings.length+" · page "+(page+1)+"/"+pageCount+"</span><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(selected.key)+"\" data-finding-page=\""+(page+1)+"\" "+(page+1>=pageCount?"disabled":"")+">Next</button></div></div>":""):"<p class=\"empty\">No findings match the current lens and filters.</p>"};
+const renderFindings=()=>{let findings=data.diagnostics.filter(findingMatches);if(state.lens==="risks")findings=findings.filter((finding)=>finding.severity==="error"||finding.severity==="warn");if(state.lens==="evidence")findings=findings.filter((finding)=>finding.evidence.length);if(state.lens==="drift")findings=findings.filter((finding)=>finding.status!=="confirmed");const itemLabel=state.lens==="evidence"?"evidence checks":"findings",groups=findingGroups(findings),active=groups.find((group)=>group.key===state.findingGroup);if(!active){state.findingGroup=null;state.findingPage=0}syncHash();const selected=active||null,pageSize=40,pageCount=selected?Math.ceil(selected.findings.length/pageSize):0,page=Math.max(0,Math.min(state.findingPage,Math.max(0,pageCount-1))),start=page*pageSize;document.querySelector("#finding-count").textContent=findings.length+" "+itemLabel+" · "+groups.length+" groups";document.querySelector("#findings").innerHTML=findings.length?"<div class=\"finding-groups\">"+groups.map((group)=>"<article class=\"finding-group\"><div class=\"finding-head\"><h3>"+esc(group.code)+"</h3><span><span class=\"tag "+esc(group.severity)+"\">"+esc(group.severity)+"</span> <span class=\"tag\">"+esc(group.status)+"</span></span></div><p><strong>"+group.findings.length+"</strong> "+itemLabel+" · "+esc(groupById.get(group.scope)?.name||group.scope)+"</p><p>"+esc(group.findings[0].message)+"</p><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(group.key)+"\" aria-expanded=\""+String(selected?.key===group.key)+"\">Inspect group</button></article>").join("")+"</div>"+(selected?"<div class=\"finding-detail\"><div class=\"finding-head\"><h3>"+esc(selected.code)+" · "+esc(groupById.get(selected.scope)?.name||selected.scope)+"</h3><span class=\"subtle\">"+selected.findings.length+" "+itemLabel+"</span></div>"+selected.findings.slice(start,start+pageSize).map(renderFinding).join("")+"<div class=\"finding-actions\"><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(selected.key)+"\" data-finding-page=\""+(page-1)+"\" "+(page===0?"disabled":"")+">Previous</button><span class=\"subtle\">Showing "+(start+1)+"–"+Math.min(start+pageSize,selected.findings.length)+" of "+selected.findings.length+" · page "+(page+1)+"/"+pageCount+"</span><button class=\"tab\" type=\"button\" data-finding-group=\""+esc(selected.key)+"\" data-finding-page=\""+(page+1)+"\" "+(page+1>=pageCount?"disabled":"")+">Next</button></div></div>":""):"<p class=\"empty\">No "+itemLabel+" match the current lens and filters.</p>"};
 const renderCoverage=()=>{document.querySelector("#coverage-list").innerHTML=(data.coverage||[]).map((entry)=>{const width=entry.status==="complete"?100:entry.status==="partial"?55:12;return"<div class=\"coverage-row\"><div><b>"+esc(entry.analyzer)+"</b><br><span class=\"subtle\">"+esc(entry.scope)+"</span></div><div class=\"bar\"><i class=\""+(entry.status==="complete"?"":entry.status==="partial"?"partial":"none")+"\" style=\"width:"+width+"%\"></i></div><div>"+esc(entry.status)+"</div></div>"}).join("")||"<p class=\"empty\">No coverage metadata.</p>"};
-const deferFindings=()=>{if(findingsLoaded())return;const count=data.diagnosticCount||0;document.querySelector("#finding-count").textContent=count+" findings · available on demand";document.querySelector("#findings").innerHTML="<div class=\"empty\"><p>Findings stay out of the first paint so large repositories remain responsive.</p><button id=\"load-findings\" class=\"tab\" type=\"button\">Load findings</button></div>"};
+const deferFindings=()=>{if(findingsLoaded())return;const actionable=data.actionableCount??data.diagnosticCount??0,confirmed=data.confirmedCount??0;document.querySelector("#finding-count").textContent=actionable+" actionable findings · "+confirmed+" confirmed checks available on demand";document.querySelector("#findings").innerHTML="<div class=\"empty\"><p>Findings stay out of the first paint so large repositories remain responsive. Confirmed checks are evidence, not issues.</p><button id=\"load-findings\" class=\"tab\" type=\"button\">Load findings</button></div>"};
 const scopePrompt=()=>{if((state.level==="module"||state.level==="file")&&!state.selected){document.querySelector("#map-note").textContent="Select an app or package to inspect this level.";document.querySelector("#graph").innerHTML="<text x=\"500\" y=\"270\" text-anchor=\"middle\" class=\"subtle\">Select an app or package to expand this view.</text>"}};
 const findingsLoaded=()=>!lazyChunks.includes("chunks/findings.js")||loadedChunks.has("chunks/findings.js");
 const levelsLoaded=()=>!hasLevelChunks||state.level==="overview"||activeLevelChunk===levelChunkName();
@@ -4197,11 +4311,12 @@ var render = (input, options) => {
   const data = reportData(snapshot, report, includeSnippets, options.privacy);
   const scriptBody = script.replace("${DATA}", options.dataExpression ?? embeddedJson(data));
   const largeNote = snapshot.entities.length > 500 || report.diagnostics.length > 1e3 ? "Large snapshots are rendered from compact canonical data with progressive graph levels." : "The viewer starts with a grouped topology and expands into canonical entities on demand.";
-  const issueCount = report.diagnostics.filter((diagnostic2) => diagnostic2.severity === "error" || diagnostic2.severity === "warn").length;
+  const actionableCount = report.diagnostics.filter((diagnostic2) => diagnostic2.status !== "confirmed").length;
+  const confirmedCount = report.diagnostics.filter((diagnostic2) => diagnostic2.status === "confirmed").length;
   const unsupportedCount = snapshot.coverage.filter((entry) => entry.status !== "complete").length;
-  const policyNote = report.summary.requiredRelationKinds === void 0 ? "Missing relation declarations are checked for every observed relation kind." : report.summary.requiredRelationKinds.length ? `Missing relation declarations are checked for: ${report.summary.requiredRelationKinds.join(", ")}.` : "Missing relation declarations are disabled by configuration; stale, conflicting, and unresolved declarations remain checked.";
+  const policyNote = report.summary.requiredRelationKinds === void 0 ? "Missing relation declarations are checked for every observed relation kind." : report.summary.requiredRelationKinds.length ? `Missing relation declarations are checked for: ${report.summary.requiredRelationKinds.join(", ")}${report.summary.requiredRelationTargets === "internal" ? " between internal entities" : ""}.` : "Missing relation declarations are disabled by configuration; stale, conflicting, and unresolved declarations remain checked.";
   const statusOptions = ["confirmed", "undocumented", "stale-or-unverified", "conflict", "unresolved", "not-analyzed"];
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Doc Bridge \u2014 ${escapeHtml(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>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Doc Bridge \u2014 ${escapeHtml(data.project.name)}</title><style>${styles}</style></head><body>${options.dataScripts ?? ""}<main class="shell"><header class="masthead"><div><div class="eyebrow">Doc Bridge / Knowledge report</div><h1>${escapeHtml(data.project.name)}</h1><p class="lede">A read-only architecture and documentation map. Start broad, then follow evidence to the exact entity, relation, or finding.</p></div><div class="run-meta"><span class="read-only">Read-only snapshot</span><strong>${escapeHtml(data.revision)}</strong><span>${escapeHtml(data.revisionKind)} \xB7 pipeline ${escapeHtml(data.pipelineVersion)}</span></div></header><section class="summary" aria-label="Snapshot summary"><div class="metric"><b>${snapshot.entities.length}</b><span>entities</span></div><div class="metric"><b>${snapshot.relations.length}</b><span>canonical relations</span></div><div class="metric ${actionableCount ? "warn" : ""}"><b>${actionableCount}</b><span>actionable findings</span></div><div class="metric"><b>${confirmedCount}</b><span>confirmed checks</span></div><div class="metric ${unsupportedCount ? "bad" : ""}"><b>${unsupportedCount}</b><span>partial / unanalyzed scopes</span></div></section><div class="lens-bar"><nav class="tabs" aria-label="Report lenses"><button class="tab" data-lens="architecture" aria-selected="true">Architecture</button><button class="tab" data-lens="drift" aria-selected="false">Documentation drift</button><button class="tab" data-lens="risks" aria-selected="false">Risks &amp; hotspots</button><button class="tab" data-lens="evidence" aria-selected="false">Evidence</button></nav><span class="subtle">${escapeHtml(largeNote)}</span></div><p id="lens-caption" class="subtle">The repository topology at the selected level.</p><p class="subtle">${escapeHtml(policyNote)}</p><section id="insights" class="insights" aria-label="Attention signals"></section><section class="filters" aria-label="Finding filters"><label>Search <input id="search" type="search" placeholder="Press / to search findings"></label><label>Status <select id="status"><option value="">Any status</option>${statusOptions.map((value) => `<option>${escapeHtml(value)}</option>`).join("")}</select></label><label>Severity <select id="severity"><option value="">Any severity</option><option>error</option><option>warn</option><option>info</option></select></label><button id="reset" type="button">Reset filters</button></section><div class="workspace"><section class="panel" aria-labelledby="architecture-title"><div class="panel-head"><div><h2 id="architecture-title">Architecture map</h2><p id="map-note" class="subtle">Grouped package/external view.</p></div><div class="tabs" aria-label="Graph level"><button class="level" data-level="overview" aria-pressed="true">Overview</button><button class="level" data-level="package" aria-pressed="false">Package</button><button class="level" data-level="module" aria-pressed="false">Module</button><button class="level" data-level="file" aria-pressed="false">File</button></div></div><div class="map-wrap"><svg id="graph" viewBox="0 0 1000 560" role="img" aria-label="Interactive architecture graph"></svg></div><p class="subtle">Node number = visible connection degree. Amber nodes/edges have actionable findings. Click or focus a node to inspect its evidence, connectivity, and findings. Grouped edges preserve canonical relation direction and count.</p></section><aside class="panel side" aria-labelledby="details-title"><div class="panel-head"><div><div class="eyebrow">Evidence trail</div><h2 id="details-title">Details</h2></div><button id="clear-selection" class="tab" type="button">Clear</button></div><div id="details"><p class="subtle">Select a node in the map to inspect its evidence, connectivity, and findings.</p></div></aside></div><section class="panel run" aria-labelledby="run-title"><div class="panel-head"><div><div class="eyebrow">Jest-like diagnostics</div><h2 id="run-title">Run report</h2></div><span id="finding-count" class="subtle">${actionableCount} actionable findings \xB7 ${confirmedCount} confirmed checks</span></div><div class="run-summary"><span class="chip"><b>${report.diagnostics.filter((item) => item.severity === "error").length}</b> errors</span><span class="chip"><b>${report.diagnostics.filter((item) => item.severity === "warn").length}</b> warnings</span><span class="chip"><b>${report.diagnostics.filter((item) => item.status === "undocumented").length}</b> undocumented</span><span class="chip"><b>${report.diagnostics.filter((item) => item.status === "stale-or-unverified" || item.status === "conflict").length}</b> drift/conflict</span><span class="chip"><b>${confirmedCount}</b> confirmed checks</span></div><div id="findings"></div></section><section class="panel run" aria-labelledby="coverage-title"><div class="panel-head"><div><div class="eyebrow">Analyzer boundaries</div><h2 id="coverage-title">Coverage &amp; unsupported areas</h2></div><span class="subtle">Explicit limits are part of the evidence</span></div><div id="coverage-list"></div></section><section class="metadata" aria-label="Run metadata"><div><b>Snapshot</b>${escapeHtml(data.snapshotHash)}</div><div><b>Report</b>${escapeHtml(data.reportHash)}</div><div><b>Configuration</b>${escapeHtml(data.configurationHash)}</div><div><b>Analyzers</b>${escapeHtml(Object.entries(data.analyzerVersions).map(([name, version]) => `${name} ${version}`).join(", "))}</div><div><b>Source revision</b>${escapeHtml(data.revision)} (${escapeHtml(data.revisionKind)})</div><div><b>Mode</b>${options.privacy === "anonymized" ? "Anonymized read-only browser viewer; evidence paths and project identity are redacted." : "Read-only browser viewer; approvals and fixes remain outside this artifact."}</div></section></main><script>${scriptBody}</script></body></html>`;
 };
 var parseReportInput = (input) => {
   if (!input || typeof input !== "object") throw new Error("Input must contain snapshot and report artifacts.");
@@ -4314,7 +4429,7 @@ var renderOfflineReportArtifact = (input, options = {}) => {
     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, entities: packageEntities, relations: packageRelations, view: overviewView }),
+    "chunks/overview.js": chunkScript({ project: data.project, revision: data.revision, revisionKind: data.revisionKind, snapshotHash: data.snapshotHash, reportHash: data.reportHash, configurationHash: data.configurationHash, pipelineVersion: data.pipelineVersion, analyzerVersions: data.analyzerVersions, coverage: data.coverage, diagnosticCount: data.diagnosticCount, actionableCount: data.actionableCount, confirmedCount: data.confirmedCount, diagnosticSummary: data.diagnosticSummary, documentation: data.documentation, requiredRelationKinds: data.requiredRelationKinds, entities: packageEntities, relations: packageRelations, view: overviewView }),
     ...levelFiles,
     ...detailFiles,
     "chunks/findings.js": chunkScript({ diagnostics: data.diagnostics })
@@ -4327,8 +4442,8 @@ var renderOfflineReportArtifact = (input, options = {}) => {
 };
 
 // src/fixes/proposals.ts
-import { existsSync as existsSync11, readdirSync as readdirSync4, readFileSync as readFileSync10, realpathSync as realpathSync7, renameSync, statSync as statSync4, unlinkSync, writeFileSync as writeFileSync3 } from "fs";
-import { basename as basename5, dirname as dirname6, extname as extname2, join as join10, relative as relative6, resolve as resolve9, sep as sep7 } from "path";
+import { existsSync as existsSync11, readdirSync as readdirSync4, readFileSync as readFileSync10, realpathSync as realpathSync7, renameSync, unlinkSync, writeFileSync as writeFileSync3 } from "fs";
+import { basename as basename5, dirname as dirname5, extname as extname2, join as join10, relative as relative6, resolve as resolve9, sep as sep7 } from "path";
 var hash2 = (value) => sha256NormalizedV1(value);
 var artifactMetadata = (root, options) => ({
   schemaVersion: 1,
@@ -4384,12 +4499,12 @@ var createMarkdownLinkFixProposal = (root, options) => {
       const target = match[3];
       if (!target || match[1] === "!" || /^(?:[a-z]+:|\/|#)/i.test(target)) continue;
       const targetPath = target.split("#")[0]?.split("?")[0];
-      if (!targetPath || existsSync11(resolve9(projectRoot, dirname6(path), targetPath))) continue;
+      if (!targetPath || existsSync11(resolve9(projectRoot, dirname5(path), targetPath))) continue;
       const targetStem = basename5(targetPath, extname2(targetPath)).toLowerCase();
       const labelStem = (match[2] ?? "").trim().toLowerCase().replace(/[^a-z0-9]+/g, "");
       const candidates = paths.filter((candidate) => basename5(candidate, extname2(candidate)).toLowerCase() === targetStem || basename5(candidate, extname2(candidate)).toLowerCase().replace(/[^a-z0-9]+/g, "") === labelStem);
       if (candidates.length !== 1) continue;
-      let replacement = relative6(dirname6(path), candidates[0]).split(sep7).join("/");
+      let replacement = relative6(dirname5(path), candidates[0]).split(sep7).join("/");
       if (target.startsWith("./") && !replacement.startsWith(".")) replacement = `./${replacement}`;
       next = next.replace(match[0], match[0].replace(target, replacement));
     }
@@ -4401,8 +4516,13 @@ var createArtifactNormalizationProposal = (root, artifactPath, options) => {
   const projectRoot = realpathSync7.native(resolve9(root));
   const path = artifactPath.split(sep7).join("/");
   const absolute = containedPath(projectRoot, path);
-  if (!absolute || !existsSync11(absolute) || !statSync4(absolute).isFile()) return void 0;
-  const before = readFileSync10(absolute, "utf8");
+  if (!absolute) return void 0;
+  let before;
+  try {
+    before = readFileSync10(absolute, "utf8");
+  } catch {
+    return void 0;
+  }
   let after;
   try {
     after = `${JSON.stringify(sortJson(JSON.parse(before)), null, 2)}
@@ -4792,8 +4912,20 @@ var evaluateRules = (report, options = {}) => {
   const sortedFindings = [...findings].sort((a, b) => a.id.localeCompare(b.id));
   return { mode: resolved.mode, findings: sortedFindings, exitCode: sortedFindings.some((finding) => finding.severity === "error") ? 1 : 0 };
 };
-var parseRuleId = (value) => RuleIdSchema.parse(value);
-var parseRuleSeverity = (value) => RuleSeveritySchema.parse(value);
+var parseRuleId = (value) => {
+  try {
+    return RuleIdSchema.parse(value);
+  } catch {
+    throw new Error(`Invalid enum value: ${value}`);
+  }
+};
+var parseRuleSeverity = (value) => {
+  try {
+    return RuleSeveritySchema.parse(value);
+  } catch {
+    throw new Error(`Invalid enum value: ${value}`);
+  }
+};
 
 // src/federation/ecosystem-llms.ts
 function formatEcosystemLlmsBlock(options) {
@@ -4825,7 +4957,7 @@ function formatEcosystemLlmsSection(options) {
 import { readFileSync as readFileSync14 } from "fs";
 
 // src/conformance/documentation-standard-v1.ts
-import { existsSync as existsSync13, readFileSync as readFileSync12, realpathSync as realpathSync8, statSync as statSync5 } from "fs";
+import { closeSync as closeSync2, existsSync as existsSync13, fstatSync as fstatSync2, openSync as openSync2, readFileSync as readFileSync12, realpathSync as realpathSync8 } from "fs";
 import { isAbsolute as isAbsolute5, relative as relative8, resolve as resolve11, sep as sep8 } from "path";
 
 // src/conformance/ecosystem-contract.ts
@@ -5030,11 +5162,10 @@ var fileEvidence = (root, path, options) => {
       evidence: { path, detail: "Path escapes the project root." }
     };
   }
-  if (!existsSync13(abs)) {
-    return { exists: false, content: "", evidence: { path, detail: "File does not exist." } };
-  }
+  let fd;
   try {
-    const stat = statSync5(abs);
+    fd = openSync2(abs, "r");
+    const stat = fstatSync2(fd);
     if (!stat.isFile()) {
       return { exists: false, content: "", evidence: { path, detail: "Path is not a regular file." } };
     }
@@ -5055,7 +5186,7 @@ var fileEvidence = (root, path, options) => {
         evidence: { path, detail: `Text evidence exceeds ${MAX_TEXT_EVIDENCE_BYTES} bytes.` }
       };
     }
-    const content = readFileSync12(abs, "utf8");
+    const content = readFileSync12(fd, "utf8");
     return {
       exists: content.trim().length > 0,
       content,
@@ -5064,8 +5195,15 @@ var fileEvidence = (root, path, options) => {
         detail: content.trim().length > 0 ? "File exists and is non-empty." : "File is empty."
       }
     };
-  } catch {
-    return { exists: false, content: "", evidence: { path, detail: "File is not readable text." } };
+  } catch (error) {
+    const code = error && typeof error === "object" && "code" in error ? error.code : void 0;
+    return {
+      exists: false,
+      content: "",
+      evidence: { path, detail: code === "ENOENT" ? "File does not exist." : "File is not readable text." }
+    };
+  } finally {
+    if (fd !== void 0) closeSync2(fd);
   }
 };
 var resultWithException = (draft, options) => {
@@ -6330,7 +6468,7 @@ var startMcpStdioServer = (ctx) => {
 // src/mcp/install.ts
 import { existsSync as existsSync16, mkdirSync as mkdirSync5, readFileSync as readFileSync17, writeFileSync as writeFileSync6 } from "fs";
 import { homedir } from "os";
-import { dirname as dirname7, join as join15, resolve as resolve14 } from "path";
+import { dirname as dirname6, join as join15, resolve as resolve14 } from "path";
 var SERVER_NAME = "ak-docs";
 var mcpServerEntry = (root) => ({
   command: "npx",
@@ -6347,7 +6485,7 @@ var readJson2 = (path) => {
   }
 };
 var writeJson = (path, value) => {
-  mkdirSync5(dirname7(path), { recursive: true });
+  mkdirSync5(dirname6(path), { recursive: true });
   writeFileSync6(path, `${JSON.stringify(value, null, 2)}
 `, "utf8");
 };
@@ -6427,16 +6565,6 @@ var gradeForScore = (score) => {
   if (score >= 40) return "D";
   return "F";
 };
-var agentDocPaths = (index) => {
-  const paths = /* @__PURE__ */ new Set();
-  for (const owner of Object.values(index.lookup?.ownership ?? {})) {
-    if (owner.agentDoc) paths.add(owner.agentDoc);
-  }
-  for (const handoff of Object.values(index.handoffs ?? {})) {
-    if (handoff.startHere) paths.add(handoff.startHere);
-  }
-  return paths;
-};
 var computeScore = (coverage) => {
   let score = 0;
   if (coverage.freshness.hasIndex) score += 15;
@@ -6524,7 +6652,7 @@ var runDoctor = (root, config) => {
   let index;
   let hasIndex = true;
   let freshnessOk = false;
-  let freshnessMessage = "Index is fresh";
+  let freshnessMessage;
   try {
     index = loadDocBridgeIndex(root, config);
     const next = buildDocBridgeIndex({ root, config, write: false }).index.contentHash;
@@ -6544,8 +6672,6 @@ var runDoctor = (root, config) => {
   const missingAgentDoc = ownership.filter(([, owner]) => !owner.agentDoc || owner.agentDoc === config.corpus.agent.index).map(([id]) => id);
   const missingHumanDoc = ownership.filter(([, owner]) => !owner.humanDoc).map(([id]) => id);
   const indexedPaths = new Set(index.knowledge.map((entry) => entry.path));
-  const expectedAgentDocs = agentDocPaths(index);
-  const unindexed = [...expectedAgentDocs].filter((path) => !indexedPaths.has(path));
   const corpusDocs = scanAgentCorpus(root, config).filter(
     (doc) => doc.path !== config.corpus.agent.index
   );
@@ -6624,7 +6750,7 @@ var formatDoctorText = (report) => {
 
 // src/index-builder/watch-index.ts
 import { existsSync as existsSync17, watch } from "fs";
-import { dirname as dirname8, resolve as resolve15 } from "path";
+import { dirname as dirname7, resolve as resolve15 } from "path";
 var WATCH_PATTERN = /\.(md|mdx|json|ya?ml|mdc)$/i;
 var NX_MANIFEST_PATTERN = /(^|[/\\])(project|package)\.json$/i;
 var collectWatchRoots = (root, config, configPath) => {
@@ -6638,7 +6764,7 @@ var collectWatchRoots = (root, config, configPath) => {
       if (typeof value === "string" && value.length) roots.add(resolve15(root, value));
     }
   }
-  if (configPath) roots.add(dirname8(resolve15(configPath)));
+  if (configPath) roots.add(dirname7(resolve15(configPath)));
   return [...roots].filter((dir) => existsSync17(dir));
 };
 var watchDocBridgeIndex = (opts) => {
@@ -6708,7 +6834,7 @@ var watchDocBridgeIndex = (opts) => {
 // src/memory/github-pr.ts
 import { execFileSync as execFileSync2, spawnSync } from "child_process";
 import { existsSync as existsSync18, mkdirSync as mkdirSync6, writeFileSync as writeFileSync7 } from "fs";
-import { join as join17 } from "path";
+import { join as join16 } from "path";
 var run = (cmd, args, cwd) => {
   const result = spawnSync(cmd, [...args], { cwd, encoding: "utf8" });
   const out = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
@@ -6716,10 +6842,10 @@ var run = (cmd, args, cwd) => {
 };
 var hasGh = () => run("gh", ["--version"], process.cwd()).ok;
 var slug = () => (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
-var defaultPromotionDraftPath = (root) => join17(root, ".doc-bridge", "drafts", `memory-promotion-${slug()}.md`);
+var defaultPromotionDraftPath = (root) => join16(root, ".doc-bridge", "drafts", `memory-promotion-${slug()}.md`);
 var writePromotionDraft = (root, draft, path) => {
   const draftPath = path ?? defaultPromotionDraftPath(root);
-  mkdirSync6(join17(root, ".doc-bridge", "drafts"), { recursive: true });
+  mkdirSync6(join16(root, ".doc-bridge", "drafts"), { recursive: true });
   writeFileSync7(draftPath, `${draft.body}
 `, "utf8");
   return draftPath;
@@ -6755,7 +6881,7 @@ var promoteMemoryToGithubPr = (root, draft, options = {}) => {
       message: `Wrote draft to ${relDraft}. Run the printed git/gh commands to open a draft PR.`
     };
   }
-  if (!existsSync18(join17(root, ".git"))) {
+  if (!existsSync18(join16(root, ".git"))) {
     return {
       ok: false,
       dryRun: false,
@@ -7039,9 +7165,20 @@ var defaultFetchText = async (url) => {
   if (!res.ok) throw new Error(`Failed to fetch ${url}: ${res.status}`);
   return res.text();
 };
+var httpUrl = (value) => {
+  try {
+    const parsed = new URL(value);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return void 0;
+    if (parsed.username || parsed.password) return void 0;
+    return parsed.href;
+  } catch {
+    return void 0;
+  }
+};
 var sourceText = async (root, source, fetchText) => {
   try {
-    if (/^https?:\/\//.test(source)) return await fetchText(source);
+    const remote = httpUrl(source);
+    if (remote) return await fetchText(remote);
     const path = resolve16(root, source);
     if (!existsSync19(path)) return null;
     return readFileSync18(path, "utf8");
@@ -7054,22 +7191,57 @@ var sameOrigin = (base, target) => {
   return new URL(base).origin === new URL(target).origin;
 };
 var parseLlmsTxtLinks = (raw) => {
-  const links = [...raw.matchAll(/\[([^\]]+)\]\(([^)]+)\)(?::\s*([^\n]+))?/g)].map((match) => ({
-    title: match[1] ?? match[2] ?? "link",
-    url: match[2] ?? "",
-    ...match[3]?.trim() ? { description: match[3].trim() } : {}
-  })).filter((link) => link.url);
-  for (const match of raw.matchAll(/(?:^|\s)(?:Raw|llms\.txt|Full bundle|ZIP bundle)?:?\s*(https?:\/\/\S+)/gi)) {
-    const url = match[1]?.replace(/[),.;]+$/, "");
-    if (url && !links.some((link) => link.url === url)) links.push({ title: slugFromPath(url), url });
+  const links = [];
+  for (const line of raw.split(/\r?\n/)) {
+    let cursor = 0;
+    while (cursor < line.length) {
+      const open = line.indexOf("[", cursor);
+      if (open < 0) break;
+      const titleEnd = line.indexOf("]", open + 1);
+      const urlStart = titleEnd < 0 ? -1 : line.indexOf("(", titleEnd + 1);
+      const urlEnd = urlStart < 0 ? -1 : line.indexOf(")", urlStart + 1);
+      if (titleEnd < 0 || urlStart !== titleEnd + 1 || urlEnd < 0) {
+        cursor = open + 1;
+        continue;
+      }
+      const title = line.slice(open + 1, titleEnd).trim();
+      const url = line.slice(urlStart + 1, urlEnd).trim();
+      const description = line.slice(urlEnd + 1).trim().replace(/^:\s*/, "");
+      if (url) links.push({ title: title || url, url, ...description ? { description } : {} });
+      cursor = urlEnd + 1;
+    }
+    for (const token of line.split(/\s+/)) {
+      let end = token.length;
+      while (end > 0 && "),.;:".includes(token[end - 1] ?? "")) end -= 1;
+      const url = token.slice(0, end);
+      if (!/^https?:\/\//i.test(url) || links.some((link) => link.url === url)) continue;
+      links.push({ title: slugFromPath(url), url });
+    }
   }
   return links;
 };
+var firstMatchingLine = (section, predicate) => section.split(/\r?\n/).find((line) => predicate(line.trim()))?.trim();
+var sectionTitle = (section, sourceUrl) => {
+  const titleLine = firstMatchingLine(section, (line) => line.startsWith("title:"));
+  if (titleLine) return titleLine.slice("title:".length).trim();
+  const urlLine = firstMatchingLine(section, (line) => /^https?:\/\//i.test(line));
+  if (urlLine) {
+    try {
+      return new URL(urlLine).pathname.split("/").filter(Boolean).at(-1) ?? slugFromPath(sourceUrl);
+    } catch {
+      return slugFromPath(sourceUrl);
+    }
+  }
+  const heading = firstMatchingLine(section, (line) => line.startsWith("#"));
+  if (heading) return heading.replace(/^#+\s*/, "").trim();
+  return slugFromPath(sourceUrl);
+};
 var chunksFromMarkdown = (property, raw, sourceUrl) => {
-  const searchable = raw.includes("\n==== ") ? raw : raw.replace(/^---\n[\s\S]*?\n---\n?/, "");
+  const frontmatterEnd = raw.startsWith("---\n") ? raw.indexOf("\n---", 4) : -1;
+  const searchable = raw.includes("\n==== ") ? raw : frontmatterEnd >= 0 ? raw.slice(frontmatterEnd + "\n---".length).replace(/^\n/, "") : raw;
   const sections = searchable.includes("\n==== ") ? searchable.split(/\n====\s+/).filter((section) => section.trim()) : searchable.split(/\n(?=##?\s+)/);
   return sections.map((section, index) => {
-    const title = /^title:\s*(.+)$/m.exec(section)?.[1]?.trim() ?? /^https?:\/\/\S+\/([^/\s]+)$/m.exec(section)?.[1]?.trim() ?? /^#+\s+(.+)$/m.exec(section)?.[1]?.trim() ?? slugFromPath(sourceUrl);
+    const title = sectionTitle(section, sourceUrl);
     const id = slugFromPath(title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")) || `${index}`;
     return {
       chunkKey: `${property}:federated:${id}`,
@@ -7097,8 +7269,15 @@ var loadFederatedChunks = async (root, config, options = {}) => {
     chunks.push(...chunksFromMarkdown(source.id, llms, source.llmsTxt));
     const links = parseLlmsTxtLinks(llms);
     for (const link of links) {
-      const url = !/^https?:\/\//.test(link.url) && source.rawBaseUrl ? `${source.rawBaseUrl.replace(/\/$/, "")}/${link.url.replace(/^\//, "")}` : link.url;
-      if (!/\.(md|txt)(?:$|\?)/.test(url)) continue;
+      const linkUrl = httpUrl(link.url);
+      const baseUrl = source.rawBaseUrl ? httpUrl(source.rawBaseUrl) : void 0;
+      const url = linkUrl ?? (baseUrl ? new URL(link.url, baseUrl).href : link.url);
+      let pathname = url;
+      try {
+        pathname = new URL(url).pathname;
+      } catch {
+      }
+      if (!/\.(md|txt)$/i.test(pathname)) continue;
       if (!sameOrigin(source.llmsTxt, url)) continue;
       const raw = await sourceText(root, url, fetchText);
       if (raw) chunks.push(...chunksFromMarkdown(source.id, raw, url));
@@ -7130,10 +7309,10 @@ var retrieveHybridChunks = async (root, config, index, query, options = {}) => {
 
 // src/intelligence/rag.ts
 import { readFileSync as readFileSync19 } from "fs";
-import { join as join19 } from "path";
+import { join as join18 } from "path";
 
 // src/intelligence/adapter.ts
-import { join as join18 } from "path";
+import { join as join17 } from "path";
 
 // src/intelligence/peers.ts
 var PeerMissingError = class extends Error {
@@ -7260,7 +7439,7 @@ var resolveIntelligenceRuntime = async (config) => {
   }
   return { adapter, embed, provider, ...model ? { model } : {} };
 };
-var defaultVectorStorePath = (root) => join18(root, ".doc-bridge", "vectors");
+var defaultVectorStorePath = (root) => join17(root, ".doc-bridge", "vectors");
 
 // src/intelligence/rag.ts
 var loadDocuments = (root, index, sources) => {
@@ -7268,7 +7447,7 @@ var loadDocuments = (root, index, sources) => {
   const docs = [];
   if (includeAgent) {
     for (const entry of index.knowledge) {
-      const abs = join19(root, entry.path);
+      const abs = join18(root, entry.path);
       let content = "";
       try {
         content = readFileSync19(abs, "utf8");
@@ -7289,7 +7468,7 @@ var createDocBridgeRag = async (root, config, index) => {
   const { embed } = await resolveIntelligenceRuntime(config);
   const ragMod = await importPeer("@agentskit/rag");
   const memoryMod = await importPeer("@agentskit/memory");
-  const storePath = typeof config.intelligence?.retriever?.options?.storePath === "string" ? join19(root, config.intelligence.retriever.options.storePath) : defaultVectorStorePath(root);
+  const storePath = typeof config.intelligence?.retriever?.options?.storePath === "string" ? join18(root, config.intelligence.retriever.options.storePath) : defaultVectorStorePath(root);
   const store = memoryMod.fileVectorMemory({ path: storePath });
   const rag = ragMod.createRAG({
     embed,