trybeacon 0.1.0

package/.next/types/validator.ts

@@ -0,0 +1,538 @@
+// 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 ../../app/help/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/help">> = Specific
+  const handler = {} as typeof import("../../app/help/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/map/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/map">> = Specific
+  const handler = {} as typeof import("../../app/map/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/">> = Specific
+  const handler = {} as typeof import("../../app/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/plan/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/plan">> = Specific
+  const handler = {} as typeof import("../../app/plan/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/settings/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings">> = Specific
+  const handler = {} as typeof import("../../app/settings/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/code-graph/position/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/code-graph/position">> = Specific
+  const handler = {} as typeof import("../../app/api/code-graph/position/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/code-graph/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/code-graph">> = Specific
+  const handler = {} as typeof import("../../app/api/code-graph/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/context/embed-backfill/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/context/embed-backfill">> = Specific
+  const handler = {} as typeof import("../../app/api/context/embed-backfill/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/context/feature/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/context/feature">> = Specific
+  const handler = {} as typeof import("../../app/api/context/feature/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/context/file/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/context/file">> = Specific
+  const handler = {} as typeof import("../../app/api/context/file/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/context/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/context">> = Specific
+  const handler = {} as typeof import("../../app/api/context/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/db/backfill-access/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/db/backfill-access">> = Specific
+  const handler = {} as typeof import("../../app/api/db/backfill-access/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/db/position/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/db/position">> = Specific
+  const handler = {} as typeof import("../../app/api/db/position/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/db/reconcile-endpoints/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/db/reconcile-endpoints">> = Specific
+  const handler = {} as typeof import("../../app/api/db/reconcile-endpoints/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/db/relations/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/db/relations/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/db/relations/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/db/tables/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/db/tables/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/db/tables/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/draft/approve/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/draft/approve">> = Specific
+  const handler = {} as typeof import("../../app/api/draft/approve/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/draft/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/draft">> = Specific
+  const handler = {} as typeof import("../../app/api/draft/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/draft/status/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/draft/status">> = Specific
+  const handler = {} as typeof import("../../app/api/draft/status/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/edges/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/edges/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/edges/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/edges/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/edges">> = Specific
+  const handler = {} as typeof import("../../app/api/edges/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/endpoints/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/endpoints/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/endpoints/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/entities/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/entities">> = Specific
+  const handler = {} as typeof import("../../app/api/entities/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/ingest/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/ingest">> = Specific
+  const handler = {} as typeof import("../../app/api/ingest/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/init/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/init">> = Specific
+  const handler = {} as typeof import("../../app/api/init/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/map/describe/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/map/describe">> = Specific
+  const handler = {} as typeof import("../../app/api/map/describe/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/map/files/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/map/files">> = Specific
+  const handler = {} as typeof import("../../app/api/map/files/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/map/finish/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/map/finish">> = Specific
+  const handler = {} as typeof import("../../app/api/map/finish/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/map/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/map">> = Specific
+  const handler = {} as typeof import("../../app/api/map/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/map/start/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/map/start">> = Specific
+  const handler = {} as typeof import("../../app/api/map/start/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/map/touch-active/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/map/touch-active">> = Specific
+  const handler = {} as typeof import("../../app/api/map/touch-active/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/nodes/[id]/position/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/nodes/[id]/position">> = Specific
+  const handler = {} as typeof import("../../app/api/nodes/[id]/position/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/nodes/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/nodes/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/nodes/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/nodes/positions/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/nodes/positions">> = Specific
+  const handler = {} as typeof import("../../app/api/nodes/positions/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/nodes/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/nodes">> = Specific
+  const handler = {} as typeof import("../../app/api/nodes/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/nodes/subtasks/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/nodes/subtasks">> = Specific
+  const handler = {} as typeof import("../../app/api/nodes/subtasks/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/notes/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/notes/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/notes/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/notes/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/notes">> = Specific
+  const handler = {} as typeof import("../../app/api/notes/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/open/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/open">> = Specific
+  const handler = {} as typeof import("../../app/api/open/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/plan/annotations/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/plan/annotations">> = Specific
+  const handler = {} as typeof import("../../app/api/plan/annotations/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/plan/approve/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/plan/approve">> = Specific
+  const handler = {} as typeof import("../../app/api/plan/approve/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/plan/history/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/plan/history">> = Specific
+  const handler = {} as typeof import("../../app/api/plan/history/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/plan/markdown/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/plan/markdown">> = Specific
+  const handler = {} as typeof import("../../app/api/plan/markdown/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/plan/presence/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/plan/presence">> = Specific
+  const handler = {} as typeof import("../../app/api/plan/presence/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/plan/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/plan">> = Specific
+  const handler = {} as typeof import("../../app/api/plan/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/plan/verdict/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/plan/verdict">> = Specific
+  const handler = {} as typeof import("../../app/api/plan/verdict/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/preferences/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/preferences">> = Specific
+  const handler = {} as typeof import("../../app/api/preferences/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/reset/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/reset">> = Specific
+  const handler = {} as typeof import("../../app/api/reset/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/settings/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/settings">> = Specific
+  const handler = {} as typeof import("../../app/api/settings/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/stream/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/stream">> = Specific
+  const handler = {} as typeof import("../../app/api/stream/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/version/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/version">> = Specific
+  const handler = {} as typeof import("../../app/api/version/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/workspace/activate/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/workspace/activate">> = Specific
+  const handler = {} as typeof import("../../app/api/workspace/activate/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/workspace/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/workspace">> = Specific
+  const handler = {} as typeof import("../../app/api/workspace/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+
+
+
+
+// Validate ../../app/layout.tsx
+{
+  type __IsExpected<Specific extends LayoutConfig<"/">> = Specific
+  const handler = {} as typeof import("../../app/layout.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}

package/README.md

@@ -0,0 +1,94 @@
+# Beacon
+
+Beacon is the **visual planning surface for the coding agent in your terminal**.
+
+You already have a Claude Code session running — that session is the brain. Beacon is its
+**eyes and hands**: the place where the agent proposes a feature plan (roadmap features +
+database schema + endpoints), you review it on a canvas instead of as a wall of text, give
+scoped structured feedback, and approve or discard with a click. Beacon does **not** embed
+a chatbot and does **not** generate plans on its own.
+
+## How the loop closes
+
+1. You ask the agent to plan a feature in your terminal session.
+2. The agent calls the MCP tool `beacon_propose_plan`. The tool **blocks** waiting for your
+   verdict.
+3. Beacon renders the plan on `/plan` — a split screen with a native annotation panel on the
+   left and the roadmap + database canvases tabbed on the right.
+4. You review, annotate inline, optionally edit the `/map` and `/db` boards directly, then
+   click **Submit feedback**, **Approve plan**, or **Discard**.
+5. The verdict (plus any feedback) returns to the terminal session. On approve, the schema +
+   roadmap drafts are persisted and the plan is archived to `/plan` history.
+
+## Views
+
+- **/plan** — the review surface: annotation panel + roadmap/database canvases + plan history.
+- **/map** — the roadmap (features → sub-tasks → dependencies) and the architecture inventory,
+  as interactive React Flow graphs. A **files** tab renders the live import graph.
+- **/db** — the database design: tables (columns, PK/FK markers), FK relationships, and which
+  endpoints touch which tables — with a distinct **draft** layer for proposed schema.
+- **/settings** — intel model/provider/editor choices, code-map sync, and the danger zone.
+
+## Stack
+
+- Next.js 16 (App Router, React 19, Turbopack) · TypeScript · Tailwind v4
+- ShadCN + **base-ui** primitives; React Flow (`@xyflow/react`) for the maps
+- **Drizzle ORM** over **`bun:sqlite`** (Bun's built-in SQLite — no native addon, no driver
+  adapter). The DB is local-only, one file per workspace under `~/.beacon/<id>/`.
+- **Bun** for package management, runtime, and tests (`bun test` — native, no Vite)
+
+## Install & run
+
+Beacon ships as a CLI. Run it inside any repo:
+
+```bash
+beacon            # registers the repo, ensures the shared server, opens the panel
+beacon doctor     # audit what's wired (global hooks, repo .mcp.json, AGENTS.md block)
+beacon stop       # stop the shared background server
+```
+
+One shared Beacon server (daemon) serves every repo you open; each repo keeps its own data in
+`~/.beacon/<id>/` (override the root with `BEACON_HOME`). On first run in a repo, run
+`/beacon-init` in your Claude Code session to map the project's architecture, schema, and
+roadmap into Beacon.
+
+### Local development of Beacon itself
+
+```bash
+make install     # bun install
+make dev         # next dev + the intel watcher together
+make test        # bun test (data layer, mutations, ingest, plan loop, code graph, intel…)
+make studio      # drizzle studio
+```
+
+> Schema note: edit `lib/drizzle/schema.ts`, then `bun run db:generate` (drizzle-kit) to add a
+> migration and restart the dev server. Existing local DBs self-heal on open (lib/drizzle/provision).
+
+## Live code-intelligence daemon (`intel/`)
+
+As you write code (any language), a watcher keeps the `/db` and **files** maps in sync —
+tables, FK relationships, endpoint↔table usage, and the import graph — updating live as you
+save. It reads an optional `beacon.config.json` at the repo root (`roots[]`, `openapiUrl?`,
+`controlUrl?`, `llm`), or derives everything from the repo when run via the CLI.
+
+```bash
+make up      # terminal 1: the panel server
+make watch   # terminal 2: the watcher  (or `make dev` to run both)
+```
+
+On each save: debounced watcher → gather source files + the framework's OpenAPI spec + the
+import graph → **the agent reads the code** and emits a structured graph (tables/columns/FKs +
+endpoint↔table usage) → `POST /api/ingest` upserts it (preserving your manual nodes + hand-
+placed positions) → SSE refreshes the open map. Introspected nodes show a green "live" dot.
+
+**Provider — no API key needed.** `provider: "auto"` (default) runs extraction through the
+**Claude Code CLI in headless mode** using your Claude Code subscription. Force it with
+`"claude-cli"`, or set `"api"` + `ANTHROPIC_API_KEY` to use the Anthropic API instead. With
+neither, the daemon still ingests endpoints from OpenAPI (deterministic-only).
+
+## Deploy
+
+Beacon is local-first: every user's boards live in per-workspace SQLite on their own machine,
+so there is **no production database**. A hosted deployment is just the static app + (optionally)
+read-only shared-board snapshots persisted to a blob/KV store — no Postgres, no migrations to run
+against a server.

package/dist/bin/beacon.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+// @bun
+import{execSync as y,spawn as k}from"child_process";import{existsSync as D,mkdirSync as b,openSync as E,readFileSync as S,writeFileSync as h}from"fs";import{homedir as f,platform as F}from"os";import{basename as c,dirname as I,join as q}from"path";import{fileURLToPath as m}from"url";var M=I(m(import.meta.url)),T=c(I(M))==="dist",L=T?I(I(M)):I(M),x=process.cwd(),G=process.env.BEACON_HOME||q(f(),".beacon"),_=q(G,"server.json"),P=process.env.PORT||"4319";if(!process.env.BEACON_MIGRATIONS_DIR)process.env.BEACON_MIGRATIONS_DIR=q(L,"drizzle");function X(z){if(!T)return q(L,z);return q(L,"dist",z.replace(/\.ts$/,".js"))}var Y=process.argv[2];if(Y==="mcp")await import(X("bin/mcp.ts"));else if(Y==="hook")await import(X("bin/hook.ts"));else if(Y==="plan")await import(X("bin/plan.ts"));else if(Y==="prompt")await import(X("bin/prompt.ts"));else if(Y==="stop-hook")await import(X("bin/stop-hook.ts"));else if(Y==="stop")a();else if(Y==="setup")await w(O()||x);else if(Y==="doctor")await import(X("bin/doctor.ts"));else if(Y==="uninstall")await import(X("bin/uninstall.ts"));else await p();async function w(z,Q=!1){let{installInitSkill:Z,installRefreshSkill:$,ensureMcp:U,ensureWorkflowDoc:N}=await import(X("lib/assets.ts")),{selfHealGlobal:V}=await import(X("lib/global-install.ts"));await V();let W=Z(z),B=$(z);N(z);let J=U(z);if(Q){if(J.added)console.log(`[beacon] registered Beacon MCP in ${J.path} \u2014 restart Claude Code to use @beacon mentions.`)}else console.log(`
+  \u25C9 Beacon setup \xB7 ${z}`),console.log(`  \u2713 skill:  ${W}`),console.log(`  \u2713 skill:  ${B}`),console.log(`  ${J.added?"\u2713 added ":"\xB7 kept  "} Beacon MCP in ${J.path}`),console.log(`  \u2192 in this repo, run /beacon-init in Claude Code to map the repo.
+`);return{initSkill:W,refreshSkill:B,mcp:J}}function O(){try{return y("git rev-parse --show-toplevel",{cwd:x,stdio:["ignore","pipe","ignore"]}).toString().trim()}catch{return""}}function v(z){try{return process.kill(z,0),!0}catch{return!1}}function C(z){try{return JSON.parse(S(z,"utf8"))}catch{return null}}async function A(z){try{return(await fetch(z)).ok}catch{return!1}}async function u(z,Q=60){for(let Z=0;Z<Q;Z++){if(await A(z))return!0;await new Promise(($)=>setTimeout($,500))}return!1}function g(){b(G,{recursive:!0});let z=E(q(G,"server.log"),"a"),Q={...process.env,PORT:P,BEACON_NO_OPEN:"1",BEACON_MIGRATIONS_DIR:q(L,"drizzle")};delete Q.BEACON_REPO,delete Q.BEACON_DATA_DIR,delete Q.DATABASE_URL;let $=k("bun",T?["run","start"]:["run","dev"],{cwd:L,env:Q,detached:!0,stdio:["ignore",z,z]});$.unref();let U={pid:$.pid??0,port:P};return h(_,JSON.stringify(U)),U}async function d(){let z=C(_);if(z&&v(z.pid)&&await A(`http://localhost:${z.port}/api/workspace`))return z.port;console.log("[beacon] starting the Beacon server\u2026");let{port:Q}=g();if(!await u(`http://localhost:${Q}/api/workspace`))console.log("[beacon] (server is taking a while \u2014 it may still be compiling)");return Q}function t(z){if(process.env.BEACON_NO_OPEN)return;let Q=F()==="darwin"?"open":F()==="win32"?"start":"xdg-open";try{y(`${Q} "${z}"`,{stdio:"ignore"})}catch{}}async function p(){let z=O()||x,{addWorkspace:Q,idForPath:Z,dataDirFor:$,ensureWorkspaceDb:U}=await import(X("lib/workspaces.ts")),N=Z(z),V=$(N),W=!D(q(V,"db.sqlite"));if(W)console.log(`[beacon] first run for ${z} \u2014 creating database\u2026`);let B=await U(N);if(!B.ok)console.error(`[beacon] failed to provision database: ${B.error}`);if(W)console.log("[beacon] tip: already have code here? run `/beacon-init` in Claude Code to map the project.");await w(z,!0);let{setupGlobalAssets:J}=await import(X("lib/global-install.ts")),K=await J(),H=[];if(K.skillsAdded.length)H.push(`skills ${K.skillsAdded.join(", ")}`);if(K.hooksAdded)H.push(`${K.hooksAdded} Claude Code hook${K.hooksAdded===1?"":"s"}`);if(K.claudeMdBlockTouched)H.push("global CLAUDE.md block");if(H.length)console.log(`[beacon] wired into ~/.claude/: ${H.join(" + ")}.`);Q(z);let j=await d(),R=`http://localhost:${j}/api/workspace/activate?id=${N}&redirect=/map`;console.log(`
+  \u25C9 Beacon
+  repo:  ${z}
+  data:  ${V}
+  url:   http://localhost:${j}
+`),console.log("  (the server keeps running in the background \u2014 `beacon stop` to stop it)\n"),t(R)}function a(){let z=C(_);if(z&&v(z.pid))try{process.kill(z.pid),console.log(`[beacon] stopped the server (pid ${z.pid}).`)}catch{console.log("[beacon] could not stop the server.")}else console.log("[beacon] no server running.")}