@enjoys/context-engine 1.3.1 → 1.4.2

package/data/commands/c.json

@@ -1,35 +1,35 @@
 {
   "name": "gcc",
-  "description": "C command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "GCC — GNU C Compiler toolchain",
+  "category": "language",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "file.c -o output", "description": "Compile C file to executable", "args": [], "options": [] },
+    { "name": "-Wall -Wextra file.c", "description": "Compile with all warnings enabled", "args": [], "options": [] },
+    { "name": "-g file.c", "description": "Compile with debug information", "args": [], "options": [] },
+    { "name": "-c file.c", "description": "Compile to object file without linking", "args": [], "options": [] },
+    { "name": "-E file.c", "description": "Preprocess only, output to stdout", "args": [], "options": [] },
+    { "name": "-S file.c", "description": "Compile to assembly language", "args": [], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "-o", "description": "Specify output file name" },
+    { "name": "-O0 / -O1 / -O2 / -O3 / -Os", "description": "Optimization level (0=none, 3=max, s=size)" },
+    { "name": "-Wall", "description": "Enable all common warnings" },
+    { "name": "-Werror", "description": "Treat all warnings as errors" },
+    { "name": "-std=c11 / -std=c17 / -std=c23", "description": "Set C language standard" },
+    { "name": "-I<dir>", "description": "Add include directory for header search" },
+    { "name": "-L<dir>", "description": "Add library search directory" },
+    { "name": "-l<lib>", "description": "Link with library" },
+    { "name": "-D<macro>=<value>", "description": "Define preprocessor macro" },
+    { "name": "-fsanitize=address", "description": "Enable AddressSanitizer for memory error detection" }
   ],
-  "subcommands": [
-    {
-      "name": "file.c -o output",
-      "description": "Compile C file",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-Wall -Wextra file.c",
-      "description": "Compile with warnings",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-g file.c",
-      "description": "Compile with debug info",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "gcc -Wall -Wextra -std=c17 main.c -o main",
+    "gcc -O2 -o app main.c utils.c -lm",
+    "gcc -g -fsanitize=address main.c -o debug_app",
+    "gcc -c module.c && gcc -c main.c && gcc module.o main.o -o app",
+    "gcc -E main.c | less"
+  ],
+  "relatedCommands": ["make", "cmake", "gdb", "valgrind", "cpp"]
 }

package/data/commands/cpp.json

@@ -1,35 +1,35 @@
 {
   "name": "g++",
-  "description": "C++ command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "G++ — GNU C++ Compiler toolchain",
+  "category": "language",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "file.cpp -o output", "description": "Compile C++ file to executable", "args": [], "options": [] },
+    { "name": "-std=c++20 file.cpp", "description": "Compile with C++20 standard", "args": [], "options": [] },
+    { "name": "-Wall -Wextra file.cpp", "description": "Compile with all warnings enabled", "args": [], "options": [] },
+    { "name": "-c file.cpp", "description": "Compile to object file without linking", "args": [], "options": [] },
+    { "name": "-E file.cpp", "description": "Preprocess only, output to stdout", "args": [], "options": [] },
+    { "name": "-S file.cpp", "description": "Compile to assembly language", "args": [], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "-o", "description": "Specify output file name" },
+    { "name": "-O0 / -O1 / -O2 / -O3 / -Os", "description": "Optimization level" },
+    { "name": "-Wall", "description": "Enable all common warnings" },
+    { "name": "-Werror", "description": "Treat all warnings as errors" },
+    { "name": "-std=c++17 / -std=c++20 / -std=c++23", "description": "Set C++ language standard" },
+    { "name": "-I<dir>", "description": "Add include directory for header search" },
+    { "name": "-L<dir>", "description": "Add library search directory" },
+    { "name": "-l<lib>", "description": "Link with library" },
+    { "name": "-fsanitize=address", "description": "Enable AddressSanitizer" },
+    { "name": "-fno-exceptions", "description": "Disable C++ exceptions" }
   ],
-  "subcommands": [
-    {
-      "name": "file.cpp -o output",
-      "description": "Compile C++ file",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-std=c++20 file.cpp",
-      "description": "Compile with C++20",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-Wall -Wextra file.cpp",
-      "description": "Compile with warnings",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "g++ -std=c++20 -Wall -Wextra main.cpp -o main",
+    "g++ -O2 -o app main.cpp utils.cpp -lstdc++fs",
+    "g++ -g -fsanitize=address main.cpp -o debug_app",
+    "g++ -c module.cpp && g++ -c main.cpp && g++ module.o main.o -o app",
+    "g++ -std=c++23 -fmodules-ts module.cppm"
+  ],
+  "relatedCommands": ["cmake", "make", "gdb", "clang++", "c"]
 }

package/data/commands/crontab.json

@@ -1,35 +1,30 @@
 {
   "name": "crontab",
-  "description": "Crontab command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "Crontab — schedule recurring tasks on Unix-like systems",
+  "category": "runtime",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh"],
+  "subcommands": [
+    { "name": "-l", "description": "List current user's cron jobs", "args": [], "options": [] },
+    { "name": "-e", "description": "Edit current user's crontab", "args": [], "options": [] },
+    { "name": "-r", "description": "Remove current user's crontab entirely", "args": [], "options": [] },
+    { "name": "-l -u user", "description": "List crontab for a specific user", "args": ["user"], "options": [] },
+    { "name": "file", "description": "Install crontab from a file", "args": ["file"], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "-u", "description": "Specify the user whose crontab to operate on" },
+    { "name": "-i", "description": "Prompt before removing crontab (with -r)" },
+    { "name": "-s", "description": "Append SELinux context to crontab (Linux)" },
+    { "name": "-n", "description": "Set host in cluster to run jobs (Linux)" },
+    { "name": "-c", "description": "Get host in cluster to run jobs (Linux)" }
   ],
-  "subcommands": [
-    {
-      "name": "-l",
-      "description": "List cron jobs",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-e",
-      "description": "Edit crontab",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-r",
-      "description": "Remove crontab",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "crontab -l",
+    "crontab -e",
+    "echo '0 2 * * * /usr/bin/backup.sh' | crontab -",
+    "crontab -l -u www-data",
+    "crontab -r -i",
+    "crontab /path/to/crontab-file"
+  ],
+  "relatedCommands": ["systemctl", "at", "anacron", "systemd"]
 }

package/data/commands/cypher.json

@@ -1,35 +1,31 @@
 {
   "name": "cypher-shell",
-  "description": "Cypher command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "Cypher Shell — Neo4j graph database command-line client",
+  "category": "tool",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "-u neo4j -p pass", "description": "Connect to Neo4j with credentials", "args": [], "options": [] },
+    { "name": "--format plain", "description": "Output results in plain text format", "args": [], "options": [] },
+    { "name": "-f script.cypher", "description": "Execute Cypher script from file", "args": ["file"], "options": [] },
+    { "name": "--database neo4j", "description": "Connect to a specific database", "args": ["database"], "options": [] },
+    { "name": "-a bolt://host:7687", "description": "Connect to specific server address", "args": ["address"], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "-u / --username", "description": "Neo4j username" },
+    { "name": "-p / --password", "description": "Neo4j password" },
+    { "name": "-a / --address", "description": "Server address (bolt://host:port)" },
+    { "name": "--database", "description": "Target database name" },
+    { "name": "--format", "description": "Output format (auto, verbose, plain)" },
+    { "name": "--encryption", "description": "Connection encryption (true, false, default)" },
+    { "name": "-f / --file", "description": "Cypher script file to execute" }
   ],
-  "subcommands": [
-    {
-      "name": "-u neo4j -p pass",
-      "description": "Connect to Neo4j",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "--format plain",
-      "description": "Plain text output",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-f script.cypher",
-      "description": "Execute script file",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "cypher-shell -u neo4j -p password",
+    "cypher-shell -u neo4j -p password -f import.cypher",
+    "echo 'MATCH (n) RETURN count(n);' | cypher-shell -u neo4j -p password",
+    "cypher-shell -a bolt://localhost:7687 --database mydb",
+    "cypher-shell --format plain -u neo4j -p password <<< 'MATCH (n:Person) RETURN n.name LIMIT 10;'"
+  ],
+  "relatedCommands": ["sql", "mongosh", "redis-cli", "psql"]
 }

package/data/commands/dockerfile.json

@@ -4,8 +4,32 @@
   "category": "containerization",
   "platforms": ["linux", "macos", "windows"],
   "shells": ["bash", "zsh", "fish", "powershell"],
