feat(viewer): surface the project facet in the table and stats

CHANGELOG.md

@@ -9,6 +9,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- **[Viewer]**: Surface the `project` facet that was already parsed and filtered
+  - New sortable **Project** column in the list view, and a Project row in the detail panel
+  - `stats` now reports `By Project`, in both the summary and the Markdown output
+  - The list view scrolls horizontally instead of overflowing on narrow windows
+
 - **[Docs]**: Add comprehensive dependencies reference documentation
   - Complete catalog of all external dependencies with purposes
   - Version constraints and update policy

src/application/stats.rs

@@ -196,6 +196,15 @@ fn format_markdown(stats: &AdrStatistics) -> String {
         }
     }
 
+    if !stats.by_project.is_empty() {
+        let _ = writeln!(output, "\n## By Project\n");
+        let _ = writeln!(output, "| Project | Count |");
+        let _ = writeln!(output, "|---------|-------|");
+        for (project, count) in &stats.by_project {
+            let _ = writeln!(output, "| {project} | {count} |");
+        }
+    }
+
     if !stats.by_author.is_empty() {
         let _ = writeln!(output, "\n## By Author\n");
         let _ = writeln!(output, "| Author | Count |");

src/domain/stats.rs

@@ -151,6 +151,13 @@ impl AdrStatistics {
             let _ = writeln!(output, "By Category: {}", parts.join(", "));
         }
 
+        // Project breakdown (top 5)
+        if !self.by_project.is_empty() {
+            let top = Self::top_n(&self.by_project, 5);
+            let parts: Vec<String> = top.iter().map(|(k, v)| format!("{k} ({v})")).collect();
+            let _ = writeln!(output, "By Project: {}", parts.join(", "));
+        }
+
         // Author breakdown (top 5)
         if !self.by_author.is_empty() {
             let top = Self::top_n(&self.by_author, 5);
@@ -486,12 +493,14 @@ mod tests {
         let fm1 = Frontmatter::new("ADR 1")
             .with_status(Status::Accepted)
             .with_category("architecture")
+            .with_project("project-alpha")
             .with_author("Alice")
             .with_created(date!(2025 - 01 - 15));
 
         let fm2 = Frontmatter::new("ADR 2")
             .with_status(Status::Proposed)
             .with_category("api")
+            .with_project("project-beta")
             .with_author("Bob")
             .with_created(date!(2025 - 06 - 20));
 
@@ -521,6 +530,7 @@ mod tests {
 
         assert!(summary.contains("Total: 2 records"));
         assert!(summary.contains("By Category:"));
+        assert!(summary.contains("By Project:"));
         assert!(summary.contains("Authors:"));
         assert!(summary.contains("Date Range:"));
     }

templates/app.js

@@ -443,6 +443,10 @@
                     aVal = a.frontmatter.category || '';
                     bVal = b.frontmatter.category || '';
                     break;
+                case 'project':
+                    aVal = a.frontmatter.project || '';
+                    bVal = b.frontmatter.project || '';
+                    break;
                 case 'author':
                     aVal = a.frontmatter.author || '';
                     bVal = b.frontmatter.author || '';
@@ -578,6 +582,11 @@
             tdCategory.appendChild(catBadge);
             tr.appendChild(tdCategory);
 
+            // Project cell
+            var tdProject = document.createElement('td');
+            tdProject.textContent = adr.frontmatter.project || '-';
+            tr.appendChild(tdProject);
+
             // Author cell
             var tdAuthor = document.createElement('td');
             tdAuthor.textContent = adr.frontmatter.author || '-';
@@ -850,6 +859,7 @@
 
         var metaItems = [
             { label: 'Category', value: fm.category || '-' },
+            { label: 'Project', value: fm.project || '-' },
             { label: 'Author', value: fm.author || '-' },
             { label: 'Project', value: fm.project || '-' },
             { label: 'Created', value: formatDate(fm.created) },

templates/styles.css

@@ -523,6 +523,7 @@ table {
 /* View Containers */
 .view-container {
     min-height: 400px;
+    overflow-x: auto;
 }
 
 /* ============================================================================

templates/viewer.html

@@ -136,6 +136,7 @@ <h3>Date Range</h3>
                                 <th class="sortable" data-sort="status">Status</th>
                                 <th class="sortable" data-sort="title">Title</th>
                                 <th class="sortable" data-sort="category">Category</th>
+                                <th class="sortable" data-sort="project">Project</th>
                                 <th class="sortable" data-sort="author">Author</th>
                                 <th class="sortable" data-sort="created">Created</th>
                                 <th class="sortable" data-sort="updated">Updated</th>