Skip to content

Feat/mail provider abstraction - #59

Merged
urnlahzer merged 3 commits into
mainfrom
feat/mail-provider-abstraction
Oct 2, 2026
Merged

urnlahzer merged 3 commits into
mainfrom
feat/mail-provider-abstraction

Conversation

@urnlahzer

Copy link
Copy Markdown
Owner

No description provided.

urnlahzer and others added 3 commits October 2, 2026 07:21
…gistry

PR #57 re-derived contracts/model/decision-questions.json (accept/escalate thresholds
changed; ids, fields and option keys did not) without touching the Rust tests, so 13
tests in review_model::scanning that hard-coded probabilities tuned to the old
thresholds failed on main. Production code reads every threshold from the embedded
registry at run time and is correct for the new values; only the fixtures were stale.

Test module of crates/openloops-desktop/src/review_scan.rs only:
- new helpers registry_accept(id), registry_gray(id) (escalate..accept midpoint) and
  micros(p), following the pattern every_rule_gray_reject_and_error_falls_back already
  used, so the next re-tune does not break these tests;
- FixedDecisionClient::new sends a gray closure.outcome choice (was 0.5, now below the
  new 0.8 escalate cut) so the noul answers still decide;
- each of the 13 tests takes its accept/gray values from the registry; no assertion
  removed. compare_prediction_flags_the_registry_gray_band_for_nouls_and_choices now
  asserts the fixed 0.5 noul label at the gray value and adds a 0.1 false-branch case.

Verified: cargo fmt --check; clippy -D warnings (desktop native-ui,ui-screenshot);
desktop 424 passed, 0 failed, 3 ignored; no Cargo, tools, or contracts changes.

Registry values for the owner to review (unchanged here): closure.outcome accept 1.0 /
escalate 0.8 means a choice below 0.8 ends the pair with no noul fallback; deadline_kind
accept 1.0 almost never auto-applies; three passing tests sit exactly on new cuts.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YCesN8ZHnhqa6n3rWFThas
…er-provider sessions

Design doc: docs/plans/2026-09-27-google-provider-and-shared-registration.md
(approved 2026-09-27). This is the graph-crate half of PR-1.

- live/provider.rs: MailProvider {Microsoft, Google}, AccountConfig enum dispatch,
  ProviderLoad and load_all (continues after one provider fails).
- live/registration.rs: build-time injected shared registrations via option_env!
  (OPENLOOPS_MS_CLIENT_ID, OPENLOOPS_GOOGLE_CLIENT_ID, OPENLOOPS_GOOGLE_CLIENT_SECRET),
  BYO-over-shipped precedence, and the tenant admin-consent URL. Nothing is committed
  to the repository; a source build without the variables behaves as before.
- live/google/mod.rs: GoogleConfig validation only; every Google call returns
  ProviderUnavailable until PR-2.
- live.rs: SESSIONS has one slot per provider (clear_session_for, clear_all_sessions,
  has_session_for; the Microsoft-named wrappers keep their behaviour); OAuthEndpoints +
  authorize_with parametrise authority, token URI, redirect host, optional installed-app
  client secret, extra params and scope normalisation, with MICROSOFT reproducing the
  current flow exactly; any refresh_token in a token response is removed and zeroed
  before the OAuth library parses it; AADSTS65001/90094 -> AdminConsentRequired and
  AADSTS650052/650056 -> PublisherNotTrusted, content-free; ConnectionError text is
  provider-neutral.
- live/callback.rs: RedirectHost {Localhost, LoopbackIp}; the Host check follows it.
- live/review.rs: provider field on MailItem, SourceReview, UserIdentity (Microsoft
  default, account string unchanged so decision fingerprints are stable);
  fetch_from_origin_with_headers, add_hydrated and cutoff made crate-shareable.
- live/reminders.rs: ReminderRequest.provider; valid_graph_id -> valid_remote_id.
- live/test_support.rs: shared fake servers plus a path-routed server for PR-2.
- desktop: struct literals gain provider: Microsoft; the reminder-status test's three
  expected strings follow the neutral ConnectionError wording (no behaviour change).

