Conversation
There was a problem hiding this comment.
Pull request overview
Adds an interactive Textual-based TUI for exploring compiled output definitions, editing JSON context, and running projections, alongside small supporting updates to docs, tests, and packaging metadata.
Changes:
- Introduces
omop_semantics.runtime.tui(Textual app + widgets) and a newomop-semantics tuiCLI subcommand. - Adds test coverage for the TUI behaviors and for
derive_status()outcome mapping. - Updates packaging/docs (new optional
tuiextra, mkdocs nav + docs page) and refreshes the lockfile.
Reviewed changes
Copilot reviewed 11 out of 12 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| uv.lock | Adds Textual and related transitive deps; bumps a few pinned packages. |
| tests/test_viz.py | Adds a focused test for derive_status() outcome coverage. |
| tests/test_tui.py | Adds end-to-end Textual run_test() scenarios for the new explorer app. |
| src/omop_semantics/runtime/tui/widgets.py | Adds shared rendering helpers for the TUI result summary and tree. |
| src/omop_semantics/runtime/tui/app.py | Implements the Textual app, CLI entrypoint, and view-model extraction. |
| src/omop_semantics/runtime/tui/init.py | Exposes the public TUI API (OutputDefinitionExplorer, run_tui). |
| src/omop_semantics/init.py | Adds tui subcommand routing to the top-level CLI entry point. |
| pyproject.toml | Bumps version to 0.4.0 and introduces tui optional dependency group. |
| mkdocs.yaml | Adds “TUI Explorer” to documentation navigation. |
| docs/visualization.md | Links to the new TUI explorer documentation. |
| docs/usage/tui.md | Adds new documentation page describing installation and usage of the TUI. |
| CHANGELOG.md | Adds 0.4.0 changelog entry describing visualization + TUI explorer. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+55
to
+57
| current context. When the app is launched through `groundworkers --tui`, that | ||
| payload uses the flat `SemanticProjectionRequest` shape so it can be pasted | ||
| directly into the real worker-backed flow. |
Comment on lines
+9
to
+16
| The TUI dependencies are optional: | ||
|
|
||
| ```bash | ||
| uv sync --extra dev | ||
| ``` | ||
|
|
||
| For a non-development install, install the package with its `tui` extra. | ||
|
|
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.
No description provided.