jobtrackingapp/docs/work-programmes/session-handoff.md

JobTracker session handoff

Updated: 2026-08-09

• Exact current task: MAIL-001 — consume the new neutral read API in shared thread/detail UI, then design the explicit provider-send/re-consent/idempotency/uncertain-delivery ledger without sending real email.
• Last completed step: owner-scoped /api/email provider status/search/thread/plain-text detail and honest read-only hub status were committed/pushed as 536d403; canonical hub routing remains 6008b4a.
• Files currently modified: MAIL-001 verification/log/master tracking documents only. Application code/tests are committed and pushed.
• Commands already run: Phase 9/provider architecture and complete legacy send trace; provider/controller and hub focused tests; full backend/frontend; production build; diff/secret review; implementation commit/push. See V-126–V-130.
• Test results: MAIL-001 provider controller 3/3; hub/review 5/5; backend 604/604; frontend 49/49 suites and 186/186 tests; production build/TypeScript and patch check pass. Full Jest required force exit and took 170.377s.
• Services currently running: none started intentionally. Exact task-owned hung Jest/build Node processes were stopped; Codex browser runtimes were not touched. Pre-existing Docker services were not changed.
• Temporary files or processes: none. No provider account, private email, external model, paid service or production service was accessed.
• Production changes currently active: none. No deployment, migration, provider connection/sync/send or production payload occurred.
• Rollback status: revert 536d403 for neutral API/status and 6008b4a for hub routing; no schema/config/dependency/data migration. CAREER rollback records remain current. Production is unchanged.
• Uncommitted changes: MAIL-001 evidence/tracking documents only; commit/push before the next application increment.
• Known failures: shared thread/detail UI, provider state actions and explicit idempotent send remain; Gmail is the only mature review UI; Gmail/Graph OAuth scopes and the IMAP contract are read-only; legacy follow-up uses application SMTP without explicit confirmation/idempotency and must not be called provider send. Real provider/SMTP/MariaDB/production unavailable; Jest open handles; SEC-006 needs internet/package-index permission; parser isolation remains SEC-007.
• Exact next action: commit/push this evidence, then define the minimum provider-send contract and durable send-attempt states (confirmed, pending, sent, failed-before-delivery, uncertain) including OAuth scope/re-consent and duplicate-request behavior; implement only a fake-tested repository slice that cannot send real email.
• Work that can continue independently: remaining MAIL-001 repository work and later UX packages. SEC-006/007 await package-index permission; PROD-001/003/004 await production access.
• Decisions still required from the user: none for synthetic/code-inspected repository work. Any provider connection or send test, internet/package upgrades, private data, external/paid providers and production actions retain explicit approval/safety gates; SEC-009 retention/legal policy remains unresolved.