# Install globally or use via npx
npm install -g memory-worth-mcp

# Or run directly (auto-installs)
npx memory-worth-mcp

{
  "memory-worth": {
    "command": "npx",
    "args": ["-y", "memory-worth-mcp"],
    "env": {
      "MEMORY_WORTH_PROJECT": "your-project-name"
    }
  }
}

active → (archive) → archived
active → (supersede) → superseded → (merge) → new active

%%{init: {'theme': 'dark'}}%%
flowchart TD
    A[Session Start] --> B[memory_wakeup]
    B --> C{Task Type}
    C -->|New Feature| D[memory_write<br/>design decisions]
    C -->|Bug Fix| E[memory_write<br/>bug + fix pair]
    C -->|Optimization| F[memory_write<br/>proposal]
    D --> G[memory_search<br/>prior art]
    E --> G
    F --> G
    G --> H[memory_synthesize<br/>cross-session insights]
    H --> I[memory_tune<br/>adjust thresholds]
    I --> J[memory_merge<br/>consolidate related]
    J --> K[memory_stats<br/>review health]

// Returns high-trust memories, recent activity, items needing review, protocol reminder
await mcp.callTool("memory_wakeup", {
  project: "my-project",
  sessionId: "abc-123"
});

await mcp.callTool("memory_write", {
  project: "my-project",
  content: "Use requestAnimationFrame + accumulator for fixed timestep. Replaces setInterval(100ms).",
  appliesWhen: "Refactoring game loop in src/game-loop.ts:45",
  tags: ["architecture", "rendering", "performance"],
  sessionId: "abc-123"
});

// Bug
const bug = await mcp.callTool("memory_write", {
  project: "my-project",
  content: "Self-collision on rapid direction reversal. Root cause: collision check after unshift.",
  appliesWhen: "Fixing collision in src/snake.ts:180",
  tags: ["bug", "collision", "critical"]
});

// Fix
const fix = await mcp.callTool("memory_write", {
  project: "my-project",
  content: "Prevent 180° reversal in input handler. Check: if (newDx === -dx && newDy === -dy) return;",
  appliesWhen: "Applying fix to src/snake.ts:210",
  tags: ["fix", "collision", "resolved"]
});

// Calibrate: mark fix as successful
await mcp.callTool("memory_update", {
  id: fix.id,
  trustScore: 0.9  // Becomes "high" trust
});

await mcp.callTool("memory_search", {
  query: "collision",
  scope: "project",
  project: "my-project",
  minTrust: 0.7,      // Only high-trust
  tags: ["resolved"],
  limit: 10
});

await mcp.callTool("memory_synthesize", {
  memoryIds: ["id1", "id2", "id3"],
  project: "my-project",
  question: "What are all known collision issues and their fixes?"
});

# Clone
git clone https://github.com/simwai/memory-worth-mcp.git
cd memory-worth-mcp

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Run server locally
npm run dev

# Dry-run release
npm run release:dry:patch

%%{init: {'theme': 'dark'}}%%
flowchart TD
    subgraph Server["MCP Server (stdio)"]
        T[Tools Registry] --> S[memory_search]
        T --> W[memory_write]
        T --> G[memory_get]
        T --> U[memory_update]
        T --> D[memory_delete]
        T --> Y[memory_synthesize]
        T --> K[memory_wakeup]
        T --> A[memory_stats]
        T --> N[memory_tune]
        T --> V[memory_invalidate]
        T --> M[memory_merge]
        T --> P[memory_set_status]
        T --> L[memory_list_tools]
    end

    DB[(SQLite WAL)]
    T --> DB

    subgraph Trust["Trust Engine"]
        WS[Wilson Score] --> Q[Quantiles]
        Q --> LBL[Labels: high/unproven/low]
    end

    subgraph Routing["Routing"]
        AS[Auto Scope] --> PR[Project + Global]
        AS --> GR[Global Only]
        AS --> AL[All Projects]
    end

    S --> Trust
    W --> Routing

memory-worth-mcp/
├── package.json
├── tsconfig.json
├── .gitignore
├── README.md
├── LICENSE
├── scripts/
│   └── release.js
├── src/
│   ├── mcp-server.ts          # McpServer with 13 registerTool calls
│   ├── db/
│   │   └── index.ts           # SQLite schema + initialization
│   ├── trust/
│   │   └── index.ts           # Wilson score, calibration, quantiles
│   ├── routing/
│   │   └── index.ts           # Scope resolution, write detection
│   ├── tools/
│   │   ├── index.ts           # Tool registry
│   │   ├── memory-search.ts
│   │   ├── memory-get.ts
│   │   ├── memory-write.ts
│   │   ├── memory-update.ts
│   │   ├── memory-delete.ts
│   │   ├── memory-synthesize.ts
│   │   ├── memory-wakeup.ts
│   │   ├── memory-stats.ts
│   │   ├── memory-tune.ts
│   │   ├── memory-invalidate.ts
│   │   ├── memory-merge.ts
│   │   ├── memory-set-status.ts
│   │   └── memory-list-tools.ts
│   ├── types/
│   │   └── index.ts           # TypeScript interfaces
│   └── utils/
│       └── paths.ts           # DB path resolution
└── tests/
    └── core.test.ts           # 15 tests (trust + routing)