@muvon/octofs 0.9.0 → 0.10.0

package/README.md

@@ -313,15 +313,40 @@ To read several files, make multiple `view` calls — they run in parallel.
 {"path": "src/", "max_depth": 2, "include_hidden": true}
 ```
 
-`pattern` is a glob, not a content search: without `/` it matches the whole filename at any depth; with `/` it matches the workdir-relative path. It supports `*`, `?`, character classes such as `[abc]`, and `|` alternatives such as `*.rs|*.toml`.
+`pattern` uses the same gitignore-style glob grammar as ripgrep's `-g/--glob`:
+without `/` it matches filenames at any depth, while a pattern containing `/`
+matches the returned relative path. It supports `*` within one path component,
+`**` across directories, `?`, character classes such as `[abc]`, brace alternatives
+such as `*.{rs,toml}`, and leading `!` exclusions. Use `|` to pass ordered globs in
+one MCP string; later globs take precedence:
+
+```json
+{"path": ".", "pattern": "**/*.{rs,toml}|!target/**"}
+{"path": ".", "content": "unsafe", "pattern": "src/**/*.rs|!src/generated/**"}
+```
+
+The glob filters files discovered by Octofs' gitignore-aware traversal. Use
+`include_hidden: true` to include hidden paths; gitignored paths remain excluded.
+Patterns are limited to 4096 UTF-8 bytes, 64 `|`-separated rules, and 16 nested
+brace levels. They must be a single line and are validated before traversal.
+Escape a literal leading `#` or `!` as `\#` or `\!`; otherwise `#` is rejected
+instead of silently acting as a gitignore comment. Empty brace alternatives such
+as `{,rs}` are rejected because ripgrep does not support them.
 
 **Content search:** (literal by default; set `regex: true` for a Rust regex, `(?i)` = case-insensitive)
 ```json
 {"path": "src", "content": "fn main"}
 {"path": "src", "content": "unwrap()", "context": 3}
 {"path": "src", "content": "(?i)error", "regex": true}
+{"path": "docs|scripts|BENCHMARK.md", "content": "update_benchmark.py", "context": 4}
 ```
 
+For an rg-style search across several roots, `path` accepts `|`-separated literal
+files and directories when `content` is set. The roots are not regexes: as with
+rg's positional path arguments, each one must exist. A real path containing `|`
+takes precedence over this shorthand. Root lists must be single-line, contain no
+duplicates, and are limited to 32 roots and 8192 UTF-8 bytes.
+
 Directory listings annotate each file as `path<TAB>NL<TAB>~Nt` (line count + estimated tokens) so you can budget reads before opening files; binary files show `path<TAB>(binary)`.
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muvon/octofs",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Standalone MCP filesystem tools server \u2014 view, edit, shell, workdir.",
   "mcpName": "io.github.Muvon/octofs",
   "bin": {