@xiaobuyu/nodesign 0.0.1

package/server/api/projects.js

@@ -0,0 +1,220 @@
+/**
+ * server/api/projects.js — Project CRUD
+ *
+ * GET    /api/projects              列项目（按 updated_at 倒序）
+ * POST   /api/projects              { name, skillId?, description? } → 创建 + ensureProjectWorkspace
+ * GET    /api/projects/:pid         单项目
+ * PATCH  /api/projects/:pid         { name?, skillId?, description? } 部分更新
+ * DELETE /api/projects/:pid         删项目 + workspace + 关联 runs
+ *
+ * description: 可选，<= 2000 字符。仅 NoDesign 后端/前端 UI 用，agent 不感知
+ * （agent 看的是项目级 instruction = workspace/.claude/CLAUDE.md）。
+ */
+
+import express from 'express';
+import {
+  listProjects, createProject, updateProject, deleteProject,
+  listRunsForProject,
+} from '../projects/store.js';
+import { guardProject } from './_guard.js';
+import { taskManifest } from '../lib/artifact-target.js';
+import { countPublishedByUser } from '../lib/publish-store.js';
+import { checkQuota } from '../lib/quota.js';
+import { ensureProjectWorkspace, removeProjectWorkspace, getSharedDir, validateSessionId } from '../projects/workspace.js';
+import { removeEntriesForProject } from '../lib/showcase-store.js';
+import { disposeProjectBus, getProjectBus } from '../ws/broker.js';
+import { Events } from '../engine/agent/events.js';
+
+const router = express.Router();
+
+/**
+ * 列表的归属口径：一律只列自己的。
+ *
+ * 2026-08-03 收窄：原本 admin 拿的是全库，于是「我的项目」首页把所有内测用户的
+ * 项目名铺在一起（16 张卡里只有 7 张是自己的）。admin 要看全站有 /admin；
+ * 要打开别人的项目 guardProject 仍然放行 —— 越权能力没变，变的是首页的口径：
+ * 「我的项目」就是我的。
+ */
+const ownerScope = (req) => req.user?.id ?? null;
+
+const KIND_VALUES = new Set(['project', 'quick']);
+const KIND_QUERY_VALUES = new Set(['project', 'quick', 'all']);
+
+// GET /api/projects 默认行为（2026-05-07）：不带 ?kind= 时 **只返 kind='project'**，
+// 把闪聊（kind='quick'）从主项目列表里挡掉 —— 避免老 client / 任何漏传 kind 的调用
+// 把闪聊泄漏到「我的项目」UI。要拿全集显式传 ?kind=all。kind=quick 仍可单独筛。
+router.get('/', (req, res, next) => {
+  try {
+    const raw = typeof req.query.kind === 'string' ? req.query.kind : undefined;
+    if (raw && !KIND_QUERY_VALUES.has(raw)) {
+      return res.status(400).json({ error: `kind must be project|quick|all (got ${raw})` });
+    }
+    const effectiveKind = raw === 'all' ? undefined : (raw || 'project');
+    res.json({ projects: listProjects({ kind: effectiveKind, owner: ownerScope(req) }) });
+  } catch (err) { next(err); }
+});
+
+/**
+ * GET /api/projects/stats —— 首页卡片那行元信息（这个项目里躺着什么）
+ *
+ * 卡片上原来印的是 skill_id，全站同一个值 'deskskill-engine-mini'，等于一行噪声。
+ * 真正配占那一行的是「这里出了几件东西、都是什么形态」，而这个事实不在库里，
+ * 在 workspace 的 tasks/ 目录里。所以单开一条而不是并进列表接口：列项目不能
+ * 因为要读一圈磁盘而变慢，前端拿到列表先把卡画出来，这条回来了再补那行字。
+ *
+ * kind=null 的任务是开了头还没写出产物的，计入 tasks 但不计入 kinds。
+ *
+ * summary 是首页写在板子上那几笔账（已上线几件、今天花了多少）。搭这趟车而不是
+ * 单开端点：首页为了这四行字已经要发一次请求了，没必要发第三次。两个数都是
+ * 单条 SQL，不额外读盘。
+ *
+ * 注意：必须注册在 '/:pid' 之前，否则 'stats' 会被当成项目 id。
+ */
+router.get('/stats', async (req, res, next) => {
+  try {
+    const projects = listProjects({ kind: 'project', owner: ownerScope(req) });
+    const stats = {};
+    await Promise.all(projects.map(async (p) => {
+      // 首页卡上的"有几件东西"。扁平化前数的是任务数（每项目恒为 1，
+      // 所以那张卡上永远写着 1），现在数**产物**——一个项目里并排的 deck /
+      // 目录型产物各算一件，这才是用户眼里的"这个项目里有什么"。
+      let artifacts = [];
+      try {
+        artifacts = (await taskManifest(getSharedDir(p.id)))?.artifacts || [];
+      } catch { /* 目录没了：算 0 件 */ }
+      const kinds = {};
+      for (const a of artifacts) if (a.kind) kinds[a.kind] = (kinds[a.kind] || 0) + 1;
+      stats[p.id] = { tasks: artifacts.length, kinds };
+    }));
+    // dev 模式（不要求登录）没有 req.user，这两笔账就没有主语，整块不下发
+    const summary = req.user
+      ? {
+        published: countPublishedByUser(req.user.id),
+        usedToday: checkQuota(req.user).usedToday,
+      }
+      : null;
+    res.json({ stats, summary });
+  } catch (err) { next(err); }
+});
+
+const DESCRIPTION_MAX = 2000;
+
+router.post('/', async (req, res, next) => {
+  try {
+    const { name, skillId, description, kind, autoNamed } = req.body || {};
+    if (!name || typeof name !== 'string' || !name.trim()) {
+      return res.status(400).json({ error: 'name required' });
+    }
+    if (description != null && typeof description !== 'string') {
+      return res.status(400).json({ error: 'description must be string' });
+    }
+    if (typeof description === 'string' && description.length > DESCRIPTION_MAX) {
+      return res.status(400).json({ error: `description too long (max ${DESCRIPTION_MAX})` });
+    }
+    if (kind != null && !KIND_VALUES.has(kind)) {
+      return res.status(400).json({ error: `kind must be project|quick (got ${kind})` });
+    }
+    const project = createProject({
+      name, skillId, description, kind, autoNamed: !!autoNamed,
+      ownerId: req.user?.id ?? null,
+    });
+    await ensureProjectWorkspace(project.id);
+    res.status(201).json({ project });
+  } catch (err) { next(err); }
+});
+
+router.get('/:pid', (req, res, next) => {
+  try {
+    const project = guardProject(req, res);
+    if (!project) return;
+    res.json({ project });
+  } catch (err) { next(err); }
+});
+
+router.patch('/:pid', (req, res, next) => {
+  try {
+    const project = guardProject(req, res);
+    if (!project) return;
+    const patch = {};
+    if (typeof req.body?.name === 'string') patch.name = req.body.name.trim();
+    if (typeof req.body?.skillId === 'string') patch.skillId = req.body.skillId;
+    if ('description' in (req.body || {})) {
+      const d = req.body.description;
+      if (d != null && typeof d !== 'string') {
+        return res.status(400).json({ error: 'description must be string' });
+      }
+      if (typeof d === 'string' && d.length > DESCRIPTION_MAX) {
+        return res.status(400).json({ error: `description too long (max ${DESCRIPTION_MAX})` });
+      }
+      patch.description = (typeof d === 'string' && d.trim()) ? d.trim() : null;
+    }
+    if ('kind' in (req.body || {})) {
+      if (!KIND_VALUES.has(req.body.kind)) {
+        return res.status(400).json({ error: `kind must be project|quick (got ${req.body.kind})` });
+      }
+      patch.kind = req.body.kind;
+    }
+    // E1a（2026-08-13）：会话真相源收敛到 projects.active_session_id 之后，
+    // 前端切会话得能直接写这个指针（此前唯一的写入方是 turn.js —— 不发消息、
+    // 只是切着看，指针就不动，别的标签页也就永远对不齐）。接受 null（清空）
+    // 或合法 sid 形状；不校验会话是否真实存在 —— 跟 turn.js 对 body.sessionId
+    // 的信任口径一致（指错了顶多下次 turn 起新会话）。
+    if ('active_session_id' in (req.body || {}) || 'activeSessionId' in (req.body || {})) {
+      const v = req.body.active_session_id ?? req.body.activeSessionId ?? null;
+      if (v !== null) {
+        try { validateSessionId(v); } catch (err) {
+          return res.status(400).json({ error: err.message || 'invalid active_session_id' });
+        }
+      }
+      patch.activeSessionId = v;
+    }
+    const updated = updateProject(req.params.pid, patch);
+    // 指针**实际变化**才广播（project 是 guardProject 读的更新前快照）。
+    // 为什么这条事件不带 sessionId 字段：见 events.js projectActiveSession 注释。
+    if ('activeSessionId' in patch && patch.activeSessionId !== project.activeSessionId) {
+      try {
+        getProjectBus(req.params.pid).publish({
+          ...Events.projectActiveSession(patch.activeSessionId),
+          ts: new Date().toISOString(),
+        });
+      } catch (err) {
+        console.warn(`[projects] active_session broadcast failed: ${err.message}`);
+      }
+    }
+    res.json({ project: updated });
+  } catch (err) { next(err); }
+});
+
+router.delete('/:pid', async (req, res, next) => {
+  try {
+    const project = guardProject(req, res);
+    if (!project) return;
+
+    // 常驻浏览器要先关：它的 profile 就在这个工作区里（`.browser/`），不关的话
+    // chromium 攥着一个已被 rm 的 user-data-dir，而只有 2 个的常驻名额被一个
+    // 已删项目占着，直到 5 分钟空闲计时器到点。（动态 import：别把 playwright
+    // 那一层拖进这个路由文件的启动图。）
+    try {
+      const { closeFor } = await import('../engine/browse/registry.js');
+      await closeFor(req.params.pid, 'project deleted');
+    } catch { /* 没起过浏览器不该挡住删项目 */ }
+    // 级联：先清 workspace 文件，再删 DB row（DB row 删了找不到，先文件后 DB 顺序保险）
+    try { await removeProjectWorkspace(req.params.pid); } catch (err) {
+      console.warn(`[projects] removeWorkspace failed for ${req.params.pid}:`, err.message);
+    }
+    // 关联 runs：标记为 cancelled? 或直接 delete? MVP 直接 delete 关联 runs 行
+    const runs = listRunsForProject(req.params.pid);
+    if (runs.length) {
+      const { default: db } = await import('../engine/runs/store.js');
+      const stmt = db.prepare('DELETE FROM runs WHERE id = ?');
+      for (const r of runs) stmt.run(r.id);
+    }
+    // 橱窗卡片指着这个项目的产物，作品没了卡片留着只会点出 404
+    removeEntriesForProject(req.params.pid);
+    deleteProject(req.params.pid);
+    disposeProjectBus(req.params.pid);
+    res.status(204).end();
+  } catch (err) { next(err); }
+});
+
+export default router;

