@riebeckite/plugin-diagnostics 0.0.3 → 0.0.6

package/README.md

@@ -48,8 +48,11 @@ export default defineConfig({
 | `publish-conflict` | `warning` | `publish: true` combined with `draft: true` / `private: true` |
 | `duplicate-title` | `warning` | Multiple published notes share a title |
 | `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) |
 | `internal-error` | `error` | Content analysis failed |
 
 ## Options
@@ -59,6 +62,7 @@ export default defineConfig({
 | `failOnError` | `boolean` | `false` | Fail the build on error-level diagnostics |
 | `reportUnusedAssets` | `boolean` | `false` | Report unreferenced images |
 | `reportOrphans` | `boolean` | `false` | Report published notes without incoming links |
+| `reportAnalyticsCoverage` | `boolean` | `false` | Report published notes the analytics plugin will not track (auto-enabled when the resolved config enables the analytics plugin) |
 | `requiredFrontmatter` | `string[]` | `[]` | Required frontmatter fields |
 | `severity` | `Partial<Record<DiagnosticCode, DiagnosticSeverity>>` | table above | Override severity per code |
 | `exclude` | `string[]` | `[]` | Extra exclude globs |
@@ -79,6 +83,7 @@ riebeckite-diagnostics --content ./content --report-orphans
 | `--publish-strategy <mode>` | `explicit` \| `selective` (default: `selective`) |
 | `--report-unused-assets` | Report images never referenced by any note |
 | `--report-orphans` | Report published notes with no incoming links |
+| `--report-analytics-coverage` | Report published notes without a stable content ID (auto-enabled for `--config` when the config enables the analytics plugin) |
 | `--required-frontmatter <f>` | Comma-separated required frontmatter fields |
 | `--fail-on-error` | Exit with code 1 when errors are found (default) |
 | `--exit-on <severity>` | Exit with code 1 at/above severity (`info` \| `warning` \| `error`) |
@@ -115,6 +120,7 @@ assertNoErrors(report);
 - `diagnostics(options?)` / `diagnosticsPlugin` — plugin factory
 - `runDiagnostics(target, options?)` — run the analysis directly
 - `analyzeContent(config, options?)` — raw analysis returning `Diagnostic[]`
+- `hasEnabledAnalyticsPlugin(config?)` — whether the resolved config enables the analytics plugin
 - Report helpers: `buildReport`, `formatDiagnostics`, `groupByCode`,
   `summarize`, `assertNoErrors`, `DiagnosticsFailure`
 - Types: `DiagnosticsOptions`, `DiagnosticsReport`, `DiagnosticsSummary`,
@@ -123,4 +129,4 @@ assertNoErrors(report);
 
 ## See also
 
-- [Plugin guide](../../docs/plugins_en.md)
+- [Plugin guide](../../../docs/en/plugin-system.md)

package/README_ja.md

@@ -37,8 +37,11 @@ export default defineConfig({
 | `publish-conflict` | warning | `publish: true` と `draft: true` または `private: true` が同居している |
 | `duplicate-title` | warning | 公開ノート同士でタイトルが重複している |
 | `slug-collision` | error | 大文字・小文字を区別しない slug が衝突している |
+| `duplicate-content-id` | error | 公開ノート同士で安定コンテンツ ID（`id`/`uid`）が重複している |
+| `invalid-content-id` | error | `id`/`uid` の frontmatter が安定コンテンツ ID の契約を満たしていない |
 | `excluded-public` | warning | 除外されたノートに `publish: true` が指定されている |
 | `publish-boundary` | warning | 公開コンテンツから非公開コンテンツへリンク・埋め込みしている |
+| `analytics-untracked` | info | 安定 `id` のない公開ノートは analytics プラグインで計測されない（`reportAnalyticsCoverage` で有効化。設定で analytics プラグインが有効な場合は自動で有効化） |
 | `internal-error` | error | コンテンツ解析中に処理できないエラーが発生した |
 
 未使用アセットと孤立ノートは、明示的に有効化した場合だけ確認します。意図的に孤立させるトップページなどがあるなら、`reportOrphans` の結果を公開方針と照らして判断してください。
@@ -50,6 +53,7 @@ export default defineConfig({
 | `failOnError` | `false` | error レベルの診断があればビルドを失敗させる |
 | `reportUnusedAssets` | `false` | 未参照画像を報告する |
 | `reportOrphans` | `false` | 孤立した公開ノートを報告する |
+| `reportAnalyticsCoverage` | `false` | analytics プラグインで計測されない公開ノートを報告する（解決済み設定で analytics プラグインが有効なら自動で有効化） |
 | `requiredFrontmatter` | `[]` | 必須にする frontmatter フィールド |
 | `severity` | コードごとの既定値 | 診断コード別の重要度を上書きする |
 | `exclude` | `[]` | 解析対象から追加で除外する glob |
@@ -89,6 +93,7 @@ assertNoErrors(report);
 - `diagnostics(options?)` / `diagnosticsPlugin`: プラグインを作成する
 - `runDiagnostics(target, options?)`: 診断と集計を実行する
 - `analyzeContent(config, options?)`: 生の `Diagnostic[]` を取得する
+- `hasEnabledAnalyticsPlugin(config?)`: 解決済み設定で analytics プラグインが有効かを判定する
 - `formatDiagnostics`、`summarize`、`groupByCode`、`assertNoErrors`: レポート処理用の補助関数
 - `DiagnosticsFailure`: `failOnError` または `assertNoErrors` が送出するエラー
 - `riebeckite-diagnostics`: CLI

package/dist/bin.js

@@ -5,6 +5,73 @@ import { resolveConfigModule } from "@riebeckite/core";
 // index.ts
 import { definePlugin, FileSystemContentSource as FileSystemContentSource2 } from "@riebeckite/core";
 
+// src/frontmatter.ts
+function parseFrontmatter(markdown) {
+  const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match?.[1]) return { hasFrontmatter: false, values: {} };
+  return { hasFrontmatter: true, values: parseFrontmatterBlock(match[1]) };
+}
+function hasField(values, field) {
+  if (!(field in values)) return false;
+  const value = values[field];
+  if (value === null || value === void 0) return false;
+  if (Array.isArray(value)) return value.length > 0;
+  if (typeof value === "string") return value.trim() !== "";
+  return true;
+}
+function getNoteTitle(values, slug) {
+  const title = values.title;
+  return typeof title === "string" && title.trim() ? title : slug;
+}
+function parseFrontmatterBlock(body) {
+  const values = {};
+  const lines = body.split(/\r?\n/);
+  let openKey = null;
+  const pending = [];
+  const closeList = () => {
+    if (openKey !== null) {
+      values[openKey] = pending.length > 0 ? [...pending] : [];
+    }
+    openKey = null;
+    pending.length = 0;
+  };
+  for (const line of lines) {
+    const keyMatch = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (keyMatch) {
+      closeList();
+      const [, key, rest] = keyMatch;
+      const trimmed = rest.trim();
+      if (trimmed === "") {
+        openKey = key;
+      } else if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+        values[key] = trimmed.slice(1, -1).split(",").map((item) => stripQuotes(item.trim())).filter(Boolean);
+      } else {
+        values[key] = parseScalar(trimmed);
+      }
+      continue;
+    }
+    const itemMatch = line.match(/^\s*-\s+(.+)$/);
+    if (itemMatch) {
+      if (openKey !== null) {
+        pending.push(stripQuotes(itemMatch[1].trim()));
+      }
+      continue;
+    }
+    if (line.trim() === "") continue;
+    closeList();
+  }
+  closeList();
+  return values;
+}
+function parseScalar(value) {
+  if (/^true$/i.test(value)) return true;
+  if (/^false$/i.test(value)) return false;
+  return stripQuotes(value);
+}
+function stripQuotes(value) {
+  return value.trim().replace(/^['"]|['"]$/g, "");
+}
+
 // src/checks/shared.ts
 var PLUGIN_NAME = "diagnostics";
 var DEFAULT_SEVERITY = {
@@ -17,8 +84,11 @@ var DEFAULT_SEVERITY = {
   "publish-conflict": "warning",
   "duplicate-title": "warning",
   "slug-collision": "error",
+  "duplicate-content-id": "error",
+  "invalid-content-id": "error",
   "excluded-public": "warning",
   "publish-boundary": "warning",
+  "analytics-untracked": "info",
   "internal-error": "error"
 };
 function createAnalysisState() {
@@ -31,6 +101,7 @@ function normalizeOptions(options) {
   return {
     reportUnusedAssets: options.reportUnusedAssets ?? false,
     reportOrphans: options.reportOrphans ?? false,
+    reportAnalyticsCoverage: options.reportAnalyticsCoverage ?? false,
     requiredFrontmatter: options.requiredFrontmatter ?? [],
     severity: options.severity ?? {}
   };
@@ -55,6 +126,26 @@ function pushDiagnostic(diagnostics, options, location, code, message, target, s
   });
 }
 
+// src/checks/analytics.ts
+function checkAnalyticsCoverage(source, options, diagnostics) {
+  if (!options.reportAnalyticsCoverage) return;
+  for (const note of source.includedNotes) {
+    if (!note.published || hasAnalyticsId(note)) continue;
+    pushDiagnostic(
+      diagnostics,
+      options,
+      { slug: note.slug, filePath: note.relativePath },
+      "analytics-untracked",
+      "published content has no stable content ID and is not tracked by the analytics plugin",
+      note.slug,
+      'add "id" to the frontmatter'
+    );
+  }
+}
+function hasAnalyticsId(note) {
+  return hasField(note.fm.values, "id") || hasField(note.fm.values, "uid");
+}
+
 // src/checks/assets.ts
 function checkUnusedAssets(source, state, options, diagnostics) {
   if (!options.reportUnusedAssets) return;
@@ -72,6 +163,52 @@ function checkUnusedAssets(source, state, options, diagnostics) {
   }
 }
 
+// src/checks/content_identity.ts
+import { resolveContentStableId } from "@riebeckite/core";
+function checkContentIdIntegrity(source, options, diagnostics) {
+  const publishedById = /* @__PURE__ */ new Map();
+  for (const note of source.includedNotes) {
+    if (!note.published) continue;
+    let id;
+    try {
+      id = resolveContentStableId(note.fm.values);
+    } catch (error) {
+      pushDiagnostic(
+        diagnostics,
+        options,
+        { slug: note.slug, filePath: note.relativePath },
+        "invalid-content-id",
+        `invalid content id frontmatter: ${toErrorMessage(error)}`,
+        void 0,
+        'set a unique, trimmed "id" value and remove a conflicting "uid" value'
+      );
+      continue;
+    }
+    if (!id) continue;
+    const group = publishedById.get(id) ?? [];
+    group.push(note);
+    publishedById.set(id, group);
+  }
+  for (const [id, notes] of publishedById) {
+    if (notes.length < 2) continue;
+    const slugs = notes.map((note) => note.slug).join(", ");
+    for (const note of notes) {
+      pushDiagnostic(
+        diagnostics,
+        options,
+        { slug: note.slug, filePath: note.relativePath },
+        "duplicate-content-id",
+        `content id "${id}" is used by multiple published notes: ${slugs}`,
+        id,
+        'give each note a unique "id" (or "uid") frontmatter value'
+      );
+    }
+  }
+}
+function toErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
 // src/checks/excluded_public.ts
 function checkExcludedPublic(source, options, diagnostics) {
   for (const note of source.excludedNotes) {
@@ -88,73 +225,6 @@ function checkExcludedPublic(source, options, diagnostics) {
   }
 }
 
-// src/frontmatter.ts
-function parseFrontmatter(markdown) {
-  const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!match?.[1]) return { hasFrontmatter: false, values: {} };
-  return { hasFrontmatter: true, values: parseFrontmatterBlock(match[1]) };
-}
-function hasField(values, field) {
-  if (!(field in values)) return false;
-  const value = values[field];
-  if (value === null || value === void 0) return false;
-  if (Array.isArray(value)) return value.length > 0;
-  if (typeof value === "string") return value.trim() !== "";
-  return true;
-}
-function getNoteTitle(values, slug) {
-  const title = values.title;
-  return typeof title === "string" && title.trim() ? title : slug;
-}
-function parseFrontmatterBlock(body) {
-  const values = {};
-  const lines = body.split(/\r?\n/);
-  let openKey = null;
-  const pending = [];
-  const closeList = () => {
-    if (openKey !== null) {
-      values[openKey] = pending.length > 0 ? [...pending] : [];
-    }
-    openKey = null;
-    pending.length = 0;
-  };
-  for (const line of lines) {
-    const keyMatch = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
-    if (keyMatch) {
-      closeList();
-      const [, key, rest] = keyMatch;
-      const trimmed = rest.trim();
-      if (trimmed === "") {
-        openKey = key;
-      } else if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
-        values[key] = trimmed.slice(1, -1).split(",").map((item) => stripQuotes(item.trim())).filter(Boolean);
-      } else {
-        values[key] = parseScalar(trimmed);
-      }
-      continue;
-    }
-    const itemMatch = line.match(/^\s*-\s+(.+)$/);
-    if (itemMatch) {
-      if (openKey !== null) {
-        pending.push(stripQuotes(itemMatch[1].trim()));
-      }
-      continue;
-    }
-    if (line.trim() === "") continue;
-    closeList();
-  }
-  closeList();
-  return values;
-}
-function parseScalar(value) {
-  if (/^true$/i.test(value)) return true;
-  if (/^false$/i.test(value)) return false;
-  return stripQuotes(value);
-}
-function stripQuotes(value) {
-  return value.trim().replace(/^['"]|['"]$/g, "");
-}
-
 // src/vault.ts
 import {
   FileSystemContentSource,
@@ -642,7 +712,7 @@ function checkPublishBoundary(source, options, diagnostics) {
     const position = new LineMapper(note.markdown);
     for (const match of getWikilinkMatches(note.markdown)) {
       const resolved = resolveWikilinkTarget(match.target, source.targetIndex);
-      if (!resolved || resolved.kind !== "note") continue;
+      if (resolved?.kind !== "note") continue;
       const { line, column } = position.positionAt(match.index);
       reportBoundaryReference(
         source,
@@ -760,10 +830,12 @@ async function analyzeContent(config, options = {}) {
   }
   checkSlugCollisions(source, normalizedOptions, diagnostics);
   checkDuplicateTitles(source, normalizedOptions, diagnostics);
+  checkContentIdIntegrity(source, normalizedOptions, diagnostics);
   checkOrphans(source, state, normalizedOptions, diagnostics);
   checkUnusedAssets(source, state, normalizedOptions, diagnostics);
   checkExcludedPublic(source, normalizedOptions, diagnostics);
   checkPublishBoundary(source, normalizedOptions, diagnostics);
+  checkAnalyticsCoverage(source, normalizedOptions, diagnostics);
   return diagnostics;
 }
 
@@ -902,6 +974,12 @@ async function runDiagnostics(target, options = {}) {
     return buildReport([createInternalError(error)]);
   }
 }
+var ANALYTICS_PLUGIN_NAME = "analytics";
+function hasEnabledAnalyticsPlugin(config) {
+  return config?.plugins.some(
+    (plugin) => plugin.name === ANALYTICS_PLUGIN_NAME && plugin.enabled !== false
+  ) ?? false;
+}
 function createInternalError(error) {
   const message = error instanceof Error ? error.message : String(error);
   return {
@@ -936,7 +1014,8 @@ var HELP = `riebeckite-diagnostics
 Check an Obsidian vault / Riebeckite content directory for content problems:
 broken wikilinks, broken images, broken markdown links, unused assets,
 orphan notes, missing frontmatter, publish conflicts, duplicate titles,
-slug collisions, and excluded-but-public notes.
+slug collisions, duplicate or invalid content IDs, and excluded-but-public
+notes.
 
 Usage:
   riebeckite-diagnostics [options]
@@ -948,6 +1027,9 @@ Options:
   --publish-strategy <mode>   explicit | selective (default: selective)
   --report-unused-assets      Report images never referenced by any note
   --report-orphans            Report published notes with no incoming links
+  --report-analytics-coverage Report published notes without a stable content ID
+                              (auto-enabled when riebeckite.config.ts enables the
+                              analytics plugin)
   --required-frontmatter <f>  Comma-separated required frontmatter fields
   --fail-on-error             Exit with code 1 when errors are found (default)
   --exit-on <severity>        Exit with code 1 at/above severity (info|warning|error)
@@ -976,6 +1058,7 @@ async function main(argv) {
     ...config ? diagnosticsOptionsFromConfig(config) : {},
     ...args.explicit.has("reportUnusedAssets") ? { reportUnusedAssets: args.reportUnusedAssets } : {},
     ...args.explicit.has("reportOrphans") ? { reportOrphans: args.reportOrphans } : {},
+    ...args.explicit.has("reportAnalyticsCoverage") ? { reportAnalyticsCoverage: args.reportAnalyticsCoverage } : config ? { reportAnalyticsCoverage: hasEnabledAnalyticsPlugin(config) } : {},
     ...args.explicit.has("requiredFrontmatter") ? { requiredFrontmatter: args.requiredFrontmatter } : {},
     ...args.explicit.has("publishStrategy") ? { publishStrategy: args.publishStrategy ?? void 0 } : {},
     exclude: [
@@ -1081,6 +1164,7 @@ function parseArgs(argv) {
     requiredFrontmatter: [],
     reportUnusedAssets: false,
     reportOrphans: false,
+    reportAnalyticsCoverage: false,
     publishStrategy: null,
     explicit: /* @__PURE__ */ new Set()
   };
@@ -1105,6 +1189,10 @@ function parseArgs(argv) {
         args.reportOrphans = true;
         args.explicit.add("reportOrphans");
         break;
+      case "--report-analytics-coverage":
+        args.reportAnalyticsCoverage = true;
+        args.explicit.add("reportAnalyticsCoverage");
+        break;
       case "--format":
         args.format = (argv[++i] ?? "text") === "json" ? "json" : "text";
         break;

package/dist/index.d.ts

@@ -6,3 +6,8 @@ export type { AnalyzerContentConfig, DiagnosticsOptions, DiagnosticsReport, Diag
 export declare function runDiagnostics(target: ResolvedRiebeckiteConfig | string, options?: DiagnosticsOptions): Promise<DiagnosticsReport>;
 export declare function diagnostics(options?: DiagnosticsOptions): import("@riebeckite/core").RiebeckitePlugin<DiagnosticsOptions>;
 export declare const diagnosticsPlugin: typeof diagnostics;
+/**
+ * Reports whether the resolved configuration enables the analytics plugin, so
+ * the analytics coverage check turns itself on without coupling to the plugin.
+ */
+export declare function hasEnabledAnalyticsPlugin(config?: ResolvedRiebeckiteConfig): boolean;

package/dist/index.js

@@ -1,6 +1,73 @@
 // index.ts
 import { definePlugin, FileSystemContentSource as FileSystemContentSource2 } from "@riebeckite/core";
 
+// src/frontmatter.ts
+function parseFrontmatter(markdown) {
+  const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match?.[1]) return { hasFrontmatter: false, values: {} };
+  return { hasFrontmatter: true, values: parseFrontmatterBlock(match[1]) };
+}
+function hasField(values, field) {
+  if (!(field in values)) return false;
+  const value = values[field];
+  if (value === null || value === void 0) return false;
+  if (Array.isArray(value)) return value.length > 0;
+  if (typeof value === "string") return value.trim() !== "";
+  return true;
+}
+function getNoteTitle(values, slug) {
+  const title = values.title;
+  return typeof title === "string" && title.trim() ? title : slug;
+}
+function parseFrontmatterBlock(body) {
+  const values = {};
+  const lines = body.split(/\r?\n/);
+  let openKey = null;
+  const pending = [];
+  const closeList = () => {
+    if (openKey !== null) {
+      values[openKey] = pending.length > 0 ? [...pending] : [];
+    }
+    openKey = null;
+    pending.length = 0;
+  };
+  for (const line of lines) {
+    const keyMatch = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (keyMatch) {
+      closeList();
+      const [, key, rest] = keyMatch;
+      const trimmed = rest.trim();
+      if (trimmed === "") {
+        openKey = key;
+      } else if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+        values[key] = trimmed.slice(1, -1).split(",").map((item) => stripQuotes(item.trim())).filter(Boolean);
+      } else {
+        values[key] = parseScalar(trimmed);
+      }
+      continue;
+    }
+    const itemMatch = line.match(/^\s*-\s+(.+)$/);
+    if (itemMatch) {
+      if (openKey !== null) {
+        pending.push(stripQuotes(itemMatch[1].trim()));
+      }
+      continue;
+    }
+    if (line.trim() === "") continue;
+    closeList();
+  }
+  closeList();
+  return values;
+}
+function parseScalar(value) {
+  if (/^true$/i.test(value)) return true;
+  if (/^false$/i.test(value)) return false;
+  return stripQuotes(value);
+}
+function stripQuotes(value) {
+  return value.trim().replace(/^['"]|['"]$/g, "");
+}
+
 // src/checks/shared.ts
 var PLUGIN_NAME = "diagnostics";
 var DEFAULT_SEVERITY = {
@@ -13,8 +80,11 @@ var DEFAULT_SEVERITY = {
   "publish-conflict": "warning",
   "duplicate-title": "warning",
   "slug-collision": "error",
+  "duplicate-content-id": "error",
+  "invalid-content-id": "error",
   "excluded-public": "warning",
   "publish-boundary": "warning",
+  "analytics-untracked": "info",
   "internal-error": "error"
 };
 function createAnalysisState() {
@@ -27,6 +97,7 @@ function normalizeOptions(options) {
   return {
     reportUnusedAssets: options.reportUnusedAssets ?? false,
     reportOrphans: options.reportOrphans ?? false,
+    reportAnalyticsCoverage: options.reportAnalyticsCoverage ?? false,
     requiredFrontmatter: options.requiredFrontmatter ?? [],
     severity: options.severity ?? {}
   };
@@ -51,6 +122,26 @@ function pushDiagnostic(diagnostics2, options, location, code, message, target,
   });
 }
 
+// src/checks/analytics.ts
+function checkAnalyticsCoverage(source, options, diagnostics2) {
+  if (!options.reportAnalyticsCoverage) return;
+  for (const note of source.includedNotes) {
+    if (!note.published || hasAnalyticsId(note)) continue;
+    pushDiagnostic(
+      diagnostics2,
+      options,
+      { slug: note.slug, filePath: note.relativePath },
+      "analytics-untracked",
+      "published content has no stable content ID and is not tracked by the analytics plugin",
+      note.slug,
+      'add "id" to the frontmatter'
+    );
+  }
+}
+function hasAnalyticsId(note) {
+  return hasField(note.fm.values, "id") || hasField(note.fm.values, "uid");
+}
+
 // src/checks/assets.ts
 function checkUnusedAssets(source, state, options, diagnostics2) {
   if (!options.reportUnusedAssets) return;
@@ -68,6 +159,52 @@ function checkUnusedAssets(source, state, options, diagnostics2) {
   }
 }
 
+// src/checks/content_identity.ts
+import { resolveContentStableId } from "@riebeckite/core";
+function checkContentIdIntegrity(source, options, diagnostics2) {
+  const publishedById = /* @__PURE__ */ new Map();
+  for (const note of source.includedNotes) {
+    if (!note.published) continue;
+    let id;
+    try {
+      id = resolveContentStableId(note.fm.values);
+    } catch (error) {
+      pushDiagnostic(
+        diagnostics2,
+        options,
+        { slug: note.slug, filePath: note.relativePath },
+        "invalid-content-id",
+        `invalid content id frontmatter: ${toErrorMessage(error)}`,
+        void 0,
+        'set a unique, trimmed "id" value and remove a conflicting "uid" value'
+      );
+      continue;
+    }
+    if (!id) continue;
+    const group = publishedById.get(id) ?? [];
+    group.push(note);
+    publishedById.set(id, group);
+  }
+  for (const [id, notes] of publishedById) {
+    if (notes.length < 2) continue;
+    const slugs = notes.map((note) => note.slug).join(", ");
+    for (const note of notes) {
+      pushDiagnostic(
+        diagnostics2,
+        options,
+        { slug: note.slug, filePath: note.relativePath },
+        "duplicate-content-id",
+        `content id "${id}" is used by multiple published notes: ${slugs}`,
+        id,
+        'give each note a unique "id" (or "uid") frontmatter value'
+      );
+    }
+  }
+}
+function toErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
 // src/checks/excluded_public.ts
 function checkExcludedPublic(source, options, diagnostics2) {
   for (const note of source.excludedNotes) {
@@ -84,73 +221,6 @@ function checkExcludedPublic(source, options, diagnostics2) {
   }
 }
 
-// src/frontmatter.ts
-function parseFrontmatter(markdown) {
-  const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!match?.[1]) return { hasFrontmatter: false, values: {} };
-  return { hasFrontmatter: true, values: parseFrontmatterBlock(match[1]) };
-}
-function hasField(values, field) {
-  if (!(field in values)) return false;
-  const value = values[field];
-  if (value === null || value === void 0) return false;
-  if (Array.isArray(value)) return value.length > 0;
-  if (typeof value === "string") return value.trim() !== "";
-  return true;
-}
-function getNoteTitle(values, slug) {
-  const title = values.title;
-  return typeof title === "string" && title.trim() ? title : slug;
-}
-function parseFrontmatterBlock(body) {
-  const values = {};
-  const lines = body.split(/\r?\n/);
-  let openKey = null;
-  const pending = [];
-  const closeList = () => {
-    if (openKey !== null) {
-      values[openKey] = pending.length > 0 ? [...pending] : [];
-    }
-    openKey = null;
-    pending.length = 0;
-  };
-  for (const line of lines) {
-    const keyMatch = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
-    if (keyMatch) {
-      closeList();
-      const [, key, rest] = keyMatch;
-      const trimmed = rest.trim();
-      if (trimmed === "") {
-        openKey = key;
-      } else if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
-        values[key] = trimmed.slice(1, -1).split(",").map((item) => stripQuotes(item.trim())).filter(Boolean);
-      } else {
-        values[key] = parseScalar(trimmed);
-      }
-      continue;
-    }
-    const itemMatch = line.match(/^\s*-\s+(.+)$/);
-    if (itemMatch) {
-      if (openKey !== null) {
-        pending.push(stripQuotes(itemMatch[1].trim()));
-      }
-      continue;
-    }
-    if (line.trim() === "") continue;
-    closeList();
-  }
-  closeList();
-  return values;
-}
-function parseScalar(value) {
-  if (/^true$/i.test(value)) return true;
-  if (/^false$/i.test(value)) return false;
-  return stripQuotes(value);
-}
-function stripQuotes(value) {
-  return value.trim().replace(/^['"]|['"]$/g, "");
-}
-
 // src/vault.ts
 import {
   FileSystemContentSource,
@@ -638,7 +708,7 @@ function checkPublishBoundary(source, options, diagnostics2) {
     const position = new LineMapper(note.markdown);
     for (const match of getWikilinkMatches(note.markdown)) {
       const resolved = resolveWikilinkTarget(match.target, source.targetIndex);
-      if (!resolved || resolved.kind !== "note") continue;
+      if (resolved?.kind !== "note") continue;
       const { line, column } = position.positionAt(match.index);
       reportBoundaryReference(
         source,
@@ -756,10 +826,12 @@ async function analyzeContent(config, options = {}) {
   }
   checkSlugCollisions(source, normalizedOptions, diagnostics2);
   checkDuplicateTitles(source, normalizedOptions, diagnostics2);
+  checkContentIdIntegrity(source, normalizedOptions, diagnostics2);
   checkOrphans(source, state, normalizedOptions, diagnostics2);
   checkUnusedAssets(source, state, normalizedOptions, diagnostics2);
   checkExcludedPublic(source, normalizedOptions, diagnostics2);
   checkPublishBoundary(source, normalizedOptions, diagnostics2);
+  checkAnalyticsCoverage(source, normalizedOptions, diagnostics2);
   return diagnostics2;
 }
 
@@ -919,7 +991,10 @@ function diagnostics(options = {}) {
       const config = context.config;
       if (!config) return [];
       try {
-        return await analyzeContent(toAnalyzerConfig(config, options), options);
+        return await analyzeContent(
+          toAnalyzerConfig(config, options),
+          analyticsCoverageOptions(config, options)
+        );
       } catch (error) {
         return [createInternalError(error)];
       }
@@ -937,6 +1012,18 @@ function diagnostics(options = {}) {
   });
 }
 var diagnosticsPlugin = diagnostics;
+var ANALYTICS_PLUGIN_NAME = "analytics";
+function hasEnabledAnalyticsPlugin(config) {
+  return config?.plugins.some(
+    (plugin) => plugin.name === ANALYTICS_PLUGIN_NAME && plugin.enabled !== false
+  ) ?? false;
+}
+function analyticsCoverageOptions(config, options) {
+  return {
+    ...options,
+    reportAnalyticsCoverage: options.reportAnalyticsCoverage ?? hasEnabledAnalyticsPlugin(config)
+  };
+}
 function createInternalError(error) {
   const message = error instanceof Error ? error.message : String(error);
   return {
@@ -973,6 +1060,7 @@ export {
   diagnosticsPlugin,
   formatDiagnostics,
   groupByCode,
+  hasEnabledAnalyticsPlugin,
   runDiagnostics,
   summarize
 };

package/dist/src/checks/analytics.d.ts

@@ -0,0 +1,13 @@
+import type { Diagnostic } from "@riebeckite/core";
+import type { ScanResult } from "../vault.js";
+import { type NormalizedOptions } from "./shared.js";
+/**
+ * Reports published content that the analytics plugin will not track.
+ *
+ * The analytics browser initializer emits a page view only for entries that
+ * carry Core's source-authored stable content ID (`id`, or the compatible
+ * `uid`). Content without that ID builds and publishes normally but is silently
+ * absent from analytics. This check surfaces that gap as factual, read-only
+ * `info` findings; the analytics plugin itself never autofixes content.
+ */
+export declare function checkAnalyticsCoverage(source: ScanResult, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/checks/content_identity.d.ts

@@ -0,0 +1,14 @@
+import type { Diagnostic } from "@riebeckite/core";
+import type { ScanResult } from "../vault.js";
+import { type NormalizedOptions } from "./shared.js";
+/**
+ * Checks stable content ID integrity.
+ *
+ * Stable content IDs come from the optional source-authored `id` frontmatter
+ * field (`uid` is accepted for legacy content). They are the identity key for
+ * per-content consumers such as analytics page views, so duplicates silently
+ * merge per-content metrics and conflicting declarations break the build.
+ * This check is intentionally generic: it validates the content-model invariant
+ * without knowing which plugin consumes the ID.
+ */
+export declare function checkContentIdIntegrity(source: ScanResult, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/checks/shared.d.ts

@@ -11,6 +11,7 @@ export type AnalysisState = {
 export type NormalizedOptions = {
     reportUnusedAssets: boolean;
     reportOrphans: boolean;
+    reportAnalyticsCoverage: boolean;
     requiredFrontmatter: string[];
     severity: Partial<Record<string, DiagnosticSeverity>>;
 };

package/dist/src/types.d.ts

@@ -3,6 +3,7 @@ export type DiagnosticsOptions = {
     failOnError?: boolean;
     reportUnusedAssets?: boolean;
     reportOrphans?: boolean;
+    reportAnalyticsCoverage?: boolean;
     requiredFrontmatter?: string[];
     severity?: Partial<Record<DiagnosticCode, DiagnosticSeverity>>;
     exclude?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-diagnostics",
-  "version": "0.0.3",
+  "version": "0.0.6",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,11 +20,12 @@
     "remark-parse": "^11.0.0",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.1.0",
-    "@riebeckite/core": "0.0.3"
+    "@riebeckite/core": "0.0.6"
   },
   "devDependencies": {
     "@types/mdast": "^4.0.4",
-    "@types/node": "^24.5.2"
+    "@types/node": "^24.5.2",
+    "tsx": "^4.22.4"
   },
   "publishConfig": {
     "access": "public"
@@ -56,6 +57,7 @@
   },
   "sideEffects": false,
   "scripts": {
-    "build": "node ../../../scripts/build_package.mjs"
+    "build": "node ../../../scripts/build_package.mjs",
+    "test": "node --import tsx --test \"test/*.test.ts\""
   }
 }