docs: review P0/P1 fix records, ISSUES ledger, lesson, task claim
- remediation master record for 5 resolved + 1 deferred + 1 open issues - ISSUES.md rows with evidence dates and lesson links - LESSON-20260926-failclosed-bypass-contract (validated) - remediation/lessons INDEX hooks + CURRENT task row (docs apply receipt)
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
|
||||
维护规则:[问题记录与开发经验闭环](../ops/2026-09-23-issue-learning-workflow.md)。每个问题一个稳定 ID;主记录是事实与状态来源,本表为可检索投影。新发现及时登记,修复后保留记录;发布 blocker 仍见 [gap-matrix](../remediation/gap-matrix.md)。
|
||||
|
||||
更新:2026-09-26。docgov 批准链:登记并修复 review_snapshot_id 装载缺失与 uow 行锁自死锁(resolved);memDocs 持久化失败缓存投毒(investigating)。历史 resolved 不表示本日产品回归通过。
|
||||
更新:2026-09-26。docgov 批准链:登记并修复 review_snapshot_id 装载缺失与 uow 行锁自死锁(resolved);memDocs 持久化失败缓存投毒(investigating)。历史 resolved 不表示本日产品回归通过。系统 code review P0/P1 批次修复落账(5 resolved + 1 deferred + 1 open,主记录见 [整改文档](2026-09-26-system-code-review-fixes.md),来源 [审计](2026-09-26-system-code-review.md))。
|
||||
|
||||
| issue_id | 模块 / 检索词 | 问题 | 严重度 | issue_state | owner | 证据日期 / 范围 | 唯一主记录 | 经验 |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
@@ -21,3 +21,11 @@
|
||||
| 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`) | [主记录](../test-reports/2026-09-26-rdev-p3-rerun-test-report.md#5-2) | 待补 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`) | [主记录](../test-reports/2026-09-26-rdev-p3-rerun-test-report.md#5-2) | 待补 LESSON |
|
||||
| ISSUE-20260926-docgov-memdocs-poison | docgov / memDocs / 状态机 / 持久化失败 / 缓存投毒 | 状态机先改内存后落库;持久化失败不复原,memDocs 缓存与 DB 永久分叉并掩盖真实错误(表现为「approved 状态」误报) | high | investigating | pi | 2026-09-26;dev 两次复现(快照/死锁两根因均被投毒掩盖);修复方向:失败时回滚内存快照或失效缓存条目 | [主记录](../test-reports/2026-09-26-rdev-p3-rerun-test-report.md#5-2) | 待补 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 | [主记录](../remediation/2026-09-26-system-code-review-fixes.md#1-find-sec-01-会话上下文-idorissue-20260926-ctx-idor) | [LESSON-20260926-failclosed-bypass-contract](../ops/lessons/2026-09-26-failclosed-bypass-contract.md) |
|
||||
| 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 | [主记录](../remediation/2026-09-26-system-code-review-fixes.md#2-find-arch-01-arch-check-未登记表静默跳过issue-20260926-archcheck-untracked) | [LESSON-20260926-failclosed-bypass-contract](../ops/lessons/2026-09-26-failclosed-bypass-contract.md) |
|
||||
| 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 | [主记录](../remediation/2026-09-26-system-code-review-fixes.md#3-find-sec-02-authorizer-无池-fail-openissue-20260926-authz-failopen) | [LESSON-20260926-failclosed-bypass-contract](../ops/lessons/2026-09-26-failclosed-bypass-contract.md) |
|
||||
| ISSUE-20260926-swboot-shell-prefix | swboot / executor / sh -c / 命令注入 / 前缀白名单 / commandAllowed | 受控命令经 sh -c 执行且白名单前缀匹配(go 放行 go-evil);元字符可求值 | high | resolved | pi | 2026-09-26;argv 化 + basename 精确匹配;前缀伪装/不求值回归 PASS | [主记录](../remediation/2026-09-26-system-code-review-fixes.md#4-find-sec-03-swboot-sh--c--前缀白名单issue-20260926-swboot-shell-prefix) | [LESSON-20260926-failclosed-bypass-contract](../ops/lessons/2026-09-26-failclosed-bypass-contract.md) |
|
||||
| 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 | [主记录](../remediation/2026-09-26-system-code-review-fixes.md#5-find-flow-01-validated_only-可-confirm-后-dispatchissue-20260926-intentflow-validated-confirm) | [LESSON-20260926-failclosed-bypass-contract](../ops/lessons/2026-09-26-failclosed-bypass-contract.md) |
|
||||
| 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 | [主记录](../remediation/2026-09-26-system-code-review-fixes.md#6-find-qual-01-双套-flags-静默漂移issue-20260926-dual-flags-drift含残差) | [LESSON-20260926-failclosed-bypass-contract](../ops/lessons/2026-09-26-failclosed-bypass-contract.md) |
|
||||
| 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);入口合并是多日级重构,需独立任务授权与回归矩阵 | [主记录](../remediation/2026-09-26-system-code-review-fixes.md#6-find-qual-01-双套-flags-静默漂移issue-20260926-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),待修复授权 | [主记录](../audit/2026-09-26-system-code-review.md) | 待修复后补 |
|
||||
|
||||
@@ -18,6 +18,7 @@
|
||||
|
||||
| owner | task | branch | worktree | mutex | status |
|
||||
|---|---|---|---|---|---|
|
||||
| pi | system-review-p0-p1-fixes-2026-09-26 | fix/system-review-p0-p1-fixes-2026-09-26 | .worktrees/system-review-p0-p1-fixes-2026-09-26 | review-fixes-batch | in_progress |
|
||||
| pi | swboot-closeout-2026-09-26-r3 | feature/swboot-closeout-2026-09-26 | .worktrees/swboot-closeout-2026-09-26 | workflow-design | done |
|
||||
| pi | swboot-closeout-2026-09-26-r2 | feature/swboot-closeout-2026-09-26 | .worktrees/swboot-closeout-2026-09-26 | workflow-design | in_progress |
|
||||
| pi | chat-semantic-replace-2026-09-26 | feature/chat-semantic-replace-2026-09-26 | .worktrees/chat-semantic-replace-2026-09-26 | chat | done |
|
||||
|
||||
@@ -0,0 +1,56 @@
|
||||
---
|
||||
lesson_id: LESSON-20260926-failclosed-bypass-contract
|
||||
lesson_state: validated
|
||||
created: 2026-09-26
|
||||
updated: 2026-09-26
|
||||
source_issues:
|
||||
- ISSUE-20260926-ctx-idor
|
||||
- ISSUE-20260926-archcheck-untracked
|
||||
- ISSUE-20260926-authz-failopen
|
||||
- ISSUE-20260926-swboot-shell-prefix
|
||||
- ISSUE-20260926-intentflow-validated-confirm
|
||||
reviewed_by: pi
|
||||
last_reviewed: 2026-09-26
|
||||
reviewed_revision: "fix/system-review-p0-p1-fixes-2026-09-26"
|
||||
keywords: [IDOR, 旁路, fail-open, fail-closed, 白名单前缀, sh -c, validated_only, table_owners, untracked, session_id, 归属校验]
|
||||
---
|
||||
|
||||
# 旁路入口与「未知即拒绝」契约
|
||||
|
||||
## 触发条件
|
||||
|
||||
- 新增/评审任何**绕过主用例路径**的 HTTP handler(尤其按 `session_id`/`project_id`/`user_id` 直接取资源的旁路端点)。
|
||||
- 写门禁扫描器、授权器或执行器时出现「未登记/未配置/依赖缺失」分支。
|
||||
- 注释或文档声称某 flag/mode 是安全边界(如 `validated_only must never be written as succeeded`)。
|
||||
- 命令/路径白名单实现(前缀匹配、`sh -c` 拼接)。
|
||||
|
||||
## 机制与应做检查
|
||||
|
||||
1. **主路径绿 ≠ 旁路绿**:主路径(chatflow/Owner 等)的鉴权不会自动覆盖旁路 handler。每个按标识取资源的入口都要复用同一归属校验(如 `GetSessionOwnerID`),并在 SQL/存储层再加归属条件作防御纵深——handler 层校验可能被未来调用方遗漏。
|
||||
2. **门禁对「未知」必须拒绝**:扫描器遇到未登记对象 `continue` 等于该维度门禁关闭(arch-check 未登记表曾静默跳过 ~50 张表的真实写)。正确形状:未登记→finding,假阳性用显式且可审计的豁免清单。
|
||||
3. **授权器缺依赖时不得放行**:`pool==nil` 返回 true 是 fail-open;需要演示/测试宽松语义时,用**显式命名的构造器**(`NewInMemoryAuthorizer`)+ 组合根按配置选择,默认路径严格拒绝。
|
||||
4. **契约写在注释里不算数**:`validated_only` 之类执行模式必须由执行器硬读硬拒(Confirm 拒 + ExecuteClaimed 拒双层),安全不能依赖「没人点 Confirm」或上游状态机不犯错。
|
||||
5. **白名单用精确匹配 + argv 执行**:basename 前缀匹配可被 `go-evil` 伪装;`sh -c` 让元字符求值。argv 化后元字符只是字面参数。
|
||||
|
||||
## 错误做法与原因
|
||||
|
||||
- 只给主路径补鉴权、把旁路留给「下次」——本仓 IDOR 事故高发位正是旁路 HTTP。
|
||||
- 用「未配置就放行」降低接线摩擦——组合根永远能构造成功,fail-open 在误配时静默生效。
|
||||
- 用测试 override `NewAuthorizer(nil)` 当「跳过检查」接缝——它同时是生产 fail-open 的机制本身;接缝必须显式命名。
|
||||
|
||||
## 验证方法
|
||||
|
||||
- 回归覆盖:原例(他户标识→403/空)、同类变体(不存在→同构拒绝、admin 越权面)、正常行为(本人→200 且数据完整)。
|
||||
- 门禁类:自测夹具证明未登记对象 block、已知假阳性不误报;全仓门禁在登记完成后 PASS。
|
||||
- 执行类:伪装命令拒绝、元字符不求值(marker 文件不产生)、owner 零调用计数。
|
||||
|
||||
## 适用边界
|
||||
|
||||
- 适用于进程内授权、静态扫描门禁、命令白名单、执行模式契约四类机制;不覆盖网络层/跨服务鉴权。
|
||||
- 豁免清单(如扫描噪音词)是启发式产物:新假阳性出现时应先确认确非真实表,再扩清单。
|
||||
|
||||
## 关联
|
||||
|
||||
- 来源修复:[2026-09-26 系统 code review P0/P1 修复](../../remediation/2026-09-26-system-code-review-fixes.md)
|
||||
- 发现审计:[2026-09-26 系统全面 code review](../../audit/2026-09-26-system-code-review.md)
|
||||
- 关联回归:`TestGetUserContext_*`、`TestUntrackedTableWriteIsBlocked`、`TestMembershipChecks_FailClosedWithoutPool`、`TestExecutor_CommandAllowlistIsExactNotPrefix`、`TestExecutor_NoShellEvaluation`、`TestConfirmRejectedForValidatedOnlyPlan`、`TestExecuteClaimedRefusesValidatedOnlyStep`
|
||||
@@ -10,5 +10,6 @@
|
||||
| LESSON-20260924-pi-tool-boundaries | PI、MCP、readonly、path、snapshot、process-group | 路径语义与快照边界一致,合法路径和拒绝路径都验收 | validated | [文件工具边界](2026-09-24-pi-tool-boundaries.md);2026-09-24 |
|
||||
| LESSON-20260924-cursor-hook-advisory-gates | Cursor、hooks、advisory、fail-open、probe、stdin | hook 与执行器分层;契约未知 fail-open;审计日志放 ignore 路径 | candidate | [客户端 hook 门禁](2026-09-24-cursor-hook-advisory-gates.md);2026-09-24 |
|
||||
| LESSON-20260924-deny-only-submit | 非编制、DOC_DUTY、400、run/edit、送审 | 权限哨兵映射 403;三道门协同放宽;ActorIsMember 不复用 RoleSystem | validated | [deny_only_submit](2026-09-24-deny-only-submit.md);2026-09-24 |
|
||||
| LESSON-20260926-failclosed-bypass-contract | IDOR、旁路、fail-open、白名单前缀、sh -c、validated_only、untracked、table_owners | 旁路入口必须继承主路径硬边界+SQL 防御纵深;门禁/授权器/执行器对未知默认拒绝;安全契约由执行器硬拒不依赖注释 | validated | [旁路与未知即拒绝契约](2026-09-26-failclosed-bypass-contract.md);2026-09-26 |
|
||||
|
||||
validated 的证据范围见各条目;本日复核为历史材料和源码阅读,未重跑产品回归。后续按机制补充,过时条目标 superseded/retired 并保留替代链接。
|
||||
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: "系统 Code Review P0/P1 修复(2C+3H)"
|
||||
task_id: "system-review-p0-p1-fixes-2026-09-26"
|
||||
status: in_progress
|
||||
created: 2026-09-26
|
||||
updated: 2026-09-26
|
||||
owner: pi
|
||||
task_type: implementation
|
||||
task_tier: cross-module
|
||||
policy_revision: "agent-governance-2026-09-21-r1 @ f4c1b73f"
|
||||
branch: fix/system-review-p0-p1-fixes-2026-09-26
|
||||
worktree: .worktrees/system-review-p0-p1-fixes-2026-09-26
|
||||
base_dev_sha: "f4c1b73f28580ad3df6db4f9ec0a80057006e516"
|
||||
write_scope: ["internal/server", "internal/ctxmgr", "internal/authz", "internal/swboot", "internal/archtest", "internal/app/intentflow", "internal/intent", "internal/app/app.go", ".doc"]
|
||||
allowed_environments: []
|
||||
mutex: "review-fixes-batch"
|
||||
review_state: pending
|
||||
integration_state: pending
|
||||
deployment: pending
|
||||
cleanup: pending
|
||||
remote_sync: not_requested
|
||||
---
|
||||
|
||||
# 系统 Code Review P0/P1 修复
|
||||
|
||||
## 用户目标与授权
|
||||
|
||||
- **来源**:[2026-09-26 系统 code review](../../audit/2026-09-26-system-code-review.md) 发现项。
|
||||
- **用户授权**(2026-09-26):一并修复 2 Critical(FIND-SEC-01、FIND-ARCH-01)+ 3 个 High 行(FIND-SEC-02/03、FIND-FLOW-01、FIND-QUAL-01);修复完成后与审计报告**一起提交**(同一批集成);完成后清理 worktree 任务分支。
|
||||
- **禁止项**:未授权环境写、push、晋升 test/main;FIND-ARCH-02(server Pool 接线)未在授权修复范围(ISSUES 登记 open)。
|
||||
|
||||
## 范围
|
||||
|
||||
- 修复主记录(含逐项根因/方案/回归):[remediation/2026-09-26-system-code-review-fixes.md](../../remediation/2026-09-26-system-code-review-fixes.md)。
|
||||
- Issue 台账:ISSUE-20260926-ctx-idor / archcheck-untracked / authz-failopen / swboot-shell-prefix / intentflow-validated-confirm / dual-flags-drift(resolved)+ governance-multi-entry(deferred)+ server-pool-wiring(open)。
|
||||
- 经验:LESSON-20260926-failclosed-bypass-contract(validated)。
|
||||
|
||||
## 问题检索与采纳
|
||||
|
||||
检索词:`IDOR`、`GetUserContext`、`session_id`、`validated_only`、`table_owners`、`untracked`、`fail-open`、`sh -c`、`前缀白名单`、`PlanTier`。命中:来源审计 FIND-*(全部);ISSUES 无同题已关闭条目;经验库无同机制 lesson(本轮新建)。采纳检查:模块规范 §2.1/§4(表唯一写者、端口装配)、验证契约「问题修复的回归范围」(原例+同类+正常行为)。
|
||||
|
||||
## 计划与进展
|
||||
|
||||
1. [x] worktree + 登记(base f4c1b73f)
|
||||
2. [x] 六项修复实施 + 回归用例
|
||||
3. [x] 验证:arch-check block / vet / short 全量 / 隔离 PG(IDOR PG、authz、duty);两个基线既有失败已核对非本批回归
|
||||
4. [x] 文档:修复主记录、ISSUES、lesson、索引
|
||||
5. [x] 提交
|
||||
6. [ ] 集成(含审计报告分支同批 --no-ff)
|
||||
7. [ ] 部署核验(dev 共享服务重启 + health/ready/业务行为——需另授权或独立部署任务)
|
||||
8. [ ] 清理(本任务 + 审计任务 worktree/分支)
|
||||
|
||||
## 验证
|
||||
|
||||
详见[修复主记录验收汇总](../../remediation/2026-09-26-system-code-review-fixes.md#验收汇总)。要点:arch-check block PASS(fail-closed 后)、vet/short 全绿、隔离 PG(55432 verify 容器临时库)IDOR/authz/duty PASS;`TestHealProjectDocuments_SkipsDutyLocked_PG` 与 PI E2E(KB 离线)为基线既有失败(stash 对照证实)。
|
||||
|
||||
## 状态与交接
|
||||
|
||||
- 集成后:任务状态改 done;审计任务(system-code-review-2026-09-26)的 integration/cleanup 由本批一并推进。
|
||||
- 部署:`deployment=pending`(代码影响运行内容;dev 服务重启与核验未在本任务授权内,见修复主记录)。
|
||||
@@ -0,0 +1,97 @@
|
||||
---
|
||||
title: "系统 Code Review P0/P1 修复(IDOR、门禁盲区、fail-open、命令白名单、validated_only 硬拒)"
|
||||
status: done
|
||||
created: 2026-09-26
|
||||
updated: 2026-09-26
|
||||
owner: pi
|
||||
task_id: "system-review-p0-p1-fixes-2026-09-26"
|
||||
severity: critical
|
||||
source_audit: "../audit/2026-09-26-system-code-review.md"
|
||||
base_dev_sha: "f4c1b73f28580ad3df6db4f9ec0a80057006e516"
|
||||
---
|
||||
|
||||
# 系统 Code Review P0/P1 修复
|
||||
|
||||
来源:[2026-09-26 系统全面 code review](../audit/2026-09-26-system-code-review.md)(被审 tip `f4c1b73f`)。
|
||||
用户授权(2026-09-26):修复 2 Critical(FIND-SEC-01、FIND-ARCH-01)+ 3 个 High 行(FIND-SEC-02/03、FIND-FLOW-01、FIND-QUAL-01),修复后与报告一起集成,清理任务 worktree。本文件是下列 issue 的唯一主记录;发现细节与证据链以来源审计为准,此处记修复方案、经过与验收。
|
||||
|
||||
## 修复范围与 issue 映射
|
||||
|
||||
| FIND | issue_id | 修复内容 | 状态 |
|
||||
|---|---|---|---|
|
||||
| FIND-SEC-01 | ISSUE-20260926-ctx-idor | GetUserContext 会话归属校验(handler 403 + SQL/内存双防线) | resolved |
|
||||
| FIND-ARCH-01 | ISSUE-20260926-archcheck-untracked | arch-check 未登记表 fail-closed + 补登记 50 表 | resolved |
|
||||
| FIND-SEC-02 | ISSUE-20260926-authz-failopen | Authorizer 无池严格拒绝;显式 NewInMemoryAuthorizer 接缝 | resolved |
|
||||
| FIND-SEC-03 | ISSUE-20260926-swboot-shell-prefix | argv 化执行(去 sh -c)+ 白名单精确匹配 | resolved |
|
||||
| FIND-FLOW-01 | ISSUE-20260926-intentflow-validated-confirm | Confirm 拒 validated_only + 执行器硬读 mode | resolved |
|
||||
| FIND-QUAL-01 | ISSUE-20260926-dual-flags-drift | 组合根 flag 一致性 fail-fast | resolved(含残差) |
|
||||
| FIND-QUAL-01(入口收敛残差) | ISSUE-20260926-governance-multi-entry | docgov 三入口 + Coordinator/OwnerMux 合并 | deferred |
|
||||
| FIND-ARCH-02 | ISSUE-20260926-server-pool-wiring | server 持 Pool 直装 swboot(本轮未授权修复) | open |
|
||||
|
||||
## 各项修复经过
|
||||
|
||||
### 1. FIND-SEC-01 会话上下文 IDOR(ISSUE-20260926-ctx-idor)
|
||||
|
||||
- **根因**:`handleGetUserContext` 只校验 `user_id` 归属,`session_id` 直通 `GetUserContext`;`chat_messages` 查询 `WHERE session_id = $1` 无归属条件,绕过 chatflow 的会话授权。
|
||||
- **修复**(双层):
|
||||
- `internal/server/handlers_context.go`:sessionID 非空时经 `GetSessionOwnerID` 校验归属(不存在与归属他人同返 403,不泄露存在性)。
|
||||
- `internal/ctxmgr/manager.go`:SQL 增加 `EXISTS(chat_sessions 归属目标用户)` 子句;内存分支按 `sessions[sessionID].UserID == userID` 过滤——未来调用方遗漏 handler 校验也不泄露。
|
||||
- **回归**:`TestGetUserContext_OtherUserSessionDenied`(他户 session→403、不存在→403、本人→200 且含正文,内存 HTTP);`TestGetUserContext_PG_SessionOwnerFilter`(隔离 PG 库:他人视角 manager 层不返回正文、归属者正常)。
|
||||
|
||||
### 2. FIND-ARCH-01 arch-check 未登记表静默跳过(ISSUE-20260926-archcheck-untracked)
|
||||
|
||||
- **根因**:`internal/archtest/scan.go` `if !tracked { continue }`——表唯一写者门禁对未登记表(含 `swboot_controlled_executions`、`projects`、`outbox_events` 等)无强制力。
|
||||
- **修复**:
|
||||
- scan.go:未登记表产生 `sql_write` finding(fail-closed);仅豁免扫描正则已知假阳性词汇(`set/of/skip/below/row/state/step/doc/docgov/message/project/aggregation/ref_count`,来自 `ON CONFLICT DO UPDATE SET`、`FOR UPDATE OF/SKIP LOCKED` 与注释散文;静态清单,非策略豁免)。
|
||||
- `module-boundaries.yaml`:补登记 50 张既有写者真实表。多 owner 条目(`projects`、`users`、`project_members`、`context_memory_chunks`)是现状快照,新包写入仍被 block;单一写者收敛留在各模块批次(见 ISSUES 残差说明)。
|
||||
- **回归**:`TestUntrackedTableWriteIsBlocked`(新表写入必须 block 且 detail 提示登记);`TestUpsertSetKeywordIsNotFlaggedAsUntracked`(SET 噪音不误报)。全仓 `arch-check --mode block` PASS。
|
||||
|
||||
### 3. FIND-SEC-02 Authorizer 无池 fail-open(ISSUE-20260926-authz-failopen)
|
||||
|
||||
- **根因**:`IsProjectMember/IsProjectOwner` 在 `!enabled()`(pool==nil)时 `return userID > 0` ——任意登录用户获得任意项目访问;组合根始终 `NewAuthorizer(pool)`,nil pool 也构造成功,绕过「nil→failClosed」语义。
|
||||
- **修复**:`NewAuthorizer(nil)` 一律严格拒绝(false);新增显式 `NewInMemoryAuthorizer()` 仅供 ALLOW_IN_MEMORY 演示/测试接缝(视任意登录用户为成员);组合根 `app.Assemble` 在 `pool==nil && cfg.AllowInMemory` 时选用。误配(无库且未显式声明)→ 拒绝。
|
||||
- **波及与处置**:8 个依赖 fail-open 作测试接缝/隐式放行的既有用例——1 个改用显式内存授权 override,5 个业务行为用例改走 `newServerWithMemoryIAM`/`AllowInMemory=true`(显式演示模式契约),1 组 u5 用例补 `ModeLive`(属 FLOW-01 波及),1 个生命周期用例由组合根修复自然恢复。无削弱鉴权断言的用例。
|
||||
- **回归**:`TestMembershipChecks_FailClosedWithoutPool`;隔离 PG 库 authz 套件(ConcurrentLastWriter/DocumentDuty/AtomicDutyRevoke/UpsertProjectMember)PASS。
|
||||
|
||||
### 4. FIND-SEC-03 swboot sh -c + 前缀白名单(ISSUE-20260926-swboot-shell-prefix)
|
||||
|
||||
- **根因**:受控命令经 `sh -c cmdLine` 执行;允许判定为 basename 前缀匹配(`go` 放行 `go-evil`)。ApproveMerge 自身恒拒未变。
|
||||
- **修复**:`runCommand` 改 argv 化 `exec.CommandContext(fields[0], fields[1:]...)`(元字符只成为字面参数);`commandMatchesPrefixes`→`commandAllowed`,仅 basename 精确相等(含绝对路径条目取其 basename)。admin 白名单粒度仍是真实边界(报告 FIND-SEC-03 说明),运维登记白名单时应只放具体命令名。
|
||||
- **回归**:`TestExecutor_CommandAllowlistIsExactNotPrefix`(前缀伪装拒绝、精确/绝对路径放行、空命令拒绝);`TestExecutor_NoShellEvaluation`(`echo x && touch <marker>` 不求值、marker 不产生、输出为字面参数)。
|
||||
|
||||
### 5. FIND-FLOW-01 validated_only 可 Confirm 后 dispatch(ISSUE-20260926-intentflow-validated-confirm)
|
||||
|
||||
- **根因**:`DecisionConfirm` 允许 `PlanProposed`;确认后 HTTP 即 `DispatchEligible`;`ExecuteClaimed` 不读 `ExecutionMode`——shadow「安全」依赖「没人点 Confirm」。
|
||||
- **修复**(双层):
|
||||
- `DecidePlan`:Confirm 对 `plan.ExecutionMode == validated_only` 一律 `ErrPlanModeNotConfirmable`(403)。
|
||||
- `ExecuteClaimed`:硬读步骤级(缺省计划级)ExecutionMode,`validated_only` 一律 `ErrPlanModeNotExecutable`——覆盖所有派发路径(confirm 后、worker、误推进)。
|
||||
- 新错误码 `PLAN_MODE_NOT_CONFIRMABLE` / `PLAN_MODE_NOT_EXECUTABLE` 入 `ErrorCode` 与 HTTP 映射。
|
||||
- **回归**:`TestConfirmRejectedForValidatedOnlyPlan`;`TestExecuteClaimedRefusesValidatedOnlyStep`(经 DecisionContinue 误推进后 DispatchEligible 硬拒,步骤不成 succeeded、owner 零执行)。既有 4 个用例的 `draft()` helper 补显式 `ModeLive`(缺省 validated_only 是安全默认,live 机制用例需显式声明)。
|
||||
|
||||
### 6. FIND-QUAL-01 双套 flags 静默漂移(ISSUE-20260926-dual-flags-drift,含残差)
|
||||
|
||||
- **修复**:`intentflow.ValidateFlagConsistency`(组合根 `Assemble` 调用)——`PlanTier` 升档但 `MULTI_INTENT_ENABLED=false` 时启动期 fail-fast(`Assemble` 最早阶段调用),消除「intentflow 已升档、intent 仍关」静默漂移配置上线。
|
||||
- **回归**:`TestValidateIntentFlagConsistency`(升档+开=过;legacy 恒过;四档×关=拒)。
|
||||
- **残差(deferred,ISSUE-20260926-governance-multi-entry)**:docgov 三入口(chat PendingAction / docgov_owner / handlers_docgov)与 Coordinator ~40 intent case + OwnerMux 平行面合并是多日级重构(自带回归矩阵),超出本批授权合理范围;已在 ISSUES 登记 owner/触发条件。
|
||||
|
||||
## 验收汇总
|
||||
|
||||
被测 SHA:本任务 worktree HEAD(见下方提交记录);基线 `f4c1b73f`。
|
||||
|
||||
| 检查 | 结果 |
|
||||
|---|---|
|
||||
| `./scripts/arch-check.sh --mode block` | PASS(fail-closed 改动 + 50 表登记后) |
|
||||
| `go vet ./...` | PASS |
|
||||
| `go test -short ./...` | 全绿 |
|
||||
| 隔离 PG:`TestGetUserContext_PG_SessionOwnerFilter` | PASS(临时库建删于 55432 verify 容器) |
|
||||
| 隔离 PG:authz + server duty 套件 | PASS |
|
||||
| 隔离 PG:duty-sync 脚本 | `TestHealProjectDocuments_SkipsDutyLocked_PG` FAIL——**基线 f4c1b73f 同样失败**(FK fixture 既有问题,与本批无关) |
|
||||
| `TestPiAgent_FullLifecycle_MultiRole_RealWorld_E2E` | 非 short 模式因 KB 离线前置检查失败——**基线同样失败**(需真实 Runner/KB,非本批回归) |
|
||||
|
||||
## 部署
|
||||
|
||||
代码已按授权集成 local_dev(见任务记录)。dev 共享服务未在本任务内重建/重启(未获 env 写授权);`deployment=pending`,重启与 `/health`、`/ready`、业务行为核验待部署任务执行。
|
||||
|
||||
## 经验
|
||||
|
||||
见 [LESSON-20260926-failclosed-bypass-contract](../ops/lessons/2026-09-26-failclosed-bypass-contract.md):旁路入口必须继承主路径硬边界;门禁/执行器对「未知」默认必须拒绝。
|
||||
@@ -2,6 +2,7 @@
|
||||
|
||||
| 文档 | 说明 |
|
||||
|------|------|
|
||||
| [2026-09-26-system-code-review-fixes.md](./2026-09-26-system-code-review-fixes.md) | 系统 code review P0/P1 修复主记录:IDOR、arch-check 未登记表 fail-closed(补登 50 表)、authz 无池 fail-open、swboot argv 化+精确白名单、intentflow validated_only 双层硬拒、flag 一致性 fail-fast;配套 [审计](../audit/2026-09-26-system-code-review.md) · [经验](../ops/lessons/2026-09-26-failclosed-bypass-contract.md) |
|
||||
| [2026-09-25-dialogue-office-p0-verification.md](./2026-09-25-dialogue-office-p0-verification.md) | 对话办公 P0 验证记录:假成功消除单测 + arch-check;PI 补证待授权 |
|
||||
| [2026-09-25-dialogue-office-expansion-plan.md](./2026-09-25-dialogue-office-expansion-plan.md) | 对话办公能力扩展 P0–P3:消除主链假成功、intentflow dry-run live、查询真数据源、新写意图(trace/补充确认/批注/资产等);治理结构 UI 专属。配套 [调研](../audit/2026-09-25-dialogue-office-capability-research.md)。planned,不实施代码 |
|
||||
| [2026-09-23-coordination-db-daemon-implementation-undertaking-plan.md](./2026-09-23-coordination-db-daemon-implementation-undertaking-plan.md) | 协调库与 daemon **实施承接计划**(工作包预填):W1–W3 七包(U1r/U2/U3/U7/U4/U5/U6)含符号级锚点、真实并发验收、mutex、开工准入;L2 仅 ADR 前置门。配套 [设计方案](./2026-09-23-coordination-db-daemon-plan.md) · [任务](../ops/short-term/2026-09-23-coordination-db-daemon-impl-plan.md)。planned,不实施代码 |
|
||||
|
||||
Reference in New Issue
Block a user