docs: seed ADR catalogue#5

Open

vilaca wants to merge 59 commits into

mainfrom

Commits on May 19, 2026

docs(adr): bootstrap ADR catalogue scaffold
vilaca
committed
docs(adr): 0001 no cyclic imports anywhere under src/
vilaca
committed
docs(adr): 0002 src/core/ has no dependency on src/ui/ or src/cli/
vilaca
committed
docs(adr): 0003 src/security/ and src/utils/ are primitive layers with no sibling deps
vilaca
committed
docs(adr): 0004 src/providers/ has no dependency on src/ui/ or src/tools/
vilaca
committed
docs(adr): 0005 src/providers/openai/ is an internal adapter with no external importers
vilaca
committed
docs(adr): 0006 src/mcp/ and src/ui/ must not import each other
vilaca
committed
docs(adr): 0007 src/ui/headless.ts must not depend on the TUI tree
vilaca
committed
docs(adr): 0008 src/ui/ is a presentation layer with no concrete providers tools SDKs or direct network
vilaca
committed
docs(adr): 0009 provider abstraction with a shared OpenAI-compatible adapter
vilaca
committed
docs(adr): 0010 two-tier rotation per key then per provider:model tuple
vilaca
committed
docs(adr): 0011 AgentEvent as the single contract between core loop and renderers
vilaca
committed
docs(adr): 0012 plan mode gates writes not all tool calls
vilaca
committed
docs(adr): 0013 built-in security rules are additive only
vilaca
committed
docs(adr): 0014 tool-call resilience stack for non-frontier models
vilaca
committed
docs(adr): 0015 context compaction recency window plus summary fingerprinted in cache
vilaca
committed
docs(adr): 0016 MCP servers wrapped as ToolHandlers in the shared registry
vilaca
committed
docs(adr): 0017 session log as JSONL in ~/.factory/sessions/
vilaca
committed
docs(adr): 0018 hooks with sandboxed env forbidden-command guard and trust prompt
vilaca
committed
docs(adr): 0019 multi-tab session model with one independent agent per tab
vilaca
committed
docs(adr): 0020 manual argv parser without commander or yargs
vilaca
committed
docs(adr): 0021 renderer split Ink TUI vs plain-stdout headless one core loop
vilaca
committed
docs(adr): 0022 subagent isolation with separate conversation and restricted Bash allowlist
vilaca
committed

Commits on May 23, 2026