docs(plan): advance to job discovery

docs/work-programmes/decisions.md

@@ -599,3 +599,13 @@
 - **Consequences:** empty-job and missing-send-consent states explain why compose is unavailable. The hub currently lists the 100 most recent owned jobs; older jobs remain accessible from their job workspace and broader searchable selection is follow-up UX, not a hidden authorization bypass.
 - **User approval required:** No; local UI work uses mocked APIs and sends no message.
 - **Reversible:** Revert `b735963`; reply drafting and all server draft/send boundaries remain.
+
+## DEC-061 — Stop MAIL scope at installed provider authority
+
+- **Date:** 2026-08-10
+- **Decision:** Mark MAIL-001 `IMPLEMENTED — NOT VERIFIED` after completing the repository draft/send/link flows. Do not add read/unread, pin/read-later, archive, spam or trash UI because the installed Gmail/Graph/IMAP contracts and granted scopes do not authorize those mutations.
+- **Reason/evidence:** Phase 9 says these states apply where supported. Current Gmail adds read/send, Graph adds read/send, and IMAP is read-only; the neutral interface exposes read/detail/send only. Displaying or simulating category actions would be false capability and production-risking scope creep.
+- **Alternatives considered:** request modify/read-write scopes silently; mutate only JobTracker copies while labelling them provider actions; add disabled controls; keep MAIL indefinitely in progress. These broaden consent, misrepresent mailbox state, clutter UX or block independent work.
+- **Consequences:** real-provider re-consent, provider category design, browser gates, SEC-009 deletion and production verification remain explicit blockers before `DONE`. JOBS-001 becomes the sole in-progress item.
+- **User approval required:** No for status correction; any future provider-scope/re-consent rollout needs a separately reviewed package and safe account verification.
+- **Reversible:** Yes. MAIL-001 can return to `IN PROGRESS` when provider mutation authority is approved and testable.

docs/work-programmes/master-progress.md

@@ -2,16 +2,16 @@
 
 Updated: 2026-08-10
 
-- **Overall programme status:** Active. Seven packages are locally verified; nineteen packages through CAREER-002 are implemented with automated/runtime evidence but blocked from applicable browser/provider/production gates; MAIL-001 is in progress with twenty-one committed implementation/test increments. Gitea run 609 passes complete pull-request CI in 4m20s; DEP-001 now awaits approved merge-to-main and production verification only.
-- **Current work package:** `MAIL-001` — consolidated job-email hub and explicit sending (`IN PROGRESS`); routing/reads/detail, ledger, Gmail/Graph delivery/re-consent, safe send API/UI, recovery, legacy SMTP retirement, send/draft export, revisioned draft API/idempotency, saved reply/new-message recovery and definitive-failure rotation are committed. Application context, confirmed Gmail unlink and honest disconnected/read-only/send/failure states are shared. Provider mailbox mutations require new scopes/re-consent and remain absent; full account deletion stays SEC-009.
+- **Overall programme status:** Active. Seven packages are locally verified; twenty packages through MAIL-001 are implemented with automated/runtime evidence but blocked from applicable browser/provider/production gates; JOBS-001 is now in progress. Gitea run 609 passes complete pull-request CI in 4m20s; DEP-001 now awaits approved merge-to-main and production verification only.
+- **Current work package:** `JOBS-001` — job-search source and assessment redesign (`IN PROGRESS`); Phase 4/source-provenance inventory and current-behavior reproduction are next.
 - **Completed work packages:** None are `DONE`; all repository security/AI packages still have applicable browser, provider and/or production gates.
 - **Locally verified work:** SEC-001, SEC-002, SEC-003, SEC-005A, CORE-001, PROD-002 and DEP-001 (`VERIFIED LOCALLY`).
