paper-mono 0.62.0

package/tools.contract.json

@@ -0,0 +1,1748 @@
+{
+  "schemaVersion": "mono-tools.v1",
+  "specialist": "paper",
+  "ownerCommand": "paper mono",
+  "agentHome": "~/.paper/agent",
+  "domain": {
+    "comment": "REQ: Paper Desktop design-to-code agent CLI powered by the Paper MCP bridge at http://127.0.0.1:29979/mcp.",
+    "toolIds": [
+      "paper_get_basic_info",
+      "paper_get_selection",
+      "paper_get_node_info",
+      "paper_get_children",
+      "paper_get_tree_summary",
+      "paper_get_screenshot",
+      "paper_get_jsx",
+      "paper_get_computed_styles",
+      "paper_get_fill_image",
+      "paper_get_font_family_info",
+      "paper_get_guide",
+      "paper_find_placement",
+      "paper_mcp_reachability_check",
+      "paper_style_tokens_extract",
+      "paper_materialize_system_direction",
+      "paper_create_page",
+      "paper_open_page",
+      "paper_rename_nodes",
+      "paper_revise_artboard",
+      "paper_delete_nodes",
+      "paper_find_nodes",
+      "paper_get_tokens",
+      "paper_capture_provenance",
+      "paper_create_tokens",
+      "paper_set_tokens",
+      "paper_write_html",
+      "paper_move_nodes"
+    ]
+  },
+  "tools": [
+    {
+      "id": "paper_get_basic_info",
+      "version": 1,
+      "label": "Paper: Get Basic Info",
+      "description": "Get file name, page name, node count, and list of artboards with dimensions from the currently open Paper file.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-basic-info"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use as the first read when grounding in the open Paper file.",
+        "If Paper Desktop is not running, fall back to fixtures or ask the operator to open a file."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_basic_info-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_selection",
+      "version": 1,
+      "label": "Paper: Get Selection",
+      "description": "Get details about the currently selected nodes in Paper Desktop (IDs, names, types, size, artboard). Use this to see what the user is pointing at.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-selection"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use when the user refers to 'this' or 'selected' without naming a node.",
+        "Returns empty selection when no nodes are selected; do not invent selected nodes."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_selection-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_node_info",
+      "version": 1,
+      "label": "Paper: Get Node Info",
+      "description": "Get details for a specific node by ID: size, visibility, lock state, parent, children, text content.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-node-info"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use after get_selection or get_tree_summary to inspect a specific node.",
+        "If the node ID does not exist, report the exact MCP error without guessing."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_node_info-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_children",
+      "version": 1,
+      "label": "Paper: Get Children",
+      "description": "Get direct children of a node: IDs, names, types, and child counts.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-children"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use to walk the layer tree one level at a time.",
+        "Respect maxItems; paginate large artboards via repeated calls if the MCP supports it."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_children-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_tree_summary",
+      "version": 1,
+      "label": "Paper: Get Tree Summary",
+      "description": "Get a bounded summary of one targeted subtree. Depth defaults to 4 and must be 1 through 8; start from an artboard or smaller subtree instead of a Snapshot-scale document root.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 165000,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-tree-summary"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Start from basic info, then target one artboard or subtree instead of the document root.",
+        "Depth defaults to 4 and accepts only integers from 1 through 8; retry a suppressed result with a shallower depth or smaller subtree."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_tree_summary-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_screenshot",
+      "version": 1,
+      "label": "Paper: Get Screenshot",
+      "description": "Screenshot one targeted artboard or node. Start with scale 1; use scale 2 only for a specific detail after the scale-1 read is insufficient.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 8400000,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-screenshot"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Target one artboard or node and start with scale 1; do not begin with a full Snapshot page at scale 2.",
+        "Decoded image data over 6291456 bytes is suppressed whole with a narrower-retry receipt."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_screenshot-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_jsx",
+      "version": 1,
+      "label": "Paper: Get JSX",
+      "description": "Get JSX for one targeted node and its descendants. Request an artboard section or smaller subtree rather than a full Snapshot page; choose 'tailwind' or 'inline' styles.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 165000,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-jsx"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Read one implementation-relevant subtree at a time and summarize it before requesting another.",
+        "UTF-8 text over 163840 bytes is suppressed whole; retry with a smaller subtree instead of requesting a full Snapshot page."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_jsx-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_computed_styles",
+      "version": 1,
+      "label": "Paper: Get Computed Styles",
+      "description": "Get exact computed CSS values for 1 through 50 targeted nodes. Read only the subtree nodes needed for the current implementation decision.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 165000,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-computed-styles"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use 1 through 50 exact node IDs from the current subtree; never request styles for the entire document.",
+        "UTF-8 text over 163840 bytes is suppressed whole; retry with fewer node IDs and summarize the relevant decisions."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_computed_styles-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_fill_image",
+      "version": 1,
+      "label": "Paper: Get Fill Image",
+      "description": "Get image data from one exact node already confirmed to have an image fill. Avoid broad reference roots; the result is base64 JPEG data.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 8400000,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-fill-image"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use only on one exact node already confirmed to have an image fill.",
+        "Decoded image data over 6291456 bytes is suppressed whole; retry the exact smaller fill node or use a targeted scale 1 screenshot."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_fill_image-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_font_family_info",
+      "version": 1,
+      "label": "Paper: Get Font Info",
+      "description": "Look up whether a font family is available on the user's machine or Google Fonts. Inspect weights and styles.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-font-family-info"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use to decide whether a font can be used directly or needs a fallback.",
+        "Consider Google Fonts availability as a hint, not a guarantee, without network proof."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_font_family_info-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_guide",
+      "version": 1,
+      "label": "Paper: Get Guide",
+      "description": "Retrieve guided workflow documentation for a topic (e.g., 'figma-import' for Figma import steps).",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-guide"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use when the operator asks about Paper-specific workflows.",
+        "Do not invent guide content; only return what the MCP provides."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_guide-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_find_placement",
+      "version": 1,
+      "label": "Paper: Find Placement",
+      "description": "Get suggested x/y coordinates on the canvas to place a new artboard without overlapping existing ones.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-find-placement"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use before creating a new artboard to avoid overlaps.",
+        "The returned coordinates are suggestions; the operator may override them."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_find_placement-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_mcp_reachability_check",
+      "version": 1,
+      "label": "Paper: MCP Reachability Check",
+      "description": "Check whether Paper Desktop's MCP server is reachable on http://127.0.0.1:29979/mcp. Use before other Paper tools to decide whether to use live Paper state or a fixture.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-doctor"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [
+          "http://127.0.0.1:29979/mcp"
+        ],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-mcp-reachability-check"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Call this before any other Paper tool to decide whether live Paper state is available.",
+        "If unreachable, explain the exact failure (app not running vs transport/schema error)."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_mcp_reachability_check-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_style_tokens_extract",
+      "version": 1,
+      "label": "Paper: Extract Style Tokens",
+      "description": "Extract design tokens (colors, typography, spacing, fonts) from one or more Paper nodes by reading computed styles and font metadata, then emit a JSON token file. Useful for grounding code implementation in actual Paper styles.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "mono-fleet-era:paper-tool-contract",
+        "audit:paper-reads"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-style-tokens-extract"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Use to ground code implementation in actual Paper styles.",
+        "Dry-run first; live extraction requires an approved absolute project-local output path."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_style_tokens_extract-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_materialize_system_direction",
+      "version": 1,
+      "label": "Paper: Materialize System Direction",
+      "description": "Create a new, non-destructive system-direction artboard from literal inline HTML, place it without overlap, screenshot the result, and return an execution receipt. Always dry-run first.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "campaign-20260725-specialist-excellence:paper-showpiece",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Operator approval after a successful dry run"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-materialize-system-direction-dry-run"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Run with dryRun=true first and show the five-step receipt before requesting approval.",
+        "Create a new adjacent artboard; never replace source artboards.",
+        "Treat the returned screenshot as the live materialization proof."
+      ],
+      "safetyContract": {
+        "modes": [
+          "dry_run",
+          "confirm-gate"
+        ],
+        "guarantees": {
+          "dry_run": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          },
+          "confirm-gate": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "confirm-gated",
+            "requiresConfirmation": true
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_materialize_system_direction-dry-run-safety",
+          "./tool-walk/safety-fixtures.json#paper_materialize_system_direction-confirm-gate-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 24576,
+          "maxLines": 300
+        }
+      }
+    },
+    {
+      "id": "paper_create_page",
+      "version": 1,
+      "label": "Paper: Create Page",
+      "description": "Create one explicitly named page in an explicit Paper file and return its page ID. This does not open, rename, overwrite, or delete any page.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "goal-paper-guarded-page-operator:create",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Explicit file ID and non-empty page name"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 4096,
+        "maxItems": 1
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-create-page"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Require an explicit file ID and non-empty page name; never infer either target.",
+        "Return the provider-created page ID and keep creation separate from opening.",
+        "Do not delete, rename, overwrite, or auto-select an existing same-name page."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_create_page-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 4096,
+          "maxLines": 80
+        }
+      }
+    },
+    {
+      "id": "paper_open_page",
+      "version": 1,
+      "label": "Paper: Open Page",
+      "description": "Open an explicit Paper file and page, then return a receipt only when Paper reports that exact target as active. This cannot infer a target or alter page contents.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "goal-paper-guarded-page-operator:open",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Explicit file ID and page ID"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 4096,
+        "maxItems": 1
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-open-page"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Require explicit file and page IDs; never infer the active target.",
+        "Treat open_file basic-info output as proof only when it reports the requested file and page.",
+        "Keep opening separate from page creation so partial completion remains reportable."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_open_page-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 4096,
+          "maxLines": 80
+        }
+      }
+    },
+    {
+      "id": "paper_rename_nodes",
+      "version": 1,
+      "label": "Paper: Rename Nodes Safely",
+      "description": "Rename exactly the listed Paper nodes through a dry-run and explicit-confirmation receipt. This cannot edit styles, content, hierarchy, or delete nodes. Targets not created in this process session and active file require sourceAcknowledgement='rename-source'.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "goal-paper-operator-control:rename",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Operator approval after a successful dry run"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-rename-nodes-dry-run"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Run with dryRun=true first and review the exact node IDs and replacement names.",
+        "Use confirm=true for a live rename; add sourceAcknowledgement='rename-source' for targets not created in this process session and active file.",
+        "Use only for names; it cannot change styles, content, hierarchy, or delete nodes."
+      ],
+      "safetyContract": {
+        "modes": [
+          "dry_run",
+          "confirm-gate"
+        ],
+        "guarantees": {
+          "dry_run": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          },
+          "confirm-gate": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "confirm-gated",
+            "requiresConfirmation": true
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_rename_nodes-dry-run-safety",
+          "./tool-walk/safety-fixtures.json#paper_rename_nodes-confirm-gate-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 24576,
+          "maxLines": 300
+        }
+      }
+    },
+    {
+      "id": "paper_revise_artboard",
+      "version": 1,
+      "label": "Paper: Revise Artboard Safely",
+      "description": "Replace only the children of one existing Paper artboard from validated literal inline-CSS HTML, then screenshot the result. This cannot replace the artboard root or touch siblings. Artboards not created in this process session and active file require sourceAcknowledgement='revise-source'.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "goal-paper-operator-control:revise",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Operator approval after a successful dry run"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-revise-artboard-dry-run"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Run with dryRun=true first and review the target artboard and literal HTML.",
+        "Use confirm=true for a live revision; add sourceAcknowledgement='revise-source' for an artboard not created in this process session and active file.",
+        "Use literal inline-CSS HTML only; the tool replaces children, preserves the artboard root, and screenshots the result."
+      ],
+      "safetyContract": {
+        "modes": [
+          "dry_run",
+          "confirm-gate"
+        ],
+        "guarantees": {
+          "dry_run": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          },
+          "confirm-gate": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "confirm-gated",
+            "requiresConfirmation": true
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_revise_artboard-dry-run-safety",
+          "./tool-walk/safety-fixtures.json#paper_revise_artboard-confirm-gate-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 24576,
+          "maxLines": 300
+        }
+      }
+    },
+    {
+      "id": "paper_delete_nodes",
+      "version": 1,
+      "label": "Paper: Delete Nodes Safely",
+      "description": "Delete exactly the listed Paper nodes and descendants after a dry run, explicit confirmation, named-node preflight, and absence verification. This cannot delete root or page nodes. Targets not created in this process session and active file require sourceAcknowledgement='delete-source'.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "goal-paper-operator-control:delete",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Operator approval after a successful dry run"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-delete-nodes-dry-run"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Run with dryRun=true first and review every exact node ID before deletion.",
+        "Use confirm=true for a live delete; add sourceAcknowledgement='delete-source' for targets not created in this process session and active file.",
+        "The tool refuses root/page nodes, preflights names, and verifies each deleted ID returns not-found."
+      ],
+      "safetyContract": {
+        "modes": [
+          "dry_run",
+          "confirm-gate"
+        ],
+        "guarantees": {
+          "dry_run": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          },
+          "confirm-gate": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "confirm-gated",
+            "requiresConfirmation": true
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_delete_nodes-dry-run-safety",
+          "./tool-walk/safety-fixtures.json#paper_delete_nodes-confirm-gate-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 24576,
+          "maxLines": 300
+        }
+      }
+    },
+    {
+      "id": "paper_find_nodes",
+      "version": 1,
+      "label": "Paper: Find Nodes Safely",
+      "description": "Find Paper nodes by computed-style filters and/or text in an explicitly targeted file. scopeId must be an exact node ID; the belt preflights it and rejects names or stale IDs instead of returning a misleading empty result.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "paper-belt-20260825:item-9",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-find-nodes"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Pass fileId to bind the query to the intended Paper file.",
+        "Pass scopeId only after obtaining an actual node ID from a Paper read; names are rejected loudly."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_find_nodes-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_get_tokens",
+      "version": 1,
+      "label": "Paper: Get Tokens",
+      "description": "List the explicit file's flat design-token namespace in JSON, CSS, or Tailwind format. Paper currently supports breakpoint, color, container, fontFamily, fontSize, fontWeight, letterSpacing, lineHeight, radius, and spacing only; it has no shadow/duration/easing types or theme dimension.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "paper-belt-20260825:item-2",
+        "audit:paper-reads"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 100
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-get-tokens"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Pass fileId even though reads remain optional for provider compatibility.",
+        "Paper currently exposes a flat token namespace and ten provider token types; it does not expose modes."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_get_tokens-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 24576,
+          "maxLines": 300
+        }
+      }
+    },
+    {
+      "id": "paper_capture_provenance",
+      "version": 1,
+      "label": "Paper: Prepare Capture Provenance",
+      "description": "Prepare a deterministic Paper capture/import name and provenance record before capture. The generated <=50-character artboardName carries route, viewport, theme, and UTC date; the receipt retains the full source URL for a sidecar manifest.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "paper-belt-20260825:item-11",
+        "audit:capture-provenance"
+      ],
+      "safety": "read",
+      "requires": {
+        "allOf": [],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 12288,
+        "maxItems": 50
+      },
+      "doctorProbe": "none",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-capture-provenance"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Call before importing every browser or device capture and use the returned artboardName instead of Frame.",
+        "Persist the returned provenance sidecar with the capture receipt."
+      ],
+      "safetyContract": {
+        "modes": [
+          "mock"
+        ],
+        "guarantees": {
+          "mock": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_capture_provenance-mock-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 12288,
+          "maxLines": 200
+        }
+      }
+    },
+    {
+      "id": "paper_create_tokens",
+      "version": 1,
+      "label": "Paper: Create Tokens Safely",
+      "description": "Create file-scoped Paper design tokens through dry-run, explicit confirmation, and a per-entry receipt. The belt rejects unsupported types and known provider-invalid color-mix()/size-alias expressions before transport.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "paper-belt-20260825:item-2",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Operator approval after a successful dry run"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 100
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-create-tokens-dry-run"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Run with dryRun=true first; live creation requires fileId and confirm=true.",
+        "Supported types are breakpoint, color, container, fontFamily, fontSize, fontWeight, letterSpacing, lineHeight, radius, and spacing.",
+        "Paper does not currently support shadow, duration, easing, token modes, color-mix(), or var() aliases for radius, spacing, and fontSize."
+      ],
+      "safetyContract": {
+        "modes": [
+          "dry_run",
+          "confirm-gate"
+        ],
+        "guarantees": {
+          "dry_run": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          },
+          "confirm-gate": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "confirm-gated",
+            "requiresConfirmation": true
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_create_tokens-dry-run-safety",
+          "./tool-walk/safety-fixtures.json#paper_create_tokens-confirm-gate-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 24576,
+          "maxLines": 300
+        }
+      }
+    },
+    {
+      "id": "paper_set_tokens",
+      "version": 1,
+      "label": "Paper: Set Tokens Safely",
+      "description": "Rename, update, describe, or delete existing file-scoped Paper tokens through dry-run, explicit confirmation, source-token acknowledgement, and preserved per-entry results.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "paper-belt-20260825:item-2",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Operator approval and sourceAcknowledgement='set-source-tokens' after a successful dry run"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 100
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-set-tokens-dry-run"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Run with dryRun=true first; live updates require fileId, confirm=true, and sourceAcknowledgement='set-source-tokens'.",
+        "The belt rejects expression values conservatively because set_tokens does not report token type in its input schema."
+      ],
+      "safetyContract": {
+        "modes": [
+          "dry_run",
+          "confirm-gate"
+        ],
+        "guarantees": {
+          "dry_run": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          },
+          "confirm-gate": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "confirm-gated",
+            "requiresConfirmation": true
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_set_tokens-dry-run-safety",
+          "./tool-walk/safety-fixtures.json#paper_set_tokens-confirm-gate-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 24576,
+          "maxLines": 300
+        }
+      }
+    },
+    {
+      "id": "paper_write_html",
+      "version": 1,
+      "label": "Paper: Write HTML Safely",
+      "description": "Insert one incremental inline-HTML item under an exact target after dry-run and confirmation. The receipt always surfaces the provider response as payload.createdNodes (for example {createdNodes:[{id,name}]}); replacement is intentionally handled by paper_revise_artboard.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "paper-belt-20260825:item-4",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Operator approval and sourceAcknowledgement='write-source' after a successful dry run"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 100
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-write-html-dry-run"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Only insert-children mode is exposed; broad raw write_html remains private.",
+        "Run with dryRun=true first; live insertion requires fileId, confirm=true, and sourceAcknowledgement='write-source'.",
+        "Use payload.createdNodes from the receipt and never guess generated IDs."
+      ],
+      "safetyContract": {
+        "modes": [
+          "dry_run",
+          "confirm-gate"
+        ],
+        "guarantees": {
+          "dry_run": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          },
+          "confirm-gate": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "confirm-gated",
+            "requiresConfirmation": true
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_write_html-dry-run-safety",
+          "./tool-walk/safety-fixtures.json#paper_write_html-confirm-gate-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 24576,
+          "maxLines": 300
+        }
+      }
+    },
+    {
+      "id": "paper_move_nodes",
+      "version": 1,
+      "label": "Paper: Move Nodes Safely",
+      "description": "Move exact node IDs through dry-run, confirmation, and a receipt while preserving identity. Every live destination must be separately typed and fingerprinted in the approved brief; the root alias and unverified cross-page roots are rejected by the public runtime. The receipt surfaces resolved moves and affectedParents.",
+      "handlerRef": "./src/core/tools/paper-mcp.ts#paperTools",
+      "sourcePack": null,
+      "demandRefs": [
+        "paper-belt-20260825:item-10",
+        "audit:paper-mutations"
+      ],
+      "safety": "mutate",
+      "requires": {
+        "allOf": [
+          "Paper Desktop running at http://127.0.0.1:29979/mcp",
+          "Operator approval and sourceAcknowledgement='move-source' after a successful dry run"
+        ],
+        "anyOf": [],
+        "cli": [
+          "paper mono"
+        ],
+        "endpoint": [],
+        "optional": false
+      },
+      "inputSchemaRef": "./src/core/tools/paper-mcp.ts",
+      "output": {
+        "envelope": "mono-tool-result.v1",
+        "maxBytes": 24576,
+        "maxItems": 100
+      },
+      "doctorProbe": "endpoint",
+      "cases": [
+        "./tool-walk/fixtures.json#paper-move-nodes-dry-run"
+      ],
+      "cliFallback": null,
+      "guidelines": [
+        "Run with dryRun=true first; live moves require fileId, confirm=true, and sourceAcknowledgement='move-source'.",
+        "Declare every live destination separately in paperTarget.moveDestinations and retain payload.affectedParents as the receipt."
+      ],
+      "safetyContract": {
+        "modes": [
+          "dry_run",
+          "confirm-gate"
+        ],
+        "guarantees": {
+          "dry_run": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "forbidden",
+            "requiresConfirmation": false
+          },
+          "confirm-gate": {
+            "networkSpend": "forbidden",
+            "filesystemWrites": "none",
+            "filesystemRoots": [],
+            "externalMutations": "confirm-gated",
+            "requiresConfirmation": true
+          }
+        },
+        "fixtureRefs": [
+          "./tool-walk/safety-fixtures.json#paper_move_nodes-dry-run-safety",
+          "./tool-walk/safety-fixtures.json#paper_move_nodes-confirm-gate-safety"
+        ],
+        "outputBudget": {
+          "maxBytes": 24576,
+          "maxLines": 300
+        }
+      }
+    }
+  ]
+}