package/server/api/publish.js

@@ -0,0 +1,64 @@
+/**
+ * server/api/publish.js — 站点一键上线的 HTTP 面（2026-08-02）
+ *
+ *   GET    /:pid/publish/:task   → { published, site? }
+ *   POST   /:pid/publish/:task   → 发布/重发布（同步等 deploy 完，前端转圈）
+ *   DELETE /:pid/publish/:task   → 下线
+ *
+ * 核心逻辑（闸门/staging/wrangler/custom domain）在 lib/site-publish.js ——
+ * agent 的 MCP 工具 publish_site 和这里共用同一套。权限：HTTP 面按请求者算
+ * （guardProject 已保证是 owner 或 admin）。
+ */
+
+import express from 'express';
+import { guardProject } from './_guard.js';
+import { publishSite, unpublishSite, validTaskName, lookupPublished } from '../lib/site-publish.js';
+
+const router = express.Router();
+
+// 根站（扁平化后站点住工作区根）的 store key 是 '.'，但 '.' 进不了 URL 路径段：
+// WHATWG URL 规范把单点段（含 %2E）就地归一掉，浏览器发出去就成了 /publish/。
+// 所以路由双注册：无 :task 段 = 根站。
+const taskOf = (req) => (req.params.task ?? '.');
+
+router.get(['/:pid/publish', '/:pid/publish/:task'], async (req, res) => {
+  if (!guardProject(req, res)) return;
+  const task = taskOf(req);
+  if (!validTaskName(task)) return res.status(400).json({ error: 'invalid task' });
+  // lookupPublished 而不是 getPublished：key 已经收敛到站点根，但界面/老链接
+  // 传别名过来时也该认得出，否则会显示"未上线"→ 用户再点一次 → 造出第二个部署
+  const site = await lookupPublished(req.params.pid, task);
+  res.json({ published: !!site, site });
+});
+
+router.post(['/:pid/publish', '/:pid/publish/:task'], async (req, res) => {
+  if (!guardProject(req, res)) return;
+  try {
+    const { site, warning, certReady, root, files, entry } = await publishSite({
+      projectId: req.params.pid, task: taskOf(req),
+      root: typeof req.body?.root === 'string' ? req.body.root : undefined,
+      slug: typeof req.body?.slug === 'string' ? req.body.slug : undefined,
+      user: req.user,
+    });
+    res.json({ site, warning, certReady, root, files, entry });
+  } catch (err) {
+    if (err.status) return res.status(err.status).json({ error: err.message });
+    console.error('[publish] deploy failed:', err.stderr || err.message);
+    res.status(502).json({ error: '发布失败：Cloudflare 部署没成功，稍后再试' });
+  }
+});
+
+router.delete(['/:pid/publish', '/:pid/publish/:task'], async (req, res) => {
+  if (!guardProject(req, res)) return;
+  try {
+    const removed = await unpublishSite({ projectId: req.params.pid, task: taskOf(req) });
+    if (!removed) return res.status(404).json({ error: 'not published' });
+    res.json({ removed: true });
+  } catch (err) {
+    if (err.status) return res.status(err.status).json({ error: err.message });
+    console.error('[publish] delete failed:', err.stderr || err.message);
+    res.status(502).json({ error: '下线失败，稍后再试' });
+  }
+});
+
+export default router;

