@riebeckite/plugin-diagnostics 0.0.13 → 0.0.15

package/README.md

@@ -1,8 +1,8 @@
 # @riebeckite/plugin-diagnostics
 
-Content diagnostics for Obsidian vaults / Riebeckite content: broken links,
-frontmatter issues, orphan notes, unused assets, and more. Usable as a build
-plugin, a programmatic API, and a CLI.
+Content diagnostics for Obsidian vaults / Riebeckite content: site-wide
+reference integrity, frontmatter issues, orphan notes, unused assets, and more.
+Usable as a build plugin, a programmatic API, and a CLI.
 
 [日本語](./README_ja.md)
 
@@ -44,17 +44,47 @@ export default defineConfig({
 | `broken-link` | `error` | Markdown link points to a missing or excluded note/file |
 | `unused-asset` | `warning` | Image never referenced by any note (`reportUnusedAssets`) |
 | `orphan-note` | `info` | Published note has no incoming links (`reportOrphans`) |
-| `missing-frontmatter` | `warning` | No frontmatter, or required fields missing |
+| `missing-frontmatter` | `warning` | A required frontmatter field is missing |
 | `publish-conflict` | `warning` | `publish: true` combined with `draft: true` / `private: true` |
-| `duplicate-title` | `warning` | Multiple published notes share a title |
+| `duplicate-title` | `warning` | Multiple published notes share a title within the same language |
 | `slug-collision` | `error` | Slugs collide case-insensitively |
 | `duplicate-content-id` | `error` | Published notes share a stable content ID (`id`/`uid`) |
 | `invalid-content-id` | `error` | `id`/`uid` frontmatter violates the stable content ID contract |
 | `excluded-public` | `warning` | Excluded note is marked `publish: true` |
 | `publish-boundary` | `warning` | Published content links to or embeds non-published content |
 | `analytics-untracked` | `info` | Published note has no stable `id` and the analytics plugin will not track it (enabled with `reportAnalyticsCoverage`, or automatically when the config enables the analytics plugin) |
+| `content-integrity:broken-link` | `warning` | A published page links to a site-local route that is not published or registered |
+| `content-integrity:unresolved-wikilink` | `warning` | A published entry contains a WikiLink that the configured WikiLink/content index resolution did not resolve |
+| `content-integrity:broken-asset` | `warning` | A published page references a local asset that is not in resolved content assets, plugin assets, generated outputs, or public routes |
+| `content-integrity:duplicate-public-location` | `error` | Two published entries or generated routes claim the same final public path |
+| `content-integrity:redirect-target-missing` | `warning` | A public redirect points at content whose public target is unavailable |
+| `content-integrity:redirect-cycle` | `error` | Public redirects form a cycle |
+| `content-integrity:redirect-public-location-conflict` | `error` | A redirect path conflicts with another public route |
 | `internal-error` | `error` | Content analysis failed |
 
+## Site-wide content integrity
+
+When used as a Riebeckite plugin, diagnostics runs site-wide integrity checks
+from the resolved manifest instead of rescanning content for link rules. It uses
+`publicEntries`, resolved `ContentLink` metadata, `ContentPublicLocation`,
+`publicRedirects`, plugin page paths, plugin assets, and generated outputs.
+This keeps permalink, alias, rename redirect, l10n, publish/exclude, and Page
+System behavior aligned with the build pipeline.
+
+It does not check external HTTP reachability, SEO, spelling, Lighthouse, or
+automatic repairs. External URLs (`http:`, `https:`, `mailto:`, `tel:`, `data:`),
+protocol-relative URLs, and fragment-only links are ignored. Query strings and
+fragments are stripped before route existence checks. Plugin authors should
+register generated routes through Page Types and generated files/assets through
+the existing plugin output/asset contracts so integrity checks can treat them as
+valid public targets.
+
+`runDiagnostics()` and the standalone CLI still use the filesystem/content-source
+analyzer because no full manifest is available in that mode. As a result,
+`orphan-note` and `unused-asset` are reported only by `runDiagnostics()` and the
+standalone CLI; during a build they are omitted because link relationships come
+from the manifest.
+
 ## Options
 
 | Option | Type | Default | Description |
@@ -129,4 +159,5 @@ assertNoErrors(report);
 
 ## See also
 
-- [Plugin guide](../../../docs/en/reference/plugin-api.md)
+- [Plugin guide](../../../docs/en/docs/reference/plugin-api.md)
+

package/README_ja.md

@@ -1,6 +1,6 @@
 # @riebeckite/plugin-diagnostics
 
-コンテンツのリンク切れ、公開設定の矛盾、frontmatter の不足などを検出するプラグインです。ビルド時の診断だけでなく、CLI とプログラムからの実行にも対応します。
+サイト全体の参照整合性、公開設定の矛盾、frontmatter の不足などを検出するプラグインです。ビルド時の診断だけでなく、CLI とプログラムからの実行にも対応します。
 
 [English](./README.md)
 
@@ -28,24 +28,39 @@ export default defineConfig({
 
 | コード | 既定の重要度 | 内容 |
 | --- | --- | --- |
-| `broken-wikilink` | error | Wikiリンクの参照先またはフラグメントを解決できない |
+| `broken-wikilink` | error | Wiki リンクの参照先またはフラグメントを解決できない |
 | `broken-image` | error | 埋め込み画像または画像リンクの参照先がない |
 | `broken-link` | error | Markdown リンクが存在しない、または除外されたノートを指す |
 | `unused-asset` | warning | どのノートからも参照されない画像 |
 | `orphan-note` | info | 公開ノートのうち、他のノートからリンクされていないもの |
-| `missing-frontmatter` | warning | frontmatter がない、または必須フィールドが欠けている |
+| `missing-frontmatter` | warning | 必須フィールドが欠けている |
 | `publish-conflict` | warning | `publish: true` と `draft: true` または `private: true` が同居している |
-| `duplicate-title` | warning | 公開ノート同士でタイトルが重複している |
+| `duplicate-title` | warning | 同じ言語の公開ノート同士でタイトルが重複している |
 | `slug-collision` | error | 大文字・小文字を区別しない slug が衝突している |
 | `duplicate-content-id` | error | 公開ノート同士で安定コンテンツ ID（`id`/`uid`）が重複している |
-| `invalid-content-id` | error | `id`/`uid` の frontmatter が安定コンテンツ ID の契約を満たしていない |
+| `invalid-content-id` | error | `id`/`uid` の frontmatter が安定コンテンツ ID の要件を満たしていない |
 | `excluded-public` | warning | 除外されたノートに `publish: true` が指定されている |
 | `publish-boundary` | warning | 公開コンテンツから非公開コンテンツへリンク・埋め込みしている |
 | `analytics-untracked` | info | 安定 `id` のない公開ノートは analytics プラグインで計測されない（`reportAnalyticsCoverage` で有効化。設定で analytics プラグインが有効な場合は自動で有効化） |
+| `content-integrity:broken-link` | warning | 公開ページが、公開または登録されていないサイト内経路へリンクしている |
+| `content-integrity:unresolved-wikilink` | warning | 公開ページ内の Wiki リンクを、設定済みの解決規則で解決できない |
+| `content-integrity:broken-asset` | warning | 公開ページが、解決済みアセット・プラグインアセット・生成出力・公開経路のいずれにもないローカルアセットを参照している |
+| `content-integrity:duplicate-public-location` | error | 複数の公開コンテンツまたは生成経路が、同じ最終公開パスを所有している |
+| `content-integrity:redirect-target-missing` | warning | 公開リダイレクトの転送先コンテンツが公開されない |
+| `content-integrity:redirect-cycle` | error | 公開リダイレクトが循環している |
+| `content-integrity:redirect-public-location-conflict` | error | リダイレクト元のパスが別の公開経路と衝突している |
 | `internal-error` | error | コンテンツ解析中に処理できないエラーが発生した |
 
 未使用アセットと孤立ノートは、明示的に有効化した場合だけ確認します。意図的に孤立させるトップページなどがあるなら、`reportOrphans` の結果を公開方針と照らして判断してください。
 
+## サイト全体の参照整合性
+
+Riebeckite のプラグインとして使う場合、リンク関係の検査はコンテンツを再走査せず、解決済み manifest から行います。`publicEntries`、解決済み `ContentLink`、`ContentPublicLocation`、`publicRedirects`、プラグインページのパス、プラグインアセット、生成出力を参照します。これにより permalink、alias、rename によるリダイレクト、l10n、公開・除外設定、Page System の扱いがビルド処理と揃います。
+
+外部 URL の疎通確認、SEO、スペルチェック、Lighthouse、自動修復は行いません。`http:`、`https:`、`mailto:`、`tel:`、`data:`、プロトコル相対 URL、ページ内フラグメントだけのリンクは対象外です。経路の存在確認では、クエリ文字列とフラグメントを除いて判定します。生成ページや生成アセットを提供するプラグインは、Page Type、生成出力、アセット登録の既存の仕組みを使ってください。登録されていれば、整合性検査でも有効な公開先として扱われます。
+
+`runDiagnostics()` と単体 CLI は、完全な manifest を持たないため、従来の content source 解析を使います。そのため `orphan-note` と `unused-asset` は `runDiagnostics()` と単体 CLI でのみ報告されます。ビルド時はリンク関係を manifest から解決するため、これらは出力しません。
+
 ## 設定項目
 
 | 項目 | 既定値 | 説明 |
@@ -100,4 +115,5 @@ assertNoErrors(report);
 
 ## 関連資料
 
-- [プラグインシステム](../../../docs/ja/reference/plugin-api.md)
+- [プラグインシステム](../../../docs/ja/docs/reference/plugin-api.md)
+

package/dist/bin.js

@@ -258,6 +258,7 @@ async function scanVault(config) {
       const note = {
         relativePath: relative,
         slug,
+        language: resolveNoteLanguage(relative, config.languages),
         markdown,
         fm,
         headings: extractHeadings(markdown),
@@ -416,6 +417,12 @@ function fragmentExists(note, fragment) {
 function normalizeMarkdown(markdown) {
   return markdown.replace(/\r\n/g, "\n");
 }
+function resolveNoteLanguage(relativePath, languages) {
+  if (!languages || languages.length === 0) return void 0;
+  const segment = relativePath.split("/")[0]?.toLowerCase();
+  if (!segment) return void 0;
+  return languages.find((language) => language.toLowerCase() === segment);
+}
 function getExtension(filePath) {
   const lastSegment = filePath.split("/").pop() ?? filePath;
   const dotIndex = lastSegment.lastIndexOf(".");
@@ -444,17 +451,7 @@ function normalizeRelativePath(parts) {
 function checkFrontmatter(note, source, state, options, diagnostics) {
   const location = { slug: note.slug, filePath: note.relativePath };
   const values = note.fm.values;
-  if (!note.fm.hasFrontmatter) {
-    pushDiagnostic(
-      diagnostics,
-      options,
-      location,
-      "missing-frontmatter",
-      "note has no frontmatter",
-      note.slug,
-      "add frontmatter with the required fields"
-    );
-  } else {
+  if (note.fm.hasFrontmatter) {
     for (const field of options.requiredFrontmatter) {
       if (!hasField(values, field))
         pushDiagnostic(
@@ -467,6 +464,16 @@ function checkFrontmatter(note, source, state, options, diagnostics) {
           `add "${field}" to the frontmatter`
         );
     }
+  } else if (options.requiredFrontmatter.length > 0) {
+    pushDiagnostic(
+      diagnostics,
+      options,
+      location,
+      "missing-frontmatter",
+      "note has no frontmatter",
+      note.slug,
+      "add frontmatter with the required fields"
+    );
   }
   if (values.publish === true && values.draft === true)
     pushDiagnostic(
@@ -629,10 +636,11 @@ function checkSlugCollisions(source, options, diagnostics) {
 function checkDuplicateTitles(source, options, diagnostics) {
   const byTitle = groupNotes(
     source.includedNotes.filter((note) => note.published),
-    (note) => getNoteTitle(note.fm.values, note.slug).toLowerCase()
+    (note) => `${note.language ?? ""}\0${getNoteTitle(note.fm.values, note.slug).toLowerCase()}`
   );
-  for (const [title, notes] of byTitle) {
+  for (const [groupKey, notes] of byTitle) {
     if (notes.length < 2) continue;
+    const title = groupKey.slice(groupKey.indexOf("\0") + 1);
     const slugs = notes.map((note) => note.slug).join(", ");
     for (const note of notes)
       pushDiagnostic(
@@ -818,23 +826,28 @@ async function analyzeContent(config, options = {}) {
   const state = createAnalysisState();
   const diagnostics = [];
   for (const note of source.includedNotes) {
-    checkWikilinks(note, source, state, normalizedOptions, diagnostics);
-    checkMarkdownReferences(
-      note,
-      source,
-      state,
-      normalizedOptions,
-      diagnostics
-    );
+    if (!options.skipReferenceIntegrity) {
+      checkWikilinks(note, source, state, normalizedOptions, diagnostics);
+      checkMarkdownReferences(
+        note,
+        source,
+        state,
+        normalizedOptions,
+        diagnostics
+      );
+    }
     checkFrontmatter(note, source, state, normalizedOptions, diagnostics);
   }
   checkSlugCollisions(source, normalizedOptions, diagnostics);
   checkDuplicateTitles(source, normalizedOptions, diagnostics);
   checkContentIdIntegrity(source, normalizedOptions, diagnostics);
-  checkOrphans(source, state, normalizedOptions, diagnostics);
-  checkUnusedAssets(source, state, normalizedOptions, diagnostics);
+  if (!options.skipReferenceIntegrity) {
+    checkOrphans(source, state, normalizedOptions, diagnostics);
+    checkUnusedAssets(source, state, normalizedOptions, diagnostics);
+  }
   checkExcludedPublic(source, normalizedOptions, diagnostics);
-  checkPublishBoundary(source, normalizedOptions, diagnostics);
+  if (!options.skipReferenceIntegrity)
+    checkPublishBoundary(source, normalizedOptions, diagnostics);
   checkAnalyticsCoverage(source, normalizedOptions, diagnostics);
   return diagnostics;
 }
@@ -975,6 +988,7 @@ async function runDiagnostics(target, options = {}) {
   }
 }
 var ANALYTICS_PLUGIN_NAME = "analytics";
+var L10N_PLUGIN_NAME = "l10n";
 function hasEnabledAnalyticsPlugin(config) {
   return config?.plugins.some(
     (plugin) => plugin.name === ANALYTICS_PLUGIN_NAME && plugin.enabled !== false
@@ -1004,9 +1018,19 @@ function toAnalyzerConfig(target, options) {
       target.content.exclude
     ),
     exclude: [...target.content.exclude, ...options.exclude ?? []],
-    publishStrategy: target.content.filters.publishStrategy
+    publishStrategy: target.content.filters.publishStrategy,
+    languages: resolveLanguages(target)
   };
 }
+function resolveLanguages(config) {
+  const plugin = config.plugins.find(
+    (entry) => entry.name === L10N_PLUGIN_NAME && entry.enabled !== false
+  );
+  const languages = plugin?.options?.languages;
+  return Array.isArray(languages) ? languages.filter(
+    (language) => typeof language === "string"
+  ) : [];
+}
 
 // bin.ts
 var HELP = `riebeckite-diagnostics

package/dist/index.js

@@ -254,6 +254,7 @@ async function scanVault(config) {
       const note = {
         relativePath: relative,
         slug,
+        language: resolveNoteLanguage(relative, config.languages),
         markdown,
         fm,
         headings: extractHeadings(markdown),
@@ -412,6 +413,12 @@ function fragmentExists(note, fragment) {
 function normalizeMarkdown(markdown) {
   return markdown.replace(/\r\n/g, "\n");
 }
+function resolveNoteLanguage(relativePath, languages) {
+  if (!languages || languages.length === 0) return void 0;
+  const segment = relativePath.split("/")[0]?.toLowerCase();
+  if (!segment) return void 0;
+  return languages.find((language) => language.toLowerCase() === segment);
+}
 function getExtension(filePath) {
   const lastSegment = filePath.split("/").pop() ?? filePath;
   const dotIndex = lastSegment.lastIndexOf(".");
@@ -440,17 +447,7 @@ function normalizeRelativePath(parts) {
 function checkFrontmatter(note, source, state, options, diagnostics2) {
   const location = { slug: note.slug, filePath: note.relativePath };
   const values = note.fm.values;
-  if (!note.fm.hasFrontmatter) {
-    pushDiagnostic(
-      diagnostics2,
-      options,
-      location,
-      "missing-frontmatter",
-      "note has no frontmatter",
-      note.slug,
-      "add frontmatter with the required fields"
-    );
-  } else {
+  if (note.fm.hasFrontmatter) {
     for (const field of options.requiredFrontmatter) {
       if (!hasField(values, field))
         pushDiagnostic(
@@ -463,6 +460,16 @@ function checkFrontmatter(note, source, state, options, diagnostics2) {
           `add "${field}" to the frontmatter`
         );
     }
+  } else if (options.requiredFrontmatter.length > 0) {
+    pushDiagnostic(
+      diagnostics2,
+      options,
+      location,
+      "missing-frontmatter",
+      "note has no frontmatter",
+      note.slug,
+      "add frontmatter with the required fields"
+    );
   }
   if (values.publish === true && values.draft === true)
     pushDiagnostic(
@@ -625,10 +632,11 @@ function checkSlugCollisions(source, options, diagnostics2) {
 function checkDuplicateTitles(source, options, diagnostics2) {
   const byTitle = groupNotes(
     source.includedNotes.filter((note) => note.published),
-    (note) => getNoteTitle(note.fm.values, note.slug).toLowerCase()
+    (note) => `${note.language ?? ""}\0${getNoteTitle(note.fm.values, note.slug).toLowerCase()}`
   );
-  for (const [title, notes] of byTitle) {
+  for (const [groupKey, notes] of byTitle) {
     if (notes.length < 2) continue;
+    const title = groupKey.slice(groupKey.indexOf("\0") + 1);
     const slugs = notes.map((note) => note.slug).join(", ");
     for (const note of notes)
       pushDiagnostic(
@@ -814,23 +822,28 @@ async function analyzeContent(config, options = {}) {
   const state = createAnalysisState();
   const diagnostics2 = [];
   for (const note of source.includedNotes) {
-    checkWikilinks(note, source, state, normalizedOptions, diagnostics2);
-    checkMarkdownReferences(
-      note,
-      source,
-      state,
-      normalizedOptions,
-      diagnostics2
-    );
+    if (!options.skipReferenceIntegrity) {
+      checkWikilinks(note, source, state, normalizedOptions, diagnostics2);
+      checkMarkdownReferences(
+        note,
+        source,
+        state,
+        normalizedOptions,
+        diagnostics2
+      );
+    }
     checkFrontmatter(note, source, state, normalizedOptions, diagnostics2);
   }
   checkSlugCollisions(source, normalizedOptions, diagnostics2);
   checkDuplicateTitles(source, normalizedOptions, diagnostics2);
   checkContentIdIntegrity(source, normalizedOptions, diagnostics2);
-  checkOrphans(source, state, normalizedOptions, diagnostics2);
-  checkUnusedAssets(source, state, normalizedOptions, diagnostics2);
+  if (!options.skipReferenceIntegrity) {
+    checkOrphans(source, state, normalizedOptions, diagnostics2);
+    checkUnusedAssets(source, state, normalizedOptions, diagnostics2);
+  }
   checkExcludedPublic(source, normalizedOptions, diagnostics2);
-  checkPublishBoundary(source, normalizedOptions, diagnostics2);
+  if (!options.skipReferenceIntegrity)
+    checkPublishBoundary(source, normalizedOptions, diagnostics2);
   checkAnalyticsCoverage(source, normalizedOptions, diagnostics2);
   return diagnostics2;
 }
@@ -855,16 +868,16 @@ function buildReport(diagnostics2) {
   const errors = [];
   const warnings = [];
   const infos = [];
-  for (const diagnostic of diagnostics2) {
-    switch (diagnostic.severity) {
+  for (const diagnostic2 of diagnostics2) {
+    switch (diagnostic2.severity) {
       case "error":
-        errors.push(diagnostic);
+        errors.push(diagnostic2);
         break;
       case "warning":
-        warnings.push(diagnostic);
+        warnings.push(diagnostic2);
         break;
       default:
-        infos.push(diagnostic);
+        infos.push(diagnostic2);
         break;
     }
   }
@@ -883,8 +896,8 @@ function summarize(diagnostics2) {
   let error = 0;
   let warning = 0;
   let info = 0;
-  for (const diagnostic of diagnostics2) {
-    switch (diagnostic.severity) {
+  for (const diagnostic2 of diagnostics2) {
+    switch (diagnostic2.severity) {
       case "error":
         error++;
         break;
@@ -900,10 +913,10 @@ function summarize(diagnostics2) {
 }
 function groupByCode(diagnostics2) {
   const byCode = /* @__PURE__ */ new Map();
-  for (const diagnostic of diagnostics2) {
-    const group = byCode.get(diagnostic.code) ?? [];
-    group.push(diagnostic);
-    byCode.set(diagnostic.code, group);
+  for (const diagnostic2 of diagnostics2) {
+    const group = byCode.get(diagnostic2.code) ?? [];
+    group.push(diagnostic2);
+    byCode.set(diagnostic2.code, group);
   }
   return byCode;
 }
@@ -922,23 +935,23 @@ function formatDiagnostics(input, options = {}) {
   );
   lines.push("");
   const ordered = [...report.diagnostics].sort(compareDiagnostics);
-  for (const diagnostic of ordered) {
+  for (const diagnostic2 of ordered) {
     const icon = {
       error: `${color.error}✖`,
       warning: `${color.yellow}⚠`,
       info: `${color.cyan}ℹ`
-    }[diagnostic.severity];
+    }[diagnostic2.severity];
     const location = [
-      diagnostic.filePath ?? "",
-      diagnostic.line != null ? `:${diagnostic.line}${diagnostic.column != null ? `:${diagnostic.column}` : ""}` : ""
+      diagnostic2.filePath ?? "",
+      diagnostic2.line != null ? `:${diagnostic2.line}${diagnostic2.column != null ? `:${diagnostic2.column}` : ""}` : ""
     ].join("");
-    lines.push(`${icon} ${color.reset}[${diagnostic.code}] ${location}`);
-    lines.push(`    ${diagnostic.message}`);
-    if (diagnostic.target) {
-      lines.push(`    ${color.dim}target: ${diagnostic.target}${color.reset}`);
+    lines.push(`${icon} ${color.reset}[${diagnostic2.code}] ${location}`);
+    lines.push(`    ${diagnostic2.message}`);
+    if (diagnostic2.target) {
+      lines.push(`    ${color.dim}target: ${diagnostic2.target}${color.reset}`);
     }
-    if (diagnostic.suggestion) {
-      lines.push(`    ${color.cyan}→ ${diagnostic.suggestion}${color.reset}`);
+    if (diagnostic2.suggestion) {
+      lines.push(`    ${color.cyan}→ ${diagnostic2.suggestion}${color.reset}`);
     }
   }
   return lines.join("\n");
@@ -973,8 +986,351 @@ var noColors = {
   cyan: ""
 };
 
-// index.ts
+// src/site_integrity.ts
 var PLUGIN_NAME2 = "diagnostics";
+var DEFAULT_SEVERITY2 = {
+  "content-integrity:broken-link": "warning",
+  "content-integrity:unresolved-wikilink": "warning",
+  "content-integrity:broken-asset": "warning",
+  "content-integrity:duplicate-public-location": "error",
+  "content-integrity:redirect-target-missing": "warning",
+  "content-integrity:redirect-cycle": "error",
+  "content-integrity:redirect-public-location-conflict": "error",
+  "content-integrity:ambiguous-folder-page-owner": "warning"
+};
+function checkSiteIntegrity(manifest, options = {}) {
+  const diagnostics2 = [];
+  const publicSlugs = new Set(
+    manifest.publicEntries.map((entry) => entry.slug)
+  );
+  const routeOwners = buildRouteOwners(manifest, diagnostics2, options);
+  const publicRoutes = new Set(routeOwners.keys());
+  const assetPaths = buildAssetPaths(manifest);
+  for (const entry of manifest.publicEntries) {
+    checkResolvedLinks(entry, publicSlugs, assetPaths, diagnostics2, options);
+    checkHtmlReferences(entry, publicRoutes, assetPaths, diagnostics2, options);
+  }
+  checkRedirectTargets(manifest, publicRoutes, diagnostics2, options);
+  checkRedirectCycles(manifest, diagnostics2, options);
+  checkAmbiguousFolderPageOwners(manifest, diagnostics2, options);
+  return diagnostics2;
+}
+function buildRouteOwners(manifest, diagnostics2, options) {
+  const owners = /* @__PURE__ */ new Map();
+  for (const entry of manifest.publicEntries) {
+    reserveRoute(owners, diagnostics2, options, {
+      path: normalizeRoutePath(entry.publicLocation.permalink),
+      slug: entry.slug,
+      kind: "content"
+    });
+  }
+  for (const [path, redirect] of manifest.publicRedirects) {
+    reserveRoute(owners, diagnostics2, options, {
+      path: normalizeRoutePath(path),
+      slug: redirect.slug,
+      kind: "redirect"
+    });
+  }
+  const pageRoutes = manifest.pageRoutes ?? [];
+  for (const route of pageRoutes) {
+    reserveRoute(owners, diagnostics2, options, {
+      path: normalizeRoutePath(route.pathname),
+      slug: `(plugin-page:${route.pluginName}:${route.pageType})`,
+      kind: "page",
+      producer: `${route.pluginName}:${route.pageType}`
+    });
+  }
+  if (pageRoutes.length === 0) {
+    for (const path of manifest.pagePaths ?? []) {
+      reserveRoute(owners, diagnostics2, options, {
+        path: normalizeRoutePath(path),
+        slug: "(plugin-page)",
+        kind: "page"
+      });
+    }
+  }
+  for (const output of manifest.generatedOutputs ?? []) {
+    reserveRoute(owners, diagnostics2, options, {
+      path: normalizeRoutePath(output.path),
+      slug: "(generated-output)",
+      kind: "output"
+    });
+  }
+  return owners;
+}
+function reserveRoute(owners, diagnostics2, options, next) {
+  const previous = owners.get(next.path);
+  if (!previous) {
+    owners.set(next.path, next);
+    return;
+  }
+  if (previous.slug === next.slug && previous.kind === next.kind) return;
+  const code = previous.kind === "redirect" || next.kind === "redirect" ? "content-integrity:redirect-public-location-conflict" : "content-integrity:duplicate-public-location";
+  diagnostics2.push(
+    diagnostic(options, {
+      code,
+      slug: next.slug.startsWith("(") ? void 0 : next.slug,
+      target: next.path,
+      message: `Public path "${next.path}" is claimed by both ${describeOwner(previous)} and ${describeOwner(next)}.`,
+      suggestion: "Change one permalink, alias, redirect, page path, or generated output path.",
+      meta: { previous, next }
+    })
+  );
+}
+function checkResolvedLinks(entry, publicSlugs, assetPaths, diagnostics2, options) {
+  for (const link of entry.links) {
+    if (link.kind === "unresolved") {
+      diagnostics2.push(
+        diagnostic(options, {
+          code: "content-integrity:unresolved-wikilink",
+          slug: entry.slug,
+          filePath: `${entry.slug}.md`,
+          target: link.raw,
+          message: `WikiLink target "${link.raw}" could not be resolved.`,
+          suggestion: "Create the target note/asset or update the WikiLink target.",
+          meta: { raw: link.raw, embed: link.embed }
+        })
+      );
+      continue;
+    }
+    if (link.kind === "note" && link.slug && !publicSlugs.has(link.slug)) {
+      diagnostics2.push(
+        diagnostic(options, {
+          code: "content-integrity:broken-link",
+          slug: entry.slug,
+          filePath: `${entry.slug}.md`,
+          target: link.slug,
+          message: `Content link "${link.raw}" resolves to unpublished content "${link.slug}".`,
+          suggestion: "Publish the target content or remove the reference from published content.",
+          meta: {
+            raw: link.raw,
+            resolvedSlug: link.slug,
+            reason: "unpublished-target"
+          }
+        })
+      );
+    }
+    if ((link.kind === "image" || link.kind === "attachment") && link.slug && !assetPaths.has(link.slug)) {
+      diagnostics2.push(
+        diagnostic(options, {
+          code: "content-integrity:broken-asset",
+          slug: entry.slug,
+          filePath: `${entry.slug}.md`,
+          target: link.slug,
+          message: `Asset reference "${link.raw}" resolves to "${link.slug}", but no asset is published for that path.`,
+          suggestion: "Add the asset, fix the reference, or register the generated asset from a plugin.",
+          meta: { raw: link.raw, resolvedPath: link.slug }
+        })
+      );
+    }
+  }
+}
+function checkHtmlReferences(entry, publicRoutes, assetPaths, diagnostics2, options) {
+  for (const href of extractAttributes(entry.html, "href")) {
+    if (!isSiteLocalReference(href)) continue;
+    const path = normalizeReferencePath(href, entry.publicLocation.permalink);
+    if (!path || publicRoutes.has(path)) continue;
+    diagnostics2.push(
+      diagnostic(options, {
+        code: "content-integrity:broken-link",
+        slug: entry.slug,
+        filePath: entry.publicLocation.permalink,
+        target: href,
+        message: `Internal link target "${href}" does not match a public route.`,
+        suggestion: "Update the link, create the target content, or register the generated route from a plugin.",
+        meta: { normalizedTarget: path }
+      })
+    );
+  }
+  for (const src of extractAttributes(entry.html, "src")) {
+    if (!isSiteLocalReference(src)) continue;
+    const path = normalizeReferencePath(src, entry.publicLocation.permalink);
+    const assetPath = path?.replace(/^\/+/, "");
+    if (!path || publicRoutes.has(path) || assetPath && assetPaths.has(assetPath))
+      continue;
+    diagnostics2.push(
+      diagnostic(options, {
+        code: "content-integrity:broken-asset",
+        slug: entry.slug,
+        filePath: entry.publicLocation.permalink,
+        target: src,
+        message: `Local asset target "${src}" does not match a published asset or route.`,
+        suggestion: "Add the asset, fix the reference, or register the generated asset from a plugin.",
+        meta: { normalizedTarget: path }
+      })
+    );
+  }
+}
+function checkRedirectTargets(manifest, publicRoutes, diagnostics2, options) {
+  for (const [path, redirect] of manifest.publicRedirects) {
+    const owner = manifest.bySlug.get(redirect.slug);
+    const target = owner ? normalizeRoutePath(owner.publicLocation.permalink) : null;
+    if (target && publicRoutes.has(target)) continue;
+    diagnostics2.push(
+      diagnostic(options, {
+        code: "content-integrity:redirect-target-missing",
+        slug: redirect.slug,
+        target: path,
+        message: `Redirect "${path}" points to content "${redirect.slug}", but its public target is not available.`,
+        suggestion: "Publish the target content or remove the redirect.",
+        meta: { redirect: path, targetSlug: redirect.slug, target }
+      })
+    );
+  }
+}
+function checkRedirectCycles(manifest, diagnostics2, options) {
+  const redirectTargets = /* @__PURE__ */ new Map();
+  const reportedCycles = /* @__PURE__ */ new Set();
+  for (const [path, redirect] of manifest.publicRedirects) {
+    const owner = manifest.bySlug.get(redirect.slug);
+    if (owner)
+      redirectTargets.set(
+        normalizeRoutePath(path),
+        normalizeRoutePath(owner.publicLocation.permalink)
+      );
+  }
+  for (const start of redirectTargets.keys()) {
+    const seen = /* @__PURE__ */ new Map();
+    const chain = [];
+    let current = start;
+    while (current) {
+      const previousIndex = seen.get(current);
+      if (previousIndex !== void 0) {
+        const cycle = [...chain.slice(previousIndex), current];
+        const key = canonicalCycleKey(cycle);
+        if (reportedCycles.has(key)) break;
+        reportedCycles.add(key);
+        diagnostics2.push(
+          diagnostic(options, {
+            code: "content-integrity:redirect-cycle",
+            target: cycle.join(" -> "),
+            message: `Redirect cycle detected: ${cycle.join(" -> ")}.`,
+            suggestion: "Remove or retarget one redirect in the cycle.",
+            meta: { cycle }
+          })
+        );
+        break;
+      }
+      seen.set(current, chain.length);
+      chain.push(current);
+      current = redirectTargets.get(current);
+    }
+  }
+}
+function buildAssetPaths(manifest) {
+  const paths = /* @__PURE__ */ new Set();
+  for (const entry of manifest.entries) {
+    for (const asset of entry.assets) paths.add(asset.path);
+  }
+  for (const asset of manifest.assets ?? [])
+    paths.add(asset.path.replace(/^\/+/, ""));
+  for (const output of manifest.generatedOutputs ?? [])
+    paths.add(output.path.replace(/^\/+/, ""));
+  return paths;
+}
+function extractAttributes(html, attribute) {
+  const pattern = new RegExp(
+    `${attribute}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+))`,
+    "gi"
+  );
+  const values = [];
+  for (let match = pattern.exec(html); match; match = pattern.exec(html)) {
+    const value = match[1] ?? match[2] ?? match[3];
+    if (value) values.push(value);
+  }
+  return values;
+}
+function isSiteLocalReference(value) {
+  if (!value || value.startsWith("#") || value.startsWith("//")) return false;
+  if (/^[a-z][a-z0-9+.-]*:/i.test(value)) return false;
+  return true;
+}
+function normalizeReferencePath(value, basePath) {
+  const path = value.split(/[?#]/)[0] ?? "";
+  if (!path || path === "/") return path || null;
+  try {
+    return normalizeRoutePath(resolveReferencePath(decodeURI(path), basePath));
+  } catch {
+    return null;
+  }
+}
+function resolveReferencePath(path, basePath) {
+  if (path.startsWith("/")) return path;
+  const baseSegments = basePath.split("/").filter(Boolean);
+  if (!basePath.endsWith("/")) baseSegments.pop();
+  const segments = [...baseSegments, ...path.split("/")];
+  const normalized = [];
+  for (const segment of segments) {
+    if (!segment || segment === ".") continue;
+    if (segment === "..") {
+      normalized.pop();
+      continue;
+    }
+    normalized.push(segment);
+  }
+  return `/${normalized.join("/")}`;
+}
+function normalizeRoutePath(value) {
+  const path = `/${value.split(/[?#]/)[0]?.split("/").filter(Boolean).join("/") ?? ""}`;
+  return path === "/" ? path : path.replace(/\/$/, "");
+}
+function describeOwner(owner) {
+  return `${owner.kind} "${owner.producer ?? owner.slug}"`;
+}
+function checkAmbiguousFolderPageOwners(manifest, diagnostics2, options) {
+  const candidates = /* @__PURE__ */ new Map();
+  for (const entry of manifest.entries) {
+    const basename = entry.slug.split("/").at(-1);
+    if (basename !== "README" && basename !== "index") continue;
+    const folder = entry.slug.split("/").slice(0, -1).join("/");
+    if (!folder) continue;
+    const folderCandidates = candidates.get(folder) ?? {};
+    folderCandidates[basename] = entry;
+    candidates.set(folder, folderCandidates);
+  }
+  for (const [folder, entries] of candidates) {
+    const readme = entries.README;
+    const index = entries.index;
+    if (!readme || !index) continue;
+    diagnostics2.push(
+      diagnostic(options, {
+        code: "content-integrity:ambiguous-folder-page-owner",
+        target: folder,
+        message: `Folder "${folder}" has both README and index Folder Page candidates.`,
+        suggestion: "Keep either README or index so the Folder Page owner is unambiguous.",
+        meta: {
+          folder,
+          readme: {
+            slug: readme.slug,
+            permalink: readme.publicLocation.permalink
+          },
+          index: {
+            slug: index.slug,
+            permalink: index.publicLocation.permalink
+          }
+        }
+      })
+    );
+  }
+}
+function canonicalCycleKey(cycle) {
+  const closed = cycle.at(0) === cycle.at(-1) ? cycle.slice(0, -1) : [...cycle];
+  const rotations = closed.map((_, index) => [
+    ...closed.slice(index),
+    ...closed.slice(0, index)
+  ]);
+  return rotations.map((rotation) => rotation.join("\0")).sort()[0] ?? "";
+}
+function diagnostic(options, input) {
+  return {
+    pluginName: PLUGIN_NAME2,
+    severity: options.severity?.[input.code] ?? input.severity ?? DEFAULT_SEVERITY2[input.code] ?? "warning",
+    ...input
+  };
+}
+
+// index.ts
+var PLUGIN_NAME3 = "diagnostics";
 async function runDiagnostics(target, options = {}) {
   const config = toAnalyzerConfig(target, options);
   try {
@@ -985,24 +1341,27 @@ async function runDiagnostics(target, options = {}) {
 }
 function diagnostics(options = {}) {
   return definePlugin({
-    name: PLUGIN_NAME2,
+    name: PLUGIN_NAME3,
     options,
     addDiagnostics: async (context) => {
       const config = context.config;
       if (!config) return [];
       try {
-        return await analyzeContent(
-          toAnalyzerConfig(config, options),
-          analyticsCoverageOptions(config, options)
-        );
+        return await analyzeContent(toAnalyzerConfig(config, options), {
+          ...analyticsCoverageOptions(config, options),
+          skipReferenceIntegrity: true
+        });
       } catch (error) {
         return [createInternalError(error)];
       }
     },
+    onManifestCreated: ({ manifest, diagnostics: diagnostics2 }) => {
+      diagnostics2.push(...checkSiteIntegrity(manifest, options));
+    },
     onBuildEnd: ({ manifest }) => {
       if (!options.failOnError) return void 0;
       const errors = manifest.diagnostics.filter(
-        (diagnostic) => diagnostic.pluginName === PLUGIN_NAME2 && diagnostic.severity === "error"
+        (diagnostic2) => diagnostic2.pluginName === PLUGIN_NAME3 && diagnostic2.severity === "error"
       );
       if (errors.length > 0) {
         throw new DiagnosticsFailure(buildReport(errors));
@@ -1013,6 +1372,7 @@ function diagnostics(options = {}) {
 }
 var diagnosticsPlugin = diagnostics;
 var ANALYTICS_PLUGIN_NAME = "analytics";
+var L10N_PLUGIN_NAME = "l10n";
 function hasEnabledAnalyticsPlugin(config) {
   return config?.plugins.some(
     (plugin) => plugin.name === ANALYTICS_PLUGIN_NAME && plugin.enabled !== false
@@ -1027,7 +1387,7 @@ function analyticsCoverageOptions(config, options) {
 function createInternalError(error) {
   const message = error instanceof Error ? error.message : String(error);
   return {
-    pluginName: PLUGIN_NAME2,
+    pluginName: PLUGIN_NAME3,
     code: "internal-error",
     severity: "error",
     message: `content analysis failed: ${message}`
@@ -1048,9 +1408,19 @@ function toAnalyzerConfig(target, options) {
       target.content.exclude
     ),
     exclude: [...target.content.exclude, ...options.exclude ?? []],
-    publishStrategy: target.content.filters.publishStrategy
+    publishStrategy: target.content.filters.publishStrategy,
+    languages: resolveLanguages(target)
   };
 }
+function resolveLanguages(config) {
+  const plugin = config.plugins.find(
+    (entry) => entry.name === L10N_PLUGIN_NAME && entry.enabled !== false
+  );
+  const languages = plugin?.options?.languages;
+  return Array.isArray(languages) ? languages.filter(
+    (language) => typeof language === "string"
+  ) : [];
+}
 export {
   DiagnosticsFailure,
   analyzeContent,

package/dist/src/site_integrity.d.ts

@@ -0,0 +1,5 @@
+import type { ContentManifest, Diagnostic, DiagnosticCode, DiagnosticSeverity } from "@riebeckite/core";
+export type SiteIntegrityOptions = {
+    readonly severity?: Partial<Record<DiagnosticCode, DiagnosticSeverity>>;
+};
+export declare function checkSiteIntegrity(manifest: ContentManifest, options?: SiteIntegrityOptions): Diagnostic[];

package/dist/src/types.d.ts

@@ -8,6 +8,7 @@ export type DiagnosticsOptions = {
     severity?: Partial<Record<DiagnosticCode, DiagnosticSeverity>>;
     exclude?: string[];
     publishStrategy?: "explicit" | "selective";
+    skipReferenceIntegrity?: boolean;
 };
 export type DiagnosticsSummary = {
     total: number;
@@ -30,4 +31,5 @@ export type AnalyzerContentConfig = {
     source?: ContentSource;
     exclude: string[];
     publishStrategy: "explicit" | "selective";
+    languages?: readonly string[];
 };

package/dist/src/vault.d.ts

@@ -3,6 +3,7 @@ import type { AnalyzerContentConfig } from "./types.js";
 export type ScannedNote = {
     relativePath: string;
     slug: string;
+    language?: string;
     markdown: string;
     fm: ParsedFrontmatter;
     headings: Set<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-diagnostics",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,7 +20,7 @@
     "remark-parse": "^11.0.0",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.1.0",
-    "@riebeckite/core": "0.0.13"
+    "@riebeckite/core": "0.0.15"
   },
   "devDependencies": {
     "@types/mdast": "^4.0.4",