-  "subcommands": [],
-  "globalOptions": [],
+  "subcommands": [
+    { "name": "FROM", "description": "Set the base image for the build stage", "args": ["image:tag"], "options": ["AS"] },
+    { "name": "RUN", "description": "Execute a command during the image build", "args": ["command"], "options": ["--mount", "--network", "--security"] },
+    { "name": "CMD", "description": "Set default command for the container", "args": ["command"], "options": [] },
+    { "name": "ENTRYPOINT", "description": "Set the main executable for the container", "args": ["executable"], "options": [] },
+    { "name": "COPY", "description": "Copy files from build context into image", "args": ["src", "dest"], "options": ["--from", "--chown", "--chmod"] },
+    { "name": "ADD", "description": "Copy files/URLs/archives into image with extraction", "args": ["src", "dest"], "options": ["--chown", "--chmod"] },
+    { "name": "WORKDIR", "description": "Set the working directory for subsequent instructions", "args": ["path"], "options": [] },
+    { "name": "ENV", "description": "Set environment variable in the image", "args": ["KEY=VALUE"], "options": [] },
+    { "name": "EXPOSE", "description": "Declare the port the container listens on", "args": ["port"], "options": [] },
+    { "name": "ARG", "description": "Define a build-time variable", "args": ["name=default"], "options": [] },
+    { "name": "HEALTHCHECK", "description": "Define a health check command for the container", "args": ["CMD command"], "options": ["--interval", "--timeout", "--retries", "--start-period"] },
+    { "name": "USER", "description": "Set the user for subsequent instructions and runtime", "args": ["user:group"], "options": [] },
+    { "name": "VOLUME", "description": "Create a mount point for external volumes", "args": ["path"], "options": [] },
+    { "name": "LABEL", "description": "Add metadata to the image", "args": ["key=value"], "options": [] },
+    { "name": "SHELL", "description": "Override the default shell for RUN commands", "args": ["executable"], "options": [] },
+    { "name": "STOPSIGNAL", "description": "Set the system call signal for container exit", "args": ["signal"], "options": [] }
+  ],
+  "globalOptions": [
+    { "name": "--platform", "description": "Set target platform for the build (e.g., linux/amd64)" },
+    { "name": "--mount=type=cache", "description": "Mount a cache directory during RUN to speed up builds" },
+    { "name": "--mount=type=secret", "description": "Mount a secret file during RUN without baking into image" },
+    { "name": "--from=stage", "description": "Copy files from a named build stage" },
+    { "name": "--chown=user:group", "description": "Set ownership of copied files" },
+    { "name": "--chmod=permissions", "description": "Set file permissions on copied files" }
+  ],
   "examples": [
     "FROM node:20-alpine",
     "FROM python:3.12-slim AS builder",

package/data/commands/doctest.json

@@ -1,29 +1,28 @@
 {
   "name": "python -m doctest",
-  "description": "Python Doctest command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "Python doctest — test interactive examples embedded in docstrings",
+  "category": "tool",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "-v file.py", "description": "Run doctests verbosely showing each test case", "args": ["file"], "options": [] },
+    { "name": "file.txt", "description": "Run doctests from a plain text file", "args": ["file"], "options": [] },
+    { "name": "file.py", "description": "Run doctests in a Python module (quiet mode)", "args": ["file"], "options": [] },
+    { "name": "-v module.py", "description": "Run doctests with verbose output", "args": ["file"], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "-v", "description": "Verbose mode — display each test and its result" },
+    { "name": "-o ELLIPSIS", "description": "Enable ellipsis matching in expected output" },
+    { "name": "-o NORMALIZE_WHITESPACE", "description": "Ignore whitespace differences in output" },
+    { "name": "-o IGNORE_EXCEPTION_DETAIL", "description": "Ignore exception message details" },
+    { "name": "-o SKIP", "description": "Skip marked test cases" }
   ],
-  "subcommands": [
-    {
-      "name": "-v file.py",
-      "description": "Run doctests verbosely",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "file.txt",
-      "description": "Run doctests from text file",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "python -m doctest mymodule.py -v",
+    "python -m doctest examples.txt",
+    "python -m doctest -v utils.py",
+    "pytest --doctest-modules",
+    "python -c \"import doctest; doctest.testmod(mymodule, verbose=True)\""
+  ],
+  "relatedCommands": ["pytest", "python", "unittest"]
 }

