forgecraft-mcp 0.2.1 → 0.4.0

package/dist/tools/forgecraft-router.js

@@ -0,0 +1,305 @@
+/**
+ * Unified forgecraft tool router.
+ *
+ * Consolidates 15 individual MCP tools into a single tool with an `action`
+ * discriminator. This dramatically reduces token overhead since MCP sends
+ * every tool schema with every request (~70% reduction from 16→2 tools).
+ *
+ * All business logic lives in the original handler files — this module
+ * is a thin dispatch layer that maps unified params to handler-specific args.
+ */
+import { z } from "zod";
+import { ALL_TAGS, CONTENT_TIERS, ALL_OUTPUT_TARGETS } from "../shared/types.js";
+// ── Handler imports ─────────────────────────────────────────────────
+import { listTagsHandler, listHooksHandler, listSkillsHandler } from "./list.js";
+import { classifyProjectHandler } from "./classify.js";
+import { scaffoldProjectHandler } from "./scaffold.js";
+import { generateInstructionsHandler } from "./generate-claude-md.js";
+import { auditProjectHandler } from "./audit.js";
+import { addHookHandler } from "./add-hook.js";
+import { addModuleHandler } from "./add-module.js";
+import { configureMcpHandler } from "./configure-mcp.js";
+import { getNfrTemplateHandler } from "./get-nfr.js";
+import { getDesignReferenceHandler } from "./get-reference.js";
+import { convertExistingHandler } from "./convert.js";
+import { reviewProjectHandler } from "./review.js";
+import { refreshProjectHandler } from "./refresh-project.js";
+// ── Constants ───────────────────────────────────────────────────────
+const ACTIONS = [
+    "refresh",
+    "scaffold",
+    "generate",
+    "audit",
+    "review",
+    "list",
+    "classify",
+    "add_hook",
+    "add_module",
+    "configure_mcp",
+    "get_reference",
+    "convert",
+];
+const LIST_RESOURCES = ["tags", "hooks", "skills"];
+const REFERENCE_RESOURCES = ["nfr", "design_patterns"];
+// ── Schema ──────────────────────────────────────────────────────────
+export const forgecraftSchema = z.object({
+    action: z
+        .enum(ACTIONS)
+        .describe("Operation to perform: refresh (re-sync project), scaffold (generate structure), " +
+        "generate (instruction files only), audit (check standards), review (code review checklist), " +
+        "list (discover tags/hooks/skills), classify (suggest tags), add_hook, add_module, " +
+        "configure_mcp, get_reference (design patterns/NFR), convert (migration plan)."),
+    project_dir: z
+        .string()
+        .optional()
+        .describe("Absolute path to the project root. Required for: refresh, scaffold, generate, audit, add_hook, add_module, configure_mcp, convert. Optional for: classify."),
+    tags: z
+        .array(z.enum(ALL_TAGS))
+        .optional()
+        .describe("Project classification tags. Used by: scaffold, generate, audit, review, add_module, configure_mcp, get_reference, convert, list (as filter)."),
+    project_name: z
+        .string()
+        .optional()
+        .describe("Human-readable project name. Used by: scaffold, generate."),
+    output_targets: z
+        .array(z.enum(ALL_OUTPUT_TARGETS))
+        .optional()
+        .describe("AI assistant targets (claude, cursor, copilot, windsurf, cline, aider). Used by: scaffold, generate, refresh."),
+    tier: z
+        .enum(CONTENT_TIERS)
+        .optional()
+        .describe("Content depth: core, recommended, optional. Used by: refresh."),
+    resource: z
+        .enum([...LIST_RESOURCES, ...REFERENCE_RESOURCES])
+        .optional()
+        .describe("Sub-resource for list (tags|hooks|skills) and get_reference (nfr|design_patterns)."),
+    name: z
+        .string()
+        .optional()
+        .describe("Item name. Used by: add_hook (hook name), add_module (module name)."),
+    language: z
+        .enum(["typescript", "python"])
+        .optional()
+        .describe("Programming language. Used by: scaffold, add_module. Default: typescript."),
+    description: z
+        .string()
+        .optional()
+        .describe("Natural language description. Used by: classify."),
+    dry_run: z
+        .boolean()
+        .optional()
+        .describe("Preview without writing files. Used by: scaffold."),
+    force: z
+        .boolean()
+        .optional()
+        .describe("Overwrite existing files. Used by: scaffold."),
+    apply: z
+        .boolean()
+        .optional()
+        .describe("Apply changes (vs preview). Used by: refresh. Default: false."),
+    merge: z
+        .boolean()
+        .optional()
+        .describe("Merge with existing instruction files. Used by: generate. Default: true."),
+    scope: z
+        .enum(["comprehensive", "focused"])
+        .optional()
+        .describe("Review scope. Used by: review. Default: comprehensive."),
+    scan_depth: z
+        .enum(["quick", "full"])
+        .optional()
+        .describe("Analysis depth. Used by: convert. Default: quick."),
+    tag: z
+        .enum(ALL_TAGS)
+        .optional()
+        .describe("Single tag filter. Used by: add_hook."),
+    add_tags: z
+        .array(z.enum(ALL_TAGS))
+        .optional()
+        .describe("Tags to add during refresh."),
+    remove_tags: z
+        .array(z.enum(ALL_TAGS))
+        .optional()
+        .describe("Tags to remove during refresh."),
+    include_anti_patterns: z
+        .boolean()
+        .optional()
+        .describe("Scan for anti-patterns. Used by: audit. Default: true."),
+    custom_servers: z
+        .record(z.object({
+        command: z.string(),
+        args: z.array(z.string()),
+        env: z.record(z.string()).optional(),
+    }))
+        .optional()
+        .describe("Custom MCP servers. Used by: configure_mcp."),
+    auto_approve_tools: z
+        .boolean()
+        .optional()
+        .describe("Auto-approve MCP tool calls. Used by: configure_mcp. Default: true."),
+    include_remote: z
+        .boolean()
+        .optional()
+        .describe("Query remote MCP registry. Used by: configure_mcp. Default: false."),
+    remote_registry_url: z
+        .string()
+        .optional()
+        .describe("Remote MCP registry URL override. Used by: configure_mcp."),
+    max_servers: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Max MCP servers to configure. Used by: configure_mcp."),
+});
+// ── Handler ─────────────────────────────────────────────────────────
+/**
+ * Unified handler that dispatches to the appropriate tool handler
+ * based on the `action` parameter.
+ *
+ * @param args - Validated unified tool input
+ * @returns MCP tool response from the delegated handler
+ */
+export async function forgecraftHandler(args) {
+    const action = args.action;
+    switch (action) {
+        case "list":
+            return dispatchList(args);
+        case "get_reference":
+            return dispatchGetReference(args);
+        case "classify":
+            return classifyProjectHandler({
+                project_dir: args.project_dir,
+                description: args.description,
+            });
+        case "refresh":
+            return refreshProjectHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "refresh"),
+                apply: args.apply ?? false,
+                tier: args.tier,
+                add_tags: args.add_tags,
+                remove_tags: args.remove_tags,
+                output_targets: args.output_targets,
+            });
+        case "scaffold":
+            return scaffoldProjectHandler({
+                tags: requireParam(args.tags, "tags", "scaffold"),
+                project_dir: requireParam(args.project_dir, "project_dir", "scaffold"),
+                project_name: args.project_name ?? "My Project",
+                language: args.language ?? "typescript",
+                dry_run: args.dry_run ?? false,
+                force: args.force ?? false,
+                output_targets: args.output_targets ?? ["claude"],
+            });
+        case "generate":
+            return generateInstructionsHandler({
+                tags: requireParam(args.tags, "tags", "generate"),
+                project_dir: args.project_dir,
+                project_name: args.project_name ?? "My Project",
+                output_targets: args.output_targets ?? ["claude"],
+                merge_with_existing: args.merge ?? true,
+            });
+        case "audit":
+            return auditProjectHandler({
+                tags: requireParam(args.tags, "tags", "audit"),
+                project_dir: requireParam(args.project_dir, "project_dir", "audit"),
+                include_anti_patterns: args.include_anti_patterns ?? true,
+            });
+        case "review":
+            return reviewProjectHandler({
+                tags: requireParam(args.tags, "tags", "review"),
+                scope: args.scope ?? "comprehensive",
+            });
+        case "add_hook":
+            return addHookHandler({
+                hook: requireParam(args.name, "name", "add_hook"),
+                project_dir: requireParam(args.project_dir, "project_dir", "add_hook"),
+                tag: args.tag,
+            });
+        case "add_module":
+            return addModuleHandler({
+                module_name: requireParam(args.name, "name", "add_module"),
+                project_dir: requireParam(args.project_dir, "project_dir", "add_module"),
+                tags: args.tags ?? ["UNIVERSAL"],
+                language: args.language ?? "typescript",
+            });
+        case "configure_mcp":
+            return configureMcpHandler({
+                tags: requireParam(args.tags, "tags", "configure_mcp"),
+                project_dir: requireParam(args.project_dir, "project_dir", "configure_mcp"),
+                custom_servers: args.custom_servers,
+                auto_approve_tools: args.auto_approve_tools ?? true,
+                include_remote: args.include_remote ?? false,
+                remote_registry_url: args.remote_registry_url,
+                max_servers: args.max_servers,
+            });
+        case "convert":
+            return convertExistingHandler({
+                tags: requireParam(args.tags, "tags", "convert"),
+                project_dir: requireParam(args.project_dir, "project_dir", "convert"),
+                scan_depth: args.scan_depth ?? "quick",
+            });
+        default:
+            return errorResult(`Unknown action: ${String(action)}. Valid actions: ${ACTIONS.join(", ")}`);
+    }
+}
+// ── Dispatch Helpers ────────────────────────────────────────────────
+/**
+ * Dispatch the `list` action based on the `resource` sub-parameter.
+ */
+async function dispatchList(args) {
+    const resource = args.resource ?? "tags";
+    switch (resource) {
+        case "tags":
+            return listTagsHandler();
+        case "hooks":
+            return listHooksHandler({ tags: args.tags });
+        case "skills":
+            return listSkillsHandler({ tags: args.tags });
+        default:
+            return errorResult(`Invalid resource '${resource}' for list action. Use: tags, hooks, or skills.`);
+    }
+}
+/**
+ * Dispatch the `get_reference` action based on the `resource` sub-parameter.
+ */
+async function dispatchGetReference(args) {
+    const resource = args.resource ?? "design_patterns";
+    const tags = requireParam(args.tags, "tags", "get_reference");
+    switch (resource) {
+        case "nfr":
+            return getNfrTemplateHandler({ tags });
+        case "design_patterns":
+            return getDesignReferenceHandler({ tags });
+        default:
+            return errorResult(`Invalid resource '${resource}' for get_reference action. Use: nfr or design_patterns.`);
+    }
+}
+// ── Utilities ───────────────────────────────────────────────────────
+/**
+ * Require a parameter that is mandatory for a given action.
+ * Throws with a clear error if missing.
+ *
+ * @param value - The parameter value (may be undefined)
+ * @param paramName - Parameter name for the error message
+ * @param action - Action name for context
+ * @returns The non-undefined value
+ */
+function requireParam(value, paramName, action) {
+    if (value === undefined || (Array.isArray(value) && value.length === 0)) {
+        throw new Error(`Missing required parameter '${paramName}' for action '${action}'.`);
+    }
+    return value;
+}
+/**
+ * Build an error result in MCP tool response format.
+ *
+ * @param message - Error description
+ * @returns MCP tool response with error text
+ */
+function errorResult(message) {
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+    };
+}
+//# sourceMappingURL=forgecraft-router.js.map

