@enjoys/context-engine 1.0.0

package/README.md

@@ -0,0 +1,213 @@
+# @enjoys/context-engine
+
+Comprehensive CLI command context engine with **133 tools** — subcommands, options, examples, and runtime context detectors for intelligent terminal autocomplete.
+
+## Install
+
+```bash
+npm install @enjoys/context-engine
+```
+
+## Usage
+
+### CommonJS
+
+```js
+const {
+  getCommand,
+  getAllCommands,
+  listCommandNames,
+  searchCommands,
+  getCommandsByCategory,
+  getCommandsByPlatform,
+  getCategories,
+  getContextEngine,
+  getSubcommands,
+  getGlobalOptions,
+  getExamples,
+  count,
+} = require("@enjoys/context-engine");
+```
+
+### ESM
+
+```js
+import {
+  getCommand,
+  getAllCommands,
+  searchCommands,
+  count,
+} from "@enjoys/context-engine";
+```
+
+## API
+
+### `getCommand(name)`
+
+Get a single command definition by name.
+
+```js
+const git = getCommand("git");
+console.log(git.subcommands.map((s) => s.name));
+// ['init', 'clone', 'add', 'commit', 'push', ...]
+```
+
+### `getAllCommands()`
+
+Return all 133 command objects as an array.
+
+### `listCommandNames()`
+
+Return sorted array of all command names.
+
+```js
+listCommandNames();
+// ['air', 'ansible', 'apachectl', 'apt', 'apt-get', 'awk', 'aws', ...]
+```
+
+### `searchCommands(query)`
+
+Search commands by name, description, or category (case-insensitive).
+
+```js
+searchCommands("docker");
+// [{ name: 'docker', ... }]
+
+searchCommands("testing");
+// [{ name: 'jest', ... }, { name: 'vitest', ... }, ...]
+```
+
+### `getCommandsByCategory(category)`
+
+Filter by category (case-insensitive partial match).
+
+```js
+getCommandsByCategory("database");
+// [psql, mysql, mongosh, sqlite3, redis-cli, ...]
+```
+
+### `getCommandsByPlatform(platform)`
+
+Filter by platform: `"linux"` | `"macos"` | `"windows"`.
+
+```js
+getCommandsByPlatform("windows");
+// [choco, winget, ...]
+```
+
+### `getCategories()`
+
+Return all unique category names.
+
+```js
+getCategories();
+// ['Build Tools', 'Cloud CLIs', 'Database', ...]
+```
+
+### `getContextEngine(name)`
+
+Get runtime context detectors for a command.
+
+```js
+const ctx = getContextEngine("docker");
+// { detectors: [{ name: 'containers', command: 'docker ps ...', parser: 'lines', ... }] }
+```
+
+### `getSubcommands(name)`
+
+```js
+getSubcommands("git");
+// [{ name: 'init', description: '...', options: [...] }, ...]
+```
+
+### `getGlobalOptions(name)`
+
+```js
+getGlobalOptions("curl");
+// [{ name: '-X', description: 'HTTP method', ... }, ...]
+```
+
+### `getExamples(name)`
+
+```js
+getExamples("docker");
+// [{ command: 'docker run -d nginx', description: 'Run nginx in background' }, ...]
+```
+
+### `count()`
+
+```js
+count(); // 133
+```
+
+### `resolveCommandPath(name)`
+
+Get absolute filesystem path to a command's JSON file.
+
+```js
+resolveCommandPath("git");
+// '/path/to/node_modules/@enjoys/context-engine/data/commands/git.json'
+```
+
+### `dataDir`
+
+Absolute path to the commands directory.
+
+### `clearCache()`
+
+Clear the in-memory cache (useful in tests).
+
+## Direct JSON Import
+
+Access raw JSON files directly:
+
+```js
+const git = require("@enjoys/context-engine/commands/git.json");
+```
+
+## Covered Tools (133)
+
+| Category | Tools |
+|----------|-------|
+| **Cloud CLIs** | aws, az, gcloud, doctl, linode-cli, vercel, netlify, firebase, supabase, railway, render, flyctl, cloudflare, aws-vault |
+| **Container & Orchestration** | docker, kubectl, helm |
+| **Version Control** | git, gh, glab, svn, hg |
+| **Node.js Ecosystem** | node, npm, npx, yarn, pnpm, bun, deno, turbo, nx, vite, next, nest, tsc, eslint, prettier |
+| **Python Ecosystem** | python, pip, pipx, poetry, pipenv, conda, pytest, uvicorn, gunicorn, django-admin, flask |
+| **Rust & Go** | cargo, rust, rustup, wasm-pack, go, gofmt, golangci-lint, air |
+| **Java/JVM** | java, gradle, mvn |
+| **Database** | psql, pg_dump, pg_restore, mysql, mongosh, redis-cli, sqlite3, cockroach, influx, clickhouse-client |
+| **DevOps & Infrastructure** | terraform, terragrunt, pulumi, packer, vault, consul, nomad, ansible |
+| **Web Servers** | nginx, caddy, httpd, apachectl |
+| **Build Tools** | make, cmake, bazel, just |
+| **Linux Core** | ls, cp, mv, rm, cat, grep, find, sed, awk, tar, chmod, chown, ps, sudo, ssh, ssh-keygen, rsync, curl, wget, systemctl, cd, zip, unzip, scp, journalctl, ufw, iptables, nft |
+| **Testing** | jest, vitest, mocha, playwright, cypress, k6, locust |
+| **Network & Security** | nmap, tcpdump, wireshark, openssl, certbot |
+| **Package Managers** | apt, apt-get, yum, dnf, pacman, brew, choco, winget |
+
+## Context Engine
+
+Each command includes a `contextEngine` with runtime `detectors` — shell commands that gather live context (running containers, git branches, installed packages, etc.) for intelligent autocomplete:
+
+```json
+{
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "branches",
+        "description": "Local git branches",
+        "command": "git branch --format='%(refname:short)'",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "git"
+      }
+    ]
+  }
+}
+```
+
+**Parser types:** `text` | `lines` | `json` | `csv` | `keyvalue` | `regex` | `table`
+
+## License
+
+MIT © Enjoys Inc

package/data/commands/air.json

@@ -0,0 +1,59 @@
+{
+  "name": "air",
+  "description": "Live reload for Go applications during development",
+  "category": "Go Ecosystem",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [
+    { "name": "init", "description": "Generate default .air.toml config file" }
+  ],
+  "globalOptions": [
+    { "name": "-c", "description": "Config file path", "takesValue": true },
+    { "name": "-d", "description": "Debug mode" },
+    { "name": "--build.cmd", "description": "Build command", "takesValue": true },
+    { "name": "--build.bin", "description": "Binary output path", "takesValue": true },
+    { "name": "--build.include_ext", "description": "File extensions to watch", "takesValue": true },
+    { "name": "--build.exclude_dir", "description": "Directories to exclude", "takesValue": true },
+    { "name": "--build.delay", "description": "Delay before rebuild (ms)", "takesValue": true }
+  ],
+  "examples": [
+    { "command": "air", "description": "Start live reload with default config" },
+    { "command": "air init", "description": "Generate .air.toml config" },
+    { "command": "air -c .air.toml", "description": "Use specific config" },
+    { "command": "air -d", "description": "Run with debug output" },
+    { "command": "air --build.cmd 'go build -o ./tmp/main ./cmd/api'", "description": "Custom build command" }
+  ],
+  "relatedCommands": ["go", "gofmt", "golangci-lint"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "air_config",
+        "description": "Air configuration file",
+        "command": "cat .air.toml 2>/dev/null || cat .air.conf 2>/dev/null || echo 'no config found'",
+        "parser": "text",
+        "cacheFor": 30
+      },
+      {
+        "name": "go_module",
+        "description": "Go module name",
+        "command": "head -1 go.mod 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 120
+      },
+      {
+        "name": "main_packages",
+        "description": "Go main packages",
+        "command": "grep -rl 'func main()' --include='*.go' . 2>/dev/null | head -5",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "tmp_dir",
+        "description": "Air temp build output",
+        "command": "ls tmp/ 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 15
+      }
+    ]
+  }
+}

package/data/commands/ansible.json

@@ -0,0 +1,24 @@
+{
+  "name": "ansible",
+  "description": "IT automation tool for configuration management, deployment, and orchestration",
+  "category": "infrastructure",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [
+    { "name": "ansible-playbook", "description": "Run Ansible playbooks", "args": [{ "name": "<playbook>", "type": "file", "required": true, "description": "Playbook YAML file" }], "options": [{ "name": "--inventory", "short": "-i", "description": "Inventory file or host list", "type": "file" }, { "name": "--extra-vars", "short": "-e", "description": "Set additional variables", "type": "string" }, { "name": "--tags", "short": "-t", "description": "Only run tagged tasks", "type": "string" }, { "name": "--skip-tags", "description": "Skip tagged tasks", "type": "string" }, { "name": "--limit", "short": "-l", "description": "Limit to hosts", "type": "string" }, { "name": "--check", "short": "-C", "description": "Dry run" }, { "name": "--diff", "short": "-D", "description": "Show file diffs" }, { "name": "--verbose", "short": "-v", "description": "Verbose mode" }, { "name": "--become", "short": "-b", "description": "Run with elevated privileges" }, { "name": "--ask-become-pass", "short": "-K", "description": "Prompt for privilege escalation password" }, { "name": "--vault-password-file", "description": "Vault password file", "type": "file" }, { "name": "--forks", "short": "-f", "description": "Number of parallel processes", "type": "number" }], "examples": ["ansible-playbook site.yml", "ansible-playbook -i inventory.ini deploy.yml --tags deploy", "ansible-playbook site.yml --check --diff", "ansible-playbook -i hosts.yml playbook.yml -e 'env=production'"] },
+    { "name": "ansible", "description": "Run ad-hoc commands", "args": [{ "name": "<pattern>", "type": "string", "required": true, "description": "Host pattern" }], "options": [{ "name": "--module-name", "short": "-m", "description": "Module name", "type": "string" }, { "name": "--args", "short": "-a", "description": "Module arguments", "type": "string" }, { "name": "--inventory", "short": "-i", "description": "Inventory", "type": "file" }, { "name": "--become", "short": "-b", "description": "Become root" }], "examples": ["ansible all -m ping", "ansible webservers -m shell -a 'uptime'", "ansible all -m apt -a 'name=nginx state=present' -b"] },
+    { "name": "ansible-galaxy", "description": "Manage Ansible roles and collections", "options": [{ "name": "install", "description": "Install role or collection" }, { "name": "init", "description": "Create a new role" }, { "name": "list", "description": "List installed roles" }], "examples": ["ansible-galaxy install geerlingguy.docker", "ansible-galaxy collection install community.general", "ansible-galaxy init my_role"] },
+    { "name": "ansible-vault", "description": "Manage encrypted files", "options": [{ "name": "create", "description": "Create encrypted file" }, { "name": "edit", "description": "Edit encrypted file" }, { "name": "encrypt", "description": "Encrypt a file" }, { "name": "decrypt", "description": "Decrypt a file" }, { "name": "view", "description": "View encrypted file" }], "examples": ["ansible-vault create secrets.yml", "ansible-vault edit secrets.yml", "ansible-vault encrypt vars.yml", "ansible-vault decrypt vars.yml"] },
+    { "name": "ansible-lint", "description": "Lint Ansible playbooks", "args": [{ "name": "<file>", "type": "file", "required": false, "description": "Playbook file" }], "examples": ["ansible-lint", "ansible-lint playbook.yml"] }
+  ],
+  "globalOptions": [
+    { "name": "--help", "short": "-h", "description": "Show help" },
+    { "name": "--version", "description": "Show version" }
+  ],
+  "examples": [
+    "ansible-playbook -i inventory.ini site.yml",
+    "ansible all -m ping -i hosts",
+    "ansible-vault encrypt secrets.yml"
+  ],
+  "relatedCommands": ["terraform", "puppet", "chef", "salt"]
+}

package/data/commands/apachectl.json

