quilltap 4.10.0-dev.175 → 4.10.0-dev.183

package/README.md

@@ -234,7 +234,8 @@ quilltap docs list                              # All mounts
 quilltap docs show <mount>                      # One mount, with counts
 quilltap docs files <mount> [--folder <path>]   # Flat file list for a mount
 quilltap docs ls <mount> [path] [--links]       # POSIX-flavoured listing (alias: dir)
-quilltap docs tree <mount> [path]               # ASCII tree of a folder hierarchy (--depth, --max-nodes)
+quilltap docs ls <mount> [path] -R --sort time -r  # Recursive, grouped by folder, sorted by time and reversed
+quilltap docs tree <mount> [path]               # ASCII tree of a folder hierarchy (--depth, --max-nodes, --long)
 quilltap docs read [--rendered] <mount> <path>  # File contents → stdout
 quilltap docs export <mount> <outputDir>        # Mount → directory
 quilltap docs find <pattern>                    # Substring match on file names (--mount, --ext, --type, --limit)
@@ -258,6 +259,8 @@ quilltap docs rmdir <mount> <path>                            # Delete an empty
 quilltap docs mvdir <mount> <fromPath> <toPath>               # Rename/move a folder (server-required)
 ```
 
+`ls` flags: `--recursive` / `-R` lists every file below the path, grouped by folder; `--sort name|time|size|links` (default `name`) with `--reverse` / `-r` to flip it; `--links` lists the other mount/path entries under each file that has more than one hard link. `tree` takes `--depth N` (default 20), `--max-nodes N` (default 1000) and `--long`, which is accepted but reserved — it does not yet add columns.
+
 Mount arguments accept the mount name (case-insensitive) or a UUID; ambiguous names print candidates and exit non-zero. `--json` is supported by every verb; `reindex`, `embed`, `link`, `rmdir`, and `mvdir` refuse to run without a reachable server. `grep --semantic` goes through `POST /api/v1/mount-points?action=semantic-search`, because the embedding provider lives in the server; it defaults to `--top 20`, `--threshold 0.5`, `--port 3000`.
 
 ### Addressing documents with `qtap://` URIs
@@ -337,6 +340,7 @@ quilltap memories ls                                                   # All hol
 quilltap memories ls --character Ariadne --sort created --limit 10     # One holder, newest first
 quilltap memories find "concrete examples"                             # Substring match on summary (--in content|both)
 quilltap memories grep -i --max 3 --context 1 "concrete examples"      # Pattern search inside content, with snippets
+quilltap memories grep -l "concrete examples"                          # Matching memory IDs only, one per line (--paths-only)
 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>] [--port <n>]          # Per-holder rollup, maintenance ledger + dangling-edge check
