@fragments-sdk/context 0.5.1 → 0.6.1

package/dist/{chunk-27BMCKU6.js → chunk-3IBKSLZY.js}

@@ -32,7 +32,7 @@ var MCP_TOOL_DEFINITIONS = [
       },
       compact: {
         type: "boolean",
-        description: "If true, returns minimal output (just component names and categories)"
+        description: "If true, returns minimal output (names, categories, and propsSummary per component)"
       },
       includeCode: {
         type: "boolean",
@@ -81,7 +81,7 @@ var MCP_TOOL_DEFINITIONS = [
       verbosity: {
         type: "string",
         enum: ["compact", "standard", "full"],
-        description: 'Response detail level: "compact" (meta + prop names), "standard" (default), "full" (everything)'
+        description: 'Response detail level: "compact" (~200 tokens: meta + propsSummary + provenance), "standard" (default, everything except full code), "full" (everything)'
       }
     },
     required: ["component"]
@@ -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-BZ6SGVA2.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" }
@@ -129,20 +131,6 @@ var CLI_COMMANDS = [
     ]
   },
   // ── Dev ──
-  {
-    name: "dev",
-    description: "Start the development server with live component rendering",
-    category: "dev",
-    usage: "fragments dev [options]",
-    options: [
-      { flags: "-p, --port <port>", description: "Port to run on", default: "6006" },
-      { flags: "--no-open", description: "Do not open browser" },
-      { flags: "--skip-setup", description: "Skip auto-setup (Storybook import, build, Figma link)" },
-      { flags: "--skip-storybook", description: "Skip auto-importing from Storybook" },
-      { flags: "--skip-figma", description: "Skip Figma link check" },
-      { flags: "--skip-build", description: "Skip auto-building fragments.json" }
-    ]
-  },
   {
     name: "list",
     description: "List all discovered fragment files",

package/dist/cli-commands/index.js

@@ -1,7 +1,7 @@
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES
-} from "../chunk-BZ6SGVA2.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-27BMCKU6.js";
+} from "./chunk-3IBKSLZY.js";
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES
-} from "./chunk-BZ6SGVA2.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-27BMCKU6.js";
+} from "../chunk-3IBKSLZY.js";
 export {
   CLI_TOOL_EXTENSIONS,
   MCP_TOOL_DEFINITIONS,

package/dist/types/index.d.ts

@@ -86,9 +86,11 @@ interface FragmentContract {
  * Provenance tracking for generated fragments
  */
 interface FragmentGenerated {
-    source: "storybook" | "manual" | "ai";
+    source: "storybook" | "manual" | "ai" | "extracted" | "merged" | "migrated";
     sourceFile?: string;
+    /** @deprecated Use provenance.verified instead */
     confidence?: number;
+    verified?: boolean;
     timestamp?: string;
 }
 /**
@@ -148,6 +150,22 @@ interface CompiledFragment {
     }>;
     contract?: FragmentContract;
     ai?: AIMetadata;
+    /** Framework hint from contract, used by preview adapters and Cloud */
+    framework?: string;
+    /** Top-level compact prop summaries for agent first-pass */
+    propsSummary?: string[];
+    /** Source file path relative to config root (for contract-sourced fragments) */
+    sourcePath?: string;
+    /** Named export for preview adapter resolution */
+    exportName?: string;
+    /** Clean provenance tracking (V2) */
+    provenance?: {
+        source: string;
+        verified: boolean;
+        frameworkSupport?: string;
+        sourceHash?: string;
+        extractedAt?: string;
+    };
     /** Component performance data from bundle size measurement */
     performance?: PerformanceData;
     _generated?: FragmentGenerated;
@@ -201,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.5.1",
+  "version": "0.6.1",
   "license": "FSL-1.1-MIT",
   "description": "Code intelligence and RAG primitives for design system and codebase indexing",
   "author": "Conan McNicholl",