Release: Demo Mode, Dashboard UI Sync & Effect Refactor

.env.local.example

@@ -2,6 +2,11 @@
 # Use staging when validating staging keys.
 # KNOWHERE_BASE_URL=https://api-staging.knowhereto.ai
 
+# Optional development override. When set, Notebook skips Dashboard session
+# auth and Dashboard-issued JWT creation, then calls Knowhere directly with
+# this key. Leave unset for production and Dashboard-authenticated staging.
+# KNOWHERE_API_KEY=sk_your_development_key_here
+
 # --- Chat provider (server-side only) ---
 # Vercel AI Gateway key; AI SDK picks it up automatically
 AI_GATEWAY_API_KEY=vck_your_key_here

README.md

@@ -11,6 +11,7 @@ Upload documents, explore parsed content, and ask questions about your knowledge
 
 2. Fill in your API keys in `.env.local`:
    - `AI_GATEWAY_API_KEY` — your Vercel AI Gateway key for chat (optional `CHAT_MODEL` override)
+   - `KNOWHERE_API_KEY` — optional development override that skips Dashboard auth and calls Knowhere directly
 
 3. Install dependencies and run:
    ```bash
@@ -42,6 +43,12 @@ Notebook treats Dashboard as the auth source of truth. Server-side auth calls
 forward the incoming session cookie to Dashboard oRPC endpoints, including
 `/api/orpc/users/getCurrentUser` and `/api/orpc/users/issueServiceJwt`.
 
+For local development, setting server-side `KNOWHERE_API_KEY` switches Notebook
+into API-key mode. In that mode the app uses a deterministic local development
+user, skips Dashboard redirects and JWT issuance, and passes the configured key
+directly to the Knowhere SDK. Leave it unset for production and normal
+Dashboard-authenticated staging flows.
+
 Dashboard chooses its oRPC handler by request shape and `Content-Type`.
 When using Effect's `HttpClientRequest.bodyText`, pass
 `"application/json"` as the body content type. Setting the header before

drizzle.config.ts

@@ -9,7 +9,7 @@ import { defineConfig } from "drizzle-kit";
  *   pnpm db:migrate    # apply migrations to DATABASE_URL (prod deploy)
  */
 export default defineConfig({
-  schema: "./src/lib/schema.ts",
+  schema: "./src/infrastructure/db/schema.ts",
   out: "./drizzle",
   dialect: "postgresql",
   dbCredentials: {

drizzle/0006_api_owned_demos.sql

@@ -0,0 +1,15 @@
+CREATE TABLE "demo_source_visibilities" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"workspace_id" uuid NOT NULL,
+	"demo_source_id" text NOT NULL,
+	"hidden_at" timestamp with time zone,
+	"deleted_at" timestamp with time zone,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "demo_source_visibilities" ADD CONSTRAINT "demo_source_visibilities_workspace_id_workspaces_id_fk" FOREIGN KEY ("workspace_id") REFERENCES "public"."workspaces"("id") ON DELETE cascade ON UPDATE no action;
+--> statement-breakpoint
+CREATE UNIQUE INDEX "demo_source_visibilities_workspace_source_idx" ON "demo_source_visibilities" USING btree ("workspace_id","demo_source_id");
+--> statement-breakpoint
+CREATE INDEX "demo_source_visibilities_workspace_idx" ON "demo_source_visibilities" USING btree ("workspace_id");

drizzle/0007_normalize_legacy_demo_sources.sql

@@ -0,0 +1,50 @@
+INSERT INTO "demo_source_visibilities" (
+  "workspace_id",
+  "demo_source_id",
+  "hidden_at",
+  "deleted_at",
+  "created_at",
+  "updated_at"
+)
+SELECT
+  "workspace_id",
+  "demo_key",
+  "deleted_at",
+  "deleted_at",
+  now(),
+  now()
+FROM "sources"
+WHERE
+  "demo_key" IS NOT NULL
+  AND "deleted_at" IS NOT NULL
+ON CONFLICT ("workspace_id", "demo_source_id") DO UPDATE
+SET
+  "hidden_at" = EXCLUDED."hidden_at",
+  "deleted_at" = EXCLUDED."deleted_at",
+  "updated_at" = now();
+
+UPDATE "sources"
+SET
+  "deleted_at" = now(),
+  "updated_at" = now()
+WHERE
+  "demo_key" IS NOT NULL
+  AND "deleted_at" IS NULL
+  AND "knowhere_job_id" IS NULL
+  AND (
+    "knowhere_document_id" IS NULL
+    OR "knowhere_document_id" LIKE 'demo-doc-%'
+  );
+
+UPDATE "sources"
+SET
+  "original_blob_pathname" = NULL,
+  "original_blob_url" = '/api/demo-sources/' || "demo_key" || '/original',
+  "updated_at" = now()
+WHERE
+  "demo_key" IS NOT NULL
+  AND "deleted_at" IS NULL
+  AND (
+    "original_blob_url" IS NULL
+    OR "original_blob_url" <> '/api/demo-sources/' || "demo_key" || '/original'
+  );