promptgraph-mcp 2.9.53 → 2.9.55

package/README.md

@@ -77,6 +77,7 @@ pg marketplace                  # Browse community skill bundles (TUI)
 # Install
 pg install <id>                 # Install a skill by marketplace ID (pg-xxxxxx)
 pg import <github-url>          # Import skills directly from a GitHub repo URL
+pg add-dir <path>               # Index skills from a local folder (any platform)
 
 # Bundles
 pg bundle install <id>          # Install a bundle by ID

package/commands/add-dir.js

@@ -0,0 +1,53 @@
+import { success, error, info } from '../cli.js';
+import chalk from 'chalk';
+import path from 'path';
+import fs from 'fs';
+
+// pg add-dir <path> [--source <name>]
+// Registers an arbitrary local folder as a skill source and indexes it.
+// Fills the gap for users whose skills live outside the default/platform dirs
+// (e.g. opencode users with a custom skills folder that reindex never scanned).
+export default async function handler(args, bin) {
+  const dirArg = args[1];
+  if (!dirArg || dirArg.startsWith('-')) {
+    error('Usage: pg add-dir <path-to-skills-folder> [--source <name>]');
+    process.exit(1);
+  }
+
+  const abs = path.resolve(dirArg);
+  if (!fs.existsSync(abs) || !fs.statSync(abs).isDirectory()) {
+    error(`Not a directory: ${abs}`);
+    process.exit(1);
+  }
+
+  const { globSync } = await import('glob');
+  const mdCount = globSync(`${abs}/**/*.md`, { absolute: true }).length;
+  if (mdCount === 0) {
+    error(`No .md files found under ${abs}`);
+    process.exit(1);
+  }
+
+  const { loadConfig, saveConfig } = await import('../config.js');
+  const config = loadConfig();
+  config.sources = config.sources || [];
+
+  const sourceIdx = args.indexOf('--source');
+  const sourceName = sourceIdx !== -1 && args[sourceIdx + 1]
+    ? `custom:${args[sourceIdx + 1]}`
+    : `custom:${path.basename(abs)}`;
+
+  const existing = config.sources.find(s => path.resolve(s.dir) === abs);
+  if (existing) {
+    info(`Already registered as source "${existing.source}" — re-indexing ${chalk.white.bold(mdCount)} files...`);
+  } else {
+    config.sources.push({ dir: abs, source: sourceName });
+    saveConfig(config);
+    success(`Added source "${sourceName}" → ${abs}`);
+    info(`Indexing ${chalk.white.bold(mdCount)} .md files...`);
+  }
+
+  const { indexSource } = await import('../indexer.js');
+  await indexSource(abs, existing ? existing.source : sourceName);
+  info(chalk.gray('Run `pg reindex` to enable semantic search across all sources.'));
+  process.exit(0);
+}

package/config.js

@@ -4,7 +4,13 @@ import os from 'os';
 
 const HOME = os.homedir();
 const CLAUDE_DIR = path.join(HOME, '.claude');
