zam-core 0.3.3 → 0.3.6

package/dist/index.js

@@ -1,14 +1,232 @@
-// src/kernel/db/connection.ts
-import Database from "libsql";
-import { existsSync, mkdirSync, rmSync } from "fs";
+// src/kernel/analytics/stats.ts
+function q(db, sql, ...params) {
+  return db.prepare(sql).get(...params);
+}
+function getUserStats(db, userId) {
+  return {
+    userId,
+    totalTokens: q(db, "SELECT COUNT(*) as n FROM tokens").n,
+    cardsInDeck: q(db, "SELECT COUNT(*) as n FROM cards WHERE user_id = ?", userId).n,
+    dueToday: q(
+      db,
+      "SELECT COUNT(*) as n FROM cards WHERE user_id = ? AND blocked = 0 AND due_at <= datetime('now')",
+      userId
+    ).n,
+    blocked: q(
+      db,
+      "SELECT COUNT(*) as n FROM cards WHERE user_id = ? AND blocked = 1",
+      userId
+    ).n,
+    mature: q(
+      db,
+      "SELECT COUNT(*) as n FROM cards WHERE user_id = ? AND reps >= 3 AND stability >= 21",
+      userId
+    ).n,
+    avgStability: (() => {
+      const v = q(
+        db,
+        "SELECT AVG(stability) as v FROM cards WHERE user_id = ? AND reps > 0",
+        userId
+      );
+      return v.v ? Math.round(v.v * 100) / 100 : null;
+    })(),
+    totalSessions: q(db, "SELECT COUNT(*) as n FROM sessions WHERE user_id = ?", userId).n,
+    lastSession: (() => {
+      const r = db.prepare(
+        "SELECT started_at FROM sessions WHERE user_id = ? ORDER BY started_at DESC LIMIT 1"
+      ).get(userId);
+      return r?.started_at ?? null;
+    })()
+  };
+}
+function getDomainCompetence(db, userId) {
+  const domains = db.prepare(
+    `SELECT DISTINCT t.domain FROM cards c
+       JOIN tokens t ON t.id = c.token_id
+       WHERE c.user_id = ? AND t.domain != ''`
+  ).all(userId);
+  return domains.map((d) => {
+    const total = q(
+      db,
+      `SELECT COUNT(*) as n FROM cards c
+       JOIN tokens t ON t.id = c.token_id
+       WHERE c.user_id = ? AND t.domain = ?`,
+      userId,
+      d.domain
+    ).n;
+    const mature = q(
+      db,
+      `SELECT COUNT(*) as n FROM cards c
+       JOIN tokens t ON t.id = c.token_id
+       WHERE c.user_id = ? AND t.domain = ? AND c.reps >= 3 AND c.stability >= 21`,
+      userId,
+      d.domain
+    ).n;
+    const avgStab = q(
+      db,
+      `SELECT AVG(c.stability) as v FROM cards c
+       JOIN tokens t ON t.id = c.token_id
+       WHERE c.user_id = ? AND t.domain = ? AND c.reps > 0`,
+      userId,
+      d.domain
+    ).v ?? 0;
+    const reviews = q(
+      db,
+      `SELECT COUNT(*) as total,
+              SUM(CASE WHEN rating >= 2 THEN 1 ELSE 0 END) as passed
+       FROM review_logs
+       WHERE user_id = ? AND token_id IN (SELECT id FROM tokens WHERE domain = ?)`,
+      userId,
+      d.domain
+    );
+    const retentionRate = reviews.total > 0 ? reviews.passed / reviews.total : 0;
+    let suggestedMode;
+    if (retentionRate > 0.9 && avgStab > 30) {
+      suggestedMode = "autonomy";
+    } else if (retentionRate > 0.7 && avgStab > 7) {
+      suggestedMode = "copilot";
+    } else {
+      suggestedMode = "shadowing";
+    }
+    return {
+      domain: d.domain,
+      totalCards: total,
+      matureCards: mature,
+      avgStability: Math.round(avgStab * 100) / 100,
+      retentionRate: Math.round(retentionRate * 1e3) / 1e3,
+      suggestedMode
+    };
+  });
+}
+
+// src/kernel/credentials.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { dirname, join } from "path";
+var DEFAULT_CREDENTIALS_PATH = join(homedir(), ".zam", "credentials.json");
+function loadCredentials(path) {
+  const p = path ?? DEFAULT_CREDENTIALS_PATH;
+  if (!existsSync(p)) return {};
+  try {
+    return JSON.parse(readFileSync(p, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function saveCredentials(creds, path) {
+  const p = path ?? DEFAULT_CREDENTIALS_PATH;
+  const dir = dirname(p);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(p, `${JSON.stringify(creds, null, 2)}
+`, "utf-8");
+}
+function getTursoCredentials(path) {
+  const creds = loadCredentials(path);
+  if (creds.turso?.url && creds.turso?.token) {
+    return { url: creds.turso.url, token: creds.turso.token };
+  }
+  return null;
+}
+function setTursoCredentials(url, token, path) {
+  const creds = loadCredentials(path);
+  creds.turso = { url, token };
+  saveCredentials(creds, path);
+}
+function clearTursoCredentials(path) {
+  const creds = loadCredentials(path);
+  delete creds.turso;
+  saveCredentials(creds, path);
+}
+function getADOCredentials(path) {
+  const creds = loadCredentials(path);
+  if (creds.ado?.org_url && creds.ado?.project && creds.ado?.pat) {
+    return {
+      org_url: creds.ado.org_url,
+      project: creds.ado.project,
+      pat: creds.ado.pat
+    };
+  }
+  return null;
+}
+function setADOCredentials(orgUrl, project, pat, path) {
+  const creds = loadCredentials(path);
+  creds.ado = { org_url: orgUrl, project, pat };
+  saveCredentials(creds, path);
+}
+function clearADOCredentials(path) {
+  const creds = loadCredentials(path);
+  delete creds.ado;
+  saveCredentials(creds, path);
+}
+
+// src/kernel/connectors/azure-devops.ts
+function loadADOConfig() {
+  const creds = getADOCredentials();
+  if (!creds) return null;
+  return {
+    orgUrl: creds.org_url.replace(/\/+$/, ""),
+    project: creds.project,
+    pat: creds.pat
+  };
+}
+function authHeader(pat) {
+  return `Basic ${Buffer.from(`:${pat}`).toString("base64")}`;
+}
+async function fetchActiveWorkItems(config) {
+  const { orgUrl, project, pat } = config;
+  const wiqlUrl = `${orgUrl}/${project}/_apis/wit/wiql?api-version=7.1`;
+  const wiqlBody = {
+    query: `SELECT [System.Id] FROM WorkItems WHERE [System.AssignedTo] = @me AND [System.State] NOT IN ('Closed', 'Completed', 'Done', 'Removed') ORDER BY [Microsoft.VSTS.Common.Priority] ASC, [System.ChangedDate] DESC`
+  };
+  const wiqlRes = await fetch(wiqlUrl, {
+    method: "POST",
+    headers: {
+      Authorization: authHeader(pat),
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(wiqlBody)
+  });
+  if (!wiqlRes.ok) {
+    const text = await wiqlRes.text();
+    throw new Error(`ADO WIQL query failed (${wiqlRes.status}): ${text}`);
+  }
+  const wiqlData = await wiqlRes.json();
+  const ids = wiqlData.workItems.map((wi) => wi.id);
+  if (ids.length === 0) return [];
+  const batchIds = ids.slice(0, 200);
+  const fields = "System.Id,System.Title,System.State,System.WorkItemType,System.AssignedTo";
+  const detailUrl = `${orgUrl}/${project}/_apis/wit/workitems?ids=${batchIds.join(",")}&fields=${fields}&api-version=7.1`;
+  const detailRes = await fetch(detailUrl, {
+    headers: { Authorization: authHeader(pat) }
+  });
+  if (!detailRes.ok) {
+    const text = await detailRes.text();
+    throw new Error(
+      `ADO work items fetch failed (${detailRes.status}): ${text}`
+    );
+  }
+  const detailData = await detailRes.json();
+  return detailData.value.map((wi) => ({
+    id: wi.id,
+    title: wi.fields["System.Title"],
+    state: wi.fields["System.State"],
+    type: wi.fields["System.WorkItemType"],
+    assignedTo: wi.fields["System.AssignedTo"]?.displayName ?? ""
+  }));
+}
+
+// src/kernel/db/connection.ts
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync } from "fs";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname2, join as join2 } from "path";
+import Database from "libsql";
 
 // src/kernel/db/schema.ts
 var SCHEMA = `
--- Use WAL mode for concurrent reads (AI CLI + user CLI)
-PRAGMA journal_mode = WAL;
-PRAGMA foreign_keys = ON;
+-- PRAGMAs (WAL, foreign_keys) are set programmatically in connection.ts,
+-- not here, because libsql embedded replicas manage their own WAL.
 
 -- Knowledge tokens: atomic concepts/facts with Bloom levels
 CREATE TABLE IF NOT EXISTS tokens (
@@ -19,9 +237,11 @@ CREATE TABLE IF NOT EXISTS tokens (
   bloom_level   INTEGER NOT NULL DEFAULT 1 CHECK (bloom_level BETWEEN 1 AND 5),
   context       TEXT NOT NULL DEFAULT '',
   symbiosis_mode TEXT CHECK (symbiosis_mode IN ('shadowing', 'copilot', 'autonomy')),
+  source_link   TEXT,
   created_at    TEXT NOT NULL DEFAULT (datetime('now')),
   updated_at    TEXT NOT NULL DEFAULT (datetime('now')),
-  deprecated_at TEXT
+  deprecated_at TEXT,
+  question      TEXT
 );
 
 -- Prerequisite dependency graph: "to learn A, first know B"
@@ -115,58 +335,90 @@ CREATE INDEX IF NOT EXISTS idx_session_steps_session ON session_steps(session_id
 `;
 
 // src/kernel/db/connection.ts
-var DEFAULT_DB_DIR = join(homedir(), ".zam");
-var DEFAULT_DB_PATH = join(DEFAULT_DB_DIR, "zam.db");
+var DEFAULT_DB_DIR = join2(homedir2(), ".zam");
+var DEFAULT_DB_PATH = join2(DEFAULT_DB_DIR, "zam.db");
+function isRemoteDatabasePath(dbPath) {
+  return /^(libsql|https?):\/\//i.test(dbPath);
+}
 function openDatabase(options = {}) {
-  const dbPath = options.dbPath ?? DEFAULT_DB_PATH;
-  if (options.initialize) {
-    const dir = dirname(dbPath);
-    if (!existsSync(dir)) {
-      mkdirSync(dir, { recursive: true });
+  const configuredCloud = options.useConfiguredCloud !== false && !options.dbPath && !options.syncUrl ? getTursoCredentials() : null;
+  let requiresTurso = false;
+  try {
+    const configPath = join2(process.cwd(), ".zam", "config.yaml");
+    if (existsSync2(configPath)) {
+      const configText = readFileSync2(configPath, "utf-8");
+      if (/[\s\S]*turso:[\s\S]*url:/m.test(configText)) {
+        requiresTurso = true;
+      }
+    }
+  } catch (_e) {
+  }
+  if (requiresTurso && !configuredCloud && options.useConfiguredCloud !== false && !options.dbPath && !options.syncUrl) {
+    throw new Error(
+      "Turso cloud database is configured in .zam/config.yaml but missing local credentials. Run: zam connector setup turso"
+    );
+  }
+  const dbPath = configuredCloud?.url ?? options.dbPath ?? DEFAULT_DB_PATH;
+  const isRemote = isRemoteDatabasePath(dbPath);
+  const isEmbeddedReplica = Boolean(options.syncUrl);
+  if (options.initialize && !isRemote) {
+    const dir = dirname2(dbPath);
+    if (!existsSync2(dir)) {
+      mkdirSync2(dir, { recursive: true });
     }
   }
   const dbOpts = {};
   if (options.syncUrl) {
     dbOpts.syncUrl = options.syncUrl;
+    const metaPath = `${dbPath}.meta`;
+    const infoPath = `${dbPath}-info`;
+    if (existsSync2(dbPath) && !existsSync2(metaPath) && !existsSync2(infoPath)) {
+      for (const suffix of ["", "-wal", "-shm"]) {
+        const f = `${dbPath}${suffix}`;
+        if (existsSync2(f)) rmSync(f, { force: true });
+      }
+    } else if (!existsSync2(dbPath) && (existsSync2(metaPath) || existsSync2(infoPath))) {
+      if (existsSync2(metaPath)) rmSync(metaPath);
+      if (existsSync2(infoPath)) rmSync(infoPath);
+    }
   }
-  if (options.authToken) {
-    dbOpts.authToken = options.authToken;
+  const authToken = configuredCloud?.token ?? options.authToken;
+  if (authToken) {
+    dbOpts.authToken = authToken;
   }
   let db;
   try {
     db = new Database(dbPath, dbOpts);
   } catch (err) {
-    if (options.syncUrl && err.message?.includes("InvalidLocalState")) {
-      for (const suffix of ["", "-wal", "-shm"]) {
-        const f = `${dbPath}${suffix}`;
-        if (existsSync(f)) rmSync(f, { force: true });
-      }
+    const msg = err.message;
+    if (msg.includes("InvalidLocalState") && options.syncUrl) {
+      const metaPath = `${dbPath}.meta`;
+      const infoPath = `${dbPath}-info`;
+      if (existsSync2(metaPath)) rmSync(metaPath);
+      if (existsSync2(infoPath)) rmSync(infoPath);
       db = new Database(dbPath, dbOpts);
     } else {
       throw err;
     }
   }
-  db.pragma("journal_mode = WAL");
+  if (!isRemote && !isEmbeddedReplica) {
+    db.pragma("journal_mode = WAL");
+  }
   db.pragma("foreign_keys = ON");
-  db.pragma("busy_timeout = 5000");
+  if (!isRemote) {
+    db.pragma("busy_timeout = 5000");
+  }
+  if (isEmbeddedReplica) {
+    db.sync();
+  }
   if (options.initialize) {
     db.exec(SCHEMA);
   }
   runMigrations(db);
-  if (options.syncUrl) {
-    db.sync();
-  }
   return db;
 }
 function openDatabaseWithSync(options = {}) {
-  const db = openDatabase(options);
-  const syncUrl = db.prepare("SELECT value FROM user_config WHERE key = ?").get("turso.url");
-  const authToken = db.prepare("SELECT value FROM user_config WHERE key = ?").get("turso.token");
-  if (!syncUrl || !authToken) return db;
-  db.pragma("wal_checkpoint(TRUNCATE)");
-  db.pragma("journal_mode = DELETE");
-  db.close();
-  return openDatabase({ ...options, syncUrl: syncUrl.value, authToken: authToken.value });
+  return openDatabase(options);
 }
 function getDefaultDbPath() {
   return DEFAULT_DB_PATH;
@@ -182,6 +434,12 @@ function runMigrations(db) {
   if (tokenCols.length > 0 && !tokenCols.some((c) => c.name === "deprecated_at")) {
     db.exec(`ALTER TABLE tokens ADD COLUMN deprecated_at TEXT`);
   }
+  if (tokenCols.length > 0 && !tokenCols.some((c) => c.name === "source_link")) {
+    db.exec(`ALTER TABLE tokens ADD COLUMN source_link TEXT`);
+  }
+  if (tokenCols.length > 0 && !tokenCols.some((c) => c.name === "question")) {
+    db.exec(`ALTER TABLE tokens ADD COLUMN question TEXT`);
+  }
   db.exec(`
     CREATE TABLE IF NOT EXISTS agent_skills (
       id          TEXT PRIMARY KEY,
@@ -196,111 +454,232 @@ function runMigrations(db) {
   `);
 }
 
-// src/kernel/models/token.ts
-import { ulid } from "ulid";
-function createToken(db, input) {
-  const id = ulid();
-  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}`);
-  }
-  db.prepare(`
-    INSERT INTO tokens (id, slug, concept, domain, bloom_level, context, symbiosis_mode, created_at, updated_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(
-    id,
-    input.slug,
-    input.concept,
-    input.domain ?? "",
-    bloom,
-    input.context ?? "",
-    input.symbiosis_mode ?? null,
-    now,
-    now
-  );
-  return getTokenById(db, id);
-}
-function getTokenBySlug(db, slug) {
-  return db.prepare("SELECT * FROM tokens WHERE slug = ?").get(slug);
-}
-function getTokenById(db, id) {
-  return db.prepare("SELECT * FROM tokens WHERE id = ?").get(id);
+// src/kernel/goals/engine.ts
+import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { basename, join as join3 } from "path";
+
+// src/kernel/goals/parser.ts
+function parseGoalFile(content, slug, filePath) {
+  const { frontmatter, body } = splitFrontmatter(content);
+  const validStatuses = [
+    "active",
+    "completed",
+    "paused",
+    "abandoned"
+  ];
+  const status = validStatuses.includes(frontmatter.status) ? frontmatter.status : "active";
+  const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  return {
+    slug,
+    title: frontmatter.title || slug,
+    status,
+    parent: frontmatter.parent || null,
+    created: frontmatter.created || now,
+    updated: frontmatter.updated || now,
+    body,
+    filePath
+  };
 }
-function deprecateToken(db, slug) {
-  const token = getTokenBySlug(db, slug);
-  if (!token) {
-    throw new Error(`Token not found: ${slug}`);
+function serializeGoal(goal) {
+  const lines = ["---", `title: ${goal.title}`, `status: ${goal.status}`];
+  if (goal.parent) {
+    lines.push(`parent: ${goal.parent}`);
   }
-  if (token.deprecated_at) {
-    throw new Error(`Token already deprecated: ${slug}`);
+  lines.push(`created: ${goal.created}`);
+  lines.push(`updated: ${goal.updated}`);
+  lines.push("---");
+  lines.push("");
+  if (goal.body.trim()) {
+    lines.push(goal.body.trim());
+    lines.push("");
   }
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  db.prepare("UPDATE tokens SET deprecated_at = ?, updated_at = ? WHERE slug = ?").run(
-    now,
-    now,
-    slug
-  );
-  return getTokenBySlug(db, slug);
+  return lines.join("\n");
 }
-function findTokens(db, query) {
-  const normalised = query.toLowerCase();
-  const qTokens = new Set(
-    normalised.split(/[\s,.\-_/\\:;!?()\[\]{}]+/).filter((t) => t.length > 2)
-  );
-  const tokens = db.prepare("SELECT * FROM tokens WHERE deprecated_at IS NULL").all();
-  const scored = [];
-  for (const t of tokens) {
-    const words = (t.slug + " " + t.concept + " " + t.domain).toLowerCase().split(/[\s,.\-_/\\:;!?()\[\]{}]+/).filter(Boolean);
-    let score = 0;
-    for (const w of words) {
-      if (qTokens.has(w)) score++;
-    }
-    if (t.concept.toLowerCase().includes(normalised.slice(0, 25))) {
-      score += 3;
+function extractTasks(body) {
+  const tasks = [];
+  const taskRegex = /^[-*]\s+\[([ xX])\]\s+(.+)$/gm;
+  let match = taskRegex.exec(body);
+  while (match !== null) {
+    tasks.push({
+      done: match[1] !== " ",
+      text: match[2].trim()
+    });
+    match = taskRegex.exec(body);
+  }
+  return tasks;
+}
+function extractTokenRefs(body) {
+  const tokensSection = body.match(/## Tokens\n([\s\S]*?)(?=\n## |\n*$)/);
+  if (!tokensSection) return [];
+  const refs = [];
+  const lines = tokensSection[1].split("\n");
+  for (const line of lines) {
+    const match = line.match(/^[-*]\s+(\S+)/);
+    if (match) {
+      refs.push(match[1]);
     }
-    if (score > 0) {
-      scored.push({ score, ...t });
+  }
+  return refs;
+}
+function splitFrontmatter(content) {
+  const trimmed = content.trim();
+  if (!trimmed.startsWith("---")) {
+    return { frontmatter: {}, body: trimmed };
+  }
+  const endIndex = trimmed.indexOf("---", 3);
+  if (endIndex === -1) {
+    return { frontmatter: {}, body: trimmed };
+  }
+  const fmBlock = trimmed.slice(3, endIndex).trim();
+  const body = trimmed.slice(endIndex + 3).trim();
+  const frontmatter = {};
+  for (const line of fmBlock.split("\n")) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1) continue;
+    const key = line.slice(0, colonIndex).trim();
+    const value = line.slice(colonIndex + 1).trim();
+    if (key && value) {
+      frontmatter[key] = value;
     }
   }
-  scored.sort((a, b) => b.score - a.score);
-  return scored;
+  return { frontmatter, body };
 }
-function listTokens(db, options) {
-  if (options?.domain) {
-    return db.prepare(
-      "SELECT * FROM tokens WHERE domain = ? AND deprecated_at IS NULL ORDER BY bloom_level, slug"
-    ).all(options.domain);
+
+// src/kernel/goals/engine.ts
+function listGoals(goalsDir) {
+  if (!existsSync3(goalsDir)) return [];
+  const files = readdirSync(goalsDir).filter(
+    (f) => f.endsWith(".md") && f !== "README.md"
+  );
+  const summaries = [];
+  for (const file of files) {
+    const filePath = join3(goalsDir, file);
+    const content = readFileSync3(filePath, "utf-8");
+    const slug = basename(file, ".md");
+    const goal = parseGoalFile(content, slug, filePath);
+    const tasks = extractTasks(goal.body);
+    const tokens = extractTokenRefs(goal.body);
+    summaries.push({
+      slug: goal.slug,
+      title: goal.title,
+      status: goal.status,
+      parent: goal.parent,
+      taskCount: tasks.length,
+      tasksDone: tasks.filter((t2) => t2.done).length,
+      tokenCount: tokens.length
+    });
   }
-  return db.prepare(
-    "SELECT * FROM tokens WHERE deprecated_at IS NULL ORDER BY bloom_level, domain, slug"
-  ).all();
+  const statusOrder = {
+    active: 0,
+    paused: 1,
+    completed: 2,
+    abandoned: 3
+  };
+  summaries.sort((a, b) => {
+    const statusDiff = statusOrder[a.status] - statusOrder[b.status];
+    if (statusDiff !== 0) return statusDiff;
+    return a.title.localeCompare(b.title);
+  });
+  return summaries;
+}
+function getGoal(goalsDir, slug) {
+  const filePath = join3(goalsDir, `${slug}.md`);
+  if (!existsSync3(filePath)) return void 0;
+  const content = readFileSync3(filePath, "utf-8");
+  return parseGoalFile(content, slug, filePath);
 }
+function createGoal(goalsDir, input) {
+  const filePath = join3(goalsDir, `${input.slug}.md`);
+  if (existsSync3(filePath)) {
+    throw new Error(`Goal already exists: ${input.slug}`);
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const goal = {
+    slug: input.slug,
+    title: input.title,
+    status: input.status ?? "active",
+    parent: input.parent ?? null,
+    created: now,
+    updated: now,
+    body: input.description ? `## Description
+${input.description}
 
-// src/kernel/models/prerequisite.ts
-function addPrerequisite(db, tokenId, requiresId) {
-  if (tokenId === requiresId) {
-    throw new Error("A token cannot be a prerequisite of itself");
+## Tasks
+
+## Tokens` : "## Description\n\n## Tasks\n\n## Tokens",
+    filePath
+  };
+  writeFileSync2(filePath, serializeGoal(goal), "utf-8");
+  return goal;
+}
+function updateGoalStatus(goalsDir, slug, status) {
+  const goal = getGoal(goalsDir, slug);
+  if (!goal) throw new Error(`Goal not found: ${slug}`);
+  goal.status = status;
+  goal.updated = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  writeFileSync2(goal.filePath, serializeGoal(goal), "utf-8");
+  return goal;
+}
+function getGoalTree(goalsDir) {
+  const all = listGoals(goalsDir);
+  const bySlug = new Map(all.map((g) => [g.slug, g]));
+  const roots = [];
+  const children = /* @__PURE__ */ new Map();
+  for (const g of all) {
+    if (g.parent && bySlug.has(g.parent)) {
+      const list = children.get(g.parent) ?? [];
+      list.push(g);
+      children.set(g.parent, list);
+    }
+  }
+  for (const g of all) {
+    if (!g.parent || !bySlug.has(g.parent)) {
+      roots.push({ ...g, children: children.get(g.slug) ?? [] });
+    }
+  }
+  return roots;
+}
+
+// src/kernel/models/agent-skill.ts
+import { ulid } from "ulid";
+function parseRow(row) {
+  return {
+    ...row,
+    steps: JSON.parse(row.steps),
+    token_slugs: JSON.parse(row.token_slugs)
+  };
+}
+function createAgentSkill(db, input) {
+  const existing = db.prepare("SELECT * FROM agent_skills WHERE slug = ?").get(input.slug);
+  if (existing) {
+    throw new Error(`Agent skill already exists: ${input.slug}`);
   }
+  const id = ulid();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
   db.prepare(
-    "INSERT OR IGNORE INTO prerequisites (token_id, requires_id) VALUES (?, ?)"
-  ).run(tokenId, requiresId);
+    `INSERT INTO agent_skills (id, slug, description, steps, token_slugs, source, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`
+  ).run(
+    id,
+    input.slug,
+    input.description,
+    JSON.stringify(input.steps),
+    JSON.stringify(input.token_slugs ?? []),
+    input.source ?? "learned",
+    now,
+    now
+  );
+  return parseRow(
+    db.prepare("SELECT * FROM agent_skills WHERE id = ?").get(id)
+  );
 }
-function getPrerequisites(db, tokenId) {
-  return db.prepare(
-    `SELECT p.token_id, p.requires_id, t.slug, t.concept, t.domain, t.bloom_level
-       FROM prerequisites p
-       JOIN tokens t ON t.id = p.requires_id
-       WHERE p.token_id = ?`
-  ).all(tokenId);
+function getAgentSkill(db, slug) {
+  const row = db.prepare("SELECT * FROM agent_skills WHERE slug = ?").get(slug);
+  return row ? parseRow(row) : void 0;
 }
-function getDependents(db, tokenId) {
-  return db.prepare(
-    `SELECT p.token_id, p.requires_id, t.slug, t.concept, t.domain, t.bloom_level
-       FROM prerequisites p
-       JOIN tokens t ON t.id = p.token_id
-       WHERE p.requires_id = ?`
-  ).all(tokenId);
+function listAgentSkills(db) {
+  const rows = db.prepare("SELECT * FROM agent_skills ORDER BY created_at ASC").all();
+  return rows.map(parseRow);
 }
 
 // src/kernel/models/card.ts
@@ -319,6 +698,9 @@ function ensureCard(db, tokenId, userId) {
 function getCard(db, tokenId, userId) {
   return db.prepare("SELECT * FROM cards WHERE token_id = ? AND user_id = ?").get(tokenId, userId);
 }
+function getCardById(db, cardId) {
+  return db.prepare("SELECT * FROM cards WHERE id = ?").get(cardId);
+}
 function updateCard(db, cardId, updates) {
   const fields = [];
   const values = [];
@@ -372,6 +754,23 @@ function updateCard(db, cardId, updates) {
   }
   return db.prepare("SELECT * FROM cards WHERE id = ?").get(cardId);
 }
+function getCardDeletionImpact(db, tokenId, userId) {
+  const card = getCard(db, tokenId, userId);
+  if (!card) {
+    throw new Error(`Card not found for token ${tokenId} and user ${userId}`);
+  }
+  const reviewLogs = db.prepare("SELECT COUNT(*) AS n FROM review_logs WHERE card_id = ?").get(card.id);
+  return { review_logs: reviewLogs.n };
+}
+function deleteCardForUser(db, tokenId, userId) {
+  const card = getCard(db, tokenId, userId);
+  if (!card) {
+    throw new Error(`Card not found for token ${tokenId} and user ${userId}`);
+  }
+  const impact = getCardDeletionImpact(db, tokenId, userId);
+  db.prepare("DELETE FROM cards WHERE id = ?").run(card.id);
+  return { card, impact };
+}
 function getDueCards(db, userId, now) {
   const cutoff = now ?? (/* @__PURE__ */ new Date()).toISOString();
   return db.prepare(
@@ -392,6 +791,32 @@ function getBlockedCards(db, userId) {
   ).all(userId);
 }
 
+// src/kernel/models/prerequisite.ts
+function addPrerequisite(db, tokenId, requiresId) {
+  if (tokenId === requiresId) {
+    throw new Error("A token cannot be a prerequisite of itself");
+  }
+  db.prepare(
+    "INSERT OR IGNORE INTO prerequisites (token_id, requires_id) VALUES (?, ?)"
+  ).run(tokenId, requiresId);
+}
+function getPrerequisites(db, tokenId) {
+  return db.prepare(
+    `SELECT p.token_id, p.requires_id, t.slug, t.concept, t.domain, t.bloom_level
+       FROM prerequisites p
+       JOIN tokens t ON t.id = p.requires_id
+       WHERE p.token_id = ?`
+  ).all(tokenId);
+}
+function getDependents(db, tokenId) {
+  return db.prepare(
+    `SELECT p.token_id, p.requires_id, t.slug, t.concept, t.domain, t.bloom_level
+       FROM prerequisites p
+       JOIN tokens t ON t.id = p.token_id
+       WHERE p.requires_id = ?`
+  ).all(tokenId);
+}
+
 // src/kernel/models/review.ts
 import { ulid as ulid3 } from "ulid";
 function logReview(db, input) {
@@ -461,12 +886,17 @@ function endSession(db, sessionId) {
     throw new Error(`Session already completed: ${sessionId}`);
   }
   const now = (/* @__PURE__ */ new Date()).toISOString();
-  db.prepare("UPDATE sessions SET completed_at = ? WHERE id = ?").run(now, sessionId);
+  db.prepare("UPDATE sessions SET completed_at = ? WHERE id = ?").run(
+    now,
+    sessionId
+  );
   return db.prepare("SELECT * FROM sessions WHERE id = ?").get(sessionId);
 }
 function logStep(db, input) {
   if (input.done_by !== "user" && input.done_by !== "agent") {
-    throw new Error(`done_by must be 'user' or 'agent', got '${input.done_by}'`);
+    throw new Error(
+      `done_by must be 'user' or 'agent', got '${input.done_by}'`
+    );
   }
   if (input.rating != null && (input.rating < 1 || input.rating > 4)) {
     throw new Error(`Rating must be between 1 and 4, got ${input.rating}`);
@@ -506,52 +936,10 @@ function getSessionSummary(db, sessionId) {
   return { session, steps };
 }
 
-// src/kernel/models/agent-skill.ts
-import { ulid as ulid5 } from "ulid";
-function parseRow(row) {
-  return {
-    ...row,
-    steps: JSON.parse(row.steps),
-    token_slugs: JSON.parse(row.token_slugs)
-  };
-}
-function createAgentSkill(db, input) {
-  const existing = db.prepare("SELECT * FROM agent_skills WHERE slug = ?").get(input.slug);
-  if (existing) {
-    throw new Error(`Agent skill already exists: ${input.slug}`);
-  }
-  const id = ulid5();
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  db.prepare(
-    `INSERT INTO agent_skills (id, slug, description, steps, token_slugs, source, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(
-    id,
-    input.slug,
-    input.description,
-    JSON.stringify(input.steps),
-    JSON.stringify(input.token_slugs ?? []),
-    input.source ?? "learned",
-    now,
-    now
-  );
-  return parseRow(
-    db.prepare("SELECT * FROM agent_skills WHERE id = ?").get(id)
-  );
-}
-function getAgentSkill(db, slug) {
-  const row = db.prepare("SELECT * FROM agent_skills WHERE slug = ?").get(slug);
-  return row ? parseRow(row) : void 0;
-}
-function listAgentSkills(db) {
-  const rows = db.prepare("SELECT * FROM agent_skills ORDER BY created_at ASC").all();
-  return rows.map(parseRow);
-}
-
-// src/kernel/models/settings.ts
-function getSetting(db, key) {
-  const row = db.prepare("SELECT value FROM user_config WHERE key = ?").get(key);
-  return row?.value;
+// src/kernel/models/settings.ts
+function getSetting(db, key) {
+  const row = db.prepare("SELECT value FROM user_config WHERE key = ?").get(key);
+  return row?.value;
 }
 function getAllSettings(db) {
   const rows = db.prepare("SELECT key, value FROM user_config ORDER BY key").all();
@@ -576,1323 +964,2328 @@ function deleteSetting(db, key) {
   return result.changes > 0;
 }
 
-// src/kernel/scheduler/fsrs.ts
-var DEFAULT_W = [
-  0.4072,
-  1.1829,
-  3.1262,
-  15.4722,
-  // w0–w3:  initial stability per rating
-  7.2102,
-  0.5316,
-  1.0651,
-  // w4–w6:  difficulty
-  92e-4,
-  1.5988,
-  0.1176,
-  1.0014,
-  // w7–w10: stability after forgetting
-  2.0032,
-  0.0266,
-  0.3077,
-  0.15,
-  // w11–w14: stability increase
-  0,
-  2.7849,
-  0.3477,
-  0.6831
-  // w15–w18: additional parameters
-];
-var DEFAULT_REQUEST_RETENTION = 0.9;
-function clamp(value, lo, hi) {
-  return Math.min(hi, Math.max(lo, value));
-}
-function daysBetween(a, b) {
-  return (b.getTime() - a.getTime()) / (1e3 * 60 * 60 * 24);
-}
-function initialStability(w, rating) {
-  return w[rating - 1];
-}
-function initialDifficulty(w, rating) {
-  return clamp(w[4] - Math.exp(w[5] * (rating - 1)) + 1, 1, 10);
-}
-function nextDifficulty(w, d, rating) {
-  const d0ForGood = initialDifficulty(w, 3);
-  const updated = w[7] * d0ForGood + (1 - w[7]) * (d - w[6] * (rating - 3));
-  return clamp(updated, 1, 10);
-}
-function retrievability(elapsed, stability) {
-  if (stability <= 0) return 0;
-  return Math.pow(1 + elapsed / (9 * stability), -1);
-}
-function stabilityAfterSuccess(w, s, d, r, rating) {
-  const hardPenalty = rating === 2 ? w[15] : 1;
-  const easyBonus = rating === 4 ? w[16] : 1;
-  const inner = Math.exp(w[8]) * (11 - d) * Math.pow(s, -w[9]) * (Math.exp(w[10] * (1 - r)) - 1) * hardPenalty * easyBonus;
-  return s * (inner + 1);
+// src/kernel/models/token.ts
+import { ulid as ulid5 } from "ulid";
+function createToken(db, input) {
+  const id = ulid5();
+  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}`);
+  }
+  db.prepare(`
+    INSERT INTO tokens (id, slug, concept, domain, bloom_level, context, symbiosis_mode, source_link, question, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    id,
+    input.slug,
+    input.concept,
+    input.domain ?? "",
+    bloom,
+    input.context ?? "",
+    input.symbiosis_mode ?? null,
+    input.source_link ?? null,
+    input.question ?? null,
+    now,
+    now
+  );
+  return getTokenById(db, id);
 }
-function stabilityAfterForgetting(w, s, d, r) {
-  return w[11] * Math.pow(d, -w[12]) * (Math.pow(s + 1, w[13]) - 1) * Math.exp(w[14] * (1 - r));
+function getTokenBySlug(db, slug) {
+  return db.prepare("SELECT * FROM tokens WHERE slug = ?").get(slug);
 }
-function nextInterval(stability, requestRetention) {
-  const interval = 9 * stability * (1 / requestRetention - 1);
-  return Math.max(1, Math.round(interval));
+function getTokenById(db, id) {
+  return db.prepare("SELECT * FROM tokens WHERE id = ?").get(id);
 }
-function createFSRS(params) {
-  const resolvedParams = {
-    w: params?.w ?? [...DEFAULT_W],
-    requestRetention: params?.requestRetention ?? DEFAULT_REQUEST_RETENTION
-  };
-  function schedule(card, rating, now) {
-    const reviewTime = now ?? /* @__PURE__ */ new Date();
-    const w = resolvedParams.w;
-    const elapsed = card.lastReviewAt !== null ? Math.max(0, daysBetween(card.lastReviewAt, reviewTime)) : 0;
-    if (card.state === "new") {
-      const s = initialStability(w, rating);
-      const d = initialDifficulty(w, rating);
-      const interval2 = nextInterval(s, resolvedParams.requestRetention);
-      const dueAt2 = new Date(reviewTime);
-      dueAt2.setDate(dueAt2.getDate() + interval2);
-      return {
-        stability: s,
-        difficulty: d,
-        elapsedDays: 0,
-        scheduledDays: interval2,
-        reps: rating >= 2 ? 1 : 0,
-        lapses: rating === 1 ? 1 : 0,
-        state: "learning",
-        dueAt: dueAt2,
-        lastReviewAt: reviewTime
-      };
+function updateToken(db, slug, updates) {
+  const token = getTokenBySlug(db, slug);
+  if (!token) {
+    throw new Error(`Token not found: ${slug}`);
+  }
+  const fields = [];
+  const values = [];
+  if (updates.concept !== void 0) {
+    fields.push("concept = ?");
+    values.push(updates.concept);
+  }
+  if (updates.domain !== void 0) {
+    fields.push("domain = ?");
+    values.push(updates.domain);
+  }
+  if (updates.bloom_level !== void 0) {
+    if (updates.bloom_level < 1 || updates.bloom_level > 5) {
+      throw new Error(
+        `bloom_level must be between 1 and 5, got ${updates.bloom_level}`
+      );
     }
-    const r = retrievability(elapsed, card.stability);
-    let newStability;
-    let newDifficulty;
-    let newReps;
-    let newLapses;
-    let newState;
-    if (rating === 1) {
-      newStability = stabilityAfterForgetting(w, card.stability, card.difficulty, r);
-      newDifficulty = nextDifficulty(w, card.difficulty, rating);
-      newReps = 0;
-      newLapses = card.lapses + 1;
-      newState = "relearning";
-    } else {
-      newStability = stabilityAfterSuccess(w, card.stability, card.difficulty, r, rating);
-      newDifficulty = nextDifficulty(w, card.difficulty, rating);
-      newReps = card.reps + 1;
-      newLapses = card.lapses;
-      newState = "review";
+    fields.push("bloom_level = ?");
+    values.push(updates.bloom_level);
+  }
+  if (updates.context !== void 0) {
+    fields.push("context = ?");
+    values.push(updates.context);
+  }
+  if (updates.symbiosis_mode !== void 0) {
+    const validModes = ["shadowing", "copilot", "autonomy"];
+    if (updates.symbiosis_mode !== null && !validModes.includes(updates.symbiosis_mode)) {
+      throw new Error(`Invalid symbiosis_mode: ${updates.symbiosis_mode}`);
     }
-    const interval = nextInterval(newStability, resolvedParams.requestRetention);
-    const dueAt = new Date(reviewTime);
-    dueAt.setDate(dueAt.getDate() + interval);
-    return {
-      stability: newStability,
-      difficulty: newDifficulty,
-      elapsedDays: elapsed,
-      scheduledDays: interval,
-      reps: newReps,
-      lapses: newLapses,
-      state: newState,
-      dueAt,
-      lastReviewAt: reviewTime
-    };
+    fields.push("symbiosis_mode = ?");
+    values.push(updates.symbiosis_mode);
+  }
+  if (updates.source_link !== void 0) {
+    fields.push("source_link = ?");
+    values.push(updates.source_link);
+  }
+  if (updates.question !== void 0) {
+    fields.push("question = ?");
+    values.push(updates.question);
+  }
+  if (fields.length === 0) {
+    throw new Error("updateToken called with no fields to update");
+  }
+  fields.push("updated_at = ?");
+  values.push((/* @__PURE__ */ new Date()).toISOString());
+  values.push(slug);
+  db.prepare(`UPDATE tokens SET ${fields.join(", ")} WHERE slug = ?`).run(
+    ...values
+  );
+  return getTokenBySlug(db, slug);
+}
+function deprecateToken(db, slug) {
+  const token = getTokenBySlug(db, slug);
+  if (!token) {
+    throw new Error(`Token not found: ${slug}`);
+  }
+  if (token.deprecated_at) {
+    throw new Error(`Token already deprecated: ${slug}`);
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  db.prepare(
+    "UPDATE tokens SET deprecated_at = ?, updated_at = ? WHERE slug = ?"
+  ).run(now, now, slug);
+  return getTokenBySlug(db, slug);
+}
+function getTokenDeleteImpact(db, slug) {
+  const token = getTokenBySlug(db, slug);
+  if (!token) {
+    throw new Error(`Token not found: ${slug}`);
   }
+  const cards = db.prepare("SELECT COUNT(*) AS n FROM cards WHERE token_id = ?").get(token.id);
+  const reviewLogs = db.prepare("SELECT COUNT(*) AS n FROM review_logs WHERE token_id = ?").get(token.id);
+  const prereqsFrom = db.prepare("SELECT COUNT(*) AS n FROM prerequisites WHERE token_id = ?").get(token.id);
+  const prereqsTo = db.prepare("SELECT COUNT(*) AS n FROM prerequisites WHERE requires_id = ?").get(token.id);
+  const sessionSteps = db.prepare("SELECT COUNT(*) AS n FROM session_steps WHERE token_id = ?").get(token.id);
+  const sessionsTouched = db.prepare(
+    "SELECT COUNT(DISTINCT session_id) AS n FROM session_steps WHERE token_id = ?"
+  ).get(token.id);
+  const skillRows = db.prepare("SELECT token_slugs FROM agent_skills").all();
+  const agentSkills = skillRows.filter((row) => {
+    const tokenSlugs = JSON.parse(row.token_slugs);
+    return tokenSlugs.includes(slug);
+  }).length;
   return {
-    schedule,
-    params: Object.freeze(resolvedParams)
+    cards: cards.n,
+    review_logs: reviewLogs.n,
+    prerequisite_edges_from_token: prereqsFrom.n,
+    prerequisite_edges_to_token: prereqsTo.n,
+    session_steps: sessionSteps.n,
+    sessions_touched: sessionsTouched.n,
+    agent_skills: agentSkills
   };
 }
-
-// src/kernel/scheduler/blocker.ts
-function cascadeBlock(db, userId, tokenSlug) {
-  const token = getTokenBySlug(db, tokenSlug);
+function deleteToken(db, slug) {
+  const token = getTokenBySlug(db, slug);
   if (!token) {
-    throw new Error(`Unknown token slug: ${tokenSlug}`);
+    throw new Error(`Token not found: ${slug}`);
   }
-  ensureCard(db, token.id, userId);
-  db.prepare(
-    "UPDATE cards SET blocked = 1 WHERE token_id = ? AND user_id = ?"
-  ).run(token.id, userId);
-  const prereqs = getPrerequisites(db, token.id);
-  const surfaced = [];
-  for (const prereq of prereqs) {
-    const card = ensureCard(db, prereq.requires_id, userId);
-    if (card.blocked === 1) {
-      const prereqOfPrereq = db.prepare("SELECT COUNT(*) as n FROM prerequisites WHERE token_id = ?").get(prereq.requires_id);
-      if (prereqOfPrereq.n === 0) {
-        const now = (/* @__PURE__ */ new Date()).toISOString();
+  const impact = getTokenDeleteImpact(db, slug);
+  db.exec("BEGIN");
+  try {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const skillRows = db.prepare("SELECT id, token_slugs FROM agent_skills").all();
+    for (const row of skillRows) {
+      const tokenSlugs = JSON.parse(row.token_slugs);
+      const filtered = tokenSlugs.filter((tokenSlug) => tokenSlug !== slug);
+      if (filtered.length !== tokenSlugs.length) {
         db.prepare(
-          "UPDATE cards SET blocked = 0, due_at = ? WHERE token_id = ? AND user_id = ?"
-        ).run(now, prereq.requires_id, userId);
+          "UPDATE agent_skills SET token_slugs = ?, updated_at = ? WHERE id = ?"
+        ).run(JSON.stringify(filtered), now, row.id);
       }
     }
-    surfaced.push({
-      slug: prereq.slug,
-      concept: prereq.concept,
-      bloomLevel: prereq.bloom_level
-    });
+    db.prepare("DELETE FROM tokens WHERE id = ?").run(token.id);
+    db.exec("COMMIT");
+  } catch (err) {
+    db.exec("ROLLBACK");
+    throw err;
   }
-  return {
-    blockedSlug: tokenSlug,
-    prerequisites: surfaced
-  };
+  return { token, impact };
 }
-function unblockReady(db, userId) {
-  const blockedCards = db.prepare(
-    `SELECT c.token_id, t.slug, t.concept
-       FROM cards c
-       JOIN tokens t ON t.id = c.token_id
-       WHERE c.user_id = ? AND c.blocked = 1`
-  ).all(userId);
-  const unblocked = [];
-  for (const card of blockedCards) {
-    const totalPrereqs = db.prepare("SELECT COUNT(*) as n FROM prerequisites WHERE token_id = ?").get(card.token_id);
-    const metPrereqs = db.prepare(
-      `SELECT COUNT(*) as n FROM cards c
-         JOIN prerequisites p ON p.requires_id = c.token_id
-         WHERE p.token_id = ? AND c.user_id = ? AND c.reps >= 1 AND c.blocked = 0`
-    ).get(card.token_id, userId);
-    if (totalPrereqs.n === 0 || metPrereqs.n === totalPrereqs.n) {
-      const now = (/* @__PURE__ */ new Date()).toISOString();
-      db.prepare(
-        "UPDATE cards SET blocked = 0, due_at = ? WHERE token_id = ? AND user_id = ?"
-      ).run(now, card.token_id, userId);
-      unblocked.push({ slug: card.slug, concept: card.concept });
+function findTokens(db, query) {
+  const normalised = query.toLowerCase();
+  const qTokens = new Set(
+    normalised.split(/[\s,.\-_/\\:;!?()[\]{}]+/).filter((t2) => t2.length > 2)
+  );
+  const tokens = db.prepare("SELECT * FROM tokens WHERE deprecated_at IS NULL").all();
+  const scored = [];
+  for (const t2 of tokens) {
+    const words = `${t2.slug} ${t2.concept} ${t2.domain}`.toLowerCase().split(/[\s,.\-_/\\:;!?()[\]{}]+/).filter(Boolean);
+    let score = 0;
+    for (const w of words) {
+      if (qTokens.has(w)) score++;
+    }
+    if (t2.concept.toLowerCase().includes(normalised.slice(0, 25))) {
+      score += 3;
+    }
+    if (score > 0) {
+      scored.push({ score, ...t2 });
     }
   }
-  return { unblocked };
+  scored.sort((a, b) => b.score - a.score);
+  return scored;
+}
+function listTokens(db, options) {
+  if (options?.domain) {
+    return db.prepare(
+      "SELECT * FROM tokens WHERE domain = ? AND deprecated_at IS NULL ORDER BY bloom_level, slug"
+    ).all(options.domain);
+  }
+  return db.prepare(
+    "SELECT * FROM tokens WHERE deprecated_at IS NULL ORDER BY bloom_level, domain, slug"
+  ).all();
 }
 
-// src/kernel/scheduler/interleaver.ts
-function interleave(items, maxConsecutive = 2) {
-  if (items.length <= 1) return [...items];
-  const byDomain = /* @__PURE__ */ new Map();
-  for (const item of items) {
-    const group = byDomain.get(item.domain);
-    if (group) {
-      group.push(item);
-    } else {
-      byDomain.set(item.domain, [item]);
+// src/kernel/observation/analyzer.ts
+function parseMonitorLog(jsonl) {
+  const events = [];
+  for (const line of jsonl.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    try {
+      events.push(JSON.parse(trimmed));
+    } catch {
     }
   }
-  if (byDomain.size === 1) return [...items];
-  const result = [];
-  let consecutiveCount = 0;
-  let lastDomain = null;
-  const cursors = /* @__PURE__ */ new Map();
-  for (const domain of byDomain.keys()) {
-    cursors.set(domain, 0);
+  return events;
+}
+function pairCommands(events) {
+  const starts = /* @__PURE__ */ new Map();
+  const records = [];
+  for (const e of events) {
+    if (e.type === "command_start" && e.seq != null) {
+      const key = `${e.pid ?? 0}:${e.seq}`;
+      starts.set(key, e);
+    } else if (e.type === "command_end" && e.seq != null) {
+      const key = `${e.pid ?? 0}:${e.seq}`;
+      const start = starts.get(key);
+      if (start) {
+        const startMs = new Date(start.ts).getTime();
+        const endMs = new Date(e.ts).getTime();
+        records.push({
+          seq: e.seq,
+          pid: e.pid ?? 0,
+          command: start.command ?? "",
+          cwd: start.cwd ?? "",
+          startedAt: start.ts,
+          endedAt: e.ts,
+          durationMs: endMs - startMs,
+          exitCode: e.exit_code ?? null
+        });
+        starts.delete(key);
+      }
+    }
   }
-  while (result.length < items.length) {
-    const activeDomains = [...byDomain.entries()].filter(([domain]) => cursors.get(domain) < byDomain.get(domain).length).sort((a, b) => {
-      const remainA = a[1].length - cursors.get(a[0]);
-      const remainB = b[1].length - cursors.get(b[0]);
-      return remainB - remainA;
+  for (const [, start] of starts) {
+    records.push({
+      seq: start.seq ?? 0,
+      pid: start.pid ?? 0,
+      command: start.command ?? "",
+      cwd: start.cwd ?? "",
+      startedAt: start.ts,
+      endedAt: null,
+      durationMs: null,
+      exitCode: null
     });
-    if (activeDomains.length === 0) break;
-    let pickedThisRound = false;
-    for (const [domain, group] of activeDomains) {
-      const cursor = cursors.get(domain);
-      if (cursor >= group.length) continue;
-      if (domain === lastDomain && consecutiveCount >= maxConsecutive) {
-        continue;
-      }
-      result.push(group[cursor]);
-      cursors.set(domain, cursor + 1);
-      pickedThisRound = true;
-      if (domain === lastDomain) {
-        consecutiveCount++;
-      } else {
-        lastDomain = domain;
-        consecutiveCount = 1;
+  }
+  records.sort(
+    (a, b) => new Date(a.startedAt).getTime() - new Date(b.startedAt).getTime()
+  );
+  return records;
+}
+var HELP_PATTERNS = ["--help", "man ", "tldr ", "help "];
+var HELP_WINDOW_MS = 6e4;
+function matchesToken(command, patterns) {
+  const lower = command.toLowerCase();
+  return patterns.some((p) => lower.includes(p.toLowerCase()));
+}
+function isHelpCommand(command) {
+  const lower = command.toLowerCase();
+  return HELP_PATTERNS.some((p) => lower.includes(p));
+}
+function commandPrefix(command) {
+  return command.split(/\s+/).slice(0, 2).join(" ").toLowerCase();
+}
+function computeMedian(values) {
+  if (values.length === 0) return null;
+  const sorted = [...values].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  return sorted.length % 2 !== 0 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
+}
+function analyzeObservation(commands, tokenPatterns) {
+  const matchedSet = /* @__PURE__ */ new Set();
+  const ratings = [];
+  for (const tp of tokenPatterns) {
+    const matchIndices = [];
+    const matchedTexts = [];
+    for (let i = 0; i < commands.length; i++) {
+      if (matchesToken(commands[i].command, tp.patterns)) {
+        matchIndices.push(i);
+        matchedTexts.push(commands[i].command);
+        matchedSet.add(i);
       }
-      break;
     }
-    if (!pickedThisRound) {
-      for (const [domain, group] of activeDomains) {
-        const cursor = cursors.get(domain);
-        if (cursor >= group.length) continue;
-        result.push(group[cursor]);
-        cursors.set(domain, cursor + 1);
-        if (domain === lastDomain) {
-          consecutiveCount++;
-        } else {
-          lastDomain = domain;
-          consecutiveCount = 1;
+    if (matchIndices.length === 0) {
+      ratings.push({
+        tokenSlug: tp.slug,
+        rating: null,
+        confidence: "low",
+        evidence: {
+          matchedCommands: 0,
+          helpSeeking: false,
+          errorCount: 0,
+          selfCorrections: 0,
+          medianGapMs: null,
+          thinkingGapMs: null
+        },
+        matchedCommandTexts: []
+      });
+      continue;
+    }
+    let helpSeeking = false;
+    for (const mi of matchIndices) {
+      const matchTime = new Date(commands[mi].startedAt).getTime();
+      for (let j = 0; j < commands.length; j++) {
+        if (j === mi) continue;
+        const cmdTime = new Date(commands[j].startedAt).getTime();
+        if (cmdTime >= matchTime - HELP_WINDOW_MS && cmdTime < matchTime) {
+          if (isHelpCommand(commands[j].command)) {
+            helpSeeking = true;
+            break;
+          }
         }
-        break;
+      }
+      if (helpSeeking) break;
+    }
+    let errorCount = 0;
+    for (const mi of matchIndices) {
+      if (commands[mi].exitCode != null && commands[mi].exitCode !== 0) {
+        errorCount++;
+      }
+    }
+    let selfCorrections = 0;
+    const prefixGroups = /* @__PURE__ */ new Map();
+    for (const mi of matchIndices) {
+      const prefix = commandPrefix(commands[mi].command);
+      prefixGroups.set(prefix, (prefixGroups.get(prefix) ?? 0) + 1);
+    }
+    for (const count of prefixGroups.values()) {
+      if (count > 1) selfCorrections += count - 1;
+    }
+    const gaps = [];
+    for (let k = 1; k < matchIndices.length; k++) {
+      const prev = commands[matchIndices[k - 1]];
+      const curr = commands[matchIndices[k]];
+      if (prev.endedAt) {
+        const gap = new Date(curr.startedAt).getTime() - new Date(prev.endedAt).getTime();
+        if (gap >= 0) gaps.push(gap);
+      }
+    }
+    let thinkingGapMs = null;
+    const firstMatchIdx = matchIndices[0];
+    if (firstMatchIdx > 0) {
+      const prev = commands[firstMatchIdx - 1];
+      if (prev.endedAt) {
+        thinkingGapMs = new Date(commands[firstMatchIdx].startedAt).getTime() - new Date(prev.endedAt).getTime();
       }
     }
+    const medianGapMs = computeMedian(gaps);
+    const rating = inferRating({
+      helpSeeking,
+      errorCount,
+      selfCorrections,
+      medianGapMs,
+      thinkingGapMs,
+      matchedCommands: matchIndices.length
+    });
+    const confidence = matchIndices.length >= 3 ? "high" : matchIndices.length >= 2 ? "medium" : "low";
+    ratings.push({
+      tokenSlug: tp.slug,
+      rating,
+      confidence,
+      evidence: {
+        matchedCommands: matchIndices.length,
+        helpSeeking,
+        errorCount,
+        selfCorrections,
+        medianGapMs,
+        thinkingGapMs
+      },
+      matchedCommandTexts: matchedTexts
+    });
   }
-  return result;
-}
-
-// src/kernel/scheduler/queue.ts
-function buildReviewQueue(db, options) {
-  const maxNew = options.maxNew ?? 10;
-  const maxReviews = options.maxReviews ?? 50;
-  const now = options.now ?? /* @__PURE__ */ new Date();
-  const nowISO = now.toISOString();
-  const dueRows = db.prepare(
-    `SELECT
-         c.id       AS card_id,
-         c.token_id AS token_id,
-         t.slug     AS slug,
-         t.concept  AS concept,
-         t.domain   AS domain,
-         t.bloom_level AS bloom_level,
-         c.state    AS state,
-         c.due_at   AS due_at
-       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 c.state IN ('review', 'relearning', 'learning')
-         AND t.deprecated_at IS NULL
-       ORDER BY c.due_at ASC`
-  ).all(options.userId, nowISO);
-  const newRows = db.prepare(
-    `SELECT
-         c.id       AS card_id,
-         c.token_id AS token_id,
-         t.slug     AS slug,
-         t.concept  AS concept,
-         t.domain   AS domain,
-         t.bloom_level AS bloom_level,
-         c.state    AS state,
-         c.due_at   AS due_at
-       FROM cards c
-       JOIN tokens t ON t.id = c.token_id
-       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);
-  const nowMs = now.getTime();
-  const sortedDue = [...dueRows].sort((a, b) => {
-    const overdueA = nowMs - new Date(a.due_at).getTime();
-    const overdueB = nowMs - new Date(b.due_at).getTime();
-    return overdueB - overdueA;
-  });
-  const interleavedDue = interleave(
-    sortedDue.map((row) => ({ ...rowToItem(row), domain: row.domain }))
-  );
-  const newItems = newRows.map(rowToItem);
-  const merged = intersperseNew(interleavedDue, newItems, 5);
-  const capped = merged.slice(0, maxReviews);
-  let newCount = 0;
-  let reviewCount = 0;
-  let relearnCount = 0;
-  const domainSet = /* @__PURE__ */ new Set();
-  for (const item of capped) {
-    domainSet.add(item.domain);
-    switch (item.state) {
-      case "new":
-        newCount++;
-        break;
-      case "relearning":
-        relearnCount++;
-        break;
-      default:
-        reviewCount++;
-        break;
+  const unmatchedCommands = [];
+  for (let i = 0; i < commands.length; i++) {
+    if (!matchedSet.has(i) && !isHelpCommand(commands[i].command)) {
+      unmatchedCommands.push(commands[i].command);
     }
   }
-  return {
-    items: capped,
-    newCount,
-    reviewCount,
-    relearnCount,
-    totalDomains: [...domainSet].sort()
-  };
+  let timeSpan = null;
+  if (commands.length > 0) {
+    const first = commands[0];
+    const last = commands[commands.length - 1];
+    const endTs = last.endedAt ?? last.startedAt;
+    timeSpan = {
+      start: first.startedAt,
+      end: endTs,
+      durationMs: new Date(endTs).getTime() - new Date(first.startedAt).getTime()
+    };
+  }
+  return { ratings, unmatchedCommands, timeSpan };
 }
-function rowToItem(row) {
-  return {
-    cardId: row.card_id,
-    tokenId: row.token_id,
-    slug: row.slug,
-    concept: row.concept,
-    domain: row.domain,
-    bloomLevel: row.bloom_level,
-    state: row.state,
-    dueAt: row.due_at
-  };
+function inferRating(signals) {
+  const {
+    helpSeeking,
+    errorCount,
+    selfCorrections,
+    medianGapMs,
+    thinkingGapMs
+  } = signals;
+  let negatives = 0;
+  if (helpSeeking) negatives += 2;
+  if (errorCount >= 3) negatives += 3;
+  else if (errorCount >= 1) negatives += 1;
+  if (selfCorrections >= 2) negatives += 2;
+  else if (selfCorrections >= 1) negatives += 1;
+  if (medianGapMs != null && medianGapMs > 3e4) negatives += 2;
+  else if (medianGapMs != null && medianGapMs > 1e4) negatives += 1;
+  if (thinkingGapMs != null && thinkingGapMs > 3e4) negatives += 1;
+  if (negatives >= 5) return 1;
+  if (negatives >= 3) return 2;
+  if (negatives >= 1) return 3;
+  return 4;
 }
-function intersperseNew(reviews, newCards, interval) {
-  if (newCards.length === 0) return [...reviews];
-  if (reviews.length === 0) return [...newCards];
-  const result = [];
-  let reviewIdx = 0;
-  let newIdx = 0;
-  let position = 0;
-  while (reviewIdx < reviews.length || newIdx < newCards.length) {
-    if (newIdx < newCards.length && position > 0 && position % interval === interval - 1) {
-      result.push(newCards[newIdx]);
-      newIdx++;
-    } else if (reviewIdx < reviews.length) {
-      result.push(reviews[reviewIdx]);
-      reviewIdx++;
-    } else if (newIdx < newCards.length) {
-      result.push(newCards[newIdx]);
-      newIdx++;
-    }
-    position++;
+
+// src/kernel/observation/monitor-io.ts
+import {
+  appendFileSync,
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync3,
+  readFileSync as readFileSync4,
+  statSync
+} from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join4 } from "path";
+var MONITOR_DIR = join4(homedir3(), ".zam", "monitor");
+function getMonitorDir() {
+  return MONITOR_DIR;
+}
+function getMonitorPath(sessionId) {
+  return join4(MONITOR_DIR, `${sessionId}.jsonl`);
+}
+function ensureMonitorDir() {
+  if (!existsSync4(MONITOR_DIR)) {
+    mkdirSync3(MONITOR_DIR, { recursive: true, mode: 448 });
   }
-  return result;
 }
-
-// src/kernel/recall/prompter.ts
-var BLOOM_VERBS = {
-  1: "Remember",
-  2: "Understand",
-  3: "Apply",
-  4: "Analyze",
-  5: "Synthesize"
-};
-var BLOOM_PROMPTS = {
-  1: (c) => `What is: ${c}?`,
-  2: (c) => `Explain how this works: ${c}`,
-  3: (c) => `Apply this concept: ${c}`,
-  4: (c) => `Analyze the trade-offs: ${c}`,
-  5: (c) => `Design a solution using: ${c}`
-};
-function generatePrompt(input) {
-  const bloom = input.bloomLevel >= 1 && input.bloomLevel <= 5 ? input.bloomLevel : 1;
-  return {
-    cardId: input.cardId,
-    tokenId: input.tokenId,
-    slug: input.slug,
-    question: BLOOM_PROMPTS[bloom](input.concept),
-    concept: input.concept,
-    domain: input.domain,
-    bloomLevel: bloom,
-    bloomVerb: BLOOM_VERBS[bloom],
-    hints: []
-  };
+function writeMonitorEvent(sessionId, event) {
+  ensureMonitorDir();
+  const path = getMonitorPath(sessionId);
+  appendFileSync(path, `${JSON.stringify(event)}
+`);
 }
-
-// src/kernel/recall/evaluator.ts
-import { ulid as ulid6 } from "ulid";
-function evaluateRating(db, input) {
-  const card = db.prepare("SELECT * FROM cards WHERE id = ?").get(input.cardId);
-  if (!card) {
-    throw new Error(`Card not found: ${input.cardId}`);
+function readMonitorLog(sessionId) {
+  const path = getMonitorPath(sessionId);
+  if (!existsSync4(path)) {
+    return [];
   }
-  const now = /* @__PURE__ */ new Date();
-  const fsrs = createFSRS();
-  const schedulingCard = {
-    stability: card.stability,
-    difficulty: card.difficulty,
-    elapsedDays: card.elapsed_days,
-    scheduledDays: card.scheduled_days,
-    reps: card.reps,
-    lapses: card.lapses,
-    state: card.state,
-    dueAt: new Date(card.due_at),
-    lastReviewAt: card.last_review_at ? new Date(card.last_review_at) : null
-  };
-  const updated = fsrs.schedule(schedulingCard, input.rating, now);
-  updateCard(db, input.cardId, {
-    stability: updated.stability,
-    difficulty: updated.difficulty,
-    elapsed_days: updated.elapsedDays,
-    scheduled_days: updated.scheduledDays,
-    reps: updated.reps,
-    lapses: updated.lapses,
-    state: updated.state,
-    due_at: updated.dueAt.toISOString(),
-    last_review_at: now.toISOString()
-  });
-  db.prepare(
-    `INSERT INTO review_logs (id, card_id, token_id, user_id, rating, response_time_ms, reviewed_at, scheduled_at, session_id)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(
-    ulid6(),
-    input.cardId,
-    input.tokenId,
-    input.userId,
-    input.rating,
-    input.responseTimeMs ?? null,
-    now.toISOString(),
-    card.due_at,
-    input.sessionId ?? null
-  );
-  return {
-    nextDueAt: updated.dueAt.toISOString(),
-    stability: updated.stability,
-    difficulty: updated.difficulty,
-    state: updated.state,
-    scheduledDays: updated.scheduledDays,
-    reps: updated.reps,
-    lapses: updated.lapses
-  };
+  const content = readFileSync4(path, "utf-8");
+  return parseMonitorLog(content);
 }
-
-// src/kernel/analytics/stats.ts
-function q(db, sql, ...params) {
-  return db.prepare(sql).get(...params);
+function monitorLogExists(sessionId) {
+  return existsSync4(getMonitorPath(sessionId));
 }
-function getUserStats(db, userId) {
-  return {
-    userId,
-    totalTokens: q(db, "SELECT COUNT(*) as n FROM tokens").n,
-    cardsInDeck: q(db, "SELECT COUNT(*) as n FROM cards WHERE user_id = ?", userId).n,
-    dueToday: q(
-      db,
-      "SELECT COUNT(*) as n FROM cards WHERE user_id = ? AND blocked = 0 AND due_at <= datetime('now')",
-      userId
-    ).n,
-    blocked: q(db, "SELECT COUNT(*) as n FROM cards WHERE user_id = ? AND blocked = 1", userId).n,
-    mature: q(
-      db,
-      "SELECT COUNT(*) as n FROM cards WHERE user_id = ? AND reps >= 3 AND stability >= 21",
-      userId
-    ).n,
-    avgStability: (() => {
-      const v = q(db, "SELECT AVG(stability) as v FROM cards WHERE user_id = ? AND reps > 0", userId);
-      return v.v ? Math.round(v.v * 100) / 100 : null;
-    })(),
-    totalSessions: q(db, "SELECT COUNT(*) as n FROM sessions WHERE user_id = ?", userId).n,
-    lastSession: (() => {
-      const r = db.prepare(
-        "SELECT started_at FROM sessions WHERE user_id = ? ORDER BY started_at DESC LIMIT 1"
-      ).get(userId);
-      return r?.started_at ?? null;
-    })()
-  };
+function getMonitorLogStats(sessionId) {
+  const path = getMonitorPath(sessionId);
+  if (!existsSync4(path)) {
+    return { exists: false, sizeBytes: 0, lineCount: 0 };
+  }
+  const stat = statSync(path);
+  const content = readFileSync4(path, "utf-8");
+  const lineCount = content.split("\n").filter((l) => l.trim()).length;
+  return { exists: true, sizeBytes: stat.size, lineCount };
 }
-function getDomainCompetence(db, userId) {
-  const domains = db.prepare(
-    `SELECT DISTINCT t.domain FROM cards c
-       JOIN tokens t ON t.id = c.token_id
-       WHERE c.user_id = ? AND t.domain != ''`
-  ).all(userId);
-  return domains.map((d) => {
-    const total = q(
-      db,
-      `SELECT COUNT(*) as n FROM cards c
-       JOIN tokens t ON t.id = c.token_id
-       WHERE c.user_id = ? AND t.domain = ?`,
-      userId,
-      d.domain
-    ).n;
-    const mature = q(
-      db,
-      `SELECT COUNT(*) as n FROM cards c
-       JOIN tokens t ON t.id = c.token_id
-       WHERE c.user_id = ? AND t.domain = ? AND c.reps >= 3 AND c.stability >= 21`,
-      userId,
-      d.domain
-    ).n;
-    const avgStab = q(
-      db,
-      `SELECT AVG(c.stability) as v FROM cards c
-       JOIN tokens t ON t.id = c.token_id
-       WHERE c.user_id = ? AND t.domain = ? AND c.reps > 0`,
-      userId,
-      d.domain
-    ).v ?? 0;
-    const reviews = q(
-      db,
-      `SELECT COUNT(*) as total,
-              SUM(CASE WHEN rating >= 2 THEN 1 ELSE 0 END) as passed
-       FROM review_logs
-       WHERE user_id = ? AND token_id IN (SELECT id FROM tokens WHERE domain = ?)`,
-      userId,
-      d.domain
-    );
-    const retentionRate = reviews.total > 0 ? reviews.passed / reviews.total : 0;
-    let suggestedMode;
-    if (retentionRate > 0.9 && avgStab > 30) {
-      suggestedMode = "autonomy";
-    } else if (retentionRate > 0.7 && avgStab > 7) {
-      suggestedMode = "copilot";
-    } else {
-      suggestedMode = "shadowing";
-    }
-    return {
-      domain: d.domain,
-      totalCards: total,
-      matureCards: mature,
-      avgStability: Math.round(avgStab * 100) / 100,
-      retentionRate: Math.round(retentionRate * 1e3) / 1e3,
-      suggestedMode
-    };
-  });
+
+// src/kernel/observation/shell-hooks.ts
+function psSingleQuoted(value) {
+  return `'${value.replace(/'/g, "''")}'`;
+}
+function generateZshHooks(monitorFile, sessionId) {
+  return `
+# ZAM monitor hooks for session ${sessionId}
+export __ZAM_MONITOR_FILE="${monitorFile}"
+export __ZAM_MONITOR_SEQ=0
+export __ZAM_MONITOR_SESSION="${sessionId}"
+
+__zam_ts() {
+  if [[ -n "\${EPOCHREALTIME:-}" ]]; then
+    local sec="\${EPOCHREALTIME%%.*}"
+    local frac="\${EPOCHREALTIME##*.}"
+    frac="\${frac:0:3}"
+    printf '%s.%sZ' "$(date -u -r "$sec" '+%Y-%m-%dT%H:%M:%S' 2>/dev/null || date -u '+%Y-%m-%dT%H:%M:%S')" "$frac"
+  else
+    date -u '+%Y-%m-%dT%H:%M:%SZ'
+  fi
 }
 
-// src/kernel/observation/analyzer.ts
-function parseMonitorLog(jsonl) {
-  const events = [];
-  for (const line of jsonl.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    try {
-      events.push(JSON.parse(trimmed));
-    } catch {
-    }
+__zam_preexec() {
+  (( __ZAM_MONITOR_SEQ++ ))
+  local cmd="\${1//\\"/\\\\\\"}"
+  local cwd="\${PWD//\\"/\\\\\\"}"
+  local ts="$(__zam_ts)"
+  printf '{"type":"command_start","ts":"%s","command":"%s","cwd":"%s","seq":%d,"pid":%d}\\n' \\
+    "$ts" "$cmd" "$cwd" "$__ZAM_MONITOR_SEQ" "$$" \\
+    >> "$__ZAM_MONITOR_FILE"
+}
+
+__zam_precmd() {
+  local exit_code=$?
+  [[ $__ZAM_MONITOR_SEQ -eq 0 ]] && return
+  local ts="$(__zam_ts)"
+  printf '{"type":"command_end","ts":"%s","exit_code":%d,"seq":%d,"pid":%d}\\n' \\
+    "$ts" "$exit_code" "$__ZAM_MONITOR_SEQ" "$$" \\
+    >> "$__ZAM_MONITOR_FILE"
+}
+
+autoload -Uz add-zsh-hook
+add-zsh-hook preexec __zam_preexec
+add-zsh-hook precmd __zam_precmd
+
+echo "ZAM monitor active for session $__ZAM_MONITOR_SESSION"
+`.trim();
+}
+function generateBashHooks(monitorFile, sessionId) {
+  return `
+# ZAM monitor hooks for session ${sessionId}
+export __ZAM_MONITOR_FILE="${monitorFile}"
+export __ZAM_MONITOR_SEQ=0
+export __ZAM_MONITOR_SESSION="${sessionId}"
+export __ZAM_MONITOR_CMD_ACTIVE=0
+
+__zam_ts() {
+  date -u '+%Y-%m-%dT%H:%M:%SZ'
+}
+
+__zam_debug_trap() {
+  [[ "$__ZAM_MONITOR_CMD_ACTIVE" -eq 1 ]] && return
+  __ZAM_MONITOR_CMD_ACTIVE=1
+  (( __ZAM_MONITOR_SEQ++ ))
+  local cmd="\${BASH_COMMAND//\\"/\\\\\\"}"
+  local cwd="\${PWD//\\"/\\\\\\"}"
+  local ts="$(__zam_ts)"
+  printf '{"type":"command_start","ts":"%s","command":"%s","cwd":"%s","seq":%d,"pid":%d}\\n' \\
+    "$ts" "$cmd" "$cwd" "$__ZAM_MONITOR_SEQ" "$$" \\
+    >> "$__ZAM_MONITOR_FILE"
+}
+
+__zam_prompt_cmd() {
+  local exit_code=$?
+  if [[ "$__ZAM_MONITOR_CMD_ACTIVE" -eq 1 ]]; then
+    __ZAM_MONITOR_CMD_ACTIVE=0
+    local ts="$(__zam_ts)"
+    printf '{"type":"command_end","ts":"%s","exit_code":%d,"seq":%d,"pid":%d}\\n' \\
+      "$ts" "$exit_code" "$__ZAM_MONITOR_SEQ" "$$" \\
+      >> "$__ZAM_MONITOR_FILE"
+  fi
+}
+
+trap '__zam_debug_trap' DEBUG
+PROMPT_COMMAND="__zam_prompt_cmd;\${PROMPT_COMMAND:-}"
+
+echo "ZAM monitor active for session $__ZAM_MONITOR_SESSION"
+`.trim();
+}
+function generatePowerShellHooks(monitorFile, sessionId) {
+  return `
+# ZAM monitor hooks for session ${sessionId}
+$global:__ZAM_MONITOR_FILE = ${psSingleQuoted(monitorFile)}
+$global:__ZAM_MONITOR_SEQ = 0
+$global:__ZAM_MONITOR_SESSION = ${psSingleQuoted(sessionId)}
+$global:__ZAM_MONITOR_SKIP_NEXT_PROMPT = $true
+
+function global:__zam_write_monitor_event {
+  param([hashtable]$Event)
+  $json = $Event | ConvertTo-Json -Compress -Depth 4
+  $utf8NoBom = New-Object System.Text.UTF8Encoding $false
+  [System.IO.File]::AppendAllText($global:__ZAM_MONITOR_FILE, $json + [Environment]::NewLine, $utf8NoBom)
+}
+
+function global:__zam_iso_utc {
+  param([datetime]$Date)
+  if ($Date -eq [datetime]::MinValue) {
+    return (Get-Date).ToUniversalTime().ToString("o")
   }
-  return events;
+  return $Date.ToUniversalTime().ToString("o")
 }
-function pairCommands(events) {
-  const starts = /* @__PURE__ */ new Map();
-  const records = [];
-  for (const e of events) {
-    if (e.type === "command_start" && e.seq != null) {
-      const key = `${e.pid ?? 0}:${e.seq}`;
-      starts.set(key, e);
-    } else if (e.type === "command_end" && e.seq != null) {
-      const key = `${e.pid ?? 0}:${e.seq}`;
-      const start = starts.get(key);
-      if (start) {
-        const startMs = new Date(start.ts).getTime();
-        const endMs = new Date(e.ts).getTime();
-        records.push({
-          seq: e.seq,
-          pid: e.pid ?? 0,
-          command: start.command ?? "",
-          cwd: start.cwd ?? "",
-          startedAt: start.ts,
-          endedAt: e.ts,
-          durationMs: endMs - startMs,
-          exitCode: e.exit_code ?? null
-        });
-        starts.delete(key);
-      }
+
+function global:__zam_update_last_history_id {
+  $history = Get-History -Count 1
+  if ($null -ne $history) {
+    $global:__ZAM_MONITOR_LAST_HISTORY_ID = $history.Id
+  } elseif ($null -eq $global:__ZAM_MONITOR_LAST_HISTORY_ID) {
+    $global:__ZAM_MONITOR_LAST_HISTORY_ID = 0
+  }
+}
+
+function global:__zam_record_last_history {
+  param(
+    [bool]$Success,
+    [object]$NativeExitCode
+  )
+
+  $history = Get-History -Count 1
+  if ($null -eq $history) { return }
+  if ($history.Id -le $global:__ZAM_MONITOR_LAST_HISTORY_ID) { return }
+
+  $global:__ZAM_MONITOR_LAST_HISTORY_ID = $history.Id
+  $global:__ZAM_MONITOR_SEQ += 1
+
+  $exitCode = 0
+  if (-not $Success) {
+    if ($NativeExitCode -is [int] -and $NativeExitCode -ne 0) {
+      $exitCode = $NativeExitCode
+    } else {
+      $exitCode = 1
     }
   }
-  for (const [, start] of starts) {
-    records.push({
-      seq: start.seq ?? 0,
-      pid: start.pid ?? 0,
-      command: start.command ?? "",
-      cwd: start.cwd ?? "",
-      startedAt: start.ts,
-      endedAt: null,
-      durationMs: null,
-      exitCode: null
-    });
+
+  $cwd = (Get-Location).Path
+  __zam_write_monitor_event @{
+    type = "command_start"
+    ts = (__zam_iso_utc $history.StartExecutionTime)
+    command = $history.CommandLine
+    cwd = $cwd
+    seq = $global:__ZAM_MONITOR_SEQ
+    pid = $PID
+  }
+  __zam_write_monitor_event @{
+    type = "command_end"
+    ts = (__zam_iso_utc $history.EndExecutionTime)
+    exit_code = $exitCode
+    seq = $global:__ZAM_MONITOR_SEQ
+    pid = $PID
   }
-  records.sort((a, b) => new Date(a.startedAt).getTime() - new Date(b.startedAt).getTime());
-  return records;
 }
-var HELP_PATTERNS = ["--help", "man ", "tldr ", "help "];
-var HELP_WINDOW_MS = 6e4;
-function matchesToken(command, patterns) {
-  const lower = command.toLowerCase();
-  return patterns.some((p) => lower.includes(p.toLowerCase()));
+
+if (-not (Test-Path function:\\__zam_previous_prompt) -and (Test-Path function:\\prompt)) {
+  Set-Item -Path function:\\__zam_previous_prompt -Value (Get-Item function:\\prompt).ScriptBlock
 }
-function isHelpCommand(command) {
-  const lower = command.toLowerCase();
-  return HELP_PATTERNS.some((p) => lower.includes(p));
+__zam_update_last_history_id
+
+function global:prompt {
+  $zamSuccess = $?
+  $zamNativeExitCode = $global:LASTEXITCODE
+
+  if ($global:__ZAM_MONITOR_SKIP_NEXT_PROMPT) {
+    __zam_update_last_history_id
+    $global:__ZAM_MONITOR_SKIP_NEXT_PROMPT = $false
+  } else {
+    __zam_record_last_history -Success $zamSuccess -NativeExitCode $zamNativeExitCode
+  }
+
+  if (Test-Path function:\\__zam_previous_prompt) {
+    & (Get-Item function:\\__zam_previous_prompt).ScriptBlock
+  } else {
+    "PS $($executionContext.SessionState.Path.CurrentLocation)$('>' * ($nestedPromptLevel + 1)) "
+  }
 }
-function commandPrefix(command) {
-  return command.split(/\s+/).slice(0, 2).join(" ").toLowerCase();
+
+Write-Host "ZAM monitor active for session $global:__ZAM_MONITOR_SESSION"
+`.trim();
 }
-function computeMedian(values) {
-  if (values.length === 0) return null;
-  const sorted = [...values].sort((a, b) => a - b);
-  const mid = Math.floor(sorted.length / 2);
-  return sorted.length % 2 !== 0 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
+function generateZshUnhooks() {
+  return `
+# Remove ZAM monitor hooks
+add-zsh-hook -d preexec __zam_preexec 2>/dev/null
+add-zsh-hook -d precmd __zam_precmd 2>/dev/null
+unset -f __zam_preexec __zam_precmd __zam_ts 2>/dev/null
+unset __ZAM_MONITOR_FILE __ZAM_MONITOR_SEQ __ZAM_MONITOR_SESSION 2>/dev/null
+echo "ZAM monitor stopped."
+`.trim();
 }
-function analyzeObservation(commands, tokenPatterns) {
-  const matchedSet = /* @__PURE__ */ new Set();
-  const ratings = [];
-  for (const tp of tokenPatterns) {
-    const matchIndices = [];
-    const matchedTexts = [];
-    for (let i = 0; i < commands.length; i++) {
-      if (matchesToken(commands[i].command, tp.patterns)) {
-        matchIndices.push(i);
-        matchedTexts.push(commands[i].command);
-        matchedSet.add(i);
-      }
-    }
-    if (matchIndices.length === 0) {
-      ratings.push({
-        tokenSlug: tp.slug,
-        rating: null,
-        confidence: "low",
-        evidence: {
-          matchedCommands: 0,
-          helpSeeking: false,
-          errorCount: 0,
-          selfCorrections: 0,
-          medianGapMs: null,
-          thinkingGapMs: null
-        },
-        matchedCommandTexts: []
-      });
-      continue;
+function generateBashUnhooks() {
+  return `
+# Remove ZAM monitor hooks
+trap - DEBUG
+PROMPT_COMMAND="\${PROMPT_COMMAND/__zam_prompt_cmd;/}"
+unset -f __zam_debug_trap __zam_prompt_cmd __zam_ts 2>/dev/null
+unset __ZAM_MONITOR_FILE __ZAM_MONITOR_SEQ __ZAM_MONITOR_SESSION __ZAM_MONITOR_CMD_ACTIVE 2>/dev/null
+echo "ZAM monitor stopped."
+`.trim();
+}
+function generatePowerShellUnhooks() {
+  return `
+# Remove ZAM monitor hooks
+if (Test-Path function:\\__zam_previous_prompt) {
+  Set-Item -Path function:\\prompt -Value (Get-Item function:\\__zam_previous_prompt).ScriptBlock
+  Remove-Item function:\\__zam_previous_prompt -Force -ErrorAction SilentlyContinue
+}
+Remove-Item function:\\__zam_write_monitor_event,function:\\__zam_iso_utc,function:\\__zam_update_last_history_id,function:\\__zam_record_last_history -ErrorAction SilentlyContinue
+Remove-Variable -Name __ZAM_MONITOR_FILE,__ZAM_MONITOR_SEQ,__ZAM_MONITOR_SESSION,__ZAM_MONITOR_LAST_HISTORY_ID,__ZAM_MONITOR_SKIP_NEXT_PROMPT -Scope Global -ErrorAction SilentlyContinue
+Write-Host "ZAM monitor stopped."
+`.trim();
+}
+
+// src/kernel/observation/skill-discovery.ts
+function discoverSkills(sessionCommands, options = {}) {
+  const minSessions = options.minSessions ?? 2;
+  const minLen = options.minSequenceLength ?? 2;
+  const maxLen = options.maxSequenceLength ?? 5;
+  const existing = new Set(options.existingSkillSlugs ?? []);
+  const sessionSequences = /* @__PURE__ */ new Map();
+  for (const [sessionId, commands] of sessionCommands) {
+    const sequences = extractSequences(commands, minLen, maxLen);
+    if (sequences.length > 0) {
+      sessionSequences.set(sessionId, sequences);
     }
-    let helpSeeking = false;
-    for (const mi of matchIndices) {
-      const matchTime = new Date(commands[mi].startedAt).getTime();
-      for (let j = 0; j < commands.length; j++) {
-        if (j === mi) continue;
-        const cmdTime = new Date(commands[j].startedAt).getTime();
-        if (cmdTime >= matchTime - HELP_WINDOW_MS && cmdTime < matchTime) {
-          if (isHelpCommand(commands[j].command)) {
-            helpSeeking = true;
-            break;
-          }
-        }
+  }
+  const sequenceIndex = /* @__PURE__ */ new Map();
+  for (const [, sequences] of sessionSequences) {
+    const seen = /* @__PURE__ */ new Set();
+    for (const seq of sequences) {
+      const key = seq.join(" \u2192 ");
+      if (seen.has(key)) continue;
+      seen.add(key);
+      const entry = sequenceIndex.get(key);
+      if (entry) {
+        entry.sessionCount++;
+        entry.totalOccurrences++;
+      } else {
+        sequenceIndex.set(key, {
+          steps: seq,
+          sessionCount: 1,
+          totalOccurrences: 1,
+          examples: []
+        });
       }
-      if (helpSeeking) break;
     }
-    let errorCount = 0;
-    for (const mi of matchIndices) {
-      if (commands[mi].exitCode != null && commands[mi].exitCode !== 0) {
-        errorCount++;
+  }
+  const lastSessionId = [...sessionCommands.keys()].pop();
+  if (lastSessionId) {
+    const lastCommands = sessionCommands.get(lastSessionId);
+    for (const [_key, entry] of sequenceIndex) {
+      if (entry.sessionCount >= minSessions) {
+        entry.examples = findExamplesForSequence(lastCommands, entry.steps);
       }
     }
-    let selfCorrections = 0;
-    const prefixGroups = /* @__PURE__ */ new Map();
-    for (const mi of matchIndices) {
-      const prefix = commandPrefix(commands[mi].command);
-      prefixGroups.set(prefix, (prefixGroups.get(prefix) ?? 0) + 1);
-    }
-    for (const count of prefixGroups.values()) {
-      if (count > 1) selfCorrections += count - 1;
+  }
+  const candidates = [...sequenceIndex.values()].filter(
+    (s) => s.sessionCount >= minSessions
+  );
+  const pruned = removeSubsequences(candidates);
+  const proposals = [];
+  for (const seq of pruned) {
+    const slug = generateSlug(seq.steps);
+    if (existing.has(slug)) continue;
+    proposals.push({
+      slug,
+      description: describeSequence(seq.steps),
+      steps: seq.steps,
+      sessionCount: seq.sessionCount,
+      confidence: seq.sessionCount >= 4 ? "high" : seq.sessionCount >= 3 ? "medium" : "low",
+      examples: seq.examples
+    });
+  }
+  const confidenceOrder = { high: 0, medium: 1, low: 2 };
+  proposals.sort((a, b) => {
+    const confDiff = confidenceOrder[a.confidence] - confidenceOrder[b.confidence];
+    if (confDiff !== 0) return confDiff;
+    return b.sessionCount - a.sessionCount;
+  });
+  return proposals;
+}
+function normalizeCommand(command) {
+  const parts = command.trim().split(/\s+/);
+  const multiWord = ["docker compose", "npm run", "npx", "git"];
+  const lower = command.toLowerCase();
+  for (const mw of multiWord) {
+    if (lower.startsWith(mw) && parts.length >= mw.split(" ").length + 1) {
+      return parts.slice(0, mw.split(" ").length + 1).join(" ").toLowerCase();
     }
-    const gaps = [];
-    for (let k = 1; k < matchIndices.length; k++) {
-      const prev = commands[matchIndices[k - 1]];
-      const curr = commands[matchIndices[k]];
-      if (prev.endedAt) {
-        const gap = new Date(curr.startedAt).getTime() - new Date(prev.endedAt).getTime();
-        if (gap >= 0) gaps.push(gap);
+  }
+  return parts.slice(0, Math.min(2, parts.length)).join(" ").toLowerCase();
+}
+function extractSequences(commands, minLen, maxLen) {
+  const filtered = commands.filter((c) => {
+    const lower = c.command.toLowerCase().trim();
+    return lower.length > 0 && !lower.startsWith("cd ") && lower !== "cd" && lower !== "ls" && lower !== "pwd" && lower !== "clear" && lower !== "exit" && !lower.startsWith("echo ");
+  });
+  const normalized = filtered.map((c) => normalizeCommand(c.command));
+  const sequences = [];
+  for (let len = minLen; len <= maxLen; len++) {
+    for (let i = 0; i <= normalized.length - len; i++) {
+      const seq = normalized.slice(i, i + len);
+      if (new Set(seq).size >= 2) {
+        sequences.push(seq);
       }
     }
-    let thinkingGapMs = null;
-    const firstMatchIdx = matchIndices[0];
-    if (firstMatchIdx > 0) {
-      const prev = commands[firstMatchIdx - 1];
-      if (prev.endedAt) {
-        thinkingGapMs = new Date(commands[firstMatchIdx].startedAt).getTime() - new Date(prev.endedAt).getTime();
+  }
+  return sequences;
+}
+function findExamplesForSequence(commands, steps) {
+  const normalized = commands.map((c) => ({
+    norm: normalizeCommand(c.command),
+    full: c.command
+  }));
+  for (let i = 0; i <= normalized.length - steps.length; i++) {
+    let match = true;
+    for (let j = 0; j < steps.length; j++) {
+      if (normalized[i + j].norm !== steps[j]) {
+        match = false;
+        break;
       }
     }
-    const medianGapMs = computeMedian(gaps);
-    const rating = inferRating({
-      helpSeeking,
-      errorCount,
-      selfCorrections,
-      medianGapMs,
-      thinkingGapMs,
-      matchedCommands: matchIndices.length
+    if (match) {
+      return normalized.slice(i, i + steps.length).map((n) => n.full);
+    }
+  }
+  return [];
+}
+function removeSubsequences(candidates) {
+  const sorted = [...candidates].sort(
+    (a, b) => b.steps.length - a.steps.length
+  );
+  const result = [];
+  for (const candidate of sorted) {
+    const key = candidate.steps.join(" \u2192 ");
+    const isSubsequence = result.some((longer) => {
+      const longerKey = longer.steps.join(" \u2192 ");
+      return longerKey.includes(key) && longerKey !== key;
     });
-    const confidence = matchIndices.length >= 3 ? "high" : matchIndices.length >= 2 ? "medium" : "low";
-    ratings.push({
-      tokenSlug: tp.slug,
-      rating,
-      confidence,
-      evidence: {
-        matchedCommands: matchIndices.length,
-        helpSeeking,
-        errorCount,
-        selfCorrections,
-        medianGapMs,
-        thinkingGapMs
-      },
-      matchedCommandTexts: matchedTexts
+    if (!isSubsequence) {
+      result.push(candidate);
+    }
+  }
+  return result;
+}
+function generateSlug(steps) {
+  return steps.map((s) => {
+    const parts = s.split(/\s+/);
+    return parts[parts.length - 1];
+  }).join("-");
+}
+function describeSequence(steps) {
+  return `Recurring pattern: ${steps.join(" \u2192 ")}`;
+}
+
+// src/kernel/scheduler/blocker.ts
+function cascadeBlock(db, userId, tokenSlug) {
+  const token = getTokenBySlug(db, tokenSlug);
+  if (!token) {
+    throw new Error(`Unknown token slug: ${tokenSlug}`);
+  }
+  ensureCard(db, token.id, userId);
+  db.prepare(
+    "UPDATE cards SET blocked = 1 WHERE token_id = ? AND user_id = ?"
+  ).run(token.id, userId);
+  const prereqs = getPrerequisites(db, token.id);
+  const surfaced = [];
+  for (const prereq of prereqs) {
+    const card = ensureCard(db, prereq.requires_id, userId);
+    if (card.blocked === 1) {
+      const prereqOfPrereq = db.prepare("SELECT COUNT(*) as n FROM prerequisites WHERE token_id = ?").get(prereq.requires_id);
+      if (prereqOfPrereq.n === 0) {
+        const now = (/* @__PURE__ */ new Date()).toISOString();
+        db.prepare(
+          "UPDATE cards SET blocked = 0, due_at = ? WHERE token_id = ? AND user_id = ?"
+        ).run(now, prereq.requires_id, userId);
+      }
+    }
+    surfaced.push({
+      slug: prereq.slug,
+      concept: prereq.concept,
+      bloomLevel: prereq.bloom_level
     });
   }
-  const unmatchedCommands = [];
-  for (let i = 0; i < commands.length; i++) {
-    if (!matchedSet.has(i) && !isHelpCommand(commands[i].command)) {
-      unmatchedCommands.push(commands[i].command);
+  return {
+    blockedSlug: tokenSlug,
+    prerequisites: surfaced
+  };
+}
+function unblockReady(db, userId) {
+  const blockedCards = db.prepare(
+    `SELECT c.token_id, t.slug, t.concept
+       FROM cards c
+       JOIN tokens t ON t.id = c.token_id
+       WHERE c.user_id = ? AND c.blocked = 1`
+  ).all(userId);
+  const unblocked = [];
+  for (const card of blockedCards) {
+    const totalPrereqs = db.prepare("SELECT COUNT(*) as n FROM prerequisites WHERE token_id = ?").get(card.token_id);
+    const metPrereqs = db.prepare(
+      `SELECT COUNT(*) as n FROM cards c
+         JOIN prerequisites p ON p.requires_id = c.token_id
+         WHERE p.token_id = ? AND c.user_id = ? AND c.reps >= 1 AND c.blocked = 0`
+    ).get(card.token_id, userId);
+    if (totalPrereqs.n === 0 || metPrereqs.n === totalPrereqs.n) {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      db.prepare(
+        "UPDATE cards SET blocked = 0, due_at = ? WHERE token_id = ? AND user_id = ?"
+      ).run(now, card.token_id, userId);
+      unblocked.push({ slug: card.slug, concept: card.concept });
     }
   }
-  let timeSpan = null;
-  if (commands.length > 0) {
-    const first = commands[0];
-    const last = commands[commands.length - 1];
-    const endTs = last.endedAt ?? last.startedAt;
-    timeSpan = {
-      start: first.startedAt,
-      end: endTs,
-      durationMs: new Date(endTs).getTime() - new Date(first.startedAt).getTime()
+  return { unblocked };
+}
+
+// src/kernel/recall/evaluator.ts
+import { ulid as ulid6 } from "ulid";
+
+// src/kernel/scheduler/fsrs.ts
+var DEFAULT_W = [
+  0.4072,
+  1.1829,
+  3.1262,
+  15.4722,
+  // w0–w3:  initial stability per rating
+  7.2102,
+  0.5316,
+  1.0651,
+  // w4–w6:  difficulty
+  92e-4,
+  1.5988,
+  0.1176,
+  1.0014,
+  // w7–w10: stability after forgetting
+  2.0032,
+  0.0266,
+  0.3077,
+  0.15,
+  // w11–w14: stability increase
+  0,
+  2.7849,
+  0.3477,
+  0.6831
+  // w15–w18: additional parameters
+];
+var DEFAULT_REQUEST_RETENTION = 0.9;
+function clamp(value, lo, hi) {
+  return Math.min(hi, Math.max(lo, value));
+}
+function daysBetween(a, b) {
+  return (b.getTime() - a.getTime()) / (1e3 * 60 * 60 * 24);
+}
+function initialStability(w, rating) {
+  return w[rating - 1];
+}
+function initialDifficulty(w, rating) {
+  return clamp(w[4] - Math.exp(w[5] * (rating - 1)) + 1, 1, 10);
+}
+function nextDifficulty(w, d, rating) {
+  const d0ForGood = initialDifficulty(w, 3);
+  const updated = w[7] * d0ForGood + (1 - w[7]) * (d - w[6] * (rating - 3));
+  return clamp(updated, 1, 10);
+}
+function retrievability(elapsed, stability) {
+  if (stability <= 0) return 0;
+  return (1 + elapsed / (9 * stability)) ** -1;
+}
+function stabilityAfterSuccess(w, s, d, r, rating) {
+  const hardPenalty = rating === 2 ? w[15] : 1;
+  const easyBonus = rating === 4 ? w[16] : 1;
+  const inner = Math.exp(w[8]) * (11 - d) * s ** -w[9] * (Math.exp(w[10] * (1 - r)) - 1) * hardPenalty * easyBonus;
+  return s * (inner + 1);
+}
+function stabilityAfterForgetting(w, s, d, r) {
+  return w[11] * d ** -w[12] * ((s + 1) ** w[13] - 1) * Math.exp(w[14] * (1 - r));
+}
+function nextInterval(stability, requestRetention) {
+  const interval = 9 * stability * (1 / requestRetention - 1);
+  return Math.max(1, Math.round(interval));
+}
+function createFSRS(params) {
+  const resolvedParams = {
+    w: params?.w ?? [...DEFAULT_W],
+    requestRetention: params?.requestRetention ?? DEFAULT_REQUEST_RETENTION
+  };
+  function schedule(card, rating, now) {
+    const reviewTime = now ?? /* @__PURE__ */ new Date();
+    const w = resolvedParams.w;
+    const elapsed = card.lastReviewAt !== null ? Math.max(0, daysBetween(card.lastReviewAt, reviewTime)) : 0;
+    if (card.state === "new") {
+      const s = initialStability(w, rating);
+      const d = initialDifficulty(w, rating);
+      const interval2 = nextInterval(s, resolvedParams.requestRetention);
+      const dueAt2 = new Date(reviewTime);
+      dueAt2.setDate(dueAt2.getDate() + interval2);
+      return {
+        stability: s,
+        difficulty: d,
+        elapsedDays: 0,
+        scheduledDays: interval2,
+        reps: rating >= 2 ? 1 : 0,
+        lapses: rating === 1 ? 1 : 0,
+        state: "learning",
+        dueAt: dueAt2,
+        lastReviewAt: reviewTime
+      };
+    }
+    const r = retrievability(elapsed, card.stability);
+    let newStability;
+    let newDifficulty;
+    let newReps;
+    let newLapses;
+    let newState;
+    if (rating === 1) {
+      newStability = stabilityAfterForgetting(
+        w,
+        card.stability,
+        card.difficulty,
+        r
+      );
+      newDifficulty = nextDifficulty(w, card.difficulty, rating);
+      newReps = 0;
+      newLapses = card.lapses + 1;
+      newState = "relearning";
+    } else {
+      newStability = stabilityAfterSuccess(
+        w,
+        card.stability,
+        card.difficulty,
+        r,
+        rating
+      );
+      newDifficulty = nextDifficulty(w, card.difficulty, rating);
+      newReps = card.reps + 1;
+      newLapses = card.lapses;
+      newState = "review";
+    }
+    const interval = nextInterval(
+      newStability,
+      resolvedParams.requestRetention
+    );
+    const dueAt = new Date(reviewTime);
+    dueAt.setDate(dueAt.getDate() + interval);
+    return {
+      stability: newStability,
+      difficulty: newDifficulty,
+      elapsedDays: elapsed,
+      scheduledDays: interval,
+      reps: newReps,
+      lapses: newLapses,
+      state: newState,
+      dueAt,
+      lastReviewAt: reviewTime
     };
   }
-  return { ratings, unmatchedCommands, timeSpan };
+  return {
+    schedule,
+    params: Object.freeze(resolvedParams)
+  };
 }
-function inferRating(signals) {
-  const { helpSeeking, errorCount, selfCorrections, medianGapMs, thinkingGapMs } = signals;
-  let negatives = 0;
-  if (helpSeeking) negatives += 2;
-  if (errorCount >= 3) negatives += 3;
-  else if (errorCount >= 1) negatives += 1;
-  if (selfCorrections >= 2) negatives += 2;
-  else if (selfCorrections >= 1) negatives += 1;
-  if (medianGapMs != null && medianGapMs > 3e4) negatives += 2;
-  else if (medianGapMs != null && medianGapMs > 1e4) negatives += 1;
-  if (thinkingGapMs != null && thinkingGapMs > 3e4) negatives += 1;
-  if (negatives >= 5) return 1;
-  if (negatives >= 3) return 2;
-  if (negatives >= 1) return 3;
-  return 4;
+
+// src/kernel/recall/evaluator.ts
+function evaluateRating(db, input) {
+  const card = db.prepare("SELECT * FROM cards WHERE id = ?").get(input.cardId);
+  if (!card) {
+    throw new Error(`Card not found: ${input.cardId}`);
+  }
+  const now = /* @__PURE__ */ new Date();
+  const fsrs = createFSRS();
+  const schedulingCard = {
+    stability: card.stability,
+    difficulty: card.difficulty,
+    elapsedDays: card.elapsed_days,
+    scheduledDays: card.scheduled_days,
+    reps: card.reps,
+    lapses: card.lapses,
+    state: card.state,
+    dueAt: new Date(card.due_at),
+    lastReviewAt: card.last_review_at ? new Date(card.last_review_at) : null
+  };
+  const updated = fsrs.schedule(schedulingCard, input.rating, now);
+  updateCard(db, input.cardId, {
+    stability: updated.stability,
+    difficulty: updated.difficulty,
+    elapsed_days: updated.elapsedDays,
+    scheduled_days: updated.scheduledDays,
+    reps: updated.reps,
+    lapses: updated.lapses,
+    state: updated.state,
+    due_at: updated.dueAt.toISOString(),
+    last_review_at: now.toISOString()
+  });
+  db.prepare(
+    `INSERT INTO review_logs (id, card_id, token_id, user_id, rating, response_time_ms, reviewed_at, scheduled_at, session_id)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
+  ).run(
+    ulid6(),
+    input.cardId,
+    input.tokenId,
+    input.userId,
+    input.rating,
+    input.responseTimeMs ?? null,
+    now.toISOString(),
+    card.due_at,
+    input.sessionId ?? null
+  );
+  return {
+    nextDueAt: updated.dueAt.toISOString(),
+    stability: updated.stability,
+    difficulty: updated.difficulty,
+    state: updated.state,
+    scheduledDays: updated.scheduledDays,
+    reps: updated.reps,
+    lapses: updated.lapses
+  };
 }
 
-// src/kernel/observation/monitor-io.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, appendFileSync, statSync } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
-var MONITOR_DIR = join2(homedir2(), ".zam", "monitor");
-function getMonitorDir() {
-  return MONITOR_DIR;
-}
-function getMonitorPath(sessionId) {
-  return join2(MONITOR_DIR, `${sessionId}.jsonl`);
-}
-function ensureMonitorDir() {
-  if (!existsSync2(MONITOR_DIR)) {
-    mkdirSync2(MONITOR_DIR, { recursive: true, mode: 448 });
+// src/kernel/recall/actions.ts
+function getReviewTarget(db, cardId, userId) {
+  const card = getCardById(db, cardId);
+  if (!card) {
+    throw new Error(`Card not found: ${cardId}`);
   }
-}
-function writeMonitorEvent(sessionId, event) {
-  ensureMonitorDir();
-  const path = getMonitorPath(sessionId);
-  appendFileSync(path, JSON.stringify(event) + "\n");
-}
-function readMonitorLog(sessionId) {
-  const path = getMonitorPath(sessionId);
-  if (!existsSync2(path)) {
-    return [];
+  if (card.user_id !== userId) {
+    throw new Error(`Card ${cardId} does not belong to user ${userId}`);
   }
-  const content = readFileSync(path, "utf-8");
-  return parseMonitorLog(content);
-}
-function monitorLogExists(sessionId) {
-  return existsSync2(getMonitorPath(sessionId));
-}
-function getMonitorLogStats(sessionId) {
-  const path = getMonitorPath(sessionId);
-  if (!existsSync2(path)) {
-    return { exists: false, sizeBytes: 0, lineCount: 0 };
+  const token = getTokenById(db, card.token_id);
+  if (!token) {
+    throw new Error(`Token not found for card ${cardId}`);
   }
-  const stat = statSync(path);
-  const content = readFileSync(path, "utf-8");
-  const lineCount = content.split("\n").filter((l) => l.trim()).length;
-  return { exists: true, sizeBytes: stat.size, lineCount };
-}
-
-// src/kernel/observation/shell-hooks.ts
-function generateZshHooks(monitorFile, sessionId) {
-  return `
-# ZAM monitor hooks for session ${sessionId}
-export __ZAM_MONITOR_FILE="${monitorFile}"
-export __ZAM_MONITOR_SEQ=0
-export __ZAM_MONITOR_SESSION="${sessionId}"
-
-__zam_ts() {
-  if [[ -n "\${EPOCHREALTIME:-}" ]]; then
-    local sec="\${EPOCHREALTIME%%.*}"
-    local frac="\${EPOCHREALTIME##*.}"
-    frac="\${frac:0:3}"
-    printf '%s.%sZ' "$(date -u -r "$sec" '+%Y-%m-%dT%H:%M:%S' 2>/dev/null || date -u '+%Y-%m-%dT%H:%M:%S')" "$frac"
-  else
-    date -u '+%Y-%m-%dT%H:%M:%SZ'
-  fi
-}
-
-__zam_preexec() {
-  (( __ZAM_MONITOR_SEQ++ ))
-  local cmd="\${1//\\"/\\\\\\"}"
-  local cwd="\${PWD//\\"/\\\\\\"}"
-  local ts="$(__zam_ts)"
-  printf '{"type":"command_start","ts":"%s","command":"%s","cwd":"%s","seq":%d,"pid":%d}\\n' \\
-    "$ts" "$cmd" "$cwd" "$__ZAM_MONITOR_SEQ" "$$" \\
-    >> "$__ZAM_MONITOR_FILE"
-}
-
-__zam_precmd() {
-  local exit_code=$?
-  [[ $__ZAM_MONITOR_SEQ -eq 0 ]] && return
-  local ts="$(__zam_ts)"
-  printf '{"type":"command_end","ts":"%s","exit_code":%d,"seq":%d,"pid":%d}\\n' \\
-    "$ts" "$exit_code" "$__ZAM_MONITOR_SEQ" "$$" \\
-    >> "$__ZAM_MONITOR_FILE"
-}
-
-autoload -Uz add-zsh-hook
-add-zsh-hook preexec __zam_preexec
-add-zsh-hook precmd __zam_precmd
-
-echo "ZAM monitor active for session $__ZAM_MONITOR_SESSION"
-`.trim();
+  return { cardId: card.id, token };
 }
-function generateBashHooks(monitorFile, sessionId) {
-  return `
-# ZAM monitor hooks for session ${sessionId}
-export __ZAM_MONITOR_FILE="${monitorFile}"
-export __ZAM_MONITOR_SEQ=0
-export __ZAM_MONITOR_SESSION="${sessionId}"
-export __ZAM_MONITOR_CMD_ACTIVE=0
-
-__zam_ts() {
-  date -u '+%Y-%m-%dT%H:%M:%SZ'
+function executeReviewAction(db, input) {
+  const target = getReviewTarget(db, input.cardId, input.userId);
+  switch (input.action) {
+    case "rate": {
+      if (input.rating == null) {
+        throw new Error("rating is required for action=rate");
+      }
+      const evaluation = evaluateRating(db, {
+        cardId: target.cardId,
+        tokenId: target.token.id,
+        userId: input.userId,
+        rating: input.rating
+      });
+      let blocked;
+      if (input.rating === 1) {
+        const prereqs = getPrerequisites(db, target.token.id);
+        if (prereqs.length > 0) {
+          blocked = cascadeBlock(db, input.userId, target.token.slug);
+        }
+      }
+      return {
+        action: input.action,
+        token: target.token,
+        evaluation,
+        blocked
+      };
+    }
+    case "skip":
+      return { action: input.action, token: target.token, skipped: true };
+    case "stop":
+      return { action: input.action, token: target.token, stopped: true };
+    case "edit-token": {
+      const updatedToken = updateToken(
+        db,
+        target.token.slug,
+        input.tokenUpdates ?? {}
+      );
+      return {
+        action: input.action,
+        token: target.token,
+        updatedToken
+      };
+    }
+    case "deprecate-token": {
+      const updatedToken = deprecateToken(db, target.token.slug);
+      return {
+        action: input.action,
+        token: target.token,
+        updatedToken
+      };
+    }
+    case "delete-token": {
+      const deletedToken = deleteToken(db, target.token.slug);
+      return {
+        action: input.action,
+        token: target.token,
+        deletedToken
+      };
+    }
+    case "delete-card": {
+      const deletedCard = deleteCardForUser(db, target.token.id, input.userId);
+      return {
+        action: input.action,
+        token: target.token,
+        deletedCard
+      };
+    }
+    default: {
+      const exhaustive = input.action;
+      throw new Error(`Unsupported review action: ${exhaustive}`);
+    }
+  }
 }
 
-__zam_debug_trap() {
-  [[ "$__ZAM_MONITOR_CMD_ACTIVE" -eq 1 ]] && return
-  __ZAM_MONITOR_CMD_ACTIVE=1
-  (( __ZAM_MONITOR_SEQ++ ))
-  local cmd="\${BASH_COMMAND//\\"/\\\\\\"}"
-  local cwd="\${PWD//\\"/\\\\\\"}"
-  local ts="$(__zam_ts)"
-  printf '{"type":"command_start","ts":"%s","command":"%s","cwd":"%s","seq":%d,"pid":%d}\\n' \\
-    "$ts" "$cmd" "$cwd" "$__ZAM_MONITOR_SEQ" "$$" \\
-    >> "$__ZAM_MONITOR_FILE"
+// src/kernel/recall/prompter.ts
+var BLOOM_VERBS = {
+  1: "Remember",
+  2: "Understand",
+  3: "Apply",
+  4: "Analyze",
+  5: "Synthesize"
+};
+function formatSlugForCue(slug) {
+  return slug.replace(/[-_]/g, " ");
+}
+var BLOOM_CUES = {
+  1: (slug) => `Recall the definition and core concept of: ${formatSlugForCue(slug)}`,
+  2: (slug) => `Explain the concept and how ${formatSlugForCue(slug)} works.`,
+  3: (slug) => `Describe how or where you would apply the concept of ${formatSlugForCue(slug)}.`,
+  4: (slug) => `Analyze the trade-offs, advantages, or alternatives of ${formatSlugForCue(slug)}.`,
+  5: (slug) => `How would you design a solution using the concept of ${formatSlugForCue(slug)}?`
+};
+function generateConceptFreeCue(bloomLevel, slug, _domain) {
+  const bloom = bloomLevel >= 1 && bloomLevel <= 5 ? bloomLevel : 1;
+  return BLOOM_CUES[bloom](slug);
 }
-
-__zam_prompt_cmd() {
-  local exit_code=$?
-  if [[ "$__ZAM_MONITOR_CMD_ACTIVE" -eq 1 ]]; then
-    __ZAM_MONITOR_CMD_ACTIVE=0
-    local ts="$(__zam_ts)"
-    printf '{"type":"command_end","ts":"%s","exit_code":%d,"seq":%d,"pid":%d}\\n' \\
-      "$ts" "$exit_code" "$__ZAM_MONITOR_SEQ" "$$" \\
-      >> "$__ZAM_MONITOR_FILE"
-  fi
+function generatePrompt(input) {
+  const bloom = input.bloomLevel >= 1 && input.bloomLevel <= 5 ? input.bloomLevel : 1;
+  const question = input.question?.trim() ? input.question.trim() : generateConceptFreeCue(bloom, input.slug, input.domain);
+  return {
+    cardId: input.cardId,
+    tokenId: input.tokenId,
+    slug: input.slug,
+    question,
+    concept: input.concept,
+    domain: input.domain,
+    bloomLevel: bloom,
+    bloomVerb: BLOOM_VERBS[bloom],
+    hints: [],
+    sourceLink: input.sourceLink ?? null
+  };
 }
 
-trap '__zam_debug_trap' DEBUG
-PROMPT_COMMAND="__zam_prompt_cmd;\${PROMPT_COMMAND:-}"
-
-echo "ZAM monitor active for session $__ZAM_MONITOR_SESSION"
-`.trim();
+// src/kernel/recall/reference-resolver.ts
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { dirname as dirname3, join as join5, resolve } from "path";
+var DEFAULT_REVIEW_CONTEXT_MAX_CHARS = 6e3;
+function htmlToText(html) {
+  let content = html;
+  const bodyMatch = /<body[^>]*>([\s\S]*?)<\/body>/i.exec(html);
+  if (bodyMatch) {
+    content = bodyMatch[1];
+  }
+  content = content.replace(/<(script|style|head)[^>]*>([\s\S]*?)<\/\1>/gi, "");
+  content = content.replace(
+    /<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi,
+    "\n\n# $1\n"
+  );
+  content = content.replace(/<(p|div|li)[^>]*>/gi, "\n");
+  content = content.replace(/<\/(p|div|li)>/gi, "\n");
+  content = content.replace(/<br\s*\/?>/gi, "\n");
+  content = content.replace(/<[^>]+>/g, "");
+  content = content.replace(/&nbsp;/g, " ").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+  content = content.replace(/\n{3,}/g, "\n\n").trim();
+  return content;
+}
+function extractLines(content, anchor) {
+  const lines = content.split(/\r?\n/);
+  const match = /#L(\d+)(?:-L(\d+))?$/i.exec(anchor);
+  if (!match) return content;
+  const start = Number.parseInt(match[1], 10) - 1;
+  const end = match[2] ? Number.parseInt(match[2], 10) - 1 : start;
+  if (start < 0 || start >= lines.length) return content;
+  const slice = lines.slice(start, Math.min(end + 1, lines.length));
+  return slice.join("\n");
+}
+async function resolveReference(sourceLink) {
+  const cleaned = sourceLink.trim();
+  if (cleaned.startsWith("search://")) {
+    try {
+      const url = new URL(cleaned);
+      const query = url.searchParams.get("q") || "";
+      return {
+        sourceType: "dynamic_search",
+        content: `QUERY_DIRECTIVE: Run web search for "${query}"`,
+        url: cleaned
+      };
+    } catch {
+      const query = cleaned.replace(/^search:\/\/(\??q=)?/, "");
+      return {
+        sourceType: "dynamic_search",
+        content: `QUERY_DIRECTIVE: Run web search for "${decodeURIComponent(query)}"`,
+        url: cleaned
+      };
+    }
+  }
+  if (cleaned.startsWith("http://") || cleaned.startsWith("https://")) {
+    const gitHubMatch = /^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/]+)\/blob\/([^/]+)\/(.+)$/i.exec(
+      cleaned
+    );
+    if (gitHubMatch) {
+      const [_, owner, repo, branch, fullPathWithAnchor] = gitHubMatch;
+      const anchorIndex2 = fullPathWithAnchor.indexOf("#");
+      const filePath = anchorIndex2 !== -1 ? fullPathWithAnchor.slice(0, anchorIndex2) : fullPathWithAnchor;
+      const anchor2 = anchorIndex2 !== -1 ? fullPathWithAnchor.slice(anchorIndex2) : "";
+      const parentDir = dirname3(process.cwd());
+      const localRepoPath = join5(parentDir, repo);
+      const localFilePath = join5(localRepoPath, filePath);
+      if (existsSync5(localFilePath)) {
+        try {
+          let fileContent = readFileSync5(localFilePath, "utf-8");
+          if (anchor2) {
+            fileContent = extractLines(fileContent, anchor2);
+          }
+          return {
+            sourceType: "local",
+            content: fileContent,
+            filePath: localFilePath
+          };
+        } catch (_e) {
+        }
+      }
+      const rawUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${filePath}`;
+      try {
+        const response = await fetch(rawUrl);
+        if (response.ok) {
+          let rawText = await response.text();
+          if (anchor2) {
+            rawText = extractLines(rawText, anchor2);
+          }
+          return {
+            sourceType: "remote_web",
+            content: rawText,
+            url: cleaned
+          };
+        }
+      } catch (_e) {
+      }
+    }
+    try {
+      const response = await fetch(cleaned);
+      if (response.ok) {
+        const text = await response.text();
+        const cleanText = htmlToText(text);
+        return {
+          sourceType: "remote_web",
+          content: cleanText,
+          url: cleaned
+        };
+      }
+      throw new Error(`HTTP error ${response.status}: ${response.statusText}`);
+    } catch (err) {
+      return {
+        sourceType: "remote_web",
+        content: `Error fetching URL reference: ${err.message}
+Link: ${cleaned}`,
+        url: cleaned
+      };
+    }
+  }
+  const anchorIndex = cleaned.indexOf("#");
+  const relativePath = anchorIndex !== -1 ? cleaned.slice(0, anchorIndex) : cleaned;
+  const anchor = anchorIndex !== -1 ? cleaned.slice(anchorIndex) : "";
+  const absolutePath = resolve(process.cwd(), relativePath);
+  if (existsSync5(absolutePath)) {
+    try {
+      let fileContent = readFileSync5(absolutePath, "utf-8");
+      if (anchor) {
+        fileContent = extractLines(fileContent, anchor);
+      }
+      return {
+        sourceType: "local",
+        content: fileContent,
+        filePath: absolutePath
+      };
+    } catch (_e) {
+    }
+  }
+  return {
+    sourceType: "local",
+    content: `Local reference file not found or unreadable.
+Reference: ${cleaned}`,
+    filePath: absolutePath
+  };
 }
-function generateZshUnhooks() {
-  return `
-# Remove ZAM monitor hooks
-add-zsh-hook -d preexec __zam_preexec 2>/dev/null
-add-zsh-hook -d precmd __zam_precmd 2>/dev/null
-unset -f __zam_preexec __zam_precmd __zam_ts 2>/dev/null
-unset __ZAM_MONITOR_FILE __ZAM_MONITOR_SEQ __ZAM_MONITOR_SESSION 2>/dev/null
-echo "ZAM monitor stopped."
-`.trim();
+async function resolveReviewContext(sourceLink, opts = {}) {
+  const cleaned = sourceLink?.trim();
+  if (!cleaned) return null;
+  const maxChars = opts.maxChars ?? DEFAULT_REVIEW_CONTEXT_MAX_CHARS;
+  const resolved = await resolveReference(cleaned);
+  let content = resolved.content;
+  let truncated = false;
+  if (content.length > maxChars) {
+    content = content.slice(0, maxChars);
+    truncated = true;
+  }
+  return {
+    sourceLink: cleaned,
+    sourceType: resolved.sourceType,
+    content,
+    filePath: resolved.filePath,
+    url: resolved.url,
+    truncated
+  };
 }
-function generateBashUnhooks() {
-  return `
-# Remove ZAM monitor hooks
-trap - DEBUG
-PROMPT_COMMAND="\${PROMPT_COMMAND/__zam_prompt_cmd;/}"
-unset -f __zam_debug_trap __zam_prompt_cmd __zam_ts 2>/dev/null
-unset __ZAM_MONITOR_FILE __ZAM_MONITOR_SEQ __ZAM_MONITOR_SESSION __ZAM_MONITOR_CMD_ACTIVE 2>/dev/null
-echo "ZAM monitor stopped."
-`.trim();
+function normalizePath(p) {
+  const base = p.split("#")[0].trim();
+  return base.replace(/\\/g, "/").toLowerCase();
+}
+function matchesFilePath(sourceLink, changedFile) {
+  if (!sourceLink) return false;
+  const normSource = normalizePath(sourceLink);
+  const normChanged = normalizePath(changedFile);
+  if (!normSource || !normChanged) return false;
+  const gitHubMatch = /^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/]+)\/blob\/([^/]+)\/(.+)$/i.exec(
+    normSource
+  );
+  if (gitHubMatch) {
+    const filePath = gitHubMatch[4];
+    return filePath === normChanged;
+  }
+  if (normSource.startsWith("http://") || normSource.startsWith("https://")) {
+    return false;
+  }
+  return normSource.endsWith(normChanged) || normChanged.endsWith(normSource);
 }
 
-// src/kernel/observation/skill-discovery.ts
-function discoverSkills(sessionCommands, options = {}) {
-  const minSessions = options.minSessions ?? 2;
-  const minLen = options.minSequenceLength ?? 2;
-  const maxLen = options.maxSequenceLength ?? 5;
-  const existing = new Set(options.existingSkillSlugs ?? []);
-  const sessionSequences = /* @__PURE__ */ new Map();
-  for (const [sessionId, commands] of sessionCommands) {
-    const sequences = extractSequences(commands, minLen, maxLen);
-    if (sequences.length > 0) {
-      sessionSequences.set(sessionId, sequences);
+// src/kernel/scheduler/interleaver.ts
+function interleave(items, maxConsecutive = 2) {
+  if (items.length <= 1) return [...items];
+  const byDomain = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const group = byDomain.get(item.domain);
+    if (group) {
+      group.push(item);
+    } else {
+      byDomain.set(item.domain, [item]);
     }
   }
-  const sequenceIndex = /* @__PURE__ */ new Map();
-  for (const [, sequences] of sessionSequences) {
-    const seen = /* @__PURE__ */ new Set();
-    for (const seq of sequences) {
-      const key = seq.join(" \u2192 ");
-      if (seen.has(key)) continue;
-      seen.add(key);
-      const entry = sequenceIndex.get(key);
-      if (entry) {
-        entry.sessionCount++;
-        entry.totalOccurrences++;
+  if (byDomain.size === 1) return [...items];
+  const result = [];
+  let consecutiveCount = 0;
+  let lastDomain = null;
+  const cursors = /* @__PURE__ */ new Map();
+  for (const domain of byDomain.keys()) {
+    cursors.set(domain, 0);
+  }
+  while (result.length < items.length) {
+    const activeDomains = [...byDomain.entries()].filter(
+      ([domain]) => (cursors.get(domain) ?? 0) < (byDomain.get(domain)?.length ?? 0)
+    ).sort((a, b) => {
+      const remainA = a[1].length - (cursors.get(a[0]) ?? 0);
+      const remainB = b[1].length - (cursors.get(b[0]) ?? 0);
+      return remainB - remainA;
+    });
+    if (activeDomains.length === 0) break;
+    let pickedThisRound = false;
+    for (const [domain, group] of activeDomains) {
+      const cursor = cursors.get(domain) ?? 0;
+      if (cursor >= group.length) continue;
+      if (domain === lastDomain && consecutiveCount >= maxConsecutive) {
+        continue;
+      }
+      result.push(group[cursor]);
+      cursors.set(domain, cursor + 1);
+      pickedThisRound = true;
+      if (domain === lastDomain) {
+        consecutiveCount++;
       } else {
-        sequenceIndex.set(key, {
-          steps: seq,
-          sessionCount: 1,
-          totalOccurrences: 1,
-          examples: []
-        });
+        lastDomain = domain;
+        consecutiveCount = 1;
       }
+      break;
     }
-  }
-  const lastSessionId = [...sessionCommands.keys()].pop();
-  if (lastSessionId) {
-    const lastCommands = sessionCommands.get(lastSessionId);
-    for (const [key, entry] of sequenceIndex) {
-      if (entry.sessionCount >= minSessions) {
-        entry.examples = findExamplesForSequence(lastCommands, entry.steps);
+    if (!pickedThisRound) {
+      for (const [domain, group] of activeDomains) {
+        const cursor = cursors.get(domain) ?? 0;
+        if (cursor >= group.length) continue;
+        result.push(group[cursor]);
+        cursors.set(domain, cursor + 1);
+        if (domain === lastDomain) {
+          consecutiveCount++;
+        } else {
+          lastDomain = domain;
+          consecutiveCount = 1;
+        }
+        break;
       }
     }
   }
-  const candidates = [...sequenceIndex.values()].filter(
-    (s) => s.sessionCount >= minSessions
+  return result;
+}
+
+// src/kernel/scheduler/queue.ts
+function buildReviewQueue(db, options) {
+  const maxNew = options.maxNew ?? 10;
+  const maxReviews = options.maxReviews ?? 50;
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const nowISO = now.toISOString();
+  const dueRows = db.prepare(
+    `SELECT
+         c.id       AS card_id,
+         c.token_id AS token_id,
+         t.slug     AS slug,
+         t.concept  AS concept,
+         t.domain   AS domain,
+         t.bloom_level AS bloom_level,
+         c.state    AS state,
+         c.due_at   AS due_at,
+         t.source_link AS source_link,
+         t.question AS question
+       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 c.state IN ('review', 'relearning', 'learning')
+         AND t.deprecated_at IS NULL
+       ORDER BY c.due_at ASC`
+  ).all(options.userId, nowISO);
+  const newRows = db.prepare(
+    `SELECT
+         c.id       AS card_id,
+         c.token_id AS token_id,
+         t.slug     AS slug,
+         t.concept  AS concept,
+         t.domain   AS domain,
+         t.bloom_level AS bloom_level,
+         c.state    AS state,
+         c.due_at   AS due_at,
+         t.source_link AS source_link,
+         t.question AS question
+       FROM cards c
+       JOIN tokens t ON t.id = c.token_id
+       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);
+  const nowMs = now.getTime();
+  const sortedDue = [...dueRows].sort((a, b) => {
+    const overdueA = nowMs - new Date(a.due_at).getTime();
+    const overdueB = nowMs - new Date(b.due_at).getTime();
+    return overdueB - overdueA;
+  });
+  const interleavedDue = interleave(
+    sortedDue.map((row) => ({ ...rowToItem(row), domain: row.domain }))
   );
-  const pruned = removeSubsequences(candidates);
-  const proposals = [];
-  for (const seq of pruned) {
-    const slug = generateSlug(seq.steps);
-    if (existing.has(slug)) continue;
-    proposals.push({
-      slug,
-      description: describeSequence(seq.steps),
-      steps: seq.steps,
-      sessionCount: seq.sessionCount,
-      confidence: seq.sessionCount >= 4 ? "high" : seq.sessionCount >= 3 ? "medium" : "low",
-      examples: seq.examples
-    });
+  const newItems = newRows.map(rowToItem);
+  const merged = intersperseNew(interleavedDue, newItems, 5);
+  const capped = merged.slice(0, maxReviews);
+  let newCount = 0;
+  let reviewCount = 0;
+  let relearnCount = 0;
+  const domainSet = /* @__PURE__ */ new Set();
+  for (const item of capped) {
+    domainSet.add(item.domain);
+    switch (item.state) {
+      case "new":
+        newCount++;
+        break;
+      case "relearning":
+        relearnCount++;
+        break;
+      default:
+        reviewCount++;
+        break;
+    }
   }
-  const confidenceOrder = { high: 0, medium: 1, low: 2 };
-  proposals.sort((a, b) => {
-    const confDiff = confidenceOrder[a.confidence] - confidenceOrder[b.confidence];
-    if (confDiff !== 0) return confDiff;
-    return b.sessionCount - a.sessionCount;
-  });
-  return proposals;
+  return {
+    items: capped,
+    newCount,
+    reviewCount,
+    relearnCount,
+    totalDomains: [...domainSet].sort()
+  };
 }
-function normalizeCommand(command) {
-  const parts = command.trim().split(/\s+/);
-  const multiWord = ["docker compose", "npm run", "npx", "git"];
-  const lower = command.toLowerCase();
-  for (const mw of multiWord) {
-    if (lower.startsWith(mw) && parts.length >= mw.split(" ").length + 1) {
-      return parts.slice(0, mw.split(" ").length + 1).join(" ").toLowerCase();
+function rowToItem(row) {
+  return {
+    cardId: row.card_id,
+    tokenId: row.token_id,
+    slug: row.slug,
+    concept: row.concept,
+    domain: row.domain,
+    bloomLevel: row.bloom_level,
+    state: row.state,
+    dueAt: row.due_at,
+    sourceLink: row.source_link,
+    question: row.question
+  };
+}
+function intersperseNew(reviews, newCards, interval) {
+  if (newCards.length === 0) return [...reviews];
+  if (reviews.length === 0) return [...newCards];
+  const result = [];
+  let reviewIdx = 0;
+  let newIdx = 0;
+  let position = 0;
+  while (reviewIdx < reviews.length || newIdx < newCards.length) {
+    if (newIdx < newCards.length && position > 0 && position % interval === interval - 1) {
+      result.push(newCards[newIdx]);
+      newIdx++;
+    } else if (reviewIdx < reviews.length) {
+      result.push(reviews[reviewIdx]);
+      reviewIdx++;
+    } else if (newIdx < newCards.length) {
+      result.push(newCards[newIdx]);
+      newIdx++;
     }
+    position++;
   }
-  return parts.slice(0, Math.min(2, parts.length)).join(" ").toLowerCase();
+  return result;
 }
-function extractSequences(commands, minLen, maxLen) {
-  const filtered = commands.filter((c) => {
-    const lower = c.command.toLowerCase().trim();
-    return lower.length > 0 && !lower.startsWith("cd ") && lower !== "cd" && lower !== "ls" && lower !== "pwd" && lower !== "clear" && lower !== "exit" && !lower.startsWith("echo ");
-  });
-  const normalized = filtered.map((c) => normalizeCommand(c.command));
-  const sequences = [];
-  for (let len = minLen; len <= maxLen; len++) {
-    for (let i = 0; i <= normalized.length - len; i++) {
-      const seq = normalized.slice(i, i + len);
-      if (new Set(seq).size >= 2) {
-        sequences.push(seq);
-      }
+
+// src/kernel/system/hooks.ts
+import {
+  appendFileSync as appendFileSync2,
+  copyFileSync,
+  existsSync as existsSync6,
+  mkdirSync as mkdirSync4,
+  readFileSync as readFileSync6
+} from "fs";
+import { homedir as homedir4 } from "os";
+import { join as join6 } from "path";
+import { fileURLToPath } from "url";
+var HOME = homedir4();
+function getPackageSkillPath(agent = "default") {
+  const packageRoot = [
+    fileURLToPath(new URL("../../..", import.meta.url)),
+    fileURLToPath(new URL("../..", import.meta.url)),
+    fileURLToPath(new URL("..", import.meta.url))
+  ].find((candidate) => existsSync6(join6(candidate, "package.json"))) ?? "";
+  if (!packageRoot) return "";
+  if (agent === "codex") {
+    const codexPath = join6(packageRoot, ".agents", "skills", "zam", "SKILL.md");
+    if (existsSync6(codexPath)) return codexPath;
+    return "";
+  }
+  if (agent === "claude") {
+    const claudePath = join6(
+      packageRoot,
+      ".claude",
+      "skills",
+      "zam",
+      "SKILL.md"
+    );
+    if (existsSync6(claudePath)) return claudePath;
+    return "";
+  }
+  let path = join6(packageRoot, ".agent", "skills", "zam", "SKILL.md");
+  if (existsSync6(path)) return path;
+  path = join6(packageRoot, ".claude", "skills", "zam", "SKILL.md");
+  if (existsSync6(path)) return path;
+  return "";
+}
+function distributeGlobalSkills(home = HOME) {
+  const sourceSkill = getPackageSkillPath();
+  const claudeSourceSkill = getPackageSkillPath("claude");
+  const codexSourceSkill = getPackageSkillPath("codex");
+  const results = [];
+  if (!sourceSkill) {
+    console.warn("Could not find ZAM source SKILL.md in the package folder.");
+    return results;
+  }
+  const claudeSkillsDir = join6(home, ".claude", "skills", "zam");
+  try {
+    if (!claudeSourceSkill) {
+      throw new Error("Claude skill source not found");
     }
+    mkdirSync4(claudeSkillsDir, { recursive: true });
+    copyFileSync(claudeSourceSkill, join6(claudeSkillsDir, "SKILL.md"));
+    results.push({
+      name: "Claude Code Global",
+      path: join6(claudeSkillsDir, "SKILL.md"),
+      success: true
+    });
+  } catch (_err) {
+    results.push({
+      name: "Claude Code Global",
+      path: claudeSkillsDir,
+      success: false
+    });
   }
-  return sequences;
+  const geminiSkillsDir = join6(home, ".gemini", "skills", "zam");
+  try {
+    mkdirSync4(geminiSkillsDir, { recursive: true });
+    copyFileSync(sourceSkill, join6(geminiSkillsDir, "SKILL.md"));
+    results.push({
+      name: "Gemini CLI Global",
+      path: join6(geminiSkillsDir, "SKILL.md"),
+      success: true
+    });
+  } catch (_err) {
+    results.push({
+      name: "Gemini CLI Global",
+      path: geminiSkillsDir,
+      success: false
+    });
+  }
+  const codexSkillsDir = join6(home, ".agents", "skills", "zam");
+  try {
+    if (!codexSourceSkill) {
+      throw new Error("Codex skill source not found");
+    }
+    mkdirSync4(codexSkillsDir, { recursive: true });
+    copyFileSync(codexSourceSkill, join6(codexSkillsDir, "SKILL.md"));
+    results.push({
+      name: "Codex Global",
+      path: join6(codexSkillsDir, "SKILL.md"),
+      success: true
+    });
+  } catch (_err) {
+    results.push({
+      name: "Codex Global",
+      path: codexSkillsDir,
+      success: false
+    });
+  }
+  const gooseSkillsDir = join6(home, ".goose", "skills", "zam");
+  try {
+    mkdirSync4(gooseSkillsDir, { recursive: true });
+    copyFileSync(sourceSkill, join6(gooseSkillsDir, "SKILL.md"));
+    results.push({
+      name: "Goose Global",
+      path: join6(gooseSkillsDir, "SKILL.md"),
+      success: true
+    });
+  } catch (_err) {
+    results.push({
+      name: "Goose Global",
+      path: gooseSkillsDir,
+      success: false
+    });
+  }
+  return results;
 }
-function findExamplesForSequence(commands, steps) {
-  const normalized = commands.map((c) => ({
-    norm: normalizeCommand(c.command),
-    full: c.command
-  }));
-  for (let i = 0; i <= normalized.length - steps.length; i++) {
-    let match = true;
-    for (let j = 0; j < steps.length; j++) {
-      if (normalized[i + j].norm !== steps[j]) {
-        match = false;
-        break;
+function injectShellHooks() {
+  const results = [];
+  const hookLine = `
+# ZAM Shell Observation Hooks
+if (command -v zam >/dev/null 2>&1); then eval "$(zam monitor start --quiet)"; fi
+`;
+  const pwshHookLine = `
+# ZAM Shell Observation Hooks
+if (Get-Command zam -ErrorAction SilentlyContinue) { Invoke-Expression (& zam monitor start --quiet pwsh) }
+`;
+  const zshrc = join6(HOME, ".zshrc");
+  if (existsSync6(zshrc)) {
+    try {
+      const content = readFileSync6(zshrc, "utf8");
+      if (content.includes("zam monitor start")) {
+        results.push({
+          shell: "zsh",
+          file: zshrc,
+          success: true,
+          alreadyHooked: true
+        });
+      } else {
+        appendFileSync2(zshrc, hookLine);
+        results.push({
+          shell: "zsh",
+          file: zshrc,
+          success: true,
+          alreadyHooked: false
+        });
       }
-    }
-    if (match) {
-      return normalized.slice(i, i + steps.length).map((n) => n.full);
+    } catch {
+      results.push({
+        shell: "zsh",
+        file: zshrc,
+        success: false,
+        alreadyHooked: false
+      });
     }
   }
-  return [];
-}
-function removeSubsequences(candidates) {
-  const sorted = [...candidates].sort((a, b) => b.steps.length - a.steps.length);
-  const result = [];
-  for (const candidate of sorted) {
-    const key = candidate.steps.join(" \u2192 ");
-    const isSubsequence = result.some((longer) => {
-      const longerKey = longer.steps.join(" \u2192 ");
-      return longerKey.includes(key) && longerKey !== key;
-    });
-    if (!isSubsequence) {
-      result.push(candidate);
+  const bashrc = join6(HOME, ".bashrc");
+  if (existsSync6(bashrc)) {
+    try {
+      const content = readFileSync6(bashrc, "utf8");
+      if (content.includes("zam monitor start")) {
+        results.push({
+          shell: "bash",
+          file: bashrc,
+          success: true,
+          alreadyHooked: true
+        });
+      } else {
+        appendFileSync2(bashrc, hookLine);
+        results.push({
+          shell: "bash",
+          file: bashrc,
+          success: true,
+          alreadyHooked: false
+        });
+      }
+    } catch {
+      results.push({
+        shell: "bash",
+        file: bashrc,
+        success: false,
+        alreadyHooked: false
+      });
+    }
+  }
+  const pwshDirs = [
+    join6(HOME, "Documents", "PowerShell"),
+    join6(HOME, "Documents", "WindowsPowerShell")
+  ];
+  for (const dir of pwshDirs) {
+    const profileFile = join6(dir, "Microsoft.PowerShell_profile.ps1");
+    try {
+      mkdirSync4(dir, { recursive: true });
+      let content = "";
+      if (existsSync6(profileFile)) {
+        content = readFileSync6(profileFile, "utf8");
+      }
+      if (content.includes("zam monitor start")) {
+        results.push({
+          shell: "powershell",
+          file: profileFile,
+          success: true,
+          alreadyHooked: true
+        });
+      } else {
+        appendFileSync2(profileFile, pwshHookLine);
+        results.push({
+          shell: "powershell",
+          file: profileFile,
+          success: true,
+          alreadyHooked: false
+        });
+      }
+    } catch {
+      results.push({
+        shell: "powershell",
+        file: profileFile,
+        success: false,
+        alreadyHooked: false
+      });
     }
   }
-  return result;
-}
-function generateSlug(steps) {
-  return steps.map((s) => {
-    const parts = s.split(/\s+/);
-    return parts[parts.length - 1];
-  }).join("-");
-}
-function describeSequence(steps) {
-  return `Recurring pattern: ${steps.join(" \u2192 ")}`;
+  return results;
 }
 
-// src/kernel/goals/engine.ts
-import { readdirSync, readFileSync as readFileSync2, writeFileSync, existsSync as existsSync3 } from "fs";
-import { join as join3, basename } from "path";
-
-// src/kernel/goals/parser.ts
-function parseGoalFile(content, slug, filePath) {
-  const { frontmatter, body } = splitFrontmatter(content);
-  const validStatuses = ["active", "completed", "paused", "abandoned"];
-  const status = validStatuses.includes(frontmatter.status) ? frontmatter.status : "active";
-  const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  return {
-    slug,
-    title: frontmatter.title || slug,
-    status,
-    parent: frontmatter.parent || null,
-    created: frontmatter.created || now,
-    updated: frontmatter.updated || now,
-    body,
-    filePath
-  };
-}
-function serializeGoal(goal) {
-  const lines = [
-    "---",
-    `title: ${goal.title}`,
-    `status: ${goal.status}`
-  ];
-  if (goal.parent) {
-    lines.push(`parent: ${goal.parent}`);
+// src/kernel/system/i18n.ts
+var TRANSLATIONS = {
+  en: {
+    welcome: "Learning session: {count} card(s)",
+    new_review_relearn: "  New: {newC}  Review: {reviewC}  Relearn: {relearnC}",
+    domains: "  Domains: {domains}",
+    instruction: "\nRecall each answer first, reveal it, then rate yourself honestly.",
+    quit_hint: "Type 'q' at the answer prompt (or press Ctrl+C) to stop anytime.",
+    offline_warning: "\n\x1B[33m\u26A0 LLM-Feedback & automatic translation are disabled.\x1B[0m",
+    offline_instruction: "  Enable with: \x1B[36mnpm run dev -- settings llm on\x1B[0m\n",
+    nothing_due: "Nothing due to learn. You're all caught up!",
+    evaluating: "Evaluating answer via local AI...",
+    generating_question: "Generating dynamic question...",
+    translating: "Translating question dynamically...",
+    prompt_answer: "Your answer (Enter to reveal \xB7 'q' to stop):",
+    session_ended: "Learning session ended.",
+    session_complete: "Learning session complete!",
+    cards_rated: "  Cards rated: {count}",
+    avg_rating: "  Average rating: {avg}",
+    forgot: "  Forgot: {count} card(s)",
+    feedback_title: "\u2500\u2500 ZAM Feedback {line}",
+    answer_title: "\u2500\u2500 Answer {line}",
+    keep_waiting: "Would you like to keep waiting?",
+    local_ai_working: "The local AI is still generating the response.",
+    wait_warning: "\u26A0 The LLM server is taking a while to load the model.",
+    wait_info: "(This is expected when transitioning between models or starting up from cold.)",
+    keep_waiting_llm: "Would you like to keep waiting for the model?",
+    proceeding_offline: "\u26A0 Proceeding in offline-mode (without active LLM evaluations for this session).",
+    eval_skipped: "  [LLM Evaluation skipped: {reason}]"
+  },
+  de: {
+    welcome: "Lern-Session: {count} Karte(n)",
+    new_review_relearn: "  Neu: {newC}  Wiederholen: {reviewC}  Lernen: {relearnC}",
+    domains: "  Dom\xE4nen: {domains}",
+    instruction: "\nRufe jede Antwort zuerst ab, decke sie auf und bewerte dich dann ehrlich selbst.",
+    quit_hint: "Gib 'q' bei der Antwortaufforderung ein (oder dr\xFCcke Strg+C), um jederzeit zu beenden.",
+    offline_warning: "\n\x1B[33m\u26A0 LLM-Feedback & automatische \xDCbersetzung sind deaktiviert.\x1B[0m",
+    offline_instruction: "  Aktivieren mit: \x1B[36mnpm run dev -- settings llm on\x1B[0m\n",
+    nothing_due: "Nichts f\xE4llig zu lernen. Du bist komplett auf dem Laufenden!",
+    evaluating: "Bewerte Antwort via lokaler KI...",
+    generating_question: "Generiere dynamische Frage...",
+    translating: "\xDCbersetze Frage dynamisch...",
+    prompt_answer: "Deine Antwort (Eingabe zum Aufdecken \xB7 'q' zum Beenden):",
+    session_ended: "Lern-Session beendet.",
+    session_complete: "Lern-Session abgeschlossen!",
+    cards_rated: "  Bewertete Karten: {count}",
+    avg_rating: "  Durchschnittliche Bewertung: {avg}",
+    forgot: "  Vergessen: {count} Karte(n)",
+    feedback_title: "\u2500\u2500 ZAM Feedback {line}",
+    answer_title: "\u2500\u2500 Antwort {line}",
+    keep_waiting: "M\xF6chtest du weiter auf die Bewertung warten?",
+    local_ai_working: "Die lokale KI arbeitet noch an der Antwort.",
+    wait_warning: "\u26A0 Der LLM-Server braucht ungew\xF6hnlich lange, um das Modell zu laden.",
+    wait_info: "(Das ist normal, wenn das Modell gewechselt wird oder kalt startet.)",
+    keep_waiting_llm: "M\xF6chtest du weiter auf das Modell warten?",
+    proceeding_offline: "\u26A0 Fahre im Offline-Modus fort (ohne aktive LLM-Bewertungen in dieser Runde).",
+    eval_skipped: "  [LLM-Bewertung \xFCbersprungen: {reason}]"
+  },
+  es: {
+    welcome: "Sesi\xF3n de aprendizaje: {count} tarjeta(s)",
+    new_review_relearn: "  Nuevas: {newC}  Repasar: {reviewC}  Reaprender: {relearnC}",
+    domains: "  Dominios: {domains}",
+    instruction: "\nRecuerda cada respuesta primero, rev\xE9lala y calif\xEDcate honestamente.",
+    quit_hint: "Escribe 'q' en la respuesta (o presiona Ctrl+C) para salir en cualquier momento.",
+    offline_warning: "\n\x1B[33m\u26A0 Los comentarios de LLM y la traducci\xF3n autom\xE1tica est\xE1n desactivados.\x1B[0m",
+    offline_instruction: "  Activar con: \x1B[36mnpm run dev -- settings llm on\x1B[0m\n",
+    nothing_due: "No hay nada pendiente para aprender. \xA1Est\xE1s al d\xEDa!",
+    evaluating: "Evaluando respuesta con IA local...",
+    generating_question: "Generando pregunta din\xE1mica...",
+    translating: "Traduciendo pregunta din\xE1micamente...",
+    prompt_answer: "Tu respuesta (Intro para revelar \xB7 'q' para salir):",
+    session_ended: "Sesi\xF3n de aprendizaje finalizada.",
+    session_complete: "\xA1Sesi\xF3n de aprendizaje completada!",
+    cards_rated: "  Tarjetas calificadas: {count}",
+    avg_rating: "  Calificaci\xF3n promedio: {avg}",
+    forgot: "  Olvidadas: {count} tarjeta(s)",
+    feedback_title: "\u2500\u2500 Comentarios de ZAM {line}",
+    answer_title: "\u2500\u2500 Respuesta {line}",
+    keep_waiting: "\xBFDeseas seguir esperando la evaluaci\xF3n?",
+    local_ai_working: "La IA local todav\xEDa est\xE1 generando la respuesta.",
+    wait_warning: "\u26A0 El servidor LLM est\xE1 tardando en cargar el modelo.",
+    wait_info: "(Esto es normal al cambiar de modelo o iniciar en fr\xEDo.)",
+    keep_waiting_llm: "\xBFDeseas seguir esperando el modelo?",
+    proceeding_offline: "\u26A0 Continuando en modo fuera de l\xEDnea (sin evaluaciones de LLM en esta sesi\xF3n).",
+    eval_skipped: "  [Evaluaci\xF3n de LLM omitida: {reason}]"
+  },
+  fr: {
+    welcome: "Session d'apprentissage : {count} carte(s)",
+    new_review_relearn: "  Nouveau: {newC}  R\xE9vision: {reviewC}  Relever: {relearnC}",
+    domains: "  Domaines: {domains}",
+    instruction: "\nRappelez-vous chaque r\xE9ponse d'abord, r\xE9v\xE9lez-la, puis \xE9valuez-vous honn\xEAtement.",
+    quit_hint: "Tapez 'q' (ou Ctrl+C) pour quitter \xE0 tout moment.",
+    offline_warning: "\n\x1B[33m\u26A0 Les commentaires LLM et la traduction automatique sont d\xE9sactiv\xE9s.\x1B[0m",
+    offline_instruction: "  Activer avec : \x1B[36mnpm run dev -- settings llm on\x1B[0m\n",
+    nothing_due: "Rien \xE0 apprendre. Vous \xEAtes \xE0 jour !",
+    evaluating: "\xC9valuation de la r\xE9ponse via l'IA locale...",
+    generating_question: "G\xE9n\xE9ration d'une question dynamique...",
+    translating: "Traduction dynamique de la question...",
+    prompt_answer: "Votre r\xE9ponse (Entr\xE9e pour r\xE9v\xE9ler \xB7 'q' pour quitter) :",
+    session_ended: "Session d'apprentissage arr\xEAt\xE9e.",
+    session_complete: "Session d'apprentissage termin\xE9e !",
+    cards_rated: "  Cartes \xE9valu\xE9es: {count}",
+    avg_rating: "  Note moyenne: {avg}",
+    forgot: "  Oubli\xE9es: {count} carte(s)",
+    feedback_title: "\u2500\u2500 Commentaires ZAM {line}",
+    answer_title: "\u2500\u2500 R\xE9ponse {line}",
+    keep_waiting: "Voulez-vous continuer \xE0 attendre l'\xE9valuation ?",
+    local_ai_working: "L'IA locale est toujours en train de g\xE9n\xE9rer la r\xE9ponse.",
+    wait_warning: "\u26A0 Le serveur LLM prend du temps pour charger le mod\xE8le.",
+    wait_info: "(Ceci est normal lors de la transition entre mod\xE8les ou du d\xE9marrage \xE0 froid.)",
+    keep_waiting_llm: "Voulez-vous continuer \xE0 attendre le mod\xE8le ?",
+    proceeding_offline: "\u26A0 Poursuite en mode hors ligne (sans \xE9valuation active de l'IA pour cette session).",
+    eval_skipped: "  [\xC9valuation LLM ignor\xE9e : {reason}]"
+  },
+  pt: {
+    welcome: "Sess\xE3o de aprendizado: {count} cart\xE3o(\xF5es)",
+    new_review_relearn: "  Novos: {newC}  Revisar: {reviewC}  Reaprender: {relearnC}",
+    domains: "  Dom\xEDnios: {domains}",
+    instruction: "\nLembre-se de cada resposta primeiro, revele-a e avalie-se honestamente.",
+    quit_hint: "Digite 'q' (ou Ctrl+C) para parar a qualquer momento.",
+    offline_warning: "\n\x1B[33m\u26A0 O feedback do LLM e a tradu\xE7\xE3o autom\xE1tica est\xE3o desativados.\x1B[0m",
+    offline_instruction: "  Ativar com: \x1B[36mnpm run dev -- settings llm on\x1B[0m\n",
+    nothing_due: "Nada faturado para aprender. Voc\xEA est\xE1 atualizado!",
+    evaluating: "Avaliando a resposta via IA local...",
+    generating_question: "Gerando pergunta din\xE2mica...",
+    translating: "Traduzindo pergunta dinamicamente...",
+    prompt_answer: "Sua resposta (Enter para revelar \xB7 'q' para parar):",
+    session_ended: "Sess\xE3o de aprendizado encerrada.",
+    session_complete: "Sess\xE3o de aprendizado conclu\xEDda!",
+    cards_rated: "  Cart\xF5es avaliados: {count}",
+    avg_rating: "  Nota m\xE9dia: {avg}",
+    forgot: "  Esquecidos: {count} cart\xE3o(\xF5es)",
+    feedback_title: "\u2500\u2500 Feedback ZAM {line}",
+    answer_title: "\u2500\u2500 Resposta {line}",
+    keep_waiting: "Deseja continuar esperando pela avalia\xE7\xE3o?",
+    local_ai_working: "A IA local ainda est\xE1 gerando a resposta.",
+    wait_warning: "\u26A0 O servidor LLM est\xE1 demorando para carregar o modelo.",
+    wait_info: "(Isso \xE9 esperado ao alternar modelos ou iniciar do zero.)",
+    keep_waiting_llm: "Deseja continuar esperando o modelo?",
+    proceeding_offline: "\u26A0 Continuando no modo offline (sem avalia\xE7\xF5es de LLM ativas nesta sess\xE3o).",
+    eval_skipped: "  [Avalia\xE7\xE3o LLM omitida: {reason}]"
+  },
+  zh: {
+    welcome: "\u5B66\u4E60\u8BFE: {count} \u5F20\u5361\u7247",
+    new_review_relearn: "  \u65B0\u5361: {newC}  \u590D\u4E60: {reviewC}  \u91CD\u5B66: {relearnC}",
+    domains: "  \u77E5\u8BC6\u9886\u57DF: {domains}",
+    instruction: "\n\u9996\u5148\u5728\u8111\u4E2D\u56DE\u5FC6\u7B54\u6848\uFF0C\u7136\u540E\u63ED\u6653\u5E76\u8BDA\u5B9E\u81EA\u6211\u8BC4\u5206\u3002",
+    quit_hint: "\u5728\u56DE\u7B54\u63D0\u793A\u5904\u8F93\u5165 'q' (\u6216\u6309 Ctrl+C) \u53EF\u968F\u65F6\u9000\u51FA\u3002",
+    offline_warning: "\n\x1B[33m\u26A0 LLM \u53CD\u9988\u4E0E\u81EA\u52A8\u7FFB\u8BD1\u5DF2\u7981\u7528\u3002\x1B[0m",
+    offline_instruction: "  \u5F00\u542F\u547D\u4EE4: \x1B[36mnpm run dev -- settings llm on\x1B[0m\n",
+    nothing_due: "\u76EE\u524D\u6CA1\u6709\u9700\u8981\u5B66\u4E60\u7684\u5185\u5BB9\u3002\u60A8\u5DF2\u5168\u90E8\u638C\u63E1\uFF01",
+    evaluating: "\u6B63\u5728\u901A\u8FC7\u672C\u5730 AI \u8BC4\u4F30\u56DE\u7B54...",
+    generating_question: "\u6B63\u5728\u52A8\u6001\u751F\u6210\u95EE\u9898...",
+    translating: "\u6B63\u5728\u52A8\u6001\u7FFB\u8BD1\u95EE\u9898...",
+    prompt_answer: "\u60A8\u7684\u56DE\u7B54 (\u6309\u56DE\u8F66\u63ED\u6653 \xB7 \u8F93\u5165 'q' \u9000\u51FA):",
+    session_ended: "\u5B66\u4E60\u8BFE\u5DF2\u7ED3\u675F\u3002",
+    session_complete: "\u5B66\u4E60\u8BFE\u5DF2\u5B8C\u6210\uFF01",
+    cards_rated: "  \u5DF2\u8BC4\u5206\u5361\u7247: {count}",
+    avg_rating: "  \u5E73\u5747\u5206: {avg}",
+    forgot: "  \u9057\u5FD8: {count} \u5F20\u5361\u7247",
+    feedback_title: "\u2500\u2500 ZAM \u53CD\u9988 {line}",
+    answer_title: "\u2500\u2500 \u53C2\u8003\u7B54\u6848 {line}",
+    keep_waiting: "\u662F\u5426\u7EE7\u7EED\u7B49\u5F85\u8BC4\u5206\uFF1F",
+    local_ai_working: "\u672C\u5730 AI \u4ECD\u5728\u751F\u6210\u56DE\u7B54\u3002",
+    wait_warning: "\u26A0 LLM \u670D\u52A1\u5668\u6B63\u5728\u52A0\u8F7D\u6A21\u578B\uFF0C\u8FD9\u53EF\u80FD\u9700\u8981\u4E00\u4E9B\u65F6\u95F4\u3002",
+    wait_info: "(\u8FD9\u5728\u5207\u6362\u6A21\u578B\u6216\u51B7\u542F\u52A8\u65F6\u662F\u6B63\u5E38\u73B0\u8C61\u3002)",
+    keep_waiting_llm: "\u662F\u5426\u7EE7\u7EED\u7B49\u5F85\u6A21\u578B\u52A0\u8F7D\uFF1F",
+    proceeding_offline: "\u26A0 \u6B63\u5728\u4EE5\u79BB\u7EBF\u6A21\u5F0F\u7EE7\u7EED\uFF08\u672C\u6B21\u5B66\u4E60\u8BFE\u5C06\u4E0D\u5305\u542B\u6D3B\u8DC3\u7684 AI \u8BC4\u4F30\uFF09\u3002",
+    eval_skipped: "  [\u5DF2\u8DF3\u8FC7 LLM \u8BC4\u4F30: {reason}]"
+  },
+  ja: {
+    welcome: "\u5B66\u7FD2\u30BB\u30C3\u30B7\u30E7\u30F3: {count} \u679A\u306E\u30AB\u30FC\u30C9",
+    new_review_relearn: "  \u65B0\u898F: {newC}  \u5FA9\u7FD2: {reviewC}  \u518D\u5B66\u7FD2: {relearnC}",
+    domains: "  \u30C9\u30E1\u30A4\u30F3: {domains}",
+    instruction: "\n\u6700\u521D\u306B\u56DE\u7B54\u3092\u601D\u3044\u51FA\u3057\u3001\u6B21\u306B\u56DE\u7B54\u3092\u8868\u793A\u3057\u3066\u3001\u6B63\u76F4\u306B\u81EA\u5DF1\u8A55\u4FA1\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+    quit_hint: "\u56DE\u7B54\u30D7\u30ED\u30F3\u30D7\u30C8\u3067\u300Cq\u300D\u3092\u5165\u529B\u3059\u308B\uFF08\u307E\u305F\u306F Ctrl+C \u3092\u62BC\u3059\uFF09\u3068\u3001\u3044\u3064\u3067\u3082\u7D42\u4E86\u3067\u304D\u307E\u3059\u3002",
+    offline_warning: "\n\x1B[33m\u26A0 LLM \u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u3068\u81EA\u52D5\u7FFB\u8A33\u306F\u7121\u52B9\u3067\u3059\u3002\x1B[0m",
+    offline_instruction: "  \u6709\u52B9\u5316\u3059\u308B\u306B\u306F: \x1B[36mnpm run dev -- settings llm on\x1B[0m\n",
+    nothing_due: "\u5B66\u7FD2\u4E88\u5B9A\u306E\u30AB\u30FC\u30C9\u306F\u3042\u308A\u307E\u305B\u3093\u3002\u3059\u3079\u3066\u5B8C\u4E86\u3057\u3066\u3044\u307E\u3059\uFF01",
+    evaluating: "\u30ED\u30FC\u30AB\u30EBAI\u306B\u3088\u308B\u56DE\u7B54\u306E\u8A55\u4FA1\u4E2D...",
+    generating_question: "\u8CEA\u554F\u3092\u52D5\u7684\u306B\u751F\u6210\u4E2D...",
+    translating: "\u8CEA\u554F\u3092\u52D5\u7684\u306B\u7FFB\u8A33\u4E2D...",
+    prompt_answer: "\u3042\u306A\u305F\u306E\u56DE\u7B54 (Enter\u3067\u8868\u793A \xB7 'q'\u3067\u7D42\u4E86):",
+    session_ended: "\u5B66\u7FD2\u30BB\u30C3\u30B7\u30E7\u30F3\u304C\u7D42\u4E86\u3057\u307E\u3057\u305F\u3002",
+    session_complete: "\u5B66\u7FD2\u30BB\u30C3\u30B7\u30E7\u30F3\u304C\u5B8C\u4E86\u3057\u307E\u3057\u305F\uFF01",
+    cards_rated: "  \u8A55\u4FA1\u6E08\u307F\u30AB\u30FC\u30C9\u6570: {count}",
+    avg_rating: "  \u5E73\u5747\u8A55\u4FA1: {avg}",
+    forgot: "  \u5FD8\u308C\u305F\u30AB\u30FC\u30C9\u6570: {count} \u679A",
+    feedback_title: "\u2500\u2500 ZAM \u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF {line}",
+    answer_title: "\u2500\u2500 \u89E3\u7B54 {line}",
+    keep_waiting: "\u8A55\u4FA1\u306E\u751F\u6210\u3092\u5F85\u3061\u307E\u3059\u304B\uFF1F",
+    local_ai_working: "\u30ED\u30FC\u30AB\u30EBAI\u304C\u56DE\u7B54\u3092\u751F\u6210\u3057\u3066\u3044\u307E\u3059\u3002",
+    wait_warning: "\u26A0 LLM \u30B5\u30FC\u30D0\u30FC\u304C\u30E2\u30C7\u30EB\u3092\u30ED\u30FC\u30C9\u3059\u308B\u306E\u306B\u6642\u9593\u304C\u304B\u304B\u3063\u3066\u3044\u307E\u3059\u3002",
+    wait_info: "(\u30E2\u30C7\u30EB\u306E\u79FB\u884C\u4E2D\u3084\u30B3\u30FC\u30EB\u30C9\u30B9\u30BF\u30FC\u30C8\u6642\u306B\u306F\u3001\u3053\u308C\u304C\u4E88\u60F3\u3055\u308C\u307E\u3059\u3002)",
+    keep_waiting_llm: "\u30E2\u30C7\u30EB\u306E\u30ED\u30FC\u30C9\u3092\u5F85\u3061\u7D9A\u3051\u307E\u3059\u304B\uFF1F",
+    proceeding_offline: "\u26A0 \u30AA\u30D5\u30E9\u30A4\u30F3\u30E2\u30FC\u30C9\u3067\u7D9A\u884C\u3057\u307E\u3059\uFF08\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067\u306F\u30A2\u30AF\u30C6\u30A3\u30D6\u306A AI \u8A55\u4FA1\u306F\u884C\u308F\u308C\u307E\u305B\u3093\uFF09\u3002",
+    eval_skipped: "  [LLM \u8A55\u4FA1\u304C\u30B9\u30AD\u30C3\u30D7\u3055\u308C\u307E\u3057\u305F: {reason}]"
   }
-  lines.push(`created: ${goal.created}`);
-  lines.push(`updated: ${goal.updated}`);
-  lines.push("---");
-  lines.push("");
-  if (goal.body.trim()) {
-    lines.push(goal.body.trim());
-    lines.push("");
+};
+function t(locale, key, params = {}) {
+  const dict = TRANSLATIONS[locale] || TRANSLATIONS.en;
+  let str = dict[key] || TRANSLATIONS.en[key] || "";
+  for (const [k, v] of Object.entries(params)) {
+    str = str.replace(new RegExp(`{${k}}`, "g"), String(v));
   }
-  return lines.join("\n");
+  return str;
 }
-function extractTasks(body) {
-  const tasks = [];
-  const taskRegex = /^[-*]\s+\[([ xX])\]\s+(.+)$/gm;
-  let match;
-  while ((match = taskRegex.exec(body)) !== null) {
-    tasks.push({
-      done: match[1] !== " ",
-      text: match[2].trim()
-    });
+
+// src/kernel/system/installer.ts
+import { execSync } from "child_process";
+import { existsSync as existsSync7 } from "fs";
+import { homedir as homedir5 } from "os";
+import { join as join7 } from "path";
+function hasCommand(cmd) {
+  try {
+    const checkCmd = process.platform === "win32" ? `where ${cmd}` : `which ${cmd}`;
+    execSync(checkCmd, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
   }
-  return tasks;
 }
-function extractTokenRefs(body) {
-  const tokensSection = body.match(/## Tokens\n([\s\S]*?)(?=\n## |\n*$)/);
-  if (!tokensSection) return [];
-  const refs = [];
-  const lines = tokensSection[1].split("\n");
-  for (const line of lines) {
-    const match = line.match(/^[-*]\s+(\S+)/);
-    if (match) {
-      refs.push(match[1]);
-    }
+function installFastFlowLM() {
+  if (process.platform !== "win32") {
+    return {
+      success: false,
+      message: "FastFlowLM is only supported on Windows."
+    };
+  }
+  const hasFlm = hasCommand("flm") || existsSync7("C:\\Program Files\\flm\\flm.exe");
+  if (hasFlm) {
+    return { success: true, message: "FastFlowLM is already installed." };
+  }
+  if (!hasCommand("winget")) {
+    return {
+      success: false,
+      message: "winget package manager was not found on this system."
+    };
+  }
+  console.log("Installing FastFlowLM via winget...");
+  try {
+    execSync(
+      "winget install -e --id FastFlowLM --accept-source-agreements --accept-package-agreements",
+      { stdio: "inherit" }
+    );
+    return { success: true, message: "FastFlowLM installed successfully." };
+  } catch (err) {
+    return {
+      success: false,
+      message: `Failed to install FastFlowLM: ${err.message}`
+    };
   }
-  return refs;
 }
-function splitFrontmatter(content) {
-  const trimmed = content.trim();
-  if (!trimmed.startsWith("---")) {
-    return { frontmatter: {}, body: trimmed };
+function installOllama() {
+  const isMac = process.platform === "darwin";
+  const isWin = process.platform === "win32";
+  const hasOllama = hasCommand("ollama") || isMac && existsSync7("/Applications/Ollama.app") || isWin && existsSync7(
+    join7(homedir5(), "AppData", "Local", "Programs", "Ollama", "ollama.exe")
+  );
+  if (hasOllama) {
+    return { success: true, message: "Ollama is already installed." };
   }
-  const endIndex = trimmed.indexOf("---", 3);
-  if (endIndex === -1) {
-    return { frontmatter: {}, body: trimmed };
+  if (process.platform === "darwin") {
+    if (!hasCommand("brew")) {
+      return {
+        success: false,
+        message: "Homebrew was not found. Please install Homebrew from brew.sh first."
+      };
+    }
+    console.log("Installing Ollama via Homebrew Cask...");
+    try {
+      execSync("brew install --cask ollama", { stdio: "inherit" });
+      return { success: true, message: "Ollama installed successfully." };
+    } catch (err) {
+      return {
+        success: false,
+        message: `Failed to install Ollama: ${err.message}`
+      };
+    }
+  } else if (process.platform === "win32") {
+    if (!hasCommand("winget")) {
+      return {
+        success: false,
+        message: "winget was not found. Please install winget first."
+      };
+    }
+    console.log("Installing Ollama via winget...");
+    try {
+      execSync(
+        "winget install -e --id Ollama.Ollama --accept-source-agreements --accept-package-agreements",
+        { stdio: "inherit" }
+      );
+      return { success: true, message: "Ollama installed successfully." };
+    } catch (err) {
+      return {
+        success: false,
+        message: `Failed to install Ollama: ${err.message}`
+      };
+    }
+  } else {
+    console.log("Installing Ollama via official installer script...");
+    try {
+      execSync("curl -fsSL https://ollama.com/install.sh | sh", {
+        stdio: "inherit"
+      });
+      return { success: true, message: "Ollama installed successfully." };
+    } catch (err) {
+      return {
+        success: false,
+        message: `Failed to install Ollama: ${err.message}`
+      };
+    }
   }
-  const fmBlock = trimmed.slice(3, endIndex).trim();
-  const body = trimmed.slice(endIndex + 3).trim();
-  const frontmatter = {};
-  for (const line of fmBlock.split("\n")) {
-    const colonIndex = line.indexOf(":");
-    if (colonIndex === -1) continue;
-    const key = line.slice(0, colonIndex).trim();
-    const value = line.slice(colonIndex + 1).trim();
-    if (key && value) {
-      frontmatter[key] = value;
+}
+
+// src/kernel/system/locale.ts
+import { execSync as execSync2 } from "child_process";
+var SUPPORTED_LOCALES = /* @__PURE__ */ new Set([
+  "en",
+  "de",
+  "es",
+  "fr",
+  "pt",
+  "zh",
+  "ja"
+]);
+function normalizeLocale(raw) {
+  const clean = raw.trim().toLowerCase().split(/[_-]/)[0];
+  if (SUPPORTED_LOCALES.has(clean)) {
+    return clean;
+  }
+  return "en";
+}
+function detectSystemLocale() {
+  try {
+    const envVars = [
+      process.env.LANG,
+      process.env.LANGUAGE,
+      process.env.LC_ALL,
+      process.env.LC_MESSAGES
+    ];
+    for (const val of envVars) {
+      if (val && val.trim().length > 0) {
+        return normalizeLocale(val);
+      }
+    }
+    if (process.platform === "win32") {
+      const output = execSync2(
+        'powershell -NoProfile -Command "[System.Globalization.CultureInfo]::CurrentCulture.Name"',
+        { stdio: "pipe", encoding: "utf8", timeout: 2e3 }
+      ).trim();
+      if (output && output.length > 0) {
+        return normalizeLocale(output);
+      }
     }
+  } catch {
   }
-  return { frontmatter, body };
+  return "en";
 }
 
-// src/kernel/goals/engine.ts
-function listGoals(goalsDir) {
-  if (!existsSync3(goalsDir)) return [];
-  const files = readdirSync(goalsDir).filter(
-    (f) => f.endsWith(".md") && f !== "README.md"
-  );
-  const summaries = [];
-  for (const file of files) {
-    const filePath = join3(goalsDir, file);
-    const content = readFileSync2(filePath, "utf-8");
-    const slug = basename(file, ".md");
-    const goal = parseGoalFile(content, slug, filePath);
-    const tasks = extractTasks(goal.body);
-    const tokens = extractTokenRefs(goal.body);
-    summaries.push({
-      slug: goal.slug,
-      title: goal.title,
-      status: goal.status,
-      parent: goal.parent,
-      taskCount: tasks.length,
-      tasksDone: tasks.filter((t) => t.done).length,
-      tokenCount: tokens.length
-    });
+// src/kernel/system/profiler.ts
+import { execSync as execSync3 } from "child_process";
+function runCommand(cmd) {
+  try {
+    return execSync3(cmd, { stdio: "pipe", encoding: "utf8" }).trim();
+  } catch {
+    return "";
   }
-  const statusOrder = {
-    active: 0,
-    paused: 1,
-    completed: 2,
-    abandoned: 3
-  };
-  summaries.sort((a, b) => {
-    const statusDiff = statusOrder[a.status] - statusOrder[b.status];
-    if (statusDiff !== 0) return statusDiff;
-    return a.title.localeCompare(b.title);
-  });
-  return summaries;
 }
-function getGoal(goalsDir, slug) {
-  const filePath = join3(goalsDir, `${slug}.md`);
-  if (!existsSync3(filePath)) return void 0;
-  const content = readFileSync2(filePath, "utf-8");
-  return parseGoalFile(content, slug, filePath);
+function detectWindowsAMDIPU() {
+  if (process.platform !== "win32") return false;
+  const cmd = `powershell -NoProfile -Command "Get-CimInstance Win32_PnPEntity | Where-Object { $_.Name -like '*AMD IPU*' -or $_.Name -like '*AMD NPU*' -or $_.Name -like '*NPU Compute*' -or $_.Name -like '*Ryzen AI*' -or $_.HardwareID -like '*VEN_1022&DEV_1502*' -or $_.HardwareID -like '*VEN_1022&DEV_17F0*' } | Select-Object -First 1 -ExpandProperty Name"`;
+  const output = runCommand(cmd);
+  return Boolean(
+    output && (output.toLowerCase().includes("amd") || output.toLowerCase().includes("ipu") || output.toLowerCase().includes("npu") || output.toLowerCase().includes("ryzen"))
+  );
 }
-function createGoal(goalsDir, input) {
-  const filePath = join3(goalsDir, `${input.slug}.md`);
-  if (existsSync3(filePath)) {
-    throw new Error(`Goal already exists: ${input.slug}`);
+function getSystemProfile() {
+  const platform = process.platform;
+  const archStr = process.arch;
+  let os = "unknown";
+  if (platform === "win32") os = "windows";
+  else if (platform === "darwin") os = "macos";
+  else if (platform === "linux") os = "linux";
+  let arch = "unknown";
+  if (archStr === "x64") arch = "x64";
+  else if (archStr === "arm64") arch = "arm64";
+  const hasRyzenNPU = os === "windows" && detectWindowsAMDIPU();
+  const hasAppleSilicon = os === "macos" && arch === "arm64";
+  let recommendedRunner = "generic";
+  let recommendedModel = "qwen3.5:4b";
+  if (hasRyzenNPU) {
+    recommendedRunner = "fastflowlm";
+    recommendedModel = "qwen3.5:4b";
+  } else if (hasAppleSilicon) {
+    recommendedRunner = "ollama";
+    recommendedModel = "llama3.2:3b";
+  } else if (os === "macos" || os === "linux" || os === "windows") {
+    recommendedRunner = "ollama";
+    recommendedModel = "llama3.2:3b";
   }
-  const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  const goal = {
-    slug: input.slug,
-    title: input.title,
-    status: input.status ?? "active",
-    parent: input.parent ?? null,
-    created: now,
-    updated: now,
-    body: input.description ? `## Description
-${input.description}
-
-## Tasks
+  return {
+    os,
+    arch,
+    hasRyzenNPU,
+    hasAppleSilicon,
+    recommendedRunner,
+    recommendedModel
+  };
+}
 
-## Tokens` : "## Description\n\n## Tasks\n\n## Tokens",
-    filePath
+// src/kernel/system/repos.ts
+import { existsSync as existsSync8 } from "fs";
+import { resolve as resolve2 } from "path";
+function getRepoPaths(db) {
+  const personalSetting = getSetting(db, "repo.personal") || getSetting(db, "personal.workspace_dir");
+  const teamSetting = getSetting(db, "repo.team");
+  const orgSetting = getSetting(db, "repo.org");
+  return {
+    personal: personalSetting ? resolve2(personalSetting) : null,
+    team: teamSetting ? resolve2(teamSetting) : null,
+    org: orgSetting ? resolve2(orgSetting) : null
   };
-  writeFileSync(filePath, serializeGoal(goal), "utf-8");
-  return goal;
 }
-function updateGoalStatus(goalsDir, slug, status) {
-  const goal = getGoal(goalsDir, slug);
-  if (!goal) throw new Error(`Goal not found: ${slug}`);
-  goal.status = status;
-  goal.updated = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  writeFileSync(goal.filePath, serializeGoal(goal), "utf-8");
-  return goal;
+function resolveRepoPath(db, type) {
+  const paths = getRepoPaths(db);
+  return paths[type];
 }
-function getGoalTree(goalsDir) {
-  const all = listGoals(goalsDir);
-  const bySlug = new Map(all.map((g) => [g.slug, g]));
-  const roots = [];
-  const children = /* @__PURE__ */ new Map();
-  for (const g of all) {
-    if (g.parent && bySlug.has(g.parent)) {
-      const list = children.get(g.parent) ?? [];
-      list.push(g);
-      children.set(g.parent, list);
-    }
+function resolveAllBeliefPaths(db) {
+  const paths = getRepoPaths(db);
+  const dirs = [];
+  if (paths.personal) {
+    const personalDir = resolve2(paths.personal, "beliefs");
+    if (existsSync8(personalDir)) dirs.push(personalDir);
   }
-  for (const g of all) {
-    if (!g.parent || !bySlug.has(g.parent)) {
-      roots.push({ ...g, children: children.get(g.slug) ?? [] });
-    }
+  if (paths.team) {
+    const teamDir = resolve2(paths.team, "beliefs");
+    if (existsSync8(teamDir)) dirs.push(teamDir);
   }
-  return roots;
-}
-
-// src/kernel/connectors/azure-devops.ts
-function loadADOConfig(db) {
-  const orgUrl = getSetting(db, "ado.org_url");
-  const project = getSetting(db, "ado.project");
-  const pat = getSetting(db, "ado.pat");
-  if (!orgUrl || !project || !pat) return null;
-  return { orgUrl: orgUrl.replace(/\/+$/, ""), project, pat };
-}
-function authHeader(pat) {
-  return `Basic ${Buffer.from(`:${pat}`).toString("base64")}`;
+  if (paths.org) {
+    const orgDir = resolve2(paths.org, "beliefs");
+    if (existsSync8(orgDir)) dirs.push(orgDir);
+  }
+  return dirs;
 }
-async function fetchActiveWorkItems(config) {
-  const { orgUrl, project, pat } = config;
-  const wiqlUrl = `${orgUrl}/${project}/_apis/wit/wiql?api-version=7.1`;
-  const wiqlBody = {
-    query: `SELECT [System.Id] FROM WorkItems WHERE [System.AssignedTo] = @me AND [System.State] NOT IN ('Closed', 'Completed', 'Done', 'Removed') ORDER BY [Microsoft.VSTS.Common.Priority] ASC, [System.ChangedDate] DESC`
-  };
-  const wiqlRes = await fetch(wiqlUrl, {
-    method: "POST",
-    headers: {
-      Authorization: authHeader(pat),
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify(wiqlBody)
-  });
-  if (!wiqlRes.ok) {
-    const text = await wiqlRes.text();
-    throw new Error(`ADO WIQL query failed (${wiqlRes.status}): ${text}`);
+function resolveAllGoalPaths(db) {
+  const paths = getRepoPaths(db);
+  const dirs = [];
+  if (paths.personal) {
+    const personalDir = resolve2(paths.personal, "goals");
+    if (existsSync8(personalDir)) dirs.push(personalDir);
   }
-  const wiqlData = await wiqlRes.json();
-  const ids = wiqlData.workItems.map((wi) => wi.id);
-  if (ids.length === 0) return [];
-  const batchIds = ids.slice(0, 200);
-  const fields = "System.Id,System.Title,System.State,System.WorkItemType,System.AssignedTo";
-  const detailUrl = `${orgUrl}/${project}/_apis/wit/workitems?ids=${batchIds.join(",")}&fields=${fields}&api-version=7.1`;
-  const detailRes = await fetch(detailUrl, {
-    headers: { Authorization: authHeader(pat) }
-  });
-  if (!detailRes.ok) {
-    const text = await detailRes.text();
-    throw new Error(`ADO work items fetch failed (${detailRes.status}): ${text}`);
+  if (paths.team) {
+    const teamDir = resolve2(paths.team, "goals");
+    if (existsSync8(teamDir)) dirs.push(teamDir);
   }
-  const detailData = await detailRes.json();
-  return detailData.value.map((wi) => ({
-    id: wi.id,
-    title: wi.fields["System.Title"],
-    state: wi.fields["System.State"],
-    type: wi.fields["System.WorkItemType"],
-    assignedTo: wi.fields["System.AssignedTo"]?.displayName ?? ""
-  }));
+  if (paths.org) {
+    const orgDir = resolve2(paths.org, "goals");
+    if (existsSync8(orgDir)) dirs.push(orgDir);
+  }
+  return dirs;
 }
 export {
+  DEFAULT_REVIEW_CONTEXT_MAX_CHARS,
   addPrerequisite,
   analyzeObservation,
   buildReviewQueue,
   cascadeBlock,
+  clearADOCredentials,
+  clearTursoCredentials,
   createAgentSkill,
   createFSRS,
   createGoal,
   createToken,
+  deleteCardForUser,
   deleteSetting,
+  deleteToken,
   deprecateToken,
+  detectSystemLocale,
   discoverSkills,
+  distributeGlobalSkills,
   endSession,
   ensureCard,
   ensureMonitorDir,
   evaluateRating,
+  executeReviewAction,
   extractTasks,
   extractTokenRefs,
   fetchActiveWorkItems,
   findTokens,
   generateBashHooks,
   generateBashUnhooks,
+  generateConceptFreeCue,
+  generatePowerShellHooks,
+  generatePowerShellUnhooks,
   generatePrompt,
   generateZshHooks,
   generateZshUnhooks,
+  getADOCredentials,
   getAgentSkill,
   getAllSettings,
   getAllSettingsDetailed,
   getBlockedCards,
   getCard,
+  getCardById,
+  getCardDeletionImpact,
   getDefaultDbPath,
   getDependents,
   getDomainCompetence,
@@ -1902,34 +3295,57 @@ export {
   getMonitorDir,
   getMonitorLogStats,
   getMonitorPath,
+  getPackageSkillPath,
   getPrerequisites,
+  getRepoPaths,
   getReviewsForCard,
   getReviewsForUser,
   getSessionSummary,
   getSetting,
+  getSystemProfile,
   getTokenById,
   getTokenBySlug,
+  getTokenDeleteImpact,
+  getTursoCredentials,
   getUserStats,
+  hasCommand,
+  injectShellHooks,
+  installFastFlowLM,
+  installOllama,
   interleave,
   listAgentSkills,
   listGoals,
   listTokens,
   loadADOConfig,
+  loadCredentials,
   logReview,
   logStep,
+  matchesFilePath,
   monitorLogExists,
+  normalizeLocale,
+  normalizePath,
   openDatabase,
   openDatabaseWithSync,
   pairCommands,
   parseGoalFile,
   parseMonitorLog,
   readMonitorLog,
+  resolveAllBeliefPaths,
+  resolveAllGoalPaths,
+  resolveReference,
+  resolveRepoPath,
+  resolveReviewContext,
+  saveCredentials,
   serializeGoal,
+  setADOCredentials,
   setSetting,
+  setTursoCredentials,
   startSession,
+  t,
   unblockReady,
   updateCard,
   updateGoalStatus,
+  updateToken,
   writeMonitorEvent
 };
 //# sourceMappingURL=index.js.map