kai/writer-work-flow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
164 Commits 1 Branch 0 Tags
9ee7c7b0003ebd6101d7dedb8d937ff522fa420b
Commit Graph

49 Commits

Author SHA1 Message Date
Yaojia Wang
bf3dabea82 perf(backend): 角色/世界观入库改批量——create_many 一次 flush 落全部行 
角色入库端点与 toolbox world_entities 入库端点原逐卡/逐条 create（每行一次
SELECT/flush/refresh，N+1 round-trip）。新增 create_many：世界观用 add_all，
角色用一次 IN 查已有名 + 一次 flush（保持 (project_id,name) upsert 幂等与批内
重名去重、保序返回）。单条 create 薄封装 create_many，行为不变（既有调用方/E2E
复用）。复活并复用 CharacterWriteFields、新增 WorldEntityFields 作批量入参。
补两端点「多行一次落库」测试；既有幂等/冲突 gate 测试与 m5 真 pg E2E 全绿。
 2026-07-08 12:44:07 +02:00
Yaojia Wang
0892ff6cda feat(backend): 无界列表端点加分页——projects/templates 支持 limit/offset 
GET /projects 与 GET /templates 原一次返回全部 owner 行，行数随数据线性增长。
新增可复用分页依赖 ww_api.pagination.get_page（limit∈[1,200] 默认 50、offset≥0，
越界 → 422），两端点接入，Repository.list_for_owner 加 keyword-only limit/offset
把 LIMIT/OFFSET 下推 DB。向后兼容：不传参返回第一页。补 projects 分页 + 边界 422 测试。
 2026-07-08 12:39:31 +02:00
Yaojia Wang
c596a8d342 perf(backend): 大纲卷过滤下推 DB WHERE——list_for_project 加 volume 参数 
GET /outline?volume=N 原在端点 Python 侧过滤全部章节；现把 volume 条件下推到
OutlineRepo.list_for_project 的 DB WHERE，只查该卷行（少读多余卷 + 语义正确）。
Protocol/SqlOutlineRepo/各 OutlineRepo fake 同步加 keyword-only volume；补 repo 级
下推断言测试。向后兼容：不传 volume 仍返回全部（默认 None）。
 2026-07-08 12:34:06 +02:00
Yaojia Wang
4a09f273d9 feat(llm): 整章重写预检澄清 spec + 教条 clarify_rewrite（WFW-9 M2） 
镜像 clarify_refine（仅 name/prompt 不同，复用 ClarifyDecision，不新增 schema）：
新增 clarify_rewrite_spec（analyst 档、reads=()/writes=() 只读，不变量 #2/#3）+ 章级
教条 prompts/clarify_rewrite.md（segment→整章：判作者章级重写意见是否含糊）。注册进
SPECS/SCHEMA_CATALOG，自检数量 24→25，__init__ 导出，金标准仅新增 1 条哈希无漂移。
 2026-07-08 11:42:21 +02:00
