bothouse-dsh 0.1.45 → 0.1.47

package/collab/team-status.mjs

@@ -0,0 +1,180 @@
+// #876: read-only busy/idle view of cc-connect's team status files.
+//
+// cc-connect writes one <project>.json per bot under its team_status_dir
+// (bridge/core/team.go:319). The hub only reads them: no writes, no bridge
+// calls, no new event type. The existing `members` event carries the result.
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+// Same cadence as bridge/core/team.go:26 teamPollInterval: the desk is never
+// more than one writer tick behind.
+export const TEAM_POLL_INTERVAL_MS = 2000;
+// bridge/core/team.go:28 teamStaleAfter: three 20s heartbeats, then the bot
+// is treated as gone rather than busy forever.
+export const TEAM_STALE_AFTER_MS = 60_000;
+const STATUS_FILE = /^[a-z0-9][a-z0-9_-]*\.json$/i;
+
+function parseTime(value) {
+  const ms = Date.parse(value);
+  return Number.isFinite(ms) ? ms : undefined;
+}
+
+function text(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function iso(ms) {
+  return ms === undefined ? null : new Date(ms).toISOString();
+}
+
+/**
+ * Merge one member's status files into the optional fields on a member view.
+ * Every busy session is kept: a bot can work in several channels at once, and
+ * the desk needs all of them, not just the first.
+ */
+export function presenceOf(entries) {
+  const items = [];
+  for (const entry of entries) {
+    const project = text(entry?.project);
+    for (const session of Array.isArray(entry?.sessions) ? entry.sessions : []) {
+      if (session?.busy !== true) continue;
+      items.push({ project, chat: text(session.chat) || null, task: text(session.task), since: parseTime(session.since) });
+    }
+  }
+  const chats = [...new Set(items.map(i => i.chat).filter(Boolean))].sort();
+  const since = items.map(i => i.since).filter(v => v !== undefined).sort((a, b) => a - b)[0];
+  const lead = items.find(i => i.chat !== null && i.task) ?? items.find(i => i.chat !== null) ?? items.find(i => i.task) ?? items[0];
+  const done = entries.map(e => parseTime(e?.done_at)).filter(v => v !== undefined).sort((a, b) => a - b).at(-1);
+  return {
+    busy: items.length > 0,
+    busy_since: iso(since),
+    busy_task: lead?.task ?? '',
+    busy_chat: lead?.chat ?? null,
+    busy_chats: chats,
+    busy_count: items.length,
+    busy_items: items.map(i => ({ project: i.project, chat: i.chat, task: i.task, since: iso(i.since) })),
+    ...(items.length === 0 && done !== undefined ? { busy_done_at: iso(done) } : {}),
+  };
+}
+
+/** Parse one status file; `error` is a reason the caller may warn about. */
+export function readStatusFile(path, now, staleAfterMs = TEAM_STALE_AFTER_MS) {
+  let raw;
+  try {
+    raw = readFileSync(path, 'utf8');
+  } catch (error) {
+    return { error: error?.code === 'ENOENT' ? 'gone' : 'read' };
+  }
+  let entry;
+  try {
+    entry = JSON.parse(raw);
+  } catch {
+    return { error: 'json' };
+  }
+  if (entry === null || typeof entry !== 'object' || Array.isArray(entry)
+    || typeof entry.project !== 'string' || entry.project.trim() === ''
+    || (entry.sessions != null && !Array.isArray(entry.sessions))) return { error: 'shape' };
+  const updated = parseTime(entry.updated);
+  if (updated === undefined) return { error: 'shape' };
+  if (now - updated > staleAfterMs) return { error: 'stale' };
+  return { entry, updated };
+}
+
+export class TeamStatus {
+  constructor(hub, dir, { logger, intervalMs = TEAM_POLL_INTERVAL_MS, staleAfterMs = TEAM_STALE_AFTER_MS, now = Date.now } = {}) {
+    this.hub = hub;
+    this.dir = dir;
+    this.logger = logger;
+    this.intervalMs = intervalMs;
+    this.staleAfterMs = staleAfterMs;
+    this.now = now;
+    this.timer = undefined;
+    this.published = new Set();
+    this.fileOwner = new Map();
+    this.warned = new Set();
+  }
+
+  start() {
+    if (!this.dir || this.timer !== undefined) return;
+    this.poll();
+    this.timer = setInterval(() => this.poll(), this.intervalMs);
+    this.timer.unref?.();
+  }
+
+  stop() {
+    if (this.timer !== undefined) clearInterval(this.timer);
+    this.timer = undefined;
+    this.published.clear();
+  }
+
+  warnOnce(key, format, ...args) {
+    if (this.warned.has(key)) return;
+    this.warned.add(key);
+    this.logger?.warn?.(format, ...args);
+  }
+
+  /** Match a status project to a hub member: id first, then display name. */
+  resolve(project, name) {
+    const members = this.hub.memberList().filter(m => m.kind !== 'human');
+    const direct = members.find(m => String(m.id).toLowerCase() === text(project).toLowerCase());
+    if (direct !== undefined) return direct;
+    const label = text(name).toLowerCase();
+    if (label === '') return undefined;
+    const same = members.filter(m => text(m.name).toLowerCase() === label);
+    if (same.length === 1) return same[0];
+    if (same.length > 1) this.warnOnce(`ambiguous:${project}`, 'conest-collab: team project %s matches %d members by name; busy state skipped', project, same.length);
+    return undefined;
+  }
+
+  poll() {
+    if (!this.dir) return;
+    let names;
+    try {
+      names = readdirSync(this.dir).sort();
+    } catch {
+      this.warnOnce('dir', 'conest-collab: team status directory is unreadable: %s', this.dir);
+      for (const id of this.published) this.hub.setPresence(id, undefined);
+      this.published.clear();
+      return;
+    }
+    this.warned.delete('dir');
+    const now = this.now();
+    const byMember = new Map();
+    const keep = new Set();
+    for (const name of names) {
+      if (!STATUS_FILE.test(name) || name.startsWith('board')) continue;
+      const path = join(this.dir, name);
+      const loaded = readStatusFile(path, now, this.staleAfterMs);
+      if (loaded.error !== undefined) {
+        if (loaded.error === 'stale' || loaded.error === 'gone') {
+          this.fileOwner.delete(name);
+        } else {
+          this.warnOnce(`file:${name}`, 'conest-collab: bad team status file %s', path);
+          // A writer may be mid-replace; keep the last good state, but only for the
+          // same 60s window a readable file would still be valid in.
+          const previous = this.fileOwner.get(name);
+          if (previous !== undefined && now - previous.updated <= this.staleAfterMs) keep.add(previous.id);
+          else this.fileOwner.delete(name);
+        }
+        continue;
+      }
+      this.warned.delete(`file:${name}`);
+      const { entry, updated } = loaded;
+      const member = this.resolve(entry.project, entry.name);
+      if (member === undefined) {
+        this.warnOnce(`member:${entry.project}`, 'conest-collab: no hub member for team project %s; busy state skipped', entry.project);
+        continue;
+      }
+      this.warned.delete(`member:${entry.project}`);
+      this.fileOwner.set(name, { id: member.id, updated });
+      if (member.online === false || member.error) continue;
+      const list = byMember.get(member.id) ?? [];
+      list.push(entry);
+      byMember.set(member.id, list);
+    }
+    // A stale, deleted or unmatched member must stop looking busy on the desk.
+    for (const id of this.published) if (!byMember.has(id) && !keep.has(id)) this.hub.setPresence(id, undefined);
+    for (const [id, entries] of byMember) this.hub.setPresence(id, presenceOf(entries));
+    this.published = new Set([...byMember.keys(), ...keep]);
+  }
+}

package/collab/wiki-galaxy.mjs

@@ -0,0 +1,126 @@
+// Wiki 星河：把一本 markdown wiki 画成星系。每页一颗星，[[链接]] 与相对 .md 链接是连线，
+// 顶层目录是星团。只读：只扫配置的 wiki 目录，不写任何文件，不跟符号链接出目录。
+import { readdirSync, readFileSync } from 'node:fs';
+import { basename, join, posix, sep } from 'node:path';
+
+// 来源：用户要求「点一颗星能看到这页标题、描述和前几行」（交接 wiki-galaxy-1103 总目标）。
+export const EXCERPT_LINES = 5;
+
+const WIKI_LINK = /\[\[([^\]\n]+?)\]\]/g;
+const MD_LINK = /\]\(([^)\s]+?\.md)(?:#[^)]*)?\)/g;
+const HTML = 'text/html; charset=utf-8';
+const JSON_TYPE = 'application/json; charset=utf-8';
+
+/** 去掉 frontmatter，返回 { meta, body }；只认顶层 name/description 两个键。 */
+export function splitFrontmatter(text) {
+  const meta = {};
+  if (!text.startsWith('---\n')) return { meta, body: text };
+  const end = text.indexOf('\n---', 4);
+  if (end < 0) return { meta, body: text };
+  for (const line of text.slice(4, end).split('\n')) {
+    const m = /^(name|description):\s*(.*)$/.exec(line);
+    if (m) meta[m[1]] = m[2].trim().replace(/^(['"])(.*)\1$/, '$2');
+  }
+  const after = text.indexOf('\n', end + 1);
+  return { meta, body: after < 0 ? '' : text.slice(after + 1) };
+}
+
+function walk(root, rel, out) {
+  let entries;
+  try { entries = readdirSync(join(root, rel), { withFileTypes: true }); } catch { return; }
+  entries.sort((a, b) => a.name.localeCompare(b.name));
+  for (const entry of entries) {
+    if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;
+    // 不跟符号链接：wiki 目录外的东西一律不读。
+    if (entry.isSymbolicLink()) continue;
+    const child = rel ? `${rel}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) walk(root, child, out);
+    else if (entry.isFile() && entry.name.endsWith('.md')) out.push(child);
+  }
+}
+
+/** 扫 wiki 目录，出 { nodes, links, groups }。 */
+export function scanWiki(root) {
+  const files = [];
+  walk(root, '', files);
+  const nodes = [];
+  const bodies = [];
+  for (const path of files) {
+    let text;
+    try { text = readFileSync(join(root, path), 'utf8'); } catch { continue; }
+    const { meta, body } = splitFrontmatter(text);
+    const heading = /^#\s+(.+)$/m.exec(body)?.[1]?.trim();
+    const parts = path.split('/');
+    const excerpt = body.split('\n').map(l => l.trim()).filter(l => l && !l.startsWith('#')).slice(0, EXCERPT_LINES).join('\n');
+    nodes.push({
+      id: path,
+      name: meta.name || basename(path, '.md'),
+      title: heading || meta.name || basename(path, '.md'),
+      description: meta.description ?? '',
+      group: parts.length > 1 ? parts[0] : '',
+      cluster: parts.slice(0, -1).join('/'),
+      lines: text.split('\n').length,
+      excerpt,
+    });
+    bodies.push(body);
+  }
+
+  // [[name]] 先按 frontmatter name，再按文件名；README 也能用目录名指到。
+  const byName = new Map();
+  const claim = (key, id) => { if (key && !byName.has(key)) byName.set(key, id); };
+  for (const n of nodes) claim(n.name, n.id);
+  for (const n of nodes) claim(basename(n.id, '.md'), n.id);
+  for (const n of nodes) if (basename(n.id) === 'README.md' && n.cluster) claim(basename(n.cluster), n.id);
+  const ids = new Set(nodes.map(n => n.id));
+
+  const seen = new Set();
+  const links = [];
+  const add = (source, target) => {
+    if (!target || source === target) return;
+    const key = source < target ? `${source}\n${target}` : `${target}\n${source}`;
+    if (seen.has(key)) return;
+    seen.add(key);
+    links.push({ source, target });
+  };
+  nodes.forEach((n, i) => {
+    for (const m of bodies[i].matchAll(WIKI_LINK)) add(n.id, byName.get(m[1].split(/[|#]/)[0].trim()));
+    for (const m of bodies[i].matchAll(MD_LINK)) {
+      if (/^[a-z]+:/i.test(m[1])) continue;
+      let target;
+      try { target = posix.normalize(posix.join(posix.dirname(n.id), decodeURI(m[1]))); } catch { continue; }
+      if (ids.has(target)) add(n.id, target);
+    }
+  });
+
+  const groups = {};
+  for (const n of nodes) groups[n.group] = (groups[n.group] ?? 0) + 1;
+  return { nodes, links, groups };
+}
+
+export function wikiGalaxyPage() {
+  return readFileSync(new URL('./wiki-galaxy/index.html', import.meta.url), 'utf8');
+}
+
+function send(res, status, type, body) {
+  res.writeHead(status, { 'content-type': type, 'cache-control': 'no-store' });
+  res.end(body);
+}
+
+/** /collab/wiki-galaxy 与 /collab/api/wiki-galaxy；返回 true 表示已处理，未匹配返回 undefined。 */
+export function wikiGalaxyRoute(req, res, url, { wikiDir }) {
+  const path = url.pathname.replace(/\/+$/, '');
+  if (path !== '/collab/wiki-galaxy' && path !== '/collab/api/wiki-galaxy') return undefined;
+  if (req.method !== 'GET') return undefined;
+  if (path === '/collab/wiki-galaxy') {
+    send(res, 200, HTML, wikiGalaxyPage()); // SPEC：HTTP 状态码，沿用 desk.mjs deskRoute
+    return true;
+  }
+  let graph;
+  try { graph = scanWiki(wikiDir); } catch {
+    send(res, 500, JSON_TYPE, JSON.stringify({ error: 'wiki scan failed' })); // SPEC：HTTP 状态码，沿用 desk.mjs deskRoute
+    return true;
+  }
+  const name = wikiDir.split(sep).filter(Boolean).pop() ?? 'wiki';
+  send(res, 200, JSON_TYPE, JSON.stringify({ name, ...graph })); // SPEC：HTTP 状态码，沿用 desk.mjs deskRoute
+  return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bothouse-dsh",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "description": "BotHouse channels for DeepSeek Harness: Discord-style rooms where DSH models and local CLIs (Claude Code, Codex, Gemini) are members",
   "type": "module",
   "main": "./collab/plugin.mjs",
@@ -25,6 +25,9 @@
   "files": [
     "collab/*.mjs",
     "collab/page.html",
+    "collab/*.json",
+    "collab/team-mode-rules.md",
+    "collab/desk/index.html",
     "collab/avatars/*.png",
     "client/client.js",
     "cordis.patch.yml",
@@ -59,7 +62,8 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "1.4.0",
-    "@zed-industries/claude-code-acp": "^0.16.2"
+    "@zed-industries/claude-code-acp": "^0.16.2",
+    "ws": "8.22.1"
   },
   "optionalDependencies": {
     "@agentclientprotocol/codex-acp": "^2.2.2"