docs(coding): record ML-07 R4 remediation

This commit is contained in:
2026-08-27 22:09:58 +08:00
parent 7fab721907
commit 78fb7d7307
2 changed files with 29 additions and 60 deletions

View File

@@ -436,6 +436,35 @@
1/1 (202 files / 1,693 passed / 2 skipped total). Coordinator typecheck passed;
full lint reported 0 errors and the unchanged 5 warnings in Home and Makelore.
## ML-07 R4 Review And Remediation
- The fourth fixed-range review over exact
`eb5d15d68470b30ec181164f08f0d7b027ef0006...07ea9da858b4a412191747a6c80f465cf2d46d45`
returned Spec PASS and Standards FAIL on one supported remaining load-ordering
case. With A1 pending, then B pending, selecting A again reused A1 before
renewing its generation, so B retained the only committable generation and
could leave the active A page displaying B's projection.
- The same sole remediation implementer returned source commit
`d0addfa743d97d4ac9c3385a1d364f94b1ccf6d5` with exact parent
`07ea9da858b4a412191747a6c80f465cf2d46d45`; it integrated without conflict as
coordinator commit `7fab721`. The foreign source task record is removed here
and remains in its isolated source worktree.
- Each keyed load flight now owns a mutable generation token. Reselecting that
same key/epoch after another project intent intervenes promotes the shared
flight to a new global generation before returning it; consecutive same-project
duplicate loads still share one request and one promise. B therefore loses
commit eligibility, while A completes without a manual retry and the stable
public pending key remains unchanged.
- Source red evidence was 2 new failures with 13 existing passes; after the fix,
store tests passed 15/15 and the expanded four-file suite passed 24/24.
Typecheck, scoped ESLint, full lint with 0 errors and the unchanged 5 warnings,
diff, project-documentation drift, and task completion gates passed. No UI,
Main, Preload, package, or asset ownership was used.
- After integration, coordinator `corepack pnpm test` passed 201 normal files /
1,694 tests with 2 staged-runtime skips, followed by the isolated pressure file
1/1 (202 files / 1,695 passed / 2 skipped total). Coordinator typecheck passed;
full lint reported 0 errors and the unchanged 5 warnings in Home and Makelore.
- ML-07 must review the fixed committed range from exact
`eb5d15d68470b30ec181164f08f0d7b027ef0006` through the final ML-06 docs
checkpoint along independent Standards and Spec axes. Accepted findings route

View File

@@ -1,60 +0,0 @@
# Task: Remediate accepted MakeLore ML-07 R4 finding
## Identity
- Task ID: 20260827-plugin-ml07-remediation-r4-8a5b3e02
- Mode: Feature
- Branch: codex/20260827-plugin-ml07-remediation-r4-8a5b3e02-plugin-ml07-remediation-r4
- Worktree: D:\Datas\OthersProjects\makelore-plugin-ml07-remediation-r4-8a5b3e02
- Base commit: 07ea9da858b4a412191747a6c80f465cf2d46d45
- Owner: ml07-remediator
- Status: Ready for integration
## Scope
- Fix the existing Plugin Center store load-flight generation handling for the exact pending A1 → pending B → A2 sequence.
- Add focused regression coverage for both A/B completion orders while retaining consecutive duplicate-A coalescing, stable public pending keys, ordinary A-to-B latest selection, and all R3 mutation-epoch/reload behavior.
- Change only `src/stores/coding-plugins.ts`, `tests/unit/coding-plugins-store.test.ts`, and this task record.
## Intent And Constraints
- A2 is a renewed latest intent for project A even when it shares A1's in-flight request; that shared flight must be promoted to the newest load generation so B cannot commit and A can commit without retry.
- Do not merely add a latest-project check to B, because the old-generation A flight would still be unable to commit. Do not blindly increment generation before returning a coalesced flight without promoting that flight, because consecutive duplicate loads would lose commit eligibility.
- Preserve epoch-specific load invalidation, authoritative mutation reloads, stable `load:<projectId>` pending keys, and project-scoped mutation guards from R3. Add no UI behavior or new abstraction layer.
- Work only in the isolated exact-base task worktree; do not touch the user root/coordinator, revert peers, push, or open a PR.
## Project Context Loaded
- Concurrent Task Gate and Planning Gate passed for the exact task ID, feature mode, branch, worktree, base `07ea9da858b4a412191747a6c80f465cf2d46d45`, and owner `ml07-remediator`.
- Read the project memory startup set, architecture/data-flow/domain/success criteria, ADR-006, evidence/reflection/commitment/stale indexes, coordinator scope, R4 reviewer scopes, implementation spec §§8 and 10.3, and ML-07 fixed review/remediation ticket.
- Coordinator owns integration; R4 standards/spec tasks are read-only. No active peer has a competing semantic decision or ownership overlap with the two product/test files.
- Plugin Center mutations must remain pending/deduplicated, project state stays Renderer-local/project-scoped, and this correction does not change Main/Pi/plugin policy authority.
## Plan
1. Add a red table test for A1 pending → B pending → A2, resolving B/A in both orders; assert A1/A2 share one request/promise, B never wins, final A contains A's response, and public pending keys contain no internal generation.
2. Attach mutable generation ownership to each in-flight load. A repeated intent promotes the shared flight to a newly allocated latest generation before returning it; its completion remains eligible, while intervening B becomes stale.
3. Run the store suite plus adjacent Plugin Center client/page/settings tests, typecheck, scoped/full lint, diff/doc gates, then return one clean sole-parent commit.
## Outcome
- Added intent-aware generation ownership for keyed load flights. Re-selecting a pending load promotes that existing flight to the newest generation without issuing a second request, so an intervening project load cannot commit and the renewed flight can commit without retry.
- Preserved epoch invalidation, mutation-triggered authoritative reloads, ordinary latest-project selection, shared-flight promise identity, and stable public `load:<projectId>` pending keys.
- Added both A1/B/A2 completion-order regressions. Before the implementation, the B-first case committed B immediately and the A-first case ended on B; both now end on the renewed A response.
## Verification
- RED: `corepack pnpm exec vitest run tests/unit/coding-plugins-store.test.ts` — 2 new failures / 13 existing passes, demonstrating both incorrect completion orders.
- GREEN: `corepack pnpm exec vitest run tests/unit/coding-plugins-store.test.ts` — 15/15 passed.
- Adjacent focused suite: `corepack pnpm exec vitest run tests/unit/coding-plugins-store.test.ts tests/unit/coding-plugins-client.test.ts tests/unit/project-plugins-page.test.tsx tests/unit/data-service-plugin-settings.test.tsx` — 24/24 passed across 4 files.
- `corepack pnpm run typecheck` — passed.
- `corepack pnpm exec eslint src/stores/coding-plugins.ts tests/unit/coding-plugins-store.test.ts` — passed with no findings.
- `corepack pnpm run lint:check` — passed with 0 errors and 5 pre-existing warnings in `src/pages/Home/index.tsx` and `src/pages/Makelore/index.tsx`, outside this task's ownership.
## Follow-ups
- None recorded.
## Promotion Candidates
- None recorded.