package/dist/tools/forgecraft-router.js.map

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

package/dist/tools/generate-claude-md.d.ts

@@ -3,6 +3,7 @@
  *
  * Generates instruction files for AI assistants (Claude, Cursor, Copilot, Windsurf, Cline, Aider).
  * Replaces the former generate_claude_md tool with multi-target support.
+ * Always merges with existing files by default to preserve user custom sections.
  */
 import { z } from "zod";
 export declare const generateInstructionsSchema: z.ZodObject<{

package/dist/tools/generate-claude-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-claude-md.d.ts","sourceRoot":"","sources":["../../src/tools/generate-claude-md.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAqBrC,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAA6B,CAAC;AAIjE,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,GAC/C,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAqE7D;AAED,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB,oCAA8B,CAAC"}
+{"version":3,"file":"generate-claude-md.d.ts","sourceRoot":"","sources":["../../src/tools/generate-claude-md.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAqBrC,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAA6B,CAAC;AAIjE,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,GAC/C,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAoE7D;AAED,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB,oCAA8B,CAAC"}

package/dist/tools/generate-claude-md.js

@@ -3,14 +3,18 @@
  *
  * Generates instruction files for AI assistants (Claude, Cursor, Copilot, Windsurf, Cline, Aider).
  * Replaces the former generate_claude_md tool with multi-target support.
+ * Always merges with existing files by default to preserve user custom sections.
  */
 import { z } from "zod";
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { writeFileSync, mkdirSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { ALL_TAGS, ALL_OUTPUT_TARGETS, OUTPUT_TARGET_CONFIGS, DEFAULT_OUTPUT_TARGET } from "../shared/types.js";
 import { loadAllTemplatesWithExtras, loadUserOverrides } from "../registry/loader.js";
 import { composeTemplates } from "../registry/composer.js";
 import { renderInstructionFile } from "../registry/renderer.js";
+import { writeInstructionFileWithMerge } from "../shared/filesystem.js";
+import { detectLanguage } from "../analyzers/language-detector.js";
+import { detectProjectContext } from "../analyzers/project-context.js";
 // ── Schema ───────────────────────────────────────────────────────────
 export const generateInstructionsSchema = z.object({
     tags: z
@@ -31,8 +35,8 @@ export const generateInstructionsSchema = z.object({
         .describe("AI assistant targets to generate for. Defaults to ['claude']. Options: claude, cursor, copilot, windsurf, cline, aider."),
     merge_with_existing: z
         .boolean()
-        .default(false)
-        .describe("If true, merge with existing instruction files instead of replacing."),
+        .default(true)
+        .describe("If true, merge with existing instruction files instead of replacing. Preserves custom sections added by the user. Default: true."),
 });
 /** @deprecated Use generateInstructionsSchema instead. */
 export const generateClaudeMdSchema = generateInstructionsSchema;
@@ -47,39 +51,38 @@ export async function generateInstructionsHandler(args) {
     const composed = composeTemplates(tags, templateSets, {
         config: userConfig ?? undefined,
     });
-    const context = {
-        projectName: args.project_name,
-        language: "typescript",
-        tags,
-    };
+    const detectedLang = args.project_dir ? detectLanguage(args.project_dir) : "typescript";
+    const context = args.project_dir
+        ? detectProjectContext(args.project_dir, args.project_name, detectedLang, tags)
+        : { projectName: args.project_name, language: detectedLang, tags };
     const filesWritten = [];
     const targetSummaries = [];
     for (const target of targets) {
         const targetConfig = OUTPUT_TARGET_CONFIGS[target];
-        let content = renderInstructionFile(composed.instructionBlocks, context, target);
-        // Handle merge with existing
-        if (args.merge_with_existing && args.project_dir) {
-            const existingPath = resolveTargetPath(args.project_dir, target);
-            if (existsSync(existingPath)) {
-                const existing = readFileSync(existingPath, "utf-8");
-                content = mergeInstructionFile(existing, content);
-            }
-        }
+        const content = renderInstructionFile(composed.instructionBlocks, context, target);
         // Write to disk if project_dir provided
         if (args.project_dir) {
             const targetPath = resolveTargetPath(args.project_dir, target);
-            mkdirSync(dirname(targetPath), { recursive: true });
-            writeFileSync(targetPath, content, "utf-8");
+            if (args.merge_with_existing) {
+                writeInstructionFileWithMerge(targetPath, content);
+            }
+            else {
+                mkdirSync(dirname(targetPath), { recursive: true });
+                writeFileSync(targetPath, content, "utf-8");
+            }
             filesWritten.push(targetPath);
             targetSummaries.push(`- **${targetConfig.displayName}**: \`${targetConfig.directory ? targetConfig.directory + "/" : ""}${targetConfig.filename}\``);
         }
     }
     if (args.project_dir && filesWritten.length > 0) {
+        const mergeNote = args.merge_with_existing
+            ? "\n\n> Custom sections from existing files have been preserved."
+            : "";
         return {
             content: [
                 {
                     type: "text",
-                    text: `# Instruction Files Generated\n\n**Tags:** ${tags.map((t) => `[${t}]`).join(" ")}\n**Blocks:** ${composed.instructionBlocks.length}\n\n## Files Written\n${targetSummaries.join("\n")}\n\n⚠️ Restart may be required to pick up changes.`,
+                    text: `# Instruction Files Generated\n\n**Tags:** ${tags.map((t) => `[${t}]`).join(" ")}\n**Blocks:** ${composed.instructionBlocks.length}\n\n## Files Written\n${targetSummaries.join("\n")}${mergeNote}\n\n⚠️ Restart may be required to pick up changes.`,
                 },
             ],
         };
@@ -107,41 +110,4 @@ function resolveTargetPath(projectDir, target) {
     }
     return join(projectDir, config.filename);
 }
-/**
- * Merge generated instruction file with existing one.
- * Keeps any custom sections from the existing file.
- */
-function mergeInstructionFile(existing, generated) {
-    const existingLines = existing.split("\n");
-    const generatedLines = generated.split("\n");
-    // Find custom sections (sections not in generated)
-    const generatedHeaders = new Set(generatedLines
-        .filter((l) => l.startsWith("## ") || l.startsWith("### "))
-        .map((l) => l.trim()));
-    const customSections = [];
-    let inCustomSection = false;
-    let currentSection = [];
-    for (const line of existingLines) {
-        if (line.startsWith("## ") || line.startsWith("### ")) {
-            if (inCustomSection && currentSection.length > 0) {
-                customSections.push(currentSection.join("\n"));
-            }
-            inCustomSection = !generatedHeaders.has(line.trim());
-            currentSection = inCustomSection ? [line] : [];
-        }
-        else if (inCustomSection) {
-            currentSection.push(line);
-        }
-    }
-    if (inCustomSection && currentSection.length > 0) {
-        customSections.push(currentSection.join("\n"));
-    }
-    // Append custom sections to generated content
-    if (customSections.length > 0) {
-        return (generated +
-            "\n\n<!-- Custom Sections (preserved from previous file) -->\n\n" +
-            customSections.join("\n\n"));
-    }
-    return generated;
-}
 //# sourceMappingURL=generate-claude-md.js.map

package/dist/tools/generate-claude-md.js.map

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

package/dist/tools/get-reference.d.ts

@@ -0,0 +1,28 @@
+/**
+ * get_design_reference tool handler.
+ *
+ * Returns design reference patterns (DDD, CQRS, GoF) on demand.
+ * These blocks are NOT included in generated instruction files to save tokens —
+ * they are served only when explicitly requested.
+ */
+import { z } from "zod";
+export declare const getDesignReferenceSchema: z.ZodObject<{
+    tags: z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    tags: string[];
+}, {
+    tags: string[];
+}>;
+/**
+ * Handle get_design_reference tool calls.
+ *
+ * @param args - Validated tool input with tags array
+ * @returns Design reference patterns as formatted markdown
+ */
+export declare function getDesignReferenceHandler(args: z.infer<typeof getDesignReferenceSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=get-reference.d.ts.map

package/dist/tools/get-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-reference.d.ts","sourceRoot":"","sources":["../../src/tools/get-reference.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,wBAAwB;;;;;;EAKnC,CAAC;AAIH;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,GAC7C,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAyC7D"}

package/dist/tools/get-reference.js

@@ -0,0 +1,63 @@
+/**
+ * get_design_reference tool handler.
+ *
+ * Returns design reference patterns (DDD, CQRS, GoF) on demand.
+ * These blocks are NOT included in generated instruction files to save tokens —
+ * they are served only when explicitly requested.
+ */
+import { z } from "zod";
+import { ALL_TAGS } from "../shared/types.js";
+import { loadAllTemplates } from "../registry/loader.js";
+import { composeTemplates } from "../registry/composer.js";
+import { renderReference } from "../registry/renderer.js";
+// ── Schema ───────────────────────────────────────────────────────────
+export const getDesignReferenceSchema = z.object({
+    tags: z
+        .array(z.enum(ALL_TAGS))
+        .min(1)
+        .describe("Tags to get design reference patterns for."),
+});
+// ── Handler ──────────────────────────────────────────────────────────
+/**
+ * Handle get_design_reference tool calls.
+ *
+ * @param args - Validated tool input with tags array
+ * @returns Design reference patterns as formatted markdown
+ */
+export async function getDesignReferenceHandler(args) {
+    const tags = args.tags.includes("UNIVERSAL")
+        ? args.tags
+        : ["UNIVERSAL", ...args.tags];
+    const templateSets = await loadAllTemplates();
+    const composed = composeTemplates(tags, templateSets);
+    if (composed.referenceBlocks.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No design reference patterns found for the specified tags.",
+                },
+            ],
+        };
+    }
+    const context = {
+        projectName: "Project",
+        language: "typescript",
+        tags,
+    };
+    const referenceContent = renderReference(composed.referenceBlocks, context);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `# Design Reference Patterns\n\n` +
+                    `**Tags:** ${tags.map((t) => `[${t}]`).join(" ")}\n` +
+                    `**Patterns:** ${composed.referenceBlocks.length}\n\n` +
+                    `> These patterns are served on demand to save tokens. ` +
+                    `They are NOT included in your instruction files.\n\n` +
+                    referenceContent,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-reference.js.map

package/dist/tools/get-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-reference.js","sourceRoot":"","sources":["../../src/tools/get-reference.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,wEAAwE;AAExE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAA4C,CAAC,CAAC;SAC3D,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC,CAAC;AAEH,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAA8C;IAE9C,MAAM,IAAI,GAAU,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QACjD,CAAC,CAAE,IAAI,CAAC,IAAc;QACtB,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAW,CAAC;IAE3C,MAAM,YAAY,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAEtD,IAAI,QAAQ,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,4DAA4D;iBACnE;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG;QACd,WAAW,EAAE,SAAS;QACtB,QAAQ,EAAE,YAAqB;QAC/B,IAAI;KACL,CAAC;IAEF,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAE5E,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EACF,iCAAiC;oBACjC,aAAa,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI;oBACpD,iBAAiB,QAAQ,CAAC,eAAe,CAAC,MAAM,MAAM;oBACtD,wDAAwD;oBACxD,sDAAsD;oBACtD,gBAAgB;aACnB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/list.d.ts

@@ -1,7 +1,7 @@
 /**
- * list_tags / list_hooks tool handlers.
+ * list_tags / list_hooks / list_skills tool handlers.
  *
- * Discovery tools for Claude Code to understand available tags and hooks.
+ * Discovery tools for Claude Code to understand available tags, hooks, and skills.
  */
 import { z } from "zod";
 export declare const listTagsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
@@ -12,6 +12,13 @@ export declare const listHooksSchema: z.ZodObject<{
 }, {
     tags?: string[] | undefined;
 }>;
+export declare const listSkillsSchema: z.ZodObject<{
+    tags: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    tags?: string[] | undefined;
+}, {
+    tags?: string[] | undefined;
+}>;
 /**
  * List all available tags with descriptions.
  */
@@ -30,4 +37,13 @@ export declare function listHooksHandler(args: z.infer<typeof listHooksSchema>):
         text: string;
     }>;
 }>;
+/**
+ * List all available skills (Claude Code custom commands), optionally filtered by tags.
+ */
+export declare function listSkillsHandler(args: z.infer<typeof listSkillsSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
 //# sourceMappingURL=list.d.ts.map

package/dist/tools/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,cAAc,gDAAe,CAAC;AAE3C,eAAO,MAAM,eAAe;;;;;;EAK1B,CAAC;AAyGH;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC,CAsBD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GACpC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA6C7D"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,cAAc,gDAAe,CAAC;AAE3C,eAAO,MAAM,eAAe;;;;;;EAK1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAK3B,CAAC;AAyGH;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC,CAsBD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GACpC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA6C7D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GACrC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA8C7D"}