@sxl-studio/bridge 1.4.0 → 1.5.0

package/README.md

@@ -27,7 +27,8 @@ Bridge forwards `commandType` + `payload` over WebSocket; **execution is always
 | `1.1.x` | same-era | `set_node_fill_variable`, extended `create_frame` / `create_text` (`parentId`, Auto Layout fields) |
 | `1.2.x` | same-era | Remote module split (`dispatch/`, `canvas/`, `sxl/`), MCP instructions, base canvas tools, validated `POST /api/command`, aligned `COMMAND_TIMEOUTS` |
 | **`1.3.x`** | **`2.1.0+`** | Dev Mode codegen bridge (`get_codegen`, `export_composition_json`), **full token workspace CRUD** (`create_token_file`, `delete_token_file`, `move_token_file`, `save_tokens_config`, upsert `save_token_file`), **Variables CRUD** (modes, scopes, codeSyntax), **Styles CRUD**, **orchestration** (`compose_from_url`, `generate_code_from_url`, `document_component`), **MCP Resources** (`sxl://…`), typed errors (`EDITOR_MODE_READONLY` + structured envelope), `BRIDGE_AUTH_TOKEN`, **Idempotency-Key** on `/api/command`, `/api/log` audit trail, `/api/tools` + `list_tools` meta-tool, editor-mode write-guard with typed propagation. |
-| **`1.4.x`** | **`2.1.0+`** (plugin с `apply_token_doc_spec`) | **Doc Spec v1** + `build_token_documentation` / `apply_token_doc_spec`, **MCP resources** `sxl://agent/recipes/doc-tokens` (+ doc-component, doc-composition, doc-flow), расширенные MCP-инструкции для documentation recipes. |
+| **`1.4.x`** | **`2.1.0+`** (plugin with `apply_token_doc_spec`) | **Doc Spec v1** + `build_token_documentation` / `apply_token_doc_spec`, **MCP resources** `sxl://agent/recipes/doc-tokens` (+ doc-component, doc-composition, doc-flow), expanded MCP instructions for documentation recipes. |
+| **`1.5.x`** | **`2.2.0+`** | **Doc Builder v2**: `apply_doc_spec` (generic sections), `bind_variable_palette`, `build_component_doc`, `build_doc_flow`. Intent-router resource `sxl://agent/recipes/index` plus `template-discovery`, `doc-spec-v2`. Reinforced anti-patterns in `sxl-mcp-instructions.ts` (`/tmp` payloads, base64 loaders, `use_figma` scripts). |
 
 Treat feature alignment by changelog or release tag, not npm name alone.
 

package/dist/agent-recipes.d.ts

@@ -1,36 +1,160 @@
 /**
  * Machine-readable documentation recipes for MCP resources (sxl://agent/recipes/*).
- * Keep aligned with Plugin/sxl/docs/22-doc-spec-v1.md and sxl-mcp-instructions.ts.
+ *
+ * Read order for an agent that just got a documentation request:
+ *   1. sxl://agent/recipes/index — intent router (THIS file: RECIPE_INDEX).
+ *   2. The specific recipe it points to.
+ *   3. sxl://agent/recipes/doc-spec-v2 — section vocabulary, when needed.
+ *   4. sxl://agent/recipes/template-discovery — how to find templateNodeId.
+ *
+ * Every recipe MUST list:
+ *   - userPhrases  — short sample utterances that route to it.
+ *   - decideBetween — siblings + when each wins.
+ *   - preferredTools — Bridge / direct tool names in call order.
+ *   - forbidden — concrete anti-patterns to avoid.
+ *   - steps — minimal sequence to reach doneCriteria.
+ *   - doneCriteria — verifiable success.
  */
