rv-bible-cli 0.1.0 → 0.1.1

package/README.md

@@ -1,19 +1,21 @@
-# rv — Recovery Version Bible CLI
+# rvb — Recovery Version Bible CLI
 
 A fast, study-grade terminal Bible reader for the Recovery Version. Offline-first, footnote-aware, cross-reference deep-linking, clipboard-friendly.
 
 ```
 npm install -g rv-bible-cli
-rv
+rvb
 ```
 
+> **Note:** `rv` also works as an alias on Mac/Linux.
+
 ## Quick Start
 
 ```bash
-rv john 3          # read a chapter (interactive pager)
-rv john 3:16       # read a single verse
-rv search grace    # concordance search (1,129 curated words)
-rv help            # see all commands and shortcuts
+rvb john 3          # read a chapter (interactive pager)
+rvb john 3:16       # read a single verse
+rvb search grace    # concordance search (1,129 curated words)
+rvb help            # see all commands and shortcuts
 ```
 
 ## Features
@@ -21,24 +23,24 @@ rv help            # see all commands and shortcuts
 ### Reading
 
 ```bash
-rv john 3              # chapter mode — opens full-screen pager
-rv john 3:16           # single verse
-rv john 3:16-18        # verse range
-rv john 3:16,18,20     # specific verses
-rv john 3:16 rom 8:28  # verses across books
-rv jn 3                # fuzzy book names (jn, gen, rm, eph, rev, etc.)
-rv john 3 --notes      # inline footnote markers + footnote block
-rv john 3 --outline    # section headers inline
-rv john 3 --full       # both notes and outline
-rv john 3 --raw        # plain text, no pager (also auto when piped)
+rvb john 3              # chapter mode — opens full-screen pager
+rvb john 3:16           # single verse
+rvb john 3:16-18        # verse range
+rvb john 3:16,18,20     # specific verses
+rvb john 3:16 rom 8:28  # verses across books
+rvb jn 3                # fuzzy book names (jn, gen, rm, eph, rev, etc.)
+rvb john 3 --notes      # inline footnote markers + footnote block
+rvb john 3 --outline    # section headers inline
+rvb john 3 --full       # both notes and outline
+rvb john 3 --raw        # plain text, no pager (also auto when piped)
 ```
 
 ### Footnotes
 
 ```bash
-rv note john 3:16      # all footnotes for a verse
-rv note john 3:16 2d   # specific footnote by marker
-rv note john 3:14-16   # footnotes for a range
+rvb note john 3:16      # all footnotes for a verse
+rvb note john 3:16 2d   # specific footnote by marker
+rvb note john 3:14-16   # footnotes for a range
 ```
 
 ### Search
@@ -46,12 +48,12 @@ rv note john 3:14-16   # footnotes for a range
 Concordance-first for known words (1,129 curated entries), FTS5 full-text for everything else.
 
 ```bash
-rv search grace              # concordance lookup
-rv search grace in romans    # scoped to a book
-rv search "only begotten"    # phrase match
-rv search eternal life       # multi-word AND
-rv search grace --fts        # force raw FTS5
-rv search grace --all        # show all results (default: 20/page)
+rvb search grace              # concordance lookup
+rvb search grace in romans    # scoped to a book
+rvb search "only begotten"    # phrase match
+rvb search eternal life       # multi-word AND
+rvb search grace --fts        # force raw FTS5
+rvb search grace --all        # show all results (default: 20/page)
 ```
 
 ### Copy to Clipboard
@@ -59,18 +61,18 @@ rv search grace --all        # show all results (default: 20/page)
 Add `--copy` to any read command. Output displays normally AND goes to clipboard.
 
 ```bash
-rv john 3:16 --copy              # "John 3:16 For God so loved..."
-rv john 3:16 --copy --no-ref     # plain text only
-rv john 3:16 --copy --numbered   # "16 For God so loved..."
-rv john 3:16 --copy --md         # markdown block quote
-rv search grace --copy           # copy all results
+rvb john 3:16 --copy              # "John 3:16 For God so loved..."
+rvb john 3:16 --copy --no-ref     # plain text only
+rvb john 3:16 --copy --numbered   # "16 For God so loved..."
+rvb john 3:16 --copy --md         # markdown block quote
+rvb search grace --copy           # copy all results
 ```
 
 ### Navigation
 
 ```bash
-rv                # home screen — browse books, pick chapters
-rv continue       # resume last-read chapter
+rvb                # home screen — browse books, pick chapters
+rvb continue       # resume last-read chapter
 ```
 
 ## Pager
@@ -124,7 +126,7 @@ Study mode persists across navigation — follow a cross-ref and you stay in stu
 
 ### Home Screen
 
