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

182 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Yaojia Wang
3bd464d400 docs: 登记 QA-CR 全项目 code review 整改批（21 项任务表） 2026-06-27 06:35:55 +02:00
Yaojia Wang
a6f5d085e5 test: 接入 jsdom 测试栈, 把 15 个 React hooks 纳入 80% 覆盖率门禁 
新增 jsdom + @testing-library/react, 为 lib/** 全部 use*.ts hooks 写 renderHook 单测:
生成/CRUD(world/character/generator/outline/accept/foreshadow/rules)、
SSE流(draftStream/reviewStream)、定时轮询(autosave/jobPoll/kimiOauth)、
文风与注入(refine/styleLearn/injection)。覆盖率 mock api 客户端+Toast, 不打真实 LLM。
vitest.config.ts 去掉 use*.ts 排除; 前端覆盖率 63%→95%。CLAUDE.md 同步说明。
 2026-06-27 06:21:42 +02:00
Yaojia Wang
a02c6b6e4f test: 接入覆盖率工具并在 CI 强制 ≥80% 门禁 
后端: 加 pytest-cov + [tool.coverage] 配置, pytest --cov-fail-under=80 (基线~88%)。
前端: 加 @vitest/coverage-v8, vitest.config.ts 设 80% 阈值, 新增 test:coverage 脚本 (基线~93%)。
前端覆盖范围限定 lib/** 纯逻辑层; hooks(use*.ts)待 jsdom 测试栈接入后纳入。
CI backend/frontend job 改跑覆盖率门禁命令。CLAUDE.md 同步 DoD 与 Toolchain。
 2026-06-26 21:11:57 +02:00
Yaojia Wang
e9477d84d8 docs: 增加每次编码的硬门禁(Definition of Done)与提交纪律 
明确 TDD/≥80%覆盖/三类自动化测试必跑/全门禁绿/合规/每次commit/禁署名尾注；
如实标注覆盖率工具尚未接入并列出补齐待办。
 2026-06-26 21:03:35 +02:00
Yaojia Wang
01257b8952 merge: 实施 4 组设计型 QA 项（规则删除/codex 角色/大纲卷过滤/文风回炉锚点） 2026-06-25 12:53:03 +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
e60eff7aa1 merge: 前端错误文案 friendlyFromApiError（QA #2/#11，去通用 toast） 2026-06-24 18:01:15 +02:00
Yaojia Wang
9a623688e8 fix(qa): 前端错误文案——按 API 信封 surface 真实错因，去掉通用 toast 
新增 friendlyFromApiError(apiError)：兼容业务信封 {error:{code,message}}（ARCH §7.1）
与 FastAPI 422 {detail:[...]}，422 映射为友好 VALIDATION 文案（不泄露技术细节）。
接入三处此前吞掉错因、永显通用文案的调用点：
- useOutline（QA #2）：原 env.error.code 漏读 422 detail，永显「大纲生成失败」。
- ChainPage / ChainAdjudication（QA #11）：原 friendlyError(undefined) 永显通用 toast，
  现 surface 真实 code（如 LLM_UNAVAILABLE→去设置 provider / CONFLICT→提示裁决）。
+ messages.test.ts 加 3 例（业务码带动作 / 422→VALIDATION / 未知形兜底）。
门禁绿：vitest / tsc / eslint 干净。
 2026-06-24 18:01:15 +02:00
Yaojia Wang
f4f01aeca9 merge: 修 3 个 QA MEDIUM（规则 GET 404 / 空白 content 422 / 未知 tier 422） 2026-06-24 17:51:03 +02:00
Yaojia Wang
3868f80502 fix(qa): 修 3 个 QA MEDIUM——规则/档位路由校验收紧 
- 规则 GET 不存在 project → 404（原返误导性空 200，掩盖坏 id）：list_rules 加
  项目存在校验（仿 C1/H2）。
- 规则 content 纯空白 → 422（原 strip 前校验 min_length，空白行入库成垃圾）：
  改 StringConstraints(strip_whitespace=True, min_length=1)。
- 档位路由 tier 限定 writer/analyst/light（Tier Literal）→ 未知档位 422
  （原接受任意字符串）。

回归测试：test_generation（GET rules 404）/ test_rules（空白 content 422）/
test_settings_providers（未知 tier 422）。门禁绿：ruff/format/mypy(210)/pytest。
 2026-06-24 17:51:02 +02:00
Yaojia Wang
7a40c7fbb5 merge: 修 QA C1/H1/H2（写章/规则项目校验 404 + 立项向导字段覆盖） 2026-06-24 17:17:35 +02:00
Yaojia Wang
2fe3bedfba fix(qa): 修 QA C1/H1/H2——写章/规则缺项目校验 + 立项向导字段覆盖 
C1 (CRITICAL) stream_draft：对不存在 project 流式写章先 fail-fast 404，
  否则非法 id 静默烧一次付费/限流 LLM 调用并返 200。在触网关前查 project_repo.get。
H2 (HIGH) create_rule：给不存在 project 加规则原 FK 违例逃逸成 500 → 改为入库前
  校验项目存在返 404（仿 chain/_require_project）。
H1 (HIGH) ProjectWizard：第3步「立意」与第4步「主角/金手指」原共用 form.premise
  互相覆盖丢数据 → 新增独立 form.protagonist，toCreateRequest 合并两段进 premise
  （M1 projects 表仍只有 premise，不编造 API）。

回归测试：
- test_projects.py：stream_draft 不存在 project → 404 且网关零调用；已有 draft
  用例改 seed 真项目。
- test_rules.py：create_rule 不存在 project → 404 不写库；已有用例 seed 真项目。
- wizard.test.ts：premise+protagonist 合并不互相覆盖（2 例）。
门禁绿：ruff/format clean · mypy 210 · pytest 749 · 前端 tsc/lint/vitest 干净。
 2026-06-24 17:17:35 +02:00
Yaojia Wang
a4ef250fc9 fix(review): 验收冲突显示与闸门对齐 — 验收报 CONFLICT_UNRESOLVED 时回拉最新审稿并回灌冲突；未审稿不再误显「可直接验收」 2026-06-24 16:17:54 +02:00
Yaojia Wang
d0c301349c merge: fix 多章链 checkpointer 连接串剥离驱动后缀（ProgrammingError 修复 + 回归测试） 2026-06-24 13:03:58 +02:00
Yaojia Wang
b5002a9864 fix(chain): checkpointer 连接串剥离 SQLAlchemy 驱动后缀 
多章链 job 一发起即 failed（exc_type=ProgrammingError）。根因：runtime
checkpointer 工厂把 settings 的 sync URL `postgresql+psycopg://…` 原样喂给
`AsyncPostgresSaver.from_conn_string`，psycopg 不识别 `+psycopg` 方言段 →
`ProgrammingError: missing "=" …`，链在打开 saver 时即崩。

E2E 用 MemorySaver 覆盖 get_checkpointer_factory，从不走真 conn string，故此
路径无回归保护、bug 未被测出（迁移 d3e4f5a6b7c8 里 `_psycopg_conn_string` 已
正确剥离，runtime 缝漏了同款处理）。

修复：chain_deps 加 `_libpq_conn_string()`，剥离 `+psycopg`/`+asyncpg` 还原为
标准 libpq 串后再交 from_conn_string。+ 单测 test_chain_deps.py（3 参数化用例）。
已直连真 pg 复验：saver.aget OK，ProgrammingError 消除。
 2026-06-24 12:40:40 +02:00
Yaojia Wang
9d94957a9b merge: 方案A 协同回写（contracts/decisions/gotchas/PROGRESS/ARCH）+ structlog 依赖补声明 2026-06-24 08:25:26 +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
eb356c42a9 merge: 全量重写 21 个 prompt——任务对齐 + prompt 工程最佳实践（交叉验证，门禁全绿） 2026-06-24 05:17:15 +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
4f561dad35 merge: prompt 外置方案A — 21 prompt → .md + SpecResolver（TDD + 交叉评审，门禁全绿） 2026-06-24 04:52:59 +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
f9ff89cd6b merge: 续补三件 — 拆书入库rules / 续写式链 continue_volume / 模板库 
多 agent 逐学科建造 + 4 路对抗交叉评审 + 修 3 HIGH。
后端 mypy 202 / alembic 无漂移 / pytest 670；前端 vitest 309/build 绿。
 2026-06-23 20:45:56 +02:00
Yaojia Wang
1921b037a0 fix(backlog): 修评审 3 HIGH — resume chain_key 真值 / 模板空白校验 / 续写链 resume E2E 
1. resume_chain 回报真 chain_key：从 awaiting job.result 读回（run 时 _chain_result
   持久化），不再按 job.kind 推断（kind 恒为通用常量 "chain"，从不在 SUPPORTED_CHAINS
   → 总错回退 draft_volume）。continue_volume 的 resume 回执现报真值。
2. 模板 title/body 拒纯空白：StringConstraints(strip_whitespace, min_length=1)，
   "   " strip 后为空 → 422。
3. 续写链 resume 路径 E2E：continue_volume 第 1 章冲突 → interrupt → awaiting →
   resume 带裁决 → done，断言 resume 回执 / job result chain_key="continue_volume"
   （回归守卫 #1）。

测试：+resume continue_volume 单测（chain_key 真值）+2 模板空白 422 单测 +1 续写链
resume E2E。重生成 TS 客户端（仅 description 文案变化）。
 2026-06-23 20:45:06 +02:00
Yaojia Wang
1a402f5ccc feat(web): F1/F2/F3 前端——拆书入库为规则 / 续写式链选择 / 模板库 
- gen:api 纳入 /templates、chain continue_volume、teardown rules ingest 端点
- F1：GeneratorRunner 识别拆书为单对象入库（整 preview 作一条 teardown），
  ingestTable(BookTeardownResult)=rules，buildIngestRequest 组装 teardown 体，
  按 isSingleObjectIngest 隐藏勾选框、改文案「入库为规则」
- F2：ChainStarter 加链类型单选（draft_volume 从头写 / continue_volume 续写），
  chain_key 作 path 参传给 run（CHAIN_KINDS 对齐后端 SUPPORTED_CHAINS）
- F3：模板库页 app/templates + 全局 nav 入口 + TemplatesManager（列/建/删，乐观更新回滚）；
  GeneratorRunner 加 TemplateFiller「从模板填入」（body 填进 brief/text，纯前端）
- vitest 覆盖 templates/ingest teardown/templateFillTarget/CHAIN_KINDS 纯逻辑
 2026-06-23 20:29:48 +02:00
Yaojia Wang
5d8e619408 test(qa): F1/F2/F3 E2E — 拆书入 rules / 续写式链前文注入 / 模板库 CRUD 
- F1: teardown generate→ingest→rules 真落行 + 负向预览不写库（不变量 #3）
- F2: continue_volume 两章第二章写章请求含第一章 accepted 正文（前文注入）+ draft_volume 回归守卫
- F3: templates POST→GET→DELETE 真 pg 回环 + title/body 空→422

真 pg + mock 网关零 token，镜像现有 tests/test_*_e2e.py 范式
 2026-06-23 20:24:24 +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
44642c37b4 docs(backlog): 续补三件设计契约（拆书入库/续写式链/模板库） 2026-06-23 19:49:00 +02:00
Yaojia Wang
0045931a6a merge: Scope B — 多章链前端 UI + 4 竞品生成器(续写/扩写/降AI率/拆书) 
多 agent 逐学科建造 + 4 路对抗交叉评审 + 修 4 HIGH。
后端 mypy 196 / alembic 无漂移 / pytest 642；前端 lint/tsc/vitest 294/build 绿。
 2026-06-23 19:40:11 +02:00
Yaojia Wang
8c7d4e2169 fix(scope-b): 修评审 4 HIGH + 同步 T6 工具数(15) 
1. T6 e2e 工具数同步：list 断言 11→15（含 continue/expand/de-ai/teardown），
   测试名 ...eleven→fifteen；保留 legacy/ingestable 意图。
2. teardown 书名（body.kind）前置入原文 → 进 text_input context（拆书 prompt 期待书名）。
3. text_input 工具（扩写/降AI/拆书）空原文 → 422 VALIDATION，不让 LLM 空跑。
4. 链 UI：busy 守卫加 awaiting，裁决期间禁止重复发起链。

测试：扩 teardown 断言书名入 context + 新增 expand 空原文 422；后端 642 passed，
前端 294 passed，两门禁全绿。
 2026-06-23 19:38:56 +02:00
Yaojia Wang
e2d798627a feat(web): Scope B B2 — 工具箱原文输入 + 4 新生成器预览渲染 
buildGenerateRequest 转发 text（扩写/降AI/拆书原文，text_input 策略；空白省略）。
mapPreview 处理单对象产物：续写/扩写/降AI（{text}→单 body 卡）、拆书
BookTeardownResult（structure 作标题 + themes/archetypes/hooks 列表字段）——
绕过 firstArrayEntry 的「记录列表」假设，使 4 新生成器声明驱动表单/预览自动可渲染。
原文 textarea 字段（name=text）由既有 FormField 渲染，无需改组件。
 2026-06-23 19:22:10 +02:00
Yaojia Wang
a2dcd89881 feat(web): Scope B B1 — 多章工作流链前端 UI（发起/轮询/裁决续跑） 
链页 app/projects/[id]/chains（RSC fetchProject）+ ChainPage/ChainStarter/
ChainProgress/ChainAdjudication；lib/chain 纯函数（result 收窄/相位映射/resume 组装）。
复用 useJobPoll 轮询、ConflictCard + decisions.ts 裁决、normalizeConflicts/latestReview、
friendlyError；nav 加 chains 入口。awaiting（interrupt）→ 读该章冲突渲 ConflictCard →
POST .../chains/runs/{job_id}/resume 续跑。gen:api 纳入 chains run/resume。
守 #5（链暂停=等裁决，token/正文不入 job result）。
 2026-06-23 19:21:00 +02:00
Yaojia Wang
416caed56b test(qa): Scope B C — 4 竞品生成器 E2E（真 pg + mock 网关零 token） 
新增 tests/test_competitor_generators_e2e.py（镜像 t6_toolbox E2E 范式）：
- 续写：种入该章 accepted 前文 → 端点读取注入续写上下文（断 fake 适配器 req.input 含前文，跨层数据流 #1）
- 扩写/降AI率：作者原文经 body.text 路由进上下文（断 req.input 含原文）
- 拆书：text_input → 断结构化输出 themes/archetypes/structure/hooks 齐全
- 负向（#3）：4 者均仅记 usage_ledger、业务表(chapters/world_entities/outline)零新增；响应体无 token/secret 泄漏

零 token：override get_tier_gateway_builder 返单一真 Gateway + 假适配器据 output_schema 分支。
 2026-06-23 19:17:08 +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
681f8e61eb docs(arch): §5.2.1 回写 — 单章流程实现现状 + 多章链图(cyclic+interrupt+checkpointer) 2026-06-23 18:44:14 +02:00
Yaojia Wang
9627845abc docs(chain): 补 PROGRESS 台账 — Chain Workflow 交付/交叉评审/CRITICAL修复/合并汇总 + 出口 + 剩余下一步 2026-06-23 18:40:20 +02:00
Yaojia Wang
513bf71689 merge: 多章工作流链（LangGraph cyclic 链图 + interrupt-on-conflict + checkpointer） 
逐学科多 agent 实施 + 3 路对抗交叉评审 + 修复 1 CRITICAL/5 HIGH。
后端门禁绿：mypy 194 · alembic 无漂移 · pytest 608 passed。
 2026-06-23 18:27:16 +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
061792db1c test(chain): C4 多章工作流链 E2E — 真 pg + mock 网关零 token 
- 用例①两章无冲突全自动：两 accepted 章 + 两 digest 行 + job done written=[1,2]
- 用例②注入冲突→interrupt→job awaiting→resume 带裁决→续跑→accept；
  interrupt+resume 横跨两次端点调用，单进程单 MemorySaver（覆盖 get_checkpointer_factory）
- 负向断言：正文/token 不入 job result/状态（HTTP + DB 真源双查）
- 守不变量 #1/#3/#4/#5/#9
 2026-06-23 17:27:46 +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
5ee9799885 docs(chain): 多章工作流链正式设计文档（实施契约） 2026-06-23 16:43:38 +02:00
Yaojia Wang
d6ffaab566 merge: T6 创作工具箱（通用生成器框架 + 8 生成器 + 声明驱动落地页） 2026-06-23 09:05:07 +02:00
Yaojia Wang
daa74f98af fix(web): 工具箱导航指向 T6 落地页 /toolbox（替换旧 /skills） 2026-06-23 09:04:58 +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
1f1afa37b6 fix(web): 写作页切章后内容不刷新——给 Workbench 加 key=chapterNo 
客户端按 ?chapter=N 切章时 React 复用 Workbench 实例，useState(initialText)/
autosave 基线沿用上一章导致显示旧内容。以章号为 key 强制重挂载即用新章草稿刷新。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 18:32:18 +02:00