forgecraft-mcp 0.2.0 → 0.2.1

package/dist/shared/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW;IACX,WAAW;IACX,YAAY;IACZ,KAAK;IACL,eAAe;IACf,IAAI;IACJ,YAAY;IACZ,SAAS;IACT,MAAM;IACN,UAAU;IACV,eAAe;IACf,MAAM;IACN,QAAQ;IACR,KAAK;IACL,SAAS;IACT,OAAO;IACP,QAAQ;IACR,WAAW;CACH,CAAC;AA4EX,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,CAAU,CAAC;AAElG,wEAAwE;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;CACC,CAAC;AAoBX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAA6C;IAC7E,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,aAAa;KAC3B;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,uBAAuB;QACjC,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,QAAQ;QACrB,eAAe,EAAE,IAAI;KACtB;IACD,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,yBAAyB;QACnC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,wBAAwB;QACjC,WAAW,EAAE,gBAAgB;KAC9B;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,UAAU;KACxB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,OAAO;KACrB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,OAAO;KACrB;CACF,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAiB,QAAQ,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,MAAoB;IACxE,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW;IACX,WAAW;IACX,YAAY;IACZ,KAAK;IACL,eAAe;IACf,IAAI;IACJ,YAAY;IACZ,SAAS;IACT,MAAM;IACN,UAAU;IACV,eAAe;IACf,MAAM;IACN,QAAQ;IACR,KAAK;IACL,SAAS;IACT,OAAO;IACP,QAAQ;IACR,WAAW;IACX,OAAO;IACP,MAAM;IACN,cAAc;IACd,oBAAoB;IACpB,wBAAwB;IACxB,YAAY;CACJ,CAAC;AA4EX,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,CAAU,CAAC;AAElG,wEAAwE;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;CACC,CAAC;AAoBX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAA6C;IAC7E,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,aAAa;KAC3B;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,uBAAuB;QACjC,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,QAAQ;QACrB,eAAe,EAAE,IAAI;KACtB;IACD,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,yBAAyB;QACnC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,wBAAwB;QACjC,WAAW,EAAE,gBAAgB;KAC9B;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,UAAU;KACxB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,OAAO;KACrB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,OAAO;KACrB;CACF,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAiB,QAAQ,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,MAAoB;IACxE,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC5C,CAAC"}

package/dist/tools/configure-mcp.d.ts

@@ -2,8 +2,11 @@
  * configure_mcp tool handler.
  *
  * Generates .claude/settings.json with recommended MCP servers based on tags.
+ * Uses the McpDiscoveryService to load curated servers from YAML templates
+ * and optionally fetch from a remote registry at setup time.
  */
 import { z } from "zod";
+import type { McpDiscoveryService } from "../registry/mcp-discovery.js";
 export declare const configureMcpSchema: z.ZodObject<{
     tags: z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">;
     project_dir: z.ZodString;
@@ -21,15 +24,19 @@ export declare const configureMcpSchema: z.ZodObject<{
         env?: Record<string, string> | undefined;
     }>>>;
     auto_approve_tools: z.ZodDefault<z.ZodBoolean>;
+    include_remote: z.ZodDefault<z.ZodBoolean>;
+    remote_registry_url: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     tags: string[];
     project_dir: string;
     auto_approve_tools: boolean;
+    include_remote: boolean;
     custom_servers?: Record<string, {
         command: string;
         args: string[];
         env?: Record<string, string> | undefined;
     }> | undefined;
+    remote_registry_url?: string | undefined;
 }, {
     tags: string[];
     project_dir: string;
@@ -39,7 +46,21 @@ export declare const configureMcpSchema: z.ZodObject<{
         env?: Record<string, string> | undefined;
     }> | undefined;
     auto_approve_tools?: boolean | undefined;
+    include_remote?: boolean | undefined;
+    remote_registry_url?: string | undefined;
 }>;
