docs(state): record the 0025 merge and main CI

docs/CLAUDE_CODE_HANDOFF.md

@@ -180,7 +180,7 @@ Status vocabulary: `DONE` (works, verified) · `PARTIAL` · `FRAMEWORK_ONLY` ·
 > `1a625a3be8a42008c8def2b31740551c6d12b3bf57bdb001400d6499162f58d0`) was
 > found outside the repository and deleted on 2026-10-21; no remaining copy was
 > found under the user home or `/tmp`. See `docs/ai/project-state.md`
-> `## Active Plan (0025)` and `build/0025/capture-retention-check.txt` (ignored).
+> `## Completed Plan (0025)` and `build/0025/capture-retention-check.txt` (ignored).
 
 ## 6. 已完成的重要工作（有证据的）
 

docs/PROJECT_DOCUMENTATION_INDEX.md

@@ -51,7 +51,7 @@ Status vocabulary used below:
 |---|---|---|---|---|---|
 | `docs/ai/README.md` | AI context router | Which document to read for which task; diff-first reading policy | Agents | `CURRENT` | — |
 | `docs/ai/agent-workflow.md` | Agent workflow and verification rules | Verification levels L1–L5, when a suite may run, harness prerequisites, one review per stage | Agents | `CURRENT` | `build/l4-0017/` (scratch harness) |
-| `docs/ai/project-state.md` | Current project state (1017 lines) | Stage-by-stage state, carried-forward items, what is genuinely open | Agents, maintainer | `CURRENT` (updated 2026-10-21) | whole repo |
+| `docs/ai/project-state.md` | Current project state (1031 lines) | Stage-by-stage state, carried-forward items, what is genuinely open | Agents, maintainer | `CURRENT` (updated 2026-10-21) | whole repo |
 | `docs/ai/CURRENT_STATE.md` | Handoff verification report (2026-10-19) | Git/CI facts, §23 fact checklist, document-code conflicts, capability-matrix update; 2026-10-20 resolution note | Agents, maintainer, release reviewer | `CURRENT` (dated 2026-10-19; point-in-time report plus dated resolution note) | whole repo |
 | `docs/ai/archive/next-phase-plan-2026-10.md` | Archived next-phase plan | An earlier plan sketch; kept for context | Agents | `REFERENCE` (archived) | — |
 | `docs/ai/references/github_resources.md` | GitHub resource research | 655-line survey used for the open-source plan | Maintainer | `REFERENCE` | — |
@@ -107,7 +107,7 @@ Status vocabulary used below:
 | `docs/exec-plans/completed/0021-docs-reconciliation.md` | Completed plan 0021 | `docs/03`–`docs/04` reconciliation of DB-1/2/3 and API-1/2/3/4; dated handoff corrections; docs-only L0; merged at `d75b14e` after VERDICT-0021-closeout PASS | Agents, maintainer | `COMPLETED` (2026-10-20) | `docs/03`, `docs/04`, `docs/CLAUDE_CODE_HANDOFF.md` |
 | `docs/exec-plans/completed/0022-web-ui.md` | Completed plan 0022 | Minimal native Web UI: nginx static + same-origin proxy, auth, jobs/filter/match, detail/apply links, resume prerequisite, favourite and status board; Python fallback + Firefox smoke; merged at `38bd484` | Agents, maintainer | `COMPLETED` (2026-10-20) | `web/`, `docker/nginx/`, `tools/dev/web-smoke.sh` |
 | `docs/exec-plans/completed/0023-release-readiness.md` | Completed plan 0023 | Release readiness: security/contributing docs, Python locks, MariaDB client image, TSan first run, libbcrypt provenance, benchmark refresh, release-checklist state; merged at `539202f` after the exclusive benchmark rework | Agents, maintainer, release reviewer | `COMPLETED` (2026-10-21) | `SECURITY.md`, `CONTRIBUTING.md`, `Dockerfile`, `backend/benchmarks/` |
