rt mission: GitHub-Desktop-parity mission control TUI

commands/mission.ts

@@ -0,0 +1,69 @@
+/**
+ * rt mission: repos, changes, diff, and commit in one board. The command is the
+ * gate and the wiring; the loop and state machine live in lib/mission/driver.ts
+ * and the view paints in the bundled Go rt-ui helper.
+ */
+import type { CommandContext } from "../lib/command-tree.ts";
+import { MissionDriver, type MissionDeps } from "../lib/mission/driver.ts";
+import { runAction } from "../lib/mission/git-actions.ts";
+import { interactive } from "../lib/ui/gate.ts";
+import { exit, openSession } from "../lib/ui/spawn.ts";
+import { SessionDied } from "../lib/runner/runner.ts";
+import { createGitClient } from "../packages/git-core/src/index.ts";
+import { daemonQuery, subscribeToDaemon } from "../lib/daemon-client.ts";
+import { checkBranchGuard } from "../lib/branch-guard.ts";
+import { commitStaged, amendStaged, stagePath, unstagePath } from "../lib/commit-ops.ts";
+
+export async function missionCommand(_args: string[], ctx: CommandContext): Promise<void> {
+  if (!interactive()) {
+    process.stderr.write("rt mission needs an interactive terminal (it drives a live board from the one you are in)\n");
+    return exit(1);
+  }
+
+  if (!ctx.identity) {
+    process.stderr.write("not in a registered repo\n");
+    return exit(1);
+  }
+  const currentRepo = ctx.identity;
+  const currentWorktree = currentRepo.repoRoot;
+
+  const deps: MissionDeps = {
+    openSession,
+    client: (dir: string) => createGitClient(dir),
+    daemonQuery,
+    subscribe: subscribeToDaemon,
+    runAction,
+    commit: commitStaged,
+    amend: amendStaged,
+    guard: checkBranchGuard,
+    now: () => new Date(),
+    stageFile: stagePath,
+    unstageFile: unstagePath,
+  };
+
+  const driver = new MissionDriver(deps, {
+    repo: currentRepo.identity,
+    worktree: currentWorktree,
+  });
+
+  const onSignal = () => {
+    process.exit(130);
+  };
+  process.once("SIGINT", onSignal);
+  process.once("SIGTERM", onSignal);
+  process.once("SIGHUP", onSignal);
+
+  try {
+    await driver.run();
+  } catch (err) {
+    if (err instanceof SessionDied) {
+      process.stderr.write(`\n  ${err.message}; the workspace was closed\n\n`);
+      return exit(1);
+    }
+    throw err;
+  } finally {
+    process.off("SIGINT", onSignal);
+    process.off("SIGTERM", onSignal);
+    process.off("SIGHUP", onSignal);
+  }
+}

docs/design/mission/README.md

