From 4f872e3b84b2c1758766431b8a08245825d70215 Mon Sep 17 00:00:00 2001
From: mblanke <mblanke@gmail.com>
Date: Wed, 24 Dec 2025 12:57:08 -0500
Subject: [PATCH] Define canonical Findings Table screen

Document the layout, behavior, and consistency of the Findings Table screen.
---
 ui/SCREEN_FINDINGS.MD | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 ui/SCREEN_FINDINGS.MD

diff --git a/ui/SCREEN_FINDINGS.MD b/ui/SCREEN_FINDINGS.MD
new file mode 100644
index 0000000..a536156
--- /dev/null
+++ b/ui/SCREEN_FINDINGS.MD
@@ -0,0 +1,31 @@
+Screen: Findings Table
+
+Purpose:
+Primary analyst workspace for reviewing results.
+
+Layout:
+- Full-width table
+- Dense rows
+- Sticky header
+- Filters above table
+
+Columns (left to right):
+- Severity (icon + color)
+- Summary
+- Source
+- Confidence
+- Timestamp
+- Actions
+
+Behavior:
+- Default sort: severity desc, timestamp desc
+- Row hover reveals secondary actions
+- Clicking a row opens a detail panel (not a new page)
+
+Animation:
+- New findings animate in briefly
+- Severity changes animate once
+- Table interactions are instant
+
+Consistency:
+This screen must look and behave the same in all applications.