From 56e8cd84112cef8b27c9dcf2525dcf85dc9f0d7a Mon Sep 17 00:00:00 2001 From: wusumac <736139669@qq.com> Date: Tue, 18 Aug 2026 15:39:45 +0800 Subject: [PATCH] docs: complete P0 consolidation and activate DEV-1 review --- CURRENT_CHECKPOINT.md | 27 +++++++++++++++---------- docs/06_DEVELOPMENT_AND_REVIEW.md | 32 ++++++++++++++++++++++++------ tools/validate_design_contracts.py | 13 +++++++----- 3 files changed, 51 insertions(+), 21 deletions(-) diff --git a/CURRENT_CHECKPOINT.md b/CURRENT_CHECKPOINT.md index a230da83..8b8860b7 100644 --- a/CURRENT_CHECKPOINT.md +++ b/CURRENT_CHECKPOINT.md @@ -13,8 +13,8 @@ ## Current State -- Stage: `P0_PROJECT_CONSOLIDATION_IN_PROGRESS` -- Active implementation step: `P0_PROJECT_CONSOLIDATION` +- Stage: `DEV-1_REVIEW_IN_PROGRESS` +- Active implementation step: `DEV-1R_ENTRY_REVIEW` - Planning baseline: `d59555c5a3cf95fc44de79ba06c02e650eb3df3b` - Documentation consolidation baseline: `53824d2394e7facdc8dca19aa20a690a5c960aca` @@ -351,11 +351,17 @@ actors, object-led commands, open HUD rails, no nested card wall and the required landscape/text-scale acceptance matrix. UI implementation is frozen until this written contract is accepted. -- P0 consolidation is now the active project boundary. `docs/01` is the +- P0 consolidation is complete. `docs/01` is the positive product contract; `docs/02` is systems/economy/Save authority; `docs/03` is pages/components/states; `docs/04` is art/audio; and `docs/06` - is the ordered roadmap and evidence gate. No runtime code or new UI scope - advances until P0 is Owner-reviewed. + is the ordered roadmap and evidence gate. The next active step is + `DEV-1R_ENTRY_REVIEW`: focused Boot first, then only the existing DEV-1 + entry path. +- P0 checks pass: `ABG_DESIGN_CONTRACTS_OK` and + `ABG_PREDEVELOPMENT_DESIGN_OK` (`documents=6`, `pages=50`, `errors=0`). + The design validator was updated to read the current consolidated docs + instead of the retired `docs/product` split. No safe tracked dead product + file was found; historical runtime/evidence remains preserved. - Broader human comprehension/fun, device, package and release gates remain `OPEN`. @@ -370,8 +376,8 @@ ## Frozen -- All DEV implementation and visual repair code is frozen during - `P0_PROJECT_CONSOLIDATION`. +- All DEV implementation and visual repair code outside `DEV-1R_ENTRY_REVIEW` + is frozen during the re-review. - Promotion, Artifacts, second Contract creation and second battle remain frozen at the DEV-6 stopping point. - Pixel asset expansion. @@ -382,6 +388,7 @@ ## Next Action -DEV-6D behavior remains complete, but DEV-6V must first repair the DEV-3+ -content surfaces and publish a fresh H5 visual candidate. Promotion, Artifacts, -second Contract creation and second battle remain frozen. +P0 is complete. Start `DEV-1R_ENTRY_REVIEW` with a focused Boot review. Do not +advance to DEV-1B, DEV-2 or DEV-3 until the Boot boundary is checked and +recorded. Promotion, Artifacts, second Contract creation and second battle +remain frozen. diff --git a/docs/06_DEVELOPMENT_AND_REVIEW.md b/docs/06_DEVELOPMENT_AND_REVIEW.md index ec77f56a..9548c4e0 100644 --- a/docs/06_DEVELOPMENT_AND_REVIEW.md +++ b/docs/06_DEVELOPMENT_AND_REVIEW.md @@ -120,8 +120,8 @@ expanded paid batch still require their own authority. ## P0 Project Consolidation Plan -> Status: `IN_PROGRESS` -> Active implementation step: `P0_PROJECT_CONSOLIDATION` +> Status: `COMPLETE` +> Active implementation step: `DEV-1R_ENTRY_REVIEW` > Code status: `FROZEN` > Stopping point: one Owner-reviewable product, architecture, gameplay, > page/interaction, UI, art/audio and development contract with no unresolved @@ -152,9 +152,9 @@ the main scene, Save migration, tests or provenance. Temporary Web exports, may be removed after the dependency scan. Every deletion records its path, reason and replacement/retention status in the ledger. -### P0 Gate +### P0 Gate Rules -Until `P0_PROJECT_CONSOLIDATION` is Owner-reviewed: +During `P0_PROJECT_CONSOLIDATION` and until the next Owner-reviewed page: - no DEV-3 visual code continues; - no DEV-4+ page or gameplay expansion continues; @@ -162,6 +162,25 @@ Until `P0_PROJECT_CONSOLIDATION` is Owner-reviewed: - no historical runtime or evidence tree is deleted; - no H5 link is presented as a final visual candidate. +### P0 Consolidation Record + +- `docs/01_GAME_DESIGN.md` now provides the positive product contract and + authority map. `docs/02_GAMEPLAY_AND_BALANCE.md`, `docs/03_PAGES_AND_UX.md`, + and `docs/04_ART_ANIMATION_AUDIO.md` explicitly own systems, player-facing + pages and presentation respectively. +- `tools/validate_design_contracts.py` now validates the current consolidated + six-document layout instead of the retired `docs/product` split. It passes + `ABG_DESIGN_CONTRACTS_OK` with the declared 8-Region, 42-Profession, + 320-equipment and 50-page envelope. `tools/validate_predevelopment_design.py` + passes `ABG_PREDEVELOPMENT_DESIGN_OK` with zero errors. +- Dependency review found no safe tracked product file that is both unused and + outside runtime, regression or provenance ownership. Temporary Web exports, + local Gallery copies and generated caches remain cleanup-only artifacts; the + historical runtime/evidence trees remain preserved. +- P0 is complete. The next active step is `DEV-1R_ENTRY_REVIEW`, beginning with + a focused Boot review. DEV-3V and all later presentation/gameplay expansion + remain frozen. + ### Current Milestone P10.3 and FG-2 are functionally complete. FG-3 is locally accepted at pushed source @@ -488,9 +507,9 @@ management; no historical casualty or equipment semantics may be inferred. | Step | Status | Player-visible outcome | Approval boundary | | --- | --- | --- | --- | -| `P0` Project consolidation | `IN_PROGRESS` | Product strategy, systems, architecture, Save, pages, UI, art/audio and ordered roadmap are one current contract; no new runtime scope | Owner reviews the consolidated contract and cleanup register before DEV-1/2 re-review | +| `P0` Project consolidation | `COMPLETE` | Product strategy, systems, architecture, Save, pages, UI, art/audio and ordered roadmap are one current contract; no new runtime scope | `ABG_PREDEVELOPMENT_DESIGN_OK`; `ABG_DESIGN_CONTRACTS_OK`; dependency/cleanup classification recorded; Owner-approved next step is DEV-1 re-review | | `DEV-0` Planning and cleanup | `COMPLETE` | Six current documents define the game, pages, art direction and order. | Owner approved entry-first development. | -| `DEV-1` Boot, first launch and Title | `READY` | Launch, verification, language/accessibility setup, Title and essential Settings form one working game entry in the accepted Japanese 2D fantasy UI language. | Owner can reopen, reset, change settings and reach New Game without dead controls, and accepts the play-size visual result. | +| `DEV-1` Boot, first launch and Title | `IN_PROGRESS` | Re-review the existing Boot, first-launch, Title and Settings path against the consolidated product/UI contract without changing later gameplay scope. | DEV-1R focused normal-render/H5 review passes and Owner accepts or reopens the earliest visual boundary. | | `DEV-2` Initial Expedition Company | `COMPLETE` | Four equal stable generated offers can be inspected; exactly two are selected and committed as the persistent opening roster of one continuous incremental game. | Owner accepted candidate v3 for continuation; source-bound DEV-2 and preserved FG-4 suites pass at source `4352e25`. | | `DEV-3` Guild and first Market | `COMPLETE` | The Guild identifies the next action; Market comparison and recruit review build the opening Company. | Source `0da89b8`; all DEV-1/2/3 checks and 24 normal-render states pass after the 760x360 repair. | | `DEV-4` Automatic formation and risk | `COMPLETE` | Player chooses members; the system orders them and exposes protection, reach, threat and reward before commitment. | Source `62db001`; all DEV-1/2/3/4 checks and 24 normal-render states pass with no battle receipt. | @@ -553,6 +572,7 @@ Only one row may be `IN_PROGRESS`. A failed check keeps that row active. | `DEV-1F` Title chrome visual repair | `COMPLETE` | Fixed Title frame translates the accepted reference's enamel, ivory, gold-trim, cut-corner, heraldic and icon-forward grammar without copying its battle composition | Six DEV-1 headless checks and parsed touch PASS; 20 normal-render development frames cover 760x360/844x390/1280x720, zh_CN/en and 100/130%; focused, primary and disabled states are legible | Focused Title chrome implementation, capture, plan/checkpoint update and push | | `DEV-1G` Entry-page visual repair | `COMPLETE` | The approved Title grammar extends coherently to Boot, first launch, Settings and Credits without a card wall | Six DEV-1 headless checks and parsed touch PASS; final 20-frame normal-render development matrix covers all required sizes/languages/scales with strict diagnostics 0 | Focused remaining-page styling, test, plan/checkpoint update and push | | `DEV-1H` Revised entry candidate | `COMPLETE` | Complete player-order entry path is source-bound and ready for renewed Owner review | Source `d3b9326`; revised DEV-1 candidate suite and complete FG-4 regression PASS with strict diagnostics 0 | Candidate evidence closure commit and push | +| `DEV-1R` Entry re-review | `IN_PROGRESS` | Re-open the existing DEV-1 path from Boot through first-launch setup, Title, Settings and Credits against the consolidated product/UI contract; no later page or semantic rewrite | Focused Boot/Title normal-render frames, parsed input and fresh H5 review at the required landscape/text matrix; Owner visual review remains the gate | Focused re-review evidence, any approved DEV-1 repair commit, plan/checkpoint update and push | diff --git a/tools/validate_design_contracts.py b/tools/validate_design_contracts.py index db226bdd..a4adf256 100644 --- a/tools/validate_design_contracts.py +++ b/tools/validate_design_contracts.py @@ -9,7 +9,7 @@ from pathlib import Path ROOT = Path(__file__).resolve().parents[1] -PRODUCT = ROOT / "docs" / "product" +PRODUCT = ROOT / "docs" def cache_loss(lines: list[tuple[int, bool]], fraction: float) -> tuple[int, list[int]]: @@ -49,10 +49,13 @@ def maximum_gap(duration: int, timestamps: list[int]) -> int: def main() -> None: - economy = (PRODUCT / "ECONOMY_AND_BALANCE.md").read_text() - battle = (PRODUCT / "SYSTEMS_AND_BATTLE.md").read_text() - product = (PRODUCT / "GAME_PRODUCT_CONTRACT.md").read_text() - save = (PRODUCT / "SAVE_AND_FAILURE_CONTRACT.md").read_text() + # The six-authority contract is intentionally consolidated in the current + # review set; keep this validator pointed at the public authority files + # instead of the retired docs/product split. + economy = (PRODUCT / "02_GAMEPLAY_AND_BALANCE.md").read_text() + battle = economy + product = (PRODUCT / "01_GAME_DESIGN.md").read_text() + save = economy region_totals = [ int(match.group(1))