docs(integration): record Square auth lifecycle merge

This commit is contained in:
brother7 committed 2026-08-19 16:55:05 +08:00
1 parent f52c2c8bf8
commit b51dea6f52
7 files changed
+87 -60

No files matched your search

@@ -0,0 +1,45 @@
# Task: Integrate Square auth proxy into Makelore main
## Identity
- Task ID: 20260819-integrate-square-auth-client-2f7c9a
- Mode: Integration
- Branch: codex/20260819-integrate-square-auth-client-2f7c9a-integrate-square-auth-client
- Worktree: D:\Datas\OthersProjects\makelore-integrate-square-auth-2f7c9a
- Base commit: 1907924203a1a998182c8e44e8884682ef216d95
- Owner: codex-root
- Status: In Progress
## Scope
- Integrate feature commit `dc776ff` from task `20260819-square-auth-proxy-client-8c4f2a` into `main` based at `1907924`.
- Promote the desktop authentication lifecycle boundary into canonical project memory.
- Re-run merged-tree authentication and static verification before attempting a default-branch fast-forward.
## Intent And Constraints
- Keep Renderer credential-free and Electron Main as the sole owner of access/refresh token persistence and idle-session cleanup.
- Route login, refresh, and logout through fixed Works Square endpoints; do not restore the embedded OAuth client secret or direct custom-service refresh.
- Preserve the unrelated untracked task record in the primary `main` worktree; do not adopt or overwrite another task's work without explicit authorization.
## Outcome
- Merged source commit `dc776ff` into the isolated candidate integration branch as merge commit `f52c2c8` without conflicts.
- Promoted the Square-owned desktop authentication lifecycle boundary into the canonical current state, architecture flow, system boundary, decision index, and ADR-004.
- The candidate tree is verified, but local `main` still points to `1907924`: its primary worktree contains the unrelated untracked task record `.project-docs/30-worklog/tasks/20260819-package-learning-off-115-9c4d.md`, which this task is not authorized to adopt or overwrite.
## Verification
- `pnpm exec vitest run tests/unit/works-square-session.test.ts tests/unit/auth-routes.test.ts`: 56 passed.
- `pnpm exec vitest run`: 184 test files and 2,190 tests passed.
- `pnpm run typecheck`: passed.
- `git diff --check`: passed before task-record finalization.
## Follow-ups
- Obtain explicit ownership/adoption of the existing primary-worktree task record, or have its owner clean/release the `main` worktree, then fast-forward `main` to this candidate integration branch.
- Deploy and smoke-test the matching Works Square server endpoints before releasing a desktop build.
## Promotion Candidates
- None; the accepted boundary is already promoted in this integration worktree.