@enjoys/context-engine 1.3.1 → 1.4.1

package/data/commands/shell.json

@@ -1,41 +1,571 @@
-{
-  "name": "sh",
-  "description": "Shell Script command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
-  ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
-  ],
-  "subcommands": [
-    {
-      "name": "-c 'command'",
-      "description": "Execute command string",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "script.sh",
-      "description": "Execute script",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-x script.sh",
-      "description": "Debug mode",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-n script.sh",
-      "description": "Syntax check",
-      "args": [],
-      "options": []
-    }
-  ]
-}
+{
+  "language": "shell",
+  "name": "sh",
+  "description": "Shell Script command-line tool",
+  "category": "development",
+  "platforms": [
+    "linux",
+    "macos",
+    "windows"
+  ],
+  "shells": [
+    "bash",
+    "zsh",
+    "powershell",
+    "fish"
+  ],
+  "subcommands": [
+    {
+      "name": "-c 'command'",
+      "description": "Execute command string",
+      "args": [],
+      "options": []
+    },
+    {
+      "name": "script.sh",
+      "description": "Execute script",
+      "args": [],
+      "options": []
+    },
+    {
+      "name": "-x script.sh",
+      "description": "Debug mode",
+      "args": [],
+      "options": []
+    },
+    {
+      "name": "-n script.sh",
+      "description": "Syntax check",
+      "args": [],
+      "options": []
+    },
+    {
+      "name": "run",
+      "description": "Execute a shell script file",
+      "args": [
+        {
+          "name": "<script>",
+          "type": "file",
+          "required": true,
+          "description": "Shell script to execute"
+        }
+      ],
+      "examples": [
+        "bash script.sh",
+        "bash deploy.sh --env production"
+      ]
+    },
+    {
+      "name": "login",
+      "description": "Start a login shell",
+      "args": [],
+      "examples": [
+        "bash --login",
+        "bash -l"
+      ]
+    }
+  ],
+  "globalOptions": [
+    {
+      "name": "--version",
+      "description": "Display version information and exit"
+    },
+    {
+      "name": "--help",
+      "description": "Display usage information and exit"
+    },
+    {
+      "name": "-c",
+      "description": "Execute commands from the following string argument",
+      "type": "string"
+    },
+    {
+      "name": "-i",
+      "description": "Start an interactive shell"
+    },
+    {
+      "name": "-l",
+      "description": "Act as if invoked as a login shell (same as --login)"
+    },
+    {
+      "name": "--login",
+      "description": "Act as if invoked as a login shell"
+    },
+    {
+      "name": "-r",
+      "description": "Start a restricted shell"
+    },
+    {
+      "name": "--restricted",
+      "description": "Start a restricted shell"
+    },
+    {
+      "name": "-s",
+      "description": "Read commands from standard input"
+    },
+    {
+      "name": "-D",
+      "description": "Print double-quoted strings preceded by $ (for localization)"
+    },
+    {
+      "name": "--dump-strings",
+      "description": "Same as -D"
+    },
+    {
+      "name": "-e",
+      "description": "Exit immediately if a command exits with non-zero status (set -e)"
+    },
+    {
+      "name": "-u",
+      "description": "Treat unset variables as an error (set -u)"
+    },
+    {
+      "name": "-x",
+      "description": "Print each command before executing it (set -x)"
+    },
+    {
+      "name": "-v",
+      "description": "Print shell input lines as they are read (set -v)"
+    },
+    {
+      "name": "-n",
+      "description": "Read commands but do not execute them (syntax check)"
+    },
+    {
+      "name": "-p",
+      "description": "Start in privileged mode"
+    },
+    {
+      "name": "--posix",
+      "description": "Change behavior to match the POSIX standard"
+    },
+    {
+      "name": "--norc",
+      "description": "Do not read the ~/.bashrc initialization file"
+    },
+    {
+      "name": "--noprofile",
+      "description": "Do not read /etc/profile or any personal profile files"
+    },
+    {
+      "name": "--rcfile",
+      "description": "Execute commands from specified file instead of ~/.bashrc",
+      "type": "file"
+    },
+    {
+      "name": "--init-file",
+      "description": "Same as --rcfile",
+      "type": "file"
+    },
+    {
+      "name": "-O",
+      "description": "Enable a shell option (shopt)",
+      "type": "string"
+    },
+    {
+      "name": "+O",
+      "description": "Disable a shell option (shopt)",
+      "type": "string"
+    },
+    {
+      "name": "--debugger",
+      "description": "Run the debugger profile before the shell starts"
+    },
+    {
+      "name": "--dump-po-strings",
+      "description": "Same as -D but output in GNU gettext PO format"
+    },
+    {
+      "name": "--verbose",
+      "description": "Same as -v"
+    },
+    {
+      "name": "--noediting",
+      "description": "Do not use the GNU Readline library for command-line editing"
+    }
+  ],
+  "builtinCommands": [
+    {
+      "name": "alias",
+      "description": "Define or display aliases",
+      "examples": [
+        "alias ll='ls -la'",
+        "alias"
+      ]
+    },
+    {
+      "name": "bg",
+      "description": "Resume a suspended job in the background",
+      "examples": [
+        "bg %1"
+      ]
+    },
+    {
+      "name": "cd",
+      "description": "Change the current directory",
+      "examples": [
+        "cd /tmp",
+        "cd -",
+        "cd ~"
+      ]
+    },
+    {
+      "name": "declare",
+      "description": "Declare variables and give them attributes",
+      "examples": [
+        "declare -i num=42",
+        "declare -a arr=()",
+        "declare -A map=()"
+      ]
+    },
+    {
+      "name": "echo",
+      "description": "Display a line of text",
+      "examples": [
+        "echo 'Hello'",
+        "echo -n 'no newline'",
+        "echo -e 'tab\\there'"
+      ]
+    },
+    {
+      "name": "eval",
+      "description": "Concatenate arguments and execute as a shell command",
+      "examples": [
+        "eval \"$cmd\""
+      ]
+    },
+    {
+      "name": "exec",
+      "description": "Replace the shell with the given command",
+      "examples": [
+        "exec bash --login",
+        "exec > output.log 2>&1"
+      ]
+    },
+    {
+      "name": "exit",
+      "description": "Exit the shell with a status",
+      "examples": [
+        "exit 0",
+        "exit 1"
+      ]
+    },
+    {
+      "name": "export",
+      "description": "Set environment variables for child processes",
+      "examples": [
+        "export PATH=\"$HOME/bin:$PATH\"",
+        "export -n VAR"
+      ]
+    },
+    {
+      "name": "fg",
+      "description": "Resume a suspended job in the foreground",
+      "examples": [
+        "fg %1"
+      ]
+    },
+    {
+      "name": "getopts",
+      "description": "Parse positional parameters as options",
+      "examples": [
+        "getopts 'ab:c' opt"
+      ]
+    },
+    {
+      "name": "hash",
+      "description": "Remember the full pathname of commands",
+      "examples": [
+        "hash -r",
+        "hash -d git"
+      ]
+    },
+    {
+      "name": "history",
+      "description": "Display or manipulate the history list",
+      "examples": [
+        "history",
+        "history -c",
+        "history 20"
+      ]
+    },
+    {
+      "name": "jobs",
+      "description": "Display status of jobs",
+      "examples": [
+        "jobs",
+        "jobs -l"
+      ]
+    },
+    {
+      "name": "kill",
+      "description": "Send a signal to a process",
+      "examples": [
+        "kill -9 1234",
+        "kill -SIGTERM %1",
+        "kill -0 $pid"
+      ]
+    },
+    {
+      "name": "let",
+      "description": "Evaluate arithmetic expressions",
+      "examples": [
+        "let 'x=5+3'",
+        "let x++"
+      ]
+    },
+    {
+      "name": "local",
+      "description": "Define local variables in a function",
+      "examples": [
+        "local var='value'",
+        "local -i num=0"
+      ]
+    },
+    {
+      "name": "printf",
+      "description": "Format and print data",
+      "examples": [
+        "printf '%s\\n' \"$var\"",
+        "printf '%-20s %d\\n' \"$name\" \"$count\""
+      ]
+    },
+    {
+      "name": "pushd",
+      "description": "Save current directory and change to another",
+      "examples": [
+        "pushd /tmp",
+        "pushd +1"
+      ]
+    },
+    {
+      "name": "popd",
+      "description": "Restore previously saved directory",
+      "examples": [
+        "popd",
+        "popd +1"
+      ]
+    },
+    {
+      "name": "read",
+      "description": "Read a line from standard input",
+      "examples": [
+        "read -p 'Name: ' name",
+        "read -r line",
+        "read -a array"
+      ]
+    },
+    {
+      "name": "readonly",
+      "description": "Mark variables as read-only",
+      "examples": [
+        "readonly PI=3.14159",
+        "readonly -a CONST_ARRAY"
+      ]
+    },
+    {
+      "name": "return",
+      "description": "Return from a shell function",
+      "examples": [
+        "return 0",
+        "return 1"
+      ]
+    },
+    {
+      "name": "set",
+      "description": "Set or unset shell options and positional parameters",
+      "examples": [
+        "set -euo pipefail",
+        "set -- \"$@\" newarg"
+      ]
+    },
+    {
+      "name": "shift",
+      "description": "Shift positional parameters to the left",
+      "examples": [
+        "shift",
+        "shift 2"
+      ]
+    },
+    {
+      "name": "shopt",
+      "description": "Toggle shell optional behavior",
+      "examples": [
+        "shopt -s globstar",
+        "shopt -u dotglob",
+        "shopt extglob"
+      ]
+    },
+    {
+      "name": "source",
+      "description": "Execute commands from a file in the current shell",
+      "examples": [
+        "source ~/.bashrc",
+        ". ./env.sh"
+      ]
+    },
+    {
+      "name": "test",
+      "description": "Evaluate conditional expression",
+      "examples": [
+        "test -f /etc/passwd",
+        "test \"$a\" = \"$b\""
+      ]
+    },
+    {
+      "name": "trap",
+      "description": "Set actions to execute when signals are received",
+      "examples": [
+        "trap 'rm -f $tmpfile' EXIT",
+        "trap '' SIGINT",
+        "trap - SIGTERM"
+      ]
+    },
+    {
+      "name": "type",
+      "description": "Display information about command type",
+      "examples": [
+        "type ls",
+        "type -a python"
+      ]
+    },
+    {
+      "name": "typeset",
+      "description": "Declare variables and give them attributes (synonym for declare)",
+      "examples": [
+        "typeset -i count=0"
+      ]
+    },
+    {
+      "name": "ulimit",
+      "description": "Set or display user resource limits",
+      "examples": [
+        "ulimit -n 4096",
+        "ulimit -a"
+      ]
+    },
+    {
+      "name": "umask",
+      "description": "Display or set the file mode creation mask",
+      "examples": [
+        "umask 022",
+        "umask -S"
+      ]
+    },
+    {
+      "name": "unalias",
+      "description": "Remove alias definitions",
+      "examples": [
+        "unalias ll",
+        "unalias -a"
+      ]
+    },
+    {
+      "name": "unset",
+      "description": "Remove variable or function names",
+      "examples": [
+        "unset VAR",
+        "unset -f myfunc"
+      ]
+    },
+    {
+      "name": "wait",
+      "description": "Wait for a process to complete",
+      "examples": [
+        "wait $pid",
+        "wait"
+      ]
+    }
+  ],
+  "examples": [
+    "bash script.sh",
+    "bash -c 'echo Hello World'",
+    "bash -x debug-script.sh",
+    "bash -n syntax-check.sh",
+    "bash --norc --noprofile",
+    "bash -c 'for i in 1 2 3; do echo $i; done'",
+    "bash -l -i",
+    "bash --posix script.sh",
+    "bash -e -u -o pipefail script.sh",
+    "bash --rcfile custom_rc.sh"
+  ],
+  "relatedCommands": [
+    "sh",
+    "zsh",
+    "fish",
+    "dash",
+    "ksh",
+    "csh",
+    "tcsh",
+    "env",
+    "source"
+  ],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "zsh_version",
+        "description": "Installed zsh version",
+        "command": "zsh --version 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 3600,
+        "requiresCmd": "zsh"
+      },
+      {
+        "name": "current_shell",
+        "description": "Current user shell",
+        "command": "echo $SHELL",
+        "parser": "text",
+        "cacheFor": 3600,
+        "requiresCmd": "zsh"
+      },
+      {
+        "name": "zshrc_exists",
+        "description": "Check if .zshrc exists",
+        "command": "test -f ~/.zshrc && echo 'yes' || echo 'no'",
+        "parser": "text",
+        "cacheFor": 60,
+        "requiresCmd": "zsh"
+      },
+      {
+        "name": "oh_my_zsh",
+        "description": "Check if Oh My Zsh is installed",
+        "command": "test -d ~/.oh-my-zsh && echo 'installed' || echo 'not installed'",
+        "parser": "text",
+        "cacheFor": 300,
+        "requiresCmd": "zsh"
+      },
+      {
+        "name": "zsh_theme",
+        "description": "Current ZSH_THEME",
+        "command": "grep '^ZSH_THEME=' ~/.zshrc 2>/dev/null | head -1 | cut -d'\"' -f2",
+        "parser": "text",
+        "cacheFor": 120,
+        "requiresCmd": "zsh"
+      },
+      {
+        "name": "zsh_plugins",
+        "description": "Configured Oh My Zsh plugins",
+        "command": "grep -A20 '^plugins=(' ~/.zshrc 2>/dev/null | sed -n '/^plugins=(/,/)/p' | tr -d '()' | sed 's/plugins=//' | tr '\\n' ' '",
+        "parser": "text",
+        "cacheFor": 120,
+        "requiresCmd": "zsh"
+      },
+      {
+        "name": "fpath_dirs",
+        "description": "Number of fpath directories",
+        "command": "zsh -c 'echo ${#fpath}' 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 300,
+        "requiresCmd": "zsh"
+      },
+      {
+        "name": "aliases_count",
+        "description": "Number of defined aliases",
+        "command": "zsh -ic 'alias | wc -l' 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 60,
+        "requiresCmd": "zsh"
+      }
+    ]
+  }
+}