compend 0.0.0 → 1.0.0

package/index.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+import { Server } from '@modelcontextprotocol/sdk/server';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+
+import { initDb, indexConcepts, indexFile, deindexConcepts, searchHybrid, getConcept, listConcepts } from './db.js';
+import { getConfig } from './config.js';
+import http from 'node:http';
+
+const DASH_PORT = getConfig().port;
+
+function notifyDash(event, data) {
+  const body = JSON.stringify({ event, ...data });
+  const req = http.request(`http://127.0.0.1:${DASH_PORT}/api/notify`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) }
+  });
+  req.on('error', () => {});
+  req.write(body);
+  req.end();
+}
+
+const db = initDb();
+
+process.on('SIGTERM', () => { try { db.close(); } catch {} process.exit(0); });
+process.on('SIGINT', () => { try { db.close(); } catch {} process.exit(0); });
+
+const server = new Server(
+  { name: 'compend', version: '1.0.0' },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: 'compend_index',
+      description: 'Mirror the filesystem source of truth into the index. No args scans all configured paths. Pass { path } to index a single .md file or a directory (recursively).',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          path: { type: 'string', description: 'Optional. Absolute path to a .md file or directory to index.' }
+        },
+        required: []
+      }
+    },
+    {
+      name: 'compend_search',
+      description: 'Hybrid FTS + vector search across indexed concepts. Returns metadata with snippet and relevance score.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          query: { type: 'string', description: 'Search query text' },
+          type: { type: 'string', description: 'Optional. Filter by concept type (skill, agent, instruction, etc.)' },
+          tags: { type: 'array', items: { type: 'string' }, description: 'Optional. Filter by tags (AND match)' },
+          limit: { type: 'number', description: 'Max results (default 10)' },
+          alpha: { type: 'number', description: 'Vector weight 0-1, 0=only FTS, 1=only vector (default 0.3)' }
+        },
+        required: ['query']
+      }
+    },
+    {
+      name: 'compend_get',
+      description: 'Retrieve a full concept by slug, including frontmatter, body, references (children), and dependencies.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          slug: { type: 'string', description: 'Concept slug (e.g. "wp-image-to-blocks")' }
+        },
+        required: ['slug']
+      }
+    },
+    {
+      name: 'compend_list',
+      description: 'List concepts with optional filters. Returns compact metadata (no body).',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          type: { type: 'string', description: 'Optional. Filter by concept type' },
+          tags: { type: 'array', items: { type: 'string' }, description: 'Optional. Filter by tags (AND match)' },
+          status: { type: 'string', description: 'Optional. Filter by status (stable, draft, deprecated)' },
+          limit: { type: 'number', description: 'Max results (default 50)' },
+          offset: { type: 'number', description: 'Pagination offset (default 0)' }
+        },
+        required: []
+      }
+    },
+    {
+      name: 'compend_deindex',
+      description: 'Remove concepts from the index. Pass { slug } to remove one concept, or { path } to remove all concepts under a directory path. Files on disk are never touched.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          slug: { type: 'string', description: 'Concept slug to remove' },
+          path: { type: 'string', description: 'Directory or file path — all concepts whose file_path starts with this are removed' }
+        },
+        required: []
+      }
+    }
+  ]
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      case 'compend_index': {
+        let result;
+        if (args.path) {
+          result = indexFile(args.path);
+        } else {
+          result = indexConcepts();
+        }
+        notifyDash('index_complete', {
+          added: result.added.length,
+          updated: result.updated.length,
+          removed: result.removed.length,
+          total: result.total
+        });
+        return {
+          content: [{ type: 'text', text: JSON.stringify(result) }]
+        };
+      }
+
+      case 'compend_search': {
+        const results = searchHybrid(args);
+        return {
+          content: [{ type: 'text', text: JSON.stringify(results, null, 2) }]
+        };
+      }
+
+      case 'compend_get': {
+        const concept = getConcept(args.slug);
+        if (!concept) {
+          return {
+            content: [{ type: 'text', text: JSON.stringify({ error: 'Concept not found: ' + args.slug }) }],
+            isError: true
+          };
+        }
+        return {
+          content: [{ type: 'text', text: JSON.stringify(concept, null, 2) }]
+        };
+      }
+
+      case 'compend_list': {
+        const results = listConcepts(args);
+        return {
+          content: [{ type: 'text', text: JSON.stringify(results, null, 2) }]
+        };
+      }
+
+      case 'compend_deindex': {
+        const result = deindexConcepts(args);
+        notifyDash('index_complete', {
+          added: 0,
+          updated: 0,
+          removed: result.removed.length,
+          total: result.total
+        });
+        return {
+          content: [{ type: 'text', text: JSON.stringify(result) }]
+        };
+      }
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (err) {
+    const msg = err.message && err.message.includes('/') ? 'Internal error' : err.message;
+    return {
+      content: [{ type: 'text', text: `Error: ${msg}` }],
+      isError: true
+    };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/logo.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#000"><path d="M440-278v-394q-41-24-87-36t-93-12q-36 0-71.5 7T120-692v396q35-12 69.5-18t70.5-6q47 0 91.5 10.5T440-278Zm40 118q-48-38-104-59t-116-21q-42 0-82.5 11T100-198q-21 11-40.5-1T40-234v-482q0-11 5.5-21T62-752q46-24 96-36t102-12q74 0 126 17t112 52q11 6 16.5 14t5.5 21v418q44-21 88.5-31.5T700-320q36 0 70.5 6t69.5 18v-481q15 5 29.5 11t28.5 14q11 5 16.5 15t5.5 21v482q0 23-19.5 35t-40.5 1q-37-20-77.5-31T700-240q-60 0-116 21t-104 59Zm140-240v-440l120-40v440l-120 40Zm-340-99Z"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" height="48" viewBox="0 -960 960 960" width="48" fill="currentColor"><path d="M440-278v-394q-41-24-87-36t-93-12q-36 0-71.5 7T120-692v396q35-12 69.5-18t70.5-6q47 0 91.5 10.5T440-278Zm40 118q-48-38-104-59t-116-21q-42 0-82.5 11T100-198q-21 11-40.5-1T40-234v-482q0-11 5.5-21T62-752q46-24 96-36t102-12q74 0 126 17t112 52q11 6 16.5 14t5.5 21v418q44-21 88.5-31.5T700-320q36 0 70.5 6t69.5 18v-481q15 5 29.5 11t28.5 14q11 5 16.5 15t5.5 21v482q0 23-19.5 35t-40.5 1q-37-20-77.5-31T700-240q-60 0-116 21t-104 59Zm140-240v-440l120-40v440l-120 40Zm-340-99Z"/></svg>

package/package.json

@@ -1,11 +1,27 @@
 {
   "name": "compend",
-  "version": "0.0.0",
-  "description": "A reference engine for AI agents. Index your Markdown skills, prompts, and knowledge bases — serve them as just-in-time grounding with hybrid search and dynamic context.",
-  "license": "MIT",
-  "keywords": ["ai", "agent", "reference", "knowledge", "skills", "markdown", "okf"],
+  "version": "1.0.0",
+  "description": "A reference engine for AI agents. Index your Markdown skills with hybrid search and dynamic context.",
+  "author": "Hector Jarquin",
+  "type": "module",
+  "license": "GPL-3.0-only",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hectorjarquin/compend.git"
+  },
+  "main": "index.js",
+  "bin": {
+    "compend": "dashboard.js"
+  },
+  "scripts": {
+    "start": "node dashboard.js",
+    "stop": "node dashboard.js stop",
+    "restart": "node dashboard.js restart"
+  },
+  "keywords": ["ai", "agent", "reference", "knowledge", "skills", "markdown", "okf"],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^11.0.0",
+    "sqlite-vec": "^0.1.9"
   }
 }