feat(console): assessment results view updates

demo/console/assessment-results-compare.tape

@@ -0,0 +1,45 @@
+Output images/assessment-results-console-compare.gif
+
+Require lula
+Set FontSize 14
+Set Width 1850
+Set Height 925
+Set Framerate 24
+Set Padding 5
+
+Hide
+Type "lula console -f ./src/test/unit/common/oscal/valid-assessment-results-multi.yaml" Enter
+Sleep 1s
+Tab
+Sleep 500ms
+Show
+
+# Select comparison result
+Sleep 1s
+Right
+Sleep 500ms
+Right
+Sleep 500ms
+Enter
+Sleep 1s
+Down
+Sleep 500ms
+Enter
+Sleep 500ms
+
+# Navigate to findings, observations
+Right
+Sleep 500ms
+Right
+Sleep 500ms
+Down
+Sleep 500ms
+Up
+Sleep 500ms
+Left
+Sleep 1s
+
+# Show findings comparison detail
+Type "d"
+Sleep 2s
+

demo/console/assessment-results.tape

@@ -0,0 +1,49 @@
+Output images/assessment-results-console.gif
+
+Require lula
+Set FontSize 14
+Set Width 1850
+Set Height 925
+Set Framerate 24
+Set Padding 5
+
+Hide
+Type "lula console -f ./src/test/unit/common/oscal/valid-assessment-results-multi.yaml" Enter
+Sleep 1s
+Tab
+Sleep 500ms
+Show
+
+# Show results picker
+Sleep 1s
+Right
+Sleep 500ms
+Enter
+Sleep 1s
+Down
+Sleep 500ms
+Enter
+Sleep 500ms
+
+# Navigate to findings, filter
+Right
+Sleep 500ms
+Right
+Sleep 500ms
+Down
+Sleep 500ms
+Up
+Sleep 500ms
+Type "/"
+Sleep 500ms
+Type "ID-1"
+Sleep 500ms
+Enter
+Sleep 1s
+
+# Navigate to observations
+Right
+Sleep 500ms
+Type "d"
+Sleep 2s
+

demo/console/component-validation-detail.tape

@@ -0,0 +1,39 @@
+Output images/component-defn-console-validation-detail.gif
+
+Require lula
+Set FontSize 14
+Set Width 1850
+Set Height 925
+Set Framerate 24
+Set Padding 5
+
+Hide
+Type "lula console -f ./src/test/unit/common/oscal/valid-multi-component-validations.yaml" Enter
+Sleep 1s
+Show
+
+# Navigate to a control and select
+Right
+Sleep 500ms
+Right
+Sleep 500ms
+Right
+Sleep 500ms
+Enter
+Sleep 1s
+Right
+Sleep 500ms
+Right
+Sleep 500ms
+Right
+Sleep 500ms
+Type "d"
+Sleep 1s
+Down
+Sleep 500ms
+Down
+Sleep 1s
+Up
+Sleep 500ms
+Up
+Sleep 1s

docs/console/README.md

@@ -2,7 +2,38 @@
 
 The Lula Console is a text-based terminal user interface that allows users to interact with the OSCAL documents in a more intuitive and visual way.
 
-See the sub-pages for more information on interacting with OSCAL models in the Console.
+Currently, only the **Component Definition** and **Assessment Results** models are supported in the Console.
+
+ * See the sub-pages for more information on interacting with each specific OSCAL model in the Console.
 
 >[!NOTE]
->The Console is currently in development and is subject to change.
+>The Console is currently in development and views are subject to change.
+
+## Usage
+
+To open the Console with particular OSCAL models:
+```shell
+lula console -f /path/to/oscal-component.yaml,/path/to/oscal-component-2.yaml,/path/to/assessment-results.yaml
+```
+The `-f` (or `--input-files`) flag can be used to specify multiple OSCAL model file paths to be loaded into the Console.
+
+### Writing to Output
+Currently, the Console supports only writing to the `component-definition` model.
+
+To include an output file to save any changes made to the component definition, use the `--component-output` or `-c`flag:
+```shell
+lula console -f /path/to/oscal-component.yaml -c /path/to/output.yaml
+```
+
+If no output file is specified and a single component definition is passed, the provided component definition will be overwritten. If multiple component definitions are passed and no output file is specified, the Console will default to `component.yaml` in the current working directory.
+
+## Keys
+
+The Console responds to the following keys for navigation and interaction (each sub-model has additional key response, see respective help views for more information):
+
+| Key | Description |
+|-----|-------------|
+| `?` | Toggle help |
+| `ctrl+c` | Quit |
+| `tab` | Tab right between models |
+| `shift+tab` | Tab left between models |

docs/console/assessment-results.md

