@enjoys/context-engine 1.0.0

package/data/commands/terragrunt.json

@@ -0,0 +1,83 @@
+{
+  "name": "terragrunt",
+  "description": "Thin wrapper for Terraform providing extra tools for keeping configurations DRY",
+  "category": "DevOps/Infra",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [
+    { "name": "plan", "description": "Generate and show execution plan (wraps terraform plan)" },
+    { "name": "apply", "description": "Apply changes (wraps terraform apply)", "options": [{ "name": "--auto-approve", "description": "Skip approval prompt" }] },
+    { "name": "destroy", "description": "Destroy infrastructure (wraps terraform destroy)" },
+    { "name": "init", "description": "Initialize Terraform (wraps terraform init)" },
+    { "name": "validate", "description": "Validate configuration" },
+    { "name": "output", "description": "Show output values" },
+    { "name": "run-all", "description": "Run command in all subdirectories", "subcommands": [
+      { "name": "plan", "description": "Plan across all modules" },
+      { "name": "apply", "description": "Apply across all modules" },
+      { "name": "destroy", "description": "Destroy across all modules" },
+      { "name": "init", "description": "Init across all modules" },
+      { "name": "validate", "description": "Validate across all modules" },
+      { "name": "output", "description": "Show outputs across all modules" }
+    ]},
+    { "name": "graph-dependencies", "description": "Show dependency graph" },
+    { "name": "hclfmt", "description": "Format HCL files" },
+    { "name": "render-json", "description": "Render terragrunt.hcl as JSON" },
+    { "name": "aws-provider-patch", "description": "Patch AWS provider configs" },
+    { "name": "scaffold", "description": "Scaffold new module configuration" },
+    { "name": "catalog", "description": "Browse module catalog" }
+  ],
+  "globalOptions": [
+    { "name": "--terragrunt-config", "description": "Path to terragrunt.hcl", "takesValue": true },
+    { "name": "--terragrunt-working-dir", "description": "Working directory", "takesValue": true },
+    { "name": "--terragrunt-source", "description": "Override source in terragrunt.hcl", "takesValue": true },
+    { "name": "--terragrunt-non-interactive", "description": "Non-interactive mode" },
+    { "name": "--terragrunt-log-level", "description": "Log level (trace, debug, info, warn, error)", "takesValue": true },
+    { "name": "--terragrunt-no-auto-init", "description": "Don't auto-run init" },
+    { "name": "--terragrunt-no-auto-retry", "description": "Don't auto-retry on errors" },
+    { "name": "--terragrunt-parallelism", "description": "Number of parallel modules for run-all", "takesValue": true },
+    { "name": "--terragrunt-exclude-dir", "description": "Exclude directory from run-all", "takesValue": true },
+    { "name": "--terragrunt-include-dir", "description": "Include only this directory in run-all", "takesValue": true }
+  ],
+  "examples": [
+    { "command": "terragrunt plan", "description": "Run plan" },
+    { "command": "terragrunt apply --auto-approve", "description": "Apply without prompt" },
+    { "command": "terragrunt run-all apply", "description": "Apply all modules" },
+    { "command": "terragrunt graph-dependencies", "description": "Show dependency graph" },
+    { "command": "terragrunt hclfmt", "description": "Format HCL files" },
+    { "command": "terragrunt run-all plan --terragrunt-parallelism 4", "description": "Parallel plan" },
+    { "command": "terragrunt render-json", "description": "Render config as JSON" }
+  ],
+  "relatedCommands": ["terraform", "pulumi"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "config_file",
+        "description": "Terragrunt configuration",
+        "command": "cat terragrunt.hcl 2>/dev/null | head -30",
+        "parser": "text",
+        "cacheFor": 30
+      },
+      {
+        "name": "modules",
+        "description": "Terragrunt modules in subdirectories",
+        "command": "find . -name 'terragrunt.hcl' -not -path './.terragrunt-cache/*' 2>/dev/null | head -20",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "dependencies",
+        "description": "Module dependencies",
+        "command": "grep -r 'dependency' terragrunt.hcl 2>/dev/null | head -10",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "terraform_source",
+        "description": "Terraform source modules",
+        "command": "grep 'source' terragrunt.hcl 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 60
+      }
+    ]
+  }
+}