Verified: cargo fmt --check; clippy -D warnings (graph live-connection, desktop
native-ui,ui-screenshot); graph 161 passed; desktop 424 passed, 0 failed, 3 ignored (the
branch sits on PR #58's scanning-test fix, 4d969d4, so the suite is green); Cargo.lock
unchanged; the twelve tools/check-*.ps1 checkers match the origin/main baseline
(the four that fail there fail identically here).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YCesN8ZHnhqa6n3rWFThas
…ope, shipped-registration wiring

Desktop half of PR-1 (design: docs/plans/2026-09-27-google-provider-and-shared-registration.md).

- review_scan/review_model/app_model/slint_review: ConversationKey = (account, conversation)
  replaces every bare conversation-id set (ScanScope::Incremental, retry/check outcomes,
  append_sources, merge_scan, retryable_conversations, prior_open_items); closes the
  cross-account collision before a second provider exists. Exchange split-thread merging
  is Microsoft-only: a ThreadGroup with non-Microsoft messages is authoritative and never
  merged. ReviewMessage carries provider.
- loop_state: Reminder::Created/Completed carry provider; wire bytes 0..3 unchanged
  (decode as Microsoft), 4/5 = Google; legacy-bytes test pins the old layout.
- Links: is_trusted_message_link accepts the Outlook hosts and https://mail.google.com/;
  open-external accepts any provider's tasks URL; "Open message in {Outlook|Gmail}" labels
  are bound per card (url-label) instead of literal.
- AccountDisplay::connected(&[MailProvider]) names one or both providers; the title bar
  binds account-text.
- Outcome::Connection(provider, ..), Service::Mailbox; AppModel gains google: Status,
  effective_microsoft_client_id (BYO field > shipped registration > none),
  shared_registration_active, admin_consent_url, exposed to the Sources screen as
  shared-registration-active / admin-consent-url (layout lands in PR-1c).
- settings: fields 13 google_client_id, 14 google_client_secret (zeroizing),
  15 mail_providers tag (ms | google | ms,google; absent -> ms) on the append-only record;
  boundary, round-trip, unknown-tag and size tests.
- graph nits from the PR-1a review: exchange_token_request takes one token URI;
  GoogleConfig exposes client_id()/client_secret() instead of a filler assertion.

- Review fixes (Opus read-only review): the sign-in button gates on the effective client
  ID, not the BYO field; the Microsoft reminder sync/complete paths bind
  provider: Microsoft so a Google record can never reach Graph; apply_reconcile keeps the
  record's provider; conversation_quality / notes / rejection_reasons are keyed by
  ConversationKey; per-message key clones removed; shared borrowed_filter helper;
  AccountDisplay::connected(&[]) keeps the empty-name contract; TODO_URL derives from
  MailProvider::Microsoft.tasks_url(). Deferred to PR-2 (noted in the plan):
  Service::Mailbox(MailProvider) and the microsoft_status() rename.

Microsoft decision fingerprints and relation keys are byte-identical to before.

Verified: cargo fmt --check; clippy -D warnings (graph live-connection, desktop
native-ui,ui-screenshot); graph 161 passed; desktop 436 passed, 0 failed, 3 ignored;
Cargo.lock unchanged; public-repo gate on staged files.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YCesN8ZHnhqa6n3rWFThas
@urnlahzer
urnlahzer marked this pull request as ready for review October 2, 2026 21:34
@urnlahzer
urnlahzer merged commit ac9d71d into main Oct 2, 2026
2 checks passed
@urnlahzer
urnlahzer deleted the feat/mail-provider-abstraction branch October 2, 2026 21:34
urnlahzer added a commit that referenced this pull request Oct 2, 2026
…amendment (CONTRACT EDIT FOR OWNER REVIEW) (#60)

Third slice of PR-1 in docs/plans/2026-09-27-google-provider-and-shared-registration.md,
on top of #59.

- Sources card 1 branches on whether the build carries a shipped Microsoft registration
  (a property set once from registration::microsoft(), so typing in the client-ID field no
  longer re-renders the card and loses focus). With one: helper text; a read-only
  monospace "Admin consent link" Field and "Open admin consent page" (reusing the open-entra
  callback) shown while the BYO field is empty; the BYO client-ID field inside a
  "Use my organization's own registration (optional)" disclosure with "Open Microsoft
  Entra" (new open-entra-portal callback). Without one: today's layout.
- Field gains a read-only passthrough to LineEdit/TextEdit; no new component types.
- on_open_entra opens the admin-consent URL only when the shared registration is active
  and the URL passes a gate allowing exactly the login.microsoftonline.com origin
  (debug-asserted); otherwise the Entra portal. shared_registration_active_for() is a pure
  helper with its own tests (empty / whitespace / non-empty field; no shipped id).
- ADR-012: additive "Amendment (2026-10-02): shared-registration mechanism" describing
  build-time injection as the enablement switch while tracked configuration stays
  placeholder-only; no existing sentence changed. tools/check-distribution-registration-
  boundary.ps1: only the ADR hash literal re-pinned; P0-DIST-CROSS-CONTRACT-001 passes;
  the pre-existing P0-DIST-INVENTORY-001 failure is unchanged. JSON contracts untouched.
- docs/native-setup.md and docs/live-connection.md describe the two modes, the
  "Need admin approval" screen, the unreachable localhost page after consent, and the
  three build-time variables (source builds without them stay BYO-only).

Verified: cargo fmt --check; clippy -D warnings (desktop native-ui,ui-screenshot);
desktop 438 passed, 0 failed, 3 ignored; distribution checker as above;
Cargo.lock unchanged; public-repo gate on staged files.


Claude-Session: https://claude.ai/code/session_01YCesN8ZHnhqa6n3rWFThas

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant