feat(ticket): entire ticket — link external tickets to branches, checkpoints & reviews

[Mohit-Katyal]

Overview

entire ticket links an external tracker ticket (Linear today, Jira-ready) to a branch and session, so work stays grounded in its original intent — and freezes that ticket into checkpoint provenance so the checkpoint chain becomes the ticket's timeline, surfaced across status, session info, explain, and review.

The command group is platform-agnostic: every tracker implements one Provider interface and registers with a single switch case, so adding Jira later never touches the command surface.

What's in it

• Commands: entire ticket setup (store platform + team + API token in the OS keychain), link / unlink, start (ticket → new branch + grounding prompt), status (live title/state + drift since last sync), revoke-token.
• Provider: a Linear implementation (GraphQL) behind the shared Provider seam.
• Provenance: at condensation the branch's linked ticket (id + snapshot) is frozen into per-session checkpoint metadata on entire/checkpoints/v1 — best-effort and offline, so a checkpoint is never blocked by ticket state.
• Read surfaces: the linked/frozen ticket is rendered in entire status, session info, checkpoint explain, and prepended to the reviewer's context in entire review (grounding the review against the original intent).
• Docs: a user-facing command reference plus the tech spec.

How to review — this is a 14-part stack

I don't have push access to entireio/cli, so the stacked branches can't live here; this is the whole feature as one PR (14 clean commits, each an additive slice). It's split into 14 stacked PRs on my fork for per-slice review — same commits, reviewable one at a time:

• [use github runners #1] feat(ticket): base entire ticket command group [1/14] — feat(ticket): base entire ticket command group [1/14] Mohit-Katyal/cli#1
• [Move "clean" root command to "session cleanup", some refactoring #2] feat(ticket): entire ticket setup [2/14] — feat(ticket): entire ticket setup [2/14] Mohit-Katyal/cli#2
• [add .entire/logs to .entire/.gitignore, small refactor #3] feat(ticket): entire ticket link and unlink [3/14] — feat(ticket): entire ticket link and unlink [3/14] Mohit-Katyal/cli#3
• [Remove start command #4] feat(ticket): entire ticket start — scaffold + branch creation [4/14] — feat(ticket): entire ticket start — scaffold + branch creation [4/14] Mohit-Katyal/cli#4
• [use strings.Contains #5] feat(ticket): entire ticket status with snapshot drift [5/14] — feat(ticket): entire ticket status with snapshot drift [5/14] Mohit-Katyal/cli#5
• [Improved entire enable messaging #6] feat(ticket): entire ticket revoke-token [6/14] — feat(ticket): entire ticket revoke-token [6/14] Mohit-Katyal/cli#6
• [add macos signing #7] feat(ticket): Linear provider — additive leaf [7/14] — feat(ticket): Linear provider — additive leaf [7/14] Mohit-Katyal/cli#7
• [Test Harness and "entire enable --agent" bug fix #9] feat(ticket): capture linked ticket into checkpoint provenance [8/14] — feat(ticket): capture linked ticket into checkpoint provenance [8/14] Mohit-Katyal/cli#9
• [Increase timeout, add a single retry #10] feat(ticket): ticket-display helpers for CLI surfaces [9/14] — feat(ticket): ticket-display helpers for CLI surfaces [9/14] Mohit-Katyal/cli#10
• [Add MIT License #11] feat(ticket): surface captured ticket in checkpoint explain [10/14] — feat(ticket): surface captured ticket in checkpoint explain [10/14] Mohit-Katyal/cli#11
• [there is no such thing as a retry for go-releaser #12] feat(ticket): surface linked ticket in entire status [11/14] — feat(ticket): surface linked ticket in entire status [11/14] Mohit-Katyal/cli#12
• [Soph/improve session list #13] feat(ticket): surface linked ticket in session info [12/14] — feat(ticket): surface linked ticket in session info [12/14] Mohit-Katyal/cli#13
• [remove timeout from goreleaser #14] feat(ticket): ground review context in linked ticket [13/14] — feat(ticket): ground review context in linked ticket [13/14] Mohit-Katyal/cli#14
• [fixed a bug with the test-repo skill that created an invalid session file #16] docs(ticket): concise entire ticket command reference [14/14] — docs(ticket): concise entire ticket command reference [14/14] Mohit-Katyal/cli#16

Each commit here maps 1:1 to a fork PR. Happy to push the branches as a real stack if a maintainer would rather review/merge that way (or grant access).

Testing

• go build ./... clean; mise run lint 0 issues.
• ticket, cli, and strategy unit suites pass; integration TestShadow_TicketProvenance proves the ticket lands in committed checkpoint metadata end-to-end.
• Rebased cleanly onto current main and re-verified.

Scope / notes

• Agent launch from start is deferred (prints the grounding prompt; launcher stays wired via Deps.LaunchFix).
• The credential is stored only in the OS keychain, never in settings; revoke-token is local-only (Linear keys are revoked in Linear).

🤖 Generated with Claude Code