package/data/commands/tsc.json

@@ -0,0 +1,85 @@
+{
+  "name": "tsc",
+  "description": "TypeScript compiler - compile TypeScript to JavaScript",
+  "category": "Node Ecosystem",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "--init", "description": "Create a tsconfig.json file" },
+    { "name": "--project", "shorthand": "-p", "description": "Compile from tsconfig path", "takesValue": true },
+    { "name": "--build", "shorthand": "-b", "description": "Build project references" },
+    { "name": "--watch", "shorthand": "-w", "description": "Watch for changes" },
+    { "name": "--outDir", "description": "Output directory", "takesValue": true },
+    { "name": "--outFile", "description": "Concatenate to single output file", "takesValue": true },
+    { "name": "--rootDir", "description": "Root directory of source files", "takesValue": true },
+    { "name": "--target", "description": "ECMAScript target (ES5, ES6, ES2015-ES2022, ESNext)", "takesValue": true },
+    { "name": "--module", "description": "Module system (commonjs, es2015, es2020, esnext, nodenext)", "takesValue": true },
+    { "name": "--moduleResolution", "description": "Resolution strategy (node, nodenext, bundler)", "takesValue": true },
+    { "name": "--strict", "description": "Enable all strict checks" },
+    { "name": "--noEmit", "description": "Don't emit output files" },
+    { "name": "--declaration", "shorthand": "-d", "description": "Generate .d.ts files" },
+    { "name": "--declarationMap", "description": "Generate declaration sourcemaps" },
+    { "name": "--sourceMap", "description": "Generate source maps" },
+    { "name": "--jsx", "description": "JSX mode (preserve, react, react-jsx, react-jsxdev)", "takesValue": true },
+    { "name": "--lib", "description": "Library files to include", "takesValue": true },
+    { "name": "--types", "description": "Type packages to include", "takesValue": true },
+    { "name": "--esModuleInterop", "description": "Enable ES module interop" },
+    { "name": "--resolveJsonModule", "description": "Enable JSON module resolution" },
+    { "name": "--skipLibCheck", "description": "Skip type checking of .d.ts files" },
+    { "name": "--noUnusedLocals", "description": "Report unused locals" },
+    { "name": "--noUnusedParameters", "description": "Report unused parameters" },
+    { "name": "--noImplicitAny", "description": "Error on implicit any" },
+    { "name": "--noImplicitReturns", "description": "Error on missing returns" },
+    { "name": "--pretty", "description": "Pretty-print errors" },
+    { "name": "--showConfig", "description": "Print resolved config" },
+    { "name": "--listFiles", "description": "List files in compilation" },
+    { "name": "--incremental", "description": "Enable incremental compilation" },
+    { "name": "--composite", "description": "Enable project references" },
+    { "name": "--help", "shorthand": "-h", "description": "Show help" },
+    { "name": "--version", "shorthand": "-v", "description": "Show version" }
+  ],
+  "examples": [
+    { "command": "tsc", "description": "Compile using tsconfig.json" },
+    { "command": "tsc --init", "description": "Create tsconfig.json" },
+    { "command": "tsc --watch", "description": "Compile in watch mode" },
+    { "command": "tsc --noEmit", "description": "Type-check without emitting" },
+    { "command": "tsc -p tsconfig.build.json", "description": "Compile with specific config" },
+    { "command": "tsc -b", "description": "Build project references" },
+    { "command": "tsc --showConfig", "description": "Show resolved config" },
+    { "command": "tsc src/index.ts --outDir dist --target ES2020", "description": "Compile single file" }
+  ],
+  "relatedCommands": ["node", "eslint", "prettier"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "tsconfig",
+        "description": "TypeScript configuration",
+        "command": "cat tsconfig.json 2>/dev/null",
+        "parser": "json",
+        "cacheFor": 30
+      },
+      {
+        "name": "tsconfig_files",
+        "description": "All tsconfig files",
+        "command": "find . -maxdepth 3 -name 'tsconfig*.json' 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 60
+      },
+      {
+        "name": "ts_version",
+        "description": "Installed TypeScript version",
+        "command": "npx tsc --version 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 300
+      },
+      {
+        "name": "ts_files",
+        "description": "TypeScript source files",
+        "command": "find src -name '*.ts' -o -name '*.tsx' 2>/dev/null | head -20",
+        "parser": "lines",
+        "cacheFor": 30
+      }
+    ]
+  }
+}

package/data/commands/turbo.json

@@ -0,0 +1,72 @@
+{
+  "name": "turbo",
+  "description": "Turborepo - high-performance build system for JavaScript/TypeScript monorepos",
+  "category": "Node Ecosystem",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [
+    { "name": "run", "description": "Run tasks across packages", "args": [{ "name": "tasks", "description": "Tasks to run", "required": true }], "options": [{ "name": "--filter", "shorthand": "-F", "description": "Filter packages", "takesValue": true }, { "name": "--parallel", "description": "Run tasks in parallel" }, { "name": "--concurrency", "description": "Max concurrent tasks", "takesValue": true }, { "name": "--continue", "description": "Continue on error" }, { "name": "--dry-run", "description": "Show task plan without executing" }, { "name": "--graph", "description": "Generate task graph (dot format)", "takesValue": true }, { "name": "--cache-dir", "description": "Cache directory", "takesValue": true }, { "name": "--force", "description": "Ignore cache" }, { "name": "--no-cache", "description": "Disable caching" }, { "name": "--output-logs", "description": "Log output mode (full, hash-only, new-only, errors-only, none)", "takesValue": true }, { "name": "--only", "description": "Run only specified tasks, no deps" }, { "name": "--env-mode", "description": "Environment variable mode (strict, loose)", "takesValue": true }] },
+    { "name": "prune", "description": "Prune workspace for deployment", "options": [{ "name": "--scope", "description": "Package to prune for", "takesValue": true }, { "name": "--docker", "description": "Output Docker-optimized structure" }, { "name": "--out-dir", "description": "Output directory", "takesValue": true }] },
+    { "name": "gen", "description": "Generate code", "subcommands": [
+      { "name": "workspace", "description": "Add a new package to the monorepo", "options": [{ "name": "--name", "description": "Package name", "takesValue": true }, { "name": "--copy", "description": "Copy from existing package", "takesValue": true }] }
+    ]},
+    { "name": "login", "description": "Login to Vercel Remote Cache" },
+    { "name": "logout", "description": "Logout from Vercel Remote Cache" },
+    { "name": "link", "description": "Link to a Vercel team for Remote Cache" },
+    { "name": "unlink", "description": "Unlink from Vercel team" },
+    { "name": "daemon", "description": "Manage turbo daemon", "subcommands": [
+      { "name": "status", "description": "Show daemon status" },
+      { "name": "start", "description": "Start the daemon" },
+      { "name": "stop", "description": "Stop the daemon" }
+    ]},
+    { "name": "bin", "description": "Show turbo binary path" },
+    { "name": "ls", "description": "List packages in the monorepo", "options": [{ "name": "--filter", "shorthand": "-F", "description": "Filter packages", "takesValue": true }] }
+  ],
+  "globalOptions": [
+    { "name": "--help", "shorthand": "-h", "description": "Show help" },
+    { "name": "--version", "description": "Show version" },
+    { "name": "--cwd", "description": "Working directory", "takesValue": true },
+    { "name": "--verbosity", "description": "Verbosity level", "takesValue": true }
+  ],
+  "examples": [
+    { "command": "turbo run build", "description": "Build all packages" },
+    { "command": "turbo run test --filter=@myorg/web", "description": "Test a specific package" },
+    { "command": "turbo run lint build test --parallel", "description": "Run multiple tasks in parallel" },
+    { "command": "turbo run build --dry-run", "description": "Preview build plan" },
+    { "command": "turbo prune --scope=@myorg/web --docker", "description": "Prune for Docker deployment" },
+    { "command": "turbo run dev --filter=./apps/*", "description": "Dev all apps" }
+  ],
+  "relatedCommands": ["nx", "npm", "pnpm", "yarn"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "turbo_config",
+        "description": "Turbo configuration",
+        "command": "cat turbo.json 2>/dev/null",
+        "parser": "json",
+        "cacheFor": 30
+      },
+      {
+        "name": "workspaces",
+        "description": "Monorepo packages",
+        "command": "turbo ls --json 2>/dev/null || node -e \"const p=require('./package.json');(p.workspaces||[]).forEach(w=>console.log(w))\" 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 60
+      },
+      {
+        "name": "tasks",
+        "description": "Available pipeline tasks",
+        "command": "cat turbo.json 2>/dev/null | node -e \"const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));console.log(Object.keys(d.tasks||d.pipeline||{}).join('\\n'))\" 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "package_scripts",
+        "description": "Root package.json scripts",
+        "command": "node -e \"const p=require('./package.json');Object.keys(p.scripts||{}).forEach(s=>console.log(s))\" 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 30
+      }
+    ]
+  }
+}

package/data/commands/ufw.json

@@ -0,0 +1,76 @@
+{
+  "name": "ufw",
+  "description": "Uncomplicated Firewall - frontend for iptables",
+  "category": "Linux Coreutils",
+  "platforms": ["linux"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [
+    { "name": "enable", "description": "Enable the firewall" },
+    { "name": "disable", "description": "Disable the firewall" },
+    { "name": "reset", "description": "Reset to default rules" },
+    { "name": "reload", "description": "Reload firewall rules" },
+    { "name": "status", "description": "Show firewall status", "options": [
+      { "name": "verbose", "description": "Detailed status" },
+      { "name": "numbered", "description": "Show rule numbers" }
+    ]},
+    { "name": "allow", "description": "Add allow rule", "args": [{ "name": "rule", "description": "Port/service/IP (e.g. 80, ssh, from 10.0.0.0/8)", "required": true }] },
+    { "name": "deny", "description": "Add deny rule", "args": [{ "name": "rule", "description": "Port/service/IP", "required": true }] },
+    { "name": "reject", "description": "Add reject rule", "args": [{ "name": "rule", "description": "Port/service/IP", "required": true }] },
+    { "name": "limit", "description": "Rate limit connections", "args": [{ "name": "rule", "description": "Port/service", "required": true }] },
+    { "name": "delete", "description": "Delete a rule", "args": [{ "name": "rule_or_num", "description": "Rule number or specification", "required": true }] },
+    { "name": "insert", "description": "Insert rule at position", "args": [{ "name": "num", "description": "Rule number", "required": true }] },
+    { "name": "route", "description": "Add routed firewall rule" },
+    { "name": "logging", "description": "Set logging level", "args": [{ "name": "level", "description": "off, low, medium, high, full", "required": true }] },
+    { "name": "default", "description": "Set default policy", "args": [{ "name": "policy", "description": "allow, deny, reject", "required": true }, { "name": "direction", "description": "incoming, outgoing, routed", "required": false }] },
+    { "name": "app", "description": "Application profiles", "subcommands": [
+      { "name": "list", "description": "List application profiles" },
+      { "name": "info", "description": "Show profile details", "args": [{ "name": "name", "description": "Profile name", "required": true }] },
+      { "name": "update", "description": "Update profile" },
+      { "name": "default", "description": "Set default app policy" }
+    ]}
+  ],
+  "globalOptions": [
+    { "name": "--dry-run", "description": "Don't modify anything" },
+    { "name": "--force", "description": "Force operation" }
+  ],
+  "examples": [
+    { "command": "sudo ufw enable", "description": "Enable firewall" },
+    { "command": "sudo ufw status verbose", "description": "Detailed status" },
+    { "command": "sudo ufw allow 80/tcp", "description": "Allow HTTP" },
+    { "command": "sudo ufw allow ssh", "description": "Allow SSH" },
+    { "command": "sudo ufw allow from 10.0.0.0/8", "description": "Allow subnet" },
+    { "command": "sudo ufw deny 3306", "description": "Deny MySQL port" },
+    { "command": "sudo ufw delete allow 80/tcp", "description": "Delete a rule" },
+    { "command": "sudo ufw limit ssh", "description": "Rate limit SSH" },
+    { "command": "sudo ufw allow proto tcp from any to any port 80,443", "description": "Allow HTTP+HTTPS" },
+    { "command": "sudo ufw default deny incoming", "description": "Default deny incoming" }
+  ],
+  "relatedCommands": ["iptables", "nft"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "status",
+        "description": "Firewall status and rules",
+        "command": "sudo ufw status numbered 2>/dev/null || ufw status numbered 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 15,
+        "requiresCmd": "ufw"
+      },
+      {
+        "name": "app_profiles",
+        "description": "Available application profiles",
+        "command": "ufw app list 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 60,
+        "requiresCmd": "ufw"
+      },
+      {
+        "name": "listening_ports",
+        "description": "Ports currently in use",
+        "command": "ss -tlnp 2>/dev/null | awk 'NR>1 {print $4}' | sort -u | head -20",
+        "parser": "lines",
+        "cacheFor": 15
+      }
+    ]
+  }
+}

package/data/commands/unzip.json

@@ -0,0 +1,59 @@
+{
+  "name": "unzip",
+  "description": "Extract files from ZIP archives",
+  "category": "Linux Coreutils",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-d", "description": "Extract to specified directory", "takesValue": true },
+    { "name": "-o", "description": "Overwrite without prompting" },
+    { "name": "-n", "description": "Never overwrite existing files" },
+    { "name": "-l", "description": "List archive contents" },
+    { "name": "-t", "description": "Test archive integrity" },
+    { "name": "-v", "description": "Verbose listing or extraction" },
+    { "name": "-q", "description": "Quiet mode" },
+    { "name": "-j", "description": "Junk paths (don't create directories)" },
+    { "name": "-x", "description": "Exclude files matching pattern", "takesValue": true },
+    { "name": "-p", "description": "Extract to stdout (pipe)" },
+    { "name": "-P", "description": "Extract absolute paths (DANGEROUS)" },
+    { "name": "-Z", "description": "zipinfo mode" },
+    { "name": "-c", "description": "Extract to stdout with filenames" },
+    { "name": "-a", "description": "Auto-convert text files" },
+    { "name": "-B", "description": "Backup existing files before overwrite" },
+    { "name": "-C", "description": "Case-insensitive matching" },
+    { "name": "-K", "description": "Preserve setuid/setgid/sticky bits" },
+    { "name": "-L", "description": "Convert filenames to lowercase" },
+    { "name": "-X", "description": "Restore UID/GID info" }
+  ],
+  "examples": [
+    { "command": "unzip archive.zip", "description": "Extract to current directory" },
+    { "command": "unzip archive.zip -d output/", "description": "Extract to directory" },
+    { "command": "unzip -l archive.zip", "description": "List contents" },
+    { "command": "unzip -o archive.zip", "description": "Extract overwriting files" },
+    { "command": "unzip archive.zip '*.txt'", "description": "Extract only txt files" },
+    { "command": "unzip -t archive.zip", "description": "Test integrity" },
+    { "command": "unzip archive.zip -x '*.log'", "description": "Extract excluding pattern" },
+    { "command": "unzip -p archive.zip file.txt | head", "description": "Extract to stdout" }
+  ],
+  "relatedCommands": ["zip", "tar"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "zip_files",
+        "description": "Available ZIP archives",
+        "command": "find . -maxdepth 2 -name '*.zip' 2>/dev/null | head -10",
+        "parser": "lines",
+        "cacheFor": 15
+      },
+      {
+        "name": "archive_contents",
+        "description": "Contents of most recent zip",
+        "command": "unzip -l $(ls -t *.zip 2>/dev/null | head -1) 2>/dev/null | tail -n +4 | head -20",
+        "parser": "lines",
+        "cacheFor": 15,
+        "requiresCmd": "unzip"
+      }
+    ]
+  }
+}

package/data/commands/uvicorn.json

@@ -0,0 +1,73 @@
+{
+  "name": "uvicorn",
+  "description": "Lightning-fast ASGI server for Python web applications",
+  "category": "Python Ecosystem",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "--host", "description": "Bind host", "takesValue": true },
+    { "name": "--port", "description": "Bind port", "takesValue": true },
+    { "name": "--uds", "description": "Unix domain socket", "takesValue": true },
+    { "name": "--fd", "description": "File descriptor", "takesValue": true },
+    { "name": "--reload", "description": "Enable auto-reload" },
+    { "name": "--reload-dir", "description": "Directories to watch", "takesValue": true },
+    { "name": "--reload-include", "description": "File patterns to watch", "takesValue": true },
+    { "name": "--reload-exclude", "description": "File patterns to exclude", "takesValue": true },
+    { "name": "--workers", "description": "Number of worker processes", "takesValue": true },
+    { "name": "--loop", "description": "Event loop (auto, asyncio, uvloop)", "takesValue": true },
+    { "name": "--http", "description": "HTTP protocol (auto, h11, httptools)", "takesValue": true },
+    { "name": "--ws", "description": "WebSocket protocol (auto, none, websockets, wsproto)", "takesValue": true },
+    { "name": "--ws-max-size", "description": "WebSocket max message size", "takesValue": true },
+    { "name": "--lifespan", "description": "Lifespan mode (auto, on, off)", "takesValue": true },
+    { "name": "--interface", "description": "Application interface (auto, asgi3, asgi2, wsgi)", "takesValue": true },
+    { "name": "--log-level", "description": "Log level (critical, error, warning, info, debug, trace)", "takesValue": true },
+    { "name": "--log-config", "description": "Logging config file", "takesValue": true },
+    { "name": "--access-log", "description": "Enable access log" },
+    { "name": "--no-access-log", "description": "Disable access log" },
+    { "name": "--proxy-headers", "description": "Enable proxy headers" },
+    { "name": "--ssl-keyfile", "description": "SSL key file", "takesValue": true },
+    { "name": "--ssl-certfile", "description": "SSL cert file", "takesValue": true },
+    { "name": "--ssl-keyfile-password", "description": "SSL key password", "takesValue": true },
+    { "name": "--root-path", "description": "ASGI root_path", "takesValue": true },
+    { "name": "--limit-concurrency", "description": "Max concurrent connections", "takesValue": true },
+    { "name": "--limit-max-requests", "description": "Max requests before restart", "takesValue": true },
+    { "name": "--timeout-keep-alive", "description": "Keep-alive timeout", "takesValue": true },
+    { "name": "--factory", "description": "Treat APP as a factory function" },
+    { "name": "--help", "shorthand": "-h", "description": "Show help" },
+    { "name": "--version", "description": "Show version" }
+  ],
+  "examples": [
+    { "command": "uvicorn main:app", "description": "Run ASGI app" },
+    { "command": "uvicorn main:app --reload --port 8000", "description": "Dev server with hot reload" },
+    { "command": "uvicorn main:app --host 0.0.0.0 --workers 4", "description": "Production with 4 workers" },
+    { "command": "uvicorn main:app --ssl-keyfile=key.pem --ssl-certfile=cert.pem", "description": "Run with HTTPS" },
+    { "command": "uvicorn app.main:create_app --factory", "description": "Run factory app" }
+  ],
+  "relatedCommands": ["gunicorn", "python", "flask"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "asgi_apps",
+        "description": "ASGI application entry points",
+        "command": "grep -rl 'FastAPI\\|Starlette\\|app\\s*=' *.py 2>/dev/null | head -5",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "pyproject",
+        "description": "Project configuration",
+        "command": "cat pyproject.toml 2>/dev/null | head -20",
+        "parser": "text",
+        "cacheFor": 60
+      },
+      {
+        "name": "virtualenv",
+        "description": "Active virtual environment",
+        "command": "echo $VIRTUAL_ENV 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 30
+      }
+    ]
+  }
+}