Yaojia Wang
e08b01ac58 test(llm): 锁定 llm_provider_failed 失败日志 request_id 条件透传（CR-H4 收尾） 2026-07-08 11:29:27 +02:00
Yaojia Wang
e1a24a2c2c fix(backend): API 文本输入加 max_length + 请求体大小中间件（CR-H9） 2026-07-08 10:53:44 +02:00
Yaojia Wang
25d48b7aa7 fix(backend): 冻结 TOOLBOX 注册表为只读 MappingProxyType（CR-H7） 2026-07-08 10:41:15 +02:00
Yaojia Wang
8a2b1b09dc fix(llm): 流式路径加首 token 前 per-provider 重试（CR-H6） 2026-07-08 10:26:29 +02:00
Yaojia Wang
51fe9f44fe fix(llm): request_id 条件透传贯通网关日志（CR-H4，守 §9.3） 2026-07-08 10:24:55 +02:00
Yaojia Wang
afeac51422 fix(llm): 删除未实现的 LlmRequest.thinking 字段（CR-H5，YAGNI） 2026-07-08 10:22:34 +02:00
Yaojia Wang
cb8fddfc3b fix(llm): Anthropic 结构化输出记真实 usage——修计费记 0 成本（CR-H3） 2026-07-08 10:21:18 +02:00
Yaojia Wang
1652ad9d20 feat(backend): AI 反问澄清预检端点——refine 侧结构化 clarify（WFW-9 M1，路线A 两阶段） 
润色「再沟通」意见含糊时先反问给选项（路线A：问题走独立非流式 JSON 预检端点，正文仍走
既有 refine 一字不改）。新增：
- ClarifyDecision/ClarifyQuestion/ClarifyOption 结构化 schema（既有 output-schema 处，供
  producer 与端点共用）；clarify_refine.md 教条（含糊→need_clarification+≤1问+2–4锚定选项+
  自由输入；明确→verification 放行；防循环）；注册 clarify_refine_spec(analyst 档,#24)+
  SCHEMA_CATALOG + 重生成金标准。
- clarify_node：build_clarify_request 纯函数(缓存前缀不含易变) + run_clarify（gateway.run
  结构化，判别/校验失败确定性回退 need_clarification=false，只读不写库）。
- POST /projects/{id}/chapters/{no}/refine/clarify → ClarifyDecision（analyst 网关，404/503，
  末尾 commit 记账）。**既有 refine 端点/RefineRequest/Response 完全未改**。
门禁绿：ruff/mypy 227/pytest 900(+test_clarify_spec/_node/style clarify)/alembic 无漂移。
 2026-07-08 08:47:13 +02:00
Yaojia Wang
6ed9c89430 feat(backend): 整章再沟通/重写 SSE 端点——喂当前草稿+意见+完整记忆注入流式重写一版 
WFW-8 整章级再沟通（后端）。新增 POST /projects/{id}/chapters/{no}/rewrite（SSE）：
- rewrite.md 教条（品类无关内核，非 SPEC，仿 write_craft 经 load_prompt 读盘）；
- rewrite_node：build_rewrite_request 纯函数（system=[rewrite教条,stable_core] cache 前缀；
  input=近况+当前草稿+作者意见，断点后不入缓存前缀——守不变量 #9）+ stream_chapter_rewrite；
- RewriteStreamRequest{feedback,prior_draft}（带 max_length 上界）；端点复用 assemble 记忆注入
  + normalize_deltas SSE，只读不写库（HITL，新版停前端接受才落，不变量 #3），是工具非写节点
  （不破坏 章=f(outline,state) 纯函数，不变量 #7），项目不存在触网关前 404。

门禁绿：ruff / mypy 224 files / pytest（新增 test_rewrite_node 5 例 + 更新 doctrine 一一对应）/
alembic 无漂移。OpenAPI 含新路径 + schema（前端待 gen:api）。
 2026-07-08 07:04:42 +02:00
Yaojia Wang
7babb4854b feat(web): 角色群像按定位配比生成（role_mix 缩减版） 
- 契约: CharacterGenerateRequest 加 role_mix{定位:数量}，model_validator 归一
  count=各值之和（每项≥1、总和≤12），缺省退回单一 role+count
- @llm: build_character_gen_context/run_character_gen 加 role_mix 参并注入配比块
  （确定性、无时间戳，守 assemble 纯函数）；router 穿参
- character-gen.md 加"按配比严格分配 role"纪律 + regen prompt_hashes 金标准
- 前端: sanitizeRoleMix/roleMixTotal + buildCharacterGenerateRequest 第4参 +
  useCharacterGen 穿参 + RoleMixEditor + CharacterGenerator 单一/配比双模
 2026-07-06 17:24:16 +02:00
Yaojia Wang
72b3c81146 feat(review): 人物塑造 advisory 审（第五审，仅建议不阻断验收） 
写→审链新增第五审「人物塑造」（灵感③/D2）：advisory 单维——仅建议、不阻断
验收（不进 conflicts、不碰 assert_conflicts_resolved、不入 REVIEW_RESERVED_NAMES）；
只做人物塑造、不做氛围。

- SPEC characterization_spec（analyst，reads=("characters",)，writes=()）+
  prompts/characterization.md（只读、显式忽略文本长度与辞藻华丽度、引用逐字片段+置信度）
- schema CharacterizationReview{issues[...]}（全字段默认值守解析韧性）+ 注册 catalog
- 计数三处 22→23 + regen prompt_hashes.json（仅加一条）
- DB chapter_reviews 加 characterization JSONB nullable 列（迁移 f6a7b8c9d0e1）
- 接线：graph REVIEW_SPECS 追加 · chain ReviewRecordRepo · collect(extract/record) ·
  review_repo(Protocol/Sql/_to_view/ReviewView) · sse(event/factory/section) · normalize 自动纳入
- 契约 ReviewHistoryItem 加 characterization（gen:api 已重生成）
- 前端 sse/history/useReviewStream + CharacterizationPanel（只展示无裁决 UI、置信度降序+低置信折叠）+ ReviewReport 挂面板
- 测试 test_characterization_does_not_block_accept + 计数/golden + collect/normalize + 前端 reducer/normalize/parse

守不变量 #2/#3/#9；依赖 ⑧（motive/appearance 作客观锚点）。
 2026-07-06 17:08:38 +02:00
Yaojia Wang
2a7a865e98 feat(core): continuity 冲突裁决反哺——上一已验收章保留裁决入本章 volatile 前瞻约束 
灵感②/D3 窄版 v1：assemble 读上一已验收章的 continuity 冲突作者裁决
（decisions.items 按 conflict_index join 回 conflicts 取正文），仅保留
verdict∈{accept,manual}、去重、按 conflict_index 排序、有界 top-3，
用确定性字符串模板改写成前瞻正向约束，注入本章 volatile「上一章冲突提醒」。

- 绝不调 LLM、绝不反哺 advisory（style/pace/characterization 无作者裁决 oracle）——守不变量 #3/#4。
- 只入 volatile、永不进 stable_core 缓存前缀（依赖上一章裁决、每章易变）——守 #9。
- assemble 仍是确定性纯函数、字节稳定、可缓存——守 #6/#7。
- decisions 非空=已验收（只在验收事务写入）；未验收上一章不反哺——守风险#5。
- MemoryRepos 末位加 review: ReviewRepo | None = None（默认 None→优雅降级不反哺），
  docstring 8→9；sql_memory_repos 工厂补 review=SqlReviewRepo（既有构造点靠默认无需感知）——守风险#6。
 2026-07-06 16:38:06 +02:00
Yaojia Wang
02d19019f6 feat(web): AI 立项方案生成+预填（种子门控 + 按字段接受） 
向导阶段（project 未建）一键推演结构化书级蓝图预填立项向导。

- 新 SPEC project_plan_spec（analyst 档，纯预览 reads/writes=()）+ schema
  ProjectPlanResult（书名候选 + 时空背景/叙事结构/故事核心/结局设计/基调，
  全字段默认值守解析韧性）+ 注册 SCHEMA_CATALOG；计数三处 21→22 + regen golden。
- 端点 POST /skills/project-plan/generate（不带 project 前缀，绕开 toolbox 404）：
  请求体序列化向导草稿为 project_context，复用 build_brief_context + run_generator；
  种子门控（缺 genre/logline→422）；请求 schema 加 max_length 上界。
- run_generator/_build_request 的 project_id 放宽 uuid.UUID|None（向导无 project）。
- 前端 wizard.ts 加 mapPlanResultToWizardForm（错配字段折进 premise 不静默丢）+
  applyPlanPatch（仅回填空字段、保护已编辑）+ useProjectPlan hook + PlanAssistant。
 2026-07-06 16:26:08 +02:00
Yaojia Wang
821ace5989 feat(web): 立项新增 基调/结局/视角 三字段（书级常量入 stable_core 缓存前缀） 
灵感计划 §3④ + §4 D 枚举决策：
- projects 表加 tone/ending_type/narrative_pov（Text nullable、无 CHECK，同 genre/structure；
  迁移 e5f6a7b8c9d0 nullable 免 backfill）。
- ProjectCreateRequest/ProjectResponse + domain ProjectCreate/ProjectView 全链路透传（snake_case）。
- 完整 stable_core 链路：ProjectSpecView + SqlProjectSpecRepo.spec + _build_spec_section 渲染进
  「作品蓝本」块——书级常量随书稳定，字节稳定守缓存前缀不变量 #9，绝不入 volatile。
- 前端 wizard.ts 三字段 + 预设数组 TONES/ENDING_TYPES/NARRATIVE_POVS + ProjectWizard 控件与确认页回显。
- 契约变更已 pnpm gen:api + memory/contracts.md 登记。
 2026-07-06 15:59:49 +02:00
Yaojia Wang
491d9342ef merge: appearance/motive 全栈穿线 (P1 流B) 2026-07-06 14:38:17 +02:00
Yaojia Wang
acde715515 feat(character): appearance/motive 全栈穿线 + motive/traits 口径重切 
打通 appearance/motive 从生成→schema→契约→落库→前端整条穿线
（DB 列早在初始迁移、此前一直 NULL，无新迁移），并原子重切人物
内驱口径。

- @llm: CharacterCard/character-gen.md 加 appearance/motive（给默认值守
  解析韧性），重切——动机唯一落 motive、traits 只留核心/表层/阴影三层、
  arc 引用 motive；regen prompt_hashes.json 金标准。
- @backend: CharacterCardView + CharacterWriteRepo/SqlCharacterWriteRepo
  （create + update backfill 分支）+ CharacterWriteFields + 路由双向形变
  与 _existing_characters 带上两字段。
- @frontend: pnpm gen:api 重生成 TS 客户端；CharacterCardItem 展示/编辑
  两字段。
- 测试: schema 默认值/解析、动机不双写重切回归、card_to_view 双向、
  ingest 透传、list 暴露、SqlCharacterWriteRepo create/backfill 真 pg 集成。
 2026-07-06 14:36:11 +02:00
Yaojia Wang
452bd56d95 feat(agents,core,config): 写章 craft 教条块 + genre-aware 片段 + 开篇黄金三章特判 
- 新增 write_craft.md 品类无关写章 craft 内核（网文语域/show-don't-tell/对话 voice/
  反注水/结构性文字质感，灵活原则非穷举清单）+ load_craft_doctrine()（import 期读盘，
  不入 SPECS/金标准）
- build_write_request 把 craft 教条作为最前的 cache=True system 块注入（craft→stable_core，
  守缓存前缀 #9，tier=writer 不写 model）
- 新增 packages/config GENRE_CRAFT 题材片段表，assemble 按 project.genre 注入 stable_core；
  ProjectSpecView + SqlProjectSpecRepo 透传 genre
- 开篇前 3 章在 volatile 注入黄金三章提示（含章号→每章易变，不进缓存前缀）
- 修正 toolbox_registry 注释：11 条 → 15 条（legacy 3 + 新 8 + Scope B 4）
 2026-07-06 14:29:43 +02:00
Yaojia Wang
90a66437d7 feat: improve app ui and project metadata 2026-06-28 07:31:20 +02:00
Yaojia Wang
bf39f50b2f fix(qa): 实施 4 组设计型 QA 项——规则删除/codex 角色/大纲卷过滤/文风回炉锚点 
#5 规则 DELETE + id：暴露 RuleView.id（PK）；新增 DELETE /projects/{id}/rules/{rule_id}
  （项目/规则不存在→404，成功→204，按 (id,project_id) 限定）；rule_repo 加
  list_for_project/delete；RulesPage 每条加删除（乐观删+回滚+toast）。assemble 侧
  RuleView（缓存前缀）不动，列表另立 RuleListItemView。
#7 codex 角色 relations：写侧本已持久化、读端点 _existing_characters 硬编码 []。
  加 _relations_from_jsonb 解析 {name,kind,note}，CodexPage 渲染关系 chip。
#8 角色入库幂等：SqlCharacterWriteRepo.create 改 (project_id,name) app 层 upsert——
  重复入库改更新而非插入；不加 UNIQUE/迁移（线上已有重复行会让约束迁移失败）。
#1 大纲卷过滤：GET /outline 支持可选 ?volume（无参=全部，向后兼容）；OutlineEditor
  加「查看：全部/卷N」筛选，与生成目标卷解耦。
H3/#9 文风回炉锚点：StyleDriftSegment 加 text（逐字命中段），style.md 指示审稿输出；
  前端按内容锚点定位回炉目标（idx 仅排序），命中失败 → 提示「无法定位该段」而非
  静默 no-op。style golden fixture 已重生成。

契约变更已 pnpm gen:api（RuleView.id / DELETE rules / outline ?volume）。无迁移
（alembic 无漂移）。门禁绿：ruff/mypy(210)/alembic/pytest 760 · 前端 tsc/lint/vitest 329。
 2026-06-25 12:53:03 +02:00
Yaojia Wang
0021426f09 docs(prompt-mgmt): 方案A 协同回写 + 补声明 structlog 依赖 
- memory/contracts.md：立 C6-ext（load_prompt/SPECS/SCHEMA_CATALOG/
  REVIEW_RESERVED_NAMES/SpecResolver + 打包契约）+ 变更日志一笔
- memory/decisions.md：方案A 决策（运行时值金标准/尾换行方案B/守卫前移/
  schema 留 Python/同一实例）
- memory/gotchas.md：spec.name 连字符命名 / 改稿须重生成金标准 /
  .gitattributes 完整嵌套路径 / wheel artifacts 带 .md / structlog 补声明 /
  SpecResolver 零 DB + 精确匹配
- PROGRESS.md：已封板「Prompt 管理重构 + 全量重写」波次
- ARCHITECTURE.md §5.1：补 prompt 外置 + SPECS/SCHEMA_CATALOG/SpecResolver，
  内置 agent 计数 8→21
- packages/{llm_gateway,core}/pyproject.toml：补声明 structlog>=24.1
  （原直接 import 未声明，靠 apps/api 传递；裸装 import ww_agents 会缺）
 2026-06-24 08:25:26 +02:00
Yaojia Wang
aac8b31b9f refactor(agents): 全量重写 21 个 prompt——任务对齐 + prompt 工程最佳实践 
对全部外置 prompt 做激进重写（每条经独立 agent 网络调研 + 重写，再由
另一 agent 交叉验证），让每条更贴合其 agent 任务。纯内容优化，零结构/schema
变更；金标准 fixture 同步重生成。

- 四审（continuity/foreshadow/style/pace）：保持只读，强化判定方法——
  continuity 证据对子 + 假阳性纪律；pace 0-5 爽点锚点；style 0-100 评分锚点
  + 字数 100 短段豁免/无指纹降级；foreshadow 埋设—回收契约
- 生成器：角色框定 + 落笔前自检 + 示例 + 差异化反雷同（character-gen/opening
  黄金三章/blurb/worldbuilder 硬规则/golden-finger/glossary/name/book-title/brainstorm）
- writer：去 AI 腔/机翻腔检查表 + 不改情节/事实约束（refiner 仍纯文本无 JSON、
  continue 无缝承接、expand、de-ai）
- 结构类：outliner 逐章蓝图 / fine-outline 分场节拍 / style_extract 先取证后下判 /
  teardown 粗拆→细拆

护栏全验：output_schema 契约逐字段保留、无具体 model 名、无占位/format 槽、
中文、≤1 尾 LF、无 BOM。语义锚点（差异化/100/硬规则）保留，3 个措辞耦合用例
无需改即过。门禁绿：ruff/format clean · mypy 209 · pytest 744 passed
（金标准 #5 对齐重生成 fixture；内容无关的 #2/#12 仍绿）。
 2026-06-24 05:17:15 +02:00
Yaojia Wang
dca4d45d4e refactor(agents): prompt 外置方案A — 21 prompt 散文外迁 .md + SpecResolver 
把 21 个内置 agent 的 system_prompt 从 specs.py 的 Python 常量外置为
prompts/<spec.name>.md，import 期由 load_prompt 确定性加载；建立 SPECS 名册
+ SCHEMA_CATALOG（Pydantic 类型留 Python）+ 统一只读解析入口 SpecResolver。
纯重构、零功能/schema 变更，缓存断点前块字节级不变（不变量 #9）。

@llm packages/agents（步骤1-3）
- spec_model.py：抽出 AgentSpec（frozen，字段不变）
- prompt_loader.py：load_prompt = utf-8-sig 去BOM → LF 归一 → NFC → rstrip尾LF，
  内存缓存 + fail-fast（PromptNotFoundError），import 期确定性
- schema_catalog.py：SCHEMA_CATALOG[name]→output type 唯一真相源（refiner=None）
- prompts/*.md ×21：取常量「运行时值」程序化外迁（反斜杠折行已塌缩，
  物理换行≡运行时换行）；文件名按 spec.name 连字符（style.md/character-gen.md 等）
- specs.py：删 21 常量 + AgentSpec 类；system_prompt=load_prompt(name)、
  output_schema=SCHEMA_CATALOG[name]；建 SPECS + REVIEW_RESERVED_NAMES；
  *_spec 兼容期保留且 SPECS[name] is *_spec（同一实例）。804→337 行
- __init__.py：显式 __all__ 重导出（避 F401）

@backend packages/skills（步骤4-5）
- SpecResolver：内置 SPECS（纯内存、零 DB）+ 用户 SkillRegistry 统一 get；
  内置 name 永不触发 DB；output_schema_for 精确匹配
- skill_registry：保留命名空间守卫前移至入库校验，拒同名内置 → VALIDATION
- toolbox_registry：GeneratorTool.spec 改走 SPECS[...]，删 12 个 *_spec 直接 import

@devops repo-root
- .gitattributes：prompts/*.md text eol=lf（修正：须用完整嵌套路径才匹配）
- packages/agents/pyproject：hatchling artifacts 纳入 prompts/*.md 随 wheel/sdist 分发
- ci.yml：新增 build wheel → 裸装 → import ww_agents.SPECS 冒烟

TDD 全程 mock 网关；门禁绿：ruff/format clean · mypy 209 files · pytest 744 passed
（含金标准 sha256 回归 / md↔spec↔catalog 一一对应 / fail-fast / BOM+NFC /
内置守卫 / 同一实例 / 编排器无回归 / apps/api import-smoke / 打包冒烟）
 2026-06-24 04:49:44 +02:00
Yaojia Wang
cfe6a535b0 feat(templates): F3b 模板库 repo + 端点（GET/POST/DELETE /templates） 
- TemplateRepo/SqlTemplateRepo（list/create/delete，owner stub 过滤，只 flush 端点 commit）
- schemas/templates.py（title/body min_length=1→422）+ routers/templates.py（删不存在→404）+ main 注册
- 单测：repo CRUD/owner 隔离/frozen + 端点 201/列出/204/422×2/404
 2026-06-23 20:17:32 +02:00
Yaojia Wang
9bb453acc8 feat(db): F3a prompt_templates 表 + 迁移 
新增 PromptTemplate 模型（UuidPk+CreatedAt+Base；owner_id stub、title、body、
category、tool_key）+ alembic 迁移。alembic check 无漂移；ruff/mypy packages/db 干净。
 2026-06-23 20:11:25 +02:00
Yaojia Wang
18aa87d751 feat(chain): F2 续写式链 continue_volume——上一章 accepted 正文作前文引子 
- core write_chapter 支持续写模式：chain_key==continue_volume 时经注入的
  chapter_repo.latest_accepted 读上一章已验收终稿，build_continuation_context
  改写 volatile（仅断点后块，守不变量 #9；core 不 import apps/api）。
- ChapterDraftRepo 协议加 latest_accepted；draft_volume 行为不变（无回归）。
- apps/api SUPPORTED_CHAINS 加 continue_volume；run 端点透传 chain_key 选模式
  （chain_runner 经 initial_chain_state 把 chain_key 落入 ChainState）。
- 单测（mock 网关+MemorySaver+fake session）：续写第二章请求含第一章正文；
  draft_volume 不注入前文；端点 202 透传 chain_key。守不变量 #1/#5。
 2026-06-23 20:09:08 +02:00
Yaojia Wang
61398a1452 feat(toolbox): F1 拆书 teardown 落库成项目 rules 
- teardown_spec.writes=["rules"]（只声明 tier，入库仍经白名单 gate，不变量 #3）
- toolbox_registry teardown entry 加 ingest=IngestSpec(table="rules")
- routers/toolbox.py 通用 ingest dispatcher 加 _ingest_rules：
  BookTeardownResult(themes/archetypes/structure/hooks) 拍平为可读 rules 条目，
  落项目级（无 continuity 预检，仿 _ingest_outline 无 409）
- schemas/toolbox.py 加 TeardownIngestView + ToolIngestRequest.teardown
- 单测：teardown ingest→rules 真落行 + 预览(generate)不写库

后端门禁绿：ruff/format/mypy clean · alembic no drift · pytest 644 passed
 2026-06-23 20:00:25 +02:00
Yaojia Wang
a5351320a2 feat(skills): Scope B A2 — 4 竞品生成器注册表+上下文分派+端点接线 
注册表 TOOLBOX +4 entry（continue/expand/de-ai/teardown，全 preview-only writes=[]）；
ContextStrategy +with_prior_chapter/text_input；ToolGenerateRequest +text 字段。
toolbox_context 分派新策略（续写→build_continuation_context、原文→build_text_input_context）；
路由续写经 chapter_repo 读最新 accepted/draft 正文注入 builder（core 不 import apps/api，仿 accept_op）。
预览仅 commit ledger 不写业务表（#3）；只声明 tier（#2）；system_prompt 进缓存前缀（#9）。
单测：4 生成器 generate 预览 + 续写读前文/草稿路由 + 扩写/降AI text 路由 + 拆书结构化；
更新 registry/strategy 计数测试（15 工具 / 6 策略）。门禁绿：ruff/format/mypy 196 files/pytest 168(api)+32(skills)。
 2026-06-23 19:10:35 +02:00
Yaojia Wang
87dd09a797 feat(agents): Scope B A1 — 4 竞品生成器 schema/spec + 2 上下文 builder 
续写/扩写/降AI率/拆书 4 个生成器的声明（preview-only writes=[]，只声明 tier #2）：
- schemas.py: ContinuationResult/PolishResult/DeAiResult/BookTeardownResult
- specs.py: continue(writer)/expand(writer)/de-ai(analyst)/teardown(analyst)，各配 system_prompt
- generation_node.py: build_continuation_context(续写读前文)/build_text_input_context(原文输入)
- 单测: 4 spec/schema 契约 + 2 builder 纯函数（确定性/空值降级）

守不变量 #2(只声明 tier)/#3(纯预览不写库)/#9(system_prompt 进缓存前缀)。
 2026-06-23 19:01:11 +02:00
Yaojia Wang
d1ea83b191 fix(chain): 修评审 CRITICAL+HIGH — 链网关按 session 重建/日志脱敏/resume 原子化+所有权/死导入 
- CRITICAL #1：链 write/review 节点经 gateway_builder 按节点自建 session 现建网关，
  usage_ledger sink 绑活 session，随节点 commit 持久化；run_chain_job 不再转发请求网关
  （其 session 在 BackgroundTask 跑时已关闭，记账行被静默丢弃）。新增 get_chain_gateway_builder
  缝（仿 digest builder），get_chain_gateway 退化为纯 503 凭据预检。守不变量 #1。
- HIGH #2：chain_runner 失败日志不再记 str(exc)（可能含 key/连接串/LLM 输出），改记
  _classify_job_error 脱敏文案 + exc_type（设计 §5）。
- HIGH #3：resume 端点原子抢占 awaiting→running（JobRepo.claim_awaiting_to_running 条件
  UPDATE），抢不到 → 409，防并发 resume 双 Command(resume) 损坏图。
- HIGH #4：resume 校验 job.project_id == project_id（JobView 新增 project_id），不匹配 → 404。
- HIGH #5：resume 返回新 ChainResumeAccepted{job_id,chain_key}，去掉无意义哨兵 start/count=0。
- HIGH #6：删 nodes.py 死导入 extract_conflicts（import + __all__）。
- 测试 #7：e2e 断言链跑后 usage_ledger 有行（#1 回归守卫）+ chapter_reviews 每章一行；
  新增 claim 原子抢占单测 + resume 跨项目 404 / 并发 409 端点测。
 2026-06-23 18:04:10 +02:00
Yaojia Wang
548b7abd6f feat(db): C3 langgraph 检查点建表迁移 + alembic 漂移豁免 
多章工作流链（docs/design/chain-workflow.md §4/§7）唯一新增 DDL：langgraph
检查点四表（checkpoints/checkpoint_blobs/checkpoint_writes/checkpoint_migrations）。

- 新增迁移 d3e4f5a6b7c8：在迁移内调 langgraph 同步 PostgresSaver.setup() 建表
  （DDL 只在 migrations/CI，绝不 app-runtime）。从 database_url 派生 psycopg
  conn string（去 +asyncpg），与 alembic 的 asyncpg 连接解耦。
- §11 风险落地：setup() 跑 CREATE INDEX CONCURRENTLY，不能在事务块内且会与
  alembic 开着的事务死锁 → 用 op.get_context().autocommit_block() 先提交退出
  事务块再建表。downgrade 幂等 DROP ... CASCADE。
- env.py 加 include_object：langgraph 四表不在 Base.metadata，过滤掉以免
  alembic check 误报漂移。
- jobs 表零迁移（C2 判定：result.awaiting_chapter 表达待裁决，复用现有状态枚举）。

验证：alembic upgrade head 应用、downgrade/re-upgrade 往返、alembic check
无漂移；ruff/format/mypy(packages/db) 全绿。
 2026-06-23 17:23:06 +02:00
Yaojia Wang
29349dc7ee feat(api): C2 多章链 服务+端点+schema+checkpointer 接线 
承 C1 链图（build_chain_graph），落地多章工作流链的 apps/api 壳：
- 3 端点 routers/chain.py：POST .../chains/{key}/run→202 ChainRunAccepted；
  POST .../chains/runs/{job_id}/resume→202；GET /jobs/{id} 复用。校验：
  count 1..50→422、未知 chain_key→404、resume 非 awaiting→409、无凭据→503。
- schemas/chain.py：ChainRunRequest/ChainRunAccepted/ChainResumeRequest
  （ConflictDecision 复用 schemas/projects）。
- services/chain_runner.py：run_chain_job 仿 run_job 壳自建独立 session 驱动链图
  （set_running→ainvoke→据 __interrupt__ 置 awaiting_input/done/failed）；
  build_accept_op 在 apps/api 装配验收事务闭包注入图节点（守 #3/#4）；
  token 不入 result/日志。
- services/chain_deps.py：get_checkpointer_factory（运行时 AsyncPostgresSaver
  上下文 / 测试 MemorySaver）。
- 零迁移（设计 §7）：复用 jobs，新增 status="awaiting_input" + JobRepo.set_awaiting，
  awaiting 章经 result.awaiting_chapter；新错误码 ErrorCode.CONFLICT(409)。
- project_deps：build_chain_gateway/get_chain_gateway（按请求 tier writer/analyst/light
  分派——单档网关恒返该档会错路由 review/digest）+ get_digest_gateway_builder。

单测 apps/api/tests/test_chain.py 12 用例（mock 网关 + MemorySaver + fake session/
accept_op，无 DB/无网络/无真 LLM）：run/resume→202、未知 key 404、count 越界 422、
resume 非 awaiting 409、run_chain_job 无冲突→done、冲突→awaiting→resume→done、
错误脱敏、accept_op 冲突缺判→CONFLICT_UNRESOLVED。

门禁绿：ruff/format 干净 · mypy 193 Success · alembic 无漂移 · pytest 600 passed。
守不变量 #1/#3/#4/#5/#9。唯一新增 DDL（langgraph 检查点表）= C3 迁移。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 17:12:53 +02:00
Yaojia Wang
7f3eaaba3d feat(orchestrator): C1 多章工作流链图 — write→review→decide→accept 有环图 
实现 chain-workflow 设计 §3 的 LangGraph 链图，激活休眠资产
（checkpointer + interrupt-on-conflict）。

- packages/core/ww_core/orchestrator/chain/{state,nodes,graph}.py：
  - ChainState（§3.1）：只放控制流（章号/计数/written/has_conflicts），
    正文/审稿/冲突明文落领域表，resume 重读（不变量 #1/#3/#5）。
  - 四节点 write_chapter/review_chapter/decide/accept_chapter（§3.2）：
    各自短事务、独立 session；decide 纯逻辑读最近审稿留痕定 has_conflicts；
    accept 节点起始处遇冲突 interrupt() 暂停交人，恢复值=裁决清单。
  - build_chain_graph（§3.3 签名）：节点 DB 依赖经 session_factory +
    repo 工厂 + assemble/accept_op 闭包默认参绑定（langgraph 不收 partial）；
    条件边实现循环（current<=last 回 write）+ interrupt。
  - 验收事务（apps/api）经 accept_op 闭包注入，守目录所有权 + 不变量 #3/#4。
  - 收集版写章：复用 build_write_request 同一组装路径（stream=False → run）。
- 删除无人调用的 build_write_graph 工厂（write_node 本体保留，被链复用）；
  清理其 __init__ 导出 + 旧单节点图单测（YAGNI，解决审计死代码）。
- 单测（mock gateway + fake session_factory + fake repos + MemorySaver）：
  无冲突全跑到 END 且 written 满 / 有冲突→__interrupt__ / resume(Command)→
  accept→END / decide 纯逻辑 / accept 推进章号；零 token 零联网。

门禁：packages ruff/format/mypy 干净；pytest 314 passed。
 2026-06-23 16:54:47 +02:00
Yaojia Wang
f43ccd293f feat(toolbox): T6 创作工具箱通用生成器框架 — 8 新生成器 + 声明驱动落地页 + P2 收尾 
通用执行路径驱动全部生成器（"加生成器=加一份声明"）：
- @llm: ww_agents +7 输出 schema + 7 spec（book-title/blurb/name/golden-finger/
  glossary/opening/fine-outline，只声明 tier）+ build_outline_chapter_context
- @backend: ww_skills GeneratorTool 描述符 + TOOLBOX(11) + get_tool；3 通用端点
  GET /skills/toolbox · POST .../skills/{tool_key}/generate(预览不写库,仅记账) ·
  POST .../ingest(复用 continuity 409 + partition_writes 白名单)；纯 context 派发
- @frontend: 工具箱落地页 RSC + 声明驱动 GeneratorRunner + lib/toolbox 纯函数
  + LeftNav「工具箱」+ ⌘K nav-toolbox/action-gen-*；legacy 3 跳现页
- @qa: tests/test_t6_toolbox_e2e.py 5 用例真 pg + mock 网关零 token，无端点 bug
- P2 收尾: 限流→decisions.md 记延后(单用户原型)；noopener/Committable 早已修

守不变量 #2(只声明 tier)/#3(预览不写库,入库经验收 gate)/#9(缓存前缀)。无 DB 迁移。
门禁绿: 后端 ruff/format/mypy 195/alembic 无漂移/pytest 583；前端 lint/tsc/vitest 279/build。
spec 回写 PRODUCT_SPEC §7 + ARCHITECTURE §7.2 端点表。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 20:37:55 +02:00
Yaojia Wang
d028c790c9 feat(agents,api): 一致性冲突一键采纳补丁对 original/replacement + SSE/契约透传 
- Conflict schema 增 original/replacement（可缺）：可局部修复时审稿提议精确补丁
- 续审 prompt 指示填逐字 original + 改后 replacement，不可定位则留空
- orchestrator SSE conflict 事件 + apps/api ReviewConflictView 透传两字段
- 重生成 TS 客户端 schema.d.ts；memory/contracts.md 记录契约变更（向后兼容）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 18:28:04 +02:00
Yaojia Wang
016509c5c6 fix(gateway): 熔断计入持续 4xx + 去 assert + Protocol/transient 去重 
P1-2 非可重试错误(持续 401/403)也 record_failure，坏 key 可触发熔断。
P1-9 _complete_structured 的 assert 改显式 raise ValueError（-O 安全）。
P2 GatewayRun 抽到 orchestrator/_protocols.py 单点（去 4 处重复）；
  _is_transient 抽到 adapters/base.py is_transient_by_name（去 3 处重复）；
  Gemini Protocol 改 async def；gateway._retrying 去无用 async。
 2026-06-21 19:32:49 +02:00
Yaojia Wang
f7004e8d74 fix(db): 时间列 TIMESTAMPTZ + 热路径索引 + 状态 CHECK 约束 
P1-1 base.py 时间列改 timezone=True；迁移把 16 表 created_at/updated_at
  ALTER 为 TIMESTAMPTZ（手写 USING ... AT TIME ZONE 'UTC'）。
P1-3 新增 8 个索引（chapter_reviews/chapter_digests 复合、owner_id、
  usage_ledger、rules + jobs/rules 部分索引）。
P2 chapters/foreshadow status CHECK 约束。
迁移链 ad2c4c663daf → b1a2c3d4e5f6 → c2b3d4e5f6a7，upgrade/downgrade 往返无漂移。
 2026-06-21 19:32:49 +02:00
Yaojia Wang
345cc73965 fix(txn+security): 仓储改 flush + 启动校验/兜底 + job.error 脱敏 + SSE 异常硬化 
P0-1 SqlCredentialStore/save_draft 由自提交改 flush，端点/服务统一 commit
  （新增 CredentialStore.commit() 统一提交点；token 刷新落库显式提交）；
  补多凭据一请求中途失败整体回滚集成测试。
P0-2 启动校验 _fernet(enc_key) 快速失败 + catch-all Exception → ErrorEnvelope；
  credential_enc_key 改 SecretStr。
P0-3 run_job 异常分类：AppError 存 code+message，其余存通用文案不泄 str(exc)。
P0-4 评审/正文 SSE 失败先发 error 事件，尾部 commit 包 try/except。
P1-4 max_version 加 FOR UPDATE 行锁消除 TOCTOU。
P1-5 scan_overdue 谓词下推 + 批量 UPDATE RETURNING。
P1-10 移除 OAuth user_code 日志。
P2 provider_deps 改调网关 build_adapter；accept_service Committable Protocol；
  CORS 白名单收窄；request_id 安全字符集白名单；stdlib 日志接管；读端点 404 校验；
  httpx timeout；测试用合法 Fernet key；类型化响应模型(JobResponse/DimensionEntry/
  ReviewConflictView/selling_points)+路由 ErrorEnvelope responses（供 codegen）。
 2026-06-21 19:32:24 +02:00
Yaojia Wang
2155193cdc feat(ux): T4-b 后端 — draft 端点接收本章指令 directive 直通 assemble(volatile) 
assemble/_build_volatile 加 directive 参数（仅入 volatile，守缓存前缀不变量 #9）；stream_draft 加可选 body {directive} 透传；不持久化、无迁移；directive 长度入 log 不记原文。新 DraftStreamRequest schema + 重生成 TS 客户端。后端门禁绿: ruff/mypy/pytest。契约记 memory/contracts.md。
 2026-06-20 18:25:00 +02:00
Yaojia Wang
0d473e726e feat(b0): 注入透明可控版后端 — PUT override(pin/排除/recent_n) + 选择函数加参 + draft 同读 
- selection.select_relevant_entities 加 pinned/excluded frozenset 入参；新理由 author_pin（末位）
- assemble 加 override 关键字参（recent_n 覆盖回看章数 + pin/排除）；GET/PUT/draft 同读同一覆盖（不变量 #6 作者兜底）
- 新 domain/injection_repo.py（InjectionOverride/EntityRef/SqlInjectionOverrideRepo，upsert 只 flush）
- 新表 chapter_injection（迁移 ad2c4c663daf，唯一 project_id+chapter_no；复用 outline 行已否决）
- PUT/GET injection 端点 + InjectionOverrideRequest/回显 pinned/excluded；recent_n 1..20 校验 422
- 单测：selection pin/排除/exclude>pin + assemble override + 端点 PUT/404/422；regen TS 客户端
- 门禁绿：ruff/format · mypy 163 · alembic 无漂移 · pytest 476

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 11:56:54 +02:00
Yaojia Wang
e8cccf7389 feat: T6.1 创作工具箱通用生成器框架地基 — 脑洞生成器 + run_generator 
- schemas: Idea/IdeaListResult（脑洞生成器结构化产出，纯预览不入库）
- specs: brainstorm_spec（light 档，reads=[projects] writes=[]）
- orchestrator: build_brief_context（brief_only 策略）+ 通用 run_generator
  （据 spec.output_schema 校验 parsed，不绑定具体类型，任一声明式生成器共用）
- 新增 13 测；两包 ruff/format/mypy 干净、252 passed 无回归

P1 第一波（@llm）：证实「加生成器=加一份声明」。@backend T6.2/T6.3 待续。
 2026-06-20 11:31:59 +02:00
Yaojia Wang
765dbdfbd4 feat: M4 文风 + M5 生成/多provider/Skill + Kimi Code 订阅接入 + 本地联调修复 
M4（文风）: style-auditor 双轨（提取指纹/漂移第四审）+ jobs 长任务框架(zombie reaper) + 回炉 refine + GET /style read-back。
M5（生成+扩展）: worldbuilder/character-gen（入库 continuity 409 gate + partition_writes 白名单 + schema→JSONB 形变）；
  网关多 provider 回退链/熔断/能力降级（Anthropic/Gemini 适配器）；Skill registry + 表权限沙箱 + 规则；
  前端 角色生成器/世界观/Codex/规则页/技能库/⌘K 命令面板。
K1（Kimi Code 订阅接入）: OAuth device-flow（kimi-code）+ 静态 Console key（kimi-code-key）两路径；
  coding 端点 KimiCLI 伪造头（实测 UA allow-list 门禁，缺则 403）+ JSON 模式结构化（thinking ⊥ tool_choice）。
本地联调修复: CORS 中间件；assemble 注入 premise+「写第N章」指令（修空 prompt 400）；
  GET /outline·/draft read-back + 大纲/工作台/审稿页重载；写页 client/server 常量边界 + notFound 健壮化；
  字数 toLocaleString locale 水合；审稿页终稿从已存草稿 seed（修 accept 422）。
门禁: backend ruff/mypy(157)/alembic 无漂移/pytest 451 · frontend lint/tsc/vitest/build。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 10:39:58 +02:00
Yaojia Wang
5fb7bfb1de feat: M3 — 伏笔账本 + 节奏引擎 + 大纲（含并发记账 bugfix） 
- 伏笔账本：纯函数状态机(OPEN/PARTIAL/CLOSED/OVERDUE) + ForeshadowLedger repo；验收后到期扫描(BackgroundTask 自建 session 置 OVERDUE)；登记/状态变更端点
- 节奏 + 三审齐：foreshadow-analyst + pace-checker 并入 LangGraph 并行审(REVIEW_SPECS)，collect 分列落 chapter_reviews(conflicts/foreshadow_sug/pace)，review SSE 加 foreshadow/pace 事件
- 大纲：outliner Agent 产 OutlineResult(含 foreshadow_windows)，POST /outline 逐章 upsert outline 表；GET /foreshadow?status= 看板
- 前端：伏笔四泳道看板(OVERDUE 琥珀) + 大纲编辑器(窗口徽标) + 节奏节拍图(▁▃▅) + 审稿页消费 foreshadow/pace SSE
- bugfix(T3.8)：并行三审共用请求 session 记账触发 'Session is already flushing' → foreshadow/pace 静默丢失；SqlAlchemyLedgerSink.record 改 add-only(靠端点/事务 commit)，加并发回归测试
- M3 E2E：真实 DB + mock 网关零 token 走通 埋设→进展→验收后扫描 OVERDUE→看板 + 大纲含窗口 + 三审齐 SSE/留痕；E2E 暴露并钉住上述 bug
- 门禁绿：mypy 111 / pytest 228(0 xfailed) / alembic 无漂移；前端 gen:api/lint/tsc/vitest 69/build
 2026-06-18 14:21:17 +02:00
Yaojia Wang
68f194a043 feat: M2 — 写→审(一致性)→裁决→验收(事务)；未决冲突禁验收 
- 续审 Agent 声明(AgentSpec) + 结构化输出契约(ContinuityReview/Conflict 五类)
- LangGraph 并行审子图(可扩四审) + collect 落 chapter_reviews 留痕 + review SSE(section/conflict)
- 验收-side Repository：章节 accepted 版本晋升 + digest append-only + 审稿留痕/裁决
- API：review(SSE) + reviews 历史 + accept(单原子事务：晋升 version + 终稿 digest + 裁决留痕)
- 冲突 gate：未决裁决拦截(CONFLICT_UNRESOLVED)；digest 从终稿提炼(不变量#4)
- 前端：审稿报告页 + 冲突就地标注 + 裁决(采纳/忽略/手改) + 未决禁验收 + 「本次将更新」清单
- M2 E2E：真实 DB + 多档位 mock 网关零 token 走通 写→审→裁决→验收→摘要入库
- 多 agent 协同台账(PROGRESS.md) + 共享记忆(memory/contracts·decisions·gotchas)
 2026-06-18 11:38:28 +02:00
Yaojia Wang
b523b4fd21 feat: M1 — 立项→写章草稿(SSE)→自动保存；连一家 provider 
- 薄自建 LLM 网关：OpenAI 兼容适配器(DeepSeek) + instructor 结构化输出 + usage_ledger 记账 + 档位路由
- 记忆服务 assemble：确定性选择(显式+主角+近况) + 渲染卡 + 缓存断点(中性文本)
- LangGraph 写章节点 + Postgres checkpointer + SSE 归一(token/done/error)
- API：立项 + 写章 draft(SSE) + PUT 自动保存 + 提供商凭据(Fernet 加密/测试连接)
- 前端：AppShell + 作品库 + 5 步立项向导 + 写作工作台(流式打字机+自动保存) + 设置页
- M1 E2E：真实 DB + mock 网关零 token 走通闭环
 2026-06-18 11:38:28 +02:00
Yaojia Wang
d3dc620a71 feat: Phase 0 — monorepo 骨架 + 全表迁移 + FastAPI/Next 骨架 + CI 
- uv(workspace) + pnpm monorepo；docker-compose(pg+api+web)
- SQLAlchemy 16 MVP 表 + Alembic 初版迁移(无漂移，users stub)
- FastAPI 骨架：统一错误信封(带 request_id) + structlog + /jobs/:id + OpenAPI
- Next.js 骨架：纸感主题 token + OpenAPI→TS 客户端代码生成(gen:api)
- CI(ruff/mypy/pytest + pg service + alembic 漂移校验)
- 四份设计规格(PRODUCT/UX/ARCHITECTURE/DEV_PLAN) + CLAUDE.md
 2026-06-18 11:38:28 +02:00