Skip to content

Architecture Decision Records

Architecture Decision Records capture significant design choices, the alternatives considered, and the reasoning. They’re the single best resource if you want to understand why the code is shaped the way it is.

timeline
  title Restura ADR timeline
  2025-11-05 : 0001 — Shared protocol layer
  2025-11-12 : 0002 — Multi-tab store
             : 0003 — Streaming + HTTP/2
             : 0004 — Security hardening
             : 0005 — CLI runner
  2025-12-03 : 0006 — Connection + DNS hardening
  2025-12-17 : 0007 — SecretRef pattern
  2026-01-14 : 0008 — OpenCollection native format
             : 0009 — Shared Hono app factory
  2026-02-04 : 0010 — AI assistant architecture
             : 0011 — Restura as an MCP server
  2026-02-25 : 0012 — Capability matrix source of truth
             : 0013 — Hash routing
  2026-03-18 : 0014 — Zustand persistence
             : 0015 — QuickJS script sandbox
  2026-04-08 : 0016 — Wire-level auth signing
             : 0017 — Runtime platform detection
  2026-04-29 : 0018 — Rate limiting strategy
             : 0019 — Response viewer architecture
  2026-05-20 : 0020 — AI Lab eval workbench
  2026-06-10 : 0021 — Maintenance harness
  2026-06-17 : 0022 — gRPC over ConnectRPC
  2026-06-24 : 0023 — AI Lab http-exec
  2026-06-28 : 0024 — Browser capture extension
  2026-06-29 : 0025 — VS Code extension
  2026-07-02 : 0026 — Electron CSP + permission hardening
  2026-07-03 : 0027 — Telemetry + privacy-preserving usage
  2026-07-16 : 0028 — TypeScript architecture boundaries
  2026-10-13 : 0029 — Digest auth via challenge-retry
  2026-10-18 : 0030 — MCP stdio transport
  2026-10-18 : 0031 — MCP OAuth 2.1 in Electron main
  2026-10-25 : 0032 — Agent harness: evals first, hook-enforced rules
  2026-10-25 : 0033 — Evals gate harness changes
  2026-10-26 : 0034 — Shared Postman parser and _postman sidecar
  2026-10-30 : 0035 — Review depth tiers, verification vote and REVIEW.md
             : 0036 — NTLM as a desktop-only fetcher handshake
  2026-10-31 : 0037 — Agent Lab: suites, runtime and telemetry
             : 0038 — CLI judges and dataset evals
             : 0039 — One variable token grammar
             : 0040 — Random install ID for Release Health
  2026-11-03 : 0041 — Desktop MCP control server
             : 0042 — Rate-limit principal and trusted proxy
  2026-11-07 : 0043 — Electron Git runtime hardening