Skip to content

Commit 777dbeb

Browse files
CyningMMcursoragent
CyningMM
and
cursoragent
committed
docs(task): ChatBI 基线合并闸 Harness 关账 · KPI 100%
50 已落盘 · PR #106 @ 26e1c45 已合 main；Fresh Context 复验全绿； git mv done/ · _views 索引 · CLOSE invoke 快照。 Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 0463afe commit 777dbeb

3 files changed

Lines changed: 112 additions & 15 deletions

File tree

‎docs/harness/invokes/by-task/chatbi_baseline_merge_gate_v1/invoke_20260606_CLOSE_chatbi-baseline-merge-gate-v1.md‎

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
# Invoke 快照 · CLOSE · chatbi_baseline_merge_gate_v1
2+
3+
| 字段 | 值 |
4+
| --- | --- |
5+
| **hat_id** | CLOSE |
6+
| **task_slug** | `chatbi_baseline_merge_gate_v1` |
7+
| **task_path** | `docs/tasks/done/task_chatbi_baseline_merge_gate_v1.md` |
8+
| **git_branch** | `task/close-chatbi-baseline-merge-gate-v1` |
9+
| **freeze_id** | （无新 L1 SPEC；v3 单测 + `_contract_manifest.json`） |
10+
| **merge_ref** | PR [#106](https://github.com/Cyning12/ai-ink-brain-api-python/pull/106) @ `26e1c45` |
11+
| **date** | `20260606` |
12+
13+
---
14+
15+
## 执行路线与 Commit 回溯
16+
17+
**一句结论**：50 复检 pass-with-notes → PR #106 已合 main 且 Required checks 全绿 → Fresh Context 复验 main 全绿 → Harness 关账（无下一棒）。
18+
19+
| 序号 | 阶段 / 帽子 | 关键动作 | 落盘工件 | commit |
20+
| ---: | --- | --- | --- | --- |
21+
| 1 | 10 需求 | task 草案 | `docs/tasks/active/task_chatbi_baseline_merge_gate_v1.md` | `a0830bb` |
22+
| 2 | 22 R1 | 文档审查零阻塞 | `docs/harness/reviews/task_chatbi_baseline_merge_gate_v1_audit_R1_20260604.md` | `c51369e` |
23+
| 3 | 人签 | HG-TASK-DRAFT + HG-AUDIT-R1 | task `human_gate` 表 | `bbd6ded` |
24+
| 4 | 30 执行 | conftest · agent · contract | `tests/conftest.py` · `api/agent.py` · manifest | `eed212e` |
25+
| 5 | 40 自检 | 验收表回填 | task `### 自检结论` | `d289fe9` |
26+
| 6 | 50 复检 | pass-with-notes | `docs/tasks/reinspect_results/reinspect_chatbi_baseline_merge_gate_v1_20260604_v1.md` | （50 轮） |
27+
| 7 | PR 合入 | main 基线闸 | PR #106 | `26e1c45` |
28+
| 8 | CLOSE | KPI · 经验摘要 · git mv done | task `done/` · `_views/done.md` · 本 invoke | （本 CLOSE commit） |
29+
30+
### api-python（ai-ink-brain-api-python）
31+
32+
```text
33+
- （CLOSE）docs(task): ChatBI 基线合并闸 Harness 关账 · KPI 100%
34+
- 26e1c45 fix(chatbi): 基线合并闸 — v3 clarify 测试环境 + contract label (#106)
35+
- d289fe9 docs(harness): 40 自检 chatbi 基线合并闸 · 验收全 pass
36+
- eed212e fix(chatbi): 基线合并闸 — contract label + v3 clarify 测试环境真值
37+
- bbd6ded docs(task): human_gate 人签 HG-TASK-DRAFT + HG-AUDIT-R1 approved
38+
- c51369e docs(harness): 22 R1 任务审核落盘 chatbi_baseline_merge_gate_v1
39+
- a0830bb docs(harness): 10 帽 chatbi 基线合并闸 task 与 invoke 落盘
40+
```
41+
42+
---
43+
44+
## Fresh Context 复验（关账 · main @ `26e1c45`）
45+
46+
| 命令 | exit | 要点 |
47+
| --- | ---: | --- |
48+
| `pytest tests/test_unified_chat_backend_v2_agent.py -k "v3 and (plan or low_confidence)" -q` | 0 | 10 passed |
49+
| `pytest tests -m "not intent_eval and not intent_benchmark" -q` | 0 | 323 passed · 1 skipped |
50+
| `python tools/tech_graph_contract_check.py` | 0 | OK |
51+
| `python tools/harness_task_validate.py docs/tasks/active/task_chatbi_baseline_merge_gate_v1.md` | 0 | OK（关账前 active 路径） |
52+
53+
---
54+
55+
## §3 调用体（快照）
56+
57+
```text
58+
Harness 关账（无下一棒）：50 已落盘 · PR #106 已合 main · Fresh Context 复验全绿。
59+
任务：git mv task → done/ · 填 KPI（00）· experience_capture 经验摘要 · _views/done.md 索引。
60+
禁止再改 api/ 业务代码；禁止夹带 P0 Graph 范围。
61+
按 HANDOFF_AUTO_COMMIT 仅 add 本轮路径并 commit。
62+
对话末尾：执行路线与 Commit 回溯 + Harness 状态栏（版本 B）· 下一棒：— · 关账完成。
63+
```

‎docs/tasks/_views/done.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
55
## 已完成
66

7+
- `../done/task_chatbi_baseline_merge_gate_v1.md`（2026-06-06：ChatBI 基线合并闸 · v3 clarify 测试环境 + contract label · PR #106 @ `26e1c45` · KPI 100% pass · 50 `reinspect_chatbi_baseline_merge_gate_v1_20260604_v1.md` · **unblocks** P0 Graph）
78
- `../done/task_chatbi_graph_p0_foundation_v1.md`（2026-06-04：LangChain 路线图 P0 · 共享层抽取 + State/边表 + Graph stub 路由 · PR #106+#107 · 50 `reinspect_chatbi_graph_p0_foundation_v1_20260603_v1.md` · `main@f53327a` · **blocks** P1 Task-B）
89
- `../done/task_chatbi_intent_hints_step1_v1.md`（2026-06-04：Intent Hints Step1 C-lite · yaml+loader+Prompt 注入 · KPI 94% pass-with-notes · `CHATBI-INTENT-HINTS@2026-06-09` · reinspect `reinspect_chatbi_intent_hints_step1_v1_20260604_v1.md` · 分支 `task/chatbi-intent-hints-step1-v1` · 实现 `bb59beb` · **待人 HG-REINSPECT + PR CI + RUNBOOK 集成**）
910
- `../done/task_harness_invokes_by_task_prompts_sync_v1.md`（2026-06-02：prompts/HANDOFF + 05 rule 对齐 by-task invoke 落盘 · 配对 Ink PR #48 · `HARNESS-INVOKES-BY-TASK-PROMPTS@2026-06-02`）

docs/tasks/active/task_chatbi_baseline_merge_gate_v1.md renamed to docs/tasks/done/task_chatbi_baseline_merge_gate_v1.md

Lines changed: 48 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
11
# Task：ChatBI 基线合并闸 — origin/main 既有 pytest + contract 红项修复
22

3-
> **状态**：`active`（40 自检完成 · 待 **50** 独立复检）
3+
> **状态**：`done`（2026-06-06 · PR [#106](https://github.com/Cyning12/ai-ink-brain-api-python/pull/106) @ `26e1c45` · Task_KPI% 100 pass）
44
> **维护者决策**：50 复检 `[reinspect_chatbi_graph_p0_foundation_v1_20260603_v1.md](../reinspect_results/reinspect_chatbi_graph_p0_foundation_v1_20260603_v1.md)` **选 B** — 先修 main 基线债，再合 P0 Graph PR
55
> **关联图谱**：`docs/_tech_graph/_contract_manifest.json`（Unified SSE 跨端契约）；`api/unified_chat.py` / `api/agent.py`（v3 plan/clarify 路径）
6-
> **schedule_ref**：P0 Graph 合入前置 · 见 `[RECENT_TASK_SCHEDULE.md](../RECENT_TASK_SCHEDULE.md)`（待维护者补锚）
6+
> **50 复检**：[`reinspect_chatbi_baseline_merge_gate_v1_20260604_v1.md`](../reinspect_results/reinspect_chatbi_baseline_merge_gate_v1_20260604_v1.md)
7+
> **22 R1**：[`task_chatbi_baseline_merge_gate_v1_audit_R1_20260604.md`](../harness/reviews/task_chatbi_baseline_merge_gate_v1_audit_R1_20260604.md)
8+
> **关闭回溯**：[`invoke_20260606_CLOSE_chatbi-baseline-merge-gate-v1.md`](../harness/invokes/by-task/chatbi_baseline_merge_gate_v1/invoke_20260606_CLOSE_chatbi-baseline-merge-gate-v1.md)
79
810
---
911

@@ -148,14 +150,14 @@ python tools/tech_graph_contract_check.py
148150

149151
## 验收标准
150152

151-
- 上述 **10** 个 v3 plan/clarify 用例 **全部 pass**（`tests/test_unified_chat_backend_v2_agent.py`）
152-
- `pytest tests -m "not intent_eval and not intent_benchmark"` **全绿**（本地 · AGENTS §8 等价）
153-
- `python tools/tech_graph_contract_check.py` **exit 0**（`label` 漂移已修复）
154-
- `python tools/tech_graph_manifest_check.py` **仍绿**（若本 PR 未改 manifest 则对照基线仍 OK）
155-
- PR 上 `**.github/workflows/pytest.yml`**（workflow 名 `**pytest**`）**Required check 全绿**
156-
- **未** 夹带 P0 Graph 交付物（`api/graph/`* · Q-8 路由 · `test_chatbi_graph_p0_foundation.py` · P0 manifest 增量）
157-
- 若触达 `_contract_manifest.json` / `.ai.md`：`## 行为变更（Delta）` 与实现 **一致**
158-
- `python tools/harness_task_validate.py docs/tasks/active/task_chatbi_baseline_merge_gate_v1.md` **OK**
153+
- [x] 上述 **10** 个 v3 plan/clarify 用例 **全部 pass**（`tests/test_unified_chat_backend_v2_agent.py`）
154+
- [x] `pytest tests -m "not intent_eval and not intent_benchmark"` **全绿**（本地 · AGENTS §8 等价）
155+
- [x] `python tools/tech_graph_contract_check.py` **exit 0**（`label` 漂移已修复）
156+
- [x] `python tools/tech_graph_manifest_check.py` **仍绿**（若本 PR 未改 manifest 则对照基线仍 OK）
157+
- [x] PR 上 `**.github/workflows/pytest.yml`**（workflow 名 `**pytest**`）**Required check 全绿**（PR #106 · 2026-06-04 merge · `gh` 核对 SUCCESS）
158+
- [x] **未** 夹带 P0 Graph 交付物（`api/graph/`* · Q-8 路由 · `test_chatbi_graph_p0_foundation.py` · P0 manifest 增量）
159+
- [x] 若触达 `_contract_manifest.json` / `.ai.md`：`## 行为变更（Delta）` 与实现 **一致**
160+
- [x] `python tools/harness_task_validate.py docs/tasks/active/task_chatbi_baseline_merge_gate_v1.md` **OK**
159161

160162
**合并前必绿（本仓）**：`pytest tests -m "not intent_eval and not intent_benchmark"` + `python tools/tech_graph_contract_check.py`（见 `AGENTS.md` §8 与 `tech-graph-contract.yml`）。
161163

@@ -178,6 +180,8 @@ python tools/tech_graph_contract_check.py
178180

179181
| 日期 | 摘要 |
180182
| ---------- | ----------------------------------------------------------------------------------------------- |
183+
| 2026-06-06 | **Harness 关账**：`git mv` → `done/` · KPI 100% · Fresh Context 复验 main 全绿 · 合入 PR #106 @ `26e1c45` |
184+
| 2026-06-04 | 50 独立复检 pass-with-notes · reinspect `reinspect_chatbi_baseline_merge_gate_v1_20260604_v1.md` |
181185
| 2026-06-04 | 40 自检：独立复跑 pytest/contract/manifest · 验收表全 pass · 待 50 |
182186
| 2026-06-04 | 30 执行：conftest 固定 `INTENT_MIN_CONFIDENCE=0.6` · contract 声明 `label` · `agent.py` clarify_gate 补 `on` |
183187

@@ -243,16 +247,45 @@ python tools/tech_graph_contract_check.py
243247

244248
**40 结论**：自检 **通过** — 本地必绿命令全绿；建议进入 **50 独立复检** 后开 PR → main。
245249

250+
#### 关账补记（2026-06-06 · main @ `26e1c45`）
251+
252+
| 项 | 结果 |
253+
| --- | --- |
254+
| 合入 | PR **#106** `26e1c45` · 2026-06-04 merged |
255+
| PR CI | `pytest` · `contract_check` · `manifest_check` · `verify` — **SUCCESS**（`gh pr view 106`） |
256+
| Fresh Context 复验 | 10× v3 **10 passed** · 全集 **323 passed** · contract/manifest/validate **OK** |
257+
| P0 unblock | `chatbi_graph_p0_foundation_v1` 已 rebase 合 main（PR #107） |
258+
259+
---
260+
261+
### 经验摘要（experience_capture · required）
262+
263+
> 跨 task 可复用：本地 `.env` 与 CI/conftest 测试环境真值不一致导致「main 已红」假象。
264+
265+
1. **现象**：`origin/main` 上 10× v3 plan/clarify 测本地红、CI 可能绿 — 开发者 `.env` 设 `INTENT_MIN_CONFIDENCE=0.3`，低于 stub 意图 `confidence=0.35`，clarify 路径不触发。
266+
2. **CI 真值**：无 `.env` 时 `rag_env` 默认 **0.6** → stub 0.35 < 0.6 → clarify 正常触发 → CI 可过。
267+
3. **修复**：`tests/conftest.py` 在 dotenv 加载**前** `os.environ.setdefault("INTENT_MIN_CONFIDENCE", "0.6")`，使本地 pytest 与 CI 语义一致。
268+
4. **排障口诀**：v3 clarify/plan 测本地红先查 `INTENT_MIN_CONFIDENCE` vs stub confidence，再查 emit 逻辑。
269+
5. **附带**：`CHATBI_V3_LOW_CONFIDENCE_CLARIFY` 合法值补 `"on"`；contract `label` 列入 `frontend_ts_ignore_payload_like_keys`（Runbook 路径 A）。
270+
246271
---
247272

248273
## KPI（00）
249274

250-
> 关账前由 CLOSE / 00 汇总；开工时留空。
275+
**rubric**: KPI_RUBRIC_v1_2 · **汇总**: 100% · **状态**: pass · **帽**: 22→30→40→50→CLOSE · **aggregator**: CLOSE
251276

277+
| hat_code | round | agent_mode | D1 | D2 | D3 | D4 | D5 | judgment_notes |
278+
|----------|-------|------------|----|----|----|----|-----|----------------|
279+
| 22 | R1 | main_chat | 100 | 100 | 100 | 100 | — | 文档层零阻塞 · 10 测名与 main 一致 |
280+
| 30 | R1 | main_chat | 100 | 100 | 100 | 100 | — | conftest/agent/contract · 无 P0 夹带 |
281+
| 40 | R1 | main_chat | 100 | 100 | 100 | 100 | — | 本地必绿全 pass |
282+
| 50 | v1 | main_chat | 100 | 100 | 100 | 100 | 100 | pass-with-notes；关账复验 PR #106 CI SUCCESS · main Fresh Context 全绿 |
283+
284+
| 指标 | 值 |
285+
| --- | --- |
286+
| Task_KPI% | **100%** |
287+
| blocked | **无** |
252288

253-
| 指标 | 值 |
254-
| --------- | ----- |
255-
| Task_KPI% | （关账填） |
256-
| blocked | （关账填） |
289+
**D2 聚合**：min(100,100,100,100)=100 · **D5 聚合**：100 · **状态**：pass（≥80，无 blocked）
257290

258291

0 commit comments

Comments
 (0)