rename: kafka → samsa

Full project rename from kafka to samsa (after Gregor Samsa, who
woke one morning from uneasy dreams to find himself transformed).

- Module: github.com/metamorphosis-dev/kafka → samsa
- Binary: cmd/kafka/ → cmd/samsa/
- CSS: kafka.css → samsa.css
- UI: all 'kafka' product names, titles, localStorage keys → samsa
- localStorage keys: kafka-theme → samsa-theme, kafka-engines → samsa-engines
- OpenSearch: ShortName, LongName, description, URLs updated
- AGPL headers: 'kafka' → 'samsa'
- Docs, configs, examples updated
- Cache key prefix: kafka: → samsa:

docs/superpowers/plans/2026-03-22-brave-search-frontend-redesign.md

@@ -2,7 +2,7 @@
 
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 
-**Goal:** Redesign the kafka frontend to match Brave Search's layout: three-column results page, category tiles on homepage, and a hybrid preferences system with full-page `/preferences` route.
+**Goal:** Redesign the samsa frontend to match Brave Search's layout: three-column results page, category tiles on homepage, and a hybrid preferences system with full-page `/preferences` route.
 
 **Architecture:** CSS Grid for page-level layouts (three-column results, two-column preferences). JavaScript popover for quick settings (theme + engines only). Server-rendered full preferences page with localStorage persistence. Category tiles are static links with category query params.
 
@@ -14,7 +14,7 @@
 
 | File | Responsibility |
 |------|----------------|
-| `internal/views/static/css/kafka.css` | Add layout grids, category tiles, sidebar styles, mobile breakpoints |
+| `internal/views/static/css/samsa.css` | Add layout grids, category tiles, sidebar styles, mobile breakpoints |
 | `internal/views/templates/index.html` | Add category tiles below search box |
 | `internal/views/templates/results.html` | Add left sidebar, restructure for three-column grid |
 | `internal/views/templates/preferences.html` | **New** — full preferences page with nav |
@@ -30,11 +30,11 @@
 ### Task 1: Add CSS Grid Layouts and Breakpoints
 
 **Files:**
-- Modify: `internal/views/static/css/kafka.css`
+- Modify: `internal/views/static/css/samsa.css`
 
 - [ ] **Step 1: Add three-column results layout CSS**
 
-Append to end of `kafka.css`, before the `@media print` block:
+Append to end of `samsa.css`, before the `@media print` block:
 
 ```css
 /* ============================================================
@@ -364,7 +364,7 @@ Note: CSS is embedded as static files and not processed by the Go compiler. CSS
 - [ ] **Step 7: Commit**
 
 ```bash
-git add internal/views/static/css/kafka.css
+git add internal/views/static/css/samsa.css
 git commit -m "feat(frontend): add CSS layout framework for three-column results and preferences page"
 ```
 
@@ -895,7 +895,7 @@ git commit -m "feat(frontend): add category tiles to homepage"
 
 - [ ] **Step 2: Add preferences section CSS styles**
 
-Append to `kafka.css`:
+Append to `samsa.css`:
 
 ```css
 /* ============================================================
@@ -1010,7 +1010,7 @@ func RenderPreferences(w http.ResponseWriter, sourceURL string) error {
 - [ ] **Step 4: Commit**
 
 ```bash
-git add internal/views/templates/preferences.html internal/views/static/css/kafka.css internal/views/views.go
+git add internal/views/templates/preferences.html internal/views/static/css/samsa.css internal/views/views.go
 git commit -m "feat(frontend): add preferences page template and styles"
 ```
 
@@ -1020,7 +1020,7 @@ git commit -m "feat(frontend): add preferences page template and styles"
 
 **Files:**
 - Modify: `internal/httpapi/handlers.go`
-- Modify: `cmd/kafka/main.go`
+- Modify: `cmd/samsa/main.go`
 
 - [ ] **Step 1: Add GET and POST handlers for /preferences**
 
@@ -1053,7 +1053,7 @@ func (h *Handler) PreferencesPOST(w http.ResponseWriter, r *http.Request) {
 
 - [ ] **Step 2: Register the route in main**
 
-Find where routes are registered (likely in `cmd/kafka/main.go`) and add:
+Find where routes are registered (likely in `cmd/samsa/main.go`) and add:
 
 ```go
 mux.HandleFunc("GET /preferences", handler.Preferences)
@@ -1068,7 +1068,7 @@ Expected: No errors
 - [ ] **Step 4: Commit**
 
 ```bash
-git add internal/httpapi/handlers.go cmd/kafka/main.go
+git add internal/httpapi/handlers.go cmd/samsa/main.go
 git commit -m "feat: add GET and POST /preferences route"
 ```
 
@@ -1192,7 +1192,7 @@ git commit -m "fix(frontend): add HTMX filter submission"
 ### Task 8: Final Mobile Responsiveness Audit
 
 **Files:**
-- Review: `internal/views/static/css/kafka.css`
+- Review: `internal/views/static/css/samsa.css`
 
 - [ ] **Step 1: Test all breakpoints manually**
 
@@ -1201,7 +1201,7 @@ git commit -m "fix(frontend): add HTMX filter submission"
 - [ ] **Step 3: Commit any fixes**
 
 ```bash
-git add internal/views/static/css/kafka.css
+git add internal/views/static/css/samsa.css
 git commit -m "fix(frontend): improve mobile responsiveness"
 ```
 
@@ -1211,7 +1211,7 @@ git commit -m "fix(frontend): improve mobile responsiveness"
 
 | Phase | Task | Files |
 |-------|------|-------|
-| 1 | CSS Layout Framework | `kafka.css` |
+| 1 | CSS Layout Framework | `samsa.css` |
 | 2 | Results Three-Column | `results.html`, `views.go` |
 | 3 | Homepage Tiles | `index.html` |
 | 4 | Preferences Page | `preferences.html` (new), `handlers.go`, `settings.js` |