package/data/commands/vault.json

@@ -0,0 +1,144 @@
+{
+  "name": "vault",
+  "description": "HashiCorp Vault - secrets management, encryption, and access control",
+  "category": "DevOps/Infra",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [
+    { "name": "server", "description": "Start Vault server", "options": [
+      { "name": "-dev", "description": "Dev mode (in-memory, unsealed)" },
+      { "name": "-dev-root-token-id", "description": "Dev root token", "takesValue": true },
+      { "name": "-config", "description": "Config file/dir", "takesValue": true },
+      { "name": "-log-level", "description": "Log level", "takesValue": true }
+    ]},
+    { "name": "status", "description": "Show Vault seal status" },
+    { "name": "login", "description": "Authenticate to Vault", "options": [
+      { "name": "-method", "description": "Auth method", "takesValue": true },
+      { "name": "-token-only", "description": "Print only the token" },
+      { "name": "-no-store", "description": "Don't persist token" }
+    ]},
+    { "name": "kv", "description": "KV secrets engine", "subcommands": [
+      { "name": "put", "description": "Write a secret", "args": [{ "name": "path", "description": "Secret path", "required": true }] },
+      { "name": "get", "description": "Read a secret", "args": [{ "name": "path", "description": "Secret path", "required": true }], "options": [{ "name": "-format", "description": "Output format", "takesValue": true }, { "name": "-field", "description": "Specific field", "takesValue": true }] },
+      { "name": "delete", "description": "Delete a secret" },
+      { "name": "list", "description": "List secrets at path" },
+      { "name": "metadata", "description": "Manage secret metadata", "subcommands": [
+        { "name": "get", "description": "Get metadata" },
+        { "name": "put", "description": "Set metadata" },
+        { "name": "delete", "description": "Delete metadata" }
+      ]},
+      { "name": "patch", "description": "Patch a secret" },
+      { "name": "rollback", "description": "Rollback to previous version" },
+      { "name": "undelete", "description": "Undelete versions" },
+      { "name": "destroy", "description": "Permanently destroy versions" }
+    ]},
+    { "name": "secrets", "description": "Secrets engine management", "subcommands": [
+      { "name": "enable", "description": "Enable secrets engine" },
+      { "name": "disable", "description": "Disable secrets engine" },
+      { "name": "list", "description": "List enabled engines" },
+      { "name": "tune", "description": "Tune secrets engine" },
+      { "name": "move", "description": "Move secrets engine" }
+    ]},
+    { "name": "auth", "description": "Auth method management", "subcommands": [
+      { "name": "enable", "description": "Enable auth method" },
+      { "name": "disable", "description": "Disable auth method" },
+      { "name": "list", "description": "List enabled auth methods" },
+      { "name": "tune", "description": "Tune auth method" }
+    ]},
+    { "name": "policy", "description": "Policy management", "subcommands": [
+      { "name": "write", "description": "Write policy" },
+      { "name": "read", "description": "Read policy" },
+      { "name": "delete", "description": "Delete policy" },
+      { "name": "list", "description": "List policies" },
+      { "name": "fmt", "description": "Format policy" }
+    ]},
+    { "name": "token", "description": "Token management", "subcommands": [
+      { "name": "create", "description": "Create token" },
+      { "name": "lookup", "description": "Lookup token" },
+      { "name": "renew", "description": "Renew token" },
+      { "name": "revoke", "description": "Revoke token" },
+      { "name": "capabilities", "description": "Check capabilities" }
+    ]},
+    { "name": "operator", "description": "Cluster operations", "subcommands": [
+      { "name": "init", "description": "Initialize Vault" },
+      { "name": "unseal", "description": "Unseal Vault" },
+      { "name": "seal", "description": "Seal Vault" },
+      { "name": "rekey", "description": "Rekey Vault" },
+      { "name": "raft", "description": "Raft operations" },
+      { "name": "step-down", "description": "Step down as leader" }
+    ]},
+    { "name": "read", "description": "Read data from Vault", "args": [{ "name": "path", "description": "Path to read", "required": true }] },
+    { "name": "write", "description": "Write data to Vault", "args": [{ "name": "path", "description": "Path to write", "required": true }] },
+    { "name": "delete", "description": "Delete data from Vault", "args": [{ "name": "path", "description": "Path to delete", "required": true }] },
+    { "name": "list", "description": "List data at path", "args": [{ "name": "path", "description": "Path to list", "required": true }] },
+    { "name": "lease", "description": "Lease management", "subcommands": [
+      { "name": "renew", "description": "Renew lease" },
+      { "name": "revoke", "description": "Revoke lease" },
+      { "name": "lookup", "description": "Lookup lease" }
+    ]}
+  ],
+  "globalOptions": [
+    { "name": "-address", "description": "Vault server address", "takesValue": true },
+    { "name": "-token", "description": "Vault token", "takesValue": true },
+    { "name": "-namespace", "description": "Vault namespace", "takesValue": true },
+    { "name": "-format", "description": "Output format (table, json, yaml)", "takesValue": true },
+    { "name": "-field", "description": "Print specific field", "takesValue": true },
+    { "name": "-tls-skip-verify", "description": "Skip TLS verification" },
+    { "name": "-output-curl-string", "description": "Show equivalent curl" },
+    { "name": "--help", "shorthand": "-h", "description": "Show help" }
+  ],
+  "examples": [
+    { "command": "vault server -dev", "description": "Start dev server" },
+    { "command": "vault kv put secret/myapp key=value", "description": "Store a secret" },
+    { "command": "vault kv get -format=json secret/myapp", "description": "Read a secret as JSON" },
+    { "command": "vault kv list secret/", "description": "List secrets" },
+    { "command": "vault secrets list", "description": "List secrets engines" },
+    { "command": "vault status", "description": "Check seal status" },
+    { "command": "vault login -method=userpass username=admin", "description": "Login with userpass" },
+    { "command": "vault policy write my-policy policy.hcl", "description": "Create policy" }
+  ],
+  "relatedCommands": ["consul", "nomad", "terraform"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "status",
+        "description": "Vault status",
+        "command": "vault status -format=json 2>/dev/null",
+        "parser": "json",
+        "cacheFor": 15,
+        "requiresCmd": "vault"
+      },
+      {
+        "name": "secrets_engines",
+        "description": "Enabled secrets engines",
+        "command": "vault secrets list -format=json 2>/dev/null",
+        "parser": "json",
+        "cacheFor": 60,
+        "requiresCmd": "vault"
+      },
+      {
+        "name": "auth_methods",
+        "description": "Enabled auth methods",
+        "command": "vault auth list -format=json 2>/dev/null",
+        "parser": "json",
+        "cacheFor": 60,
+        "requiresCmd": "vault"
+      },
+      {
+        "name": "policies",
+        "description": "Available policies",
+        "command": "vault policy list 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 60,
+        "requiresCmd": "vault"
+      },
+      {
+        "name": "env",
+        "description": "Vault environment",
+        "command": "echo \"VAULT_ADDR=$VAULT_ADDR\nVAULT_NAMESPACE=$VAULT_NAMESPACE\"",
+        "parser": "keyvalue",
+        "cacheFor": 30
+      }
+    ]
+  }
+}