better-design 0.41.0 → 0.42.0

package/README.md

@@ -45,7 +45,7 @@ the variables in every mode, the text and effect styles, and the components
 with their variant options. It writes them to one JSON file. You confirm the
 read in the plugin panel. Pass that file to `create-figma-prototype` as
 `kitPath` in model mode, and the prototype uses the kit's colours, font and
-radius.
+radius. Pass a `projectId` to also keep the kit on that project.
 
 A frame from a file that was not built from a Better Design library has no
 components to map, so pass `mode: "model"` and a catalog `system`. The plugin

package/dist/index.js

@@ -12856,7 +12856,7 @@ var init_agent_feedback = __esm({
 
 // ../shared/src/schema.ts
 import { z as z8 } from "zod";
-var vector2, messageRoleEnum, messageTypeEnum, designSystemStatusEnum, onboardingPathValues, onboardingPathSchema, onboardingPathSqlValues, mcpIssueCategoryValues, mcpIssueStatusValues, mcpIssueImprovementStatusValues, mcpIssueImprovementVerdictValues, mcpIssueImprovementStatusSchema, mcpIssueImprovementVerdictSchema, mcpIssueImprovementStatusSqlValues, mcpIssueImprovementVerdictSqlValues, designConfigSchema, projectMemoryDataSchema, projects, messages, projectMemory, fragments, usage, scrapeBlock, resourceAccess, user, signupAlertDeliveries, billingAlertDeliveries, billingEmailDeliveries, TEAM_RULES_MAX_BYTES, teamRules, TEAM_RULE_PROPOSAL_MAX_BYTES, teamRuleProposals, projectRuleKindValues, PROJECT_RULE_MAX_BYTES, PROJECT_RULE_NAME_MAX_CHARS, projectRules, agentFeedbackStatusValues, agentFeedback, billingSubscription, githubInstallationClaim, githubInstallation, featureAccess, session, account, verification, jwks, oauthClient, oauthRefreshToken, oauthAccessToken, oauthConsent, designSystems, designSystemComponents, foundationalDocs, apiKeys, claimCodes, emailCampaignSends, emailCampaignSteps, projectEvents, adminProjectReadRouteValues, adminProjectReads, iconLibraries, dsSearchQueries, mcpToolCalls, mcpClientConnections, evalVerdicts, generationInputs, mcpIssues, mcpIssueImprovements, productOutcomeMetricValues, productOutcomeStatusValues, productOutcomeBlockedReasonValues, mcpIssueImprovementOutcomes, projectsRelations, projectMemoryRelations, mcpIssuesRelations, mcpIssueImprovementsRelations, messagesRelations, fragmentsRelations, designSystemsRelations, designSystemComponentsRelations, insertProjectSchema, selectProjectSchema, insertMessageSchema, selectMessageSchema, insertFragmentSchema, selectFragmentSchema, insertProjectMemorySchema, selectProjectMemorySchema, insertDesignSystemSchema, selectDesignSystemSchema, insertDesignSystemComponentSchema, selectDesignSystemComponentSchema, insertFoundationalDocSchema, selectFoundationalDocSchema, insertIconLibrarySchema, selectIconLibrarySchema, insertApiKeySchema, selectApiKeySchema, insertUserSchema, selectUserSchema, insertSignupAlertDeliverySchema, selectSignupAlertDeliverySchema, insertEmailCampaignSendSchema, selectEmailCampaignSendSchema, insertEmailCampaignStepSchema, selectEmailCampaignStepSchema, insertMcpIssueImprovementSchema, selectMcpIssueImprovementSchema, pluginAuthNonces;
+var vector2, messageRoleEnum, messageTypeEnum, designSystemStatusEnum, onboardingPathValues, onboardingPathSchema, onboardingPathSqlValues, mcpIssueCategoryValues, mcpIssueStatusValues, mcpIssueImprovementStatusValues, mcpIssueImprovementVerdictValues, mcpIssueImprovementStatusSchema, mcpIssueImprovementVerdictSchema, mcpIssueImprovementStatusSqlValues, mcpIssueImprovementVerdictSqlValues, designConfigSchema, projectMemoryDataSchema, projects, messages, projectMemory, fragments, usage, scrapeBlock, resourceAccess, user, signupAlertDeliveries, billingAlertDeliveries, billingEmailDeliveries, TEAM_RULES_MAX_BYTES, teamRules, TEAM_RULE_PROPOSAL_MAX_BYTES, teamRuleProposals, projectRuleKindValues, PROJECT_RULE_MAX_BYTES, PROJECT_RULE_NAME_MAX_CHARS, projectRules, projectFigmaKits, agentFeedbackStatusValues, agentFeedback, billingSubscription, githubInstallationClaim, githubInstallation, featureAccess, session, account, verification, jwks, oauthClient, oauthRefreshToken, oauthAccessToken, oauthConsent, designSystems, designSystemComponents, foundationalDocs, apiKeys, claimCodes, emailCampaignSends, emailCampaignSteps, projectEvents, adminProjectReadRouteValues, adminProjectReads, iconLibraries, dsSearchQueries, mcpToolCalls, mcpClientConnections, evalVerdicts, generationInputs, mcpIssues, mcpIssueImprovements, productOutcomeMetricValues, productOutcomeStatusValues, productOutcomeBlockedReasonValues, mcpIssueImprovementOutcomes, projectsRelations, projectMemoryRelations, mcpIssuesRelations, mcpIssueImprovementsRelations, messagesRelations, fragmentsRelations, designSystemsRelations, designSystemComponentsRelations, insertProjectSchema, selectProjectSchema, insertMessageSchema, selectMessageSchema, insertFragmentSchema, selectFragmentSchema, insertProjectMemorySchema, selectProjectMemorySchema, insertDesignSystemSchema, selectDesignSystemSchema, insertDesignSystemComponentSchema, selectDesignSystemComponentSchema, insertFoundationalDocSchema, selectFoundationalDocSchema, insertIconLibrarySchema, selectIconLibrarySchema, insertApiKeySchema, selectApiKeySchema, insertUserSchema, selectUserSchema, insertSignupAlertDeliverySchema, selectSignupAlertDeliverySchema, insertEmailCampaignSendSchema, selectEmailCampaignSendSchema, insertEmailCampaignStepSchema, selectEmailCampaignStepSchema, insertMcpIssueImprovementSchema, selectMcpIssueImprovementSchema, pluginAuthNonces, accountPages;
 var init_schema2 = __esm({
   "../shared/src/schema.ts"() {
     "use strict";
@@ -13308,6 +13308,13 @@ var init_schema2 = __esm({
         )
       ]
     );
+    projectFigmaKits = pgTable("project_figma_kits", {
+      projectId: uuid("project_id").primaryKey().references(() => projects.id, { onDelete: "cascade" }),
+      /** The Figma file name the kit came from. */
+      file: text("file").notNull(),
+      kit: jsonb("kit").$type().notNull(),
+      updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
+    });
     agentFeedbackStatusValues = [
       "open",
       "accepted",
@@ -14229,6 +14236,25 @@ var init_schema2 = __esm({
       createdAt: timestamp("created_at").defaultNow().notNull(),
       expiresAt: timestamp("expires_at").notNull()
     });
+    accountPages = pgTable(
+      "account_pages",
+      {
+        id: text("id").primaryKey(),
+        userId: text("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
+        designSystemId: text("design_system_id").notNull(),
+        website: text("website").notNull(),
+        company: text("company").notNull(),
+        headline: text("headline").notNull(),
+        problem: text("problem"),
+        offer: text("offer").notNull(),
+        /** Up to three short proof points: results, customers or numbers. [BD-1093] */
+        proofs: text("proofs").array(),
+        ctaLabel: text("cta_label").notNull(),
+        ctaUrl: text("cta_url").notNull(),
+        createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (t) => [index("account_pages_user_id_idx").on(t.userId)]
+    );
   }
 });
 
@@ -30644,7 +30670,7 @@ var MCP_IMPLEMENTATION_VERSION;
 var init_version2 = __esm({
   "../shared/src/mcp/version.ts"() {
     "use strict";
-    MCP_IMPLEMENTATION_VERSION = "0.41.0";
+    MCP_IMPLEMENTATION_VERSION = "0.42.0";
   }
 });
 
@@ -30792,6 +30818,7 @@ __export(api_client_exports, {
   listPrinciples: () => listPrinciples,
   proposeTeamRule: () => proposeTeamRule,
   readInspiration: () => readInspiration,
+  saveProjectFigmaKit: () => saveProjectFigmaKit,
   saveProjectRule: () => saveProjectRule,
   saveTeamRules: () => saveTeamRules,
   searchDesignSystems: () => searchDesignSystems,
@@ -30965,6 +30992,9 @@ async function saveProjectRule(projectId, save, replaceExisting) {
     throw error;
   }
 }
+async function saveProjectFigmaKit(projectId, kit) {
+  return request(`/v1/project-kit/${encodeURIComponent(projectId)}`, { method: "PUT", body: kit });
+}
 function postAlert(body) {
   return fetch(`${API_URL2}/api/internal/alert`, {
     method: "POST",
@@ -31577,7 +31607,7 @@ var init_code_rules = __esm({
 
 // ../shared/src/lint/length-rules.ts
 function pxMatches(value) {
-  const unquoted = value.replace(QUOTED_RE, (quoted2) => " ".repeat(quoted2.length));
+  const unquoted = value.replace(QUOTED_RE, (quoted3) => " ".repeat(quoted3.length));
   return [...unquoted.matchAll(PX_RE)].filter((match) => Number.parseFloat(match[0]) !== 0);
 }
 function pxValues(value) {
@@ -34739,6 +34769,16 @@ review-ui-code({ files: [{ path: "components/signup-form.tsx", content: "..." },
 
 // ../shared/src/mcp/figma-kit.ts
 import { z as z36 } from "zod";
+function kitCounts(kit) {
+  return {
+    file: kit.file,
+    collections: kit.collections.length,
+    variables: kit.collections.reduce((total, collection) => total + collection.variables.length, 0),
+    textStyles: kit.textStyles.length,
+    effectStyles: kit.effectStyles.length,
+    components: kit.components.length
+  };
+}
 var colorSchema, kitValueSchema, kitVariableSchema, kitCollectionSchema, kitTextStyleSchema, kitEffectStyleSchema, kitComponentSchema, figmaKitSchema;
 var init_figma_kit = __esm({
   "../shared/src/mcp/figma-kit.ts"() {
@@ -35837,6 +35877,38 @@ var init_figma_model_providers = __esm({
   }
 });
 
+// ../shared/src/mcp/figma-kit-gaps.ts
+function describeKitGaps(gaps) {
+  if (gaps.length === 0) return "An agent can use every component set in this kit.";
+  const names = (reason) => {
+    const all = gaps.filter((gap) => gap.reason === reason).map((gap) => quoted2(gap.component));
+    const shown = all.slice(0, NAMES_SHOWN).join(", ");
+    return { count: all.length, list: all.length > NAMES_SHOWN ? `${shown} and ${all.length - NAMES_SHOWN} more` : shown };
+  };
+  const crowded = names("many-variant-properties");
+  const missing = names("no-match-in-code");
+  const renamed = names("name-differs-from-code");
+  const unruled = names("no-use-rule");
+  return [
+    "Before an agent builds with this kit:",
+    crowded.count ? `- ${crowded.count} set(s) have more than ${VARIANT_PROPERTY_LIMIT} variant properties, so an agent may pick the wrong variant: ${crowded.list}.` : "",
+    missing.count ? `- ${missing.count} set(s) have no part in code, so an agent builds them from plain layers: ${missing.list}.` : "",
+    renamed.count ? `- ${renamed.count} set(s) build as a part with another name, so check each one: ${renamed.list}.` : "",
+    unruled.count ? `- ${unruled.count} set(s) have no use rule, so an agent does not know when to use them: ${unruled.list}. Save one with set-team-rules, kind "use".` : ""
+  ].filter(Boolean).join("\n");
+}
+var VARIANT_PROPERTY_LIMIT, NAME_MAX_CHARS, quoted2, NAMES_SHOWN;
+var init_figma_kit_gaps = __esm({
+  "../shared/src/mcp/figma-kit-gaps.ts"() {
+    "use strict";
+    init_project_rules();
+    VARIANT_PROPERTY_LIMIT = 3;
+    NAME_MAX_CHARS = 80;
+    quoted2 = (name) => JSON.stringify(name.replace(/\s+/g, " ").trim().slice(0, NAME_MAX_CHARS));
+    NAMES_SHOWN = 8;
+  }
+});
+
 // ../shared/src/mcp/figma-relay.ts
 import { z as z40 } from "zod";
 function noPluginMessage() {
@@ -36281,7 +36353,7 @@ ${page.html}` }],
     }
   );
 }
-function registerFigmaKitTool(server) {
+function registerFigmaKitTool(server, saveKit) {
   server.registerTool(
     "read-figma-kit",
     {
@@ -36291,10 +36363,12 @@ function registerFigmaKitTool(server) {
         "the text and effect styles, and every component with the options of its variant properties.",
         "Writes them as one JSON file and returns the counts. The Better Design plugin must be open in",
         "that file, and the designer confirms the read in the plugin panel. Only the file's own items are",
-        "read; a library the file uses is read from its own file."
+        "read; a library the file uses is read from its own file. Pass a projectId to also keep the kit on",
+        "that Better Design project, so later calls build with the client's own names and values."
       ].join(" "),
       inputSchema: z41.object({
-        outputPath: z41.string().describe("Where to write the kit JSON. Relative paths resolve against the working directory.")
+        outputPath: z41.string().describe("Where to write the kit JSON. Relative paths resolve against the working directory."),
+        projectId: z41.guid().optional().describe("A Better Design project id. The kit is kept on it, replacing the one it held.")
       }),
       outputSchema: z41.object({
         status: z41.enum(["completed", "failed"]),
@@ -36305,11 +36379,21 @@ function registerFigmaKitTool(server) {
         variables: z41.number().optional(),
         textStyles: z41.number().optional(),
         effectStyles: z41.number().optional(),
-        components: z41.number().optional()
+        components: z41.number().optional(),
+        projectId: z41.string().optional(),
+        gaps: z41.array(
+          z41.object({
+            component: z41.string(),
+            page: z41.string(),
+            reason: z41.enum(["many-variant-properties", "no-use-rule", "no-match-in-code", "name-differs-from-code"]),
+            detail: z41.string()
+          })
+        ).optional(),
+        nameMap: z41.array(z41.object({ component: z41.string(), part: z41.string().nullable(), match: z41.enum(["same", "family", "none"]) })).optional()
       }),
       annotations: { readOnlyHint: false, openWorldHint: true }
     },
-    async ({ outputPath }) => {
+    async ({ outputPath, projectId }) => {
       const failed = (message2) => ({
         content: [{ type: "text", text: message2 }],
         structuredContent: { status: "failed", message: message2 },
@@ -36319,6 +36403,7 @@ function registerFigmaKitTool(server) {
       if (!started) {
         return failed("Another Better Design session already owns the Figma relay port. Close it and try again.");
       }
+      if (projectId && !saveKit) return failed("This server cannot reach a Better Design project. Run the stdio server with an API key.");
       if (!await waitForPlugin(started)) return failed(noPluginMessage());
       const { answer } = started.queue.ask(void 0, void 0, "kit");
       const result = await answer;
@@ -36329,17 +36414,23 @@ function registerFigmaKitTool(server) {
       await mkdir2(dirname4(path9), { recursive: true });
       await writeFile2(path9, `${JSON.stringify(kit, null, 2)}
 `, "utf8");
-      const counts = {
-        collections: kit.collections.length,
-        variables: kit.collections.reduce((total, collection) => total + collection.variables.length, 0),
-        textStyles: kit.textStyles.length,
-        effectStyles: kit.effectStyles.length,
-        components: kit.components.length
-      };
-      const message = `${kit.file}: ${counts.components} component(s), ${counts.variables} variable(s) in ${counts.collections} collection(s), ${counts.textStyles} text style(s) and ${counts.effectStyles} effect style(s). Written to ${path9}.`;
+      const { file, ...counts } = kitCounts(kit);
+      let message = `${file}: ${counts.components} component(s), ${counts.variables} variable(s) in ${counts.collections} collection(s), ${counts.textStyles} text style(s) and ${counts.effectStyles} effect style(s). Written to ${path9}.`;
+      let gaps;
+      let nameMap;
+      if (projectId && saveKit) {
+        try {
+          ({ gaps, nameMap } = await saveKit(projectId, kit));
+          message = `${describeKitGaps(gaps)}
+
+${message} Kept on project ${projectId}.`;
+        } catch (error) {
+          return failed(`${message} The kit was not kept on project ${projectId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      }
       return {
         content: [{ type: "text", text: message }],
-        structuredContent: { status: "completed", message, path: path9, file: kit.file, ...counts }
+        structuredContent: { status: "completed", message, path: path9, file, ...counts, projectId, gaps, nameMap }
       };
     }
   );
@@ -36353,6 +36444,8 @@ var init_figma_prototype_tool = __esm({
     init_figma_model();
     init_figma_model_handoff();
     init_figma_model_providers();
+    init_figma_kit();
+    init_figma_kit_gaps();
     init_figma_relay();
     init_figma_relay_server();
     relay = null;
@@ -36469,7 +36562,8 @@ async function startServer() {
     sendAgentFeedback: sendAgentFeedback2,
     confirmAgentClaim: confirmAgentClaim2,
     trackToolUsage: trackToolUsage2,
-    trackMcpInstalled: trackMcpInstalled2
+    trackMcpInstalled: trackMcpInstalled2,
+    saveProjectFigmaKit: saveProjectFigmaKit2
   } = await Promise.resolve().then(() => (init_api_client(), api_client_exports));
   const { isFirstConnect: isFirstConnect2 } = await Promise.resolve().then(() => (init_install_marker(), install_marker_exports));
   const { mcpDebugLog: mcpDebugLog2 } = await Promise.resolve().then(() => (init_mcp_debug_log(), mcp_debug_log_exports));
@@ -36500,7 +36594,7 @@ async function startServer() {
   });
   registerReviewTool2(server, onToolUsage);
   registerFigmaPrototypeTool2(server);
-  registerFigmaKitTool2(server);
+  registerFigmaKitTool2(server, saveProjectFigmaKit2);
   server.server.oninitialized = () => {
     try {
       const info = server.server.getClientVersion?.();