-| `docs/exec-plans/active/0025-readme-and-usage.md` | Active plan 0025 | External-facing English README plus a separate Chinese mirror, two real UI screenshots, one-command demo launcher/seed, 12-job fixture, docs index/state; L0 + shell smoke, no L4 | Agents, maintainer, release reviewer | `ACTIVE` (implementation on `docs/readme-demo`; closeout pending) | `README.md`, `README.zh-CN.md`, `tools/dev/demo-up.sh`, `tools/dev/demo-seed.sh` |
+| `docs/exec-plans/completed/0025-readme-and-usage.md` | Completed plan 0025 | External-facing English README plus a separate Chinese mirror, two real UI screenshots, one-command demo launcher/seed, 12-job fixture, docs index/state; merged at `01ad46b` (PR #8) after VERDICT-0025-closeout PASS; main `ci`/`image` green | Agents, maintainer, release reviewer | `COMPLETED` (2026-10-21) | `README.md`, `README.zh-CN.md`, `tools/dev/demo-up.sh`, `tools/dev/demo-seed.sh` |
 | `docs/exec-plans/completed/0001…0017A` | 20 archived plans | The history of every stage, each with its evidence, decisions and L4 results. Notable: `0014` (China sources + manual capture, 1264 lines), `0015`/`0015A` (tailoring, explainable matching, quality gate), `0016` (packaging, demo gate), `0017` (ops hardening, L4), `0017A` (the `published_at` contract gap) | Agents needing the "why" | `HISTORICAL` by definition, but each is the **authority for its stage's decisions** | the module named in each plan |
 
 ## 7. Ingestion, sources and tools

docs/ai/project-state.md

@@ -58,11 +58,14 @@
 > The release-readiness work is merged; A history disclosure remains
 > accepted/no-rewrite. Wait for the owner’s 0024 instruction; do not start it.
 >
-> **2026-10-21 update — 0025 implementation in progress.** The plan-only PR #7
-> merged at `7acc58f`; the docs/tooling implementation is on branch
-> `docs/readme-demo` and is **not merged yet**. The README rewrite, screenshots,
-> one-command demo and the capture no-retention check are recorded in
-> `## Active Plan (0025)` below. 0024 remains owner-only and has not started.
+> **2026-10-21 update — 0025 merged.** Plan-only PR #7 merged at `7acc58f`;
+> implementation PR #8 merged at `01ad46b` (merge commit; final head `aff6a07`,
+> code head `97b124b`) after **VERDICT-0025-closeout PASS** (lightweight
+> closeout, notes accepted). Main CI: `ci` `39607961509` (4m01s; clean build
+> 2m26s + suite 1m27s) and `image` `39607961464` (2m19s; container gate 2m10s),
+> both **completed/success**. The README rewrite, screenshots, one-command demo
+> and capture no-retention check are recorded in `## Completed Plan (0025)`
+> below. **No plan is active**; 0024 remains owner-only and has not started.
 
 Repository files and Git history are the cross-agent fact source. This concise
 state plus the active or most recent ExecPlan should be enough for a new Agent to
@@ -237,12 +240,13 @@ libbcrypt upstream unresolved with SHA-256 manifest. PR image `39461251212`
 passed `Verify the MariaDB client linkage` (`MARIA_DB_LINK_OK`) + demo gate;
 main CI after merge is green (`ci` `39462589981`, `image` `39462589965`).
 
-## Active Plan (0025)
+## Completed Plan (0025)
 
-[`active/0025-readme-and-usage.md`](../exec-plans/active/0025-readme-and-usage.md)
-— plan-only PR #7 merged at `7acc58f`; implementation is in progress on branch
-`docs/readme-demo`, **not yet reviewed or merged**. Scope: external-facing
-English README + separate `README.zh-CN.md`, two UI screenshots, one-command
+[`completed/0025-readme-and-usage.md`](../exec-plans/completed/0025-readme-and-usage.md)
+— **merged at `01ad46b` via PR #8 (merge commit) after VERDICT-0025-closeout
+PASS (lightweight, notes accepted)**. Final head `aff6a07`; code head
+`97b124b`; plan-only PR #7 at `7acc58f`. Scope: external-facing English README
++ separate `README.zh-CN.md`, two UI screenshots, one-command
 `tools/dev/demo-up.sh`/`demo-seed.sh`, 12-job fixture, docs index/state. This is
 docs + developer tooling only: no core/API/schema/CI/P1 change; L0 + shell smoke,
 no L4.
@@ -284,10 +288,17 @@ Evidence collected on the branch (2026-10-21):
   payload. The old handoff statement that the real sample is still
   `resolution=open` now carries dated corrections in §5 row 9 and §7 item 8.
   Raw DB output: `build/0025/capture-retention-check.txt` (ignored).
-
-Remaining for this branch: closeout request, owner-created PR/merge, and the
-post-merge main CI verification. Do not archive the plan or mark this stage
-completed until the owner merges it.
+- **CI evidence**: PR #8 on head `aff6a07` — `ci` `39600944962`
+  completed/success (4m06s), `image` `39600944883` completed/success (2m11s).
+  Main after merge — `ci` `39607961509` completed/success in 4m01s
+  (`clean build` 2m26s, `full test suite (MySQL + Redis)` 1m27s); `image`
+  `39607961464` completed/success in 2m19s (`container image and the end-to-end
+  gate` 2m10s). Both main runs are on merge commit `01ad46b`.
+- **Verdict / accepted deviations**: `VERDICT-0025-closeout.md` PASS, with the
+  regenerated screenshots, environment-limited nginx path, skipped local image
+  build, no-L4 scope, and the capture-file deletion accepted as documented.
+  The plan is archived under `completed/`; **no plan is active**. 0024 remains
+  owner-only and has not started.
 
 ## Current Stage
 
@@ -354,6 +365,9 @@ completed until the owner merges it.
   acceptance in one command and prints the 0014 §19.5 evidence block; and
   `docs/RELEASE_CHECKLIST.md` plus `tools/checks/release_preflight.py` make the
   release gate checkable. Details: `## Completed Plan (0017)` below.
