mirror of
https://github.com/webstudio-is/webstudio.git
synced 2026-10-23 03:27:27 +09:00
Oleg IsonenandClaude Fable 5
071a4d9a85
## Summary This update adds new MCP and CLI capabilities for project auditing, structured data, project-specific agent instructions, focused project search, safer bulk editing, image descriptions, font discovery, visual verification, and external registry inspection. ## New Capabilities ### Audit projects - Run a single `audit` command across accessibility, SEO, security, assets, styles, and performance. - Limit an audit to selected scopes, pages, or severity levels. - Receive stable findings with locations and suggested fixes. - Run rendered audits across desktop, mobile, and Builder breakpoint widths. - Detect horizontal overflow, broken images, oversized images, eager below-fold images, render-blocking resources, and legacy font formats. - Identify unused assets, tokens, CSS variables, local styles, and breakpoints. - Identify duplicate token declarations. - Detect accessibility issues involving names, labels, headings, landmarks, IDs, keyboard focus, ARIA, iframes, and autoplaying media. - Detect SEO issues involving titles, descriptions, language, social images, and structured data. - Detect unsafe new-tab links and write resources exposed during page rendering. ### Search an entire project - Search project text, labels, props, resources, assets, and styles through `search-project`. - Find relevant records without downloading and reparsing the full project snapshot. - Scope searches to the relevant project-data areas. ### Add validated JSON-LD - Add structured data with a dedicated JSON-LD component. - Place JSON-LD inside the page Head Slot. - Edit JSON in a purpose-built code editor. - Prevent structurally invalid JSON-LD from being saved. - Validate Schema.org types, properties, and values. - Find invalid, missing, unknown, deprecated, or incompatible structured data through the SEO audit. - Let agents discover the correct JSON-LD workflow without using page custom metadata or a generic HTML embed. ### Configure project-specific agent instructions - Add AI-agent instructions from the new **Agents** section in Project Settings. - Synchronize those instructions into a managed root `AGENTS.md`. - Update or remove the managed file automatically during project sync. - Protect existing user-owned `AGENTS.md` files from being overwritten. - Share the instructions with authenticated CLI and MCP agents. - Keep agent instructions out of publicly readable production bundles. ### Generate and manage image descriptions - Audit image assets for missing descriptions. - Let a vision-capable agent inspect each image in its rendered context. - Save generated descriptions to multiple image assets in one operation. - Mark images as intentionally decorative. - Reuse the saved asset description wherever the image is used. - Re-run the audit to verify that missing-description findings are resolved. ### Perform bounded bulk replacements - Replace matching literal text across selected pages with `replace-text`. - Replace matching fixed prop text with `replace-prop-text`. - Replace matching resource names or URLs with `replace-resource-text`. - Restrict replacements by page, instance, prop, resource, field, match mode, and maximum change count. - Leave dynamic expressions unchanged. ### Inspect element ancestry - Return an element’s direct parent in instance listings. - Request the complete ancestor chain when inspecting an element. - Understand tree placement without rebuilding the instance hierarchy from raw project data. ### Discover available fonts - List uploaded font families through `list-fonts`. - Discover available system font stacks. - Inspect font family, style, weight, format, and associated asset information before applying typography. ### Inspect external component registries - Inspect a local or remote shadcn-style registry item. - Read its description, files, dependencies, targets, and documentation. - Receive an explicit Webstudio compatibility report. - Inspect registry metadata without installing or executing external code. ### Capture generated project routes directly - Run `webstudio screenshot --path /route` against the configured project. - Generate a temporary production-style preview automatically. - Capture the requested route. - Stop the temporary preview after capture. - Avoid manually building and starting a preview for a single screenshot. ### Assert visual changes - Add expected text to screenshot comparisons. - Set maximum pixel mismatch limits. - Set minimum or maximum changed-region counts. - Assert whether overall brightness or a color channel moved in the expected direction. - Use these assertions as pass/fail evidence for visual changes. ### Require compatible CLI versions - Send the project-bundle contract version with CLI synchronization requests. - Stop incompatible CLI versions before they receive incomplete project data. - Tell users exactly how to update the CLI or run the latest version once. - Prevent older clients from silently dropping project settings. ## Upgrade Note This branch introduces a new synchronized project-bundle contract. Older CLI versions must update before synchronizing against the new API. ```sh npm install -g webstudio@latest ``` Or run the latest version once: ```sh npx webstudio@latest <command> ``` --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
211 lines
5.0 KiB
JSON
211 lines
5.0 KiB
JSON
{
|
|
"bundleVersion": "bundle-u14gh7",
|
|
"build": {
|
|
"id": "8f0fdff2-e76b-4f86-9203-ea7df5f1143c",
|
|
"projectId": "8a7358b1-7de3-459d-b7b1-56dddfb6ce1e",
|
|
"version": 7,
|
|
"createdAt": "2026-01-04T10:46:48.415+00:00",
|
|
"updatedAt": "2026-01-04T10:46:48.415+00:00",
|
|
"pages": {
|
|
"homePageId": "Y60VJnVZMU_ifI0GnAR1N",
|
|
"rootFolderId": "root",
|
|
"pages": [
|
|
{
|
|
"id": "Y60VJnVZMU_ifI0GnAR1N",
|
|
"name": "Home",
|
|
"title": "\"Home\"",
|
|
"rootInstanceId": "iavYtlaxaMTf7HB5DBf8e",
|
|
"systemDataSourceId": "XE93KQdVwfiA3TCf8hQAQ",
|
|
"meta": {},
|
|
"path": ""
|
|
},
|
|
{
|
|
"id": "fOBamlMdmM461hLaITmV7",
|
|
"name": "Untitled",
|
|
"title": "\"Untitled\"",
|
|
"rootInstanceId": "6dkXcbi85BtasJdJdkV9L",
|
|
"meta": {
|
|
"description": "\"\"",
|
|
"excludePageFromSearch": "true",
|
|
"language": "\"\"",
|
|
"socialImageUrl": "\"\"",
|
|
"status": "302",
|
|
"redirect": "\"/\"",
|
|
"documentType": "html",
|
|
"custom": [
|
|
{
|
|
"property": "",
|
|
"content": "\"\""
|
|
}
|
|
]
|
|
},
|
|
"marketplace": {
|
|
"include": false
|
|
},
|
|
"path": "/redirect"
|
|
}
|
|
],
|
|
"pageTemplates": [],
|
|
"folders": [
|
|
{
|
|
"id": "root",
|
|
"name": "Root",
|
|
"slug": "",
|
|
"children": ["Y60VJnVZMU_ifI0GnAR1N", "fOBamlMdmM461hLaITmV7"]
|
|
}
|
|
]
|
|
},
|
|
"breakpoints": [
|
|
[
|
|
"pTyOZEX5PG52onfyt3-Vg",
|
|
{
|
|
"id": "pTyOZEX5PG52onfyt3-Vg",
|
|
"label": "Base"
|
|
}
|
|
],
|
|
[
|
|
"GzBytedsc258Pp7rh1hiD",
|
|
{
|
|
"id": "GzBytedsc258Pp7rh1hiD",
|
|
"label": "Tablet",
|
|
"maxWidth": 991
|
|
}
|
|
],
|
|
[
|
|
"ugRM71O_Lm78kMKjkrtyz",
|
|
{
|
|
"id": "ugRM71O_Lm78kMKjkrtyz",
|
|
"label": "Mobile landscape",
|
|
"maxWidth": 767
|
|
}
|
|
],
|
|
[
|
|
"NKdYAYw-oxmW8laNbpiwK",
|
|
{
|
|
"id": "NKdYAYw-oxmW8laNbpiwK",
|
|
"label": "Mobile portrait",
|
|
"maxWidth": 479
|
|
}
|
|
]
|
|
],
|
|
"styles": [],
|
|
"styleSources": [],
|
|
"styleSourceSelections": [],
|
|
"props": [],
|
|
"instances": [
|
|
[
|
|
"iavYtlaxaMTf7HB5DBf8e",
|
|
{
|
|
"type": "instance",
|
|
"id": "iavYtlaxaMTf7HB5DBf8e",
|
|
"component": "Body",
|
|
"children": [
|
|
{
|
|
"type": "id",
|
|
"value": "cenhRks51W1S2iJMoGmqx"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
[
|
|
"cenhRks51W1S2iJMoGmqx",
|
|
{
|
|
"type": "instance",
|
|
"id": "cenhRks51W1S2iJMoGmqx",
|
|
"component": "Heading",
|
|
"children": [
|
|
{
|
|
"type": "text",
|
|
"value": "FIXTURE-CLIENT-DO-NOT-TOUCH"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
[
|
|
"6dkXcbi85BtasJdJdkV9L",
|
|
{
|
|
"type": "instance",
|
|
"id": "6dkXcbi85BtasJdJdkV9L",
|
|
"component": "ws:element",
|
|
"tag": "body",
|
|
"children": []
|
|
}
|
|
]
|
|
],
|
|
"dataSources": [
|
|
[
|
|
"XE93KQdVwfiA3TCf8hQAQ",
|
|
{
|
|
"type": "parameter",
|
|
"id": "XE93KQdVwfiA3TCf8hQAQ",
|
|
"scopeInstanceId": "iavYtlaxaMTf7HB5DBf8e",
|
|
"name": "system"
|
|
}
|
|
]
|
|
],
|
|
"resources": [],
|
|
"projectSettings": {
|
|
"meta": {},
|
|
"compiler": {}
|
|
},
|
|
"deployment": {
|
|
"destination": "saas",
|
|
"domains": ["fixture-client-do-not-touch-wsmel"],
|
|
"assetsDomain": "fixture-client-do-not-touch-wsmel",
|
|
"excludeWstdDomainFromSearch": false
|
|
}
|
|
},
|
|
"page": {
|
|
"id": "Y60VJnVZMU_ifI0GnAR1N",
|
|
"name": "Home",
|
|
"title": "\"Home\"",
|
|
"rootInstanceId": "iavYtlaxaMTf7HB5DBf8e",
|
|
"systemDataSourceId": "XE93KQdVwfiA3TCf8hQAQ",
|
|
"meta": {},
|
|
"path": ""
|
|
},
|
|
"pages": [
|
|
{
|
|
"id": "Y60VJnVZMU_ifI0GnAR1N",
|
|
"name": "Home",
|
|
"title": "\"Home\"",
|
|
"rootInstanceId": "iavYtlaxaMTf7HB5DBf8e",
|
|
"systemDataSourceId": "XE93KQdVwfiA3TCf8hQAQ",
|
|
"meta": {},
|
|
"path": ""
|
|
},
|
|
{
|
|
"id": "fOBamlMdmM461hLaITmV7",
|
|
"name": "Untitled",
|
|
"title": "\"Untitled\"",
|
|
"rootInstanceId": "6dkXcbi85BtasJdJdkV9L",
|
|
"meta": {
|
|
"description": "\"\"",
|
|
"excludePageFromSearch": "true",
|
|
"language": "\"\"",
|
|
"socialImageUrl": "\"\"",
|
|
"status": "302",
|
|
"redirect": "\"/\"",
|
|
"documentType": "html",
|
|
"custom": [
|
|
{
|
|
"property": "",
|
|
"content": "\"\""
|
|
}
|
|
]
|
|
},
|
|
"marketplace": {
|
|
"include": false
|
|
},
|
|
"path": "/redirect"
|
|
}
|
|
],
|
|
"assets": [],
|
|
"user": {
|
|
"email": "hello@webstudio.is"
|
|
},
|
|
"projectDomain": "fixture-client-do-not-touch-wsmel",
|
|
"projectTitle": "FIXTURE-CLIENT-DO-NOT-TOUCH",
|
|
"origin": "https://main.development.webstudio.is"
|
|
}
|