package/data/commands/dotenv.json

@@ -1,16 +1,29 @@
 {
   "name": "dotenv",
-  "description": "dotenv command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "dotenv — environment variable management from .env files",
+  "category": "tool",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "run", "description": "Run a command with .env variables loaded", "args": ["command"], "options": ["--env-file"] },
+    { "name": "list", "description": "List all variables in .env file", "args": [], "options": ["--env-file"] },
+    { "name": "set", "description": "Set a variable in .env file", "args": ["KEY=VALUE"], "options": [] },
+    { "name": "get", "description": "Get a specific variable value", "args": ["KEY"], "options": [] },
+    { "name": "check", "description": "Validate .env file against .env.example", "args": [], "options": ["--strict"] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "--env-file", "description": "Specify path to .env file (default: .env)" },
+    { "name": "--override", "description": "Override existing environment variables" },
+    { "name": "--no-expand", "description": "Disable variable expansion" },
+    { "name": "--debug", "description": "Enable debug output" },
+    { "name": "--encoding", "description": "Specify file encoding (default: utf-8)" }
   ],
-  "subcommands": []
+  "examples": [
+    "dotenv run -- node server.js",
+    "dotenv --env-file .env.production run -- npm start",
+    "dotenv list",
+    "dotenv set DATABASE_URL=postgres://localhost/mydb",
+    "dotenv check --strict"
+  ],
+  "relatedCommands": ["env", "export", "direnv", "shell"]
 }

package/data/commands/ecl.json

@@ -1,35 +1,31 @@
 {
   "name": "ecl",
-  "description": "ECL command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "ECL — HPCC Systems Enterprise Control Language CLI",
+  "category": "language",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "run", "description": "Run an ECL program on a cluster", "args": ["file.ecl"], "options": ["--target", "--cluster"] },
+    { "name": "publish", "description": "Publish ECL query to a Roxie cluster", "args": ["file.ecl"], "options": ["--name", "--cluster"] },
+    { "name": "deploy", "description": "Deploy ECL workunit to target cluster", "args": ["wuid"], "options": ["--cluster"] },
+    { "name": "compile", "description": "Compile ECL code without running", "args": ["file.ecl"], "options": ["--target"] },
+    { "name": "status", "description": "Check status of a workunit", "args": ["wuid"], "options": [] },
+    { "name": "results", "description": "Retrieve results from a completed workunit", "args": ["wuid"], "options": ["--format"] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "--server", "description": "HPCC server address" },
+    { "name": "--port", "description": "Server port number" },
+    { "name": "--username", "description": "Authentication username" },
+    { "name": "--password", "description": "Authentication password" },
+    { "name": "--cluster", "description": "Target cluster name (thor, roxie, hthor)" },
+    { "name": "--target", "description": "Target environment" }
   ],
-  "subcommands": [
-    {
-      "name": "run",
-      "description": "Run an ECL program",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "publish",
-      "description": "Publish ECL query",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "deploy",
-      "description": "Deploy ECL workunit",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "ecl run --target thor myquery.ecl",
+    "ecl publish --cluster roxie --name MyQuery myquery.ecl",
+    "ecl status W20240101-000001",
+    "ecl results W20240101-000001 --format csv",
+    "eclcc -o output.so myquery.ecl"
+  ],
+  "relatedCommands": ["sql", "sparql", "hive"]
 }

package/data/commands/flow9.json

@@ -1,29 +1,29 @@
 {
   "name": "flowc",
-  "description": "Flow9 command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "Flow9 — functional programming language compiler (area9)",
+  "category": "language",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "file.flow", "description": "Compile Flow9 program", "args": ["file"], "options": [] },
+    { "name": "--js file.flow", "description": "Compile to JavaScript target", "args": ["file"], "options": [] },
+    { "name": "--bytecode file.flow", "description": "Compile to bytecode", "args": ["file"], "options": [] },
+    { "name": "--java file.flow", "description": "Compile to Java target", "args": ["file"], "options": [] },
+    { "name": "--html file.flow", "description": "Compile and generate HTML wrapper", "args": ["file"], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "--js", "description": "Compile to JavaScript output" },
+    { "name": "--bytecode", "description": "Compile to Flow bytecode" },
+    { "name": "--java", "description": "Compile to Java output" },
+    { "name": "-I", "description": "Add include path for imports" },
+    { "name": "--debug", "description": "Enable debug mode" },
+    { "name": "--verbose", "description": "Verbose compilation output" }
   ],
