@tikoci/rosetta 0.5.0 → 0.5.1

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server that gives AI assistants searchable access to the complete [MikroTik RouterOS documentation](https://help.mikrotik.com/docs/spaces/ROS/overview) — 317 pages, 4,860 properties, 40,000-entry command tree, hardware specs for 144 products, 518 YouTube video transcripts, and direct links to help.mikrotik.com.
 
-If you need MikroTik docs, you likely have a MikroTik. Install rosetta once as a container on your router using [RouterOS /app](#install-on-mikrotik-app), and any AI assistant on the network can use it. Or [run it locally](#install-locally-with-bun) on your workstation.
+If you need MikroTik docs, you likely have a MikroTik. Install rosetta once as a container on your router using [RouterOS /app](#install-on-mikrotik-app), and any AI assistant on the network can use it. Or [run it locally](#install-locally-with-bun) on your workstation. **No AI required** — rosetta includes a [terminal browser](#browse-without-ai) for searching the database directly.
 
 ### SQL-as-RAG
 
@@ -10,16 +10,18 @@ Instead of vector embeddings, rosetta uses **SQLite [FTS5](https://www.sqlite.or
 
 ### What's Inside
 
-- **317 documentation pages** from MikroTik's official help site (~515K words)
-- **4,860 property definitions** with types, defaults, and descriptions
-- **5,114 commands** in the RouterOS command hierarchy (551 directories, 34K arguments)
-- **1,034 callout blocks** — warnings, notes, and tips with important caveats
-- **144 hardware products** — CPU, RAM, storage, ports, PoE, wireless, license level, pricing
-- **2,874 performance benchmarks** — ethernet and IPSec throughput test results for 125 devices (64/512/1518-byte packets, multiple routing/bridging modes), plus block diagrams for 110
-- **518 YouTube video transcripts** — chapter-level transcript segments from MikroTik's official YouTube channel, searchable by topic with timestamped deep links
-- **46 RouterOS versions tracked** (7.9 through 7.23beta2) for command history
-- **2 MCP CSV resources** for bulk reporting workflows: full benchmark dataset and full device catalog
-- Direct links to help.mikrotik.com for every page and section
+| Data Source | Coverage |
+|-------------|----------|
+| Documentation pages | 317 pages (~515K words) from help.mikrotik.com |
+| Property definitions | 4,860 with types, defaults, descriptions |
+| Command tree | 5,114 commands, 551 dirs, 34K arguments |
+| Version history | 46 RouterOS versions tracked (7.9–7.23beta2) |
+| Hardware products | 144 devices — specs, pricing, block diagrams |
+| Performance benchmarks | 2,874 tests across 125 devices (ethernet + IPSec) |
+| YouTube transcripts | 518 videos, ~1,890 chapter-level segments |
+| Callout blocks | 1,034 warnings, notes, and tips |
+
+Documentation covers RouterOS **v7 only**, aligned with the long-term release (~7.22) at export time.
 
 ---
 
@@ -91,7 +93,13 @@ Point any HTTP-capable MCP client at the URL from the previous step:
 
 > **CHR note:** Cloud Hosted Router in free or trial mode does not include the `/ip/cloud` service needed for HTTPS certificates. Set `use-https=no` on the /app — the URL will use HTTP instead. The UI URL always reflects the correct protocol.
 
-> **HTTP option:** On any platform, you may choose `use-https=no` if you prefer HTTP or are on an isolated network. 
+> **HTTP option:** On any platform, you may choose `use-https=no` if you prefer HTTP or are on an isolated network.
+
+> **Browse the database from the router:** If rosetta is running as a `/app`, you can use `/container/shell` to access the TUI browser directly:
+> ```routeros
+> /container/shell app-rosetta
+> # /app/rosetta browse
+> ```
 
 ---
 
@@ -107,7 +115,7 @@ bunx @tikoci/rosetta --setup
 
 This downloads the database and prints config snippets for all supported MCP clients. Copy-paste the config for your client and you're done.
 
-### Or configure manually
+### Configure your MCP client
 
 <details>
 <summary><b>VS Code Copilot</b></summary>
@@ -214,34 +222,36 @@ powershell -c "irm bun.sh/install.ps1 | iex"
 
 > **Auto-update:** `bunx` checks the npm registry each session and uses the latest published version automatically. The database in `~/.rosetta/ros-help.db` persists across updates.
 
-### MCP Resources for Reporting
-
-If your MCP client supports resources, rosetta also exposes two read-only CSV datasets for bulk analysis and reporting:
+---
 
-- `rosetta://datasets/device-test-results.csv`
-- `rosetta://datasets/devices.csv`
+## Browse Without AI
 
-In VS Code Copilot, attach them via **Add Context > MCP Resources** or **MCP: Browse Resources**. Use tools for normal search and drill-down; use resources when you explicitly want the whole dataset as CSV.
+Rosetta includes a terminal-based "card catalog" browser — **no AI assistant or MCP client required**. It searches the same database the MCP tools use, with a keyboard-driven REPL modeled after a 1980s library terminal.
 
----
+```sh
+bunx @tikoci/rosetta browse
+```
 
-## Install from Binary
+Type a search query to find documentation pages, then select a numbered result to drill in. Beyond page search, the browser covers every data source in the database:
 
-Download a compiled binary from [Releases](https://github.com/tikoci/rosetta/releases) — no Bun, Node.js, or other runtime needed.
+| Command | What it searches |
+|---------|-----------------|
+| *(bare text)* | Documentation pages (default) |
+| `dev <query>` | Device hardware specs, block diagrams, benchmarks |
+| `cmd [path]` | Command tree hierarchy |
+| `prop <name>` | Property definitions (scoped to current page when viewing one) |
+| `cal [query]` | Warnings, notes, and tips |
+| `cl [version]` | Changelogs — `cl breaking` for breaking changes only |
+| `vid <query>` | YouTube video transcripts with timestamped chapter links |
+| `diff <from> <to>` | Command tree diff between RouterOS versions |
+| `tests [type]` | Cross-device performance benchmarks |
+| `ver` | Live-fetch current RouterOS versions |
 
-| Platform | File |
-|----------|------|
-| macOS (Apple Silicon) | `rosetta-macos-arm64.zip` |
-| macOS (Intel) | `rosetta-macos-x64.zip` |
-| Windows | `rosetta-windows-x64.zip` |
-| Linux | `rosetta-linux-x64.zip` |
+Type `help` for the full command list. URLs are clickable in terminals that support OSC 8 hyperlinks (iTerm2, Windows Terminal, GNOME Terminal, etc.).
 
-```sh
-./rosetta --setup    # downloads DB + prints MCP client config
-```
+The browser is also useful as a test harness — it interacts with the data the same way an AI agent would through MCP, so gaps or rough edges visible here often point to MCP tool improvements too.
 
-> **macOS Gatekeeper:** `xattr -d com.apple.quarantine ./rosetta` or System Settings → Privacy & Security → Allow Anyway.
-> **Windows SmartScreen:** Click **More info → Run anyway**.
+> **From a router:** If rosetta is installed as a `/app`, access the browser via `/container/shell app-rosetta` then `/app/rosetta browse`.
 
 ---
 
@@ -252,7 +262,6 @@ Ask your AI assistant questions like:
 - *"What are the DHCP server properties in RouterOS?"*
 - *"How do I set up a bridge VLAN?"*
 - *"Is the /container command available in RouterOS 7.12?"*
-- *"What are the firewall filter default chains?"*
 - *"Show me warnings about hardware offloading"*
 - *"Which MikroTik routers have L3HW offload, and more than 8 ports of 48V PoE? Include cost."*
 - *"Compare the RB5009 and CCR2004 IPSec throughput at 1518-byte packets."*
@@ -260,122 +269,30 @@ Ask your AI assistant questions like:
 
 ## MCP Tools
 
-The server provides 15 tools, designed to work together:
+The server exposes 14 tools designed to work together — agents start with `routeros_search` and drill into specific data as needed:
 
 | Tool | What it does |
 |------|-------------|
-| `routeros_search` | **Start here.** Full-text search across all pages with BM25 ranking |
-| `routeros_get_page` | Retrieve full page content by ID or title. Section-aware for large pages |
-| `routeros_lookup_property` | Look up a property by exact name (type, default, description) |
-| `routeros_search_properties` | Search across 4,860 property names and descriptions |
-| `routeros_command_tree` | Browse the `/ip/firewall/filter` style command hierarchy |
-| `routeros_search_callouts` | Search warnings, notes, and tips across all pages |
-| `routeros_search_changelogs` | Search parsed changelog entries — filter by version range, category, breaking changes |
-| `routeros_command_version_check` | Check which RouterOS versions include a command |
-| `routeros_command_diff` | Diff two RouterOS versions — which command paths were added or removed between them |
-| `routeros_device_lookup` | Hardware specs for 144 MikroTik products — filter by architecture, RAM, storage, PoE, wireless, LTE. Includes ethernet/IPSec benchmarks and block diagrams for most devices |
-| `routeros_search_tests` | Cross-device performance benchmarks — filter by test type, mode, packet size; one call replaces 125+ individual lookups |
-| `routeros_search_videos` | Search MikroTik YouTube video transcripts — chapter-level results with timestamps and excerpts |
-| `routeros_stats` | Database health: page/property/command counts, coverage stats |
-| `routeros_current_versions` | Fetch current RouterOS versions from MikroTik (live) |
-
-The AI assistant typically starts with `routeros_search`, then drills into specific pages, properties, or the command tree based on what it finds. Each tool's description includes workflow hints (e.g., "→ use `routeros_get_page` to read full content") and empty-result suggestions so the AI knows how to chain tools together — this is where most of the tuning effort goes.
-
-## Troubleshooting
-
-| Issue | Solution |
-|-------|----------|
-| **First launch is slow** | One-time database download (~50 MB). Subsequent starts are instant. |
-| **`npx @tikoci/rosetta` fails** | This package requires Bun, not Node.js. Use `bunx` instead of `npx`. |
-| **`npm install -g` then `rosetta` fails** | Global npm install works if Bun is on PATH — it delegates to `bun` at runtime. But prefer `bunx` — it's simpler and auto-updates. |
-| **ChatGPT Apps can't connect** | ChatGPT Apps require a remote HTTPS MCP endpoint. Use the [MikroTik /app install](#install-on-mikrotik-app) for a hosted endpoint, or Codex CLI for local stdio. |
-| **Claude Desktop can't find `bunx`** | Claude Desktop on macOS may not inherit shell PATH. Use the full path to bunx (run `which bunx` to find it, typically `~/.bun/bin/bunx`). `bunx @tikoci/rosetta --setup` prints the full-path config. |
-| **macOS Gatekeeper blocks binary** | Use `bunx` install (no Gatekeeper issues), or: `xattr -d com.apple.quarantine ./rosetta` |
-| **Windows SmartScreen warning** | Use `bunx` install (no SmartScreen issues), or click **More info → Run anyway** |
-| **How to update** | `bunx` always uses the latest published version. For binaries, re-download from [Releases](https://github.com/tikoci/rosetta/releases/latest). MikroTik /app with `auto-update: true` pulls the latest image on each boot. |
-
-## HTTP Transport
-
-The [MikroTik /app install](#install-on-mikrotik-app) is the easiest way to get an HTTP endpoint. For other setups, rosetta supports the [MCP Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) via `--http`:
-
-```sh
-rosetta --http                    # http://localhost:8080/mcp
-rosetta --http --port 9090        # custom port
-rosetta --http --host 0.0.0.0    # accessible from LAN
-```
-
-Then point your MCP client at the URL:
-
-```json
-{ "url": "http://localhost:8080/mcp" }
-```
-
-- **Read-only** — queries a local SQLite database, stores nothing.
-- **No authentication** — designed for local/trusted-network use. Use a reverse proxy for public exposure.
-- **TLS built-in** — `--tls-cert cert.pem --tls-key key.pem` for direct HTTPS without a proxy.
-- **Defaults to localhost** — LAN binding (`--host 0.0.0.0`) requires an explicit flag.
-
-## Container Images
-
-Multi-arch OCI images (linux/amd64 + linux/arm64) are published with each release:
-
-- `ghcr.io/tikoci/rosetta` (GitHub Container Registry)
-- `ammo74/rosetta` (Docker Hub)
-
-```sh
-docker run --rm -p 8080:8080 ghcr.io/tikoci/rosetta:latest
-```
-
-These are the same images used by the [MikroTik /app install](#install-on-mikrotik-app). Tags: `latest`, version (e.g., `v0.2.1`), and `sha-<commit>`.
-
-## Data Sources
-
-The database combines multiple MikroTik data sources into a single SQLite file with [FTS5](https://www.sqlite.org/fts5.html) full-text search, [porter stemming](https://www.sqlite.org/fts5.html#porter_tokenizer), and [BM25 ranking](https://www.sqlite.org/fts5.html#the_bm25_function):
-
-- **HTML Documentation** — Confluence space export from help.mikrotik.com (March 2026). 317 pages broken into sections, callouts, and property tables (~515K words) with links back to help.mikrotik.com.
-
-- **Command Tree** — `inspect.json` from [tikoci/restraml](https://github.com/tikoci/restraml), generated by running `/console/inspect` against RouterOS CHR under QEMU for every version since 7.9 (46 versions tracked: 7.9–7.23beta2).
-
-- **Product Matrix** — CSV export from mikrotik.com/products/matrix (144 products, 34 columns). Hardware specs, license levels, and pricing.
-
-- **Device Benchmarks** — Ethernet bridging/routing and IPSec throughput test results scraped from individual product pages on mikrotik.com (2,874 measurements across 125 devices; 64/512/1518-byte packets, multiple configurations). Also captures block diagram image URLs for 110 devices.
-
-- **YouTube Transcripts** — Auto-generated English transcripts from the official [MikroTik YouTube channel](https://www.youtube.com/@MikroTik/videos) (518 videos, ~1,800 transcript segments). Split by chapter when available, with timestamps for deep linking. MUM conference talks excluded. Extracted via yt-dlp, cached as NDJSON in the repo for reproducible CI builds.
-
-Documentation covers RouterOS **v7 only** and aligns with the long-term release (~7.22) at export time. v6 had different syntax and major subsystems — answers for v6 are unreliable.
-
-## Database (Standalone)
-
-The SQLite database is downloadable on its own from [GitHub Releases](https://github.com/tikoci/rosetta/releases):
-
-```text
-https://github.com/tikoci/rosetta/releases/latest/download/ros-help.db.gz
-```
-
-Use it with any SQLite client:
-
-```sh
-sqlite3 ros-help.db "SELECT title, url FROM pages_fts WHERE pages_fts MATCH 'DHCP lease' ORDER BY rank LIMIT 5;"
-```
-
-### Tables
-
-| Table | Rows | What's in it |
-|-------|------|-------------|
-| `pages` | 317 | Documentation pages — title, breadcrumb path, full text, code blocks, help.mikrotik.com URL |
-| `sections` | 2,984 | Page chunks split by h1–h3 headings, with anchor IDs for deep linking |
-| `callouts` | 1,034 | Warning/Note/Info/Tip boxes extracted from Confluence callout macros |
-| `properties` | 4,860 | Command properties — name, type, default value, description (from doc tables) |
-| `commands` | 40K+ | RouterOS command hierarchy — dirs, commands, arguments from `/console/inspect` |
-| `command_versions` | 1.67M | Junction table: which command paths exist in which RouterOS versions (7.9–7.23beta2) |
-| `ros_versions` | 46 | Tracked RouterOS versions with channel (stable/development) |
-| `devices` | 144 | MikroTik hardware — CPU, RAM, storage, ports, PoE, wireless, license level, MSRP |
-| `device_test_results` | 2,874 | Ethernet and IPSec throughput benchmarks for 125 devices — packet sizes, modes, Mbps/Kpps |
-| `changelogs` | varies | Parsed changelog entries per RouterOS version — category, description, breaking flag |
-| `videos` | 518 | MikroTik YouTube video metadata — title, description, duration, chapters |
-| `video_segments` | ~1,890 | Chapter-level transcript segments with timestamps for deep linking |
-
-Each content table has a corresponding FTS5 index (e.g., `pages_fts`, `properties_fts`, `devices_fts`, `video_segments_fts`).
+| `routeros_search` | **Start here.** Full-text search across all documentation pages |
+| `routeros_get_page` | Full page content by ID or title, section-aware for large pages |
+| `routeros_lookup_property` | Property by exact name — type, default, description |
+| `routeros_search_properties` | FTS across 4,860 property names and descriptions |
+| `routeros_command_tree` | Browse the command hierarchy (`/ip/firewall/filter` style) |
+| `routeros_search_callouts` | Search warnings, notes, and tips |
+| `routeros_search_changelogs` | Changelogs filtered by version range, category, breaking flag |
+| `routeros_command_version_check` | Which RouterOS versions include a command path |
+| `routeros_command_diff` | Added/removed commands between two RouterOS versions |
+| `routeros_device_lookup` | Hardware specs — filter by architecture, RAM, PoE, wireless, etc. |
+| `routeros_search_tests` | Cross-device ethernet and IPSec benchmarks |
+| `routeros_search_videos` | YouTube transcript search with chapter timestamps |
+| `routeros_stats` | Database health and coverage stats |
+| `routeros_current_versions` | Live-fetch current RouterOS versions from MikroTik |
+
+Each tool description includes workflow arrows (`→ next_tool`) and empty-result hints so agents chain tools effectively.
+
+
+## RTFM for Details
+For additional install options, HTTP transport configuration, data source details, and the database schema, see [MANUAL.md](MANUAL.md).
 
 ## Contributing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tikoci/rosetta",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "RouterOS documentation as SQLite FTS5 — RAG search + command glossary via MCP",
   "type": "module",
   "license": "MIT",

package/src/browse.ts

@@ -15,6 +15,7 @@ import * as readline from "node:readline";
 import { db, getDbStats, initDb } from "./db.ts";
 import { resolveVersion } from "./paths.ts";
 import type {
+  CalloutResult,
   ChangelogResult,
   DeviceResult,
   DeviceTestRow,
@@ -151,11 +152,15 @@ async function paged(output: string): Promise<boolean> {
     offset += pageSize;
     if (offset < lines.length) {
       const remaining = lines.length - offset;
-      process.stdout.write(dim(`── ${remaining} more lines (Enter=next, q=stop) ──`));
+      process.stdout.write(dim(`-- ${remaining} more lines [Q quit | SPACE next page | ENTER next line]`));
       const key = await waitForKey();
       // Clear the "more" line
       process.stdout.write(`\r${" ".repeat(termWidth())}\r`);
       if (key === "q" || key === "Q") return true;
+      // ENTER or arrow-down → advance one line; SPACE → advance one page
+      if (key === "\r" || key === "\n" || key === "\x1b[B") {
+        offset -= pageSize - 1; // back up so only 1 line advances
+      }
     }
   }
   return false;
@@ -184,14 +189,14 @@ type Context =
   | { type: "search"; response: SearchResponse; results: SearchResult[] }
   | { type: "page"; pageId: number; title: string; commandPath?: string }
   | { type: "sections"; pageId: number; title: string; sections: SectionTocEntry[] }
-  | { type: "properties"; query: string; pageId?: number }
   | { type: "commands"; path: string }
   | { type: "devices"; query: string; results: DeviceResult[] }
   | { type: "device"; device: DeviceResult }
   | { type: "tests" }
-  | { type: "callouts"; query: string }
-  | { type: "changelogs" }
-  | { type: "videos"; query: string }
+  | { type: "callouts"; query: string; results: CalloutResult[] }
+  | { type: "changelogs"; results: ChangelogResult[] }
+  | { type: "videos"; query: string; results: VideoSearchResult[] }
+  | { type: "properties"; query: string; pageId?: number; results: Array<{ name: string; page_id: number; page_title: string }> }
   | { type: "diff" }
   | { type: "vcheck"; path: string };
 
@@ -209,6 +214,32 @@ function popCtx(): boolean {
   return false;
 }
 
+/** Build a context-aware prompt string, mirroring RouterOS [admin@router]> style. */
+function buildPrompt(): string {
+  const label = contextLabel(ctx);
+  if (label) return `${cyan("rosetta")}${dim("[")}${label}${dim("]>")} `;
+  return `${cyan("rosetta")}${dim(">")} `;
+}
+
+function contextLabel(c: Context): string {
+  switch (c.type) {
+    case "home": return "";
+    case "search": return truncate(`search: "${c.response.query}"`, 30);
+    case "page": return truncate(c.title, 30);
+    case "sections": return truncate(`${c.title} §`, 30);
+    case "properties": return truncate(`prop: "${c.query}"`, 30);
+    case "commands": return truncate(`cmd: ${c.path || "/"}`, 30);
+    case "devices": return truncate(`dev: "${c.query}"`, 30);
+    case "device": return truncate(c.device.product_name, 30);
+    case "tests": return "tests";
+    case "callouts": return c.query ? truncate(`cal: "${c.query}"`, 30) : "callouts";
+    case "changelogs": return "changelogs";
+    case "videos": return truncate(`vid: "${c.query}"`, 30);
+    case "diff": return "diff";
+    case "vcheck": return truncate(`vc: ${c.path}`, 30);
+  }
+}
+
 // ── Renderers ──
 
 function renderWelcome(): string {
@@ -250,7 +281,7 @@ function renderSearchResults(resp: SearchResponse): string {
 
   // Navigation hints
   const hints = [
-    `${cyan("[N]")} view page`,
+    `${cyan("#N")} view page`,
     `${cyan("[s <query>]")} search`,
     `${cyan("[p <query>]")} properties`,
     `${cyan("[cmd <path>]")} commands`,
@@ -318,7 +349,7 @@ function renderPage(page: NonNullable<ReturnType<typeof getPage>>): string {
     if (page.code) {
       out.push("");
       out.push(dim("── code ──"));
-      out.push(page.code);
+      out.push(page.code.split("\n").map((l) => `  ${l}`).join("\n"));
     }
   }
 
@@ -336,14 +367,14 @@ function renderPage(page: NonNullable<ReturnType<typeof getPage>>): string {
     if (page.code) {
       out.push("");
       out.push(dim("── code ──"));
-      out.push(page.code);
+      out.push(page.code.split("\n").map((l) => `  ${l}`).join("\n"));
     }
   }
 
   // Navigation hints
   out.push("");
   const hints: string[] = [];
-  if (page.sections && page.sections.length > 0) hints.push(`${cyan("[N]")} section`);
+  if (page.sections && page.sections.length > 0) hints.push(`${cyan("#N")} section`);
   hints.push(`${cyan("[p]")} properties`);
   hints.push(`${cyan("[cmd]")} command tree`);
   hints.push(`${cyan("[cal]")} callouts`);
@@ -449,7 +480,7 @@ function renderDeviceResults(results: DeviceResult[], mode: string, total: numbe
     out.push("");
   }
 
-  out.push(`  ${cyan("[N]")} view device  ${cyan("[tests]")} benchmarks  ${cyan("[b]")} back`);
+  out.push(`  ${cyan("#N")} view device  ${cyan("[tests]")} benchmarks  ${cyan("[b]")} back`);
   return out.join("\n");
 }
 
@@ -498,17 +529,24 @@ function renderDeviceCard(d: DeviceResult): string {
     out.push(`  ${dim("Block diagram:")} ${cyan(link(d.block_diagram_url, "view"))}`);
   }
 
-  // Test results (attached for exact matches)
+  // Test results (attached for exact matches) — default to 512B for a useful baseline
   if (d.test_results && d.test_results.length > 0) {
+    const pkt512 = d.test_results.filter((t) => t.packet_size === 512);
+    const displayTests = pkt512.length > 0 ? pkt512 : d.test_results.slice(0, 20);
+    const pktNote = pkt512.length > 0 ? " (512B baseline)" : "";
     out.push("");
-    out.push(`  ${bold("Benchmarks:")}  ${dim(`(${d.test_results.length} tests)`)}`);
-    for (const t of d.test_results.slice(0, 12)) {
+    out.push(`  ${bold("Benchmarks:")}  ${dim(`(${displayTests.length} of ${d.test_results.length} tests${pktNote})`)}`);
+    for (const t of displayTests) {
       const mbps = t.throughput_mbps ? `${fmt(t.throughput_mbps)} Mbps` : "";
       const kpps = t.throughput_kpps ? `${fmt(t.throughput_kpps)} Kpps` : "";
       out.push(`    ${dim(pad(t.test_type, 9))} ${pad(t.mode, 16)} ${dim(pad(t.configuration, 28))} ${pad(`${t.packet_size}B`, 6)} ${bold(mbps)} ${dim(kpps)}`);
     }
-    if (d.test_results.length > 12) {
-      out.push(`    ${dim(`... and ${d.test_results.length - 12} more (use`)} ${cyan("tests")} ${dim("for full listing)")}`);
+    if (d.test_results.length > displayTests.length) {
+      const otherSizes = [...new Set(
+        d.test_results.filter((t) => t.packet_size !== 512).map((t) => t.packet_size),
+      )].sort((a, b) => a - b);
+      const sizesStr = otherSizes.map((s) => `${s}B`).join(", ");
+      out.push(`    ${dim(`Also at ${sizesStr} — use`)} ${cyan("tests")} ${dim("<type> <size> for other packet sizes")}`);
     }
   }
 
@@ -582,22 +620,24 @@ function renderChangelogs(results: ChangelogResult[]): string {
   }
 
   let lastVersion = "";
-  for (const c of results) {
+  for (let i = 0; i < results.length; i++) {
+    const c = results[i];
     if (c.version !== lastVersion) {
       out.push("");
       out.push(`  ${bold(c.version)}  ${dim(c.released ?? "")}`);
       lastVersion = c.version;
     }
-    const breaking = c.is_breaking ? red("⚠ ") : "  ";
+    const num = dim(`${String(i + 1).padStart(3)}  `);
+    const breaking = c.is_breaking ? red("⚠ ") : "";
     const cat = dim(pad(c.category, 14));
     const desc = c.excerpt.includes("**")
       ? c.excerpt.replace(/\*\*/g, `${ESC}[1m`)
-      : truncate(c.description, termWidth() - 22);
-    out.push(`  ${breaking}${cat} ${desc}`);
+      : truncate(c.description, termWidth() - 26);
+    out.push(`${num}${breaking}${cat} ${desc}`);
   }
 
   out.push("");
-  out.push(`  ${cyan("[cl breaking]")} breaking only  ${cyan("[cl <ver>]")} specific version  ${cyan("[b]")} back`);
+  out.push(`  ${cyan("[cl 7.22 bgp]")} version + topic  ${cyan("[cl 7.21..7.22]")} range  ${cyan("[cl breaking]")} breaking only  ${cyan("[b]")} back`);
   return out.join("\n");
 }
 
@@ -719,25 +759,26 @@ function renderHelp(): string {
   out.push(`  ${bold("Commands")}  ${dim("(bare text = search)")}`);
   out.push("");
 
-  const cmd = (name: string, alias: string, desc: string) => {
-    out.push(`  ${cyan(pad(name, 26))} ${dim(pad(alias, 6))} ${desc}`);
+  const cmd = (name: string, alias: string, desc: string, mcp?: string) => {
+    const mcpHint = mcp ? `  ${dim(`(${mcp})`)}` : "";
+    out.push(`  ${cyan(pad(name, 26))} ${dim(pad(alias, 6))} ${desc}${mcpHint}`);
   };
 
-  cmd("<query>", "", "Search pages (default action)");
-  cmd("search <query>", "s", "Explicit page search");
-  cmd("page <id|title>", "", "View full page");
-  cmd("prop <name>", "p", "Look up property (scoped to current page)");
-  cmd("props <query>", "sp", "Search properties by FTS");
-  cmd("cmd [path]", "tree", "Browse command tree");
-  cmd("device <query>", "dev", "Look up device specs");
-  cmd("tests [type] [mode]", "", "Cross-device benchmarks");
-  cmd("callouts [query]", "cal", "Search callouts (type filter: cal warning)");
-  cmd("changelog [query]", "cl", "Search changelogs (cl 7.22, cl breaking)");
-  cmd("videos <query>", "vid", "Search video transcripts");
-  cmd("diff <from> <to> [path]", "", "Command tree diff between versions");
-  cmd("vcheck <path>", "vc", "Version range for a command path");
-  cmd("versions", "ver", "Live-fetch current RouterOS versions");
-  cmd("stats", "", "Database health / counts");
+  cmd("<query>", "", "Search pages (default action)", "routeros_search");
+  cmd("search <query>", "s", "Explicit page search", "routeros_search");
+  cmd("page <id|title>", "", "View full page", "routeros_get_page");
+  cmd("prop <name>", "p", "Look up property (scoped to current page)", "routeros_lookup_property");
+  cmd("props <query>", "sp", "Search properties by FTS", "routeros_search_properties");
+  cmd("cmd [path]", "tree", "Browse command tree", "routeros_command_tree");
+  cmd("device <query>", "dev", "Look up device specs", "routeros_device_lookup");
+  cmd("tests [device] <type> [packet_size] [mode]", "", "Cross-device benchmarks (512B default)", "routeros_search_tests");
+  cmd("callouts [query]", "cal", "Search callouts (type filter: cal warning)", "routeros_search_callouts");
+  cmd("changelog [query]", "cl", "Search changelogs (cl 7.22, cl breaking)", "routeros_search_changelogs");
+  cmd("videos <query>", "vid", "Search video transcripts", "routeros_search_videos");
+  cmd("diff <from> <to> [path]", "", "Command tree diff between versions", "routeros_command_diff");
+  cmd("vcheck <path>", "vc", "Version range for a command path", "routeros_command_version_check");
+  cmd("versions", "ver", "Live-fetch current RouterOS versions", "routeros_current_versions");
+  cmd("stats", "", "Database health / counts", "routeros_stats");
   cmd("back", "b", "Go to previous view");
   cmd("help", "?", "This help");
   cmd("quit", "q", "Exit");
@@ -750,8 +791,69 @@ function renderHelp(): string {
   return out.join("\n");
 }
 
+/** Fetch the full transcript text for a specific video segment. */
+function getVideoSegmentTranscript(youtubeVideoId: string, startS: number): string | null {
+  try {
+    const row = db
+      .prepare(
+        `SELECT vs.transcript FROM video_segments vs
+         JOIN videos v ON v.id = vs.video_id
+         WHERE v.video_id = ? AND vs.start_s = ? LIMIT 1`,
+      )
+      .get(youtubeVideoId, startS) as { transcript: string } | null;
+    return row?.transcript ?? null;
+  } catch {
+    return null;
+  }
+}
+
 // ── Command dispatcher ──
 
+/** Re-render the current context after going back — uses cached results where possible. */
+async function renderCurrentCtx(): Promise<void> {
+  switch (ctx.type) {
+    case "home":
+      console.log(renderWelcome());
+      return;
+    case "search":
+      await paged(renderSearchResults(ctx.response));
+      return;
+    case "commands": {
+      const children = browseCommands(ctx.path);
+      if (children.length > 0) await paged(renderCommandTree(ctx.path, children));
+      else console.log(dim(`  No children at "${ctx.path}".`));
+      return;
+    }
+    case "devices":
+      await paged(renderDeviceResults(ctx.results, "cached", ctx.results.length));
+      return;
+    case "device":
+      await paged(renderDeviceCard(ctx.device));
+      return;
+    case "callouts":
+      if (ctx.results.length > 0) await paged(renderCallouts(ctx.results));
+      return;
+    case "changelogs":
+      if (ctx.results.length > 0) await paged(renderChangelogs(ctx.results));
+      return;
+    case "videos":
+      if (ctx.results.length > 0) await paged(renderVideos(ctx.results));
+      return;
+    case "page": {
+      const page = getPage(ctx.pageId);
+      if (page) await paged(renderPage(page));
+      return;
+    }
+    case "sections": {
+      const page = getPage(ctx.pageId);
+      if (page) await paged(renderPage(page));
+      return;
+    }
+    default:
+      console.log(dim(`  In ${ctx.type} context. Type a command or help.`));
+  }
+}
+
 async function dispatch(input: string): Promise<void> {
   const trimmed = input.trim();
   if (!trimmed) return;
@@ -786,7 +888,8 @@ async function dispatch(input: string): Promise<void> {
       if (!popCtx()) {
         console.log(dim("  Already at top."));
       } else {
-        console.log(dim(`  ← back to ${ctx.type}`));
+        console.log(dim(`  ← ${ctx.type}`));
+        await renderCurrentCtx();
       }
       return;
 
@@ -801,7 +904,20 @@ async function dispatch(input: string): Promise<void> {
       return;
 
     case "page": {
-      if (!rest) { console.log(dim("  Usage: page <id|title>")); return; }
+      if (!rest) {
+        // From commands context: navigate to the linked page
+        if (ctx.type === "commands") {
+          const row = db.prepare("SELECT page_id FROM commands WHERE path = ? LIMIT 1").get(ctx.path) as { page_id: number | null } | null;
+          if (row?.page_id) {
+            await doPage(String(row.page_id));
+            return;
+          }
+          console.log(dim(`  No linked page for ${ctx.path}.`));
+          return;
+        }
+        console.log(dim("  Usage: page <id|title>"));
+        return;
+      }
       await doPage(rest);
       return;
     }
@@ -809,13 +925,12 @@ async function dispatch(input: string): Promise<void> {
     case "p":
     case "prop": {
       if (!rest) {
-        // Context-scoped: show properties for current page
-        if (ctx.type === "page") {
-          const page = getPage(ctx.pageId, 0); // just get metadata
-          if (page) {
-            await doPropsForPage(ctx.pageId, ctx.title);
-            return;
-          }
+        // Context-scoped: show properties for current page or sections context
+        const pageId = ctx.type === "page" ? ctx.pageId : ctx.type === "sections" ? ctx.pageId : null;
+        const title = ctx.type === "page" ? ctx.title : ctx.type === "sections" ? ctx.title : null;
+        if (pageId !== null && title !== null) {
+          await doPropsForPage(pageId, title);
+          return;
         }
         console.log(dim("  Usage: prop <name> — or navigate to a page first"));
         return;
@@ -833,8 +948,15 @@ async function dispatch(input: string): Promise<void> {
 
     case "cmd":
     case "tree": {
-      const path = rest || (ctx.type === "commands" ? ctx.path : "");
-      await doCommandTree(path);
+      let cmdPath = rest;
+      if (!cmdPath && ctx.type === "commands") {
+        // Re-display current commands context
+        cmdPath = ctx.path;
+      } else if (cmdPath && !cmdPath.startsWith("/") && ctx.type === "commands") {
+        // Relative path: resolve against current commands path
+        cmdPath = `${ctx.path}/${cmdPath}`;
+      }
+      await doCommandTree(cmdPath);
       return;
     }
 
@@ -852,13 +974,24 @@ async function dispatch(input: string): Promise<void> {
 
     case "cal":
     case "callouts": {
-      if (!rest && ctx.type === "page") {
-        // Show callouts for current page
-        const results = searchCallouts("", undefined, 50);
-        const pageCallouts = results.filter((c) => c.page_id === (ctx as { pageId: number }).pageId);
-        if (pageCallouts.length > 0) {
-          await paged(renderCallouts(pageCallouts));
-          pushCtx({ type: "callouts", query: "" });
+      if (!rest) {
+        // Context-aware: show callouts for the current page directly
+        const pageId = ctx.type === "page" ? ctx.pageId
+          : ctx.type === "sections" ? ctx.pageId
+          : null;
+        if (pageId !== null) {
+          const pageCallouts = db.prepare(
+            `SELECT c.type, c.content, p.title as page_title, p.url as page_url,
+                    c.page_id, c.content as excerpt
+             FROM callouts c JOIN pages p ON p.id = c.page_id
+             WHERE c.page_id = ? ORDER BY c.sort_order`,
+          ).all(pageId) as CalloutResult[];
+          if (pageCallouts.length > 0) {
+            await paged(renderCallouts(pageCallouts));
+            pushCtx({ type: "callouts", query: "", results: pageCallouts });
+          } else {
+            console.log(dim("  No callouts for this page."));
+          }
           return;
         }
       }
@@ -873,6 +1006,7 @@ async function dispatch(input: string): Promise<void> {
     }
 
     case "vid":
+    case "video":
     case "videos": {
       if (!rest) { console.log(dim("  Usage: videos <query>")); return; }
       await doSearchVideos(rest);
@@ -935,6 +1069,39 @@ async function handleNumberSelect(idx: number): Promise<void> {
     }
     return;
   }
+  if (ctx.type === "callouts" && ctx.results[idx]) {
+    const c = ctx.results[idx];
+    await doPage(String(c.page_id));
+    return;
+  }
+  if (ctx.type === "videos" && ctx.results[idx]) {
+    const v = ctx.results[idx];
+    const timeUrl = v.start_s > 0 ? `${v.url}&t=${v.start_s}` : v.url;
+    const out: string[] = [];
+    out.push(`\n  ${bold(v.title)}`);
+    if (v.chapter_title) out.push(`  ${magenta(`§ ${v.chapter_title}`)}  ${dim(`@ ${formatTime(v.start_s)}`)}`);
+    out.push(`  ${cyan(link(timeUrl))}`);
+    // Fetch and show full transcript for this segment
+    const transcript = getVideoSegmentTranscript(v.video_id, v.start_s);
+    if (transcript) {
+      out.push("");
+      out.push(`  ${dim("── transcript ──")}`);
+      out.push(transcript.split("\n").map((l) => `  ${l}`).join("\n"));
+    }
+    await paged(out.join("\n"));
+    return;
+  }
+  if (ctx.type === "properties" && ctx.results[idx]) {
+    const p = ctx.results[idx];
+    await doPage(String(p.page_id));
+    return;
+  }
+  if (ctx.type === "changelogs" && ctx.results[idx]) {
+    const c = ctx.results[idx];
+    console.log(`\n  ${bold(c.version)}  ${dim(c.released ?? "")}  ${dim(c.category)}${c.is_breaking ? `  ${red("⚠ BREAKING")}` : ""}`);
+    console.log(`  ${c.description}\n`);
+    return;
+  }
   console.log(dim(`  No item #${idx + 1} in current view.`));
 }
 
@@ -987,7 +1154,7 @@ async function doPropsForPage(pageId: number, title: string): Promise<void> {
     return;
   }
   await paged(`  ${bold("Properties for")} ${bold(title)}\n\n${renderProperties(pageProps)}`);
-  pushCtx({ type: "properties", query: title, pageId });
+  pushCtx({ type: "properties", query: title, pageId, results: pageProps.map(p => ({ name: p.name, page_id: p.page_id ?? pageId, page_title: p.page_title })) });
 }
 
 async function doLookupProperty(name: string): Promise<void> {
@@ -999,7 +1166,7 @@ async function doLookupProperty(name: string): Promise<void> {
     return;
   }
   await paged(renderProperties(results));
-  pushCtx({ type: "properties", query: name });
+  pushCtx({ type: "properties", query: name, results: results.map(p => ({ name: p.name, page_id: p.page_id, page_title: p.page_title })) });
 }
 
 async function doSearchProperties(query: string): Promise<void> {
@@ -1009,7 +1176,7 @@ async function doSearchProperties(query: string): Promise<void> {
     return;
   }
   await paged(`  ${bold(String(results.length))} properties matching ${cyan(`"${query}"`)}\n\n${renderProperties(results)}`);
-  pushCtx({ type: "properties", query });
+  pushCtx({ type: "properties", query, results: results.map(p => ({ name: p.name, page_id: p.page_id, page_title: p.page_title })) });
 }
 
 async function doCommandTree(path: string): Promise<void> {
@@ -1048,24 +1215,64 @@ async function doDeviceLookup(query: string): Promise<void> {
 }
 
 async function doTests(argsStr: string): Promise<void> {
-  if (!argsStr) {
-    // Show available filter values
+  const parts = argsStr.split(/\s+/).filter(Boolean);
+  const filters: Record<string, string | number> = {};
+
+  // Parse args if provided
+  if (argsStr) {
+    const knownTypes = ["ethernet", "ipsec"];
+    let offset = 0;
+    if (parts[0] && !knownTypes.includes(parts[0].toLowerCase())) {
+      filters.device = parts[0];
+      offset = 1;
+    }
+    if (parts[offset]) filters.test_type = parts[offset];
+    // packet_size is always numeric; mode can be multi-word — identify by type
+    const remaining = parts.slice(offset + 1);
+    const pktIdx = remaining.findIndex((p) => /^\d+$/.test(p));
+    if (pktIdx !== -1) {
+      filters.packet_size = Number.parseInt(remaining[pktIdx], 10);
+      const modeParts = [...remaining.slice(0, pktIdx), ...remaining.slice(pktIdx + 1)];
+      if (modeParts.length > 0) filters.mode = modeParts.join(" ");
+    } else if (remaining.length > 0) {
+      filters.mode = remaining.join(" ");
+    }
+  }
+
+  // Auto-inject device name from context when in a device view and none specified
+  if (!filters.device && ctx.type === "device") {
+    filters.device = ctx.device.product_name;
+  }
+
+  // Show help if no filters could be determined
+  if (!argsStr && !filters.device) {
     const meta = getTestResultMeta();
     console.log(`  ${bold("Test filters:")}`);
     console.log(`  ${dim("Types:")} ${meta.test_types.join(", ")}`);
     console.log(`  ${dim("Modes:")} ${meta.modes.join(", ")}`);
     console.log(`  ${dim("Packet sizes:")} ${meta.packet_sizes.join(", ")}`);
     console.log("");
-    console.log(`  ${dim("Usage: tests <type> [mode] [packet_size]")}`);
+    console.log(`  ${dim("Usage: tests [device] <type> [packet_size] [mode]")}`);
     console.log(`  ${dim("Example: tests ethernet Routing 1518")}`);
+    console.log(`  ${dim("Example: tests rb5009 ethernet 1518")}`);
     return;
   }
 
-  const parts = argsStr.split(/\s+/);
-  const filters: Record<string, string | number> = {};
-  if (parts[0]) filters.test_type = parts[0];
-  if (parts[1]) filters.mode = parts[1];
-  if (parts[2] && /^\d+$/.test(parts[2])) filters.packet_size = Number.parseInt(parts[2], 10);
+  // Round packet_size to the nearest valid test packet size
+  if (filters.packet_size) {
+    const validSizes = [64, 512, 1400, 1518];
+    const size = Number(filters.packet_size);
+    const rounded = validSizes.reduce((prev, curr) =>
+      Math.abs(curr - size) < Math.abs(prev - size) ? curr : prev,
+    );
+    if (rounded !== size) {
+      console.log(dim(`  Rounding ${size}B → ${rounded}B (nearest test packet size)`));
+      filters.packet_size = rounded;
+    }
+  }
+
+  // Default packet_size to 512 for a focused baseline comparison
+  if (!filters.packet_size && !filters.mode) filters.packet_size = 512;
 
   const result = searchDeviceTests(filters);
   if (result.results.length === 0) {
@@ -1094,7 +1301,7 @@ async function doSearchCallouts(query: string): Promise<void> {
     return;
   }
   await paged(`  ${bold(String(results.length))} callouts${type ? ` (${type})` : ""}\n\n${renderCallouts(results)}`);
-  pushCtx({ type: "callouts", query });
+  pushCtx({ type: "callouts", query, results });
 }
 
 async function doSearchChangelogs(query: string): Promise<void> {
@@ -1135,7 +1342,7 @@ async function doSearchChangelogs(query: string): Promise<void> {
     return;
   }
   await paged(`  ${bold("Changelogs")}${version ? ` for ${bold(version)}` : ""}${breakingOnly ? ` ${red("(breaking only)")}` : ""}\n\n${renderChangelogs(results)}`);
-  pushCtx({ type: "changelogs" });
+  pushCtx({ type: "changelogs", results });
 }
 
 async function doSearchVideos(query: string): Promise<void> {
@@ -1145,7 +1352,7 @@ async function doSearchVideos(query: string): Promise<void> {
     return;
   }
   await paged(`  ${bold(String(results.length))} video results for ${cyan(`"${query}"`)}\n\n${renderVideos(results)}`);
-  pushCtx({ type: "videos", query });
+  pushCtx({ type: "videos", query, results });
 }
 
 async function doDiff(from: string, to: string, pathPrefix?: string): Promise<void> {
@@ -1210,7 +1417,7 @@ async function main() {
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,
-    prompt: `${cyan("rosetta")}${dim(">")} `,
+    prompt: buildPrompt(),
     terminal: true,
   });
 
@@ -1222,6 +1429,10 @@ async function main() {
     } catch (err) {
       console.error(red(`  Error: ${err instanceof Error ? err.message : String(err)}`));
     }
+    // Clear any keys that leaked from the pager into readline's internal line buffer
+    // (the key pressed to exit paging — q/SPACE/ENTER — can appear in the next prompt)
+    rl.write(null as unknown as string, { ctrl: true, name: "u" });
+    rl.setPrompt(buildPrompt());
     rl.prompt();
   });
 

package/src/extract-html.ts

@@ -179,6 +179,13 @@ function extractPage(file: string, html: string): (PageRow & { callouts: Callout
   const codeLang = codeLangs.size > 0 ? [...codeLangs].join(",") : null;
   const codeLines = code.split("\n").filter((l) => l.trim()).length;
 
+  // Remove <style> elements before extracting text — they contain Confluence
+  // table-of-contents CSS (CDATA blocks like div.rbtoc... {padding:0}) that
+  // otherwise pollute the plain-text index and appear in page views.
+  for (const styleEl of mainContent?.querySelectorAll("style") ?? []) {
+    styleEl.remove();
+  }
+
   // Plain text from main content (includes code block text too, which is fine for FTS)
   const text = mainContent?.textContent?.trim() || "";
   const wordCount = text.split(/\s+/).filter(Boolean).length;

package/src/mcp.ts

@@ -978,6 +978,10 @@ Workflow:
 → routeros_device_lookup: get full specs (CPU, RAM, pricing) + block diagram for a specific device
 → routeros_search: find documentation about features relevant to the test type`,
     inputSchema: {
+      device: z
+        .string()
+        .optional()
+        .describe("Filter by device product name (substring match, e.g., 'RB5009', 'hAP', 'CCR2216')"),
       test_type: z
         .string()
         .optional()
@@ -1010,8 +1014,8 @@ Workflow:
         .describe("Max results (default 50, max 200)"),
     },
   },
-  async ({ test_type, mode, configuration, packet_size, sort_by, limit }) => {
-    const hasFilters = test_type || mode || configuration || packet_size;
+  async ({ device, test_type, mode, configuration, packet_size, sort_by, limit }) => {
+    const hasFilters = device || test_type || mode || configuration || packet_size;
 
     if (!hasFilters) {
       // Discovery mode: return available filter values
@@ -1028,8 +1032,17 @@ Workflow:
       };
     }
 
+    // Round packet_size to the nearest valid test size (64, 512, 1400, 1518)
+    let effectivePacketSize = packet_size;
+    if (packet_size !== undefined) {
+      const validSizes = [64, 512, 1400, 1518];
+      effectivePacketSize = validSizes.reduce((prev, curr) =>
+        Math.abs(curr - packet_size) < Math.abs(prev - packet_size) ? curr : prev,
+      );
+    }
+
     const result = searchDeviceTests(
-      { test_type, mode, configuration, packet_size, sort_by },
+      { device, test_type, mode, configuration, packet_size: effectivePacketSize, sort_by },
       limit,
     );
 
@@ -1052,6 +1065,9 @@ Workflow:
         text: JSON.stringify({
           ...result,
           has_more: result.total > result.results.length,
+          ...(effectivePacketSize !== packet_size && packet_size !== undefined
+            ? { packet_size_rounded: `${packet_size} → ${effectivePacketSize} (nearest valid test size)` }
+            : {}),
         }, null, 2),
       }],
     };

package/src/query.test.ts

@@ -267,6 +267,10 @@ beforeAll(() => {
   db.run(`INSERT INTO device_test_results
     (device_id, test_type, mode, configuration, packet_size, throughput_kpps, throughput_mbps)
     VALUES (1, 'ipsec', 'Single tunnel', 'AES-128-CBC + SHA1', 1400, 120.9, 1354.1)`);
+  // RB5009UG+S+IN = id 9 (9th device inserted)
+  db.run(`INSERT INTO device_test_results
+    (device_id, test_type, mode, configuration, packet_size, throughput_kpps, throughput_mbps)
+    VALUES (9, 'ethernet', 'Routing', 'none (fast path)', 1518, 1613.0, 19577.3)`);
 
   // Page 3: a "large" page with sections for TOC testing
   // Text is ~200 chars to keep fixture small, but we'll use max_length=50 to trigger truncation
@@ -1154,14 +1158,14 @@ describe("searchDevices", () => {
 describe("searchDeviceTests", () => {
   test("returns all test results with no filters", () => {
     const res = searchDeviceTests({});
-    expect(res.results.length).toBe(3);
-    expect(res.total).toBe(3);
+    expect(res.results.length).toBe(4);
+    expect(res.total).toBe(4);
   });
 
   test("filters by test_type", () => {
     const res = searchDeviceTests({ test_type: "ethernet" });
     expect(res.results.every((r) => r.test_type === "ethernet")).toBe(true);
-    expect(res.results.length).toBe(2);
+    expect(res.results.length).toBe(3);
   });
 
   test("filters by test_type and mode", () => {
@@ -1181,6 +1185,32 @@ describe("searchDeviceTests", () => {
     expect(res.results.every((r) => r.packet_size === 512)).toBe(true);
   });
 
+  test("filters by device name (substring match)", () => {
+    const res = searchDeviceTests({ device: "hAP" });
+    expect(res.results).toHaveLength(3);
+    expect(res.results.every((r) => r.product_name.includes("hAP"))).toBe(true);
+  });
+
+  test("device filter combined with test_type", () => {
+    const res = searchDeviceTests({ device: "hAP", test_type: "ethernet" });
+    expect(res.results).toHaveLength(2);
+    expect(res.results.every((r) => r.test_type === "ethernet")).toBe(true);
+    expect(res.results.every((r) => r.product_name.includes("hAP"))).toBe(true);
+  });
+
+  test("device filter with no matches returns empty", () => {
+    const res = searchDeviceTests({ device: "Audience" });
+    expect(res.results).toHaveLength(0);
+    expect(res.total).toBe(0);
+  });
+
+  test("device filter for RB5009 returns its test results", () => {
+    const res = searchDeviceTests({ device: "RB5009" });
+    expect(res.results).toHaveLength(1);
+    expect(res.results[0].product_name).toBe("RB5009UG+S+IN");
+    expect(res.results[0].packet_size).toBe(1518);
+  });
+
   test("sorts by mbps descending by default", () => {
     const res = searchDeviceTests({ test_type: "ethernet" });
     if (res.results.length >= 2) {
@@ -1210,7 +1240,7 @@ describe("searchDeviceTests", () => {
   test("respects limit", () => {
     const res = searchDeviceTests({}, 1);
     expect(res.results).toHaveLength(1);
-    expect(res.total).toBe(3);
+    expect(res.total).toBe(4);
   });
 });
 
@@ -1220,9 +1250,10 @@ describe("dataset CSV exports", () => {
     const lines = csv.trim().split("\n");
 
     expect(lines[0]).toBe("product_name,product_code,architecture,cpu,cpu_cores,cpu_frequency,test_type,mode,configuration,packet_size,throughput_kpps,throughput_mbps,product_url");
-    expect(lines).toHaveLength(4);
+    expect(lines).toHaveLength(5);
     expect(csv).toContain("hAP ax3");
     expect(csv).toContain("IPQ-6010");
+    expect(csv).toContain("RB5009UG+S+IN");
     expect(csv).toContain("https://mikrotik.com/product/hap_ax3");
   });
 

package/src/query.ts

@@ -458,6 +458,7 @@ export function searchProperties(
   default_val: string | null;
   description: string;
   section: string | null;
+  page_id: number;
   page_title: string;
   page_url: string;
   excerpt: string;
@@ -486,6 +487,7 @@ function runPropertiesFtsQuery(
   default_val: string | null;
   description: string;
   section: string | null;
+  page_id: number;
   page_title: string;
   page_url: string;
   excerpt: string;
@@ -495,7 +497,7 @@ function runPropertiesFtsQuery(
     return db
       .prepare(
         `SELECT p.name, p.type, p.default_val, p.description, p.section,
-                pg.title as page_title, pg.url as page_url,
+                pg.id as page_id, pg.title as page_title, pg.url as page_url,
                 snippet(properties_fts, 1, '**', '**', '...', 20) as excerpt
          FROM properties_fts fts
          JOIN properties p ON p.id = fts.rowid
@@ -509,6 +511,7 @@ function runPropertiesFtsQuery(
         default_val: string | null;
         description: string;
         section: string | null;
+        page_id: number;
         page_title: string;
         page_url: string;
         excerpt: string;
@@ -518,7 +521,7 @@ function runPropertiesFtsQuery(
   }
 }
 
-type CalloutResult = {
+export type CalloutResult = {
   type: string;
   content: string;
   page_title: string;
@@ -1088,6 +1091,7 @@ export type DeviceTestRow = {
 };
 
 type DeviceTestFilters = {
+  device?: string;
   test_type?: string;
   mode?: string;
   configuration?: string;
@@ -1099,6 +1103,10 @@ function buildTestWhereClause(filters: DeviceTestFilters): { whereClause: string
   const where: string[] = [];
   const params: (string | number)[] = [];
 
+  if (filters.device) {
+    where.push("d.product_name LIKE ?");
+    params.push(`%${filters.device}%`);
+  }
   if (filters.test_type) {
     where.push("t.test_type = ?");
     params.push(filters.test_type);