# PROGRESS · 增长冻结改盯耦合（2026-09-16）

工作树：`.worktrees/freeze-metric-change-20260915`  
分支：`codex/freeze-metric-change-20260915`  
任务书基线写 `6b3248bf`；开工时 `origin/staging` = **`51a65d92`**（含 BUG-732）。  
本机 Windows。无 Docker。本单不占 BUG 号，不改 `CHANGELOG.md` / `BUG_HISTORY.md` / `docs/tasks/README.md`。  
`page.tsx` 与 `scripts/jyotish_api_server.py` **一行未动**（反向验证后已 `git checkout` 还原）。

## 开工实测基线（2026-09-16，`51a65d92`）

禁止抄任务书 1951 / 66 / 41 / 11334 / 225。下列数字全部本机现测。

| 组 | 指标 | 数法 | 实测 | 新门 |
| --- | --- | --- | ---: | --- |
| 1 | `frontend/src/app/page.tsx` 行数 | `Path.read_bytes().count(b"\n")`，与 `(source.match(/\n/g) ?? []).length` 相同 | **1951** | 粗护栏 ≤ 1951 + 150 = 2101 |
| 2a | `Home()` `useState` | `\buseState[<(]`（含 `useState<Type>(`） | **66** | 主门，不得增长 |
| 2b | `Home()` `useRef` | `\buseRef[<(]` | **41** | 主门，不得增长 |
| 3 | `scripts/jyotish_api_server.py` 行数 | `Path.read_bytes().count(b"\n")` | **11291** | 粗护栏 ≤ 11291 + 300 = 11591 |
| 4a | 四空格 `def`（任务书同一种数法） | `^    (?:async )?def \w+` 扫全文件 | **225** | 主门，不得增长 |
| 4b | `JyotishAPIHandler.__new__` | `scripts/` + `tests/` 的 `*.py`，排除合同测试自身 | **33** | 主门，不得增长 |

说明：

- 任务书表格写 api 行数 11,334；本机 `51a65d92` 实测 **11291**（未抄）。
- 任务书表格写 `__new__` = 4：那是 **scripts/ 生产伪造点**（`consultation_workflow_service.py` ×2、`capture_report_blocked_repairs_golden.py` ×1、`local_accuracy_report.py` ×1）。任务书要求扫 `scripts/` 与 `tests/`，实测合计 **33**（scripts 4 + tests 29）。主门按扫描范围合计冻结，只许降不许升。失败信息会列出命中文件。
- 全文件四空格 `def` = 225，其中 `JyotishAPIHandler` 类体 222、类前嵌套 3。冻结用任务书指定的全文件数法。
- 只按 `useState(` 会计到 26，漏掉泛型调用；合同用 `\buseState[<(]`。

`frontend/AGENTS.md` 只有 Next.js 版本提示，没有 §6 重复表述，本单未改。

## 做了什么

1. `tests/test_api_server_growth_contract.py`：主门改成类方法数 + `__new__` 计数；行数 rebaseline 为 11291 + 300。`must not grow` / `thinly registered` / `CORE_PYTEST_TARGETS` 三条原样仍绿。
2. 新建 `frontend/tests/home-shell-growth-contract.test.ts`：`Home()` `useState` / `useRef` 不得增长，行数粗护栏 1951 + 150。
3. `frontend/tests/chart-view-route.test.ts`：删除行数断言，保留 `doesNotMatch(pageSource, /chart-page|ChartPageView|\/api\/chart-view/)`，注明搬到 home-shell 合同。
4. `AGENTS.md` §6：主门改耦合指标；删掉「参数式 hook 内部保持 0 个 React hook」；第三条三个「不得再手写第二套」原样保留；仍含 `must not grow` 与 `thinly registered`。

## 既有断言改动

| 文件 | 原值 | 新值 | 原因 |
| --- | --- | --- | --- |
| `chart-view-route.test.ts` `page.tsx does not grow to host the chart page` | `(pageSource.match(/\n/g) ?? []).length <= 1951` 且 `doesNotMatch(...)` | 测试改名为 `page.tsx does not host the chart page`，只留 `doesNotMatch` | 行数冻结与星盘页无关，搬到专用合同 |
| `test_api_server_growth_contract.py` 行数 baseline | 11063（2026-09-02）+ 300 | **11291**（2026-09-16 实测）+ 300 | 任务书要求开工实测 rebaseline，不得抄旧数 |

## 反向验证

### 1. `page.tsx` 人为加一个 `useState`

在 `Home()` 里插入 `const [_growthContractProbe, _setGrowthContractProbe] = useState(false);`，然后：

```
npx tsx --test tests/home-shell-growth-contract.test.ts
not ok 1 - Home() useState count must not grow
error: 'Home() has 67 useState calls; cap is 66. ...'
# tests 3 / pass 2 / fail 1
```

`useRef` 与行数粗护栏仍绿。随后 `git checkout -- frontend/src/app/page.tsx`，文件回到 `51a65d92`。

### 2. `jyotish_api_server.py` 人为加一个类方法

在 `JyotishAPIHandler` 里插入 `def _growth_contract_probe(self): return None`，然后：

```
pytest tests/test_api_server_growth_contract.py
FAILED test_jyotish_api_handler_method_count_must_not_grow
AssertionError: ... has 226 four-space def methods; cap is 225.
1 failed, 4 passed
```

行数粗护栏、`__new__`、AGENTS 措辞、`CORE_PYTEST_TARGETS` 仍绿——尺子动的是耦合门。随后 `git checkout -- scripts/jyotish_api_server.py`。

## 测试

本 worktree 的 `.venv` 是已跟踪的指针文件（内容 `/workspace/Jyotisha/.venv`），Windows 上不能当目录用，未覆盖。合同测试用本机 `C:\Users\74082\anaconda3\python.exe`（pytest 9.1.1）。

| 命令 | 结果 |
| --- | --- |
| `python -m pytest tests/test_api_server_growth_contract.py -v` | **5 passed**（含原 `must not grow` / `thinly registered` / `CORE_PYTEST_TARGETS` 三条） |
| `npx tsx --test tests/home-shell-growth-contract.test.ts tests/chart-view-route.test.ts` | **16 pass / 0 fail**（home-shell 3 + chart-view 13；chart-view 无行数断言） |
| `./node_modules/.bin/tsc --noEmit` | 0 错 |
| `npm run lint` | **0 error** / 119 warning（既有，未动） |
| `npx tsx --test tests/*.test.ts` | 3196 tests / 3112 pass / **69 fail** / 15 skip。本单 3 条 + `page.tsx does not host the chart page` 均 `ok`。失败为无 Docker、Windows `SKILL.md` symlink `EPERM`、bash 部署脚本，与近期同机清单同类 |
| `run_quality_gate.py --profile quick --skip-frontend-runtime` | **blocked**：`interpretation_source_inventory_gate.py` → `ModuleNotFoundError: No module named 'mcp'`。停在 pytest 之前，不是本单合同红。未写成通过 |

同 SHA 近期进度 `PROGRESS-consultation-session-capacity-20260915.md` 记 `tests/*.test.ts` 为 3089 / 3001 / **73** fail。本机这次 3196 / 3112 / **69** fail（PowerShell glob 与计数差一截，fail 未增加）。本单新增 3 条全绿，不把 69 写成通过。

未跑 `next build`：无 UI 改动；质量门在 Python 预检就停了。

## 未做（属范围外）

- 真的搬 `Home()` 状态或拆 `JyotishAPIHandler`（后续两单）
- `__new__` 收到 0
- 推 `origin HEAD:staging`