@lyupro/skillforge-mcp 1.3.0 → 1.4.1

package/dist/cli/skills-shared.js

@@ -0,0 +1,90 @@
+/**
+ * Shared helpers for the `skills` subcommand modules.
+ *
+ * Holds pure parsing/lookup logic split out of `skills.ts` so the entry
+ * module stays small and the handler modules can reuse it.
+ */
+import { resolve } from 'node:path';
+import { findFolderEntry } from './folders-shared.js';
+/**
+ * Parse the flags accepted by `skills list`.
+ * Returns null on a malformed or unknown flag.
+ */
+export function parseListFlags(args) {
+    let search;
+    let source;
+    let folder;
+    let folderTag;
+    let folderFmt = 'alias';
+    let asJson = false;
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === '--json') {
+            asJson = true;
+        }
+        else if (arg === '--search') {
+            const value = args[i + 1];
+            if (value === undefined || value.startsWith('--'))
+                return null;
+            search = value;
+            i += 1;
+        }
+        else if (arg === '--source') {
+            const value = args[i + 1];
+            if (value === undefined || value.startsWith('--'))
+                return null;
+            source = value;
+            i += 1;
+        }
+        else if (arg === '--folder') {
+            const value = args[i + 1];
+            if (value === undefined || value.startsWith('--'))
+                return null;
+            folder = value;
+            i += 1;
+        }
+        else if (arg === '--folder-tag') {
+            const value = args[i + 1];
+            if (value === undefined || value.startsWith('--'))
+                return null;
+            folderTag = value;
+            i += 1;
+        }
+        else if (arg === '--folder-fmt') {
+            const value = args[i + 1];
+            if (value !== 'alias' && value !== 'path')
+                return null;
+            folderFmt = value;
+            i += 1;
+        }
+        else {
+            return null;
+        }
+    }
+    return { search, source, folder, folderTag, folderFmt, asJson };
+}
+/**
+ * Resolve a `--folder` token (alias or path) to the resolved folder path.
+ * Returns null if the token does not match any registered folder.
+ */
+export function resolveFolderArg(token, folders) {
+    const entry = findFolderEntry(folders, token);
+    if (entry === null)
+        return null;
+    return entry.path;
+}
+/**
+ * Build a map of folder path → display label.
+ * When an alias is set, the alias is used; otherwise the path itself.
+ */
+export function buildFolderAliasMap(folders, fmt) {
+    const map = new Map();
+    for (const f of folders) {
+        const label = fmt === 'alias' && f.alias !== undefined && f.alias.length > 0
+            ? f.alias
+            : f.path;
+        map.set(resolve(f.path), label);
+    }
+    return map;
+}
+//# sourceMappingURL=skills-shared.js.map

package/dist/cli/skills-shared.js.map

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

package/dist/cli/skills.d.ts

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+/**
+ * SkillForge `skills` subcommand.
+ *
+ * Terminal-side skill inspection and registry reload. Without this, skills
+ * could only be viewed from inside an LLM session via the `skills__list` or
+ * `skills__get` MCP tools. This subcommand exposes the same tool handlers to
+ * the shell — no separate registry logic.
+ *
+ * Note: the CLI reads config.json and skill files directly from disk. It
+ * reflects disk truth, NOT the state of any running MCP server session.
+ *
+ * Usage:
+ *   skillforge skills list [flags]       List skills from the registry
+ *   skillforge skills get <name> [flags] Print full content of one skill
+ *   skillforge skills reload             Force a registry rebuild from disk
+ *
+ * list flags:
+ *   --search <s>          Case-insensitive substring filter over name + description.
+ *   --source <format>     Filter by skill format: claude | codex | persona | custom.
+ *   --folder <path|alias> Restrict to one configured folder (alias or path).
+ *   --folder-tag <tag>    Restrict to folders with this tag in config.
+ *   --folder-fmt <fmt>    FOLDER column format: alias (default) or path.
+ *   --json                Emit raw JSON instead of a table.
+ *
+ * get flags:
+ *   --json                Emit raw JSON instead of human-readable output.
+ *
+ * This module keeps only the entry point + action dispatch; the handlers,
+ * table formatting, and shared parsing helpers live in sibling modules.
+ */
+import type { ServerDeps } from '../server-deps.js';
+export interface SkillsDeps {
+    stdout?: (text: string) => void;
+    stderr?: (text: string) => void;
+    /** Override the ServerDeps factory — tests inject a fake deps object here. */
+    buildDeps?: () => Promise<ServerDeps>;
+}
+/**
+ * `skills` subcommand entry. Returns an exit code:
+ *   - 0 on success
+ *   - 1 on a runtime failure (e.g. skill not found)
+ *   - 2 on a missing/unknown sub-action or malformed flag
+ */
+export declare function main(rawArgv: string[], deps?: SkillsDeps): Promise<number>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/cli/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/cli/skills.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOpD,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;CACvC;AA8BD;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA0CpF"}

