Skip to content

feat(framework): preflight checks + framework doctor#173

Merged
suleimansh merged 1 commit into
mainfrom
suleimansh/feat/framework-preflight
Jul 3, 2026
Merged

feat(framework): preflight checks + framework doctor#173
suleimansh merged 1 commit into
mainfrom
suleimansh/feat/framework-preflight

Conversation

@suleimansh

Copy link
Copy Markdown
Member

Adoption polish for the now-published @gemstack/framework@0.1.0. A turnkey tool should fail early and clearly when a prerequisite is missing, not spawn a broken process mid-run.

  • A live run now runs preflight first: is Claude Code installed and runnable? If not, it prints \claude` not found - install Claude Code ...` and exits 2, instead of a cryptic spawn error after the dashboard and preset detection.
  • framework doctor reports the checks (node + agent CLI) and exits by their outcome.
  • --skip-preflight escape hatch; --fake never runs preflight (it needs no CLI).

6 new tests (42 total). framework doctor smoke: prints node + claude versions, exit 0. Full typecheck + build clean. Changeset (minor).

Turnkey should fail early and clearly, not mid-run. A live run now verifies its
prerequisites (Claude Code installed + runnable) before starting the dashboard
and driver; if missing, it prints install guidance and exits instead of a
cryptic spawn error deep in the flow.

- preflight(): checks node + the agent CLI (injectable probe for tests)
- framework doctor: reports the checks and exits by their outcome
- --skip-preflight escape hatch; --fake never runs preflight (needs no CLI)

6 new tests (42 total); doctor smoke verified (node + claude versions); full
typecheck + build clean.
@suleimansh suleimansh added enhancement New feature or request priority: medium Worth doing, not urgent labels Jul 3, 2026
@suleimansh suleimansh self-assigned this Jul 3, 2026
@suleimansh suleimansh merged commit d31a260 into main Jul 3, 2026
2 checks passed
@suleimansh suleimansh deleted the suleimansh/feat/framework-preflight branch July 3, 2026 18:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request priority: medium Worth doing, not urgent

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant