claude-nb 0.4.0 → 0.5.1

package/lib/board_task.py

@@ -1,7 +1,7 @@
 """board_task — task queue: add / done / list / next."""
 
 from lib.board_db import BoardDB, ts
-from lib.common import is_privileged, is_terminal_task_status, parse_flags
+from lib.common import is_privileged, is_terminal_task_status, parse_flags, validate_identity
 
 
 def _promote_next(db: BoardDB, target: str) -> None:
@@ -48,6 +48,7 @@ def _print_queue(db: BoardDB, target: str, include_done: bool = False) -> None:
 
 
 def cmd_task(db: BoardDB, identity: str, args: list[str]) -> None:
+    validate_identity(db, identity)
     subcmd = args[0] if args else "list"
     rest = args[1:] if len(args) > 1 else []
 
@@ -90,7 +91,7 @@ def _task_add(db: BoardDB, identity: str, args: list[str]) -> None:
             (target, desc, status, priority),
             c=c,
         )
-        print(f"OK #{task_id}")
+        print(f"OK task #{task_id} added to {target} ({status})")
 
         if target != name:
             now = ts()
@@ -100,28 +101,30 @@ def _task_add(db: BoardDB, identity: str, args: list[str]) -> None:
                 c=c,
             )
             db.execute("INSERT INTO inbox(session, message_id) VALUES (?, ?)", (target, msg_id), c=c)
+            print(f"OK notified {target}")
+    _print_queue(db, target)
 
 
 def _task_done(db: BoardDB, identity: str, args: list[str]) -> None:
     name = identity.lower()
 
-    task_id = args[0] if args else None
+    raw_id: str | int | None = args[0] if args else None
 
-    if not task_id:
+    if not raw_id:
         _promote_next(db, name)
