Files
sql-server-query-ai/kb/First-run gate.md
T
ahmed mohammedandClaude Opus 4.7 8b42a0931c docs: karpathy-pattern wiki built from the spec, plan, design contract and decisions ledger
kb/ is its own wiki root: 34 pages across 7 categories, index.md catalog, log.md, AGENTS.md schema layer, and raw/ holding copies of README, the spec, the 13-task plan, the design master and the SDD ledger.

Every page cross-references 3 to 6 others and all 107 wikilinks resolve except two [["list"]] artefacts inside JSON snippets in the copied plan.

Kept separate from the repository root on purpose: its generated graph lands in kb/.ua/ instead of overwriting the code graph.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-09-22 12:14:05 +03:00

813 B

First-run gate

The console requires two things before it renders: an analyst base URL with model and key, and a Jev key. The gate lives in app/app/layout.tsx, so it covers /app and /app/[id] in one place, and it matches the rule POST /api/analyze already enforces with a 412.

Before the gate existed, the guide was only reachable because the signup and sign-in actions redirect there. Close the wizard halfway and the console rendered anyway, then failed only when Analyse turned red.

The three-step guide is reused as the destination after a save from settings, via a hidden after field on SettingsForm. Without it, a save from the wizard bounced the user straight to the console and the Save button looked dead.

Related: Session cookie rules, Settings form, Email collision check.