.task/archive/feature-scratch-session-general-agent.md

@@ -0,0 +1,300 @@
+# feature/scratch-session-general-agent 任务卡
+
+任务主记录：PR #691 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/691；状态：已完成（合入前闭合）；owner：weichen
+
+## 基线与授权
+
+- 权威仓：ssh://git@192.168.3.2:2222/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= a4311c6341c318d4bbf1563b3973358326086794
+- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-scratch-session-general-agent（worktree）；分支：feature/scratch-session-general-agent
+- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
+- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=617539e611dec18b73e0f60c7581ac55246864a96411c38c56fb31dcf561d276；triage_receipt=/tmp/scratch-triage.json；receipt_sha256=1d6484b995d8c51764e91dfeb6ae605e2e3f5ccbf19e07c016f58abe5502d953
+
+- 授权与交付终点：按已批准设计实现无项目对话（scratch）；Backend/Frontend/Dev pin 经 PR 合入；未授权：改写历史、分支保护、发布版本、配额/升级成真项目
+- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
+- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
+- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
+- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
+- 当前阶段：需求拆解；当前增量：I1（待定义）
+- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
+
+## 目标与非目标
+
+- 目标：所有启用账号可创建彼此隔离的 scratch 会话；侧栏「无项目对话」；固有能力不可配置；拒绝知识树/文档树等项目专属能力。
+- 非目标：升级成真项目、协作分享、配额/TTL、nullable project_id。
+- 规格：docs/superpowers/specs/2026-10-22-scratch-session-general-agent-design.md
+- 计划：docs/superpowers/plans/2026-10-22-scratch-session-general-agent-plan.md
+
+## Agent 实施收据
+
+路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
+
+| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
+|---|---|---|---|---|---|---|---|---|---|---|
+| backend-scratch-session-create-u1 | Backend internal/store/{scratch,projects}.go、internal/server/{server,project_lifecycle,scratch_session}.go + tests | Backend AGENT-EXECUTION.md digest 22fcb8ac | implementation | 按配置 | 1（fresh_session） | pi MiniMax-M3 | success | apply 16538f1..096e96e → 规范提交 3b4a7af（tree 不变） | never | /tmp/scratch-session-20261022/u1-run.json |
+| backend-scratch-session-gates-u2 | Backend store/server/runmgr/app 门禁 + tests | 同上 | implementation | 按配置 | 1（fresh_session） | pi MiniMax-M3 | success | apply 3b4a7af..7bd3e51 → 规范提交 613c068（tree 不变） | never | /tmp/scratch-session-20261022/u2-run.json |
+| frontend-scratch-session-sidebar-u3 | Frontend src/{contracts,api,store}.ts、TaskSidebar.tsx、tests | Frontend AGENT-EXECUTION.md | implementation | 按配置 | 1 | cursor | failed-unknown（CLI HTTP/2 keepalive 超时）；对账：仅只读命令与 npm ci 下载、隔离区零跟踪改动 → 全新重派 | 无 | never | /tmp/scratch-session-20261022/u3-run.json |
+| 同上（重派 2） | 同上 | 同上 | implementation | 按配置 | 1 | cursor | failed-unknown（无有效终态记录；worker 报 src/store.test.ts 旧规则测试在范围外）；对账：改动仅在隔离区；扩围 src/store.test.ts（已批准设计内的旧规则测试）→ 单元 u3b | 无 | never | /tmp/scratch-session-20261022/u3-run2.json |
+| frontend-scratch-session-sidebar-u3b | 同上 + src/store.test.ts | 同上 | implementation | 按配置 | 1 | cursor | failed-unknown（CLI Connection stalled，验证已通过、终态前断线）；对账：只读/npm ci/vitest/tsc、/tmp 临时配置已删 → 全新重派 | 无 | never | /tmp/scratch-session-20261022/u3-run3.json |
+| backend-scratch-flag-u2b | Backend server 会话响应 scratch 标记 + store.ScratchProjectIDs + tests | Backend AGENT-EXECUTION.md | implementation | 按配置 | 1（fresh_session） | pi | success | apply → 规范提交 f3f70a7（tree 不变） | never | /tmp/scratch-session-20261022/u2b-run.json |
+| 同上 u3b（重派 4） | 同上 | 同上 | implementation | 按配置 | 1 | cursor | failed-unknown（最终消息含两份有效终态记录：后台 npm ci 完成通知后重复输出）；对账：改动仅在隔离区，外部仅 npm ci 下载 → 单元 u3c 增加“前台执行、仅一份终态记录”约束后全新重派 | 无 | never | /tmp/scratch-session-20261022/u3-run4.json |
+| frontend-scratch-session-sidebar-u3c | 同 u3b | 同上 | implementation | 按配置 | 1（fresh_session） | cursor | success | apply 18fc958..62b7442 → 规范提交 1d7f2a3（tree 不变） | never | /tmp/scratch-session-20261022/u3-run5.json |
+| backend-scratch-context-and-bus-gates-u2c | Backend ProjectContext 门禁 + Bus.SetHostProjectGuard + scratch fail-closed + tests | Backend AGENT-EXECUTION.md | implementation | 按配置 | 1（fresh_session） | pi | success | apply → 规范提交 2fc6e7e（tree 不变） | never | /tmp/scratch-session-20261022/u2c-run.json |
+| backend-scratch-failclosed-both-ways-u2d | Backend confirmedScratchProject 双向 fail-closed + tests | 同上 | implementation | 按配置 | 1（fresh_session） | pi | success | apply → 规范提交 b704ba9（tree 不变） | never | /tmp/scratch-session-20261022/u2d-run.json |
+| frontend-scratch-hide-project-surfaces-u3d | Frontend Conversation/Workbench/ConversationWork 隐藏项目专属面 | Frontend AGENT-EXECUTION.md | implementation | 按配置 | 1 | cursor | scope-expansion（UI ActivityCardView 必须检查 callbacks.onArchive）；人工授权扩围到 UI 仓 | 无 | never | /tmp/scratch-session-20261022/u3d-run.json |
+| frontend-scratch-hide-project-surfaces-u3e | 同 u3d（UI 侧另单元处理；本单元只断言回调） | 同上 | implementation | 按配置 | 1（fresh_session） | cursor | success | apply → 规范提交 b02ff83（tree 不变） | never | /tmp/scratch-session-20261022/u3e-run.json |
+| ui-activity-card-archive-optional-u5 | UI ActivityCardView 仅在有 onArchive 时渲染留档按钮 + tests | UI AGENT-EXECUTION.md | implementation | 按配置 | 1（fresh_session） | cursor | success | apply → 规范提交 db5129c（tree 不变） | never | /tmp/scratch-session-20261022/u5-run.json |
+
+## 关联方向与规划
+
+- 适用状态：待核对（无适用规划时说明原因）
+- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
+- 对应里程碑：待核对
+
+## 需求分析
+
+| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
+|---|---|---|---|---|---|---|
+| R1 | 待填写 | 待评估 | 待定 | 待定义 | 待确认 | 待评审 |
+
+## 方案与计划
+
+- 方案引用：待填写（含对象版本）
+- 实施计划引用：待填写（含增量与需求 ID）
+- 测试计划引用：待填写（含需求 ID 与验收条件）
+
+## 阶段记录
+
+| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
+|---|---|---|---|---|---|
+| 需求拆解 | 待定 | 待执行 | — | — | — |
+| 需求评估 | 待定 | 待执行 | — | — | — |
+| 需求表确认 | 待定 | 待执行 | — | — | — |
+| 方案设计 | 待定 | 待执行 | — | — | — |
+| 实施计划 | 待定 | 待执行 | — | — | — |
+| 实施与自检 | 待定 | 待执行 | — | — | — |
+| 正式测试与验收 | 待定 | 待执行 | — | — | — |
+| 代码 Review | 待定 | 待执行 | — | — | — |
+| 合入 | 待定 | 待执行 | — | — | — |
+| 合入核验与收口 | 待定 | 待执行 | — | — | — |
+
+## 探索试验与迭代
+
+| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
+|---|---|---|---|---|---|---|---|
+| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
+
+## 同步记录
+
+| 节点 | sync_base_sha | tested_head_sha | checked_at |
+|---|---|---|---|
+| 启动 | a4311c6341c318d4bbf1563b3973358326086794 | a4311c6341c318d4bbf1563b3973358326086794 | 2026-10-22T01:43:32Z |
+
+## 证据（Evidence）
+
+<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
+| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
+|---|---|---|---|---|---|
+
+## 交付调度
+
+- 调度状态：未入队；调度记录：无
+- entry_id：无；attempt_id：无；窗口执行者：无
+- 固定候选：无（base/head、组件与相关配置引用实际尝试）
+- 调度依据：policy/delivery.md#合入调度
+- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
+
+## 结果与验证
+
+- 结果：
+- 验证：<结论摘要 PASS/FAIL/SKIP/NOT_RUN 逐项；逐条证据由 make evidence 写入上方证据表>
+- 影响与剩余项：
+
+## 规划进展与下一步
+
+- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划）
+- 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务）
+- 推荐依据：待填写
+- 前置条件/待确认：待核对
+- 预期产物/验收条件：待定义
+- 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
+- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
+
+## 合入与清理
+
+- Review 记录：NOT_RUN（审阅智能体/平台身份、base/head、结论、问题闭合及重放依据）
+- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
+- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
+- 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
+- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
+
+<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
+```json
+{
+  "summary_schema": 1,
+  "source": "SELF",
+  "timestamp": "2026-10-22T01:41:26.489856+00:00",
+  "command": "make precheck",
+  "exit_code": 0,
+  "cwd": "/home/weichen/projects/Agent-System-Dev",
+  "before_head": "a4311c6341c318d4bbf1563b3973358326086794",
+  "after_head": "a4311c6341c318d4bbf1563b3973358326086794",
+  "branch": "main",
+  "target_branch": "main",
+  "target_head": "a4311c6341c318d4bbf1563b3973358326086794",
+  "root_target": "main",
+  "immediate_target": "main",
+  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "output_tail": [
+    "make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
+    "[repo]   branch=main head=a4311c6341",
+    "[remote] origin/main=a4311c6341 ahead=0 behind=0",
+    "[tree]   clean submodules_drift=0 uninit=0",
+    "[worktrees] linked=6",
+    "[recycle] merged un-recycled branches: feature/card-close-20261022-012859Z fix/ci-rdm-pin-materialization fix/pal-component-delivery-pins",
+    "[initiatives] local cards (not authoritative): none",
+    "[hooks]   core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
+    "[facts]   policy/facts.md 6 条事实均在有效期内",
+    "[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
+    "[R0] a4311c6341（完整：a4311c6341c318d4bbf1563b3973358326086794）",
+    "[worktree] before-sync: recursive component checks passed",
+    "[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
+    "make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
+  ],
+  "output_sha256": "5dc418ef2935ca343c4d18b9a8b9408c31d0870061bf48a0cd20d1efeb574159",
+  "receipt_sha256": "59b8a99e07c11121e009221f6700874c9650c4f057f494394d05d5e47eec3f95",
+  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/59b8a99e07c11121e009221f6700874c9650c4f057f494394d05d5e47eec3f95.json"
+}
+```
+| 同步（记录前对象） | 1de7c28c2122609dd9b6435881696492bd052a34 | 635459316dbd4e4a5134f4e409bed72a5dd02730 | 2026-10-22T05:18:42Z |
+
+<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
+```json
+{
+  "summary_schema": 1,
+  "source": "SELF",
+  "timestamp": "2026-10-22T05:18:47.691228+00:00",
+  "command": "make test",
+  "exit_code": 2,
+  "cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-scratch-session-general-agent",
+  "before_head": "36a1d4084e8bb7aaea6f04e29fb4d3492f4f0db3",
+  "after_head": "36a1d4084e8bb7aaea6f04e29fb4d3492f4f0db3",
+  "branch": "feature/scratch-session-general-agent",
+  "target_branch": "main",
+  "target_head": "1de7c28c2122609dd9b6435881696492bd052a34",
+  "root_target": "main",
+  "immediate_target": "main",
+  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "output_tail": [
+    "warn: deps/agent-native deps/development-manager is bd3a7de57a3a, Dev is 2c2e37255807",
+    "ok deps/agent-native error-code-system",
+    "ok deps/agent-native logging-system",
+    "ok deps/agent-squad agent-intent",
+    "ok deps/agent-squad agent-native",
+    "warn: deps/agent-squad deps/development-guidelines is 2688fd2be6a5, Dev is a15db5085585",
+    "warn: deps/agent-squad deps/development-manager is bd3a7de57a3a, Dev is 2c2e37255807",
+    "ok deps/agent-squad error-code-system",
+    "ok deps/agent-squad logging-system",
+    "warn: deps/agent-intent deps/development-guidelines is 2688fd2be6a5, Dev is a15db5085585",
+    "warn: deps/agent-intent deps/development-manager is bd3a7de57a3a, Dev is 2c2e37255807",
+    "ok deps/agent-intent error-code-system",
+    "ok deps/agent-intent logging-system",
+    "make[1]: *** [Makefile:209: test-pins] Error 1",
+    "make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-scratch-session-general-agent'"
+  ],
+  "output_sha256": "2d377eb17fd54185095a73449eb657b742e645e180e1d52202cdd168114fe7e7",
+  "receipt_sha256": "21c7a8c6a8ffc79adb81ed7e90b6c50d4f1aaaa941de12c2a4cd64e8b47e4aa8",
+  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/21c7a8c6a8ffc79adb81ed7e90b6c50d4f1aaaa941de12c2a4cd64e8b47e4aa8.json"
+}
+```
+| 同步（记录前对象） | b7636742fc9ea937e6030123afc608fd294861bf | 1dee480dff7203aff3bd6b57661645fe0b890bce | 2026-10-22T05:49:12Z |
+
+<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
+```json
+{
+  "summary_schema": 1,
+  "source": "SELF",
+  "timestamp": "2026-10-22T05:49:16.822650+00:00",
+  "command": "make test",
+  "exit_code": 0,
+  "cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-scratch-session-general-agent",
+  "before_head": "aa77f20184ace3302480642aef5d412819792da8",
+  "after_head": "aa77f20184ace3302480642aef5d412819792da8",
+  "branch": "feature/scratch-session-general-agent",
+  "target_branch": "main",
+  "target_head": "b7636742fc9ea937e6030123afc608fd294861bf",
+  "root_target": "main",
+  "immediate_target": "main",
+  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "after_tracked_diff_sha256": "7a447319f8c4fdedb68da2ef8c0fc740d86697df8f8af7650980c77a56befa7b",
+  "output_tail": [
+    "added 162 packages in 945ms",
+    "",
+    " RUN  v4.1.11 /home/weichen/projects/Agent-System-Dev-wt-feature-scratch-session-general-agent/modules/ui",
+    "",
+    "",
+    " Test Files  19 passed (19)",
+    "      Tests  188 passed (188)",
+    "   Start at  05:56:58",
+    "   Duration  1.68s (transform 1.31s, setup 0ms, import 3.38s, tests 3.68s, environment 6.91s)",
+    "",
+    "knip unused exports 61 <= 61",
+    "cd deps/agent-command && go vet ./... && go test -count=1 ./...",
+    "ok  \tagent-command\t0.002s",
+    "ok  \tagent-command/conformance\t0.002s",
+    "make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-scratch-session-general-agent'"
+  ],
+  "output_sha256": "4fee33a7ba3812f667660d6c2b49348ae902983cdfebd6a5f3f13bedb4611f0b",
+  "receipt_sha256": "1331f3cff5d6a225efa50af64c5e1301faee72c380b995ea08b4a1a7beff79da",
+  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/1331f3cff5d6a225efa50af64c5e1301faee72c380b995ea08b4a1a7beff79da.json"
+}
+```
+
+<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
+```json
+{
+  "summary_schema": 1,
+  "source": "SELF",
+  "timestamp": "2026-10-22T06:14:22.167417+00:00",
+  "command": "make test",
+  "exit_code": 2,
+  "cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-scratch-session-general-agent",
+  "before_head": "b672792f77f612d563720bff99a55ff5aa721242",
+  "after_head": "b672792f77f612d563720bff99a55ff5aa721242",
+  "branch": "feature/scratch-session-general-agent",
+  "target_branch": "main",
+  "target_head": "33d6ef69212595c680a744549986c19bb6acd6c3",
+  "root_target": "main",
+  "immediate_target": "main",
+  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "output_tail": [
+    "  File \"/home/weichen/projects/Agent-System-Dev-wt-feature-scratch-session-general-agent/tests/test_svc.py\", line 227, in svc",
+    "    self.assertEqual(proc.returncode, 0, proc.stdout)",
+    "    ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
+    "AssertionError: 1 != 0 : \u001b[1;33m[svc]\u001b[0m [dev] 跳过 manifest 迁移：需 python3 与 scripts/svc_manifest.py",
+    "\u001b[1;34m[svc]\u001b[0m [dev] 无 pidfile——没有由本脚本启动的实例",
+    "\u001b[1;31m[svc]\u001b[0m [dev] 端口被占用（非本服务）：LISTEN 0      4096       127.0.0.1:18794      0.0.0.0:*    users:((\"python3\",pid=1444356,fd=3))         ",
+    "\u001b[1;31m[svc]\u001b[0m 处理：停掉该进程，或换端口（--port / --addr）",
+    "",
+    "",
+    "----------------------------------------------------------------------",
+    "Ran 539 tests in 373.148s",
+    "",
+    "FAILED (failures=1, skipped=18)",
+    "make[1]: *** [Makefile:232: test-governance] Error 1",
+    "make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-scratch-session-general-agent'"
+  ],
+  "output_sha256": "572e274146ea0cd7b0f87865cf16c8be406ca4eda51bca7ef8469be6812ddec9",
+  "receipt_sha256": "d2b9cb21e0ab4dcf1d4b03bc939dd9f8bcd94faadff03b19acacad81b5465848",
+  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/d2b9cb21e0ab4dcf1d4b03bc939dd9f8bcd94faadff03b19acacad81b5465848.json"
+}
+```
+| 同步（记录前对象） | 33d6ef69212595c680a744549986c19bb6acd6c3 | 1970dccb7c8c11fb69ad739ae1338e97ca4ac0a6 | 2026-10-22T06:21:57Z |
+
+## 闭合记录（合入前折叠）
+
+- 本卡在 PR #691（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/691）合入前闭合并归档，随该 PR 一同合入。
+- 该 PR 的合并提交即本任务的落地记录。
+- 合入后无需回填，也无需单独的闭合 PR。

