privateboard 0.1.13 → 0.1.15

package/dist/cli.js

@@ -510,6 +510,80 @@ var init_room_members_removed_at = __esm({
   }
 });
 
+// src/storage/migrations/034_user_topic_recs.sql
+var user_topic_recs_default;
+var init_user_topic_recs = __esm({
+  "src/storage/migrations/034_user_topic_recs.sql"() {
+    user_topic_recs_default = `-- Interest-driven topic recommendations \xB7 the home composer's
+-- "\u627E\u4F60\u53EF\u80FD\u611F\u5174\u8DA3\u7684\u8BDD\u9898" trigger drops a row in topic_rec_jobs,
+-- the pipeline writes a topic_rec_batches row at start +
+-- N topic_recs rows per recommendation it synthesises. The
+-- composer tray pages topic_recs newest-first; each card can
+-- carry web-search snippets in seed_context_json that get
+-- forwarded into the room's opening message at convene time.
+
+-- One batch per "user clicked the button" event. Lets us
+-- show "generated 3h ago", keep older batches addressable via
+-- pagination, and (later) attribute a room back to its rec.
+CREATE TABLE topic_rec_batches (
+  id            TEXT    PRIMARY KEY,
+  has_web       INTEGER NOT NULL DEFAULT 0,  -- 1 = web-search ran for this batch
+  keywords_json TEXT    NOT NULL,            -- JSON string[] \xB7 the 10 keywords pulled from chair memory
+  created_at    INTEGER NOT NULL
+);
+CREATE INDEX idx_topic_rec_batches_created ON topic_rec_batches(created_at DESC);
+
+-- One row per recommended topic. \`source\` drives the UI badge
+-- (// web vs // memory). \`seed_context_json\` carries the web
+-- snippets that informed this topic so the composer can attach
+-- them to the room's opening message when the user convenes.
+CREATE TABLE topic_recs (
+  id                TEXT    PRIMARY KEY,
+  batch_id          TEXT    NOT NULL REFERENCES topic_rec_batches(id) ON DELETE CASCADE,
+  subject           TEXT    NOT NULL,           -- the suggested room subject
+  rationale         TEXT    NOT NULL,           -- one-line "why this fits you" hint
+  source            TEXT    NOT NULL,           -- 'web' | 'memory'
+  seed_context_json TEXT,                       -- JSON [{ title, url, description }] \xB7 NULL when source=memory
+  created_at        INTEGER NOT NULL,
+  opened_room_id    TEXT    REFERENCES rooms(id) ON DELETE SET NULL
+);
+CREATE INDEX idx_topic_recs_created ON topic_recs(created_at DESC);
+CREATE INDEX idx_topic_recs_batch   ON topic_recs(batch_id);
+
+-- Async job tracker \xB7 1:1 mirror of agent_persona_jobs.
+-- Boot-time recovery flips status='running' \u2192 'failed' so
+-- crashed jobs surface a retry CTA instead of a hung spinner.
+CREATE TABLE topic_rec_jobs (
+  id            TEXT    PRIMARY KEY,
+  status        TEXT    NOT NULL,                -- running | done | failed | aborted
+  current_phase INTEGER NOT NULL DEFAULT 0,
+  progress_pct  INTEGER NOT NULL DEFAULT 0,
+  batch_id      TEXT    REFERENCES topic_rec_batches(id) ON DELETE SET NULL,
+  error         TEXT,
+  started_at    INTEGER NOT NULL,
+  updated_at    INTEGER NOT NULL
+);
+CREATE INDEX idx_topic_rec_jobs_status ON topic_rec_jobs(status);
+`;
+  }
+});
+
+// src/storage/migrations/035_topic_rec_tag.sql
+var topic_rec_tag_default;
+var init_topic_rec_tag = __esm({
+  "src/storage/migrations/035_topic_rec_tag.sql"() {
+    topic_rec_tag_default = `-- Per-topic category tag \xB7 the synthesiser produces a 1-2 word
+-- label per recommendation (e.g. "strategy", "product", "market",
+-- "ops") so the composer card can display a meaningful tag in
+-- the left column instead of the source token (which was always
+-- "web" / "memory" and didn't tell the user what the topic was
+-- about). NULL on rows generated before this migration \xB7 the
+-- frontend falls back to the source token in that case.
+ALTER TABLE topic_recs ADD COLUMN tag TEXT;
+`;
+  }
+});
+
 // src/storage/db.ts
 var db_exports = {};
 __export(db_exports, {
@@ -600,6 +674,8 @@ var init_db = __esm({
     init_agent_persona_spec();
     init_room_vote_trigger();
     init_room_members_removed_at();
+    init_user_topic_recs();
+    init_topic_rec_tag();
     MIGRATIONS = [
       { name: "001_init.sql", sql: init_default },
       { name: "002_default_opus.sql", sql: default_opus_default },
@@ -633,7 +709,9 @@ var init_db = __esm({
       { name: "030_minimax_region.sql", sql: minimax_region_default },
       { name: "031_agent_persona_spec.sql", sql: agent_persona_spec_default },
       { name: "032_room_vote_trigger.sql", sql: room_vote_trigger_default },
-      { name: "033_room_members_removed_at.sql", sql: room_members_removed_at_default }
+      { name: "033_room_members_removed_at.sql", sql: room_members_removed_at_default },
+      { name: "034_user_topic_recs.sql", sql: user_topic_recs_default },
+      { name: "035_topic_rec_tag.sql", sql: topic_rec_tag_default }
     ];
     _db = null;
   }
@@ -1966,7 +2044,7 @@ function runSeed() {
 // src/server.ts
 import { serve } from "@hono/node-server";
 import { serveStatic } from "@hono/node-server/serve-static";
-import { Hono as Hono12 } from "hono";
+import { Hono as Hono13 } from "hono";
 import { existsSync as existsSync2 } from "fs";
 
 // src/routes/agents.ts
@@ -14665,8 +14743,750 @@ function collectProviderSummary(models) {
   return Array.from(map.entries()).map(([provider, v]) => ({ provider, ...v }));
 }
 
-// src/routes/notes.ts
+// src/routes/topic-recs.ts
 import { Hono as Hono6 } from "hono";
+import { streamSSE as streamSSE2 } from "hono/streaming";
+
+// src/orchestrator/topic-recommender.ts
+import { randomUUID as randomUUID2 } from "crypto";
+
+// src/storage/topic-recs.ts
+init_db();
+function createTopicRecBatch(input) {
+  const now = Date.now();
+  getDb().prepare("INSERT INTO topic_rec_batches (id, has_web, keywords_json, created_at) VALUES (?, ?, ?, ?)").run(input.id, input.hasWeb ? 1 : 0, JSON.stringify(input.keywords), now);
+  return { id: input.id, hasWeb: input.hasWeb, keywords: input.keywords, createdAt: now };
+}
+function mapRec(r) {
+  let seedContext = null;
+  if (r.seed_context_json) {
+    try {
+      const parsed = JSON.parse(r.seed_context_json);
+      if (Array.isArray(parsed)) {
+        seedContext = parsed.filter(
+          (s) => s && typeof s.title === "string" && typeof s.url === "string" && typeof s.description === "string"
+        );
+      }
+    } catch {
+    }
+  }
+  return {
+    id: r.id,
+    batchId: r.batch_id,
+    subject: r.subject,
+    rationale: r.rationale,
+    source: r.source === "web" ? "web" : "memory",
+    tag: typeof r.tag === "string" && r.tag.trim().length > 0 ? r.tag.trim() : null,
+    seedContext,
+    createdAt: r.created_at,
+    openedRoomId: r.opened_room_id
+  };
+}
+var REC_COLS = "id, batch_id, subject, rationale, source, tag, seed_context_json, created_at, opened_room_id";
+function insertTopicRec(input) {
+  const now = Date.now();
+  getDb().prepare(
+    `INSERT INTO topic_recs
+         (id, batch_id, subject, rationale, source, tag, seed_context_json, created_at, opened_room_id)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, NULL)`
+  ).run(
+    input.id,
+    input.batchId,
+    input.subject,
+    input.rationale,
+    input.source,
+    input.tag,
+    input.seedContext ? JSON.stringify(input.seedContext) : null,
+    now
+  );
+  return {
+    id: input.id,
+    batchId: input.batchId,
+    subject: input.subject,
+    rationale: input.rationale,
+    source: input.source,
+    tag: input.tag,
+    seedContext: input.seedContext,
+    createdAt: now,
+    openedRoomId: null
+  };
+}
+function getTopicRec(id) {
+  const row = getDb().prepare(`SELECT ${REC_COLS} FROM topic_recs WHERE id = ?`).get(id);
+  return row ? mapRec(row) : null;
+}
+function listTopicRecs(opts) {
+  const limit = Math.max(1, Math.min(100, opts.limit));
+  const stmt = opts.cursor === null ? getDb().prepare(`SELECT ${REC_COLS} FROM topic_recs ORDER BY created_at DESC LIMIT ?`) : getDb().prepare(`SELECT ${REC_COLS} FROM topic_recs WHERE created_at < ? ORDER BY created_at DESC LIMIT ?`);
+  const rows = opts.cursor === null ? stmt.all(limit) : stmt.all(opts.cursor, limit);
+  const items = rows.map(mapRec);
+  const nextCursor = items.length === limit ? items[items.length - 1].createdAt : null;
+  return { items, nextCursor };
+}
+function markTopicRecOpened(recId, roomId) {
+  getDb().prepare("UPDATE topic_recs SET opened_room_id = ? WHERE id = ?").run(roomId, recId);
+}
+function clearAllTopicRecs() {
+  const r = getDb().prepare("DELETE FROM topic_recs").run();
+  return r.changes;
+}
+function mapJob(r) {
+  const status = ["running", "done", "failed", "aborted"].includes(r.status) ? r.status : "failed";
+  return {
+    id: r.id,
+    status,
+    currentPhase: r.current_phase,
+    progressPct: r.progress_pct,
+    batchId: r.batch_id,
+    error: r.error,
+    startedAt: r.started_at,
+    updatedAt: r.updated_at
+  };
+}
+var JOB_COLS = "id, status, current_phase, progress_pct, batch_id, error, started_at, updated_at";
+function createTopicRecJob(id) {
+  const now = Date.now();
+  getDb().prepare(
+    `INSERT INTO topic_rec_jobs (id, status, current_phase, progress_pct, batch_id, error, started_at, updated_at)
+       VALUES (?, 'running', 0, 0, NULL, NULL, ?, ?)`
+  ).run(id, now, now);
+  return getTopicRecJob(id);
+}
+function getTopicRecJob(id) {
+  const row = getDb().prepare(`SELECT ${JOB_COLS} FROM topic_rec_jobs WHERE id = ?`).get(id);
+  return row ? mapJob(row) : null;
+}
+function updateTopicRecJob(id, patch) {
+  const fields = [];
+  const values = [];
+  if (patch.status !== void 0) {
+    fields.push("status = ?");
+    values.push(patch.status);
+  }
+  if (typeof patch.currentPhase === "number") {
+    fields.push("current_phase = ?");
+    values.push(patch.currentPhase);
+  }
+  if (typeof patch.progressPct === "number") {
+    fields.push("progress_pct = ?");
+    values.push(Math.max(0, Math.min(100, Math.round(patch.progressPct))));
+  }
+  if (patch.batchId !== void 0) {
+    fields.push("batch_id = ?");
+    values.push(patch.batchId);
+  }
+  if (patch.error !== void 0) {
+    fields.push("error = ?");
+    values.push(patch.error);
+  }
+  if (fields.length === 0) return getTopicRecJob(id);
+  fields.push("updated_at = ?");
+  values.push(Date.now());
+  values.push(id);
+  getDb().prepare(`UPDATE topic_rec_jobs SET ${fields.join(", ")} WHERE id = ?`).run(...values);
+  return getTopicRecJob(id);
+}
+function markRunningTopicRecJobsFailed() {
+  const r = getDb().prepare(
+    `UPDATE topic_rec_jobs
+          SET status = 'failed',
+              error = COALESCE(error, 'server restarted mid-build'),
+              updated_at = ?
+        WHERE status = 'running'`
+  ).run(Date.now());
+  return r.changes;
+}
+
+// src/orchestrator/topic-stream.ts
+import { EventEmitter as EventEmitter3 } from "events";
+var TopicRecBus = class {
+  emitters = /* @__PURE__ */ new Map();
+  get(jobId) {
+    let e = this.emitters.get(jobId);
+    if (!e) {
+      e = new EventEmitter3();
+      e.setMaxListeners(16);
+      this.emitters.set(jobId, e);
+    }
+    return e;
+  }
+  emit(jobId, event) {
+    this.get(jobId).emit("event", event);
+  }
+  subscribe(jobId, listener) {
+    const e = this.get(jobId);
+    e.on("event", listener);
+    return () => e.off("event", listener);
+  }
+  /** Free the EventEmitter for a job. Call on terminal events
+   *  (`topic-final`, `topic-error`, `topic-aborted`) so the Map
+   *  doesn't grow unbounded across many runs in one process. */
+  drop(jobId) {
+    const e = this.emitters.get(jobId);
+    if (e) {
+      e.removeAllListeners();
+      this.emitters.delete(jobId);
+    }
+  }
+};
+var topicRecBus = new TopicRecBus();
+
+// src/orchestrator/topic-recommender.ts
+var LLM_CALL_TIMEOUT_MS2 = 6e4;
+var PIPELINE_WALL_CLOCK_MS = 12e4;
+var SEARCH_PARALLEL_CHUNK = 3;
+var SEARCH_CHUNK_GAP_MS = 1e3;
+var SEARCH_RESULTS_PER_QUERY = 5;
+var inFlightJobs2 = /* @__PURE__ */ new Map();
+function signalWithTimeout3(parent, timeoutMs) {
+  const controller = new AbortController();
+  const onParentAbort = () => controller.abort();
+  if (parent?.aborted) controller.abort();
+  else parent?.addEventListener("abort", onParentAbort, { once: true });
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  return {
+    signal: controller.signal,
+    cleanup: () => {
+      clearTimeout(timer);
+      parent?.removeEventListener("abort", onParentAbort);
+    }
+  };
+}
+function extractJson5(raw) {
+  const fence = /```(?:json)?\s*([\s\S]*?)```/i.exec(raw);
+  const candidate = fence ? fence[1] : raw;
+  if (!candidate) return null;
+  const start = candidate.indexOf("{");
+  if (start === -1) return null;
+  let depth = 0;
+  let end = -1;
+  for (let i = start; i < candidate.length; i++) {
+    if (candidate[i] === "{") depth++;
+    else if (candidate[i] === "}") {
+      depth--;
+      if (depth === 0) {
+        end = i;
+        break;
+      }
+    }
+  }
+  if (end === -1) return null;
+  try {
+    return JSON.parse(candidate.slice(start, end + 1));
+  } catch {
+    return null;
+  }
+}
+async function callPhaseLLM2(state, modelV, messages, opts) {
+  if (!isModelV(modelV)) return null;
+  const t = signalWithTimeout3(state.controller.signal, LLM_CALL_TIMEOUT_MS2);
+  try {
+    const r = await callLLMWithUsage({
+      modelV,
+      messages,
+      temperature: opts.temperature,
+      maxTokens: opts.maxTokens,
+      signal: t.signal
+    });
+    return r.text;
+  } catch (e) {
+    process.stderr.write(
+      `[topic-recommender] ${modelV} failed: ${e instanceof Error ? e.message : String(e)}
+`
+    );
+    return null;
+  } finally {
+    t.cleanup();
+  }
+}
+function sleepWithSignal2(ms, signal) {
+  return new Promise((resolve2) => {
+    if (signal.aborted) return resolve2();
+    const t = setTimeout(() => {
+      signal.removeEventListener("abort", onAbort);
+      resolve2();
+    }, ms);
+    function onAbort() {
+      clearTimeout(t);
+      resolve2();
+    }
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function startTopicRecommend() {
+  const jobId = randomUUID2();
+  createTopicRecJob(jobId);
+  const state = {
+    id: jobId,
+    startedAt: Date.now(),
+    controller: new AbortController()
+  };
+  inFlightJobs2.set(jobId, state);
+  const wallClock = setTimeout(() => {
+    if (inFlightJobs2.has(jobId)) state.controller.abort();
+  }, PIPELINE_WALL_CLOCK_MS);
+  void runPipeline3(state).finally(() => {
+    clearTimeout(wallClock);
+    inFlightJobs2.delete(jobId);
+  });
+  return jobId;
+}
+function abortTopicRecommend(jobId) {
+  const state = inFlightJobs2.get(jobId);
+  if (!state) return false;
+  try {
+    state.controller.abort();
+  } catch {
+  }
+  return true;
+}
+function isTopicRecJobRunning(jobId) {
+  return inFlightJobs2.has(jobId);
+}
+async function runPipeline3(state) {
+  const phaseLabels = [
+    "Reading your boardroom history",
+    "Distilling interests",
+    "Scanning trending topics",
+    "Synthesising recommendations"
+  ];
+  const emitPhaseStart = (phase) => {
+    topicRecBus.emit(state.id, {
+      type: "topic-phase-start",
+      phase,
+      label: phaseLabels[phase - 1] ?? `Phase ${phase}`
+    });
+  };
+  const emitPhaseProgress = (phase, detail, pct) => {
+    topicRecBus.emit(state.id, {
+      type: "topic-phase-progress",
+      phase,
+      detail,
+      progressPct: Math.max(0, Math.min(100, Math.round(pct)))
+    });
+    updateTopicRecJob(state.id, { currentPhase: phase, progressPct: pct });
+  };
+  const emitPhaseEnd = (phase, pct) => {
+    topicRecBus.emit(state.id, {
+      type: "topic-phase-end",
+      phase,
+      progressPct: Math.max(0, Math.min(100, Math.round(pct)))
+    });
+    updateTopicRecJob(state.id, { currentPhase: phase, progressPct: pct });
+  };
+  const fail = (message) => {
+    updateTopicRecJob(state.id, { status: "failed", error: message });
+    topicRecBus.emit(state.id, { type: "topic-error", message });
+    topicRecBus.drop(state.id);
+  };
+  const cancel = () => {
+    updateTopicRecJob(state.id, { status: "aborted" });
+    topicRecBus.emit(state.id, { type: "topic-aborted" });
+    topicRecBus.drop(state.id);
+  };
+  try {
+    emitPhaseStart(1);
+    const chair = getChairAgent();
+    if (!chair) {
+      fail("chair agent missing \u2014 set up onboarding first");
+      return;
+    }
+    const memories = memoriesForContext(chair.id, 50);
+    emitPhaseProgress(1, `read ${memories.length} memories`, 8);
+    emitPhaseEnd(1, 10);
+    if (state.controller.signal.aborted) {
+      cancel();
+      return;
+    }
+    emitPhaseStart(2);
+    const modelV = utilityModelFor();
+    if (!modelV) {
+      fail("no LLM provider configured \u2014 add an API key first");
+      return;
+    }
+    const keywords = await distilKeywords(state, modelV, memories);
+    if (state.controller.signal.aborted) {
+      cancel();
+      return;
+    }
+    if (keywords.length === 0) {
+      fail("couldn't distil any keywords from the chair's memory yet \u2014 try again after a couple of rooms");
+      return;
+    }
+    emitPhaseProgress(2, `picked ${keywords.length} keywords`, 25);
+    emitPhaseEnd(2, 30);
+    const hasWeb = hasWebSearchKey();
+    let snippetsByKeyword = /* @__PURE__ */ new Map();
+    if (hasWeb) {
+      emitPhaseStart(3);
+      snippetsByKeyword = await runWebSweep(state, keywords, (kw, snippets, idx) => {
+        emitPhaseProgress(
+          3,
+          `scanned "${kw}" (${snippets.length} hits) \xB7 ${idx}/${keywords.length}`,
+          30 + Math.round(idx / keywords.length * 40)
+        );
+        topicRecBus.emit(state.id, {
+          type: "topic-search-round",
+          keyword: kw,
+          query: `${kw} site:x.com`,
+          resultsCount: snippets.length,
+          snippets
+        });
+      });
+      if (state.controller.signal.aborted) {
+        cancel();
+        return;
+      }
+      emitPhaseEnd(3, 70);
+    } else {
+      emitPhaseProgress(3, "no web-search key \u2014 skipping", 70);
+    }
+    emitPhaseStart(4);
+    const batchId = randomUUID2();
+    createTopicRecBatch({ id: batchId, hasWeb, keywords });
+    updateTopicRecJob(state.id, { batchId });
+    const synth = await synthesiseTopics(state, modelV, {
+      memories,
+      keywords,
+      snippetsByKeyword,
+      hasWeb
+    });
+    if (state.controller.signal.aborted) {
+      cancel();
+      return;
+    }
+    if (synth.length === 0) {
+      fail("synthesis returned no topics \u2014 try again or refine your boardroom history first");
+      return;
+    }
+    clearAllTopicRecs();
+    let inserted = 0;
+    for (const t of synth) {
+      const rec = insertTopicRec({
+        id: randomUUID2(),
+        batchId,
+        subject: t.subject,
+        rationale: t.rationale,
+        source: t.source,
+        tag: t.tag,
+        seedContext: t.seedContext
+      });
+      inserted++;
+      topicRecBus.emit(state.id, { type: "topic-rec", rec });
+      emitPhaseProgress(
+        4,
+        `synthesised ${inserted}/${synth.length}`,
+        70 + Math.round(inserted / synth.length * 28)
+      );
+    }
+    emitPhaseEnd(4, 100);
+    updateTopicRecJob(state.id, {
+      status: "done",
+      progressPct: 100,
+      currentPhase: 4
+    });
+    topicRecBus.emit(state.id, {
+      type: "topic-final",
+      batchId,
+      totalRecs: inserted,
+      hasWeb
+    });
+    topicRecBus.drop(state.id);
+  } catch (e) {
+    if (state.controller.signal.aborted) {
+      cancel();
+      return;
+    }
+    const msg = e instanceof Error ? e.message : String(e);
+    process.stderr.write(`[topic-recommender] pipeline crashed: ${msg}
+`);
+    fail(msg);
+  }
+}
+async function distilKeywords(state, modelV, memories) {
+  if (memories.length === 0) return [];
+  const memoryLines = memories.slice(0, 60).map((m, i) => {
+    const tier = m.tier === "long" ? "STABLE" : "fresh";
+    const prov = m.provenanceRooms > 1 ? ` \xB7 \xD7${m.provenanceRooms} rooms` : "";
+    const recency = Math.max(0, Math.round((Date.now() - m.createdAt) / 864e5));
+    return `${i + 1}. [${tier}${prov} \xB7 ${recency}d ago \xB7 ${m.kind}] ${m.content}`;
+  }).join("\n");
+  const system = `You distil a user's interests from a chair's accumulated memory log. Pick the 10 keywords / domains / themes the user is MOST currently engaged with. Weight: recency \xD7 kind salience (goal > preference > observation > fact) \xD7 cross-room provenance. Reject any keyword that wouldn't make a good boardroom subject (too narrow, too transient, too personal-irrelevant). Output strict JSON only: { "keywords": ["...", "...", ...] } with up to 10 entries.`;
+  const user = `# Chair's memory about the user (newest first within each tier)
+${memoryLines}
+
+Return up to 10 keywords as JSON.`;
+  const raw = await callPhaseLLM2(state, modelV, [
+    { role: "system", content: system },
+    { role: "user", content: user }
+  ], { temperature: 0.3, maxTokens: 600 });
+  if (!raw) return [];
+  const parsed = extractJson5(raw);
+  if (!parsed || !Array.isArray(parsed.keywords)) return [];
+  return parsed.keywords.filter((k) => typeof k === "string").map((k) => k.trim()).filter((k) => k.length > 0).slice(0, 10);
+}
+async function runWebSweep(state, keywords, onKeywordDone) {
+  const out = /* @__PURE__ */ new Map();
+  const creds = getActiveWebSearchCredentials();
+  if (!creds) return out;
+  let doneCount = 0;
+  for (let i = 0; i < keywords.length; i += SEARCH_PARALLEL_CHUNK) {
+    if (state.controller.signal.aborted) break;
+    const chunk = keywords.slice(i, i + SEARCH_PARALLEL_CHUNK);
+    const settled = await Promise.allSettled(
+      chunk.map((kw) => fetchKeywordSnippets(creds.backend, creds.apiKey, kw))
+    );
+    settled.forEach((res, j) => {
+      const kw = chunk[j];
+      const snippets = res.status === "fulfilled" ? res.value : [];
+      out.set(kw, snippets);
+      doneCount++;
+      onKeywordDone(kw, snippets, doneCount);
+    });
+    if (i + SEARCH_PARALLEL_CHUNK < keywords.length) {
+      await sleepWithSignal2(SEARCH_CHUNK_GAP_MS, state.controller.signal);
+    }
+  }
+  return out;
+}
+async function fetchKeywordSnippets(backend, apiKey, keyword) {
+  const xQuery = `${keyword} site:x.com`;
+  const xResults = await runWebSearch(backend, apiKey, xQuery, {
+    count: SEARCH_RESULTS_PER_QUERY
+  });
+  if (xResults && xResults.length > 0) {
+    return xResults.map(toSnippet);
+  }
+  const generic = await runWebSearch(backend, apiKey, keyword, {
+    count: SEARCH_RESULTS_PER_QUERY
+  });
+  return (generic ?? []).map(toSnippet);
+}
+function toSnippet(r) {
+  return {
+    title: r.title || "(untitled)",
+    url: r.url,
+    description: r.description || ""
+  };
+}
+async function synthesiseTopics(state, modelV, opts) {
+  const { memories, keywords, snippetsByKeyword, hasWeb } = opts;
+  const flatSnippets = [];
+  if (hasWeb) {
+    for (const kw of keywords) {
+      for (const s of snippetsByKeyword.get(kw) ?? []) {
+        flatSnippets.push({ ...s, keyword: kw });
+      }
+    }
+  }
+  const memorySummary = memories.length === 0 ? "(no chair memory yet \u2014 recommend topics that introduce the user to the boardroom format)" : memories.slice(0, 24).map((m, i) => `M${i + 1}. [${m.kind}] ${m.content}`).join("\n");
+  const snippetBlock = flatSnippets.length === 0 ? "(no web snippets \u2014 synthesise from memory only)" : flatSnippets.map(
+    (s, i) => `S${i + 1}. [keyword: ${s.keyword}] ${s.title}
+   ${s.description}
+   ${s.url}`
+  ).join("\n\n");
+  const system = 'You recommend boardroom discussion topics to a user, based on (a) the chair\'s long-term memory of who they are + what they care about, and optionally (b) a set of currently-trending web/x.com snippets keyed off the user\'s recent interests. Produce EXACTLY 6 distinct topics \u2014 not 5, not 7, six. Each topic is a subject line a user could plausibly drop into the convene composer.\n\nThe 6 topics MUST span DIFFERENT dimensions/categories \u2014 don\'t return six pricing topics. Use the 10 keywords as a multi-dimensional search index; the 6 final topics should distil ACROSS those dimensions so the picker reads as a balanced board agenda, not a single-angle obsession. Each topic gets a different `tag`.\n\nVoice: tight, specific, opinionated. Avoid corporate-speak. Skew toward questions the user would actually want to debate, not generic explainers.\n\nEVERY topic MUST include a `tag` field \xB7 a SHORT CATEGORY in 1-2 lowercase words naming what bucket the topic falls into. Pick from the user\'s actual subject matter (examples: strategy / product / market / pricing / positioning / brand / hiring / fundraising / ops / infra / research / craft / ethics / personal / leadership / growth / sales / design / data / partnerships / regulation). FORBIDDEN tag values: "web", "memory", "general", "misc", "other", "topic", "recommendation" \u2014 these are meta-vocabulary that leaks the system, not real categories. If the topic spans two areas, pick the dominant one. NEVER omit the tag field.\n\nEach topic must cite either (a) at least one snippet ref (S<n>) \u2014 in which case set "source":"web" \u2014 OR (b) no snippet refs at all \u2014 in which case set "source":"memory". The `source` and `tag` fields are independent: `source` is the data provenance, `tag` is the topic category. Never use "web" or "memory" as a tag.\n\nStrict JSON output only:\n{ "topics": [ { "tag": "pricing", "subject": "...", "rationale": "one sentence on why this fits the user", "source": "web|memory", "snippetRefs": [<S indexes, omit when source=memory>] } ] }';
+  const user = `# Keywords distilled from chair memory
+${keywords.map((k, i) => `K${i + 1}. ${k}`).join("\n")}
+
+# Memory excerpts
+${memorySummary}
+
+# Web snippets ${hasWeb ? "(use these to ground at least some recs as source=web)" : "(none \u2014 synthesise from memory only)"}
+${snippetBlock}
+
+Return EXACTLY 6 topics as JSON, each with a different tag, spanning different dimensions.`;
+  const raw = await callPhaseLLM2(state, modelV, [
+    { role: "system", content: system },
+    { role: "user", content: user }
+  ], { temperature: 0.6, maxTokens: 2e3 });
+  if (!raw) return [];
+  const parsed = extractJson5(raw);
+  if (!parsed || !Array.isArray(parsed.topics)) return [];
+  const out = [];
+  for (const t of parsed.topics) {
+    const subject = typeof t.subject === "string" ? t.subject.trim() : "";
+    const rationale = typeof t.rationale === "string" ? t.rationale.trim() : "";
+    if (!subject || !rationale) continue;
+    let tag = null;
+    const TAG_BLOCKLIST = /* @__PURE__ */ new Set([
+      "web",
+      "memory",
+      "general",
+      "misc",
+      "other",
+      "topic",
+      "recommendation",
+      "recommendations",
+      "rec",
+      "category",
+      "n/a",
+      "na",
+      "none"
+    ]);
+    if (typeof t.tag === "string") {
+      const cleaned = t.tag.trim().replace(/^\/\/\s*/, "").toLowerCase().replace(/[^a-z0-9 -]/g, "").replace(/\s+/g, " ").trim().slice(0, 28);
+      if (cleaned.length > 0 && !TAG_BLOCKLIST.has(cleaned)) {
+        tag = cleaned;
+      }
+    }
+    if (!tag) {
+      const words = subject.toLowerCase().replace(/[^a-z0-9\s-]/g, " ").split(/\s+/).filter((w) => w.length > 2 && !["the", "and", "for", "are", "you", "your", "what", "how", "why", "when", "with", "from", "this", "that"].includes(w));
+      if (words.length > 0) {
+        tag = words.slice(0, 2).join(" ").slice(0, 28);
+      } else {
+        tag = "topic";
+      }
+    }
+    let source = t.source === "web" ? "web" : "memory";
+    let seedContext = null;
+    if (source === "web" && hasWeb && Array.isArray(t.snippetRefs)) {
+      const refs = t.snippetRefs.map((r) => {
+        if (typeof r === "number") return r;
+        if (typeof r === "string") {
+          const m = r.match(/^S?(\d+)$/i);
+          return m ? Number(m[1]) : NaN;
+        }
+        return NaN;
+      }).filter((n) => Number.isInteger(n) && n > 0 && n <= flatSnippets.length);
+      const seen = /* @__PURE__ */ new Set();
+      const cited = [];
+      for (const ref of refs) {
+        const snip = flatSnippets[ref - 1];
+        if (!snip || seen.has(snip.url)) continue;
+        seen.add(snip.url);
+        cited.push({ title: snip.title, url: snip.url, description: snip.description });
+      }
+      if (cited.length > 0) {
+        seedContext = cited;
+      } else {
+        source = "memory";
+      }
+    } else if (source === "web") {
+      source = "memory";
+    }
+    out.push({ subject, rationale, source, tag, seedContext });
+    if (out.length >= 6) break;
+  }
+  return out;
+}
+
+// src/routes/topic-recs.ts
+function topicRecsRouter() {
+  const r = new Hono6();
+  r.post("/", (c) => {
+    if (!hasAnyModelKey()) {
+      return c.json({ error: "configure an LLM provider key first" }, 400);
+    }
+    const jobId = startTopicRecommend();
+    return c.json({ jobId });
+  });
+  r.get("/jobs/:id/stream", (c) => {
+    const jobId = c.req.param("id");
+    const job = getTopicRecJob(jobId);
+    if (!job) return c.json({ error: "job not found" }, 404);
+    return streamSSE2(c, async (s) => {
+      await s.writeSSE({
+        event: "hello",
+        data: JSON.stringify({
+          jobId,
+          status: job.status,
+          currentPhase: job.currentPhase,
+          progressPct: job.progressPct,
+          batchId: job.batchId,
+          error: job.error
+        })
+      });
+      if (!isTopicRecJobRunning(jobId)) {
+        if (job.status === "done") {
+          await s.writeSSE({
+            event: "topic-final",
+            data: JSON.stringify({
+              type: "topic-final",
+              batchId: job.batchId,
+              totalRecs: null,
+              hasWeb: null
+            })
+          });
+        } else if (job.status === "aborted") {
+          await s.writeSSE({
+            event: "topic-aborted",
+            data: JSON.stringify({ type: "topic-aborted" })
+          });
+        } else if (job.status === "failed") {
+          await s.writeSSE({
+            event: "topic-error",
+            data: JSON.stringify({
+              type: "topic-error",
+              message: job.error || "generation failed"
+            })
+          });
+        }
+        return;
+      }
+      const queue = [];
+      let resolveWaiter = null;
+      let closed = false;
+      const off = topicRecBus.subscribe(jobId, (event) => {
+        queue.push(event);
+        if (resolveWaiter) {
+          resolveWaiter();
+          resolveWaiter = null;
+        }
+      });
+      s.onAbort(() => {
+        closed = true;
+        off();
+        if (resolveWaiter) {
+          resolveWaiter();
+          resolveWaiter = null;
+        }
+      });
+      while (!closed) {
+        if (queue.length === 0) {
+          await new Promise((resolve2) => {
+            resolveWaiter = resolve2;
+          });
+          continue;
+        }
+        const event = queue.shift();
+        await s.writeSSE({ event: event.type, data: JSON.stringify(event) });
+        if (event.type === "topic-final" || event.type === "topic-error" || event.type === "topic-aborted") {
+          closed = true;
+          off();
+        }
+      }
+    });
+  });
+  r.post("/jobs/:id/abort", (c) => {
+    const jobId = c.req.param("id");
+    const ok = abortTopicRecommend(jobId);
+    if (!ok) {
+      const job = getTopicRecJob(jobId);
+      if (!job) return c.json({ error: "job not found" }, 404);
+      return c.json({ ok: true, status: job.status });
+    }
+    return c.json({ ok: true });
+  });
+  r.get("/", (c) => {
+    const cursorRaw = c.req.query("cursor");
+    const limitRaw = c.req.query("limit");
+    const cursor = cursorRaw && /^\d+$/.test(cursorRaw) ? Number(cursorRaw) : null;
+    const limit = limitRaw && /^\d+$/.test(limitRaw) ? Math.max(1, Math.min(100, Number(limitRaw))) : 20;
+    const { items, nextCursor } = listTopicRecs({ cursor, limit });
+    return c.json({ items, nextCursor });
+  });
+  r.get("/:id", (c) => {
+    const id = c.req.param("id");
+    const rec = getTopicRec(id);
+    if (!rec) return c.json({ error: "not found" }, 404);
+    return c.json(rec);
+  });
+  return r;
+}
+
+// src/routes/notes.ts
+import { Hono as Hono7 } from "hono";
 
 // src/storage/notes.ts
 init_db();
@@ -14766,7 +15586,7 @@ function listAllNotesWithRoom() {
 
 // src/routes/notes.ts
 function notesRouter() {
-  const r = new Hono6();
+  const r = new Hono7();
   r.get("/", (c) => {
     const notes = listAllNotesWithRoom();
     return c.json({ notes, total: notes.length });
@@ -14838,9 +15658,9 @@ function deriveAuthorName(kind, authorId) {
 }
 
 // src/routes/prefs.ts
-import { Hono as Hono7 } from "hono";
+import { Hono as Hono8 } from "hono";
 function prefsRouter() {
-  const r = new Hono7();
+  const r = new Hono8();
   r.get("/", (c) => c.json(getPrefs()));
   r.put("/", async (c) => {
     let body;
@@ -14875,8 +15695,8 @@ function prefsRouter() {
 }
 
 // src/routes/rooms.ts
-import { Hono as Hono8 } from "hono";
-import { streamSSE as streamSSE2 } from "hono/streaming";
+import { Hono as Hono9 } from "hono";
+import { streamSSE as streamSSE3 } from "hono/streaming";
 
 // src/storage/key_points.ts
 init_db();
@@ -14981,7 +15801,7 @@ Does the chair need to ask a clarifying question before opening the room?`
     }
     return { shouldAsk: true, rationale: "" };
   }
-  const parsed = extractJson5(raw);
+  const parsed = extractJson6(raw);
   if (!parsed || typeof parsed !== "object") {
     return { shouldAsk: true, rationale: "" };
   }
@@ -15073,7 +15893,7 @@ async function pickRoundWrap(opts) {
     }
     return { recommendation: "continue", rationale: "" };
   }
-  const parsed = extractJson5(raw);
+  const parsed = extractJson6(raw);
   if (!parsed || typeof parsed !== "object") {
     return { recommendation: "continue", rationale: "" };
   }
@@ -15198,7 +16018,7 @@ async function pickNextSpeaker(opts) {
     }
     return { agentId: null, rationale: "", intervention: null };
   }
-  const parsed = extractJson5(raw);
+  const parsed = extractJson6(raw);
   if (!parsed || typeof parsed !== "object") {
     return { agentId: null, rationale: "", intervention: null };
   }
@@ -15310,7 +16130,7 @@ async function pickChairWebSearch(opts) {
     }
     return null;
   }
-  const parsed = extractJson5(raw);
+  const parsed = extractJson6(raw);
   if (!parsed || typeof parsed !== "object") return null;
   const ws = parsed;
   if (typeof ws.query !== "string") return null;
@@ -15335,7 +16155,7 @@ function buildSkillsIndex(skills) {
 function loadSkillBody(skill) {
   return skill.bodyMd;
 }
-function extractJson5(text) {
+function extractJson6(text) {
   if (!text) return null;
   let s = text.trim();
   s = s.replace(/^```(?:json)?\s*/i, "").replace(/```\s*$/i, "").trim();
@@ -15449,7 +16269,7 @@ Which skills apply, and does this turn need web search?`
       continue;
     }
   }
-  const parsed = extractJson5(raw);
+  const parsed = extractJson6(raw);
   if (!parsed || typeof parsed !== "object") {
     return { used: [], reason: "", webSearchQuery: null };
   }
@@ -16267,8 +17087,10 @@ function buildChairClarifyMessages(opts) {
     ``,
     `Output: either <ack + blank line + READY> OR the 2-part question block (in the user's language).`
   ].join("\n");
+  const seedSystem = buildSeedContextSystem(opts.history);
   return [
     buildChairSystem(opts, isFirstTurn ? firstTurnTask : followUpTask),
+    ...seedSystem ? [seedSystem] : [],
     ...renderHistoryForChair(opts.history, opts.cast, opts.prefs),
     {
       role: "user",
@@ -16276,6 +17098,39 @@ function buildChairClarifyMessages(opts) {
     }
   ];
 }
+function buildSeedContextSystem(history) {
+  for (let i = 0; i < history.length; i++) {
+    const m = history[i];
+    if (m.authorKind !== "user") continue;
+    const meta = m.meta;
+    const rationale = typeof meta?.seedContext?.rationale === "string" ? meta.seedContext.rationale.trim() : "";
+    const rawSnippets = meta?.seedContext?.snippets;
+    const snippets = Array.isArray(rawSnippets) ? rawSnippets : [];
+    const snippetLines = [];
+    for (const s of snippets) {
+      if (!s || typeof s !== "object") continue;
+      const title = typeof s.title === "string" ? s.title.trim() : "";
+      const url = typeof s.url === "string" ? s.url.trim() : "";
+      const desc = typeof s.description === "string" ? s.description.trim() : "";
+      if (!title && !url && !desc) continue;
+      snippetLines.push(`\xB7 ${title || "(untitled)"} \u2014 ${url || "(no url)"}
+  ${desc.slice(0, 360)}`);
+    }
+    if (!rationale && snippetLines.length === 0) continue;
+    const blocks = [
+      `\u2500\u2500\u2500 BACKGROUND MATERIAL \xB7 pre-attached by the user \u2500\u2500\u2500`,
+      `The user opened this room from a topic recommendation. Treat the material below as hidden context they've already seen \u2014 reference it naturally when useful, don't re-summarise it, don't pretend it doesn't exist.`
+    ];
+    if (rationale) {
+      blocks.push(``, `Why this topic was recommended (hidden from the user \u2014 your reasoning context):`, `\xB7 ${rationale}`);
+    }
+    if (snippetLines.length > 0) {
+      blocks.push(``, `Source snippets the recommendation was grounded in:`, ...snippetLines);
+    }
+    return { role: "system", content: blocks.join("\n") };
+  }
+  return null;
+}
 function buildChairConveningMessages(opts) {
   const subject = opts.room.subject;
   const directorList = opts.picksWithReasons.map((p, i) => {
@@ -19732,7 +20587,7 @@ async function runAutoPickAndSeat(roomId, subject) {
   }
 }
 function roomsRouter() {
-  const r = new Hono8();
+  const r = new Hono9();
   r.get("/", (c) => c.json({ rooms: listRooms() }));
   r.post("/", async (c) => {
     let body;
@@ -19827,12 +20682,42 @@ function roomsRouter() {
       payload: { mode, intensity, briefStyle, deliveryMode, members: members.map((m) => m.agentId), autoPick },
       actorKind: "user"
     });
+    let seedContext = null;
+    if (b.seedContext && typeof b.seedContext === "object") {
+      const raw = b.seedContext;
+      const topicRecId = typeof raw.topicRecId === "string" && raw.topicRecId.trim().length > 0 ? raw.topicRecId.trim().slice(0, 64) : void 0;
+      const rationale = typeof raw.rationale === "string" && raw.rationale.trim().length > 0 ? raw.rationale.trim().slice(0, 400) : void 0;
+      const rawSnippets = Array.isArray(raw.snippets) ? raw.snippets : [];
+      const snippets = rawSnippets.filter(
+        (s) => !!s && typeof s === "object" && typeof s.title === "string" && typeof s.url === "string" && typeof s.description === "string"
+      ).slice(0, 12).map((s) => ({
+        title: s.title.slice(0, 200),
+        url: s.url.slice(0, 600),
+        description: s.description.slice(0, 600)
+      }));
+      if (topicRecId || rationale || snippets.length > 0) {
+        seedContext = {
+          ...topicRecId ? { topicRecId } : {},
+          ...rationale ? { rationale } : {},
+          ...snippets.length > 0 ? { snippets } : {}
+        };
+      }
+    }
     const opening = insertMessage({
       roomId: room.id,
       authorKind: "user",
       body: subject,
-      roundNum: 1
+      roundNum: 1,
+      meta: seedContext ? { seedContext } : void 0
     });
+    if (seedContext?.topicRecId) {
+      try {
+        markTopicRecOpened(seedContext.topicRecId, room.id);
+      } catch (e) {
+        process.stderr.write(`[rooms] topic-rec link failed: ${e instanceof Error ? e.message : String(e)}
+`);
+      }
+    }
     roomBus.emit(room.id, {
       type: "message-appended",
       messageId: opening.id,
@@ -19964,7 +20849,7 @@ function roomsRouter() {
   r.get("/:id/stream", (c) => {
     const id = c.req.param("id");
     if (!getRoom(id)) return c.json({ error: "not found" }, 404);
-    return streamSSE2(c, async (s) => {
+    return streamSSE3(c, async (s) => {
       await s.writeSSE({ event: "hello", data: JSON.stringify({ roomId: id, ts: Date.now() }) });
       const queue = [];
       let resolveWaiter = null;
@@ -20628,9 +21513,9 @@ function buildRoomExportMarkdown(opts) {
 }
 
 // src/routes/search.ts
-import { Hono as Hono9 } from "hono";
+import { Hono as Hono10 } from "hono";
 function searchRouter() {
-  const r = new Hono9();
+  const r = new Hono10();
   r.get("/", (c) => {
     const q = (c.req.query("q") || "").trim();
     if (q.length < 1) {
@@ -20669,7 +21554,7 @@ function searchRouter() {
 }
 
 // src/routes/usage.ts
-import { Hono as Hono10 } from "hono";
+import { Hono as Hono11 } from "hono";
 function modelDisplay(modelV) {
   if (isModelV(modelV)) {
     const m = MODELS[modelV];
@@ -20678,7 +21563,7 @@ function modelDisplay(modelV) {
   return { displayName: modelV, provider: "unknown" };
 }
 function usageRouter() {
-  const r = new Hono10();
+  const r = new Hono11();
   r.get("/summary", (c) => {
     const s = getUsageSummary();
     return c.json({
@@ -20728,7 +21613,7 @@ function usageRouter() {
 }
 
 // src/routes/voices.ts
-import { Hono as Hono11 } from "hono";
+import { Hono as Hono12 } from "hono";
 var TTS_CACHE_MAX = 50;
 var ttsCache = /* @__PURE__ */ new Map();
 function ttsCacheKey(messageId, profile) {
@@ -20758,7 +21643,7 @@ function ttsCacheSet(key, val) {
   }
 }
 function voicesRouter() {
-  const r = new Hono11();
+  const r = new Hono12();
   r.get("/", async (c) => c.json({ voices: await listAvailableVoices() }));
   r.post("/preview", async (c) => {
     let body;
@@ -20854,11 +21739,11 @@ function voicesRouter() {
 init_paths();
 
 // src/version.ts
-var VERSION = "0.1.13";
+var VERSION = "0.1.15";
 
 // src/server.ts
 function createApp() {
-  const app = new Hono12();
+  const app = new Hono13();
   const dir = publicDir();
   if (!existsSync2(dir)) {
     throw new Error(
@@ -20898,6 +21783,7 @@ Build the package or check that public/ is bundled alongside dist/.`
   app.route("/api/agents", agentsRouter());
   app.route("/api/keys", keysRouter());
   app.route("/api/models", modelsRouter());
+  app.route("/api/topic-recs", topicRecsRouter());
   app.route("/api/rooms", roomsRouter());
   app.route("/api/briefs", briefsRouter());
   app.route("/api/notes", notesRouter());
@@ -20997,6 +21883,16 @@ async function main() {
     }
   } catch (e) {
     process.stderr.write(`[boot] persona-job recovery failed: ${e instanceof Error ? e.message : String(e)}
+`);
+  }
+  try {
+    const failed = markRunningTopicRecJobsFailed();
+    if (failed > 0) {
+      process.stderr.write(`[boot] marked ${failed} topic-rec job(s) failed (server restarted mid-build)
+`);
+    }
+  } catch (e) {
+    process.stderr.write(`[boot] topic-rec recovery failed: ${e instanceof Error ? e.message : String(e)}
 `);
   }
   void (async () => {