weichen
db038aa7a7
App.tsx hardcoded fallbacks (active session "sess-001", projectId 1) sent requests for nonexistent resources on fresh logins against real dev data, producing 7+ console 404/403 hits. Fallbacks now resolve to empty/0; the existing chatBlockedNoProject empty state and session-reconciliation effect carry the UI, and demo-seeds-enabled builds keep the NEUROPULSE fallback. Root cause, same-class scan, and before/after browser evidence (9 phantom requests -> 0, author+member accounts) recorded in the task doc; ISSUES row ISSUE-20260927-demo-fallback registered.
12 KiB
12 KiB
问题与修复台账
维护规则：问题记录与开发经验闭环。每个问题一个稳定 ID；主记录是事实与状态来源，本表为可检索投影。新发现及时登记，修复后保留记录；发布 blocker 仍见 gap-matrix。
更新：2026-09-26。docgov 批准链：登记并修复 review_snapshot_id 装载缺失与 uow 行锁自死锁（resolved）；memDocs 持久化失败缓存投毒（investigating）。历史 resolved 不表示本日产品回归通过。系统 code review P0/P1 批次修复落账（5 resolved + 1 deferred + 1 open，主记录见 整改文档，来源 审计）。
| issue_id | 模块 / 检索词 | 问题 | 严重度 | issue_state | owner | 证据日期 / 范围 | 唯一主记录 | 经验 |
|---|---|---|---|---|---|---|---|---|
| ISSUE-20260923-nullable-duty | docgov / nullable / 23503 / reviewer_id | 可选职责空值写 0 导致 FK 失败 | high | resolved | Codex（历史补录） | 2026-09-17；历史 PG / API 冒烟；当前未复测 | 主记录 | LESSON-20260923-nullable-duty |
| ISSUE-20260923-content-hash | docrevision / canonicalize / hard-break / 404 | 规范化破坏 Markdown 语义并造成正文哈希漂移 | critical | resolved | Codex（历史补录） | 2026-09-14；历史真实 UI / 重启；当前未复测 | 主记录 | LESSON-20260923-content-hash |
| ISSUE-20260923-coordination-authority | agentctl / claim / SQLite / CAS / CURRENT / FEATURE-MATRIX | 本地副本 CAS 与任务许可不能表达跨主机全局权威认领 | high | investigating | Codex（研究） | 2026-09-23；源码/只读状态，未复现具体丢写 | 主记录 | 沿用 content-hash 投影经验；跨机结论待实施验证 |
| ISSUE-20260923-matrix-status-regression | FEATURE-MATRIX / module-batches-ag / merge / docs-apply | 矩阵行 done 被 closeout 合并冲突手解回退为 planned | high | resolved | Cursor | 2026-09-23；本机 tip 与 git 考古；docs apply 已恢复 | 主记录 | LESSON-20260923-matrix-status-cas |
| ISSUE-20260924-admin-reset-dead | auth / adminResetPassword / T20-F4 / chenwei | 管理台重置密码死按钮；验收口令不可知后无法恢复 | high | resolved | Cursor | 2026-09-24；test 库实查 + API 单测 | 主记录 | 待补 LESSON |
| ISSUE-20260924-login-error-envelope | auth / AUTHZ / 无权访问 / auth.ts | 登录失败展示裸 JSON / 「无权访问」误导 | medium | resolved | Cursor | 2026-09-24；wire 复现 + 前端单测 | 主记录 | 待补 LESSON |
| ISSUE-20260924-zombie-credentials | auth / user_credentials / LEFT JOIN / CreateUser | 空哈希静默建号导致永久无法登录 | high | resolved | Cursor | 2026-09-24；三环境只读盘点；机制修复不含存量清理 | 主记录 | 待补 LESSON |
| ISSUE-20260924-cursor-test-rule-drift | Cursor / test-reports / 固定模型 / 规则副本 | Cursor 测试规则与验证契约存在固定模型及范围冲突 | medium | verifying | Cursor | 2026-09-24；规则文本已缩为验证契约指针；客户端实际读取行为待实机 | 主记录 | LESSON-20260924-cursor-hook-advisory-gates |
| ISSUE-20260924-pi-executor-boundaries | PI executor / 路径规范化 / MCP / 子进程 / 幂等 | 未发布初版只读边界与执行可靠性缺陷 | high | resolved | Cursor/Codex | 2026-09-24；173 工程回归与真实 Cursor CLI/MCP/PI | 主记录 | 工具路径与输入隔离 |
| ISSUE-20260924-cursor-cli-mcp-path | Cursor CLI / MCP / workspaceFolder / NDJSON | agentctl/jev MCP 加载失败（路径 + Content-Length 回包） | medium | verifying | Cursor | 2026-09-24；相对路径+NDJSON 已修；待 IDE 重载后 list-tools 实机 | 主记录 | LESSON-20260924-cursor-hook-advisory-gates |
| ISSUE-20260924-cursor-hook-event-contract | Cursor / hooks / beforeMCPExecution / probe | hook 事件 stdin 字段名与 matcher 官方未文档化 | medium | verifying | Cursor | 2026-09-24；IDE postToolUse tool_name=MCP:pi_subagent_roles 已采样；beforeMCP 全量 stdin 仍缺 |
主记录 | LESSON-20260924-cursor-hook-advisory-gates |
| ISSUE-20260924-non-author-400-duty | iam-authz / docgov / duty / 400 / 非编制 | 权限不足误报 400；run/edit 与编制职责绑死导致成员无法上传总结写草稿 | high | resolved | Cursor | 2026-09-24；真实 PI TestNonAuthorMember_PiAgent_RunEditSubmitGates PASS |
主记录 | LESSON-20260924-deny-only-submit |
| ISSUE-20260926-docgov-snapshot-load | docgov / loadDocumentFromDBLocked / review_snapshot_id / 跨重启批准 | 文档装载 SELECT 漏 review_snapshot_id，重启/缓存未命中后最终批准必失败 | high | resolved | pi | 2026-09-26；隔离库 PG 回归 + dev 真实批准 200/state=approved（dev 121b33f8） |
主记录 | 待补 LESSON |
| ISSUE-20260926-docgov-uow-deadlock | docgov / persistApproveAndFAV / uow / FOR UPDATE / 57014 | docflow uow 行锁后 FAV 持久化自开第二连接更新同行，语句超时致死锁，所有最终批准失败 | critical | resolved | pi | 2026-09-26；生产形状 PG 回归（FOR UPDATE+FAV+Within）+ dev 真实批准转 200（dev 5d5cd5fd） |
主记录 | 待补 LESSON |
| ISSUE-20260926-docgov-memdocs-poison | docgov / memDocs / 状态机 / 持久化失败 / 缓存投毒 | 状态机先改内存后落库；持久化失败不复原，memDocs 缓存与 DB 永久分叉并掩盖真实错误（表现为「approved 状态」误报） | high | investigating | pi | 2026-09-26；dev 两次复现（快照/死锁两根因均被投毒掩盖）；修复方向：失败时回滚内存快照或失效缓存条目 | 主记录 | 待补 LESSON |
| ISSUE-20260926-ctx-idor | ctxmgr / GetUserContext / session_id / IDOR / handlers_context | GetUserContext 按 session_id 取消息无归属校验，登录用户可读他人会话正文（已证实） | critical | resolved | pi | 2026-09-26；handler 403 + SQL/内存双防线；内存 HTTP 与隔离 PG 回归 PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-archcheck-untracked | archtest / table_owners / untracked / sql_write / 门禁盲区 | arch-check 对未登记表 SQL 写静默跳过，含 swboot_controlled_executions 等 ~50 表；门禁形同关闭 | critical | resolved | pi | 2026-09-26；未登记表 fail-closed + 补登 50 表 + 噪音豁免清单；arch-check block PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-authz-failopen | authz / IsProjectMember / pool==nil / fail-open / NewInMemoryAuthorizer | Authorizer 无池时 IsProjectMember/IsProjectOwner 对任意登录用户返回 true，误配即全量放行 | high | resolved | pi | 2026-09-26；无池严格拒绝 + 显式内存授权接缝 + 组合根按 AllowInMemory 选择；隔离 PG authz 套件 PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-swboot-shell-prefix | swboot / executor / sh -c / 命令注入 / 前缀白名单 / commandAllowed | 受控命令经 sh -c 执行且白名单前缀匹配（go 放行 go-evil）；元字符可求值 | high | resolved | pi | 2026-09-26；argv 化 + basename 精确匹配；前缀伪装/不求值回归 PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-intentflow-validated-confirm | intentflow / DecisionConfirm / PlanProposed / validated_only / ExecuteClaimed | validated_only（shadow）计划可经 Confirm 进入 executing 并真实执行；执行器不读 ExecutionMode | high | resolved | pi | 2026-09-26；Confirm 拒 + 执行器硬拒双层 + 错误码/HTTP 映射；确认/派发双回归 PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-dual-flags-drift | intent / intentflow / FeatureFlags / PlanTier / MULTI_INTENT_ENABLED / 静默漂移 | 双套 flags 可配置出「intentflow 升档但 intent 关闭」的矛盾组合并静默降级 | high | resolved | pi | 2026-09-26；组合根经 intentflow.ValidateFlagConsistency 启动期 fail-fast + 单测；入口收敛残差另立 deferred | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-governance-multi-entry | docgov / 多意图 / 多入口 / Coordinator / OwnerMux / GovernanceEngine | docgov 三入口 + Coordinator ~40 case 与 intentflow OwnerMux 平行，鉴权/确认/审计易漂移 | high | deferred | pi | 2026-09-26；flag 漂移面已修（dual-flags-drift）；入口合并是多日级重构，需独立任务授权与回归矩阵 | 主记录 | 沿用 failclosed-bypass-contract |
| ISSUE-20260926-server-pool-wiring | server / swboot_handlers / Runtime.Pool / 组合根越界 / FIND-ARCH-02 | server 持 Pool 直装 swboot repo/executor 并直查表，成为第二组合根（本轮未授权修复） | critical | open | pi | 2026-09-26；代码审证据齐（审计 FIND-ARCH-02），待修复授权 | 主记录 | 待修复后补 |
| ISSUE-20260927-demo-fallback | web / App.tsx / sess-001 / projectId fallback / demo seeds 关闭 | demo seeds 关闭模式下前端硬编码 fallback（激活 sess-001、项目 1）对真实后端发假请求，新登录用户首屏 9 个 404/403（chat 窗口被迫回退本地缓存） | medium | resolved | pi | 2026-09-27；dev 真实浏览器修复前后对照（author+member 双账号：9 假请求→0） | 主记录 | 经验小结（独立 lesson 待后续任务补登） |