chore: add guardrails — TypeScript fixes, ESLint, Prettier, Husky, CI (GAB-19)

- Fix 7 TypeScript errors in reddit-poller.ts (implicit any, possibly
  undefined comicswapData fields); add RawRedditPost interface for the
  raw Reddit API response shape
- Add Prettier (.prettierrc, .prettierignore, format/format:check scripts);
  reformat all files to enforce consistent style
- Add root ESLint flat config targeting *.ts; fix dashboard eslint.config.js
  to also lint *.ts/*.tsx (was js/jsx only); add lint/lint:fix scripts
- Add Husky pre-commit hook running lint-staged + tsc --noEmit
- Add GitHub Actions CI workflow (lint, format:check, tsc, build on push/PR
  to main)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: celias

.claude/agents/image-strategy.md

@@ -138,7 +138,7 @@ Execution requirements:
 - Asynchronous queue/worker so poller cadence and API latency are unaffected
 - Rate limiting + retries with backoff
 - Confidence policy:
-  - >= 0.85 auto-attach
+  - > = 0.85 auto-attach
   - 0.60 to 0.84 hold for manual-review path
   - < 0.60 keep empty
 

.claude/commands/junior-review.md

@@ -3,6 +3,7 @@ Pull up ticket $ARGUMENTS from Linear and review the plan like a junior engineer
 Your job is NOT to implement it. Your job is to ask every question you can think of before a single line of code gets written.
 
 For every statement in the plan, ask yourself:
+
 - What if this fails? What's the fallback?
 - Is this ambiguous? Could I interpret it two different ways?
 - What are the edge cases?

.claude/commands/lessons-learned.md

@@ -1,6 +1,7 @@
 Something went wrong or took too long. Let's capture it.
 
 Ask me:
+
 1. What happened?
 2. Why did it happen? (Push past "I messed up" — what's the systemic reason?)
 3. What's the rule going forward to prevent this?

.claude/commands/work-ticket.md

@@ -2,15 +2,6 @@ Pull up ticket $ARGUMENTS from Linear using get_issue.
 
 1. Read the ticket fully — acceptance criteria, implementation plan, testing plan, and any comments.
 
-**Before doing any work, check if it's already done:**
-2. Search the codebase for evidence the work described in the ticket already exists (grep for key identifiers, function names, routes, or UI elements mentioned in the acceptance criteria).
-3. Check git log on main for recent commits that may have addressed this work.
-4. If the work appears already complete, tell me what you found and ask whether to close the ticket as-is or continue.
+**Before doing any work, check if it's already done:** 2. Search the codebase for evidence the work described in the ticket already exists (grep for key identifiers, function names, routes, or UI elements mentioned in the acceptance criteria). 3. Check git log on main for recent commits that may have addressed this work. 4. If the work appears already complete, tell me what you found and ask whether to close the ticket as-is or continue.
 
-**If work is not already done:**
-5. Use list_issue_statuses to find the correct "Done" or "Complete" status ID for this team.
-6. Implement everything described in the ticket. Reference specific files and follow the implementation plan order.
-7. Run any relevant tests and verify acceptance criteria are met.
-8. Show me a summary of what was done and ask for confirmation before closing.
-9. On confirmation, use save_issue to move the ticket to the "Done" status.
-10. Use save_comment to add a brief summary of what was implemented and any notable decisions made.
+**If work is not already done:** 5. Use list_issue_statuses to find the correct "Done" or "Complete" status ID for this team. 6. Implement everything described in the ticket. Reference specific files and follow the implementation plan order. 7. Run any relevant tests and verify acceptance criteria are met. 8. Show me a summary of what was done and ask for confirmation before closing. 9. On confirmation, use save_issue to move the ticket to the "Done" status. 10. Use save_comment to add a brief summary of what was implemented and any notable decisions made.

.github/instructions/api-files.instructions.md

@@ -26,7 +26,7 @@ try {
   const response = await fetch(url);
   if (!response.ok) {
     throw new Error(
-      `API request failed: ${response.status} ${response.statusText}`,
+      `API request failed: ${response.status} ${response.statusText}`
     );
   }
   const data = await response.json();

.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run format:check
+      - run: npx tsc --noEmit
+      - run: npm run build

.husky/pre-commit

@@ -0,0 +1,2 @@
+npx lint-staged
+npx tsc --noEmit

.prettierignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+generated
+dashboard/dist

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 80
+}

CLAUDE.md

@@ -15,11 +15,11 @@ Comic Hunter monitors Reddit for free and cheap comic deals, scores posts by key
 
 ## Architecture — 3 Processes
 
-| Process | File | Port | Purpose |
-|---------|------|------|---------|
-| Reddit Poller | `reddit-poller.ts` | — | Polls subreddits, scores posts, saves alerts, fires Discord webhooks |
-| API Server | `api-server.ts` | 3001 | Express — serves alerts and keyword data to the dashboard |
-| Dashboard | `dashboard/` | 5173 | React — real-time alert browser with filters |
+| Process       | File               | Port | Purpose                                                              |
+| ------------- | ------------------ | ---- | -------------------------------------------------------------------- |
+| Reddit Poller | `reddit-poller.ts` | —    | Polls subreddits, scores posts, saves alerts, fires Discord webhooks |
+| API Server    | `api-server.ts`    | 3001 | Express — serves alerts and keyword data to the dashboard            |
+| Dashboard     | `dashboard/`       | 5173 | React — real-time alert browser with filters                         |
 
 ## Common Commands