+export declare const RECIPE_INDEX: {
+    readonly id: "index";
+    readonly title: "SXL Doc Builder — intent router";
+    readonly version: 1;
+    readonly 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.";
+    readonly userIntents: readonly [{
+        readonly recipeId: "doc-tokens";
+        readonly userPhrases: readonly ["задокументируй токены", "build a token doc", "table of token values", "fill template TEXT layers with token values", "tokenPath, layerName binding", "show DTCG paths in doc frame"];
+    }, {
+        readonly recipeId: "variable-palette";
+        readonly userPhrases: readonly ["добавь все цвета коллекции projects карточками", "render figma variable collection as cards", "swatches from local variable collection", "по коллекции переменных нарисуй палитру", "fill content with one card per variable"];
+    }, {
+        readonly recipeId: "doc-component";
+        readonly userPhrases: readonly ["задокументируй компонент", "document WButton", "component frame with variants and props", "build component doc"];
+    }, {
+        readonly recipeId: "doc-flow";
+        readonly userPhrases: readonly ["сделай flow по этим ссылкам", "build a multi-page scenario", "screen flow doc", "story of pages from these urls"];
+    }, {
+        readonly recipeId: "doc-spec-v2";
+        readonly userPhrases: readonly ["сложная документация: title + variants + props + palette", "mix sections in one frame", "custom doc spec"];
+    }, {
+        readonly recipeId: "template-discovery";
+        readonly userPhrases: readonly ["find the card template inside content frame", "локализуй карточку-шаблон в content", "where is the swatch template node"];
+    }];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["doc-tokens", "variable-palette"];
+        readonly use_doc_tokens_when: "data source is DTCG token files in the plugin workspace (paths like core.color.fg)";
+        readonly use_variable_palette_when: "data source is local Figma Variables (no DTCG file behind them)";
+    }, {
+        readonly between: readonly ["doc-component", "doc-spec-v2"];
+        readonly use_doc_component_when: "single Figma component / component set with default sections (title + variants + props)";
+        readonly use_doc_spec_v2_when: "user wants a custom mix of sections, or several non-component artefacts in one frame";
+    }];
+    readonly forbidden: readonly ["Calling use_figma with a hand-written figma.* script when an SXL Bridge tool covers the task.", "Shell payload assembly to /tmp/*.json + base64 loaders + node -e glue to invoke MCP.", "Hand-crafting composition / token / Doc Spec JSON when the plugin pipeline (export_composition_json / list_compositions / get_variables) is the source of truth.", "Skipping this index and jumping straight to a sub-recipe without confirming intent."];
+    readonly doneCriteria: "Agent picked exactly one recipe, called only the tools it lists, and produced a verifiable result (doneWhen of that recipe).";
+};
+export declare const RECIPE_TEMPLATE_DISCOVERY: {
+    readonly id: "template-discovery";
+    readonly title: "Find the swatch / card template inside a content frame";
+    readonly version: 1;
+    readonly context: "Many doc tasks (variable-palette, doc-spec-v2.palette, doc-component.variants) need a templateNodeId — an existing scene node we can clone. This recipe shows how to locate it deterministically without scripts.";
+    readonly userPhrases: readonly ["find template card in content", "locate swatch template", "templateNodeId под content фрейма"];
+    readonly preferredTools: readonly ["get_node_tree", "find_nodes", "get_node_info", "read_node_properties"];
+    readonly forbidden: readonly ["Cloning the entire content frame instead of one card.", "Guessing node ids — always verify via get_node_tree / find_nodes.", "Falling back to use_figma to traverse the file: get_node_tree returns enough info for SXL templates."];
+    readonly steps: readonly ["From the user URL, parse node-id (`figma.com/design/.../?node-id=151-2` → `151:2`).", "Call get_node_tree with that nodeId and depth=4 to inspect the frame and its content.", "Pick the first child of the content layer (or one named 'card', 'swatch', 'token-card' — let the user confirm if ambiguous).", "Read swatch / label / value layer names with get_node_tree (depth=2 from the picked card) and pass them to bind_variable_palette / palette section."];
+    readonly doneCriteria: "templateNodeId + swatchLayerName (and optionally labelLayerName / valueLayerName) confirmed against the file before any clone.";
+};
+export declare const RECIPE_DOC_SPEC_V2: {
+    readonly id: "doc-spec-v2";
+    readonly title: "Doc Spec v2 — sections vocabulary";
+    readonly version: 1;
+    readonly 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.";
+    readonly preferredTools: readonly ["apply_doc_spec", "build_component_doc", "bind_variable_palette", "build_doc_flow"];
+    readonly sections: readonly [{
+        readonly type: "title";
+        readonly note: "Either creates a TEXT node or writes into an existing layerName.";
+    }, {
+        readonly type: "description";
+        readonly note: "Markdown subset → formatted runs. Use **bold**, *italic*, `code`, # headings.";
+    }, {
+        readonly type: "variants";
+        readonly note: "ComponentSet → matrix / grid / list of instances. Use groupBy for matrix rows.";
+    }, {
+        readonly type: "props";
+        readonly note: "componentPropertyDefinitions → table TEXT block. include filters which kinds.";
+    }, {
+        readonly type: "tokenTable";
+        readonly note: "v1 surface preserved: layerName + tokenPath. Picks values from DTCG workspace.";
+    }, {
+        readonly type: "palette";
+        readonly note: "Local Figma Variables → cards by cloning templateNodeId.";
+    }, {
+        readonly type: "measure";
+        readonly note: "Experimental: node.annotations = [...].";
+    }];
+    readonly forbidden: readonly ["Generating section types not in the schema (the validator rejects them).", "Using `palette.collectionName` for a DTCG file path — palette only inspects local Figma Variables.", "Putting v1 fields (`groups`, `version: \"1\"`) into a v2 spec — use apply_token_doc_spec for v1."];
+    readonly steps: readonly ["Decide which sections are needed (intent router → user request).", "Resolve targetRootId (existing frame) or targetParentId (with createIfMissing).", "Call apply_doc_spec with the assembled spec; rely on per-section reports for partial failures."];
+    readonly doneCriteria: "apply_doc_spec returns ok=true (or section-level report shows which section failed and why).";
+};
 export declare const RECIPE_DOC_TOKENS: {
     readonly id: "doc-tokens";
-    readonly title: "Token documentation (Doc Spec v1)";
-    readonly version: 1;
-    readonly preferredTools: readonly ["list_token_files", "get_token_file_content", "build_token_documentation", "apply_token_doc_spec", "duplicate_subtree", "apply_documentation_payload"];
-    readonly forbidden: readonly ["Hand-written DTCG or composition JSON as the source of truth — use export_variables / plugin workspace files.", "Raw Figma plugin scripts in the repo for one-off doc builds — use Bridge + whitelist commands."];
-    readonly steps: readonly ["Read sxl://tokens/config and sxl://tokens/files (or list_token_files) to locate token files.", "In Figma Design mode, duplicate a documentation template frame (e.g. from your DS library) to get targetRootId.", "Build a Doc Spec v1 JSON: version \"1\", groups[].rows with layerName (TEXT layer name) and tokenPath (DTCG path).", "Call build_token_documentation with { spec, targetRootId } (or apply_token_doc_spec with the same).", "On unresolved paths, check tokenPath spelling and that files are loaded in the plugin workspace."];
-    readonly doneWhen: "TEXT layers under targetRootId show resolved values; apply_token_doc_spec returns ok and updated > 0 (unless dryRun).";
+    readonly title: "Token documentation (Doc Spec v1 / v2 tokenTable)";
+    readonly version: 2;
+    readonly userPhrases: readonly ["задокументируй токены", "fill doc template with token values", "table of DTCG paths and resolved values"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["doc-tokens", "variable-palette"];
+        readonly hint: "If the data source is local Figma variables (no DTCG file), switch to variable-palette.";
+    }];
+    readonly preferredTools: readonly ["list_token_files", "get_token_file_content", "build_token_documentation", "apply_token_doc_spec", "apply_doc_spec", "duplicate_subtree"];
+    readonly forbidden: readonly ["Hand-written DTCG / composition JSON as the source of truth — use plugin workspace files.", "Raw figma.* JS / use_figma scripts to traverse tokens — Bridge has list_token_files + get_token_file_content.", "Copy-pasting token values into the spec instead of letting the plugin resolve them."];
+    readonly steps: readonly ["Read sxl://tokens/config and sxl://tokens/files (or list_token_files) to locate token files.", "In Figma Design mode duplicate the doc template (or use an existing one) to obtain targetRootId.", "Build Doc Spec v1 (groups[].rows with layerName + tokenPath) — or v2 with a single tokenTable section if you also need title / description.", "Call build_token_documentation / apply_token_doc_spec (v1) or apply_doc_spec (v2) with { spec, targetRootId }.", "On unresolved paths re-check tokenPath spelling and confirm files are present in the workspace."];
+    readonly doneCriteria: "TEXT layers under targetRootId show resolved values; the response reports updated > 0 and no unresolved paths (unless dryRun).";
 };
 export declare const RECIPE_DOC_COMPONENT: {
     readonly id: "doc-component";
-    readonly title: "Component documentation";
-    readonly version: 1;
-    readonly preferredTools: readonly ["export_composition_json", "get_codegen", "document_component", "apply_documentation_payload", "create_component_instance"];
-    readonly forbidden: readonly ["Synthesising composition JSON from get_node_tree — use export_composition_json or get_codegen (designer-json)."];
-    readonly steps: readonly ["Select the component (or pass nodeId) and call get_codegen / export_composition_json for authoritative JSON.", "Use document_component or apply_documentation_payload with targetRootId and entries [{ layerName, text }] to fill a template frame."];
+    readonly title: "Component documentation (title + variants + props + optional measure)";
+    readonly version: 2;
+    readonly userPhrases: readonly ["задокументируй компонент", "document this component", "WButton documentation frame", "build component doc"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["doc-component", "doc-spec-v2"];
+        readonly hint: "If you need anything beyond title/description/variants/props/measure (e.g. palette, tokenTable), pick doc-spec-v2 + apply_doc_spec.";
+    }];
+    readonly preferredTools: readonly ["build_component_doc", "apply_doc_spec", "export_composition_json", "get_codegen", "duplicate_subtree"];
+    readonly forbidden: readonly ["Synthesising composition JSON from get_node_tree — use export_composition_json / get_codegen.", "Calling use_figma to read componentPropertyDefinitions — the plugin already exposes it via build_component_doc.", "Mutating the component itself when documenting it — work on the doc frame, not the source."];
+    readonly steps: readonly ["Identify the component (componentNodeId). For a component set, pass the set id.", "Provide either targetRootId (existing doc frame) or targetParentId (createIfMissing=true).", "Call build_component_doc; toggle includeMeasure only if the user asked for size annotations.", "Refine specific sections (e.g. update description markdown) by re-running with new payload."];
+    readonly doneCriteria: "The doc frame contains a title, a variants matrix (when applicable), and a props table with all componentPropertyDefinitions.";
     readonly phases: "Measuring/annotations: see Plugin/sxl/docs/23-doc-agent-phased-roadmap.md (Phase 3).";
 };
 export declare const RECIPE_DOC_COMPOSITION: {
     readonly id: "doc-composition";
     readonly title: "Documentation from composition file";
-    readonly version: 1;
+    readonly version: 2;
+    readonly userPhrases: readonly ["render this composition file as documentation", "доку по composition.json", "build a frame from a composition file"];
     readonly preferredTools: readonly ["list_compositions", "export_composition_json", "generate_composition", "apply_composition", "compose_from_url"];
-    readonly steps: readonly ["Prefer compose_from_url or export_composition_json → create_token_file → generate_composition to materialise the layout.", "Do not hand-assemble the composition tree; the plugin pipeline is the single source of truth."];
+    readonly forbidden: readonly ["Hand-assembling composition trees in JSON — the plugin pipeline is the single source of truth.", "Using use_figma to draw the composition manually."];
+    readonly steps: readonly ["Prefer compose_from_url for a Figma URL → export_composition_json → create_token_file → generate_composition.", "Apply with apply_composition / generate_composition; do not hand-construct nodes."];
+    readonly doneCriteria: "Composition file in workspace + generated component / instance on the canvas matching the source.";
 };
 export declare const RECIPE_DOC_FLOW: {
     readonly id: "doc-flow";
-    readonly title: "Multi-page screen flow";
-    readonly version: 1;
-    readonly preferredTools: readonly ["compose_from_url", "generate_composition", "export_composition_json", "get_codegen"];
-    readonly steps: readonly ["For each screen, use a Figma URL with node-id or export_composition_json from the source node.", "Chain composition saves and generate_composition; avoid ad-hoc canvas scripts for full flows (see Phase 4 roadmap)."];
+    readonly title: "Multi-page screen flow / scenario";
+    readonly version: 2;
+    readonly userPhrases: readonly ["сделай flow по этим ссылкам", "build a screen flow doc", "story of pages from these urls", "scenario doc with multiple frames"];
+    readonly preferredTools: readonly ["build_doc_flow", "compose_from_url", "duplicate_subtree", "apply_doc_spec"];
+    readonly forbidden: readonly ["Calling use_figma to clone many frames into one container — use build_doc_flow.", "Skipping captions when the user provided a description per page — pass them via pages[].title / description."];
+    readonly steps: readonly ["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."];
+    readonly doneCriteria: "All requested pages appear inside a single auto-layout container with optional captions; no use_figma script was used.";
+};
+export declare const RECIPE_VARIABLE_PALETTE: {
+    readonly id: "variable-palette";
+    readonly title: "Color (or variable) cards from a Figma variable collection";
+    readonly version: 2;
+    readonly userPhrases: readonly ["добавь все цвета коллекции projects карточками", "render figma variable collection as cards", "swatches from local variable collection", "по коллекции переменных нарисуй палитру"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["variable-palette", "doc-tokens"];
+        readonly hint: "If user names a DTCG file or token path (`core.color.*`), switch to doc-tokens.";
+    }];
+    readonly context: "Example: fill a frame's content with one card per COLOR variable in the Projects collection, using an existing card component / instance as template.";
+    readonly preferredTools: readonly ["get_plugin_status", "get_variables", "get_node_tree", "find_nodes", "bind_variable_palette", "apply_doc_spec"];
+    readonly forbidden: readonly ["use_figma (official Figma MCP) with a custom JavaScript payload — SXL session cannot execute that in the plugin; bind_variable_palette covers the same flow.", "Shell payloads (/tmp/*.json, base64 loaders, copy-paste into tokens/system, node -e glue) to invoke MCP — pass JSON directly to bind_variable_palette.", "Pretending the task requires a 'Figma script' when get_variables + bind_variable_palette is enough."];
+    readonly steps: readonly ["get_plugin_status — confirm writesAllowed (Figma Design, not Dev Mode read-only).", "Use sxl://agent/recipes/template-discovery to locate templateNodeId + swatchLayerName under the user's content frame.", "Call bind_variable_palette with { templateNodeId, collectionName, variableType: 'COLOR', swatchLayerName, labelLayerName? }.", "Inspect the response: created should equal the variable count; bound should equal created (one fill bind per swatch)."];
+    readonly doneCriteria: "One card per target variable next to the template; each swatch is bound to its variable; no use_figma script was used.";
 };

package/dist/agent-recipes.js

@@ -1,56 +1,241 @@
 /**
  * Machine-readable documentation recipes for MCP resources (sxl://agent/recipes/*).
- * Keep aligned with Plugin/sxl/docs/22-doc-spec-v1.md and sxl-mcp-instructions.ts.
+ *
+ * Read order for an agent that just got a documentation request:
+ *   1. sxl://agent/recipes/index — intent router (THIS file: RECIPE_INDEX).
+ *   2. The specific recipe it points to.
+ *   3. sxl://agent/recipes/doc-spec-v2 — section vocabulary, when needed.
+ *   4. sxl://agent/recipes/template-discovery — how to find templateNodeId.
+ *
+ * Every recipe MUST list:
+ *   - userPhrases  — short sample utterances that route to it.
+ *   - decideBetween — siblings + when each wins.
+ *   - preferredTools — Bridge / direct tool names in call order.
+ *   - forbidden — concrete anti-patterns to avoid.
+ *   - steps — minimal sequence to reach doneCriteria.
+ *   - doneCriteria — verifiable success.
  */
+export const RECIPE_INDEX = {
+    id: "index",
+    title: "SXL Doc Builder — intent router",
+    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: "doc-tokens",
+            userPhrases: [
+                "задокументируй токены",
+                "build a token doc",
+                "table of token values",
+                "fill template TEXT layers with token values",
+                "tokenPath, layerName binding",
+                "show DTCG paths in doc frame",
+            ],
+        },
+        {
+            recipeId: "variable-palette",
+            userPhrases: [
+                "добавь все цвета коллекции projects карточками",
+                "render figma variable collection as cards",
+                "swatches from local variable collection",
+                "по коллекции переменных нарисуй палитру",
+                "fill content with one card per variable",
+            ],
+        },
+        {
+            recipeId: "doc-component",
+            userPhrases: [
+                "задокументируй компонент",
+                "document WButton",
+                "component frame with variants and props",
+                "build component doc",
+            ],
+        },
+        {
+            recipeId: "doc-flow",
+            userPhrases: [
+                "сделай flow по этим ссылкам",
+                "build a multi-page scenario",
+                "screen flow doc",
+                "story of pages from these urls",
+            ],
+        },
+        {
+            recipeId: "doc-spec-v2",
+            userPhrases: [
+                "сложная документация: title + variants + props + palette",
+                "mix sections in one frame",
+                "custom doc spec",
+            ],
+        },
+        {
+            recipeId: "template-discovery",
+            userPhrases: [
+                "find the card template inside content frame",
+                "локализуй карточку-шаблон в content",
+                "where is the swatch template node",
+            ],
+        },
+    ],
+    decideBetween: [
+        {
+            between: ["doc-tokens", "variable-palette"],
+            use_doc_tokens_when: "data source is DTCG token files in the plugin workspace (paths like core.color.fg)",
+            use_variable_palette_when: "data source is local Figma Variables (no DTCG file behind them)",
+        },
+        {
+            between: ["doc-component", "doc-spec-v2"],
+            use_doc_component_when: "single Figma component / component set with default sections (title + variants + props)",
+            use_doc_spec_v2_when: "user wants a custom mix of sections, or several non-component artefacts in one frame",
+        },
+    ],
+    forbidden: [
+        "Calling use_figma with a hand-written figma.* script when an SXL Bridge tool covers the task.",
+        "Shell payload assembly to /tmp/*.json + base64 loaders + node -e glue to invoke MCP.",
+        "Hand-crafting composition / token / Doc Spec JSON when the plugin pipeline (export_composition_json / list_compositions / get_variables) is the source of truth.",
+        "Skipping this index and jumping straight to a sub-recipe without confirming intent.",
+    ],
+    doneCriteria: "Agent picked exactly one recipe, called only the tools it lists, and produced a verifiable result (doneWhen of that recipe).",
+};
+export const RECIPE_TEMPLATE_DISCOVERY = {
+    id: "template-discovery",
+    title: "Find the swatch / card template inside a content frame",
+    version: 1,
+    context: "Many doc tasks (variable-palette, doc-spec-v2.palette, doc-component.variants) need a templateNodeId — an existing scene node we can clone. This recipe shows how to locate it deterministically without scripts.",
+    userPhrases: [
+        "find template card in content",
+        "locate swatch template",
+        "templateNodeId под content фрейма",
+    ],
+    preferredTools: [
+        "get_node_tree",
+        "find_nodes",
+        "get_node_info",
+        "read_node_properties",
+    ],
+    forbidden: [
+        "Cloning the entire content frame instead of one card.",
+        "Guessing node ids — always verify via get_node_tree / find_nodes.",
+        "Falling back to use_figma to traverse the file: get_node_tree returns enough info for SXL templates.",
+    ],
+    steps: [
+        "From the user URL, parse node-id (`figma.com/design/.../?node-id=151-2` → `151:2`).",
+        "Call get_node_tree with that nodeId and depth=4 to inspect the frame and its content.",
+        "Pick the first child of the content layer (or one named 'card', 'swatch', 'token-card' — let the user confirm if ambiguous).",
+        "Read swatch / label / value layer names with get_node_tree (depth=2 from the picked card) and pass them to bind_variable_palette / palette section.",
+    ],
+    doneCriteria: "templateNodeId + swatchLayerName (and optionally labelLayerName / valueLayerName) confirmed against the file before any clone.",
+};
+export const RECIPE_DOC_SPEC_V2 = {
+    id: "doc-spec-v2",
+    title: "Doc Spec v2 — sections vocabulary",
+    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"],
+    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." },
+        { type: "variants", note: "ComponentSet → matrix / grid / list of instances. Use groupBy for matrix rows." },
+        { type: "props", note: "componentPropertyDefinitions → table TEXT block. include filters which kinds." },
+        { type: "tokenTable", note: "v1 surface preserved: layerName + tokenPath. Picks values from DTCG workspace." },
+        { type: "palette", note: "Local Figma Variables → cards by cloning templateNodeId." },
+        { type: "measure", note: "Experimental: node.annotations = [...]." },
+    ],
+    forbidden: [
+        "Generating section types not in the schema (the validator rejects them).",
+        "Using `palette.collectionName` for a DTCG file path — palette only inspects local Figma Variables.",
+        "Putting v1 fields (`groups`, `version: \"1\"`) into a v2 spec — use apply_token_doc_spec for v1.",
+    ],
+    steps: [
+        "Decide which sections are needed (intent router → user request).",
+        "Resolve targetRootId (existing frame) or targetParentId (with createIfMissing).",
+        "Call apply_doc_spec with the assembled spec; rely on per-section reports for partial failures.",
+    ],
+    doneCriteria: "apply_doc_spec returns ok=true (or section-level report shows which section failed and why).",
+};
 export const RECIPE_DOC_TOKENS = {
     id: "doc-tokens",
-    title: "Token documentation (Doc Spec v1)",
-    version: 1,
+    title: "Token documentation (Doc Spec v1 / v2 tokenTable)",
+    version: 2,
+    userPhrases: [
+        "задокументируй токены",
+        "fill doc template with token values",
+        "table of DTCG paths and resolved values",
+    ],
+    decideBetween: [
+        {
+            between: ["doc-tokens", "variable-palette"],
+            hint: "If the data source is local Figma variables (no DTCG file), switch to variable-palette.",
+        },
+    ],
     preferredTools: [
         "list_token_files",
         "get_token_file_content",
         "build_token_documentation",
         "apply_token_doc_spec",
+        "apply_doc_spec",
         "duplicate_subtree",
-        "apply_documentation_payload",
     ],
     forbidden: [
-        "Hand-written DTCG or composition JSON as the source of truth — use export_variables / plugin workspace files.",
-        "Raw Figma plugin scripts in the repo for one-off doc builds — use Bridge + whitelist commands.",
+        "Hand-written DTCG / composition JSON as the source of truth — use plugin workspace files.",
+        "Raw figma.* JS / use_figma scripts to traverse tokens — Bridge has list_token_files + get_token_file_content.",
+        "Copy-pasting token values into the spec instead of letting the plugin resolve them.",
     ],
     steps: [
         "Read sxl://tokens/config and sxl://tokens/files (or list_token_files) to locate token files.",
-        "In Figma Design mode, duplicate a documentation template frame (e.g. from your DS library) to get targetRootId.",
-        "Build a Doc Spec v1 JSON: version \"1\", groups[].rows with layerName (TEXT layer name) and tokenPath (DTCG path).",
-        "Call build_token_documentation with { spec, targetRootId } (or apply_token_doc_spec with the same).",
-        "On unresolved paths, check tokenPath spelling and that files are loaded in the plugin workspace.",
+        "In Figma Design mode duplicate the doc template (or use an existing one) to obtain targetRootId.",
+        "Build Doc Spec v1 (groups[].rows with layerName + tokenPath) — or v2 with a single tokenTable section if you also need title / description.",
+        "Call build_token_documentation / apply_token_doc_spec (v1) or apply_doc_spec (v2) with { spec, targetRootId }.",
+        "On unresolved paths re-check tokenPath spelling and confirm files are present in the workspace.",
     ],
-    doneWhen: "TEXT layers under targetRootId show resolved values; apply_token_doc_spec returns ok and updated > 0 (unless dryRun).",
+    doneCriteria: "TEXT layers under targetRootId show resolved values; the response reports updated > 0 and no unresolved paths (unless dryRun).",
 };
 export const RECIPE_DOC_COMPONENT = {
     id: "doc-component",
-    title: "Component documentation",
-    version: 1,
+    title: "Component documentation (title + variants + props + optional measure)",
+    version: 2,
+    userPhrases: [
+        "задокументируй компонент",
+        "document this component",
+        "WButton documentation frame",
+        "build component doc",
+    ],
+    decideBetween: [
+        {
+            between: ["doc-component", "doc-spec-v2"],
+            hint: "If you need anything beyond title/description/variants/props/measure (e.g. palette, tokenTable), pick doc-spec-v2 + apply_doc_spec.",
+        },
+    ],
     preferredTools: [
+        "build_component_doc",
+        "apply_doc_spec",
         "export_composition_json",
         "get_codegen",
-        "document_component",
-        "apply_documentation_payload",
-        "create_component_instance",
+        "duplicate_subtree",
     ],
     forbidden: [
-        "Synthesising composition JSON from get_node_tree — use export_composition_json or get_codegen (designer-json).",
+        "Synthesising composition JSON from get_node_tree — use export_composition_json / get_codegen.",
+        "Calling use_figma to read componentPropertyDefinitions — the plugin already exposes it via build_component_doc.",
+        "Mutating the component itself when documenting it — work on the doc frame, not the source.",
     ],
     steps: [
-        "Select the component (or pass nodeId) and call get_codegen / export_composition_json for authoritative JSON.",
-        "Use document_component or apply_documentation_payload with targetRootId and entries [{ layerName, text }] to fill a template frame.",
+        "Identify the component (componentNodeId). For a component set, pass the set id.",
+        "Provide either targetRootId (existing doc frame) or targetParentId (createIfMissing=true).",
+        "Call build_component_doc; toggle includeMeasure only if the user asked for size annotations.",
+        "Refine specific sections (e.g. update description markdown) by re-running with new payload.",
     ],
+    doneCriteria: "The doc frame contains a title, a variants matrix (when applicable), and a props table with all componentPropertyDefinitions.",
     phases: "Measuring/annotations: see Plugin/sxl/docs/23-doc-agent-phased-roadmap.md (Phase 3).",
 };
 export const RECIPE_DOC_COMPOSITION = {
     id: "doc-composition",
     title: "Documentation from composition file",
-    version: 1,
+    version: 2,
+    userPhrases: [
+        "render this composition file as documentation",
+        "доку по composition.json",
+        "build a frame from a composition file",
+    ],
     preferredTools: [
         "list_compositions",
         "export_composition_json",
@@ -58,19 +243,74 @@ export const RECIPE_DOC_COMPOSITION = {
         "apply_composition",
         "compose_from_url",
     ],
+    forbidden: [
+        "Hand-assembling composition trees in JSON — the plugin pipeline is the single source of truth.",
+        "Using use_figma to draw the composition manually.",
+    ],
     steps: [
-        "Prefer compose_from_url or export_composition_json → create_token_file → generate_composition to materialise the layout.",
-        "Do not hand-assemble the composition tree; the plugin pipeline is the single source of truth.",
+        "Prefer compose_from_url for a Figma URL → export_composition_json → create_token_file → generate_composition.",
+        "Apply with apply_composition / generate_composition; do not hand-construct nodes.",
     ],
+    doneCriteria: "Composition file in workspace + generated component / instance on the canvas matching the source.",
 };
 export const RECIPE_DOC_FLOW = {
     id: "doc-flow",
-    title: "Multi-page screen flow",
-    version: 1,
-    preferredTools: ["compose_from_url", "generate_composition", "export_composition_json", "get_codegen"],
+    title: "Multi-page screen flow / scenario",
+    version: 2,
+    userPhrases: [
+        "сделай flow по этим ссылкам",
+        "build a screen flow doc",
+        "story of pages from these urls",
+        "scenario doc with multiple frames",
+    ],
+    preferredTools: ["build_doc_flow", "compose_from_url", "duplicate_subtree", "apply_doc_spec"],
+    forbidden: [
+        "Calling use_figma to clone many frames into one container — use build_doc_flow.",
+        "Skipping captions when the user provided a description per page — pass them via pages[].title / description.",
+    ],
+    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.",
+    ],
+    doneCriteria: "All requested pages appear inside a single auto-layout container with optional captions; no use_figma script was used.",
+};
+export const RECIPE_VARIABLE_PALETTE = {
+    id: "variable-palette",
+    title: "Color (or variable) cards from a Figma variable collection",
+    version: 2,
+    userPhrases: [
+        "добавь все цвета коллекции projects карточками",
+        "render figma variable collection as cards",
+        "swatches from local variable collection",
+        "по коллекции переменных нарисуй палитру",
+    ],
+    decideBetween: [
+        {
+            between: ["variable-palette", "doc-tokens"],
+            hint: "If user names a DTCG file or token path (`core.color.*`), switch to doc-tokens.",
+        },
+    ],
+    context: "Example: fill a frame's content with one card per COLOR variable in the Projects collection, using an existing card component / instance as template.",
+    preferredTools: [
+        "get_plugin_status",
+        "get_variables",
+        "get_node_tree",
+        "find_nodes",
+        "bind_variable_palette",
+        "apply_doc_spec",
+    ],
+    forbidden: [
+        "use_figma (official Figma MCP) with a custom JavaScript payload — SXL session cannot execute that in the plugin; bind_variable_palette covers the same flow.",
+        "Shell payloads (/tmp/*.json, base64 loaders, copy-paste into tokens/system, node -e glue) to invoke MCP — pass JSON directly to bind_variable_palette.",
+        "Pretending the task requires a 'Figma script' when get_variables + bind_variable_palette is enough.",
+    ],
     steps: [
-        "For each screen, use a Figma URL with node-id or export_composition_json from the source node.",
-        "Chain composition saves and generate_composition; avoid ad-hoc canvas scripts for full flows (see Phase 4 roadmap).",
+        "get_plugin_status — confirm writesAllowed (Figma Design, not Dev Mode read-only).",
+        "Use sxl://agent/recipes/template-discovery to locate templateNodeId + swatchLayerName under the user's content frame.",
+        "Call bind_variable_palette with { templateNodeId, collectionName, variableType: 'COLOR', swatchLayerName, labelLayerName? }.",
+        "Inspect the response: created should equal the variable count; bound should equal created (one fill bind per swatch).",
     ],
+    doneCriteria: "One card per target variable next to the template; each swatch is bound to its variable; no use_figma script was used.",
 };
 //# sourceMappingURL=agent-recipes.js.map

