Changelog

Every release of open-design-mcp, rendered at build time from CHANGELOG.md on the master branch. Link directly to a release with the version anchor, e.g. #0-17-0.

Changelog

All notable changes to this project will be documented in this file.

#[0.17.1] — 2026-05-20

Other

  • chore(openspec): archive add-design-system-workflow + update TEST_MATRIX (closes #65) (#66)

Install: npm install open-design-mcp@0.17.1

#[0.17.0] — 2026-05-20

Added

  • feat(design-system): add design-system-first workflow (closes #60) (#64)

Install: npm install open-design-mcp@0.17.0

#[0.17.0] — Unreleased

Added

  • Design-system-first workflow — new opt-in workflow for multi-page visual consistency.
  • od_generate_design_system tool — generates a design-system.html artifact (tokens + components + layout) via BYOK.
  • od_extract_design_system tool — pure function that parses a design-system.html and returns the JSON manifest + CSS blocks.
  • od_update_design_system tool — patches a design system in two modes: semantic (BYOK) or deterministic JSON delta.
  • designSystemMode argument on od_generate_design (strict/advisory/off) — controls auto-injection of the design system contract when a project has a linked system.
  • designSystemHtml argument on od_lint_artifact — enables design-system-specific static checks (DS001–DS005: missing style blocks, off-palette colors, undocumented components, new custom properties, token drift).
  • designSystemSummary argument on od_compose_brief — includes design system context in Turn 3 prompts.
  • <!-- od-lint-ignore-next-line --> escape hatch for suppressing DS lint findings.

Changed

  • Tool count: 10 → 13.
  • Integration test assertions updated to expect 13 tools.

Known Limitations

  • od_generate_design auto-injection via designSystemId linkage is currently a runtime no-op. The daemon's files-list endpoint (GET /api/projects/:id/files) returns only file metadata (name, size, modifiedAt) — not file content. When a project has a linked designSystemId, od_generate_design detects the link, looks up the file, but falls through to designSystemMode='off' and prepends an advisory HTML comment to the output instead of injecting the contract. The buildDesignSystemContract code path is implemented, tested, and wired — it activates automatically once the daemon API exposes a file-content endpoint (planned for v0.18). Until then, design system enforcement works through two fully-functional paths: (a) od_lint_artifact + designSystemHtml for post-generation static checks (DS001–DS005), and (b) od_compose_brief + designSystemSummary for including design system context in Turn 3 prompts.

#[0.16.2] — 2026-05-20

Other

  • chore(harness): add per-phase compliance checklist + autonomy override (#59)

Install: npm install open-design-mcp@0.16.2

#[0.16.1] — 2026-05-19

Other

  • chore(openspec): archive surface-customInstructions-on-get-project

Install: npm install open-design-mcp@0.16.1

#[0.16.0] — 2026-05-19

Added

  • feat: surface customInstructions on od_get_project (closes #56) (#57)

Install: npm install open-design-mcp@0.16.0

#[0.15.2] — 2026-05-19

Documentation

  • docs: refresh skill catalog + document multi-daemon pattern (closes #49) (#55)

Install: npm install open-design-mcp@0.15.2

#[0.15.1] — 2026-05-19

Other

  • chore(openspec): archive add-od-save-project-file

Install: npm install open-design-mcp@0.15.1

#[0.15.0] — 2026-05-19

Added

  • feat: add od_save_project_file MCP tool (closes #53) (#54)

Install: npm install open-design-mcp@0.15.0

#[0.14.10] — 2026-05-19

Other

  • chore: doc-drift cleanup + dynamic serverInfo.version (closes #45 #46 #47 #48) (#52)

Install: npm install open-design-mcp@0.14.10

#[0.14.9] — 2026-05-19

Documentation

  • docs: re-dogfood proof for #36 fix (truncation FIXED, 21KB→31KB, properly closed)

Install: npm install open-design-mcp@0.14.9

#[0.14.8] — 2026-05-19

Other

  • chore(openspec): archive fix-generate-design-maxtokens

Install: npm install open-design-mcp@0.14.8

#[0.14.7] — 2026-05-19

Fixed

  • fix: forward maxTokens to daemon to prevent silent truncation (closes #36) (#51)

Install: npm install open-design-mcp@0.14.7

#[0.14.6] — 2026-05-19

Documentation

  • docs: re-dogfood proof for #43 fix (Signal 4 PASS against hosted daemon)

Install: npm install open-design-mcp@0.14.6

#[0.14.5] — 2026-05-19

Other

  • chore(openspec): archive fix-custominstructions-metadata-stash

Install: npm install open-design-mcp@0.14.5

#[0.14.4] — 2026-05-19

Fixed

  • fix: stash customInstructions in metadata for daemon compat (closes #43) (#50)

Install: npm install open-design-mcp@0.14.4

#[0.14.3] — 2026-05-19

Documentation

  • docs: add v1-ships dogfood evidence (filed #43-#49)

Install: npm install open-design-mcp@0.14.3

#[0.14.2] — 2026-05-18

Other

  • chore(od-workflow-skill): bump to v0.1.1 (post-#39 sync)

Install: npm install open-design-mcp@0.14.2

#[0.14.1] — 2026-05-18

Other

  • chore(openspec): archive add-od-compose-brief

Install: npm install open-design-mcp@0.14.1

#[0.14.0] — 2026-05-18

Added

  • feat: add od_compose_brief tool — format Turn 3 prompts (closes #39) (#42)

Install: npm install open-design-mcp@0.14.0

#[0.13.1] — 2026-05-18

Other

  • chore(openspec): archive add-od-workflow-skill

Install: npm install open-design-mcp@0.13.1

#[0.13.0] — 2026-05-18

Added

  • feat: add od-workflow skill — OD playbook for OpenCode subagents (closes #38) (#41)

Other

  • chore(openspec): archive wire-project-custominstructions

Install: npm install open-design-mcp@0.13.0

#[0.12.3] — 2026-05-18

Other

  • chore(openspec): archive fix-generate-design-timeout

Install: npm install open-design-mcp@0.12.3

#[0.12.2] — 2026-05-18

Fixed

  • fix(generate-design): raise default timeout to 600s, env-configurable, partial-result recovery on abort (closes #33) (#35)

Install: npm install open-design-mcp@0.12.2

#[0.12.1] — 2026-05-18

Other

  • chore(openspec): archive add-opendesign-mcp-skill

Install: npm install open-design-mcp@0.12.1

#[0.12.0] — 2026-05-18

Added

  • feat: add open-design-mcp OpenCode skill (closes #32) (#34)

Install: npm install open-design-mcp@0.12.0

#[0.11.5] — 2026-05-18

Other

  • chore(openspec): archive docs-generate-design-flow

Install: npm install open-design-mcp@0.11.5

#[0.11.4] — 2026-05-18

Documentation

  • docs: add generate-design flow diagram + narrative (closes #30) (#31)

Install: npm install open-design-mcp@0.11.4

#[0.11.3] — 2026-05-18

Documentation

  • docs(evidence): hosted-OD smoke — all 8 tools work with basic auth

Install: npm install open-design-mcp@0.11.3

#[0.11.2] — 2026-05-18

Documentation

  • docs(evidence): live smoke transcript for project-lifecycle-tools

Install: npm install open-design-mcp@0.11.2

#[0.11.1] — 2026-05-18

Other

  • chore(openspec): archive project-lifecycle-tools

Install: npm install open-design-mcp@0.11.1

#[0.11.0] — 2026-05-18

Added

  • feat(project-lifecycle-tools): add od_create/update/delete_project (closes #28) (#29)

Install: npm install open-design-mcp@0.11.0

#[0.10.4] — 2026-05-18

Other

  • chore(openspec): archive fix-401-mode-aware-hint

Install: npm install open-design-mcp@0.10.4

#[0.10.3] — 2026-05-18

Fixed

  • fix(errors): emit mode-aware 401 hint (closes #25) (#27)

Install: npm install open-design-mcp@0.10.3

#[0.10.2] — 2026-05-18

Documentation

  • docs(evidence): live smoke transcript for od-auth-modes against hosted OD

Install: npm install open-design-mcp@0.10.2

#[0.10.1] — 2026-05-18

Other

  • chore(openspec): archive od-auth-modes change

Install: npm install open-design-mcp@0.10.1

#[0.10.0] — 2026-05-18

Added

  • feat(od-auth-modes): support HTTP Basic Auth for hosted OD daemons (closes #23) (#24)

Install: npm install open-design-mcp@0.10.0

#[0.9.0] — 2026-05-18

Added

  • feat(byok-pipeline-tool): PR-F — live smoke, README, archive (closes #12) (#22)

Install: npm install open-design-mcp@0.9.0

#[0.8.0] — 2026-05-18

Added

  • feat(byok-pipeline-tool): activate od_generate_design BYOK streaming (PR-E, #11) (#21)

Install: npm install open-design-mcp@0.8.0

#[0.7.0] — 2026-05-18

Added

  • feat(byok-pipeline-tool): activate write/validation MCP tools (PR-D, #10) (#20)

Install: npm install open-design-mcp@0.7.0

#[0.6.0] — 2026-05-18

Added

  • feat(byok-pipeline-tool): activate read-only MCP tools (PR-C, #9) (#19)

Install: npm install open-design-mcp@0.6.0

#[0.5.1] — 2026-05-18

Other

  • chore(byok-pipeline-tool): add typed OD HTTP client (PR-B, #8) (#18)

Install: npm install open-design-mcp@0.5.1

#[0.5.0] — 2026-05-18

Documentation

  • docs(harness): add HB-8 + adjust byok-pipeline-tool PR-F version expectation (#16) (#17)

Install: npm install open-design-mcp@0.5.0

#[0.4.1] — 2026-05-18

Documentation

  • docs(harness): add HB-6 basic-auth OD + HB-7 test env-leak gap (#14) (#15)

Install: npm install open-design-mcp@0.4.1

#[0.4.0] — 2026-05-18

Added

  • feat(byok-pipeline-tool): add config + SSE parser foundation (PR-A, #7) (#13)

Other

  • chore(openspec): archive vendor-sync-initial change

Install: npm install open-design-mcp@0.4.0

#[0.3.0] — 2026-05-17

Added

  • feat(vendor): vendor-sync-initial — 13 OD contracts files + HB-3 tests (#5)

Install: npm install open-design-mcp@0.3.0

#[0.2.1] — 2026-05-17

Documentation

  • docs(harness): add HB-5 — read serverInfo.version dynamically from package.json

Install: npm install open-design-mcp@0.2.1

#[0.2.0] — 2026-05-17

Added

  • feat: init-package-scaffold (#3)

Documentation

  • docs(readme): fix OD_DAEMON_URL default — localhost:7456 is wrong from inside Docker

Other

  • chore: add publish workflows from kokorolx/shared-workflows@v1
  • chore(release): harden package.json for npm publish
  • chore(openspec): archive init-package-scaffold change
  • chore: harness init

Install: npm install open-design-mcp@0.2.0