kai/writer-work-flow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8058cfb11a69c94fda510cc06ceb9573ad986455
writer-work-flow/PROGRESS.md
Yaojia Wang 8058cfb11a feat(ux): B0 注入透明读端点 + F1 写作页右栏真面板 
兑现「看到的=写章用的」信任牌（不变量 #6），替换写作页右栏过时假占位
（「M1 暂未接 / M2 开放」）。

后端：
- GET /projects/{id}/chapters/{no}/injection → InjectionResponse（selected
  实体 + 入选理由 + recent_n）；调既有 assemble() 回放确定性 SelectionTrace，
  无 LLM / 无 commit / 无 DDL；项目不存在→404，无大纲→selected:[]。
- 新 schemas/injection.py；tests/test_injection.py(3 测)。

前端：
- gen:api 纳入端点；纯逻辑 lib/workbench/injection.ts（理由/类型→中文徽标
  + 4 vitest）+ useInjection 读 hook。
- ChapterAssistant 改 client 组件：列出选中实体 + 理由徽标 + 空/载/错三态，
  四审段指向审稿页；Workbench 传 projectId/chapterNo。

门禁：后端 ruff/format/mypy 159/alembic 无漂移/pytest 454；
前端 lint/typecheck/vitest 167/build。

B0 可控版（PUT override pin/排除/recent_n + selection 加参 + draft 同读
override + 持久化）+ F1 可控控件待后续。
2026-06-20 10:57:03 +02:00

83 KiB
Raw Blame History

PROGRESS — 多 Agent 协同任务台账

多 agent 共享的唯一协同入口。开工前读这里 + memory/；认领任务、尊重依赖、完成即更新。 完整任务定义见 DEV_PLAN.md；本台账只展开当前阶段，进入新阶段时再把该阶段任务拉进来。 协同规则见 CLAUDE.md →「多 Agent 协同」。

状态图例：⬜ 待办 · 🔵 进行中(注明 @skill + 日期) · ✅ 完成 · ⛔ 阻塞(注明等什么)

当前阶段：K1 · Kimi Code OAuth（订阅 plan 接入）

背景：用户要求接入 Kimi Code 订阅 plan（device-flow OAuth）。已知情接受 ToS/封号风险——研究确认：用订阅 plan 调用需伪造官方客户端 User-Agent + X-Msh-* 头，Kimi ToS 视为违规、可能封停会员（见变更日志研究结论）。用户明确选择此路径（非合规的 API Key 路径）。与既有 API-key провайдер kimi 分离，新增独立 provider kimi-code 以便切换。 集成契约（研究确认，实现时对照 github.com/picassio/pi-kimi-coder 校验）：

  • device flow：POST https://auth.kimi.com/api/oauth/device_authorization（client_id 17e5f671-d194-4dfb-9706-5516cb48c098，env KIMI_CLIENT_ID 可覆盖，scope kimi-code）→ 返回 user_code/verification_uri/device_code/interval；轮询 POST https://auth.kimi.com/api/oauth/token（grant device_code，处理 authorization_pending/slow_down）。refresh：同 token 端点 grant refresh_token。
  • 推理：base https://api.kimi.com/coding/v1（OpenAI 兼容），model kimi-for-coding，Authorization: Bearer <access_token> + 必需伪造头：User-Agent(如 KimiCLI/1.x) + X-Msh-Platform/X-Msh-Version/X-Msh-Device-Name/X-Msh-Device-Model/X-Msh-Os-Version/X-Msh-Device-Id(持久 UUID)。缺头→403。
  • token：access ~15min / refresh ~30d → 建网关时按需刷新（临近过期刷新并持久化）。存储：provider_credentials 加 auth_type(api_key|oauth) + oauth_enc(Fernet 加密 JSON {access_token,refresh_token,expires_at})。 执行波次：A(@db 加列+迁移 ‖ @llm Kimi coding 适配器) → B(@backend OAuth device 服务 + 端点 + store + _build_provider_adapter 接线) → C(@frontend 设置页连接/轮询/断开 + 路由档位) → D(@qa E2E device-flow mock + 头断言)。 测试纪律：device flow 注入 fake httpx（零联网）；适配器断言伪造头集；token 刷新逻辑单测；E2E mock auth+coding 两端点。
任务 状态 负责 依赖 契约 备注
K1.1 provider_credentials 加 auth_type + oauth_enc 列 ✅ @db — C2扩 完成：models 加 auth_type/oauth_enc + api_key_enc 改 nullable；迁移 1f011c42bd4d；alembic check 无漂移。⚠️ K1.3 @backend 须把 StoredCredential.api_key_enc 改 bytes|None（见下方请求 + memory）
K1.2 Kimi coding 适配器（伪造头 + OAuth bearer） ✅ @llm — C1扩 完成：adapters/kimi_code.py(KimiCodeAdapter 子类化 OpenAICompatAdapter + 伪造头 + 稳定 device_id)；build_adapter 加 kimi-code 分支；UA 验证为 KimiCLI/1.5（pi-kimi-coder 仅设 UA，X-Msh-* 为契约附带，见 C1扩 校正）；11 测全绿
K1.3 OAuth device 服务 + 端点 + store + 接线 ✅ @backend K1.1,K1.2 C3扩 完成：services/kimi_oauth.py(start/poll/refresh,注入 httpx Protocol)+3 端点(start 202→jobs 后台轮询/disconnect/status,复用 run_job)+StoredCredential 收口(api_key_enc→nullable+auth_type/oauth_enc，K1.1 的 2 mypy red 已消)+store upsert_oauth_credential/delete_credential+_build_provider_adapter OAuth 按需刷新(300s 缓冲)。token 不进 job 结果/日志/响应。全仓门禁绿(ruff/format/mypy 154/alembic 无漂移/pytest 430)。OpenAPI 加 3 端点→@frontend K1.4 须 pnpm gen:api
K1.4 设置页 Kimi Code 连接流 ✅ @frontend K1.3 — 完成：gen:api 纳入 3 OAuth 端点；KimiCodeOauth 连接区（显 user_code+开授权页+轮询 job→已连接/断开）+ 可编辑档位路由（含 kimi-code:kimi-for-coding）；纯逻辑 lib/settings/{kimiOauth,providers} + 25 新 vitest；前端门禁全绿（gen:api/lint/typecheck/vitest 155/build）。运行时验真 auth.kimi.com 留 K1.5
K1.5 K1 E2E ✅ @qa K1.4 — tests/test_k1_kimi_oauth_e2e.py(4 用例,真 pg)：device-flow(pending×2→成功)→加密 token 真落 pg(无明文+回环)→建网关断言 KimiCodeAdapter coding base+伪造头+bearer→refresh-on-build 更新存量 token(DB 真源)→disconnect 清除；token 全程不进 job 结果/状态/start 响应。全仓门禁绿(ruff/format/mypy 154/alembic 无漂移/pytest 434)。K1 完成，可封板

K1 出口（DoD）✅ 全部达成：作者在设置页用 Kimi Code OAuth 登录（device flow，显 user_code + 开授权页 + 轮询 job）→ token Fernet 加密入库（oauth_enc，全程不进 job 结果/日志/响应）→ 把档位路由到 kimi-code:kimi-for-coding → 建网关时构 KimiCodeAdapter（coding base + 伪造 UA/X-Msh-* 头 + bearer）→ token 临近过期建网关时自动刷新并回写。后端门禁绿（ruff/format 干净 / mypy 154 / alembic 无漂移 / pytest 434）；前端门禁绿（gen:api/lint/tsc/vitest 155/build）；E2E（tests/test_k1_kimi_oauth_e2e.py 4 用例）device-flow mock 零联网走通，DB 真源逐项断言（含 token 不泄漏 + refresh-on-build + disconnect 清除）。K1 完成。 ⚠️ 仍需用户用真账号对真 auth.kimi.com/api.kimi.com 做一次联网冒烟（device-flow 需伪造官方客户端 UA → ToS 视为违规、可能封停会员，用户已知情自担）；E2E/单测仅验逻辑、不联网。

状态：M1–M5 全部完成（含 M5 三项收尾余项已清理）

当前无活跃阶段。 Phase 0–5（M1–M5）已全部交付，M5 的三项非阻塞收尾余项（①Codex 读端点、②Anthropic/Gemini 真实适配器选择、③packages/skills 纳入 workspace）亦已清理。各阶段详情见下方「已归档阶段」+「变更日志」。 最终门禁（本次全绿）：后端 ruff/format 干净、mypy 144 文件、alembic 无漂移、pytest 400 passed；前端 lint/typecheck 干净、vitest 130 passed、build OK。 下一步若继续：DEV_PLAN §4 的 P2/后续（向量检索 / 真任务队列 / 全书一致性扫描 / 社区市场），进入时把对应任务拉入本表。 仍开放的非阻塞备注：@devops 复核根 uv.lock（@backend 改了 packages/skills/pyproject.toml deps 后已 uv sync 重建 ww-skills）；Anthropic/Gemini 真实回退已接线（build_adapter 工厂 + 按 provider 选适配器）但尚未对真 SDK 联网验证（单测/E2E 用 OpenAI 兼容 mock）。

已归档阶段

Phase 5 · 生成 + 多 provider + 扩展 (M5) — ✅ 全部完成（2026-06-19）

T5.1 worldbuilder + character-gen 节点（C6✅扩；群像防雷同注入已生成+已有 + 入库前 continuity 校验缝 precheck_generated_cards）@llm · T5.4 网关多 provider 韧性（C1✅扩；Anthropic/Gemini 适配器 + 回退链 + CircuitBreaker + tenacity 退避 + 能力协商/降级 served_by.degraded，无 OpenAPI 形变）@llm · T5.5 Skill 运行时 + 规则（C8 + C3✅扩；SkillRegistry.load 越权声明拒绝 + 表权限沙箱 filter_reads/partition_writes + POST /rules）@backend · T5.2 生成/入库 API（C3✅扩；world/characters generate 预览 + POST characters 入库双 gate：continuity 预检 409 + partition_writes 白名单 + schema→JSONB 形变 + GET rules/skills；build_gateway_for_tier 接线 chain_from_routing 回退）@backend · T5.3+T5.6 角色生成器 + 世界观设计器 + 设定库 Codex + 规则页 + 技能库 + 命令面板（⌘K）@frontend · T5.7 M5 E2E + 切 provider（真 Gateway deepseek 失败→openai 回退、DB ledger 记实际服务方、能力降级）@qa。 出口达成：后端门禁绿（ruff/format 干净 / mypy 142 / pytest 391 / alembic 无漂移，复用 T0.2 既有表零建表迁移）；前端门禁绿（gen:api / lint / tsc / vitest 125 / build）；E2E 真 DB + mock 多 provider 零 token 走通。M5 完成 → M1–M5 全部交付。 三非阻塞余项（①Codex 读端点、②Anthropic/Gemini 真实适配器选择、③packages/skills 纳入 workspace）随后于同日全部清理（见变更日志 follow-up #1–#4）。

Phase 4 · 文风 (M4) — ✅ 全部完成（2026-06-19）

T4.2 style-auditor 双轨 + 第四审（C6✅扩/C4✅扩；style_extract_spec(analyst,16 维指纹带证据,不进 review 图) + style_drift_spec(name="style",light,第四审并入 REVIEW_SPECS) + refiner_spec(writer 纯文本)，REVIEW_SPECS 四审齐 + collect/SSE 加 style）@llm · T4.1 jobs 长任务基建（C3.5✅；JobRepo/SqlJobRepo + run_job 独立 session + lifespan zombie reaper）@backend · T4.3 API style + refine（C3✅扩；POST /style 202+jobs BackgroundTask、GET /style 最新指纹、POST /refine 同步 diff 不写库）@backend · T4.4 文风页 + 漂移 + 回炉 + job 轮询（useJobPoll 状态机 + StyleUpload/FingerprintView + 审稿页第四审 StylePanel + RefineView diff 采纳合入）@frontend · T4.5 M4 E2E（学文风→202 job→后台跑完→指纹真落 pg version+1 + 第四审 SSE/chapter_reviews.style 真填 + 回炉不写库）@qa。 出口达成：后端门禁绿（ruff/format 干净 / mypy 115 / pytest 296 / alembic 无漂移，全程零建表迁移，复用 T0.2 预留的 style_fingerprint/chapter_reviews.style/jobs）；前端门禁绿（gen:api / lint / tsc / vitest 96 / build）；E2E 真 DB + mock 网关零 token 走通 学文风→第四审打分→回炉，DB 真源逐项断言。@docs 已把 GET /style 回写 ARCH §7.2/PRODUCT_SPEC §6。

