nx-kv 0.1.1

package/src/modules/group/view.jsx

@@ -0,0 +1,159 @@
+// 工作空间页：列出、切换、新建、改名、解散。
+// 切换只改本机配置，不动服务端任何数据；解散有前置条件（后端要求组内已无 KV）。
+import { useCallback, useEffect, useState } from 'react';
+import { api } from '../../web/frontend/api/client.js';
+import { useStore } from '../../web/frontend/store.jsx';
+import { useToast, useGuard, useDialog, Copyable, Modal } from '../../web/frontend/components/ui.jsx';
+import { CliHints } from '../../web/frontend/components/CliHints.jsx';
+
+export default function GroupView() {
+  const { boot, refreshBoot } = useStore();
+  const toast = useToast();
+  const guard = useGuard();
+  const { dialog, node: dialogNode } = useDialog();
+  const [groups, setGroups] = useState([]);
+  const [err, setErr] = useState('');
+  const [form, setForm] = useState({ name: '', description: '' });
+  const [modal, setModal] = useState(null);
+
+  const load = useCallback(async () => {
+    if (!boot?.loggedIn) return;
+    try {
+      const d = await api('/api/groups');
+      setGroups(d.groups || []);
+      setErr('');
+    } catch (e) {
+      setErr(e.message);
+    }
+  }, [boot?.loggedIn]);
+
+  useEffect(() => { load(); }, [load]);
+
+  const use = (locator) => guard(async () => {
+    const g = await api('/api/group', { method: 'POST', body: { locator } });
+    toast(g.id === 0 ? '已切回默认组' : `已切换到 ${g.name}`);
+    await refreshBoot();
+    await load();
+  });
+
+  const create = () => guard(async () => {
+    const name = form.name.trim();
+    if (!name) { toast('请填名称'); return; }
+    const g = await api('/api/groups', {
+      method: 'POST',
+      body: { name, description: form.description.trim() },
+    });
+    setForm({ name: '', description: '' });
+    toast(`已新建工作空间 ${g.name}（id=${g.id}）`);
+    await refreshBoot();
+    await load();
+  });
+
+  const rename = (g) => guard(async () => {
+    const name = await dialog({ title: `重命名「${g.name}」`, input: true, value: g.name });
+    if (name === null || !name.trim()) return;
+    await api(`/api/groups/${g.id}`, { method: 'PATCH', body: { name: name.trim() } });
+    toast('已更新名称');
+    await refreshBoot();
+    await load();
+  });
+
+  const remove = (g) => guard(async () => {
+    const ok = await dialog({
+      message: `解散工作空间「${g.name}」（id=${g.id}）？\n\n后端要求组内已无 KV 数据，否则会拒绝。此操作不可撤销。`,
+      danger: true,
+    });
+    if (!ok) return;
+    await api(`/api/groups/${g.id}`, { method: 'DELETE' });
+    toast(`已解散 ${g.name}`);
+    await refreshBoot();
+    await load();
+  });
+
+  const members = (g) => guard(async () => {
+    const d = await api(`/api/groups/${g.id}/members`);
+    setModal({
+      title: `成员 · ${g.name}`,
+      node: (
+        <div className="list">
+          {d.members.length
+            ? d.members.map((m) => (
+                <div className="row" key={m.userId}>
+                  <Copyable className="name" text={m.email} title="点击复制邮箱">{m.email}</Copyable>
+                  <span className="tag">{m.role || 'member'}</span>
+                  <span className="muted">{m.nickname}</span>
+                </div>
+              ))
+            : <div className="row muted">（没有成员）</div>}
+        </div>
+      ),
+    });
+  });
+
+  if (!boot?.loggedIn) {
+    return (
+      <div className="card" style={{ padding: 16 }}>
+        <div className="colhead"><h3>请先登录</h3></div>
+        <div className="muted">工作空间需要登录后才能列出。</div>
+      </div>
+    );
+  }
+
+  return (
+    <>
+      <div className="toolbar">
+        <input placeholder="新工作空间名称" size="16" value={form.name}
+          onChange={(e) => setForm({ ...form, name: e.target.value })}
+          onKeyDown={(e) => { if (e.key === 'Enter') create(); }} />
+        <input placeholder="描述（可选）" size="20" value={form.description}
+          onChange={(e) => setForm({ ...form, description: e.target.value })} />
+        <button className="btn" onClick={create}>新建</button>
+        <span className="sep"></span>
+        <button className="btn ghost" onClick={() => guard(load)}>刷新</button>
+      </div>
+
+      <div className="card">
+        <div className="colhead">
+          <h3>我的工作空间</h3>
+          <span className="muted">切换后清单页立即跟着变</span>
+        </div>
+        <div className="list">
+          {err ? <div className="row muted">{err}</div> : null}
+
+          <div className="row">
+            <span className="name">默认组</span>
+            <span className="desc">不传 groupId，由后端回落</span>
+            <span className="acts">
+              {boot.groupId === 0
+                ? <span className="tag strong">当前</span>
+                : <button className="btn small" onClick={() => use('default')}>切到这里</button>}
+            </span>
+          </div>
+
+          {groups.map((g) => (
+            <div className="row" key={g.id}>
+              <Copyable className="name" text={g.name} title="点击复制名称">{g.name}</Copyable>
+              <span className="tag">{g.myRole || 'member'}</span>
+              <span className="desc">{g.description || ''}</span>
+              <span className="muted mono">id={g.id}</span>
+              <span className="muted">{g.memberCount} 人</span>
+              <span className="acts">
+                {g.id === boot.groupId
+                  ? <span className="tag strong">当前</span>
+                  : <button className="btn small" onClick={() => use(String(g.id))}>切到这里</button>}
+                <button className="btn small ghost" onClick={() => members(g)}>成员</button>
+                <button className="btn small ghost" onClick={() => rename(g)}>改名</button>
+                <button className="btn small ghost danger" onClick={() => remove(g)}>解散</button>
+              </span>
+            </div>
+          ))}
+          {!err && !groups.length ? <div className="row muted">（没有其他工作空间）</div> : null}
+        </div>
+      </div>
+
+      <CliHints module="group" />
+      {modal ? <Modal title={modal.title} onClose={() => setModal(null)}>{modal.node}</Modal> : null}
+      {dialogNode}
+    </>
+  );
+}

