feat: add devtrail explore interactive TUI documentation viewer#9
Merged
feat: add devtrail explore interactive TUI documentation viewer#9
Conversation
Add a full terminal UI for browsing and reading DevTrail documentation directly from the command line, powered by ratatui + crossterm. - Two-panel layout (Navigation + Document) with adaptive fallback for narrow terminals - Metadata panel showing status, confidence, risk bars, tags, and navigable related links - Markdown rendering with heading indentation, styled tables, code blocks, and lists - Hyperlinked navigation between related documents with history stack - Search/filter by filename, title, tags, date, or document ID - Fullscreen document mode, vim-style keybindings, and help popup - Feature-flagged under `tui` (enabled by default, opt-out with --no-default-features) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|
|
2 tasks
montfort
added a commit
that referenced
this pull request
May 2, 2026
Editorial-only pass on Propuesta/devtrail-design-principles.md to remove internal-language phrases that confuse readers who don't know Sentinel (the project that produced the empirical evidence). All decisions and commitments preserved; only language generalized. Specific changes: - Version metadata now names the editorial pass and dates it. - v0.2 anotaciones intro: glosses Sentinel as "un sistema Go backend" on first mention, drops references to /plan-audit and PLAN-NN that cold readers can't anchor to anything. - Principle #6 anotación (virtud-vs-ceremonia): replaces specific artifact IDs (AILOG-020, AILOG-022, PLAN-05.telemetry.yaml) with abstracted descriptions of the empirical findings. The decisions about what counts as virtud vs ceremonia stay identical. - Principle #9 anotación (bash before framework): drops the script filename and AILOG ref, keeps the ~145-line metric and the three-property justification (zero-build, no deps, in-situ inspection). - Principle #12 anotación (N≥3 spirit): "Sentinel es un solo proyecto..." → "La evidencia empírica disponible proviene de un solo proyecto adoptante..."; specific scores (9.25/9.5) generalized to "scores similares"; supuesto #4 named as "supuesto de aprobaciones condicionales" instead of by number alone. - Meta-meta paragraph: drops Sentinel-specific framing while keeping the auto-evolución insight intact. Prerequisite for D4 of the README repositioning plan: link the design principles from the public README. Cold readers (a developer landing on GitHub, not someone who read all the propuesta docs) need to grasp each principle without first decoding internal artifacts. Co-authored-by: Claude Opus 4.7 (1M context) <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
2 participants
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.
Summary
devtrail explorecommand: a full terminal UI for browsing and reading DevTrail documentation interactivelytui(enabled by default), adds ~600KB to binary via ratatui + crossterm + pulldown-cmarkTest plan
cargo build --releasecompiles without warningscargo build --no-default-featurescompiles without TUIcargo testpasses all 26 testsdevtrail explorein a DevTrail project opens the TUIdevtrail explore /tmpshows friendly error/filters by tags, title, dateftoggles fullscreen,?shows help,q/Ctrl+Cquits🤖 Generated with Claude Code