@@ -0,0 +1,87 @@
+{
+  "name": "apachectl",
+  "description": "Apache HTTP Server control interface",
+  "category": "Network/Security",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [
+    { "name": "start", "description": "Start Apache" },
+    { "name": "stop", "description": "Stop Apache" },
+    { "name": "restart", "description": "Restart Apache" },
+    { "name": "graceful", "description": "Graceful restart (no dropped connections)" },
+    { "name": "graceful-stop", "description": "Graceful stop" },
+    { "name": "status", "description": "Display server status (requires mod_status)" },
+    { "name": "fullstatus", "description": "Full server status" },
+    { "name": "configtest", "description": "Test configuration syntax" }
+  ],
+  "globalOptions": [
+    { "name": "-d", "description": "Server root directory", "takesValue": true },
+    { "name": "-f", "description": "Config file path", "takesValue": true },
+    { "name": "-C", "description": "directive processed before config", "takesValue": true },
+    { "name": "-c", "description": "directive processed after config", "takesValue": true },
+    { "name": "-D", "description": "Define a parameter", "takesValue": true },
+    { "name": "-e", "description": "Log level for startup", "takesValue": true },
+    { "name": "-E", "description": "Log startup errors to file", "takesValue": true },
+    { "name": "-k", "description": "Signal (start, restart, graceful, graceful-stop, stop)", "takesValue": true },
+    { "name": "-R", "description": "Server root for SHARED_CORE", "takesValue": true },
+    { "name": "-n", "description": "Service name (Windows)", "takesValue": true },
+    { "name": "-t", "description": "Test config and dump parsed settings" },
+    { "name": "-v", "description": "Show version" },
+    { "name": "-V", "description": "Show version and build options" },
+    { "name": "-h", "description": "Show help" },
+    { "name": "-l", "description": "List compiled-in modules" },
+    { "name": "-L", "description": "List available directives" },
+    { "name": "-M", "description": "List loaded modules" },
+    { "name": "-S", "description": "Show parsed VirtualHost settings" },
+    { "name": "-T", "description": "Start without DocumentRoot check" },
+    { "name": "-t", "description": "Syntax check" },
+    { "name": "-X", "description": "Debug mode (single process)" }
+  ],
+  "examples": [
+    { "command": "apachectl start", "description": "Start Apache" },
+    { "command": "apachectl stop", "description": "Stop Apache" },
+    { "command": "apachectl graceful", "description": "Graceful restart" },
+    { "command": "apachectl configtest", "description": "Test configuration" },
+    { "command": "apachectl -M", "description": "List loaded modules" },
+    { "command": "apachectl -S", "description": "Parsed VirtualHost settings" },
+    { "command": "apachectl -V", "description": "Version and compile settings" },
+    { "command": "apachectl -t -D DUMP_VHOSTS", "description": "Dump VirtualHosts" },
+    { "command": "apachectl -t -D DUMP_MODULES", "description": "Dump loaded modules" }
+  ],
+  "relatedCommands": ["nginx", "certbot", "httpd"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "modules",
+        "description": "Loaded Apache modules",
+        "command": "apachectl -M 2>/dev/null | tail -30",
+        "parser": "lines",
+        "cacheFor": 120,
+        "requiresCmd": "apachectl"
+      },
+      {
+        "name": "vhosts",
+        "description": "Virtual host configuration",
+        "command": "apachectl -S 2>/dev/null | head -20",
+        "parser": "text",
+        "cacheFor": 60,
+        "requiresCmd": "apachectl"
+      },
+      {
+        "name": "config_files",
+        "description": "Apache config files",
+        "command": "ls /etc/apache2/sites-enabled/ 2>/dev/null || ls /etc/httpd/conf.d/ 2>/dev/null | head -15",
+        "parser": "lines",
+        "cacheFor": 60
+      },
+      {
+        "name": "status",
+        "description": "Apache status",
+        "command": "apachectl status 2>/dev/null | head -10 || systemctl status apache2 2>/dev/null | head -5 || systemctl status httpd 2>/dev/null | head -5",
+        "parser": "text",
+        "cacheFor": 30,
+        "requiresCmd": "apachectl"
+      }
+    ]
+  }
+}

package/data/commands/apt-get.json

