zam-core 0.7.1 → 0.8.0

package/dist/index.js

@@ -530,6 +530,7 @@ var SCHEMA = `
 CREATE TABLE IF NOT EXISTS tokens (
   id            TEXT PRIMARY KEY,
   slug          TEXT UNIQUE NOT NULL,
+  title         TEXT NOT NULL DEFAULT '',
   concept       TEXT NOT NULL,
   domain        TEXT NOT NULL DEFAULT '',
   bloom_level   INTEGER NOT NULL DEFAULT 1 CHECK (bloom_level BETWEEN 1 AND 5),
@@ -668,6 +669,22 @@ CREATE TABLE IF NOT EXISTS agent_skills (
   updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
 );
 
+-- Knowledge contexts: work, school, private
+CREATE TABLE IF NOT EXISTS contexts (
+  id         TEXT PRIMARY KEY,
+  name       TEXT NOT NULL UNIQUE,
+  label      TEXT,
+  language   TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Join table mapping tokens to their knowledge contexts
+CREATE TABLE IF NOT EXISTS token_contexts (
+  token_id   TEXT NOT NULL REFERENCES tokens(id) ON DELETE CASCADE,
+  context_id TEXT NOT NULL REFERENCES contexts(id) ON DELETE CASCADE,
+  PRIMARY KEY (token_id, context_id)
+);
+
 -- Performance indexes
 CREATE INDEX IF NOT EXISTS idx_tokens_domain ON tokens(domain);
 CREATE INDEX IF NOT EXISTS idx_tokens_slug ON tokens(slug);
@@ -678,6 +695,8 @@ CREATE INDEX IF NOT EXISTS idx_cards_token_user ON cards(token_id, user_id);
 CREATE INDEX IF NOT EXISTS idx_review_logs_card ON review_logs(card_id);
 CREATE INDEX IF NOT EXISTS idx_review_logs_user ON review_logs(user_id, reviewed_at);
 CREATE INDEX IF NOT EXISTS idx_session_steps_session ON session_steps(session_id);
+CREATE INDEX IF NOT EXISTS idx_tokens_title ON tokens(title);
+CREATE INDEX IF NOT EXISTS idx_token_contexts_context ON token_contexts(context_id);
 `;
 
 // src/kernel/db/sync-adapter.ts
@@ -1011,6 +1030,34 @@ async function runMigrations(db) {
       embedded_at  TEXT NOT NULL DEFAULT (datetime('now'))
     )
   `);
+  if (!tokenCols.some((c) => c.name === "title")) {
+    await db.exec(
+      `ALTER TABLE tokens ADD COLUMN title TEXT NOT NULL DEFAULT ''`
+    );
+  }
+  await db.exec(`CREATE INDEX IF NOT EXISTS idx_tokens_title ON tokens(title)`);
+  await db.exec(
+    `CREATE INDEX IF NOT EXISTS idx_tokens_domain ON tokens(domain)`
+  );
+  await db.exec(`
+    CREATE TABLE IF NOT EXISTS contexts (
+      id         TEXT PRIMARY KEY,
+      name       TEXT NOT NULL UNIQUE,
+      label      TEXT,
+      language   TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+  await db.exec(`
+    CREATE TABLE IF NOT EXISTS token_contexts (
+      token_id   TEXT NOT NULL REFERENCES tokens(id) ON DELETE CASCADE,
+      context_id TEXT NOT NULL REFERENCES contexts(id) ON DELETE CASCADE,
+      PRIMARY KEY (token_id, context_id)
+    )
+  `);
+  await db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_token_contexts_context ON token_contexts(context_id)
+  `);
 }
 
 // src/kernel/db/snapshot.ts
@@ -1474,24 +1521,27 @@ async function deleteCardForUser(db, tokenId, userId) {
   await db.prepare("DELETE FROM cards WHERE id = ?").run(card.id);
   return { card, impact };
 }
-async function getDueCards(db, userId, now, domain) {
+async function getDueCards(db, userId, now, domain, knowledgeContext) {
   const cutoff = now ?? (/* @__PURE__ */ new Date()).toISOString();
+  let sql = `SELECT c.*, t.slug, t.concept, t.domain, t.bloom_level
+    FROM cards c
+    JOIN tokens t ON t.id = c.token_id
+    WHERE c.user_id = ? AND c.blocked = 0 AND c.due_at <= ?`;
+  const params = [userId, cutoff];
   if (domain) {
-    return await db.prepare(
-      `SELECT c.*, t.slug, t.concept, t.domain, t.bloom_level
-         FROM cards c
-         JOIN tokens t ON t.id = c.token_id
-         WHERE c.user_id = ? AND c.blocked = 0 AND c.due_at <= ? AND t.domain = ?
-         ORDER BY t.bloom_level ASC, c.due_at ASC`
-    ).all(userId, cutoff, domain);
+    sql += " AND t.domain = ?";
+    params.push(domain);
   }
-  return await db.prepare(
-    `SELECT c.*, t.slug, t.concept, t.domain, t.bloom_level
-       FROM cards c
-       JOIN tokens t ON t.id = c.token_id
-       WHERE c.user_id = ? AND c.blocked = 0 AND c.due_at <= ?
-       ORDER BY t.bloom_level ASC, c.due_at ASC`
-  ).all(userId, cutoff);
+  if (knowledgeContext) {
+    sql += ` AND EXISTS (
+      SELECT 1 FROM token_contexts tc
+      INNER JOIN contexts context_filter ON context_filter.id = tc.context_id
+      WHERE tc.token_id = t.id AND context_filter.name = ?
+    )`;
+    params.push(knowledgeContext);
+  }
+  sql += " ORDER BY t.bloom_level ASC, c.due_at ASC";
+  return await db.prepare(sql).all(...params);
 }
 async function getBlockedCards(db, userId) {
   return await db.prepare(
@@ -1503,21 +1553,128 @@ async function getBlockedCards(db, userId) {
   ).all(userId);
 }
 
-// src/kernel/models/token.ts
+// src/kernel/models/knowledge-context.ts
 import { ulid as ulid3 } from "ulid";
-async function createToken(db, input) {
+function normalizeContextName(name) {
+  const normalized = name.trim();
+  if (!normalized) {
+    throw new Error("Context name cannot be empty");
+  }
+  return normalized;
+}
+function normalizeOptionalText(value) {
+  if (value == null) return null;
+  const normalized = value.trim();
+  return normalized || null;
+}
+async function createKnowledgeContext(db, input) {
   const id = ulid3();
   const now = (/* @__PURE__ */ new Date()).toISOString();
+  const name = normalizeContextName(input.name);
+  const existing = await getKnowledgeContextByName(db, name);
+  if (existing) {
+    throw new Error(`Knowledge context with name "${name}" already exists`);
+  }
+  await db.prepare(
+    `INSERT INTO contexts (id, name, label, language, created_at)
+       VALUES (?, ?, ?, ?, ?)`
+  ).run(
+    id,
+    name,
+    normalizeOptionalText(input.label),
+    normalizeOptionalText(input.language),
+    now
+  );
+  const context = await getKnowledgeContextById(db, id);
+  if (!context) {
+    throw new Error(
+      `Failed to retrieve newly created knowledge context: ${id}`
+    );
+  }
+  return context;
+}
+async function getKnowledgeContextByName(db, name) {
+  const normalized = name.trim();
+  if (!normalized) return void 0;
+  return await db.prepare("SELECT * FROM contexts WHERE name = ?").get(normalized);
+}
+async function getKnowledgeContextById(db, id) {
+  return await db.prepare("SELECT * FROM contexts WHERE id = ?").get(id);
+}
+async function listKnowledgeContexts(db) {
+  return await db.prepare("SELECT * FROM contexts ORDER BY name ASC").all();
+}
+async function updateKnowledgeContext(db, id, updates) {
+  const context = await getKnowledgeContextById(db, id);
+  if (!context) {
+    throw new Error(`Knowledge context not found: ${id}`);
+  }
+  const fields = [];
+  const values = [];
+  if (updates.name !== void 0) {
+    const name = normalizeContextName(updates.name);
+    if (name !== context.name) {
+      const existing = await getKnowledgeContextByName(db, name);
+      if (existing) {
+        throw new Error(`Knowledge context with name "${name}" already exists`);
+      }
+      fields.push("name = ?");
+      values.push(name);
+    }
+  }
+  if (updates.label !== void 0) {
+    fields.push("label = ?");
+    values.push(normalizeOptionalText(updates.label));
+  }
+  if (updates.language !== void 0) {
+    fields.push("language = ?");
+    values.push(normalizeOptionalText(updates.language));
+  }
+  if (fields.length === 0) {
+    return context;
+  }
+  values.push(id);
+  await db.prepare(`UPDATE contexts SET ${fields.join(", ")} WHERE id = ?`).run(...values);
+  return await getKnowledgeContextById(db, id);
+}
+async function deleteKnowledgeContext(db, id) {
+  await db.prepare("DELETE FROM contexts WHERE id = ?").run(id);
+}
+async function assignTokenToContext(db, tokenId, contextId) {
+  await db.prepare(
+    `INSERT OR IGNORE INTO token_contexts (token_id, context_id)
+       VALUES (?, ?)`
+  ).run(tokenId, contextId);
+}
+async function unassignTokenFromContext(db, tokenId, contextId) {
+  await db.prepare("DELETE FROM token_contexts WHERE token_id = ? AND context_id = ?").run(tokenId, contextId);
+}
+async function listContextsForToken(db, tokenId) {
+  return await db.prepare(
+    `SELECT c.* FROM contexts c
+       INNER JOIN token_contexts tc ON tc.context_id = c.id
+       WHERE tc.token_id = ?
+       ORDER BY c.name ASC`
+  ).all(tokenId);
+}
+
+// src/kernel/models/token.ts
+import { ulid as ulid4 } from "ulid";
+async function createToken(db, input) {
+  const id = ulid4();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
   const bloom = input.bloom_level ?? 1;
   if (bloom < 1 || bloom > 5) {
     throw new Error(`bloom_level must be between 1 and 5, got ${bloom}`);
   }
+  const title = input.title ?? "";
   await db.prepare(`
-    INSERT INTO tokens (id, slug, concept, domain, bloom_level, context, symbiosis_mode, source_link, question, provider, topic_id, created_at, updated_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    INSERT INTO tokens (id, slug, title, concept, domain, bloom_level, context, symbiosis_mode, source_link, question, provider, topic_id, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `).run(
     id,
     input.slug,
+    title,
     input.concept,
     input.domain ?? "",
     bloom,
@@ -1560,6 +1717,10 @@ async function updateToken(db, slug, updates) {
   }
   const fields = [];
   const values = [];
+  if (updates.title !== void 0) {
+    fields.push("title = ?");
+    values.push(updates.title ?? "");
+  }
   if (updates.concept !== void 0) {
     fields.push("concept = ?");
     values.push(updates.concept);
@@ -1665,13 +1826,14 @@ async function deleteToken(db, slug) {
   await db.transaction(async (tx) => {
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const skillRows = await tx.prepare("SELECT id, token_slugs FROM agent_skills").all();
+    const skillUpdateStmt = tx.prepare(
+      "UPDATE agent_skills SET token_slugs = ?, updated_at = ? WHERE id = ?"
+    );
     for (const row of skillRows) {
       const tokenSlugs = JSON.parse(row.token_slugs);
       const filtered = tokenSlugs.filter((tokenSlug) => tokenSlug !== slug);
       if (filtered.length !== tokenSlugs.length) {
-        await tx.prepare(
-          "UPDATE agent_skills SET token_slugs = ?, updated_at = ? WHERE id = ?"
-        ).run(JSON.stringify(filtered), now, row.id);
+        await skillUpdateStmt.run(JSON.stringify(filtered), now, row.id);
       }
     }
     await tx.prepare("DELETE FROM tokens WHERE id = ?").run(token.id);
@@ -1685,10 +1847,16 @@ async function findTokens(db, query) {
   const shortTerms = searchTokens.filter((t2) => t2.length <= 2);
   const longTerms = searchTokens.filter((t2) => t2.length > 2);
   const scoreMap = /* @__PURE__ */ new Map();
-  const likeSQL = `SELECT * FROM tokens WHERE deprecated_at IS NULL AND (lower(slug) LIKE ? OR lower(concept) LIKE ? OR lower(domain) LIKE ?)`;
+  const likeSQL = `SELECT * FROM tokens WHERE deprecated_at IS NULL AND (lower(slug) LIKE ? OR lower(title) LIKE ? OR lower(concept) LIKE ? OR lower(domain) LIKE ?)`;
+  const likeStmt = db.prepare(likeSQL);
   for (const term of longTerms) {
     const pattern = `%${term}%`;
-    const rows = await db.prepare(likeSQL).all(pattern, pattern, pattern);
+    const rows = await likeStmt.all(
+      pattern,
+      pattern,
+      pattern,
+      pattern
+    );
     for (const row of rows) {
       const entry = scoreMap.get(row.id);
       if (entry) {
@@ -1701,7 +1869,7 @@ async function findTokens(db, query) {
   if (shortTerms.length > 0 || longTerms.length === 0) {
     const allTokens = await db.prepare("SELECT * FROM tokens WHERE deprecated_at IS NULL").all();
     for (const token of allTokens) {
-      const words = `${token.slug} ${token.concept} ${token.domain}`.toLowerCase().split(/[\s,.\-_/\\:;!?()[\]{}]+/).filter(Boolean);
+      const words = `${token.slug} ${token.title} ${token.concept} ${token.domain}`.toLowerCase().split(/[\s,.\-_/\\:;!?()[\]{}]+/).filter(Boolean);
       let matchCount = 0;
       for (const term of shortTerms.length > 0 ? shortTerms : searchTokens) {
         for (const w of words) {
@@ -1730,23 +1898,47 @@ async function findTokens(db, query) {
   return scored;
 }
 async function listTokens(db, options) {
-  let tokens;
+  const whereClauses = ["deprecated_at IS NULL"];
+  const params = [];
   if (options?.domain) {
-    tokens = await db.prepare(
-      "SELECT * FROM tokens WHERE domain = ? AND deprecated_at IS NULL ORDER BY bloom_level, slug"
-    ).all(options.domain);
-  } else {
-    tokens = await db.prepare(
-      "SELECT * FROM tokens WHERE deprecated_at IS NULL ORDER BY bloom_level, domain, slug"
-    ).all();
-  }
+    whereClauses.push("domain = ?");
+    params.push(options.domain);
+  } else if (options?.domainPrefix) {
+    const prefix = options.domainPrefix;
+    whereClauses.push("(domain = ? OR domain LIKE ?)");
+    params.push(prefix, `${prefix}/%`);
+  }
+  if (options?.knowledgeContext) {
+    whereClauses.push(`EXISTS (
+      SELECT 1 FROM token_contexts tc
+      INNER JOIN contexts c ON c.id = tc.context_id
+      WHERE tc.token_id = tokens.id AND c.name = ?
+    )`);
+    params.push(options.knowledgeContext);
+  }
+  const orderBy = options?.domain || options?.domainPrefix ? "ORDER BY bloom_level, slug" : "ORDER BY bloom_level, domain, slug";
+  const sql = `SELECT * FROM tokens WHERE ${whereClauses.join(" AND ")} ${orderBy}`;
+  const tokens = await db.prepare(sql).all(...params);
   for (const token of tokens) {
     parseTokenFallback(token);
   }
   return tokens;
 }
 function slugify(text) {
-  return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+  return text.toLowerCase().replace(/ä/g, "ae").replace(/ö/g, "oe").replace(/ü/g, "ue").replace(/ß/g, "ss").replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+}
+function getShortSlug(slug, domainPrefix) {
+  if (domainPrefix) {
+    const folded = domainPrefix.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+    if (folded && slug.startsWith(`${folded}-`)) {
+      return slug.substring(folded.length + 1);
+    }
+  }
+  return slug;
+}
+function getDisplayTitle(t2, activeDomainScope) {
+  if (t2.title?.trim()) return t2.title.trim();
+  return getShortSlug(t2.slug, activeDomainScope);
 }
 async function generateTokenSlug(db, domain, concept, question) {
   const baseText = question && question.trim().length > 0 ? question : concept;
@@ -1776,6 +1968,7 @@ async function listPersonalCards(db, userId, options) {
     SELECT 
       t.id AS tokenId,
       t.slug,
+      t.title,
       t.concept,
       t.domain,
       t.bloom_level AS bloomLevel,
@@ -1816,6 +2009,14 @@ async function listPersonalCards(db, userId, options) {
     sql += " AND t.domain = ?";
     values.push(options.domain);
   }
+  if (options?.knowledgeContext) {
+    sql += ` AND EXISTS (
+      SELECT 1 FROM token_contexts tc
+      INNER JOIN contexts kc ON kc.id = tc.context_id
+      WHERE tc.token_id = t.id AND kc.name = ?
+    )`;
+    values.push(options.knowledgeContext);
+  }
   if (options?.query) {
     const terms = options.query.toLowerCase().split(/\s+/).filter(Boolean);
     for (const term of terms) {
@@ -1877,6 +2078,7 @@ async function importCurriculumCards(db, userId, cards) {
         );
         token = await createToken(tx, {
           slug: finalSlug,
+          title: card.title,
           concept: card.concept,
           domain: card.domain,
           bloom_level: bloom,
@@ -1994,23 +2196,28 @@ async function confirmCardSplit(db, userId, originalSlug, action, originalQuesti
         (/* @__PURE__ */ new Date()).toISOString(),
         originalToken.id
       );
+      const insertPrereqStmt = tx.prepare(
+        "INSERT OR IGNORE INTO prerequisites (token_id, requires_id) VALUES (?, ?)"
+      );
       for (const propToken of proposalTokens) {
-        await tx.prepare(
-          "INSERT OR IGNORE INTO prerequisites (token_id, requires_id) VALUES (?, ?)"
-        ).run(originalToken.id, propToken.id);
+        await insertPrereqStmt.run(originalToken.id, propToken.id);
       }
       await tx.prepare(
         "UPDATE cards SET blocked = 1 WHERE token_id = ? AND user_id = ?"
       ).run(originalToken.id, userId);
+      const checkPrereqsStmt = tx.prepare(
+        "SELECT COUNT(*) as n FROM prerequisites WHERE token_id = ?"
+      );
+      const unblockCardStmt = tx.prepare(
+        "UPDATE cards SET blocked = 0, due_at = ? WHERE id = ?"
+      );
       for (const propToken of proposalTokens) {
         const card = await ensureCard(tx, propToken.id, userId);
         if (card.blocked === 1) {
-          const prereqOfPrereq = await tx.prepare(
-            "SELECT COUNT(*) as n FROM prerequisites WHERE token_id = ?"
-          ).get(propToken.id);
+          const prereqOfPrereq = await checkPrereqsStmt.get(propToken.id);
           if (prereqOfPrereq.n === 0) {
             const now = (/* @__PURE__ */ new Date()).toISOString();
-            await tx.prepare("UPDATE cards SET blocked = 0, due_at = ? WHERE id = ?").run(now, card.id);
+            await unblockCardStmt.run(now, card.id);
           }
         }
       }
@@ -2081,6 +2288,7 @@ async function confirmFoundations(db, userId, originalSlug, proposals) {
           );
           token = await createToken(tx, {
             slug: finalSlug,
+            title: card.title,
             concept: card.concept,
             domain: card.domain,
             bloom_level: bloom,
@@ -2147,6 +2355,7 @@ async function confirmSourceImport(db, userId, sourceId, proposals) {
         }
         token = await createToken(tx, {
           slug: finalSlug,
+          title: card.title,
           concept: card.concept,
           domain: card.domain,
           bloom_level: bloom,
@@ -2249,7 +2458,7 @@ async function addPrerequisite(db, tokenId, requiresId) {
 }
 async function getPrerequisites(db, tokenId) {
   return await db.prepare(
-    `SELECT p.token_id, p.requires_id, t.slug, t.concept, t.domain, t.bloom_level
+    `SELECT p.token_id, p.requires_id, t.slug, t.title, t.concept, t.domain, t.bloom_level
        FROM prerequisites p
        JOIN tokens t ON t.id = p.requires_id
        WHERE p.token_id = ?`
@@ -2257,7 +2466,7 @@ async function getPrerequisites(db, tokenId) {
 }
 async function getDependents(db, tokenId) {
   return await db.prepare(
-    `SELECT p.token_id, p.requires_id, t.slug, t.concept, t.domain, t.bloom_level
+    `SELECT p.token_id, p.requires_id, t.slug, t.title, t.concept, t.domain, t.bloom_level
        FROM prerequisites p
        JOIN tokens t ON t.id = p.token_id
        WHERE p.requires_id = ?`
@@ -2288,6 +2497,7 @@ async function getTokenNeighborhood(db, tokenId, userId) {
   const toNode = (t2, card) => ({
     id: t2.id,
     slug: t2.slug,
+    title: t2.title ?? t2.slug,
     concept: t2.concept,
     domain: t2.domain,
     bloom_level: t2.bloom_level,
@@ -2307,6 +2517,7 @@ async function getTokenNeighborhood(db, tokenId, userId) {
       {
         id: p.requires_id,
         slug: p.slug,
+        title: p.title,
         concept: p.concept,
         domain: p.domain,
         bloom_level: p.bloom_level
@@ -2319,6 +2530,7 @@ async function getTokenNeighborhood(db, tokenId, userId) {
       {
         id: d.token_id,
         slug: d.slug,
+        title: d.title,
         concept: d.concept,
         domain: d.domain,
         bloom_level: d.bloom_level
@@ -2330,12 +2542,12 @@ async function getTokenNeighborhood(db, tokenId, userId) {
 }
 
 // src/kernel/models/review.ts
-import { ulid as ulid4 } from "ulid";
+import { ulid as ulid5 } from "ulid";
 async function logReview(db, input) {
   if (input.rating < 1 || input.rating > 4) {
     throw new Error(`Rating must be between 1 and 4, got ${input.rating}`);
   }
-  const id = ulid4();
+  const id = ulid5();
   const now = (/* @__PURE__ */ new Date()).toISOString();
   await db.prepare(
     `INSERT INTO review_logs (id, card_id, token_id, user_id, rating, response_time_ms, reviewed_at, scheduled_at, session_id)
@@ -2378,9 +2590,9 @@ async function getReviewsForUser(db, userId, options) {
 }
 
 // src/kernel/models/session.ts
-import { ulid as ulid5 } from "ulid";
+import { ulid as ulid6 } from "ulid";
 async function startSession(db, input) {
-  const id = ulid5();
+  const id = ulid6();
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const ctx = input.execution_context ?? "shell";
   await db.prepare(
@@ -2414,7 +2626,7 @@ async function logStep(db, input) {
   if (!session) {
     throw new Error(`Session not found: ${input.session_id}`);
   }
-  const id = ulid5();
+  const id = ulid6();
   const now = (/* @__PURE__ */ new Date()).toISOString();
   await db.prepare(
     `INSERT INTO session_steps (id, session_id, token_id, done_by, rating, notes, created_at)
@@ -2478,7 +2690,8 @@ import { createHash as createHash2 } from "crypto";
 function embeddingContentForToken(t2) {
   return `${t2.concept}
 ${t2.question ?? ""}
-${t2.domain}`;
+${t2.domain}
+${t2.title ?? ""}`;
 }
 function computeContentHash(text) {
   return createHash2("sha256").update(text, "utf8").digest("hex");
@@ -3312,10 +3525,10 @@ async function syncObserverSidecarPolicy(db, dir = getUiObserverDir()) {
 }
 
 // src/kernel/observation/session-synthesis.ts
-import { ulid as ulid7 } from "ulid";
+import { ulid as ulid8 } from "ulid";
 
 // src/kernel/recall/evaluator.ts
-import { ulid as ulid6 } from "ulid";
+import { ulid as ulid7 } from "ulid";
 
 // src/kernel/scheduler/fsrs.ts
 var DEFAULT_W = [
@@ -3494,7 +3707,7 @@ async function evaluateRatingWithinTransaction(db, input) {
     due_at: updated.dueAt.toISOString(),
     last_review_at: now.toISOString()
   });
-  const reviewLogId = input.reviewLogId ?? ulid6();
+  const reviewLogId = input.reviewLogId ?? ulid7();
   await db.prepare(
     `INSERT INTO review_logs (id, card_id, token_id, user_id, rating, response_time_ms, reviewed_at, scheduled_at, session_id)
      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
@@ -3828,7 +4041,7 @@ async function applySessionSynthesis(db, input) {
       return { applied: false, record: parseSynthesisRow(existing) };
     }
     const card = await ensureCard(tx, token.id, session.user_id);
-    const reviewLogId = ulid7();
+    const reviewLogId = ulid8();
     await evaluateRatingWithinTransaction(tx, {
       cardId: card.id,
       tokenId: token.id,
@@ -4657,11 +4870,11 @@ async function buildReviewQueue(db, options) {
   const maxReviews = options.maxReviews ?? 50;
   const now = options.now ?? /* @__PURE__ */ new Date();
   const nowISO = now.toISOString();
-  const dueRows = await db.prepare(
-    `SELECT
+  let dueSql = `SELECT
          c.id       AS card_id,
          c.token_id AS token_id,
          t.slug     AS slug,
+         t.title    AS title,
          t.concept  AS concept,
          t.domain   AS domain,
          t.bloom_level AS bloom_level,
@@ -4675,14 +4888,23 @@ async function buildReviewQueue(db, options) {
          AND c.blocked = 0
          AND c.due_at <= ?
          AND c.state IN ('review', 'relearning', 'learning')
-         AND t.deprecated_at IS NULL
-       ORDER BY c.due_at ASC`
-  ).all(options.userId, nowISO);
-  const newRows = await db.prepare(
-    `SELECT
+         AND t.deprecated_at IS NULL`;
+  const dueParams = [options.userId, nowISO];
+  if (options.knowledgeContext) {
+    dueSql += ` AND EXISTS (
+      SELECT 1 FROM token_contexts tc
+      INNER JOIN contexts ctx ON ctx.id = tc.context_id
+      WHERE tc.token_id = t.id AND ctx.name = ?
+    )`;
+    dueParams.push(options.knowledgeContext);
+  }
+  dueSql += ` ORDER BY c.due_at ASC`;
+  const dueRows = await db.prepare(dueSql).all(...dueParams);
+  let newSql = `SELECT
          c.id       AS card_id,
          c.token_id AS token_id,
          t.slug     AS slug,
+         t.title    AS title,
          t.concept  AS concept,
          t.domain   AS domain,
          t.bloom_level AS bloom_level,
@@ -4695,10 +4917,19 @@ async function buildReviewQueue(db, options) {
        WHERE c.user_id = ?
          AND c.blocked = 0
          AND c.state = 'new'
-         AND t.deprecated_at IS NULL
-       ORDER BY t.bloom_level ASC, t.slug ASC
-       LIMIT ?`
-  ).all(options.userId, maxNew);
+         AND t.deprecated_at IS NULL`;
+  const newParams = [options.userId];
+  if (options.knowledgeContext) {
+    newSql += ` AND EXISTS (
+      SELECT 1 FROM token_contexts tc
+      INNER JOIN contexts ctx ON ctx.id = tc.context_id
+      WHERE tc.token_id = t.id AND ctx.name = ?
+    )`;
+    newParams.push(options.knowledgeContext);
+  }
+  newSql += ` ORDER BY t.bloom_level ASC, t.slug ASC LIMIT ?`;
+  newParams.push(maxNew);
+  const newRows = await db.prepare(newSql).all(...newParams);
   const nowMs = now.getTime();
   const sortedDue = [...dueRows].sort((a, b) => {
     const overdueA = nowMs - new Date(a.due_at).getTime();
@@ -4742,6 +4973,7 @@ function rowToItem(row) {
     cardId: row.card_id,
     tokenId: row.token_id,
     slug: row.slug,
+    title: getDisplayTitle(row),
     concept: row.concept,
     domain: row.domain,
     bloomLevel: row.bloom_level,
@@ -5444,6 +5676,27 @@ function detectSyncProvider(dir) {
   }
   return null;
 }
+function getActiveWorkspaceContext(path = defaultConfigPath()) {
+  const activeWorkspace = getActiveWorkspace(path);
+  return activeWorkspace?.activeKnowledgeContext;
+}
+function setActiveWorkspaceContext(contextName, path = defaultConfigPath()) {
+  const config = loadInstallConfig(path);
+  const activeId = config.activeWorkspaceId;
+  if (activeId && config.workspaces) {
+    const workspace = config.workspaces.find((w) => w.id === activeId);
+    if (workspace) {
+      if (contextName) {
+        workspace.activeKnowledgeContext = contextName;
+      } else {
+        delete workspace.activeKnowledgeContext;
+      }
+      saveInstallConfig(config, path);
+      return true;
+    }
+  }
+  return false;
+}
 
 // src/kernel/system/installer.ts
 import { execFileSync, execSync } from "child_process";
@@ -5939,6 +6192,7 @@ export {
   analyzeObservation,
   appendUiObservationReport,
   applySessionSynthesis,
+  assignTokenToContext,
   buildAncestorMap,
   buildReviewQueue,
   buildUiSynthesisCandidates,
@@ -5956,12 +6210,14 @@ export {
   createAgentSkill,
   createFSRS,
   createGoal,
+  createKnowledgeContext,
   createToken,
   decidePostCapture,
   decidePreCapture,
   decideUpdate,
   decodeEmbedding,
   deleteCardForUser,
+  deleteKnowledgeContext,
   deleteSetting,
   deleteToken,
   deprecateToken,
@@ -5993,6 +6249,7 @@ export {
   generateZshUnhooks,
   getADOCredentials,
   getActiveWorkspace,
+  getActiveWorkspaceContext,
   getActiveWorkspaceId,
   getAgentSkill,
   getAllSettings,
@@ -6005,6 +6262,7 @@ export {
   getDatabaseTargetInfo,
   getDefaultDbPath,
   getDependents,
+  getDisplayTitle,
   getDomainCompetence,
   getDueCards,
   getEmbeddingCoverage,
@@ -6012,6 +6270,8 @@ export {
   getGoalTree,
   getInstallChannel,
   getInstallMode,
+  getKnowledgeContextById,
+  getKnowledgeContextByName,
   getMachineAiConfig,
   getMonitorDir,
   getMonitorLogStats,
@@ -6025,6 +6285,7 @@ export {
   getSessionSummary,
   getSessionSynthesisRecords,
   getSetting,
+  getShortSlug,
   getSystemProfile,
   getTokenById,
   getTokenBySlug,
@@ -6047,8 +6308,10 @@ export {
   isOllamaInstalled,
   isUiObservationReport,
   listAgentSkills,
+  listContextsForToken,
   listEmbeddedTokens,
   listGoals,
+  listKnowledgeContexts,
   listPersonalCards,
   listProviderApiKeyRefs,
   listTokens,
@@ -6095,6 +6358,7 @@ export {
   searchTokensHybrid,
   serializeGoal,
   setADOCredentials,
+  setActiveWorkspaceContext,
   setActiveWorkspaceId,
   setInstallChannel,
   setInstallMode,
@@ -6109,9 +6373,11 @@ export {
   toSidecarPrivacyPolicy,
   uiObservationLogExists,
   uiObservationTimeSpan,
+  unassignTokenFromContext,
   unblockReady,
   updateCard,
   updateGoalStatus,
+  updateKnowledgeContext,
   updateToken,
   upsertConfiguredWorkspace,
   upsertTokenEmbedding,