@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.
- package/README.md +17 -9
- package/dist/application/add-note.js +2 -2
- package/dist/application/build-context.js +16 -10
- package/dist/application/canonical-context-links.js +44 -5
- package/dist/application/check-package-update.js +105 -0
- package/dist/application/frontend/client/chunk-fetch.js +236 -0
- package/dist/application/frontend/client/controls.js +178 -0
- package/dist/application/frontend/client/elements.js +122 -0
- package/dist/application/frontend/client/input.js +202 -0
- package/dist/application/frontend/client/node-details.js +191 -0
- package/dist/application/frontend/client/rendering.js +296 -0
- package/dist/application/frontend/client/scope-theme.js +114 -0
- package/dist/application/frontend/client/spatial.js +98 -0
- package/dist/application/frontend/client/storage.js +215 -0
- package/dist/application/frontend/client/upload.js +90 -0
- package/dist/application/frontend/client/worker-bootstrap.js +147 -0
- package/dist/application/frontend/client-js.js +24 -1837
- package/dist/application/frontend/client-render-worker-js.js +1 -1
- package/dist/application/index-vault-phases.js +189 -0
- package/dist/application/index-vault.js +44 -165
- package/dist/application/server/routes.js +12 -9
- package/dist/cli/commands/write/dedupe-commands.js +59 -0
- package/dist/cli/commands/write/index-commands.js +205 -0
- package/dist/cli/commands/write/link-commands.js +68 -0
- package/dist/cli/commands/write/note-commands.js +146 -0
- package/dist/cli/commands/write/server-commands.js +553 -0
- package/dist/cli/commands/write/shared.js +35 -0
- package/dist/cli/commands/write/vault-lifecycle-commands.js +270 -0
- package/dist/cli/commands/write-commands.js +12 -1303
- package/dist/cli/main.js +39 -3
- package/dist/domain/context.js +39 -3
- package/dist/domain/embeddings.js +31 -5
- package/dist/domain/graph-contexts.js +62 -57
- package/dist/domain/graph-layout/cauliflower-layout.js +116 -0
- package/dist/domain/graph-layout/collisions.js +100 -0
- package/dist/domain/graph-layout/hierarchy.js +135 -0
- package/dist/domain/graph-layout/metrics.js +111 -0
- package/dist/domain/graph-layout/segments.js +76 -0
- package/dist/domain/graph-layout/star-layout.js +110 -0
- package/dist/domain/graph-layout.js +4 -625
- package/dist/infrastructure/config.js +10 -4
- package/dist/infrastructure/file-index.js +13 -4
- package/dist/infrastructure/semantic-prefilter.js +24 -0
- package/dist/mcp/server.js +7 -0
- package/dist/mcp/tool-guard.js +29 -0
- package/dist/mcp/tools/maintenance-tools.js +409 -0
- package/dist/mcp/tools/read-tools.js +504 -0
- package/dist/mcp/tools/shared.js +216 -0
- package/dist/mcp/tools/write-tools.js +247 -0
- package/dist/mcp/tools.js +3 -1357
- package/docs/AGENT_USAGE.md +4 -4
- package/docs/QUICKSTART.md +5 -1
- package/package.json +2 -2
package/docs/AGENT_USAGE.md
CHANGED
|
@@ -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
|
|
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 `
|
|
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=
|
|
782
|
-
GET /api/context?q=<query>&limit=
|
|
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
|
package/docs/QUICKSTART.md
CHANGED
|
@@ -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":
|
|
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.
|
|
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.
|
|
67
|
+
"hono": "4.12.26",
|
|
68
68
|
"qs": "6.15.2"
|
|
69
69
|
},
|
|
70
70
|
"devDependencies": {
|