+- **0025 (README and external usage) is complete and archived** (`01ad46b`,
+  PR #8) after VERDICT-0025-closeout PASS; main `ci`/`image` are both green.
+  **No plan is active**; the next stage is owner-only 0024 publication.
 
 The revised architecture direction is:
 [../architecture/open-source-mvp.md](../architecture/open-source-mvp.md).
@@ -987,8 +1001,8 @@ Do not start a new P2 module without its own approved plan.
 ## Key Entry Points
 
 - AI routing: [README.md](README.md)
-- Most recent archived ExecPlan (0016):
-  [../exec-plans/completed/0016-open-source-packaging.md](../exec-plans/completed/0016-open-source-packaging.md)
+- Most recent archived ExecPlan (0025):
+  [../exec-plans/completed/0025-readme-and-usage.md](../exec-plans/completed/0025-readme-and-usage.md)
 - Full historical state:
   [references/project-state-full.md](references/project-state-full.md)
 - Current architecture:

docs/exec-plans/active/0025-readme-and-usage.md → docs/exec-plans/completed/0025-readme-and-usage.md

@@ -1,8 +1,10 @@
 # ExecPlan 0025 — README and external usage guide
 
-> 状态：**IMPLEMENTATION（closeout pending；计划已由 PR #7 合入）**
-> 分支：`docs/readme-demo`（实施）；计划原始分支 `docs/0025-readme-and-usage`
+> 状态：**COMPLETED（2026-10-21 合并；VERDICT-0025-closeout PASS，附说明）**
+> 分支：`docs/readme-demo`（计划原始分支 `docs/0025-readme-and-usage`）
+> 合并：`01ad46b`（PR #8 merge commit）；最终 head `aff6a07`；code head `97b124b`
 > 基线：`main@7acc58f`（计划 PR #7；0023 merge `539202f`）
+> 合并后 main CI：`ci` `39607961509`（4m01s）与 `image` `39607961464`（2m19s）双绿。
 > 类型：**docs + developer demo tooling**（不碰 core/API/schema/CI）；L0 + shell smoke，不跑 L4；不启动 0024。
 
 ## 1. 背景
@@ -59,7 +61,7 @@ contract 表和内部运维细节。外部读者无法快速回答“这是什
 | `docs/examples/demo-jobs.json` | 12 条合成示例岗位；含 C++ 后端、Linux/MySQL、不同城市；`example.invalid` URL；部分带显式 apply_url |
 | `docs/PROJECT_DOCUMENTATION_INDEX.md` | README 描述、README.zh-CN、images 行；0025 active/closeout 行 |
 | `docs/ai/project-state.md` | 0025 active/completed；docs-only L0 证据；语言/截图说明 |
-| `docs/exec-plans/active/0025-readme-and-usage.md` | 本计划 |
+| `docs/exec-plans/completed/0025-readme-and-usage.md` | 本计划（合并后归档） |
 
 不改 `.gitignore`（当前未忽略 `*.png`；若实施时发现被忽略，再加
 `!docs/images/*.png` 并说明）。使用 `git check-ignore` 验证。
@@ -256,7 +258,7 @@ P1 demo scripts + seed fixture [x] demo-up.sh / demo-seed.sh / 12-job fixture
 P2 screenshots + README + one-command Quick Start [x] screenshots regenerated; README rewritten
 P3 README.zh-CN         [x] 独立中文镜像
 P4 index/state          [x] docs index + project-state + handoff corrections
-P5 L0 + shell smoke + closeout [x] smoke 完成；REQUEST-0025-closeout 已写；owner PR/merge 待办
+P5 L0 + shell smoke + closeout [x] smoke 完成；VERDICT PASS；PR #8 merged at 01ad46b
 ```
 
 Execution note (2026-10-21): the planned `/tmp/0022-browser-final/*.png`
@@ -270,4 +272,23 @@ down with `down -v`. The capture no-retention check found 0 review items and
 only DAO test fixtures; the raw real-capture file
 `$HOME/capture-acceptance.json` was also deleted, with no copy found under the
 user home or `/tmp`. See `docs/ai/project-state.md` and the handoff
-corrections. Closeout request is written; owner PR/merge remains.
+corrections.
+
+## 11. Post-merge closeout (2026-10-21)
+
+- PR #8 merged at `01ad46b` (Create a merge commit); final head `aff6a07`;
+  code head `97b124b`.
+- `VERDICT-0025-closeout.md`: **PASS** (lightweight closeout, notes accepted).
+  Accepted deviations: screenshots regenerated; nginx container path
+  environment-limited (Python fallback tested); backend image build skipped in
+  the local smoke; no L4 by plan; capture sample had no DB row and the raw file
+  was deleted with a hash record.
+- PR #8 CI on head `aff6a07`: `ci` `39600944962` completed/success (4m06s);
+  `image` `39600944883` completed/success (2m11s).
+- Main CI after merge:
+  - `ci` `39607961509` — completed/success, 4m01s; `clean build` 2m26s,
+    `full test suite (MySQL + Redis)` 1m27s.
+  - `image` `39607961464` — completed/success, 2m19s; `container image and the
+    end-to-end gate` 2m10s.
+- Plan archived under `completed/`; **no plan is active**. 0024 (owner
+  publication) remains owner-only and has not started.