@andespindola/brainlink 1.0.4 → 1.0.6

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.
Files changed (53) hide show
  1. package/README.md +17 -9
  2. package/dist/application/add-note.js +2 -2
  3. package/dist/application/build-context.js +16 -10
  4. package/dist/application/canonical-context-links.js +44 -5
  5. package/dist/application/check-package-update.js +105 -0
  6. package/dist/application/frontend/client/chunk-fetch.js +236 -0
  7. package/dist/application/frontend/client/controls.js +178 -0
  8. package/dist/application/frontend/client/elements.js +122 -0
  9. package/dist/application/frontend/client/input.js +202 -0
  10. package/dist/application/frontend/client/node-details.js +191 -0
  11. package/dist/application/frontend/client/rendering.js +296 -0
  12. package/dist/application/frontend/client/scope-theme.js +114 -0
  13. package/dist/application/frontend/client/spatial.js +98 -0
  14. package/dist/application/frontend/client/storage.js +215 -0
  15. package/dist/application/frontend/client/upload.js +90 -0
  16. package/dist/application/frontend/client/worker-bootstrap.js +147 -0
  17. package/dist/application/frontend/client-js.js +24 -1837
  18. package/dist/application/frontend/client-render-worker-js.js +1 -1
  19. package/dist/application/index-vault-phases.js +189 -0
  20. package/dist/application/index-vault.js +44 -165
  21. package/dist/application/server/routes.js +12 -9
  22. package/dist/cli/commands/write/dedupe-commands.js +59 -0
  23. package/dist/cli/commands/write/index-commands.js +205 -0
  24. package/dist/cli/commands/write/link-commands.js +68 -0
  25. package/dist/cli/commands/write/note-commands.js +146 -0
  26. package/dist/cli/commands/write/server-commands.js +553 -0
  27. package/dist/cli/commands/write/shared.js +35 -0
  28. package/dist/cli/commands/write/vault-lifecycle-commands.js +270 -0
  29. package/dist/cli/commands/write-commands.js +12 -1303
  30. package/dist/cli/main.js +39 -3
  31. package/dist/domain/context.js +39 -3
  32. package/dist/domain/embeddings.js +31 -5
  33. package/dist/domain/graph-contexts.js +62 -57
  34. package/dist/domain/graph-layout/cauliflower-layout.js +116 -0
  35. package/dist/domain/graph-layout/collisions.js +100 -0
  36. package/dist/domain/graph-layout/hierarchy.js +135 -0
  37. package/dist/domain/graph-layout/metrics.js +111 -0
  38. package/dist/domain/graph-layout/segments.js +76 -0
  39. package/dist/domain/graph-layout/star-layout.js +110 -0
  40. package/dist/domain/graph-layout.js +4 -625
  41. package/dist/infrastructure/config.js +10 -4
  42. package/dist/infrastructure/file-index.js +13 -4
  43. package/dist/infrastructure/semantic-prefilter.js +24 -0
  44. package/dist/mcp/server.js +7 -0
  45. package/dist/mcp/tool-guard.js +29 -0
  46. package/dist/mcp/tools/maintenance-tools.js +409 -0
  47. package/dist/mcp/tools/read-tools.js +504 -0
  48. package/dist/mcp/tools/shared.js +216 -0
  49. package/dist/mcp/tools/write-tools.js +247 -0
  50. package/dist/mcp/tools.js +3 -1357
  51. package/docs/AGENT_USAGE.md +4 -4
  52. package/docs/QUICKSTART.md +5 -1
  53. package/package.json +2 -2
@@ -585,7 +585,7 @@ Context assembly uses middle-out ordering inside each note: the highest-scoring
585
585
  ### Build Agent Context
586
586
 
