promptgraph-mcp 2.8.1 → 2.8.3

package/package.json

@@ -1,61 +1,61 @@
-{
-  "name": "promptgraph-mcp",
-  "version": "2.8.1",
-  "files": [
-    "*.js",
-    "commands/",
-    "src/",
-    "README.md"
-  ],
-  "main": "index.js",
-  "type": "module",
-  "bin": {
-    "pg": "index.js",
-    "promptgraph": "index.js",
-    "promptgraph-mcp": "index.js"
-  },
-  "scripts": {
-    "start": "node index.js",
-    "init": "node index.js init",
-    "reindex": "node index.js reindex",
-    "test": "vitest run"
-  },
-  "keywords": [
-    "claude",
-    "claude-code",
-    "mcp",
-    "ai",
-    "skills",
-    "embeddings"
-  ],
-  "author": "NeiP4n",
-  "license": "MIT",
-  "description": "Semantic skill router for Claude Code — load only the skills you need, save 20k+ tokens per session",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/NeiP4n/promptgraph.git"
-  },
-  "homepage": "https://github.com/NeiP4n/promptgraph#readme",
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "better-sqlite3": "^12.10.0",
-    "boxen": "^8.0.1",
-    "chalk": "^5.6.2",
-    "chokidar": "^5.0.0",
-    "fastembed": "^2.1.0",
-    "glob": "^13.0.6",
-    "gray-matter": "^4.0.3",
-    "hnswlib-node": "^3.0.0",
-    "ora": "^9.4.0"
-  },
-  "devDependencies": {
-    "@vitest/coverage-v8": "^4.1.8",
-    "vitest": "^4.1.8"
-  },
-  "overrides": {
-    "tar": "^7.5.11"
-  }
-}
+{
+  "name": "promptgraph-mcp",
+  "version": "2.8.3",
+  "files": [
+    "*.js",
+    "commands/",
+    "src/",
+    "README.md"
+  ],
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "pg": "index.js",
+    "promptgraph": "index.js",
+    "promptgraph-mcp": "index.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "init": "node index.js init",
+    "reindex": "node index.js reindex",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "mcp",
+    "ai",
+    "skills",
+    "embeddings"
+  ],
+  "author": "NeiP4n",
+  "license": "MIT",
+  "description": "Semantic skill router for Claude Code — load only the skills you need, save 20k+ tokens per session",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NeiP4n/promptgraph.git"
+  },
+  "homepage": "https://github.com/NeiP4n/promptgraph#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.10.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "fastembed": "^2.1.0",
+    "glob": "^13.0.6",
+    "gray-matter": "^4.0.3",
+    "hnswlib-node": "^3.0.0",
+    "ora": "^9.4.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.8",
+    "vitest": "^4.1.8"
+  },
+  "overrides": {
+    "tar": "^7.5.11"
+  }
+}

package/parser.js

