@fragments-sdk/context 0.6.0 → 0.7.0

package/dist/{chunk-62K7BSAT.js → chunk-PIWQB6CK.js}

@@ -50,6 +50,11 @@ var MCP_TOOL_DEFINITIONS = [
         type: "string",
         enum: ["compact", "standard", "full"],
         description: 'Response detail level: "compact" (names only), "standard" (default), "full" (everything including code)'
+      },
+      depth: {
+        type: "string",
+        enum: ["quick", "full"],
+        description: 'Search depth for useCase mode. "quick" (default): component suggestions only. "full": also returns matching blocks with code, relevant CSS tokens, and import statements \u2014 everything needed to implement in one call.'
       }
     }
   },
@@ -135,26 +140,6 @@ var MCP_TOOL_DEFINITIONS = [
       }
     }
   },
-  {
-    key: "implement",
-    description: "One-shot implementation helper. Describe what you want to build and get everything needed in a single call: best-matching component(s) with full props and code examples, relevant composition blocks, and applicable CSS tokens. Saves multiple round-trips.",
-    params: {
-      useCase: {
-        type: "string",
-        description: 'What you want to implement (e.g., "login form", "data table with sorting", "streaming chat messages")'
-      },
-      limit: {
-        type: "number",
-        description: "Maximum number of components to return (default: 5)"
-      },
-      verbosity: {
-        type: "string",
-        enum: ["compact", "standard", "full"],
-        description: 'Response detail level: "compact" (names only), "standard" (default), "full" (all props + examples + full block code)'
-      }
-    },
-    required: ["useCase"]
-  },
   {
     key: "render",
     description: "Render a component and return a screenshot. Optionally compare against a Figma design ('figmaUrl'). Requires a running Fragments dev server (viewer URL). Use this to verify your implementation looks correct.",
@@ -243,11 +228,11 @@ var MCP_TOOL_DEFINITIONS = [
         description: "Max traversal depth for impact mode (default: 3)"
       }
     },
-    required: ["mode"]
+    required: []
   },
   {
     key: "perf",
-    description: "Query component performance data (bundle sizes, complexity tiers, budget status). Returns measured bundle sizes from fragments.json. Run `fragments perf` first to generate measurements.",
+    description: "Query component performance data (bundle sizes, complexity tiers, budget status). Returns measured bundle sizes when the active source provides performance data. Run `fragments perf` first to generate measurements for local fragments.json sources.",
     params: {
       component: {
         type: "string",
@@ -323,6 +308,73 @@ var MCP_TOOL_DEFINITIONS = [
       }
     },
     required: ["spec"]
+  },
+  {
+    key: "validate_and_fix",
+    description: "Validate a UI spec against governance policies and deterministically repair deprecated component usage when a safe canonical replacement exists. Returns the verdict, any applied replacements, and the fixed spec when successful.",
+    params: {
+      spec: {
+        type: "object",
+        description: "The UI spec to validate and repair. Format: { nodes: [{ id, type, props, children }], root?, metadata? }"
+      },
+      policy: {
+        type: "object",
+        description: "Optional policy overrides to merge with the base policy. Same shape as govern.config.ts rules."
+      },
+      applyFixes: {
+        type: "boolean",
+        description: "If true (default), applies deterministic repairs before re-validating the spec."
+      },
+      format: {
+        type: "string",
+        description: 'Output format: "json" (default) or "summary" (compact text)',
+        enum: ["json", "summary"]
+      }
+    },
+    required: ["spec"]
+  },
+  {
+    key: "findings_list",
+    description: "List governance findings for a project from Fragments Cloud. Returns violations detected by CI checks or repo scans. Requires a Cloud API key (FRAGMENTS_API_KEY). Filter by status, severity, category, ruleId, or file path.",
+    params: {
+      status: {
+        type: "string",
+        enum: ["open", "resolved", "ignored"],
+        description: 'Filter by finding status (default: "open")'
+      },
+      severity: {
+        type: "string",
+        enum: ["error", "warning", "info"],
+        description: "Filter by severity level"
+      },
+      category: {
+        type: "string",
+        description: 'Filter by violation category (e.g., "tokens/hardcoded-color")'
+      },
+      ruleId: {
+        type: "string",
+        description: "Filter by governance rule ID"
+      },
+      filePath: {
+        type: "string",
+        description: "Filter findings whose file path starts with this prefix"
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of findings to return (default: 50, max: 200)"
+      }
+    }
+  },
+  {
+    key: "findings_for_file",
+    description: "Get all open governance findings for a specific file from Fragments Cloud. Returns findings sorted by line number. Requires a Cloud API key (FRAGMENTS_API_KEY).",
+    params: {
+      filePath: {
+        type: "string",
+        description: "Exact file path to retrieve findings for"
+      }
+    },
+    required: ["filePath"]
   }
 ];
 var CLI_TOOL_EXTENSIONS = [
@@ -343,14 +395,14 @@ var CLI_TOOL_EXTENSIONS = [
   },
   {
     key: "fix",
-    description: "Generate patches to fix token compliance issues in a component. Returns unified diff patches that replace hardcoded CSS values with design token references. Use this after fragments_render identifies issues to automatically fix them.",
+    description: "Generate patches to fix token compliance issues in a component. Returns unified diff patches that replace hardcoded CSS values with design token references. Use this after the render tool identifies issues to automatically fix them.",
     params: {}
   }
 ];
 function buildToolNames(prefix) {
   const map = {};
   for (const def of MCP_TOOL_DEFINITIONS) {
-    map[def.key] = `${prefix}_${def.key}`;
+    map[def.key] = prefix ? `${prefix}_${def.key}` : def.key;
   }
   return map;
 }