Phase 3 · 伏笔 + 节奏 (M3) — ✅ 全部完成（2026-06-18）

T3.1 foreshadow Repository + 纯函数状态机（OPEN/PARTIAL/CLOSED/OVERDUE 全转移 + 到期判据 + ForeshadowLedger* 写侧 repo）@backend · T3.4 outliner Agent + 伏笔窗口（C6✅扩；outliner_spec + OutlineResult(含 foreshadow_windows) + run_outline 只读节点）@llm · T3.3 foreshadow-analyst + pace-checker 节点（C6✅扩/C4✅扩；并入 REVIEW_SPECS 三审齐 + collect 分列 + SSE foreshadow/pace 事件）@llm · T3.2 到期扫描 BackgroundTask + 登记/状态接口（验收后 run_overdue_scan 自建 session 置 OVERDUE + POST/PATCH .../foreshadow，重复/非法→VALIDATION 422）@backend · T3.5 API outline + foreshadow（C3✅扩；GET .../foreshadow?status= 看板 + POST .../outline upsert outline 表含窗口）@backend · T3.6 伏笔看板 + 大纲编辑器 + 节奏报告（四泳道 + beats+窗口徽标 + 审稿页节拍图▁▃▅）@frontend · T3.7 M3 E2E（伏笔埋设→进展→验收后扫描 OVERDUE + 大纲含窗口 + 三审 SSE，strict-xfail 钉住并发记账 bug）@qa · T3.8 [bugfix] 并行审记账并发安全（SqlAlchemyLedgerSink.record 改 add-only 去 await flush，解 AsyncSession 并发 flush 冲突，xfail 转 XPASS 后解钉）@llm。 出口达成：后端门禁绿（ruff / mypy 111 / pytest 228 passed（0 xfailed/0 failed）/ alembic 无漂移，foreshadow 表已 T0.2 建齐无新建表）；前端门禁绿（gen:api / lint / tsc / vitest 69 / build）；E2E 真 DB + mock 网关零 token 走通，DB 真源逐项断言。T3.7 暴露并发记账 bug → T3.8 修复 → 解钉 xfail。

Phase 2 · 一致性 + 验收 (M2) — ✅ 全部完成（2026-06-18）

T2.1 续审 AgentSpec+结构化输出契约+网关 instructor 接线（C6✅稳定，改 C1：run() 填 parsed）@llm · T2.2 LangGraph 并行审+collect 留痕+review SSE（C4✅扩）@llm · T2.3 摘要/审稿留痕 Repository+章节 version（@backend，表已 T0.2 建）· T2.4 验收事务+冲突 gate（单原子事务 + R2 事务外提炼 digest）@backend · T2.5 review API+历史（C3✅扩）@backend · T2.6 审稿报告页+冲突裁决+验收 gate @frontend · T2.7 M2 E2E（真 DB+多档位 mock 网关零 token）@qa。 出口达成：后端门禁绿（ruff / mypy 90 / pytest 114 / alembic 无漂移）；前端门禁绿（gen:api / lint / tsc / vitest 45 / build）；E2E 写→审→裁决→验收→摘要入库闭环、DB 真源逐项断言。设计决策 R1–R6 全兑现（见 memory/decisions）。

Phase 1 · 写章闭环骨架 (M1) — ✅ 全部完成（2026-06-18）

T1.1 LLM 网关接口+DeepSeek 适配器+usage_ledger 记账（C1✅稳定）@llm · T1.2 记忆 assemble 确定性选择（C5✅稳定）@backend · T1.3 LangGraph 写章节点+Postgres checkpointer+SSE（C4✅稳定）@llm · T1.4 立项+写章 draft(SSE)+PUT 自动保存（C3✅稳定）@backend · T1.5 AppShell+作品库+5 步立项向导 @frontend · T1.6 写作工作台（三栏+流式打字机+注入透明面板+自动保存）@frontend · T1.7 提供商凭据管理（Fernet 加密+测试连接）@backend · T1.8 设置页（档位路由+凭据行）@frontend · T1.9 M1 E2E（真实 DB+mock 网关零 token；暴露并修复 ledger 提交 bug）@qa。 出口达成：后端门禁绿（ruff / mypy 68 / pytest 57 / alembic 无漂移）；前端门禁绿（gen:api / lint / tsc / vitest 24 / build）；E2E 闭环走通。 M2 起可补的 M1 占位：本章助手/注入透明面板、向导主角/世界观字段、档位路由可写。

Phase 0 · 基建与栈修订 — ✅ 全部完成（2026-06-18）

T0.1 monorepo 骨架 ✅ @devops · T0.2 16 MVP 表迁移（无漂移，users stub）✅ @db · T0.3 FastAPI 骨架 + config + 错误信封(带 request_id) + OpenAPI + GET /jobs/:id + structlog ✅ @backend · T0.4 前端骨架 + 纸感 token + OpenAPI→TS gen:api ✅ @frontend · T0.5 CI（含 pg service + alembic 漂移校验）✅ @devops · T0.6 架构栈修订回写规格 ✅ @docs。 出口达成：backend 门禁绿、frontend 门禁绿、API 实跑 200 带 x-request-id。

变更日志（append-only，最新在最上）

