Move forgejo-api to the ADR-0310 path source in os-backlog and os-sdlc #1648

New issue

Open

opened 2026-11-09 17:34:37 +00:00 by jared · 0 comments

jared commented

2026-11-09 17:34:37 +00:00

Owner

Problem

plugins/os-backlog/Gemfile and plugins/os-sdlc/Gemfile declare forgejo-api with a Bundler git: source (ssh://git@forgejo.swansoncloud.com:2222/jared/forgejo-api.git). Each lock pins a revision. Each forgejo-api commit therefore forces a lock change in both plugins. ADR-0310 (2026-11-09) says that each gem we own uses path: to the machine's ~/dev checkout with no pin. ADR-0310 names forgejo-api as the one gem that still uses a git source until this ticket.

Reproduce

n/a: design change; the defect is the pinned revision in both locks.

Approach

Find the forgejo-api checkout under ~/dev on this machine. Declare the gem in both Gemfiles in the ADR-0310 form: path: File.expand_path("dev/<repo path>", Etc.getpwuid.dir). Update both locks. Edit plugins/os-sdlc/Gemfile and its lock only when the mutation track (#1645) has finished its run or agrees.

Required work:

Declare forgejo-api by path in os-backlog — check: absent forgejo-api.git in plugins/os-backlog/Gemfile
Declare forgejo-api by path in os-sdlc — check: absent forgejo-api.git in plugins/os-sdlc/Gemfile

Acceptance criteria

Given a commit to the forgejo-api checkout, when os-backlog and os-sdlc boot, then each loads the new code and no Gemfile.lock changes.
Given a machine without the forgejo-api checkout, when bin/refresh-plugins runs, then it names the missing checkout and the clone command.
Given the Gemfiles under plugins/, when they are searched, then no Gemfile has a git: source for a gem we own.

Origin

Trigger: #1630 Approach, "Not in this ticket: moving forgejo-api off its git source. File it as a follow-up with the ADR"; ADR-0310 landed in main 4b8f679c
Improvised this session: none
Chain: lock change on each forgejo-api commit ← Bundler git: source pins a revision ← DESIGN (ADR-0257 item 2, removed by the ADR-0310 amend in 4b8f679c)
Root candidate: none found; searched forgejo-api, Gemfile, git source, path source, Gemfile.lock pin
Where: plugins/os-backlog/Gemfile, plugins/os-sdlc/Gemfile
Session: bbe5ea91-45fa-45a0-8831-c49254f48da6
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/bbe5ea91-45fa-45a0-8831-c49254f48da6.jsonl

Parent: #1610. Follows #1630.

VERDICT: CREATE

## Problem `plugins/os-backlog/Gemfile` and `plugins/os-sdlc/Gemfile` declare `forgejo-api` with a Bundler `git:` source (`ssh://git@forgejo.swansoncloud.com:2222/jared/forgejo-api.git`). Each lock pins a revision. Each `forgejo-api` commit therefore forces a lock change in both plugins. ADR-0310 (2026-11-09) says that each gem we own uses `path:` to the machine's `~/dev` checkout with no pin. ADR-0310 names `forgejo-api` as the one gem that still uses a git source until this ticket. ## Reproduce n/a: design change; the defect is the pinned revision in both locks. ## Approach Find the `forgejo-api` checkout under `~/dev` on this machine. Declare the gem in both Gemfiles in the ADR-0310 form: `path: File.expand_path("dev/<repo path>", Etc.getpwuid.dir)`. Update both locks. Edit `plugins/os-sdlc/Gemfile` and its lock only when the mutation track (#1645) has finished its run or agrees. Required work: 1. Declare `forgejo-api` by path in os-backlog — check: absent `forgejo-api.git` in `plugins/os-backlog/Gemfile` 2. Declare `forgejo-api` by path in os-sdlc — check: absent `forgejo-api.git` in `plugins/os-sdlc/Gemfile` ## Acceptance criteria 1. Given a commit to the `forgejo-api` checkout, when os-backlog and os-sdlc boot, then each loads the new code and no `Gemfile.lock` changes. 2. Given a machine without the `forgejo-api` checkout, when `bin/refresh-plugins` runs, then it names the missing checkout and the clone command. 3. Given the Gemfiles under `plugins/`, when they are searched, then no Gemfile has a `git:` source for a gem we own. ## Origin - Trigger: #1630 Approach, "Not in this ticket: moving `forgejo-api` off its git source. File it as a follow-up with the ADR"; ADR-0310 landed in main 4b8f679c - Improvised this session: none - Chain: lock change on each forgejo-api commit ← Bundler `git:` source pins a revision ← DESIGN (ADR-0257 item 2, removed by the ADR-0310 amend in 4b8f679c) - Root candidate: none found; searched forgejo-api, Gemfile, git source, path source, Gemfile.lock pin - Where: `plugins/os-backlog/Gemfile`, `plugins/os-sdlc/Gemfile` - Session: bbe5ea91-45fa-45a0-8831-c49254f48da6 - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/bbe5ea91-45fa-45a0-8831-c49254f48da6.jsonl Parent: #1610. Follows #1630. VERDICT: CREATE

jared added the

plugin/os-backlog

filed-by/user

category/code-change

labels

2026-11-09 17:34:37 +00:00

jared referenced this issue

2026-11-09 17:40:32 +00:00

One gem source rule: path to the ~/dev checkout, no pin, no symlink (os_git first) #1630

jared referenced this issue

2026-11-09 17:40:43 +00:00

Build os-git end to end (orchestrator) #1610