package/dist/agent-recipes.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-recipes.js","sourceRoot":"","sources":["../src/agent-recipes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,mCAAmC;IAC1C,OAAO,EAAE,CAAC;IACV,cAAc,EAAE;QACd,kBAAkB;QAClB,wBAAwB;QACxB,2BAA2B;QAC3B,sBAAsB;QACtB,mBAAmB;QACnB,6BAA6B;KAC9B;IACD,SAAS,EAAE;QACT,+GAA+G;QAC/G,gGAAgG;KACjG;IACD,KAAK,EAAE;QACL,8FAA8F;QAC9F,iHAAiH;QACjH,oHAAoH;QACpH,qGAAqG;QACrG,kGAAkG;KACnG;IACD,QAAQ,EAAE,uHAAuH;CACzH,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,yBAAyB;IAChC,OAAO,EAAE,CAAC;IACV,cAAc,EAAE;QACd,yBAAyB;QACzB,aAAa;QACb,oBAAoB;QACpB,6BAA6B;QAC7B,2BAA2B;KAC5B;IACD,SAAS,EAAE;QACT,gHAAgH;KACjH;IACD,KAAK,EAAE;QACL,8GAA8G;QAC9G,qIAAqI;KACtI;IACD,MAAM,EAAE,sFAAsF;CACtF,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,EAAE,EAAE,iBAAiB;IACrB,KAAK,EAAE,qCAAqC;IAC5C,OAAO,EAAE,CAAC;IACV,cAAc,EAAE;QACd,mBAAmB;QACnB,yBAAyB;QACzB,sBAAsB;QACtB,mBAAmB;QACnB,kBAAkB;KACnB;IACD,KAAK,EAAE;QACL,0HAA0H;QAC1H,+FAA+F;KAChG;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,wBAAwB;IAC/B,OAAO,EAAE,CAAC;IACV,cAAc,EAAE,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,aAAa,CAAC;IACtG,KAAK,EAAE;QACL,gGAAgG;QAChG,qHAAqH;KACtH;CACO,CAAC"}
+{"version":3,"file":"agent-recipes.js","sourceRoot":"","sources":["../src/agent-recipes.ts"],"names":[],"mappings":"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"}

package/dist/command-queue.js

@@ -20,6 +20,10 @@ export const BRIDGE_COMMAND_TIMEOUT_MS = {
     duplicate_subtree: 60_000,
     apply_documentation_payload: 45_000,
     apply_token_doc_spec: 45_000,
+    apply_doc_spec: 90_000,
+    bind_variable_palette: 90_000,
+    build_component_doc: 120_000,
+    build_doc_flow: 120_000,
     generate_instances: 30_000,
     reapply_token_bindings: 30_000,
     reapply_compositions: 60_000,

package/dist/command-queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-queue.js","sourceRoot":"","sources":["../src/command-queue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-queue.js","sourceRoot":"","sources":["../src/command-queue.ts"],"names":[],"mappings":"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"}

package/dist/mcp-factory.js

@@ -25,7 +25,7 @@ export function createBridgeMcpServer(commandQueue) {
     }
     const server = new McpServer({
         name: "@sxl-studio/bridge",
-        version: "1.4.0",
+        version: "1.5.0",
     }, {
         instructions: SXL_BRIDGE_MCP_INSTRUCTIONS,
     });