docs: integrate reset card wallet

2026-09-08 23:26:08 +08:00
1 parent 01525834fd
commit 84250399dd
@@ -4,6 +4,23 @@ This file is the integrated default-branch snapshot. Feature tasks record progre

 ## Integrated Through

+- Expiring reset-card wallet source commit
+  `01525834fd326a0fbcd6f537b11d6f278470f992` from task
+  `20260908-reset-card-wallet-client-6c3e8a1f` is integrated onto local `main` by
+  task `20260908-integrate-reset-card-wallet-9c4e2a71`. The account menu now owns a
+  lazy-loaded reset-card wallet backed by Main-owned list/redeem routes and the Works
+  Square billing authority. It shows available, elapsed, and redeemed Operations
+  grants with explicit local-time expiry, blocks known-expired and family-shared
+  redemption attempts, and refreshes both the card list and authoritative Token Point
+  V2 balance only after server-confirmed fulfillment. Paid reset-card checkout remains
+  an immediate server-side reset and does not enter this inventory. Source verification
+  passed 78 focused tests, typecheck, scoped and full lint, all Vite production targets,
+  and 3/3 Electron E2E runs. The full unit run's only failure was the previously
+  recorded Pi real-process two-second cold timing assertion, which passed 6/6 in
+  isolation; no Pi code was changed. A compatible Works Square deployment with
+  migration `20260908_reset_card_grants_0087` and a rebuilt client remain release
+  gates; no package, deployment, production mutation, remote push, or publication is
+  claimed.
 - AI Design confirmation-handoff client source commit
  `1a52831b26a226ee675c815e8975b4258a10fa18` from task
  `20260908-design-confirmation-handoff-client-8c3f1a72` is integrated as product
@@ -0,0 +1,51 @@
+# Task: Integrate Makelore reset card wallet
+
+## Identity
+
+- Task ID: 20260908-integrate-reset-card-wallet-9c4e2a71
+- Mode: Integration
+- Branch: codex/20260908-integrate-reset-card-wallet-9c4e2a71-integrate-reset-card-wallet
+- Worktree: D:\Datas\OthersProjects\.codex-worktrees\makelore\20260908-integrate-reset-card-wallet-9c4e2a71
+- Base commit: 01525834fd326a0fbcd6f537b11d6f278470f992
+- Owner: codex
+- Status: In Progress
+
+## Scope
+
+- Integrate exact client source commit
+  `01525834fd326a0fbcd6f537b11d6f278470f992` from Feature task
+  `20260908-reset-card-wallet-client-6c3e8a1f` onto local `main`.
+- Promote the Main-owned reset-card proxy boundary, account-menu wallet flow, and
+  paid-versus-granted-card distinction into canonical project memory.
+- Verify the exact integrated tree, advance `main` by fast-forward only, and preserve
+  the three adopted foreign task records in the primary worktree byte-for-byte.
+
+## Intent And Constraints
+
+- Keep Works credentials, DTO filtering, and safe error mapping in Electron Main;
+  Renderer must not call Works Square directly or receive internal grant/audit data.
+- Keep server-confirmed redemption authoritative and refresh both cards and Token Point
+  balance after fulfillment; do not introduce optimistic success or local allowance
+  calculation.
+- Preserve youth-owned entitlement support and family-shared redemption blocking;
+  Works Square remains the final ownership authority.
+- Preserve paid reset-card immediate fulfillment as a separate non-inventory flow.
+- Do not change product code during Integration, package or publish an installer,
+  deploy a service, push a remote branch, or touch the three adopted task records.
+
+## Outcome
+
+- Not completed.
+
+## Verification
+
+- Not run.
+
+## Follow-ups
+
+- None recorded.
+
+## Promotion Candidates
+
+- In progress: promote reset-card wallet facts to `current-state.md`,
+  `system-overview.md`, `data-flow.md`, and `business-rules.md`.