@nrafinia/csmesh 0.8.2 → 0.10.0

package/README.md

@@ -23,14 +23,14 @@ Built for AI coding agents and developers who are tired of multi-turn "file-hopp
 ```bash
 $ csmesh trace PaymentController.Post --budget 600
 
-PaymentController.Post  {http:POST /charge}  Api/PaymentController.cs:14
-  -> CreatePaymentCommandHandler.Handle  [mediatr via Send(CreatePaymentCommand)]  App/CreatePaymentCommand.cs:18
+PaymentController.Post  {http:POST /charge}  Api/PaymentController.cs:14-26
+  -> CreatePaymentCommandHandler.Handle  [mediatr via Send(CreatePaymentCommand)]  App/CreatePaymentCommand.cs:18-31
     -> IPaymentGateway.Authorize  Infra/Repositories.cs:11
-      -> StripeGateway.Authorize  [impl, di-bound]  Infra/Repositories.cs:29
+      -> StripeGateway.Authorize  [impl, di-bound]  Infra/Repositories.cs:29-33
     -> IPaymentRepository.Add  Infra/Repositories.cs:7
-      -> PaymentRepository.Add  [impl, di-bound]  Infra/Repositories.cs:17
-        -> AppDbContext.SavePayment  Infra/Repositories.cs:34
-      -> InMemoryPaymentRepository.Add  [impl]  Infra/Repositories.cs:23
+      -> PaymentRepository.Add  [impl, di-bound]  Infra/Repositories.cs:17-22
+        -> AppDbContext.SavePayment  Infra/Repositories.cs:35-40
+      -> InMemoryPaymentRepository.Add  [impl]  Infra/Repositories.cs:24-27
 ```
 
 
@@ -187,7 +187,7 @@ Times below are the same 2026-09-21 medians as the table above, measured on the
 - **💥 Blast Radius & Impact Analysis:** Computes the reverse call graph to surface all direct/indirect callers, affected controllers, and background consumers before modifying a symbol.
 - **🧩 Nested Type & Member Resolution:** Resolves members declared inside nested types seamlessly (e.g. `Container.Compute` automatically resolves `Container.Inner.Compute`), avoiding lookup misses without shadowing direct matches.
 - **🌐 Universal AI Agent Integration:** Installs native prompt rules and skills for **12+ AI tools** (Claude Code, Cursor, Antigravity, OpenCode, Windsurf, Cline, Copilot, MiMo Code, etc.) with both local and `--global` machine-wide support.
-- **🔄 Incremental Re-indexing:** Node identity is a compiler symbol key, not an array position, so an edit re-binds only the files that moved and every edge into them survives. Rows from files the index has not caught up with are tagged `[STALE]`; `--heal` re-binds them before answering. Falls back to a full pass when an edit touches something that binds across files.
+- **🔄 Incremental Re-indexing:** Node identity is a compiler symbol key, not an array position, so an edit re-binds only the files that moved and every edge into them survives. Queries re-bind changed files before answering by default; a `[STALE]` row means that heal could not run, and the note says why. `--no-heal` answers from the current graph instead. Falls back to a full pass when an edit touches something that binds across files.
 - **🧭 Entry by Description, Not by Name:** `csmesh where <term>` searches names, namespaces, file paths and route templates, then ranks by how many entrypoints reach each hit — so the handler outranks the DTO that shares its name.
 
 ---
@@ -209,8 +209,8 @@ Anything below the threshold prints its score and origin inline rather than blen
 ```text
 $ csmesh impl IStore --budget 300
 IStore  -- 2 implementation(s)
-  SqlStore  [di:scoped, ?0.75 assembly-scan]  src/Data/SqlStore.cs:12  @ src/Api/Startup.cs:41
-  InMemoryStore  [test]  tests/Fakes/InMemoryStore.cs:8
+  SqlStore  [di:scoped, ?0.75 assembly-scan]  src/Data/SqlStore.cs:12-40  @ src/Api/Startup.cs:41
+  InMemoryStore  [test]  tests/Fakes/InMemoryStore.cs:8-20
 ```
 
 And what csmesh could not resolve is an answer too, not a silence:
@@ -383,7 +383,8 @@ csmesh entrypoints orders
 | `--project <PATH>` | Pick one project when a name repeats across assemblies, e.g. `--project src/Api`. Exit `3` lists each candidate's project. Two overloads in one project need the parameter list instead, e.g. `Type.Member(int, string)`. |
 | `--budget <N>` | Hard token limit for stdout. Exits code `2` on overflow. Defaults per command below. |
 | `--depth <N>` | Traversal depth limit (`trace` 6, `blast-radius` 3, `context` 3, `path` 12, `diff` 3, `export` neighbourhood 1) |
-| `--heal` | Re-bind changed files before answering, instead of marking rows `[STALE]` |
+| `--heal` | Heal changed files explicitly before answering. Healing is the default; this form makes a contended index write exit `75` instead of answering stale. |
+| `--no-heal` | Answer from the current graph without healing, marking rows from changed files `[STALE]` |
 | `--json` | Output results in structured JSON format |
 | `--debug` | Print verbose diagnostics to stderr |
 | `--no-telemetry` | Skip recording the invocation in local usage metrics |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nrafinia/csmesh",
-  "version": "0.8.2",
+  "version": "0.10.0",
   "description": "Structural code intelligence & call-graph engine for C# and .NET — built for AI coding agents under hard token budgets",
   "bin": {
     "csmesh": "./bin/run.js"