From afbf0e0950a70127c7fdefc5673d33ccee1e88d8 Mon Sep 17 00:00:00 2001 From: mintaka Date: Thu, 27 Aug 2026 23:23:25 -0400 Subject: [PATCH] docs(forge): supersede poll-driver record for board webhook cutover (RIG-2883) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mark the SEA-1810 forge-poll driver design record `Superseded by` the board webhook-ingestion record (DL-281), the T6 docs delta of the poll→webhooks cutover. The record's status header flips `Active` → `Superseded by ../compass-forge-board-webhook-ingestion/design.md` (the house format, per `compass-tauri-shell.md`), with a superseded callout noting DL-161's board-poll retirement, DL-162's `forge_repo_subscriptions` + `--forge-repos` seed survival, DL-163's now-writer-less `forge_list_cursors`, and the removed `--forge-poll` / `--forge-poll-interval` flags and `$COMPASS_FORGE_POLL(_INTERVAL)` env vars. The App-setup runbook and operator flag/env prose docs the T6 brief also names have no on-disk target: the GitHub App runbook is shipped by the agent-notification T7 (not yet landed), and the poll flag/env strings live only in `main.go` `-help` text and frozen design records — both out of scope for a docs-only slice. No `DECISIONS.md` edit (DL-281 landed in #695). markdownlint-cli2: 0 errors on the changed file. Refs RIG-2883 Co-authored-by: Matt Wilkinson --- .../product/compass-forge-poll-driver/design.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/designs/product/compass-forge-poll-driver/design.md b/docs/designs/product/compass-forge-poll-driver/design.md index 5c911bb9c..8e0f6f964 100644 --- a/docs/designs/product/compass-forge-poll-driver/design.md +++ b/docs/designs/product/compass-forge-poll-driver/design.md @@ -1,9 +1,20 @@ # Compass forge-poll driver (SEA-1810) -Status: Active +Status: Superseded by ../compass-forge-board-webhook-ingestion/design.md Lane: compass-server Tracker: SEA +> **Superseded** by the board webhook-ingestion record +> ([`../compass-forge-board-webhook-ingestion/design.md`](../compass-forge-board-webhook-ingestion/design.md), +> DL-281 in [`../../DECISIONS.md`](../../DECISIONS.md)): board issue ingestion is +> now webhook-driven, not polled. This record's board-ingestion poll driver +> (DL-161) is retired; DL-162's `forge_repo_subscriptions` target table and the +> `--forge-repos` seed survive verbatim as the webhook lane's subscribed-repo +> set, and `forge_list_cursors` (DL-163) loses its only writer. The +> `--forge-poll` / `--forge-poll-interval` flags and the +> `$COMPASS_FORGE_POLL` / `$COMPASS_FORGE_POLL_INTERVAL` environment variables +> are removed. Read the superseding record for the current design. + OQ-A is RESOLVED — Matt ruled **Option 2** (2026-08-07): this driver is built ON the DL-053 forge-subscription machinery from day one, with the board as a distinguished subscriber. OQ-C and OQ-D are RESOLVED (Matt, 2026-08-08): the