gitbound 1.0.0

A safety-first local GitHub identity manager
Documentation
# Release QA checklist

Walk this before tagging a release.

It exists because the frontend has no JavaScript test runner. `cargo test`
covers the backend, the IPC contract, and the frontend's structural invariants,
but not DOM behaviour — focus handling, confirmation gating, and toast timing.
Those are checked here, by hand.

Run against a **throwaway configuration**, not your real one:

```sh
# Windows PowerShell
$env:GITBOUND_CONFIG = "$env:TEMP\gitbound-qa\config.toml"
cargo run -p gitbound-desktop
```

Create two or three scratch git repositories to bind against. Do not point this
at repositories whose git config you care about.

---

## A. First run and shell

1. With no configuration file present, the onboarding view appears — not the
   main views — and offers "Import from a repository" first.
2. "Import from a repository" opens the native picker. Cancelling it leaves the
   chooser unchanged.
3. Picking a git repository opens the wizard on step 1 with author, email, and
   host prefilled from that repository, and shows the chosen path above it.
4. "Start from scratch instead" opens the same wizard with empty fields and no
   path.
5. Completing the wizard lands on the Dashboard with the identity present.
   Started from a repository, that repository is also bound; started from
   scratch, **no repository is touched** — verify with `git config --local -l`.
6. The title bar shows the correct version, the Quick switch trigger, and
   "Local configuration only".
7. All six navigation entries switch views, and the active one is highlighted.
8. **No console window appears at any point** — not at launch, and not during
   any action below.

## B. Theme and layout

9. Switch the OS to dark mode with Settings on "System": the app follows
   without a restart.
10. In Settings, choose Light. The app stays light with the OS in dark mode.
    Restart: the choice survives.
11. Choose the Violet accent. Brand surfaces change; **passing checks stay
    green** and failures stay red. Choosing Dark afterwards keeps the accent,
    and choosing an accent keeps the mode.
12. Narrow the window below 860px: navigation collapses to an icon rail, the
    footer keeps the identity avatar, and the window does not scroll
    horizontally. Wide tables scroll inside their own container.
13. Narrow below 620px: cards and grids go to one column; nothing becomes
    unreachable.
14. With "reduce motion" enabled in the OS, page transitions and the spinner do
    not animate.

## C. Dashboard

15. The Active identity card shows name, author, email, `@user`, host, and
    either the SSH key path or "HTTPS · credential helper".
16. The Current repository card shows the selected repository and its status
    badge. With no repositories discovered it offers "Go to repositories"
    instead.
17. "Run checks" contacts GitHub CLI and SSH **only when pressed** — nothing
    reaches the network on page load. Afterwards "Last checked" appears.
18. "Check CI status" is likewise never automatic. With `gh` unavailable it
    reports the reason in place rather than raising an error toast.
19. The three shortcut cards navigate to Quick switch, Repositories, and
    Diagnostics.
20. Recent repositories lists up to five rows; clicking one opens its detail
    page.

## D. Quick Switch

21. `Ctrl`/`Cmd`+`K` opens the palette from any view. `Escape` closes it. The
    trigger in the title bar does the same.
22. **Type in the search box.** Focus and caret survive every keystroke.
23. Clicking an identity arms it and shows a preview of exactly what will
    change. **Nothing is written yet** — verify with `git config --local -l`.
24. Clicking the same identity again, or pressing Switch, applies it.
25. With "Current repository" selected and no repository chosen, the preview
    says so and applying reports it rather than failing silently.
26. With "GitHub CLI account" selected, the preview names the account gh will
    authenticate as, and confirms no repository is modified. Verify with
    `gh auth status`.
27. The palette does not open before any identity exists.

## E. Identities

28. The grid shows one card per identity with avatar initials, author, email,
    `@user`, SSH key, and a repository count that matches the Repositories
    table.
29. The first identity is marked Default and carries the star.
30. **Type in the search box.** Focus and caret survive every keystroke, and
    filtering narrows the grid.
31. "Use" shows the GitHub CLI switch preview with the real current account.
    Confirming switches it; cancelling does nothing.
32. "Edit" opens the wizard with every field populated, including the signing
    format and the "require signed commits" checkbox.
33. **Tab through the entire wizard using only the keyboard.** No field loses
    focus and the caret never jumps.
34. Step 1 refuses to advance without a name, author, and a plausible email,
    and says which is missing. Step 2 refuses without a GitHub user and host.
    Step 3 is optional and can be skipped entirely.
35. Step 4 shows exactly what will be saved and states that nothing is written
    yet.
