Architecture Decision Records
Architecture Decision Records (ADRs) capture the significant technical decisions made while building chartgen. Each one describes the context that forced the decision, the options considered, and the consequences of the choice. The goal is that a contributor arriving six months from now — or the author’s future self — can reconstruct the why, not just the what.
When to write an ADR
Section titled “When to write an ADR”Write an ADR when a decision has long-term consequences and more than one viable option: transport protocols, frameworks, auth models, data-contract shape, persistence layers, a major dependency. Keep them short. Ship the ADR in the same pull request as the code that implements the decision — never after the fact.
chartgen uses MADR 3.0 as the ADR format.
Naming is sequential: NNNN-kebab-title.md. Statuses move through
proposed → accepted → deprecated | superseded by NNNN. ADRs are immutable
once merged; to revisit a decision, write a new ADR that supersedes the old
one and link both ways.
Records
Section titled “Records”| # | Title | Status | Date |
|---|---|---|---|
| 0001 | Record architecture decisions | Accepted | 2026-04-19 |
| 0002 | MCP transport: Streamable HTTP 2025-03-26 | Accepted; amended by 0074 | 2026-04-19 |
| 0003 | Web frontend stack: SolidJS + TanStack Query + Kobalte + Tailwind v4 | Accepted | 2026-04-19 |
| 0004 | Type safety: codegen from MCP schemas + Zod at boundary | Accepted | 2026-04-19 |
| 0005 | Client-side indicator state with localStorage persistence | Accepted | 2026-04-20 |
| 0006 | TradingView visual parity for the web frontend | Accepted | 2026-04-19 |
| 0007 | Complete series serialization: fills, hbars, divlines | Accepted | 2026-04-19 |
| 0008 | End-to-end tests with Playwright + CI integration | Accepted; amended by 0039 and 0057 | 2026-11-04 |
| 0009 | Live tail polling and history paging | Accepted | 2026-11-04 |
| 0010 | Overlay geometry rendering via klinecharts indicator draw callbacks | Accepted | 2026-11-04 |
| 0011 | Watchlist quotes: batched get_quotes, rolling 24 h change for Binance | Accepted; amended by 0076 | 2026-11-04 |
| 0012 | Geometry colors on the wire | Accepted | 2026-11-04 |
| 0013 | Indicator visibility, parameter editing and one instance per indicator | Accepted; superseded in part by 0028 and 0053 | 2026-11-04 |
| 0015 | Named chart layouts | Accepted | 2026-11-04 |
| 0016 | Light theme with a single TypeScript token source | Accepted | 2026-11-04 |
| 0017 | Indicator plot styles | Accepted | 2026-11-05 |
| 0018 | Pine v5 semantics for indicator math | Accepted | 2026-11-05 |
| 0019 | Chart settings: per-theme overrides over the palette | Accepted | 2026-11-05 |
| 0020 | Client-side price alerts | Accepted | 2026-11-05 |
| 0021 | Real-time chart push over the MCP SSE stream | Accepted; amended by 0043, 0044 and 0074 | 2026-11-05 |
| 0022 | Compare symbols | Accepted | 2026-11-05 |
| 0023 | Bar replay: client slice, server recompute of repainting indicators | Accepted | 2026-11-05 |
| 0024 | Starlark as the script runtime for user indicators | Accepted | 2026-11-05 |
| 0025 | Per-user indicator registry and MCP surface | Accepted | 2026-11-05 |
| 0026 | Line and histogram colors on the wire | Accepted | 2026-11-05 |
| 0027 | Serve the web app from the MCP server’s origin | Accepted; amended by 0062 | 2026-11-05 |
| 0028 | Several instances of one indicator | Accepted | 2026-11-05 |
| 0029 | Shareable chart links as query parameters | Accepted | 2026-11-05 |
| 0030 | Chart types klinecharts does not draw | Accepted | 2026-11-05 |
| 0031 | Multiple named watchlists, sections and flags | Accepted | 2026-11-05 |
| 0032 | Indicator-aware warmup | Accepted | 2026-11-05 |
| 0033 | Indicator projection past the last bar | Accepted; superseded in part by 0038 | 2026-11-05 |
| 0034 | Drawing and indicator alerts | Accepted | 2026-11-05 |
| 0035 | Styleable indicator geometry colors | Accepted | 2026-11-05 |
| 0036 | Redirect an unknown OAuth client back to the server’s own web app | Accepted | 2026-11-06 |
| 0037 | Pull-based deploy from the host | Accepted; superseded in part by 0060 | 2026-11-06 |
| 0038 | Custom intervals and session-aware future bars | Accepted | 2026-11-06 |
| 0039 | Compact layout for phones and small tablets | Accepted | 2026-11-06 |
| 0040 | A layout stores the scale mode its compare symbols return to | Accepted | 2026-11-06 |
| 0041 | Script editor in the web app | Accepted | 2026-11-06 |
| 0042 | Alerts that run on the server, with webhooks | Accepted | 2026-11-06 |
| 0043 | Multi-chart grid: per-pane store instances behind an active-chart API | Accepted | 2026-11-06 |
| 0044 | Sign-in through GitHub and Google | Accepted; superseded in part by 0050; amended by 0058 and 0062 and 0063 | 2026-11-06 |
| 0045 | Browser push for server alerts | Accepted | 2026-11-06 |
| 0046 | Pattern detection: candlesticks, chart patterns, auto fib | Accepted; amended by 0055 | 2026-11-06 |
| 0047 | Price-based charts: Renko, Kagi, Point & Figure, Line Break, Range | Accepted | 2026-11-06 |
| 0048 | Order flow from lower-timeframe bars: footprints, TPO, volume profiles | Accepted | 2026-11-06 |
| 0049 | One Binance kline read per symbol and interval | Accepted | 2026-11-06 |
| 0050 | A signed-in user’s workspace, on any device | Accepted; amended by 0063 | 2026-11-07 |
| 0051 | What one connection may cost | Accepted | 2026-11-07 |
| 0052 | What an indicator costs | Accepted | 2026-11-07 |
| 0053 | A hidden indicator stays in the status line | Accepted | 2026-11-08 |
| 0054 | An agent draws with the web app’s tools | Accepted | 2026-11-08 |
| 0055 | Provisional swing ends in zigzag and auto fib | Accepted | 2026-11-09 |
| 0056 | A png or summary reads its indicators’ warmup | Accepted | 2026-11-09 |
| 0057 | The e2e suite runs in duration-balanced CI shards | Accepted | 2026-11-09 |
| 0058 | Refresh tokens, so a client authorized once keeps working | Accepted | 2026-11-11 |
| 0059 | A setup is a stored record, scored on paper by the server | Accepted; amended by 0066, 0068, 0070, 0071 and 0072 | 2026-11-11 |
| 0060 | The production image is built in CI and pulled by the host | Accepted; superseded in part by 0075 | 2026-11-11 |
| 0061 | An alert can wake the owner’s agent | Accepted; amended by 0067 and 0072 | 2026-11-11 |
| 0062 | Other origins get an answer on the MCP and OAuth client routes only, and the app is not framed | Accepted | 2026-11-11 |
| 0063 | A read-only operator page, for a signed-in operator in the web app only | Accepted | 2026-11-11 |
| 0064 | A setup states what it was made with, once, and the record is read back as counts | Proposed; amended by 0077 | 2026-11-11 |
| 0066 | Fixed shadow exit variants on every filled setup | Accepted | 2026-11-12 |
| 0067 | Server alerts on an indicator’s line, at bar closes | Accepted | 2026-11-12 |
| 0068 | Replay over real Binance history | Accepted (phase 1); phases 2 and 3 proposed | 2026-11-12 |
| 0069 | An alert at a bar’s close | Accepted | 2026-11-13 |
| 0070 | Setups on US stocks, scored on Yahoo’s 1m bars | Accepted | 2026-11-14 |
| 0071 | A Setups panel in the web app | Accepted | 2026-11-14 |
| 0072 | A wake-up carries the market around it, and a take near its stop wakes the agent | Accepted; amended by 0073 | 2026-11-14 |
| 0073 | A symbol that is not trading has no market context | Accepted | 2026-11-14 |
| 0074 | After a restart, a client hears that the tools may have changed | Accepted | 2026-11-15 |
| 0075 | The autodeploy follows a deployment until the platform finished it | Accepted | 2026-11-15 |
| 0076 | get_quotes marks a quote that is not trading as stale | Accepted | 2026-11-15 |
| 0077 | A setup records the market context it was made in | Accepted | 2026-11-15 |