@@ -0,0 +1,40 @@
+# Assessment Results
+
+The Assessment Result view provides the Console user with an interactive experience of the OSCAL Assessment Results model. The view supports navigation between the different results contained in the Assessment Results model, as well as the ability to view Findings and Observations in tabular and filterable formats. Additional `detail` views are available to view the raw OSCAL model data for selected Findings/Observations.
+
+## Usage
+
+The Assessment Results model supports the following views:
+ * [Result View](./assessment-results.md#result-view)
+ * [Result Comparison View](./assessment-results.md#result-comparison-view)
+
+## Keys
+
+The Assessment Results model responds to the following keys for navigation and interaction (some widgets have additional key response, see respective help views for more information):
+
+| Key | Description |
+|-----|-------------|
+| `?` | Toggle help |
+| `ctrl+c` | Quit |
+| `tab` | Tab right between models |
+| `shift+tab` | Tab left between models |
+| `←/h` | Navigate left across widgets in model|
+| `→/l` | Navigate right across widgets model |
+| `↑/k` | Move up in table OR scroll up in panel |
+| `↓/j` | Move down in table OR scroll up in panel |
+| `/` | Filter table |
+| `↳` | Select available item |
+| `d` | Detail available item (findings and observations) |
+| `esc` | Close OR esc filtering |
+
+During console viewing, the top-right corner will display the help keys availble in the context of the selected widget. When an overlay is open, the help keys will be displayed in the overlay.
+
+## Views
+
+### Result View
+
+<img align="right" src="../../images/assessment-results-console.gif" alt="assessment results console" style="width:100%; height:auto;">
+
+### Result Comparison View
+
+<img align="right" src="../../images/assessment-results-console-compare.gif" alt="assessment results console comparison" style="width:100%; height:auto;">

docs/console/component-definition.md

@@ -4,19 +4,10 @@ The Component Definition view currently allows for a read and limited write expe
 
 ## Usage
 
-To view an OSCAL Component Definition model in the Console:
-```shell
-lula console -f /path/to/oscal-component.yaml
-```
-The `oscal-component.yaml` will need to be a valid OSCAL model - to use with the Component Definition view, it must contain the `component-definition` top level key.
-
-To include an output file to save any changes made to the component definition, use the `--component-output` or `-c`flag:
-```shell
-lula console -f /path/to/oscal-component.yaml -c /path/to/output.yaml
-```
-
-> [!Note] 
-> Several component definition models can be passed into the console, via `-f` in a comma-separated list. For multiple component definitions, the output file will default to `component.yaml` unless specified.
+The Component Definition model supports the following views:
+ * [Read-Only Navigation](./component-definition.md#read-only-navigation)
+ * [Editing Remarks and Description](./component-definition.md#editing-remarks-and-description)
+ * [Validation Detail](./component-definition.md#validation-detail)
 
 ## Keys
 
@@ -28,13 +19,14 @@ The Component Definition model responds to the following keys for navigation and
 | `ctrl+c` | Quit |
 | `tab` | Tab right between models |
 | `shift+tab` | Tab left between models |
-| `←/h` | Navigate left in model|
-| `→/l` | Navigate right in model |
+| `←/h` | Navigate left across widgets model|
+| `→/l` | Navigate right across widgets model |
 | `↑/k` | Move up in list OR scroll up in panel |
 | `↓/j` | Move down in list OR scroll up in panel |
 | `/` | Filter list |
 | `↳` | Select item |
 | `e` | Edit available fields (remarks and description) |
+| `d` | Detail available fields (validations) |
 | `ctrl+s` | Save changes (Note: this may overwrite the original file if an output file unspecified) |
 | `esc` | Cancel |
 
@@ -44,8 +36,18 @@ During console viewing, the top-right corner will display the help keys availble
 
 ### Read-Only Navigation
 
+The model can be sorted by Component, Framework, and Control. Additional data/features provided by the Component Definition OSCAL Model are not currently supported for viewing in the Console.
+
 <img align="right" src="../../images/component-defn-console-read.gif" alt="component definition console read" style="width:100%; height:auto;">
 
 ### Editing Remarks and Description
 
+Limited editing of the remarks and description is supported. Once changes are made, to be persisted back to the file, the data will need to be saved via the `ctrl+s` key.
+
 <img align="right" src="../../images/component-defn-console-edit.gif" alt="component definition console edit" style="width:100%; height:auto;">
+
+### Validation Detail
+
+The Validation Detail is a view that displays a somewhat curated version of the Lula Validation. It is intended to be a quick view of the validation, and is not a one-to-one representation.
+
+<img align="right" src="../../images/component-defn-console-validation-detail" alt="component definition console validation detail" style="width:100%; height:auto;">

go.mod

@@ -10,6 +10,7 @@ require (
 	github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc
 	github.com/defenseunicorns/go-oscal v0.6.0
 	github.com/defenseunicorns/pkg/kubernetes v0.3.0
+	github.com/evertras/bubble-table v0.17.0
 	github.com/google/go-cmp v0.6.0
 	github.com/hashicorp/go-version v1.7.0
 	github.com/kyverno/kyverno-json v0.0.3
@@ -117,6 +118,7 @@ require (
 	github.com/monochromegane/go-gitignore v0.0.0-20200626010858-205db1a8cc00 // indirect
 	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
 	github.com/muesli/cancelreader v0.2.2 // indirect
+	github.com/muesli/reflow v0.3.0 // indirect
 	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
 	github.com/mxk/go-flowrate v0.0.0-20140419014527-cca7078d478f // indirect
 	github.com/opencontainers/go-digest v1.0.0 // indirect

go.sum

@@ -143,6 +143,8 @@ github.com/evanphx/json-patch v5.9.0+incompatible h1:fBXyNpNMuTTDdquAq/uisOr2lSh
 github.com/evanphx/json-patch v5.9.0+incompatible/go.mod h1:50XU6AFN0ol/bzJsmQLiYLvXMP4fmwYFNcr97nuDLSk=
 github.com/evanphx/json-patch/v5 v5.9.0 h1:kcBlZQbplgElYIlo/n1hJbls2z/1awpXxpRi0/FOJfg=
 github.com/evanphx/json-patch/v5 v5.9.0/go.mod h1:VNkHZ/282BpEyt/tObQO8s5CMPmYYq14uClGH4abBuQ=
+github.com/evertras/bubble-table v0.17.0 h1:qQU4bi3IRxuZ5+Fvm3esyU/ucH9ufRXWhWL0fFuMn9c=
+github.com/evertras/bubble-table v0.17.0/go.mod h1:ifHujS1YxwnYSOgcR2+m3GnJ84f7CVU/4kUOxUCjEbQ=
 github.com/exponent-io/jsonpath v0.0.0-20151013193312-d6023ce2651d h1:105gxyaGwCFad8crR9dcMQWvV9Hvulu6hwUh4tWPJnM=
 github.com/exponent-io/jsonpath v0.0.0-20151013193312-d6023ce2651d/go.mod h1:ZZMPRZwes7CROmyNKgQzC3XPs6L/G2EJLHddWejkmf4=
 github.com/felixge/httpsnoop v1.0.4 h1:NFTV2Zj1bL4mc9sqWACXbQFVBBg2W3GPvqp8/ESS2Wg=
@@ -304,6 +306,7 @@ github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWE
 github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
 github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
 github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
+github.com/mattn/go-runewidth v0.0.12/go.mod h1:RAqKPSqVFrSLVXbA8x7dzmKdmGzieGRCM46jaSJTDAk=
 github.com/mattn/go-runewidth v0.0.13/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
 github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
 github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
@@ -335,6 +338,8 @@ github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D
 github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
 github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
 github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/muesli/reflow v0.3.0 h1:IFsN6K9NfGtjeggFP+68I4chLZV2yIKsXJFNZ+eWh6s=
+github.com/muesli/reflow v0.3.0/go.mod h1:pbwTDkVPibjO2kyvBQRBxTWEEGDGq0FlB1BIKtnHY/8=
 github.com/muesli/termenv v0.15.2 h1:GohcuySI0QmI3wN8Ok9PtKGkgkFIk7y6Vpb5PvrY+Wo=
 github.com/muesli/termenv v0.15.2/go.mod h1:Epx+iuz8sNs7mNKhxzH4fWXGNpZwUaJKRS1noLXviQ8=
 github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA=
@@ -384,6 +389,7 @@ github.com/pterm/pterm v0.12.79 h1:lH3yrYMhdpeqX9y5Ep1u7DejyHy7NSQg9qrBjF9dFT4=
 github.com/pterm/pterm v0.12.79/go.mod h1:1v/gzOF1N0FsjbgTHZ1wVycRkKiatFvJSJC4IGaQAAo=
 github.com/rcrowley/go-metrics v0.0.0-20201227073835-cf1acfcdf475 h1:N/ElC8H3+5XpJzTSTfLsJV/mx9Q9g7kxmchpfZyxgzM=
 github.com/rcrowley/go-metrics v0.0.0-20201227073835-cf1acfcdf475/go.mod h1:bCqnVzQkZxMG4s8nGwiZ5l3QUCyqpo9Y+/ZMZ9VjZe4=
+github.com/rivo/uniseg v0.1.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
 github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
 github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
 github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=