package/server/api/recent.js

@@ -0,0 +1,73 @@
+/**
+ * server/api/recent.js — 跨项目最近 session 聚合接口
+ *
+ * GET /api/sessions/recent?limit=20&kind=quick
+ *   → { sessions: [{
+ *         projectId, projectName, projectKind,
+ *         sessionId, customTitle, summary, firstPrompt, lastModified, tag
+ *       }] }
+ *
+ * 用途：
+ *   - Home 页「最近闪聊」list（kind=quick 过滤）
+ *   - 未来 Home 全局 session 索引（不过滤）
+ *
+ * 实现：listProjects({ kind? }) → 对每个 project 调 listSessionsForProject →
+ * merge → 按 lastModified desc → slice(limit)。
+ *
+ * 性能：N 个 project × Promise.all 内部并行（readdir + getSessionInfo）。
+ * 当前预期项目规模 < 30，足够；如未来要扩，加 in-memory cache 或维护 view。
+ */
+
+import express from 'express';
+import { listProjects } from '../projects/store.js';
+import { listSessionsForProject } from './sessions.js';
+
+const router = express.Router();
+
+const KIND_VALUES = new Set(['project', 'quick']);
+
+router.get('/sessions/recent', async (req, res, next) => {
+  try {
+    const limit = req.query.limit
+      ? Math.min(Math.max(Number(req.query.limit), 1), 100)
+      : 20;
+    const kind = typeof req.query.kind === 'string' ? req.query.kind : undefined;
+    if (kind && !KIND_VALUES.has(kind)) {
+      return res.status(400).json({ error: `kind must be project|quick (got ${kind})` });
+    }
+
+    // 多用户（2026-07-30）：这是唯一的跨项目聚合口，必须按归属过滤，
+    // 否则别人的会话标题/摘要从这里横向漏出去
+    const owner = req.user?.role === 'admin' ? null : (req.user?.id ?? null);
+    const projects = listProjects({ kind, limit: 200, owner });
+
+    // 并行拿每个 project 的 sessions
+    const perProject = await Promise.all(projects.map(async (p) => {
+      try {
+        const sessions = await listSessionsForProject(p.id);
+        return sessions.map(s => ({
+          projectId: p.id,
+          projectName: p.name,
+          projectKind: p.kind,
+          sessionId: s.sessionId,
+          customTitle: s.customTitle || null,
+          summary: s.summary || null,
+          firstPrompt: s.firstPrompt || null,
+          lastModified: s.lastModified || 0,
+          tag: s.tag || null,
+        }));
+      } catch (err) {
+        console.warn(`[sessions/recent] ${p.id} list failed:`, err.message);
+        return [];
+      }
+    }));
+
+    const merged = perProject.flat()
+      .sort((a, b) => (b.lastModified || 0) - (a.lastModified || 0))
+      .slice(0, limit);
+
+    res.json({ sessions: merged });
+  } catch (err) { next(err); }
+});
+
+export default router;