docs: 待办收尾,补测试与代码布局约定

- 待办:任务恢复边界、注册断言、测试装配去重、大文件拆分、MP 对照 6.4 已完成并移除;
  BrowserService 类拆分与超长函数写明暂缓原因;真实环境验收列出所需条件;
  continuous-series 偶发超时改为观察项(已核实不是业务竞争)
- CLAUDE.md:test/support、contracts api/ 与整理服务的文件布局、起子进程的测试进串行组
- lessons 第 26 条:检查命令不接管道

Co-Authored-By: Claude Opus 5.5 <[email protected]>

CLAUDE.md

@@ -16,6 +16,8 @@ deno task ci          # 提交前完整检查(含 web 构建与编译产物自
 deno task release     # 测试环境发布,见下
 ```
 
+REST 端点定义按领域分在 `packages/contracts/src/api/*.ts`，`api.ts` 按顺序合并成 `Api`（顺序即路由注册顺序）。整理服务按阶段分在 `organize-plan / -exec / -finalize / -records / -types.ts`，外部仍从 `organize.ts` 引用。
+
 只改一个包时可在包目录跑 `deno run -A npm:vitest run <文件>`；web 包用 `../../node_modules/.bin/vitest run`（Node）。改迁移后跑 `deno task gen:types` 重新生成 `packages/db/src/types.ts`，contracts 枚举顺序与数据库保持一致（`packages/contracts/test/db-sync.test.ts` 会查）。
 
 ## 约定
@@ -31,7 +33,8 @@ deno task release     # 测试环境发布,见下
 
 - 位置：server 的测试统一放 `apps/server/test/<模块>/`（不再用 `src/**/__tests__`）；web 与 adapters 测试和源码放同目录 `*.test.ts`；其它包放 `test/`。
 - 命名按测的行为（`crash-recovery.test.ts`、`two-stage-search.test.ts`），不要用任务编号（`e4-`、`w5a2`、`-md1`）。
-- server 分三组（`apps/server/vitest.config.ts`）：`unit` 不碰 PG；`pg` 真实 PG + 假引擎，文件并行；`serial` 起真实引擎 / worker / 子进程的集成与 e2e，串行。新文件缺省进 `pg`，起真实 worker 的必须加进 `SERIAL`。
+- server 分三组（`apps/server/vitest.config.ts`）：`unit` 不碰 PG；`pg` 真实 PG + 假引擎，文件并行；`serial` 起真实引擎 / worker / 子进程的集成与 e2e，串行。新文件缺省进 `pg`，起真实 worker / 引擎 / 子进程的必须加进 `SERIAL`。
+- server 测试的建库、schema 锁、假引擎统一用 `apps/server/test/support/`（`pg.ts`、`engine.ts`），各模块 harness 只写自己的装配。
 - 每个 PG 测试文件用自己的 schema；等待异步结果用轮询到条件，不写固定 sleep。
 - 真机测试用 `*.real.test.ts`，靠环境变量开启，缺省跳过。