diff --git a/docs/CLAUDE_CODE_HANDOFF.md b/docs/CLAUDE_CODE_HANDOFF.md index 46b99f6..0055e90 100644 --- a/docs/CLAUDE_CODE_HANDOFF.md +++ b/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. 已完成的重要工作（有证据的） diff --git a/docs/PROJECT_DOCUMENTATION_INDEX.md b/docs/PROJECT_DOCUMENTATION_INDEX.md index d59e40f..f60f578 100644 --- a/docs/PROJECT_DOCUMENTATION_INDEX.md +++ b/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 diff --git a/docs/ai/project-state.md b/docs/ai/project-state.md index 97c3a83..74fff78 100644 --- a/docs/ai/project-state.md +++ b/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: diff --git a/docs/exec-plans/active/0025-readme-and-usage.md b/docs/exec-plans/completed/0025-readme-and-usage.md similarity index 90% rename from docs/exec-plans/active/0025-readme-and-usage.md rename to docs/exec-plans/completed/0025-readme-and-usage.md index c3e3e71..6b81ed6 100644 --- a/docs/exec-plans/active/0025-readme-and-usage.md +++ b/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.