587
587
  ```bash
588
- blink context "how does authentication work?" --vault ./vault --limit 12 --tokens 2000
588
+ blink context "how does authentication work?" --vault ./vault --limit 8 --tokens 1500
589
589
  blink context "how does authentication work?" --vault ./vault --json
590
590
  blink context "how does authentication work?" --vault ./vault --agent coding-agent --json
591
591
  blink context "how does authentication work?" --vault ./vault --agent coding-agent --mode hybrid --json
@@ -596,7 +596,7 @@ blink context-packs --vault ./vault --stale --clear
596
596
  ```
597
597
 
598
598
  This returns a Markdown context package optimized for prompt injection.
599
- The default strategy is configured by `defaultContextStrategy` and starts as `rag`. Use `--strategy cag` when the same agent/task context should be served from a persisted context pack when the index and volatile-memory signatures are unchanged. Use `--strategy auto` when Brainlink should use CAG on fresh pack hits and RAG otherwise. Context responses include `cache`, `metrics`, `requestedStrategy` and `recommendedStrategy` metadata. CAG packs live under `.brainlink/context-packs` and are rebuildable derived artifacts.
599
+ The default strategy is configured by `defaultContextStrategy` and starts as `auto`, so repeated stable context can reuse fresh CAG packs while misses fall back to RAG and refresh a pack for later calls. Use `--strategy cag` when the same agent/task context must be served from a persisted context pack when the index and volatile-memory signatures are unchanged. Use `--strategy rag` when fresh retrieval is required. Context responses include `cache`, `metrics`, `requestedStrategy` and `recommendedStrategy` metadata. CAG packs live under `.brainlink/context-packs` and are rebuildable derived artifacts.
600
600
 
601
601
  ### Inspect Links
602
602
 
@@ -778,8 +778,8 @@ GET /api/graph-layout
778
778
  GET /api/graph-view?x=<x>&y=<y>&w=<width>&h=<height>&scale=<scale>
779
779
  GET /api/graph-node?id=<node-id>
780
780
  GET /api/graph-filter?q=<query>&limit=<n>
781
- GET /api/search?q=<query>&limit=10&mode=hybrid
782
- GET /api/context?q=<query>&limit=12&tokens=2000&mode=hybrid
781
+ GET /api/search?q=<query>&limit=8&mode=hybrid
782
+ GET /api/context?q=<query>&limit=8&tokens=1500&mode=hybrid
783
783
  GET /api/links
784
784
  GET /api/backlinks?title=<title>
785
785
  GET /api/stats
@@ -46,11 +46,13 @@ Optional per-agent retrieval defaults in `brainlink.config.json`:
46
46
 
47
47
  ```json
48
48
  {
49
+ "autoUpdateCheck": true,
50
+ "updateCheckIntervalMs": 86400000,
49
51
  "agentProfiles": {
50
52
  "coding-agent": {
51
53
  "defaultSearchMode": "semantic",
52
54
  "defaultSearchLimit": 8,
53
- "defaultContextTokens": 2400,
55
+ "defaultContextTokens": 1500,
54
56
  "defaultContextStrategy": "auto",
55
57
  "defaultContextCacheTtlMs": 120000
56
58
  }
@@ -58,6 +60,8 @@ Optional per-agent retrieval defaults in `brainlink.config.json`:
58
60
  }
59
61
  ```
60
62
 
63
+ `autoUpdateCheck` only prints a newer-version notice to `stderr`; it does not install updates automatically. Set `BRAINLINK_NO_UPDATE_CHECK=1` or `"autoUpdateCheck": false` to disable the check.
64
+
61
65
  ## 4) Run Bootstrap Before Work
62
66
 
63
67
  MCP clients should call `brainlink_bootstrap` first for each vault/agent session, then `brainlink_context`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@andespindola/brainlink",
3
- "version": "1.0.4",
3
+ "version": "1.0.6",
4
4
  "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -64,7 +64,7 @@
64
64
  "zod": "^4.3.6"
65
65
  },
66
66
  "overrides": {
67
- "hono": "4.12.21",
67
+ "hono": "4.12.26",
68
68
  "qs": "6.15.2"
69
69
  },
70
70
  "devDependencies": {