Add Git-backed OpenAPI API references

.changeset/page-builder-a11y-chrome.md

@@ -0,0 +1,5 @@
+---
+"@frontlit/page-builder": patch
+---
+
+Accessibility fixes in site chrome: the `Drawer` trigger props now go on the trigger element instead of a wrapping `span` (no more `aria-expanded` on a non-interactive element), and footer column titles are `h2` instead of `h4`, so headings no longer skip levels.

.changeset/page-builder-api-reference-primitives.md

@@ -0,0 +1,5 @@
+---
+"@frontlit/page-builder": minor
+---
+
+Add `Tabs`, `Table`, `Collapsible`, `NativeSelect` and `InlineCode` primitives (all themed; `Tabs` is a client island, the rest are server-safe), and export `CodeSnippet` from `@frontlit/page-builder/primitives/server`.

.changeset/page-builder-section-sticky.md

@@ -0,0 +1,5 @@
+---
+"@frontlit/page-builder": patch
+---
+
+`Section` clips its content with `overflow: clip` instead of `overflow: hidden`, so sticky elements inside a section (such as a docs sidebar) stick to the viewport again.

AGENTS.md

@@ -1,5 +1,12 @@
 # Development Guidelines for FrontLit
 
+## Architecture Guidelines
+
+- Strive for a simpler design and add more complexity only when it is required to solve a problem.
+- Avoid over-engineering.
+- Don't go for premature-optimizations.
+- We haven't hit planet scale yet, so don't try to cater to edge cases which our users may not even encounter.
+
 ## Development Tips
 
 - The platform is in early stages of development. We don't even have a production deployment yet. So, feel free to scratch migrations and write those from scratch as many times as you need, reset database etc.. No need to worry about being backwards compatible.

apps/api/drizzle/0012_openapi_reference.sql

@@ -0,0 +1,53 @@
+CREATE TABLE IF NOT EXISTS "documentation_api_operations" (
+	"spec_id" text NOT NULL,
+	"team_id" text NOT NULL,
+	"route" text NOT NULL,
+	"title" text NOT NULL,
+	"group" text NOT NULL,
+	"order" integer NOT NULL,
+	"method" text NOT NULL,
+	"path" text NOT NULL,
+	"deprecated" boolean DEFAULT false NOT NULL,
+	"slice" text NOT NULL,
+	"chunks" jsonb NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "documentation_api_specs" (
+	"spec_id" text PRIMARY KEY NOT NULL,
+	"team_id" text NOT NULL,
+	"status" text NOT NULL,
+	"commit_sha" text NOT NULL,
+	"source_path" text NOT NULL,
+	"source_blob_sha" text,
+	"mount" text NOT NULL,
+	"spec" text,
+	"spec_hash" text,
+	"info" jsonb,
+	"diagnostics" jsonb DEFAULT '[]'::jsonb NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "documentation_git_bindings" ADD COLUMN "api_spec_path" text;--> statement-breakpoint
+ALTER TABLE "documentation_git_bindings" ADD COLUMN "api_mount" text DEFAULT 'api-reference' NOT NULL;--> statement-breakpoint
+ALTER TABLE "documentation_settings" ADD COLUMN "active_api_spec_id" text;--> statement-breakpoint
+DO $$ BEGIN
+ ALTER TABLE "documentation_api_operations" ADD CONSTRAINT "documentation_api_operations_spec_id_documentation_api_specs_spec_id_fk" FOREIGN KEY ("spec_id") REFERENCES "public"."documentation_api_specs"("spec_id") ON DELETE cascade ON UPDATE no action;
+EXCEPTION
+ WHEN duplicate_object THEN null;
+END $$;
+--> statement-breakpoint
+DO $$ BEGIN
+ ALTER TABLE "documentation_api_operations" ADD CONSTRAINT "documentation_api_operations_team_id_teams_id_fk" FOREIGN KEY ("team_id") REFERENCES "public"."teams"("id") ON DELETE cascade ON UPDATE no action;
+EXCEPTION
+ WHEN duplicate_object THEN null;
+END $$;
+--> statement-breakpoint
+DO $$ BEGIN
+ ALTER TABLE "documentation_api_specs" ADD CONSTRAINT "documentation_api_specs_team_id_teams_id_fk" FOREIGN KEY ("team_id") REFERENCES "public"."teams"("id") ON DELETE cascade ON UPDATE no action;
+EXCEPTION
+ WHEN duplicate_object THEN null;
+END $$;
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS "documentation_api_operations_route_idx" ON "documentation_api_operations" USING btree ("spec_id","route");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "documentation_api_operations_team_idx" ON "documentation_api_operations" USING btree ("team_id");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "documentation_api_specs_team_idx" ON "documentation_api_specs" USING btree ("team_id","status");