From ea158530467e4c3c8be793926ae092004385ffda Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 3 Aug 2026 18:51:39 +0200 Subject: [PATCH] Add ISSUE-WP-0006: Forgejo-only projection boundary, not ops queue. Align issue-core with ACT-ADR-005: external tracker facade only; retire Gitea as a product target; keep automation claim out of issue-core. --- ...P-0006-forgejo-only-projection-boundary.md | 125 ++++++++++++++++++ 1 file changed, 125 insertions(+) create mode 100644 workplans/ISSUE-WP-0006-forgejo-only-projection-boundary.md diff --git a/workplans/ISSUE-WP-0006-forgejo-only-projection-boundary.md b/workplans/ISSUE-WP-0006-forgejo-only-projection-boundary.md new file mode 100644 index 0000000..7378f7d --- /dev/null +++ b/workplans/ISSUE-WP-0006-forgejo-only-projection-boundary.md @@ -0,0 +1,125 @@ +--- +id: ISSUE-WP-0006 +type: workplan +title: "Forgejo-only forge + projection boundary (not ops queue)" +domain: infotech +repo: issue-core +status: ready +owner: grok +topic_slug: issue-core +priority: medium +created: "2026-08-03" +updated: "2026-08-03" +depends_on: [] +related: + - ACT-ADR-005 + - ACTIVITY-WP-0022 + - ISSUE-WP-0004 + - ISSUE-WP-0005 +--- + +# ISSUE-WP-0006 — Forgejo-only projection boundary + +## Origin + +ACT-ADR-005 and founder direction (2026-08-03): + +1. **Gitea is no longer relevant** — self-hosted forge is **Forgejo** only. +2. issue-core must not be used as the **ops claim queue** for activity-core. +3. issue-core remains the **multi-tracker facade** (project/link external issues). + +## Goal + +Align code, docs, and env names so operators and agents never plan on Gitea, +and so rein-aharness stops treating issue-core as the primary automation queue +(handoff language to ops_run in ACTIVITY-WP-0026 / REIN-A-0002). + +## Tasks + +### T01 — Terminology sweep: Gitea → Forgejo (product language) + +```task +id: ISSUE-WP-0006-T01 +status: todo +priority: high +``` + +Sweep INTENT, SCOPE, README, ROADMAP, workplans, comments: + +- Prefer **Forgejo** for the self-hosted forge product. +- Where code talks to the Forgejo HTTP API that is Gitea-compatible, say + **“Forgejo (Gitea-compatible API)”** once — do not present Gitea as a + supported second product or migration target. +- Rename operator-facing env docs that say `GITEA_*` for forge access to + `FORGEJO_*` **or** document aliases: `FORGEJO_TOKEN` preferred; + legacy `GITEA_*` only as deprecated alias if code still requires it. + +**Done when:** `rg -i gitea` in docs is zero for “we use Gitea”, or only +compatibility notes remain. + +--- + +### T02 — INTENT/SCOPE: ops queue non-goal + +```task +id: ISSUE-WP-0006-T02 +status: todo +priority: high +``` + +Explicit section: + +- Internal scheduled automation claim/execute → **activity-core ops_run** + (ACT-ADR-005). +- issue-core does **not** provide the fleet ops claim queue. +- `POST /issues/` = external tracker create/link only. +- Default activity-core sink remains state-hub progress + ops_run; **not** rest + to issue-core for Binky/FI. + +**Done when:** INTENT/SCOPE quote ACT-ADR-005; no contradiction with “poll us for automation.” + +--- + +### T03 — Connector docs: projection path only + +```task +id: ISSUE-WP-0006-T03 +status: todo +priority: medium +``` + +Update AGENT_INTEGRATION / connector docs: + +1. Author work record in repo → hub index. +2. Optional: project/link via issue-core to **Forgejo** (or GitHub/Jira later). +3. Mapping UUID ↔ `(backend=forgejo, external_id)`. + +**Done when:** happy path diagram has no “activity-core → issue-core → harness” +as the primary automation loop. + +--- + +### T04 — Coordinate rein-aharness intake docs + +```task +id: ISSUE-WP-0006-T04 +status: todo +priority: low +``` + +Message or PR note for REIN-A-0002-T06: issue-core poll = legacy/external only. +No code change required in issue-core if rein owns the doc cut. + +**Done when:** cross-link in ISSUE-WP-0006 and REIN-A-0002. + +## Acceptance + +- [ ] No Gitea-as-product planning +- [ ] Projection boundary clear +- [ ] Ops claim queue explicitly out of scope for issue-core + +## Out of scope + +- Implementing ops_run (ACTIVITY-WP-0026) +- Fixing Forgejo PAT for rest sink (only if projection needs it later) +- GitHub/Jira connectors