backpack-ontology 0.2.24 → 0.3.0
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 +153 -3
- package/dist/bin/backpack-benchmark.d.ts +3 -0
- package/dist/bin/backpack-benchmark.d.ts.map +1 -0
- package/dist/bin/backpack-benchmark.js +213 -0
- package/dist/bin/backpack-benchmark.js.map +1 -0
- package/dist/bin/backpack.js +3 -3
- package/dist/bin/backpack.js.map +1 -1
- package/dist/bin/init.js +8 -11
- package/dist/bin/init.js.map +1 -1
- package/dist/core/backpack.d.ts +78 -2
- package/dist/core/backpack.d.ts.map +1 -1
- package/dist/core/backpack.js +226 -3
- package/dist/core/backpack.js.map +1 -1
- package/dist/core/draft.d.ts +42 -0
- package/dist/core/draft.d.ts.map +1 -0
- package/dist/core/draft.js +232 -0
- package/dist/core/draft.js.map +1 -0
- package/dist/core/events.d.ts +114 -0
- package/dist/core/events.d.ts.map +1 -0
- package/dist/core/events.js +375 -0
- package/dist/core/events.js.map +1 -0
- package/dist/core/graph.d.ts +3 -1
- package/dist/core/graph.d.ts.map +1 -1
- package/dist/core/graph.js +50 -0
- package/dist/core/graph.js.map +1 -1
- package/dist/core/hooks.d.ts +11 -3
- package/dist/core/hooks.d.ts.map +1 -1
- package/dist/core/hooks.js +53 -47
- package/dist/core/hooks.js.map +1 -1
- package/dist/core/normalize.d.ts +28 -0
- package/dist/core/normalize.d.ts.map +1 -0
- package/dist/core/normalize.js +133 -0
- package/dist/core/normalize.js.map +1 -0
- package/dist/core/remote-fetch.d.ts +50 -0
- package/dist/core/remote-fetch.d.ts.map +1 -0
- package/dist/core/remote-fetch.js +338 -0
- package/dist/core/remote-fetch.js.map +1 -0
- package/dist/core/remote-registry.d.ts +95 -0
- package/dist/core/remote-registry.d.ts.map +1 -0
- package/dist/core/remote-registry.js +296 -0
- package/dist/core/remote-registry.js.map +1 -0
- package/dist/core/remote-schema.d.ts +31 -0
- package/dist/core/remote-schema.d.ts.map +1 -0
- package/dist/core/remote-schema.js +252 -0
- package/dist/core/remote-schema.js.map +1 -0
- package/dist/core/role-audit.d.ts +20 -0
- package/dist/core/role-audit.d.ts.map +1 -0
- package/dist/core/role-audit.js +197 -0
- package/dist/core/role-audit.js.map +1 -0
- package/dist/core/telemetry.d.ts +2 -0
- package/dist/core/telemetry.d.ts.map +1 -1
- package/dist/core/telemetry.js +27 -0
- package/dist/core/telemetry.js.map +1 -1
- package/dist/core/token-estimate.d.ts +16 -0
- package/dist/core/token-estimate.d.ts.map +1 -0
- package/dist/core/token-estimate.js +29 -0
- package/dist/core/token-estimate.js.map +1 -0
- package/dist/core/types.d.ts +30 -1
- package/dist/core/types.d.ts.map +1 -1
- package/dist/index.d.ts +9 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +11 -0
- package/dist/mcp/server.js.map +1 -1
- package/dist/mcp/tools/bulk-tools.d.ts.map +1 -1
- package/dist/mcp/tools/bulk-tools.js +80 -12
- package/dist/mcp/tools/bulk-tools.js.map +1 -1
- package/dist/mcp/tools/edge-tools.d.ts.map +1 -1
- package/dist/mcp/tools/edge-tools.js +14 -18
- package/dist/mcp/tools/edge-tools.js.map +1 -1
- package/dist/mcp/tools/error-helpers.d.ts +16 -0
- package/dist/mcp/tools/error-helpers.d.ts.map +1 -0
- package/dist/mcp/tools/error-helpers.js +34 -0
- package/dist/mcp/tools/error-helpers.js.map +1 -0
- package/dist/mcp/tools/intelligence-tools.d.ts +4 -0
- package/dist/mcp/tools/intelligence-tools.d.ts.map +1 -0
- package/dist/mcp/tools/intelligence-tools.js +184 -0
- package/dist/mcp/tools/intelligence-tools.js.map +1 -0
- package/dist/mcp/tools/node-tools.d.ts.map +1 -1
- package/dist/mcp/tools/node-tools.js +43 -40
- package/dist/mcp/tools/node-tools.js.map +1 -1
- package/dist/mcp/tools/ontology-tools.d.ts.map +1 -1
- package/dist/mcp/tools/ontology-tools.js +237 -12
- package/dist/mcp/tools/ontology-tools.js.map +1 -1
- package/dist/mcp/tools/remote-tools.d.ts +5 -0
- package/dist/mcp/tools/remote-tools.d.ts.map +1 -0
- package/dist/mcp/tools/remote-tools.js +295 -0
- package/dist/mcp/tools/remote-tools.js.map +1 -0
- package/dist/mcp/tools/version-tools.d.ts.map +1 -1
- package/dist/mcp/tools/version-tools.js +86 -0
- package/dist/mcp/tools/version-tools.js.map +1 -1
- package/dist/storage/backpack-app-backend.d.ts +1 -1
- package/dist/storage/backpack-app-backend.d.ts.map +1 -1
- package/dist/storage/backpack-app-backend.js +3 -1
- package/dist/storage/backpack-app-backend.js.map +1 -1
- package/dist/storage/event-sourced-backend.d.ts +174 -0
- package/dist/storage/event-sourced-backend.d.ts.map +1 -0
- package/dist/storage/event-sourced-backend.js +840 -0
- package/dist/storage/event-sourced-backend.js.map +1 -0
- package/dist/storage/json-file-backend.d.ts +1 -54
- package/dist/storage/json-file-backend.d.ts.map +1 -1
- package/dist/storage/json-file-backend.js +11 -470
- package/dist/storage/json-file-backend.js.map +1 -1
- package/package.json +3 -3
- package/hooks/auto-capture-prompt.md +0 -40
- package/hooks/hooks.json +0 -16
- package/hooks/suggest-viewer.sh +0 -4
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "backpack-ontology",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "A persistent learning graph engine for Claude Code via MCP — structured knowledge that carries forward across sessions",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "Noah Irzinger",
|
|
@@ -10,13 +10,13 @@
|
|
|
10
10
|
"backpack-local": "./dist/bin/backpack.js",
|
|
11
11
|
"backpack-sync": "./dist/bin/backpack-sync.js",
|
|
12
12
|
"backpack-init": "./dist/bin/init.js",
|
|
13
|
+
"backpack-benchmark": "./dist/bin/backpack-benchmark.js",
|
|
13
14
|
"backpack": "./dist/bin/backpack.js"
|
|
14
15
|
},
|
|
15
16
|
"main": "./dist/index.js",
|
|
16
17
|
"types": "./dist/index.d.ts",
|
|
17
18
|
"files": [
|
|
18
|
-
"dist"
|
|
19
|
-
"hooks"
|
|
19
|
+
"dist"
|
|
20
20
|
],
|
|
21
21
|
"scripts": {
|
|
22
22
|
"build": "tsc",
|
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
You are a knowledge-capture agent for Backpack, a learning graph system. Your job is to review the conversation that just happened and decide whether meaningful knowledge should be preserved in a learning graph.
|
|
2
|
-
|
|
3
|
-
## Instructions
|
|
4
|
-
|
|
5
|
-
1. **Review the conversation transcript** — understand what was discussed, decided, or worked on.
|
|
6
|
-
|
|
7
|
-
2. **Decide if anything is worth capturing.** Look for:
|
|
8
|
-
- **Business knowledge**: client details, vendor info, pricing, partnerships, workflows
|
|
9
|
-
- **Technical knowledge**: architecture, APIs, data flows, integrations, design decisions
|
|
10
|
-
- **Domain knowledge**: industry concepts, terminology, regulations, best practices
|
|
11
|
-
- **Operational knowledge**: decisions made, problems solved, processes established, conventions agreed upon
|
|
12
|
-
- **Relationships**: how people, systems, concepts, or processes connect to each other
|
|
13
|
-
|
|
14
|
-
3. **Skip trivial interactions.** Do NOT capture:
|
|
15
|
-
- Simple Q&A with no lasting value
|
|
16
|
-
- Debugging sessions that led nowhere
|
|
17
|
-
- Casual conversation or greetings
|
|
18
|
-
- Knowledge that was already captured in a previous pass
|
|
19
|
-
- Temporary state or in-progress work that will change
|
|
20
|
-
|
|
21
|
-
4. **If there IS something worth capturing:**
|
|
22
|
-
a. Call `backpack_list` to see existing learning graphs
|
|
23
|
-
b. Call `backpack_describe` on relevant learning graphs to check what's already there
|
|
24
|
-
c. Decide: update an existing learning graph (if the topic fits) or create a new one (if the topic is distinct)
|
|
25
|
-
d. Use `backpack_import_nodes` for efficient bulk node creation
|
|
26
|
-
e. Use `backpack_add_edge` to create relationships between nodes
|
|
27
|
-
f. Use clear, descriptive node types and edge types that make the graph readable
|
|
28
|
-
|
|
29
|
-
5. **If there is NOTHING worth capturing**, simply stop. Do not force it.
|
|
30
|
-
|
|
31
|
-
6. **After making updates**, briefly tell the user what was added to their learning graph and suggest they can visualize it:
|
|
32
|
-
> "Your backpack was updated with [brief summary]. View it by running `npx backpack-viewer` and opening http://localhost:5173"
|
|
33
|
-
|
|
34
|
-
## Guidelines for good entries
|
|
35
|
-
|
|
36
|
-
- **Node types** should be clear nouns: `Person`, `Company`, `API`, `Decision`, `Process`, `Concept`, `Tool`, `Service`, `Regulation`, etc.
|
|
37
|
-
- **Edge types** should be clear relationships: `WORKS_WITH`, `DEPENDS_ON`, `DECIDED_TO`, `MANAGES`, `IMPLEMENTS`, `RELATES_TO`, etc.
|
|
38
|
-
- **Properties** should include enough context to be useful later: names, descriptions, dates, reasons, status.
|
|
39
|
-
- **Be selective but thorough** — capture the important things well rather than everything poorly.
|
|
40
|
-
- **Prefer updating existing nodes** over creating duplicates. Check if a concept already exists before adding it.
|
package/hooks/hooks.json
DELETED
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"hooks": {
|
|
3
|
-
"PostToolUse": [
|
|
4
|
-
{
|
|
5
|
-
"matcher": "backpack_create|backpack_add_node|backpack_update_node|backpack_import_nodes|backpack_add_edge",
|
|
6
|
-
"hooks": [
|
|
7
|
-
{
|
|
8
|
-
"type": "command",
|
|
9
|
-
"command": "echo 'Backpack updated.'",
|
|
10
|
-
"timeout": 5
|
|
11
|
-
}
|
|
12
|
-
]
|
|
13
|
-
}
|
|
14
|
-
]
|
|
15
|
-
}
|
|
16
|
-
}
|
package/hooks/suggest-viewer.sh
DELETED
|
@@ -1,4 +0,0 @@
|
|
|
1
|
-
#!/bin/sh
|
|
2
|
-
# PostToolUse hook: suggest the viewer after backpack write operations.
|
|
3
|
-
# Output is injected into Claude's context as additional information.
|
|
4
|
-
echo 'The user'\''s backpack ontology was just updated. Let the user know they can visualize their knowledge graph by running: npx backpack-viewer (opens http://localhost:5173)'
|