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:

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-kafka is a privacy-respecting metasearch engine written in Go. It provides a SearXNG-compatible `/search` API and an HTML frontend (HTMX + Go templates). 9 engines are implemented natively in Go; unlisted engines can be proxied to an upstream metasearch instance. Responses from multiple engines are merged into a single JSON/CSV/RSS/HTML response.
+samsa is a privacy-respecting metasearch engine written in Go. It provides a SearXNG-compatible `/search` API and an HTML frontend (HTMX + Go templates). 9 engines are implemented natively in Go; unlisted engines can be proxied to an upstream metasearch instance. Responses from multiple engines are merged into a single JSON/CSV/RSS/HTML response.
 
 ## Build & Run Commands
 
@@ -22,7 +22,7 @@ go test -run TestWikipedia ./internal/engines/
 go test -v ./internal/engines/
 
 # Run the server (requires config.toml)
-go run ./cmd/kafka -config config.toml
+go run ./cmd/samsa -config config.toml
 ```
 
 There is no Makefile. There is no linter configured.
@@ -43,7 +43,7 @@ There is no Makefile. There is no linter configured.
 - `internal/cache` — Valkey/Redis-backed cache with SHA-256 cache keys. No-op if unconfigured.
 - `internal/middleware` — Three rate limiters (per-IP sliding window, burst+sustained, global) and CORS. All disabled by default.
 - `internal/views` — HTML templates and static files embedded via `//go:embed`. Renders full pages or HTMX fragments. Templates: `base.html`, `index.html`, `results.html`, `results_inner.html`, `result_item.html`.
-- `cmd/kafka` — Entry point. Loads TOML config, seeds env vars for engine code, wires up middleware chain, starts HTTP server.
+- `cmd/samsa` — Entry point. Loads TOML config, seeds env vars for engine code, wires up middleware chain, starts HTTP server.
 
 **Engine interface** (`internal/engines/engine.go`):
 ```go
@@ -66,7 +66,7 @@ Config is loaded from `config.toml` (see `config.example.toml`). All fields can
 
 ## Conventions
 
-- Module path: `github.com/metamorphosis-dev/kafka`
+- Module path: `github.com/metamorphosis-dev/samsa`
 - Tests use shared mock helpers in `internal/engines/http_mock_test.go` (`roundTripperFunc`, `httpResponse`)
 - Engine implementations are single files under `internal/engines/` (e.g., `wikipedia.go`, `duckduckgo.go`)
 - Response merging de-duplicates by `engine|title|url` key; suggestions/corrections are merged as sets

README.md

@@ -1,4 +1,4 @@
-# kafka
+# samsa
 
 A privacy-respecting, open metasearch engine written in Go. SearXNG-compatible API with an HTML frontend, designed to be fast, lightweight, and deployable anywhere.
 
@@ -12,7 +12,7 @@ A privacy-respecting, open metasearch engine written in Go. SearXNG-compatible A
 - **Valkey cache** — optional Redis-compatible caching with configurable TTL
 - **Rate limiting** — three layers: per-IP, burst, and global (all disabled by default)
 - **CORS** — configurable origins for browser-based clients
-- **OpenSearch** — browsers can add kafka as a search engine from the address bar
+- **OpenSearch** — browsers can add samsa as a search engine from the address bar
 - **Graceful degradation** — individual engine failures don't kill the whole search
 - **Docker** — multi-stage build, ~20MB runtime image
 - **NixOS** — native NixOS module with systemd service
@@ -23,9 +23,9 @@ A privacy-respecting, open metasearch engine written in Go. SearXNG-compatible A
 
 ```bash
 git clone https://git.ashisgreat.xyz/penal-colony/gosearch.git
-cd kafka
+cd samsa
-go build ./cmd/kafka
+go build ./cmd/samsa
-./kafka -config config.toml
+./samsa -config config.toml
 ```
 
 ### Docker Compose
@@ -41,28 +41,28 @@ docker compose up -d
 Add to your flake inputs:
 
 ```nix
-inputs.kafka.url = "git+https://git.ashisgreat.xyz/penal-colony/gosearch.git";
+inputs.samsa.url = "git+https://git.ashisgreat.xyz/penal-colony/gosearch.git";
 ```
 
 Enable in your configuration:
 
 ```nix
-imports = [ inputs.kafka.nixosModules.default ];
+imports = [ inputs.samsa.nixosModules.default ];
 