@@ -0,0 +1,81 @@
+{
+  "name": "apt-get",
+  "description": "Low-level APT package management tool for Debian/Ubuntu",
+  "category": "Package Managers",
+  "platforms": ["linux"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [
+    { "name": "install", "description": "Install packages", "args": [{ "name": "packages", "description": "Package names", "required": true }], "options": [
+      { "name": "-y", "description": "Assume yes" },
+      { "name": "--no-install-recommends", "description": "Skip recommended packages" },
+      { "name": "--reinstall", "description": "Reinstall" },
+      { "name": "-d", "description": "Download only" },
+      { "name": "--allow-unauthenticated", "description": "Allow unauthenticated packages" },
+      { "name": "--allow-downgrades", "description": "Allow downgrade" }
+    ]},
+    { "name": "remove", "description": "Remove packages", "args": [{ "name": "packages", "description": "Package names", "required": true }] },
+    { "name": "purge", "description": "Remove packages with config files" },
+    { "name": "update", "description": "Update package index" },
+    { "name": "upgrade", "description": "Upgrade packages" },
+    { "name": "dist-upgrade", "description": "Distribution upgrade" },
+    { "name": "autoremove", "description": "Remove unneeded packages" },
+    { "name": "autoclean", "description": "Clean old package archives" },
+    { "name": "clean", "description": "Clear local repository" },
+    { "name": "download", "description": "Download package .deb", "args": [{ "name": "package", "description": "Package name", "required": true }] },
+    { "name": "source", "description": "Download source package" },
+    { "name": "build-dep", "description": "Install build dependencies", "args": [{ "name": "package", "description": "Package name", "required": true }] },
+    { "name": "check", "description": "Verify no broken dependencies" },
+    { "name": "changelog", "description": "Download and display changelog" },
+    { "name": "indextargets", "description": "List index targets" }
+  ],
+  "globalOptions": [
+    { "name": "-y", "description": "Assume yes" },
+    { "name": "-q", "description": "Quiet" },
+    { "name": "-qq", "description": "Very quiet" },
+    { "name": "-s", "description": "Simulate (dry run)" },
+    { "name": "-d", "description": "Download only" },
+    { "name": "-f", "description": "Fix broken dependencies" },
+    { "name": "-o", "description": "Set config option", "takesValue": true },
+    { "name": "-t", "description": "Target release", "takesValue": true },
+    { "name": "--force-yes", "description": "Force yes (deprecated)" },
+    { "name": "--print-uris", "description": "Print URIs instead of downloading" }
+  ],
+  "examples": [
+    { "command": "sudo apt-get update", "description": "Update package index" },
+    { "command": "sudo apt-get upgrade -y", "description": "Upgrade all packages" },
+    { "command": "sudo apt-get install -y curl wget", "description": "Install packages" },
+    { "command": "sudo apt-get install --no-install-recommends nginx", "description": "Minimal install" },
+    { "command": "sudo apt-get remove nginx", "description": "Remove package" },
+    { "command": "sudo apt-get purge nginx", "description": "Remove with config" },
+    { "command": "sudo apt-get autoremove", "description": "Remove unused" },
+    { "command": "sudo apt-get dist-upgrade", "description": "Distribution upgrade" },
+    { "command": "sudo apt-get build-dep python3", "description": "Install build deps" },
+    { "command": "apt-get -s install nginx", "description": "Simulate install" }
+  ],
+  "relatedCommands": ["apt", "dpkg"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "installed",
+        "description": "Installed packages",
+        "command": "dpkg -l 2>/dev/null | grep '^ii' | tail -20",
+        "parser": "lines",
+        "cacheFor": 120
+      },
+      {
+        "name": "broken",
+        "description": "Broken packages",
+        "command": "dpkg -l 2>/dev/null | grep -v '^ii' | grep -v '^||' | grep -v '^Desired' | grep -v '^+' | head -10",
+        "parser": "lines",
+        "cacheFor": 60
+      },
+      {
+        "name": "sources",
+        "description": "Repository sources",
+        "command": "cat /etc/apt/sources.list 2>/dev/null | grep -v '^#' | grep -v '^$' | head -10",
+        "parser": "lines",
+        "cacheFor": 300
+      }
+    ]
+  }
+}

package/data/commands/apt.json