@@ -382,7 +434,7 @@ function buildMcpTools(prefix, extensions) {
       properties[name] = prop;
     }
     return {
-      name: `${prefix}_${def.key}`,
+      name: prefix ? `${prefix}_${def.key}` : def.key,
       description: ext?.description ?? def.description,
       inputSchema: {
         type: "object",

package/dist/{chunk-XVZH4IVV.js → chunk-RQ46R2HQ.js}

@@ -84,6 +84,8 @@ var CLI_COMMANDS = [
       { flags: "--registry", description: "Also generate .fragments/registry.json and context.md" },
       { flags: "--registry-only", description: "Only generate .fragments/ directory (skip fragments.json)" },
       { flags: "--from-source", description: "Build from source code (zero-config, no fragment files needed)" },
+      { flags: "--if-needed", description: "Skip rebuilding when fragments.json is already fresh" },
+      { flags: "--check", description: "Check whether fragments.json is fresh and exit non-zero if it is stale" },
       { flags: "--skip-usage", description: "Skip usage analysis when building from source" },
       { flags: "--skip-storybook", description: "Skip Storybook parsing when building from source" },
       { flags: "-v, --verbose", description: "Verbose output" }

package/dist/cli-commands/index.js

@@ -1,7 +1,7 @@
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES
-} from "../chunk-XVZH4IVV.js";
+} from "../chunk-RQ46R2HQ.js";
 export {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES

package/dist/index.js

@@ -3,11 +3,11 @@ import {
   MCP_TOOL_DEFINITIONS,
   buildMcpTools,
   buildToolNames
-} from "./chunk-62K7BSAT.js";
+} from "./chunk-PIWQB6CK.js";
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES
-} from "./chunk-XVZH4IVV.js";
+} from "./chunk-RQ46R2HQ.js";
 import {
   chunkByAST,
   chunkByLines,

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

@@ -15,7 +15,7 @@ interface McpToolParam {
     properties?: Record<string, McpToolParam>;
 }
 interface McpToolDefinition {
-    /** Short key used to build the prefixed tool name, e.g. "discover" */
+    /** Short key used as the canonical tool name, e.g. "discover" */
     key: string;
     description: string;
     params: Record<string, McpToolParam>;
@@ -41,13 +41,14 @@ interface McpSdkTool {
     };
 }
 /**
- * Build a TOOL_NAMES map: `{ discover: "prefix_discover", ... }`
+ * Build a TOOL_NAMES map: `{ discover: "discover", ... }` by default.
+ * Pass a prefix only for embedding scenarios that intentionally namespace tools.
  */
-declare function buildToolNames(prefix: string): Record<string, string>;
+declare function buildToolNames(prefix?: string): Record<string, string>;
 /**
  * Build MCP SDK `Tool[]` from shared definitions, optionally merging CLI
- * extensions.
+ * extensions. Tool names are bare by default.
  */
-declare function buildMcpTools(prefix: string, extensions?: CliToolExtension[]): McpSdkTool[];
+declare function buildMcpTools(prefix?: string, extensions?: CliToolExtension[]): McpSdkTool[];
 
 export { CLI_TOOL_EXTENSIONS, type CliToolExtension, MCP_TOOL_DEFINITIONS, type McpToolDefinition, type McpToolParam, buildMcpTools, buildToolNames };

package/dist/mcp-tools/index.js

@@ -3,7 +3,7 @@ import {
   MCP_TOOL_DEFINITIONS,
   buildMcpTools,
   buildToolNames
-} from "../chunk-62K7BSAT.js";
+} from "../chunk-PIWQB6CK.js";
 export {
   CLI_TOOL_EXTENSIONS,
   MCP_TOOL_DEFINITIONS,

package/dist/types/index.d.ts

@@ -219,6 +219,10 @@ interface PerformanceSummary {
 interface CompiledFragmentsFile {
     version: string;
     generatedAt: string;
+    /** CLI version that produced this file, used for freshness checks */
+    generatorVersion?: string;
+    /** Relative source/config inputs used to build this file, used for freshness checks */
+    buildInputs?: string[];
     packageName?: string;
     fragments: Record<string, CompiledFragment>;
     blocks?: Record<string, CompiledBlock>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/context",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "FSL-1.1-MIT",
   "description": "Code intelligence and RAG primitives for design system and codebase indexing",
   "author": "Conan McNicholl",