-export const PROMPTGRAPH_DIR = path.join(CLAUDE_DIR, '.promptgraph');
+
+// Data dir (config/db/index) is platform-neutral at ~/.promptgraph so non-Claude
+// users (opencode/cursor/…) don't get a stray ~/.claude folder. Existing Claude
+// installs keep using ~/.claude/.promptgraph so their index isn't orphaned.
+const LEGACY_PG_DIR = path.join(CLAUDE_DIR, '.promptgraph');
+const NEUTRAL_PG_DIR = path.join(HOME, '.promptgraph');
+export const PROMPTGRAPH_DIR = fs.existsSync(LEGACY_PG_DIR) ? LEGACY_PG_DIR : NEUTRAL_PG_DIR;
 const CONFIG_PATH = path.join(PROMPTGRAPH_DIR, 'config.json');
 
 export const PLATFORM_SKILLS_DIRS = {
@@ -32,17 +38,20 @@ export const RATE_LIMIT_REQUESTS = 30               // requests per window
 export const RATE_LIMIT_WINDOW_MS = 60000           // 1 minute window
 export const BATCH_SIZE = 100                       // batch indexing size
 
-function makeDefaults(skillsDir) {
+function makeDefaults(skillsDir, platform) {
   const base = skillsDir || path.join(CLAUDE_DIR, 'skills-store');
-  return {
-    skillsDir: base,
-    sources: [
-      { dir: base, source: 'skills-store' },
-      { dir: path.join(base, 'marketplace'), source: 'marketplace' },
-      { dir: path.join(CLAUDE_DIR, 'skills'),   source: 'skills' },
-      { dir: path.join(CLAUDE_DIR, 'commands'), source: 'commands' },
-    ],
-  };
+  const sources = [
+    { dir: base, source: 'skills-store' },
+    { dir: path.join(base, 'marketplace'), source: 'marketplace' },
+  ];
+  // Claude-specific dirs (~/.claude/skills, ~/.claude/commands) only on Claude
+  // platforms — otherwise an opencode/cursor user would index (and create) ~/.claude.
+  const isClaude = !platform || platform.startsWith('claude');
+  if (isClaude) {
+    sources.push({ dir: path.join(CLAUDE_DIR, 'skills'),   source: 'skills' });
+    sources.push({ dir: path.join(CLAUDE_DIR, 'commands'), source: 'commands' });
+  }
+  return { skillsDir: base, sources };
 }
 
 
@@ -67,7 +76,7 @@ export async function promptConfig() {
 export function setupForPlatform(platformId) {
   const skillsDir = PLATFORM_SKILLS_DIRS[platformId] || path.join(CLAUDE_DIR, 'skills-store');
   const existing = loadConfig();
-  const config = makeDefaults(skillsDir);
+  const config = makeDefaults(skillsDir, platformId);
   config.platform = platformId;
   // preserve any custom sources the user added
   if (existing.sources) {

package/index.js

@@ -18,7 +18,7 @@ const args = process.argv.slice(2);
 const rawBin = process.argv[1]?.split(/[\\/]/).pop()?.replace(/\.js$/, '');
 const bin = (rawBin && rawBin !== 'index') ? rawBin : 'pg';
 
-const KNOWN_COMMANDS = new Set(['reindex', 'update', 'import', 'install', 'setup', 'validate', 'marketplace', 'doctor', 'search', 'help', '--help', '-h', '--version', '-v', 'version', 'bundle', 'status', 'train']);
+const KNOWN_COMMANDS = new Set(['reindex', 'update', 'import', 'install', 'setup', 'validate', 'marketplace', 'doctor', 'search', 'help', '--help', '-h', '--version', '-v', 'version', 'bundle', 'status', 'train', 'add-dir']);
 
 function showHelp() {
   console.log(
@@ -33,6 +33,7 @@ function showHelp() {
     ['reindex',             'Re-index all skills'],
     ['search <query>',      'Search skills from the terminal'],
     ['import <owner/repo>', 'Import skills from GitHub'],
+    ['add-dir <path>',      'Index skills from a local folder (any platform)'],
     ['status',              'Show installed skills, repos, and bundles'],
     ['install <name>',      'Install a bundle by name, code, or id'],
     ['marketplace',         'Interactive TUI: browse + search + install skills & bundles'],
@@ -93,6 +94,7 @@ const COMMAND_MAP = {
   setup:     './commands/setup.js',
   update:    './commands/update.js',
   reindex:   './commands/reindex.js',
+  'add-dir': './commands/add-dir.js',
 }
 
 if (COMMAND_MAP[args[0]]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promptgraph-mcp",
-  "version": "2.9.53",
+  "version": "2.9.55",
   "files": [
     "*.js",
     "commands/",

package/parser.js

@@ -7,6 +7,12 @@ 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;
 
+// Generic filenames that carry no identity — name comes from the parent folder.
+const GENERIC_SKILL_FILENAMES = new Set([
+  'skill', 'skills', 'index', 'readme', 'agent', 'agents', 'main',
+  'prompt', 'prompts', 'instructions', 'instruction',
+]);
+
 export function isSkillFile(filePath, raw) {
   const result = hardFilter(filePath, raw);
   if (!result.pass) return false;
@@ -51,7 +57,16 @@ export function parseSkillFile(filePath, source, opts = {}) {
     content = raw;
   }
 
-  name = (name && String(name).trim()) || path.basename(filePath, '.md');
+  // Derive name when frontmatter lacks one. For the common "<skill-name>/SKILL.md"
+  // layout (anthropics/skills, google/skills, opencode, …) the filename is generic,
+  // so every skill would collapse to the same id ("skill") and overwrite each other.
+  // Use the parent folder name in that case.
+  let derived = path.basename(filePath, '.md');
+  if (GENERIC_SKILL_FILENAMES.has(derived.toLowerCase())) {
+    const parent = path.basename(path.dirname(filePath));
+    if (parent && parent !== '.') derived = parent;
+  }
+  name = (name && String(name).trim()) || derived;
   description = (description && String(description).trim()) || extractFirstParagraph(content || raw);
 
   const calls = new Set();