-services.kafka = {
+services.samsa = {
   enable = true;
   openFirewall = true;
   baseUrl = "https://search.example.com";
-  # config = "/etc/kafka/config.toml";  # default
+  # config = "/etc/samsa/config.toml";  # default
 };
 ```
 
 Write your config:
 
 ```bash
-sudo mkdir -p /etc/kafka
+sudo mkdir -p /etc/samsa
-sudo cp config.example.toml /etc/kafka/config.toml
+sudo cp config.example.toml /etc/samsa/config.toml
-sudo $EDITOR /etc/kafka/config.toml
+sudo $EDITOR /etc/samsa/config.toml
 ```
 
 Deploy:
@@ -76,7 +76,7 @@ sudo nixos-rebuild switch --flake .#
 ```bash
 nix develop
 go test ./...
-go run ./cmd/kafka -config config.toml
+go run ./cmd/samsa -config config.toml
 ```
 
 ## Endpoints

cmd/samsa/main.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -25,13 +25,13 @@ import (
 	"net/http"
 	"os"
 
-	"github.com/metamorphosis-dev/kafka/internal/autocomplete"
+	"github.com/metamorphosis-dev/samsa/internal/autocomplete"
-	"github.com/metamorphosis-dev/kafka/internal/cache"
+	"github.com/metamorphosis-dev/samsa/internal/cache"
-	"github.com/metamorphosis-dev/kafka/internal/config"
+	"github.com/metamorphosis-dev/samsa/internal/config"
-	"github.com/metamorphosis-dev/kafka/internal/httpapi"
+	"github.com/metamorphosis-dev/samsa/internal/httpapi"
-	"github.com/metamorphosis-dev/kafka/internal/middleware"
+	"github.com/metamorphosis-dev/samsa/internal/middleware"
-	"github.com/metamorphosis-dev/kafka/internal/search"
+	"github.com/metamorphosis-dev/samsa/internal/search"
-	"github.com/metamorphosis-dev/kafka/internal/views"
+	"github.com/metamorphosis-dev/samsa/internal/views"
 )
 
 func main() {
@@ -127,7 +127,7 @@ func main() {
 	}, logger)(handler)
 
 	addr := fmt.Sprintf(":%d", cfg.Server.Port)
-	logger.Info("kafka starting",
+	logger.Info("samsa starting",
 		"addr", addr,
 		"cache", searchCache.Enabled(),
 		"rate_limit", cfg.RateLimit.Requests > 0,

config.example.toml

@@ -1,4 +1,4 @@
-# kafka configuration
+# samsa configuration
 # Copy to config.toml and adjust as needed.
 # Environment variables are used as fallbacks when a config field is empty/unset.
 
@@ -10,13 +10,13 @@ port = 8080
 http_timeout = "10s"
 
 # Public base URL for OpenSearch XML (env: BASE_URL)
-# Set this so browsers can add kafka as a search engine.
+# Set this so browsers can add samsa as a search engine.
 # Example: "https://search.example.com"
 base_url = ""
 
 # Link to the source code (shown in footer as "Source" link)
-# Defaults to the upstream kafka repo if not set.
+# Defaults to the upstream samsa repo if not set.
-# Example: "https://git.example.com/my-kafka-fork"
+# Example: "https://git.example.com/my-samsa-fork"
 source_url = ""
 
 [upstream]

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` |

docs/superpowers/plans/2026-03-22-settings-ui.md

@@ -4,9 +4,9 @@
 
 **Goal:** A preferences popover panel (top-right on desktop, bottom sheet on mobile) that lets users set theme, enabled engines, safe search, and default format. All changes auto-save to `localStorage` and apply immediately to the DOM.
 
-**Architecture:** Pure client-side JS + CSS added alongside existing templates. No Go changes. Settings persist via `localStorage` key `kafka_prefs`. Theme applies via `data-theme` attribute on `<html>`.
+**Architecture:** Pure client-side JS + CSS added alongside existing templates. No Go changes. Settings persist via `localStorage` key `samsa_prefs`. Theme applies via `data-theme` attribute on `<html>`.
 
-**Tech Stack:** Vanilla JS (no framework), existing `kafka.css` custom properties, HTMX for search.
+**Tech Stack:** Vanilla JS (no framework), existing `samsa.css` custom properties, HTMX for search.
 
 ---
 
@@ -15,7 +15,7 @@
 | Action | File |
 |--------|------|
 | Create | `internal/views/static/js/settings.js` |
-| Modify | `internal/views/static/css/kafka.css` |
+| Modify | `internal/views/static/css/samsa.css` |
 | Modify | `internal/views/templates/base.html` |
 | Modify | `internal/views/templates/index.html` |
 | Modify | `internal/views/templates/results.html` |
@@ -28,11 +28,11 @@
 ## Task 1: CSS — Popover, toggles, bottom sheet
 
 **Files:**
-- Modify: `internal/views/static/css/kafka.css`
+- Modify: `internal/views/static/css/samsa.css`
 
 - [ ] **Step 1: Add CSS for popover, triggers, toggles, bottom sheet**
 
-Append the following to `kafka.css`:
+Append the following to `samsa.css`:
 
 ```css
 /* ============================================
@@ -305,7 +305,7 @@ Expected: all pass
 - [ ] **Step 3: Commit**
 
 ```bash
-git add internal/views/static/css/kafka.css
+git add internal/views/static/css/samsa.css
 git commit -m "feat(settings): add popover, toggle, and bottom-sheet CSS"
 ```
 
@@ -335,7 +335,7 @@ var DEFAULT_PREFS = {
   format: 'html'
 };
 
-var STORAGE_KEY = 'kafka_prefs';
+var STORAGE_KEY = 'samsa_prefs';
 
 // ── Persistence ──────────────────────────────────────────────────────────────
 
@@ -619,7 +619,7 @@ In `base.html`, update the `<body>` to:
 <body class="{{if .Query}}search_on_results{{end}}">
   {{if .ShowHeader}}
   <header class="site-header">
-    <span class="site-title">kafka</span>
+    <span class="site-title">samsa</span>
     <!-- Desktop trigger (hidden on mobile) -->
     <button id="settings-trigger" class="settings-trigger settings-trigger-desktop"
       aria-label="Preferences" aria-expanded="false" aria-controls="settings-popover">&#9881;</button>
@@ -633,7 +633,7 @@ In `base.html`, update the `<body>` to:
     {{template "content" .}}
   </main>
   <footer>
-    <p>Powered by <a href="https://git.ashisgreat.xyz/penal-colony/kafka">kafka</a> — a privacy-respecting, open metasearch engine</p>
+    <p>Powered by <a href="https://git.ashisgreat.xyz/penal-colony/samsa">samsa</a> — a privacy-respecting, open metasearch engine</p>
   </footer>
   <script src="/static/js/settings.js"></script>
   <div id="settings-popover" data-open="false" role="dialog" aria-label="Preferences" aria-modal="true">
@@ -699,7 +699,7 @@ The `value` is populated by `syncEngineInput(prefs)` on page load. When the form
 
 - [ ] **Step 2: Verify existing search works**
 
-Run: `go run ./cmd/kafka -config config.toml`
+Run: `go run ./cmd/samsa -config config.toml`
 Open: `http://localhost:8080`
 Search for "golang" — results should appear as normal.
 
@@ -716,7 +716,7 @@ git commit -m "feat(settings): add hidden engines input to search forms"
 
 - [ ] **Step 1: Start server**
 
-Run: `go run ./cmd/kafka -config config.toml`
+Run: `go run ./cmd/samsa -config config.toml`
 Open: `http://localhost:8080`
 
 - [ ] **Step 2: Verify gear icon and panel**

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

@@ -2,7 +2,7 @@
 
 ## Overview
 
-Redesign the kafka frontend to match Brave Search's clean, functional aesthetic with emphasis on layout changes: three-column results page, category tiles on homepage, and a hybrid preferences system with full-page `/preferences` route.
+Redesign the samsa frontend to match Brave Search's clean, functional aesthetic with emphasis on layout changes: three-column results page, category tiles on homepage, and a hybrid preferences system with full-page `/preferences` route.
 
 ## Design Principles
 
@@ -302,7 +302,7 @@ On mobile (< 768px):
 | `internal/views/templates/results.html` | Add left sidebar, restructure for three columns |
 | `internal/views/templates/base.html` | Minimal changes (no structural changes needed) |
 | `internal/views/templates/preferences.html` | **New** — full preferences page |
-| `internal/views/static/css/kafka.css` | Add layout grids, category tiles, sidebar styles, sticky positioning, mobile breakpoints |
+| `internal/views/static/css/samsa.css` | Add layout grids, category tiles, sidebar styles, sticky positioning, mobile breakpoints |
 | `internal/views/static/js/settings.js` | Reduce popover to theme + engines; add preferences page JS |
 | `internal/httpapi/httpapi.go` | Add `/preferences` route (GET + POST) |
 | `internal/views/views.go` | Add preferences template rendering |

docs/superpowers/specs/2026-03-22-settings-ui-design.md

@@ -1,4 +1,4 @@
-# Settings UI Design — kafka
+# Settings UI Design — samsa
 
 **Date:** 2026-03-22
 **Status:** Approved
@@ -61,10 +61,10 @@ const DEFAULT_PREFS = {
 
 ```js
 // Written on every interaction
-localStorage.setItem('kafka_prefs', JSON.stringify({ ... }));
+localStorage.setItem('samsa_prefs', JSON.stringify({ ... }));
 
 // Read on page load — merge with DEFAULT_PREFS
-const saved = JSON.parse(localStorage.getItem('kafka_prefs') || '{}');
+const saved = JSON.parse(localStorage.getItem('samsa_prefs') || '{}');
 const prefs = { ...DEFAULT_PREFS, ...saved };
 ```
 
@@ -76,5 +76,5 @@ const prefs = { ...DEFAULT_PREFS, ...saved };
 ## Applied to Existing Code
 
 - `base.html` — add gear button in header, panel markup at end of `<body>`
-- `kafka.css` — popover styles, toggle switch styles, bottom sheet styles for mobile
+- `samsa.css` — popover styles, toggle switch styles, bottom sheet styles for mobile
 - `settings.js` — localStorage read/write, theme application, panel toggle, aria attributes, focus trap

go.mod

@@ -1,4 +1,4 @@
-module github.com/metamorphosis-dev/kafka
+module github.com/metamorphosis-dev/samsa
 
 go 1.24
 

internal/autocomplete/service.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -102,7 +102,7 @@ func (s *Service) wikipediaSuggestions(ctx context.Context, query string) ([]str
 	}
 	req.Header.Set(
 		"User-Agent",
-		"gosearch-go/0.1 (compatible; +https://github.com/metamorphosis-dev/kafka)",
+		"gosearch-go/0.1 (compatible; +https://github.com/metamorphosis-dev/samsa)",
 	)
 
 	resp, err := s.http.Do(req)

internal/cache/cache.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -25,7 +25,7 @@ import (
 	"log/slog"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 	"github.com/redis/go-redis/v9"
 )
 
@@ -97,7 +97,7 @@ func (c *Cache) Get(ctx context.Context, key string) (contracts.SearchResponse,
 		return contracts.SearchResponse{}, false
 	}
 
-	fullKey := "kafka:" + key
+	fullKey := "samsa:" + key
 
 	data, err := c.client.Get(ctx, fullKey).Bytes()
 	if err != nil {
@@ -129,7 +129,7 @@ func (c *Cache) Set(ctx context.Context, key string, resp contracts.SearchRespon
 		return
 	}
 
-	fullKey := "kafka:" + key
+	fullKey := "samsa:" + key
 	if err := c.client.Set(ctx, fullKey, data, c.ttl).Err(); err != nil {
 		c.logger.Warn("cache set failed", "key", fullKey, "error", err)
 	}
@@ -140,7 +140,7 @@ func (c *Cache) Invalidate(ctx context.Context, key string) {
 	if !c.Enabled() {
 		return
 	}
-	fullKey := "kafka:" + key
+	fullKey := "samsa:" + key
 	c.client.Del(ctx, fullKey)
 }
 

internal/cache/cache_test.go

@@ -3,13 +3,13 @@ package cache
 import (
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestKey_Deterministic(t *testing.T) {
 	req := contracts.SearchRequest{
 		Format:     contracts.FormatJSON,
-		Query:      "kafka metamorphosis",
+		Query:      "samsa metamorphosis",
 		Pageno:     1,
 		Safesearch: 0,
 		Language:   "auto",
@@ -29,7 +29,7 @@ func TestKey_Deterministic(t *testing.T) {
 }
 
 func TestKey_DifferentQueries(t *testing.T) {
-	reqA := contracts.SearchRequest{Query: "kafka", Format: contracts.FormatJSON}
+	reqA := contracts.SearchRequest{Query: "samsa", Format: contracts.FormatJSON}
 	reqB := contracts.SearchRequest{Query: "orwell", Format: contracts.FormatJSON}
 
 	if Key(reqA) == Key(reqB) {

internal/config/config.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -23,10 +23,10 @@ import (
 	"time"
 
 	"github.com/BurntSushi/toml"
-	"github.com/metamorphosis-dev/kafka/internal/util"
+	"github.com/metamorphosis-dev/samsa/internal/util"
 )
 
-// Config is the top-level configuration for the kafka service.
+// Config is the top-level configuration for the samsa service.
 type Config struct {
 	Server        ServerConfig         `toml:"server"`
 	Upstream      UpstreamConfig       `toml:"upstream"`

internal/contracts/main_result.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify

internal/contracts/types.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify

internal/engines/arxiv.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -28,7 +28,7 @@ import (
 	"strings"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 const (

internal/engines/arxiv_test.go

@@ -6,7 +6,7 @@ import (
 	"strings"
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestArxivEngine_Search(t *testing.T) {

internal/engines/bing.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -28,7 +28,7 @@ import (
 	"strconv"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // BingEngine searches Bing via the public Bing API.

internal/engines/bing_images.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -18,7 +18,7 @@ import (
 	"net/url"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // BingImagesEngine searches Bing Images via their public RSS endpoint.

internal/engines/bing_test.go

@@ -7,7 +7,7 @@ import (
 	"testing"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestBingEngine_EmptyQuery(t *testing.T) {

internal/engines/brave.go

@@ -9,7 +9,7 @@ import (
 	"regexp"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 type BraveEngine struct {

internal/engines/braveapi.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -27,7 +27,7 @@ import (
 	"strings"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // BraveEngine implements the Brave Web Search API.

internal/engines/braveapi_test.go

@@ -5,7 +5,7 @@ import (
 	"net/http"
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestBraveEngine_GatingAndHeader(t *testing.T) {

internal/engines/crossref.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -27,7 +27,7 @@ import (
 	"strings"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 type CrossrefEngine struct {

internal/engines/crossref_test.go

@@ -5,7 +5,7 @@ import (
 	"net/http"
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestCrossrefEngine_Search(t *testing.T) {

internal/engines/ddg_images.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -19,7 +19,7 @@ import (
 	"strconv"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // DuckDuckGoImagesEngine searches DuckDuckGo Images via their vql API.

internal/engines/duckduckgo.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -25,7 +25,7 @@ import (
 	"net/url"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // DuckDuckGoEngine searches DuckDuckGo's Lite/HTML endpoint.

internal/engines/duckduckgo_parse.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -21,7 +21,7 @@ import (
 	"net/url"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // parseDuckDuckGoHTML parses DuckDuckGo Lite's HTML response for search results.

internal/engines/duckduckgo_test.go

@@ -7,7 +7,7 @@ import (
 	"testing"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestDuckDuckGoEngine_EmptyQuery(t *testing.T) {

internal/engines/engine.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -19,7 +19,7 @@ package engines
 import (
 	"context"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // Engine is a Go-native implementation of a search engine.

internal/engines/factory.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -21,7 +21,7 @@ import (
 	"os"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/config"
+	"github.com/metamorphosis-dev/samsa/internal/config"
 )
 
 // NewDefaultPortedEngines returns the Go-native engine registry.

internal/engines/github.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -27,7 +27,7 @@ import (
 	"strings"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // GitHubEngine searches GitHub repositories and code via the public search API.

internal/engines/github_test.go

@@ -6,7 +6,7 @@ import (
 	"testing"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestGitHubEngine_EmptyQuery(t *testing.T) {

internal/engines/google.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -25,13 +25,13 @@ import (
 	"regexp"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // googleUserAgent is an honest User-Agent identifying the metasearch engine.
 // Using a spoofed GSA User-Agent violates Google's Terms of Service and
 // risks permanent IP blocking.
-var googleUserAgent = "Kafka/0.1 (compatible; +https://github.com/metamorphosis-dev/kafka)"
+var googleUserAgent = "Kafka/0.1 (compatible; +https://github.com/metamorphosis-dev/samsa)"
 
 type GoogleEngine struct {
 	client *http.Client

internal/engines/html_helpers.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify

internal/engines/planner.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -20,7 +20,7 @@ import (
 	"os"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 var defaultPortedEngines = []string{

internal/engines/qwant.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -26,7 +26,7 @@ import (
 	"net/url"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 	"github.com/PuerkitoBio/goquery"
 )
 

internal/engines/qwant_images.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -18,7 +18,7 @@ import (
 	"net/url"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // QwantImagesEngine searches Qwant Images via the v3 search API.

internal/engines/qwant_lite_test.go

@@ -5,7 +5,7 @@ import (
 	"net/http"
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestQwantEngine_WebLite(t *testing.T) {

internal/engines/qwant_test.go

@@ -5,7 +5,7 @@ import (
 	"net/http"
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestQwantEngine_Web(t *testing.T) {

internal/engines/reddit.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -26,7 +26,7 @@ import (
 	"net/url"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // RedditEngine searches Reddit posts via the public JSON API.

internal/engines/reddit_test.go

@@ -6,7 +6,7 @@ import (
 	"testing"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestRedditEngine_EmptyQuery(t *testing.T) {

internal/engines/stackoverflow.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -27,7 +27,7 @@ import (
 	"strings"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 const stackOverflowAPIBase = "https://api.stackexchange.com/2.3"

internal/engines/stackoverflow_test.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -23,7 +23,7 @@ import (
 	"net/http/httptest"
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestStackOverflow_Name(t *testing.T) {

internal/engines/wikipedia.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -26,7 +26,7 @@ import (
 	"net/url"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 type WikipediaEngine struct {
@@ -108,7 +108,7 @@ func (e *WikipediaEngine) Search(ctx context.Context, req contracts.SearchReques
 	// Wikimedia APIs require a descriptive User-Agent.
 	httpReq.Header.Set(
 		"User-Agent",
-		"gosearch-go/0.1 (compatible; +https://github.com/metamorphosis-dev/kafka)",
+		"gosearch-go/0.1 (compatible; +https://github.com/metamorphosis-dev/samsa)",
 	)
 	// Best-effort: hint content language.
 	if req.Language != "" && req.Language != "auto" {

internal/engines/wikipedia_test.go

@@ -5,7 +5,7 @@ import (
 	"net/http"
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestWikipediaEngine_Search(t *testing.T) {

internal/engines/youtube.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -27,7 +27,7 @@ import (
 	"strings"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 type YouTubeEngine struct {

internal/httpapi/handlers.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -22,9 +22,9 @@ import (
 	"net/http"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
-	"github.com/metamorphosis-dev/kafka/internal/search"
+	"github.com/metamorphosis-dev/samsa/internal/search"
-	"github.com/metamorphosis-dev/kafka/internal/views"
+	"github.com/metamorphosis-dev/samsa/internal/views"
 )
 
 type Handler struct {

internal/httpapi/httpapi_test.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -24,9 +24,9 @@ import (
 	"strings"
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
-	"github.com/metamorphosis-dev/kafka/internal/httpapi"
+	"github.com/metamorphosis-dev/samsa/internal/httpapi"
-	"github.com/metamorphosis-dev/kafka/internal/search"
+	"github.com/metamorphosis-dev/samsa/internal/search"
 )
 
 // mockUpstreamHandler returns controlled JSON responses.

internal/middleware/cors.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify

internal/middleware/ratelimit.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify

internal/middleware/ratelimit_global.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify

internal/middleware/security.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify

internal/search/merge.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -21,7 +21,7 @@ import (
 	"net/url"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 // MergeResponses merges multiple compatible JSON responses.

internal/search/merge_test.go

@@ -4,7 +4,7 @@ import (
 	"strings"
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func TestMergeResponses_DedupResultsAndSets(t *testing.T) {

internal/search/request_params.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify

internal/search/response.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -127,7 +127,7 @@ func writeCSV(w http.ResponseWriter, resp SearchResponse) error {
 
 func writeRSS(w http.ResponseWriter, resp SearchResponse) error {
 	q := resp.Query
-	escapedTitle := xmlEscape("kafka search: " + q)
+	escapedTitle := xmlEscape("samsa search: " + q)
 	escapedDesc := xmlEscape("Search results for \"" + q + "\" - kafka")
 	escapedQueryTerms := xmlEscape(q)
 

internal/search/service.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -22,11 +22,11 @@ import (
 	"sync"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/cache"
+	"github.com/metamorphosis-dev/samsa/internal/cache"
-	"github.com/metamorphosis-dev/kafka/internal/config"
+	"github.com/metamorphosis-dev/samsa/internal/config"
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
-	"github.com/metamorphosis-dev/kafka/internal/engines"
+	"github.com/metamorphosis-dev/samsa/internal/engines"
-	"github.com/metamorphosis-dev/kafka/internal/upstream"
+	"github.com/metamorphosis-dev/samsa/internal/upstream"
 )
 
 type ServiceConfig struct {

internal/search/service_test.go

@@ -6,8 +6,8 @@ import (
 	"testing"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
-	"github.com/metamorphosis-dev/kafka/internal/engines"
+	"github.com/metamorphosis-dev/samsa/internal/engines"
 )
 
 // mockEngine is a test engine that returns a predefined response or error.

internal/search/types.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -16,7 +16,7 @@
 
 package search
 
-import "github.com/metamorphosis-dev/kafka/internal/contracts"
+import "github.com/metamorphosis-dev/samsa/internal/contracts"
 
 // Re-export the JSON contract types so the rest of the code can stay in the
 // `internal/search` namespace without creating an import cycle.

internal/upstream/client.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -27,7 +27,7 @@ import (
 	"strings"
 	"time"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 type Client struct {

internal/util/validate.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify

internal/views/templates/base.html

@@ -6,12 +6,13 @@
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <meta name="referrer" content="no-referrer">
   <meta name="robots" content="noarchive">
-  <meta name="description" content="kafka — a privacy-respecting, open metasearch engine">
+  <meta name="description" content="samsa — a privacy-respecting, open metasearch engine">
-  <title>{{if .Query}}{{.Query}} — {{end}}kafka</title>
+  <title>{{if .Query}}{{.Query}} — {{end}}samsa</title>
-  <link rel="stylesheet" href="/static/css/kafka.css">
+  <link rel="stylesheet" href="/static/css/samsa.css">
   <link rel="icon" href="/static/img/favicon.svg" type="image/svg+xml">
-  <link title="kafka" type="application/opensearchdescription+xml" rel="search" href="/opensearch.xml">
+  <link title="samsa" type="application/opensearchdescription+xml" rel="search" href="/opensearch.xml">
-  <script>var s=document.documentElement;s.setAttribute('data-theme',localStorage.getItem('kafka-theme')||'light');</script>
+  <meta name="samsa" content="samsa">
+  <script>var s=document.documentElement;s.setAttribute('data-theme',localStorage.getItem('samsa-theme')||'light');</script>
 </head>
 <body>
   <header class="site-header">
@@ -20,7 +21,7 @@
         <circle cx="11" cy="11" r="8"/>
         <path d="m21 21-4.35-4.35"/>
       </svg>
-      <span class="site-name">kafka</span>
+      <span class="site-name">samsa</span>
     </a>
     <a href="/preferences" class="settings-link" title="Preferences">
       <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
@@ -35,7 +36,7 @@
   </main>
 
   <footer>
-    <p>Powered by <a href="https://git.ashisgreat.xyz/penal-colony/kafka">kafka</a> — a privacy-respecting, open metasearch engine{{if .SourceURL}} · <a href="{{.SourceURL}}">Source</a>{{end}} · <a href="https://www.gnu.org/licenses/agpl-3.0.html">AGPLv3</a></p>
+    <p>Powered by <a href="https://git.ashisgreat.xyz/penal-colony/samsa">samsa</a> — a privacy-respecting, open metasearch engine{{if .SourceURL}} · <a href="{{.SourceURL}}">Source</a>{{end}} · <a href="https://www.gnu.org/licenses/agpl-3.0.html">AGPLv3</a></p>
   </footer>
 </body>
 </html>

internal/views/templates/index.html

@@ -6,7 +6,7 @@
       <circle cx="11" cy="11" r="8"/>
       <path d="m21 21-4.35-4.35"/>
     </svg>
-    <span class="home-logo-text">kafka</span>
+    <span class="home-logo-text">samsa</span>
   </a>
   <p class="home-tagline">Private meta-search, powered by open source.</p>
 

internal/views/templates/opensearch.xml

@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
-  <ShortName>kafka</ShortName>
+  <ShortName>samsa</ShortName>
   <Description>A privacy-respecting, open metasearch engine</Description>
   <InputEncoding>UTF-8</InputEncoding>
   <OutputEncoding>UTF-8</OutputEncoding>
-  <LongName>kafka — Privacy-respecting metasearch</LongName>
+  <LongName>samsa — Privacy-respecting metasearch</LongName>
   <Image width="16" height="16" type="image/svg+xml">/static/img/favicon.svg</Image>
-  <Contact>https://git.ashisgreat.xyz/penal-colony/kafka</Contact>
+  <Contact>https://git.ashisgreat.xyz/penal-colony/samsa</Contact>
   <Url type="text/html" method="GET" template="{baseUrl}/search?q={searchTerms}&amp;format=html">
     <Param name="pageno" value="{startPage?}" />
     <Param name="language" value="{language?}" />

internal/views/templates/preferences.html

@@ -102,7 +102,7 @@
   var themeButtons = document.querySelectorAll('.theme-btn');
 
   // Load saved theme
-  var savedTheme = localStorage.getItem('kafka-theme') || 'light';
+  var savedTheme = localStorage.getItem('samsa-theme') || 'light';
   themeInput.value = savedTheme;
   document.querySelectorAll('.theme-btn').forEach(function(btn) {
     btn.classList.toggle('active', btn.dataset.theme === savedTheme);
@@ -116,12 +116,12 @@
       themeButtons.forEach(function(b) { b.classList.remove('active'); });
       btn.classList.add('active');
       document.documentElement.setAttribute('data-theme', theme);
-      localStorage.setItem('kafka-theme', theme);
+      localStorage.setItem('samsa-theme', theme);
     });
   });
 
   // Load saved engine preferences
-  var savedEngines = JSON.parse(localStorage.getItem('kafka-engines') || 'null');
+  var savedEngines = JSON.parse(localStorage.getItem('samsa-engines') || 'null');
   if (savedEngines) {
     savedEngines.forEach(function(engine) {
       var checkbox = document.querySelector('input[name="engine"][value="' + engine.id + '"]');
@@ -135,7 +135,7 @@
     document.querySelectorAll('input[name="engine"]').forEach(function(cb) {
       engines.push({ id: cb.value, enabled: cb.checked });
     });
-    localStorage.setItem('kafka-engines', JSON.stringify(engines));
+    localStorage.setItem('samsa-engines', JSON.stringify(engines));
   });
 })();
 </script>

internal/views/templates/results.html

@@ -7,7 +7,7 @@
         <circle cx="11" cy="11" r="8"/>
         <path d="m21 21-4.35-4.35"/>
       </svg>
-      <span>kafka</span>
+      <span>samsa</span>
     </a>
 
     <form class="header-search" method="GET" action="/search" role="search">

internal/views/views.go

@@ -1,4 +1,4 @@
-// kafka — a privacy-respecting metasearch engine
+// samsa — a privacy-respecting metasearch engine
 // Copyright (C) 2026-present metamorphosis-dev
 //
 // This program is free software: you can redistribute it and/or modify
@@ -26,8 +26,8 @@ import (
 	"strconv"
 	"strings"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
-	"github.com/metamorphosis-dev/kafka/internal/util"
+	"github.com/metamorphosis-dev/samsa/internal/util"
 )
 
 //go:embed all:templates

internal/views/views_test.go

@@ -3,7 +3,7 @@ package views
 import (
 	"testing"
 
-	"github.com/metamorphosis-dev/kafka/internal/contracts"
+	"github.com/metamorphosis-dev/samsa/internal/contracts"
 )
 
 func mockSearchResponse(query string, numResults int) contracts.SearchResponse {
@@ -36,10 +36,10 @@ func mockEmptyResponse() contracts.SearchResponse {
 }
 
 func TestFromResponse_Basic(t *testing.T) {
-	resp := mockSearchResponse("kafka trial", 42)
+	resp := mockSearchResponse("samsa trial", 42)
-	data := FromResponse(resp, "kafka trial", 1, "", "", "")
+	data := FromResponse(resp, "samsa trial", 1, "", "", "")
 
-	if data.Query != "kafka trial" {
+	if data.Query != "samsa trial" {
 		t.Errorf("expected query 'kafka trial', got %q", data.Query)
 	}
 	if data.NumberOfResults != 42 {