@lyupro/skillforge-mcp 1.2.0 → 1.4.0

package/dist/watcher/config-watcher.js

@@ -0,0 +1,92 @@
+import { basename, dirname } from 'node:path';
+// The config CLI writes via temp+rename (atomic), so a direct file watch goes
+// dead after the first save. We watch the parent directory instead and filter
+// raw events down to the config file's basename. Hidden-file ignore patterns
+// must NOT be applied — config.json lives in a dotted dir (~/.lyupro/.skillforge).
+const CHOKIDAR_OPTS = {
+    ignoreInitial: true,
+    persistent: true,
+    awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
+    depth: 0,
+};
+async function loadDefaultChokidar() {
+    const mod = await import('chokidar');
+    return {
+        watch: (paths, options) => mod.watch(paths, options),
+    };
+}
+/**
+ * Watches a single config file for out-of-process edits (e.g. the
+ * `skillforge folders` CLI rewriting config.json). Debounced — a burst of
+ * raw filesystem events coalesces into one onChange call.
+ */
+export class ConfigWatcher {
+    #configPath;
+    #configDir;
+    #configBasename;
+    #onChange;
+    #debounceMs;
+    #setTimeoutFn;
+    #clearTimeoutFn;
+    #injectedChokidar;
+    #watcher = null;
+    #resolvedChokidar = null;
+    #pendingTimer = null;
+    constructor(opts) {
+        this.#configPath = opts.configPath;
+        this.#configDir = dirname(opts.configPath);
+        this.#configBasename = basename(opts.configPath);
+        this.#onChange = opts.onChange;
+        this.#debounceMs = opts.debounceMs ?? 400;
+        this.#injectedChokidar = opts.chokidar;
+        this.#setTimeoutFn = opts.setTimeoutFn ?? setTimeout;
+        this.#clearTimeoutFn = opts.clearTimeoutFn ?? clearTimeout;
+    }
+    isRunning() {
+        return this.#watcher !== null;
+    }
+    getConfigPath() {
+        return this.#configPath;
+    }
+    async start() {
+        if (this.#watcher !== null)
+            return;
+        const chokidar = this.#injectedChokidar ?? (await this.#getResolvedChokidar());
+        this.#watcher = chokidar.watch(this.#configDir, CHOKIDAR_OPTS);
+        this.#watcher.on('add', (path) => this.#handleRaw(path));
+        this.#watcher.on('change', (path) => this.#handleRaw(path));
+        this.#watcher.on('unlink', (path) => this.#handleRaw(path));
+        this.#watcher.on('error', (err) => {
+            console.error(`[skillforge:config-watcher] error: ${String(err)}`);
+        });
+    }
+    async stop() {
+        if (this.#watcher === null)
+            return;
+        if (this.#pendingTimer !== null) {
+            this.#clearTimeoutFn(this.#pendingTimer);
+            this.#pendingTimer = null;
+        }
+        await this.#watcher.close();
+        this.#watcher = null;
+    }
+    async #getResolvedChokidar() {
+        if (this.#resolvedChokidar === null) {
+            this.#resolvedChokidar = await loadDefaultChokidar();
+        }
+        return this.#resolvedChokidar;
+    }
+    #handleRaw(path) {
+        // Only react to the config file itself — the parent dir may hold siblings.
+        if (basename(path) !== this.#configBasename)
+            return;
+        if (this.#pendingTimer !== null) {
+            this.#clearTimeoutFn(this.#pendingTimer);
+        }
+        this.#pendingTimer = this.#setTimeoutFn(() => {
+            this.#pendingTimer = null;
+            void this.#onChange();
+        }, this.#debounceMs);
+    }
+}
+//# sourceMappingURL=config-watcher.js.map

package/dist/watcher/config-watcher.js.map

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

package/dist/watcher/index.d.ts

@@ -1,4 +1,6 @@
 export { FolderWatcher } from './folder-watcher.js';
 export type { FolderWatcherOptions, WatcherEvent, WatcherEventType } from './folder-watcher.js';
+export { ConfigWatcher } from './config-watcher.js';
+export type { ConfigWatcherOptions } from './config-watcher.js';
 export type { ChokidarLike, ChokidarWatcher, ChokidarOptions } from './chokidar-types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/watcher/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/watcher/index.js

@@ -1,2 +1,3 @@
 export { FolderWatcher } from './folder-watcher.js';
+export { ConfigWatcher } from './config-watcher.js';
 //# sourceMappingURL=index.js.map

package/dist/watcher/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/manifest.json

@@ -2,7 +2,7 @@
   "$schema": "https://modelcontextprotocol.io/schemas/manifest.json",
   "name": "@lyupro/skillforge-mcp",
   "displayName": "SkillForge MCP",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Universal Skills MCP server — load Markdown skills from arbitrary folders, lazy-by-design, cross-tool (Claude Code / Codex CLI / any MCP client).",
   "author": {
     "name": "Lyu Pro",
@@ -41,7 +41,7 @@
   "tools": [
     {
       "name": "skills__list",
-      "description": "Enumerate available skills (metadata only). Filters: folder, search, source."
+      "description": "Enumerate available skills (metadata only). Filters: folder, search, source, folderTag (keeps skills under folders carrying that tag)."
     },
     {
       "name": "skills__get",
@@ -53,7 +53,7 @@
     },
     {
       "name": "skills__configure",
-      "description": "Manage configured skill folders, blacklist, and reset to defaults. Actions: add_folder, remove_folder, list_folders, set_blacklist, get_blacklist, reset. Persists to the platform config path."
+      "description": "Manage configured skill folders, blacklist, and reset to defaults. Actions: add_folder (optionally with a kebab-case alias), remove_folder, list_folders, set_blacklist, get_blacklist, reset. Persists to the platform config path."
     },
     {
       "name": "skills__reload",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lyupro/skillforge-mcp",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Universal Skills MCP Server — load Markdown skills from arbitrary folders, lazy-by-design, cross-tool (Claude Code / Codex CLI / any MCP client).",
   "keywords": [
     "mcp",