@muvon/octofs 0.14.1 → 0.15.1

package/README.md

@@ -58,6 +58,7 @@ Your AI coding assistant (Cursor, Claude, Windsurf, etc.) is smart — but it's
 | **Transport** | STDIO + Streamable HTTP | STDIO only |
 | **Shell Integration** | Automatic foreground-to-background handoff | Limited or none |
 | **Remote Files** | Transparent SSH/SFTP on every file tool | None |
+| **Re-reads** | Delta views — re-viewing a file returns only the hunks changed since | Full file every time |
 | **Safety** | Gitignore-aware, stale-write detection, path validation | Full filesystem access |
 
 ---
@@ -234,7 +235,10 @@ Edit tools take these ids back as targets and verify the hash against the file
 before applying anything. A stale id (the file changed since it was viewed) fails
 with the current content around the target and where the expected content moved —
 so the model retargets from the error instead of re-reading the file. Edit results
-are diffs with fresh ids, so edits chain without re-viewing.
+are diffs with fresh ids, so edits chain without re-viewing. Removed lines collapse
+to their old id range (`-12:a3..15:f1 (4 lines)`), and a trailing
+`shift: lines after 40:b2 +3` line says how original line numbers below each edit
+moved, so ids the model still holds can be adjusted without a failed call.
 
 This is the single line-id format — there is no mode switch. Plain line numbers
 are still accepted where a position alone is safe: `view` ranges (negative counts
@@ -301,6 +305,7 @@ octofs mcp --path ssh://deploy@example.com/var/www/app --ssh-key ~/.ssh/id_ed255
 view path="ssh://deploy@example.com/etc/nginx/nginx.conf"
 ```
 
+- **Login home** — `ssh://host` (no path) and `ssh://host/~/dir` resolve against the login user's home, like `ssh host` / `scp host:dir`. `ssh://host/dir` stays absolute.
 - **OpenSSH config** — host aliases are resolved through the local OpenSSH config (including `Include` and `Match`) and honor `HostName`, `User`, `Port`, and a single `ProxyJump`. Explicit URL values win, so both `ssh://dev/path` and `ssh://user@example.com:2222/path` work as expected. Multi-hop `ProxyJump` and `ProxyCommand` routing are rejected with a clear error.
 - **Authentication** — uses the host's `IdentityAgent` (e.g. 1Password) or `$SSH_AUTH_SOCK`, then key files — `--ssh-key` if given, the host's `IdentityFile` entries, then the defaults in `~/.ssh` (`id_ed25519`, `id_ecdsa`). Passphrase-protected key files are not supported directly; use an agent instead.
 - **RSA keys are not supported** — the Rust `rsa` crate has an unfixed timing side-channel (Marvin attack, [RUSTSEC-2023-0071](https://rustsec.org/advisories/RUSTSEC-2023-0071)), so octofs is built without RSA entirely. Use an ed25519 key instead (`ssh-keygen -t ed25519`); ecdsa also works. RSA-only setups fail with a clear error naming the key.
@@ -329,6 +334,16 @@ that `batch_edit` and `extract_lines` take as targets.
 
 To read several files, make multiple `view` calls — they run in parallel.
 
+**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.
+```json
+{"path": "src/main.rs", "full": true}   // force the complete file (e.g. after context compaction)
+```
+
 **Directory listing:**
 ```json
 {"path": "src/"}
@@ -336,6 +351,11 @@ To read several files, make multiple `view` calls — they run in parallel.
 {"path": "src/", "max_depth": 2, "include_hidden": true}
 ```
 
+A bare listing of a remote directory (`ssh://host/path`, no `pattern`/`content`)
+defaults to `max_depth: 1` — root entries only — because every subdirectory costs
+an SFTP round trip; pass `max_depth` explicitly to walk deeper. Searches with
+`pattern` or `content` always walk the whole tree, like `rg`.
+
 `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,

package/package.json

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