@@ -0,0 +1,91 @@
+{
+  "name": "apt",
+  "description": "High-level package management tool for Debian/Ubuntu",
+  "category": "Package Managers",
+  "platforms": ["linux"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [
+    { "name": "install", "description": "Install packages", "args": [{ "name": "packages", "description": "Package names", "required": true }], "options": [
+      { "name": "-y", "description": "Assume yes" },
+      { "name": "--no-install-recommends", "description": "Skip recommended packages" },
+      { "name": "--reinstall", "description": "Reinstall package" },
+      { "name": "--fix-broken", "description": "Fix broken dependencies" },
+      { "name": "-d", "description": "Download only" }
+    ]},
+    { "name": "remove", "description": "Remove packages", "args": [{ "name": "packages", "description": "Package names", "required": true }], "options": [
+      { "name": "-y", "description": "Assume yes" },
+      { "name": "--purge", "description": "Remove config files too" }
+    ]},
+    { "name": "purge", "description": "Remove packages and config files" },
+    { "name": "update", "description": "Update package index" },
+    { "name": "upgrade", "description": "Upgrade installed packages", "options": [
+      { "name": "-y", "description": "Assume yes" }
+    ]},
+    { "name": "full-upgrade", "description": "Full upgrade (may remove packages)" },
+    { "name": "dist-upgrade", "description": "Distribution upgrade" },
+    { "name": "autoremove", "description": "Remove unneeded packages" },
+    { "name": "autoclean", "description": "Clean old downloaded packages" },
+    { "name": "clean", "description": "Clean local package cache" },
+    { "name": "search", "description": "Search package names and descriptions", "args": [{ "name": "query", "description": "Search term", "required": true }] },
+    { "name": "show", "description": "Show package details", "args": [{ "name": "package", "description": "Package name", "required": true }] },
+    { "name": "list", "description": "List packages", "options": [
+      { "name": "--installed", "description": "Show installed" },
+      { "name": "--upgradable", "description": "Show upgradable" },
+      { "name": "--all-versions", "description": "Show all versions" }
+    ]},
+    { "name": "depends", "description": "Show package dependencies", "args": [{ "name": "package", "description": "Package name", "required": true }] },
+    { "name": "rdepends", "description": "Show reverse dependencies", "args": [{ "name": "package", "description": "Package name", "required": true }] },
+    { "name": "policy", "description": "Show package policy/versions", "args": [{ "name": "package", "description": "Package name", "required": true }] },
+    { "name": "edit-sources", "description": "Edit sources.list" },
+    { "name": "satisfy", "description": "Satisfy dependency strings" }
+  ],
+  "globalOptions": [
+    { "name": "-y", "description": "Automatic yes" },
+    { "name": "-q", "description": "Quiet output" },
+    { "name": "-s", "description": "Dry run / simulate" },
+    { "name": "-d", "description": "Download only" },
+    { "name": "--fix-broken", "shorthand": "-f", "description": "Fix broken dependencies" },
+    { "name": "-o", "description": "Set config option", "takesValue": true },
+    { "name": "-t", "description": "Target release", "takesValue": true }
+  ],
+  "examples": [
+    { "command": "sudo apt update", "description": "Update package index" },
+    { "command": "sudo apt upgrade -y", "description": "Upgrade all packages" },
+    { "command": "sudo apt install nginx", "description": "Install nginx" },
+    { "command": "sudo apt install -y --no-install-recommends curl git", "description": "Install minimal" },
+    { "command": "apt search redis", "description": "Search for Redis" },
+    { "command": "apt show nginx", "description": "Show package details" },
+    { "command": "apt list --installed", "description": "List installed packages" },
+    { "command": "apt list --upgradable", "description": "List upgradable" },
+    { "command": "sudo apt remove --purge nginx", "description": "Complete removal" },
+    { "command": "sudo apt autoremove", "description": "Remove unused packages" }
+  ],
+  "relatedCommands": ["apt-get", "dpkg"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "installed",
+        "description": "Installed packages",
+        "command": "apt list --installed 2>/dev/null | tail -20",
+        "parser": "lines",
+        "cacheFor": 120,
+        "requiresCmd": "apt"
+      },
+      {
+        "name": "upgradable",
+        "description": "Upgradable packages",
+        "command": "apt list --upgradable 2>/dev/null | tail -20",
+        "parser": "lines",
+        "cacheFor": 120,
+        "requiresCmd": "apt"
+      },
+      {
+        "name": "sources",
+        "description": "Configured repositories",
+        "command": "cat /etc/apt/sources.list 2>/dev/null | grep -v '^#' | grep -v '^$' | head -10",
+        "parser": "lines",
+        "cacheFor": 300
+      }
+    ]
+  }
+}

package/data/commands/awk.json

@@ -0,0 +1,26 @@
+{
+  "name": "awk",
+  "description": "Pattern scanning and text processing language",
+  "category": "text-processing",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-F", "description": "Field separator", "type": "string" },
+    { "name": "-v", "description": "Assign variable", "type": "string" },
+    { "name": "-f", "description": "Program file", "type": "file" }
+  ],
+  "examples": [
+    "awk '{print $1}' file.txt",
+    "awk -F: '{print $1, $3}' /etc/passwd",
+    "awk '/pattern/ {print}' file.txt",
+    "awk '{sum += $1} END {print sum}' numbers.txt",
+    "awk 'NR==10,NR==20' file.txt",
+    "awk '{print NR, $0}' file.txt",
+    "awk -F, '{print $2}' data.csv",
+    "awk 'length > 80' file.txt",
+    "awk '!seen[$0]++' file.txt",
+    "ps aux | awk '{print $2, $11}'"
+  ],
+  "relatedCommands": ["sed", "grep", "cut", "sort", "uniq", "perl"]
+}