@fragments-sdk/context 0.6.0 → 0.6.1

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

@@ -247,7 +247,7 @@ var MCP_TOOL_DEFINITIONS = [
   },
   {
     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",
@@ -343,14 +343,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 +382,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-3IBKSLZY.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-3IBKSLZY.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.6.1",
   "license": "FSL-1.1-MIT",
   "description": "Code intelligence and RAG primitives for design system and codebase indexing",
   "author": "Conan McNicholl",