Skip to content

feat: auto-setup SDKs and data store before dev/build/test#614

Open
zastrowm wants to merge 3 commits intostrands-agents:mainfrom
zastrowm:better_devx
Open

feat: auto-setup SDKs and data store before dev/build/test#614
zastrowm wants to merge 3 commits intostrands-agents:mainfrom
zastrowm:better_devx

Conversation

@zastrowm
Copy link
Member

@zastrowm zastrowm commented Mar 7, 2026

Description

Previously, npm run dev, npm run build, and npm test all required manual pre-flight
steps that weren't obvious to someone new to the repo. This PR makes all three work
out of the box.

  • vite-plugin-sdk-setup.ts — Vite plugin that auto-runs sdk:clone + sdk:generate
    at startup if the .build/sdk-* artifacts are missing.
  • test/global-setup.ts — vitest global setup that spins up astro dev just long enough
    to populate the content layer data store if absent, working around this Astro 5 issue.
  • CI drops the now-redundant test:prep step.

Related Issues

#441

Type of Change

  • Other (please describe): Getting started experience

Checklist

  • I have read the CONTRIBUTING document
  • My changes follow the project's documentation style
  • I have tested the documentation locally using mkdocs serve
  • Links in the documentation are valid and working

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: Comment

Good developer experience improvement that simplifies onboarding by automating SDK setup and data store population.

Review Categories
  • Robustness: The global-setup process cleanup could be improved to handle process trees and early server crashes (see inline comments)
  • Consistency: Code follows existing patterns in the repo (execSync usage, plugin structure)
  • Documentation: PR description is clear; no public API changes so documentation PR is not required

The implementation is clean and achieves its goal. The inline suggestions are optional improvements for edge cases in CI environments.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 7, 2026

Documentation Preview Ready

Your documentation preview has been successfully deployed!

Preview URL: https://d3ehv1nix5p99z.cloudfront.net/pr-cms-614/docs/user-guide/quickstart/overview/

Updated at: 2026-03-07T22:18:29.770Z

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