docs: ADR 0036 (sign-up trial) and ADR 0037 (reconciler work queue) #52

Sammanfogat

supernaut sammanfogade 3 incheckningar från feat/adr-0036-0037-trial-and-queue in i main

2026-07-28 16:05:02 +00:00

supernaut kommenterad

2026-07-28 12:22:14 +00:00

Ägare

What

Two architecture decision records.

ADR 0036 — Sign-up trial and downgrade. Records the mechanism for the time-boxed, opt-in trial
that grants paid-equivalent capabilities and downgrades to a participant account at end of August:
a dedicated tier_trial group nested into the paid entitlement groups, projected by the
reconciler, with an operator-gated batch downgrade and a TRIAL_OPEN kill switch. Epic
bitborg-docs#51; implemented by bitborg-web#92/#93 and bitborg-infra#232.
ADR 0037 — Reconciler event-driven work queue. Proposes evolving the reconciler from a
oneshot full-sweep into a rate-limited, de-duplicating work queue fed by writer-enqueue + a
Forgejo repository webhook, with a periodic resync backstop — revising ADR 0035's oneshot
trigger model (projection rules unchanged). Design only; grounded in the finding that Kanidm
cannot push change events. Records the cheaper debounce-plus-diff-skip alternative too.

Notes

Both are mechanism-only (no pricing/business rationale), citing public issue numbers only.
ADR 0037 is Proposed and has no implementing issue yet.

## What Two architecture decision records. - **ADR 0036 — Sign-up trial and downgrade.** Records the mechanism for the time-boxed, opt-in trial that grants paid-equivalent capabilities and downgrades to a participant account at end of August: a dedicated `tier_trial` group nested into the paid entitlement groups, projected by the reconciler, with an operator-gated batch downgrade and a `TRIAL_OPEN` kill switch. Epic bitborg-docs#51; implemented by bitborg-web#92/#93 and bitborg-infra#232. - **ADR 0037 — Reconciler event-driven work queue.** Proposes evolving the reconciler from a oneshot full-sweep into a rate-limited, de-duplicating work queue fed by writer-enqueue + a Forgejo `repository` webhook, with a periodic resync backstop — revising ADR 0035's oneshot trigger model (projection rules unchanged). Design only; grounded in the finding that Kanidm cannot push change events. Records the cheaper debounce-plus-diff-skip alternative too. ## Notes Both are mechanism-only (no pricing/business rationale), citing public issue numbers only. ADR 0037 is `Proposed` and has no implementing issue yet.

supernaut lade till 1 incheckning

2026-07-28 12:22:14 +00:00

docs: add ADR 0036 (sign-up trial) and ADR 0037 (reconciler work queue)

ci / ci (pull_request) Failing after 11s

Detaljer

36cb321db1

ADR 0036 records the time-boxed trial + end-of-August downgrade mechanism
(epic gitborg-docs#51). ADR 0037 proposes evolving the reconciler into an
event-driven, rate-limited work queue, revising ADR 0035's oneshot trigger
model (design only).

supernaut lade till etiketterna

area/identity

type

docs

2026-07-28 12:22:40 +00:00

supernaut lade till 2 incheckningar

2026-07-28 16:04:02 +00:00

chore: update pnpm-lock.yaml b725d6287e

style: apply linting

ci / ci (pull_request) Successful in 12s

Detaljer

f025befdb4