@muvon/octofs 0.15.2 → 0.15.4

package/README.md

@@ -334,12 +334,21 @@ that `batch_edit` and `extract_lines` take as targets.
 
 To read several files, make multiple `view` calls — they run in parallel.
 
+Reuse content and line ids already returned. Read a complete relevant function or block
+in one call, combining adjacent windows. If its location is unknown, use `content` with
+enough `context` to understand the matches, then fetch only missing surrounding code.
+Do not re-read overlapping ranges or repeatedly narrow a range just to pick edit targets.
+Re-read when the file may have changed, output was truncated, or prior context is unavailable.
+Empty files return `[empty file, 0 lines]` on an initial or forced full read.
+
 **Delta views:** a whole-file view of a file the session already served returns
 only the hunks changed since — the same `...`/`-`/`+` style as edit results, with
 removed lines collapsed to their old id range — or
 `[unchanged since you last viewed or edited it: N lines. Pass full: true to re-read.]`.
 Octofs' own edits keep the cache current, so a re-view after your own `batch_edit`
 costs one line. Ranged views and content search always render exactly what was asked.
+`full` has no effect on ranges or searches; omit `start`/`end` and content search to
+force a complete file read. It does not change output limits.
 ```json
 {"path": "src/main.rs", "full": true}   // force the complete file (e.g. after context compaction)
 ```

package/package.json

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