@@ -0,0 +1,90 @@
+# Mission-control design boards: the parity reference
+
+These boards (PNG exports plus `mission.pen`, the editable pencil source) are
+the signed-off visual contract for the rt mission-control session view
+(2026-09-18). They are the standard the built TUI is scrutinized against:
+reviews compare real terminal captures against these boards, surface by
+surface, and deviations are either fixed in the TUI or ratified by updating
+the board in the same change.
+
+The design mirrors GitHub Desktop, verified against its source at the local
+clone (app/src/ui: toolbar push-pull-button state machine, changes sidebar,
+commit area, diff view, repository and branch foldouts), rendered in rt-ui's
+own dialect: every color is a theme.go token role (never inline), picker row
+and modal conventions carry over unchanged (HoverBg hover distinct from
+SelBg cursor rows, Surface + Panel modal lift over a dimmed parent, no
+shadows, no radii).
+
+## Boards
+
+- `Main.png`: the full view. Top bar (repo / worktree / branch segments plus
+  the adaptive action segment), changes pane, diff pane, commit box, keybar.
+  The repository segment and the changes sidebar share one locked width; the
+  divider runs unbroken through bar and body, and is not draggable.
+- `ActionStates.png`: the adaptive action segment's complete state machine,
+  matching GitHub Desktop's exactly: Fetch, Pull (a diverged repo shows both
+  counts on the one Pull button; there is no combined pull-then-push state),
+  Push, Publish branch, Publish repository, Force push (recommended after
+  amend or rebase), in-progress. Wording rules: "Last fetched Xm ago" or
+  "Never fetched"; "Pull origin with rebase" when pull.rebase is set.
+- `RepoPicker.png`: the repository foldout as an rt picker: grouped by host
+  and owner, fuzzy filter, badges per worktree (dirty count, ahead, behind,
+  clean check).
+- `InteractionStates.png`: rest / hover / cursor / action-row treatments for
+  rows, segments, buttons, and the diff gutter's rest / hover-preview /
+  staged ladder.
+- `BranchModal.png`: the branch foldout in context over the dimmed parent,
+  with current-branch marker, ahead/behind pills, guarded rows (branches
+  checked out in another worktree refuse checkout), section grouping, and a
+  new-branch action row.
+- `WorktreeModal.png`: the worktree foldout (no GitHub Desktop analog): the
+  current worktree, per-tree badges, on-deck pool rows, provision action.
+- `Mouse.png`: every mouse affordance by zone; hover always previews.
+- `DiffStates.png`: expand up / down / all handles, binary and oversized
+  messages.
+
+## Ratified deviations from GitHub Desktop
+
+- `@@` hunk headers stay visible (terminal-native); the header row itself is
+  the hunk stage toggle. GitHub Desktop hides hunk text behind expand
+  handles and a hunk-handle gutter.
+- Guarded checkout replaces the stash-and-switch dialog: rt's worktree model
+  refuses checkout of a branch owned by another worktree instead of offering
+  to move changes.
+- Repository rows carry numeric badges where GitHub Desktop shows a dot plus
+  bare arrows.
+- A worktree segment and foldout exist; GitHub Desktop has no worktree
+  surface.
+- The History tab is deferred; the tab renders dimmed.
+
+## Terminal-fidelity deltas (same set the picker ratified)
+
+No drop shadows (modal lift = Surface token + Panel border + parent dim),
+rounded corners only as box-drawing glyphs, 1-cell scrollbar thumb, fixed
+cell line-height. Everything else on the boards is the contract: exact
+tokens, glyphs, spacing rhythm, keybar grammar, and every interaction state.
+
+## Ratified at the build's visual pass (2026-09-18)
+
+Deviations the terminal build keeps deliberately; the boards show the
+pre-ratification drawing:
+
+- Top-bar segment icons sit on the value row (a glyph cell before the
+  value) instead of the boards' icon centered across both rows; the state
+  glyph family is the circle set (◉ current, ○ unchecked, ◪ mixed) rather
+  than the boards' squares, matching rt's picker language. The master row
+  uses the same ◪ for its mixed state.
+- The undo strip is one line ("Committed <when> · <summary>" clipped to the
+  sidebar, Undo chip right) instead of the boards' two-line strip.
+- The main keybar lists the built action set (adds "enter diff" and
+  "u undo", names the adaptive segment key "f action", omits "? help").
+- The commit button renders the disabled treatment whenever the wire says
+  it cannot commit (empty summary); the boards draw the enabled pink for
+  visual reference.
+- The diff gutter's hover-preview bar is the exact 0.5 Pink-to-Bg blend
+  (#8A3E60) via theme.GutterHoverBar; the boards' #8A4560 was hand-picked.
+- Modal keybars list only wired keys: the boards' "ctrl-f fetch all"
+  (repo), "ctrl-w worktrees" (repo), and "ctrl-d dispose" (worktree) stay
+  off until those actions exist.
+- A diverged current branch shows both count pills in the branch modal;
+  the board drew only the ahead pill for the current row.