@sxl-studio/bridge 1.7.2 → 1.8.0

package/dist/agent-recipes.js

@@ -21,6 +21,165 @@ export const RECIPE_INDEX = {
     version: 1,
     context: "Decision tree for any documentation / palette / scenario request that targets a Figma file managed by SXL Studio. Always read this resource first; it routes the agent to a specific recipe instead of running ad-hoc figma.* JS.",
     userIntents: [
+        {
+            recipeId: "sxl-use",
+            userPhrases: [
+                "управляй фигмой через bridge",
+                "figma-use",
+                "use_figma",
+                "use figma to update the current design file",
+                "create or modify nodes in figma",
+                "read selection and edit canvas",
+                "назначь переменные объектам",
+                "work with variables styles and components",
+                "use figma rest api",
+                "diagnose figma rest token",
+                "whoami figma token",
+                "search known figma library",
+                "get_libraries",
+                "search_design_system",
+                "search design system library",
+                "upload images to figma",
+                "загрузи изображения в фигму",
+            ],
+        },
+        {
+            recipeId: "sxl-implement-design",
+            userPhrases: [
+                "figma-implement-design",
+                "figma-swiftui",
+                "implement this figma design in swiftui",
+                "convert figma selection to swiftui",
+                "implement this figma design in code",
+                "turn figma selection into code",
+                "convert figma selection to code",
+                "реализуй выбранный макет в коде",
+            ],
+        },
+        {
+            recipeId: "sxl-generate-design",
+            userPhrases: [
+                "нарисуй экран в фигме",
+                "figma-generate-design",
+                "generate_figma_design",
+                "code to canvas",
+                "push app page into figma",
+                "build a real UI screen in Figma",
+                "собери макет из дизайн-системы",
+                "update this screen without rebuilding everything",
+                "validate screen spec before applying",
+            ],
+        },
+        {
+            recipeId: "sxl-generate-library",
+            userPhrases: [
+                "создай дизайн-систему в фигме",
+                "figma-generate-library",
+                "generate a figma design system library",
+                "generate library in figma from codebase",
+                "generate library variables styles components docs",
+                "экспортируй переменные и стили",
+                "пересобери компоненты из композиций",
+                "build design system foundations",
+                "figma-create-design-system-rules",
+                "create design system rules for this project",
+                "generate rules for translating figma designs into code",
+            ],
+        },
+        {
+            recipeId: "sxl-code-connect",
+            userPhrases: [
+                "настрой code connect",
+                "figma-code-connect",
+                "figma-code-connect-components",
+                "get_context_for_code_connect",
+                "send_code_connect_mappings",
+                "save code connect binding",
+                "свяжи figma компонент с storybook",
+                "show code connect registry",
+                "component docs url files storybook binding",
+            ],
+        },
+        {
+            recipeId: "sxl-audit",
+            userPhrases: [
+                "проведи аудит макетов",
+                "analyze variables styles and component usage",
+                "проверь пропсы компонентов",
+                "найди компоненты с prop value",
+                "audit coverage drift unused analytics",
+            ],
+        },
+        {
+            recipeId: "sxl-doc-builder",
+            userPhrases: [
+                "нарисуй документацию в фигме",
+                "build documentation in Figma",
+                "документация компонентов токенов флоу",
+                "render markdown scenario as Figma flow",
+                "apply doc spec",
+            ],
+        },
+        {
+            recipeId: "sxl-data-apply-mapping",
+            userPhrases: [
+                "примени маппинг",
+                "примени mapping",
+                "apply mapping to selection",
+                "apply data mapping",
+                "подставь данные по маппингу",
+                "fill selected nodes from dataset",
+            ],
+        },
+        {
+            recipeId: "sxl-data-apply-all",
+            userPhrases: [
+                "примени все маппинги",
+                "apply all mappings",
+                "apply all data mappings",
+                "подставь данные по всем маппингам",
+                "apply mappings on page",
+                "apply mappings to document",
+            ],
+        },
+        {
+            recipeId: "sxl-data-generate-instances",
+            userPhrases: [
+                "сгенерируй инстансы из датасета",
+                "generate instances from dataset",
+                "generate instances from mapping",
+                "создай строки из датасета",
+                "render rows from mapping data",
+                "generate cards from dataset mapping",
+            ],
+        },
+        {
+            recipeId: "sxl-database-transfer",
+            userPhrases: [
+                "экспортируй базу sxl",
+                "импортируй базу sxl",
+                "backup sxl database",
+                "restore sxl database",
+                "export database payload",
+                "import database payload",
+                "перенеси datasets assets mappings",
+            ],
+        },
+        {
+            recipeId: "figma-mcp-companion",
+            userPhrases: [
+                "figma-create-new-file",
+                "create_new_file",
+                "create a new figma file",
+                "new figma design file",
+                "figma-generate-diagram",
+                "generate_diagram",
+                "create a figjam diagram",
+                "figma-use-figjam",
+                "figma-use-slides",
+                "create figma slides",
+            ],
+        },
         {
             recipeId: "doc-tokens",
             userPhrases: [
@@ -112,7 +271,12 @@ export const RECIPE_INDEX = {
             recipeId: "audit-coverage",
             userPhrases: [
                 "проверь везде ли подкреплены переменные",
+                "проверь на всех макетах установлены ли переменные и стили",
+                "проверь на всех ли макетах и объектах установленные переменные",
+                "проверь переменные и стили на макетах",
                 "найди объекты без переменных",
+                "check whether every screen object has variables and styles assigned",
+                "check variable and style coverage across layouts",
                 "audit raw values without variables",
                 "review the file for missing bindings",
                 "где hex заливки вместо токенов",
@@ -321,6 +485,608 @@ export const RECIPE_INDEX = {
     ],
     doneCriteria: "Agent picked exactly one recipe, called only the tools it lists, and produced a verifiable result (doneWhen of that recipe).",
 };
+export const RECIPE_SXL_USE = {
+    id: "sxl-use",
+    title: "SXL Use — read/write the current Figma Design file through Bridge",
+    version: 1,
+    context: "Foundational SXL skill for canvas reads/writes, variables, styles, components, token workspace operations, status checks, and design-to-code context. Mirrors the role of figma-use for SXL Studio and supplies the active-file context needed by figma-implement-design-style workflows: prefer Bridge tools and plugin handlers over arbitrary use_figma scripts.",
+    userPhrases: [
+        "управляй фигмой через bridge",
+        "create or modify nodes in figma",
+        "read selection and edit canvas",
+        "назначь переменные объектам",
+        "work with variables styles and components",
+        "figma-implement-design",
+        "implement this figma design in code",
+        "turn figma selection into code",
+        "diagnose figma rest token",
+        "whoami figma token",
+        "search known figma library",
+        "get_libraries",
+        "search_design_system",
+        "search organization design library",
+        "get variable definitions used in selection",
+        "покажи переменные и стили выделения",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-use", "sxl-generate-design"],
+            hint: "sxl-use handles low-level targeted reads/writes; sxl-generate-design assembles or updates full screens via Design DSL.",
+        },
+        {
+            between: ["sxl-use", "sxl-audit"],
+            hint: "sxl-use writes after the target is known; sxl-audit discovers usage, coverage, drift, unused entries, or component prop statistics first.",
+        },
+    ],
+    preferredTools: [
+        "get_bridge_runtime_summary",
+        "get_plugin_status",
+        "get_capability_matrix",
+        "get_figma_mcp_skills_parity",
+        "list_tools",
+        "get_selection",
+        "get_design_context",
+        "get_metadata",
+        "get_node_info",
+        "get_node_tree",
+        "get_screenshot",
+        "get_variable_defs",
+        "get_context_for_code_connect",
+        "get_code_connect_suggestions",
+        "get_libraries",
+        "search_design_system",
+        "get_variables",
+        "get_local_styles",
+        "search_enabled_library_assets",
+        "inspect_enabled_libraries",
+        "list_enabled_library_variables",
+        "figma_rest_diagnose",
+        "figma_rest_whoami",
+        "figma_rest_get_file_nodes",
+        "figma_rest_search_design_system",
+        "upload_assets",
+        "set_node_fill_variable",
+        "batch_bind_variables",
+    ],
+    schemaResources: ["sxl://agent/schemas/code-connect-context-v1"],
+    forbidden: [
+        "Calling use_figma with a hand-written figma.* script when a Bridge tool exists.",
+        "Writing canvas changes before checking get_plugin_status.writesAllowed.",
+        "Fetching image URLs in an ad-hoc script or sending raw imageBytes arrays when upload_assets can validate and apply assets.",
+        "Looping single-node writes for bulk variable binding when batch_bind_variables covers the request.",
+    ],
+    steps: [
+        "Call get_bridge_runtime_summary before heavy workflows to check plugin connection, queue pressure, recent failures, and auth status.",
+        "Call get_plugin_status and inspect editorType / writesAllowed before any write.",
+        "Call get_capability_matrix or list_tools if tool choice is uncertain; prefer tools with dryRunSupported for writes.",
+        "For Figma MCP-style library discovery, prefer get_libraries and search_design_system; they combine active-file enabled libraries, local components, and known REST file/team libraries where configured.",
+        "When the plugin is not open, cross-file context is needed, or the request targets a known file/team library outside the active file, call figma_rest_diagnose first; get_libraries/search_design_system can then use fileKey/url/teamId with a configured FIGMA_TOKEN / FIGMA_ACCESS_TOKEN.",
+        "For image insertion in Figma Design, call upload_assets with dryRun=true first; it validates PNG/JPG/GIF/WebP assets up to 10MB and applies them through set_image_fill.",
+        "Read the narrowest needed context: current selection, node tree, variables, or styles.",
+        "For design implementation requests, call get_design_context plus get_variable_defs/get_screenshot/get_context_for_code_connect when components or code mappings matter; the agent then edits project code outside the plugin.",
+        "For writes, use the thickest Bridge command that covers the task; fall back to direct canvas tools only for small targeted edits.",
+        "After writes, inspect the changed node or rerun the relevant audit/read tool.",
+    ],
+    doneCriteria: "Agent completed the requested Figma operation through Bridge tools, respected Design/Dev mode constraints, and did not use arbitrary use_figma scripts.",
+};
+export const RECIPE_SXL_IMPLEMENT_DESIGN = {
+    id: "sxl-implement-design",
+    title: "SXL Implement Design — read Figma context for code implementation",
+    version: 1,
+    context: "Read-only Bridge workflow for Figma-to-code requests, including current official figma-swiftui and legacy/client figma-implement-design-style aliases. It gathers active-file design context, screenshots, variable/style definitions, SXL codegen/composition data, and Code Connect hints so the agent can edit the repository code outside Figma. It must not mutate the Figma canvas.",
+    userPhrases: [
+        "figma-implement-design",
+        "figma-swiftui",
+        "implement this figma design in swiftui",
+        "convert figma selection to swiftui",
+        "implement this figma design in code",
+        "turn figma selection into code",
+        "convert figma selection to code",
+        "реализуй выбранный макет в коде",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-implement-design", "sxl-use"],
+            hint: "sxl-implement-design is read-only context for code implementation; sxl-use is broad active-file read/write control.",
+        },
+        {
+            between: ["sxl-implement-design", "sxl-generate-design"],
+            hint: "sxl-implement-design turns Figma into repository code; sxl-generate-design builds Figma screens from a spec/code context.",
+        },
+    ],
+    preferredTools: [
+        "get_bridge_runtime_summary",
+        "get_figma_mcp_skills_parity",
+        "get_design_context",
+        "get_metadata",
+        "get_screenshot",
+        "get_variable_defs",
+        "get_context_for_code_connect",
+        "get_code_connect_suggestions",
+        "get_codegen",
+        "export_composition_json",
+    ],
+    schemaResources: ["sxl://agent/schemas/code-connect-context-v1"],
+    forbidden: [
+        "Mutating the Figma canvas for an implement-design request.",
+        "Calling upload_assets, set_node_fill_variable, batch_bind_variables, build_screen, or export_variables.",
+        "Treating SXL codegen as final project code without adapting it to repository components and conventions.",
+    ],
+    steps: [
+        "Call get_bridge_runtime_summary to confirm Bridge/plugin state and queue pressure.",
+        "Call get_design_context for the selected frame/component; include screenshot/context options when useful.",
+        "Call get_variable_defs and get_screenshot when visual/token fidelity matters.",
+        "Call get_context_for_code_connect and get_code_connect_suggestions when component mappings or Storybook context matter.",
+        "Use get_codegen/export_composition_json only as reference material; then edit repository code with normal project tooling.",
+    ],
+    doneCriteria: "Agent collected read-only Figma/SXL context and implemented or updated repository code without mutating the Figma file.",
+};
+export const RECIPE_SXL_GENERATE_DESIGN = {
+    id: "sxl-generate-design",
+    title: "SXL Generate Design — build or update real UI screens in Figma",
+    version: 1,
+    context: "Screen-building skill for real editable Figma Design files. Use inspect_design_system + validate_screen_spec + build_screen/update_screen first; direct canvas tools are fallback only.",
+    userPhrases: [
+        "нарисуй экран в фигме",
+        "build a real UI screen in Figma",
+        "собери макет из дизайн-системы",
+        "update this screen without rebuilding everything",
+        "validate screen spec before applying",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-generate-design", "mockup-builder"],
+            hint: "sxl-generate-design is the top-level screen skill; mockup-builder is the detailed recipe for the underlying build_mockup/build_screen DSL.",
+        },
+        {
+            between: ["sxl-generate-design", "sxl-doc-builder"],
+            hint: "generate-design builds product UI screens; doc-builder builds documentation pages, palettes, component docs, and flows.",
+        },
+    ],
+    preferredTools: [
+        "inspect_design_system",
+        "validate_screen_spec",
+        "build_screen",
+        "update_screen",
+        "find_components",
+        "search_enabled_library_assets",
+        "inspect_enabled_libraries",
+        "get_variables",
+        "audit_variable_coverage",
+    ],
+    schemaResources: ["sxl://agent/schemas/design-dsl-v1"],
+    forbidden: [
+        "Creating a screen by hand with many create_frame/create_text/create_component_instance calls when build_screen covers it.",
+        "Guessing component names or component prop keys without inspect_design_system / find_components.",
+        "Committing build_screen/update_screen without a dryRun or validate_screen_spec preview.",
+        "Hardcoding hex colors when a local Figma Variable is available.",
+    ],
+    steps: [
+        "Run inspect_design_system with includeProperties and a narrow query/prefix when possible; use search_enabled_library_assets when the user expects components/styles/variables from libraries enabled in the current file.",
+        "Draft a Design DSL v1 spec using real component ids/keys, human prop keys, text overrides, and variable fill bindings.",
+        "Call validate_screen_spec or build_screen/update_screen with dryRun: true and fix any unresolved components/props.",
+        "Commit build_screen or update_screen only after the dry-run plan is clean or approved.",
+        "Run audit_variable_coverage on the resulting root/page when variable binding quality matters.",
+    ],
+    doneCriteria: "A real Figma screen was created or updated with existing components, auto layout, and variable/style bindings where available. The flow used dryRun before write.",
+};
+export const RECIPE_SXL_GENERATE_LIBRARY = {
+    id: "sxl-generate-library",
+    title: "SXL Generate Library — variables, styles, compositions, and docs",
+    version: 1,
+    context: "Design-system skill for SXL Studio. Covers safe export_variables modes, bulk variable/style specs, composition generation, drift checks, library documentation, and the SXL context needed by figma-create-design-system-rules-style agent workflows.",
+    userPhrases: [
+        "создай дизайн-систему в фигме",
+        "generate library variables styles components docs",
+        "экспортируй переменные и стили",
+        "пересобери компоненты из композиций",
+        "build design system foundations",
+        "figma-create-design-system-rules",
+        "create design system rules for this project",
+        "generate rules for translating figma designs into code",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-generate-library", "bulk-variables"],
+            hint: "use bulk-variables for variable-only refactors; use sxl-generate-library when variables, styles, compositions, and docs are part of one system workflow.",
+        },
+        {
+            between: ["sxl-generate-library", "bulk-compositions"],
+            hint: "bulk-compositions rebuilds existing composition files; sxl-generate-library orchestrates the broader library pipeline.",
+        },
+    ],
+    preferredTools: [
+        "get_tokens_config",
+        "get_figma_mcp_skills_parity",
+        "search_enabled_library_assets",
+        "inspect_enabled_libraries",
+        "list_enabled_library_variables",
+        "inspect_design_system",
+        "get_context_for_code_connect",
+        "get_code_connect_suggestions",
+        "preview_export_variables",
+        "export_variables",
+        "import_variable_spec",
+        "import_style_spec",
+        "list_compositions",
+        "bulk_generate_compositions",
+        "audit_composition_drift",
+        "build_component_doc",
+    ],
+    forbidden: [
+        "Using destructive export options such as deleteOrphans, forceUpdateAll, or allowDestructiveReorder unless the user explicitly asked for them.",
+        "Claiming export_variables applies codeSyntax/scopes by default; plugin safe default is applyCodeSyntaxAndScopes=false.",
+        "Hand-crafting composition JSON instead of export_composition_json / compose_from_url / list_compositions.",
+        "Bulk-generating compositions without dryRun first.",
+    ],
+    steps: [
+        "Read get_tokens_config and list_token_files/list_compositions to understand the workspace; use inspect_enabled_libraries/list_enabled_library_variables when reconciling enabled library definitions.",
+        "For design-system-rules requests, call inspect_design_system and get_context_for_code_connect/get_code_connect_suggestions when code mappings matter; the agent writes the client-specific rule file in the repository, not through a plugin command.",
+        "For token export, call preview_export_variables first; then call export_variables with only explicit settings and keep safe defaults unless requested.",
+        "For large variable/style changes, use import_variable_spec/import_style_spec with dryRun first.",
+        "Run audit_composition_drift before rebuilding existing components; use bulk_generate_compositions dryRun before commit.",
+        "Build documentation with sxl-doc-builder recipes after foundations are generated.",
+    ],
+    doneCriteria: "Library foundations were exported/generated with non-destructive defaults, drift was inspected before rebuilds, and all bulk writes were previewed first.",
+};
+export const RECIPE_SXL_CODE_CONNECT = {
+    id: "sxl-code-connect",
+    title: "SXL Code Connect — bind Figma components to code, Storybook, and docs",
+    version: 1,
+    context: "Code Connect skill for SXL Studio. Manages full CodeConnectBinding payloads: docs URL, files, Storybook, component API, status, registry, and global settings.",
+    userPhrases: [
+        "настрой code connect",
+        "save code connect binding",
+        "свяжи figma компонент с storybook",
+        "show code connect registry",
+        "component docs url files storybook binding",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-code-connect", "doc-component"],
+            hint: "code-connect links Figma nodes to code/docs metadata; doc-component renders documentation on the Figma canvas.",
+        },
+    ],
+    preferredTools: [
+        "codeconnect_get_global_settings",
+        "codeconnect_save_global_settings",
+        "codeconnect_get_registry",
+        "codeconnect_get_selection_status",
+        "get_context_for_code_connect",
+        "get_code_connect_suggestions",
+        "generate_code_connect_template",
+        "codeconnect_get_binding",
+        "codeconnect_save_binding",
+        "codeconnect_get_node_ui_status",
+    ],
+    schemaResources: [
+        "sxl://agent/schemas/code-connect-context-v1",
+        "sxl://agent/schemas/code-connect-template-v1",
+    ],
+    forbidden: [
+        "Saving partial binding metadata that drops docsUrl/files/storybook/component API fields.",
+        "Guessing node ids when selection status can identify the current component.",
+        "Hand-writing filePath/importPath bindings before checking get_context_for_code_connect or get_code_connect_suggestions.",
+        "Writing .figma.ts files without generate_code_connect_template dry-run preview.",
+        "Treating Code Connect as composition JSON; keep bindings as metadata, not generated component structure.",
+    ],
+    steps: [
+        "Read codeconnect_get_global_settings and codeconnect_get_registry to understand existing defaults.",
+        "Use codeconnect_get_selection_status or get_node_info to confirm target node ids.",
+        "Call get_context_for_code_connect with explicit targets/componentNames or current selection; review existing binding, component props, codegen/composition context, and highest-confidence local code candidates.",
+        "For template-file workflows, call generate_code_connect_template without writeFile first; only writeFile=true after reviewing output path/content.",
+        "Save the chosen binding with full metadata: componentName, docs URL, files[], Storybook data, component API, and status where available.",
+        "Verify with codeconnect_get_binding and codeconnect_get_node_ui_status.",
+    ],
+    doneCriteria: "Target Figma component has a full Code Connect binding and the registry/UI status reflect it.",
+};
+export const RECIPE_SXL_AUDIT = {
+    id: "sxl-audit",
+    title: "SXL Audit — variables, styles, components, props, drift, and unused entries",
+    version: 1,
+    context: "Audit skill for read-only analysis and dry-run-first remediation. Covers variable/style coverage, usage, unused entries, component usage, component prop usage, and composition/style drift.",
+    userPhrases: [
+        "проведи аудит макетов",
+        "analyze variables styles and component usage",
+        "проверь пропсы компонентов",
+        "найди компоненты с prop value",
+        "audit coverage drift unused analytics",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-audit", "audit-coverage"],
+            hint: "audit-coverage is the specialized recipe for missing variable/style bindings; sxl-audit is the broad audit router.",
+        },
+        {
+            between: ["sxl-audit", "composition-drift"],
+            hint: "composition-drift is composition JSON vs Figma component; sxl-audit can route there when that is the user's unit.",
+        },
+    ],
+    preferredTools: [
+        "audit_variable_coverage",
+        "find_variable_coverage_misses",
+        "audit_style_coverage",
+        "find_style_coverage_misses",
+        "analyze_component_usage",
+        "find_component_usages",
+        "analyze_component_prop_usage",
+        "find_component_prop_usages",
+        "find_unused_variables",
+        "find_unused_styles",
+        "audit_composition_drift",
+    ],
+    forbidden: [
+        "Walking the entire document manually with use_figma for analytics already covered by Bridge audit tools.",
+        "Requesting full detail lists before running summary tools.",
+        "Applying audit suggestions without preview mode first and explicit user confirmation.",
+    ],
+    steps: [
+        "Choose the narrowest scope: selection, page, node, then file only when needed.",
+        "Run summary tools first; use find_* paginated tools only for requested details.",
+        "For component prop analytics, use analyze_component_prop_usage for counts and find_component_prop_usages for node ids.",
+        "If the user asks to fix findings, switch to apply_coverage_suggestions / apply_style_coverage_suggestions / batch_bind_variables and preview before committing.",
+    ],
+    doneCriteria: "Agent returned a scoped audit report with counts and actionable findings; any remediation used preview mode before write.",
+};
+export const RECIPE_SXL_DOC_BUILDER = {
+    id: "sxl-doc-builder",
+    title: "SXL Doc Builder — render documentation in Figma",
+    version: 1,
+    context: "Documentation skill for Figma canvas output: token tables, variable palettes, component docs, doc flows, and markdown scenarios. Uses Bridge doc tools, never ad-hoc scripts.",
+    userPhrases: [
+        "нарисуй документацию в фигме",
+        "build documentation in Figma",
+        "документация компонентов токенов флоу",
+        "render markdown scenario as Figma flow",
+        "apply doc spec",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-doc-builder", "doc-component"],
+            hint: "doc-component is the specialized single-component recipe; sxl-doc-builder routes all documentation types.",
+        },
+        {
+            between: ["sxl-doc-builder", "scenario-from-markdown"],
+            hint: "scenario-from-markdown wins when the user provides markdown H1/H2 scenario text with Figma URLs.",
+        },
+    ],
+    preferredTools: [
+        "apply_doc_spec",
+        "build_component_doc",
+        "build_doc_flow",
+        "bind_variable_palette",
+        "build_scenario_from_md",
+        "build_token_documentation",
+    ],
+    schemaResources: [
+        "sxl://agent/schemas/doc-spec-v2",
+        "sxl://agent/schemas/token-doc-v1",
+    ],
+    forbidden: [
+        "Creating throwaway JS scripts or /tmp payload loaders for documentation.",
+        "Using use_figma to clone templates or enumerate variables when bind_variable_palette/apply_doc_spec exists.",
+        "Hand-crafting composition JSON for docs; use export_composition_json or compose_from_url.",
+        "Skipping dryRun on build_scenario_from_md or doc flows that support preview.",
+    ],
+    steps: [
+        "Route the request: token table, variable palette, component doc, flow, markdown scenario, or custom Doc Spec v2.",
+        "Read the specialized recipe resource for that route before building payloads.",
+        "Discover targetParentId/templateNodeId/layer names via template-discovery when templates are involved.",
+        "Call the chosen doc tool with dryRun when supported, then commit.",
+        "Inspect the created documentation root or report returned nodes.",
+    ],
+    doneCriteria: "Documentation was rendered in Figma through Bridge doc tools with real token/variable/component data and without ad-hoc scripts.",
+};
+export const RECIPE_SXL_DATA_APPLY_MAPPING = {
+    id: "sxl-data-apply-mapping",
+    title: "SXL Data — apply one mapping to explicit targets or current selection",
+    version: 1,
+    context: "Agent workflow for applying one SXL database mapping to explicit targetNodeIds or the current Figma selection. Agents must preview mapping fields, datasets, and target counts before writing.",
+    userPhrases: [
+        "примени маппинг",
+        "apply mapping to selection",
+        "apply data mapping",
+        "подставь данные по маппингу",
+        "fill selected nodes from dataset",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-data-apply-mapping", "sxl-data-apply-all"],
+            hint: "Use apply-mapping when the user names one mapping or selected target. Use apply-all only when the user says all mappings or whole scope.",
+        },
+        {
+            between: ["sxl-data-apply-mapping", "sxl-data-generate-instances"],
+            hint: "Use apply-mapping to fill existing selected layers. Use generate-instances when the task needs new rows/cards/instances.",
+        },
+    ],
+    preferredTools: [
+        "get_plugin_status",
+        "list_mappings",
+        "get_mapping",
+        "count_apply_targets",
+        "apply_mapping",
+    ],
+    forbidden: [
+        "Calling apply_mapping without dryRun preview and explicit approval.",
+        "Passing legacy targetNodes when targetNodeIds are available; use explicit node ids for deterministic agent control.",
+        "Applying to page/document scope with apply_mapping; use apply_all_mappings for broad scope.",
+    ],
+    steps: [
+        "Check plugin status and writesAllowed.",
+        "List mappings and read the selected mapping before applying.",
+        "Run count_apply_targets for selection and apply_mapping with dryRun:true.",
+        "Present mapping fields, dataset row hints, and target count.",
+        "Commit apply_mapping only after approval, preferably with targetNodeIds when the intended roots are known.",
+    ],
+    doneCriteria: "One selected SXL mapping was previewed, approved, and applied to the intended explicit targetNodeIds or current Figma selection.",
+};
+export const RECIPE_SXL_DATA_APPLY_ALL = {
+    id: "sxl-data-apply-all",
+    title: "SXL Data — apply all mappings in a scope",
+    version: 1,
+    context: "Agent workflow for applying all SXL mappings to explicit targetNodeIds or a selection/page/document scope. This is a bulk write and must be dry-run previewed before commit.",
+    userPhrases: [
+        "примени все маппинги",
+        "apply all mappings",
+        "apply all data mappings",
+        "подставь данные по всем маппингам",
+        "apply mappings on page",
+        "apply mappings to document",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-data-apply-all", "sxl-data-apply-mapping"],
+            hint: "Use apply-all only when the user explicitly asks for all mappings or a broad scope.",
+        },
+    ],
+    preferredTools: [
+        "get_plugin_status",
+        "list_mappings",
+        "count_apply_targets",
+        "apply_all_mappings",
+    ],
+    forbidden: [
+        "Running apply_all_mappings without dryRun preview and explicit approval.",
+        "Defaulting to document scope when the user did not ask for it; prefer selection/page unless specified.",
+        "Deleting or changing mappings as part of apply; this workflow only fills data into existing nodes.",
+    ],
+    steps: [
+        "Check plugin status and writesAllowed.",
+        "List mappings and choose explicit targetNodeIds when known, otherwise scope: selection, page, or document.",
+        "Run count_apply_targets and apply_all_mappings with dryRun:true.",
+        "Show mapping count, target count, and scope.",
+        "Commit apply_all_mappings only after approval.",
+    ],
+    doneCriteria: "All requested mappings were previewed and applied only to the approved explicit target roots or Figma scope.",
+};
+export const RECIPE_SXL_DATA_GENERATE_INSTANCES = {
+    id: "sxl-data-generate-instances",
+    title: "SXL Data — generate instances from mapping rows",
+    version: 1,
+    context: "Agent workflow for generating repeated component instances/cards/rows from an SXL mapping and dataset. The selected Figma node is the template/container source.",
+    userPhrases: [
+        "сгенерируй инстансы из датасета",
+        "generate instances from dataset",
+        "generate instances from mapping",
+        "создай строки из датасета",
+        "render rows from mapping data",
+        "generate cards from dataset mapping",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-data-generate-instances", "mockup-builder"],
+            hint: "Use generate-instances when a mapping already exists and the selected Figma template should be duplicated. Use mockup-builder for declarative Design DSL screens.",
+        },
+        {
+            between: ["sxl-data-generate-instances", "sxl-data-apply-mapping"],
+            hint: "Use generate-instances to create new repeated nodes; use apply-mapping to fill existing selected nodes.",
+        },
+    ],
+    preferredTools: [
+        "get_plugin_status",
+        "list_mappings",
+        "get_mapping",
+        "generate_instances",
+    ],
+    forbidden: [
+        "Calling generate_instances without dryRun preview and explicit approval.",
+        "Generating rows without targetNodeIds when the intended template/container root is already known.",
+        "Hand-duplicating components through low-level canvas tools when the existing SXL generation engine should be used.",
+    ],
+    steps: [
+        "Check plugin status and writesAllowed.",
+        "List mappings and read the mapping/dataset relationship.",
+        "Use explicit targetNodeIds for the template/container root when known; otherwise confirm the active Figma selection.",
+        "Run generate_instances with dryRun:true to estimate rows and validate mapping fields.",
+        "Show requested row count, estimated generated rows, and dataset row counts.",
+        "Commit generate_instances only after approval, preferably with targetNodeIds for deterministic remote control.",
+    ],
+    doneCriteria: "Instances were generated through SXL's mapping engine after dry-run preview, with the approved row count and intended explicit targetNodeIds or confirmed active selection.",
+};
+export const RECIPE_SXL_DATABASE_TRANSFER = {
+    id: "sxl-database-transfer",
+    title: "SXL Database — portable datasets/assets/mappings payloads",
+    version: 1,
+    context: "Agent workflow for backing up, restoring, or moving SXL Studio database datasets, local assets, and mappings between files/workspaces using portable Bridge payloads.",
+    userPhrases: [
+        "экспортируй базу sxl",
+        "импортируй базу sxl",
+        "backup sxl database",
+        "restore sxl database",
+        "export database payload",
+        "import database payload",
+        "перенеси datasets assets mappings",
+    ],
+    decideBetween: [
+        {
+            between: ["sxl-database-transfer", "sxl-data-apply-mapping"],
+            hint: "Use database-transfer for moving/storing datasets/assets/mappings. Use data-apply when the goal is to fill nodes on canvas.",
+        },
+    ],
+    preferredTools: [
+        "get_plugin_status",
+        "list_datasets",
+        "list_assets",
+        "list_mappings",
+        "export_database_payload",
+        "import_database_payload",
+    ],
+    forbidden: [
+        "Importing payloads without dryRun preview.",
+        "Overwriting existing ids without confirmDestructive:true and a human-readable destructiveReason.",
+        "Including asset content in export unless the user needs a full backup/restore payload.",
+    ],
+    steps: [
+        "Check plugin status and inspect existing datasets/assets/mappings.",
+        "For backup/transfer, call export_database_payload; include asset content only when needed.",
+        "For restore/import, call import_database_payload with dryRun:true first.",
+        "Review counts, conflicts, and warnings.",
+        "Commit import only after approval; existing id conflicts require destructive confirmation and reason.",
+    ],
+    doneCriteria: "SXL database payload was exported or imported through Bridge with dry-run conflict review and no accidental overwrites.",
+};
+export const RECIPE_FIGMA_MCP_COMPANION = {
+    id: "figma-mcp-companion",
+    title: "Official Figma MCP Companion — remote-only and non-Design scopes",
+    version: 1,
+    context: "Routing recipe for official Figma MCP features that Bridge should not fake through the local SXL plugin: new-file creation, FigJam/Slides, diagram generation, and hosted remote-only workflows. Bridge can explain parity and prepare local SXL context, but the agent must call official Figma MCP tools for these capabilities.",
+    userPhrases: [
+        "figma-create-new-file",
+        "create_new_file",
+        "create a new figma file",
+        "figma-generate-diagram",
+        "generate_diagram",
+        "create a figjam diagram",
+        "figma-use-figjam",
+        "figma-use-slides",
+    ],
+    decideBetween: [
+        {
+            between: ["figma-mcp-companion", "sxl-use"],
+            hint: "Use sxl-use for the active Figma Design file, SXL plugin workflows, Figma Design asset upload, and get_libraries/search_design_system. Use companion when the request names remote-only official Figma MCP features, FigJam, Slides, or new-file creation.",
+        },
+        {
+            between: ["figma-mcp-companion", "sxl-generate-design"],
+            hint: "Use sxl-generate-design when building into an existing Figma Design file through SXL Bridge. Use companion when the first step is creating a new Figma file or using official generate_figma_design in a supported hosted MCP client.",
+        },
+    ],
+    preferredTools: [
+        "get_figma_mcp_parity",
+        "get_bridge_runtime_summary",
+        "figma_rest_diagnose",
+    ],
+    forbidden: [
+        "Pretending Bridge can create new Figma files, FigJam boards, Slides decks, or Mermaid diagrams through the local plugin.",
+        "Routing Figma Design get_libraries/search_design_system to companion without first checking Bridge get_libraries/search_design_system coverage.",
+        "Replacing official Figma MCP FigJam/Slides workflows with Figma Design canvas commands.",
+    ],
+    steps: [
+        "Call get_figma_mcp_parity to identify the exact official Figma MCP companion tool and explain why Bridge is not primary for this request.",
+        "If the request also needs SXL Studio state, call get_bridge_runtime_summary and relevant SXL reads after the official MCP step has produced/selected a Figma Design file.",
+        "Use official Figma MCP tools for create_new_file, generate_diagram, FigJam, Slides, and remote-only generate_figma_design workflows.",
+    ],
+    doneCriteria: "Agent routed the user to official Figma MCP for remote-only/non-Design work and did not claim the local SXL plugin can perform unsupported operations.",
+};
 export const RECIPE_TEMPLATE_DISCOVERY = {
     id: "template-discovery",
     title: "Find the swatch / card template inside a content frame",
@@ -356,6 +1122,7 @@ export const RECIPE_DOC_SPEC_V2 = {
     version: 1,
     context: "Doc Spec v2 lets you compose a single apply_doc_spec call from a list of sections. Each section is independent: combine only what the user asked for. Read this resource before assembling a custom spec.",
     preferredTools: ["apply_doc_spec", "build_component_doc", "bind_variable_palette", "build_doc_flow"],
+    schemaResources: ["sxl://agent/schemas/doc-spec-v2"],
     sections: [
         { type: "title", note: "Either creates a TEXT node or writes into an existing layerName." },
         { type: "description", note: "Markdown subset → formatted runs. Use **bold**, *italic*, `code`, # headings." },
@@ -494,8 +1261,8 @@ export const RECIPE_DOC_FLOW = {
     ],
     steps: [
         "Resolve each Figma URL to a node id (parseFigmaUrl handles `&node-id=` segments).",
-        "Call build_doc_flow with pages[] (each with nodeId and optional title / description).",
-        "If a page references a composition file rather than a node, call compose_from_url first to materialise it.",
+        "Call build_doc_flow with pages[] (each with nodeId or compositionFileId, plus optional title / description).",
+        "When a page references an existing composition file, pass pages[].compositionFileId directly; Bridge/plugin will generate/apply it and render an instance or clone in the flow.",
     ],
     doneCriteria: "All requested pages appear inside a single auto-layout container with optional captions; no use_figma script was used.",
 };
@@ -657,7 +1424,12 @@ export const RECIPE_AUDIT_COVERAGE = {
     version: 1,
     userPhrases: [
         "проверь везде ли подкреплены переменные",
+        "проверь на всех макетах установлены ли переменные и стили",
+        "проверь на всех ли макетах и объектах установленные переменные",
+        "проверь переменные и стили на макетах",
         "найди объекты без переменных",
+        "check whether every screen object has variables and styles assigned",
+        "check variable and style coverage across layouts",
         "audit raw values without variables",
         "review the file for missing bindings",
         "где hex заливки вместо токенов",
@@ -674,7 +1446,6 @@ export const RECIPE_AUDIT_COVERAGE = {
         "find_variable_coverage_misses",
         "audit_style_coverage",
         "find_style_coverage_misses",
-        "batch_bind_variables",
     ],
     forbidden: [
         "Walking the document manually with use_figma — audit_* tools cover the case (chunked, alias-aware).",
@@ -684,10 +1455,11 @@ export const RECIPE_AUDIT_COVERAGE = {
     steps: [
         "Start narrow: audit_variable_coverage { scope: 'page' } — confirm magnitude.",
         "If acceptable, widen: scope: 'file'.",
-        "For details / fix-up: find_variable_coverage_misses { limit, cursor } — assemble a batch_bind_variables payload from suggestion entries.",
+        "For details: find_variable_coverage_misses { limit, cursor } and find_style_coverage_misses { limit, cursor }.",
         "For style coverage do the same with audit_style_coverage / find_style_coverage_misses.",
+        "If the user asks to fix the findings, switch to auto-bind-from-audit and run apply_coverage_suggestions / apply_style_coverage_suggestions in preview mode first.",
     ],
-    doneCriteria: "Agent returned a summary (and optionally a batch_bind_variables proposal) without using use_figma. Coverage gaps are quantified per property and per page.",
+    doneCriteria: "Agent returned a read-only summary and optional paginated findings without using use_figma. Coverage gaps are quantified per property and per page; remediation is a separate dry-run-first workflow.",
 };
 export const RECIPE_BULK_VARIABLES = {
     id: "bulk-variables",
@@ -927,32 +1699,38 @@ export const RECIPE_MOCKUP_BUILDER = {
             hint: "mockup-builder = single auto-layout screen; doc-flow = multiple pages stacked side-by-side as a story.",
         },
     ],
-    context: "Phase D: thick orchestration over `figma.createInstance / setProperties / setBoundVariableForPaint / loadFontAsync`. Pipeline: (1) `find_components` to discover ids / keys + componentPropertyDefinitions; (2) `build_mockup` to assemble an auto-layout container from a declarative item tree (`instance | section | spacer | text`) with property / text / fill-binding overrides; (3) `apply_mockup_dataset` when the same template needs to be cloned per-row from a structured list.",
+    context: "Phase D: thick orchestration over `figma.createInstance / setProperties / setBoundVariableForPaint / loadFontAsync`. Pipeline: (1) `inspect_design_system` to aggregate components, variables, styles, token config, and compositions; (2) optional `find_components` to narrow ids / keys + componentPropertyDefinitions; (3) `validate_screen_spec` or `build_screen { dryRun: true }` to preview; (4) `build_screen` / `update_screen` to assemble an auto-layout container from a declarative item tree (`instance | section | spacer | text`) with property / text / fill-binding overrides; (5) `apply_mockup_dataset` when the same template needs to be cloned per-row from a structured list.",
     preferredTools: [
+        "inspect_design_system",
+        "validate_screen_spec",
+        "build_screen",
+        "update_screen",
         "find_components",
         "build_mockup",
         "apply_mockup_dataset",
         "get_variables",
     ],
+    schemaResources: ["sxl://agent/schemas/design-dsl-v1"],
     forbidden: [
-        "Calling use_figma to write a hand-rolled `figma.createInstance(...) / setProperties(...)` loop when build_mockup covers the assembly.",
-        "Guessing component names instead of running find_components first — the user's file may have arbitrary local names.",
-        "Skipping dryRun for build_mockup / apply_mockup_dataset — always preview the resolved plan before writing to canvas.",
+        "Calling use_figma to write a hand-rolled `figma.createInstance(...) / setProperties(...)` loop when build_screen/build_mockup covers the assembly.",
+        "Guessing component names instead of running inspect_design_system or find_components first — the user's file may have arbitrary local names.",
+        "Skipping dryRun for build_screen / update_screen / build_mockup / apply_mockup_dataset — always preview the resolved plan before writing to canvas.",
         "Hand-coding fill colours when a Figma Variable is available — use fillBindings { variableId } so the mockup picks up theme switches automatically.",
         "Loading fonts manually — build_mockup loads fonts on demand with a safe Inter Regular fallback.",
         "Assuming property names like `size#123:0` — pass the human key (`size`); the plugin maps to the internal `name#defId` suffix via `componentProperties`.",
     ],
     steps: [
-        "Run find_components { query | prefix?, includeProperties: true, kind?: 'COMPONENT' | 'COMPONENT_SET', limit?: 50 } to enumerate available components. Cache the (id, name, propertyDefinitions, defaultVariantId) list.",
+        "Run inspect_design_system { query | prefix?, includeProperties: true, includeRemoteInstances?: true } to aggregate components, variables, local styles, token config, and composition index.",
+        "Run find_components { query | prefix?, includeProperties: true, kind?: 'COMPONENT' | 'COMPONENT_SET', limit?: 50 } when the aggregate response needs narrowing. Cache the (id, name, propertyDefinitions, defaultVariantId) list.",
         "If the user wants library components, set includeRemoteInstances: true so library components instantiated in this file are included; otherwise stay local-only.",
         "Decide the layout: VERTICAL stack of sections, HORIZONTAL row of cards, or WRAP grid. Pick itemSpacing / padding to match the user's intent (e.g. 16px gutters).",
         "Build the items[] tree. Use `instance` for components (one of componentId | componentKey | componentName), `section` for nested auto-layout frames, `spacer` for explicit gaps, `text` for bare TEXT layers (TEXT styles can be applied via textStyleId).",
         "For property / text / fill overrides on instances: pass `properties` (human keys), `textOverrides[]` (layerName + value), `fillBindings[]` (variableId; optional layerName when only one child should receive the fill).",
-        "Call build_mockup { ..., dryRun: true } first. The plugin returns a resolved plan with per-item ok/error. If any errors → fix the spec, do not commit.",
-        "Re-call build_mockup without dryRun to write to canvas. Capture rootNodeId for downstream tools (e.g. document the mockup, run audit_variable_coverage on it).",
+        "Call validate_screen_spec or build_screen { ..., dryRun: true } first. The plugin returns a resolved plan with per-item ok/error. If any errors → fix the spec, do not commit.",
+        "Re-call build_screen without dryRun to write a new canvas root, or update_screen { targetRootId, ... } to modify an existing frame without recreating the whole screen. Capture rootNodeId for downstream tools (e.g. document the mockup, run audit_variable_coverage on it).",
         "If the user wants N cards from a dataset, leave one template instance inside the mockup (kind: 'instance'), then call apply_mockup_dataset { templateNodeId, rows[], dryRun: true } → preview → commit. removeTemplate: true deletes the placeholder after cloning.",
     ],
-    doneCriteria: "Agent produced one (or a sequence of) Phase D calls (find_components → build_mockup [dryRun → commit] → optional apply_mockup_dataset) that the plugin executed without use_figma. The user approved each diff before commit. The mockup uses real components by id/key (not duplicated geometry) and binds Figma Variables instead of raw hex when a variable is available.",
+    doneCriteria: "Agent produced one (or a sequence of) Phase D calls (inspect_design_system → validate/build_screen [dryRun → commit] → optional apply_mockup_dataset) that the plugin executed without use_figma. The user approved each diff before commit. The mockup uses real components by id/key (not duplicated geometry) and binds Figma Variables instead of raw hex when a variable is available.",
 };
 export const RECIPE_BULK_COMPOSITIONS = {
     id: "bulk-compositions",
@@ -1056,4 +1834,99 @@ export const RECIPE_COMPOSITION_DRIFT = {
     ],
     doneCriteria: "Agent returned a deterministic drift report with per-composition status. No canvas writes happened during the audit. If the user approved a fix, a follow-up bulk_generate_compositions was issued with explicit dryRun preview.",
 };
+export const ALL_AGENT_RECIPES = [
+    RECIPE_SXL_USE,
+    RECIPE_SXL_IMPLEMENT_DESIGN,
+    RECIPE_SXL_GENERATE_DESIGN,
+    RECIPE_SXL_GENERATE_LIBRARY,
+    RECIPE_SXL_CODE_CONNECT,
+    RECIPE_SXL_AUDIT,
+    RECIPE_SXL_DOC_BUILDER,
+    RECIPE_SXL_DATA_APPLY_MAPPING,
+    RECIPE_SXL_DATA_APPLY_ALL,
+    RECIPE_SXL_DATA_GENERATE_INSTANCES,
+    RECIPE_SXL_DATABASE_TRANSFER,
+    RECIPE_FIGMA_MCP_COMPANION,
+    RECIPE_DOC_TOKENS,
+    RECIPE_DOC_COMPONENT,
+    RECIPE_DOC_COMPOSITION,
+    RECIPE_DOC_FLOW,
+    RECIPE_VARIABLE_PALETTE,
+    RECIPE_DOC_SPEC_V2,
+    RECIPE_TEMPLATE_DISCOVERY,
+    RECIPE_COMPOSE_WITH_VARIABLES,
+    RECIPE_SCENARIO_FROM_MARKDOWN,
+    RECIPE_VARIABLE_USAGE,
+    RECIPE_AUDIT_COVERAGE,
+    RECIPE_FIND_UNUSED,
+    RECIPE_BULK_VARIABLES,
+    RECIPE_AUTO_BIND_FROM_AUDIT,
+    RECIPE_BULK_STYLES,
+    RECIPE_STYLE_DRIFT,
+    RECIPE_MOCKUP_BUILDER,
+    RECIPE_BULK_COMPOSITIONS,
+    RECIPE_COMPOSITION_DRIFT,
+];
+const RECIPES_BY_ID = new Map(ALL_AGENT_RECIPES.map((recipe) => [recipe.id, recipe]));
+function normalizeIntent(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}_:#/-]+/gu, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function intentTokens(input) {
+    return new Set(normalizeIntent(input)
+        .split(" ")
+        .filter((token) => token.length >= 3));
+}
+function routeScore(request, phrase) {
+    const normalizedRequest = normalizeIntent(request);
+    const normalizedPhrase = normalizeIntent(phrase);
+    if (!normalizedRequest || !normalizedPhrase)
+        return 0;
+    if (normalizedRequest.includes(normalizedPhrase))
+        return 100 + normalizedPhrase.length / 10;
+    const requestTokens = intentTokens(normalizedRequest);
+    const phraseTokens = intentTokens(normalizedPhrase);
+    if (requestTokens.size === 0 || phraseTokens.size === 0)
+        return 0;
+    let overlap = 0;
+    for (const token of phraseTokens) {
+        if (requestTokens.has(token))
+            overlap += 1;
+    }
+    return overlap === 0 ? 0 : overlap / phraseTokens.size;
+}
+export function routeAgentIntent(request, options = {}) {
+    const routes = [];
+    for (const intent of RECIPE_INDEX.userIntents) {
+        const recipe = RECIPES_BY_ID.get(intent.recipeId);
+        if (!recipe)
+            continue;
+        const scored = intent.userPhrases
+            .map((phrase) => ({ phrase, score: routeScore(request, phrase) }))
+            .filter((entry) => entry.score > 0)
+            .sort((a, b) => b.score - a.score);
+        if (scored.length === 0)
+            continue;
+        const recipeText = JSON.stringify(recipe);
+        routes.push({
+            recipeId: recipe.id,
+            title: recipe.title,
+            score: scored[0].score,
+            matchedPhrases: scored.slice(0, 3).map((entry) => entry.phrase),
+            preferredTools: recipe.preferredTools,
+            schemaResources: "schemaResources" in recipe ? recipe.schemaResources : [],
+            dryRunFirst: /dryRun/i.test(recipeText),
+            doneCriteria: recipe.doneCriteria,
+        });
+    }
+    routes.sort((a, b) => b.score - a.score || a.recipeId.localeCompare(b.recipeId));
+    return {
+        ok: true,
+        request,
+        routes: routes.slice(0, Math.max(1, Math.min(options.limit ?? 5, 10))),
+    };
+}
 //# sourceMappingURL=agent-recipes.js.map