-  "subcommands": [
-    {
-      "name": "file.flow",
-      "description": "Compile Flow9 program",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "--js file.flow",
-      "description": "Compile to JavaScript",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "flowc1 --js myapp.flow",
+    "flowc1 --bytecode myapp.flow",
+    "flowc1 --java myapp.flow",
+    "flowcpp myapp.flow"
+  ],
+  "relatedCommands": ["node", "java", "typescript"]
 }

package/data/commands/freemarker2.json

@@ -1,23 +1,29 @@
 {
   "name": "freemarker-cli",
-  "description": "FreeMarker command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "FreeMarker CLI — Apache FreeMarker template processing tool",
+  "category": "tool",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "-t template.ftl -d data.json", "description": "Process template with JSON data", "args": ["template", "data"], "options": [] },
+    { "name": "-t template.ftl -d data.yaml", "description": "Process template with YAML data", "args": ["template", "data"], "options": [] },
+    { "name": "-t template.ftl -d data.csv", "description": "Process template with CSV data", "args": ["template", "data"], "options": [] },
+    { "name": "-t template.ftl -d data.xml", "description": "Process template with XML data", "args": ["template", "data"], "options": [] },
+    { "name": "--interactive", "description": "Run in interactive REPL mode", "args": [], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "-t / --template", "description": "FreeMarker template file path" },
+    { "name": "-d / --data", "description": "Data source file (JSON, YAML, CSV, XML)" },
+    { "name": "-o / --output", "description": "Output file path (default: stdout)" },
+    { "name": "--encoding", "description": "Template file encoding" },
+    { "name": "--locale", "description": "Locale for template rendering" },
+    { "name": "--config", "description": "FreeMarker configuration file path" }
   ],
-  "subcommands": [
-    {
-      "name": "-t template.ftl -d data.json",
-      "description": "Process template with data",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "freemarker-cli -t template.ftl -d data.json",
+    "freemarker-cli -t report.ftl -d data.csv -o report.html",
+    "freemarker-cli -t email.ftl -d users.yaml --encoding UTF-8",
+    "freemarker-cli -t config.ftl -d env.json -o application.properties"
+  ],
+  "relatedCommands": ["java", "mvn", "twig", "html"]
 }

package/data/commands/graphql.json

@@ -1,16 +1,30 @@
 {
-  "name": "graphql",
-  "description": "GraphQL command-line tool",
+  "name": "graphql-codegen",
+  "description": "GraphQL Code Generator and CLI tools for schema management",
   "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "generate", "description": "Generate code from GraphQL schema and operations", "args": [], "options": ["--config", "--watch", "--overwrite"] },
+    { "name": "init", "description": "Initialize a codegen configuration file", "args": [], "options": [] },
+    { "name": "get-schema", "description": "Download and save GraphQL schema from endpoint", "args": ["endpoint"], "options": ["--header", "--output"] },
+    { "name": "validate", "description": "Validate GraphQL operations against schema", "args": ["schema", "documents"], "options": ["--strict"] },
+    { "name": "inspect", "description": "Inspect a GraphQL schema and display type information", "args": ["schema"], "options": ["--format"] },
+    { "name": "diff", "description": "Compare two GraphQL schemas for breaking changes", "args": ["old-schema", "new-schema"], "options": ["--fail-on-breaking"] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "--config", "description": "Path to codegen config file (default: codegen.ts)" },
+    { "name": "--watch", "description": "Watch for changes and regenerate" },
+    { "name": "--overwrite", "description": "Overwrite existing generated files" },
+    { "name": "--profile", "description": "Enable performance profiling" },
+    { "name": "--verbose", "description": "Enable verbose logging" }
   ],
-  "subcommands": []
+  "examples": [
+    "npx graphql-codegen --config codegen.ts",
+    "npx graphql-codegen --watch",
+    "npx graphql-codegen init",
+    "graphql-inspector diff old.graphql new.graphql --fail-on-breaking",
+    "npx get-graphql-schema https://api.example.com/graphql > schema.graphql"
+  ],
+  "relatedCommands": ["npm", "typescript", "node", "apollo"]
 }