Releases · yshishenya/stitchflow

19 May 20:50

v1.4.0

643256d

StitchFlow v1.4.0 Latest

Latest

StitchFlow v1.4.0

StitchFlow v1.4.0 hardens the project from a prompt-to-design helper into a fuller release-ready Stitch workflow: design-system operations, website design delivery, artifact audits, safer downloads, stronger regression coverage, and cleaner GitHub release documentation.

Highlights

Added a first-class design-system CLI for list, create, update, and apply actions against live Stitch MCP tools.
Added site-design:e2e for the full website delivery path: logo exploration, homepage variants, selected homepage expansion, approved screen export, project download, and handoff audit.
Added --model-id support across generate/edit/variants/regression/site-design E2E commands.
Hardened regression:e2e so each step reads its own output directory instead of the shared runs/latest-screen.json pointer.
Added safe project download fallback when the SDK downloader hits path-length limits from long Stitch-generated screen titles or image prompts.
Expanded site-design-audit to cover artifact quality, required content, unsupported claims, responsive behavior, rendered browser checks, and serious axe accessibility issues.
Reworked the root README into a concise GitHub entry point and added a detailed CHANGELOG.md.

Added

npm run design-system with live MCP-backed list, create, update, and apply actions.
npm run site-design:e2e for full website design workflow regression.
site-design-audit checks for:
- handoffStatus and qaNotes
- required phrases per screen
- unsupported/forbidden claims
- HTML parseability and meaningful text
- image MIME/type/dimension validation
- static accessibility basics
- responsive CSS signals and fixed-width anti-patterns
- rendered viewport overflow and clipped text
- browser page errors
- serious axe accessibility violations
Playwright and axe dev dependencies for rendered audit checks.
.github/release.yml for grouped GitHub generated release notes.
CHANGELOG.md using Keep a Changelog and SemVer conventions.

Changed

README is now GitHub-first: quick value, install, quick start, MCP setup, CLI table, website workflow, validation, docs, distribution, release policy.
Installer copies an explicit toolkit allowlist instead of copying local state.
CI validates script syntax, required npm scripts, installer layout, and optional live regression workflows.
design-system apply now requires explicit --allow-screen-id-fallback when falling back from screen instances to screen ids.
Skill docs, CLI docs, workflow docs, toolkit README, catalog references, and platform manifests are aligned to 1.4.0.

Fixed

Fixed a regression race where concurrent runs could read a shared latest-screen.json written by another process.
Fixed weak artifact validation by checking file type, size, parseability, text, and image dimensions.
Fixed hidden download coverage gaps by recording when download-project omits approved screens and requiring explicit export-screens fallback coverage.
Fixed SDK downloadAssets() path-length failures via StitchFlow's safe local downloader fallback.
Fixed installer leakage risk for .env, runs/, and node_modules.
Fixed live workflow hangs by adding child process timeout handling and a parent/worker timeout wrapper for site-design:e2e.

Validation

npm ci
node --check scripts/*.mjs
required package script validation
bash -n install.sh
installer layout smoke with isolated temp homes
README/CHANGELOG local link check
git diff --check
offline rendered site-design-audit smoke: 64/64 passed
live download-project --safe-download smoke against a real Stitch project
live automatic download-project safe fallback smoke against a real Stitch project
live regression:e2e: 88/88 assertions passed against Stitch project 2181787718089577151
GitHub Actions Validate passed on main after merge

Known Notes

Full site-design:e2e is intentionally heavier than regression:e2e. During validation, live logo generation exposed a long-running Stitch call; this release adds the parent/worker --total-timeout-ms path so future runs fail cleanly instead of hanging.
The Stitch SDK project listing can omit generated/edit/variant screens that are still accessible by id. Use export-screens for approved screen ids when download-project does not include them.

What changed

tightened the first screen of the README for clearer positioning
added docs/launch-system.md with a practical 7-day rollout plan
added docs/community-posts.md with ready-to-paste copy for Show HN, Reddit, X, Discord, and Telegram
linked the new launch assets from the main README