docs: document 0.71 expanded git-ops surfaces (submodule actions, remotes, blame, rebase)

gfargo committed Jun 12, 2026

docs: multi-forge support (GitHub / GitHub Enterprise / GitLab) for 0.70 New Multi-Forge-Support page + updates to Command-Reference, Config-Overview (forgeHosts), Issue-PR-Triage, Home, and Troubleshooting (glab).

gfargo committed Jun 10, 2026

docs: document opt-out local usage stats (telemetry.usage), per-repo cost, doctor --clear (0.69)

gfargo committed Jun 9, 2026

docs: document 0.66-0.68 features - Command-Reference: add `coco amend` and `coco pr create`; document the global --json/--quiet flags, `review --severity`/`--staged`, and `doctor --cost`. - Config-Overview: extend service.provider to all seven providers (gemini, mistral, azure, bedrock) with config examples + env vars, the new structural fast-path languages (Java/C/C++/C#/Ruby/PHP), and the commitSplit routing task. - Coco-UI + TUI-Navigation: document the actionable reflog keys (c checkout, Z reset, B branch). - Home + Getting-Started: add the new commands and the seven-provider list.

gfargo committed Jun 9, 2026

docs(themes): update theme counts to 108 (color theme release) Reflects the expanded catalog (108 color themes / 109 presets, 29 light) in the config, log-TUI, navigation, and home pages. Pairs with the coco color theme release.

gfargo committed Jun 5, 2026

docs: worktree-aware checkout conflict resolutions Document the new prompt shown when checking out a branch that's already checked out in another worktree — switch to that worktree (y), remove it and check out here (r), or remove it and delete the branch (x).

gfargo committed Jun 5, 2026

docs: stash view aligned table + green current-branch highlight Update the stash-view descriptions from "rich rows (branch · files · age)" to the new aligned table (ref · age · branch · files · message), note that the checked-out branch is shown in green in the branches list/sidebar, and add a "v0.62.x — workstation readability tweaks" entry to the What's-New log.

gfargo committed Jun 5, 2026

docs(tui): document the g? view-keys strip (#1137) Add a "View-keys strip (g?)" section to TUI-Navigation.md: the per-view counterpart to the g-chord which-key overlay, surfacing the single-key actions available in the current view, sourced live from the binding table filtered by view + focus. ? steps up to full help; Esc closes; bare ? is unchanged. Cross-referenced from the Mental model section. Coco-UI.md's Navigation intro now points to g? for discovering a view's single keys.

gfargo committed Jun 4, 2026

Document workspace clone (c) — URL → destination prompt The clone-from-workspace feature (coco 0.60.0) was missing from the Workspace page: add the 'c' key to the keymap table and a Clone-prompt entry to 'Adding & Removing Repos'.

gfargo committed Jun 4, 2026

Document 0.60.0: stash workflow, single-pane fallback, honest chrome - TUI-Navigation: add a v0.60.0 'What's new' entry (stash overhaul with gZ/R/b/A/u + palette variants, rich rows; single-pane fallback + v peek; footer/breadcrumb honesty); expand the Stash views-table row; document the v key. - Coco-UI: add the narrow-terminal single-pane fold to the Layout section; expand the Stash views-table row. - Command-Reference: add stash-workflow + single-pane bullets to the coco ui feature list.

gfargo committed Jun 4, 2026

docs(workspace): default discovery root is now the current directory Bare coco / coco ws scans the cwd when workspace.roots is unset (was a hardcoded ~/code). Updated the quick-start comment, the roots default in the config table + populate section, and the no-repos troubleshooting hint. Pin workspace.roots for a fixed tree.

gfargo committed Jun 1, 2026

docs: update for 0.57.0 bare-`coco` smart routing Bare `coco` (no subcommand) now routes to init / ui / workspace instead of defaulting to commit, so every doc that used bare `coco` to mean 'generate a commit' was wrong. Across all pages: - Rewrite bare-`coco` commit examples to explicit `coco commit …` (incl. $(coco) subshells and `coco | git commit` pipes). - Add a 'Smart default routing' section to Command-Reference and Getting-Started documenting the init/ui/workspace table + the --commit / COCO_DEFAULT=commit escape hatch. - Heads-up callouts in the onboarding flow.

gfargo committed Jun 1, 2026

docs: refresh theme counts, preset lists, and view counts for 0.57.0 - Theme/preset references updated from the old 4-preset lists to the current 49 color themes / 50 presets (17 light), linking the gallery. - coco ui view count corrected to 16 (Command-Reference, Home). - Note that the active/selected row is now readable on every theme. - Clarify logTui.theme.preset is shared by coco log -i and coco ui.

gfargo committed May 31, 2026

feat: add Workspace page covering `coco workspace` / `coco ws` Full user-facing reference for the multi-repo overview TUI: - Start commands + flags (`--root`, `--max-depth`, `--theme`) - Layout sketch with chip header, rail-collapsible sidebar, table body with responsive column drop priority - Focus model (sidebar / list with tab cycling; modal focuses for filter / add-repo / confirm-delete) - Full keymap grouped into Navigate / Filter & sort / Repos / General - Drill-in loop semantics (chdir, mount ui, restore on exit) - Sort modes + filter behavior - Add / remove repo flow including the per-user known-repos store - Configuration reference (`workspace.roots`, `knownRepos`, `maxDepth`) - Performance + resilience notes - Troubleshooting (no repos discovered, PR counts missing, dev watcher capturing keys, slow network FS) Linked from Home.md under the TUI section.

gfargo committed May 28, 2026

docs: refresh wiki for 0.54 (streaming preview, cancel, pendingAiDraft, split fallback) Three pages updated to reflect features that landed across 0.54.0 and the post-0.54 audit fixes: - **Coco-UI.md** — compose surface section gains Esc-cancel keybinding, the new `R`-accept-pending-draft keybinding, a `service.streaming.enabled` opt-in section with the JSON snippet, and a "Pending AI draft confirmation" subsection covering the clobber guard (audit #7). - **Commit-Split.md** — error-message section reworked to explain the default single-commit fallback (0.54.0, #1005) and the `--strict-split` opt-out for CI gates. Adds recovery options for when the fallback isn't what the user wanted. - **TUI-Navigation.md** — `I` row expanded to mention the Esc-cancel and R-accept keystrokes with a cross-link to Coco-UI. No content removed; all changes are additive elaboration of existing sections.

gfargo committed May 25, 2026

docs(scenarios): refresh Testing-Scenarios for git-scenarios 0.5.0 The page was written when the package was at v0.3.0/0.3.1 with 19 scenarios; the registry has grown to 27 across the v0.3.2 → v0.5.0 releases and the package now exposes a Jest framework adapter plus programmatic registration. Brought the page back in sync. Changes: - Total bumped 19 → 27 across the kind tables. - Added missing scenarios that landed since the original draft: empty-repo (0.3.2), branch-sync-showcase (0.3.3), mid-rebase-conflict + mid-cherry-pick-conflict (0.4.0), multiple-worktrees + shallow-clone + large-repo + mid-revert-conflict (0.5.0). - Rewrote the in-progress operations section to surface the complete conflict matrix (merge / rebase / cherry-pick / revert) with each state's .git/ marker file. - New "I'm working on the conflicts view" workflow block calls out the four-scenario cycle as the right way to audit any conflict-view changes. - New "stress-test history" + "worktrees view" workflow blocks for large-repo and multiple-worktrees. - New "Path A — the Jest framework adapter" section describing describeWithScenario / describeEachScenario / describeWithScenarioExtended as the preferred surface for new tests. The raw spinUpScenario API becomes Path B for cases that need finer lifecycle control. - New "Path B — fromScenario" + "Path C — register a coco-specific scenario at runtime" sections in the "compose your own" guide. - "Where things live" mentions the Jest adapter subpath export and the bin/scenarioRunner.ts wrapper that makes --run-ui work. Home.md tile copy refreshed to match: 19 → 27, conflict matrix language ("merge / rebase / cherry-pick / revert"), describeWithScenario swapped in for the older spinUpScenario one-liner.

gfargo committed May 22, 2026

docs: add Testing-Scenarios page Comprehensive guide to coco's scenario library: - The 19 named scenarios available, grouped by kind - The npm run scenario CLI (list, describe, create + flags) - Common dev workflows for each TUI surface (chip-rendering-showcase, mid-merge-conflict, branch-diverged, etc) - How to compose scenarios inline in tests via the atom layer - How to use spinUpScenario in jest integration tests - Pointers to the @gfargo/git-scenarios package for contributing new scenarios back Also surfaces the page on Home.md so it's discoverable from the landing index.

gfargo committed May 18, 2026

docs: nested-repo navigation + submodules view (#931 / #932) - Coco-UI.md: view count fifteen → sixteen; add Submodules (g M) row; add a dedicated "Submodule navigation" section covering both drill-in entry points, the breadcrumb, and the stacking semantics. - TUI-Navigation.md: extend mental model with the repo stack; add g M to the chord enumeration; add Submodules row to the views table; add a "Submodule drill-in (#931)" cross-view workflow section; document Esc/< walking out of nested frames; record the two known polish follow-ups.

gfargo committed May 17, 2026

docs: document logTui.dateBucketing in Config-Overview + Interactive-Log-TUI Ships alongside #968 (smart date bucketing). Two updates: - Config-Overview: new row in the `logTui` table for `dateBucketing` with the default + opt-out instructions, and extends the example JSON to show both `idleTips` and the new field. - Interactive-Log-TUI: new "Date Bucketing" section with a sample rendering, a table of all six bucket tiers (today → calendar month), the opt-out config snippet, and a note about the filter-suppression invariant. Won't reflect on the public wiki until someone runs `npm run wiki:push` after #968 merges so docs and the feature land together.

gfargo committed May 15, 2026

Document issue / PR triage workflow (#882)

gfargo committed May 15, 2026

Document commitSplit dynamic-model task + dedupe rescue passes

gfargo committed May 14, 2026

Refresh Coco-UI / TUI-Navigation / Commit-Split / Command-Reference / Home Catches up the canonical user docs to the 0.49.x workstation: - Adds C / L / E / S keystrokes under History view + Compose - Documents the just-landed commit marker (▎ accent bar for ~5s after apply) - Documents the directive next-step hint surfaced post-commit / post-split - "Nine" → "Thirteen" views (changelog joined the list) - New chord entries: g x (conflicts) / g r (reflog) / g B (bisect) - New "One-keystroke workflows" table for C / L / S / E / I / B / + - Adds the workstation-first quick start (S keystroke in compose) - New "Commit Message Style" section documenting: - Conventional Commits format honored when configured - Commitlint integration auto-detected - Branch name passed as prompt context - Same LLM service config as `coco commit` (incl. dynamic model routing) - New "Resilient Plan Validation" section explaining the 4-pass rescue chain - Adds the per-commit HEAD-verification safety rule - Adds the empty-groups filter safety rule - New Global Options section calls out `--repo <dir>` (alias `--cwd`) explicitly - Worked examples for each subcommand (commit/ui/log/doctor/init) with --repo - Coco UI feature bullets list now mentions 13 views + the one-keystroke workflows + the just-landed marker - Commit Split bullets mention conventional-commits / commitlint inheritance + workstation S workflow + rescue chain

gfargo committed May 14, 2026

Document logTui.idleTips config option Surfaced during the v0.46.0 audit. Off by default — rotates short usage tips through the status line after ~10s idle. Flip on if you're new to the chord model and want prompts.

gfargo committed May 10, 2026

Document bisect workflow view (gB) (#784, PR #868) Adds the twelfth promoted view to the navigation reference: - TUI-Navigation.md: Bisect row in the views table; new "Bisect (#784)" section under "Cross-view workflows" documenting the gB chord, the four in-view action keys (g/b/s/x), the chord-bypass behavior, and the BISECTING title-bar badge. Quick-reference card gets gB and the bisect action keys. - Coco-UI.md: Bisect row in the views table; chord box updated. - Interactive-Log-TUI.md: chord list expanded to include gB. Eleven views became twelve. Bisect is the first view with single-letter scoped action keys that bypass the global g chord prefix; the docs spell out why and when that's safe.

gfargo committed May 9, 2026

Document reflog browser (gr), conflicts view (gx), and compare-two-refs flow Brings the TUI nav docs in line with v0.45.0+ shipped features: - Add Conflicts (gx) and Reflog (gr) rows to the views tables in TUI-Navigation.md and Coco-UI.md. Updates the count from nine to eleven. - New "Cross-view workflows" section in TUI-Navigation.md documenting compare-two-refs (m mark + Enter compare), with the step-by-step flow and footer-hint adaptation. - New "Compare two refs" section in Coco-UI.md with the same flow, inlined for the user-facing intro. - Update Interactive-Log-TUI.md chord list to include the four views added since v0.34.0 (worktrees, pull-request, conflicts, reflog). - Update the quick-reference card in TUI-Navigation.md to include conflicts, reflog, and the m compare-mark binding.

gfargo committed May 9, 2026

Document opt-in service.fastPath.markdown flag (#861, PR #863)

gfargo committed May 8, 2026

docs(config): document current fast-tier model defaults (#854) Reorganize the Supported Models list so current-generation models appear first and older lines are grouped as "back-compat". Update the Anthropic config example to recommend `claude-haiku-4-5-20251001` (the new default). Correct the documented `tokenLimit` default to 4096 to match the value shipped after #845's PR 1. Adds a one-paragraph note explaining the "default to the fast tier" rationale: diff condensing is bounded summarization, so the cheaper model is the right default and users can step up if quality demands it.

gfargo committed May 6, 2026

docs: cover the unified three-tier navigation in 0.40.0 Bring Coco-UI and TUI-Navigation up to date with the four 0.40.0 PRs (#818, #819, #820, #821) that applied the same "named groups have first-class cursor-targetable headers" pattern across the sidebar, status surface, inspector actions, and stash diffs. Coco-UI: status section now describes the staged/unstaged/untracked groups + batch actions; inspector section describes the executable Actions tab; diff section mentions the stash file headers. TUI-Navigation: new v0.40.0 entry frames the unified pattern across all four surfaces.

gfargo committed May 3, 2026

docs(coco-ui): document the three-tier sidebar navigation model The "Sidebar (focused)" section now describes the cursor model explicitly: ←/→ between tab titles (horizontal axis), ↑/↓ within items (vertical axis), with the active tab's header as a first-class cursor target you reach by pressing ↑ at item index 0. Enter on the header drills into the dedicated view; Enter on an item performs the per-entity action. ASCII diagram makes the three tiers (tab bar / header / items) visible at a glance, and a single-cursor invariant note explains why items dim their highlight when the header is focused. Behavior implemented in the sidebar header focus PR. This commit is docs-only.

gfargo committed May 3, 2026

docs(coco-ui): catch surface keybindings + sidebar/inspector model up to 0.39.0 The page was last refreshed for the v0.34.0 shell architecture. This commit catches it up across the action-surface work that landed in v0.37.0–v0.39.0 without restructuring the page layout itself. Changes: - Bump "seven views" → "nine views". Add Worktrees (`g w`) and Pull request (`g p`) rows to the views table with a one-line summary of each. - Layout section: header label is now `coco` (was `coco ui`); sidebar mentions in-sidebar selection (cursor inside the active tab + per-entity ops); inspector mentions narrow-at-rest / focus-expand / tabbed-on-short-terminals. - Drop the stale `v0.34.0 migration` callout. The TUI Navigation page now owns the "what's new" history per release. - Surface keybindings — full rewrite around per-surface tables: - Generic (every view): adds `←/→` for sidebar tabs, `y/Y` yank, `O` open in browser, `r` refresh, expanded `Enter` and `[/]` semantics. - History view: new section covering `c` cherry-pick, `R` revert, `Z` reset (mode prompt), `i` interactive rebase, `B` create branch here, `gT` create tag here. - Diff view: new section covering `d` split toggle, `H` / `gH` hunk apply, `[/]` hunk/file navigation, `c` cherry-pick file. - Pull-request view: new section covering `m` / `x` / `a` / `R` / `c` / `O` action keys with the multi-line comment / review-body prompt model. - Sidebar (focused): documents the in-sidebar selection model (←/→ tabs, ↑/↓ items, Enter primary action) and lists the per-entity secondary keys (D/R/u/+P/F for branches; a/p/X for stashes; T/P for tags; W for worktrees). - Inspector (focused): `[/]` cycles tabs on short terminals; ↑/↓ moves the file-list cursor. - Input prompts: documents the multi-line mode (Enter newline, Ctrl+D submit) for `pr-comment` and `pr-request-changes`. - GitKraken Migration Notes table: replaced the speculative "Roadmap" column with a concrete "Notes" column, since most of the previously-roadmapped capabilities have shipped (lane coloring, side-by-side diff, hunk apply, PR panel). Added rows for the right-click commit menu equivalent, branches sidebar, stash list, and worktrees. No changes to the Worktree And Diff Workflow, Commit Compose, Manual QA Checklist, or Troubleshooting sections — they remain accurate.

gfargo committed May 3, 2026