package/src/modules/system/index.js

@@ -0,0 +1,153 @@
+// 系统模块：聚合与自检。没有业务状态，也没有面板视图。
+//
+// 分层例外：本模块是刻意的聚合器，允许 import 其他模块的 service。
+import { readFileSync } from 'node:fs';
+import { configPathFromEnv, loadConfig } from '../../core/config.js';
+import { badInput, notFound } from '../../core/errors.js';
+import { listGroups } from '../../core/kvapi.js';
+import { DEFAULT_PORT } from '../../core/paths.js';
+
+const VERSION = JSON.parse(
+  readFileSync(new URL('../../../package.json', import.meta.url), 'utf8')
+).version;
+
+// 命令表：CLI 命令 ↔ HTTP 路由的对照。
+// 动态 import：runtime/registry 静态依赖本模块，静态引入会成环；
+// 而该函数只在启动完成后调用，届时 cli.js 早已求值完毕。
+async function commandTable() {
+  const { ALL_COMMANDS, commandEntry } = await import('../../runtime/cli.js');
+  return ALL_COMMANDS.map(commandEntry);
+}
+
+// 面板启动上下文。groups 失败不致命——未登录时面板仍应能打开并提示去登录，
+// 所以这里降级成空数组而不抛。
+async function bootstrap() {
+  const cfg = await loadConfig();
+  let groups = [];
+  let groupsError = '';
+  if (cfg.token) {
+    try {
+      groups = await listGroups();
+    } catch (e) {
+      groupsError = String(e.message || e);
+    }
+  }
+  return {
+    version: VERSION,
+    configPath: configPathFromEnv(),
+    baseUrl: cfg.baseUrl,
+    loggedIn: !!cfg.token,
+    email: cfg.email,
+    userId: cfg.userId,
+    groupId: cfg.groupId,
+    groups,
+    groupsError,
+    defaultPort: DEFAULT_PORT,
+    commands: await commandTable(),
+  };
+}
+
+export default {
+  id: 'system',
+  title: '系统',
+  order: 0,
+  view: null,
+
+  actions: [
+    {
+      id: 'system.bootstrap',
+      cli: ['bootstrap'],
+      http: ['GET', '/api/bootstrap'],
+      summary: '聚合上下文：版本 / 登录态 / 工作空间 / 命令表',
+      run: bootstrap,
+    },
+    {
+      id: 'system.health',
+      cli: ['health'],
+      http: ['GET', '/api/health'],
+      summary: '健康检查（本机配置 + 后端可达性）',
+      run: async () => {
+        const cfg = await loadConfig();
+        let backend = 'unreachable';
+        let backendError = '';
+        try {
+          const res = await fetch(cfg.baseUrl.replace(/\/$/, '') + '/api/v1/user/info', {
+            headers: cfg.token ? { authorization: `Bearer ${cfg.token}` } : {},
+            signal: AbortSignal.timeout(6000),
+          });
+          backend = res.ok ? 'reachable' : `http ${res.status}`;
+        } catch (e) {
+          backendError = String(e.message || e);
+        }
+        return {
+          status: 'ok',
+          version: VERSION,
+          baseUrl: cfg.baseUrl,
+          configPath: configPathFromEnv(),
+          loggedIn: !!cfg.token,
+          backend,
+          backendError,
+        };
+      },
+    },
+    {
+      id: 'system.routes',
+      cli: ['routes'],
+      http: null,
+      summary: '命令 ↔ 路由对照表（--module 过滤；--http 反查命令）',
+      flags: {
+        module: { type: 'string', hint: '模块名' },
+        http: { type: 'string', hint: 'METHOD /api/path' },
+      },
+      run: async (ctx) => {
+        const table = await commandTable();
+        if (ctx.http) {
+          const { method, path } = parseHttpQuery(ctx.http);
+          const hit = table.filter(
+            (c) => c.http && (!method || c.http.method === method) && routeMatches(c.http.path, path)
+          );
+          if (!hit.length) throw notFound(`没有路由匹配: ${ctx.http}（用 nx-kv routes 查看全部对照）`);
+          return hit;
+        }
+        if (!ctx.module) return table;
+
+        const known = [...new Set(table.map((c) => c.module))];
+        if (!known.includes(ctx.module)) {
+          throw badInput(`未知模块: ${ctx.module}（可用: ${known.join(', ')}）`);
+        }
+        return table.filter((c) => c.module === ctx.module);
+      },
+      render: (list) => {
+        if (!list.length) return '（无匹配）';
+        const w = Math.max(...list.map((c) => c.command.length));
+        return list
+          .map(
+            (c) =>
+              `${c.command.padEnd(w + 2)}${c.http ? `${c.http.method} ${c.http.path}` : '（仅 CLI，无 HTTP 路由）'}`
+          )
+          .join('\n');
+      },
+    },
+  ],
+};
+
+// ---- 内部小工具 ----
+
+function parseHttpQuery(input) {
+  const s = String(input || '').trim();
+  const m = /^([A-Za-z]+)\s+(.*)$/.exec(s);
+  const method = m ? m[1].toUpperCase() : null;
+  const path = (m ? m[2] : s).split('?')[0];
+  if (!path.startsWith('/')) {
+    throw badInput(`HTTP 查询需形如 "/api/todo" 或 "GET /api/todo"，收到: ${input}`);
+  }
+  return { method, path };
+}
+
+// 段对段比较：`:param` 视为通配
+function routeMatches(pattern, path) {
+  const a = pattern.split('/').filter(Boolean);
+  const b = path.split('/').filter(Boolean);
+  if (a.length !== b.length) return false;
+  return a.every((seg, i) => seg.startsWith(':') || seg === b[i]);
+}