@@ -1,69 +1,69 @@
-import fs from 'fs';
-import path from 'path';
-import matter from 'gray-matter';
-import { hardFilter } from './src/filter/hard-filter.js';
-import { classify } from './src/filter/classifier.js';
-import { loadModel } from './src/filter/train.js';
-
-const SKILL_REF_RE = /(?<!https?:|ftp:)(?<![a-zA-Z0-9])\/([a-z0-9][a-z0-9-]{2,})/g;
-
-export function isSkillFile(filePath, raw) {
-  const result = hardFilter(filePath, raw);
-  if (!result.pass) return false;
-
-  try {
-    if (!raw) raw = fs.readFileSync(filePath, 'utf8');
-    const firstLines = raw.trimStart().slice(0, 300);
-    if (/^#\s*readme\b/i.test(firstLines)) return false;
-    if (/!\[.*\]\(https?:\/\/(img\.shields\.io|badge\.fury|travis-ci|github\.com\/[^)]+\/badge)/i.test(firstLines)) return false;
-
-    return true;
-  } catch {
-    return true;
-  }
-}
-
-export async function filterWithClassifier(skills) {
-  const centroids = loadModel();
-  if (!centroids) return skills;
-
-  const { embedBatch } = await import('./embedder.js');
-  const texts = skills.map(s => s.content || '');
-  const embeddings = await embedBatch(texts);
-
-  return skills.filter((_, i) => {
-    const decision = classify(embeddings[i], centroids, skills[i].content, skills[i].path);
-    return decision.label === 'skill' || decision.label === 'unsure';
-  });
-}
-
-export function parseSkillFile(filePath, source, opts = {}) {
-  const raw = opts.raw ?? fs.readFileSync(filePath, 'utf8');
-
-  let name, description, content;
-
-  try {
-    const { data, content: body } = matter(raw);
-    name = data.name;
-    description = data.description;
-    content = body;
-  } catch {
-    content = raw;
-  }
-
-  name = (name && String(name).trim()) || path.basename(filePath, '.md');
-  description = (description && String(description).trim()) || extractFirstParagraph(content || raw);
-
-  const calls = new Set();
-  for (const match of raw.matchAll(SKILL_REF_RE)) {
-    const ref = match[1];
-    if (ref !== name && ref.length > 2) calls.add(ref);
-  }
-
-  return { name, description, path: filePath, source, content: raw, calls: [...calls] };
-}
-
-function extractFirstParagraph(content) {
-  const lines = content.split('\n').filter(l => l.trim() && !l.startsWith('#') && !l.startsWith('---'));
-  return lines[0]?.trim().slice(0, 200) || '';
-}
+import fs from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+import { hardFilter } from './src/filter/hard-filter.js';
+import { classify } from './src/filter/classifier.js';
+import { loadModel } from './src/filter/train.js';
+
+const SKILL_REF_RE = /(?<!https?:|ftp:)(?<![a-zA-Z0-9])\/([a-z0-9][a-z0-9-]{2,})/g;
+
+export function isSkillFile(filePath, raw) {
+  const result = hardFilter(filePath, raw);
+  if (!result.pass) return false;
+
+  try {
+    if (!raw) raw = fs.readFileSync(filePath, 'utf8');
+    const firstLines = raw.trimStart().slice(0, 300);
+    if (/^#\s*readme\b/i.test(firstLines)) return false;
+    if (/!\[.*\]\(https?:\/\/(img\.shields\.io|badge\.fury|travis-ci|github\.com\/[^)]+\/badge)/i.test(firstLines)) return false;
+
+    return true;
+  } catch {
+    return true;
+  }
+}
+
+export async function filterWithClassifier(skills) {
+  const centroids = loadModel();
+  if (!centroids) return skills;
+
+  const { embedBatch } = await import('./embedder.js');
+  const texts = skills.map(s => s.content || '');
+  const embeddings = await embedBatch(texts);
+
+  return skills.filter((_, i) => {
+    const decision = classify(embeddings[i], centroids, skills[i].content, skills[i].path);
+    return decision.label === 'skill' || decision.label === 'unsure';
+  });
+}
+
+export function parseSkillFile(filePath, source, opts = {}) {
+  const raw = opts.raw ?? fs.readFileSync(filePath, 'utf8');
+
+  let name, description, content;
+
+  try {
+    const { data, content: body } = matter(raw);
+    name = data.name;
+    description = data.description;
+    content = body;
+  } catch {
+    content = raw;
+  }
+
+  name = (name && String(name).trim()) || path.basename(filePath, '.md');
+  description = (description && String(description).trim()) || extractFirstParagraph(content || raw);
+
+  const calls = new Set();
+  for (const match of raw.matchAll(SKILL_REF_RE)) {
+    const ref = match[1];
+    if (ref !== name && ref.length > 2) calls.add(ref);
+  }
+
+  return { name, description, path: filePath, source, content: raw, calls: [...calls] };
+}
+
+function extractFirstParagraph(content) {
+  const lines = content.split('\n').filter(l => l.trim() && !l.startsWith('#') && !l.startsWith('---'));
+  return lines[0]?.trim().slice(0, 200) || '';
+}

package/pg-hook.js

@@ -1,70 +1,70 @@
-#!/usr/bin/env node
-import { embed, cosineSimilarity } from './embedder.js';
-import { getDb, blobToVec } from './db.js';
-import { annSearch } from './ann.js';
-
-let input = '';
-process.stdin.on('data', d => input += d);
-process.stdin.on('end', async () => {
-  try {
-    const json = JSON.parse(input);
-    const prompt = json?.prompt || json?.user_prompt || '';
-    if (!prompt || prompt.length < 5) process.exit(0);
-
-    const queryVec = await embed(prompt);
-    const db = getDb();
-
-    // Use ANN index (fast). Fall back to brute-force only if ANN unavailable.
-    let topIds;
-    const annResults = await annSearch(queryVec, 15);
-
-    if (annResults && annResults.length > 0) {
-      const bestBySkill = new Map();
-      for (const r of annResults) {
-        const prev = bestBySkill.get(r.skill_id);
-        if (!prev || r.score > prev) bestBySkill.set(r.skill_id, r.score);
-      }
-      topIds = [...bestBySkill.entries()]
-        .sort((a, b) => b[1] - a[1])
-        .slice(0, 3)
-        .filter(([, score]) => score > 0.55);
-    } else {
-      // Fallback: brute-force (only before first reindex)
-      const chunks = db.prepare('SELECT skill_id, embedding FROM chunks').all();
-      const bestBySkill = new Map();
-      for (const chunk of chunks) {
-        const score = cosineSimilarity(queryVec, blobToVec(chunk.embedding));
-        const prev = bestBySkill.get(chunk.skill_id);
-        if (!prev || score > prev) bestBySkill.set(chunk.skill_id, score);
-      }
-      topIds = [...bestBySkill.entries()]
-        .sort((a, b) => b[1] - a[1])
-        .slice(0, 3)
-        .filter(([, score]) => score > 0.55);
-    }
-
-    if (topIds.length === 0) process.exit(0);
-
-    const results = topIds.map(([id, score]) => {
-      const skill = db.prepare('SELECT name, description, path FROM skills WHERE id = ?').get(id);
-      return skill ? { ...skill, score } : null;
-    }).filter(Boolean);
-
-    if (results.length === 0) process.exit(0);
-
-    const context = [
-      '## Relevant skills found by PromptGraph',
-      ...results.map(s => `- **${s.name}** (score: ${s.score.toFixed(2)}): ${s.description}\n  path: ${s.path}`),
-      '\nIf any skill matches the task — Read its file and follow its instructions.',
-    ].join('\n');
-
-    console.log(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'UserPromptSubmit',
-        additionalContext: context,
-      }
-    }));
-  } catch {
-    process.exit(0);
-  }
-});
+#!/usr/bin/env node
+import { embed, cosineSimilarity } from './embedder.js';
+import { getDb, blobToVec } from './db.js';
+import { annSearch } from './ann.js';
+
+let input = '';
+process.stdin.on('data', d => input += d);
+process.stdin.on('end', async () => {
+  try {
+    const json = JSON.parse(input);
+    const prompt = json?.prompt || json?.user_prompt || '';
+    if (!prompt || prompt.length < 5) process.exit(0);
+
+    const queryVec = await embed(prompt);
+    const db = getDb();
+
+    // Use ANN index (fast). Fall back to brute-force only if ANN unavailable.
+    let topIds;
+    const annResults = await annSearch(queryVec, 15);
+
+    if (annResults && annResults.length > 0) {
+      const bestBySkill = new Map();
+      for (const r of annResults) {
+        const prev = bestBySkill.get(r.skill_id);
+        if (!prev || r.score > prev) bestBySkill.set(r.skill_id, r.score);
+      }
+      topIds = [...bestBySkill.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 3)
+        .filter(([, score]) => score > 0.55);
+    } else {
+      // Fallback: brute-force (only before first reindex)
+      const chunks = db.prepare('SELECT skill_id, embedding FROM chunks').all();
+      const bestBySkill = new Map();
+      for (const chunk of chunks) {
+        const score = cosineSimilarity(queryVec, blobToVec(chunk.embedding));
+        const prev = bestBySkill.get(chunk.skill_id);
+        if (!prev || score > prev) bestBySkill.set(chunk.skill_id, score);
+      }
+      topIds = [...bestBySkill.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 3)
+        .filter(([, score]) => score > 0.55);
+    }
+
+    if (topIds.length === 0) process.exit(0);
+
+    const results = topIds.map(([id, score]) => {
+      const skill = db.prepare('SELECT name, description, path FROM skills WHERE id = ?').get(id);
+      return skill ? { ...skill, score } : null;
+    }).filter(Boolean);
+
+    if (results.length === 0) process.exit(0);
+
+    const context = [
+      '## Relevant skills found by PromptGraph',
+      ...results.map(s => `- **${s.name}** (score: ${s.score.toFixed(2)}): ${s.description}\n  path: ${s.path}`),
+      '\nIf any skill matches the task — Read its file and follow its instructions.',
+    ].join('\n');
+
+    console.log(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: 'UserPromptSubmit',
+        additionalContext: context,
+      }
+    }));
+  } catch {
+    process.exit(0);
+  }
+});

