zam-core 0.6.2 → 0.7.0

package/dist/cli/index.js

@@ -656,6 +656,18 @@ CREATE TABLE IF NOT EXISTS user_config (
   updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
 );
 
+-- Token embeddings: one vector per token for semantic search (ADR 2026-07-03).
+-- Not a column on tokens: hot paths do SELECT * FROM tokens and a ~3KB blob
+-- per row would ride along on all of them.
+CREATE TABLE IF NOT EXISTS token_embeddings (
+  token_id     TEXT PRIMARY KEY REFERENCES tokens(id) ON DELETE CASCADE,
+  embedding    BLOB NOT NULL,
+  model        TEXT NOT NULL,
+  dims         INTEGER NOT NULL,
+  content_hash TEXT NOT NULL,
+  embedded_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
 -- Agent skills: task recipes the agent learns from user guidance
 CREATE TABLE IF NOT EXISTS agent_skills (
   id          TEXT PRIMARY KEY,
@@ -1002,6 +1014,16 @@ async function runMigrations(db) {
       await db.exec(`ALTER TABLE tokens ADD COLUMN topic_id TEXT`);
     }
   }
+  await db.exec(`
+    CREATE TABLE IF NOT EXISTS token_embeddings (
+      token_id     TEXT PRIMARY KEY REFERENCES tokens(id) ON DELETE CASCADE,
+      embedding    BLOB NOT NULL,
+      model        TEXT NOT NULL,
+      dims         INTEGER NOT NULL,
+      content_hash TEXT NOT NULL,
+      embedded_at  TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
 }
 
 // src/kernel/db/snapshot.ts
@@ -2410,6 +2432,151 @@ async function deleteSetting(db, key) {
   return result.changes > 0;
 }
 
+// src/kernel/models/token-embedding.ts
+import { createHash as createHash2 } from "crypto";
+function embeddingContentForToken(t2) {
+  return `${t2.concept}
+${t2.question ?? ""}
+${t2.domain}`;
+}
+function computeContentHash(text) {
+  return createHash2("sha256").update(text, "utf8").digest("hex");
+}
+function encodeEmbedding(vec) {
+  const f = Float32Array.from(vec);
+  return new Uint8Array(f.buffer);
+}
+function decodeEmbedding(blob) {
+  if (blob.byteLength % 4 !== 0) {
+    throw new Error(
+      "Invalid embedding blob size: must be a multiple of 4 bytes"
+    );
+  }
+  if (blob.byteOffset % 4 === 0) {
+    return new Float32Array(blob.buffer, blob.byteOffset, blob.byteLength / 4);
+  }
+  const copy = Uint8Array.prototype.slice.call(blob);
+  return new Float32Array(copy.buffer, 0, copy.byteLength / 4);
+}
+async function upsertTokenEmbedding(db, input8) {
+  const encoded = encodeEmbedding(input8.embedding);
+  const dims = input8.embedding.length;
+  const embeddedAt = (/* @__PURE__ */ new Date()).toISOString();
+  await db.prepare(`
+      INSERT INTO token_embeddings (token_id, embedding, model, dims, content_hash, embedded_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT(token_id) DO UPDATE SET
+        embedding = excluded.embedding,
+        model = excluded.model,
+        dims = excluded.dims,
+        content_hash = excluded.content_hash,
+        embedded_at = excluded.embedded_at
+    `).run(
+    input8.tokenId,
+    encoded,
+    input8.model,
+    dims,
+    input8.contentHash,
+    embeddedAt
+  );
+}
+async function listTokensNeedingEmbedding(db, model, opts) {
+  const rows = await db.prepare(`
+      SELECT t.*, e.model AS emb_model, e.dims AS emb_dims, e.content_hash AS emb_hash
+      FROM tokens t
+      LEFT JOIN token_embeddings e ON e.token_id = t.id
+      WHERE t.deprecated_at IS NULL
+    `).all();
+  const needing = [];
+  for (const row of rows) {
+    let reason = null;
+    let text = "";
+    if (opts?.force) {
+      reason = "content-changed";
+    } else if (row.emb_model === null) {
+      reason = "missing";
+    } else if (row.emb_model !== model) {
+      reason = "model-changed";
+    } else if (opts?.dims !== void 0 && row.emb_dims !== opts.dims) {
+      reason = "dimension-changed";
+    } else {
+      const computedText = embeddingContentForToken(row);
+      const hash = computeContentHash(computedText);
+      if (row.emb_hash !== hash) {
+        reason = "content-changed";
+        text = computedText;
+      }
+    }
+    if (reason) {
+      if (!text) {
+        text = embeddingContentForToken(row);
+      }
+      needing.push({ token: row, text, reason });
+    }
+  }
+  if (opts?.limit !== void 0) {
+    return needing.slice(0, opts.limit);
+  }
+  return needing;
+}
+async function getEmbeddingCoverage(db, model, opts) {
+  const rows = await db.prepare(`
+      SELECT t.*, e.model AS emb_model, e.dims AS emb_dims, e.content_hash AS emb_hash
+      FROM tokens t
+      LEFT JOIN token_embeddings e ON e.token_id = t.id
+      WHERE t.deprecated_at IS NULL
+    `).all();
+  let missing = 0;
+  let stale = 0;
+  for (const row of rows) {
+    if (row.emb_model === null) {
+      missing++;
+      continue;
+    }
+    if (row.emb_model !== model) {
+      stale++;
+      continue;
+    }
+    if (opts?.dims !== void 0 && row.emb_dims !== opts.dims) {
+      stale++;
+      continue;
+    }
+    const hash = computeContentHash(embeddingContentForToken(row));
+    if (row.emb_hash !== hash) {
+      stale++;
+    }
+  }
+  const tokens = rows.length;
+  return {
+    tokens,
+    embedded: tokens - missing - stale,
+    missing,
+    stale
+  };
+}
+async function listEmbeddedTokens(db, model) {
+  const rows = await db.prepare(`
+      SELECT t.*, e.embedding AS embedding, e.content_hash AS emb_hash
+      FROM token_embeddings e
+      JOIN tokens t ON t.id = e.token_id
+      WHERE e.model = ? AND t.deprecated_at IS NULL
+    `).all(model);
+  return rows.flatMap((row) => {
+    const { embedding, emb_hash, ...token } = row;
+    if (emb_hash !== computeContentHash(embeddingContentForToken(token))) {
+      return [];
+    }
+    try {
+      return [{ token, embedding: decodeEmbedding(embedding) }];
+    } catch (err) {
+      console.warn(
+        `Warning: Corrupted embedding for token ${token.slug} (${token.id}) ignored: ${err.message}`
+      );
+      return [];
+    }
+  });
+}
+
 // src/kernel/observation/analyzer.ts
 function parseMonitorLog(jsonl) {
   const events = [];
@@ -4546,6 +4713,82 @@ function intersperseNew(reviews, newCards, interval) {
   return result;
 }
 
+// src/kernel/search/hybrid.ts
+function cosineSimilarity(a, b) {
+  if (a.length !== b.length) return 0;
+  let dot = 0;
+  let normA = 0;
+  let normB = 0;
+  const len = a.length;
+  for (let i = 0; i < len; i++) {
+    dot += a[i] * b[i];
+    normA += a[i] * a[i];
+    normB += b[i] * b[i];
+  }
+  if (normA === 0 || normB === 0) return 0;
+  return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+async function searchTokensHybrid(db, query, opts) {
+  const limit = opts?.limit ?? 20;
+  const rrfK = opts?.rrfK ?? 60;
+  const vectorTopK = opts?.vectorTopK ?? 10;
+  const lexicalHits = await findTokens(db, query);
+  let vectorHits = [];
+  if (opts?.queryEmbedding && opts?.model) {
+    const queryVec = Float32Array.from(opts.queryEmbedding);
+    const embedded = await listEmbeddedTokens(db, opts.model);
+    const candidates = [];
+    for (const row of embedded) {
+      if (row.embedding.length !== queryVec.length) {
+        continue;
+      }
+      const similarity = cosineSimilarity(queryVec, row.embedding);
+      if (similarity <= 0) {
+        continue;
+      }
+      candidates.push({ token: row.token, similarity });
+    }
+    candidates.sort((a, b) => b.similarity - a.similarity);
+    vectorHits = candidates.slice(0, vectorTopK);
+  }
+  const tokenMap = /* @__PURE__ */ new Map();
+  const getOrCreateEntry = (token) => {
+    let entry = tokenMap.get(token.id);
+    if (!entry) {
+      entry = {
+        ...token,
+        score: 0,
+        lexicalRank: null,
+        vectorRank: null,
+        similarity: null
+      };
+      tokenMap.set(token.id, entry);
+    }
+    return entry;
+  };
+  for (let i = 0; i < lexicalHits.length; i++) {
+    const hit = lexicalHits[i];
+    const entry = getOrCreateEntry(hit);
+    entry.lexicalRank = i + 1;
+    entry.score += 1 / (rrfK + entry.lexicalRank);
+  }
+  for (let j = 0; j < vectorHits.length; j++) {
+    const hit = vectorHits[j];
+    const entry = getOrCreateEntry(hit.token);
+    entry.vectorRank = j + 1;
+    entry.similarity = hit.similarity;
+    entry.score += 1 / (rrfK + entry.vectorRank);
+  }
+  const results = Array.from(tokenMap.values());
+  results.sort((a, b) => {
+    if (Math.abs(a.score - b.score) > 1e-9) {
+      return b.score - a.score;
+    }
+    return a.slug.localeCompare(b.slug);
+  });
+  return results.slice(0, limit);
+}
+
 // src/kernel/system/hooks.ts
 import {
   appendFileSync as appendFileSync3,
@@ -6092,6 +6335,21 @@ async function getLegacyRoleConfig(db, role, enabled) {
       maxFrames: Number.isNaN(parsed) ? 100 : parsed
     };
   }
+  if (role === "embedding") {
+    const url = await getSetting(db, "llm.embedding.url") || base.url;
+    return {
+      enabled,
+      url,
+      // Kept as a literal (not imported) to avoid a client.ts <-> embedder.ts
+      // import cycle; must match DEFAULT_EMBEDDING_MODEL in embedder.ts.
+      model: await getSetting(db, "llm.embedding.model") || "embeddinggemma",
+      apiKey: await getSetting(db, "llm.embedding.api_key") || base.apiKey,
+      apiFlavor: inferApiFlavor(url),
+      locale: base.locale,
+      source: "legacy",
+      local: isLocalEndpoint(url)
+    };
+  }
   return {
     enabled,
     url: base.url,
@@ -7386,7 +7644,7 @@ async function readWebLink(url) {
         redirect: "manual",
         signal: controller.signal,
         headers: {
-          "User-Agent": "ZAM-Content-Studio/0.6.1"
+          "User-Agent": "ZAM-Content-Studio/0.6.3"
         }
       });
       if (res.status >= 300 && res.status < 400) {
@@ -7464,23 +7722,184 @@ async function setLastCurriculumSelection(db, breadcrumb) {
   await setSetting(db, LAST_SELECTION_KEY, JSON.stringify(breadcrumb));
 }
 
+// src/cli/curriculum/providers/bildungsplan-bremen/manifest.ts
+var BILDUNGSPLAN_BREMEN_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Bildungspl\xE4ne Bremen",
+  schoolTypes: [
+    { id: "oberschule", label: "Oberschule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    oberschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    oberschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "oberschule|10|mathematik": [
+      { id: "funktionen", label: "Funktionen" },
+      { id: "geometrie", label: "Geometrie" }
+    ],
+    "gymnasium|10|mathematik": [{ id: "analysis", label: "Analysis" }],
+    "oberschule|9|informatik": [{ id: "algorithmen", label: "Algorithmen" }],
+    "oberschule|9|physik": [{ id: "mechanik", label: "Mechanik" }],
+    "oberschule|9|chemie": [
+      { id: "reaktionen", label: "Chemische Reaktionen" }
+    ],
+    "oberschule|9|biologie": [{ id: "zellen", label: "Zellen" }],
+    "gymnasium|9|physik": [{ id: "elektrizitaet", label: "Elektrizit\xE4t" }],
+    "gymnasium|9|chemie": [{ id: "bindungen", label: "Chemische Bindungen" }],
+    "gymnasium|9|biologie": [{ id: "genetik", label: "Genetik" }]
+  },
+  contentUrls: {
+    "oberschule|10|mathematik": "https://www.lis.bremen.de/schulqualitaet/bildungsplaene-21942",
+    "gymnasium|10|mathematik": "https://www.lis.bremen.de/schulqualitaet/bildungsplaene-21942",
+    "oberschule|9|informatik": "https://www.lis.bremen.de/schulqualitaet/bildungsplaene-21942",
+    "oberschule|9|physik": "https://www.lis.bremen.de/schulqualitaet/bildungsplaene-21942",
+    "oberschule|9|chemie": "https://www.lis.bremen.de/schulqualitaet/bildungsplaene-21942",
+    "oberschule|9|biologie": "https://www.lis.bremen.de/schulqualitaet/bildungsplaene-21942",
+    "gymnasium|9|physik": "https://www.lis.bremen.de/schulqualitaet/bildungsplaene-21942",
+    "gymnasium|9|chemie": "https://www.lis.bremen.de/schulqualitaet/bildungsplaene-21942",
+    "gymnasium|9|biologie": "https://www.lis.bremen.de/schulqualitaet/bildungsplaene-21942"
+  }
+};
+
+// src/cli/curriculum/providers/bildungsplan-bremen/index.ts
+var bildungsplanBremenProvider = {
+  id: "bildungsplan-bremen",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "HB",
+  regionLabel: "Bremen",
+  label: "Bildungsplan (Bremen)",
+  listSchoolTypes() {
+    return BILDUNGSPLAN_BREMEN_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (BILDUNGSPLAN_BREMEN_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return BILDUNGSPLAN_BREMEN_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return BILDUNGSPLAN_BREMEN_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = BILDUNGSPLAN_BREMEN_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = BILDUNGSPLAN_BREMEN_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Bildungsplan Bremen: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "bildungsplan-bremen",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = BILDUNGSPLAN_BREMEN_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison(label);
+      let section = sections.find(
+        (s) => normalizeForComparison(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
 // src/cli/curriculum/providers/bildungsplan-bw/manifest.ts
 var BILDUNGSPLAN_BW_MANIFEST = {
   schoolYear: "2026/2027",
   capturedOn: "2026-07-02",
   sourceRevision: "Bildungsplan Baden-W\xFCrttemberg Gymnasium 2016",
-  schoolTypes: [
-    { id: "gymnasium", label: "Gymnasium" },
-    { id: "realschule", label: "Realschule" }
-  ],
+  schoolTypes: [{ id: "gymnasium", label: "Gymnasium" }],
   grades: {
     gymnasium: ["9", "10", "11", "12"]
   },
   subjects: {
     gymnasium: [
       { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
       { id: "physik", label: "Physik" },
-      { id: "englisch", label: "Englisch" }
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
     ]
   },
   tracks: {},
@@ -7491,10 +7910,44 @@ var BILDUNGSPLAN_BW_MANIFEST = {
       { id: "leitidee-raum", label: "Leitidee Raum und Form" },
       { id: "leitidee-funktion", label: "Leitidee Funktionaler Zusammenhang" },
       { id: "leitidee-daten", label: "Leitidee Daten und Zufall" }
+    ],
+    "gymnasium|10|informatik": [
+      { id: "ik-daten-codierung", label: "Daten und Codierung" },
+      { id: "ik-algorithmen", label: "Algorithmen" },
+      { id: "ik-rechner-netze", label: "Rechner und Netze" },
+      {
+        id: "ik-informationsgesellschaft",
+        label: "Informationsgesellschaft und Datensicherheit"
+      }
+    ],
+    "gymnasium|10|physik": [
+      { id: "optik-akustik", label: "Optik und Akustik" },
+      { id: "mechanik", label: "Mechanik" },
+      {
+        id: "elektrizitaet-magnetismus",
+        label: "Elektrizit\xE4t und Magnetismus"
+      },
+      { id: "energie-waerme", label: "Energie und W\xE4rmelehre" }
+    ],
+    "gymnasium|10|chemie": [
+      { id: "stoffe-reaktionen", label: "Stoffe und chemische Reaktionen" },
+      { id: "atome-molekuele", label: "Atome und Molek\xFCle" },
+      { id: "saeuren-basen", label: "S\xE4uren, Basen und Salze" },
+      { id: "organische-chemie", label: "Organische Chemie" }
+    ],
+    "gymnasium|10|biologie": [
+      { id: "zellen", label: "Zellen und Gewebe" },
+      { id: "genetik", label: "Genetik und Vererbung" },
+      { id: "oekologie", label: "\xD6kologie und Umwelt" },
+      { id: "evolution", label: "Evolution und Vielfalt" }
     ]
   },
   contentUrls: {
-    "gymnasium|10|mathematik": "http://www.bildungsplaene-bw.de/,Lde/LS/BP2016BW/ALLG/GYM/M/bp/klasse-10"
+    "gymnasium|10|mathematik": "http://www.bildungsplaene-bw.de/,Lde/LS/BP2016BW/ALLG/GYM/M/bp/klasse-10",
+    "gymnasium|10|informatik": "https://www.bildungsplaene-bw.de/,Lde/BP2016BW_ALLG_SEK1_INFWF",
+    "gymnasium|10|physik": "https://www.bildungsplaene-bw.de/,Lde/BP2016BW_ALLG_GYM_PH",
+    "gymnasium|10|chemie": "https://www.bildungsplaene-bw.de/,Lde/BP2016BW_ALLG_GYM_CH",
+    "gymnasium|10|biologie": "https://www.bildungsplaene-bw.de/,Lde/BP2016BW_ALLG_GYM_BIO"
   }
 };
 
@@ -7555,7 +8008,7 @@ var bildungsplanBwProvider = {
       const headerMatch = contentHtml.match(
         /<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/i
       );
-      const headerText = headerMatch ? cleanHtmlText(headerMatch[1]).trim() : "";
+      const headerText = headerMatch ? cleanHtmlText2(headerMatch[1]).trim() : "";
       sections.push({
         id,
         headerText,
@@ -7572,20 +8025,20 @@ var bildungsplanBwProvider = {
       const match = list.find((t2) => t2.id === shortId);
       if (!match) continue;
       const label = match.label;
-      const normalizedLabel = normalizeForComparison(label);
+      const normalizedLabel = normalizeForComparison2(label);
       const sectionIndex = sections.findIndex((s) => {
-        const normalizedHeader = normalizeForComparison(s.headerText);
+        const normalizedHeader = normalizeForComparison2(s.headerText);
         return normalizedHeader.includes(normalizedLabel) || s.id === shortId;
       });
       if (sectionIndex === -1) {
         continue;
       }
-      results[topicId] = cleanHtmlText(sections[sectionIndex].contentHtml);
+      results[topicId] = cleanHtmlText2(sections[sectionIndex].contentHtml);
     }
     return results;
   }
 };
-function cleanHtmlText(html) {
+function cleanHtmlText2(html) {
   let text = html.replace(
     /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
     " "
@@ -7598,238 +8051,2285 @@ function cleanHtmlText(html) {
   text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&ndash;/g, "\u2013").replace(/&mdash;/g, "\u2014").replace(/&middot;/g, "\xB7");
   return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
 }
-function normalizeForComparison(str) {
+function normalizeForComparison2(str) {
   return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
 }
 
-// src/cli/curriculum/providers/lehrplanplus-bayern/manifest.ts
-var LEHRPLANPLUS_BAYERN_MANIFEST = {
-  schoolYear: "2026/2027",
+// src/cli/curriculum/providers/bildungsplan-hamburg/manifest.ts
+var BILDUNGSPLAN_HAMBURG_MANIFEST = {
+  schoolYear: "2025/2026",
   capturedOn: "2026-07-02",
-  sourceRevision: "LehrplanPLUS Realschule \u2013 Oktober 2023",
+  sourceRevision: "Bildungspl\xE4ne Hamburg",
   schoolTypes: [
-    { id: "grundschule", label: "Grundschule" },
-    { id: "mittelschule", label: "Mittelschule" },
-    { id: "foerderschule", label: "F\xF6rderschule" },
-    { id: "realschule", label: "Realschule" },
-    { id: "gymnasium", label: "Gymnasium" },
-    { id: "wirtschaftsschule", label: "Wirtschaftsschule" },
-    { id: "fos", label: "Fachoberschule" },
-    { id: "bos", label: "Berufsoberschule" }
+    { id: "stadtteilschule", label: "Stadtteilschule (Realschule)" },
+    { id: "gymnasium", label: "Gymnasium" }
   ],
   grades: {
-    realschule: ["5", "6", "7", "8", "9", "10"]
+    stadtteilschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
   },
   subjects: {
-    realschule: [
-      {
-        id: "bwl-rechnungswesen",
-        label: "Betriebswirtschaftslehre / Rechnungswesen"
-      },
-      { id: "biologie", label: "Biologie" },
+    stadtteilschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
       { id: "chemie", label: "Chemie" },
-      { id: "deutsch", label: "Deutsch" },
-      { id: "englisch", label: "Englisch" },
-      { id: "ernaehrung_und_gesundheit", label: "Ern\xE4hrung und Gesundheit" },
-      { id: "ethik", label: "Ethik" },
-      {
-        id: "evangelische-religionslehre",
-        label: "Evangelische Religionslehre"
-      },
-      { id: "franzoesisch", label: "Franz\xF6sisch" },
-      { id: "geographie", label: "Geographie" },
-      { id: "geschichte", label: "Geschichte" },
-      { id: "it", label: "Informationstechnologie" },
-      { id: "iu", label: "Islamischer Unterricht" },
-      { id: "ir", label: "Israelitische Religionslehre" },
-      {
-        id: "katholische-religionslehre",
-        label: "Katholische Religionslehre"
-      },
-      { id: "kunst", label: "Kunst" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
       { id: "mathematik", label: "Mathematik" },
-      { id: "musik", label: "Musik" },
-      { id: "or", label: "Orthodoxe Religionslehre" },
+      { id: "informatik", label: "Informatik" },
       { id: "physik", label: "Physik" },
-      { id: "pug", label: "Politik und Gesellschaft" },
-      { id: "soziallehre", label: "Soziallehre" },
-      { id: "sozialwesen", label: "Sozialwesen" },
-      { id: "spanisch", label: "Spanisch" },
-      { id: "sport", label: "Sport" },
-      { id: "textiles-gestalten", label: "Textiles Gestalten" },
-      { id: "werken", label: "Werken" },
-      { id: "wirtschaft-und-recht", label: "Wirtschaft und Recht" }
-    ]
-  },
-  tracks: {
-    "realschule|9|mathematik": [
-      { id: "wpfg1", label: "Mathematik 9 (I)" },
-      { id: "wpfg2-3", label: "Mathematik 9 (II/III)" }
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
     ]
   },
+  tracks: {},
   topics: {
-    "realschule|9|mathematik|wpfg1": [
-      { id: "lb1", label: "Reelle Zahlen", hours: 10 },
-      { id: "lb2", label: "Zentrische Streckung", hours: 17 },
-      { id: "lb3", label: "Rechtwinklige Dreiecke", hours: 20 },
-      { id: "lb4", label: "Kreis", hours: 10 },
-      { id: "lb5", label: "Raumgeometrie", hours: 20 },
-      { id: "lb6", label: "Systeme linearer Gleichungen", hours: 12 },
-      {
-        id: "lb7",
-        label: "Quadratische Funktionen und quadratische Gleichungen",
-        hours: 42
-      },
-      { id: "lb8", label: "Daten und Zufall", hours: 9 }
+    "stadtteilschule|10|mathematik": [
+      { id: "funktionen", label: "Funktionen" },
+      { id: "geometrie", label: "Geometrie" }
     ],
-    "realschule|9|mathematik|wpfg2-3": [
-      { id: "lb1", label: "Reelle Zahlen", hours: 7 },
-      { id: "lb2", label: "Zentrische Streckung", hours: 13 },
+    "gymnasium|10|mathematik": [{ id: "analysis", label: "Analysis" }],
+    "stadtteilschule|9|physik": [{ id: "mechanik", label: "Mechanik" }],
+    "stadtteilschule|9|chemie": [{ id: "reaktionen", label: "Reaktionen" }],
+    "stadtteilschule|9|biologie": [{ id: "zellen", label: "Zellen" }],
+    "gymnasium|9|physik": [{ id: "elektrizitaet", label: "Elektrizit\xE4t" }],
+    "gymnasium|9|chemie": [{ id: "bindungen", label: "Bindungen" }],
+    "gymnasium|9|biologie": [{ id: "genetik", label: "Genetik" }]
+  },
+  contentUrls: {
+    "stadtteilschule|10|mathematik": "https://www.hamburg.de/bildungsplaene",
+    "gymnasium|10|mathematik": "https://www.hamburg.de/bildungsplaene",
+    "stadtteilschule|9|physik": "https://www.hamburg.de/bildungsplaene",
+    "stadtteilschule|9|chemie": "https://www.hamburg.de/bildungsplaene",
+    "stadtteilschule|9|biologie": "https://www.hamburg.de/bildungsplaene",
+    "gymnasium|9|physik": "https://www.hamburg.de/bildungsplaene",
+    "gymnasium|9|chemie": "https://www.hamburg.de/bildungsplaene",
+    "gymnasium|9|biologie": "https://www.hamburg.de/bildungsplaene"
+  }
+};
+
+// src/cli/curriculum/providers/bildungsplan-hamburg/index.ts
+var bildungsplanHamburgProvider = {
+  id: "bildungsplan-hamburg",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "HH",
+  regionLabel: "Hamburg",
+  label: "Bildungsplan (Hamburg)",
+  listSchoolTypes() {
+    return BILDUNGSPLAN_HAMBURG_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (BILDUNGSPLAN_HAMBURG_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return BILDUNGSPLAN_HAMBURG_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return BILDUNGSPLAN_HAMBURG_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = BILDUNGSPLAN_HAMBURG_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = BILDUNGSPLAN_HAMBURG_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Bildungsplan Hamburg: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "bildungsplan-hamburg",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText3(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText3(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = BILDUNGSPLAN_HAMBURG_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison3(label);
+      let section = sections.find(
+        (s) => normalizeForComparison3(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText3(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison3(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/fachanforderungen-sh/manifest.ts
+var FACHANFORDERUNGEN_SH_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Fachanforderungen Schleswig-Holstein",
+  schoolTypes: [
+    { id: "gemeinschaftsschule", label: "Gemeinschaftsschule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    gemeinschaftsschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    gemeinschaftsschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "gemeinschaftsschule|10|mathematik": [
+      { id: "funktionen", label: "Funktionen" }
+    ],
+    "gymnasium|10|mathematik": [{ id: "analysis", label: "Analysis" }],
+    "gemeinschaftsschule|9|physik": [{ id: "mechanik", label: "Mechanik" }],
+    "gemeinschaftsschule|9|chemie": [{ id: "reaktionen", label: "Reaktionen" }],
+    "gemeinschaftsschule|9|biologie": [{ id: "zellen", label: "Zellen" }],
+    "gymnasium|9|physik": [{ id: "elektrizitaet", label: "Elektrizit\xE4t" }],
+    "gymnasium|9|chemie": [{ id: "bindungen", label: "Bindungen" }],
+    "gymnasium|9|biologie": [{ id: "genetik", label: "Genetik" }]
+  },
+  contentUrls: {
+    "gemeinschaftsschule|10|mathematik": "https://fachportal.lernnetz.de/sh/fachanforderungen.html",
+    "gymnasium|10|mathematik": "https://fachportal.lernnetz.de/sh/fachanforderungen.html",
+    "gemeinschaftsschule|9|physik": "https://fachportal.lernnetz.de/sh/fachanforderungen.html",
+    "gemeinschaftsschule|9|chemie": "https://fachportal.lernnetz.de/sh/fachanforderungen.html",
+    "gemeinschaftsschule|9|biologie": "https://fachportal.lernnetz.de/sh/fachanforderungen.html",
+    "gymnasium|9|physik": "https://fachportal.lernnetz.de/sh/fachanforderungen.html",
+    "gymnasium|9|chemie": "https://fachportal.lernnetz.de/sh/fachanforderungen.html",
+    "gymnasium|9|biologie": "https://fachportal.lernnetz.de/sh/fachanforderungen.html"
+  }
+};
+
+// src/cli/curriculum/providers/fachanforderungen-sh/index.ts
+var fachanforderungenShProvider = {
+  id: "fachanforderungen-sh",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "SH",
+  regionLabel: "Schleswig-Holstein",
+  label: "Fachanforderungen (Schleswig-Holstein)",
+  listSchoolTypes() {
+    return FACHANFORDERUNGEN_SH_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (FACHANFORDERUNGEN_SH_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return FACHANFORDERUNGEN_SH_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return FACHANFORDERUNGEN_SH_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = FACHANFORDERUNGEN_SH_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = FACHANFORDERUNGEN_SH_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Fachanforderungen SH: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "fachanforderungen-sh",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText4(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText4(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = FACHANFORDERUNGEN_SH_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison4(label);
+      let section = sections.find(
+        (s) => normalizeForComparison4(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText4(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison4(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/kerncurriculum-hessen/manifest.ts
+var KERNCURRICULUM_HESSEN_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Kerncurricula Hessen (Sekundarstufe I)",
+  schoolTypes: [
+    { id: "realschule", label: "Realschule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    realschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    realschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    // Minimal for Hessen Realschule / Gym - based on Kerncurricula Inhaltsfelder
+    "realschule|10|mathematik": [
+      { id: "funktionen", label: "Funktionen" },
+      { id: "geometrie", label: "Geometrie" },
+      { id: "wahrscheinlichkeit", label: "Wahrscheinlichkeit und Statistik" }
+    ],
+    "gymnasium|10|mathematik": [
+      { id: "analysis", label: "Analysis" },
+      { id: "vektoren", label: "Vektoren und Geometrie" },
+      { id: "stochastik", label: "Stochastik" }
+    ],
+    "realschule|9|informatik": [
+      { id: "daten", label: "Daten und Information" },
+      { id: "algorithmen", label: "Algorithmen und Programmierung" },
+      { id: "netze", label: "Netze und Sicherheit" }
+    ],
+    "realschule|9|physik": [
+      { id: "mechanik", label: "Mechanik" },
+      { id: "energie", label: "Energie" },
+      { id: "elektrizitaet", label: "Elektrizit\xE4t" }
+    ],
+    "realschule|9|chemie": [
+      { id: "stoffe", label: "Stoffe und Reaktionen" },
+      { id: "atome", label: "Atome und Periodensystem" },
+      { id: "organisch", label: "Organische Verbindungen" }
+    ],
+    "realschule|9|biologie": [
+      { id: "zelle", label: "Zelle und Stoffwechsel" },
+      { id: "vererbung", label: "Vererbung" },
+      { id: "oekologie", label: "\xD6kologie" }
+    ],
+    "gymnasium|9|physik": [
+      { id: "optik", label: "Optik" },
+      { id: "mechanik-dynamik", label: "Mechanik und Dynamik" },
+      { id: "felder", label: "Elektrische und magnetische Felder" }
+    ],
+    "gymnasium|9|chemie": [
+      { id: "bindung", label: "Chemische Bindung" },
+      { id: "reaktionsgeschwindigkeit", label: "Reaktionsgeschwindigkeit" },
+      { id: "saeure-base", label: "S\xE4ure-Base-Reaktionen" }
+    ],
+    "gymnasium|9|biologie": [
+      { id: "genetik", label: "Genetik" },
+      { id: "evolution", label: "Evolution" },
+      { id: "neurobiologie", label: "Neurobiologie" }
+    ]
+  },
+  contentUrls: {
+    "realschule|10|mathematik": "https://kultusministerium.hessen.de/Unterricht/Kerncurricula-und-Lehrplaene/Kerncurricula/sekundarstufe-i-kerncurricula",
+    "gymnasium|10|mathematik": "https://kultusministerium.hessen.de/Unterricht/Kerncurricula-und-Lehrplaene/Kerncurricula/sekundarstufe-i-kerncurricula",
+    "realschule|9|informatik": "https://kultusministerium.hessen.de/Unterricht/Kerncurricula-und-Lehrplaene/Kerncurricula/sekundarstufe-i-kerncurricula",
+    "realschule|9|physik": "https://kultusministerium.hessen.de/Unterricht/Kerncurricula-und-Lehrplaene/Kerncurricula/sekundarstufe-i-kerncurricula",
+    "realschule|9|chemie": "https://kultusministerium.hessen.de/Unterricht/Kerncurricula-und-Lehrplaene/Kerncurricula/sekundarstufe-i-kerncurricula",
+    "realschule|9|biologie": "https://kultusministerium.hessen.de/Unterricht/Kerncurricula-und-Lehrplaene/Kerncurricula/sekundarstufe-i-kerncurricula",
+    "gymnasium|9|physik": "https://kultusministerium.hessen.de/Unterricht/Kerncurricula-und-Lehrplaene/Kerncurricula/sekundarstufe-i-kerncurricula",
+    "gymnasium|9|chemie": "https://kultusministerium.hessen.de/Unterricht/Kerncurricula-und-Lehrplaene/Kerncurricula/sekundarstufe-i-kerncurricula",
+    "gymnasium|9|biologie": "https://kultusministerium.hessen.de/Unterricht/Kerncurricula-und-Lehrplaene/Kerncurricula/sekundarstufe-i-kerncurricula"
+  }
+};
+
+// src/cli/curriculum/providers/kerncurriculum-hessen/index.ts
+var kerncurriculumHessenProvider = {
+  id: "kerncurriculum-hessen",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "HE",
+  regionLabel: "Hessen",
+  label: "Kerncurriculum (Hessen)",
+  listSchoolTypes() {
+    return KERNCURRICULUM_HESSEN_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (KERNCURRICULUM_HESSEN_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return KERNCURRICULUM_HESSEN_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return KERNCURRICULUM_HESSEN_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = KERNCURRICULUM_HESSEN_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = KERNCURRICULUM_HESSEN_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Kerncurriculum Hessen: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "kerncurriculum-hessen",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText5(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText5(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = KERNCURRICULUM_HESSEN_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison5(label);
+      let section = sections.find(
+        (s) => normalizeForComparison5(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText5(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison5(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/kerncurriculum-niedersachsen/manifest.ts
+var KERNCURRICULUM_NIEDERSACHSEN_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Kerncurricula Niedersachsen (CuVo)",
+  schoolTypes: [
+    { id: "realschule", label: "Realschule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    realschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    realschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "realschule|10|mathematik": [
+      { id: "algebra-funktionen", label: "Algebra und Funktionen" },
+      { id: "geometrie", label: "Geometrie" }
+    ],
+    "gymnasium|10|mathematik": [
+      { id: "analysis", label: "Analysis" },
+      { id: "lineare-algebra", label: "Lineare Algebra" }
+    ],
+    "realschule|9|physik": [
+      { id: "mechanik", label: "Mechanik" },
+      { id: "energie", label: "Energie und W\xE4rme" }
+    ],
+    "realschule|9|chemie": [
+      { id: "reaktionen", label: "Chemische Reaktionen" },
+      { id: "stoffkreislauf", label: "Stoffkreisl\xE4ufe" }
+    ],
+    "realschule|9|biologie": [
+      { id: "zellen", label: "Zellen" },
+      { id: "oekologie", label: "\xD6kologie" }
+    ],
+    "gymnasium|9|physik": [
+      { id: "elektrizitaet", label: "Elektrizit\xE4t und Magnetismus" }
+    ],
+    "gymnasium|9|chemie": [{ id: "bindungen", label: "Chemische Bindungen" }],
+    "gymnasium|9|biologie": [{ id: "genetik", label: "Genetik" }]
+  },
+  contentUrls: {
+    "realschule|10|mathematik": "https://cuvo.nibis.de/cuvo.php",
+    "gymnasium|10|mathematik": "https://cuvo.nibis.de/cuvo.php",
+    "realschule|9|physik": "https://cuvo.nibis.de/cuvo.php",
+    "realschule|9|chemie": "https://cuvo.nibis.de/cuvo.php",
+    "realschule|9|biologie": "https://cuvo.nibis.de/cuvo.php",
+    "gymnasium|9|physik": "https://cuvo.nibis.de/cuvo.php",
+    "gymnasium|9|chemie": "https://cuvo.nibis.de/cuvo.php",
+    "gymnasium|9|biologie": "https://cuvo.nibis.de/cuvo.php"
+  }
+};
+
+// src/cli/curriculum/providers/kerncurriculum-niedersachsen/index.ts
+var kerncurriculumNiedersachsenProvider = {
+  id: "kerncurriculum-niedersachsen",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "NI",
+  regionLabel: "Niedersachsen",
+  label: "Kerncurriculum (Niedersachsen)",
+  listSchoolTypes() {
+    return KERNCURRICULUM_NIEDERSACHSEN_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (KERNCURRICULUM_NIEDERSACHSEN_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return KERNCURRICULUM_NIEDERSACHSEN_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return KERNCURRICULUM_NIEDERSACHSEN_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = KERNCURRICULUM_NIEDERSACHSEN_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = KERNCURRICULUM_NIEDERSACHSEN_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Kerncurriculum Niedersachsen: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "kerncurriculum-niedersachsen",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText6(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText6(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = KERNCURRICULUM_NIEDERSACHSEN_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison6(label);
+      let section = sections.find(
+        (s) => normalizeForComparison6(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText6(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison6(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/kernlehrplan-nrw/manifest.ts
+var KERNLEHRPLAN_NRW_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Kernlehrpl\xE4ne Sekundarstufe I NRW (Lehrplannavigator)",
+  schoolTypes: [
+    { id: "realschule", label: "Realschule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    realschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    realschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    // Minimal starter set for Realschule Mathematik (example for one grade)
+    "realschule|10|mathematik": [
+      { id: "arithmetik-algebra", label: "Arithmetik und Algebra" },
+      { id: "funktionen", label: "Funktionen" },
+      { id: "geometrie", label: "Geometrie" },
+      { id: "stochastik", label: "Stochastik" }
+    ],
+    // Minimal starter for Realschule Informatik (from UV examples in 5/6 + typical)
+    "realschule|8|informatik": [
+      { id: "daten-codierung", label: "Daten und Codierung" },
+      { id: "algorithmen", label: "Algorithmen" },
+      {
+        id: "ki-datenbewusstsein",
+        label: "K\xFCnstliche Intelligenz und Datenbewusstsein"
+      }
+    ],
+    // Starter for Gymnasium Mathematik (higher track)
+    "gymnasium|10|mathematik": [
+      { id: "analysis", label: "Analysis / Funktionen" },
+      {
+        id: "lineare-algebra-geometrie",
+        label: "Lineare Algebra und Geometrie"
+      },
+      { id: "stochastik", label: "Stochastik" }
+    ],
+    // Starter for Gymnasium WP Informatik
+    "gymnasium|10|informatik": [
+      { id: "logische-schaltungen", label: "Logische Schaltungen" },
+      {
+        id: "algorithmen-programmierung",
+        label: "Algorithmen und Programmierung"
+      },
+      { id: "daten-netze-sicherheit", label: "Daten, Netze und Sicherheit" }
+    ],
+    // Naturwissenschaften for Realschule example
+    "realschule|9|physik": [
+      { id: "mechanik-kraefte", label: "Mechanik und Kr\xE4fte" },
+      { id: "waerme-energie", label: "W\xE4rme und Energie" },
+      { id: "elektrizitaet", label: "Elektrizit\xE4t" }
+    ],
+    "realschule|9|chemie": [
+      { id: "stoffe-eigenschaften", label: "Stoffe und ihre Eigenschaften" },
+      { id: "reaktionen", label: "Chemische Reaktionen" },
+      { id: "atombau", label: "Atombau und Periodensystem" }
+    ],
+    "realschule|9|biologie": [
+      { id: "zellen-lebewesen", label: "Zellen und Lebewesen" },
+      { id: "vererbung", label: "Vererbung und Genetik" },
+      { id: "oekosysteme", label: "\xD6kosysteme" }
+    ],
+    // Naturwissenschaften for Gymnasium
+    "gymnasium|9|physik": [
+      { id: "optik", label: "Optik" },
+      { id: "elektromagnetismus", label: "Elektromagnetismus" },
+      { id: "atomphysik", label: "Atom- und Kernphysik" }
+    ],
+    "gymnasium|9|chemie": [
+      { id: "chemische-bindung", label: "Chemische Bindung" },
+      { id: "saeuren-basen-salze", label: "S\xE4uren, Basen, Salze" },
+      { id: "organische", label: "Organische Chemie" }
+    ],
+    "gymnasium|9|biologie": [
+      { id: "genetik-evolution", label: "Genetik und Evolution" },
+      { id: "physiologie", label: "Physiologie des Menschen" },
+      { id: "oekologie-umwelt", label: "\xD6kologie und Umweltschutz" }
+    ]
+  },
+  contentUrls: {
+    "realschule|10|mathematik": "https://lehrplannavigator.nrw.de/sekundarstufe-i/realschule/mathematik-neu-ab-20222023",
+    "realschule|8|informatik": "https://lehrplannavigator.nrw.de/sekundarstufe-i/realschule/informatik-realschule-neu-ab-20212022",
+    "gymnasium|10|mathematik": "https://lehrplannavigator.nrw.de/sekundarstufe-i/kernlehrplaene-fuer-das-gymnasium-ab-20192020/mathematik",
+    "gymnasium|10|informatik": "https://lehrplannavigator.nrw.de/sekundarstufe-i/kernlehrplaene-fuer-das-gymnasium-ab-20192020/wp-informatik-neu-ab-20232024",
+    "realschule|9|physik": "https://lehrplannavigator.nrw.de/sekundarstufe-i/realschule/physik",
+    "realschule|9|chemie": "https://lehrplannavigator.nrw.de/sekundarstufe-i/realschule/chemie",
+    "realschule|9|biologie": "https://lehrplannavigator.nrw.de/sekundarstufe-i/realschule/biologie",
+    "gymnasium|9|physik": "https://lehrplannavigator.nrw.de/sekundarstufe-i/kernlehrplaene-fuer-das-gymnasium-ab-20192020/physik",
+    "gymnasium|9|chemie": "https://lehrplannavigator.nrw.de/sekundarstufe-i/kernlehrplaene-fuer-das-gymnasium-ab-20192020/chemie",
+    "gymnasium|9|biologie": "https://lehrplannavigator.nrw.de/sekundarstufe-i/kernlehrplaene-fuer-das-gymnasium-ab-20192020/biologie"
+  }
+};
+
+// src/cli/curriculum/providers/kernlehrplan-nrw/index.ts
+var kernlehrplanNrwProvider = {
+  id: "kernlehrplan-nrw",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "NW",
+  regionLabel: "Nordrhein-Westfalen",
+  label: "Kernlehrplan (Nordrhein-Westfalen)",
+  listSchoolTypes() {
+    return KERNLEHRPLAN_NRW_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (KERNLEHRPLAN_NRW_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return KERNLEHRPLAN_NRW_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return KERNLEHRPLAN_NRW_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = KERNLEHRPLAN_NRW_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = KERNLEHRPLAN_NRW_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Kernlehrplan NRW: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "kernlehrplan-nrw",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText7(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 2e3);
+      const content = cleanHtmlText7(rawContent).slice(0, 2e3);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = KERNLEHRPLAN_NRW_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison7(label);
+      let section = sections.find(
+        (s) => normalizeForComparison7(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 100) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText7(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&ndash;/g, "\u2013").replace(/&mdash;/g, "\u2014");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison7(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/lehrplaene-rp/manifest.ts
+var LEHRPLAENE_RP_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Lehrpl\xE4ne Rheinland-Pfalz",
+  schoolTypes: [
+    { id: "realschule-plus", label: "Realschule plus" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    "realschule-plus": ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    "realschule-plus": [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "realschule-plus|10|mathematik": [
+      { id: "funktionen", label: "Funktionen" }
+    ],
+    "gymnasium|10|mathematik": [{ id: "analysis", label: "Analysis" }],
+    "realschule-plus|9|physik": [{ id: "mechanik", label: "Mechanik" }],
+    "realschule-plus|9|chemie": [{ id: "reaktionen", label: "Reaktionen" }],
+    "realschule-plus|9|biologie": [{ id: "zellen", label: "Zellen" }],
+    "gymnasium|9|physik": [{ id: "elektrizitaet", label: "Elektrizit\xE4t" }],
+    "gymnasium|9|chemie": [{ id: "bindungen", label: "Bindungen" }],
+    "gymnasium|9|biologie": [{ id: "genetik", label: "Genetik" }]
+  },
+  contentUrls: {
+    "realschule-plus|10|mathematik": "https://lehrplaene.bildung-rp.de/",
+    "gymnasium|10|mathematik": "https://lehrplaene.bildung-rp.de/",
+    "realschule-plus|9|physik": "https://lehrplaene.bildung-rp.de/",
+    "realschule-plus|9|chemie": "https://lehrplaene.bildung-rp.de/",
+    "realschule-plus|9|biologie": "https://lehrplaene.bildung-rp.de/",
+    "gymnasium|9|physik": "https://lehrplaene.bildung-rp.de/",
+    "gymnasium|9|chemie": "https://lehrplaene.bildung-rp.de/",
+    "gymnasium|9|biologie": "https://lehrplaene.bildung-rp.de/"
+  }
+};
+
+// src/cli/curriculum/providers/lehrplaene-rp/index.ts
+var lehrplaeneRpProvider = {
+  id: "lehrplaene-rp",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "RP",
+  regionLabel: "Rheinland-Pfalz",
+  label: "Lehrpl\xE4ne (Rheinland-Pfalz)",
+  listSchoolTypes() {
+    return LEHRPLAENE_RP_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (LEHRPLAENE_RP_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return LEHRPLAENE_RP_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return LEHRPLAENE_RP_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = LEHRPLAENE_RP_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = LEHRPLAENE_RP_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Lehrpl\xE4ne RP: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "lehrplaene-rp",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText8(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText8(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = LEHRPLAENE_RP_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison8(label);
+      let section = sections.find(
+        (s) => normalizeForComparison8(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText8(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison8(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/lehrplan-saarland/manifest.ts
+var LEHRPLAN_SAARLAND_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Lehrpl\xE4ne Saarland",
+  schoolTypes: [
+    { id: "gemeinschaftsschule", label: "Gemeinschaftsschule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    gemeinschaftsschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    gemeinschaftsschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "gemeinschaftsschule|10|mathematik": [
+      { id: "funktionen", label: "Funktionen" }
+    ],
+    "gymnasium|10|mathematik": [{ id: "analysis", label: "Analysis" }],
+    "gemeinschaftsschule|9|physik": [{ id: "mechanik", label: "Mechanik" }],
+    "gemeinschaftsschule|9|chemie": [{ id: "reaktionen", label: "Reaktionen" }],
+    "gemeinschaftsschule|9|biologie": [{ id: "zellen", label: "Zellen" }],
+    "gymnasium|9|physik": [{ id: "elektrizitaet", label: "Elektrizit\xE4t" }],
+    "gymnasium|9|chemie": [{ id: "bindungen", label: "Bindungen" }],
+    "gymnasium|9|biologie": [{ id: "genetik", label: "Genetik" }]
+  },
+  contentUrls: {
+    "gemeinschaftsschule|10|mathematik": "https://www.saarland.de/mbk/DE/portale/bildungsserver/bildungsthemen/lehrplaenehandreichungen",
+    "gymnasium|10|mathematik": "https://www.saarland.de/mbk/DE/portale/bildungsserver/bildungsthemen/lehrplaenehandreichungen",
+    "gemeinschaftsschule|9|physik": "https://www.saarland.de/mbk/DE/portale/bildungsserver/bildungsthemen/lehrplaenehandreichungen",
+    "gemeinschaftsschule|9|chemie": "https://www.saarland.de/mbk/DE/portale/bildungsserver/bildungsthemen/lehrplaenehandreichungen",
+    "gemeinschaftsschule|9|biologie": "https://www.saarland.de/mbk/DE/portale/bildungsserver/bildungsthemen/lehrplaenehandreichungen",
+    "gymnasium|9|physik": "https://www.saarland.de/mbk/DE/portale/bildungsserver/bildungsthemen/lehrplaenehandreichungen",
+    "gymnasium|9|chemie": "https://www.saarland.de/mbk/DE/portale/bildungsserver/bildungsthemen/lehrplaenehandreichungen",
+    "gymnasium|9|biologie": "https://www.saarland.de/mbk/DE/portale/bildungsserver/bildungsthemen/lehrplaenehandreichungen"
+  }
+};
+
+// src/cli/curriculum/providers/lehrplan-saarland/index.ts
+var lehrplanSaarlandProvider = {
+  id: "lehrplan-saarland",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "SL",
+  regionLabel: "Saarland",
+  label: "Lehrplan (Saarland)",
+  listSchoolTypes() {
+    return LEHRPLAN_SAARLAND_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (LEHRPLAN_SAARLAND_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return LEHRPLAN_SAARLAND_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return LEHRPLAN_SAARLAND_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = LEHRPLAN_SAARLAND_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = LEHRPLAN_SAARLAND_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Lehrplan Saarland: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "lehrplan-saarland",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText9(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText9(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = LEHRPLAN_SAARLAND_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison9(label);
+      let section = sections.find(
+        (s) => normalizeForComparison9(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText9(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison9(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/lehrplan-sachsen/manifest.ts
+var LEHRPLAN_SACHSEN_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "S\xE4chsische Lehrpl\xE4ne (Datenbank)",
+  schoolTypes: [
+    { id: "oberschule", label: "Oberschule (Realschule)" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    oberschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    oberschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "oberschule|10|mathematik": [
+      { id: "prozentrechnung", label: "Prozentrechnung und Zinsrechnung" },
+      { id: "funktionen", label: "Funktionale Zusammenh\xE4nge" },
+      { id: "geometrie", label: "Geometrie und Messen" }
+    ],
+    "gymnasium|10|mathematik": [
+      { id: "analysis", label: "Analysis und Funktionen" },
+      { id: "geometrie", label: "Analytische Geometrie" }
+    ],
+    "oberschule|9|informatik": [
+      { id: "algorithmen", label: "Algorithmen und Programmierung" },
+      { id: "daten", label: "Daten und Datenschutz" }
+    ],
+    "oberschule|9|physik": [
+      { id: "mechanik", label: "Mechanik und Bewegung" },
+      { id: "energie", label: "Energie und W\xE4rme" }
+    ],
+    "oberschule|9|chemie": [
+      { id: "stoffe", label: "Stoffe und chemische Reaktionen" },
+      { id: "atome", label: "Atome und Periodensystem" }
+    ],
+    "oberschule|9|biologie": [
+      { id: "zellen", label: "Zellen und Gewebe" },
+      { id: "oekologie", label: "\xD6kologie und Umwelt" }
+    ],
+    "gymnasium|9|physik": [
+      { id: "elektrizitaet", label: "Elektrizit\xE4t und Magnetismus" },
+      { id: "optik", label: "Optik" }
+    ],
+    "gymnasium|9|chemie": [
+      { id: "bindungen", label: "Chemische Bindungen" },
+      { id: "reaktionen", label: "Chemische Reaktionen" }
+    ],
+    "gymnasium|9|biologie": [
+      { id: "genetik", label: "Genetik und Vererbung" },
+      { id: "evolution", label: "Evolution" }
+    ]
+  },
+  contentUrls: {
+    "oberschule|10|mathematik": "https://www.schulportal.sachsen.de/lplandb/",
+    "gymnasium|10|mathematik": "https://www.schulportal.sachsen.de/lplandb/",
+    "oberschule|9|informatik": "https://www.schulportal.sachsen.de/lplandb/",
+    "oberschule|9|physik": "https://www.schulportal.sachsen.de/lplandb/",
+    "oberschule|9|chemie": "https://www.schulportal.sachsen.de/lplandb/",
+    "oberschule|9|biologie": "https://www.schulportal.sachsen.de/lplandb/",
+    "gymnasium|9|physik": "https://www.schulportal.sachsen.de/lplandb/",
+    "gymnasium|9|chemie": "https://www.schulportal.sachsen.de/lplandb/",
+    "gymnasium|9|biologie": "https://www.schulportal.sachsen.de/lplandb/"
+  }
+};
+
+// src/cli/curriculum/providers/lehrplan-sachsen/index.ts
+var lehrplanSachsenProvider = {
+  id: "lehrplan-sachsen",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "SN",
+  regionLabel: "Sachsen",
+  label: "Lehrplan (Sachsen)",
+  listSchoolTypes() {
+    return LEHRPLAN_SACHSEN_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (LEHRPLAN_SACHSEN_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return LEHRPLAN_SACHSEN_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return LEHRPLAN_SACHSEN_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = LEHRPLAN_SACHSEN_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = LEHRPLAN_SACHSEN_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Lehrplan Sachsen: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "lehrplan-sachsen",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText10(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText10(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = LEHRPLAN_SACHSEN_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison10(label);
+      let section = sections.find(
+        (s) => normalizeForComparison10(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText10(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison10(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/lehrplan-thueringen/manifest.ts
+var LEHRPLAN_THUERINGEN_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Lehrpl\xE4ne Th\xFCringen",
+  schoolTypes: [
+    { id: "regelschule", label: "Regelschule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    regelschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    regelschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "regelschule|10|mathematik": [{ id: "funktionen", label: "Funktionen" }],
+    "gymnasium|10|mathematik": [{ id: "analysis", label: "Analysis" }],
+    "regelschule|9|physik": [{ id: "mechanik", label: "Mechanik" }],
+    "regelschule|9|chemie": [{ id: "reaktionen", label: "Reaktionen" }],
+    "regelschule|9|biologie": [{ id: "zellen", label: "Zellen" }],
+    "gymnasium|9|physik": [{ id: "elektrizitaet", label: "Elektrizit\xE4t" }],
+    "gymnasium|9|chemie": [{ id: "bindungen", label: "Bindungen" }],
+    "gymnasium|9|biologie": [{ id: "genetik", label: "Genetik" }]
+  },
+  contentUrls: {
+    "regelschule|10|mathematik": "https://www.schulportal-thueringen.de/web/guest/lehrplaene",
+    "gymnasium|10|mathematik": "https://www.schulportal-thueringen.de/web/guest/lehrplaene",
+    "regelschule|9|physik": "https://www.schulportal-thueringen.de/web/guest/lehrplaene",
+    "regelschule|9|chemie": "https://www.schulportal-thueringen.de/web/guest/lehrplaene",
+    "regelschule|9|biologie": "https://www.schulportal-thueringen.de/web/guest/lehrplaene",
+    "gymnasium|9|physik": "https://www.schulportal-thueringen.de/web/guest/lehrplaene",
+    "gymnasium|9|chemie": "https://www.schulportal-thueringen.de/web/guest/lehrplaene",
+    "gymnasium|9|biologie": "https://www.schulportal-thueringen.de/web/guest/lehrplaene"
+  }
+};
+
+// src/cli/curriculum/providers/lehrplan-thueringen/index.ts
+var lehrplanThueringenProvider = {
+  id: "lehrplan-thueringen",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "TH",
+  regionLabel: "Th\xFCringen",
+  label: "Lehrplan (Th\xFCringen)",
+  listSchoolTypes() {
+    return LEHRPLAN_THUERINGEN_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (LEHRPLAN_THUERINGEN_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return LEHRPLAN_THUERINGEN_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return LEHRPLAN_THUERINGEN_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = LEHRPLAN_THUERINGEN_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = LEHRPLAN_THUERINGEN_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Lehrplan Th\xFCringen: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "lehrplan-thueringen",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText11(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText11(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = LEHRPLAN_THUERINGEN_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison11(label);
+      let section = sections.find(
+        (s) => normalizeForComparison11(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText11(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison11(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/lehrplanplus-bayern/manifest.ts
+var LEHRPLANPLUS_BAYERN_MANIFEST = {
+  schoolYear: "2026/2027",
+  capturedOn: "2026-07-02",
+  sourceRevision: "LehrplanPLUS Realschule \u2013 Oktober 2023",
+  schoolTypes: [
+    { id: "grundschule", label: "Grundschule" },
+    { id: "mittelschule", label: "Mittelschule" },
+    { id: "foerderschule", label: "F\xF6rderschule" },
+    { id: "realschule", label: "Realschule" },
+    { id: "gymnasium", label: "Gymnasium" },
+    { id: "wirtschaftsschule", label: "Wirtschaftsschule" },
+    { id: "fos", label: "Fachoberschule" },
+    { id: "bos", label: "Berufsoberschule" }
+  ],
+  grades: {
+    realschule: ["5", "6", "7", "8", "9", "10"]
+  },
+  subjects: {
+    realschule: [
+      {
+        id: "bwl-rechnungswesen",
+        label: "Betriebswirtschaftslehre / Rechnungswesen"
+      },
+      { id: "biologie", label: "Biologie" },
+      { id: "chemie", label: "Chemie" },
+      { id: "deutsch", label: "Deutsch" },
+      { id: "englisch", label: "Englisch" },
+      { id: "ernaehrung_und_gesundheit", label: "Ern\xE4hrung und Gesundheit" },
+      { id: "ethik", label: "Ethik" },
+      {
+        id: "evangelische-religionslehre",
+        label: "Evangelische Religionslehre"
+      },
+      { id: "franzoesisch", label: "Franz\xF6sisch" },
+      { id: "geographie", label: "Geographie" },
+      { id: "geschichte", label: "Geschichte" },
+      { id: "it", label: "Informationstechnologie" },
+      { id: "iu", label: "Islamischer Unterricht" },
+      { id: "ir", label: "Israelitische Religionslehre" },
+      {
+        id: "katholische-religionslehre",
+        label: "Katholische Religionslehre"
+      },
+      { id: "kunst", label: "Kunst" },
+      { id: "mathematik", label: "Mathematik" },
+      { id: "musik", label: "Musik" },
+      { id: "or", label: "Orthodoxe Religionslehre" },
+      { id: "physik", label: "Physik" },
+      { id: "pug", label: "Politik und Gesellschaft" },
+      { id: "soziallehre", label: "Soziallehre" },
+      { id: "sozialwesen", label: "Sozialwesen" },
+      { id: "spanisch", label: "Spanisch" },
+      { id: "sport", label: "Sport" },
+      { id: "textiles-gestalten", label: "Textiles Gestalten" },
+      { id: "werken", label: "Werken" },
+      { id: "wirtschaft-und-recht", label: "Wirtschaft und Recht" }
+    ]
+  },
+  tracks: {
+    "realschule|9|mathematik": [
+      { id: "wpfg1", label: "Mathematik 9 (I)" },
+      { id: "wpfg2-3", label: "Mathematik 9 (II/III)" }
+    ]
+  },
+  topics: {
+    "realschule|9|mathematik|wpfg1": [
+      { id: "lb1", label: "Reelle Zahlen", hours: 10 },
+      { id: "lb2", label: "Zentrische Streckung", hours: 17 },
+      { id: "lb3", label: "Rechtwinklige Dreiecke", hours: 20 },
+      { id: "lb4", label: "Kreis", hours: 10 },
+      { id: "lb5", label: "Raumgeometrie", hours: 20 },
+      { id: "lb6", label: "Systeme linearer Gleichungen", hours: 12 },
+      {
+        id: "lb7",
+        label: "Quadratische Funktionen und quadratische Gleichungen",
+        hours: 42
+      },
+      { id: "lb8", label: "Daten und Zufall", hours: 9 }
+    ],
+    "realschule|9|mathematik|wpfg2-3": [
+      { id: "lb1", label: "Reelle Zahlen", hours: 7 },
+      { id: "lb2", label: "Zentrische Streckung", hours: 13 },
       { id: "lb3", label: "Rechtwinklige Dreiecke", hours: 20 },
       { id: "lb4", label: "Kreis", hours: 10 },
       { id: "lb5", label: "Lineare Funktionen", hours: 15 },
       { id: "lb6", label: "Systeme linearer Gleichungen", hours: 10 },
       { id: "lb7", label: "Daten und Zufall", hours: 9 }
     ],
-    "realschule|9|deutsch": [
-      { id: "lb1", label: "Sprechen und Zuh\xF6ren" },
-      { id: "lb2", label: "Lesen \u2013 mit Texten und weiteren Medien umgehen" },
-      { id: "lb3", label: "Schreiben" },
-      {
-        id: "lb4",
-        label: "Sprachgebrauch und Sprache untersuchen und reflektieren"
-      }
+    "realschule|9|deutsch": [
+      { id: "lb1", label: "Sprechen und Zuh\xF6ren" },
+      { id: "lb2", label: "Lesen \u2013 mit Texten und weiteren Medien umgehen" },
+      { id: "lb3", label: "Schreiben" },
+      {
+        id: "lb4",
+        label: "Sprachgebrauch und Sprache untersuchen und reflektieren"
+      }
+    ],
+    "realschule|9|englisch": [
+      { id: "lb1", label: "Kommunikative Kompetenzen" },
+      { id: "lb2", label: "Interkulturelle Kompetenzen" },
+      { id: "lb3", label: "Text- und Medienkompetenzen" },
+      { id: "lb4", label: "Methodische Kompetenzen" },
+      { id: "lb5", label: "Themengebiete" }
+    ]
+  },
+  contentUrls: {
+    "realschule|9|mathematik|wpfg1": "https://www.lehrplanplus.bayern.de/schulart/realschule/jgs/9/fach/mathematik/inhalt/fachlehrplaene?w_schulart=realschule&wt_1=schulart&w_fach=mathematik&wt_2=fach&w_jgs=9&wt_3=jgs&w_auspraegung=wpfg1",
+    "realschule|9|mathematik|wpfg2-3": "https://www.lehrplanplus.bayern.de/schulart/realschule/jgs/9/fach/mathematik/inhalt/fachlehrplaene?w_schulart=realschule&wt_1=schulart&w_fach=mathematik&wt_2=fach&w_jgs=9&wt_3=jgs&w_auspraegung=wpfg2-3",
+    "realschule|9|deutsch": "https://www.lehrplanplus.bayern.de/schulart/realschule/jgs/9/fach/deutsch/inhalt/fachlehrplaene",
+    "realschule|9|englisch": "https://www.lehrplanplus.bayern.de/schulart/realschule/jgs/9/fach/englisch/inhalt/fachlehrplaene"
+  }
+};
+
+// src/cli/curriculum/providers/lehrplanplus-bayern/index.ts
+function levelKey(schoolType, grade, subject, track) {
+  return track ? `${schoolType}|${grade}|${subject}|${track}` : `${schoolType}|${grade}|${subject}`;
+}
+var lehrplanplusBayernProvider = {
+  id: "lehrplanplus-bayern",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "BY",
+  regionLabel: "Bayern",
+  label: "LehrplanPLUS (Bayern)",
+  listSchoolTypes() {
+    return LEHRPLANPLUS_BAYERN_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (LEHRPLANPLUS_BAYERN_MANIFEST.grades[schoolType] ?? []).map((grade) => ({
+      id: grade,
+      label: grade
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return LEHRPLANPLUS_BAYERN_MANIFEST.subjects[schoolType] ?? [];
+  },
+  listTracks(schoolType, grade, subject) {
+    return LEHRPLANPLUS_BAYERN_MANIFEST.tracks[levelKey(schoolType, grade, subject)] ?? [];
+  },
+  listTopics(selection) {
+    const { schoolType, grade, subject, track } = selection;
+    if (!schoolType || !grade || !subject) return [];
+    const key = levelKey(schoolType, grade, subject, track);
+    return (LEHRPLANPLUS_BAYERN_MANIFEST.topics[key] ?? []).map((topic) => ({
+      ...topic,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = LEHRPLANPLUS_BAYERN_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `LehrplanPLUS Bayern: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}). The manifest only covers the combinations curated as of ${LEHRPLANPLUS_BAYERN_MANIFEST.capturedOn}.`
+      );
+    }
+    return {
+      provider: "lehrplanplus-bayern",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const chunks = html.split('<div id="thema_');
+    const sections = [];
+    for (let i = 1; i < chunks.length; i++) {
+      const chunk = chunks[i];
+      const quoteIdx = chunk.indexOf('"');
+      if (quoteIdx === -1) continue;
+      const id = chunk.slice(0, quoteIdx);
+      const classStart = chunk.indexOf('class="');
+      if (classStart === -1) continue;
+      const classEnd = chunk.indexOf('"', classStart + 7);
+      const classContent = chunk.slice(classStart + 7, classEnd);
+      const lvlMatch = classContent.match(/headline_lvl(\d+)/);
+      if (!lvlMatch) continue;
+      const level = parseInt(lvlMatch[1], 10);
+      const contentHtml = chunk.slice(classEnd + 1);
+      const headerMatch = contentHtml.match(
+        /<a[^>]*class="paragraph_toggle"[^>]*>([\s\S]*?)<\/a>/i
+      );
+      const headerText = headerMatch ? cleanHtmlText12(headerMatch[1]).trim() : "";
+      sections.push({
+        id,
+        level,
+        headerText,
+        contentHtml
+      });
+    }
+    const results = {};
+    for (const topicId of topicIds) {
+      let label = "";
+      for (const key of Object.keys(LEHRPLANPLUS_BAYERN_MANIFEST.topics)) {
+        const list = LEHRPLANPLUS_BAYERN_MANIFEST.topics[key];
+        const match = list.find(
+          (t2) => t2.id === topicId || `${key}#${t2.id}` === topicId
+        );
+        if (match) {
+          label = match.label;
+          break;
+        }
+      }
+      if (!label) {
+        continue;
+      }
+      const normalizedLabel = normalizeForComparison12(label);
+      const lvl1Index = sections.findIndex((s) => {
+        if (s.level !== 1) return false;
+        const normalizedHeader = normalizeForComparison12(s.headerText);
+        return normalizedHeader.includes(normalizedLabel);
+      });
+      if (lvl1Index === -1) {
+        continue;
+      }
+      const collectedSections = [sections[lvl1Index]];
+      for (let i = lvl1Index + 1; i < sections.length; i++) {
+        if (sections[i].level === 1) {
+          break;
+        }
+        collectedSections.push(sections[i]);
+      }
+      const fullHtml = collectedSections.map((s) => s.contentHtml).join("\n");
+      results[topicId] = cleanHtmlText12(fullHtml);
+    }
+    return results;
+  }
+};
+function cleanHtmlText12(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&ndash;/g, "\u2013").replace(/&mdash;/g, "\u2014").replace(/&middot;/g, "\xB7");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison12(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/rahmenlehrplan-berlin-brandenburg/manifest.ts
+var RAHMENLEHRPLAN_BERLIN_BRANDENBURG_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Gemeinsamer Rahmenlehrplan Berlin-Brandenburg",
+  schoolTypes: [
+    { id: "realschule", label: "Realschule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    realschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    realschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "realschule|10|mathematik": [
+      { id: "funktionen", label: "Funktionen" },
+      { id: "geometrie", label: "Geometrie" },
+      { id: "stochastik", label: "Stochastik" }
+    ],
+    "gymnasium|10|mathematik": [
+      { id: "analysis", label: "Analysis" },
+      { id: "vektoren", label: "Vektoren" }
     ],
-    "realschule|9|englisch": [
-      { id: "lb1", label: "Kommunikative Kompetenzen" },
-      { id: "lb2", label: "Interkulturelle Kompetenzen" },
-      { id: "lb3", label: "Text- und Medienkompetenzen" },
-      { id: "lb4", label: "Methodische Kompetenzen" },
-      { id: "lb5", label: "Themengebiete" }
+    "realschule|9|informatik": [
+      { id: "algorithmen", label: "Algorithmen" },
+      { id: "daten", label: "Daten und Information" }
+    ],
+    "realschule|9|physik": [
+      { id: "mechanik", label: "Mechanik" },
+      { id: "elektrizitaet", label: "Elektrizit\xE4t" }
+    ],
+    "realschule|9|chemie": [
+      { id: "reaktionen", label: "Chemische Reaktionen" },
+      { id: "stoffe", label: "Stoffe" }
+    ],
+    "realschule|9|biologie": [
+      { id: "zellen", label: "Zellen" },
+      { id: "oekologie", label: "\xD6kologie" }
+    ],
+    "gymnasium|9|physik": [
+      { id: "optik", label: "Optik" },
+      { id: "felder", label: "Felder" }
+    ],
+    "gymnasium|9|chemie": [
+      { id: "bindungen", label: "Bindungen" },
+      { id: "saeuren", label: "S\xE4uren und Basen" }
+    ],
+    "gymnasium|9|biologie": [
+      { id: "genetik", label: "Genetik" },
+      { id: "evolution", label: "Evolution" }
     ]
   },
   contentUrls: {
-    "realschule|9|mathematik|wpfg1": "https://www.lehrplanplus.bayern.de/schulart/realschule/jgs/9/fach/mathematik/inhalt/fachlehrplaene?w_schulart=realschule&wt_1=schulart&w_fach=mathematik&wt_2=fach&w_jgs=9&wt_3=jgs&w_auspraegung=wpfg1",
-    "realschule|9|mathematik|wpfg2-3": "https://www.lehrplanplus.bayern.de/schulart/realschule/jgs/9/fach/mathematik/inhalt/fachlehrplaene?w_schulart=realschule&wt_1=schulart&w_fach=mathematik&wt_2=fach&w_jgs=9&wt_3=jgs&w_auspraegung=wpfg2-3",
-    "realschule|9|deutsch": "https://www.lehrplanplus.bayern.de/schulart/realschule/jgs/9/fach/deutsch/inhalt/fachlehrplaene",
-    "realschule|9|englisch": "https://www.lehrplanplus.bayern.de/schulart/realschule/jgs/9/fach/englisch/inhalt/fachlehrplaene"
+    "realschule|10|mathematik": "https://bildungsserver.berlin-brandenburg.de/rlp-online/c-faecher/mathematik",
+    "gymnasium|10|mathematik": "https://bildungsserver.berlin-brandenburg.de/rlp-online/c-faecher/mathematik",
+    "realschule|9|informatik": "https://bildungsserver.berlin-brandenburg.de/rlp-online/c-faecher/informatik",
+    "realschule|9|physik": "https://bildungsserver.berlin-brandenburg.de/rlp-online/c-faecher/physik",
+    "realschule|9|chemie": "https://bildungsserver.berlin-brandenburg.de/rlp-online/c-faecher/chemie",
+    "realschule|9|biologie": "https://bildungsserver.berlin-brandenburg.de/rlp-online/c-faecher/biologie",
+    "gymnasium|9|physik": "https://bildungsserver.berlin-brandenburg.de/rlp-online/c-faecher/physik",
+    "gymnasium|9|chemie": "https://bildungsserver.berlin-brandenburg.de/rlp-online/c-faecher/chemie",
+    "gymnasium|9|biologie": "https://bildungsserver.berlin-brandenburg.de/rlp-online/c-faecher/biologie"
   }
 };
 
-// src/cli/curriculum/providers/lehrplanplus-bayern/index.ts
-function levelKey(schoolType, grade, subject, track) {
-  return track ? `${schoolType}|${grade}|${subject}|${track}` : `${schoolType}|${grade}|${subject}`;
+// src/cli/curriculum/providers/rahmenlehrplan-berlin-brandenburg/index.ts
+var rahmenlehrplanBerlinBrandenburgProvider = {
+  id: "rahmenlehrplan-berlin-brandenburg",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "BE-BB",
+  regionLabel: "Berlin / Brandenburg",
+  label: "Rahmenlehrplan (Berlin-Brandenburg)",
+  listSchoolTypes() {
+    return RAHMENLEHRPLAN_BERLIN_BRANDENBURG_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (RAHMENLEHRPLAN_BERLIN_BRANDENBURG_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return RAHMENLEHRPLAN_BERLIN_BRANDENBURG_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return RAHMENLEHRPLAN_BERLIN_BRANDENBURG_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = RAHMENLEHRPLAN_BERLIN_BRANDENBURG_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = RAHMENLEHRPLAN_BERLIN_BRANDENBURG_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Rahmenlehrplan Berlin-Brandenburg: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
+      );
+    }
+    return {
+      provider: "rahmenlehrplan-berlin-brandenburg",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText13(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText13(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = RAHMENLEHRPLAN_BERLIN_BRANDENBURG_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison13(label);
+      let section = sections.find(
+        (s) => normalizeForComparison13(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText13(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
 }
-var lehrplanplusBayernProvider = {
-  id: "lehrplanplus-bayern",
+function normalizeForComparison13(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/rahmenplan-mv/manifest.ts
+var RAHMENPLAN_MV_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Rahmenpl\xE4ne Mecklenburg-Vorpommern",
+  schoolTypes: [
+    { id: "regionale-schule", label: "Regionale Schule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    "regionale-schule": ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    "regionale-schule": [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "regionale-schule|10|mathematik": [
+      { id: "funktionen", label: "Funktionen" }
+    ],
+    "gymnasium|10|mathematik": [{ id: "analysis", label: "Analysis" }],
+    "regionale-schule|9|physik": [{ id: "mechanik", label: "Mechanik" }],
+    "regionale-schule|9|chemie": [{ id: "reaktionen", label: "Reaktionen" }],
+    "regionale-schule|9|biologie": [{ id: "zellen", label: "Zellen" }],
+    "gymnasium|9|physik": [{ id: "elektrizitaet", label: "Elektrizit\xE4t" }],
+    "gymnasium|9|chemie": [{ id: "bindungen", label: "Bindungen" }],
+    "gymnasium|9|biologie": [{ id: "genetik", label: "Genetik" }]
+  },
+  contentUrls: {
+    "regionale-schule|10|mathematik": "https://www.bildung-mv.de/schueler/schule-und-unterricht/faecher-und-rahmenplaene/rahmenplaene-an-allgemeinbildenden-schulen/",
+    "gymnasium|10|mathematik": "https://www.bildung-mv.de/schueler/schule-und-unterricht/faecher-und-rahmenplaene/rahmenplaene-an-allgemeinbildenden-schulen/",
+    "regionale-schule|9|physik": "https://www.bildung-mv.de/schueler/schule-und-unterricht/faecher-und-rahmenplaene/rahmenplaene-an-allgemeinbildenden-schulen/",
+    "regionale-schule|9|chemie": "https://www.bildung-mv.de/schueler/schule-und-unterricht/faecher-und-rahmenplaene/rahmenplaene-an-allgemeinbildenden-schulen/",
+    "regionale-schule|9|biologie": "https://www.bildung-mv.de/schueler/schule-und-unterricht/faecher-und-rahmenplaene/rahmenplaene-an-allgemeinbildenden-schulen/",
+    "gymnasium|9|physik": "https://www.bildung-mv.de/schueler/schule-und-unterricht/faecher-und-rahmenplaene/rahmenplaene-an-allgemeinbildenden-schulen/",
+    "gymnasium|9|chemie": "https://www.bildung-mv.de/schueler/schule-und-unterricht/faecher-und-rahmenplaene/rahmenplaene-an-allgemeinbildenden-schulen/",
+    "gymnasium|9|biologie": "https://www.bildung-mv.de/schueler/schule-und-unterricht/faecher-und-rahmenplaene/rahmenplaene-an-allgemeinbildenden-schulen/"
+  }
+};
+
+// src/cli/curriculum/providers/rahmenplan-mv/index.ts
+var rahmenplanMvProvider = {
+  id: "rahmenplan-mv",
   country: "DE",
   countryLabel: "Deutschland",
-  region: "BY",
-  regionLabel: "Bayern",
-  label: "LehrplanPLUS (Bayern)",
+  region: "MV",
+  regionLabel: "Mecklenburg-Vorpommern",
+  label: "Rahmenplan (Mecklenburg-Vorpommern)",
   listSchoolTypes() {
-    return LEHRPLANPLUS_BAYERN_MANIFEST.schoolTypes;
+    return RAHMENPLAN_MV_MANIFEST.schoolTypes;
   },
   listGrades(schoolType) {
-    return (LEHRPLANPLUS_BAYERN_MANIFEST.grades[schoolType] ?? []).map((grade) => ({
-      id: grade,
-      label: grade
+    return (RAHMENPLAN_MV_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
     }));
   },
   listSubjects(schoolType, _grade) {
-    return LEHRPLANPLUS_BAYERN_MANIFEST.subjects[schoolType] ?? [];
+    return RAHMENPLAN_MV_MANIFEST.subjects[schoolType] || [];
   },
   listTracks(schoolType, grade, subject) {
-    return LEHRPLANPLUS_BAYERN_MANIFEST.tracks[levelKey(schoolType, grade, subject)] ?? [];
+    const key = `${schoolType}|${grade}|${subject}`;
+    return RAHMENPLAN_MV_MANIFEST.tracks[key] || [];
   },
   listTopics(selection) {
-    const { schoolType, grade, subject, track } = selection;
-    if (!schoolType || !grade || !subject) return [];
-    const key = levelKey(schoolType, grade, subject, track);
-    return (LEHRPLANPLUS_BAYERN_MANIFEST.topics[key] ?? []).map((topic) => ({
-      ...topic,
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = RAHMENPLAN_MV_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
       sourceRef: key
     }));
   },
   resolveTopic(topic) {
-    const uri = LEHRPLANPLUS_BAYERN_MANIFEST.contentUrls[topic.sourceRef];
+    const uri = RAHMENPLAN_MV_MANIFEST.contentUrls[topic.sourceRef];
     if (!uri) {
       throw new Error(
-        `LehrplanPLUS Bayern: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}). The manifest only covers the combinations curated as of ${LEHRPLANPLUS_BAYERN_MANIFEST.capturedOn}.`
+        `Rahmenplan MV: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
       );
     }
     return {
-      provider: "lehrplanplus-bayern",
+      provider: "rahmenplan-mv",
       topicId: `${topic.sourceRef}#${topic.id}`,
       uri
     };
   },
   extractTopics(html, topicIds) {
-    const chunks = html.split('<div id="thema_');
+    const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
     const sections = [];
-    for (let i = 1; i < chunks.length; i++) {
-      const chunk = chunks[i];
-      const quoteIdx = chunk.indexOf('"');
-      if (quoteIdx === -1) continue;
-      const id = chunk.slice(0, quoteIdx);
-      const classStart = chunk.indexOf('class="');
-      if (classStart === -1) continue;
-      const classEnd = chunk.indexOf('"', classStart + 7);
-      const classContent = chunk.slice(classStart + 7, classEnd);
-      const lvlMatch = classContent.match(/headline_lvl(\d+)/);
-      if (!lvlMatch) continue;
-      const level = parseInt(lvlMatch[1], 10);
-      const contentHtml = chunk.slice(classEnd + 1);
-      const headerMatch = contentHtml.match(
-        /<a[^>]*class="paragraph_toggle"[^>]*>([\s\S]*?)<\/a>/i
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText14(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText14(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
+    for (const topicId of topicIds) {
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = RAHMENPLAN_MV_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison14(label);
+      let section = sections.find(
+        (s) => normalizeForComparison14(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
+      }
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
+      }
+    }
+    return results;
+  }
+};
+function cleanHtmlText14(html) {
+  let text = html.replace(
+    /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
+    " "
+  );
+  text = text.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, "\n\n$1\n\n");
+  text = text.replace(/<li[^>]*>/gi, "\n- ");
+  text = text.replace(/<p[^>]*>/gi, "\n");
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function normalizeForComparison14(str) {
+  return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
+}
+
+// src/cli/curriculum/providers/rahmenrichtlinien-st/manifest.ts
+var RAHMENRICHTLINIEN_ST_MANIFEST = {
+  schoolYear: "2025/2026",
+  capturedOn: "2026-07-02",
+  sourceRevision: "Rahmenrichtlinien Sachsen-Anhalt",
+  schoolTypes: [
+    { id: "sekundarschule", label: "Sekundarschule" },
+    { id: "gymnasium", label: "Gymnasium" }
+  ],
+  grades: {
+    sekundarschule: ["7", "8", "9", "10"],
+    gymnasium: ["7", "8", "9", "10"]
+  },
+  subjects: {
+    sekundarschule: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ],
+    gymnasium: [
+      { id: "mathematik", label: "Mathematik" },
+      { id: "informatik", label: "Informatik" },
+      { id: "physik", label: "Physik" },
+      { id: "chemie", label: "Chemie" },
+      { id: "biologie", label: "Biologie" }
+    ]
+  },
+  tracks: {},
+  topics: {
+    "sekundarschule|10|mathematik": [{ id: "funktionen", label: "Funktionen" }],
+    "gymnasium|10|mathematik": [{ id: "analysis", label: "Analysis" }],
+    "sekundarschule|9|physik": [{ id: "mechanik", label: "Mechanik" }],
+    "sekundarschule|9|chemie": [{ id: "reaktionen", label: "Reaktionen" }],
+    "sekundarschule|9|biologie": [{ id: "zellen", label: "Zellen" }],
+    "gymnasium|9|physik": [{ id: "elektrizitaet", label: "Elektrizit\xE4t" }],
+    "gymnasium|9|chemie": [{ id: "bindungen", label: "Bindungen" }],
+    "gymnasium|9|biologie": [{ id: "genetik", label: "Genetik" }]
+  },
+  contentUrls: {
+    "sekundarschule|10|mathematik": "https://lisa.sachsen-anhalt.de/schulqualitaet/lehrplaene-rahmenrichtlinien",
+    "gymnasium|10|mathematik": "https://lisa.sachsen-anhalt.de/schulqualitaet/lehrplaene-rahmenrichtlinien",
+    "sekundarschule|9|physik": "https://lisa.sachsen-anhalt.de/schulqualitaet/lehrplaene-rahmenrichtlinien",
+    "sekundarschule|9|chemie": "https://lisa.sachsen-anhalt.de/schulqualitaet/lehrplaene-rahmenrichtlinien",
+    "sekundarschule|9|biologie": "https://lisa.sachsen-anhalt.de/schulqualitaet/lehrplaene-rahmenrichtlinien",
+    "gymnasium|9|physik": "https://lisa.sachsen-anhalt.de/schulqualitaet/lehrplaene-rahmenrichtlinien",
+    "gymnasium|9|chemie": "https://lisa.sachsen-anhalt.de/schulqualitaet/lehrplaene-rahmenrichtlinien",
+    "gymnasium|9|biologie": "https://lisa.sachsen-anhalt.de/schulqualitaet/lehrplaene-rahmenrichtlinien"
+  }
+};
+
+// src/cli/curriculum/providers/rahmenrichtlinien-st/index.ts
+var rahmenrichtlinienStProvider = {
+  id: "rahmenrichtlinien-st",
+  country: "DE",
+  countryLabel: "Deutschland",
+  region: "ST",
+  regionLabel: "Sachsen-Anhalt",
+  label: "Rahmenrichtlinien (Sachsen-Anhalt)",
+  listSchoolTypes() {
+    return RAHMENRICHTLINIEN_ST_MANIFEST.schoolTypes;
+  },
+  listGrades(schoolType) {
+    return (RAHMENRICHTLINIEN_ST_MANIFEST.grades[schoolType] || []).map((id) => ({
+      id,
+      label: `Klasse ${id}`
+    }));
+  },
+  listSubjects(schoolType, _grade) {
+    return RAHMENRICHTLINIEN_ST_MANIFEST.subjects[schoolType] || [];
+  },
+  listTracks(schoolType, grade, subject) {
+    const key = `${schoolType}|${grade}|${subject}`;
+    return RAHMENRICHTLINIEN_ST_MANIFEST.tracks[key] || [];
+  },
+  listTopics(selection) {
+    const key = selection.track ? `${selection.schoolType}|${selection.grade}|${selection.subject}|${selection.track}` : `${selection.schoolType}|${selection.grade}|${selection.subject}`;
+    const list = RAHMENRICHTLINIEN_ST_MANIFEST.topics[key] || [];
+    return list.map((t2) => ({
+      ...t2,
+      sourceRef: key
+    }));
+  },
+  resolveTopic(topic) {
+    const uri = RAHMENRICHTLINIEN_ST_MANIFEST.contentUrls[topic.sourceRef];
+    if (!uri) {
+      throw new Error(
+        `Rahmenrichtlinien ST: no resolvable source URL for topic "${topic.id}" (${topic.sourceRef}).`
       );
-      const headerText = headerMatch ? cleanHtmlText2(headerMatch[1]).trim() : "";
-      sections.push({
-        id,
-        level,
-        headerText,
-        contentHtml
-      });
     }
+    return {
+      provider: "rahmenrichtlinien-st",
+      topicId: `${topic.sourceRef}#${topic.id}`,
+      uri
+    };
+  },
+  extractTopics(html, topicIds) {
     const results = {};
+    const headingMatches = Array.from(
+      html.matchAll(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi)
+    );
+    const sections = [];
+    for (const m of headingMatches) {
+      const headerText = cleanHtmlText15(m[1]).trim();
+      const start = m.index + m[0].length;
+      const nextHeading = html.indexOf("<h", start);
+      const rawContent = nextHeading > -1 ? html.slice(start, nextHeading) : html.slice(start, start + 1500);
+      const content = cleanHtmlText15(rawContent).slice(0, 1500);
+      if (headerText) sections.push({ header: headerText, content });
+    }
     for (const topicId of topicIds) {
-      let label = "";
-      for (const key of Object.keys(LEHRPLANPLUS_BAYERN_MANIFEST.topics)) {
-        const list = LEHRPLANPLUS_BAYERN_MANIFEST.topics[key];
-        const match = list.find(
-          (t2) => t2.id === topicId || `${key}#${t2.id}` === topicId
-        );
-        if (match) {
-          label = match.label;
-          break;
-        }
-      }
-      if (!label) {
-        continue;
-      }
-      const normalizedLabel = normalizeForComparison2(label);
-      const lvl1Index = sections.findIndex((s) => {
-        if (s.level !== 1) return false;
-        const normalizedHeader = normalizeForComparison2(s.headerText);
-        return normalizedHeader.includes(normalizedLabel);
-      });
-      if (lvl1Index === -1) {
-        continue;
+      const hashIdx = topicId.indexOf("#");
+      if (hashIdx === -1) continue;
+      const key = topicId.substring(0, hashIdx);
+      const shortId = topicId.substring(hashIdx + 1);
+      const list = RAHMENRICHTLINIEN_ST_MANIFEST.topics[key] ?? [];
+      const match = list.find((t2) => t2.id === shortId);
+      if (!match) continue;
+      const label = match.label;
+      const normalizedLabel = normalizeForComparison15(label);
+      let section = sections.find(
+        (s) => normalizeForComparison15(s.header).includes(normalizedLabel) || s.header.toLowerCase().includes(shortId.toLowerCase())
+      );
+      if (!section && sections.length > 0) {
+        section = sections.find((s) => s.content.length > 80) || sections[0];
       }
-      const collectedSections = [sections[lvl1Index]];
-      for (let i = lvl1Index + 1; i < sections.length; i++) {
-        if (sections[i].level === 1) {
-          break;
-        }
-        collectedSections.push(sections[i]);
+      if (section) {
+        results[topicId] = `${label}
+
+${section.content}`.trim();
+      } else {
+        results[topicId] = label;
       }
-      const fullHtml = collectedSections.map((s) => s.contentHtml).join("\n");
-      results[topicId] = cleanHtmlText2(fullHtml);
     }
     return results;
   }
 };
-function cleanHtmlText2(html) {
+function cleanHtmlText15(html) {
   let text = html.replace(
     /<(head|script|style|svg)[^>]*>[\s\S]*?<\/\1>/gi,
     " "
@@ -7839,22 +10339,248 @@ function cleanHtmlText2(html) {
   text = text.replace(/<p[^>]*>/gi, "\n");
   text = text.replace(/<br\s*\/?>/gi, "\n");
   text = text.replace(/<[^>]+>/g, " ");
-  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&ndash;/g, "\u2013").replace(/&mdash;/g, "\u2014").replace(/&middot;/g, "\xB7");
+  text = text.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
   return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
 }
-function normalizeForComparison2(str) {
+function normalizeForComparison15(str) {
   return str.toLowerCase().replace(/&[a-z0-9#]+;/gi, "").replace(/[^a-z0-9]/gi, "");
 }
 
 // src/cli/curriculum/registry.ts
 var CURRICULUM_PROVIDERS = [
   lehrplanplusBayernProvider,
-  bildungsplanBwProvider
+  bildungsplanBwProvider,
+  kernlehrplanNrwProvider,
+  kerncurriculumHessenProvider,
+  kerncurriculumNiedersachsenProvider,
+  lehrplanSachsenProvider,
+  rahmenlehrplanBerlinBrandenburgProvider,
+  bildungsplanHamburgProvider,
+  bildungsplanBremenProvider,
+  rahmenplanMvProvider,
+  lehrplaeneRpProvider,
+  lehrplanSaarlandProvider,
+  rahmenrichtlinienStProvider,
+  fachanforderungenShProvider,
+  lehrplanThueringenProvider
 ];
 function getCurriculumProvider(id) {
   return CURRICULUM_PROVIDERS.find((provider) => provider.id === id);
 }
 
+// src/cli/llm/embedder.ts
+var CANONICAL_EMBEDDING_MODEL_ID = "embeddinggemma-300m";
+var EMBEDDINGGEMMA_ALIASES = /* @__PURE__ */ new Set([
+  "embeddinggemma",
+  "embeddinggemma:300m",
+  "embeddinggemma-300m",
+  "embed-gemma",
+  "embed-gemma:300m",
+  "google/embeddinggemma-300m"
+]);
+function canonicalEmbeddingModelId(model) {
+  const lowered = model.trim().toLowerCase();
+  if (EMBEDDINGGEMMA_ALIASES.has(lowered)) {
+    return CANONICAL_EMBEDDING_MODEL_ID;
+  }
+  return lowered;
+}
+function embeddingTextForToken(t2, model) {
+  const isGemma = EMBEDDINGGEMMA_ALIASES.has(model.trim().toLowerCase());
+  const content = embeddingContentForToken(t2);
+  return isGemma ? `title: none | text: ${content}` : content;
+}
+function embeddingTextForQuery(text, model) {
+  const isGemma = EMBEDDINGGEMMA_ALIASES.has(model.trim().toLowerCase());
+  return isGemma ? `task: search result | query: ${text}` : text;
+}
+async function resolveUsableEmbeddingEndpoint(db) {
+  const cfg = await getProviderForRole(db, "embedding");
+  if (!cfg.enabled) return null;
+  for (const endpoint of [cfg, ...cfg.fallback ? [cfg.fallback] : []]) {
+    if (endpoint.apiFlavor !== "chat-completions") continue;
+    const online = await isLlmOnline(endpoint.url);
+    if (!online) continue;
+    const availableModels = await getAvailableModels(
+      endpoint.url,
+      endpoint.apiKey
+    );
+    const modelAvailable = availableModels.length === 0 || availableModels.some(
+      (candidate) => candidate.toLowerCase() === endpoint.model.toLowerCase()
+    );
+    if (modelAvailable) return endpoint;
+  }
+  return null;
+}
+async function embedTexts(endpoint, texts) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), 6e4);
+  let res;
+  try {
+    res = await fetch(`${endpoint.url}/embeddings`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${endpoint.apiKey || DEFAULT_LLM_API_KEY}`
+      },
+      body: JSON.stringify({ model: endpoint.model, input: texts }),
+      signal: controller.signal
+    });
+  } finally {
+    clearTimeout(timeoutId);
+  }
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(
+      `Embedding request failed: ${res.statusText} (${res.status}) - ${body}`
+    );
+  }
+  const data = await res.json();
+  const items = data.data ?? [];
+  if (items.length !== texts.length) {
+    throw new Error(
+      `Embedding response returned ${items.length} vectors for ${texts.length} inputs`
+    );
+  }
+  const ordered = new Array(texts.length);
+  for (let i = 0; i < items.length; i++) {
+    const item = items[i];
+    const index = typeof item.index === "number" ? item.index : i;
+    if (!Number.isInteger(index)) {
+      throw new Error("Embedding response item is missing a valid index");
+    }
+    if (index < 0 || index >= texts.length) {
+      throw new Error(`Embedding response index out of range: ${index}`);
+    }
+    if (!Array.isArray(item.embedding) || item.embedding.length === 0 || !item.embedding.every((n) => typeof n === "number" && Number.isFinite(n))) {
+      throw new Error(
+        `Embedding response at index ${index} is not a non-empty array of finite numbers`
+      );
+    }
+    ordered[index] = item.embedding;
+  }
+  const firstLength = ordered[0]?.length;
+  if (ordered.some((vec) => vec === void 0 || vec.length !== firstLength)) {
+    throw new Error("Embedding response vectors have inconsistent lengths");
+  }
+  return ordered;
+}
+var EMBED_BATCH_SIZE = 16;
+async function ensureTokenEmbeddings(db, opts) {
+  const endpoint = await resolveUsableEmbeddingEndpoint(db);
+  if (!endpoint) {
+    const reason = await describeUnavailableReason(db);
+    return { status: "unavailable", embedded: 0, remaining: 0, reason };
+  }
+  const model = canonicalEmbeddingModelId(endpoint.model);
+  const pending = await listTokensNeedingEmbedding(db, model, {
+    limit: opts?.limit ?? 64,
+    force: opts?.force,
+    dims: opts?.dims
+  });
+  let embedded = 0;
+  let failure;
+  try {
+    for (let i = 0; i < pending.length; i += EMBED_BATCH_SIZE) {
+      const batch = pending.slice(i, i + EMBED_BATCH_SIZE);
+      const formattedTexts = batch.map(
+        (item) => embeddingTextForToken(item.token, endpoint.model)
+      );
+      const vectors = await embedTexts(
+        { url: endpoint.url, model: endpoint.model, apiKey: endpoint.apiKey },
+        formattedTexts
+      );
+      for (const [index, item] of batch.entries()) {
+        await upsertTokenEmbedding(db, {
+          tokenId: item.token.id,
+          embedding: vectors[index],
+          model,
+          contentHash: computeContentHash(item.text)
+        });
+        embedded++;
+      }
+    }
+  } catch (err) {
+    failure = err instanceof Error ? err.message : String(err);
+  }
+  const coverage = await getEmbeddingCoverage(db, model, { dims: opts?.dims });
+  const remaining = coverage.missing + coverage.stale;
+  if (failure !== void 0) {
+    return { status: "unavailable", embedded, remaining, reason: failure };
+  }
+  return { status: "ok", embedded, remaining };
+}
+async function describeUnavailableReason(db) {
+  const cfg = await getProviderForRole(db, "embedding");
+  if (!cfg.enabled) {
+    return "embedding role is disabled in settings (llm.enabled)";
+  }
+  const endpoints = [cfg, ...cfg.fallback ? [cfg.fallback] : []];
+  const online = await Promise.all(
+    endpoints.map((endpoint) => isLlmOnline(endpoint.url))
+  );
+  if (!online.some(Boolean)) {
+    return `embedding endpoints offline (${endpoints.map((endpoint) => endpoint.url).join(", ")})`;
+  }
+  return `no configured embedding model is available (${endpoints.map((endpoint) => endpoint.model).join(", ")})`;
+}
+async function embedQuery(db, text) {
+  const endpoint = await resolveUsableEmbeddingEndpoint(db);
+  if (!endpoint) return null;
+  try {
+    const [vector] = await embedTexts(
+      { url: endpoint.url, model: endpoint.model, apiKey: endpoint.apiKey },
+      [embeddingTextForQuery(text, endpoint.model)]
+    );
+    return { vector, model: canonicalEmbeddingModelId(endpoint.model) };
+  } catch {
+    return null;
+  }
+}
+async function findPossibleDuplicates(db, candidate, embed = embedQuery) {
+  const queryText = embeddingContentForToken({
+    concept: candidate.concept,
+    question: candidate.question ?? null,
+    domain: candidate.domain ?? ""
+  });
+  const q2 = await embed(db, queryText);
+  if (!q2) {
+    return [];
+  }
+  const coverage = await getEmbeddingCoverage(db, q2.model, {
+    dims: q2.vector.length
+  });
+  const totalNeeding = coverage.missing + coverage.stale;
+  if (totalNeeding > 0) {
+    await ensureTokenEmbeddings(db, { limit: 100, dims: q2.vector.length });
+    if (totalNeeding > 100) {
+      console.warn(
+        `Warning: Duplicate check is incomplete. ${totalNeeding - 100} tokens are still missing embeddings. Run 'zam token reembed' to complete indexing.`
+      );
+    }
+  }
+  const thresholdStr = await getSetting(db, "search.dedup_threshold");
+  const parsed = thresholdStr ? Number.parseFloat(thresholdStr) : Number.NaN;
+  const threshold = Number.isFinite(parsed) && parsed > 0 && parsed <= 1 ? parsed : 0.85;
+  const hits = await searchTokensHybrid(db, queryText, {
+    queryEmbedding: q2.vector,
+    model: q2.model,
+    limit: 1e3,
+    vectorTopK: 1e3
+  });
+  const results = [];
+  for (const hit of hits) {
+    if (hit.similarity !== null && hit.similarity >= threshold) {
+      results.push({
+        slug: hit.slug,
+        concept: hit.concept,
+        similarity: hit.similarity
+      });
+    }
+  }
+  return results;
+}
+
 // src/cli/llm/vision.ts
 import { randomBytes } from "crypto";
 import { readFileSync as readFileSync10 } from "fs";
@@ -8294,7 +11020,7 @@ var VALID_API_FLAVORS = [
   "chat-completions",
   "anthropic-messages"
 ];
-var VALID_ROLES = ["vision", "recall", "text"];
+var VALID_ROLES = ["vision", "recall", "text", "embedding"];
 function upsertProviderRecord(providers, name, patch) {
   const merged = { ...providers[name] ?? {} };
   if (patch.url !== void 0) merged.url = patch.url;
@@ -8927,14 +11653,23 @@ async function backupDatabaseTo(db, targetDir) {
 
 // src/cli/commands/bridge.ts
 var isServeMode = false;
+var serveStdinPayload;
 function jsonOut2(data) {
   console.log(JSON.stringify(data, null, 2));
 }
 function jsonError(message) {
+  let msg = message;
+  if (message.startsWith('{"error":')) {
+    try {
+      const parsed = JSON.parse(message);
+      msg = parsed.error;
+    } catch {
+    }
+  }
   if (isServeMode) {
-    throw new Error(JSON.stringify({ error: message }));
+    throw new Error(JSON.stringify({ error: msg }));
   }
-  console.log(JSON.stringify({ error: message }, null, 2));
+  console.log(JSON.stringify({ error: msg }, null, 2));
   process.exit(1);
 }
 function parseNonNegativeIntegerOption(name, value) {
@@ -9257,7 +11992,10 @@ bridgeCommand.command("agent-open").description("Launch an agent harness in the
     });
   });
 });
-bridgeCommand.command("get-review").description("Get next review card with prompt (JSON)").option("--user <id>", "User ID (default: whoami)").option("--no-resolve", "Skip resolving the token's source_link into context").action(async (opts) => {
+bridgeCommand.command("get-review").description("Get next review card with prompt (JSON)").option("--user <id>", "User ID (default: whoami)").option("--no-resolve", "Skip resolving the token's source_link into context").option(
+  "--no-dynamic-question",
+  "Use the stored question without generating a fresh LLM question"
+).action(async (opts) => {
   await withDb2(async (db) => {
     const userId = await resolveUser(opts, db, { json: true });
     const queue = await buildReviewQueue(db, {
@@ -9281,7 +12019,7 @@ bridgeCommand.command("get-review").description("Get next review card with promp
     let resolvedQuestion = item.question;
     let questionSource = "original";
     let questionModel;
-    if (isLlmEnabled) {
+    if (isLlmEnabled && opts.dynamicQuestion !== false) {
       try {
         const healed = await ensureHighQualityQuestion(db, {
           id: item.tokenId,
@@ -9528,11 +12266,16 @@ bridgeCommand.command("analyze-monitor").description("Analyze monitor log with t
       });
       return;
     }
-    const chunks = [];
-    for await (const chunk of process.stdin) {
-      chunks.push(chunk);
+    let raw;
+    if (isServeMode) {
+      raw = serveStdinPayload ?? "";
+    } else {
+      const chunks = [];
+      for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+      }
+      raw = Buffer.concat(chunks).toString("utf-8").trim();
     }
-    const raw = Buffer.concat(chunks).toString("utf-8").trim();
     if (!raw) {
       jsonError("No input received on stdin. Pipe JSON with token patterns.");
     }
@@ -9557,13 +12300,17 @@ bridgeCommand.command("analyze-monitor").description("Analyze monitor log with t
   }
 });
 bridgeCommand.command("add-token").description("Create a token + card from JSON stdin").option("--user <id>", "User ID (default: whoami)").action(async (opts) => {
-  let db;
-  try {
-    const chunks = [];
-    for await (const chunk of process.stdin) {
-      chunks.push(chunk);
+  await withDb2(async (db) => {
+    let raw;
+    if (isServeMode) {
+      raw = serveStdinPayload ?? "";
+    } else {
+      const chunks = [];
+      for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+      }
+      raw = Buffer.concat(chunks).toString("utf-8").trim();
     }
-    const raw = Buffer.concat(chunks).toString("utf-8").trim();
     if (!raw) {
       jsonError("No input received on stdin. Pipe JSON with token data.");
     }
@@ -9576,8 +12323,12 @@ bridgeCommand.command("add-token").description("Create a token + card from JSON
     if (!data?.slug || !data?.concept) {
       jsonError("JSON must include 'slug' and 'concept' fields");
     }
-    db = await openDatabase();
     const userId = await resolveUser(opts, db, { json: true });
+    const possibleDuplicates = await findPossibleDuplicates(db, {
+      concept: data?.concept,
+      question: data?.question ?? null,
+      domain: data?.domain
+    });
     const token = await createToken(db, {
       slug: data?.slug,
       concept: data?.concept,
@@ -9589,6 +12340,10 @@ bridgeCommand.command("add-token").description("Create a token + card from JSON
       question: data?.question ?? null
     });
     const card = await ensureCard(db, token.id, userId);
+    try {
+      await ensureTokenEmbeddings(db, { limit: 8 });
+    } catch {
+    }
     jsonOut2({
       success: true,
       token,
@@ -9599,15 +12354,79 @@ bridgeCommand.command("add-token").description("Create a token + card from JSON
         state: card.state,
         dueAt: card.due_at,
         blocked: card.blocked
+      },
+      possible_duplicates: possibleDuplicates
+    });
+  });
+});
+bridgeCommand.command("relevant-tokens").description("Find tokens relevant to a given context").option("--user <id>", "User ID (default: whoami)").action(async (opts) => {
+  await withDb2(async (db) => {
+    let raw;
+    if (isServeMode) {
+      raw = serveStdinPayload ?? "";
+    } else {
+      const chunks = [];
+      for await (const chunk of process.stdin) {
+        chunks.push(chunk);
       }
+      raw = Buffer.concat(chunks).toString("utf-8").trim();
+    }
+    if (!raw) {
+      jsonError("No input received on stdin. Pipe JSON with context.");
+    }
+    let data;
+    try {
+      data = JSON.parse(raw);
+    } catch {
+      jsonError("Invalid JSON input");
+    }
+    if (!data?.context || data.context.trim() === "") {
+      jsonError("JSON must include a non-empty 'context' field");
+    }
+    const userId = await resolveUser(opts, db, { json: true });
+    const truncatedContext = data.context.slice(0, 2e3);
+    const q2 = await embedQuery(db, truncatedContext);
+    try {
+      await ensureTokenEmbeddings(db, {
+        limit: 32,
+        dims: q2?.vector.length
+      });
+    } catch {
+    }
+    let limit = data.limit ?? 10;
+    if (typeof limit !== "number" || limit <= 0 || !Number.isInteger(limit)) {
+      limit = 10;
+    }
+    if (limit > 100) {
+      limit = 100;
+    }
+    const results = await searchTokensHybrid(db, truncatedContext, {
+      queryEmbedding: q2?.vector,
+      model: q2?.model,
+      limit
     });
-    await db.close();
-  } catch (err) {
-    await db?.close();
-    if (err.message) {
-      jsonError(err.message);
+    const tokens = [];
+    for (const t2 of results) {
+      const card = await getCard(db, t2.id, userId);
+      tokens.push({
+        slug: t2.slug,
+        concept: t2.concept,
+        domain: t2.domain,
+        bloom_level: t2.bloom_level,
+        score: t2.score,
+        similarity: t2.similarity,
+        card: card ? {
+          state: card.state,
+          due_at: card.due_at,
+          blocked: card.blocked
+        } : null
+      });
     }
-  }
+    jsonOut2({
+      semantic: q2 !== null,
+      tokens
+    });
+  });
 });
 bridgeCommand.command("discover-skills").description(
   "Analyze monitor logs across sessions to discover recurring patterns"
@@ -10417,12 +13236,13 @@ bridgeCommand.command("check-llm").description("Check if LLM is enabled and onli
 });
 bridgeCommand.command("provider-status").description("Show secret-safe provider status for LLM roles (JSON)").action(async () => {
   await withDb2(async (db) => {
-    const [recall, vision, text] = await Promise.all([
+    const [recall, vision, text, embedding] = await Promise.all([
       getProviderRoleStatus(db, "recall"),
       getProviderRoleStatus(db, "vision"),
-      getProviderRoleStatus(db, "text")
+      getProviderRoleStatus(db, "text"),
+      getProviderRoleStatus(db, "embedding")
     ]);
-    jsonOut2({ roles: { recall, vision, text } });
+    jsonOut2({ roles: { recall, vision, text, embedding } });
   });
 });
 bridgeCommand.command("provider-config-list").description("List provider records and role bindings (JSON)").option("--scope <scope>", "machine (default) or shared", "machine").action(async (opts) => {
@@ -10728,6 +13548,46 @@ bridgeCommand.command("get-settings").description("Get active ZAM settings (JSON
     });
   });
 });
+async function readDatabaseUserSummaries(db) {
+  return await db.prepare(
+    `SELECT user_id AS id, COUNT(*) AS cardCount
+       FROM cards
+       GROUP BY user_id
+       ORDER BY user_id`
+  ).all();
+}
+bridgeCommand.command("database-status").description("Show the active database target and learning profiles (JSON)").action(async () => {
+  const target = getDatabaseTargetInfo();
+  await withDb2(async (db) => {
+    const userId = await getSetting(db, "user.id") ?? null;
+    const users = await readDatabaseUserSummaries(db);
+    jsonOut2({
+      success: true,
+      connected: true,
+      target,
+      userId,
+      cardCount: users.find((user) => user.id === userId)?.cardCount ?? 0,
+      users
+    });
+  });
+});
+bridgeCommand.command("database-select-user").description("Select an existing learning profile for this database (JSON)").requiredOption("--user <id>", "Existing user ID").action(async (opts) => {
+  await withDb2(async (db) => {
+    const userId = String(opts.user ?? "").trim();
+    const users = await readDatabaseUserSummaries(db);
+    const selected = users.find((user) => user.id === userId);
+    if (!selected) {
+      jsonError(`Learning profile not found: ${userId}`);
+      return;
+    }
+    await setSetting(db, "user.id", userId);
+    jsonOut2({
+      success: true,
+      userId,
+      cardCount: selected.cardCount
+    });
+  });
+});
 bridgeCommand.command("list-tokens").description(
   "List tokens (optionally enriched with user card state for viz) (JSON)"
 ).option(
@@ -11302,7 +14162,7 @@ async function fetchRawHtml(url) {
     const res = await fetch(url, {
       signal: controller.signal,
       headers: {
-        "User-Agent": "ZAM-Content-Studio/0.6.1"
+        "User-Agent": "ZAM-Content-Studio/0.6.3"
       }
     });
     if (!res.ok) {
@@ -11452,6 +14312,13 @@ bridgeCommand.command("serve").description("Start the persistent JSON-RPC stdin/
       requestId = req.id ?? null;
       const cmd = req.cmd;
       const args = req.args ?? [];
+      if (typeof req.stdin === "string") {
+        serveStdinPayload = req.stdin;
+      } else if (typeof req.stdin === "object" && req.stdin !== null) {
+        serveStdinPayload = JSON.stringify(req.stdin);
+      } else {
+        serveStdinPayload = void 0;
+      }
       if (!cmd) {
         return JSON.stringify({
           id: requestId,
@@ -11506,6 +14373,8 @@ bridgeCommand.command("serve").description("Start the persistent JSON-RPC stdin/
         id: requestId,
         error: `Invalid JSON request: ${err.message}`
       });
+    } finally {
+      serveStdinPayload = void 0;
     }
   };
   const readline = await import("readline");
@@ -14511,7 +17380,7 @@ import { Command as Command20 } from "commander";
 var tokenCommand = new Command20("token").description(
   "Manage knowledge tokens"
 );
-tokenCommand.command("register").description("Register a new knowledge token").requiredOption("--slug <slug>", "Unique token slug").requiredOption("--concept <concept>", "Concept description").option("--domain <domain>", "Knowledge domain", "").option("--bloom <level>", "Bloom taxonomy level (1-5)", "1").option("--source-link <link>", "Source file path or reference URL", "").option("--question <question>", "Specific question prompt for recall", "").option("--json", "Output as JSON").option("--quiet", "Suppress output (exit code only)").action(async (opts) => {
+tokenCommand.command("register").description("Register a new knowledge token").requiredOption("--slug <slug>", "Unique token slug").requiredOption("--concept <concept>", "Concept description").option("--domain <domain>", "Knowledge domain", "").option("--bloom <level>", "Bloom taxonomy level (1-5)", "1").option("--source-link <link>", "Source file path or reference URL", "").option("--question <question>", "Specific question prompt for recall", "").option("--user <id>", "Owner of the personal card (default: whoami)").option("--no-card", "Register the token only; do not create a personal card").option("--json", "Output as JSON").option("--quiet", "Suppress output (exit code only)").action(async (opts) => {
   await withDb(async (db) => {
     let question = opts.question || null;
     if (!question) {
@@ -14521,6 +17390,11 @@ tokenCommand.command("register").description("Register a new knowledge token").r
         opts.domain
       );
     }
+    const possibleDuplicates = await findPossibleDuplicates(db, {
+      concept: opts.concept,
+      question,
+      domain: opts.domain
+    });
     const token = await createToken(db, {
       slug: opts.slug,
       concept: opts.concept,
@@ -14529,9 +17403,30 @@ tokenCommand.command("register").description("Register a new knowledge token").r
       source_link: opts.sourceLink || null,
       question
     });
+    let cardUserId = null;
+    if (opts.card !== false) {
+      cardUserId = opts.user ?? await getSetting(db, "user.id");
+      if (cardUserId) {
+        await ensureCard(db, token.id, cardUserId);
+      }
+    }
+    try {
+      await ensureTokenEmbeddings(db, { limit: 8 });
+    } catch {
+    }
     if (opts.quiet) return;
     if (opts.json) {
-      console.log(JSON.stringify(token, null, 2));
+      console.log(
+        JSON.stringify(
+          {
+            ...token,
+            card: cardUserId ? { userId: cardUserId } : null,
+            possible_duplicates: possibleDuplicates
+          },
+          null,
+          2
+        )
+      );
     } else {
       console.log(`Registered token: ${token.slug} (${token.id})`);
       console.log(`  Concept:  ${token.concept}`);
@@ -14541,12 +17436,41 @@ tokenCommand.command("register").description("Register a new knowledge token").r
       if (token.source_link) {
         console.log(`  Source:   ${token.source_link}`);
       }
+      if (cardUserId) {
+        console.log(`  Card:     created for ${cardUserId}`);
+      } else if (opts.card === false) {
+        console.log(`  Card:     skipped (--no-card)`);
+      } else {
+        console.log(`  Card:     skipped (no default user set)`);
+      }
+      if (possibleDuplicates.length > 0) {
+        console.log(`
+WARNING: Possible duplicate tokens found:`);
+        for (const dup of possibleDuplicates) {
+          console.log(
+            `  - ${dup.slug} (similarity: ${dup.similarity.toFixed(2)})`
+          );
+        }
+      }
     }
   });
 });
 tokenCommand.command("find").description("Fuzzy search for tokens").requiredOption("--query <query>", "Search query").option("--json", "Output as JSON").option("--quiet", "Suppress output (exit code only)").action(async (opts) => {
   await withDb(async (db) => {
-    const results = await findTokens(db, opts.query);
+    const q2 = await embedQuery(db, opts.query);
+    const embRes = await ensureTokenEmbeddings(db, {
+      limit: 32,
+      dims: q2?.vector.length
+    });
+    if (embRes.status === "unavailable" && !opts.json && !opts.quiet) {
+      console.error(
+        `Note: semantic search unavailable (${embRes.reason}) \u2014 lexical matches only.`
+      );
+    }
+    const results = await searchTokensHybrid(db, opts.query, {
+      queryEmbedding: q2?.vector,
+      model: q2?.model
+    });
     if (opts.quiet) return;
     if (opts.json) {
       console.log(JSON.stringify(results, null, 2));
@@ -14559,12 +17483,14 @@ tokenCommand.command("find").description("Fuzzy search for tokens").requiredOpti
     console.log(`Found ${results.length} token(s):
 `);
     console.log(
-      "Score  Slug                  Concept                         Domain      Bloom"
+      "Score  Sim  Slug                  Concept                         Domain      Bloom"
     );
-    console.log("\u2500".repeat(90));
+    console.log("\u2500".repeat(95));
     for (const t2 of results) {
+      const scoreStr = t2.score.toFixed(3).padEnd(6);
+      const simStr = (t2.similarity?.toFixed(2) ?? "-").padEnd(4);
       console.log(
-        `${String(t2.score).padEnd(6)} ${t2.slug.padEnd(21)} ${t2.concept.slice(0, 31).padEnd(31)} ${(t2.domain || "-").padEnd(11)} ${t2.bloom_level}`
+        `${scoreStr} ${simStr} ${t2.slug.padEnd(21)} ${t2.concept.slice(0, 31).padEnd(31)} ${(t2.domain || "-").padEnd(11)} ${t2.bloom_level}`
       );
     }
   });
@@ -14792,6 +17718,56 @@ tokenCommand.command("status").description("Show full status of a token for a us
     }
   });
 });
+tokenCommand.command("reembed").description("Backfill or refresh semantic-search embeddings for tokens").option("--all", "Force re-embed every token, including already-fresh ones").option("--json", "Output as JSON").option("--quiet", "Suppress output (exit code only)").action(async (opts) => {
+  await withDb(async (db) => {
+    const probe = await embedQuery(db, "ZAM embedding dimension probe");
+    const model = probe?.model ?? null;
+    const dims = probe?.vector.length;
+    const before = model ? await getEmbeddingCoverage(db, model, { dims }) : { tokens: 0, embedded: 0, missing: 0, stale: 0 };
+    let embedded = 0;
+    let reason;
+    let force = Boolean(opts.all);
+    while (true) {
+      const result = await ensureTokenEmbeddings(
+        db,
+        force ? { force: true, limit: Number.MAX_SAFE_INTEGER, dims } : { dims }
+      );
+      force = false;
+      embedded += result.embedded;
+      if (result.status === "unavailable") {
+        reason = result.reason;
+        break;
+      }
+      if (result.remaining === 0 || result.embedded === 0) break;
+    }
+    if (reason !== void 0) {
+      if (opts.quiet) {
+        process.exit(1);
+      }
+      if (opts.json) {
+        jsonOut({ error: reason, embedded });
+      } else {
+        console.error(`Error: ${reason}`);
+        if (embedded > 0) {
+          console.error(
+            `(${embedded} token(s) were embedded before the failure)`
+          );
+        }
+      }
+      process.exit(1);
+    }
+    const after = await getEmbeddingCoverage(db, model, { dims });
+    if (opts.quiet) return;
+    const staleBefore = before.missing + before.stale;
+    if (opts.json) {
+      jsonOut({ embedded, model, before, after });
+      return;
+    }
+    console.log(
+      `Embedded ${embedded} tokens (${after.tokens} total, ${staleBefore} stale before) with ${model}`
+    );
+  });
+});
 
 // src/cli/commands/ui.ts
 import { spawn as spawn3, spawnSync } from "child_process";