quilltap 4.8.0-dev.124 → 4.8.0-dev.136

package/README.md

@@ -187,6 +187,7 @@ quilltap docs status                            # Per-mount extraction + embeddi
 quilltap docs scan <mount>                                    # Trigger a rescan
 quilltap docs reindex <mount> [path] [--force]                # Re-extract + re-chunk
 quilltap docs embed <mount> [path] [--force] [--wait]         # Enqueue embedding jobs
+quilltap docs grep --semantic [--top N] [--threshold 0..1] <query>  # Embedding search over indexed chunks
 quilltap docs write [--force] [--base64] <mount> <path> [file]  # Stdin or file → mount
 quilltap docs read [--rendered] [--base64] <mount> <path>       # File contents → stdout
 quilltap docs delete <mount> <path>                           # Idempotent delete
@@ -226,6 +227,7 @@ quilltap memories grep -i --max 3 --context 1 "concrete examples"      # Pattern
 quilltap memories show <id|prefix> [--depth N] [--no-related]          # Full record + related-memory neighbourhood
 quilltap memories tree <id|prefix> [--depth N] [--max-nodes N]         # ASCII walk of the bidirectional related-memory graph
 quilltap memories status [--character <name|id>]                       # Per-holder rollup + dangling-edge check
+quilltap memories grep --semantic --character Ariadne "the argument"   # Embedding search (server required, one holder)
 ```
 
 Shared filter flags apply to `ls`, `find`, `grep`, and `status` where they make sense: `--character`, `--about` (with `self` / `none` shortcuts), `--source`, `--chat` (with `none` for manual entries), `--project`, `--since`, `--until`, `--min-importance`, `--min-reinforced`, `--has-embedding` / `--no-embedding`. Sort flags (`--sort reinforced|importance|created|accessed|reinforcement-count|links`, plus `-r` to reverse) apply to `ls`, `find`, and `grep`. Names accept fuzzy substrings; ambiguous names print candidates and exit 2. `--json` is supported by every verb. The legacy `quilltap db memories --character <name>` verb remains undisturbed.

package/lib/__tests__/completion-coverage.test.js

@@ -59,3 +59,38 @@ describe('CLI subcommand surface stays documented', () => {
     expect(missing).toEqual([]);
   });
 });
+
+/**
+ * A bare substring match is too weak: a subcommand named only in a shared
+ * `case` list still tab-completes its own flags as nothing. These check that
+ * each shell actually has a per-subcommand completion arm — the gap that let
+ * `file-verify` (all three shells) and `recall-replay` (fish) ship with the
+ * verb completing but none of its flags.
+ */
+describe('every subcommand has its own completion arm', () => {
+  function template(shell) {
+    return fs.readFileSync(path.join(COMPLETION_DIR, `${shell}.template`), 'utf8');
+  }
+
+  it('bash has a case arm per subcommand', () => {
+    const tpl = template('bash');
+    const missing = SUBCOMMANDS.filter((sub) => !new RegExp(`^\\s*${sub}\\)\\s*$`, 'm').test(tpl));
+    expect(missing).toEqual([]);
+  });
+
+  it('zsh dispatches every subcommand from _quilltap_subcommand', () => {
+    const tpl = template('zsh');
+    const body = tpl.match(/_quilltap_subcommand\(\) \{([\s\S]*?)\n\}/);
+    expect(body).toBeTruthy();
+    const missing = SUBCOMMANDS.filter((sub) => !new RegExp(`^\\s*${sub}\\)\\s*$`, 'm').test(body[1]));
+    expect(missing).toEqual([]);
+  });
+
+  it('fish offers every subcommand at top level and completes inside it', () => {
+    const tpl = template('fish');
+    const notOffered = SUBCOMMANDS.filter((sub) => !tpl.includes(`-a '${sub}'`));
+    expect(notOffered).toEqual([]);
+    const noFlags = SUBCOMMANDS.filter((sub) => !tpl.includes(`__quilltap_using_subcommand ${sub}'`));
+    expect(noFlags).toEqual([]);
+  });
+});

package/lib/completion/bash.template

@@ -244,6 +244,10 @@ _quilltap_complete() {
         COMPREPLY=($(compgen -W "$maint_flags" -- "$cur"))
       fi
       ;;
+    file-verify)
+      local fv_flags="--all --stall-ms --json --instance --data-dir --help"
+      COMPREPLY=($(compgen -W "$fv_flags" -- "$cur"))
+      ;;
     completion)
       if [[ "$cur" == -* ]]; then
         COMPREPLY=($(compgen -W "--help" -- "$cur"))

package/lib/completion/fish.template

@@ -55,6 +55,7 @@ complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'themes' -d 'Manage the
 complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'instances' -d 'Register or inspect instances'
 complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'memories' -d 'Search and browse memories'
 complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'memory-diff' -d 'Memory extraction dry-run'
+complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'recall-replay' -d 'Replay memory recall for a turn'
 complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'logs' -d 'Tail or print log files'
 complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'migrations' -d 'Inspect migration status'
 complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'maintenance' -d 'Run retention/cleanup sweeps'
