@vasfal/vellum 0.1.0

package/.next/types/validator.ts

@@ -0,0 +1,160 @@
+// This file is generated automatically by Next.js
+// Do not edit this file manually
+// This file validates that all pages and layouts export the correct types
+
+import type { AppRoutes, LayoutRoutes, ParamMap, AppRouteHandlerRoutes } from "./routes.js"
+import type { ResolvingMetadata, ResolvingViewport } from "next/types.js"
+import type { NextRequest } from 'next/server.js'
+
+type AppPageConfig<Route extends AppRoutes = AppRoutes> = {
+  default: React.ComponentType<{ params: Promise<ParamMap[Route]> } & any> | ((props: { params: Promise<ParamMap[Route]> } & any) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
+  generateStaticParams?: (props: { params: ParamMap[Route] }) => Promise<any[]> | any[]
+  generateMetadata?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingMetadata
+  ) => Promise<any> | any
+  generateViewport?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingViewport
+  ) => Promise<any> | any
+  metadata?: any
+  viewport?: any
+}
+
+type LayoutConfig<Route extends LayoutRoutes = LayoutRoutes> = {
+  default: React.ComponentType<LayoutProps<Route>> | ((props: LayoutProps<Route>) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
+  generateStaticParams?: (props: { params: ParamMap[Route] }) => Promise<any[]> | any[]
+  generateMetadata?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingMetadata
+  ) => Promise<any> | any
+  generateViewport?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingViewport
+  ) => Promise<any> | any
+  metadata?: any
+  viewport?: any
+}
+
+type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRoutes> = {
+  GET?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  POST?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  PUT?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  PATCH?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  DELETE?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  HEAD?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  OPTIONS?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+}
+
+
+// Validate ../../src/app/(app)/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/">> = Specific
+  const handler = {} as typeof import("../../src/app/(app)/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/(app)/session/[name]/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/session/[name]">> = Specific
+  const handler = {} as typeof import("../../src/app/(app)/session/[name]/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/(app)/settings/key/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings/key">> = Specific
+  const handler = {} as typeof import("../../src/app/(app)/settings/key/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/record-test/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/record-test">> = Specific
+  const handler = {} as typeof import("../../src/app/record-test/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/styleguide/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/styleguide">> = Specific
+  const handler = {} as typeof import("../../src/app/styleguide/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/analyze/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/analyze">> = Specific
+  const handler = {} as typeof import("../../src/app/api/analyze/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/key-status/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/key-status">> = Specific
+  const handler = {} as typeof import("../../src/app/api/key-status/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/key/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/key">> = Specific
+  const handler = {} as typeof import("../../src/app/api/key/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/models/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/models">> = Specific
+  const handler = {} as typeof import("../../src/app/api/models/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/revise/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/revise">> = Specific
+  const handler = {} as typeof import("../../src/app/api/revise/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+
+
+
+
+// Validate ../../src/app/(app)/layout.tsx
+{
+  type __IsExpected<Specific extends LayoutConfig<"/">> = Specific
+  const handler = {} as typeof import("../../src/app/(app)/layout.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/layout.tsx
+{
+  type __IsExpected<Specific extends LayoutConfig<"/">> = Specific
+  const handler = {} as typeof import("../../src/app/layout.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vasyl Falach
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# Vellum
+
+> Think out loud over your screen. Vellum turns the recording into a structured report — every point you made, timestamped, screenshotted, and sorted into tasks.
+
+The best reviews happen out loud: you point at something and say what's wrong with it — then it vanishes into a screen recording nobody rewatches. Vellum keeps the substance instead. Talk through the work, and get back a clean, actionable report — problems, ideas, questions, and decisions, each linked to the exact moment and frame it came from. It runs entirely on your machine, under your own API key: no account, no cloud.
+
+Built for design and product reviews — the analysis is tuned for critiquing UI, checking a build against its design, and reviewing docs — but the mechanic works for any spoken walkthrough of a screen.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/hero-dark.png">
+  <img alt="Vellum turns a spoken design review into a structured report — the recording on the left, extracted tasks with timestamps, categories, and priorities on the right" src="docs/assets/hero-light.png">
+</picture>
+
+<!-- A short demo GIF of the record → report loop can go here later — see docs/assets/README.md -->
+
+## Before you start — is this for you?
+
+Vellum is deliberately narrow. It's a good fit if:
+
+- You're on a **Chromium browser** (Chrome, Edge, Arc, Brave). Recording and the floating controls use APIs Firefox and Safari don't support.
+- You're comfortable getting a **free Google AI Studio API key** and pasting it in once. Analysis runs on Gemini under *your* key — there's no hosted service.
+- You want a **single-user, local** tool. Recordings live on your disk; nothing syncs to a cloud.
+
+If you need meeting transcription, multi-user collaboration, or a hosted app, Vellum isn't that — see [Scope](#scope).
+
+## Install and run
+
+Vellum runs entirely on your machine. The web app is the tool; the `vellum` command just launches it.
+
+```bash
+# Requires Node.js 20+
+npx @vasfal/vellum ui
+```
+
+That starts the local app and opens it in your browser. On first launch it walks you through pasting your Gemini key (stored in `~/.vellum/.env`, never sent anywhere but Google's API at analyze time) and picking a workspace folder for your recordings.
+
+<details>
+<summary>Or run from source (for development)</summary>
+
+```bash
+git clone https://github.com/vasfal/vellum.git
+cd vellum
+npm install
+npm run dev          # starts on http://localhost:4270
+```
+
+For a global command from a local checkout: `npm link`, then `vellum ui`.
+</details>
+
+## Setting your API key
+
+Analysis runs on Google Gemini under *your* key — there's no hosted service and no account. A key is free from [Google AI Studio](https://aistudio.google.com/apikey).
+
+**In the app (recommended).** On first launch Vellum shows a prompt to paste your key, validates it, and saves it. You can change or remove it later from the sidebar. This is the path most people should use — no files, no restart.
+
+<!-- screenshot: in-app key setup -->
+
+**Power users / CLI.** If you'd rather not use the form, Vellum reads the key from the environment, in this order of precedence:
+
+1. An exported `GEMINI_API_KEY` environment variable (wins over everything below).
+2. `~/.vellum/.env` — the file the in-app form writes to. The launcher (`vellum ui`) loads it at every boot.
+3. `.env.local` in a source checkout — copy [`.env.example`](.env.example) to `.env.local` and fill in `GEMINI_API_KEY`. Read by `npm run dev`.
+
+`.env.example` also documents the optional `GEMINI_MODEL` and `GEMINI_FALLBACK_MODELS` overrides.
+
+**Where the key lives.** It's stored only in `~/.vellum/.env` on your machine, written with `0600` permissions (readable by you alone). Vellum never logs it, never echoes it back, and never sends it anywhere but Google's Gemini API at analyze time. See [Privacy](#privacy).
+
+## How it works
+
+1. **Record** — click *New recording*, pick a screen or window, and talk through your review. Floating controls stay above your other windows.
+2. **Stop** — the recording is saved to your workspace folder as `recording.webm`.
+3. **Analyze** — click *Analyze*. Vellum uploads the recording to Gemini (under your key), which watches it and pulls out what you said and pointed at.
+4. **Review** — a few minutes later you get a report: extracted tasks, each with a timestamp, a screenshot of the moment, a category, and a priority. Edit, comment, and re-run as you like.
+
+## What goes into the report
+
+For each task Vellum extracts:
+
+- A descriptive title and a description with on-screen context
+- A timestamp linking back to the moment in the video
+- A screenshot of the relevant frame
+- A category: `problem` / `idea` / `question` / `decision` / `followup` / `praise`
+- A priority guess
+
+Each session is tagged with a `review_type` (UI design, dev-vs-design, documentation, mixed) so the analysis adapts to the kind of review it is.
+
+## Privacy
+
+- Recordings live on your local filesystem, in the folder you choose.
+- Only the analyze step sends video to Google (the Gemini API), under your own key.
+- Your API key stays in `~/.vellum/.env` on your machine — it never leaves the local server.
+- No telemetry, no analytics, no servers anyone else controls.
+
+## Your files
+
+Each session is a self-contained folder in your workspace:
+
+```
+~/vellum-sessions/
+├── .vellum-workspace.json        ← marks this folder as a Vellum workspace
+└── 2026-05-19-onboarding-review/
+    ├── recording.webm            ← the raw recording
+    ├── report.md                 ← the Markdown report
+    ├── tasks.json                ← structured Gemini output, for re-rendering
+    └── screenshots/
+        ├── 00-03-42.png
+        └── ...
+```
+
+Re-running analysis keeps your history — the latest report is always `report.md`, and previous runs are archived alongside it. Back up a session by copying its folder; share one by zipping it.
+
+## Scope
+
+**What Vellum does:** single-user design and product reviews · screen + microphone recording · AI analysis and task extraction · Markdown reports with embedded screenshots.
+
+**What it doesn't (and isn't trying to):** meeting transcription · multi-user collaboration · live sharing · cloud sync · recording other people's screens · system-audio capture (microphone only).
+
+## Troubleshooting
+
+**The folder picker or floating controls don't work** — you need a Chromium-based browser. The File System Access and Document Picture-in-Picture APIs aren't in Firefox or Safari.
+
+**Analysis takes a long time** — Gemini's File API is slower on the first upload of a long video. A 30-minute recording usually finishes in 3–5 minutes; 10+ minutes means something's wrong — check the terminal.
+
+**The recording is silent** — grant the browser microphone permission and watch the audio meter while you talk.
+
+**Gemini returned odd tasks** — usually poor recording quality (mumbled audio, blank screen). The prompt is tuned for design reviews; other kinds of review may need tuning.
+
+## Contributing
+
+Issues and pull requests are welcome — there are templates for both. If you're developing Vellum rather than just using it, start with:
+
+- [`ARCHITECTURE.md`](ARCHITECTURE.md) — the current locked state of the system
+- [`DECISIONS.md`](DECISIONS.md) — the architecture decision log
+- [`SCENARIOS.md`](SCENARIOS.md) — the core user scenarios the product supports
+
+Vellum is developed with AI assistance; the architecture docs above are the source of truth for how it fits together.
+
+## License
+
+[MIT](LICENSE).
+
+## Acknowledgements
+
+Built with Next.js, Tailwind, shadcn/ui, Google Gemini, and ffmpeg.
+
+The name *Vellum* refers to the thin parchment medieval scribes wrote on — a surface for holding thought.

package/bin/vellum.mjs

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+// Vellum launcher (TASK-62): `vellum ui` boots the local web app and opens a
+// browser at it. Written as plain ESM on purpose — it runs straight from a
+// published npm package with no tsx/TypeScript step at runtime. The Next app
+// itself is the built `.next` that ships in the tarball; this file is just the
+// front door.
+
+import { spawn } from "node:child_process";
+import { createServer } from "node:net";
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { homedir, platform } from "node:os";
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+// The package root is the parent of bin/ — where `.next`, `public`, and
+// next.config.ts live, both in a published tarball and in a dev checkout.
+const packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
+
+const [command = "ui"] = process.argv.slice(2);
+
+switch (command) {
+  case "ui":
+    await runUi();
+    break;
+  case "analyze":
+    // Reserved for TASK-53. Named here so `vellum analyze` fails with a human
+    // hint instead of an "unknown command", since docs will mention it.
+    console.error(
+      "`vellum analyze` isn't available yet — analyze from the web app for now:\n  vellum ui\n(The terminal analyze command lands in TASK-53.)",
+    );
+    process.exit(1);
+    break;
+  case "-v":
+  case "--version":
+    console.log(readVersion());
+    break;
+  case "-h":
+  case "--help":
+    printHelp();
+    break;
+  default:
+    console.error(`Unknown command: ${command}\n`);
+    printHelp();
+    process.exit(1);
+}
+
+async function runUi() {
+  // Load the home-config key (TASK-64 writes it here) so the server sees it. A
+  // real process.env value wins, so a dev checkout with .env.local or an
+  // exported GEMINI_API_KEY still works.
+  loadHomeEnv();
+
+  const nextBin = require.resolve("next/dist/bin/next");
+
+  // A production build must exist for `next start`. It ships prebuilt in the
+  // published tarball; a dev checkout builds once on first run.
+  if (!existsSync(join(packageRoot, ".next"))) {
+    console.log("First run — building Vellum (one time, ~a minute)…\n");
+    await runToCompletion(nextBin, ["build"]);
+  }
+
+  const port = await freePort(4270);
+  const url = `http://localhost:${port}`;
+
+  const server = spawn(process.execPath, [nextBin, "start", "-p", String(port)], {
+    cwd: packageRoot,
+    stdio: ["ignore", "inherit", "inherit"],
+    env: { ...process.env, NODE_ENV: "production" },
+  });
+
+  // Stop the server cleanly on Ctrl-C so a stray port isn't left held.
+  const stop = () => {
+    server.kill("SIGINT");
+    process.exit(0);
+  };
+  process.on("SIGINT", stop);
+  process.on("SIGTERM", stop);
+  server.on("exit", (code) => process.exit(code ?? 0));
+
+  await waitForServer(url);
+  console.log(`\nVellum is running at ${url} — opening your browser.`);
+  console.log("Leave this terminal open; press Ctrl-C to stop.\n");
+  openBrowser(url);
+}
+
+/** Load ~/.vellum/.env into process.env without overriding real env vars. */
+function loadHomeEnv() {
+  const envPath = join(homedir(), ".vellum", ".env");
+  if (!existsSync(envPath)) return;
+  for (const line of readFileSync(envPath, "utf8").split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eq = trimmed.indexOf("=");
+    if (eq === -1) continue;
+    const key = trimmed.slice(0, eq).trim();
+    let value = trimmed.slice(eq + 1).trim();
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1);
+    }
+    if (key && !(key in process.env)) process.env[key] = value;
+  }
+}
+
+/** Prefer `preferred`; fall back to an OS-assigned free port if it's taken. */
+function freePort(preferred) {
+  return new Promise((resolve) => {
+    const probe = createServer();
+    probe.once("error", () => resolve(ephemeralPort()));
+    probe.listen(preferred, () => probe.close(() => resolve(preferred)));
+  });
+}
+
+function ephemeralPort() {
+  return new Promise((resolve, reject) => {
+    const probe = createServer();
+    probe.once("error", reject);
+    probe.listen(0, () => {
+      const { port } = probe.address();
+      probe.close(() => resolve(port));
+    });
+  });
+}
+
+/** Poll until the server answers (any HTTP response counts), then return. */
+async function waitForServer(url, timeoutMs = 60_000) {
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    try {
+      await fetch(url, { method: "HEAD" });
+      return;
+    } catch {
+      await sleep(300);
+    }
+  }
+  throw new Error(`Vellum didn't become ready at ${url} within 60s.`);
+}
+
+function openBrowser(url) {
+  const os = platform();
+  const [cmd, args] =
+    os === "darwin"
+      ? ["open", [url]]
+      : os === "win32"
+        ? ["cmd", ["/c", "start", "", url]]
+        : ["xdg-open", [url]];
+  try {
+    spawn(cmd, args, { stdio: "ignore", detached: true }).unref();
+  } catch {
+    // Non-fatal: the URL is already printed for the user to click.
+  }
+}
+
+/** Spawn `node <script> <args>` and resolve on a clean exit, reject otherwise. */
+function runToCompletion(script, args) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [script, ...args], {
+      cwd: packageRoot,
+      stdio: "inherit",
+      env: { ...process.env, NODE_ENV: "production" },
+    });
+    child.on("exit", (code) =>
+      code === 0 ? resolve() : reject(new Error(`\`next ${args[0]}\` exited with code ${code}.`)),
+    );
+  });
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function readVersion() {
+  const pkg = JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf8"));
+  return pkg.version ?? "unknown";
+}
+
+function printHelp() {
+  console.log(`Vellum — record a design review, get a structured report.
+
+Usage:
+  vellum ui         Launch the local web app and open it in your browser
+  vellum analyze    (coming soon) Analyze a recording from the terminal
+
+  vellum --version  Print the installed version
+  vellum --help     Show this help
+
+The web app runs entirely on your machine. Recordings never leave your disk;
+only the analyze step sends video to Google Gemini, under your own API key.`);
+}

package/next.config.ts

@@ -0,0 +1,19 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  // ffmpeg-static resolves its binary via a __dirname-relative path. Bundling it
+  // (Turbopack's default for server code) relocates that path into the build
+  // output, so getFfmpegPath() can't find the real binary and /api/analyze's
+  // screenshot stage fails. Keeping it external leaves the require() running
+  // from node_modules, where the path stays correct. Same reasoning for the
+  // Gemini SDK's native/file deps — exclude the packages the API route spawns
+  // or streams from disk. (ADR-014: the analyze route runs the Node pipeline.)
+  serverExternalPackages: ["ffmpeg-static"],
+
+  // Vellum is a focused, single-window desktop tool; the floating Next.js dev
+  // indicator overlaps the app chrome and reads as noise in an otherwise clean
+  // monochrome shell (ADR-004). Hide it — this only affects dev, not the build.
+  devIndicators: false,
+};
+
+export default nextConfig;

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@vasfal/vellum",
+  "version": "0.1.0",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Think out loud over your screen; Vellum turns the recording into a structured report with timestamps, screenshots, and extracted tasks. Local-first, bring-your-own Gemini key.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vasfal/vellum.git"
+  },
+  "homepage": "https://github.com/vasfal/vellum#readme",
+  "bugs": {
+    "url": "https://github.com/vasfal/vellum/issues"
+  },
+  "bin": {
+    "vellum": "bin/vellum.mjs"
+  },
+  "files": [
+    "bin",
+    ".next",
+    "public",
+    "next.config.ts"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "next dev -p 4270",
+    "build": "next build",
+    "start": "next start",
+    "prepack": "rm -rf .next && next build",
+    "lint": "eslint",
+    "upload": "tsx --env-file-if-exists=.env.local scripts/upload-video.ts",
+    "analyze": "tsx --env-file-if-exists=.env.local scripts/analyze-video.ts",
+    "cli": "tsx --env-file-if-exists=.env.local scripts/cli.ts",
+    "validate:schema": "tsx scripts/validate-schema.ts",
+    "extract": "tsx scripts/extract-frames.ts",
+    "report": "tsx scripts/write-report.ts"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.6.0",
+    "@google/genai": "^2.10.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "ffmpeg-static": "^5.3.0",
+    "lucide-react": "^1.22.0",
+    "next": "16.2.9",
+    "next-themes": "^0.4.6",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
+    "shadcn": "^4.12.0",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.6.0",
+    "tw-animate-css": "^1.4.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20.19.43",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.9",
+    "tailwindcss": "^4",
+    "tsx": "^4.22.4",
+    "typescript": "^5"
+  }
+}

package/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>