package/src/modules/todo/index.js

@@ -0,0 +1,280 @@
+// 清单模块：四把 key（open / done / freeze / topics）上的任务管理。
+//
+// 声明了 `resource: 'todo'`，因此必须齐备 CRUD 五操作且两端可调用 ——
+// tests/unit/registry.test.mjs 会据此断言。非 CRUD 的动作（完成/冻结/归档/topic/prompt）
+// 用动作动词命名，不受五动词约束，但同样两端可达。
+import * as service from './service.js';
+
+// 所有动作都接受 --group 覆盖当前工作空间；默认取本机配置里的当前值
+const GROUP = { type: 'number', hint: '工作空间 id（默认取当前）' };
+
+// 完成时间显示：只取到分钟，表格里塞不下完整时间戳
+const shortTime = (s) => (s ? String(s).slice(0, 16).replace('T', ' ') : '');
+
+function renderTaskList(d) {
+  const groups = [
+    ['open', '待办'],
+    ['done', '已完成'],
+    ['freeze', '冻结'],
+  ].filter(([k]) => d[k]);
+
+  const lines = [];
+  if (d.topic) lines.push(`topic=${d.topic}`);
+  for (const [key, label] of groups) {
+    const items = d[key];
+    if (!items) continue;
+    if (!items.length) {
+      lines.push(`${label}: （空）`);
+      continue;
+    }
+    lines.push(`${label}（${items.length}）:`);
+    const w = Math.max(...items.map((t) => String(t.id).length));
+    for (const t of items) {
+      const mark = key === 'done' ? `✓ ${shortTime(t.doneAt)}` : key === 'freeze' ? `❄ ${shortTime(t.frozenAt)}` : '';
+      lines.push(`  ${String(t.id).padStart(w)}  [${t.topic}] ${t.text}${mark ? '  ' + mark : ''}`);
+      if (t.note) lines.push(`  ${' '.repeat(w)}    note: ${t.note.slice(0, 100)}`);
+    }
+  }
+  return lines.join('\n');
+}
+
+const renderTask = (t) =>
+  [
+    `#${t.id}  [${t.topic}]  ${t.text}`,
+    `  状态:   ${t.doneAt ? '已完成' : t.frozenAt ? '冻结' : '待办'}${t.bucket ? `（在 ${t.bucket}）` : ''}`,
+    `  创建:   ${t.createdAt}`,
+    t.doneAt ? `  完成:   ${t.doneAt}` : '',
+    t.frozenAt ? `  冻结:   ${t.frozenAt}` : '',
+    t.note ? `  备注:   ${t.note}` : '',
+  ]
+    .filter(Boolean)
+    .join('\n');
+
+export default {
+  id: 'todo',
+  title: '清单（= Web「清单」页）',
+  order: 30,
+  view: () => import('./view.jsx'),
+
+  // CRUD 资源声明：任务的增删查改必须齐备，且 CLI 与面板都能调用
+  resource: 'todo',
+
+  actions: [
+    // ─── CRUD 五操作 ───────────────────────────────────────────
+    {
+      id: 'todo.list',
+      cli: ['todo', 'list'],
+      http: ['GET', '/api/todo'],
+      summary: '列出任务（--topic / --status 过滤；默认三个桶全列）',
+      flags: {
+        topic: { type: 'string', hint: '只看某个主题' },
+        status: { type: 'string', enum: ['open', 'done', 'freeze', 'all'], default: 'all' },
+        group: GROUP,
+      },
+      run: (ctx) => service.listTodos({ topic: ctx.topic, status: ctx.status, groupId: ctx.group }),
+      render: renderTaskList,
+    },
+    {
+      id: 'todo.get',
+      cli: ['todo', 'get'],
+      http: ['GET', '/api/todo/:id'],
+      summary: '查看单个任务（自动在待办/已完成/冻结里找）',
+      args: ['id'],
+      flags: {
+        topic: { type: 'string', hint: '消歧：同 id 有多条时用主题定位' },
+        pick: { type: 'number', hint: '消歧：同 id 多条时按编号选（配合报错里的列表）' },
+        group: GROUP,
+      },
+      run: (ctx) => service.getTodo(Number(ctx.id), { topic: ctx.topic, pick: ctx.pick, groupId: ctx.group }),
+      render: renderTask,
+    },
+    {
+      id: 'todo.add',
+      cli: ['todo', 'add'],
+      http: ['POST', '/api/todo'],
+      summary: '新增任务到待办（topic 不在快捷列表时自动补上）',
+      args: ['text'],
+      flags: { topic: { type: 'string', required: true, hint: '主题，路由维度' }, group: GROUP },
+      run: (ctx) => service.addTodo({ topic: ctx.topic, text: ctx.text, groupId: ctx.group }),
+      render: (d) =>
+        `已加入待办: #${d.id} [${d.task.topic}] ${d.task.text}` +
+        (d.topicAdded ? `\n（已把 ${d.task.topic} 加入快捷 topic）` : ''),
+    },
+    {
+      id: 'todo.update',
+      cli: ['todo', 'update'],
+      http: ['PATCH', '/api/todo/:id'],
+      summary: '编辑任务（只改传入的字段）',
+      args: ['id'],
+      flags: {
+        topic: { type: 'string', hint: '改成这个主题' },
+        text: { type: 'string' },
+        note: { type: 'string' },
+        matchTopic: { type: 'string', hint: '消歧：同 id 有多条时用主题定位' },
+        pick: { type: 'number', hint: '消歧：同 id 多条时按编号选（配合报错里的列表）' },
+        group: GROUP,
+      },
+      run: (ctx) =>
+        service.updateTodo(Number(ctx.id), {
+          topic: ctx.topic,
+          text: ctx.text,
+          note: ctx.note,
+          matchTopic: ctx.matchTopic,
+          pick: ctx.pick,
+          groupId: ctx.group,
+        }),
+      render: (d) => `已更新 #${d.task.id}（在 ${d.bucket}）`,
+    },
+    {
+      id: 'todo.remove',
+      cli: ['todo', 'remove'],
+      http: ['DELETE', '/api/todo/:id'],
+      summary: '删除任务（只删命中的那一条）',
+      args: ['id'],
+      flags: {
+        topic: { type: 'string', hint: '消歧：同 id 有多条时用主题定位' },
+        pick: { type: 'number', hint: '消歧：同 id 多条时按编号选（配合报错里的列表）' },
+        group: GROUP,
+      },
+      run: (ctx) => service.removeTodo(Number(ctx.id), { topic: ctx.topic, pick: ctx.pick, groupId: ctx.group }),
+      render: (d) => `已删除 #${d.removed.id} [${d.removed.topic}] ${d.removed.text}`,
+    },
+
+    // ─── 状态流转 ──────────────────────────────────────────────
+    {
+      id: 'todo.done',
+      cli: ['todo', 'done'],
+      http: ['POST', '/api/todo/:id/done'],
+      summary: '标记完成（--result 写进 note 作为完成结果）',
+      args: ['id'],
+      flags: {
+        result: { type: 'string', hint: '完成结果摘要' },
+        topic: { type: 'string', hint: '消歧：同 id 有多条时用主题定位' },
+        pick: { type: 'number', hint: '消歧：同 id 多条时按编号选（配合报错里的列表）' },
+        group: GROUP,
+      },
+      run: (ctx) =>
+        service.doneTodo(Number(ctx.id), { result: ctx.result, topic: ctx.topic, pick: ctx.pick, groupId: ctx.group }),
+      render: (d) => `已完成 #${d.task.id} [${d.task.topic}] ${d.task.text}\n  ${d.task.doneAt}`,
+    },
+    {
+      id: 'todo.freeze',
+      cli: ['todo', 'freeze'],
+      http: ['POST', '/api/todo/:id/freeze'],
+      summary: '冻结任务（id 保留，解冻时校验冲突）',
+      args: ['id'],
+      flags: {
+        topic: { type: 'string', hint: '消歧：同 id 有多条时用主题定位' },
+        pick: { type: 'number', hint: '消歧：同 id 多条时按编号选（配合报错里的列表）' },
+        group: GROUP,
+      },
+      run: (ctx) => service.freezeTodo(Number(ctx.id), { topic: ctx.topic, pick: ctx.pick, groupId: ctx.group }),
+      render: (d) => `已冻结 #${d.task.id} [${d.task.topic}] ${d.task.text}`,
+    },
+    {
+      id: 'todo.unfreeze',
+      cli: ['todo', 'unfreeze'],
+      http: ['POST', '/api/todo/:id/unfreeze'],
+      summary: '解冻回待办（id 撞车时自动换新 id）',
+      args: ['id'],
+      flags: {
+        topic: { type: 'string', hint: '消歧：同 id 有多条时用主题定位' },
+        pick: { type: 'number', hint: '消歧：同 id 多条时按编号选（配合报错里的列表）' },
+        group: GROUP,
+      },
+      run: (ctx) => service.unfreezeTodo(Number(ctx.id), { topic: ctx.topic, pick: ctx.pick, groupId: ctx.group }),
+      render: (d) =>
+        `已解冻 #${d.task.id} [${d.task.topic}] ${d.task.text}` +
+        (d.reIded ? '\n（原 id 与现有待办冲突，已分配新 id）' : ''),
+    },
+    {
+      id: 'todo.archive',
+      cli: ['todo', 'archive'],
+      http: ['POST', '/api/todo/archive'],
+      summary: '把已完成里较旧的条目归档到冷 key（默认 30 天前）',
+      flags: {
+        before: { type: 'string', hint: '截止日期，如 2026-08-01' },
+        group: GROUP,
+      },
+      run: (ctx) => service.archiveDone({ before: ctx.before, groupId: ctx.group }),
+      render: (d) =>
+        d.moved
+          ? `已归档 ${d.moved} 条 -> ${d.coldKey}（已完成剩 ${d.remaining} 条，冷 key 共 ${d.total} 条）`
+          : '没有需要归档的条目',
+    },
+
+    // ─── 快捷 topic（动作集合，非 CRUD）───────────────────────
+    {
+      id: 'topic.list',
+      cli: ['topic', 'list'],
+      http: ['GET', '/api/topics'],
+      summary: '快捷主题列表（含各状态任务数）',
+      flags: { group: GROUP },
+      run: (ctx) => service.listTopics({ groupId: ctx.group }),
+      render: (list) => {
+        if (!list.length) return '（暂无快捷主题）';
+        const w = Math.max(...list.map((t) => t.name.length));
+        return list
+          .map((t) => `${t.name.padEnd(w)}  待办 ${t.open}  完成 ${t.done}  冻结 ${t.freeze}`)
+          .join('\n');
+      },
+    },
+    {
+      id: 'topic.add',
+      cli: ['topic', 'add'],
+      http: ['POST', '/api/topics'],
+      summary: '加入快捷主题',
+      args: ['name'],
+      flags: { group: GROUP },
+      run: (ctx) => service.addTopic(ctx.name, { groupId: ctx.group }),
+      render: (d) => (d.added ? `已加入快捷主题: ${d.name}` : `${d.name} 已在快捷列表中`),
+    },
+    {
+      id: 'topic.remove',
+      cli: ['topic', 'remove'],
+      http: ['DELETE', '/api/topics'],
+      summary: '移出快捷主题（不动已有任务；仍被任务使用时会在结果里提示）',
+      args: ['name'],
+      flags: { group: GROUP },
+      run: (ctx) => service.removeTopic(ctx.name, { groupId: ctx.group }),
+      render: (d) => {
+        if (!d.removed) return `${d.name} 本就不在快捷列表中`;
+        return d.inUse
+          ? `已移出快捷主题: ${d.name}\n注意: 仍有 ${d.inUse} 条任务在用它，主题名不会消失，只是不再出现在候选里`
+          : `已移出快捷主题: ${d.name}`;
+      },
+    },
+
+    // ─── 主题提示词（给 agent 的上下文）───────────────────────
+    {
+      id: 'prompt.get',
+      cli: ['prompt', 'get'],
+      http: ['GET', '/api/prompts/:topic'],
+      summary: '读取某主题的上下文提示词',
+      args: ['topic'],
+      flags: { group: GROUP },
+      run: (ctx) => service.getPrompt(ctx.topic, { groupId: ctx.group }),
+      render: (d) => (d.hasPrompt ? d.prompt : `（${d.topic} 没有配置提示词）`),
+    },
+    {
+      id: 'prompt.set',
+      cli: ['prompt', 'set'],
+      http: ['POST', '/api/prompts/:topic'],
+      summary: '写入某主题的上下文提示词（覆盖）',
+      args: ['topic', 'text'],
+      flags: { group: GROUP },
+      run: (ctx) => service.setPrompt(ctx.topic, ctx.text, { groupId: ctx.group }),
+      render: (d) => `已写入 ${d.topic} 的提示词（${d.bytes} 字节）`,
+    },
+    {
+      id: 'prompt.remove',
+      cli: ['prompt', 'remove'],
+      http: ['DELETE', '/api/prompts/:topic'],
+      summary: '删除某主题的提示词',
+      args: ['topic'],
+      flags: { group: GROUP },
+      run: (ctx) => service.removePrompt(ctx.topic, { groupId: ctx.group }),
+      render: (d) => (d.removed ? `已删除 ${d.topic} 的提示词` : `${d.topic} 本就没有提示词`),
+    },
+  ],
+};