@kokorolx/ai-sandbox-wrapper 2.7.0 → 3.0.1

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.
package/README.md CHANGED
@@ -192,6 +192,26 @@ npx @kokorolx/ai-sandbox-wrapper git fetch-only ~/projects/myrepo
192
192
  npx @kokorolx/ai-sandbox-wrapper git full ~/projects/myrepo
193
193
  ```
194
194
 
195
+ ### Nano-brain Auto-Repair
196
+
197
+ When running nano-brain inside the sandbox, `ai-run` performs a targeted preflight and automatic retry for common native-module failures (for example tree-sitter binding issues).
198
+
199
+ It also suppresses known **non-fatal** tree-sitter symbol-graph warnings when the command succeeds, so normal query output stays clean. To see suppressed diagnostics, run with debug mode (`AI_RUN_DEBUG=1`).
200
+
201
+ ```bash
202
+ # Auto-repair enabled by default
203
+ ai-run npx nano-brain status
204
+
205
+ # Disable per-command
206
+ ai-run npx nano-brain status --no-nano-brain-auto-repair
207
+
208
+ # Disable via environment variable
209
+ AI_RUN_DISABLE_NANO_BRAIN_AUTO_REPAIR=1 ai-run npx nano-brain status
210
+
211
+ # Show suppressed non-fatal warning details
212
+ AI_RUN_DEBUG=1 ai-run npx nano-brain query "hello"
213
+ ```
214
+
195
215
  ### Clipboard
196
216
 
197
217
  Clipboard access in containers requires a terminal that supports **OSC52** protocol.
@@ -320,6 +340,10 @@ opencode -n mynetwork # Join Docker network
320
340
  # Git fetch-only
321
341
  opencode --git-fetch # Fetch only (no push)
322
342
 
343
+ # Nano-brain
344
+ ai-run npx nano-brain status # With auto-repair
345
+ AI_RUN_DISABLE_NANO_BRAIN_AUTO_REPAIR=1 ai-run npx nano-brain status
346
+
323
347
  # Management
324
348
  npx @kokorolx/ai-sandbox-wrapper workspace list
325
349
  npx @kokorolx/ai-sandbox-wrapper clean
@@ -336,6 +360,7 @@ npx @kokorolx/ai-sandbox-wrapper clean
336
360
  | Port already in use | Stop the process or use different port |
337
361
  | Docker not found | Install and start Docker Desktop |
338
362
  | Clipboard not working | Use OSC52-compatible terminal. See [CLIPBOARD_SUPPORT.md](CLIPBOARD_SUPPORT.md) |
363
+ | nano-brain native binding/tree-sitter error | Fatal errors auto-repair and retry once by default; known non-fatal symbol-graph warnings are suppressed unless `AI_RUN_DEBUG=1` |
339
364
 
340
365
  ---
341
366