Decide on the hyperthrive verify-warm-slate git calls #1604

New issue

Closed

opened 2026-11-06 16:53:39 +00:00 by jared · 1 comment

jared commented

2026-11-06 16:53:39 +00:00

Owner

Problem

hyperthrive_dev/scripts/verify-warm-slate.sh runs git branch --show-current and git log --oneline -1 in a one-off bash verification script.

Design: docs/os-git/use-cases-and-domain.md (design) and docs/os-git/call-site-checklist.md (call sites). Settled decisions are in design section 1 (docs/os-git/use-cases-and-domain.md): the gem lives in plugins/os-git with a path: source; git-context and os:worktree merge into os-git; old wrappers go only after all references are updated; design order is use-cases, objects, interfaces; os-context and os-vault become Ruby; ticket tracking stays out of os-git.

Reproduce

n/a: migration of existing call sites; behavior stays the same unless a criterion says otherwise.

Approach

Group A-19. The script is bash and one-off. If plugins/os-git ships an os-git CLI with a branch command and a last-commit command by then, call the CLI. Otherwise mark row G-086 out of scope with the reason "one-off bash script; no Ruby object serves it". Commit in the hyperthrive_dev repository with explicit paths.

Mark every row in the checklist from the Done column as it is replaced. Mark the matching test rows in the same change. Run bin/refresh-plugins after changes to SKILL.md, hooks, or CLIs.

Required work: none beyond the acceptance criteria.

Acceptance criteria

Given the decision, when the checklist is read, then row G-086 is marked replaced or out of scope with the reason.
Given the script is changed, when it runs on the warm-slate branch, then it passes the same checks as before.
Given row G-086, when the ticket closes, then each row is marked - [x] with Replaced by filled in, or marked out of scope with a reason, in docs/os-git/call-site-checklist.md.
Given the touched code, when it is searched for Open3, system(, %x, backticks, and git argv, then no git call remains outside OsGit adapters, except sites marked out of scope with a reason.

Blocking edges

Blocked by the core ticket (#1588).

Origin

Trigger: User request in session 1a5b2630-09c9-46cb-aee4-a5a98e2e7d24 on 2026-11-06: one os-git gem for all local git work in cc-os and the user's projects.
Improvised this session: none
Chain: one-off bash script runs git ← no CLI for branch and last commit ← DESIGN (docs/os-git/call-site-checklist.md group A-19)
Root candidate: none found; searched open issues for git, worktree, octokit, ruby port, python, statusline, reset --hard. Related but not a match: #845, #853, #857, #1527, #1554.
Where: hyperthrive_dev/scripts/verify-warm-slate.sh
Session: 1a5b2630-09c9-46cb-aee4-a5a98e2e7d24
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/1a5b2630-09c9-46cb-aee4-a5a98e2e7d24.jsonl

## Problem `hyperthrive_dev/scripts/verify-warm-slate.sh` runs `git branch --show-current` and `git log --oneline -1` in a one-off bash verification script. Design: `docs/os-git/use-cases-and-domain.md` (design) and `docs/os-git/call-site-checklist.md` (call sites). Settled decisions are in design section 1 (`docs/os-git/use-cases-and-domain.md`): the gem lives in `plugins/os-git` with a `path:` source; `git-context` and `os:worktree` merge into `os-git`; old wrappers go only after all references are updated; design order is use-cases, objects, interfaces; `os-context` and `os-vault` become Ruby; ticket tracking stays out of `os-git`. ## Reproduce n/a: migration of existing call sites; behavior stays the same unless a criterion says otherwise. ## Approach Group A-19. The script is bash and one-off. If `plugins/os-git` ships an `os-git` CLI with a branch command and a last-commit command by then, call the CLI. Otherwise mark row G-086 out of scope with the reason "one-off bash script; no Ruby object serves it". Commit in the `hyperthrive_dev` repository with explicit paths. Mark every row in the checklist from the `Done` column as it is replaced. Mark the matching test rows in the same change. Run `bin/refresh-plugins` after changes to `SKILL.md`, hooks, or CLIs. Required work: none beyond the acceptance criteria. ## Acceptance criteria 1. Given the decision, when the checklist is read, then row G-086 is marked replaced or out of scope with the reason. 2. Given the script is changed, when it runs on the warm-slate branch, then it passes the same checks as before. 3. Given row G-086, when the ticket closes, then each row is marked `- [x]` with `Replaced by` filled in, or marked out of scope with a reason, in `docs/os-git/call-site-checklist.md`. 4. Given the touched code, when it is searched for `Open3`, `system(`, `%x`, backticks, and `git` argv, then no git call remains outside `OsGit` adapters, except sites marked out of scope with a reason. ## Blocking edges Blocked by the core ticket (#1588). ## Origin - Trigger: User request in session 1a5b2630-09c9-46cb-aee4-a5a98e2e7d24 on 2026-11-06: one os-git gem for all local git work in cc-os and the user's projects. - Improvised this session: none - Chain: one-off bash script runs git ← no CLI for branch and last commit ← DESIGN (docs/os-git/call-site-checklist.md group A-19) - Root candidate: none found; searched open issues for git, worktree, octokit, ruby port, python, statusline, reset --hard. Related but not a match: #845, #853, #857, #1527, #1554. - Where: hyperthrive_dev/scripts/verify-warm-slate.sh - Session: 1a5b2630-09c9-46cb-aee4-a5a98e2e7d24 - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/1a5b2630-09c9-46cb-aee4-a5a98e2e7d24.jsonl

jared added the

project/cc-os

filed-by/user

category/investigation

labels

2026-11-06 16:53:39 +00:00

jared referenced this issue

2026-11-06 16:54:49 +00:00

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

jared commented

2026-11-06 23:38:37 +00:00

Author

Owner

Resolution

Done: verify-warm-slate.sh is a one-off bash script that checks one migration; os-git has no branch or last-commit command; G-086 marked out of scope; no code changed.

Evidence: hyperthrive_dev scripts/verify-warm-slate.sh:1,12,30; os-git CLI has commit, commit-apply, repo-init, repo-audit only.

Follow-ups: none

## Resolution **Done:** verify-warm-slate.sh is a one-off bash script that checks one migration; os-git has no branch or last-commit command; G-086 marked out of scope; no code changed. **Evidence:** hyperthrive_dev scripts/verify-warm-slate.sh:1,12,30; os-git CLI has commit, commit-apply, repo-init, repo-audit only. **Follow-ups:** none

jared closed this issue

2026-11-06 23:38:37 +00:00

jared referenced this issue

2026-11-07 07:09:13 +00:00

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

jared referenced this issue from a commit

2026-11-07 07:09:21 +00:00

docs(os-git): mark rows G-085 and G-086 out of scope (#1603, #1604)