@enjoys/context-engine 1.0.9 → 1.1.0

package/README.md

@@ -2,6 +2,14 @@
 
 Comprehensive CLI command context engine with **190 tools** and **35 languages** — completions, definitions, hovers, subcommands, options, examples, and runtime context detectors for intelligent terminal autocomplete in Monaco Editor.
 
+## Why Context Engine?
+
+Traditional LSP (Language Server Protocol) setups require a backend server running a separate language server process for every language you want to support. Each language server needs its own binary installed — Go, Rust, Python, TypeScript, and so on. At scale, this makes the backend **heavy**, memory-hungry, and CPU-intensive. Supporting all languages can easily consume **1 GB+** of disk space and significant runtime resources just to keep those servers alive.
+
+Context Engine takes a fundamentally different approach. Instead of running language servers on the backend, it ships **pre-built, Monaco-compatible JSON data** loaded directly via API — completions, hover docs, definitions, and 190 CLI command definitions — all in a single package under **~100 MB**. No language binaries to install. No background processes to manage. No backend required for intelligence.
+
+> **Note:** Context Engine does not provide path-based intelligence (file resolution, go-to-definition across files, etc.) the way a full LSP does. It focuses on **language-aware completions, hover documentation, inline definitions, and terminal command autocomplete** — the features that matter most in web-based terminal and editor experiences, without the infrastructure overhead.
+
 ## Install
 
 ```bash
@@ -585,6 +593,26 @@ const ctx = getContextEngine('systemctl');
 
 **Parser types:** `text` | `lines` | `json` | `csv` | `keyvalue` | `regex` | `table`
 
+## Upcoming Monaco Provider Support
+
+The following Monaco providers are planned for future releases, bringing Context Engine closer to full LSP-level intelligence — all without a backend:
+
+| Provider | Status |
+|----------|--------|
+| `registerCodeActionProvider` | 🔜 Planned |
+| `registerDocumentHighlightProvider` | 🔜 Planned |
+| `registerDocumentSymbolProvider` | 🔜 Planned |
+| `registerLinkProvider` | 🔜 Planned |
+| `registerTypeDefinitionProvider` | 🔜 Planned |
+| `registerReferenceProvider` | 🔜 Planned |
+| `registerImplementationProvider` | 🔜 Planned |
+| `registerInlineCompletionsProvider` | 🔜 Planned |
+| `registerDocumentFormattingEditProvider` | 🔜 Planned |
+| `registerCodeLensProvider` | 🔜 Planned |
+| `registerColorProvider` | 🔜 Planned |
+| `registerDeclarationProvider` | 🔜 Planned |
+| `registerInlayHintsProvider` | 🔜 Planned |
+
 ## License
 
 MIT © Enjoys Inc

package/data/codeActions/awk.json

@@ -0,0 +1,41 @@
+{
+  "language": "awk",
+  "codeActions": [
+    {
+      "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": "\\\\b\\\\w+\\\\b",
+      "isPreferred": false
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll"
+  ]
+}

package/data/codeActions/bash.json

@@ -0,0 +1,169 @@
+{
+  "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/c.json

@@ -0,0 +1,35 @@
+{
+  "language": "c",
+  "codeActions": [
+    {
+      "title": "Organize imports",
+      "kind": "source.organizeImports",
+      "description": "Sort and clean up #include statements",
+      "pattern": "\\\\b#include\\\\b",
+      "isPreferred": true
+    },
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll",
+    "source.organizeImports"
+  ]
+}

package/data/codeActions/caddy.json

@@ -0,0 +1,35 @@
+{
+  "language": "caddy",
+  "codeActions": [
+    {
+      "title": "Organize imports",
+      "kind": "source.organizeImports",
+      "description": "Sort and clean up import statements",
+      "pattern": "\\\\bimport\\\\b",
+      "isPreferred": true
+    },
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll",
+    "source.organizeImports"
+  ]
+}

package/data/codeActions/cpp.json

@@ -0,0 +1,35 @@
+{
+  "language": "cpp",
+  "codeActions": [
+    {
+      "title": "Organize imports",
+      "kind": "source.organizeImports",
+      "description": "Sort and clean up #include/using statements",
+      "pattern": "\\\\b#include\\\\b|\\\\busing\\\\b",
+      "isPreferred": true
+    },
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll",
+    "source.organizeImports"
+  ]
+}

package/data/codeActions/crontab.json

@@ -0,0 +1,27 @@
+{
+  "language": "crontab",
+  "codeActions": [
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll"
+  ]
+}

package/data/codeActions/csharp.json

@@ -0,0 +1,35 @@
+{
+  "language": "csharp",
+  "codeActions": [
+    {
+      "title": "Organize imports",
+      "kind": "source.organizeImports",
+      "description": "Sort and clean up using statements",
+      "pattern": "\\\\busing\\\\b",
+      "isPreferred": true
+    },
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll",
+    "source.organizeImports"
+  ]
+}

package/data/codeActions/dockerfile.json

@@ -0,0 +1,35 @@
+{
+  "language": "dockerfile",
+  "codeActions": [
+    {
+      "title": "Organize imports",
+      "kind": "source.organizeImports",
+      "description": "Sort and clean up FROM statements",
+      "pattern": "\\\\bFROM\\\\b",
+      "isPreferred": true
+    },
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll",
+    "source.organizeImports"
+  ]
+}

package/data/codeActions/dotenv.json

@@ -0,0 +1,27 @@
+{
+  "language": "dotenv",
+  "codeActions": [
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll"
+  ]
+}

package/data/codeActions/go.json

@@ -0,0 +1,49 @@
+{
+  "language": "go",
+  "codeActions": [
+    {
+      "title": "Organize imports",
+      "kind": "source.organizeImports",
+      "description": "Sort and clean up import statements",
+      "pattern": "\\\\bimport\\\\b",
+      "isPreferred": true
+    },
+    {
+      "title": "Extract to function",
+      "kind": "refactor.extract",
+      "description": "Extract selected code into a new func",
+      "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": "\\\\bvar\\\\b",
+      "isPreferred": false
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll",
+    "source.organizeImports"
+  ]
+}

package/data/codeActions/graphql.json

@@ -0,0 +1,41 @@
+{
+  "language": "graphql",
+  "codeActions": [
+    {
+      "title": "Extract to function",
+      "kind": "refactor.extract",
+      "description": "Extract selected code into a new query",
+      "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": "\\\\b\\\\w+\\\\b",
+      "isPreferred": false
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll"
+  ]
+}

package/data/codeActions/hcl.json

@@ -0,0 +1,35 @@
+{
+  "language": "hcl",
+  "codeActions": [
+    {
+      "title": "Organize imports",
+      "kind": "source.organizeImports",
+      "description": "Sort and clean up source statements",
+      "pattern": "\\\\bsource\\\\b",
+      "isPreferred": true
+    },
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll",
+    "source.organizeImports"
+  ]
+}

package/data/codeActions/html.json

@@ -0,0 +1,27 @@
+{
+  "language": "html",
+  "codeActions": [
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll"
+  ]
+}

package/data/codeActions/ini.json

@@ -0,0 +1,27 @@
+{
+  "language": "ini",
+  "codeActions": [
+    {
+      "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
+    }
+  ],
+  "providedCodeActionKinds": [
+    "quickfix",
+    "refactor",
+    "refactor.extract",
+    "refactor.inline",
+    "source",
+    "source.fixAll"
+  ]
+}