Add determinism tests for verdict artifact generation and update SHA256 sums script
- Implemented comprehensive tests for verdict artifact generation to ensure deterministic outputs across various scenarios, including identical inputs, parallel execution, and change ordering. - Created helper methods for generating sample verdict inputs and computing canonical hashes. - Added tests to validate the stability of canonical hashes, proof spine ordering, and summary statistics. - Introduced a new PowerShell script to update SHA256 sums for files, ensuring accurate hash generation and file integrity checks.
This commit is contained in:
@@ -1,13 +1,8 @@
|
||||
# Console Asset Captures for Vuln Explorer Documentation
|
||||
|
||||
> **Status:** Ready for capture
|
||||
> **Last Updated:** 2025-12-06
|
||||
> **Owner:** Console Guild
|
||||
> **Hash Manifest:** See SHA256SUMS after capture
|
||||
|
||||
## Capture Instructions
|
||||
|
||||
Run the console app locally and capture each screen:
|
||||
Run the Console locally and capture each screen listed below.
|
||||
|
||||
```bash
|
||||
# Start the dev environment
|
||||
@@ -22,7 +17,7 @@ docker compose -f deploy/compose/docker-compose.dev.yaml up -d
|
||||
|
||||
### 1. Dashboard Overview
|
||||
|
||||
**File:** `dashboard-overview.png`
|
||||
**File:** `dashboard-overview.png`
|
||||
**Description:** Main dashboard showing vulnerability counts, risk scores, and recent activity.
|
||||
|
||||
```markdown
|
||||
@@ -39,7 +34,7 @@ The dashboard provides:
|
||||
|
||||
### 2. Vulnerability Explorer List
|
||||
|
||||
**File:** `vuln-explorer-list.png`
|
||||
**File:** `vuln-explorer-list.png`
|
||||
**Description:** Vulnerability list view with filters and sorting.
|
||||
|
||||
```markdown
|
||||
@@ -56,7 +51,7 @@ The vulnerability list shows:
|
||||
|
||||
### 3. Vulnerability Detail View
|
||||
|
||||
**File:** `vuln-detail.png`
|
||||
**File:** `vuln-detail.png`
|
||||
**Description:** Single vulnerability detail page with full context.
|
||||
|
||||
```markdown
|
||||
@@ -75,7 +70,7 @@ The detail view includes:
|
||||
|
||||
### 4. Findings Ledger Timeline
|
||||
|
||||
**File:** `findings-timeline.png`
|
||||
**File:** `findings-timeline.png`
|
||||
**Description:** Timeline view of vulnerability findings and state changes.
|
||||
|
||||
```markdown
|
||||
@@ -92,7 +87,7 @@ The timeline shows:
|
||||
|
||||
### 5. Risk Score Panel
|
||||
|
||||
**File:** `risk-score-panel.png`
|
||||
**File:** `risk-score-panel.png`
|
||||
**Description:** Risk score breakdown with contributing factors.
|
||||
|
||||
```markdown
|
||||
@@ -109,7 +104,7 @@ The risk panel displays:
|
||||
|
||||
### 6. VEX Consensus View
|
||||
|
||||
**File:** `vex-consensus.png`
|
||||
**File:** `vex-consensus.png`
|
||||
**Description:** VEX consensus display showing multiple issuer statements.
|
||||
|
||||
```markdown
|
||||
@@ -126,14 +121,14 @@ The VEX consensus view shows:
|
||||
|
||||
### 7. Policy Studio Editor
|
||||
|
||||
**File:** `policy-studio-editor.png`
|
||||
**Description:** Policy Studio with Monaco editor and rule builder.
|
||||
**File:** `policy-studio-editor.png`
|
||||
**Description:** Policy Studio with editor and rule builder.
|
||||
|
||||
```markdown
|
||||

|
||||
|
||||
The Policy Studio includes:
|
||||
- Monaco editor with StellaOps DSL highlighting
|
||||
- Policy editor with DSL highlighting
|
||||
- Rule builder sidebar
|
||||
- Simulation panel
|
||||
- Lint/compile feedback
|
||||
@@ -143,7 +138,7 @@ The Policy Studio includes:
|
||||
|
||||
### 8. Air-Gap Status Panel
|
||||
|
||||
**File:** `airgap-status.png`
|
||||
**File:** `airgap-status.png`
|
||||
**Description:** Air-gap mode status and bundle information.
|
||||
|
||||
```markdown
|
||||
@@ -160,23 +155,8 @@ The air-gap panel shows:
|
||||
|
||||
## After Capture
|
||||
|
||||
1. Place captured images in this directory
|
||||
2. Generate hashes:
|
||||
```bash
|
||||
sha256sum *.png > SHA256SUMS
|
||||
```
|
||||
3. Update `docs/assets/vuln-explorer/SHA256SUMS` with new entries
|
||||
4. Mark DOCS-CONSOLE-OBS-52-001 as DONE in sprint file
|
||||
1. Place captured images in this directory.
|
||||
2. Compute hashes:
|
||||
- `sha256sum *.png`
|
||||
3. Record the sha256 next to each captured filename in this document (or in a sibling README where the asset is referenced).
|
||||
|
||||
## Sample SHA256SUMS Entry
|
||||
|
||||
```
|
||||
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 dashboard-overview.png
|
||||
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 vuln-explorer-list.png
|
||||
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 vuln-detail.png
|
||||
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 findings-timeline.png
|
||||
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 risk-score-panel.png
|
||||
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 vex-consensus.png
|
||||
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 policy-studio-editor.png
|
||||
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 airgap-status.png
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user