quilltap 4.4.0 → 4.5.0-dev.0

package/lib/completion/fish.template

@@ -0,0 +1,93 @@
+#!/usr/bin/env fish
+
+# Fish completion for quilltap
+
+# Top-level verbs
+complete -c quilltap -n '__fish_use_subcommand' -f -a 'db' -d 'Query encrypted databases'
+complete -c quilltap -n '__fish_use_subcommand' -f -a 'docs' -d 'Inspect and read document mounts'
+complete -c quilltap -n '__fish_use_subcommand' -f -a 'themes' -d 'Manage theme bundles'
+complete -c quilltap -n '__fish_use_subcommand' -f -a 'instances' -d 'Register or inspect instances'
+complete -c quilltap -n '__fish_use_subcommand' -f -a 'memories' -d 'Search and browse memories'
+complete -c quilltap -n '__fish_use_subcommand' -f -a 'memory-diff' -d 'Memory extraction dry-run'
+complete -c quilltap -n '__fish_use_subcommand' -f -a 'completion' -d 'Generate shell completion'
+
+# Global options
+complete -c quilltap -n '__fish_use_subcommand' -f -l 'port' -s 'p' -d 'Port to listen on' -x
+complete -c quilltap -n '__fish_use_subcommand' -f -l 'data-dir' -s 'd' -d 'Data directory' -x
+complete -c quilltap -n '__fish_use_subcommand' -f -l 'instance' -s 'i' -d 'Use registered instance' -x
+complete -c quilltap -n '__fish_use_subcommand' -f -l 'open' -s 'o' -d 'Open browser after start'
+complete -c quilltap -n '__fish_use_subcommand' -f -l 'version' -s 'v' -d 'Show version'
+complete -c quilltap -n '__fish_use_subcommand' -f -l 'update' -d 'Force re-download'
+complete -c quilltap -n '__fish_use_subcommand' -f -l 'help' -s 'h' -d 'Show help'
+
+# db subcommands
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'schema' -d 'Show database schema'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'find' -d 'Find entities by name'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'chats' -d 'Find chats'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'messages' -d 'Find messages'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'logs' -d 'Get LLM logs'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'message' -d 'Get single message'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'log' -d 'Get single log entry'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'memories' -d 'List memories'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'optimize' -d 'Optimize database'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'backup' -d 'Backup database'
+complete -c quilltap -n '__fish_seen_subcommand_from db' -f -a 'integrity' -d 'Check integrity'
+
+# docs subcommands
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'list' -d 'List mount points'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'show' -d 'Show mount details'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'files' -d 'List files in mount'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'ls' -d 'ls-style listing'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'dir' -d 'Directory listing'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'read' -d 'Print file contents'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'export' -d 'Export mount'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'scan' -d 'Trigger rescan'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'find' -d 'Substring search'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'grep' -d 'Pattern search in text'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'status' -d 'Per-mount status'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'reindex' -d 'Re-extract and chunk'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'embed' -d 'Enqueue embeddings'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'write' -d 'Write a file'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'delete' -d 'Delete a file'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'mkdir' -d 'Create folder'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'move' -d 'Move file'
+complete -c quilltap -n '__fish_seen_subcommand_from docs' -f -a 'copy' -d 'Copy file'
+
+# themes subcommands
+complete -c quilltap -n '__fish_seen_subcommand_from themes' -f -a 'list' -d 'List themes'
+complete -c quilltap -n '__fish_seen_subcommand_from themes' -f -a 'install' -d 'Install theme'
+complete -c quilltap -n '__fish_seen_subcommand_from themes' -f -a 'uninstall' -d 'Uninstall theme'
+complete -c quilltap -n '__fish_seen_subcommand_from themes' -f -a 'validate' -d 'Validate bundle'
+complete -c quilltap -n '__fish_seen_subcommand_from themes' -f -a 'export' -d 'Export theme'
+complete -c quilltap -n '__fish_seen_subcommand_from themes' -f -a 'create' -d 'Create theme'
+complete -c quilltap -n '__fish_seen_subcommand_from themes' -f -a 'search' -d 'Search registries'
+complete -c quilltap -n '__fish_seen_subcommand_from themes' -f -a 'update' -d 'Update themes'
+complete -c quilltap -n '__fish_seen_subcommand_from themes' -f -a 'registry' -d 'Manage registries'
+
+# instances subcommands
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'list' -d 'List instances'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'ls' -d 'List instances'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'show' -d 'Show instance'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'path' -d 'Show path'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'where' -d 'Show path'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'add' -d 'Register instance'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'create' -d 'Register instance'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'remove' -d 'Unregister'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'rm' -d 'Unregister'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'delete' -d 'Unregister'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'set-passphrase' -d 'Set passphrase'
+complete -c quilltap -n '__fish_seen_subcommand_from instances' -f -a 'passphrase' -d 'Set passphrase'
+
+# memories subcommands
+complete -c quilltap -n '__fish_seen_subcommand_from memories' -f -a 'ls' -d 'List memories'
+complete -c quilltap -n '__fish_seen_subcommand_from memories' -f -a 'find' -d 'Substring search'
+complete -c quilltap -n '__fish_seen_subcommand_from memories' -f -a 'grep' -d 'Pattern search'
+complete -c quilltap -n '__fish_seen_subcommand_from memories' -f -a 'show' -d 'Show memory'
+complete -c quilltap -n '__fish_seen_subcommand_from memories' -f -a 'tree' -d 'Graph walk'
+complete -c quilltap -n '__fish_seen_subcommand_from memories' -f -a 'status' -d 'Memory status'
+complete -c quilltap -n '__fish_seen_subcommand_from memories' -f -a 'validate' -d 'Health check'
+
+# completion subcommands
+complete -c quilltap -n '__fish_seen_subcommand_from completion' -f -a 'bash' -d 'Bash completion'
+complete -c quilltap -n '__fish_seen_subcommand_from completion' -f -a 'zsh' -d 'Zsh completion'
+complete -c quilltap -n '__fish_seen_subcommand_from completion' -f -a 'fish' -d 'Fish completion'

package/lib/completion/zsh.template

@@ -0,0 +1,209 @@
+#compdef quilltap
+
+# Zsh completion for quilltap
+
+local ret=1
+
+_quilltap() {
+  local -a subcommands
+  local -a global_options
+
+  global_options=(
+    '(-d --data-dir)'{-d,--data-dir}'[Data directory]:directory:_directories'
+    '(-i --instance)'{-i,--instance}'[Use a registered instance]:instance:_quilltap_instance_names'
+    '(-p --port)'{-p,--port}'[Port to listen on]:port:'
+    '(-o --open)'{-o,--open}'[Open browser after server starts]'
+    '(-v --version)'{-v,--version}'[Show version number]'
+    '(-h --help)'{-h,--help}'[Show help message]'
+    '--update[Force re-download of application files]'
+  )
+
+  subcommands=(
+    'db:Query encrypted databases'
+    'docs:Inspect, read, and export document mounts'
+    'themes:Manage theme bundles'
+    'instances:Register or inspect named Quilltap instances'
+    'memories:Search, browse, and graph memories'
+    'memory-diff:Dump existing memories and dry-run re-extraction'
+    'completion:Generate shell completion scripts'
+  )
+
+  _arguments -C \
+    '1: :->subcommand' \
+    "${global_options[@]}" \
+    '*::arg:->args'
+
+  case "$state" in
+    subcommand)
+      _describe 'command' subcommands
+      ;;
+    args)
+      _quilltap_subcommand
+      ;;
+  esac
+
+  return ret
+}
+
+_quilltap_subcommand() {
+  local subcommand="$words[1]"
+
+  case "$subcommand" in
+    db)
+      _quilltap_db
+      ;;
+    docs)
+      _quilltap_docs
+      ;;
+    themes)
+      _quilltap_themes
+      ;;
+    instances)
+      _quilltap_instances
+      ;;
+    memories)
+      _quilltap_memories
+      ;;
+    memory-diff)
+      _quilltap_memory_diff
+      ;;
+    completion)
+      _quilltap_completion
+      ;;
+  esac
+}
+
+_quilltap_db() {
+  local -a subverbs
+  subverbs=(
+    'schema:Show database schema'
+    'find:Find entities by name'
+    'chats:Find chats'
+    'messages:Find messages in a chat'
+    'logs:Get LLM request logs'
+    'message:Get a single message'
+    'log:Get a single LLM log entry'
+    'memories:List memories for a character'
+    'optimize:Optimize database'
+    'backup:Backup database'
+    'integrity:Check database integrity'
+  )
+
+  _values 'db subcommand' $subverbs
+}
+
+_quilltap_docs() {
+  local -a subverbs
+  subverbs=(
+    'list:List all mount points'
+    'show:Details for one mount point'
+    'files:List files in a mount'
+    'ls:ls-style listing'
+    'dir:Directory listing'
+    'read:Print file contents'
+    'export:Export mount to directory'
+    'scan:Trigger rescan'
+    'find:Substring search'
+    'grep:Pattern search inside text'
+    'status:Per-mount status'
+    'reindex:Re-extract and re-chunk'
+    'embed:Enqueue embedding jobs'
+    'write:Write a file'
+    'delete:Delete a file'
+    'mkdir:Create folder'
+    'move:Move file'
+    'copy:Copy file'
+  )
+
+  _values 'docs subcommand' $subverbs
+}
+
+_quilltap_themes() {
+  local -a subverbs
+  subverbs=(
+    'list:List available themes'
+    'install:Install a theme'
+    'uninstall:Uninstall a theme'
+    'validate:Validate a theme bundle'
+    'export:Export a theme'
+    'create:Create a new theme'
+    'search:Search theme registries'
+    'update:Update installed themes'
+    'registry:Manage registries'
+  )
+
+  _values 'themes subcommand' $subverbs
+}
+
+_quilltap_instances() {
+  local -a subverbs
+  subverbs=(
+    'list:List registered instances'
+    'ls:List instances'
+    'show:Show instance details'
+    'path:Show instance path'
+    'where:Show instance path'
+    'add:Register a new instance'
+    'create:Register a new instance'
+    'remove:Unregister an instance'
+    'rm:Unregister an instance'
+    'delete:Unregister an instance'
+    'set-passphrase:Set instance passphrase'
+    'passphrase:Set instance passphrase'
+  )
+
+  _values 'instances subcommand' $subverbs
+}
+
+_quilltap_memories() {
+  local -a subverbs mem_opts
+  subverbs=(
+    'ls:List memories'
+    'find:Substring search'
+    'grep:Pattern search with snippets'
+    'show:Show full record'
+    'tree:ASCII walk of graph'
+    'status:Per-character rollup'
+    'validate:Health check'
+  )
+
+  mem_opts=(
+    '--character[Character name or id]'
+    '--about[Subject of memory]'
+    '--source[AUTO or MANUAL]'
+    '--chat[Chat id or title]'
+    '--project[Project name or id]'
+    '--since[Since timestamp]'
+    '--until[Until timestamp]'
+    '--min-importance[Minimum importance]'
+    '--min-reinforced[Minimum reinforcement]'
+    '--has-embedding[Has embedding]'
+    '--no-embedding[No embedding]'
+    '--sort[Sort field]'
+    '--limit[Result limit]'
+    '--json[JSON output]'
+    '--help[Show help]'
+  )
+
+  _values 'memories subcommand' $subverbs
+  _arguments $mem_opts
+}
+
+_quilltap_memory_diff() {
+  _arguments \
+    '(-h --help)'{-h,--help}'[Show help]' \
+    '(-i --instance)'{-i,--instance}'[Use instance]:instance:_quilltap_instance_names' \
+    '(-d --data-dir)'{-d,--data-dir}'[Data directory]:directory:_directories'
+}
+
+_quilltap_completion() {
+  _values 'shell' bash zsh fish
+}
+
+_quilltap_instance_names() {
+  local instances
+  instances=(${(f)"$(command quilltap instances list --names-only 2>/dev/null)"})
+  _values 'instance' $instances
+}
+
+_quilltap "$@"

package/lib/completion-commands.js

@@ -0,0 +1,77 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function printCompletionHelp() {
+  console.log(`
+Quilltap Shell Completion
+
+Usage: quilltap completion <shell> [--help]
+
+Supported shells:
+  bash          Bash completion script
+  zsh           Zsh completion script
+  fish          Fish completion script
+
+This command generates a shell completion script for the given shell.
+To install:
+
+  Bash:
+    quilltap completion bash >> ~/.bashrc
+
+  Zsh:
+    mkdir -p ~/.zsh/completions
+    quilltap completion zsh > ~/.zsh/completions/_quilltap
+    # Then add to ~/.zshrc: fpath=(~/.zsh/completions $fpath)
+
+  Fish:
+    quilltap completion fish > ~/.config/fish/completions/quilltap.fish
+
+Examples:
+  quilltap completion bash | bash -c 'source /dev/stdin'  # Test in current shell
+  quilltap completion zsh                                 # Print to stdout
+  quilltap completion fish > ~/completions.fish           # Save to file
+`);
+}
+
+async function completionCommand(args) {
+  if (args.length === 0 || args[0] === '-h' || args[0] === '--help') {
+    printCompletionHelp();
+    process.exit(args.length === 0 ? 1 : 0);
+  }
+
+  const shell = args[0];
+
+  switch (shell) {
+    case 'bash':
+    case 'zsh':
+    case 'fish':
+      break;
+    case '--help':
+    case '-h':
+      printCompletionHelp();
+      process.exit(0);
+      break;
+    default:
+      console.error(`Error: Unknown shell '${shell}'. Supported shells: bash, zsh, fish`);
+      process.exit(1);
+  }
+
+  // Load the appropriate template file
+  const templatePath = path.join(__dirname, 'completion', `${shell}.template`);
+  let template;
+  try {
+    template = fs.readFileSync(templatePath, 'utf-8');
+  } catch (err) {
+    console.error(`Error: Could not load completion template for ${shell}: ${err.message}`);
+    process.exit(1);
+  }
+
+  // Print the template to stdout
+  process.stdout.write(template);
+}
+
+module.exports = {
+  completionCommand,
+};