- Create a new ADR using the template in
docs/adr/template.md.
- Give it a sequential identifier (e.g.,
001, 002) and a concise title.
- Capture context, decision, consequences, and follow-up actions.
- Append the new ADR entry to the end of the Catalogue list above.
- Append the same entry under
ADRs in docs/SUMMARY.md, keeping it nested so the sidebar stays collapsed.
- Reference ADRs from code comments or docs where the decision applies.
- Template – ADR template
- 001 – Configuration revisioning
- 002 – Setup token lifecycle
- 003 – Libtorrent session runner
- 004 – Phase one delivery
- 005 – FS operations pipeline
- 006 – API/CLI contract
- 007 – Security posture
- 008 – Remaining phase-one tasks
- 009 – FS ops permission hardening
- 010 – Agent compliance sweep
- 011 – Coverage hardening
- 012 – Agent compliance refresh
- 013 – Runtime persistence
- 014 – Data access layer
- 015 – Agent compliance hardening
- 016 – Libtorrent restoration
- 017 – Avoid
sqlx-named-bind
- 018 – Retire testcontainers
- 019 – Advisory RUSTSEC-2024-0370 temporary ignore
- 020 – Torrent engine precursor hardening
- 021 – Torrent precursor enforcement
- 022 – Torrent settings parity and observability
- 023 – Tracker config wiring and persistence
- 024 – Seeding stop criteria and overrides
- 025 – Seed mode admission with optional hash sampling
- 026 – Queue auto-managed defaults and PEX threading
- 027 – Choking strategy and super-seeding configuration
- 028 – qBittorrent parity and tracker TLS wiring
- 029 – Torrent authoring, labels, and metadata updates
- 030 – Migration consolidation for initial setup
- 031 – UI Nexus asset sync tooling
- 032 – Torrent FFI audit closeout
- 033 – UI SSE + auth/setup wiring
- 034 – UI SSE normalization and ApiClient singleton
- 035 – Advisory RUSTSEC-2021-0065 temporary ignore
- 036 – Asset sync test stability under parallel runs
- 037 – UI row slices and system-rate store wiring
- 038 – UI shared API models and torrent query paging state
- 039 – UI store, API coverage, and rate-limit retries
- 040 – UI label policy editor and API wiring
- 041 – UI health view and label shortcuts
- 042 – UI metrics copy button
- 043 – UI settings bypass local auth toggle
- 044 – UI ApiClient torrent options/selection endpoints
- 045 – UI icon components and icon button standardization
- 046 – UI torrent filters, pagination, and URL sync
- 047 – UI torrent list updated timestamp column
- 048 – UI torrent row actions, bulk controls, and rate/remove dialogs
- 049 – UI detail drawer overview/files/options
- 050 – UI torrent FAB, add modal, and create-torrent authoring flow
- 051 – UI shared API models and UX primitives
- 052 – UI dashboard migration to Nexus vendor layout
- 053 – UI dashboard hardline rebuild
- 054 – UI dashboard Nexus parity tweaks
- 055 – Factory reset and bootstrap API key
- 056 – Factory reset auth fallback when no API keys exist
- 057 – UI settings tabs and editor controls
- 058 – UI settings controls, logs stream, and filesystem browser
- 059 – Migration rebaseline and JSON backfill guardrails
- 060 – Auth expiry enforcement and structured error context
- 061 – API error i18n and OpenAPI asset constants
- 062 – Event bus publish guardrails and API i18n cleanup
- 063 – CI compliance cleanup for test error handling
- 064 – Factory reset error context and allow-path validation
- 065 – API key refresh and no-auth setup mode
- 066 – Factory reset UX fallback and SSE setup gating
- 067 – Logs ANSI rendering and bounded buffer
- 068 – Agent compliance clippy cargo linting
- 069 – Pin mdbook-mermaid for docs builds
- 070 – Dashboard UI checklist completion and auth/SSE hardening
- 071 – Libtorrent native fallback for default CI
- 072 – Agent compliance refactor (UI + HTTP + Config Layout)
- 073 – UI checklist follow-ups: SSE detail refresh, labels shortcuts, strict i18n, and anymap removal
- 074 – Temporary vendoring of yewdux for latest Yew compatibility
- 075 – Coverage gate tests for config loader and data toggles
- 076 – Temporary clippy exception for hashbrown multiple versions
- 077 – UI menu interactions
- 078 – Local auth bypass guardrails
- 079 – Advisory RUSTSEC-2025-0141 temporary ignore
- 080 – Local auth bypass reliability
- 081 – Playwright E2E test suite
- 082 – E2E gate and selector stability
- 083 – API preflight before UI E2E
- 084 – E2E API coverage with temp databases
- 085 – E2E OpenAPI client and unified coverage
- 086 – Default local auth bypass
- 087 – Local network auth ranges and settings validation
- 088 – Live SSE log streaming
- 089 – Port process termination for dev tooling
- 090 – UI log filters and shell controls
- 091 – Raise per-crate coverage gate to 90%
- 092 – Fsops coverage hardening
- 093 – UI logic extraction for testable components
- 094 – UI E2E sharding in workflows
- 095 – Untagged images use dev tag
- 096 – Aggregate UI E2E coverage for sharded runs
- 097 – Dev prereleases and PR image previews
- 098 – Reusable image build workflow
- 099 – Indexer ERD single-tenant and audit fields