package/dist/cli/skills.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+/**
+ * SkillForge `skills` subcommand.
+ *
+ * Terminal-side skill inspection and registry reload. Without this, skills
+ * could only be viewed from inside an LLM session via the `skills__list` or
+ * `skills__get` MCP tools. This subcommand exposes the same tool handlers to
+ * the shell — no separate registry logic.
+ *
+ * Note: the CLI reads config.json and skill files directly from disk. It
+ * reflects disk truth, NOT the state of any running MCP server session.
+ *
+ * Usage:
+ *   skillforge skills list [flags]       List skills from the registry
+ *   skillforge skills get <name> [flags] Print full content of one skill
+ *   skillforge skills reload             Force a registry rebuild from disk
+ *
+ * list flags:
+ *   --search <s>          Case-insensitive substring filter over name + description.
+ *   --source <format>     Filter by skill format: claude | codex | persona | custom.
+ *   --folder <path|alias> Restrict to one configured folder (alias or path).
+ *   --folder-tag <tag>    Restrict to folders with this tag in config.
+ *   --folder-fmt <fmt>    FOLDER column format: alias (default) or path.
+ *   --json                Emit raw JSON instead of a table.
+ *
+ * get flags:
+ *   --json                Emit raw JSON instead of human-readable output.
+ *
+ * This module keeps only the entry point + action dispatch; the handlers,
+ * table formatting, and shared parsing helpers live in sibling modules.
+ */
+import { handleSkillsList, handleSkillsGet, handleSkillsReload, } from './skills-handlers.js';
+const USAGE = `skillforge skills — view and reload skills from the terminal.
+
+Note: the CLI reads disk, not a live server session. Results reflect the
+current state of config.json and skill files on disk.
+
+Usage:
+  skillforge skills <action> [args]
+
+Actions:
+  list [flags]        Print a table of skills from the registry.
+                        Flags: --search <s>, --source <format>,
+                               --folder <path|alias>, --folder-tag <tag>,
+                               --folder-fmt alias|path (default alias), --json
+  get <name> [flags]  Print the full content of one skill.
+                        Flags: --json
+  reload              Force a registry rebuild + config reconcile from disk.
+                        Prints: N folders, M skills, and any per-file errors.
+
+Examples:
+  skillforge skills list
+  skillforge skills list --search review --json
+  skillforge skills list --folder work --folder-fmt path
+  skillforge skills list --source claude
+  skillforge skills get code-review
+  skillforge skills get code-review --json
+  skillforge skills reload
+`;
+/**
+ * `skills` subcommand entry. Returns an exit code:
+ *   - 0 on success
+ *   - 1 on a runtime failure (e.g. skill not found)
+ *   - 2 on a missing/unknown sub-action or malformed flag
+ */
+export async function main(rawArgv, deps = {}) {
+    const stdout = deps.stdout ?? ((text) => process.stdout.write(text));
+    const stderr = deps.stderr ?? ((text) => process.stderr.write(text));
+    const action = rawArgv[0];
+    const rest = rawArgv.slice(1);
+    if (action === undefined || (action !== 'list' && action !== 'get' && action !== 'reload')) {
+        if (action !== undefined) {
+            stderr(`skillforge skills: unknown action: ${action}\n\n`);
+        }
+        stderr(USAGE);
+        return 2;
+    }
+    let serverDeps;
+    try {
+        const factory = deps.buildDeps ?? (async () => {
+            const { buildDeps } = await import('../server.js');
+            return buildDeps();
+        });
+        serverDeps = await factory();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        stderr(`skillforge skills: failed to initialise registry: ${msg}\n`);
+        return 1;
+    }
+    try {
+        switch (action) {
+            case 'list':
+                return await handleSkillsList(serverDeps, rest, stdout, stderr);
+            case 'get':
+                return await handleSkillsGet(serverDeps, rest, stdout, stderr);
+            case 'reload':
+                return await handleSkillsReload(serverDeps, rest, stdout, stderr);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        stderr(`skillforge skills: ${msg}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/cli/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/cli/skills.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAS9B,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bb,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAiB,EAAE,OAAmB,EAAE;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7E,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE9B,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC3F,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,CAAC,sCAAsC,MAAM,MAAM,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,CAAC;QACd,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,UAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,IAAI,EAAE;YAC5C,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;YACnD,OAAO,SAAS,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,UAAU,GAAG,MAAM,OAAO,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,CAAC,qDAAqD,GAAG,IAAI,CAAC,CAAC;QACrE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,MAAM,gBAAgB,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAClE,KAAK,KAAK;gBACR,OAAO,MAAM,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACjE,KAAK,QAAQ;gBACX,OAAO,MAAM,kBAAkB,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}