@openweave/weave-link 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lemur bookstores
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# 🧠 weave-graph
+
+> **WeaveGraph** — The knowledge graph engine at the heart of OpenWeave.
+
+Part of the [OpenWeave](../../README.md) monorepo.
+
+---
+
+## What it does
+
+WeaveGraph manages all memory for an OpenWeave session:
+
+- Stores **concepts, decisions, errors and corrections** as typed graph nodes
+- Connects them with **semantic edges** (relates, causes, corrects, implements, depends_on)
+- **Compresses context** into the graph when the LLM window reaches 75% capacity
+- **Retrieves relevant nodes** from long-term memory given a query
+- **Persists everything** to disk by `chat_id`, survives across sessions
+
+## Node Types
+
+| Type | Description |
+|---|---|
+| `CONCEPT` | A key idea or term in the project |
+| `DECISION` | An architectural or implementation decision |
+| `MILESTONE` | A planned deliverable |
+| `ERROR` | A response flagged as incorrect by the user (suppressed) |
+| `CORRECTION` | The correct version linked to an ERROR node |
+| `CODE_ENTITY` | A function, class, or module created during the session |
+
+## Edge Types
+
+| Relation | Meaning |
+|---|---|
+| `RELATES` | General semantic relationship |
+| `CAUSES` | A causes B |
+| `CORRECTS` | A is the correction of B (B is an ERROR node) |
+| `IMPLEMENTS` | A implements B (code → decision) |
+| `DEPENDS_ON` | A depends on B |
+| `BLOCKS` | A blocks B |
+
+## Quick Start
+
+```python
+from weave_graph import ContextGraphManager, NodeType, EdgeType
+
+# Initialize for a session
+graph = ContextGraphManager(chat_id="proj_abc123")
+
+# Add a decision node
+decision = graph.add_node(
+    content="Use PostgreSQL for persistence, not SQLite — project will scale",
+    node_type=NodeType.DECISION,
+    tags=["database", "architecture"]
+)
+
+# Add a concept and relate it
+concept = graph.add_node(
+    content="Session persistence by chat_id",
+    node_type=NodeType.CONCEPT
+)
+graph.add_edge(decision.id, concept.id, EdgeType.RELATES)
+
+# Suppress an error and record correction
+graph.suppress_error_node(
+    node_id=bad_response_node.id,
+    correction_content="Use async/await, not threading — the codebase is fully async"
+)
+
+# Query relevant context before responding
+relevant = graph.query_relevant_nodes("database connection pooling", top_k=5)
+
+# Compress context when window is getting full
+compressed_summary = graph.compress_context_to_graph(
+    context_text=long_conversation_text,
+    llm_extractor_fn=my_extraction_function
+)
+```
+
+## Storage
+
+All data is persisted to:
+```
+{storage_path}/{chat_id}/
+├── context_graph.json    ← Full graph (nodes + edges)
+├── roadmap.md            ← Human-readable milestone status
+├── decisions.md          ← Decision log
+└── errors.md             ← Error pattern registry
+```
+
+## Installation
+
+```bash
+pip install openweave-graph
+# or within the monorepo:
+pnpm --filter weave-graph dev
+```

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * WeaveLink - MCP Server
+ * Model Context Protocol server for integrating WeaveGraph with AI clients
+ */
+export declare const version = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * WeaveLink - MCP Server
+ * Model Context Protocol server for integrating WeaveGraph with AI clients
+ */
+export const version = "0.1.0";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@openweave/weave-link",
+  "version": "0.2.0",
+  "description": "WeaveLink — MCP Server for integrating WeaveGraph with AI clients",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "weave-link": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "mcp",
+    "weave",
+    "ai-agent",
+    "model-context-protocol"
+  ],
+  "devDependencies": {
+    "@types/node": "22.10.2",
+    "typescript": "5.7.2",
+    "vitest": "3.0.0"
+  },
+  "dependencies": {
+    "@openweave/weave-graph": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src --max-warnings 0",
+    "clean": "rm -rf dist",
+    "start": "node dist/cli.js"
+  }
+}