claude-nb 0.4.0 → 0.5.1

package/lib/monitor.py

@@ -75,6 +75,7 @@ class KqueueWatcher:
             path = os.path.join(self.watch_dir, f)
             if path in self.file_fds:
                 continue
+            fd = -1
             try:
                 fd = os.open(path, os.O_RDONLY)
                 ev = select.kevent(
@@ -86,7 +87,8 @@ class KqueueWatcher:
                 self.kq.control([ev], 0)
                 self.file_fds[path] = fd
             except OSError:
-                pass
+                if fd >= 0:
+                    os.close(fd)
 
     def poll(self, timeout: float = 5.0) -> set:
         """Block up to *timeout* seconds, return set of changed file paths."""
@@ -144,11 +146,13 @@ class InotifyWatcher:
         import selectors
 
         sel = selectors.DefaultSelector()
-        sel.register(self.proc.stdout, selectors.EVENT_READ)
+        stdout = self.proc.stdout
+        assert stdout is not None
+        sel.register(stdout, selectors.EVENT_READ)
         changed = set()
         events = sel.select(timeout=timeout)
         for key, _ in events:
-            line = key.fileobj.readline().strip()
+            line = key.fileobj.readline().strip()  # type: ignore[union-attr]
             if line:
                 changed.add(line)
         sel.close()
@@ -349,7 +353,7 @@ def main() -> None:
         print("  --benchmark  Compare event vs polling")
     else:
         print(f"Unknown: {arg}", file=sys.stderr)
-        sys.exit(1)
+        raise SystemExit(1)
 
 
 if __name__ == "__main__":

package/lib/notification_config.py

@@ -0,0 +1,101 @@
+"""notification_config — parse .claudes/notifications.toml for push subscriptions."""
+
+from __future__ import annotations
+
+import tomllib
+from dataclasses import dataclass, field
+from pathlib import Path
+
+NOTIFICATION_TYPES = ("daily-digest", "ci-alert", "mention", "issue-activity", "weekly-report")
+CHANNELS = ("board-inbox", "lark-im", "lark-mail", "gmail")
+
+BUILTIN_DEFAULTS: dict[str, bool] = {
+    "daily-digest": True,
+    "ci-alert": True,
+    "mention": True,
+    "issue-activity": False,
+    "weekly-report": False,
+}
+
+
+@dataclass
+class HumanRecipient:
+    name: str
+    email: str
+    subscriptions: dict[str, bool] = field(default_factory=dict)
+
+
+@dataclass
+class NotificationConfig:
+    defaults: dict[str, bool] = field(default_factory=dict)
+    human_channel: str = "lark-im"
+    teammate_channel: str = "board-inbox"
+    overrides: dict[str, dict[str, bool]] = field(default_factory=dict)
+    human: HumanRecipient | None = None
+
+    def is_subscribed(self, member: str, notif_type: str) -> bool:
+        if notif_type not in NOTIFICATION_TYPES:
+            return False
+        if member in self.overrides and notif_type in self.overrides[member]:
+            return self.overrides[member][notif_type]
+        return self.defaults.get(notif_type, BUILTIN_DEFAULTS.get(notif_type, False))
+
+    def channel_for(self, member: str) -> str:
+        if self.human and member == "human":
+            return self.human_channel
+        return self.teammate_channel
+
+    def subscribers_for(self, notif_type: str, members: list[str]) -> list[str]:
+        return [m for m in members if self.is_subscribed(m, notif_type)]
+
+
+def load(config_path: Path) -> NotificationConfig:
+    if not config_path.exists():
+        return NotificationConfig(defaults=dict(BUILTIN_DEFAULTS))
+
+    with open(config_path, "rb") as f:
+        data = tomllib.load(f)
+
+    defaults = dict(BUILTIN_DEFAULTS)
+    if "defaults" in data:
+        for k, v in data["defaults"].items():
+            if k in NOTIFICATION_TYPES and isinstance(v, bool):
+                defaults[k] = v
+
+    channel_cfg = data.get("channel", {})
+    human_channel = channel_cfg.get("human", "lark-im")
+    teammate_channel = channel_cfg.get("teammate", "board-inbox")
+
+    if human_channel not in CHANNELS:
+        human_channel = "lark-im"
+    if teammate_channel not in CHANNELS:
+        teammate_channel = "board-inbox"
+
+    overrides: dict[str, dict[str, bool]] = {}
+    for member, prefs in data.get("override", {}).items():
+        member_lower = member.lower()
+        overrides[member_lower] = {}
+        for k, v in prefs.items():
+            if k in NOTIFICATION_TYPES and isinstance(v, bool):
+                overrides[member_lower][k] = v
+
+    human = None
+    if "human" in data:
+        h = data["human"]
+        human_subs = {}
+        for k in NOTIFICATION_TYPES:
+            if k in h and isinstance(h[k], bool):
+                human_subs[k] = h[k]
+        human = HumanRecipient(
+            name=h.get("name", ""),
+            email=h.get("email", ""),
+            subscriptions=human_subs,
+        )
+
+    return NotificationConfig(
+        defaults=defaults,
+        human_channel=human_channel,
+        teammate_channel=teammate_channel,
+        overrides=overrides,
+        human=human,
+    )

package/lib/swarm.py

@@ -1,15 +1,17 @@
 """swarm — launch and manage multi-agent sessions."""
 
 import os
-import re
 import threading
+import time
+import tomllib
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
 
 from lib.board_db import BoardDB
-from lib.common import ClaudesEnv, is_suspended
+from lib.common import ClaudesEnv, _write_config_toml, is_suspended
 from lib.swarm_backend import SessionBackend, TmuxBackend, detect_backend
+from lib.theme_profiles import PROFILES
 
 
 @dataclass
@@ -29,6 +31,13 @@ class SwarmConfig:
         return cls(env=env, agent=agent, backend=backend, install_home=install_home)
 
 
+def _lookup_profile(name: str) -> dict[str, str] | None:
+    for theme_profiles in PROFILES.values():
+        if name in theme_profiles:
+            return theme_profiles[name]
+    return None
+
+
 class SwarmManager:
     def __init__(self, cfg: SwarmConfig) -> None:
         self.cfg = cfg
@@ -43,8 +52,13 @@ class SwarmManager:
 
     def build_system_prompt(self, name: str) -> str:
         board = self._board_path()
+        profile = _lookup_profile(name)
+        identity = f"你是 {name}"
+        if profile:
+            identity += f"（{profile['full_name']} — {profile['info']}）"
+        identity += "，cnb 团队的一员。你在后台工作，通过消息板与组长和同学协作。\n"
         return (
-            f"你是 {name}，cnb 团队的一员。你在后台工作，通过消息板与组长和同学协作。\n"
+            f"{identity}"
             f"协作命令：\n"
             f"  {board} --as {name} inbox          # 查看收件箱\n"
             f"  {board} --as {name} ack            # 清空收件箱\n"
@@ -113,15 +127,17 @@ class SwarmManager:
 
         config_path = self._env.claudes_dir / "config.toml"
         if config_path.exists():
-            text = config_path.read_text()
+            data = tomllib.loads(config_path.read_text())
+            current_sessions = list(data.get("sessions", []))
             changed = False
             for n in names:
-                if f'"{n}"' not in text:
-                    text = text.replace("sessions = [", f'sessions = ["{n}", ', 1)
-                    text += f'\n[session.{n}]\npersona = ""\n'
+                if n not in current_sessions:
+                    current_sessions.append(n)
+                    data.setdefault("session", {})[n] = {"persona": ""}
                     changed = True
             if changed:
-                config_path.write_text(text)
+                data["sessions"] = current_sessions
+                _write_config_toml(config_path, data)
         self._env.sessions.extend([n for n in names if n not in self._env.sessions])
 
     # --- Attendance ---
@@ -174,24 +190,15 @@ class SwarmManager:
     # --- Role filtering ---
 
     def get_role(self, name: str) -> str:
-        roster = self._env.claudes_dir / "ROSTER.md"
-        if not roster.exists():
+        config_path = self._env.claudes_dir / "config.toml"
+        if not config_path.exists():
             return "unknown"
         try:
-            text = roster.read_text()
-        except OSError:
+            data = tomllib.loads(config_path.read_text())
+        except (OSError, tomllib.TOMLDecodeError):
             return "unknown"
-        for line in text.splitlines():
-            if re.search(rf"\| \*\*{re.escape(name)}\*\*", line, re.IGNORECASE):
-                lower = line.lower()
-                if "实习生" in lower:
-                    return "intern"
-                if "调度员" in lower:
-                    return "dispatcher"
-                if "lead" in lower:
-                    return "lead"
-                return "dev"
-        return "unknown"
+        role = data.get("session", {}).get(name, {}).get("role", "")
+        return role if role else "unknown"
 
     def filter_sessions(self, *, role: str = "", exclude: str = "") -> list[str]:
         result: list[str] = []
@@ -211,8 +218,11 @@ class SwarmManager:
         backend = self.cfg.backend
 
         if backend.is_running(prefix, name):
-            print(f"  {name}: already running")
-            return
+            if backend.is_agent_active(prefix, name):
+                print(f"  {name}: already running")
+                return
+            backend.stop_session(prefix, name, "true")
+            time.sleep(1)
 
         self.log_startup(name)
         agent_cmd = self.build_agent_cmd(name)
@@ -279,7 +289,7 @@ class SwarmManager:
 
         print()
         backend_name = type(self.cfg.backend).__name__.lower().replace("backend", "")
-        print(f"Mode: {backend_name} | Agent: {self.cfg.agent} | Started: {started}")
+        print(f"Mode: {backend_name} | Engine: {self.cfg.agent} | Started: {started}")
         print(f"Logs: {self._env.log_dir}")
         if isinstance(self.cfg.backend, TmuxBackend):
             print(f"  tmux attach -t {self._env.prefix}-<name>   # attach (Ctrl-B D to detach)")
@@ -289,15 +299,17 @@ class SwarmManager:
 
     def status(self) -> None:
         backend_name = type(self.cfg.backend).__name__.lower().replace("backend", "")
-        print(f"=== Swarm Status (mode: {backend_name}, agent: {self.cfg.agent}) ===")
+        print(f"=== 同学状态 (mode: {backend_name}, engine: {self.cfg.agent}) ===")
         prefix = self._env.prefix
         sf = self._env.suspended_file
         for name in self._env.sessions:
             if is_suspended(name, sf):
                 print(f"  {name}: SUSPENDED")
-            elif self.cfg.backend.is_running(prefix, name):
+            elif self.cfg.backend.is_agent_active(prefix, name):
                 line = self.cfg.backend.status_line(prefix, name, self.cfg.agent)
                 print(f"  {name}: {line}")
+            elif self.cfg.backend.is_running(prefix, name):
+                print(f"  {name}: stale (session exists, 同学已退出)")
             else:
                 print(f"  {name}: stopped")
 
@@ -367,8 +379,6 @@ class SwarmManager:
                 continue
             if self.cfg.backend.is_running(prefix, name):
                 self.cfg.backend.stop_session(prefix, name, self._save_cmd(name))
-                import time
-
                 time.sleep(1)
             self._start_one(name)
             print(f"  {name}: restarted")
@@ -410,8 +420,6 @@ class SwarmManager:
                 lines = [l for l in sf.read_text().splitlines() if l != name]
                 sf.write_text("\n".join(lines) + "\n" if lines else "")
             self._start_one(name)
-            import time
-
             time.sleep(1)
             if self.cfg.backend.is_running(prefix, name):
                 self.clock_in(name)
@@ -428,10 +436,10 @@ class SwarmManager:
     def help(self) -> None:
         backend_name = type(self.cfg.backend).__name__.lower().replace("backend", "")
         print(f"""\
-swarm — manage multi-agent session swarm
+swarm — 管理同学协作会话
 
 Mode: {backend_name} (override with SWARM_MODE=tmux|screen)
-Agent: {self.cfg.agent} (override with SWARM_AGENT=claude|trae|qwen)
+Engine: {self.cfg.agent} (override with SWARM_AGENT=claude|trae|qwen)
 
   start [names...]    Launch sessions (default: all non-suspended)
   start --role=dev    Launch only sessions with matching role
@@ -445,7 +453,7 @@ Agent: {self.cfg.agent} (override with SWARM_AGENT=claude|trae|qwen)
   attendance          Show attendance records
   help                This message
 
-Roles (from ROSTER.md): lead, dev, intern, dispatcher
+Roles (from config.toml [session.X] role key): lead, dev, intern, dispatcher
 
 Examples:
   swarm start                           # launch all with Claude (default)

package/lib/swarm_backend.py

@@ -15,6 +15,9 @@ class SessionBackend(ABC):
     @abstractmethod
     def is_running(self, prefix: str, name: str) -> bool: ...
 
+    def is_agent_active(self, prefix: str, name: str) -> bool:
+        return self.is_running(prefix, name)
+
     @abstractmethod
     def start_session(
         self,
@@ -39,6 +42,9 @@ class SessionBackend(ABC):
     @abstractmethod
     def capture_pane(self, prefix: str, name: str) -> str: ...
 
+    @abstractmethod
+    def inject_initial_prompt(self, prefix: str, name: str, prompt: str, log_dir: Path) -> None: ...
+
 
 class TmuxBackend(SessionBackend):
     def _sess(self, prefix: str, name: str) -> str:
@@ -52,6 +58,21 @@ class TmuxBackend(SessionBackend):
         )
         return r.returncode == 0
 
+    def _pane_command(self, prefix: str, name: str) -> str:
+        r = subprocess.run(
+            ["tmux", "list-panes", "-t", self._sess(prefix, name), "-F", "#{pane_current_command}"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        return r.stdout.strip().split("\n")[0] if r.returncode == 0 else ""
+
+    def is_agent_active(self, prefix: str, name: str) -> bool:
+        if not self.is_running(prefix, name):
+            return False
+        cmd = self._pane_command(prefix, name)
+        return cmd not in ("zsh", "bash", "sh", "-zsh", "-bash", "")
+
     def capture_pane(self, prefix: str, name: str) -> str:
         r = subprocess.run(
             ["tmux", "capture-pane", "-t", self._sess(prefix, name), "-p"],
@@ -93,7 +114,7 @@ class TmuxBackend(SessionBackend):
             )
             if "I trust" in r.stdout or "trust this folder" in r.stdout.lower():
                 time.sleep(0.5)
-                subprocess.run(["tmux", "send-keys", "-t", sess, "Enter"])
+                subprocess.run(["tmux", "send-keys", "-t", sess, "Enter"], timeout=10)
                 return
             time.sleep(2)
             waited += 2
@@ -106,7 +127,7 @@ class TmuxBackend(SessionBackend):
         agent_cmd: str,
     ) -> str:
         sess = self._sess(prefix, name)
-        subprocess.run(["tmux", "new-session", "-d", "-s", sess, "-x", "200", "-y", "50"])
+        subprocess.run(["tmux", "new-session", "-d", "-s", sess, "-x", "200", "-y", "50"], timeout=10)
         self.wait_for_shell(prefix, name, timeout=10)
         subprocess.run(
             [
@@ -114,34 +135,35 @@ class TmuxBackend(SessionBackend):
                 "send-keys",
                 "-t",
                 sess,
-                f"source ~/.zprofile 2>/dev/null; source ~/.zshrc 2>/dev/null; cd '{project_root}'",
+                f"source ~/.zprofile 2>/dev/null; source ~/.zshrc 2>/dev/null; cd '{project_root}' && export CNB_PROJECT='{project_root}'",
                 "Enter",
-            ]
+            ],
+            timeout=10,
         )
         self.wait_for_shell(prefix, name, timeout=10)
-        subprocess.run(["tmux", "send-keys", "-t", sess, agent_cmd, "Enter"])
+        subprocess.run(["tmux", "send-keys", "-t", sess, agent_cmd, "Enter"], timeout=10)
         return sess
 
     def stop_session(self, prefix: str, name: str, save_cmd: str) -> None:
         sess = self._sess(prefix, name)
-        subprocess.run(["tmux", "send-keys", "-t", sess, "C-c"])
+        subprocess.run(["tmux", "send-keys", "-t", sess, "C-c"], timeout=10)
         time.sleep(1)
-        subprocess.run(["tmux", "send-keys", "-t", sess, f"! {save_cmd}", "Enter"])
+        subprocess.run(["tmux", "send-keys", "-t", sess, f"! {save_cmd}", "Enter"], timeout=10)
         time.sleep(3)
-        subprocess.run(["tmux", "send-keys", "-t", sess, "/exit", "Enter"])
+        subprocess.run(["tmux", "send-keys", "-t", sess, "/exit", "Enter"], timeout=10)
 
         waited = 0
         while self.is_running(prefix, name) and waited < 15:
             time.sleep(1)
             waited += 1
         if self.is_running(prefix, name):
-            subprocess.run(["tmux", "kill-session", "-t", sess])
+            subprocess.run(["tmux", "kill-session", "-t", sess], timeout=10)
             print(f"  {name}: force killed (after {waited}s)")
         else:
             print(f"  {name}: exited gracefully")
 
     def status_line(self, prefix: str, name: str, agent: str) -> str:
-        return f"running (tmux, agent: {agent})"
+        return f"running (tmux, engine: {agent})"
 
     def attach(self, prefix: str, name: str) -> None:
         os.execvp("tmux", ["tmux", "attach-session", "-t", self._sess(prefix, name)])
@@ -152,22 +174,22 @@ class TmuxBackend(SessionBackend):
             print(f"  {name}: not running")
             raise SystemExit(1)
         oneline = message.replace("\n", " ")
-        subprocess.run(["tmux", "send-keys", "-t", sess, "-l", oneline])
-        subprocess.run(["tmux", "send-keys", "-t", sess, "Enter"])
+        subprocess.run(["tmux", "send-keys", "-t", sess, "-l", oneline], timeout=10)
+        subprocess.run(["tmux", "send-keys", "-t", sess, "Enter"], timeout=10)
         print(f"  {name}: injected")
 
     def inject_initial_prompt(self, prefix: str, name: str, prompt: str, log_dir: Path) -> None:
         if self.wait_for_prompt(prefix, name, timeout=60):
             sess = self._sess(prefix, name)
             time.sleep(1)
-            subprocess.run(["tmux", "send-keys", "-t", sess, "-l", prompt])
-            subprocess.run(["tmux", "send-keys", "-t", sess, "Enter"])
+            subprocess.run(["tmux", "send-keys", "-t", sess, "-l", prompt], timeout=10)
+            subprocess.run(["tmux", "send-keys", "-t", sess, "Enter"], timeout=10)
         else:
             with open(log_dir / f"{name}.log", "a") as f:
                 f.write(f"[WARN] {name}: prompt not detected after 60s, skipping injection\n")
 
     def enable_mouse(self) -> None:
-        subprocess.run(["tmux", "set", "-g", "mouse", "on"], capture_output=True)
+        subprocess.run(["tmux", "set", "-g", "mouse", "on"], capture_output=True, timeout=10)
 
 
 class ScreenBackend(SessionBackend):
@@ -191,29 +213,41 @@ class ScreenBackend(SessionBackend):
         agent_cmd: str,
     ) -> str:
         sess = self._sess(prefix, name)
-        subprocess.run(["screen", "-dmS", sess])
+        subprocess.run(["screen", "-dmS", sess], timeout=10)
         time.sleep(1)
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", f"cd '{project_root}'"])
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\r"])
+        subprocess.run(
+            [
+                "screen",
+                "-S",
+                sess,
+                "-p",
+                "0",
+                "-X",
+                "stuff",
+                f"cd '{project_root}' && export CNB_PROJECT='{project_root}'",
+            ],
+            timeout=10,
+        )
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\r"], timeout=10)
         time.sleep(0.5)
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", agent_cmd])
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\r"])
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", agent_cmd], timeout=10)
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\r"], timeout=10)
         return sess
 
     def stop_session(self, prefix: str, name: str, save_cmd: str) -> None:
         sess = self._sess(prefix, name)
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\x03"])
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\x03"], timeout=10)
         time.sleep(1)
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", f"! {save_cmd}\r"])
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", f"! {save_cmd}\r"], timeout=10)
         time.sleep(3)
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "/exit\r"])
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "/exit\r"], timeout=10)
 
         waited = 0
         while self.is_running(prefix, name) and waited < 15:
             time.sleep(1)
             waited += 1
         if self.is_running(prefix, name):
-            subprocess.run(["screen", "-S", sess, "-X", "quit"])
+            subprocess.run(["screen", "-S", sess, "-X", "quit"], timeout=10)
             print(f"  {name}: force killed (after {waited}s)")
         else:
             print(f"  {name}: exited gracefully")
@@ -228,7 +262,7 @@ class ScreenBackend(SessionBackend):
                 if parts:
                     state = parts[-1]
                 break
-        return f"running (screen, agent: {agent}) {state}"
+        return f"running (screen, engine: {agent}) {state}"
 
     def attach(self, prefix: str, name: str) -> None:
         os.execvp("screen", ["screen", "-r", self._sess(prefix, name)])
@@ -239,17 +273,17 @@ class ScreenBackend(SessionBackend):
             print(f"  {name}: not running")
             raise SystemExit(1)
         oneline = message.replace("\n", " ")
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", oneline])
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", oneline], timeout=10)
         time.sleep(0.3)
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\r"])
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\r"], timeout=10)
         print(f"  {name}: injected")
 
     def inject_initial_prompt(self, prefix: str, name: str, prompt: str, log_dir: Path) -> None:
         time.sleep(3)
         sess = self._sess(prefix, name)
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", prompt])
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", prompt], timeout=10)
         time.sleep(0.3)
-        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\r"])
+        subprocess.run(["screen", "-S", sess, "-p", "0", "-X", "stuff", "\r"], timeout=10)
 
 
 def detect_backend() -> SessionBackend:

package/lib/theme_profiles.py

@@ -0,0 +1,89 @@
+"""Profile data for person-name themes.
+
+Maps canonical short name -> full name + info for disambiguation.
+"""
+
+PROFILES: dict[str, dict[str, dict[str, str]]] = {
+    "ai": {
+        "altman": {"full_name": "Sam Altman", "info": "CEO of OpenAI"},
+        "dario": {"full_name": "Dario Amodei", "info": "CEO of Anthropic"},
+        "ilya": {
+            "full_name": "Ilya Sutskever",
+            "zh": "伊利亚",
+            "info": "Co-founder of SSI, former OpenAI chief scientist",
+        },
+        "lecun": {"full_name": "Yann LeCun", "info": "Chief AI Scientist at Meta, Turing Award winner"},
+        "karpathy": {"full_name": "Andrej Karpathy", "info": "Founder of Eureka Labs, former Tesla AI director"},
+        "hassabis": {"full_name": "Demis Hassabis", "info": "CEO of Google DeepMind, Nobel laureate"},
+        "vaswani": {
+            "full_name": "Ashish Vaswani",
+            "info": "Lead author of Attention Is All You Need, Transformer inventor",
+        },
+        "hinton": {"full_name": "Geoffrey Hinton", "info": "Godfather of deep learning, Turing & Nobel laureate"},
+        "bengio": {"full_name": "Yoshua Bengio", "info": "Mila founder, Turing Award winner"},
+        "fei-fei": {"full_name": "Fei-Fei Li", "zh": "李飞飞", "info": "Stanford HAI co-director, ImageNet creator"},
+        "ng": {"full_name": "Andrew Ng", "zh": "吴恩达", "info": "DeepLearning.AI founder, former Baidu VP"},
+        "zuck": {"full_name": "Mark Zuckerberg", "info": "CEO of Meta"},
+        "bezos": {"full_name": "Jeff Bezos", "info": "Founder of Amazon & Blue Origin"},
+        "nadella": {"full_name": "Satya Nadella", "info": "CEO of Microsoft"},
+        "pichai": {"full_name": "Sundar Pichai", "info": "CEO of Google & Alphabet"},
+        "musk": {"full_name": "Elon Musk", "info": "CEO of Tesla, SpaceX, xAI"},
+        "huang": {"full_name": "Jensen Huang", "zh": "黄仁勋", "info": "CEO of NVIDIA"},
+        "lisa-su": {"full_name": "Lisa Su", "zh": "苏姿丰", "info": "CEO of AMD"},
+        "radford": {"full_name": "Alec Radford", "info": "GPT & CLIP author, OpenAI researcher"},
+        "jack-clark": {"full_name": "Jack Clark", "info": "Co-founder of Anthropic"},
+    },
+    "threebody": {
+        "luo-ji": {"full_name": "罗辑 (Luo Ji)", "info": "面壁者、执剑人，黑暗森林威慑的守护者"},
+        "shi-qiang": {"full_name": "史强 (Shi Qiang)", "info": "刑警，人称大史，罗辑的搭档与守护者"},
+        "ye-wenjie": {"full_name": "叶文洁 (Ye Wenjie)", "info": "天体物理学家，红岸工程负责人，三体危机的起源"},
+        "cheng-xin": {"full_name": "程心 (Cheng Xin)", "info": "航天工程师，第二任执剑人，阶梯计划发起者"},
+        "zhang-beihai": {
+            "full_name": "章北海 (Zhang Beihai)",
+            "info": "海军政委，面壁者式的钢印战士，自然选择号劫持者",
+        },
+        "yun-tianming": {
+            "full_name": "云天明 (Yun Tianming)",
+            "info": "通过阶梯计划将大脑送往三体舰队，用三个童话传递情报",
+        },
+        "wang-miao": {"full_name": "汪淼 (Wang Miao)", "info": "纳米材料学家，三体游戏玩家，古筝行动参与者"},
+        "ding-yi": {"full_name": "丁仪 (Ding Yi)", "info": "理论物理学家，研究球状闪电和宏原子"},
+        "yang-dong": {"full_name": "杨冬 (Yang Dong)", "info": "粒子物理学家，叶文洁之女，因物理学不存在而绝望"},
+        "zhuang-yan": {"full_name": "庄颜 (Zhuang Yan)", "info": "罗辑的妻子，梦中人变为现实"},
+        "guan-yifan": {"full_name": "关一帆 (Guan Yifan)", "info": "引力波宇宙学家，与程心一同进入小宇宙"},
+        "shen-yufei": {"full_name": "申玉菲 (Shen Yufei)", "info": "物理学家，三体组织成员，降临派"},
+        "wei-cheng": {"full_name": "魏成 (Wei Cheng)", "info": "数学家，申玉菲之夫，研究三体问题数学解"},
+        "hines": {"full_name": "Bill Hines (比尔·希恩斯)", "info": "面壁者，脑科学家，思想钢印发明者"},
+        "tyler": {"full_name": "Frederick Tyler (弗雷德里克·泰勒)", "info": "面壁者，前美国国防部长"},
+        "wade": {"full_name": "Thomas Wade (托马斯·维德)", "info": "PIA 局长，光速飞船的推动者，不择手段的战略家"},
+        "evans": {"full_name": "Mike Evans (迈克·伊文斯)", "info": "地球三体组织统帅，审判日号船长"},
+        "rey-diaz": {
+            "full_name": "Manuel Rey Diaz (曼努尔·雷迪亚兹)",
+            "info": "面壁者，前委内瑞拉总统，恒星型氢弹计划",
+        },
+        "tomoko": {"full_name": "智子 (Tomoko/Sophon)", "info": "三体人用质子展开制造的超级计算机，也是人形使者"},
+        "singer": {"full_name": "歌者 (Singer)", "info": "歌者文明的清理员，向太阳系发射二向箔"},
+    },
+    "titan": {
+        "wang-xingxing": {"full_name": "王兴兴 (Wang Xingxing)", "info": "宇树科技创始人，人形机器人先驱"},
+        "ren-zhengfei": {"full_name": "任正非 (Ren Zhengfei)", "info": "华为创始人"},
+        "zhang-yiming": {"full_name": "张一鸣 (Zhang Yiming)", "info": "字节跳动创始人"},
+        "lei-jun": {"full_name": "雷军 (Lei Jun)", "info": "小米创始人"},
+        "li-yanhong": {"full_name": "李彦宏 (Li Yanhong)", "info": "百度创始人兼CEO"},
+        "li-kaifu": {"full_name": "李开复 (Kai-Fu Lee)", "info": "零一万物创始人，创新工场董事长"},
+        "liang-wenfeng": {"full_name": "梁文锋 (Liang Wenfeng)", "info": "DeepSeek / 幻方量化创始人"},
+        "yang-zhilin": {"full_name": "杨植麟 (Yang Zhilin)", "info": "月之暗面 (Moonshot AI / Kimi) 创始人"},
+        "kaiming-he": {"full_name": "何恺明 (Kaiming He)", "info": "ResNet 作者，MIT 教授，前 FAIR 研究员"},
+        "ma-huateng": {"full_name": "马化腾 (Ma Huateng)", "info": "腾讯创始人兼CEO"},
+        "wang-jian": {"full_name": "王坚 (Wang Jian)", "info": "阿里云创始人，中国工程院院士"},
+        "lu-qi": {"full_name": "陆奇 (Lu Qi)", "info": "奇绩创坛创始人，前百度COO、微软副总裁"},
+        "goodfellow": {"full_name": "Ian Goodfellow", "info": "GAN 发明者"},
+        "schmidhuber": {"full_name": "Jürgen Schmidhuber", "info": "LSTM 共同发明者，IDSIA 科学主任"},
+        "dean": {"full_name": "Jeff Dean", "info": "Google Chief Scientist，MapReduce/TensorFlow 作者"},
+        "chollet": {"full_name": "François Chollet", "info": "Keras 作者，ARC 基准提出者"},
+        "silver": {"full_name": "David Silver", "info": "AlphaGo 首席研究员，DeepMind"},
+        "carmack": {"full_name": "John Carmack", "info": "Doom/Quake 之父，前 Oculus CTO"},
+        "torvalds": {"full_name": "Linus Torvalds", "info": "Linux & Git 创始人"},
+        "wolfram": {"full_name": "Stephen Wolfram", "info": "Mathematica 创始人，Wolfram Research CEO"},
+    },
+}

package/migrations/004_heartbeat.sql

@@ -0,0 +1 @@
+ALTER TABLE sessions ADD COLUMN last_heartbeat TEXT DEFAULT NULL;

package/migrations/005_notification_log.sql

@@ -0,0 +1,12 @@
+-- Track delivered notifications to prevent duplicates.
+CREATE TABLE IF NOT EXISTS notification_log(
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    notif_type TEXT NOT NULL,
+    recipient TEXT NOT NULL,
+    ref_type TEXT NOT NULL,
+    ref_id TEXT NOT NULL,
+    channel TEXT NOT NULL,
+    sent_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%d %H:%M:%S','now','localtime'))
+);
+CREATE INDEX IF NOT EXISTS idx_notif_dedup ON notification_log(notif_type, recipient, ref_id);
+CREATE INDEX IF NOT EXISTS idx_notif_ts ON notification_log(sent_at);