backpack-ontology 0.1.4 → 0.2.0

package/README.md

@@ -109,6 +109,12 @@ await backpack.initialize();
 await backpack.createOntology("my-graph", "A knowledge graph");
 const node = await backpack.addNode("my-graph", "Person", { name: "Alice" });
 await backpack.addEdge("my-graph", "KNOWS", node.id, otherNodeId);
+
+// Search across all node properties (case-insensitive)
+const results = await backpack.searchNodes("my-graph", "alice");
+
+// BFS traversal from a node (depth 1–3)
+const neighbors = await backpack.getNeighbors("my-graph", node.id, undefined, "both", 2);
 ```
 
 ### Pluggable Storage

package/dist/bin/init.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/bin/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/bin/init.ts"],"names":[],"mappings":""}

package/dist/bin/init.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+/** Check if a hook rule array already contains a backpack-originated rule. */
+function hasBackpackRule(rules) {
+    return rules.some((r) => r.hooks?.some((h) => (h.prompt && h.prompt.includes("Backpack")) ||
+        (h.command && h.command.includes("backpack"))) ?? false);
+}
+async function main() {
+    const projectDir = process.cwd();
+    const claudeDir = path.join(projectDir, ".claude");
+    const settingsPath = path.join(claudeDir, "settings.json");
+    // Load the hooks configuration shipped with backpack-ontology
+    const thisFile = fileURLToPath(import.meta.url);
+    const packageRoot = path.resolve(path.dirname(thisFile), "..", "..");
+    const hooksJsonPath = path.join(packageRoot, "hooks", "hooks.json");
+    let hooksConfig;
+    try {
+        const raw = await fs.readFile(hooksJsonPath, "utf-8");
+        hooksConfig = JSON.parse(raw);
+    }
+    catch {
+        console.error("Error: could not read hooks configuration from backpack-ontology package.");
+        console.error(`Expected at: ${hooksJsonPath}`);
+        process.exit(1);
+    }
+    // Ensure .claude directory exists
+    await fs.mkdir(claudeDir, { recursive: true });
+    // Read existing settings or start fresh
+    let settings = {};
+    try {
+        const raw = await fs.readFile(settingsPath, "utf-8");
+        settings = JSON.parse(raw);
+    }
+    catch {
+        // File doesn't exist or isn't valid JSON — start fresh
+    }
+    // Merge hooks — backpack hooks are added alongside any existing hooks
+    if (!settings.hooks) {
+        settings.hooks = {};
+    }
+    const existingHooks = settings.hooks;
+    const newHooks = (hooksConfig.hooks ?? {});
+    let alreadyConfigured = false;
+    for (const [event, rules] of Object.entries(newHooks)) {
+        if (!existingHooks[event]) {
+            existingHooks[event] = rules;
+        }
+        else {
+            const existing = existingHooks[event];
+            if (Array.isArray(existing) && hasBackpackRule(existing)) {
+                // Backpack hooks already present for this event — skip to avoid duplicates
+                alreadyConfigured = true;
+                continue;
+            }
+            // Append backpack hook rules to existing event rules
+            if (Array.isArray(existing) && Array.isArray(rules)) {
+                existingHooks[event] = [...existing, ...rules];
+            }
+            else {
+                existingHooks[event] = rules;
+            }
+        }
+    }
+    if (alreadyConfigured) {
+        console.log("");
+        console.log("  Backpack hooks are already configured in: " + settingsPath);
+        console.log("  No changes made. To reconfigure, remove the existing backpack hooks first.");
+        console.log("");
+        return;
+    }
+    settings.hooks = existingHooks;
+    // Write settings
+    await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+    console.log("");
+    console.log("  Backpack hooks configured successfully!");
+    console.log("");
+    console.log("  Enabled in: " + settingsPath);
+    console.log("");
+    console.log("  What's enabled:");
+    console.log("    - Auto-capture: a background agent reviews your Claude conversations");
+    console.log("      and automatically builds knowledge graphs from meaningful discussions.");
+    console.log("    - Viewer suggestions: after ontology updates, you'll be reminded to");
+    console.log("      visualize your knowledge graph with `npx backpack-viewer`.");
+    console.log("");
+    console.log("  To disable, remove the backpack hooks from .claude/settings.json");
+    console.log("");
+}
+main().catch((error) => {
+    console.error("Error:", error.message ?? error);
+    process.exit(1);
+});
+//# sourceMappingURL=init.js.map

package/dist/bin/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/bin/init.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQvD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,CAoBpB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQvD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,CA+BpB"}

package/dist/mcp/server.js

@@ -23,7 +23,15 @@ export async function createMcpServer(storage) {
     catch { /* noop */ }
     const server = new McpServer({
         name: "backpack",
-        version: "0.1.0",
+        version: "0.2.0",
+    }, {
+        instructions: `Backpack is a persistent knowledge graph that remembers what matters across conversations.
+
+When you learn something meaningful — a business relationship, a technical decision, a process, a domain concept — consider adding it to backpack. Use backpack_list to see what ontologies exist and backpack_describe to understand their structure before adding to them. Create a new ontology when the topic is distinct from existing ones.
+
+After updating an ontology, let the user know they can visualize their knowledge graph by running: npx backpack-viewer (opens http://localhost:5173)
+
+Be selective — not every conversation needs to be captured. Focus on knowledge with lasting value: relationships, decisions, architecture, processes, domain concepts, conventions.`,
     });
     // Register all tool groups
     registerOntologyTools(server, backpack);

package/dist/mcp/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAwB;IAExB,MAAM,OAAO,GAAG,OAAO,IAAI,IAAI,eAAe,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAE5B,sDAAsD;IACtD,IAAI,CAAC;QAAC,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,2BAA2B;IAC3B,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEpC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAwB;IAExB,MAAM,OAAO,GAAG,OAAO,IAAI,IAAI,eAAe,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAE5B,sDAAsD;IACtD,IAAI,CAAC;QAAC,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;;;;;;oLAMgK;KAC/K,CACF,CAAC;IAEF,2BAA2B;IAC3B,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEpC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/hooks/auto-capture-prompt.md

@@ -0,0 +1,40 @@
+You are a knowledge-capture agent for Backpack, a knowledge graph system. Your job is to review the conversation that just happened and decide whether meaningful knowledge should be preserved in an ontology.
+
+## Instructions
+
+1. **Review the conversation transcript** — understand what was discussed, decided, or worked on.
+
+2. **Decide if anything is worth capturing.** Look for:
+   - **Business knowledge**: client details, vendor info, pricing, partnerships, workflows
+   - **Technical knowledge**: architecture, APIs, data flows, integrations, design decisions
+   - **Domain knowledge**: industry concepts, terminology, regulations, best practices
+   - **Operational knowledge**: decisions made, problems solved, processes established, conventions agreed upon
+   - **Relationships**: how people, systems, concepts, or processes connect to each other
+
+3. **Skip trivial interactions.** Do NOT capture:
+   - Simple Q&A with no lasting value
+   - Debugging sessions that led nowhere
+   - Casual conversation or greetings
+   - Knowledge that was already captured in a previous pass
+   - Temporary state or in-progress work that will change
+
+4. **If there IS something worth capturing:**
+   a. Call `backpack_list` to see existing ontologies
+   b. Call `backpack_describe` on relevant ontologies to check what's already there
+   c. Decide: update an existing ontology (if the topic fits) or create a new one (if the topic is distinct)
+   d. Use `backpack_import_nodes` for efficient bulk node creation
+   e. Use `backpack_add_edge` to create relationships between nodes
+   f. Use clear, descriptive node types and edge types that make the graph readable
+
+5. **If there is NOTHING worth capturing**, simply stop. Do not force it.
+
+6. **After making updates**, briefly tell the user what was added to their knowledge graph and suggest they can visualize it:
+   > "Your backpack knowledge graph was updated with [brief summary]. View it by running `npx backpack-viewer` and opening http://localhost:5173"
+
+## Guidelines for good ontology entries
+
+- **Node types** should be clear nouns: `Person`, `Company`, `API`, `Decision`, `Process`, `Concept`, `Tool`, `Service`, `Regulation`, etc.
+- **Edge types** should be clear relationships: `WORKS_WITH`, `DEPENDS_ON`, `DECIDED_TO`, `MANAGES`, `IMPLEMENTS`, `RELATES_TO`, etc.
+- **Properties** should include enough context to be useful later: names, descriptions, dates, reasons, status.
+- **Be selective but thorough** — capture the important things well rather than everything poorly.
+- **Prefer updating existing nodes** over creating duplicates. Check if a concept already exists before adding it.

package/hooks/hooks.json

@@ -0,0 +1,29 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "agent",
+            "prompt": "You are a knowledge-capture agent for Backpack, a knowledge graph system. Review the conversation that just happened and decide whether meaningful knowledge should be preserved in an ontology.\n\n## What to capture\n- Business knowledge: client details, vendor info, pricing, partnerships, workflows\n- Technical knowledge: architecture, APIs, data flows, integrations, design decisions\n- Domain knowledge: industry concepts, terminology, regulations, best practices\n- Operational knowledge: decisions made, problems solved, processes established, conventions\n- Relationships: how people, systems, concepts, or processes connect\n\n## What to skip\n- Simple Q&A with no lasting value\n- Debugging that led nowhere\n- Casual conversation or greetings\n- Knowledge already captured in a previous pass\n- Temporary or in-progress state\n\n## If there IS something worth capturing\n1. Call `backpack_list` to see existing ontologies\n2. Call `backpack_describe` on relevant ones to check existing content\n3. Decide: update an existing ontology (if topic fits) or create a new one (if distinct)\n4. Use `backpack_import_nodes` for bulk node creation\n5. Use `backpack_add_edge` to create relationships\n6. Use clear node types (Person, Company, API, Decision, Process, Concept, Tool, Service) and edge types (WORKS_WITH, DEPENDS_ON, DECIDED_TO, MANAGES, IMPLEMENTS, RELATES_TO)\n\n## If NOTHING is worth capturing, just stop.\n\n## After updates, tell the user:\n\"Your backpack knowledge graph was updated with [brief summary]. View it by running `npx backpack-viewer` (http://localhost:5173)\"",
+            "timeout": 120,
+            "async": true
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "backpack_create|backpack_add_node|backpack_update_node|backpack_import_nodes|backpack_add_edge",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "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)'",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/suggest-viewer.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+# PostToolUse hook: suggest the viewer after backpack write operations.
+# Output is injected into Claude's context as additional information.
+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)'

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "backpack-ontology",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "A persistent ontology engine for Claude Code via MCP — progressive discovery of structured knowledge graphs",
   "license": "Apache-2.0",
   "author": "Noah Irzinger",
   "type": "module",
   "bin": {
-    "backpack": "./dist/bin/backpack.js"
+    "backpack": "./dist/bin/backpack.js",
+    "backpack-init": "./dist/bin/init.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "hooks"
   ],
   "scripts": {
     "build": "tsc",