docs/superpowers/plans/2026-10-22-scratch-session-general-agent-plan.md

@@ -0,0 +1,61 @@
+# 无项目对话（Scratch Session）实施计划
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 任意启用账号可创建彼此隔离的通用智能体会话；无 `project.create` 也能用；不得接入知识树/文档树等项目专属功能。
+
+**Architecture:** 每个无项目对话 = 带 `settings.host.kind = "scratch"` 的私有空壳 `Project` + 恰好一条 `Conversation`。新建走专用 API（不要求 `project.create`）。列表/侧栏把 scratch 从真项目切换器剔除，归入虚拟分类「无项目对话」。服务端对 scratch 统一 fail-closed 拒绝 RDM/知识发布/成员等。
+
+**Tech Stack:** Go Backend（store/server/authz）、TypeScript Frontend（store/TaskSidebar）、现有 SQLite projects 表 `settings` JSON。
+
+**Spec:** [docs/superpowers/specs/2026-10-22-scratch-session-general-agent-design.md](../specs/2026-10-22-scratch-session-general-agent-design.md)
+
+**实施执行：** agent-per-unit（配置：AGENT-EXECUTION.md）；`fallback_to_host: never`。
+
+## Global Constraints
+
+- 固有能力不可做成 `role_permissions` 行。
+- ListProjects 前后端一致过滤 scratch。
+- RDM 未部署时也须宿主侧拒绝，不能只藏 UI。
+- 最小充分：不做升级、协作、配额、nullable project_id。
+
+## Review Focus
+
+- 无 `project.create` 的创建路径与真项目门禁是否拆开
+- scratch 上项目专属能力是否服务端 fail-closed
+- 侧栏是否把 scratch 与真项目分开
+
+## 文件映射
+
+| 区域 | 路径 |
+|------|------|
+| 标记 helper | Backend store 或 core 小 helper |
+| 创建 API | `modules/backend/internal/server/server.go` |
+| 列表过滤 / 1:1 | `modules/backend/internal/store/projects.go`、server createConversation |
+| 门禁 | `project_lifecycle.go`、cmdbus/RDM、knowledge、跨读 |
+| 前端 API/store/侧栏 | `api.ts`、`store.ts`、`TaskSidebar.tsx` |
+
+## Tasks
+
+### U1 — Backend 创建与固有授权
+
+- [ ] 实现 `IsScratchProject`；`POST /api/scratch-sessions`
+- [ ] ListProjects 排除 scratch；禁止 POST /api/projects 伪造 scratch；scratch 下禁止二开会话
+- [ ] 角色 catalog 不暴露可配置 scratch 动作
+- [ ] 单测覆盖无/有 project.create、禁用账号、伪造、1:1
+
+### U2 — Backend 项目专属 fail-closed
+
+- [ ] `rejectIfScratch` 挂到 projectWork/成员/RDM/knowledge/X1/跨读
+- [ ] 允许消息/附件/改名置顶归档/级联删除
+- [ ] 单测正负例
+
+### U3 — Frontend
+
+- [ ] `createScratchSession`；sidebarMode；去掉无项目时自动「默认项目」
+- [ ] TaskSidebar「无项目对话」分类与隐藏项目专属入口
+- [ ] 前端测试
+
+### U4 — 验证收口
+
+- [ ] 最小相关测试通过；task-sync / PR / CI / 独立 Review