@@ -348,7 +352,7 @@ quilltap memories maintain --character Ariadne --phases consolidate    # Queue a
 quilltap memories maintain --character all [--phases demote,retire]    # Queue maintenance for every character
 ```
 
-Shared filter flags apply to `ls`, `find`, `grep`, and `status` where they make sense: `--character`, `--about` (with `self` / `none` shortcuts), `--source` (AUTO / MANUAL / CONSOLIDATED), `--tier` (hot / cold; both by default, cold rows are starred in the `src` column), `--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. `validate` is `status`'s terse twin — read-only; it counts dangling `relatedMemoryIds` edges, dangling `consolidatedFrom` members (digests naming notes that are gone), dangling `supersededById` pointers, and rows with no embedding. It exits 1 if any dangling link remains (a missing embedding only warns), and `--list` prints the offending IDs. `grep --semantic` defaults to `--top 20`, `--threshold 0.5`, and scopes to **one holder at a time**: `--character all` is rejected. The legacy `quilltap db memories --character <name>` verb remains, now with `--tier hot|cold` (rows with no tier count as hot).
+Shared filter flags apply to `ls`, `find`, `grep`, and `status` where they make sense: `--character`, `--about` (with `self` / `none` shortcuts), `--source` (AUTO / MANUAL / CONSOLIDATED), `--tier` (hot / cold; both by default, cold rows are starred in the `src` column), `--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` / `--reverse` to flip it, `--limit N` (default 50) and `--full-titles` to stop chat titles being truncated to 32 characters) apply to `ls`, `find`, and `grep`. `grep -l` / `--paths-only` prints only the IDs of matching memories, one per line. Names accept fuzzy substrings; ambiguous names print candidates and exit 2. `--json` is supported by every verb. `validate` is `status`'s terse twin — read-only; it counts dangling `relatedMemoryIds` edges, dangling `consolidatedFrom` members (digests naming notes that are gone), dangling `supersededById` pointers, and rows with no embedding. It exits 1 if any dangling link remains (a missing embedding only warns), and `--list` prints the offending IDs. `grep --semantic` defaults to `--top 20`, `--threshold 0.5`, and scopes to **one holder at a time**: `--character all` is rejected. The legacy `quilltap db memories --character <name>` verb remains, now with `--tier hot|cold` (rows with no tier count as hot).
 
 Verbs that call the server (`grep --semantic`, `status`'s ledger, `maintain`, `validate --repair`) take `--port`; without it they use the port recorded in the `--instance` / `--data-dir` instance's lock, else 3000.
 
@@ -480,7 +484,13 @@ quilltap themes create sunset           # Scaffold a new theme
 quilltap themes search "dark"           # Search registries
 quilltap themes update                  # Check for theme updates
 quilltap themes registry list           # List configured registries
-quilltap themes registry add <url>      # Add a registry source
+quilltap themes registry add <url>      # Add a registry source (--key <pubkey>, --name <name>)
+quilltap themes registry remove <name>  # Remove a registry source
+quilltap themes registry refresh        # Refresh all registry indexes
+
+# For registry operators
+quilltap themes registry keygen [--output <dir>]     # Generate an Ed25519 keypair
+quilltap themes registry sign <dir> --key <private>  # Sign a registry directory
 ```
 
 ## Shell Completion
@@ -559,7 +569,7 @@ Fish picks new completion files up automatically — no shell restart needed.
 
 Completions **parse the line rather than counting words**, so a flag typed anywhere the CLI itself accepts one does not derail them: `quilltap docs --instance Friday <TAB>` still offers the `docs` verbs. bash and zsh also reuse the `-i` / `-d` / `--passphrase` already on the line when looking store names up, so the names offered come from the instance you are addressing rather than the default one. fish completes `--mount` but not the positionals, and always reads the default instance.
 
-Dynamic completions shell out to `quilltap`'s own subcommands. If the active instance is encrypted and no passphrase is reachable, the completion silently returns nothing rather than prompting in the middle of a tab.
+Dynamic completions shell out to `quilltap`'s own subcommands — `quilltap instances list --names-only` and `quilltap docs list --names-only`, which print one name per line and are handy in scripts too. If the active instance is encrypted and no passphrase is reachable, the completion silently returns nothing rather than prompting in the middle of a tab.
 
 ## Requirements
 

package/bin/quilltap.js

@@ -103,7 +103,7 @@ Subcommands:
   file-verify                   Force-download cloud-evicted data files (iCloud, etc.)
   memory-diff <chatId>          Dump existing memories and dry-run re-extraction for a chat
   recall-replay <chatId>        Replay a turn's memory recall, old vs episodic ranking
-  anchor-probe <characterId>    Probe whether episodic anchor lines suppress Memory Gate reinforcement
+  anchor-probe <characterId>    Probe whether episodic anchor lines suppress reinforcement at admission
   completion <shell>            Generate a shell completion script (bash / zsh / fish)
 
 Options:

package/lib/__tests__/migrations-source-ids.test.js

@@ -0,0 +1,54 @@
+/**
+ * `quilltap migrations status` compares the ledger against the ids it reads
+ * out of `migrations/scripts/*.ts`. Most migrations declare their id through a
+ * `MIGRATION_ID` constant rather than a string literal; when the reader only
+ * understood literals, every one of those vanished from "source" and showed up
+ * as "retired" on any instance that had run it.
+ *
+ * @jest-environment node
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const { extractMigrationId } = require('../migrations-commands');
+
+describe('extractMigrationId', () => {
+  it('reads a string-literal id', () => {
+    expect(extractMigrationId(`export const m = {\n  id: 'foo-v1',\n};`)).toBe('foo-v1');
+  });
+
+  it('resolves an id declared through MIGRATION_ID', () => {
+    const src = `const MIGRATION_ID = 'bar-v1';\nexport const m = {\n  id: MIGRATION_ID,\n};`;
+    expect(extractMigrationId(src)).toBe('bar-v1');
+  });
+
+  it('accepts a typed MIGRATION_ID constant', () => {
+    const src = `const MIGRATION_ID: string = 'baz-v1'\nexport const m = {\n  id: MIGRATION_ID,\n};`;
+    expect(extractMigrationId(src)).toBe('baz-v1');
+  });
+
+  it('returns null when no id is declared', () => {
+    expect(extractMigrationId('export const nothing = 1;')).toBeNull();
+  });
+});
+
+describe('every migration script yields an id', () => {
+  const scriptsDir = path.join(__dirname, '..', '..', '..', '..', 'migrations', 'scripts');
+  const files = fs.existsSync(scriptsDir)
+    ? fs.readdirSync(scriptsDir).filter((f) => f.endsWith('.ts') && f !== 'index.ts')
+    : [];
+
+  it('finds the migration scripts', () => {
+    expect(files.length).toBeGreaterThan(100);
+  });
+
+  it('extracts an id from each one', () => {
+    const missing = files.filter(
+      (f) => !extractMigrationId(fs.readFileSync(path.join(scriptsDir, f), 'utf8'))
+    );
+    expect(missing).toEqual([]);
+  });
+});

package/lib/completion/fish.template

@@ -61,7 +61,7 @@ complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'instances' -d 'Registe
 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 'anchor-probe' -d 'Probe anchor-line effect on Memory Gate'
+complete -c quilltap -n '__quilltap_no_subcommand' -f -a 'anchor-probe' -d 'Probe anchor-line effect on admission'
 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'

package/lib/completion/zsh.template

@@ -43,7 +43,7 @@ _quilltap() {
     'memories:Search, browse, and graph memories'
     'memory-diff:Dump existing memories and dry-run re-extraction'
     'recall-replay:Replay a turn'\''s memory recall, old vs episodic ranking'
-    'anchor-probe:Probe whether episodic anchor lines suppress Memory Gate reinforcement'
+    'anchor-probe:Probe whether episodic anchor lines suppress reinforcement at admission'
     'logs:Tail or print an instance log file'
     'migrations:Inspect migration status'
     'maintenance:Run retention/cleanup sweeps'

package/lib/migrations-commands.js

@@ -43,6 +43,19 @@ function parseFlags(args) {
 
 // ---------- migration list parsing ----------
 
+/**
+ * A migration's id is either a string literal on the object (`id: 'foo-v1'`)
+ * or a module constant (`id: MIGRATION_ID` beside `const MIGRATION_ID = 'foo-v1'`).
+ * Missing the constant form drops those migrations from "source", which then
+ * report as retired on every instance that ran them.
+ */
+function extractMigrationId(fileContent) {
+  const constMatch = fileContent.match(/^\s*const\s+MIGRATION_ID\s*(?::\s*\w+\s*)?=\s*['"]([^'"]+)['"]/m);
+  if (constMatch && /^\s*id:\s*MIGRATION_ID\b/m.test(fileContent)) return constMatch[1];
+  const literalMatch = fileContent.match(/^\s*id:\s*['"]([^'"]+)['"]/m);
+  return literalMatch ? literalMatch[1] : null;
+}
+
 // Reads the registered migration list from migrations/scripts/index.ts and resolves each
 // entry's real `id:` value by reading the imported source file. Heuristic camelCase→kebab
 // conversion is unreliable (some migrations omit `-v1`, others use `-v2`), so we always
@@ -95,11 +108,11 @@ function extractMigrationsFromSource() {
     const filePath = path.join(scriptsDir, info.filePath + '.ts');
     if (!fs.existsSync(filePath)) continue;
     const fileContent = fs.readFileSync(filePath, 'utf-8');
-    const idMatch = fileContent.match(/^\s*id:\s*['"]([^'"]+)['"]/m);
-    if (!idMatch) continue;
+    const id = extractMigrationId(fileContent);
+    if (!id) continue;
     migrations.push({
-      id: idMatch[1],
-      description: info.comment || idMatch[1],
+      id,
+      description: info.comment || id,
     });
   }
 
@@ -321,4 +334,5 @@ async function migrationsCommand(args) {
 
 module.exports = {
   migrationsCommand,
+  extractMigrationId,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quilltap",
-  "version": "4.10.0-dev.175",
+  "version": "4.10.0-dev.183",
   "description": "Self-hosted AI workspace for writers, worldbuilders, and roleplayers. Run with npx quilltap.",
   "author": {
     "name": "Charles Sebold",