36. Changing the signing format updates the signing-key placeholder.
37. "Allowed owners" accepts `a, b, ,c` and stores three owners.
38. "Browse" opens the key picker and fills the SSH key path.
39. Renaming an identity and saving renames it and keeps the grid correct.
40. "…" → Duplicate produces `<name>-copy`; duplicating again produces
    `<name>-copy-2`.
41. "…" → Remove requires confirmation on the card before removing.

## F. Repositories

42. With no folder approved, the empty state explains that nothing on disk is
    scanned and offers "Add path".
43. "Add path" opens the folder picker and then scans.
44. "Scan" streams live progress text, then reports the count in a toast.
    During a scan the button reads "Cancel scan"; pressing it stops the scan.
45. **Type in the search box.** Focus stays and the caret stays put across every
    keystroke, including typing in the middle of existing text. _(This is the
    most important check on the page.)_
46. The table shows repository, identity pill, remote host, status, and CI.
47. "Check CI" fills the CI column one repository at a time and is **never**
    automatic. Repositories without workflows read "unavailable" with the
    reason on hover, not an error.
48. Clicking a repository name or its chevron opens the detail page.
49. "Manage approved paths" goes to Settings.

## G. Repository details

50. The header shows the repository name and path, with Open folder and Back.
51. "Open folder" reveals the repository in the OS file manager. It does **not**
    open a shell.
52. The remote row shows the URL; the copy button puts it on the clipboard.
53. The Identity select lists every identity. Commit identity and Authentication
    are read-outs derived from that selection, not separately editable.
54. For an unbound repository "Apply configuration" first shows the preview and
    changes to "Confirm and write". **No git config is written until the second
    click** — verify with `git config --local -l`.
55. For a drifted repository the preview adds the sentence about drifted managed
    values being overwritten.
56. After binding, `git config --local -l` shows `user.name`, `user.email`,
    `gitbound.profile`, and the `gitbound.backup*` entries.
57. "Reset" returns the select to the currently bound identity.
58. "Unbind and restore" requires its own confirmation, and after confirming,
    the repository's original `user.name`/`user.email` are restored exactly —
    including being absent again if they were absent before.
59. "Run checks" fills the Checks card and notes when the network was not
    contacted.
60. A repository with drift shows the dot on the Repositories nav entry.

## H. SSH keys

61. Selecting an identity with no SSH key disables "Test authentication" and
    shows the "No SSH identity file" notice.
62. Selecting one with a key enables the button.
63. Running the test makes exactly one SSH connection and shows the verdict.
64. Switching identities clears the previous verdict rather than showing a
    stale one.

## I. Diagnostics

65. The report shows git, gh, and ssh with real versions.
66. Temporarily rename `gh.exe` on PATH: that row becomes unavailable, the
    banner switches to "needs attention", and a "Fix" button appears.
67. "Fix" reveals the remediation command and **does not run it**.
68. The copy button puts the command on the clipboard.
69. The "Recommended" callout names the most serious problem, and "Show command"
    reveals the same command.
70. "Run again" re-runs the checks.

## J. Settings

71. Approved folders lists every approved root.
72. Removing one asks for confirmation first, and after confirming, repositories
    beneath it disappear from the table.
73. The About panel shows the version, configuration path, schema version, and
    identity count, and the copy button copies the path.

## K. Failure and recovery

74. Corrupt the config file (write `not toml` into it). The app shows
    "Configuration could not be read" and offers only Retry and Diagnostics —
    **no write actions are offered.**
75. Diagnostics is still reachable from that state, and `Ctrl`/`Cmd`+`K` does
    not open the palette.
76. Fixing the file and pressing Retry recovers without a restart.
77. Error toasts persist until dismissed; success toasts disappear after about
    three and a half seconds.

## L. CI surface

78. `gitbound verify` in a bound repository exits 0; in an unbound one it
    exits 1 and names the `binding` check.
79. `gitbound verify --format sarif --output out.sarif` writes valid SARIF and
    still exits on the same rule.
80. With `GITHUB_ACTIONS=true` and `GITHUB_STEP_SUMMARY` set, `verify` prints
    `::error` annotations and appends a table to the summary file.
81. `gitbound audit --range HEAD~3..HEAD` names any commit authored outside
    policy.
82. A `.gitbound.toml` with `schema_version = 99` makes `verify` exit 2 rather
    than ignoring the policy.
83. `gitbound --json` output is unchanged from the previous release for
    `status`, `check`, `doctor`, `profile list`, `profile show`, and `ssh test`.

## M. Packaging

84. `cargo build --release -p gitbound-desktop` succeeds with no Node and no
    tauri CLI on PATH.
85. The release executable runs on a clean machine that has only the WebView2
    runtime.
86. `?demo` does nothing in the release build.
87. Every published asset has a matching `.sha256`, and
    `gh attestation verify` succeeds against the release.