cc-memory 2.0.0

package/README.md

@@ -0,0 +1,369 @@
+# cc-memory
+
+> マルチエージェント開発で、共有知識と専門知識を分離管理するメモリサーバー
+
+[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io/)
+
+---
+
+## コンセプト
+
+```
+Shared Scope（共有層）← 全エージェント読める、manager のみ書ける
+  ├── プロジェクト要件
+  ├── コーディング規約
+  └── 運用ルール
+
+Personal Scope（個人層）← 本人のみ読み書き
+  ├── Web AG: Nginx経験、フロント知識
+  ├── DB AG: MySQL経験、クエリ最適化
+  └── Infra AG: k8s経験、監視設定
+```
+
+マネージャーがチーム全体の知識を **Shared Scope** に集約し、各ワーカーは自分だけの経験を **Personal Scope** に蓄積。これにより、知識の一貫性と専門性を両立します。
+
+---
+
+## 特徴
+
+- **スコープモデル** — `shared`（共有）と `personal`（個人）の 2 層でメモリを管理
+- **Role-based Access Control** — `manager` は全スコープ読み書き可、`worker` は shared 読み取り＋自分の personal のみ
+- **MCP 対応** — Claude Code やその他 MCP クライアントからそのまま使える
+- **SQLite** — ローカル保存、クラウド不要、プライバシー重視
+- **8 API endpoints** — シンプルで必要十分な API セット
+
+---
+
+## インストール & セットアップ
+
+```bash
+# グローバルインストール
+npm install -g cc-memory
+
+# データベース初期化
+cc-memory setup
+```
+
+### Claude Code で使う
+
+`~/.claude/settings.json` に以下を追加:
+
+```json
+{
+  "mcpServers": {
+    "cc-memory": {
+      "command": "cc-memory",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+> `cc-memory setup` を実行すると DB ファイルが作成されます。デフォルトパスは `./cc-memory.db`（環境変数 `CC_MEMORY_DB` で変更可）。
+
+---
+
+## MCP API 一覧
+
+### メモリ操作（4 本）
+
+| ツール | 説明 |
+|--------|------|
+| `memory_store` | メモリを保存。shared スコープは manager のみ書き込み可 |
+| `memory_recall` | クエリでメモリを検索。関連度順にランキング |
+| `memory_list` | スコープ内の全メモリを一覧 |
+| `memory_delete` | メモリを削除。オーナーまたは manager のみ |
+
+### プロジェクト管理（2 本）
+
+| ツール | 説明 |
+|--------|------|
+| `project_create` | 新しいプロジェクトを作成 |
+| `project_list` | 全プロジェクトを一覧 |
+
+### エージェント管理（2 本）
+
+| ツール | 説明 |
+|--------|------|
+| `agent_register` | エージェントをプロジェクトに登録（role: manager / worker） |
+| `agent_list` | プロジェクト内の全エージェントを一覧 |
+
+### パラメータ詳細
+
+<details>
+<summary><code>memory_store</code></summary>
+
+| パラメータ | 型 | 必須 | 説明 |
+|-----------|------|------|------|
+| `scope` | `"shared" \| "personal"` | ✅ | メモリスコープ |
+| `agent_id` | `string` | ✅ | 呼び出し元エージェント ID |
+| `content` | `string` | ✅ | メモリ内容 |
+| `tags` | `string[]` | - | タグ（検索用） |
+| `project_id` | `string` | - | プロジェクト ID（デフォルト: `"default"`） |
+
+</details>
+
+<details>
+<summary><code>memory_recall</code></summary>
+
+| パラメータ | 型 | 必須 | 説明 |
+|-----------|------|------|------|
+| `scope` | `"shared" \| "personal" \| "all"` | ✅ | 検索スコープ |
+| `query` | `string` | ✅ | 検索クエリ |
+| `caller_id` | `string` | ✅* | 呼び出し元エージェント ID（権限チェック用） |
+| `agent_id` | `string` | - | エージェント ID フィルタ |
+| `project_id` | `string` | - | プロジェクト ID |
+| `limit` | `number` | - | 最大件数（1-100、デフォルト: 10） |
+
+> *`caller_id` は権限チェックのため実質必須です。
+
+</details>
+
+<details>
+<summary><code>memory_list</code></summary>
+
+| パラメータ | 型 | 必須 | 説明 |
+|-----------|------|------|------|
+| `scope` | `"shared" \| "personal"` | ✅ | メモリスコープ |
+| `agent_id` | `string` | - | エージェント ID フィルタ |
+| `project_id` | `string` | - | プロジェクト ID |
+
+</details>
+
+<details>
+<summary><code>memory_delete</code></summary>
+
+| パラメータ | 型 | 必須 | 説明 |
+|-----------|------|------|------|
+| `memory_id` | `string` | ✅ | 削除するメモリの ID |
+| `caller_id` | `string` | ✅* | 呼び出し元エージェント ID |
+| `project_id` | `string` | - | プロジェクト ID |
+
+</details>
+
+<details>
+<summary><code>project_create</code></summary>
+
+| パラメータ | 型 | 必須 | 説明 |
+|-----------|------|------|------|
+| `project_id` | `string` | ✅ | プロジェクト ID |
+| `description` | `string` | ✅ | プロジェクトの説明 |
+
+</details>
+
+<details>
+<summary><code>project_list</code></summary>
+
+パラメータなし。
+
+</details>
+
+<details>
+<summary><code>agent_register</code></summary>
+
+| パラメータ | 型 | 必須 | 説明 |
+|-----------|------|------|------|
+| `project_id` | `string` | ✅ | プロジェクト ID |
+| `agent_id` | `string` | ✅ | エージェント ID |
+| `role` | `"manager" \| "worker"` | ✅ | 役割 |
+
+</details>
+
+<details>
+<summary><code>agent_list</code></summary>
+
+| パラメータ | 型 | 必須 | 説明 |
+|-----------|------|------|------|
+| `project_id` | `string` | ✅ | プロジェクト ID |
+
+</details>
+
+---
+
+## 使い方（マルチエージェントシナリオ）
+
+### 1. プロジェクト作成
+
+```json
+{ "tool": "project_create", "project_id": "my-app", "description": "ECサイト開発" }
+```
+
+### 2. エージェント登録
+
+```json
+{ "tool": "agent_register", "project_id": "my-app", "agent_id": "lead", "role": "manager" }
+{ "tool": "agent_register", "project_id": "my-app", "agent_id": "web-worker", "role": "worker" }
+{ "tool": "agent_register", "project_id": "my-app", "agent_id": "db-worker", "role": "worker" }
+```
+
+### 3. マネージャーが共有知識を保存
+
+```json
+{
+  "tool": "memory_store",
+  "scope": "shared",
+  "agent_id": "lead",
+  "content": "TypeScript + Next.js で開発。ESLint strict モード必須。",
+  "tags": ["規約", "tech-stack"],
+  "project_id": "my-app"
+}
+```
+
+### 4. ワーカーが共有知識を参照 & 個人メモリに記録
+
+```json
+// 共有知識を検索
+{ "tool": "memory_recall", "scope": "shared", "query": "tech-stack", "caller_id": "web-worker", "project_id": "my-app" }
+
+// 個人メモリに作業記録を保存
+{
+  "tool": "memory_store",
+  "scope": "personal",
+  "agent_id": "web-worker",
+  "content": "Nginx リバースプロキシ設定完了。ポート 3000 → 80 に転送。",
+  "tags": ["nginx", "infra"],
+  "project_id": "my-app"
+}
+```
+
+---
+
+## スコープと権限
+
+| 操作 | Shared Scope | Personal Scope（自分） | Personal Scope（他人） |
+|------|:---:|:---:|:---:|
+| **Manager 読み取り** | ✅ | ✅ | ✅ |
+| **Manager 書き込み** | ✅ | ✅ | ❌ |
+| **Worker 読み取り** | ✅ | ✅ | ❌ |
+| **Worker 書き込み** | ❌ | ✅ | ❌ |
+| **削除** | Manager のみ | オーナー or Manager | Manager のみ |
+
+---
+
+## CLI コマンド
+
+```bash
+cc-memory setup    # DB 初期化
+cc-memory doctor   # 環境チェック
+cc-memory status   # プロジェクト・メモリの統計表示
+```
+
+---
+
+## 設定
+
+### 環境変数
+
+| 変数 | デフォルト | 説明 |
+|------|-----------|------|
+| `CC_MEMORY_DB` | `cc-memory.db` | SQLite データベースのパス |
+
+### Claude Code 設定
+
+```json
+{
+  "mcpServers": {
+    "cc-memory": {
+      "command": "cc-memory",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+---
+
+## FAQ
+
+**Q: データはどこに保存されますか？**
+A: ローカルの SQLite ファイル（デフォルト: `./cc-memory.db`）。クラウドには送信されません。
+
+**Q: メモリを全削除するには？**
+A: DB ファイルを削除して `cc-memory setup` を再実行してください。
+
+**Q: Claude Code 以外でも使えますか？**
+A: はい。MCP プロトコルに対応した任意のクライアントから利用できます。
+
+**Q: プロジェクトを指定しないとどうなりますか？**
+A: `"default"` プロジェクトが自動的に使用されます（初回起動時に作成済み）。
+
+---
+
+## v1 からの移行
+
+v1 のコードは [`v1` ブランチ](https://github.com/0xchoux1/cc-memory/tree/v1)で保全されています。
+
+### 主な変更点
+
+| | v1 | v2 |
+|---|---|---|
+| **メモリモデル** | 3 層（Working / Episodic / Semantic） | 2 スコープ（Shared / Personal） |
+| **アクセス制御** | チーム・API キーベース | Role-based（manager / worker） |
+| **API 数** | 20+ ツール | 8 ツール |
+| **同期** | Tachikoma / Git / Cloud | なし（ローカル完結） |
+| **設計思想** | 機能豊富 | シンプル・必要十分 |
+
+> ⚠️ v1 と v2 のデータベースには互換性がありません。v2 は新しい DB で始めてください。
+
+---
+
+## English
+
+### What is cc-memory?
+
+A memory server for multi-agent development that separates **shared knowledge** from **personal expertise** using scope-based access control.
+
+### Key Features
+
+- **Scope model** — `shared` (team-wide, manager-writable) and `personal` (agent-private)
+- **Role-based access** — `manager` reads/writes all; `worker` reads shared + own personal only
+- **MCP compatible** — works with Claude Code and any MCP client
+- **SQLite** — local storage, no cloud, privacy-first
+- **8 API endpoints** — simple and sufficient
+
+### Quick Start
+
+```bash
+npm install -g cc-memory
+cc-memory setup
+```
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "cc-memory": {
+      "command": "cc-memory",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+### API
+
+**Memory:** `memory_store`, `memory_recall`, `memory_list`, `memory_delete`
+**Projects:** `project_create`, `project_list`
+**Agents:** `agent_register`, `agent_list`
+
+### Scope & Permissions
+
+| Action | Shared | Own Personal | Other's Personal |
+|--------|:---:|:---:|:---:|
+| Manager read | ✅ | ✅ | ✅ |
+| Manager write | ✅ | ✅ | ❌ |
+| Worker read | ✅ | ✅ | ❌ |
+| Worker write | ❌ | ✅ | ❌ |
+
+### Migration from v1
+
+v1 is preserved on the [`v1` branch](https://github.com/0xchoux1/cc-memory/tree/v1). v2 databases are not compatible with v1 — start fresh.
+
+---
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,9 @@
+import type { Storage } from "./storage.js";
+import type { Scope, Role } from "./types.js";
+export declare class AuthError extends Error {
+    constructor(message: string);
+}
+export declare function checkStorePermission(storage: Storage, projectId: string, agentId: string, scope: Scope): void;
+export declare function checkReadPermission(storage: Storage, projectId: string, requestingAgentId: string, scope: Scope, targetAgentId?: string): void;
+export declare function getAgentRole(storage: Storage, projectId: string, agentId: string): Role | null;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE9C,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GACX,IAAI,CASN;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,KAAK,EACZ,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAeN;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,GAAG,IAAI,CAGb"}

package/dist/auth.js

@@ -0,0 +1,35 @@
+export class AuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AuthError";
+    }
+}
+export function checkStorePermission(storage, projectId, agentId, scope) {
+    const agent = storage.getAgent(projectId, agentId);
+    if (!agent) {
+        throw new AuthError(`Agent "${agentId}" is not registered in project "${projectId}"`);
+    }
+    if (scope === "shared" && agent.role !== "manager") {
+        throw new AuthError("Only managers can write to shared scope");
+    }
+}
+export function checkReadPermission(storage, projectId, requestingAgentId, scope, targetAgentId) {
+    const agent = storage.getAgent(projectId, requestingAgentId);
+    if (!agent) {
+        throw new AuthError(`Agent "${requestingAgentId}" is not registered in project "${projectId}"`);
+    }
+    // shared: everyone can read
+    if (scope === "shared")
+        return;
+    // personal: own data or manager
+    if (scope === "personal") {
+        if (targetAgentId && targetAgentId !== requestingAgentId && agent.role !== "manager") {
+            throw new AuthError("Workers can only read their own personal memories");
+        }
+    }
+}
+export function getAgentRole(storage, projectId, agentId) {
+    const agent = storage.getAgent(projectId, agentId);
+    return agent?.role ?? null;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,SAAiB,EACjB,OAAe,EACf,KAAY;IAEZ,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,SAAS,CAAC,UAAU,OAAO,mCAAmC,SAAS,GAAG,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACnD,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,SAAiB,EACjB,iBAAyB,EACzB,KAAY,EACZ,aAAsB;IAEtB,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,SAAS,CAAC,UAAU,iBAAiB,mCAAmC,SAAS,GAAG,CAAC,CAAC;IAClG,CAAC;IAED,4BAA4B;IAC5B,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO;IAE/B,gCAAgC;IAChC,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,IAAI,aAAa,IAAI,aAAa,KAAK,iBAAiB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACrF,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,SAAiB,EACjB,OAAe;IAEf,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,KAAK,EAAE,IAAI,IAAI,IAAI,CAAC;AAC7B,CAAC"}

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+// cc-memory v2 CLI - setup, doctor, status
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { Storage } from "./storage.js";
+const DB_PATH = process.env.CC_MEMORY_DB ?? "cc-memory.db";
+function setup() {
+    console.log("Setting up cc-memory v2...");
+    const storage = new Storage(DB_PATH);
+    storage.close();
+    console.log(`Database created at: ${resolve(DB_PATH)}`);
+    console.log("Setup complete.");
+}
+function doctor() {
+    console.log("cc-memory v2 doctor\n");
+    // Check Node version
+    const nodeVersion = process.version;
+    console.log(`Node.js: ${nodeVersion} ✅`);
+    // Check better-sqlite3
+    try {
+        require("better-sqlite3");
+        console.log("better-sqlite3: installed ✅");
+    }
+    catch {
+        console.log("better-sqlite3: missing ❌");
+    }
+    // Check DB
+    if (existsSync(resolve(DB_PATH))) {
+        console.log(`Database: ${resolve(DB_PATH)} ✅`);
+        try {
+            const storage = new Storage(DB_PATH);
+            const projects = storage.listProjects();
+            console.log(`  Projects: ${projects.length}`);
+            storage.close();
+        }
+        catch (err) {
+            console.log(`  Error reading DB: ${err}`);
+        }
+    }
+    else {
+        console.log(`Database: not found (run 'cc-memory setup')`);
+    }
+}
+function status() {
+    if (!existsSync(resolve(DB_PATH))) {
+        console.log("No database found. Run 'cc-memory setup' first.");
+        return;
+    }
+    const storage = new Storage(DB_PATH);
+    const projects = storage.listProjects();
+    console.log("cc-memory v2 status\n");
+    console.log(`Database: ${resolve(DB_PATH)}`);
+    console.log(`Projects: ${projects.length}`);
+    for (const project of projects) {
+        const agents = storage.listAgents(project.id);
+        const shared = storage.listMemories("shared", project.id);
+        const personal = storage.listMemories("personal", project.id);
+        console.log(`\n  [${project.id}] ${project.description ?? ""}`);
+        console.log(`    Agents: ${agents.length}`);
+        console.log(`    Shared memories: ${shared.length}`);
+        console.log(`    Personal memories: ${personal.length}`);
+    }
+    storage.close();
+}
+// Main
+const command = process.argv[2];
+switch (command) {
+    case "setup":
+        setup();
+        break;
+    case "doctor":
+        doctor();
+        break;
+    case "status":
+        status();
+        break;
+    default:
+        console.log("cc-memory v2 CLI");
+        console.log("Usage: cc-memory <command>");
+        console.log("Commands: setup, doctor, status");
+        process.exit(command ? 1 : 0);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,11 @@
+import type { Memory } from "./types.js";
+/**
+ * Score a memory against a query string.
+ * Returns 0 if no match, higher = better match.
+ */
+export declare function scoreMemory(memory: Memory, query: string): number;
+/**
+ * Filter and rank memories by query relevance.
+ */
+export declare function filterAndRank(memories: Memory[], query: string, limit: number): Memory[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBjE;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAOxF"}

package/dist/search.js

@@ -0,0 +1,40 @@
+// cc-memory v2 search - text-based search utilities
+// Currently delegates to Storage.searchMemories which does keyword matching.
+// This module exists as the extension point for future semantic search.
+/**
+ * Score a memory against a query string.
+ * Returns 0 if no match, higher = better match.
+ */
+export function scoreMemory(memory, query) {
+    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+    if (terms.length === 0)
+        return 0;
+    const text = (memory.content + " " + (memory.tags?.join(" ") ?? "")).toLowerCase();
+    let score = 0;
+    for (const term of terms) {
+        // Exact word boundary match scores higher
+        const regex = new RegExp(`\\b${escapeRegex(term)}\\b`, "i");
+        if (regex.test(text)) {
+            score += 2;
+        }
+        else if (text.includes(term)) {
+            score += 1;
+        }
+    }
+    return score;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Filter and rank memories by query relevance.
+ */
+export function filterAndRank(memories, query, limit) {
+    return memories
+        .map((m) => ({ memory: m, score: scoreMemory(m, query) }))
+        .filter((s) => s.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit)
+        .map((s) => s.memory);
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,6EAA6E;AAC7E,wEAAwE;AAIxE;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,KAAa;IACvD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACnF,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,0CAA0C;QAC1C,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5D,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB,EAAE,KAAa,EAAE,KAAa;IAC5E,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;SACzD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/dist/server.d.ts

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

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+// cc-memory v2 - MCP Server entry point
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { Storage } from "./storage.js";
+import { toolDefinitions, createToolHandler } from "./tools.js";
+const DB_PATH = process.env.CC_MEMORY_DB ?? "cc-memory.db";
+const storage = new Storage(DB_PATH);
+const handleTool = createToolHandler(storage);
+const server = new Server({ name: "cc-memory", version: "2.0.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: toolDefinitions,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const result = await handleTool(name, args ?? {});
+    return {
+        content: [{ type: "text", text: result }],
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("cc-memory v2 MCP server started");
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});
+// Cleanup on exit
+process.on("SIGINT", () => {
+    storage.close();
+    process.exit(0);
+});
+process.on("SIGTERM", () => {
+    storage.close();
+    process.exit(0);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,wCAAwC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,cAAc,CAAC;AAE3D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;AACrC,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAE9C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EACvC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE,eAAe;CACvB,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,kBAAkB;AAClB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,20 @@
+import type { Memory, Project, Agent, Scope, Role } from "./types.js";
+export declare class Storage {
+    private db;
+    constructor(dbPath?: string);
+    private migrateCreatedBy;
+    private ensureDefaultProject;
+    createProject(id: string, description: string): Project;
+    listProjects(): Project[];
+    getProject(id: string): Project | undefined;
+    registerAgent(projectId: string, agentId: string, role: Role): Agent;
+    listAgents(projectId: string): Agent[];
+    getAgent(projectId: string, agentId: string): Agent | undefined;
+    storeMemory(projectId: string, scope: Scope, agentId: string | null, content: string, tags: string[] | null, createdBy?: string | null): Memory;
+    listMemories(scope: Scope, projectId?: string, agentId?: string): Memory[];
+    searchMemories(query: string, scope: Scope | "all", projectId?: string, agentId?: string, limit?: number): Memory[];
+    getMemory(id: string): Memory | undefined;
+    deleteMemory(id: string): boolean;
+    close(): void;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAkCtE,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,GAAE,MAAuB;IAW3C,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,oBAAoB;IAS5B,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAQvD,YAAY,IAAI,OAAO,EAAE;IAIzB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAK3C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,KAAK;IAUpE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,EAAE;IAMtC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAO/D,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EACrB,SAAS,GAAE,MAAM,GAAG,IAAW,GAC9B,MAAM;IAYT,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAiB1E,cAAc,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,GAAG,KAAK,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,GAAE,MAAW,GACjB,MAAM,EAAE;IAoCX,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKzC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAKjC,KAAK,IAAI,IAAI;CAGd"}