-Press `H` from the pager or run `rv` with no arguments.
+Press `H` from the pager or run `rvb` with no arguments.
 
 | Key | Action |
 |-----|--------|

package/dist/index.js

@@ -85,10 +85,10 @@ function renderHomepage() {
     if (last) {
         const bookName = getBookInfo(last.book)?.full_name ?? last.book;
         lines.push(chalk.dim(`  Last read: ${bookName} ${last.chapter}`));
-        lines.push(chalk.dim('  › rv continue'));
+        lines.push(chalk.dim('  › rvb continue'));
     }
     else {
-        lines.push(chalk.dim('  Get started: rv john 1'));
+        lines.push(chalk.dim('  Get started: rvb john 1'));
     }
     lines.push('');
     // Book grid
@@ -110,7 +110,7 @@ function renderHomepage() {
     lines.push(...renderGrid(nt));
     lines.push('');
     // Hints
-    lines.push(chalk.dim('  rv <book> <chapter>   rv search <query>   rv continue'));
+    lines.push(chalk.dim('  rvb <book> <chapter>   rvb search <query>   rvb continue'));
     lines.push('');
     console.log(lines.join('\n'));
 }
@@ -229,7 +229,7 @@ program
     .option('--copy', 'copy displayed output to clipboard')
     .action(async (args, opts) => {
     if (args.length === 0) {
-        console.error('Usage: rv note <ref> [marker]  (e.g. rv note john 3:16 or rv note john 3:16 1a)');
+        console.error('Usage: rvb note <ref> [marker]  (e.g. rvb note john 3:16 or rvb note john 3:16 1a)');
         process.exit(1);
     }
     // Try no-marker mode: parse all args as verse refs (every ref must have verses).
@@ -263,7 +263,7 @@ program
     }
     // Marker mode: last token is the marker, everything before is the ref.
     if (args.length < 2) {
-        console.error('Usage: rv note <ref> <marker>  (e.g. rv note john 3:16 1a)');
+        console.error('Usage: rvb note <ref> <marker>  (e.g. rvb note john 3:16 1a)');
         process.exit(1);
     }
     const marker = args[args.length - 1];
@@ -351,7 +351,7 @@ program
     .action(async (queryArgs, opts) => {
     const { queryTokens, book } = parseScope(queryArgs);
     if (queryTokens.length === 0) {
-        console.error('Usage: rv search <query> [in <book>]');
+        console.error('Usage: rvb search <query> [in <book>]');
         process.exit(1);
     }
     const word = queryTokens.join(' ');
@@ -428,7 +428,7 @@ program
         if (!isTTY) {
             // Non-interactive: show "showing N of M" hint and stop
             const ftsFlag = opts.fts ? ' --fts' : '';
-            const cmd = `rv search ${word}${book ? ` in ${(getBookInfo(book)?.full_name ?? book).toLowerCase()}` : ''}${ftsFlag}`;
+            const cmd = `rvb search ${word}${book ? ` in ${(getBookInfo(book)?.full_name ?? book).toLowerCase()}` : ''}${ftsFlag}`;
             console.log('');
             console.log(chalk.dim(`  showing ${offset} of ${all.length}  ·  ${cmd} --all to show all`));
             break;
@@ -457,7 +457,7 @@ program
     .action(async (opts) => {
     const last = getLastRead();
     if (!last) {
-        console.log(chalk.dim('  Nothing read yet — try: rv john 1'));
+        console.log(chalk.dim('  Nothing read yet — try: rvb john 1'));
         return;
     }
     if (opts.full) {
@@ -504,43 +504,43 @@ program
     const b = chalk.bold;
     const c = chalk.cyan;
     console.log(`
-${b('rv — Recovery Version Bible CLI')}
+${b('rvb — Recovery Version Bible CLI')}
 
 ${b('READING')}
-  ${c('rv john 3')}              Read a chapter (opens pager in terminal)
-  ${c('rv john 3:16')}           Read a single verse
-  ${c('rv john 3:16-18')}        Read a verse range
-  ${c('rv john 3:16,18,20')}     Multiple specific verses
-  ${c('rv john 3:16 rom 8:28')}  Verses across books
-  ${c('rv jn 3')}                Fuzzy book names ${d('(jn → John, gen → Genesis, rm → Romans)')}
-  ${c('rv john 3 --notes')}      Show footnote markers + footnote block
-  ${c('rv john 3 --outline')}    Show section headers inline
-  ${c('rv john 3 --full')}       Both notes and outline
-  ${c('rv john 3 --raw')}        Plain text, no pager ${d('(also auto when piped)')}
+  ${c('rvb john 3')}              Read a chapter (opens pager in terminal)
+  ${c('rvb john 3:16')}           Read a single verse
+  ${c('rvb john 3:16-18')}        Read a verse range
+  ${c('rvb john 3:16,18,20')}     Multiple specific verses
+  ${c('rvb john 3:16 rom 8:28')}  Verses across books
+  ${c('rvb jn 3')}                Fuzzy book names ${d('(jn → John, gen → Genesis, rm → Romans)')}
+  ${c('rvb john 3 --notes')}      Show footnote markers + footnote block
+  ${c('rvb john 3 --outline')}    Show section headers inline
+  ${c('rvb john 3 --full')}       Both notes and outline
+  ${c('rvb john 3 --raw')}        Plain text, no pager ${d('(also auto when piped)')}
 
 ${b('FOOTNOTES')}
-  ${c('rv note john 3:16')}      All footnotes for a verse
-  ${c('rv note john 3:16 2d')}   Specific footnote by marker
-  ${c('rv note john 3:14-16')}   Footnotes for a range
+  ${c('rvb note john 3:16')}      All footnotes for a verse
+  ${c('rvb note john 3:16 2d')}   Specific footnote by marker
+  ${c('rvb note john 3:14-16')}   Footnotes for a range
 
 ${b('SEARCH')}  ${d('concordance-first for known words, FTS5 for everything else')}
-  ${c('rv search grace')}        Concordance lookup ${d('(1,129 curated words)')}
-  ${c('rv search grace in rom')} Scoped to a book
-  ${c('rv search "only begotten"')}  Phrase match via FTS5
-  ${c('rv search eternal life')}     Multi-word AND match
-  ${c('rv search grace --fts')}  Force raw FTS5
-  ${c('rv search grace --all')}  Show all results ${d('(default: 20 per page)')}
+  ${c('rvb search grace')}        Concordance lookup ${d('(1,129 curated words)')}
+  ${c('rvb search grace in rom')} Scoped to a book
+  ${c('rvb search "only begotten"')}  Phrase match via FTS5
+  ${c('rvb search eternal life')}     Multi-word AND match
+  ${c('rvb search grace --fts')}  Force raw FTS5
+  ${c('rvb search grace --all')}  Show all results ${d('(default: 20 per page)')}
 
 ${b('NAVIGATION')}
-  ${c('rv')}                     Home screen — browse books, pick chapters
-  ${c('rv continue')}            Resume last-read chapter
+  ${c('rvb')}                     Home screen — browse books, pick chapters
+  ${c('rvb continue')}            Resume last-read chapter
 
 ${b('COPY')}  ${d('add --copy to any read command')}
-  ${c('rv john 3:16 --copy')}           Copy with reference prefix
-  ${c('rv john 3:16 --copy --no-ref')}  Plain text only
-  ${c('rv john 3:16 --copy --numbered')} Verse number prefix
-  ${c('rv john 3:16 --copy --md')}      Markdown block quote
-  ${c('rv search grace --copy')}        Copy all search results
+  ${c('rvb john 3:16 --copy')}           Copy with reference prefix
+  ${c('rvb john 3:16 --copy --no-ref')}  Plain text only
+  ${c('rvb john 3:16 --copy --numbered')} Verse number prefix
+  ${c('rvb john 3:16 --copy --md')}      Markdown block quote
+  ${c('rvb search grace --copy')}        Copy all search results
 
 ${b('PAGER SHORTCUTS')}  ${d('chapter mode in terminal')}
   ${d('Scroll')}     ↑↓ or j/k line  ·  Space/b page  ·  g top  ·  G bottom

package/dist/ui/Pager.js

@@ -931,8 +931,10 @@ function Pager({ initialBook, initialChapter, initialNotes, initialOutline, star
         MajorProphets: 'Major Prophets', MinorProphets: 'Minor Prophets',
         Gospels: 'Gospels', Paul: 'Epistles of Paul', Others: 'General Epistles & Prophecy',
     };
+    // Acts is miscategorized as "Gospels" in the DB — override it
+    const BOOK_OVERRIDES = { Act: 'History of the Church' };
     const bookInfo = getBookInfo(book);
-    const categoryLabel = CATEGORY_LABELS[bookInfo?.category ?? ''] ?? '';
+    const categoryLabel = BOOK_OVERRIDES[book] ?? CATEGORY_LABELS[bookInfo?.category ?? ''] ?? '';
     const topVerseIdx = verseAtLine(verseMap, scrollOffset) + 1;
     const title = `${bookName} ${chapter}`;
     const position = `${topVerseIdx}/${verses.length}`;

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "rv-bible-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Fast, offline terminal Bible reader for the Recovery Version. Footnotes, cross-references, concordance search, interactive pager.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "rv": "dist/index.js"
+    "rv": "dist/index.js",
+    "rvb": "dist/index.js"
   },
   "files": [
     "dist/",