@tikoci/rosetta 0.5.0 → 0.5.2

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.2",
   "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 {
@@ -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,7 +367,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"));
     }
   }
 
@@ -582,18 +613,20 @@ 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("");
@@ -688,6 +721,13 @@ function renderStats(): string {
   const out: string[] = [];
   out.push(`  ${bold("Database Statistics")}`);
   out.push(`  ${dim("Path:")} ${stats.db_path}`);
+  if (stats.db_size_bytes != null) {
+    const mb = stats.db_size_bytes / (1024 * 1024);
+    out.push(`  ${dim("Size:")} ${mb.toFixed(1)} MB`);
+  }
+  if (stats.schema_version != null) {
+    out.push(`  ${dim("Schema:")} v${stats.schema_version}`);
+  }
   out.push(`  ${dim("Export:")} ${stats.doc_export}`);
   out.push("");
 
@@ -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]", "", "Cross-device benchmarks", "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");
@@ -858,7 +899,7 @@ async function dispatch(input: string): Promise<void> {
         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: "" });
+          pushCtx({ type: "callouts", query: "", results: pageCallouts });
           return;
         }
       }
@@ -935,6 +976,30 @@ 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;
+    console.log(`\n  ${bold(v.title)}`);
+    if (v.chapter_title) console.log(`  ${magenta(`§ ${v.chapter_title}`)}  ${dim(`@ ${formatTime(v.start_s)}`)}`);
+    console.log(`  ${cyan(link(timeUrl))}\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 +1052,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 +1064,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 +1074,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> {
@@ -1056,16 +1121,25 @@ async function doTests(argsStr: string): Promise<void> {
     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> [mode] [packet_size]")}`);
     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);
+
+  // Known test types — if parts[0] is not a known type, treat it as a device filter
+  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];
+  if (parts[offset + 1]) filters.mode = parts[offset + 1];
+  if (parts[offset + 2] && /^\d+$/.test(parts[offset + 2])) filters.packet_size = Number.parseInt(parts[offset + 2], 10);
 
   const result = searchDeviceTests(filters);
   if (result.results.length === 0) {
@@ -1094,7 +1168,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 +1209,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 +1219,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> {
@@ -1172,6 +1246,7 @@ async function doCurrentVersions(): Promise<void> {
     const ch = pad(channel, 14);
     out.push(`  ${dim(ch)} ${bold(String(v))}`);
   }
+  out.push(`  ${dim(pad("winbox 4", 14))} ${bold(String(result.winbox ?? dim("unavailable")))}`);
   console.log(out.join("\n"));
 }
 
@@ -1210,7 +1285,7 @@ async function main() {
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,
-    prompt: `${cyan("rosetta")}${dim(">")} `,
+    prompt: buildPrompt(),
     terminal: true,
   });
 
@@ -1222,6 +1297,7 @@ async function main() {
     } catch (err) {
       console.error(red(`  Error: ${err instanceof Error ? err.message : String(err)}`));
     }
+    rl.setPrompt(buildPrompt());
     rl.prompt();
   });
 

package/src/db.ts

@@ -441,8 +441,24 @@ export function checkSchemaVersion(): { ok: boolean; actual: number; expected: n
 export function getDbStats() {
   const count = (sql: string) =>
     Number((db.prepare(sql).get() as { c: number }).c ?? 0);
+  const dbSizeBytes = (() => {
+    try {
+      return Bun.file(DB_PATH).size;
+    } catch {
+      return null;
+    }
+  })();
+  const schemaVersion = (() => {
+    try {
+      return (db.prepare("PRAGMA user_version").get() as { user_version: number }).user_version;
+    } catch {
+      return null;
+    }
+  })();
   return {
     db_path: DB_PATH,
+    db_size_bytes: dbSizeBytes,
+    schema_version: schemaVersion,
     pages: count("SELECT COUNT(*) AS c FROM pages"),
     sections: count("SELECT COUNT(*) AS c FROM sections"),
     properties: count("SELECT COUNT(*) AS c FROM properties"),

package/src/extract-devices.ts

@@ -120,7 +120,11 @@ if (lines.length < 2) {
 // Skip header row
 const dataLines = lines.slice(1);
 
-// Idempotent: clear existing data (FTS triggers handle cleanup)
+// Idempotent: clear existing data (FTS triggers handle cleanup).
+// device_test_results FKs into devices — wipe it first to avoid a FOREIGN KEY
+// constraint failure on re-run over a populated DB. extract-test-results runs
+// later in the pipeline and repopulates it.
+db.run("DELETE FROM device_test_results");
 db.run("DELETE FROM devices");
 
 const insert = db.prepare(`INSERT INTO devices (