docs/superpowers/specs/2026-10-22-scratch-session-general-agent-design.md

@@ -0,0 +1,108 @@
+# 无项目对话（Scratch Session）设计
+
+- 状态：**已批准**（对话设计第 1–4 节，2026-10-22）。
+- 日期：2026-10-22；作者：host（设计整理）；来源等级：SELF。
+- 配套计划：[实施计划](../plans/2026-10-22-scratch-session-general-agent-plan.md)。
+
+## 1. 目标与非目标
+
+**目标**
+
+- 任意**启用账号**可创建「无项目对话」，当作通用智能体使用（多轮对话）。
+- 无 `project.create`（角色「项目访问」）的用户也能完成该路径，不被「默认项目」创建 403 卡住。
+- 各无项目对话彼此**独立**：不共享文档、上下文、知识等。
+- **不得**接入知识树、文档树、成员、RDM 等项目专属功能。
+
+**非目标（本轮）**
+
+- scratch → 真项目升级 / 事后绑定 RDM
+- 分享、协作、邀请进空壳项目
+- 配额、TTL、自动清理
+- 将 `conversations.project_id` 改为可空等大 schema 重构
+
+## 2. 已锁定决策
+
+| 项 | 决策 |
+|---|---|
+| 数据模型 | 方案 A：每个无项目对话 = 一个轻量私有空壳 `Project` + 恰好一条 `Conversation` |
+| UI | 侧栏虚拟分类「无项目对话」下列会话；**不**进入真项目切换器 |
+| 谁可建 | 所有启用账号（有无 `project.create` 均可） |
+| 权限 | **固有能力**，不进角色矩阵，**不可被管理员修改**；与可配置的 `project.create` 完全分离 |
+
+## 3. 数据模型与权限
+
+### 3.1 空壳项目约定
+
+- 仍用现有 `projects` 表；`settings` 写入稳定标记：`host.kind = "scratch"`（解析仅经统一 helper，例如 `IsScratchProject`）。
+- 每个无项目对话 = **一个 scratch 项目 + 恰好一条会话**（创建时原子写入；禁止在 scratch 下再建第二会话）。
+- 项目 `owner` = 当前账号；不建成员、不共享、不邀请。
+- 会话默认 `crossPrivate = true`。
+
+### 3.2 权限
+
+| 动作 | 门禁 |
+|------|------|
+| `POST /api/projects` 创建真项目 | 仍要 `project.create`（不变） |
+| 创建无项目对话 | 启用账号即可；**不是**角色可配置动作 |
+| scratch 上读写会话/发消息 | 仅 owner |
+| scratch 升成真项目 / 绑 RDM | 本轮不做（明确拒绝） |
+
+角色 catalog、`PUT .../permissions`、角色编辑 UI **不得**出现或改写「无项目对话」能力。关掉 `project.create` 不影响 scratch 创建。
+
+### 3.3 专用创建 API
+
+`POST /api/scratch-sessions` → `{ project, conversation }`
+
+- 内部：插 scratch 项目 → 建唯一会话 → **不**触发 RDM provision。
+- **禁止**经 `POST /api/projects` 伪造 scratch 标记。
+
+### 3.4 列表语义
+
+- 真项目列表 / 侧栏项目切换器：**过滤掉** scratch。
+- 「无项目对话」分类：按会话列出（标题来自会话名）。
+
+## 4. 服务端门禁（禁用项目专属能力）
+
+判定：`IsScratchProject(p)` ≡ `settings.host.kind == "scratch"`。
+
+**一律拒绝（scratch 上）**
+
+- RDM 绑定 / provision；`rdm.*` 命令对 scratch 的 projectId → 403/400
+- 知识树 / 文档树 / 法规树 / 驾驶舱 / 模板实例化
+- 成员、职责、项目权限矩阵、项目归档协作
+- 因「拥有 scratch」而授予 `project.create` 联动能力
+- Project Context（X1）注入（视为未启用，走普通通用智能体组装）
+- 跨会话读：scratch 会话不可被对端读出，也不可读其他会话
+- 在已有 scratch 下再建会话
+- 普通创建项目接口伪装 scratch
+
+**允许（通用智能体最小集）**
+
+- 本会话消息、附件（仅挂本 scratch，不进知识发布）
+- 会话改名 / 置顶 / 归档 / 删除（删除可级联删空壳项目）
+- 普通 LLM 对话；显式 `@knowledge` 对 scratch **关闭**
+
+实现：集中 `rejectIfScratch` / `requireNonScratch`，挂在项目工作、RDM 分发、knowledge、成员 API；不能只藏 UI。
+
+## 5. 前端信息架构
+
+- 项目切换器：真项目列表 + 虚拟项「无项目对话」。
+- 选中「无项目对话」：列出本人所有 scratch 会话；「+ 新建对话」调用 scratch API。
+- 打开 scratch 会话时：隐藏项目设置、模板生成、依赖当前真项目的 RDM 入口。
+- `createTask`：无真项目时**不再**自动 `createProject('默认项目')`；无建项权或用户在无项目对话视图时走 scratch API。
+- 无建项权用户主路径：登录 → 默认落在「无项目对话」→ 可直接新建/继续对话。
+
+## 6. 验收标准
+
+1. 无建项权账号可进入「无项目对话」并完成多轮通用对话，不因默认项目 403。
+2. 有建项权账号同样可建无项目对话；真项目创建仍只认 `project.create`。
+3. 同一用户两个 scratch 会话互不共享附件知识库、上下文条目、跨会话读取。
+4. scratch 上 RDM/知识树/文档树/成员/项目设置类能力服务端拒绝；UI 无入口。
+5. 角色权限 UI / API 不能出现或改写该能力。
+6. scratch 不出现在项目切换器。
+7. 无法在已有 scratch 项目下再建第二条会话。
+
+## 7. 最小验证
+
+- Backend：创建门禁、RDM/knowledge 拒绝、ListProjects 过滤、1:1 约束单测。
+- Frontend：侧栏分组、无建项权主路径、scratch 视图隐藏项目入口的测试。