-- **Implemented, verification incomplete:** SEC-004, SEC-005B, SEC-008, CORE-002, BG-001, OPS-001A/B/C, POL-001/002, AI-001/002/003/004, UX-001/002, QA-001, CAREER-001 and CAREER-002 (`IMPLEMENTED — NOT VERIFIED`). CAREER-002 now protects unsaved edits and provides tested structured custom-entry, profile-override and preview-error interactions; all automated/build gates pass.
+- **Implemented, verification incomplete:** SEC-004, SEC-005B, SEC-008, CORE-002, BG-001, OPS-001A/B/C, POL-001/002, AI-001/002/003/004, UX-001/002, QA-001, CAREER-001, CAREER-002 and MAIL-001 (`IMPLEMENTED — NOT VERIFIED`). MAIL repository flows are implemented; provider mutation/re-consent, browser, deletion and production gates remain.
 - **Production-verified work:** None.
 - **Blocked work:** SEC-006 parser upgrades remain outside the scoped frontend advisory permission; PROD-001/003/004 and REL-001 require documented production access and unfinished dependencies. Real provider, SMTP/MariaDB and production environments are unavailable; DEP-001 awaits approved merge/live verification. The in-app browser is available for local UI checks.
 - **Deferred work:** None. Conditional multi-replica coordination, model deletion, realtime operation delivery and unrelated production changes remain outside current packages.
-- **Next five work packages:** MAIL-001 consolidated email experience; JOBS-001 job-search/application redesign; HOME-001 homepage/Pro promotion; UX-003 authentication/profile polish; PRODUCT-001 homepage/Pro claims. SEC-006/007 resume after package-index permission.
-- **Status counts:** 7 `VERIFIED LOCALLY`; 19 `IMPLEMENTED — NOT VERIFIED`; 1 `IN PROGRESS`; 8 `NOT STARTED`; 5 `BLOCKED`; 0 `DONE`; 0 `DEFERRED`.
+- **Next five work packages:** JOBS-001 job-search/application redesign; HOME-001 homepage/Pro promotion; UX-003 authentication/profile polish; PRODUCT-001 homepage/Pro claims; JOBS-002 application workspace redesign. SEC-006/007 resume after package-index permission.
+- **Status counts:** 7 `VERIFIED LOCALLY`; 20 `IMPLEMENTED — NOT VERIFIED`; 1 `IN PROGRESS`; 7 `NOT STARTED`; 5 `BLOCKED`; 0 `DONE`; 0 `DEFERRED`.
 - **Test status:** backend 630/630; frontend 50/50 suites and 198/198 tests; Playwright smoke 4/4; npm audit 0 vulnerabilities; DEP-001 focused router 24/24 and production build pass; MAIL-001 draft/new-message UI 13/13, draft API/idempotency/rotation 10/10, readable draft export 4/4, draft persistence 1/1, Free send 7/7, provider states 9/9, hub unlink 8/8 UI and 2/2 API, shared context 10/10, prior send export/cascade 16/16, recovery/send 10/10, legacy follow-up/backend worker 10/10, legacy UI 2/2, delivery/capability 18/18, provider/correspondence 5/5 and hub detail 5/5. EF model-current and SQLite/MariaDB up/down draft scripts pass; a full blank-chain SQLite apply remains blocked by pre-existing JT-019 drift. Jest open-handle/slow-run behavior is recorded in V-127/V-128/V-130/V-131/V-135/V-142/V-143/V-144/V-150/V-151/V-152.
 - **Deployment status:** Gitea pull-request run 609 passed the complete CI job in 4m20s. Deploy was intentionally skipped because the workflow deploys only a `push` to `main`; live remains unchanged. No merge/deployment was performed directly, no production migrations were run and the AI operation worker remains disabled by default.
 - **Production status:** Unchanged and unverified. No provider/model call, model pull, external request or paid API occurred.

docs/work-programmes/master-work-plan.md

