@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/api/projects.js

@@ -1,220 +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;
+/**
+ * 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

@@ -1,64 +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;
+/**
+ * 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;