格式：- [YYYY-MM-DD] @skill 完成/进展 Txx — 一句话结果 + 影响的契约/文件

  • [2026-06-20] UX计划 B0(读)+F1 — ✅ 本章注入透明（读端点 + 右栏真面板）。兑现差异化信任牌「看到的=写章用的」（不变量 #6）：把先前写作页右栏「M1 暂未接 / M2 开放」的过时假占位换成真数据。后端(@backend)：GET /projects/{id}/chapters/{no}/injection → InjectionResponse{project_id,chapter_no,selected:[{kind,name,reasons[]}],recent_n}，调既有 assemble() 回放确定性 SelectionTrace（无 LLM、无 commit、无 DDL）；项目不存在→404，无大纲→selected:[]。文件：schemas/injection.py(新) · routers/projects.py(+GET+2 import) · tests/test_injection.py(新,3 测)。前端(@frontend)：gen:api 纳入端点；纯逻辑 lib/workbench/injection.ts(理由/类型→中文徽标 + 4 vitest) + useInjection 读 hook；ChapterAssistant 改 client 组件列出选中实体 + 入选理由徽标（本章点名/主角常驻/近章出现/伏笔窗口）+ 空/载/错三态，「四审」段改指向审稿页；Workbench 传 projectId/chapterNo。全仓门禁绿：后端 ruff/format/mypy 159 Success/alembic 无漂移/pytest 454 passed；前端 lint/typecheck/vitest 167 passed/build。记 contracts C3扩。B0 余项（可控版：PUT override pin/排除/recent_n + selection 加参 + draft 同读 override + 持久化）+ F1 可控控件待后续。

  • [2026-06-20] @frontend — ✅ 接上两个新读端点：大纲页 / 写作工作台重访时回显已存内容。pnpm gen:api 纳入 GET .../outline + GET .../chapters/{no}/draft + schema DraftView；lib/api/types.ts 加 DraftView 别名。新增两个 RSC 读 helper（仿 fetchForeshadow/fetchProject 服务端读、无 CORS）：fetchOutline(projectId)→OutlineChapterView[]（200 解包 chapters，任何错误/空降级为 [] 不阻塞进页），fetchDraft(projectId,chapterNo)→DraftView|null（复用 getJsonOrNull，404→null 当空编辑器，不抛）。大纲页(outline/page.tsx) 进页 fetchOutline 作 initialChapters 种入 OutlineEditor（useOutline 已据非空初值置 ready）→ 重访显已生成大纲；生成流照常覆盖所显章节。写作工作台(write/page.tsx + Workbench) 进页 fetchDraft 拿 content 作编辑器初值（useState(initialText)）→ 重访重载已写正文；404/新章 → "" 空编辑器；SSE 流式写 + AbortController + PUT 自动保存全不动（流起始空、仅 streaming/done/aborted 变化才覆盖，初值不反扑活跃流）；导出 WORKBENCH_CHAPTER_NO(原 M1_CHAPTER_NO)供页面拉对应章草稿。新增 lib/api/server.test.ts(5 vitest，mock fetch 验解包/降级/404→null)。前端门禁全绿：gen:api / lint / typecheck / vitest 160(155→+5) / build。文件：lib/api/{types,server,server.test}.ts · app/projects/[id]/{outline,write}/page.tsx · components/workbench/Workbench.tsx。消费 contracts C3扩（@backend 两读端点）。

  • [2026-06-20] @backend — ✅ GET /projects/{id}/chapters/{no}/draft 草稿读端点（补缺口，镜像 GET /outline）。写作工作台先前只有 POST .../draft(SSE 流写)+PUT .../draft(自动保存) 无读端点 → 重访工作台编辑器空白、看似「未保存」（其实 chapters 行在库）。补对称读侧：GET /projects/{id}/chapters/{no}/draft → 200 DraftView{project_id,chapter_no,volume,status,version,content,length}（比 PUT 的 DraftResponse 多 content——读侧需正文重建编辑器）；无草稿行/正文空白 → 404 NOT_FOUND（工作台据此呈现空编辑器，仿其它缺资源端点）。直接复用既有 chapter_repo.get_draft（同续审 _resolve_review_draft 读缝，ChapterDraftView 已含全字段，无新 repo 方法/view）；只读不写库；多版本固定返草稿版次(DRAFT_VERSION=1)。文件：schemas/projects.py(+DraftView) · routers/projects.py(+GET endpoint+import) · tests/test_projects.py(+2：回灌正文 / 无草稿 404)。全仓门禁绿：ruff/format 干净、mypy 154 Success、alembic 无漂移、pytest 444 passed（442→+2）。OpenAPI 新增 1 端点 → @frontend 须 cd apps/web && pnpm gen:api + 工作台初次加载拉已保存草稿回灌编辑器。记 contracts C3扩。

  • [2026-06-20] @backend — ✅ GET /projects/{id}/outline 大纲读端点（补缺口，仿 Codex 读端点）。大纲页先前只有 POST .../outline（生成+落库）无读端点 → 重访页面已落库大纲不回显、看似「未保存」。补对称读侧：GET /projects/{id}/outline → 200 OutlineResponse{chapters:[OutlineChapterView{no,volume,beats:list[str],foreshadow_windows}]}（与 POST 同形，按 chapter_no 升序）；项目存在无大纲 → 200 空列表（非 404）；项目不存在 → 404 NOT_FOUND。复用 C5 读侧：扩 OutlineRepo(domain) + SqlOutlineRepo(assemble 读侧) 加 list_for_project（仿 Character/WorldEntityRepo，order_by chapter_no，既有 get 不动）；新注入缝 get_outline_read_repo(仿 get_rules_read_repo)。beats DB JSONB {"beats":[...]} → 解包裸 list[str]（同 POST）。文件：routers/outline.py(+GET) · services/project_deps.py(+dep) · domain/repositories.py(+protocol method) · memory/sql_repositories.py(+impl) · tests/{test_outline.py(+3),fakes_projects.py(+FakeOutlineReadRepo)} + 补 2 既有 outline fake（test_memory/test_projects）满足扩展后的 protocol。全仓门禁绿：ruff/format 干净、mypy 154 Success、alembic 无漂移、pytest 442 passed（439→+3）。OpenAPI 新增 1 端点 → @frontend 须 cd apps/web && pnpm gen:api + 大纲页初次加载拉已持久化大纲。记 contracts C3扩。

  • [2026-06-19] @llm — K1.2 修头校正：恢复 opencode 规范的完整 7 头（UA KimiCLI/1.37.0）。先前误信 picassio/pi-kimi-coder（UA-only）把头集裁成仅 UA，是分歧/错误参考导致的误修——真源改为 ooojustin/opencode-kimi（src/headers.ts+src/constants.ts，1:1 镜像 kimi-cli v1.37.0，已重新拉取 master 核对）。kimi_code_headers() 现发 7 头：User-Agent=KimiCLI/1.37.0 + X-Msh-Platform=kimi_cli（字面常量）+ X-Msh-Version=1.37.0 + X-Msh-Device-Name（hostname ASCII 化）+ X-Msh-Device-Model（kimi_device_model()：macOS=macOS {mac_ver} {machine}）+ X-Msh-Os-Version（platform.version()）+ X-Msh-Device-Id（稳定 32 位无连字符 uuid4().hex：env KIMI_DEVICE_ID 优先→否则持久化 ~/.kimi/device_id）。恢复 kimi_device_id()/kimi_device_model() 助手 + 重加 imports（os/uuid/socket/platform/pathlib）+ __init__ 重导出。文件：packages/llm_gateway/ww_llm_gateway/adapters/kimi_code.py + __init__.py + 两测（断全 7 头键 + 固定字面值 + device-id 32 位小写 hex 稳定 + host 派生值非空 ASCII，env 注入保 CI 确定）。更 contracts C1扩（7 头 + opencode 真源）+ gotcha（pi-kimi-coder 分歧→回退）。门禁绿：ruff/format 干净、mypy 干净（27 文件）、pytest 60 passed（packages/llm_gateway）。无 OpenAPI 形变。

  • [2026-06-19] @backend — K1.3 修正：device authorization 重新带 scope=kimi-code（实测 401 后修）。K1.5 联网实测登录拿到真 JWT 但调 api.kimi.com/coding/v1 回 401 Invalid Authentication——根因 token 缺 coding entitlement（省略了 scope）。start_device_authorization 请求体加 scope=kimi-code（={"client_id":<id>,"scope":"kimi-code"}，模块常量 KIMI_CODE_SCOPE）；scope 只放 device-auth，token 交换/刷新不带。文件：apps/api/ww_api/services/kimi_oauth.py + 单测 test_kimi_oauth_service.py（test_start_device_authorization_parses_response_and_sends_scope 断 data["scope"]=="kimi-code"）。修正 C3扩 contract + decision「省略 scope」表述 + 加 gotcha。无 OpenAPI 形变，前端无需 re-gen。门禁绿：ruff/format 干净、mypy 干净、pytest 101 passed（apps/api）。

  • [2026-06-19] @orchestrator — 🎉 K1 完成 + 独立复核（Kimi Code OAuth 订阅 plan 接入）。波次 A(K1.1 @db 加列+迁移 ‖ K1.2 @llm KimiCodeAdapter)→B(K1.3 @backend OAuth device 服务+端点+store+接线)→C(K1.4 @frontend 连接流+可编辑路由)→D(K1.5 @qa E2E) 全绿，契约先行、零返工、无新 bug。研究先行（device flow at auth.kimi.com、client_id、伪造 UA/X-Msh-*、coding base、kimi-for-coding、access15m/refresh30d）+ 对照 pi-kimi-coder/ooojustin/lemon07r 校验（省略 scope 匹配 kimi-cli v1.41.0+）。最终独立复跑确认：后端 ruff/format 干净、mypy 154 文件、alembic 无漂移(首个新迁移=provider_credentials 加 auth_type/oauth_enc)、pytest 434 passed；前端 vitest 155/build。能力闭环：设置页 device-flow 登录→token Fernet 加密入库(oauth_enc，不泄漏)→路由 kimi-code:kimi-for-coding→网关构 KimiCodeAdapter(伪造头+bearer)→临过期自动刷新。封号风险用户已知情接受；与既有 API-key provider kimi 分离可切换。唯一未尽：对真 auth.kimi.com/api.kimi.com 的真账号联网冒烟（含封号风险，用户自担）——代码/E2E 仅验逻辑零联网。

  • [2026-06-19] @qa — K1.5 ✅ K1 E2E（Kimi Code OAuth device-flow 全 mock → 真 pg）。新增 tests/test_k1_kimi_oauth_e2e.py（4 用例，零联网，真 pg）：① POST .../oauth/start→202 {job_id,user_code,verification_uri,interval}，fake httpx 跑 device-auth + token(pending×2→成功) 全程；后台 run_job 轮询跑在真 e2e_sm session（override get_session_factory→e2e_sm + monkeypatch 模块级 kimi_oauth._default_http_client→同一 scripted fake + kimi_oauth.asyncio.sleep→no-op；端点 device-auth 走 _default_http_client dep 同样指 fake）→ GET /jobs/{id} done，result {connected:true,provider:"kimi-code"}；DB 真源：provider_credentials 行 auth_type="oauth"/oauth_enc 非空/api_key_enc null，密文不含明文 token + 解密回环 access/refresh；GET .../oauth/status connected 无 token。② 存 oauth + tier_routing writer→kimi-code:kimi-for-coding → build_gateway_for_tier → KimiCodeAdapter，其 _client 带 coding base https://api.kimi.com/coding/v1 + UA KimiCLI/1.5 + 全 X-Msh-* + api_key(=bearer)=存量 access token。③ 临近过期 oauth 包 → _build_provider_adapter 触发刷新（fake project_deps.kimi_refresh + 字符串 target monkeypatch project_deps.httpx.AsyncClient）→ 适配器用新 token + oauth_enc(DB 真源)更新为新包。④ POST .../oauth/disconnect→凭据行清除（DB 真源无 oauth）。token 全程负向断言：不进 job 结果/状态响应/start 响应/密文明文。全仓门禁绿：ruff/format 干净、mypy 154 Success、alembic 无漂移、pytest 434 passed（430→+4）。memory 记 1 gotcha。K1（Kimi Code OAuth 订阅 plan 接入）全 5 子任务 ✅，可封板。⚠️ 仍未对真 auth.kimi.com/api.kimi.com 联网验证（含封号风险，用户自担）。

  • [2026-06-19] @frontend — K1.4 ✅ 设置页 Kimi Code OAuth 连接流 + 可编辑档位路由。pnpm gen:api 纳入 K1.3 的 3 端点（OAuthStart/Disconnect/StatusResponse），lib/api/types.ts 加 3 别名。纯逻辑（node-env vitest）：lib/settings/kimiOauth.ts（connectPhase 状态机 idle/awaiting/connected/error + toDeviceDisplay/authOpenUrl/toConnectionStatus/jobConnected/formatExpiresAt，16 测）+ lib/settings/providers.ts 扩（KNOWN_PROVIDERS 加 kimi-code(auth:oauth, model:kimi-for-coding) + API_KEY_PROVIDERS/TIERS/defaultModelFor + 路由草稿纯函数 toRoutingDrafts/applyProviderChange/draftsToRoutingInput，9 测）。组件：useKimiOauth hook（复用 useJobPoll：connect=POST start→展示 user_code+window.open 授权页+轮询 job→done 拉 status；disconnect=POST→复位）+ KimiCodeOauth.tsx（连接区，user_code 用 <output select-all tabIndex=0> 可读可选可聚焦 + motion-safe）。ProvidersSettings.tsx 改：档位路由从只读→可编辑（per-tier select provider + model input + 保存 PUT），API-key 凭据行只列 API_KEY_PROVIDERS（OAuth 提供商有独立连接区，无 key 输入），挂入 KimiCodeOauth。server.ts 加 fetchKimiOauthStatus，page.tsx Promise.all 拉 providers+oauth 状态传 kimiOauth prop（进页即显连接态）。job 结果无 token，只读 connected。前端门禁全绿：gen:api / lint / typecheck / vitest 155 passed（130→+25）/ build。memory 记 1 gotcha。⚠️ 运行时对真 auth.kimi.com 设备授权 + 真 api.kimi.com 调用验证留 K1.5/手动（含封号风险，用户自担）。

  • [2026-06-19] @backend — K1.3 ✅ Kimi Code OAuth device-flow 服务 + 端点 + store + 网关接线（C3 扩稳定）。新增 apps/api/ww_api/services/kimi_oauth.py（start_device_authorization/poll_token/refresh，注入 AsyncHttpClient Protocol 零联网；TokenSet+encrypt_oauth_bundle/decrypt_oauth_bundle 复用 Fernet；needs_refresh 300s 缓冲；client_id env KIMI_CLIENT_ID 可覆盖、device authorization 省略 scope）+ routers/kimi_oauth.py（POST .../oauth/start→202 {job_id,user_code,verification_uri,...}+ BackgroundTask run_job 后台循环轮询→成功存加密 oauth_enc+job done(结果只 {connected,provider})；POST .../oauth/disconnect→{disconnected}；GET .../oauth/status→{connected,expires_at} 无 token）+ schemas/kimi_oauth.py（3 schema）+ 注册 main.py。services/credentials.py：StoredCredential 加 auth_type/oauth_enc、api_key_enc→bytes|None（K1.1 的 2 处 mypy red 消除），SqlCredentialStore 读新列 + upsert_oauth_credential/delete_credential，upsert_credential 显式置 api_key 态。services/project_deps.py：_build_provider_adapter 对 kimi-code/auth_type=oauth 走 _resolve_kimi_code_token（解密→临近过期则经 httpx 刷新+持久化→access token 喂 build_adapter("kimi-code",…)）；provider_deps.py _PROVIDER_BASE_URLS 加 kimi-code。token 全程不进 job 结果/日志/响应（仅 Fernet 密文存 oauth_enc）。TDD 先红后绿：tests/test_kimi_oauth_service.py(11) + test_kimi_oauth_endpoints.py(5) + test_kimi_code_wiring.py(3)（fake httpx 零联网）。全仓门禁绿：ruff/format 干净、mypy 154 源文件 Success、alembic 无漂移、pytest 430 passed（400→+30）。OpenAPI 新增 3 端点 + 3 schema → @frontend K1.4 须 pnpm gen:api。memory 记 C3 扩（K1.3）+ 1 decision + 2 gotcha。⚠️ 真 auth.kimi.com/api.kimi.com 联网验证（含封号风险）留 K1.5，用户自担。

  • [2026-06-19] @llm — K1.2 ✅ Kimi Code 订阅 plan 适配器（C1 扩稳定）。packages/llm_gateway/ww_llm_gateway/adapters/kimi_code.py：KimiCodeAdapter 子类化 OpenAICompatAdapter（coding 端点 OpenAI 兼容，复用 complete/stream/结构化/瞬时错误包装/capabilities），provider 固定 kimi-code（与 API-key kimi 分离）；build_kimi_code_client(access_token, base_url?) 构 AsyncOpenAI(api_key=access_token, base_url="https://api.kimi.com/coding/v1", default_headers=kimi_code_headers())——access_token 当 bearer，伪造头随客户端发。kimi_code_headers()：User-Agent + 全 X-Msh-*(Platform/Version/Device-Name/Device-Model/Os-Version/Device-Id)。kimi_device_id()：env KIMI_DEVICE_ID 优先，否则确定性 uuid5 缺省（绝不每次随机，稳定且来源可测/可配）。model kimi-for-coding 不硬编码（经 .complete(req, model) 传入，路由关注点）。factory.build_adapter 加 provider=="kimi-code" 分支；包 __init__ 导出全部符号。契约校正（已对照 github.com/picassio/pi-kimi-coder extensions/index.ts）：参考实现对 coding API 仅设 User-Agent: "KimiCLI/1.5"（精确值，已采用）、未设 X-Msh-* 头——与 PROGRESS 契约「缺 X-Msh→403」不符；本实现以验证到的 UA 为准 + 附带 X-Msh-* 客户端标识头（真客户端会发、额外标识无害、最大化避免 403）；真 api.kimi.com 联网验证头集是否足够留 K1.3/K1.5（含封号风险，用户自担）。TDD 先红后绿；tests/test_kimi_code_adapter.py(8) + tests/test_kimi_code_factory.py(3)，不联网（断 base_url + default_headers + 稳定 device_id + 工厂分派）。门禁绿（隔离 MYPY_CACHE_DIR=.mypy_cache_k12 已清理）：ruff/format 干净、mypy 27 源文件 Success、pytest 58 passed（47→+11）。@backend 行动（K1.3）：_build_provider_adapter 对 provider kimi-code 调 build_adapter("kimi-code", api_key=<刷新后的 access_token>, base_url=…)；token 刷新/获取归 K1.3。无 OpenAPI 形变，前端无需 re-gen。memory 记 C1 扩（K1.2）契约 + 1 gotcha。

  • [2026-06-19] @db — K1.1 ✅ provider_credentials 加 OAuth 列（C2 扩稳定）。packages/db/ww_db/models.py ProviderCredential：① 加 auth_type: Mapped[str](Text, nullable=False, server_default="'api_key'"，值 api_key|oauth)；② 加 oauth_enc: Mapped[bytes|None](LargeBinary, nullable=True，持 Fernet 加密 JSON {access_token,refresh_token,expires_at})；③ api_key_enc 改 nullable=True(Mapped[bytes|None]，OAuth-only 行无 api_key、既有 api_key 行保值)；UniqueConstraint(owner_id,project_id,provider) 不变。首个新迁移（M1–M5 全零建表）migrations/versions/1f011c42bd4d_provider_credentials_oauth_columns.py（down_revision=220ca2e3d53f）：up=add_column auth_type/oauth_enc + alter api_key_enc→nullable，down 逆向；autogenerate 仅这 3 op 无 noise，手修模板重复 import + 改本仓 ruff 样式（见 gotcha）。upgrade head 已应用、alembic check 无漂移。门禁：ruff/format 干净、pytest 400 passed、alembic 无漂移；mypy 余 2 处 arg-type 错（均在 @backend apps/api/ww_api/services/credentials.py，因 api_key_enc 改 nullable 打穿，K1.3 吸收，见下方 @backend 请求）。memory 记 C2 扩 + 2 gotcha。

  • [请求 → @backend，K1.3]：K1.1 把 provider_credentials.api_key_enc 改 nullable（bytes|None），打穿到你拥有的 apps/api/ww_api/services/credentials.py mypy 报 2 处 arg-type（StoredCredential.api_key_enc: bytes ↳ 现 bytes|None，dataclass line 28 + store line 75/97）。@db 不越权改 apps/api。K1.3 接 OAuth store 时把 StoredCredential.api_key_enc 改 bytes | None（并加 auth_type/oauth_enc 字段 + OAuth 读写路径），mypy 即全绿。oauth_enc 持 Fernet 加密 JSON {access_token,refresh_token,expires_at}（key=settings.credential_enc_key，同 api_key_enc）。

  • [2026-06-19] @orchestrator — 🎉 M1–M5 全部交付 + M5 余项收尾完成。五个里程碑（Phase 0–5）全部 ✅；M5 三项非阻塞余项 + 本次台账归档共四项 follow-up 已清：#1 Codex 读端点（GET /projects/:id/characters + GET .../world_entities，@backend）+ 前端接线（CodexPage 拉全量真源，去「会话内回显」局限，@frontend）；#2 build_adapter provider→适配器工厂 + anthropic mypy 修复（@llm），build_gateway_for_tier 按 provider 选适配器启用 Anthropic/Gemini 真实回退（@backend）；#3 packages/skills 纳入 uv workspace + skill impl（registry/permissions）从 ww_core.domain 迁入 ww_skills（@backend，@devops 加 SDK）；#4 本次把 M5/M4/M3 三段折叠进「已归档阶段」、顶部改短状态行（@orchestrator）。最终门禁全绿：后端 ruff/format 干净、mypy 144 文件、alembic 无漂移、pytest 400 passed；前端 lint/typecheck 干净、vitest 130 passed、build OK。台账已归档，当前无活跃阶段。

  • [2026-06-19] @frontend — M5 follow-up #1 ✅ Codex 展示真源（解余项①）（消费 @backend C3 扩 Codex 读端点，无契约变更）。先 pnpm gen:api 纳入 GET /projects/:id/characters（CharacterListResponse{characters?}）+ GET .../world_entities（WorldEntityListResponse{world_entities?}）+ lib/api/types 加 2 别名。lib/api/server 加 fetchCharacters/fetchWorldEntities（200 空列表非 404，仿 fetchForeshadow）；codex route（Server Component）Promise.all 拉 项目+人物+世界观全量 → 传 CodexPage 初始数据。CodexPage 人物 tab 渲染跨会话持久化真源（刷新不再空），本会话新入库卡经纯函数 mergeCharacterCards（按 name 去重、持久化优先、不重复）合并补显（generate→ingest 后仍即时见新行）；世界观 tab 渲染入库真源（本期无世界观入库端点，故只真源 + 生成器预览，无 session 合并）；时间线维持 P2 占位。纯逻辑 lib/generation/cards.{mergeCharacterCards,mergeWorldEntities} + 5 node-env 单测。前端门禁全绿：gen:api/lint/tsc/vitest 130（125→+5）/build。Codex「会话内回显」局限已去除（解 gotcha + PROGRESS 余项①）。memory 把 Codex 缺口 gotcha 标 RESOLVED。

  • [2026-06-19] @backend — M5 follow-up R1 + R3 ✅（三 fix，与并行 @llm llm_gateway 改动 disjoint）。R1-Codex 读端点（解余项①）：加 GET /projects/:id/characters（CharacterListResponse）+ GET /projects/:id/world_entities（WorldEntityListResponse），复用 C5 读侧 SqlCharacterRepo/SqlWorldEntityRepo（经 get_memory_repos，不动 assemble）+ 反向 JSONB 解包（{"items":[...]}→list/{"text":...}→str/{"rules":[...]}→list），register main；C3 扩稳定。R3-skill 迁包（解余项③）：skill_registry.py+skill_permissions.py 从 ww_core.domain 迁入 packages/skills/ww_skills/（ww_skills/__init__ 改直接导出，删门面）；importer（generation.py/project_deps.py/test_generation.py）改 from ww_skills import …；skill 单测移 packages/skills/tests/（13 测）；删 ww_core.domain 两模块+init 导出；packages/skills/pyproject.toml deps 校准（去 ww-core、补 ww-llm-gateway+sqlalchemy），uv sync 重建。R1#2-build_adapter 接线（解余项②的 apps 侧；@llm 的 build_adapter 工厂 + @devops 的 anthropic/google-genai SDK 均已落地，import 实解非 transient）：build_gateway_for_tier 的 _build_provider_adapter（原 _build_openai_compat_adapter）改调 ww_llm_gateway.build_adapter(provider, api_key=…, base_url=…)——Anthropic/Gemini 传 base_url=None 走原生适配器，去掉直接 AsyncOpenAI/OpenAICompatAdapter import。门禁绿（隔离 MYPY_CACHE_DIR=.mypy_cache_r1backend 已清理）：ruff/format 净、mypy 101 文件 0 error、pytest packages/core packages/skills apps/api 246 passed（226→+20：+10 迁移 skill 测 +3 Codex 读端点测 + 其余）。两新端点入 OpenAPI（验证 get 存在）。memory 登记 C3 扩（Codex 读端点）+ C8 实现位置更新 + build_adapter 接线 + 3 decisions。@frontend 行动：cd apps/web && pnpm gen:api 纳入 GET characters/GET world_entities，CodexPage 初始列表拉全量去掉「会话内」局限（解 gotcha Codex 缺口）。@devops 行动：复核根 uv.lock（@backend 改了 packages/skills/pyproject.toml deps，已 uv sync 重建 ww-skills）。M5 三非阻塞余项①②③ 至此全部清除。

  • [2026-06-19] @llm — R2 follow-up #2 ✅ 真多 provider 适配器选择（C1 扩 follow-up #2 稳定；接 @devops 已加 anthropic+google-genai SDK 之后）。① 修真 SDK 装上后的 mypy 报错：instructor.from_anthropic(self._client) 重载只收 SDK 具体 AsyncAnthropic|...、AnthropicClient Protocol 不匹配 → adapter 内 cast("AsyncAnthropic", self._client)（TYPE_CHECKING import，零运行时硬依赖）选中 AsyncInstructor 重载。gemini 走 response_schema 非 instructor，无该类错。② 新增 provider→适配器工厂 factory.build_adapter(provider, *, api_key, base_url=None) -> ProviderAdapter（包 __init__ 导出）：anthropic→AnthropicAdapter、{gemini,google}→GeminiAdapter、其余→OpenAICompatAdapter(provider, AsyncOpenAI(...))；从 api_key 构真实客户端（factory 处 cast 跨 Protocol read-only-attr 约束，adapter 仍声明 Protocol 形参、测试替身缝完好）。新增 tests/test_build_adapter_factory.py 6 测（按 provider 名断分派，不联网）。门禁绿（隔离 cache）：ruff/format 净、mypy 24 源文件 0 错、pytest 47 passed（41→+6）；全仓 mypy packages apps 144 文件 Success（anthropic.py 报错确认消除、gemini 无同类错）。无 OpenAPI 形变（served_by 不出 API），前端无需 re-gen。@backend 可在 build_gateway_for_tier 用 build_adapter 替换「一律 OpenAICompatAdapter」启用 anthropic/gemini 真实回退。 记 1 gotcha（Protocol vs 真 SDK cast 边界）。

  • [2026-06-19] @orchestrator — 🎉 M5 完成 + 独立复核 ✅（Wave C：T5.3+T5.6 ✅ + Wave D：T5.7 ✅）。波次 A(T5.1‖T5.4‖T5.5)→B(T5.2)→C(T5.3+T5.6)→D(T5.7) 全绿，契约先行、零返工、无新 bug。最终独立复跑确认：后端 ruff/format 干净、mypy 142 文件、alembic 无漂移（M5 复用 T0.2 既有 world_entities/characters/rules/skills 表，全程零建表迁移）、pytest 391 passed；前端 tsc 干净、vitest 125 passed。M5（生成+多provider+扩展）出口 DoD 全达成：worldbuilder/character-gen 生成→预览→入库（continuity 409 gate + partition_writes 白名单 + schema→JSONB 形变）；网关多 provider 回退/熔断/能力降级（真 Gateway 回退链，E2E 验主失败→fallback 服务 + 记账记实际 provider）；Skill registry + 表权限沙箱 + 规则页/技能库/命令面板(⌘K)。M1–M5 全部交付。 非阻塞余项：① Codex 读端点缺口（无 GET characters/world_entities，现以生成+会话内回显管理）；② Anthropic/Gemini 真实回退待 @devops 加 SDK + 按 provider 选适配器类（E2E 用 OpenAI 兼容 mock 验证回退）；③ packages/skills 纳入 uv workspace（现 impl 落 ww_core.domain + façade）。建议下一步：清理 PROGRESS 把 M3/M4/M5 折叠归档，或处理上述余项。

  • [2026-06-19] @qa — M5 Wave D：T5.7✅ M5 E2E + 切 provider（真 pg + mock 多 provider，零 token；无契约变更）。tests/test_m5_e2e.py 3 用例：① 群像生成→入库闭环（mock 网关按 req.output_schema 路由 CharacterGenResult/WorldGenResult/ContinuityReview）：POST /world/generate 预览 + POST /characters/generate 预览 3 卡 → POST /characters 入库双 gate——precheck 有冲突且未 acknowledge_conflicts → 409 CONFLICT_UNRESOLVED+details.conflicts（并断言此刻 characters 表无行，守不变量 #3）→ 带 acknowledge_conflicts=true 重发 201；DB 真源断言 characters 行真落 pg + schema→JSONB 形变（traits/speech_tics→{"items":[...]}、arc→{"text":...}、tags/relations 直落 list），rejected_tables 空（partition_writes 合法路径），4 条 ledger。② 切 provider 回退：HTTP 角色生成跑在真 Gateway（非 stub）deepseek(每次 complete 抛 TransientProviderError 耗尽重试)→openai 回退链上，端点仍 200；served_by 不出 API，故经 DB 真源 usage_ledger 断言实际服务方 = openai(fallback)≠deepseek(primary)（ARCH §4.5 记账记实际服务方）。③ 能力降级：structured_output=False 唯一 provider 直测 Gateway.run → served_by.degraded=True（§4.4）。坑：生成网关是请求 scope 依赖（get_worldbuilder_gateway/get_character_gen_gateway/get_precheck_gateway），直接 app.dependency_overrides 注假网关即可，无需 monkeypatch build_gateway_for_tier（与 M4 学文风后台自建网关不同）。全仓门禁绿：ruff/format 净、mypy 142 文件、alembic 无漂移、pytest 391 passed（388→+3）。未发现 REAL bug。M5 出口 DoD 全达成 → orchestrator 可封 M5。

  • [2026-06-19] @frontend — M5 Wave C：T5.3+T5.6✅ 生成 + 设定库 + 规则 + 技能 + 命令面板（消费 C3 扩 T5.2 + C8/T5.5，无契约变更）。先 pnpm gen:api 纳入 5 端点（world/characters generate + characters ingest + GET rules + GET skills）+ lib/api/types 加 12 别名。T5.3：① 角色生成器（UX §6.6）components/generation/CharacterGenerator：一句话 brief + 数量(1–12) + 定位 → POST /characters/generate 预览卡 → CharacterCardItem（勾选入库 + 就地编辑名/弧光，默认全选）→ POST /characters 入库；409 CONFLICT_UNRESOLVED 裁决流：useCharacterGen 捕 409 → extractIngestConflicts 收窄 details.conflicts(复用 ReviewConflict 形) → ConflictAdjudication 面板展示 continuity 冲突 → 作者「已知悉强制入库」= 带 acknowledge_conflicts=true 重发 / 「取消改卡」。② 世界观设计器 WorldGenerator：POST /world/generate 预览 type/name/rules（本期无入库端点，仅预览参考）。③ 设定库 Codex（UX §6.5）codex/CodexPage + app/projects/[id]/codex：人物/世界观/时间线三 tab（时间线 P2 占位）；?gen=character|world 命令面板跳转直开对应 tab。T5.6：④ 规则页 rules/RulesPage + app/.../rules：四级规则列表(groupByLevel) + 新增(useRules 乐观追加+回滚，仿 useForeshadow)。⑤ 技能库 skills/SkillsPage（Server Component 纯读）+ app/.../skills：GET /skills 按 scope 分组只读注册表(name/tier/reads/writes)。⑥ 命令面板 ⌘K command/{CommandPalette,CommandPaletteMount} + lib/command/palette：⌘K/Ctrl+K 开关、模糊过滤(filterCommands)、上下循环高亮(moveHighlight)、Esc/Enter，a11y(role=dialog/listbox/option + 自动聚焦 + prefers-reduced-motion)；挂 RootLayout 对全局生效，读 pathname 注入项目上下文。⑦ LeftNav ActiveNav 加 codex/rules/skills（替换原 disabled 设定库占位）。纯逻辑全单测（node-env）：lib/{generation/cards,rules/rules,skills/skills,command/palette}.test。前端门禁全绿：gen:api/lint/tsc/vitest 125(96→+29：cards 12 + rules 5 + skills 3 + palette 9)/build（codex/rules/skills 路由齐）。memory 记 2 gotcha + 1 gap（Codex 读端点缺口）。M5 前端交付完成 → 下一步 Wave D：T5.7(@qa) M5 E2E + 切 provider。

  • [2026-06-19] @orchestrator — M5 Wave B 收口 ✅（T5.2，C3 扩稳定）。5 端点入 OpenAPI：world/characters generate 预览 + characters 入库（双 gate：continuity 预检 409 + partition_writes 白名单 + schema→DB 形变）+ GET rules/skills；build_gateway_for_tier 接线回退链（OpenAI 兼容齐，Anthropic/Gemini 真实切换余量 deferred 给 T5.7 + @devops SDK）。全仓门禁绿：ruff/format 干净、mypy 142 文件、alembic 无漂移、pytest 388 passed（371→+17）。下一步 Wave C：T5.3+T5.6(@frontend 单 agent 顺序做)——先 pnpm gen:api，做 角色生成器 + 世界观设计器 + 设定库 Codex + 规则页 + 技能库 + 命令面板（⌘K），入库流处理 409 裁决重发。

  • [2026-06-19] @backend — M5 Wave B：T5.2✅ 生成/入库 API（契约 C3 扩稳定；消费 Wave A 的 C6扩/C8/C1扩，与已合并 Wave A 无写冲突）。routers/generation.py（+ skills_router，已注册 main）落 5 端点：① POST /world/generate（worldbuilder writer 网关 run_worldbuilder → 预览世界观，不入库，末尾 commit 落 ledger）；② POST /characters/generate（character-gen writer 网关，注入已有角色防雷同 → 预览角色卡）；③ POST /characters（入库 双 gate：precheck_generated_cards continuity 预检 analyst 网关——有冲突且未 acknowledge_conflicts → 409 CONFLICT_UNRESOLVED+冲突详情，作者裁决后放行；partition_writes(character_gen_spec,...) 白名单过滤越权写表；过 gate 写 characters 行，schema list/str → DB JSONB dict 形变）；④ GET /rules（规则列表，复用 C5 读侧）；⑤ GET /skills（技能库，经 registry）。新写侧 repo ww_core.domain.{character_repo(traits/speech_tics→{"items"}/arc→{"text"}),world_entity_repo(rules→{"rules"})}（只 flush，端点 commit）。T5.4 follow-up 接线完成：build_gateway_for_tier 据 DB tier_routing.primary+fallback 预备多 OpenAICompatAdapter + 注入 chain_resolver=chain_from_routing(...) 启用回退链；无路由行退回 resolve_route（单 provider，M1 兼容），无可用凭据→503。仅 OpenAI 兼容 provider（deepseek/kimi/qwen/glm/openai）——Anthropic/Gemini 真实回退需 @devops 加 SDK + provider_deps 据 provider 选适配器类（余量 deferred 给 T5.7 切 provider）。全仓门禁绿：ruff/format 净、mypy 142 文件、alembic 无漂移（M5 复用 T0.2 既有表）、pytest 388 passed（371→+17：13 生成/入库端点 + 4 网关回退接线 + 4 形变 helper）。新端点入 OpenAPI（验证 world/characters generate + POST characters + GET rules + GET skills 齐）。memory 登记 C3扩稳定 + 2 decisions（入库 gate / 形变）+ 2 gotchas。@frontend(T5.3/T5.6) 行动：先 cd apps/web && pnpm gen:api 纳入这 5 端点；入库流处理 409（展示冲突→裁决勾选→带 acknowledge_conflicts 重发）。下一步 Wave C：T5.3+T5.6(@frontend)（依赖 T5.2✅+T5.5✅，可起）。

  • [2026-06-19] @orchestrator — M5 Wave A 收口 ✅（T5.1 + T5.4 + T5.5 三 agent 并行，disjoint 目录 + 隔离 mypy cache，零写冲突零返工）。worldbuilder/character-gen 双 spec + 节点 + 入库前 continuity 校验缝（C6扩）‖ 网关多 provider 韧性：Anthropic/Gemini 适配器 + 回退链 + 熔断 + 能力降级（C1扩，无 OpenAPI 形变）‖ Skill registry + 表权限白名单（filter_reads/partition_writes）+ POST /rules（C8 + C3扩）。全仓门禁绿：ruff/format 干净、mypy 135 文件、alembic 无漂移（M5 复用 T0.2 已建的 world_entities/characters/rules/skills 表，无建表迁移）、pytest 371 passed（296→+75）。Wave B 衔接待办（T5.2 @backend 须处理）：① 角色 schema traits/speech_tics(list)/arc(str) ↔ DB JSONB dict 形变，入库须转换；② 入库 gate 调 precheck_generated_cards(continuity 冲突拦截) + partition_writes(越权写丢弃审计)；③ 补 GET /rules + GET /skills 供 T5.6 前端；④ 接线 build_gateway_for_tier→chain_from_routing 启用回退链（T5.7 切 provider 依赖）。@devops 待办：加 anthropic/google-genai SDK 依赖（适配器懒 import，单测不需）；评估把 packages/skills 纳入 uv workspace（现 impl 落 ww_core.domain + ww_skills façade）。下一步 Wave B：T5.2(@backend 生成/入库 API)。

  • [2026-06-19] @llm — M5 Wave A：T5.4✅ 网关多 provider 韧性（契约 C1 扩稳定，仅扩 packages/llm_gateway/，与并行 T5.1 @llm 无文件冲突）。① 新适配器adapters/anthropic.py(AnthropicAdapter：原生结构化经 instructor.from_anthropic 懒构建、cache_control 缓存断点、thinking 能力)+adapters/gemini.py(GeminiAdapter：response_mime_type=json+response_schema 结构化、thinking)——均经注入的客户端 Protocol，不硬 import anthropic/google-genai SDK，单测零联网零依赖。② 回退链 + 重试 + 熔断gateway.py：Gateway 加 chain_resolver/max_retries/breaker(保留 resolver= M1 兼容→自动包成单元素链)；沿链逐 provider→瞬时失败(tenacity 指数退避)重试 R 次→仍失败/熔断打开/无适配器→切下一个；首个成功者服务、非链首标 served_by.fell_back；链耗尽抛 LLM_UNAVAILABLE；记账记实际服务方(回退后不记主模型)；流式仅首块前可切(产出后中途失败上抛不重连)。CircuitBreaker(threshold/reset_seconds/clock) 连续失败超阈值短时熔断、成功清零、冷却半开。③ 能力协商/降级：结构化请求按 capabilities().structured_output 重排链优先选支持者；链上无支持者→降级首个可用(适配器自走 instructor JSON 提示)标 served_by.degraded。④ 瞬时错误契约errors.py：TransientProviderError(三适配器按异常类名+status_code 包装)+网关视 AppError(RATE_LIMITED) 可重试。⑤ routing.py：resolve_chain/chain_from_routing(据 DB tier_routing 去重保序)/ChainResolver 别名导出。⑥ ServedBy 加 degraded(向后兼容，默认 False)；pyproject.toml 加 tenacity>=8.2。23 新测(test_fallback_chain 10/test_capability_degradation 4/test_new_adapters 7/test_multi_provider_accounting 2)，包内 41 passed；全仓门禁绿：ruff/format 净、mypy 135 文件、core+api 226 passed(无回归)。无 OpenAPI 形变(served_by 不出 API，前端无需 re-gen)。memory 登记 C1 扩 + 2 gotcha。后续待办：apps/api build_gateway_for_tier 接线回退链(预备多适配器+传 chain_resolver=chain_from_routing 包装)、@devops 加 anthropic/google-genai SDK 依赖供真实接线。下一步 Wave B(T5.2 @backend，依赖 T5.1)。

  • [2026-06-19] @backend — M5 Wave A：T5.5✅ Skill 运行时 + 规则（契约 C8 + C3 扩稳定；与并行 T5.1/T5.4 @llm 无目录/写冲突，隔离 MYPY_CACHE_DIR=.mypy_cache_t55）。① Skill registry loader（packages/core/ww_core/domain/skill_registry.py）：SkillRecord(frozen,skills 行声明快照) + SkillRepo Protocol + SqlSkillRepo（读 skills 表，裸 tier 非法→VALIDATION） + SkillRegistry.load(repo)（async，每条跑 validate_declaration，越权声明→AppError VALIDATION 加载中断；frozen dict[name,AgentSpec]）+ get/names/list_scope。复用 §5.1 网关机制（不重实现网关），不变量#2 只带 tier。② 表权限沙箱（skill_permissions.py，纯函数/不可变，§5.6「声明式权限+apply 层白名单」非进程沙箱）：KNOWN_TABLES(10 创作表白名单) + filter_reads(注入只喂声明 reads 表) + partition_writes(写库只应用声明 writes，越权→rejected 供审计 log+丢弃) + validate_declaration(reads/writes 越界→VALIDATION)。守不变量#3（allowed 仍过验收 gate，不开写后门）。③ POST /projects/:id/rules（routers/rules.py，已注册 main）：RuleCreateRequest{level:Literal[global/genre/style/project],content(min1)}→201 RuleView{level,content}，非法 level/空 content→FastAPI 422；写侧 domain/rule_repo.py(RuleWriteRepo/SqlRuleWriteRepo/RuleWriteView,只 flush,端点 commit)；喂 assemble 四级 merge_rules。④ 注入缝 get_rule_write_repo/get_skill_registry（project_deps）。门禁绿（限本任务范围）：ruff/format 净、MYPY_CACHE_DIR=.mypy_cache_t55 mypy packages/skills packages/core apps/api 0 error/94 文件、pytest packages/skills packages/core apps/api 226 passed（+18 新测：6 permissions + 4 registry + 2 rule_repo + 3 rules 端点 + 既有）。POST /rules 已入 OpenAPI（验证）。实现位置决策：registry/沙箱落 ww_core.domain（§5.6 强制点在编排/写库层 + packages/skills 当前非 uv workspace member，根 pyproject @devops 未接线）；ww_skills 留再导出门面，待 @devops 纳入 workspace 可迁移（见 decisions/gotchas）。@frontend(T5.6) 行动：先 cd apps/web && pnpm gen:api 纳入 POST /rules（规则页）；技能库经 get_skill_registry(若 T5.6 需 GET /skills 端点，请在此提请 @backend 补)。@llm/T5.2 行动：生成入库层用 partition_writes 守自定义 skill 产出白名单（仅声明 writes 表），仍过验收。

  • [2026-06-19] @llm — M5 Wave A 半程：T5.1✅（C6 扩稳定，与并行 T5.4 @llm/T5.5 @backend 无目录/写冲突，隔离 MYPY_CACHE_DIR）。worldbuilder + character-gen 落地：① schema（packages/agents/ww_agents/schemas.py）WorldEntityCard{type,name,rules:list[str]}/WorldGenResult{entities} + CharacterRelation{name,kind,note?}/CharacterCard{name,role,traits,backstory,arc,speech_tics,tags,relations}/CharacterGenResult{cards}——字段对齐 world_entities/characters DB 列供 T5.2 ingest 直映。② spec（specs.py）worldbuilder_spec(writer,reads=projects,writes=world_entities,硬规则显式 prompt)、character_gen_spec(writer,reads=world_entities+characters,writes=characters,system_prompt 注入「已生成卡+已有角色」差异化要求=M5-a 防雷同)。③ 生成节点（packages/core/ww_core/orchestrator/generation_node.py，模块内自有 GatewayRun Protocol，不重复导出）run_worldbuilder/run_character_gen（build_character_gen_context 把已有+已生成卡序列化成 name(role)：traits 简表注入，空时占位不崩，独立生成、网关失败上抛、parsed 违约 ValueError，只读不写库）。④ 入库前 continuity 校验缝（ARCH §6.5）precheck_generated_cards(spec=continuity_spec,*,cards,world_context,characters_context,...)->list[Conflict]——编排器追加的检查、非 character-gen 直接互调（守 §5.4/不变量#1），T5.2 入库端点调它做 gate。门禁绿（限本任务文件）：ruff/format 净、mypy 本任务 7 文件 0 error（packages/agents packages/core 余 3 error 全在并行 @backend T5.5 的 rule_repo/skill 测试）、pytest 246 passed(+34 新测：22 spec 契约 + 12 节点/防雷同/校验缝)。memory 登记 C6 扩稳定。T5.2(@backend) 行动：POST /world/generate→run_worldbuilder、/characters/generate→run_character_gen(批量循环把已产卡传 generated_so_far)、POST /characters 入库前调 precheck_generated_cards gate；analyst/writer 网关复用 build_gateway_for_tier。下一步 Wave B：T5.2（依赖本任务✅，可起）。

  • [2026-06-19] @docs — spec 一致性回写：把 T4.3 顺带新增的 GET /projects/:id/style（最新指纹 {dimensions, evidence, version}，无指纹 404）补进 ARCHITECTURE.md §7.2 端点表（紧邻 POST /style 行）+ PRODUCT_SPEC.md §6 端点清单（紧邻 POST /style 行），消除 code↔spec 漂移。memory/decisions.md 该决策的「待回写规格」flag 至此已解决。仅改两份 spec，未动代码/测试。

  • [2026-06-19] @orchestrator — M4 收官独立复核 ✅。波次按计划走通 A(T4.2‖T4.1)→B(T4.3)→C(T4.4)→D(T4.5)，每波契约先行 + 全仓门禁收口、零返工、无新 bug。最终独立复跑后端门禁确认绿：ruff/format 干净、mypy 115 文件、alembic 无漂移（M4 全程零建表迁移，全靠 T0.2 预留的 style_fingerprint/chapter_reviews.style/jobs 列表）、pytest 296 passed；前端 gen:api/lint/tsc/vitest 96/build 绿。M4（文风）出口 DoD 全达成：学文风(16 维指纹带证据,版本化,异步 jobs+zombie reaper) + 漂移打分作为第四审真持久化(review 四并行分支+SSE style+chapter_reviews.style) + 回炉同步 diff(不写库守不变量#3)。Phase 4 完成；M1–M4 全部交付。下一阶段 M5(生成+多 provider+Skill) 见 DEV_PLAN，进入时归档 M3/M4 并拉入新表。

  • [2026-06-19] @qa — 🎉 M4 完成（Wave D：T4.5✅ M4 E2E）。tests/test_m4_e2e.py 真 pg + 多档位 mock 网关（零 token）真跑通过 3 用例：① 学文风闭环：POST /style→202 {job_id}→BackgroundTask run_job 自建独立 session 跑 run_style_extraction(analyst 假适配器产 StyleFingerprintResult)→SqlStyleFingerprintWriteRepo.append 真落 pg→GET /jobs/{id} status=done(result.version/dims_count)→GET /style 最新指纹→mode="update" 学一次 version+1；DB 真源 style_fingerprint 2 行(version 1/2,dimensions/evidence)+ jobs 2 行 done。② 写章第四审：学文风后 assemble stable_core 含指纹→POST .../review SSE 四审齐(continuity/foreshadow/pace/style)无 error + section{name:"style"} + style{score:72,segments:[{idx:2,score:40,label:"机翻腔"}]} 帧真发 + GET .../reviews 留痕 style(dict)；DB 真源 chapter_reviews.style 列真填。③ 回炉：POST .../refine→200 {original,refined},refined≠original(writer 据 output_schema is None 返改写串)+ 不写库(无 chapter/review 行,不变量#3)+ writer 记账落 usage_ledger。无新 bug。关键坑(记 memory/gotchas)：学文风 BackgroundTask 在独立 session 上自造网关(build_gateway_for_tier 从凭据建真 OpenAI 适配器)→E2E 无真凭据,须 monkeypatch style.build_gateway_for_tier→真 Gateway 包假适配器(ledger 绑入参 session);写侧 repo + run_job 默认 SqlJobRepo 保持真→指纹/job 真落 pg;override get_session_factory→e2e_sm(同测试 engine/loop)。最终全收口门禁绿：ruff/format 干净、mypy 115 文件、pytest 296 passed(293→+3)、alembic 无漂移(M4 无建表迁移)。M4 出口 DoD 全达成 → Phase 4 可归档。

  • [2026-06-19] @frontend — M4 Wave C：T4.4✅ 文风页 + 漂移 + 回炉 + job 轮询（消费 C3 扩 + C4 扩，无契约变更）。先 pnpm gen:api 纳入 style/refine/GET-style + jobs 类型（lib/api/types 加 4 别名）。① job 轮询：新模式 lib/jobs/job.ts(纯状态机 narrowJob/reducePoll/isTerminal/styleLearnResult——GET /jobs/{id} 是松散 {[k]:unknown} 裸端点须安全收窄) + useJobPoll.ts(setTimeout 轮询，done/failed 终态停，卸载清理)。② 文风页 app/projects/[id]/style/page.tsx(RSC 取 project + GET /style→404 容忍返 null) + components/style/：StyleUpload(多段文本粘贴/选文件 file.text() 读成文本→空行切段→POST /style)、useStyleLearn(受理 202→useJobPoll→done 拉指纹)、FingerprintView(16 维行+可展开证据)。③ 审稿页第四审：lib/review/sse.ts 加 StyleEvent/StyleDriftReport/reduceReview case "style"(替换式仿 pace)/ReviewStreamState.style/seed；history-style 收窄 normalizeStyleDrift 落 lib/style/style.ts；StylePanel(◔ 整体相似度% + 漂移段一键回炉)接进 ReviewReport(seed 扩四态)。④ 回炉 RefineView + useRefine(POST /refine→新旧 diff→采纳：把 refined 替换 finalText 中原段，经既有 draft 路径合入，不另写库守不变量#3；503 优雅提示)。LeftNav 开「文风」入口(ActiveNav 加 "style")。前端门禁全绿：gen:api/lint/tsc/vitest 96(+27：job 12 + style 10 + style-sse 5)/build(含 /projects/[id]/style 路由)。memory 记 1 gotcha。下一步 Wave D：T4.5(@qa) M4 E2E。

  • [2026-06-19] @orchestrator — M4 Wave B 完成 ✅（T4.3，C3 扩稳定）。style/refine 三端点入 OpenAPI：POST /style(202+jobs BackgroundTask 跑 run_style_extraction→StyleFingerprintWriteRepo.append)、GET /style(最新指纹含证据/版本)、POST /refine(writer 网关同步返 {original,refined} 不写库)。全仓门禁绿：ruff/format 干净、mypy 115 文件、alembic 无漂移、pytest 293 passed(+13)。GET /style 顺带补入（回写 ARCH §7.2/PRODUCT_SPEC §6 留 @docs）。下一步 Wave C：T4.4(@frontend)——先 pnpm gen:api 纳入 style/refine/GET-style + jobs 类型，再做文风页(上传/指纹/证据) + lib/jobs/useJobPoll + 审稿页第四审 StylePanel + 回炉 diff。

  • [2026-06-19] @backend — M4 Wave B：T4.3✅ API style + refine（契约 C3 扩稳定）。三端点入 OpenAPI（独立 routers/style.py，仿 outline.py，已注册）：① POST /projects/:id/style → 202 {job_id}（学文风走 jobs，M4-c）：job_repo.create("style_learn")+commit → background_tasks.add_task(run_job, session_factory, job.id, work)；work 在 run_job 自建独立 session 上自造 analyst 网关+写侧 repo → run_style_extraction → 拆 dimensions_json/evidence_json → append(version+1) → {version,dims_count} 落 jobs.result；无凭据 → dep 解析阶段 503（调度 job 前拦下，不凭空写注定失败的 job）。② POST /projects/:id/chapters/:no/refine → 同步 200 {original,refined}（writer 网关 run(refiner_spec)，output_schema=None→resp.text；不写库守不变量#3；末尾 commit 让 usage_ledger 落库）。③ 顺带补 GET /projects/:id/style → 最新指纹 {dimensions,evidence,version}（UX §6.9；ARCH §7.2 原缺读端点——决策见 decisions，待 @docs 回写 ARCH §7.2/PRODUCT_SPEC §6）；不动 C5 读侧 SqlStyleRepo（assemble 行为不变）。新建写侧 domain/style_repo.py(StyleFingerprintWriteRepo/Sql*，append 只 flush + latest 含证据/版本)；project_deps 加 get_style_write_repo/get_style_extract_gateway(analyst)/get_refine_gateway(writer)。全仓门禁绿：ruff/format 干净、mypy 115 文件、alembic 无漂移(M4 无建表)、pytest 293 passed(280→+13)。memory 登记 C3 扩 + 2 decisions + 1 gotcha。@frontend 行动：T4.4 前 cd apps/web && pnpm gen:api 纳入 style/refine/GET style + jobs 轮询类型。下一步 Wave C：T4.4(@frontend)。

  • [2026-06-19] @orchestrator — M4 Wave A 收口 ✅（T4.2 + T4.1 全绿）。全仓门禁收口：ruff/format 干净、mypy 111 文件、alembic 无漂移（M4 无建表迁移）、pytest 280 passed（M3 基线 228 → +52：T4.2 37 + T4.1 15）。契约稳定：C6扩/C4扩（StyleFingerprintResult/StyleDriftReview/四审齐/SSE style 事件）、C3.5（JobRepo/run_job）。下一步 Wave B：T4.3(@backend)——单 @backend agent 顺序做 style/refine 两端点：新建 StyleFingerprintWriteRepo + routers/style.py(POST /style 202 调 job_repo.create+run_job(work=run_style_extraction→StyleFingerprintWriteRepo.append)；POST /refine 同步 refiner_spec writer 网关返 {original,refined})，C3 扩；评估顺带 GET /projects/:id/style。

  • [2026-06-19] @backend — M4 Wave A：T4.1✅ jobs 长任务基建（契约 C3.5 稳定，不碰 style 业务，与并行 T4.2 @llm 无目录/写冲突）。packages/core/ww_core/domain/job_repo.py：JobRepo Protocol + SqlJobRepo(create/set_running/set_progress 夹取/complete/fail/get/reap_zombies) + frozen JobView——状态写只 flush(提交归 run_job/端点)，唯 reap_zombies 启动期独立调用故自 commit。apps/api/ww_api/services/job_runner.py：通用 run_job(session_factory, job_id, work) 自建独立 session(仿 run_overdue_scan)→set_running→work→complete/异常→新 session fail，异常吞不冒泡；最小 JobLifecycleRepo Protocol + 可注入 repo_factory 缝。get_job_repo 加进 project_deps；main.py lifespan 在 seed_stub_user 后跑 reaper(M4-d，幂等自 commit)。门禁绿(限本任务文件)：ruff/format 干净、mypy 本任务文件 0 error(packages/core apps/api 余 7 error 全在 @llm 在做的 test_style_*)、pytest 15 新测(13 job_repo+2 job_runner)，packages/core 130 passed / apps/api 50 passed。memory 登记 C3.5。T4.3 行动：POST /style 调 job_repo.create + background_tasks.add_task(run_job, session_factory, job.id, work=…)。

  • [2026-06-19] @llm — M4 Wave A 半程：T4.2✅（C6 扩 + C4 扩稳定）。style-auditor 双轨落地：①提取轨 style_extract_spec(analyst,独立生成仿 outliner,不进 review 图)+StyleFingerprintResult{dimensions:[StyleDimension{name,value,evidence}]}(16 维带证据)+orchestrator/style_extract_node.py(build_style_extract_request/run_style_extraction,模块内自有 GatewayRun Protocol,网关失败上抛/parsed 违约抛 ValueError,只读不写库)；②漂移轨第四审 style_drift_spec(name="style",light,只读)+StyleDriftReview{score=100,segments:[StyleDriftSegment{idx,score,label?}]}(默认值即无指纹降级态)→REVIEW_SPECS 四审齐；collect 加 STYLE/extract_style→record style= 列；sse 加 EVENT_STYLE/style_event+_section_result_events STYLE 分支(style{score,segments},字典序 continuity<foreshadow<pace<style 天然纳入)；③回炉 refiner_spec(writer,output_schema=None 纯文本,非持久)。门禁绿：ruff/format 净、mypy 47 文件(隔离 cache 避与 @backend T4.1 竞争)、packages/agents+core pytest 197 passed(+37 新测：双轨 spec/schema 契约 + 四审图跑通 len(calls)==4 + collect 落 style 列 + SSE style 事件 + 无指纹降级落库)。memory 登记 C6扩/C4扩。T4.1(@backend) 已并行完成→ Wave B：T4.3(@backend style/refine 端点) 可起，调本任务 run_style_extraction/refiner_spec。

  • [2026-06-19] @orchestrator — 进入 M4（文风）：归档心智上 M3，Phase 4 五任务拉入台账。探查确认免重复建表：style_fingerprint 表/chapter_reviews.style 列/jobs 表+GET /jobs/:id/读侧 SqlStyleRepo.latest 均已在前期建齐 → M4 无新建表迁移；assemble 已把指纹纳入 stable_core → 第四审天然在 review_context 拿指纹对照、无需额外注入。已定决策：style-auditor 双轨拆 style_extract_spec(analyst,独立生成,仿 outliner)+style_drift_spec(light,第四审并入 REVIEW_SPECS)；学文风走 jobs+BackgroundTask(独立 session,仿 run_overdue_scan)+启动 zombie reaper；回炉 refine 同步返回 {original,refined} 不写库（守不变量#3）。启动 Wave A：T4.2(@llm·agents+orchestrator) ‖ T4.1(@backend·jobs 基建)（不同目录,隔离 MYPY_CACHE_DIR）。

  • [2026-06-18] @orchestrator — 🎉 M3 完成（T3.8✅ 修复 + @qa 解钉 xfail）。T3.8 把 SqlAlchemyLedgerSink.record 改 add-only（去并行路径里唯一的 await flush()，靠端点/事务 commit 持久化），并发回归测试 RED 已验旧实现抛 Session is already flushing；@qa 移除 T3.7 case3 strict-xfail、收紧为严格正向断言（三审 section 齐 + foreshadow/pace 真发事件 + chapter_reviews.foreshadow_sug/pace 列真填 + beat_map 精确断言）。最终全收口门禁绿：ruff/format 干净、mypy 111 文件、pytest 228 passed(0 xfailed/0 failed)、alembic 无漂移；前端 lint/tsc/vitest 69 绿。M3 出口 DoD 全达成。 下一阶段 M4（文风）。

  • [2026-06-18] @orchestrator — M3 Wave E：T3.7✅ E2E 交付 + 暴露并发 bug。tests/test_m3_e2e.py 真 pg 跑通：① 伏笔 埋设→进展→验收后 BackgroundTask 扫描置 OVERDUE→看板过滤(DB 真源)✓ ② 大纲 POST .../outline→outline 表行+窗口+幂等 upsert+记账✓。③ 三审 SSE 用例 strict-xfail 钉住真 bug：三审同 LangGraph superstep 并行 + 共用请求 session 的 SqlAlchemyLedgerSink.record(add+await flush)→AsyncSession 非并发安全→第二/三审 flush 撞「Session is already flushing」→被 run_review 失败隔离静默吞成 incomplete→foreshadow/pace 静默丢失(SSE 无事件、chapter_reviews 列空)。M2 单审未触发。基线 222 passed + 1 xfailed。开 T3.8(@llm) 修复 → 修后 @qa 解钉 xfail → 才算 M3 达成。

  • [2026-06-18] @orchestrator — M3 Wave D 完成（T3.6✅）。前端三块落地：伏笔四泳道看板（/foreshadow，OVERDUE 琥珀 + 登记/转移乐观更新）、大纲编辑器（/outline，逐章 beats + 伏笔窗口徽标 + 接近回收提示）、审稿页扩消费 foreshadow/pace SSE（伏笔建议区 + 节奏节拍图 ▁▃▅，三审齐显，文风第四审留 M4）。pnpm gen:api 纳入 M3 端点（看板/登记/转移/大纲），松散 JSONB 字段安全收窄不手写。前端门禁绿：gen:api/lint/tsc/vitest 69(+24)/build。memory +1 decision +2 gotchas。下一步 Wave E：T3.7 M3 E2E(@qa 真 DB + mock 网关零 token)。

  • [2026-06-18] @orchestrator — M3 Wave C 完成（T3.5✅，C3 扩稳定）。GET .../foreshadow?status= 看板（续 foreshadow.router，四泳道）+ POST .../outline（独立 outline.py：run_outline analyst 网关 → 逐章 upsert outline 表含伏笔窗口 → 端点末尾 commit）。outline 写侧 repo 加 Write 前缀避撞 C5 读侧。全仓门禁绿：mypy 102 文件、pytest 220 passed(205→+15)。memory 登记 C3 扩 + 1 decision + 1 gotcha。下一步 Wave D：T3.6(@frontend 伏笔看板 + 大纲编辑器 + 节奏节拍图 + 审稿页消费 foreshadow/pace SSE，先 pnpm gen:api)。

  • [2026-06-18] @orchestrator — M3 Wave B 完成（T3.2✅）。验收后到期扫描挂 BackgroundTask（run_overdue_scan 自建独立 session 置 OVERDUE，接 §5.5 TODO(M3)）+ 伏笔登记/状态端点（POST/PATCH .../foreshadow，重复 code/非法转移→VALIDATION 422，未动 shared 错误码）。全仓门禁绿：mypy 95 文件、pytest 205 passed(196→+9)。memory 登记 C3 扩 + 1 decision + 2 gotchas。下一步 Wave C：T3.5(@backend GET .../foreshadow?status= 看板续接 foreshadow.router + POST .../outline 独立 outline.py 调 run_outline)。

  • [2026-06-18] @orchestrator — M3 Wave B 半程（T3.3✅，C4/C6 扩稳定）。foreshadow-analyst + pace-checker 并入 build_review_graph（REVIEW_SPECS 三审齐，文风第四审留 M4）；collect 一次 record 分列落 conflicts/foreshadow_sug(扁平+kind 标记)/pace(整 dict)；normalize_review 加 foreshadow/pace SSE 事件（向后兼容）。全仓门禁绿：ruff/format 干净、mypy 91 文件、pytest 196 passed(169→+27)。memory 登记 C4/C6 扩 + 2 gotchas。Wave B 顺序执行：T3.3 改完 orchestrator → 现启 T3.2(@backend apps/api)，对最终 orchestrator 构建、无编译竞争。

  • [2026-06-18] @orchestrator — M3 Wave A 完成（T3.1✅ + T3.4✅）。两 agent 并行（@backend core/domain ‖ @llm agents+orchestrator，隔离 MYPY_CACHE_DIR 避缓存竞争）。T3.1：伏笔纯函数状态机(OPEN/PARTIAL/CLOSED/OVERDUE 全转移+到期判据)+写侧账本 repo(ForeshadowLedger*，加 Ledger 前缀避撞 C5 读侧)。T3.4：outliner spec + OutlineResult schema(含 foreshadow_windows)+run_outline 节点(只读不写库，C6 扩稳定)。全仓门禁绿：ruff/format 干净、mypy 90 文件、pytest 169 passed(114→+37+18)。memory 登记 C6 扩 + 2 decisions + 2 gotchas。下一步 Wave B：T3.2(@backend 到期扫描+登记接口) ‖ T3.3(@llm foreshadow/pace 第三审并入 review_specs)。

  • [2026-06-18] @orchestrator — 进入 M3：归档 Phase 2(M2) 至已归档；Phase 3 七任务拉入台账。沿用 M2 节奏：契约先行 + 分目录并行 + 全仓门禁收口。核对：foreshadow 表已在 T0.2 建齐 → M3 无新建表迁移；T3.1「Repository+状态机」据实记 @backend（落 core/ww_core/domain/，同 T2.3 先例）；T3.3 复用 M2 build_review_graph 的 review_specs 扩展点加 foreshadow/pace 两审（文风第四审留 M4）。启动 Wave A：T3.1(@backend·core/domain) ‖ T3.4(@llm·packages/agents+orchestrator)（不同目录，无写冲突）。

  • [2026-06-18] @orchestrator — 🎉 M2 完成（Wave E：T2.7✅）。tests/test_m2_e2e.py 真实 pg + 多档位 mock 网关（零 token）真跑通过 2 用例：主用例串 立项→写章 SSE→自动保存→审稿 SSE(section/conflict)→GET 历史→残缺裁决触发 409 CONFLICT_UNRESOLVED+missing_indices(gate 事务前拦截未写库)→全量裁决+终稿验收(200, accepted v2)→DB 真源逐项断言：chapters draft v1 留存 + accepted v2(content==final_text)、chapter_digests.facts 追溯终稿标记(证 #4 digest 从终稿非草稿)、chapter_reviews.decisions 写回、usage_ledger 三档位(writer/analyst/light)各落一条且事务已 commit；补充用例验证零冲突直通。无新 bug（M1 曾暴露的 ledger 提交 bug 在 M2 三档位无复发——review 流末 + accept 事务末均 commit）。最终全收口门禁绿：ruff/format 干净、mypy 90 文件、pytest 114 passed、alembic 无漂移（M2 全程零建表迁移）。M2 出口 DoD 全达成。下一阶段 M3（伏笔+节奏）。

  • [2026-06-18] @orchestrator — Wave D 完成（T2.6✅）。审稿报告页落地：app/projects/[id]/review（RSC 取历史）+ components/review/*（报告卡/就地标注/AcceptPanel）+ lib/review/*（SSE reducer/裁决完整性/请求体组装，纯逻辑单测）。pnpm gen:api 纳入 review/accept/reviews 三端点类型（不手写）；SSE 沿用 useDraftStream 的 fetch+ReadableStream 范式；五类冲突就地朱砂锚点(R6 段级降级)+裁决(采纳/忽略/手改)+未决禁验收 gate+409 missing_indices 高亮+「本次将更新」清单。前端门禁绿：gen:api/lint/tsc/vitest 45(+21)/build。memory +1 decision +2 gotchas。下一步 Wave E：T2.7 M2 E2E(@qa 真实 DB + mock 网关零 token)。

  • [2026-06-18] @orchestrator — Wave C 完成（T2.4✅ + T2.5✅，C3 扩稳定，单 @backend agent 顺序做）。三端点入 OpenAPI：POST .../review(SSE section/conflict/done) + GET .../reviews(新→旧) + POST .../accept。验收：冲突 gate（裁决 conflict_index 须覆盖 review.conflicts 全下标，缺判→409 CONFLICT_UNRESOLVED+missing_indices）→ 终稿 digest 提炼在事务外(R2，light 档)→ 单原子事务 promote(R4)+digest.append(#4)+set_decisions、末尾一次 commit、失败全回滚(R3)。build_gateway_for_tier 统一多档位网关注入。全仓门禁绿：ruff/format 干净、mypy 83 文件、pytest 112 passed（+9）。memory 登记 C3 扩 + 1 decision + 2 gotchas。下一步 Wave D：T2.6(@frontend 审稿页+裁决+验收 gate，先 pnpm gen:api)。

  • [2026-06-18] @orchestrator — Wave B 完成（T2.2✅，C4 扩稳定）。审稿子图落地：build_review_graph(START→continuity 并行审→collect→END，可扩四审) + collect_reviews 落 chapter_reviews 留痕 + normalize_review(SSE 加 section/conflict)；M1 build_write_graph 不动。划清边界：本任务到 collect+归一缝为止，interrupt/accept 事务接线交 T2.4（对齐 R3：accept 从领域表重读、checkpoint 仅控制流）。全仓门禁绿：ruff/format 干净、mypy 80 文件、pytest 103 passed。memory 登记 C4 扩 + 3 gotchas（reducer/add_node 重载/失败隔离两层）。下一步 Wave C：T2.4+T2.5（单 @backend agent 顺序做：验收事务+冲突 gate / review API+历史，避免 apps/api 路由+OpenAPI 写冲突）。

  • [2026-06-18] @orchestrator — Wave A 完成（T2.1✅ C6 稳定 + T2.3✅）。两个 fresh agent 并行（@llm packages/agents+llm_gateway ‖ @backend core/domain，目录不相交无冲突）。补上 M1 遗留网关缺口：Gateway.run() 经 instructor 接通 output_schema→LlmResponse.parsed（改 C1，见 contracts 变更日志）。T2.3 写侧三 repo（章节 accepted 晋升/digest append/审稿留痕+裁决）只 flush 不 commit、交 T2.4 事务。全仓 compose 门禁绿：ruff 干净、format 干净、mypy 77 文件、pytest 89 passed。memory 已登记 C6+C1 变更+2 decisions+3 gotchas。下一步 Wave B：T2.2(@llm 并行审图+collect 留痕+review SSE，依赖 C6+C4)。

  • [2026-06-18] @orchestrator — 进入 M2：归档 Phase 1(M1) 至已归档；Phase 2 七任务拉入台账。计划核对两处偏差并据实修正：(1) T2.3「Repository 逻辑」落 packages/core/ww_core/domain/（@backend owned）而非 packages/db——DB 全 MVP 表 + 唯一约束 (project_id,chapter_no,version) 已在 T0.2(@db) 一次建齐、M2 无新建表迁移，故 T2.3 由 @backend 承接 Repository 逻辑；(2) 网关结构化输出缺口：Gateway.run() 当前不消费 output_schema/不填 LlmResponse.parsed（instructor 未接线），续审依赖此，归入 T2.1(@llm)。启动 Wave A：T2.1(@llm·packages/agents+llm_gateway) ‖ T2.3(@backend·core/domain)（不同目录，无写冲突）。

  • [2026-06-18] @orchestrator — 🎉 M1 完成（Wave E：T1.9 E2E✅）。真实 DB + mock 网关 E2E 走通 立项→写章 SSE→自动保存→DB 真源断言（projects/chapters/usage_ledger）。E2E 暴露并修复一个生产 bug：draft SSE 端点未提交注入 ledger 的请求 session（SqlAlchemyLedgerSink 按设计只 flush、不 commit——写库事务归编排层），导致真实写章的 usage_ledger 行被回滚丢失（违背「成本账本从第一天」）。修复：draft 端点流耗尽后 await session.commit()；E2E 改用请求 session 做 ledger、去掉手动 commit 以回归校验该提交。最终全门禁绿：ruff / mypy 68 / pytest 57 / alembic 无漂移；前端 gen:api/lint/tsc/vitest 24/build 绿。

  • [2026-06-18] @orchestrator — Wave D 完成（T1.5+T1.6+T1.8✅，单前端 agent）。pnpm gen:api 重生成客户端含全 M1 端点；路由 /(作品库)、/projects/new(5 步向导)、/projects/[id]/write(工作台 SSE 打字机+停+自动保存)、/settings/providers(脱敏+测试连接+能力徽标)。前端门禁全绿：gen:api/lint/tsc/test 24/build。M1 占位（无 API 支撑、未造假端点）：单章导航、本章助手/注入透明面板(M2)、向导主角/世界观字段折叠进 premise、档位路由只读。下一步 Wave E：T1.9 E2E(@qa, mock 网关)。

  • [2026-06-18] @orchestrator — Wave C 完成（T1.4✅ 立项+写章 API，C3 稳定：M1 端点全落）。记忆→网关→编排器串成 HTTP：5 端点入 OpenAPI，写章 SSE(token/done/error) + 幂等自动保存，lifespan 幂等 seed stub user（修 owner_id FK 缺口）。网关从凭据构建、测试经 dependency_overrides 注 mock。全仓 compose 绿：ruff、mypy 68 文件、pytest 56 passed。后端/编排全部完成。下一步 Wave D：单个前端 agent 做 T1.5+T1.6+T1.8（同一 Next 应用合并做，先 pnpm gen:api），避免 apps/web 写冲突。

  • [2026-06-18] @orchestrator — Wave B 完成（T1.3✅ 编排器/C4稳定 + T1.7✅ 凭据/C3部分）。两个 fresh agent 并行（各 ~90–98k tokens，比 fork 省）。全仓 compose 门禁绿：ruff、mypy 61 文件、pytest 48 passed。修了跨包测试碰撞（apps/api fakes.py→fakes_providers.py；root mypy 排除 conftest.py 解决多 rootless conftest 同名）。⚠️ Wave C 前置：DB 无 stub user，而 projects/usage_ledger/provider_credentials.owner_id 均 FK→users.id；T1.4 须先幂等 seed stub user(uuid(int=1))。下一步 Wave C：T1.4(@backend 立项+写章 SSE+自动保存，依赖 C4)。

  • [2026-06-18] @orchestrator — Wave A 完成（T1.1✅ + T1.2✅，契约 C1/C5 稳定）。全仓 compose 门禁绿：ruff 干净、mypy 45 文件、pytest 27 passed（9 基线 +10 网关 +8 记忆）。T1.1 网关由 orchestrator 内联实现（原 fork 因 stream idle timeout 早夭、零产出）；T1.2 记忆由 fork 完成。下一步 Wave B：T1.3(@llm 写章节点+SSE，依赖 C1+C5) + T1.7(@backend 凭据，依赖 C1)。

  • [2026-06-18] @orchestrator — 进入 M1：把 Phase 1 九任务拉入台账并归档 Phase 0；新增 workspace 成员 packages/llm_gateway(ww-llm-gateway) + packages/core(ww-core)，装 openai/instructor/langgraph/langgraph-checkpoint-postgres/cryptography/tenacity，根 pyproject.toml members+mypy_path 已更，uv sync 通过，基线门禁全绿(ruff/mypy 27 文件/pytest 9 passed)。记录 decision：assemble 返回中性文本以解耦 T1.1‖T1.2。启动 Wave A（T1.1 @llm + T1.2 @backend）。

  • [2026-06-18] @devops/@db/@backend/@frontend — Phase 0 全部完成：monorepo(uv workspace + pnpm)、16 MVP 表迁移(无漂移)、FastAPI(structlog+request_id+错误信封+/jobs/:id)、Next.js(纸感 token + OpenAPI→TS gen:api)、CI。门禁全绿，API 实跑 200。下一步 M1/T1.1(网关接口)。

  • [2026-06-18] @docs — DEV_PLAN 与规格对齐修订：T0.3 加可观测性底座(structlog+request_id)、T1.1 加 usage_ledger 记账(从第一天)、T0.2/T2.3 统一建表口径(全 MVP 表一次建齐, T2.3 仅 Repository)、T4.2 把文风漂移并入第四审、新增 PUT .../draft 自动保存端点并回写 ARCH §7.2 + contracts C3。

  • [2026-06-17] @docs — 四份规格 + CLAUDE.md + 协同系统（PROGRESS/memory）就绪；可进 Phase 0 / T0.1。

  • [2026-06-19] @llm — K1.2 修头：Kimi Code 适配器 kimi_code_headers() 改为仅 {"User-Agent": "KimiCLI/1.5"}，删全部 X-Msh-* 头 + kimi_device_id/KIMI_DEVICE_ID/确定性 device-id 机制（K1.5 联网实测：有效 token 下 X-Msh-* 疑似触发 401 Invalid Authentication；对齐 pi-kimi-coder = UA-only）。改 adapters/kimi_code.py + __init__ 导出 + 两测（adapter 6 测/factory 3 测，断 default_headers 仅 UA、无 X-Msh-*）。更 contracts C1扩（头集 UA-only）+ gotcha。门禁绿：ruff/format/mypy/pytest（56 passed）。

  • [2026-06-19] @backend — bugfix 空写章 prompt：assemble（C5）从不含项目 premise/logline/theme/title 且无写章指令 → 全新项目（仅 premise）产空 stable_core+volatile，写章触发 LLM 400 message must not be empty。修复：MemoryRepos 加第 8 repo project:ProjectSpecRepo（SqlProjectSpecRepo 按 project_id 读 projects）；assemble 把「作品蓝本」放入 stable_core 首段（书级 spec→缓存前缀，守 #9）+ volatile 始终含「请创作第 N 章的正文。」。改 domain/repositories.py(+ProjectSpecView/Repo) · memory/sql_repositories.py(+SqlProjectSpecRepo, sql_memory_repos 装配) · memory/assemble.py(_build_spec_section + 注入)；测试 test_memory.py(+bare-project/chapter-directive 两测+fake) · test_projects.py/test_generation.py(补 project= fake)。无 DDL/迁移（只读既有列）。门禁全绿：ruff/format/mypy(154 文件)/alembic check(无漂移)/pytest 438 passed。更 contracts C5 + gotcha。消费方注意：手搓 MemoryRepos(...) 须补 project=。