-        task_id = db.scalar(
+        raw_id = db.scalar(
             "SELECT id FROM tasks WHERE session=? AND status='active' ORDER BY id ASC LIMIT 1",
             (name,),
         )
-    if not task_id:
+    if not raw_id:
         print(f"No active task for {name}.")
         _print_queue(db, name)
         return
 
     try:
-        task_id = int(task_id)
-    except ValueError:
-        print(f"ERROR: 无效的任务 ID: {task_id}")
+        task_id = int(raw_id)
+    except (ValueError, TypeError):
+        print(f"ERROR: 无效的任务 ID: {raw_id}")
         raise SystemExit(1)
     row = db.query_one("SELECT session, status, description FROM tasks WHERE id=?", (task_id,))
     if not row:
@@ -140,9 +143,18 @@ def _task_done(db: BoardDB, identity: str, args: list[str]) -> None:
 
     now = ts()
     db.execute("UPDATE tasks SET status='done', done_at=? WHERE id=?", (now, task_id))
-    print(f"OK #{task_id} done")
+    print(f"OK task #{task_id} done: {desc}")
 
     _promote_next(db, assignee)
+    nxt = db.query_one(
+        "SELECT id, description FROM tasks WHERE session=? AND status='active' ORDER BY id ASC LIMIT 1",
+        (assignee,),
+    )
+    if nxt:
+        print(f"Next: #{nxt[0]} {nxt[1]}")
+    else:
+        print(f"No remaining active/pending tasks for {assignee}.")
+    _print_queue(db, assignee)
 
 
 def _task_list(db: BoardDB, identity: str, args: list[str]) -> None:

package/lib/board_tui.py

@@ -44,25 +44,26 @@ def cmd_tui(db: BoardDB) -> None:
         print("ERROR: 没有在线的 worker，先运行 cnb swarm start")
         raise SystemExit(1)
 
-    # Kill old UI session if exists
+    # Rebuild base UI session (shared window group)
     if _session_exists(UI_SESSION):
         _tmux("kill-session", "-t", UI_SESSION)
 
-    # Create session grouped with first worker
-    _tmux("new-session", "-d", "-s", UI_SESSION, "-t", f"{prefix}-{online[0]}")
+    _tmux("new-session", "-d", "-s", UI_SESSION)
+    for name in online:
+        _tmux("link-window", "-s", f"{prefix}-{name}:0", "-t", UI_SESSION, "-a")
+    _tmux("kill-window", "-t", f"{UI_SESSION}:0")
 
-    # Link remaining workers as windows
-    for name in online[1:]:
-        _tmux("link-window", "-s", f"{prefix}-{name}", "-t", UI_SESSION, "-a")
-
-    # Rename windows
     win_indices = _tmux_out("list-windows", "-t", UI_SESSION, "-F", "#{window_index}").split("\n")
     for i, name in enumerate(online):
         if i < len(win_indices):
             _tmux("rename-window", "-t", f"{UI_SESSION}:{win_indices[i]}", name)
 
-    # Mouse + clean visual config
-    opts = {
+    _apply_style(len(online), win_indices)
+    _open_terminal()
+
+
+def _apply_style(n_online: int, win_indices: list[str]) -> None:
+    session_opts = {
         "mouse": "on",
         "status": "on",
         "status-position": "top",
@@ -70,24 +71,27 @@ def cmd_tui(db: BoardDB) -> None:
         "status-left": " cnb ",
         "status-left-style": "bold",
         "status-left-length": "6",
-        "status-right": f" {len(online)} online ",
+        "status-right": f" {n_online} online ",
         "status-right-style": "dim",
+    }
+    for k, v in session_opts.items():
+        _tmux("set-option", "-t", UI_SESSION, k, v)
+
+    window_opts = {
         "window-status-format": " #W ",
         "window-status-current-format": " #W ",
         "window-status-style": "dim",
         "window-status-current-style": "bold,underscore",
         "window-status-separator": "",
     }
-    for k, v in opts.items():
-        _tmux("set-option", "-t", UI_SESSION, k, v)
-
-    # Open in new terminal window
-    _open_terminal()
+    for idx in win_indices:
+        for k, v in window_opts.items():
+            _tmux("set-option", "-w", "-t", f"{UI_SESSION}:{idx}", k, v)
 
 
 def _open_terminal() -> None:
-    """Open a new terminal window attached to cnb-ui."""
-    attach_cmd = f"tmux attach -t {UI_SESSION}"
+    """Open a new terminal attached to cnb-ui."""
+    attach_cmd = f"tmux attach -t {UI_SESSION} ';' set-option destroy-unattached on"
 
     if sys.platform == "darwin":
         if os.path.isdir("/Applications/iTerm.app"):
@@ -99,7 +103,10 @@ def _open_terminal() -> None:
             )
         else:
             script = f'tell application "Terminal"\n  do script "{attach_cmd}"\n  activate\nend tell'
-        subprocess.run(["osascript", "-e", script], capture_output=True)
+        r = subprocess.run(["osascript", "-e", script], capture_output=True, text=True)
+        if r.returncode != 0:
+            print(f"ERROR: 无法打开终端: {r.stderr.strip()}")
+            raise SystemExit(1)
         print("OK 已打开 — 点击顶部 tab 切换同学")
     else:
         import shutil
@@ -109,4 +116,5 @@ def _open_terminal() -> None:
                 subprocess.Popen([term, "--", "bash", "-c", attach_cmd])
                 print("OK 已打开 — 点击顶部 tab 切换同学")
                 return
-        print(f"运行: {attach_cmd}")
+        print(f"ERROR: 找不到终端模拟器，手动运行: {attach_cmd}")
+        raise SystemExit(1)

package/lib/board_view.py

@@ -41,31 +41,57 @@ def _tmux_pane_command(name: str) -> str:
         return ""
 
 
+def _heartbeat_status(last_heartbeat: str | None, prefix: str, name: str) -> tuple[str, str]:
+    """Derive agent liveness from heartbeat timestamp, with tmux fallback."""
+    if last_heartbeat:
+        try:
+            hb_time = datetime.strptime(last_heartbeat, "%Y-%m-%d %H:%M:%S")
+            delta = (datetime.now() - hb_time).total_seconds()
+            if delta < 120:
+                ago = f"[{int(delta)}s ago]"
+                return "● active", ago
+            elif delta < 180:
+                return "◐ thinking", f"[{int(delta / 60)}m ago]"
+            elif delta < 600:
+                return "○ stale", f"[{int(delta / 60)}m ago]"
+            else:
+                hours = delta / 3600
+                ago = f"[{int(hours)}h ago]" if hours >= 1 else f"[{int(delta / 60)}m ago]"
+                return "· offline", ago
+        except ValueError:
+            pass
+    sess = f"{prefix}-{name}"
+    if _tmux_has_session(sess):
+        cmd = _tmux_pane_command(sess)
+        if cmd not in ("zsh", "bash", "sh", "-zsh", "-bash"):
+            return "● running", ""
+        return "○ dead", ""
+    return "· offline", ""
+
+
 def cmd_overview(db: BoardDB) -> None:
     """Default view when running cnb with no args."""
+    assert db.env is not None
     prefix = db.env.prefix
     now = datetime.now().strftime("%H:%M")
     print(f"=== {db.env.project_root.name}  {now} ===")
     print()
 
     # ── sessions ──
-    for (name,) in db.query("SELECT name FROM sessions WHERE name != 'all' ORDER BY name"):
-        sess = f"{prefix}-{name}"
-        if _tmux_has_session(sess):
-            cmd = _tmux_pane_command(sess)
-            status = "● running" if cmd not in ("zsh", "bash", "sh", "-zsh", "-bash") else "○ dead"
-        else:
-            status = "· offline"
+    for row in db.query("SELECT name, status, last_heartbeat FROM sessions WHERE name != 'all' ORDER BY name"):
+        name, task, last_hb = row[0], row[1], row[2]
+        status, ago = _heartbeat_status(last_hb, prefix, name)
 
         inbox = db.scalar("SELECT COUNT(*) FROM inbox WHERE session=? AND read=0", (name,)) or 0
         inbox_str = f"  [{inbox} msg]" if inbox else ""
-        task = db.scalar("SELECT status FROM sessions WHERE name=?", (name,)) or ""
         if task:
             task = task[:60]
         else:
             task = "(no status)"
 
         line = f"  {status:12s} {name:<10s} {task}"
+        if ago:
+            line += f"  {ago}"
         if inbox:
             line += f"{inbox_str}"
         print(line)
@@ -100,6 +126,7 @@ def cmd_overview(db: BoardDB) -> None:
 
 
 def cmd_view(db: BoardDB, identity: str) -> None:
+    assert db.env is not None
     print("=== Board ===\n")
 
     roadmap = db.env.project_root / "ROADMAP.md"
@@ -118,16 +145,19 @@ def cmd_view(db: BoardDB, identity: str) -> None:
         if count:
             print(f">>> 你有 {count} 条未读消息，运行 ./board inbox 查看 <<<\n")
 
+    prefix = db.env.prefix
     print("Status:")
-    for name, task in db.query("SELECT name, status FROM sessions ORDER BY name"):
+    for name, task, last_hb in db.query("SELECT name, status, last_heartbeat FROM sessions ORDER BY name"):
         cap = name[0].upper() + name[1:] if name else name
+        status, ago = _heartbeat_status(last_hb, prefix, name)
         task = task or "(none)"
         tag = ""
         if p0_locked and "[P0]" not in task:
             tag = " [!! 未标 P0]"
-        if len(task) > 72:
-            task = task[:69] + "..."
-        print(f"  {cap:<8s} {task}{tag}")
+        if len(task) > 60:
+            task = task[:57] + "..."
+        ago_str = f"  {ago}" if ago else ""
+        print(f"  {status:12s} {cap:<10s} {task}{tag}{ago_str}")
     print()
 
     print("Recent messages:")
@@ -154,6 +184,7 @@ def cmd_view(db: BoardDB, identity: str) -> None:
 
 
 def cmd_p0(db: BoardDB) -> None:
+    assert db.env is not None
     roadmap = db.env.project_root / "ROADMAP.md"
     if not roadmap.is_file():
         print("ERROR: ROADMAP.md not found")
@@ -181,6 +212,7 @@ def cmd_p0(db: BoardDB) -> None:
 
 
 def cmd_prebuild(db: BoardDB) -> None:
+    assert db.env is not None
     print("=== Pre-build Check ===\n")
     has_fail = False
     pr = db.env.project_root
@@ -207,6 +239,7 @@ def cmd_prebuild(db: BoardDB) -> None:
 
 
 def cmd_dirty(db: BoardDB) -> None:
+    assert db.env is not None
     print("=== Uncommitted Changes ===\n")
     pr = db.env.project_root
     changes = _git(pr, "status", "--porcelain").strip()
@@ -228,22 +261,18 @@ def cmd_dirty(db: BoardDB) -> None:
 
 
 def cmd_dashboard(db: BoardDB) -> None:
+    assert db.env is not None
     prefix = db.env.prefix
     print(f"=== Team Dashboard {datetime.now().strftime('%H:%M')} ===\n")
-    for (name,) in db.query("SELECT name FROM sessions ORDER BY name"):
-        session_name = f"{prefix}-{name}"
-        status = "offline"
-        if _tmux_has_session(session_name):
-            cmd = _tmux_pane_command(session_name)
-            if cmd in ("zsh", "bash", "sh", "-zsh", "-bash"):
-                status = "DEAD"
-            else:
-                status = "running"
+    for row in db.query("SELECT name, status, last_heartbeat FROM sessions ORDER BY name"):
+        name, task, last_hb = row[0], row[1], row[2]
+        status, ago = _heartbeat_status(last_hb, prefix, name)
 
         inbox_count = db.scalar("SELECT COUNT(*) FROM inbox WHERE session=? AND read=0", (name,))
         inbox_str = f" [{inbox_count}msg]" if inbox_count else ""
-        task = db.scalar("SELECT substr(status, 1, 50) FROM sessions WHERE name=?", (name,)) or "-"
-        print(f"  {name:<7s} {status:<8s}{inbox_str}")
+        task = task[:50] if task else "-"
+        ago_str = f"  {ago}" if ago else ""
+        print(f"  {name:<7s} {status:<12s}{inbox_str}{ago_str}")
         print(f"         {task}")
     print()
     dispatcher_sess = f"{prefix}-dispatcher"
@@ -254,6 +283,7 @@ def cmd_dashboard(db: BoardDB) -> None:
 
 
 def cmd_files(db: BoardDB) -> None:
+    assert db.env is not None
     print("=== 共享文件 ===\n")
     rows = db.query("SELECT hash, original_name, sender, ts FROM files ORDER BY ts DESC")
     if not rows:
@@ -270,6 +300,7 @@ def cmd_files(db: BoardDB) -> None:
 
 
 def cmd_get(db: BoardDB, args: list[str]) -> None:
+    assert db.env is not None
     if not args:
         print("Usage: ./board get <hash-prefix|filename>")
         raise SystemExit(1)
@@ -298,15 +329,15 @@ def cmd_get(db: BoardDB, args: list[str]) -> None:
 
 def cmd_freshness(db: BoardDB) -> None:
     print("=== 数据新鲜度 ===\n")
-    print(f"  {'Session':<8s}  {'Last status update':<20s}  {'Unread inbox'}")
-    print(f"  {'-------':<8s}  {'------------------':<20s}  {'------------'}")
+    print(f"  {'Session':<8s}  {'Last status':<20s}  {'Last heartbeat':<20s}  {'Unread'}")
+    print(f"  {'-------':<8s}  {'-----------':<20s}  {'--------------':<20s}  {'------'}")
     rows = db.query(
-        "SELECT s.name, s.updated_at, "
+        "SELECT s.name, s.updated_at, s.last_heartbeat, "
         "(SELECT COUNT(*) FROM inbox i WHERE i.session=s.name AND i.read=0) "
         "FROM sessions s ORDER BY s.name"
     )
-    for name, updated, inbox_count in rows:
-        print(f"  {name:<8s}  {updated or '(never)':<20s}  {inbox_count}")
+    for name, updated, heartbeat, inbox_count in rows:
+        print(f"  {name:<8s}  {updated or '(never)':<20s}  {heartbeat or '(never)':<20s}  {inbox_count}")
 
 
 def cmd_relations(db: BoardDB) -> None:
@@ -343,6 +374,7 @@ def cmd_history(db: BoardDB, args: list[str]) -> None:
 
 
 def cmd_roster(db: BoardDB) -> None:
+    assert db.env is not None
     print("=== 员工状态 ===")
     prefix = db.env.prefix
     rows = db.query(

package/lib/board_vote.py

@@ -1,10 +1,11 @@
 """board_vote — governance: vote / tally / propose."""
 
 from lib.board_db import BoardDB, ts
-from lib.common import PRIVILEGED_ROLES, parse_flags
+from lib.common import PRIVILEGED_ROLES, parse_flags, validate_identity
 
 
 def cmd_vote(db: BoardDB, identity: str, args: list[str]) -> None:
+    validate_identity(db, identity)
     name = identity.lower()
     if name in PRIVILEGED_ROLES:
         print("ERROR: privileged roles have no voting rights (charter §二)")
@@ -58,7 +59,9 @@ def cmd_vote(db: BoardDB, identity: str, args: list[str]) -> None:
 
     prop_type = db.scalar("SELECT type FROM proposals WHERE id=?", (prop_id,))
     eligible = (
-        db.scalar("SELECT COUNT(*) FROM sessions WHERE name != (SELECT value FROM meta WHERE key='dispatcher_session')")
+        db.scalar(
+            "SELECT COUNT(*) FROM sessions WHERE name NOT IN (SELECT value FROM meta WHERE key='dispatcher_session')"
+        )
         or 0
     )
     threshold = (eligible * 2 + 2) // 3 if prop_type == "S" else eligible // 2 + 1
@@ -90,6 +93,7 @@ def cmd_vote(db: BoardDB, identity: str, args: list[str]) -> None:
 
 
 def cmd_propose(db: BoardDB, identity: str, args: list[str]) -> None:
+    validate_identity(db, identity)
     name = identity.lower()
     if len(args) < 1:
         print("Usage: ./board --as <name> propose <内容> [--type S]")
@@ -157,7 +161,9 @@ def cmd_tally(db: BoardDB, args: list[str]) -> None:
     )
     prop_type = db.scalar("SELECT type FROM proposals WHERE id=?", (prop_id,))
     eligible = (
-        db.scalar("SELECT COUNT(*) FROM sessions WHERE name != (SELECT value FROM meta WHERE key='dispatcher_session')")
+        db.scalar(
+            "SELECT COUNT(*) FROM sessions WHERE name NOT IN (SELECT value FROM meta WHERE key='dispatcher_session')"
+        )
         or 0
     )
     threshold = (eligible * 2 + 2) // 3 if prop_type == "S" else eligible // 2 + 1

package/lib/build_lock.py

@@ -184,22 +184,22 @@ def main() -> None:
     if cmd == "acquire":
         if len(args) < 2:
             print("Usage: build_lock.py acquire <session> <target>", file=sys.stderr)
-            sys.exit(1)
+            raise SystemExit(1)
         session = args[1]
         target = args[2] if len(args) > 2 else "unknown"
         ok, msg = lock.acquire(session, target)
         print(msg)
         if not ok:
-            sys.exit(1)
+            raise SystemExit(1)
 
     elif cmd == "release":
         if len(args) < 2:
             print("Usage: build_lock.py release <session>", file=sys.stderr)
-            sys.exit(1)
+            raise SystemExit(1)
         ok, msg = lock.release(args[1])
         print(msg)
         if not ok:
-            sys.exit(1)
+            raise SystemExit(1)
 
     elif cmd == "status":
         print(lock.status())
@@ -207,14 +207,14 @@ def main() -> None:
     elif cmd == "wrap":
         if len(args) < 3:
             print("Usage: build_lock.py wrap <session> <command...>", file=sys.stderr)
-            sys.exit(1)
+            raise SystemExit(1)
         session = args[1]
         command = args[2:]
-        sys.exit(lock.wrap(session, command))
+        raise SystemExit(lock.wrap(session, command))
 
     else:
         print("Usage: build_lock.py {acquire|release|status|wrap} [args...]", file=sys.stderr)
-        sys.exit(1)
+        raise SystemExit(1)
 
 
 if __name__ == "__main__":

package/lib/common.py

@@ -12,13 +12,21 @@ from typing import Any, Generic, TypeVar
 
 
 def find_claudes_dir() -> Path:
-    """Walk up from cwd to find the .claudes/ directory."""
+    """Find .claudes/ directory. Checks CNB_PROJECT env var first, then walks up from cwd."""
+    import os
+
+    env_root = os.environ.get("CNB_PROJECT")
+    if env_root:
+        p = Path(env_root) / ".claudes"
+        if p.is_dir():
+            return p
+
     d = Path.cwd()
     while d != d.parent:
         if (d / ".claudes").is_dir():
             return d / ".claudes"
         d = d.parent
-    raise FileNotFoundError(".claudes/ not found")
+    raise FileNotFoundError(".claudes/ not found (set CNB_PROJECT or run from project dir)")
 
 
 def _parse_toml(path: Path) -> dict:
@@ -28,6 +36,30 @@ def _parse_toml(path: Path) -> dict:
     return tomllib.loads(path.read_text())
 
 
+def _write_config_toml(path: Path, data: dict) -> None:
+    """Serialize *data* back to our config.toml format."""
+    lines: list[str] = []
+    for key, val in data.items():
+        if key == "session":
+            continue
+        if isinstance(val, list):
+            items = ", ".join(f'"{v}"' for v in val)
+            lines.append(f"{key} = [{items}]")
+        else:
+            lines.append(f'{key} = "{val}"')
+    lines.append("")
+    for name, section in data.get("session", {}).items():
+        lines.append(f"[session.{name}]")
+        for k, v in section.items():
+            sv = str(v)
+            if "\n" in sv:
+                lines.append(f'{k} = """{sv}"""')
+            else:
+                lines.append(f'{k} = "{sv}"')
+        lines.append("")
+    path.write_text("\n".join(lines) + "\n")
+
+
 @dataclass
 class ClaudesEnv:
     claudes_dir: Path
@@ -84,6 +116,16 @@ def is_privileged(name: str) -> bool:
     return name in PRIVILEGED_ROLES
 
 
+def validate_identity(db: "BaseDB", identity: str) -> None:
+    name = identity.lower()
+    if name in PRIVILEGED_ROLES:
+        return
+    exists = db.scalar("SELECT COUNT(*) FROM sessions WHERE name=?", (name,))
+    if not exists:
+        print(f"ERROR: '{name}' is not a registered session")
+        raise SystemExit(1)
+
+
 def is_terminal_task_status(status: str) -> bool:
     """Return True if *status* is a terminal state (task will not transition further).
 
@@ -190,7 +232,7 @@ class DB(BaseDB):
 
     def execute(self, sql: str, params: tuple[Any, ...] = ()) -> int:
         with self.conn() as c:
-            return c.execute(sql, params).lastrowid
+            return c.execute(sql, params).lastrowid or 0
 
 
 # ---------------------------------------------------------------------------

package/lib/concerns/__init__.py

@@ -11,7 +11,8 @@ from .file_watcher import FileWatcher
 from .health import HealthChecker, ResourceMonitor, SessionKeepAlive
 from .helpers import log, tmux_ok, warn
 from .idle import IdleDetector, IdleKiller, IdleNudger
-from .notifications import BugSLAChecker, InboxNudger, TimeAnnouncer
+from .notifications import BugSLAChecker, InboxNudger, QueuedMessageFlusher, TimeAnnouncer
+from .nudge_coordinator import NudgeCoordinator
 
 __all__ = [
     "AdaptiveThrottle",
@@ -26,6 +27,8 @@ __all__ = [
     "IdleKiller",
     "IdleNudger",
     "InboxNudger",
+    "NudgeCoordinator",
+    "QueuedMessageFlusher",
     "ResourceMonitor",
     "SessionKeepAlive",
     "TimeAnnouncer",

package/lib/concerns/coral.py

@@ -38,7 +38,7 @@ class CoralManager(Concern):
         log("Starting Coral...")
         tmux("kill-session", "-t", self.cfg.coral_sess)
         tmux("new-session", "-d", "-s", self.cfg.coral_sess, "-x", "200", "-y", "50")
-        tmux_send(self.cfg.coral_sess, f"cd '{self.cfg.project_root}'")
+        tmux_send(self.cfg.coral_sess, f"cd '{self.cfg.project_root}' && export CNB_PROJECT='{self.cfg.project_root}'")
         time.sleep(0.5)
         tmux_send(
             self.cfg.coral_sess,

package/lib/concerns/digest_scheduler.py

@@ -0,0 +1,109 @@
+"""DigestScheduler — sends daily/weekly digests at scheduled times."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from pathlib import Path
+
+from lib.digest import generate_daily_digest
+from lib.notification_config import load as load_config
+
+from .base import Concern
+from .config import DispatcherConfig
+from .helpers import board_send, db, get_dev_sessions, log, warn
+
+
+class DigestScheduler(Concern):
+    interval = 30
+
+    def __init__(self, cfg: DispatcherConfig) -> None:
+        super().__init__()
+        self.cfg = cfg
+        self._last_daily_date: str = ""
+        self._last_weekly_date: str = ""
+
+    def _config_path(self) -> Path:
+        return self.cfg.claudes_dir / "notifications.toml"
+
+    def _already_sent_today(self, notif_type: str, date_str: str) -> bool:
+        try:
+            count = db(self.cfg).scalar(
+                "SELECT COUNT(*) FROM notification_log WHERE notif_type=? AND ref_id=?",
+                (notif_type, f"digest-{date_str}"),
+            )
+            return bool(count)
+        except Exception:
+            return False
+
+    def _record_digest(self, notif_type: str, recipient: str, date_str: str, channel: str) -> None:
+        try:
+            with db(self.cfg).conn() as c:
+                c.execute(
+                    "INSERT INTO notification_log(notif_type, recipient, ref_type, ref_id, channel) VALUES(?,?,?,?,?)",
+                    (notif_type, recipient, "digest", f"digest-{date_str}", channel),
+                )
+        except Exception as e:
+            warn(f"digest record: {e}")
+
+    def tick(self, now: int) -> None:
+        d = datetime.now()
+        if d.hour != 9 or d.minute > 5:
+            return
+
+        date_str = d.strftime("%Y-%m-%d")
+
+        if date_str != self._last_daily_date:
+            self._send_daily(date_str)
+            self._last_daily_date = date_str
+
+        if d.weekday() == 0 and date_str != self._last_weekly_date:
+            self._send_weekly(date_str)
+            self._last_weekly_date = date_str
+
+    def _send_daily(self, date_str: str) -> None:
+        if self._already_sent_today("daily-digest", date_str):
+            log(f"Daily digest already sent for {date_str}, skipping")
+            return
+
+        config = load_config(self._config_path())
+        members = get_dev_sessions(self.cfg)
+        subscribers = config.subscribers_for("daily-digest", members)
+
+        if not subscribers:
+            return
+
+        try:
+            board = db(self.cfg)
+            digest_text = generate_daily_digest(board)
+        except Exception as e:
+            warn(f"digest generation failed: {e}")
+            return
+
+        for member in subscribers:
+            channel = config.channel_for(member)
+            if channel == "board-inbox":
+                board_send(self.cfg, member, digest_text)
+            else:
+                log(f"[digest] {channel} delivery not implemented for {member}")
+            self._record_digest("daily-digest", member, date_str, channel)
+
+        log(f"Daily digest sent to {len(subscribers)} subscribers")
+
+    def _send_weekly(self, date_str: str) -> None:
+        if self._already_sent_today("weekly-report", date_str):
+            log(f"Weekly report already sent for {date_str}, skipping")
+            return
+
+        config = load_config(self._config_path())
+        members = get_dev_sessions(self.cfg)
+        subscribers = config.subscribers_for("weekly-report", members)
+
+        if not subscribers:
+            return
+
+        board_send(self.cfg, "all", f"[Weekly Report] {date_str} — 本周报告待实现")
+        for member in subscribers:
+            channel = config.channel_for(member)
+            self._record_digest("weekly-report", member, date_str, channel)
+
+        log(f"Weekly report sent to {len(subscribers)} subscribers")