+/**
+ * Inject a custom discovery service (for testing).
+ *
+ * @param service - Discovery service to use, or undefined to reset to default
+ */
+export declare function setDiscoveryService(service: McpDiscoveryService | undefined): void;
+/**
+ * Generate .claude/settings.json with discovered MCP servers for active tags.
+ *
+ * @param args - Validated tool input
+ * @returns MCP tool response with configuration summary
+ */
 export declare function configureMcpHandler(args: z.infer<typeof configureMcpSchema>): Promise<{
     content: Array<{
         type: "text";

package/dist/tools/configure-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure-mcp.d.ts","sourceRoot":"","sources":["../../src/tools/configure-mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyB7B,CAAC;AAmBH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACvC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA4F7D"}
+{"version":3,"file":"configure-mcp.d.ts","sourceRoot":"","sources":["../../src/tools/configure-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAKxE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoC7B,CAAC;AAOH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAElF;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACvC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAmH7D"}

package/dist/tools/configure-mcp.js

@@ -2,11 +2,14 @@
  * configure_mcp tool handler.
  *
  * Generates .claude/settings.json with recommended MCP servers based on tags.
+ * Uses the McpDiscoveryService to load curated servers from YAML templates
+ * and optionally fetch from a remote registry at setup time.
  */
 import { z } from "zod";
 import { mkdirSync, writeFileSync, existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { ALL_TAGS } from "../shared/types.js";
+import { DefaultMcpDiscoveryService } from "../registry/mcp-discovery.js";
 // ── Schema ───────────────────────────────────────────────────────────
 export const configureMcpSchema = z.object({
     tags: z
@@ -29,36 +32,60 @@ export const configureMcpSchema = z.object({
         .default(true)
         .describe("If true, adds permissions.allow entries for all configured MCP servers " +
         "so tool invocations are auto-approved without manual confirmation."),
+    include_remote: z
+        .boolean()
+        .default(false)
+        .describe("If true, also queries a remote MCP server registry for additional recommendations. " +
+        "Requires FORGECRAFT_MCP_REGISTRY_URL env var or remote_registry_url parameter."),
+    remote_registry_url: z
+        .string()
+        .optional()
+        .describe("Override URL for the remote MCP server registry."),
 });
-// ── Recommended Servers per Tag ──────────────────────────────────────
-const TAG_SERVERS = {
-    UNIVERSAL: {
-        forgecraft: {
-            command: "npx",
-            args: ["-y", "forgecraft-mcp"],
-        },
-        codeseeker: {
-            command: "npx",
-            args: ["-y", "codeseeker"],
-        },
-    },
-};
 // ── Handler ──────────────────────────────────────────────────────────
+/** Injected discovery service for testing. Defaults to DefaultMcpDiscoveryService. */
+let injectedDiscoveryService;
+/**
+ * Inject a custom discovery service (for testing).
+ *
+ * @param service - Discovery service to use, or undefined to reset to default
+ */
+export function setDiscoveryService(service) {
+    injectedDiscoveryService = service;
+}
+/**
+ * Generate .claude/settings.json with discovered MCP servers for active tags.
+ *
+ * @param args - Validated tool input
+ * @returns MCP tool response with configuration summary
+ */
 export async function configureMcpHandler(args) {
     const tags = args.tags;
-    // Collect recommended servers
+    const discovery = injectedDiscoveryService ?? new DefaultMcpDiscoveryService();
+    // ── Discover servers ─────────────────────────────────────────────
+    const discoveryOptions = {
+        includeRemote: args.include_remote,
+        remoteRegistryUrl: args.remote_registry_url,
+    };
+    const recommendations = await discovery.discoverServers(tags, discoveryOptions);
+    // Convert recommendations to server config map
     const servers = {};
-    for (const tag of tags) {
-        const tagServers = TAG_SERVERS[tag];
-        if (tagServers) {
-            Object.assign(servers, tagServers);
-        }
+    for (const rec of recommendations) {
+        servers[rec.name] = {
+            command: rec.command,
+            args: rec.args,
+            ...(rec.env ? { env: rec.env } : {}),
+            source: rec.source,
+            description: rec.description,
+        };
     }
-    // Add custom servers
+    // Add custom servers (user-provided, highest priority)
     if (args.custom_servers) {
-        Object.assign(servers, args.custom_servers);
+        for (const [name, config] of Object.entries(args.custom_servers)) {
+            servers[name] = { ...config, source: "custom" };
+        }
     }
-    // Build settings.json
+    // ── Build settings.json ──────────────────────────────────────────
     const mcpConfig = {};
     for (const [name, config] of Object.entries(servers)) {
         mcpConfig[name] = {
@@ -78,7 +105,7 @@ export async function configureMcpHandler(args) {
     if (permissionRules.length > 0) {
         settings["permissions"] = { allow: permissionRules };
     }
-    // Handle existing settings
+    // ── Handle existing settings ─────────────────────────────────────
     const settingsDir = join(args.project_dir, ".claude");
     const settingsPath = join(settingsDir, "settings.json");
     let merged = settings;
@@ -107,14 +134,19 @@ export async function configureMcpHandler(args) {
     }
     mkdirSync(settingsDir, { recursive: true });
     writeFileSync(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+    // ── Build response ───────────────────────────────────────────────
     const serverNames = Object.keys(servers);
+    const bySource = groupBySource(servers);
     return {
         content: [
             {
                 type: "text",
                 text: `MCP configuration written to \`.claude/settings.json\`.\n\n` +
                     `**Servers configured (${serverNames.length}):**\n` +
-                    serverNames.map((n) => `- \`${n}\`: \`${servers[n].command} ${servers[n].args.join(" ")}\``).join("\n") +
+                    formatServerList(servers) +
+                    (bySource["remote"] && bySource["remote"] > 0
+                        ? `\n\n📡 ${bySource["remote"]} server(s) discovered from remote registry.`
+                        : "") +
                     (permissionRules.length > 0
                         ? `\n\n**Auto-approved (${permissionRules.length}):**\n` +
                             permissionRules.map((r) => `- \`${r}\``).join("\n")
@@ -124,4 +156,34 @@ export async function configureMcpHandler(args) {
         ],
     };
 }
+// ── Helpers ──────────────────────────────────────────────────────────
+/**
+ * Format the server list for display, grouped by source.
+ *
+ * @param servers - Server config map with source metadata
+ * @returns Markdown-formatted server list
+ */
+function formatServerList(servers) {
+    return Object.entries(servers)
+        .map(([name, config]) => {
+        const sourceLabel = config.source ? ` [${config.source}]` : "";
+        const descLabel = config.description ? ` — ${config.description}` : "";
+        return `- \`${name}\`${sourceLabel}: \`${config.command} ${config.args.join(" ")}\`${descLabel}`;
+    })
+        .join("\n");
+}
+/**
+ * Count servers by source.
+ *
+ * @param servers - Server config map with source metadata
+ * @returns Counts per source type
+ */
+function groupBySource(servers) {
+    const counts = {};
+    for (const config of Object.values(servers)) {
+        const source = config.source ?? "unknown";
+        counts[source] = (counts[source] ?? 0) + 1;
+    }
+    return counts;
+}
 //# sourceMappingURL=configure-mcp.js.map

package/dist/tools/configure-mcp.js.map

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

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;AAiFH;;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;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"}

package/dist/tools/list.js

@@ -88,6 +88,30 @@ const TAG_DESCRIPTIONS = {
         description: "Analytics/reporting — event tracking, dashboards, data warehousing.",
         appliesWhen: "Project includes analytics dashboards, reporting, or event tracking.",
     },
+    HIPAA: {
+        description: "HIPAA compliance — PII masking templates, encryption checks, audit logging.",
+        appliesWhen: "Project handles Protected Health Information requiring HIPAA compliance.",
+    },
+    SOC2: {
+        description: "SOC2 compliance — access control validation, change management, incident response.",
+        appliesWhen: "Project requires SOC2 audit readiness (Type I or Type II).",
+    },
+    "DATA-LINEAGE": {
+        description: "Data lineage — enforce 100% field coverage, lineage tracking decorators.",
+        appliesWhen: "Project processes data that requires full field-level lineage tracking.",
+    },
+    "OBSERVABILITY-XRAY": {
+        description: "AWS X-Ray observability — auto-add X-Ray instrumentation to Lambdas.",
+        appliesWhen: "Project runs on AWS Lambda and requires distributed tracing with X-Ray.",
+    },
+    "MEDALLION-ARCHITECTURE": {
+        description: "Medallion architecture — enforce Bronze=immutable, Silver=validated, Gold=aggregated.",
+        appliesWhen: "Project uses a lakehouse/medallion data architecture (Bronze/Silver/Gold).",
+    },
+    "ZERO-TRUST": {
+        description: "Zero-trust security — deny-by-default IAM, explicit allow rules.",
+        appliesWhen: "Project requires zero-trust network/IAM policies with deny-by-default.",
+    },
 };
 // ── Handlers ─────────────────────────────────────────────────────────
 /**

package/dist/tools/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,wEAAwE;AAExE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAA4C,CAAC,CAAC;SAC3D,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;CACtE,CAAC,CAAC;AAEH,wEAAwE;AAExE,MAAM,gBAAgB,GAA8D;IAClF,SAAS,EAAE;QACT,WAAW,EAAE,0FAA0F;QACvG,WAAW,EAAE,8CAA8C;KAC5D;IACD,WAAW,EAAE;QACX,WAAW,EAAE,wFAAwF;QACrG,WAAW,EAAE,uEAAuE;KACrF;IACD,YAAY,EAAE;QACZ,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE,4DAA4D;KAC1E;IACD,GAAG,EAAE;QACH,WAAW,EAAE,oFAAoF;QACjG,WAAW,EAAE,oFAAoF;KAClG;IACD,eAAe,EAAE;QACf,WAAW,EAAE,qEAAqE;QAClF,WAAW,EAAE,gFAAgF;KAC9F;IACD,EAAE,EAAE;QACF,WAAW,EAAE,4EAA4E;QACzF,WAAW,EAAE,0EAA0E;KACxF;IACD,UAAU,EAAE;QACV,WAAW,EAAE,qFAAqF;QAClG,WAAW,EAAE,qEAAqE;KACnF;IACD,OAAO,EAAE;QACP,WAAW,EAAE,mFAAmF;QAChG,WAAW,EAAE,6EAA6E;KAC3F;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,iFAAiF;QAC9F,WAAW,EAAE,+DAA+D;KAC7E;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE,sEAAsE;KACpF;IACD,eAAe,EAAE;QACf,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE,sEAAsE;KACpF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,gEAAgE;KAC9E;IACD,MAAM,EAAE;QACN,WAAW,EAAE,wEAAwE;QACrF,WAAW,EAAE,wEAAwE;KACtF;IACD,GAAG,EAAE;QACH,WAAW,EAAE,uEAAuE;QACpF,WAAW,EAAE,2DAA2D;KACzE;IACD,OAAO,EAAE;QACP,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE,2EAA2E;KACzF;IACD,KAAK,EAAE;QACL,WAAW,EAAE,yEAAyE;QACtF,WAAW,EAAE,qEAAqE;KACnF;IACD,MAAM,EAAE;QACN,WAAW,EAAE,0EAA0E;QACvF,WAAW,EAAE,kEAAkE;KAChF;IACD,SAAS,EAAE;QACT,WAAW,EAAE,qEAAqE;QAClF,WAAW,EAAE,sEAAsE;KACpF;CACF,CAAC;AAEF,wEAAwE;AAExE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IAGnC,MAAM,QAAQ,GAAc,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjD,GAAG;QACH,WAAW,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,WAAW;QAC9C,WAAW,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,WAAW;KAC/C,CAAC,CAAC,CAAC;IAEJ,MAAM,SAAS,GAAG,QAAQ;SACvB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,WAAW,uBAAuB,CAAC,CAAC,WAAW,EAAE,CAC1E;SACA,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,qBAAqB,QAAQ,CAAC,MAAM,QAAQ,SAAS,EAAE;aAC9D;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAqC;IAErC,MAAM,YAAY,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAE9C,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,YAAY,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QAED,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACtB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,GAAG,EAAE,WAAW,CAAC,GAAG;oBACpB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;iBACxB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wCAAwC,EAAE;aACjE;SACF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,KAAK;SACpB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,WAAW,eAAe,CAAC,CAAC,QAAQ,IAAI,CAC7F;SACA,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,sBAAsB,KAAK,CAAC,MAAM,QAAQ,SAAS,EAAE;aAC5D;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgecraft-mcp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "mcpName": "io.github.jghiringhelli/forgecraft",
   "description": "MCP server that gives Claude Code production-grade engineering standards — SOLID, testing, architecture, CI/CD — automatically tailored to your stack",
   "type": "module",
@@ -25,6 +25,11 @@
     "model-context-protocol",
     "claude",
     "claude-code",
+    "github-copilot",
+    "copilot",
+    "cursor",
+    "windsurf",
+    "ai-coding",
     "scaffolding",
     "project-setup",
     "developer-tools",
@@ -33,8 +38,7 @@
     "solid-principles",
     "testing",
     "architecture",
-    "claude-md",
-    "ai-coding"
+    "claude-md"
   ],
   "author": "JC",
   "license": "MIT",

package/templates/analytics/mcp-servers.yaml

@@ -0,0 +1,10 @@
+tag: ANALYTICS
+section: mcp-servers
+servers:
+  - name: chrome-devtools
+    description: "Chrome DevTools integration for debugging, profiling, and network inspection"
+    command: npx
+    args: ["-y", "@anthropic/chrome-devtools-mcp@latest"]
+    tags: [WEB-REACT, WEB-STATIC, ANALYTICS]
+    category: devtools
+    url: "https://github.com/anthropics/anthropic-quickstarts/tree/main/chrome-devtools-mcp"

package/templates/api/mcp-servers.yaml

@@ -0,0 +1,12 @@
+tag: API
+section: mcp-servers
+servers:
+  - name: postman
+    description: "API testing and collection management via Postman workspace"
+    command: npx
+    args: ["-y", "@anthropic/mcp-server-postman"]
+    tags: [API]
+    category: testing
+    url: "https://github.com/anthropics/anthropic-quickstarts/tree/main/mcp-server-postman"
+    env:
+      POSTMAN_API_KEY: ""

package/templates/cli/mcp-servers.yaml

@@ -0,0 +1,10 @@
+tag: CLI
+section: mcp-servers
+servers:
+  - name: filesystem
+    description: "Secure file operations — read, write, search, and directory management with configurable access controls"
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-filesystem", "/"]
+    tags: [CLI, LIBRARY]
+    category: general
+    url: "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem"

package/templates/data-lineage/instructions.yaml

@@ -0,0 +1,28 @@
+tag: DATA-LINEAGE
+section: instructions
+blocks:
+  - id: field-coverage
+    tier: recommended
+    title: "100% Field Coverage Enforcement"
+    content: |
+      ## 100% Field Coverage Enforcement
+
+      - Every data field must have a documented origin (source system, table, column) and destination (target system, table, column).
+      - Maintain a field-level lineage registry: no field enters production without a lineage entry. Enforce this in CI.
+      - Track field transformations explicitly: document every rename, type cast, aggregation, join, and filter applied to each field.
+      - Implement automated coverage checks: compare the lineage registry against actual schema definitions. Flag any untracked fields as errors.
+      - Version lineage metadata alongside code: lineage definitions live in the repository, not in external wikis or spreadsheets.
+      - Generate lineage reports per pipeline run: which fields were read, transformed, and written, with row counts and data quality metrics.
+
+  - id: lineage-tracking-decorators
+    tier: recommended
+    title: "Lineage Tracking Decorators & Annotations"
+    content: |
+      ## Lineage Tracking Decorators & Annotations
+
+      - Use decorators or annotations on transformation functions to declare input fields, output fields, and transformation type.
+      - Standardize lineage metadata format: source, transformation, destination, timestamp, pipeline_id, run_id.
+      - Emit lineage events at runtime: every transformation step publishes a lineage event to a centralized lineage store.
+      - Support both code-level lineage (decorators on functions) and config-level lineage (YAML/JSON transformation specs).
+      - Integrate lineage with data quality: when a quality check fails, trace back through lineage to identify the source of bad data.
+      - Visualize lineage graphs: generate dependency diagrams showing field-level flow from source to consumption.

package/templates/data-lineage/mcp-servers.yaml

@@ -0,0 +1,20 @@
+tag: DATA-LINEAGE
+section: mcp-servers
+servers:
+  - name: postgres
+    description: "PostgreSQL database inspection — query lineage metadata and schema definitions"
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-postgres"]
+    tags: [DATA-LINEAGE, DATA-PIPELINE]
+    category: database
+    env:
+      POSTGRES_CONNECTION_STRING: ""
+    url: "https://github.com/modelcontextprotocol/servers/tree/main/src/postgres"
+
+  - name: filesystem
+    description: "Filesystem access for lineage definition files and pipeline configurations"
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-filesystem"]
+    tags: [DATA-LINEAGE, UNIVERSAL]
+    category: filesystem
+    url: "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem"

package/templates/data-pipeline/mcp-servers.yaml

@@ -0,0 +1,12 @@
+tag: DATA-PIPELINE
+section: mcp-servers
+servers:
+  - name: postgres
+    description: "PostgreSQL database inspection, queries, and schema management"
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-postgres"]
+    tags: [DATA-PIPELINE, API]
+    category: database
+    env:
+      POSTGRES_CONNECTION_STRING: ""
+    url: "https://github.com/modelcontextprotocol/servers/tree/main/src/postgres"

package/templates/fintech/mcp-servers.yaml

@@ -0,0 +1,12 @@
+tag: FINTECH
+section: mcp-servers
+servers:
+  - name: stripe
+    description: "Stripe API integration — payments, subscriptions, invoices, and customer management"
+    command: npx
+    args: ["-y", "@stripe/mcp-server"]
+    tags: [FINTECH]
+    category: general
+    env:
+      STRIPE_SECRET_KEY: ""
+    url: "https://github.com/stripe/agent-toolkit"

package/templates/game/mcp-servers.yaml

@@ -0,0 +1,10 @@
+tag: GAME
+section: mcp-servers
+servers:
+  - name: unity-mcp
+    description: "Unity Editor integration — scene management, asset control, code generation"
+    command: npx
+    args: ["-y", "@anthropic/unity-mcp"]
+    tags: [GAME]
+    category: game-engine
+    url: "https://github.com/CoplayDev/unity-mcp"

package/templates/healthcare/mcp-servers.yaml

@@ -0,0 +1,12 @@
+tag: HEALTHCARE
+section: mcp-servers
+servers:
+  - name: postgres
+    description: "PostgreSQL database inspection, queries, and schema management — common backend for EHR/clinical data"
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-postgres"]
+    tags: [DATA-PIPELINE, API, HEALTHCARE]
+    category: database
+    env:
+      POSTGRES_CONNECTION_STRING: ""
+    url: "https://github.com/modelcontextprotocol/servers/tree/main/src/postgres"

package/templates/hipaa/instructions.yaml

@@ -0,0 +1,41 @@
+tag: HIPAA
+section: instructions
+blocks:
+  - id: pii-masking
+    tier: recommended
+    title: "PII Masking & Data Protection"
+    content: |
+      ## PII Masking & Data Protection
+
+      - Identify all Personally Identifiable Information (PII) fields at design time using the 18 HIPAA identifiers as a baseline.
+      - Implement masking templates for every PII field: full mask for display, partial mask for verification, tokenized for logging.
+      - Apply dynamic masking based on user role — clinicians see full data, billing sees partial, analytics sees only de-identified data.
+      - Never store raw PII in caches, message queues, or temporary files. Use tokenized references that resolve through a secure lookup service.
+      - Validate masking coverage with automated tests: no PII field should reach a log sink, error report, or analytics pipeline unmasked.
+      - Maintain a PII field registry as a living document — every new field must be classified before it enters the data model.
+
+  - id: encryption-checks
+    tier: recommended
+    title: "Encryption Verification & Key Management"
+    content: |
+      ## Encryption Verification & Key Management
+
+      - Enforce AES-256 encryption at rest for all data stores containing PII. Verify encryption status in CI with infrastructure-as-code checks.
+      - Require TLS 1.2+ for all data in transit. Reject connections using older protocols at the load balancer level.
+      - Use envelope encryption with a managed KMS (AWS KMS, Azure Key Vault, GCP KMS). Never store encryption keys alongside encrypted data.
+      - Rotate encryption keys on a defined schedule (90 days minimum). Automate rotation and re-encryption of affected data.
+      - Include encryption verification in deployment checklists: database encryption enabled, TLS certificates valid, KMS policies correct.
+      - Test encryption boundaries: verify that data crossing service boundaries remains encrypted and that decryption only occurs in authorized services.
+
+  - id: audit-logging-hipaa
+    tier: recommended
+    title: "HIPAA Audit Logging"
+    content: |
+      ## HIPAA Audit Logging
+
+      - Log every access to PII: who, when, what data, from where, and the business justification.
+      - Store audit logs in an append-only, tamper-evident store separate from application databases.
+      - Retain audit logs for a minimum of 6 years per HIPAA requirements.
+      - Generate automated audit reports: access frequency per user, unusual patterns, after-hours access.
+      - Implement real-time alerting for anomalous access: bulk record access, out-of-role access, VIP record access.
+      - Include a unique correlation ID in every request touching PII for end-to-end traceability across services.

package/templates/hipaa/mcp-servers.yaml

@@ -0,0 +1,12 @@
+tag: HIPAA
+section: mcp-servers
+servers:
+  - name: postgres
+    description: "PostgreSQL database inspection and schema management — common backend for PHI/PII storage"
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-postgres"]
+    tags: [HIPAA, HEALTHCARE, API]
+    category: database
+    env:
+      POSTGRES_CONNECTION_STRING: ""
+    url: "https://github.com/modelcontextprotocol/servers/tree/main/src/postgres"

package/templates/infra/mcp-servers.yaml

@@ -0,0 +1,18 @@
+tag: INFRA
+section: mcp-servers
+servers:
+  - name: docker
+    description: "Docker container and image management via MCP"
+    command: npx
+    args: ["-y", "mcp-server-docker"]
+    tags: [INFRA]
+    category: deployment
+    url: "https://github.com/ckreiling/mcp-server-docker"
+
+  - name: kubernetes
+    description: "Kubernetes cluster management — pods, deployments, services"
+    command: npx
+    args: ["-y", "mcp-server-kubernetes"]
+    tags: [INFRA]
+    category: deployment
+    url: "https://github.com/strowk/mcp-k8s-go"

package/templates/library/mcp-servers.yaml

@@ -0,0 +1,18 @@
+tag: LIBRARY
+section: mcp-servers
+servers:
+  - name: filesystem
+    description: "Secure file operations — read, write, search, and directory management with configurable access controls"
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-filesystem", "/"]
+    tags: [CLI, LIBRARY]
+    category: general
+    url: "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem"
+
+  - name: npm-search
+    description: "Search npm registry for packages, check versions, and inspect dependencies"
+    command: npx
+    args: ["-y", "mcp-server-npm-search"]
+    tags: [LIBRARY]
+    category: documentation
+    url: "https://github.com/nicholasgriffintn/npm-search-mcp-server"

package/templates/medallion-architecture/instructions.yaml

@@ -0,0 +1,41 @@
+tag: MEDALLION-ARCHITECTURE
+section: instructions
+blocks:
+  - id: bronze-layer
+    tier: recommended
+    title: "Bronze Layer — Immutable Raw Ingestion"
+    content: |
+      ## Bronze Layer — Immutable Raw Ingestion
+
+      - Bronze is the landing zone. Data arrives exactly as received from source systems — no transformations, no filtering, no deduplication.
+      - Store Bronze data in append-only, immutable formats (Parquet, Delta Lake, Iceberg). Never overwrite or delete Bronze records.
+      - Include ingestion metadata on every record: source_system, ingested_at, batch_id, file_origin, raw_checksum.
+      - Partition Bronze tables by ingestion date for efficient reprocessing. Never partition by business keys at this layer.
+      - Implement schema-on-read: Bronze accepts any schema from source. Schema validation happens at the Silver promotion step.
+      - Retain Bronze data indefinitely (or per legal retention policy). Bronze is the recovery point for all downstream reprocessing.
+
+  - id: silver-layer
+    tier: recommended
+    title: "Silver Layer — Validated & Conformed"
+    content: |
+      ## Silver Layer — Validated & Conformed
+
+      - Silver applies data quality rules: type validation, null checks, range constraints, referential integrity, deduplication.
+      - Every record in Silver must pass defined quality gates. Records failing validation are routed to a quarantine table, not dropped.
+      - Conform naming conventions: standardize column names, date formats, currency codes, and enum values across all Silver tables.
+      - Track record lineage: every Silver record links back to its Bronze source via source_record_id and bronze_batch_id.
+      - Apply slowly changing dimension (SCD) Type 2 for reference data: maintain history with effective_from and effective_to timestamps.
+      - Silver tables define explicit schemas enforced on write. Schema changes require a migration plan and backward compatibility check.
+
+  - id: gold-layer
+    tier: recommended
+    title: "Gold Layer — Aggregated & Business-Ready"
+    content: |
+      ## Gold Layer — Aggregated & Business-Ready
+
+      - Gold tables are purpose-built for specific business use cases: dashboards, ML features, API responses, reports.
+      - Apply business logic at the Gold layer: aggregations, joins, calculated fields, business rules, KPI definitions.
+      - Optimize Gold tables for read performance: pre-aggregate, denormalize, partition by access patterns.
+      - Document every Gold table with its business purpose, refresh cadence, source Silver tables, and SLA.
+      - Version Gold table definitions: changes to aggregation logic or business rules are tracked, reviewed, and deployed like code.
+      - Implement data contracts for Gold consumers: define expected schema, update frequency, and quality guarantees.