@@ -261,6 +262,16 @@ complete -c quilltap -n '__quilltap_using_subcommand memory-diff' -l 'port' -s '
 complete -c quilltap -n '__quilltap_using_subcommand memory-diff' -l 'concurrency' -d 'Concurrency limit' -x
 complete -c quilltap -n '__quilltap_using_subcommand memory-diff' -l 'out' -d 'Output file' -r -F
 
+# ---------- recall-replay flags ----------
+complete -c quilltap -n '__quilltap_using_subcommand recall-replay' -l 'turn' -d 'Interchange to replay (1-based)' -x
+complete -c quilltap -n '__quilltap_using_subcommand recall-replay' -l 'char' -d 'Character whose memories are searched' -x
+complete -c quilltap -n '__quilltap_using_subcommand recall-replay' -l 'limit' -d 'Candidate rows per path' -x
+complete -c quilltap -n '__quilltap_using_subcommand recall-replay' -l 'port' -d 'Server port' -x
+
+# ---------- file-verify flags ----------
+complete -c quilltap -n '__quilltap_using_subcommand file-verify' -l 'all' -d 'Read every top-level file, not just dataless ones'
+complete -c quilltap -n '__quilltap_using_subcommand file-verify' -l 'stall-ms' -d 'Per-chunk stall threshold (ms)' -x
+
 # ---------- logs flags ----------
 complete -c quilltap -n '__quilltap_using_subcommand logs' -l 'stream' -d 'Log stream' -x -a 'combined error stdout stderr startup'
 complete -c quilltap -n '__quilltap_using_subcommand logs' -l 'tail' -d 'Last N lines (0=full)' -x

package/lib/completion/zsh.template

@@ -85,6 +85,9 @@ _quilltap_subcommand() {
     maintenance)
       _quilltap_maintenance
       ;;
+    file-verify)
+      _arguments '--all[read every top-level file, not just dataless ones]' '--stall-ms[per-chunk stall threshold in ms]:ms:' '--json[machine-readable output]' '--help[show help]'
+      ;;
     completion)
       _quilltap_completion
       ;;

package/lib/docs-commands.js

@@ -73,6 +73,9 @@ Read subcommands:
   status [--mount <name|id>] [--top N]   Per-mount extraction + embedding rollup
 
 Server-required subcommands (background-job queue lives in the running server):
+  grep --semantic [--mount <name|id|all>] [--top N] [--threshold 0..1] <query>
+                                         Embedding search over indexed chunks
+                                         (default --top 20, --threshold 0.5)
   reindex <mount> [path] [--force]       Re-extract text + re-chunk affected files
   embed <mount> [path] [--force] [--wait]
                                          Enqueue embedding jobs for un-embedded chunks
@@ -158,6 +161,7 @@ Examples:
   quilltap docs find --mount notes --ext md Knowledge
   quilltap docs grep --mount notes --ignore-case "five-point Calvinist"
   quilltap docs grep --mount notes -l "TODO"
+  quilltap docs grep --semantic --mount notes --top 10 "what did we decide about pricing"
   quilltap docs read qtap://notes/today.md
   quilltap docs find --uri Manifesto
   quilltap docs status

package/lib/memories-commands.js

@@ -1276,6 +1276,11 @@ Subcommands:
   grep     [filters] [-i] [-l] [--max N] [--context N] <pattern>
                                              Pattern search inside content
                                              with snippets.
+  grep --semantic --character <name|id> [--top N] [--threshold 0..1] <query>
+                                             Embedding search via the running
+                                             server (default --top 20,
+                                             --threshold 0.5). One holder at a
+                                             time; --port sets the server port.
   show     <id|prefix> [--depth N] [--no-related] [--json]
                                              Full record + related-memory
                                              neighbourhood.
@@ -1326,6 +1331,7 @@ Examples:
   quilltap memories ls --character Ariadne --sort created --limit 10
   quilltap memories find "concrete examples"
   quilltap memories grep -i --max 3 --context 1 "concrete examples"
+  quilltap memories grep --semantic --character Ariadne --top 10 "the argument about Calvin"
   quilltap memories show abc12345 --depth 2
   quilltap memories tree abc12345 --depth 3
   quilltap memories status --character Ariadne

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quilltap",
-  "version": "4.8.0-dev.124",
+  "version": "4.8.0-dev.136",
   "description": "Self-hosted AI workspace for writers, worldbuilders, and roleplayers. Run with npx quilltap.",
   "author": {
     "name": "Charles Sebold",
@@ -39,8 +39,8 @@
     "@napi-rs/canvas": "^0.1.100",
     "better-sqlite3-multiple-ciphers": "^12.11.1",
     "node-pty": "^1.1.0",
-    "sharp": "^0.34.5",
-    "tar": "^7.5.20",
+    "sharp": "^0.35.3",
+    "tar": "^7.5.22",
     "yauzl": "^3.4.0"
   },
   "engines": {