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.
Files changed (109) hide show
  1. package/README.md +153 -3
  2. package/dist/bin/backpack-benchmark.d.ts +3 -0
  3. package/dist/bin/backpack-benchmark.d.ts.map +1 -0
  4. package/dist/bin/backpack-benchmark.js +213 -0
  5. package/dist/bin/backpack-benchmark.js.map +1 -0
  6. package/dist/bin/backpack.js +3 -3
  7. package/dist/bin/backpack.js.map +1 -1
  8. package/dist/bin/init.js +8 -11
  9. package/dist/bin/init.js.map +1 -1
  10. package/dist/core/backpack.d.ts +78 -2
  11. package/dist/core/backpack.d.ts.map +1 -1
  12. package/dist/core/backpack.js +226 -3
  13. package/dist/core/backpack.js.map +1 -1
  14. package/dist/core/draft.d.ts +42 -0
  15. package/dist/core/draft.d.ts.map +1 -0
  16. package/dist/core/draft.js +232 -0
  17. package/dist/core/draft.js.map +1 -0
  18. package/dist/core/events.d.ts +114 -0
  19. package/dist/core/events.d.ts.map +1 -0
  20. package/dist/core/events.js +375 -0
  21. package/dist/core/events.js.map +1 -0
  22. package/dist/core/graph.d.ts +3 -1
  23. package/dist/core/graph.d.ts.map +1 -1
  24. package/dist/core/graph.js +50 -0
  25. package/dist/core/graph.js.map +1 -1
  26. package/dist/core/hooks.d.ts +11 -3
  27. package/dist/core/hooks.d.ts.map +1 -1
  28. package/dist/core/hooks.js +53 -47
  29. package/dist/core/hooks.js.map +1 -1
  30. package/dist/core/normalize.d.ts +28 -0
  31. package/dist/core/normalize.d.ts.map +1 -0
  32. package/dist/core/normalize.js +133 -0
  33. package/dist/core/normalize.js.map +1 -0
  34. package/dist/core/remote-fetch.d.ts +50 -0
  35. package/dist/core/remote-fetch.d.ts.map +1 -0
  36. package/dist/core/remote-fetch.js +338 -0
  37. package/dist/core/remote-fetch.js.map +1 -0
  38. package/dist/core/remote-registry.d.ts +95 -0
  39. package/dist/core/remote-registry.d.ts.map +1 -0
  40. package/dist/core/remote-registry.js +296 -0
  41. package/dist/core/remote-registry.js.map +1 -0
  42. package/dist/core/remote-schema.d.ts +31 -0
  43. package/dist/core/remote-schema.d.ts.map +1 -0
  44. package/dist/core/remote-schema.js +252 -0
  45. package/dist/core/remote-schema.js.map +1 -0
  46. package/dist/core/role-audit.d.ts +20 -0
  47. package/dist/core/role-audit.d.ts.map +1 -0
  48. package/dist/core/role-audit.js +197 -0
  49. package/dist/core/role-audit.js.map +1 -0
  50. package/dist/core/telemetry.d.ts +2 -0
  51. package/dist/core/telemetry.d.ts.map +1 -1
  52. package/dist/core/telemetry.js +27 -0
  53. package/dist/core/telemetry.js.map +1 -1
  54. package/dist/core/token-estimate.d.ts +16 -0
  55. package/dist/core/token-estimate.d.ts.map +1 -0
  56. package/dist/core/token-estimate.js +29 -0
  57. package/dist/core/token-estimate.js.map +1 -0
  58. package/dist/core/types.d.ts +30 -1
  59. package/dist/core/types.d.ts.map +1 -1
  60. package/dist/index.d.ts +9 -1
  61. package/dist/index.d.ts.map +1 -1
  62. package/dist/index.js +8 -1
  63. package/dist/index.js.map +1 -1
  64. package/dist/mcp/server.d.ts.map +1 -1
  65. package/dist/mcp/server.js +11 -0
  66. package/dist/mcp/server.js.map +1 -1
  67. package/dist/mcp/tools/bulk-tools.d.ts.map +1 -1
  68. package/dist/mcp/tools/bulk-tools.js +80 -12
  69. package/dist/mcp/tools/bulk-tools.js.map +1 -1
  70. package/dist/mcp/tools/edge-tools.d.ts.map +1 -1
  71. package/dist/mcp/tools/edge-tools.js +14 -18
  72. package/dist/mcp/tools/edge-tools.js.map +1 -1
  73. package/dist/mcp/tools/error-helpers.d.ts +16 -0
  74. package/dist/mcp/tools/error-helpers.d.ts.map +1 -0
  75. package/dist/mcp/tools/error-helpers.js +34 -0
  76. package/dist/mcp/tools/error-helpers.js.map +1 -0
  77. package/dist/mcp/tools/intelligence-tools.d.ts +4 -0
  78. package/dist/mcp/tools/intelligence-tools.d.ts.map +1 -0
  79. package/dist/mcp/tools/intelligence-tools.js +184 -0
  80. package/dist/mcp/tools/intelligence-tools.js.map +1 -0
  81. package/dist/mcp/tools/node-tools.d.ts.map +1 -1
  82. package/dist/mcp/tools/node-tools.js +43 -40
  83. package/dist/mcp/tools/node-tools.js.map +1 -1
  84. package/dist/mcp/tools/ontology-tools.d.ts.map +1 -1
  85. package/dist/mcp/tools/ontology-tools.js +237 -12
  86. package/dist/mcp/tools/ontology-tools.js.map +1 -1
  87. package/dist/mcp/tools/remote-tools.d.ts +5 -0
  88. package/dist/mcp/tools/remote-tools.d.ts.map +1 -0
  89. package/dist/mcp/tools/remote-tools.js +295 -0
  90. package/dist/mcp/tools/remote-tools.js.map +1 -0
  91. package/dist/mcp/tools/version-tools.d.ts.map +1 -1
  92. package/dist/mcp/tools/version-tools.js +86 -0
  93. package/dist/mcp/tools/version-tools.js.map +1 -1
  94. package/dist/storage/backpack-app-backend.d.ts +1 -1
  95. package/dist/storage/backpack-app-backend.d.ts.map +1 -1
  96. package/dist/storage/backpack-app-backend.js +3 -1
  97. package/dist/storage/backpack-app-backend.js.map +1 -1
  98. package/dist/storage/event-sourced-backend.d.ts +174 -0
  99. package/dist/storage/event-sourced-backend.d.ts.map +1 -0
  100. package/dist/storage/event-sourced-backend.js +840 -0
  101. package/dist/storage/event-sourced-backend.js.map +1 -0
  102. package/dist/storage/json-file-backend.d.ts +1 -54
  103. package/dist/storage/json-file-backend.d.ts.map +1 -1
  104. package/dist/storage/json-file-backend.js +11 -470
  105. package/dist/storage/json-file-backend.js.map +1 -1
  106. package/package.json +3 -3
  107. package/hooks/auto-capture-prompt.md +0 -40
  108. package/hooks/hooks.json +0 -16
  109. 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.2.24",
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
- }
@@ -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)'