package/platform.js

@@ -1,120 +1,120 @@
-import os from 'os';
-import path from 'path';
-import fs from 'fs';
-import { spawnSync } from 'child_process';
-
-const HOME = os.homedir();
-
-const STD_ENTRY = { command: 'npx', args: ['promptgraph-mcp'] };
-const OC_ENTRY  = { type: 'local', command: ['npx', 'promptgraph-mcp'], enabled: true };
-
-// Shared helper: write standard mcpServers entry (Claude Code, Cursor, Windsurf, Codex format)
-function addStdMcp(configPath) {
-  const json = readJson(configPath) || {};
-  json.mcpServers = json.mcpServers || {};
-  json.mcpServers.promptgraph = STD_ENTRY;
-  fs.mkdirSync(path.dirname(configPath), { recursive: true });
-  writeJson(configPath, json);
-}
-
-// Cline uses servers.promptgraph (not mcpServers)
-function addClineMcp(configPath) {
-  const json = readJson(configPath) || {};
-  json.servers = json.servers || {};
-  json.servers.promptgraph = STD_ENTRY;
-  fs.mkdirSync(path.dirname(configPath), { recursive: true });
-  writeJson(configPath, json);
-}
-
-// OpenCode uses mcp.promptgraph with type/command/enabled
-function addOpenCodeMcp(configPath) {
-  const json = readJson(configPath) || {};
-  json.mcp = json.mcp || {};
-  json.mcp.promptgraph = OC_ENTRY;
-  fs.mkdirSync(path.dirname(configPath), { recursive: true });
-  writeJson(configPath, json);
-}
-
-export const PLATFORMS = {
-  'claude-code': {
-    name: 'Claude Code',
-    configPath: path.join(HOME, '.claude', 'settings.json'),
-    addMcp: (config) => addStdMcp(config.configPath),
-  },
-  'claude-desktop': {
-    name: 'Claude Desktop',
-    configPath: getClaudeDesktopConfig(),
-    addMcp: (config) => addStdMcp(config.configPath),
-  },
-  'cline': {
-    name: 'Cline (VS Code)',
-    configPath: path.join(HOME, '.vscode', 'mcp.json'),
-    addMcp: (config) => addClineMcp(config.configPath),
-  },
-  'codex': {
-    name: 'OpenAI Codex CLI',
-    configPath: path.join(HOME, '.codex', 'config.json'),
-    addMcp: (config) => addStdMcp(config.configPath),
-  },
-  'cursor': {
-    name: 'Cursor',
-    configPath: path.join(HOME, '.cursor', 'mcp.json'),
-    addMcp: (config) => addStdMcp(config.configPath),
-  },
-  'windsurf': {
-    name: 'Windsurf',
-    configPath: path.join(HOME, '.codeium', 'windsurf', 'mcp_config.json'),
-    addMcp: (config) => addStdMcp(config.configPath),
-  },
-  'opencode': {
-    name: 'OpenCode',
-    configPath: getOpenCodeConfig(),
-    addMcp: (config) => addOpenCodeMcp(config.configPath),
-  },
-};
-
-export function detectPlatforms() {
-  return Object.entries(PLATFORMS)
-    .filter(([id, p]) => {
-      if (!p.configPath) return false;
-      if (fs.existsSync(path.dirname(p.configPath))) return true;
-      if (id === 'opencode') return isOpenCodeInstalled();
-      return false;
-    })
-    .map(([id, p]) => ({ id, ...p }));
-}
-
-function isOpenCodeInstalled() {
-  try {
-    const r = spawnSync('opencode', ['--version'], { encoding: 'utf8', timeout: 3000 });
-    return r.status === 0;
-  } catch { return false; }
-}
-
-function getOpenCodeConfig() {
-  if (process.platform === 'win32') return path.join(HOME, 'AppData', 'Roaming', 'opencode', 'opencode.json');
-  if (process.platform === 'darwin') return path.join(HOME, 'Library', 'Application Support', 'opencode', 'opencode.json');
-  return path.join(HOME, '.config', 'opencode', 'opencode.json');
-}
-
-function getClaudeDesktopConfig() {
-  if (process.platform === 'win32') {
-    const base = process.env.LOCALAPPDATA || '';
-    const packages = path.join(base, 'Packages');
-    if (fs.existsSync(packages)) {
-      const claudeDir = fs.readdirSync(packages).find(d => d.startsWith('Claude_'));
-      if (claudeDir) return path.join(packages, claudeDir, 'LocalCache', 'Roaming', 'Claude', 'claude_desktop_config.json');
-    }
-  }
-  if (process.platform === 'darwin') return path.join(HOME, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
-  return path.join(HOME, '.config', 'Claude', 'claude_desktop_config.json');
-}
-
-function readJson(filePath) {
-  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); } catch { return {}; }
-}
-
-function writeJson(filePath, data) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
-}
+import os from 'os';
+import path from 'path';
+import fs from 'fs';
+import { spawnSync } from 'child_process';
+
+const HOME = os.homedir();
+
+const STD_ENTRY = { command: 'npx', args: ['promptgraph-mcp'] };
+const OC_ENTRY  = { type: 'local', command: ['npx', 'promptgraph-mcp'], enabled: true };
+
+// Shared helper: write standard mcpServers entry (Claude Code, Cursor, Windsurf, Codex format)
+function addStdMcp(configPath) {
+  const json = readJson(configPath) || {};
+  json.mcpServers = json.mcpServers || {};
+  json.mcpServers.promptgraph = STD_ENTRY;
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  writeJson(configPath, json);
+}
+
+// Cline uses servers.promptgraph (not mcpServers)
+function addClineMcp(configPath) {
+  const json = readJson(configPath) || {};
+  json.servers = json.servers || {};
+  json.servers.promptgraph = STD_ENTRY;
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  writeJson(configPath, json);
+}
+
+// OpenCode uses mcp.promptgraph with type/command/enabled
+function addOpenCodeMcp(configPath) {
+  const json = readJson(configPath) || {};
+  json.mcp = json.mcp || {};
+  json.mcp.promptgraph = OC_ENTRY;
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  writeJson(configPath, json);
+}
+
+export const PLATFORMS = {
+  'claude-code': {
+    name: 'Claude Code',
+    configPath: path.join(HOME, '.claude', 'settings.json'),
+    addMcp: (config) => addStdMcp(config.configPath),
+  },
+  'claude-desktop': {
+    name: 'Claude Desktop',
+    configPath: getClaudeDesktopConfig(),
+    addMcp: (config) => addStdMcp(config.configPath),
+  },
+  'cline': {
+    name: 'Cline (VS Code)',
+    configPath: path.join(HOME, '.vscode', 'mcp.json'),
+    addMcp: (config) => addClineMcp(config.configPath),
+  },
+  'codex': {
+    name: 'OpenAI Codex CLI',
+    configPath: path.join(HOME, '.codex', 'config.json'),
+    addMcp: (config) => addStdMcp(config.configPath),
+  },
+  'cursor': {
+    name: 'Cursor',
+    configPath: path.join(HOME, '.cursor', 'mcp.json'),
+    addMcp: (config) => addStdMcp(config.configPath),
+  },
+  'windsurf': {
+    name: 'Windsurf',
+    configPath: path.join(HOME, '.codeium', 'windsurf', 'mcp_config.json'),
+    addMcp: (config) => addStdMcp(config.configPath),
+  },
+  'opencode': {
+    name: 'OpenCode',
+    configPath: getOpenCodeConfig(),
+    addMcp: (config) => addOpenCodeMcp(config.configPath),
+  },
+};
+
+export function detectPlatforms() {
+  return Object.entries(PLATFORMS)
+    .filter(([id, p]) => {
+      if (!p.configPath) return false;
+      if (fs.existsSync(path.dirname(p.configPath))) return true;
+      if (id === 'opencode') return isOpenCodeInstalled();
+      return false;
+    })
+    .map(([id, p]) => ({ id, ...p }));
+}
+
+function isOpenCodeInstalled() {
+  try {
+    const r = spawnSync('opencode', ['--version'], { encoding: 'utf8', timeout: 3000 });
+    return r.status === 0;
+  } catch { return false; }
+}
+
+function getOpenCodeConfig() {
+  if (process.platform === 'win32') return path.join(HOME, 'AppData', 'Roaming', 'opencode', 'opencode.json');
+  if (process.platform === 'darwin') return path.join(HOME, 'Library', 'Application Support', 'opencode', 'opencode.json');
+  return path.join(HOME, '.config', 'opencode', 'opencode.json');
+}
+
+function getClaudeDesktopConfig() {
+  if (process.platform === 'win32') {
+    const base = process.env.LOCALAPPDATA || '';
+    const packages = path.join(base, 'Packages');
+    if (fs.existsSync(packages)) {
+      const claudeDir = fs.readdirSync(packages).find(d => d.startsWith('Claude_'));
+      if (claudeDir) return path.join(packages, claudeDir, 'LocalCache', 'Roaming', 'Claude', 'claude_desktop_config.json');
+    }
+  }
+  if (process.platform === 'darwin') return path.join(HOME, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+  return path.join(HOME, '.config', 'Claude', 'claude_desktop_config.json');
+}
+
+function readJson(filePath) {
+  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); } catch { return {}; }
+}
+
+function writeJson(filePath, data) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+}