Skip to content

gm jarvis: issue-centric workflow, Project View, and caching#49172

Draft
georgekarrv wants to merge 2 commits into
mainfrom
gkarr-jarvis
Draft

gm jarvis: issue-centric workflow, Project View, and caching#49172
georgekarrv wants to merge 2 commits into
mainfrom
gkarr-jarvis

Conversation

@georgekarrv

@georgekarrv georgekarrv commented Jul 10, 2026

Copy link
Copy Markdown
Member

Overview

gm jarvis is a personal, interactive TUI (under tools/github-manage/) that aggregates your GitHub work into leverage-ordered buckets. This PR grows it from a read-only inbox into a per-issue development-lifecycle driver.

Personal dev tool — all changes are scoped to tools/github-manage/. Draft while I dogfood it.

What's new

  • Issue-centric overlay — a WorkItem ties together an issue, its project Status, the linked PR, the local branch/clone, and the Claude session driving it, with a next-action state machine.
  • Start Work (w) — branch off main in a chosen local clone (auto-discovered under configurable base dirs), launch a Claude session, and set the issue's project Status to In progress.
  • Focus view (f) — a pinned, card-style view (manual pin with auto-suggest) showing each item's status, PR, session, and next step.
  • Status transitionsv → Ready for review, a → Awaiting QA; merging advances the linked issue to Awaiting QA; M merges then hands off to a Claude cherry-pick session.
  • Project View — with primary_projects set in ~/.config/gm/jarvis/config.json, the top section groups by board: a selectable project row (b opens it) plus your assigned issues (excluding Done / Ready for release) and a count of unassigned issues in Ready.
  • Caching & refresh — opens instantly from a 4h on-disk cache (--no-cache to bypass); r full refresh, R refresh just the highlighted item; g/G jump to top/bottom.
  • Auto-clear finished work — merged PRs / closed issues are marked done, including dropping stale merged/closed notification items via batched state lookups.

Testing

Unit tests cover the state machine, caching round-trip, status/name normalization, project resolution, and linkage. Build + go test ./pkg/jarvis/... green; logic validated against live boards.

Example

image

Extends the jarvis dashboard from a read-only leverage inbox into a
per-issue development-lifecycle driver:

- WorkItem overlay aggregating issue + project Status + linked PR +
  branch/clone + Claude session, with a next-action state machine
- Start Work (w): branch off main in a chosen local clone, launch a
  Claude session, set project Status to In progress; multi-clone
  discovery under configurable base dirs
- Focus view (f) with manual pin + auto-suggest; status transitions
  (v Ready-for-review, a Awaiting QA), merge advances to Awaiting QA,
  and merge+cherry-pick (M) hands off to a cherry-pick session
- Project View top section (primary_projects): per-board group with a
  selectable header (b opens the board), your assigned issues excluding
  Done/Ready-for-release, and a count of unassigned issues in Ready
- Local 4h cache (--no-cache to bypass); full (r) and per-item (R)
  refresh; g/G jump to top/bottom
- Auto-mark done when a PR merges / issue closes, incl. dropping
  stale merged/closed notification items via batched state lookups

Personal tool; all changes scoped to tools/github-manage.
@codecov

codecov Bot commented Jul 10, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 67.80%. Comparing base (3c6b05f) to head (94810a4).
⚠️ Report is 984 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #49172      +/-   ##
==========================================
+ Coverage   67.02%   67.80%   +0.77%     
==========================================
  Files        2862     2937      +75     
  Lines      224838   235282   +10444     
  Branches    11633    11633              
==========================================
+ Hits       150704   159533    +8829     
- Misses      60481    60989     +508     
- Partials    13653    14760    +1107     
Flag Coverage Δ
backend 69.56% <ø> (+0.82%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant