quoxcli 0.0.0-stage → 0.3.1

package/lib/core/commandRegistrars.js

@@ -0,0 +1,121 @@
+/**
+ * The CLI's command groups, in registration order (moved verbatim from bin/quox.js so
+ * one list feeds both the binary and cli/scripts/export-leaf-tree.mjs, which exports the
+ * machine-readable leaf tree the collector's quox_cli tool validates against).
+ * Paths are relative to THIS file; registerCommandGroups resolves them against the
+ * baseUrl it is given (COMMAND_REGISTRARS_BASE).
+ */
+export const COMMAND_REGISTRARS = [
+  ['../commands/auth.js', 'registerAuthCommands'],
+  ['../commands/service.js', 'registerServiceCommands'],
+  ['../commands/status.js', 'registerStatusCommand'],
+  ['../commands/doctor.js', 'registerDoctorCommand'],
+  ['../commands/server.js', 'registerServerCommands'],
+  ['../commands/update.js', 'registerUpdateCommand'],
+  ['../commands/open.js', 'registerOpenCommand'],
+  ['../commands/peek.js', 'registerPeekCommand'],
+  ['../commands/aside.js', 'registerAsideCommand'],
+  ['../commands/motion.js', 'registerMotionCommand'],
+  ['../commands/welcome.js', 'registerWelcomeCommand'],
+  ['../commands/config-cmd.js', 'registerConfigCommands'],
+  ['../commands/org.js', 'registerOrgCommands'],
+  ['../commands/invites.js', 'registerInvitesCommands'],
+  ['../commands/team.js', 'registerTeamCommands'],
+  ['../commands/department.js', 'registerDepartmentCommands'],
+  ['../commands/agent.js', 'registerAgentCommands'],
+  ['../commands/tool.js', 'registerToolCommands'],
+  ['../commands/workflow.js', 'registerWorkflowCommands'],
+  ['../commands/objective.js', 'registerObjectiveCommands'],
+  ['../commands/assistant.js', 'registerAssistantCommands'],
+  ['../commands/fleet.js', 'registerFleetCommands'],
+  ['../commands/chat.js', 'registerChatCommands'],
+  ['../commands/memory.js', 'registerMemoryCommands'],
+  ['../commands/actions.js', 'registerActionsCommands'],
+  ['../commands/brain.js', 'registerBrainCommands'],
+  ['../commands/entity.js', 'registerEntityCommands'],
+  ['../commands/backup.js', 'registerBackupCommands'],
+  ['../commands/inbox.js', 'registerInboxCommands'],
+  ['../commands/approvals.js', 'registerApprovalsCommands'],
+  ['../commands/vm.js', 'registerVmCommands'],
+  ['../commands/router.js', 'registerRouterCommands'],
+  ['../commands/mail.js', 'registerMailCommands'],
+  ['../commands/calendar.js', 'registerCalendarCommands'],
+  ['../commands/notes.js', 'registerNotesCommands'],
+  ['../commands/contacts.js', 'registerContactsCommands'],
+  ['../commands/licence.js', 'registerLicenceCommands'],
+  ['../commands/run.js', 'registerRunCommands'],
+  ['../commands/file.js', 'registerFileCommands'],
+  ['../commands/admin.js', 'registerAdminCommands'],
+  ['../commands/aee.js', 'registerAeeCommands'],
+  ['../commands/integration.js', 'registerIntegrationCommands'],
+  ['../commands/consent.js', 'registerConsentCommands'],
+  ['../commands/setup.js', 'registerSetupCommands'],
+  ['../commands/watch.js', 'registerWatchCommands'],
+  ['../commands/tag.js', 'registerTagCommands'],
+  ['../commands/scope.js', 'registerScopeCommands'],
+  ['../commands/notification.js', 'registerNotificationCommands'],
+  ['../commands/prompt.js', 'registerPromptCommands'],
+  ['../commands/plugin.js', 'registerPluginCommands'],
+  ['../commands/powers.js', 'registerPowersCommands'],
+  ['../commands/conversation.js', 'registerConversationCommands'],
+  ['../commands/vault.js', 'registerVaultCommands'],
+  ['../commands/volt.js', 'registerVoltCommands'],
+  ['../commands/governance.js', 'registerGovernanceCommands'],
+  ['../commands/skills.js', 'registerSkillsCommands'],
+  ['../commands/claude.js', 'registerClaudeCommands'],
+  ['../commands/monitoring.js', 'registerMonitoringCommands'],
+  ['../commands/trigger.js', 'registerTriggerCommands'],
+  ['../commands/webhook.js', 'registerWebhookCommands'],
+  ['../commands/sso.js', 'registerSsoCommands'],
+  ['../commands/role.js', 'registerRoleCommands'],
+  ['../commands/domain.js', 'registerDomainCommands'],
+  ['../commands/security.js', 'registerSecurityCommands'],
+  ['../commands/safety.js', 'registerSafetyCommands'],
+  ['../commands/scim.js', 'registerScimCommands'],
+  ['../commands/llm-policy.js', 'registerLlmPolicyCommands'],
+  ['../commands/hat.js', 'registerHatCommands'],
+  ['../commands/rows.js', 'registerRowsCommands'],
+  ['../commands/settings.js', 'registerSettingsCommands'],
+  ['../commands/llm.js', 'registerLlmCommands'],
+  ['../commands/capabilities.js', 'registerCapabilitiesCommands'],
+  ['../commands/provider.js', 'registerProviderCommands'],
+  ['../commands/tips.js', 'registerTipsCommands'],
+  ['../commands/quoxchat.js', 'registerQuoxchatCommands'],
+  ['../commands/budget.js', 'registerBudgetCommands'],
+  ['../commands/trace.js', 'registerTraceCommands'],
+  ['../commands/mon.js', 'registerMonCommands'],
+  ['../commands/quoxbox.js', 'registerQuoxboxCommands'],
+  ['../commands/plan.js', 'registerPlanCommands'],
+  ['../commands/engagement.js', 'registerEngagementCommands'],
+  ['../commands/done.js', 'registerDoneCommands'],
+  ['../commands/discord.js', 'registerDiscordCommands'],
+  ['../commands/qlarity.js', 'registerQlarityCommands'],
+  ['../commands/fetchAllowlist.js', 'registerFetchAllowlistCommands'],
+  ['../commands/reach.js', 'registerReachCommands'],
+  ['../commands/inventory.js', 'registerInventoryCommands'],
+  ['../commands/policy.js', 'registerPolicyCommands'],
+  ['../commands/quoxseo.js', 'registerQuoxseoCommands'],
+  ['../commands/voice.js', 'registerVoiceCommands'],
+  ['../commands/awareness.js', 'registerAwarenessCommands'],
+  ['../commands/mind.js', 'registerMindCommands'],
+  ['../commands/lucid.js', 'registerLucidCommands'],
+  ['../commands/hyperion.js', 'registerHyperionCommands'],
+  ['../commands/tg.js', 'registerTgCommands'],
+  ['../commands/dev.js', 'registerDevCommands'],
+  ['../commands/build.js', 'registerBuildCommands'],
+  ['../commands/slot.js', 'registerSlotCommands'],
+  ['../commands/gripe.js', 'registerGripeCommands'],
+  ['../commands/ask.js', 'registerAskCommands'],
+  ['../commands/presence.js', 'registerPresenceCommands'],
+  ['../commands/dashboard.js', 'registerDashboardCommands'],
+  ['../commands/nucleus.js', 'registerNucleusCommands'],
+  ['../commands/onboard.js', 'registerOnboardCommands'],
+  ['../commands/x.js', 'registerXCommands'],
+  ['../commands/linkedin.js', 'registerLinkedInCommands'],
+  ['../commands/facebook.js', 'registerFacebookCommands'],
+  ['../commands/instagram.js', 'registerInstagramCommands'],
+  ['../commands/tiktok.js', 'registerTikTokCommands'],
+  ['../commands/offload.js', 'registerOffloadCommands'],
+];
+
+export const COMMAND_REGISTRARS_BASE = import.meta.url;

package/lib/core/completions.js

@@ -0,0 +1,163 @@
+/**
+ * Shell completion generator for QuoxCLI
+ *
+ * Generates completion scripts for bash, zsh, and fish shells.
+ * Install with: quox completion bash >> ~/.bashrc
+ */
+
+const COMMANDS = [
+  'login', 'logout', 'whoami', 'signup', 'mfa',
+  'org', 'team', 'department', 'agent', 'tool', 'workflow', 'assistant',
+  'fleet', 'chat', 'memory', 'entity', 'conversation',
+  'backup', 'inbox', 'run', 'file', 'admin', 'aee',
+  'integration', 'consent', 'setup', 'service', 'config',
+  'tag', 'scope', 'notification', 'watch', 'llm', 'quoxchat', 'tg',
+];
+
+const SUBCOMMANDS = {
+  org: ['list', 'get', 'create', 'update', 'delete', 'switch', 'members', 'divisions', 'audit'],
+  team: ['list', 'get', 'create', 'update', 'delete', 'provision-room', 'members'],
+  department: ['list', 'get', 'create', 'update', 'delete'],
+  agent: ['list', 'get', 'create', 'update', 'delete', 'activate', 'deactivate', 'tool'],
+  tool: ['list', 'get', 'create', 'update', 'delete', 'catalog', 'install', 'publish'],
+  workflow: ['list', 'get', 'create', 'update', 'delete', 'run', 'publish', 'steps'],
+  assistant: ['list', 'get', 'create', 'update', 'delete', 'deploy', 'fork'],
+  fleet: ['status', 'summary', 'agents', 'tools', 'exec', 'watch'],
+  chat: ['send', 'stream', 'status'],
+  memory: ['list', 'get', 'create', 'update', 'delete', 'search', 'stats', 'export'],
+  entity: ['list', 'get', 'create', 'search', 'relate'],
+  backup: ['list', 'get', 'create', 'delete', 'verify', 'restore', 'schedule'],
+  inbox: ['list', 'get', 'respond', 'stats'],
+  run: ['list', 'get', 'create', 'cancel', 'resume'],
+  file: ['upload', 'download', 'list', 'delete', 'stats'],
+  admin: ['config', 'key', 'service', 'logs', 'stats', 'retention'],
+  aee: ['store', 'get', 'query', 'conversations', 'stats'],
+  integration: ['list', 'get', 'create', 'update', 'delete', 'test'],
+  consent: ['list', 'grant', 'history'],
+  setup: ['status', 'admin', 'config', 'license'],
+  service: ['health'],
+  config: ['profile'],
+  mfa: ['setup', 'verify', 'disable', 'backup-codes'],
+  tag: ['list', 'create', 'update', 'delete'],
+  scope: ['list', 'create', 'update', 'delete'],
+  notification: ['channels'],
+  watch: ['fleet', 'services'],
+  llm: ['status'],
+  quoxchat: ['widgets', 'availability', 'conversations', 'transcript', 'reply'],
+  tg: ['status', 'bind-owner', 'leases', 'webhook-info', 'setup'],
+};
+
+const GLOBAL_FLAGS = [
+  '--output', '--json', '--quiet', '--org', '--profile',
+  '--no-color', '--verbose', '--debug', '--dry-run', '--yes', '--insecure',
+];
+
+export function generateBashCompletion() {
+  const cmds = COMMANDS.join(' ');
+  const subcmdCases = Object.entries(SUBCOMMANDS)
+    .map(([cmd, subs]) => `      ${cmd}) COMPREPLY=($(compgen -W "${subs.join(' ')}" -- "$cur")) ;;`)
+    .join('\n');
+
+  return `# QuoxCLI bash completion
+# Install: quox completion bash >> ~/.bashrc
+
+_quox_completions() {
+  local cur prev commands
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  commands="${cmds}"
+
+  if [[ \${COMP_CWORD} -eq 1 ]]; then
+    COMPREPLY=($(compgen -W "$commands ${GLOBAL_FLAGS.join(' ')}" -- "$cur"))
+    return 0
+  fi
+
+  case "\${COMP_WORDS[1]}" in
+${subcmdCases}
+  esac
+
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=($(compgen -W "${GLOBAL_FLAGS.join(' ')}" -- "$cur"))
+  fi
+}
+
+complete -F _quox_completions quox
+complete -F _quox_completions quoxcli
+`;
+}
+
+export function generateZshCompletion() {
+  const subcmdCases = Object.entries(SUBCOMMANDS)
+    .map(([cmd, subs]) => `    ${cmd}) compadd ${subs.join(' ')} ;;`)
+    .join('\n');
+
+  return `#compdef quox quoxcli
+# QuoxCLI zsh completion
+# Install: quox completion zsh > ~/.zsh/completions/_quox
+
+_quox() {
+  local -a commands
+  commands=(
+${COMMANDS.map(c => `    '${c}:${c} commands'`).join('\n')}
+  )
+
+  _arguments -C \\
+    '1:command:->command' \\
+    '*::arg:->args'
+
+  case $state in
+    command)
+      _describe 'command' commands
+      ;;
+    args)
+      case $words[1] in
+${subcmdCases}
+      esac
+      ;;
+  esac
+}
+
+_quox "$@"
+`;
+}
+
+export function generateFishCompletion() {
+  const lines = ['# QuoxCLI fish completion', '# Install: quox completion fish > ~/.config/fish/completions/quox.fish', ''];
+
+  // Top-level commands
+  for (const cmd of COMMANDS) {
+    lines.push(`complete -c quox -n '__fish_use_subcommand' -a '${cmd}' -d '${cmd} commands'`);
+  }
+  lines.push('');
+
+  // Subcommands
+  for (const [cmd, subs] of Object.entries(SUBCOMMANDS)) {
+    for (const sub of subs) {
+      lines.push(`complete -c quox -n '__fish_seen_subcommand_from ${cmd}' -a '${sub}'`);
+    }
+  }
+  lines.push('');
+
+  // Global flags
+  lines.push(`complete -c quox -l output -s o -d 'Output format (table|json|csv|quiet)'`);
+  lines.push(`complete -c quox -l json -d 'JSON output'`);
+  lines.push(`complete -c quox -l quiet -s q -d 'Quiet mode (IDs only)'`);
+  lines.push(`complete -c quox -l org -d 'Override active org'`);
+  lines.push(`complete -c quox -l profile -d 'Use named config profile'`);
+  lines.push(`complete -c quox -l verbose -s v -d 'Verbose output'`);
+  lines.push(`complete -c quox -l debug -d 'Debug HTTP requests'`);
+  lines.push(`complete -c quox -l dry-run -d 'Show what would happen'`);
+  lines.push(`complete -c quox -l yes -s y -d 'Skip confirmations'`);
+
+  return lines.join('\n') + '\n';
+}
+
+export function generateCompletion(shell) {
+  switch (shell) {
+    case 'bash': return generateBashCompletion();
+    case 'zsh': return generateZshCompletion();
+    case 'fish': return generateFishCompletion();
+    default: throw new Error(`Unsupported shell: ${shell}. Use bash, zsh, or fish.`);
+  }
+}