@@ -16,7 +16,7 @@ Allowed statuses are `NOT STARTED`, `IN PROGRESS`, `IMPLEMENTED — NOT VERIFIED
 
 `DONE` requires every applicable acceptance criterion, focused and regression tests, browser/accessibility/theme/mobile checks, tenant and entitlement checks, documentation, migration/rollback evidence, and production verification. Repository-only work that still requires production is at most `VERIFIED LOCALLY`.
 
-Exactly one implementation item may be `IN PROGRESS`. As of this revision it is **MAIL-001**.
+Exactly one implementation item may be `IN PROGRESS`. As of this revision it is **JOBS-001**.
 
 ## Consolidated dependency order
 
@@ -649,9 +649,9 @@ Ordering differences from the suggested list:
 - **Required tests:** link/unlink/dismiss/draft/send duplicate/uncertain/provider failure/reauth/two tenants/free/pro/application embed.
 - **Required browser verification:** all states at three widths/themes/keyboard; mocked providers only unless safe configured account.
 - **Required production verification:** provider read/draft/send requires explicit authorized synthetic account; never real unsolicited email.
-- **Status:** `IN PROGRESS`.
-- **Blocker:** real provider verification is external; required 375/768/1440/theme/keyboard browser gates were unavailable in the current browser surface. Mocked/local repository implementation remains unblocked.
-- **Evidence:** `docs/verification/mail-001-job-email-hub.md`; V-126–V-152. Draft/new-message UI 13/13, API/idempotency/rotation 10/10, persistence 1/1 with dual-provider reversible SQL and readable export 4/4; Free send policy 7/7; provider states 9/9; hub unlink 8/8 UI and 2/2 API; shared application context focused 10/10; prior send export/cascade focused 16/16; recovery/send focused 10/10; legacy follow-up/worker 10/10; delivery/capability 18/18; provider/correspondence 5/5; hub detail 5/5; backend 630/630; frontend 50/50 suites and 198/198 tests plus build/audit; local empty/disconnected and compatibility-route browser smoke at 1280×720.
+- **Status:** `IMPLEMENTED — NOT VERIFIED`.
+- **Blocker:** real provider/re-consent, full SEC-009 deletion, MariaDB, production and required 375/768/1440/theme/keyboard browser gates are unavailable or require new authority.
+- **Evidence:** `docs/verification/mail-001-job-email-hub.md`; V-126–V-153. Draft/new-message UI 13/13, API/idempotency/rotation 10/10, persistence 1/1 with dual-provider reversible SQL and readable export 4/4; Free send policy 7/7; provider states 9/9; hub unlink 8/8 UI and 2/2 API; shared application context focused 10/10; prior send export/cascade focused 16/16; recovery/send focused 10/10; legacy follow-up/worker 10/10; delivery/capability 18/18; provider/correspondence 5/5; hub detail 5/5; backend 630/630; frontend 50/50 suites and 198/198 tests plus build/audit; local empty/disconnected and compatibility-route browser smoke at 1280×720.
 - **Commit:** `6008b4a` (hub), `536d403` (neutral reads), `a20775c` (safe detail), `653f011` (ledger), `e9937ac` (Gmail/Graph delivery adapters and consent), `123fc55` (explicit-confirmed send API), `449faeb` (confirmed reply composer), `ee5ef7e` (interrupted-send recovery), `8fe3903` (legacy SMTP retirement), `aff34cc` (content-free export and cascade evidence), `ff547df` (shared application context), `1dabbeb` (confirmed hub unlink), `f9e641c` (honest provider states), `7f41cb2` (Free email policy regression), `14b396a` (inert tenant draft persistence), `2fa4e38` (owner-isolated readable draft export), `a9bb22e` (tenant-safe revisioned draft API), `80b5532` (persisted draft send identity), `d3d2b67` (saved reply recovery/conflicts), `29de263` (definitive-failure identity rotation), `b735963` (new-message job/provider drafting).
 - **Remaining work:** full account deletion remains SEC-009; provider mailbox category capabilities require separately authorized scopes/re-consent and remain absent; searchable selection beyond the 100 recent jobs; browser/production verification. Existing connections need explicit re-consent; IMAP remains read-only. No real email; uncertain sends need manual reconciliation. JT-019 blocks a clean full-chain SQLite rehearsal before the new draft migration.
 
@@ -667,11 +667,11 @@ Ordering differences from the suggested list:
 - **Required tests:** provenance mapping/filter/import preservation/empty/loading/error/duplicates.
 - **Required browser verification:** three widths/themes/keyboard/long text/Norwegian/import.
 - **Required production verification:** official NAV/safe provider smoke; unavailable providers labeled.
-- **Status:** `NOT STARTED`.
-- **Blocker:** live provider checks may be external; synthetic fixtures suffice locally.
-- **Evidence:** source requirement.
-- **Commit:** none.
-- **Remaining work:** no scraping or inferred-as-verified source.
+- **Status:** `IN PROGRESS`.
+- **Blocker:** none for repository inspection and synthetic implementation; official source/browser/production validation remains external.
+- **Evidence:** initial dependency and source-provenance inventory begins at V-154.
+- **Commit:** none yet.
+- **Remaining work:** re-read Phase 4, reproduce current discovery/import behavior, inventory source provenance and implement the smallest evidence-backed increment.
 
 ### JOBS-002 — Applications table and embedded workspace
 

docs/work-programmes/session-handoff.md

@@ -2,8 +2,8 @@
 
 Updated: 2026-08-10
 
-- **Exact current task:** MAIL-001 — revalidate remaining repository work (shared job-workspace actions and provider mailbox mutations), then either implement a safe supported increment or record the scope/re-consent blocker and move to the next work package.
-- **Last completed step:** new-message owned-job/send-capable-provider drafting was committed/pushed as `b735963`; inbox 13/13, frontend 198/198 and production build pass.
+- **Exact current task:** JOBS-001 — re-read Phase 4 and reproduce current job discovery/source/import behavior before choosing the first change.
+- **Last completed step:** MAIL-001 repository inventory found no safe remaining provider mutation without new consent/scopes; MAIL moved to `IMPLEMENTED — NOT VERIFIED` and JOBS-001 became the sole `IN PROGRESS` item.
 - **Files currently modified:** authoritative MAIL-001 tracking/evidence only; persistence/export/API code is committed.
 - **Commands already run:** dependency/audit/router/full frontend/build; legacy follow-up/export/recovery/provider suites; full backend; Gitea run inspection; Playwright; MAIL context/unlink/provider-state/Free-policy/draft-persistence focused and full suites/build; EF model-current and dual-provider up/down scripts. See V-126–V-146.
 - **Test results:** npm audit 0 vulnerabilities; Gitea pull-request CI PASS in 4m20s at run 609; backend 625/625; frontend 50/50 suites and 194/194 tests; Playwright 4/4; production build passes. Draft isolation/cascade 1/1; EF model current; SQLite/MariaDB draft up/down scripts pass. Full blank-chain SQLite apply fails earlier in `AddJobEntityAndProspectStages` on missing `LastReminderEmailSentAt` (JT-019).
@@ -11,8 +11,8 @@ Updated: 2026-08-10
 - **Temporary files or processes:** no task-owned process is running and the failed disposable migration database was removed. Existing synthetic browser evidence/account and startup-created local backup remain documented. No provider account, real email, private content, 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:** downgrade `20260810080858_AddEmailDraftClientRequestId`, then `20260810075206_AddEmailDrafts`, before reverting draft commits; then follow the existing MAIL rollback order (`ee5ef7e`, `449faeb`, `123fc55`/`e9937ac`, ledger downgrade before `653f011`). No production migration/deploy/provider grant occurred.
-- **Uncommitted changes:** tracking/evidence for `b735963` and V-152 only; commit and push before remaining MAIL inventory.
+- **Uncommitted changes:** tracking/decision/evidence for MAIL closure and V-153 only; commit and push before JOBS implementation.
 - **Known failures:** live deployment is not verified because PR deploy is intentionally skipped and the active branch is not approved for merge. Draft export/API/UI, full thread/category actions and non-Gmail review remain; existing accounts need re-consent and IMAP stays read-only. A clean full-chain SQLite apply fails in the pre-existing JT-019 migration before the new draft migration. Browser/provider/MariaDB/production unavailable or unverified; recovery scan performance is unmeasured at large ledger scale; Jest open handles; SEC-006 parser dependency work is still separately gated; parser isolation remains SEC-007.
-- **Exact next action:** compare canonical hub and embedded job-workspace detail/link/unlink actions against current provider contracts. Do not request Gmail modify or Graph read-write scopes without a reviewed re-consent package; if no safe mutation remains, record MAIL repository scope complete/externally blocked and advance to JOBS-001.
+- **Exact next action:** read `docs/todo/work.md` Phase 4 and inspect `JobDiscoveryPage`, discovery DTO/API/source adapters/import path and tests; reproduce source/filter/import behavior with mocks before editing.
 - **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.