Skip to content

fix(setup): headless/CI mode + fork type-staleness warning + doc drift#13

Merged
chriskehayias merged 2 commits into
mainfrom
dev
May 31, 2026
Merged

fix(setup): headless/CI mode + fork type-staleness warning + doc drift#13
chriskehayias merged 2 commits into
mainfrom
dev

Conversation

@chriskehayias
Copy link
Copy Markdown
Contributor

Summary

Promotes the second-evaluation fixes from dev to main. Follow-up to #11 and #12.

Changes

Headless / CI mode (scripts/setup.ts)

  • New non-interactive mode: -y / --yes / --non-interactive, also auto-enabled when stdin isn't a TTY, so @inquirer/prompts no longer throws in a pipeline.
  • Keeps existing .env.local values, auto-generates missing secrets, applies defaults. All prompts in steps 2/4/5/6 are guarded.
  • Documented under Quick Setup, including node scripts/setup-bootstrap.mjs --yes.

Fork type-staleness footgun

  • When type generation fails and committed models are used as a fallback, the warning now loudly states the models come from a reference tenant, may not match the user's instance, and to run pnpm mp:generate:models before relying on them. README's committed-models note expanded to match.

Doc drift

  • Fixed the stale TOC anchor (#quick-setup-with-claude-code#quick-setup-automated).
  • Removed the leftover "don't have Claude Code" framing from the Manual Setup intro.
  • Added scripts/setup-bootstrap.mjs (the real pnpm setup entry point) to the Project Structure diagram.

Chore

  • Synced generated next-env.d.ts to the Next 16 .next/dev/types path.

Testing

tsc --noEmit clean; --help renders the new flag; prompt-guard coverage reviewed across all interactive steps. A full live --yes build was not run (it would regenerate models/ against the live tenant); non-interactive path verified by type-check + review.

🤖 Generated with Claude Code

chriskehayias and others added 2 commits May 31, 2026 11:58
Addresses a second clean-environment evaluation.

- TOC: fix stale "#quick-setup-with-claude-code" anchor to match the renamed
  "Quick Setup (Automated)" heading; drop the remaining "don't have Claude
  Code" framing from the Manual Setup intro.
- Project Structure: add scripts/setup-bootstrap.mjs (the actual entry point
  `pnpm setup` runs) to the diagram.
- Headless/CI: add a non-interactive mode (-y/--yes/--non-interactive), also
  auto-enabled when stdin is not a TTY, so @inquirer/prompts no longer throws
  in a pipeline. It keeps existing .env.local values, auto-generates missing
  secrets, and applies defaults; all step 2/4/5/6 prompts are guarded.
  Documented under Quick Setup.
- Fork type-staleness footgun: when type generation fails and committed
  models are used as a fallback, the warning now loudly states the committed
  models come from a reference tenant and may not match the user's instance,
  and to run `pnpm mp:generate:models` before relying on them. README's
  committed-models note expanded to say the same.

(The reported "v18+ / Claude Code" GitHub web view was stale CDN cache; the
clone is already correct — confirmed no v18 references remain.)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Next.js 16 (Turbopack) regenerates next-env.d.ts to import from
./.next/dev/types/routes.d.ts. Committing the regenerated reference so the
tracked file matches the installed Next version and the working tree stays
clean (this file is generated, not hand-edited).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@codecov-commenter
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@chriskehayias chriskehayias merged commit 2f7bad4 into main May 31, 2026
1 check passed
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.

2 participants