Skip to content

docs: architecture decision records (ADR-0001..0004)#8

Merged
sepehr-safari merged 1 commit into
mainfrom
docs/adr
Jul 11, 2026
Merged

docs: architecture decision records (ADR-0001..0004)#8
sepehr-safari merged 1 commit into
mainfrom
docs/adr

Conversation

@sepehr-safari

Copy link
Copy Markdown
Member

Summary

Captures the foundational architecture decisions as ADRs, in Status → Context → Decision → Consequences form. This is the last S0 issue; it also satisfies the docs/adr/0001-independent-implementation.md link introduced by the docs PR (#7).

ADRs

  • 0001 — Independent implementation with a shared conformance contract. Zero shared code with the toolkit; the two meet only at a versioned fixture + golden contract, enforced in CI.
  • 0002 — macOS-first, Linux in CI, Windows post-1.0. The platform strategy and the asymmetric CI split.
  • 0003 — Native-rendered UI, no WebView. Commit to .native markup + Zig; WebView shell explicitly rejected.
  • 0004 — Zig + Native SDK on the zero-config build. Toolchain choice; stay on the CLI-owned build until a concrete need (likely TLS for live capture) forces ejection.

Plus docs/adr/README.md as the index.

Notes

  • Index links and README/AGENTS forward-links all resolve (verified).
  • No AI-tool references or emails.

Closes #4

Captures the foundational decisions in Status/Context/Decision/Consequences
form: independent implementation with a shared conformance contract (0001),
macOS-first platform strategy (0002), native-rendered UI with no WebView
(0003), and Zig on the Native SDK zero-config build (0004). Adds the ADR
index. This satisfies the README/AGENTS links introduced in #7.

Closes #4
@sepehr-safari sepehr-safari merged commit 69cc7e5 into main Jul 11, 2026
3 checks passed
@sepehr-safari sepehr-safari deleted the docs/adr branch July 11, 2026 02:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: architecture decision records (ADR-0001..0004)

1 participant