refactor: split main.rs into types, hn_api, and ui modules

Extract data types into types.rs, HTTP functions into hn_api.rs, and
rendering into ui.rs to match the documented architecture. Add make
format and make verify targets. Fix all clippy warnings.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: program247365

CLAUDE.md

@@ -0,0 +1,41 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What This Is
+
+Hackertuah is a Rust TUI application for browsing Hacker News. It uses ratatui/crossterm for the terminal UI, tokio/reqwest for async HTTP, and integrates with the Claude API for story summarization. The app features vim-style navigation, a command palette, search/filter, and section switching (Top, Ask, Show, Jobs).
+
+## Build & Run
+
+```bash
+make build        # cargo build
+make run          # cargo run
+make test         # cargo test
+make lint         # cargo clippy -- -D warnings
+make format       # cargo fmt
+make verify       # format + lint + build + test (run after any change)
+make clean        # cargo clean
+make install      # release build + copy binary to ~/bin
+make bump         # cog bump --auto (cocogitto versioning)
+```
+
+## Architecture
+
+The `src/` directory is split by concern:
+
+- **`types.rs`** — Data types: `Story`, `Section`, `Mode`, `ClaudeRequest`, `Message`. No dependencies on other local modules.
+- **`hn_api.rs`** — HTTP layer: `fetch_stories` (HN Firebase API) and `get_claude_summary` (Anthropic API). Depends on `types`.
+- **`ui.rs`** — All rendering: `draw_ui`, `draw_menu`, `draw_summary`, `draw_command_palette`, `centered_rect`. Depends on `types` and `app`.
+- **`loading_screen.rs`** — `MatrixRain` struct for the Matrix-style loading animation.
+- **`main.rs`** — `App` struct (all application state), `Command`/`CommandPalette`, terminal setup/teardown, and the main event loop. `App` is exposed via `pub mod app` so `ui.rs` can reference it.
+
+The app uses a single-threaded tokio runtime. Story fetching spawns tokio tasks per section that run concurrently. The `App` struct holds all state: stories, UI mode, cached stories per section, command palette state, and search state.
+
+## Key Details
+
+- HN API: Firebase REST API at `hacker-news.firebaseio.com/v0/`. Fetches up to 100 stories per section.
+- Claude API: Requires `CLAUDE_API_KEY` env var. Currently hardcoded to `claude-3-opus-20240229` model.
+- Versioning: Uses cocogitto (`cog.toml`) with conventional commits. Changelog at `CHANGELOG.md`.
+- CI: GitHub Actions runs `cargo build` and `cargo test` on push/PR to main.
+- Cargo.toml lists edition 2021; version is `0.1.0` (behind the `0.2.0` tag from cog).

Makefile

@@ -1,11 +1,13 @@
-.PHONY: help build run test lint clean bump install
+.PHONY: help build run test lint format verify clean bump install
 
 help:
 	@echo "Available commands:"
 	@echo "  make build   - Build the project (cargo build)"
 	@echo "  make run     - Run the project (cargo run)"
 	@echo "  make test    - Run tests (cargo test)"
 	@echo "  make lint    - Run clippy linter (cargo clippy)"
+	@echo "  make format  - Run cargo fmt"
+	@echo "  make verify  - Format, lint, build, and test (use after any change)"
 	@echo "  make clean   - Clean build artifacts (cargo clean)"
 	@echo "  make bump    - Bump version with cog (cog bump --auto)"
 	@echo "  make install - Build and install binary to system bin directory"
@@ -22,6 +24,11 @@ test:
 lint:
 	cargo clippy -- -D warnings
 
+format:
+	cargo fmt
+
+verify: format lint build test
+
 clean:
 	cargo clean
 

src/hn_api.rs

@@ -0,0 +1,55 @@
+use std::error::Error;
+
+use crate::types::{ClaudeRequest, Message, Section, Story};
+
+pub async fn fetch_stories(section: Section) -> Result<Vec<Story>, Box<dyn Error + Send + Sync>> {
+    let client = reqwest::Client::new();
+
+    let ids: Vec<u32> = client
+        .get(section.get_api_url())
+        .send()
+        .await?
+        .json()
+        .await?;
+
+    let mut stories = Vec::new();
+    for id in ids.iter().take(100) {
+        let story: Story = client
+            .get(format!(
+                "https://hacker-news.firebaseio.com/v0/item/{}.json",
+                id
+            ))
+            .send()
+            .await?
+            .json()
+            .await?;
+        stories.push(story);
+    }
+
+    Ok(stories)
+}
+
+pub async fn get_claude_summary(text: &str) -> Result<String, Box<dyn Error + Send + Sync>> {
+    let client = reqwest::Client::new();
+
+    let request = ClaudeRequest {
+        model: "claude-3-opus-20240229".to_string(),
+        messages: vec![Message {
+            role: "user".to_string(),
+            content: format!(
+                "Please summarize this Hacker News post concisely:\n\n{}",
+                text
+            ),
+        }],
+        max_tokens: 150,
+    };
+
+    let response = client
+        .post("https://api.anthropic.com/v1/messages")
+        .header("x-api-key", std::env::var("CLAUDE_API_KEY")?)
+        .json(&request)
+        .send()
+        .await?;
+
+    Ok(response.text().await?)
+}

src/loading_screen.rs

@@ -71,7 +71,7 @@ impl MatrixRain {
             for x in 0..self.chars.len() {
                 let pos = self.positions[x] as i32;
                 let char_index = (y as i32 - pos).rem_euclid(self.chars[x].len() as i32) as usize;
-                let intensity = ((y as i32 - pos) as f32 * 0.5).min(1.0).max(0.0);
+                let intensity = ((y as i32 - pos) as f32 * 0.5).clamp(0.0, 1.0);
 
                 if intensity <= 0.0 {
                     line.push(Span::styled(