@enjoys/context-engine 1.3.1 → 1.4.2

package/data/typeDefinition/shell.json

@@ -1,40 +1,104 @@
-{
-  "language": "shell",
-  "typeDefinitions": {
-    "string": {
-      "type": "type",
-      "signature": "\"text\" or 'text'",
-      "description": "Text value, double-quoted allows variable expansion and escapes, single-quoted is literal"
-    },
-    "integer": {
-      "type": "type",
-      "signature": "integer",
-      "description": "Whole number used in arithmetic via $(( )) and test comparisons"
-    },
-    "array": {
-      "type": "type",
-      "signature": "array=(val1 val2 val3)",
-      "description": "Indexed array of strings declared with parentheses, accessed with ${arr[i]}"
-    },
-    "exit_status": {
-      "type": "type",
-      "signature": "$? (0-255)",
-      "description": "Integer 0-255 returned by commands; 0 means success, non-zero is failure"
-    },
-    "file_descriptor": {
-      "type": "type",
-      "signature": "0 (stdin), 1 (stdout), 2 (stderr)",
-      "description": "Integer handle for I/O streams used with redirection operators > < 2>"
-    },
-    "pid": {
-      "type": "type",
-      "signature": "$$ (self) or $! (last bg)",
-      "description": "Process ID number for the current shell or background processes"
-    },
-    "glob_pattern": {
-      "type": "type",
-      "signature": "*, ?, [chars], {a,b}",
-      "description": "Filename expansion pattern with wildcards for matching multiple paths"
-    }
-  }
-}
+{
+  "language": "shell",
+  "typeDefinitions": {
+    "string": {
+      "type": "type",
+      "signature": "\"text\" or 'text'",
+      "description": "Text value, double-quoted allows variable expansion and escapes, single-quoted is literal"
+    },
+    "integer": {
+      "type": "type",
+      "signature": "integer",
+      "description": "Whole number used in arithmetic via $(( )) and test comparisons"
+    },
+    "array": {
+      "type": "type",
+      "signature": "array=(val1 val2 val3)",
+      "description": "Indexed array of strings declared with parentheses, accessed with ${arr[i]}"
+    },
+    "exit_status": {
+      "type": "type",
+      "signature": "$? (0-255)",
+      "description": "Integer 0-255 returned by commands; 0 means success, non-zero is failure"
+    },
+    "file_descriptor": {
+      "type": "type",
+      "signature": "0 (stdin), 1 (stdout), 2 (stderr)",
+      "description": "Integer handle for I/O streams used with redirection operators > < 2>"
+    },
+    "pid": {
+      "type": "type",
+      "signature": "$$ (self) or $! (last bg)",
+      "description": "Process ID number for the current shell or background processes"
+    },
+    "glob_pattern": {
+      "type": "type",
+      "signature": "*, ?, [chars], {a,b}",
+      "description": "Filename expansion pattern with wildcards for matching multiple paths"
+    },
+    "indexed_array": {
+      "type": "primitive",
+      "signature": "declare -a name=(value1 value2 ...)",
+      "description": "Ordered array indexed by non-negative integers starting at 0. Can be sparse. Created implicitly with name=() or name[n]=value, or explicitly with declare -a.",
+      "module": "builtin"
+    },
+    "associative_array": {
+      "type": "primitive",
+      "signature": "declare -A name=([key1]=val1 [key2]=val2)",
+      "description": "Key-value map using arbitrary string keys. Must be explicitly declared with declare -A. Available since Bash 4.0. Cannot be exported.",
+      "module": "builtin"
+    },
+    "nameref": {
+      "type": "type_alias",
+      "signature": "declare -n ref=varname",
+      "description": "Name reference variable that acts as an alias for another variable. All operations on the nameref affect the referenced variable. Available since Bash 4.3. Useful for passing variable names to functions.",
+      "module": "builtin"
+    },
+    "readonly": {
+      "type": "primitive",
+      "signature": "declare -r name=value  or  readonly name=value",
+      "description": "Immutable variable that cannot be reassigned or unset after declaration. Applies to strings, integers, and arrays.",
+      "module": "builtin"
+    },
+    "exported": {
+      "type": "primitive",
+      "signature": "declare -x name=value  or  export name=value",
+      "description": "Variable marked for export to child processes. The value is copied into the environment of subsequently executed commands.",
+      "module": "builtin"
+    },
+    "lowercase": {
+      "type": "primitive",
+      "signature": "declare -l name",
+      "description": "Variable with lowercase attribute. Any value assigned is automatically converted to lowercase.",
+      "module": "builtin"
+    },
+    "uppercase": {
+      "type": "primitive",
+      "signature": "declare -u name",
+      "description": "Variable with uppercase attribute. Any value assigned is automatically converted to uppercase.",
+      "module": "builtin"
+    },
+    "function": {
+      "type": "primitive",
+      "signature": "name() { commands; }  or  function name { commands; }",
+      "description": "Shell function. Takes positional parameters ($1, $2, ...), can declare local variables, and returns an exit status (0-255) via return.",
+      "module": "builtin"
+    },
+    "regex": {
+      "type": "primitive",
+      "signature": "[[ string =~ regex ]]",
+      "description": "POSIX extended regular expression used with the =~ operator in [[ ]]. Capture groups populate BASH_REMATCH array. Do not quote the regex pattern.",
+      "module": "builtin"
+    },
+    "float": {
+      "type": "type",
+      "signature": "float (typeset -F)",
+      "description": "Floating-point variable type declared with typeset -F or float builtin"
+    },
+    "glob": {
+      "type": "type",
+      "signature": "*(D) **/pattern (#q)",
+      "description": "Extended glob patterns with qualifiers for recursive matching and file filtering"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enjoys/context-engine",
-  "version": "1.3.1",
+  "version": "1.4.2",
   "description": "Comprehensive CLI command context engine with 135 tools — subcommands, options, examples, and runtime context detectors for intelligent terminal autocomplete",
   "main": "index.js",
   "types": "index.d.ts",

package/data/codeActions/bash.json

@@ -1,169 +0,0 @@
-{
-  "language": "bash",
-  "codeActions": [
-    {
-      "title": "Add 'set -euo pipefail' header",
-      "kind": "source",
-      "description": "Add strict mode header (set -euo pipefail) to the beginning of the script for safer execution",
-      "pattern": "^#!/",
-      "isPreferred": true
-    },
-    {
-      "title": "Add shebang line",
-      "kind": "source",
-      "description": "Add #!/usr/bin/env bash shebang as the first line of the script",
-      "pattern": "^[^#]",
-      "isPreferred": true
-    },
-    {
-      "title": "Organize source/import statements",
-      "kind": "source.organizeImports",
-      "description": "Sort and deduplicate source/. statements at the top of the script",
-      "pattern": "\\bsource\\b|^\\s*\\.\\s+",
-      "isPreferred": true
-    },
-    {
-      "title": "Extract to function",
-      "kind": "refactor.extract",
-      "description": "Extract selected code into a new bash function with appropriate local variables",
-      "pattern": ".*",
-      "isPreferred": false
-    },
-    {
-      "title": "Extract to variable",
-      "kind": "refactor.extract",
-      "description": "Extract command substitution or expression into a named variable",
-      "pattern": "\\$\\(|`",
-      "isPreferred": false
-    },
-    {
-      "title": "Inline variable",
-      "kind": "refactor.inline",
-      "description": "Replace variable with its value at all usage sites",
-      "pattern": "\\blocal\\b|^\\s*\\w+=",
-      "isPreferred": false
-    },
-    {
-      "title": "Convert to function keyword syntax",
-      "kind": "refactor.rewrite",
-      "description": "Convert name() { } to function name() { } syntax",
-      "pattern": "^\\s*\\w+\\s*\\(\\s*\\)",
-      "isPreferred": false
-    },
-    {
-      "title": "Convert to POSIX function syntax",
-      "kind": "refactor.rewrite",
-      "description": "Convert function name() { } to name() { } (POSIX-compatible) syntax",
-      "pattern": "^\\s*function\\s+\\w+",
-      "isPreferred": false
-    },
-    {
-      "title": "Convert backticks to $() syntax",
-      "kind": "quickfix",
-      "description": "Replace legacy backtick command substitution with modern $(command) syntax",
-      "pattern": "`[^`]+`",
-      "isPreferred": true
-    },
-    {
-      "title": "Convert [ ] to [[ ]]",
-      "kind": "quickfix",
-      "description": "Replace POSIX test brackets with bash extended test brackets for safer evaluation",
-      "pattern": "\\[\\s+.*\\s+\\]",
-      "isPreferred": false
-    },
-    {
-      "title": "Quote unquoted variable",
-      "kind": "quickfix",
-      "description": "Add double quotes around unquoted variable expansion to prevent word splitting and globbing",
-      "pattern": "\\$\\w+|\\$\\{\\w+\\}",
-      "isPreferred": true
-    },
-    {
-      "title": "Add missing 'local' keyword",
-      "kind": "quickfix",
-      "description": "Add 'local' keyword to variable assignments inside functions to prevent global scope pollution",
-      "pattern": "^\\s*\\w+=(?!.*\\bexport\\b)",
-      "isPreferred": false
-    },
-    {
-      "title": "Replace echo with printf",
-      "kind": "refactor.rewrite",
-      "description": "Replace echo with printf for more portable and predictable output formatting",
-      "pattern": "\\becho\\b",
-      "isPreferred": false
-    },
-    {
-      "title": "Add error handling to command",
-      "kind": "quickfix",
-      "description": "Add || { echo 'Error' >&2; exit 1; } error handling to a command",
-      "pattern": "^\\s*\\w+",
-      "isPreferred": false
-    },
-    {
-      "title": "Convert to here-document",
-      "kind": "refactor.rewrite",
-      "description": "Convert multiple echo/printf statements into a single here-document (<<EOF)",
-      "pattern": "\\becho\\b|\\bprintf\\b",
-      "isPreferred": false
-    },
-    {
-      "title": "Wrap in if-check for command existence",
-      "kind": "refactor.rewrite",
-      "description": "Wrap command in 'if command -v cmd &>/dev/null; then ... fi' to check availability",
-      "pattern": "^\\s*\\w+",
-      "isPreferred": false
-    },
-    {
-      "title": "Convert arithmetic to (( )) syntax",
-      "kind": "quickfix",
-      "description": "Replace expr or let with modern (( )) arithmetic syntax",
-      "pattern": "\\bexpr\\b|\\blet\\b",
-      "isPreferred": true
-    },
-    {
-      "title": "Fix all ShellCheck warnings",
-      "kind": "source.fixAll",
-      "description": "Apply all available ShellCheck-based quick-fixes automatically",
-      "pattern": ".*",
-      "isPreferred": false
-    },
-    {
-      "title": "Add trap for cleanup on exit",
-      "kind": "source",
-      "description": "Add a trap command to clean up temporary files or resources on script exit",
-      "pattern": "\\bmktemp\\b|\\btmp\\b",
-      "isPreferred": false
-    },
-    {
-      "title": "Convert to array iteration",
-      "kind": "refactor.rewrite",
-      "description": "Convert whitespace-separated variable to proper array with safe iteration",
-      "pattern": "\\bfor\\s+\\w+\\s+in\\s+\\$",
-      "isPreferred": false
-    },
-    {
-      "title": "Add input validation",
-      "kind": "quickfix",
-      "description": "Add parameter count check and usage message at the top of the script or function",
-      "pattern": "\\$1|\\$\\{1",
-      "isPreferred": false
-    },
-    {
-      "title": "Convert to getopts argument parsing",
-      "kind": "refactor.rewrite",
-      "description": "Replace manual argument parsing with getopts-based option handling loop",
-      "pattern": "\\$1|\\$\\{1|\\bshift\\b",
-      "isPreferred": false
-    }
-  ],
-  "providedCodeActionKinds": [
-    "quickfix",
-    "refactor",
-    "refactor.extract",
-    "refactor.inline",
-    "refactor.rewrite",
-    "source",
-    "source.fixAll",
-    "source.organizeImports"
-  ]
-}

package/data/codeActions/zsh.json

@@ -1,49 +0,0 @@
-{
-  "language": "zsh",
-  "codeActions": [
-    {
-      "title": "Organize imports",
-      "kind": "source.organizeImports",
-      "description": "Sort and clean up source/./autoload/zmodload statements",
-      "pattern": "\\\\bsource\\\\b|\\\\b\\.\\\\b|\\\\bautoload\\\\b|\\\\bzmodload\\\\b",
-      "isPreferred": true
-    },
-    {
-      "title": "Extract to function",
-      "kind": "refactor.extract",
-      "description": "Extract selected code into a new function",
-      "pattern": ".*",
-      "isPreferred": false
-    },
-    {
-      "title": "Extract to variable",
-      "kind": "refactor.extract",
-      "description": "Extract expression into a variable",
-      "pattern": ".*",
-      "isPreferred": false
-    },
-    {
-      "title": "Fix all auto-fixable problems",
-      "kind": "source.fixAll",
-      "description": "Apply all available quick-fixes",
-      "pattern": ".*",
-      "isPreferred": false
-    },
-    {
-      "title": "Inline variable",
-      "kind": "refactor.inline",
-      "description": "Inline a variable at its usage sites",
-      "pattern": "\\\\blocal\\\\b",
-      "isPreferred": false
-    }
-  ],
-  "providedCodeActionKinds": [
-    "quickfix",
-    "refactor",
-    "refactor.extract",
-    "refactor.inline",
-    "source",
-    "source.fixAll",
-    "source.organizeImports"
-  ]
-}

package/data/codeLens/bash.json

@@ -1,75 +0,0 @@
-{
-  "language": "bash",
-  "codeLensPatterns": [
-    {
-      "pattern": "^\\s*function\\s+(\\w+)",
-      "captureGroup": 1,
-      "commandId": "editor.action.referenceSearch.trigger",
-      "title": "Find References",
-      "description": "Show all references to this function"
-    },
-    {
-      "pattern": "^\\s*(\\w[\\w-]*)\\s*\\(\\s*\\)",
-      "captureGroup": 1,
-      "commandId": "editor.action.referenceSearch.trigger",
-      "title": "Find References",
-      "description": "Show all references to this function"
-    },
-    {
-      "pattern": "^\\s*@test\\s+['\"](.+)['\"]",
-      "captureGroup": 1,
-      "commandId": "testing.runAtCursor",
-      "title": "Run Test",
-      "description": "Run this BATS test case"
-    },
-    {
-      "pattern": "^\\s*(?:test_\\w+)\\s*\\(\\s*\\)",
-      "captureGroup": 0,
-      "commandId": "testing.runAtCursor",
-      "title": "Run Test",
-      "description": "Run this test function"
-    },
-    {
-      "pattern": "^\\s*(?:function\\s+)?main\\s*\\(\\s*\\)|^\\s*function\\s+main\\b",
-      "captureGroup": 0,
-      "commandId": "editor.action.referenceSearch.trigger",
-      "title": "Entry Point",
-      "description": "Script main entry point"
-    },
-    {
-      "pattern": "^\\s*(?:export\\s+)?([A-Z_][A-Z0-9_]*)=",
-      "captureGroup": 1,
-      "commandId": "editor.action.referenceSearch.trigger",
-      "title": "Find References",
-      "description": "Show all references to this variable"
-    },
-    {
-      "pattern": "^\\s*source\\s+['\"]?([^'\"\\s]+)['\"]?|^\\s*\\.\\s+['\"]?([^'\"\\s]+)['\"]?",
-      "captureGroup": 1,
-      "commandId": "editor.action.revealDefinition",
-      "title": "Open Source",
-      "description": "Open the sourced file"
-    },
-    {
-      "pattern": "^\\s*trap\\s+['\"]?\\w+['\"]?\\s+(\\w+)",
-      "captureGroup": 1,
-      "commandId": "editor.action.referenceSearch.trigger",
-      "title": "Trap Handler",
-      "description": "Signal trap handler"
-    },
-    {
-      "pattern": "^\\s*complete\\s+.*-F\\s+(\\w+)\\s+(\\w+)",
-      "captureGroup": 2,
-      "commandId": "editor.action.referenceSearch.trigger",
-      "title": "Completion",
-      "description": "Programmable completion for this command"
-    },
-    {
-      "pattern": "^\\s*alias\\s+([\\w-]+)=",
-      "captureGroup": 1,
-      "commandId": "editor.action.referenceSearch.trigger",
-      "title": "Find References",
-      "description": "Show all references to this alias"
-    }
-  ]
-}

package/data/codeLens/zsh.json

@@ -1,19 +0,0 @@
-{
-  "language": "zsh",
-  "codeLensPatterns": [
-    {
-      "pattern": "^\\\\s*function\\\\s+(\\\\w+)",
-      "captureGroup": 1,
-      "commandId": "editor.action.referenceSearch.trigger",
-      "title": "Find References",
-      "description": "Show all references to this function"
-    },
-    {
-      "pattern": "^\\\\s*(\\\\w+)\\\\s*\\\\(\\\\)",
-      "captureGroup": 1,
-      "commandId": "editor.action.referenceSearch.trigger",
-      "title": "Find References",
-      "description": "Show all references to this function"
-    }
-  ]
-}

package/data/color/bash.json

@@ -1,100 +0,0 @@
-{
-  "language": "bash",
-  "colorPatterns": [
-    {
-      "pattern": "\\\\033\\[(\\d+;)*\\d+m|\\\\e\\[(\\d+;)*\\d+m|\\\\x1b\\[(\\d+;)*\\d+m",
-      "format": "ansi_escape",
-      "description": "ANSI escape code color sequence (\\033[...m, \\e[...m, \\x1b[...m)"
-    },
-    {
-      "pattern": "tput\\s+setaf\\s+(\\d+)",
-      "format": "tput_setaf",
-      "description": "tput foreground color (0-255)"
-    },
-    {
-      "pattern": "tput\\s+setab\\s+(\\d+)",
-      "format": "tput_setab",
-      "description": "tput background color (0-255)"
-    }
-  ],
-  "colorPresentations": [
-    "ansi_escape",
-    "tput"
-  ],
-  "namedColors": {
-    "black": {
-      "red": 0,
-      "green": 0,
-      "blue": 0,
-      "alpha": 1
-    },
-    "red": {
-      "red": 0.804,
-      "green": 0,
-      "blue": 0,
-      "alpha": 1
-    },
-    "green": {
-      "red": 0,
-      "green": 0.804,
-      "blue": 0,
-      "alpha": 1
-    },
-    "yellow": {
-      "red": 0.804,
-      "green": 0.804,
-      "blue": 0,
-      "alpha": 1
-    },
-    "blue": {
-      "red": 0,
-      "green": 0,
-      "blue": 0.804,
-      "alpha": 1
-    },
-    "magenta": {
-      "red": 0.804,
-      "green": 0,
-      "blue": 0.804,
-      "alpha": 1
-    },
-    "cyan": {
-      "red": 0,
-      "green": 0.804,
-      "blue": 0.804,
-      "alpha": 1
-    },
-    "white": {
-      "red": 0.804,
-      "green": 0.804,
-      "blue": 0.804,
-      "alpha": 1
-    }
-  },
-  "ansiColorCodes": {
-    "30": "black",
-    "31": "red",
-    "32": "green",
-    "33": "yellow",
-    "34": "blue",
-    "35": "magenta",
-    "36": "cyan",
-    "37": "white",
-    "40": "bg black",
-    "41": "bg red",
-    "42": "bg green",
-    "43": "bg yellow",
-    "44": "bg blue",
-    "45": "bg magenta",
-    "46": "bg cyan",
-    "47": "bg white",
-    "90": "bright black",
-    "91": "bright red",
-    "92": "bright green",
-    "93": "bright yellow",
-    "94": "bright blue",
-    "95": "bright magenta",
-    "96": "bright cyan",
-    "97": "bright white"
-  }
-}

package/data/color/zsh.json

@@ -1,80 +0,0 @@
-{
-  "language": "zsh",
-  "colorPatterns": [
-    {
-      "pattern": "\\\\033\\[(\\d+;)*\\d+m|\\\\e\\[(\\d+;)*\\d+m|\\\\x1b\\[(\\d+;)*\\d+m",
-      "format": "ansi_escape",
-      "description": "ANSI escape code color sequence"
-    },
-    {
-      "pattern": "tput\\s+setaf\\s+(\\d+)",
-      "format": "tput_setaf",
-      "description": "tput foreground color"
-    },
-    {
-      "pattern": "tput\\s+setab\\s+(\\d+)",
-      "format": "tput_setab",
-      "description": "tput background color"
-    },
-    {
-      "pattern": "[\"']#([0-9a-fA-F]{6})[\"']",
-      "format": "hex6_string",
-      "description": "Hex color in string literal"
-    }
-  ],
-  "colorPresentations": [
-    "ansi_escape",
-    "tput",
-    "hex"
-  ],
-  "namedColors": {
-    "black": {
-      "red": 0,
-      "green": 0,
-      "blue": 0,
-      "alpha": 1
-    },
-    "red": {
-      "red": 0.804,
-      "green": 0,
-      "blue": 0,
-      "alpha": 1
-    },
-    "green": {
-      "red": 0,
-      "green": 0.804,
-      "blue": 0,
-      "alpha": 1
-    },
-    "yellow": {
-      "red": 0.804,
-      "green": 0.804,
-      "blue": 0,
-      "alpha": 1
-    },
-    "blue": {
-      "red": 0,
-      "green": 0,
-      "blue": 0.804,
-      "alpha": 1
-    },
-    "magenta": {
-      "red": 0.804,
-      "green": 0,
-      "blue": 0.804,
-      "alpha": 1
-    },
-    "cyan": {
-      "red": 0,
-      "green": 0.804,
-      "blue": 0.804,
-      "alpha": 1
-    },
-    "white": {
-      "red": 0.804,
-      "green": 0.804,
-      "blue": 0.804,
-      "alpha": 1
-    }
-  }
-}