bool create: verify runtime before scaffolding; sync template pin - #15
Merged
Merged
Conversation
`bool create` created the project, scaffolded 11 files, and only then fetched the connection descriptor — so a project that isn't on the gateway runtime failed after the fact, leaving an orphaned local folder. Move the connection check ahead of the scaffold: on failure it now reports the server's reason and writes nothing. The descriptor is fetched once and reused for the link step. Also catch the scaffold's pinned bool-sdk version up to the latest published release (next.16 -> next.17) and record the missing next.17 changelog entry. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011zKXrczjUj4pce5BH9Y1HL
The admin-key note said private entities carry a `user_id` owner field and that creates must set `user_id`. The managed owner column is `owner_id` (defaulting to the signed-in user, with row-level security); `user_id` was never right and misled callers into a column that doesn't exist. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011zKXrczjUj4pce5BH9Y1HL
The docs list linked to /docs/local-development and /docs/sdk-reference, neither of which exists. Point local development at the CLI guide (which now covers the local workflow, commands, client setup, and deploy) and keep the data-model link, dropping the two dead entries. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011zKXrczjUj4pce5BH9Y1HL
HomemadeToast57
marked this pull request as ready for review
July 22, 2026 23:17
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
bool createcreated the project, scaffolded all 11 files, and then fetched the connection descriptor. So when a project couldn't be developed against locally (it wasn't on the gateway runtime), the command failed only after writing a full app directory — leaving an orphaned local folder next to an orphaned project. The failure was confusing and the mess was left for the user to clean up.What changed
bool createnow fetches the connection descriptor immediately after creating the project, before writing any files. If the project can't be used for local development, it exits with the server's own reason plus a note that nothing was scaffolded. The descriptor is fetched once and reused for the link step (no extra request).bool-sdk@0.2.0-next.16while the latest published release isnext.17. Bumped the pin tonext.17and added a comment explaining the pin tracks the latest published version (the scaffold runsnpm install), which can trail this package's in-flight version by the release being cut.user_idowner field and that creates must setuser_id. The managed owner column isowner_id(defaulting to the signed-in user, with RLS);user_idwas never right. Fixed the prose and the code example.next.18entry for this change and backfilled the missingnext.17entry.Tests
bool createaborts at the connection check when the new project isn't a gateway project — asserts the target directory is never created and neither the api-key nor entities endpoints are called.bun run typecheckclean;bun test107 pass.