[ADR] Select runtime, store, queue, migration tooling, and repository layout #12

Activity

1. gnanirahulnutakki

   added this to the M0 — Foundation milestone on Sep 1, 2026
2. gnanirahulnutakki

   added

   priority:p0Critical prerequisite or correctness boundaryCritical prerequisite or correctness boundary

   decision-requiredRequires an explicit architecture or governance decisionRequires an explicit architecture or governance decision

   area:foundationGovernance, architecture, and repository foundationGovernance, architecture, and repository foundation

   on Sep 1, 2026
3. gnanirahulnutakki

   added the

   Task

   issue type on Sep 1, 2026
4. gnanirahulnutakki

   added a parent issue on Sep 1, 2026

   • [Epic] Establish the engineering and governance foundation #2
5. gnanirahulnutakki

   marked this as blocked on Sep 1, 2026

   • [Architecture] Define topology, SLOs, RTO/RPO, scale, retention, and cost envelope #11
6. gnanirahulnutakki

   marked this as blocking 6 issues on Sep 1, 2026

   • [Developer Experience] Create reproducible bootstrap and local quality commands #13
   • [API] Define HTTP and resource evolution conventions #16
   • [Isolation] Enforce workspace isolation in storage, queues, lists, and workers #26
   • [Persistence] Design relational state, migrations, tenant constraints, and outbox #30
   • [Queue] Implement transactional dispatch, leases, deduplication, and fencing #32
   • [Deployment] Publish hardened packaging, capacity controls, and upgrade-safe defaults #65
7. gnanirahulnutakki commented on Sep 1, 2026

   

   gnanirahulnutakki

   on Sep 1, 2026

   MemberAuthor

   More actions

   Completion evidence — 2026-09-01

   ADR 0002 is accepted and merged through PR #69:
   #69

   Acceptance mapping

   • Alternatives: runtime/framework, relational store, queue, migration tooling, and module boundaries are assessed across correctness, recovery, security, performance, operability, and monthly baseline cost. Rejected choices and their assumptions are recorded in ADR 0002.
   • Replaceable interfaces: ADR 0002 defines the StateStore and ReconciliationQueue capability and failure contracts, including atomic accepted-work recording and deliberately weak at-least-once/unordered delivery semantics.
   • Supported pins: Go 1.27.0, PostgreSQL 18.6, pgx 5.10.0, sqlc 1.31.1, and goose 3.27.3 are recorded in the ADR and machine-readable version manifest with primary evidence.
   • Benchmark evidence: the ADR binds qualification to ADR 0001's exact topology, data occupancy, request mix, payload distribution, latency, failure, recovery, queue, and cost assumptions rather than external microbenchmarks.

   Exact merge proof

   • Reviewed head: 5ea22b2
   • Merge commit on live main: 0acbaf5
   • Merge parents: dc3cf67 and 5ea22b2
   • Merge tree and reviewed-head tree: 7fd07c7eec4ac45b0b753dafd41d0148cc3335d8
   • Merge author and committer: Gnani Rahul Nutakki gnani.nutakki@gmail.com
   • GitHub records PR docs(architecture): select alpha implementation stack #69 merged at 2026-09-01T10:52:31Z.
   • origin/main, local main, and the GitHub merge commit all resolve to the same SHA.
   • README.md was checked and updated; the architecture overview links ADR 0002.

   Validation on the merge commit

   • shellcheck docs/architecture/stack-evaluation/verify.sh
   • docs/architecture/stack-evaluation/verify.sh — passed
   • docs/architecture/cost-model/verify.sh — passed
   • Markdown lint passed with only repository-existing MD013 long-table/URL handling excluded
   • git diff --check — passed
   • every external ADR and version-manifest link returned HTTP success on 2026-09-01
   • zero unresolved review threads

   Reviews

   • Codex code review completed cleanly on 5ea22b2.
   • Codex security review completed cleanly on 5ea22b2 with no security issues.
   • The configured CodeRabbit context passed. CodeRabbit declined a substantive retry because its incremental review allowance was rate-limited; it produced no findings. This limit was not represented as a substantive approval.

   Cost boundary

   The selected PostgreSQL plus SQS envelope is USD 355.83/month small and USD 682.13/month target, already included in ADR 0001. The whole profiles remain USD 937.50 and USD 2,627.40, leaving USD 62.50 and USD 22.60 headroom. No recurring service was added.
8. gnanirahulnutakki

   closed this as completedon Sep 1, 2026
9. gnanirahulnutakki

   removed

   decision-requiredRequires an explicit architecture or governance decisionRequires an explicit architecture or governance decision

   on Sep 6, 2026