Skip to content

adr

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

adr

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
superseded
superseded
 
 
0004-spa-hono-workers.md
0004-spa-hono-workers.md
 
 
0006-openai-gpt-5-mini-via-ai-gateway.md
0006-openai-gpt-5-mini-via-ai-gateway.md
 
 
0009-vercel-ai-sdk-with-streaming.md
0009-vercel-ai-sdk-with-streaming.md
 
 
0011-parallel-suggestion-generation.md
0011-parallel-suggestion-generation.md
 
 
0013-hono-rpc-type-sharing.md
0013-hono-rpc-type-sharing.md
 
 
0014-module-boundaries-platform-types.md
0014-module-boundaries-platform-types.md
 
 
0015-web-ui-linear-sidebar-layout.md
0015-web-ui-linear-sidebar-layout.md
 
 
0016-web-ui-capture-term-composer.md
0016-web-ui-capture-term-composer.md
 
 
0018-outbox-backed-capture-semantics.md
0018-outbox-backed-capture-semantics.md
 
 
0019-e2e-auth-bootstrap-preview.md
0019-e2e-auth-bootstrap-preview.md
 
 
0020-events-first-learning-telemetry.md
0020-events-first-learning-telemetry.md
 
 
0021-extension-device-token-auth.md
0021-extension-device-token-auth.md
 
 
0022-m1-dashboard-read-models-and-export.md
0022-m1-dashboard-read-models-and-export.md
 
 
0023-term-archival-and-bulk-actions.md
0023-term-archival-and-bulk-actions.md
 
 
0024-accept-individual-candidates.md
0024-accept-individual-candidates.md
 
 
0025-public-auth-and-telemetry-separation.md
0025-public-auth-and-telemetry-separation.md
 
 
0026-term-suggestion-quotas-and-global-budget.md
0026-term-suggestion-quotas-and-global-budget.md
 
 
0027-data-retention-and-account-deletion.md
0027-data-retention-and-account-deletion.md
 
 
0028-doppler-canonical-secrets.md
0028-doppler-canonical-secrets.md
 
 
README.md
README.md
 
 

README.md

Architecture Decision Records

This folder stores append-only decisions with rationale.

Rules

Prefer adding new ADRs over editing old ones. If a decision changes, add a new ADR and mark the old one superseded. Keep docs/design.md as the current snapshot and link to ADRs for context.

Index

Active

  • 0004: SPA (React + TanStack Router) + Hono on Workers (no SSR)
  • 0006: OpenAI gpt-5-mini via Cloudflare AI Gateway
  • 0009: Vercel AI SDK with SSE streaming for suggestions
  • 0011: Parallel suggestion generation with concurrency=10
  • 0013: Hono RPC replaces contracts package for API type sharing
  • 0014: Module boundary: lib must not depend on platform
  • 0015: Linear-style sidebar navigation replacing header nav
  • 0016: Capture page term composer with local-only draft persistence
  • 0018: Outbox-backed capture semantics (queue now, open later, undo)
  • 0019: E2E auth bootstrap endpoint for preview + Playwright (non-prod only)
  • 0020: Events-first learning telemetry (WakaTime-for-learning)
  • 0021: Extension auth via device tokens (bearer)
  • 0022: M1 dashboard read models + raw events export
  • 0023: Term archival + bulk actions (delete/move)
  • 0024: Accept individual candidates with data table UI
  • 0025: Public auth with AUTH_MODE switch + telemetry access separation
  • 0026: Per-user lifetime quotas (3) + global monthly budget
  • 0027: Indefinite retention by default + hard delete on account deletion
  • 0028: Doppler as canonical source of truth for secrets

Superseded

(Moved to superseded/ subdirectory)

  • 0001: Google SSO with allowlist (see 0025)
  • 0002: Duplicate handling via Term + TermSense (see 0020)
  • 0003: Bucket feed shows primary sense by default (see 0020)
  • 0005: Web auth gating via protected layout route (see 0015)
  • 0007: Step 3 suggestions stored on candidate + per-term cache (see 0020)
  • 0008: Accept-all idempotency via candidate materialization pointers (see 0020)
  • 0010: OpenAI API key stored in Cloudflare Secrets Store (see 0028)
  • 0012: User-owned dynamic buckets (see 0020)
  • 0017: Term + TermSense edits with optimistic locking (see 0020)