Repository navigation
feat: desktop viewer for decisions and rules (ingrain viewer) - #19
Merged
Merged
Conversation
A native app (`ingrain-viewer`, built with Rune, in its own `viewer/` workspace) to read, review and trace decisions and learned rules: - Inbox: proposals one at a time; A accepts, R rejects with a reason, J/K move. - A page per decision: why, not chosen, scope, enforcing checks, lineage, sources, and git history with each commit's diff. Supersede from the page. - Learned rules: mode switch, weekly hits and overrides, the fix it learned from, backtest. - Timeline by month, Archive, and "Applies to" for a path or a dropped file. - Project, local and global stores together, tagged, with a Stores filter. - Opens from any folder (`ingrain view [PATH] [--select ID]`), recents, ⌘O or a dropped folder; updates when files change. Every write runs the `ingrain` CLI, one at a time. The CLI only gains `ingrain view`, which starts the viewer; it stays free of GUI dependencies and on MSRV 1.90. CI builds and tests the viewer on macOS. Docs: README, book page, CHANGELOG, skills, and docs/viewer/PLAN.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The viewer was a separate `ingrain-viewer` program; it is now a subcommand of the one `ingrain` binary (D-0001), in crates/cli/src/viewer/, behind the default `viewer` Cargo feature. - `ingrain viewer [PATH] [--select ID] [--wait]` starts itself again detached (own process group; no console on Windows) and returns. `--local` / `--global` show only that store. - Writes run this same binary's commands, one at a time. - No toast after accept, reject, supersede or a mode change: only failures, and long jobs (extract, learn) finishing with their log closed. - macOS and Windows release binaries include the viewer. Linux release binaries are built `--no-default-features`: Rune links libxkbcommon and libwayland-client, which would stop `ingrain` (hooks included) from starting in containers and on servers. - The CLI keeps MSRV 1.90 (D-0033), checked without the viewer; the viewer needs Rust 1.99. - deny.toml: allow Rune's git source, BSD-2-Clause (arrayref, via winit) and MPL-2.0 (spellbook, Rune's spellchecker); ignore three unmaintained zbus crates that come only through the Linux folder dialog. Rune's audio and SVG features are off. - Viewer tests take the global store's path instead of setting INGRAIN_HOME. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Bump the version in Cargo.toml, Cargo.lock, plugin.json, the action and the docs, and date the CHANGELOG. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
ingrain vieweropens a native desktop viewer, built into theingrainbinary with Rune, for a repository's decisions and learned rules. It's for reading, reviewing and tracing them. User stories and how each is solved:docs/viewer/PLAN.md.Aaccepts,Rrejects with a reason,J/Kmove. A replacement shows the decision it retires.ingrain viewer [PATH] [--select ID];--local/--globalfor one store), a recent list, ⌘O or a dropped folder. It returns at once; the window updates when files change.How
crates/cli/src/viewer/, a subcommand of the singleingrainbinary (D-0001), behind the defaultviewerCargo feature. It reads withingrain-core/ingrain-ledger/ingrain-engine, so parsing and scope matching are the CLI's own.accept,reject,supersede,rules mode,extract,mine+propose). The viewer never writes a record itself.ingrain viewerstarts itself again detached with--wait(its own process group; no console on Windows) and returns.--version3.8 → 6.3 ms).--no-default-features: Rune links libxkbcommon and libwayland-client, which would stopingrain(hooks included) from starting in containers and on servers. Linux desktops build from source.--no-default-features). The viewer needs 1.99.libxkbcommon-dev/libwayland-dev, and lint also runs clippy--no-default-features.Testing
cargo test --all --lockedpasses: 133 tests with the viewer, 125 without, including a Runtime test that renders every lens and clicks a row.cargo +1.90 check --no-default-featurespasses, andcargo deny checkpasses.ingrain viewer -- --snap/--scriptagainst a seeded repo (scripts/viewer-demo-repo.py):--local vieweropens filtered to the local store.Notes
🤖 Generated with Claude Code