Skip to content

docs(agent-mcp): note CLI is required when DESIGN_DATA_CONFIG is set - #1557

Merged
GarthDB merged 2 commits into
mainfrom
docs/h890.35-mcp-cli-requirement
Oct 20, 2026
Merged

GarthDB merged 2 commits into
mainfrom
docs/h890.35-mcp-cli-requirement

Conversation

@GarthDB

@GarthDB GarthDB commented Oct 19, 2026

Copy link
Copy Markdown
Member

Description

Corrects tools/design-data-agent-mcp/README.md: the design-data CLI is needed not only for authoring_session_step_intent but also whenever DESIGN_DATA_CONFIG is set, because the platform cascade runs design-data catalog export. It also states the minimum version (0.13.0) and the Homebrew install. Adds a patch changeset for @adobe/design-data-agent-mcp.

Related Issue

Beads spectrum-design-data-h890.35 (verify design-data-cli 0.13.0 release and Homebrew bump). Follow-up for the stale "cargo install" text in release notes: spectrum-design-data-8om7.

Motivation and Context

While verifying the 0.13.0 release, the README line "CLI is only needed for authoring_session_step_intent" contradicted cascade-bootstrap.js and the README's own platform cascade section. Users setting DESIGN_DATA_CONFIG with an older or missing CLI would hit a failure the README didn't predict.

How Has This Been Tested?

  • Release verified: tag design-data-cli@0.13.0, 4 binaries + SHA256SUMS (shasum -c OK), Homebrew PR chore(homebrew): bump design-data formula to 0.13.0 #1556 merged with matching sha256, ruby -c Formula/design-data.rb OK.
  • Clean env -i shell: brew update, tap, brew install adobe/spectrum-design-data/design-data, design-data --version → 0.13.0, brew test passed.
  • design-data catalog export --out <tmp> --platform react-spectrum wrote components/ (97) and guidelines/ (58 + manifest).
  • Published @adobe/design-data-agent-mcp@latest over stdio with DESIGN_DATA_CONFIG and DESIGN_DATA_PLATFORM=react-spectrum: cascade resolved, read-only describe_component returned button.
  • node tools/changeset-linter/src/cli.js check --fail-on-warnings: passed.

Screenshots (if appropriate):

N/A

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Documentation-only change.

Checklist:

  • I have signed the Adobe Open Source CLA.
  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@changeset-bot

changeset-bot Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 569a676

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@adobe/design-data-agent-mcp Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Run report for 569a676f

Total time: 979.3ms | Comparison time: 878.6ms | Estimated loss: 100.6ms (10.3% slower)

Action Time Status Info
⬛️ SetupProto(0.57.4) 0ms Skipped
🟩 SyncWorkspace 10.2ms Passed
🟩 SyncProject(root) 0.7ms Passed
⬛️ SetupToolchain(node:20.17.0) 226.5ms Skipped
⬛️ SetupToolchain(pnpm:10.17.1) 150.1ms Skipped
⬛️ SetupToolchain(javascript) 0ms Skipped
🟩 SetupEnvironment(javascript) 0.6ms Passed
⬛️ InstallDependencies(javascript) 0.1ms Skipped
🟩 RunTask(root:ai-check) 591.4ms Passed
Changed files
.changeset/mcp-readme-cli-requirement.md
tools/design-data-agent-mcp/README.md

@github-actions

Copy link
Copy Markdown
Contributor

🎨 Token Changes Report

Tokens Changed (0)

Original Branch: main


This comment was automatically generated by the token diff tool. 🤖

@github-actions

Copy link
Copy Markdown
Contributor

🧩 Component Schema Changes Report

No component schema changes detected.

This comment was automatically generated by the component schema diff tool. 🤖

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@GarthDB
GarthDB merged commit 4db31e6 into main Oct 20, 2026
9 checks passed
@GarthDB
GarthDB deleted the docs/h890.35-mcp-cli-requirement branch October 20, 2026 14:58
@GarthDB GarthDB mentioned this pull request Oct 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant