fix(wiki-pub): 创建发布唯一约束冲突 500 修复（双层防御 + 409 SSOT）

[ThreeFish-AI]

背景

• 本次变更要解决的问题：Wiki 页「新建 Wiki 发布」对话框点击「创建」时，对已存在 LIVE 发布的 Catalog 二次提交 → POST /api/knowledge/wiki/publications 返回 500 Internal Server Error（前端 toast 仅显示「Failed to create wiki publication: Internal Server Error」）。根因为 endpoint 仅捕获 ValueError，未覆盖 sqlalchemy.exc.IntegrityError——DB 部分唯一索引 uq_wiki_pub_catalog_active（Phase A WHERE publish_mode='LIVE'：每 catalog 仅允许 1 个 LIVE）违反时直接漏出 ASGI 中间件栈，前端拿不到任何排障线索。
• 关联上下文：docs/issue.md ISSUE-024（与 ISSUE-016 同 endpoint 不同根因——「错误处理缺失」结构性问题）；约束定义见 migrations/0007_catalog_singleton_phase_a.py。

核心变更

• 后端 endpoint 双层防御 — apps/negentropy/src/negentropy/knowledge/api.py：(a) 业务前置检查：调用 service 前对同 catalog LIVE 发布 / 同 (catalog,slug) 做轻量 select(...).limit(1)，命中即抛 409 + WIKI_PUB_CATALOG_LIVE_CONFLICT / WIKI_PUB_SLUG_CONFLICT，details 携带既有发布 id/name/slug 引导用户跳转编辑或归档；slug 归一化复用 negentropy.knowledge.slug.slugify。(b) IntegrityError 兜底：包裹 db.commit()，按 exc.orig 字符串中约束名映射回 409 code，覆盖竞态与未来新增约束；错误体 {code, message, details} 与既有 _map_exception_to_http 同形，message 中文面向用户。
• 前端透传 — apps/negentropy-ui/features/knowledge/utils/knowledge-api.ts：createWikiPublication 改为复用 handleKnowledgeError<T>，parseKnowledgeError 解析后端 {code, message, details} 后 toast.error(err.message) 自然显示中文友好提示，CreateWikiPublicationDialog UI 零改动。
• 集成测试 — tests/integration_tests/knowledge/test_wiki_publish_modes.py：新增 TestCreateWikiPublicationApiConflict 三例（LIVE 冲突 / SLUG 冲突 / CATALOG_NOT_FOUND 回归）+ isolated_wiki_catalog fixture 用 test-wiki-pub-conflict-<uuid> 派生独立 app_name 规避 dev DB 的 uq_doc_catalogs_app_singleton 约束。
• 文档沉淀 — CHANGELOG.md [Unreleased] / Fixed + docs/issue.md ISSUE-024：根因、五点修复手法、三条后续防范、同型扫荡指引。

风险与回滚

• 主要风险：(1) 业务前置检查与 IntegrityError 兜底两条路径在错误体结构上对齐，但若新增第三方约束，未列入字符串映射的会落入 WIKI_PUB_CONFLICT 通用 code（仍 409，体验降级而非 500）；(2) 新增两次 select(...).limit(1) 查询带来微量额外开销，已通过 .limit(1) 控制；(3) 前端从 res.statusText 改为 handleKnowledgeError，对响应体非 JSON 的极端场景由 parseKnowledgeError 内部 try/catch 兜底为 UNKNOWN_ERROR，不抛 SyntaxError。
• 回滚方式：直接 git revert 本 PR；不涉及 schema / migration 变更；前后端解耦修改可单独回退（虽不建议拆分以免出现「后端 409 但前端读 statusText」中间态）。

验证证据

• 集成测试：uv run pytest tests/integration_tests/knowledge/test_wiki_publish_modes.py::TestCreateWikiPublicationApiConflict --no-cov -v → 3 passed in 2.91s（同一 catalog 二次创建 → 409 LIVE_CONFLICT、slug 重复 → 409 SLUG_CONFLICT、catalog 不存在 → 404 回归）。
• 静态检查：uv run ruff check apps/negentropy/src/negentropy/knowledge/api.py apps/negentropy/tests/integration_tests/knowledge/test_wiki_publish_modes.py → All checks passed；pre-commit hooks（ruff lint / ruff format / ESLint）全绿。
• 预先存在失败排查：同文件其他 11 例在 dev DB 上的失败为 fixture app_name='negentropy' 与共享 dev DB 的 uq_doc_catalogs_app_singleton 冲突（ISSUE-015 单实例 Catalog 收敛副作用），通过 git stash 已验证与本次修复无关。

影响范围

• 前端：apps/negentropy-ui/features/knowledge/utils/knowledge-api.ts::createWikiPublication 错误处理复用既有 handleKnowledgeError；CreateWikiPublicationDialog.tsx 零改动；BFF _proxy.ts 零改动。
• 后端：apps/negentropy/src/negentropy/knowledge/api.py::create_wiki_publication 双层防御；service / DAO / ORM 模型 / migration 零改动；AsyncSessionLocal 路径与 logger 风格沿用。
• GitHub Actions / 文档：CI 配置零改动；CHANGELOG.md + docs/issue.md ISSUE-024 同步沉淀。

Next Best Action

• 同型扫荡审计（建议作为 follow-up）：对 apps/negentropy/src/negentropy/{knowledge,interface,memory,auth}/api.py 全量 db.add(...) + db.commit() 路径做一次 IntegrityError 覆盖审计；interface/api.py:1336/1393/1496 三处 SubAgent 端点已有正确写法可作为模板。
• 前端 fetch helper 写作纪律扫荡：apps/negentropy-ui/features/*/utils/*-api.ts 全文检索 statusText，将 throw new Error(... statusText ...) 形式逐项改为 handleKnowledgeError<T> 统一路径。