@ushiradineth/veil 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +44 -36
  2. package/dist/bin.js +24 -43405
  3. package/package.json +32 -28
  4. package/skills/SKILL.md +77 -0
package/README.md CHANGED
@@ -12,18 +12,6 @@ It provides one compact tool surface for local code retrieval, git context, web
12
12
  npx -y @ushiradineth/veil@latest
13
13
  ```
14
14
 
15
- Local dev:
16
-
17
- ```bash
18
- nix run nixpkgs#bun -- run src/bin.ts
19
- ```
20
-
21
- Optional Streamable HTTP mode:
22
-
23
- ```bash
24
- VEIL_HTTP=1 npx -y @ushiradineth/veil@latest
25
- ```
26
-
27
15
  ### Install MCP skill
28
16
 
29
17
  ```bash
@@ -71,27 +59,47 @@ Add to `~/.config/opencode/opencode.json`:
71
59
 
72
60
  ## Capabilities
73
61
 
74
- | Capability | MCP tool |
75
- | ---------------------------------- | ----------------------------------------------------------------------------------------- |
76
- | Index status | `veil_status` |
77
- | Incremental refresh | `veil_refresh` |
78
- | Full rebuild | `veil_build` |
79
- | Discover files/symbols/chunks | `veil_discover` |
80
- | Fetch one chunk by id | `veil_chunk` |
81
- | Intent-aware lookup | `veil_lookup` |
82
- | File path retrieval | `veil_files` |
83
- | Symbol retrieval | `veil_symbols` |
84
- | Content search | `veil_search` |
85
- | Grammar list/install/remove/update | `veil_grammar_list`, `veil_grammar_install`, `veil_grammar_remove`, `veil_grammar_update` |
86
- | Web search | `veil_web_search` |
87
- | URL fetch | `veil_fetch_url` |
88
- | Git status/log/diff/show | `veil_git_status`, `veil_git_log`, `veil_git_diff`, `veil_git_show` |
89
- | GitHub context lookup | `veil_gh_lookup` |
90
- | Diagnostics | `veil_diagnostics` |
91
-
92
- ## Notes
93
-
94
- - MCP responses are TOON text and compact by default.
95
- - Retrieval tools auto-refresh on stale or dirty worktrees by default.
96
- - Full chunk content is opt-in on retrieval calls via `include_content`.
97
- - `veil_fetch_url` blocks private/local network targets by default unless explicitly allowed.
62
+ | Capability | MCP tool |
63
+ | ----------------------------------- | ----------------------------------------------------------------------------------------- |
64
+ | Index status | `veil_status` |
65
+ | MCP and skill update check | `veil_update_check` |
66
+ | Incremental refresh | `veil_refresh` |
67
+ | Full rebuild | `veil_build` |
68
+ | Discover files/symbols/chunks | `veil_discover` |
69
+ | Fetch one chunk by id | `veil_chunk` |
70
+ | Intent-aware lookup | `veil_lookup` |
71
+ | File path retrieval | `veil_files` |
72
+ | Symbol retrieval | `veil_symbols` |
73
+ | Content search | `veil_search` |
74
+ | Grammar list/install/remove/update | `veil_grammar_list`, `veil_grammar_install`, `veil_grammar_remove`, `veil_grammar_update` |
75
+ | Grammar recommendation/install plan | `veil_grammar_recommend` |
76
+ | Grammar runtime package install | `veil_grammar_runtime_install` |
77
+ | Web search | `veil_web_search` |
78
+ | URL fetch | `veil_fetch_url` |
79
+ | Git status/log/diff/show | `veil_git_status`, `veil_git_log`, `veil_git_diff`, `veil_git_show` |
80
+ | GitHub context lookup | `veil_gh_lookup` |
81
+ | Diagnostics | `veil_diagnostics` |
82
+
83
+ ## Optional parser runtimes
84
+
85
+ - Core defaults stay minimal: `javascript`, `typescript`, `json`.
86
+ - Additional languages are optional and install only after explicit user approval via
87
+ `veil_grammar_runtime_install`.
88
+ - Common optional coverage includes:
89
+ - `nix`, `elixir`, `zig`, `go`, `rust`
90
+ - `c`, `cpp`, `c-sharp`
91
+ - `markdown`
92
+ - `java`, `php`, `ruby`, `lua`, `kotlin`, `swift`
93
+
94
+ ### Runtime install reuse semantics
95
+
96
+ - Parser enable or install state is persisted in `<state_root>/grammars.json` (default state root: `.veil`).
97
+ - Runtime packages are installed into `<state_root>/grammars-runtime` for that workspace.
98
+ - Separate MCP server instances reuse the same runtime install location when they target the same workspace and
99
+ state root.
100
+ - Fallback policy is strict for known installable parsers: global fallback is only allowed when runtime install is
101
+ recorded as failed (`runtime_install_failed`) or when no known runtime package mapping exists.
102
+
103
+ ## Note
104
+
105
+ > Veil is still experimental and under active development. Please report any issues or suggestions.