trybeacon 0.1.0

package/dist/bin/mcp.js

@@ -0,0 +1,247 @@
+#!/usr/bin/env bun
+// @bun
+var T5=Object.defineProperty;var S5=($)=>$;function h5($,Q){this[$]=S5.bind(null,Q)}var e=($,Q)=>{for(var Z in Q)T5($,Z,{get:Q[Z],enumerable:!0,configurable:!0,set:h5.bind(Q,Z)})};var b0=($,Q)=>()=>($&&(Q=$($=0)),Q);var s0={};e(s0,{removeRepoAssets:()=>b5,installRefreshSkill:()=>x5,installPlanSkill:()=>g5,installInitSkill:()=>y5,ensureWorkflowDoc:()=>f5,ensureMcp:()=>u5,auditRepo:()=>z5,REFRESH_SKILL:()=>c0,PLAN_SKILL:()=>l0,INIT_SKILL:()=>p0});import{existsSync as K0,mkdirSync as M0,readFileSync as _,rmSync as N0,writeFileSync as I}from"fs";import{join as C}from"path";function y5($){let Q=C($,".claude","skills","beacon-init");M0(Q,{recursive:!0});let Z=C(Q,"SKILL.md");return I(Z,p0),Z}function x5($){let Q=C($,".claude","skills","beacon-refresh");M0(Q,{recursive:!0});let Z=C(Q,"SKILL.md");return I(Z,c0),Z}function g5($){let Q=C($,".claude","skills","beacon-plan");M0(Q,{recursive:!0});let Z=C(Q,"SKILL.md");return I(Z,l0),Z}function f5($){let Q=C($,"AGENTS.md"),Z="";try{Z=_(Q,"utf8")}catch{}let X=new RegExp(`${$0}[\\s\\S]*?${W0}`);Z=X.test(Z)?Z.replace(X,m0):`${Z.trim()}
+
+${m0}
+`.trimStart(),I(Q,Z.endsWith(`
+`)?Z:`${Z}
+`);let V=C($,"CLAUDE.md"),H="";try{H=_(V,"utf8")}catch{}if(!/@AGENTS\.md/.test(H))I(V,`${H?`${H.trim()}
+
+`:""}@AGENTS.md
+`)}function u5($){let Q=C($,".mcp.json"),Z={};try{Z=JSON.parse(_(Q,"utf8"))}catch{}if(Z.mcpServers=Z.mcpServers??{},Z.mcpServers.beacon)return{path:Q,added:!1};return Z.mcpServers.beacon={command:"beacon",args:["mcp"]},I(Q,JSON.stringify(Z,null,2)+`
+`),{path:Q,added:!0}}function z5($){let Q=C($,".mcp.json"),Z=!1;try{Z=!!JSON.parse(_(Q,"utf8")).mcpServers?.beacon}catch{}let X=!1;try{X=_(C($,"AGENTS.md"),"utf8").includes($0)}catch{}let V=!1;try{V=/@AGENTS\.md/.test(_(C($,"CLAUDE.md"),"utf8"))}catch{}return{repo:$,mcpRegistered:Z,agentsMdBlock:X,claudeMdImport:V,skills:{"beacon-init":K0(C($,".claude","skills","beacon-init","SKILL.md")),"beacon-refresh":K0(C($,".claude","skills","beacon-refresh","SKILL.md"))}}}function b5($){let Q=[];for(let K of["beacon-init","beacon-refresh","beacon-db-design"]){let O=C($,".claude","skills",K);if(K0(O))N0(O,{recursive:!0,force:!0}),Q.push(K)}let Z=!1,X=C($,".mcp.json");try{let K=JSON.parse(_(X,"utf8"));if(K.mcpServers?.beacon){if(delete K.mcpServers.beacon,Z=!0,K.mcpServers&&Object.keys(K.mcpServers).length===0)delete K.mcpServers;if(Object.keys(K).length===0)N0(X,{force:!0});else I(X,JSON.stringify(K,null,2)+`
+`)}}catch{}let V=!1,H=C($,"AGENTS.md");try{let K=_(H,"utf8"),O=new RegExp(`\\n?${$0}[\\s\\S]*?${W0}\\n?`);if(O.test(K)){let l=K.replace(O,`
+`).replace(/\n{3,}/g,`
+
+`).trimStart();I(H,l.endsWith(`
+`)?l:`${l}
+`),V=!0}}catch{}let B=!1,N=C($,"CLAUDE.md");try{let K=_(N,"utf8"),O=K.replace(/^[ \t]*@AGENTS\.md[ \t]*\n?/m,"");if(O!==K){if(!O.trim())N0(N,{force:!0});else I(N,O);B=!0}}catch{}return{skillsRemoved:Q,mcpUnregistered:Z,agentsBlockRemoved:V,claudeImportRemoved:B}}var p0=`---
+name: beacon-init
+description: Read this repository and map its architecture, schema, and roadmap into Beacon (the local visual planning panel). Use when the user runs /beacon-init, asks to "set up Beacon for this repo", or asks to initialize/bootstrap Beacon's map of this codebase.
+---
+
+# Map this repo into Beacon (/beacon-init)
+
+The user already has Beacon running. You're going to map this repository's architecture into it \u2014 what used to be \`beacon init\`. **You** do the analysis (your session already has the codebase context); Beacon just persists what you send.
+
+## What you produce
+
+A single \`beacon_init_persist\` MCP tool call with:
+
+- **components**: 8\u201325 main building blocks of this codebase. NOT every file. Group them by \`domain\` (short UPPERCASE: AUTH, API, DATA, UI, JOBS, INFRA, BILLING, SEARCH, \u2026). For each: a one-line technical \`role\`, a one-sentence plain-language \`plain\`, the few \`files\` that implement it (repo-relative), and \`depends\` listing other component titles it relies on. Use the dependency graph you can see in the source \u2014 files that import each other heavily usually belong together.
+- **roadmap**: 3\u20136 BROAD strategic directions. Big-picture themes only \u2014 "Harden auth & security", "Add observability", "Scale the data layer", "Pay down test-coverage debt". NOT detailed tasks. NOT file-level. Each gets a short title and one-line \`why\`.
+- **overview**: one paragraph describing what this project is and its stack. This lands in AGENTS.md as the project intro.
+- **conventions**: 3\u20138 concrete rules a contributor MUST follow \u2014 build/test commands, where code goes, patterns, things easy to get wrong. Infer from actual files, not assumptions.
+- **snapshot** (optional but encouraged): \`{ tables, relations, endpoints }\` for the existing database. If the project uses Prisma, read \`prisma/schema.prisma\`. If SQLAlchemy, read the model files. If Django, read \`models.py\`. If you find no obvious schema source, skip the snapshot \u2014 don't fabricate.
+
+## How to do it
+
+1. **Survey**. Use \`LS\` / \`Glob\` to see the top-level structure. Read \`README.md\` and the manifest (\`package.json\` / \`pyproject.toml\` / \`go.mod\` / \`Cargo.toml\` / \`pom.xml\`).
+2. **Sample the source.** Read 15\u201330 representative files \u2014 one per cluster you can identify. Don't read everything; pick by name (route files, model files, main entrypoints, key services). The goal is to identify boundaries, not memorize every line.
+3. **Identify the schema** if any. \`prisma/schema.prisma\` \u2192 translate each model into a \`tables\` entry. \`alembic\`/SQLAlchemy \u2192 read the latest models. Django \u2192 read \`models.py\`. Skip the snapshot if the source-of-truth isn't obvious.
+4. **Identify endpoints** if any. Look for routes \u2014 Next.js \`app/api/*\` files, FastAPI \`@router.*\` / \`@app.*\`, Express \`app.get\`/etc. For each endpoint try to fill \`uses: [{ table, access }]\` so the canvas can draw which endpoint touches which table.
+5. **Call \`beacon_init_persist\`** ONCE with the whole analysis. It replaces any prior init-derived map (idempotent) and regenerates \`AGENTS.md\`.
+
+## What you should NOT do
+
+- Don't propose detailed tasks in \`roadmap\` \u2014 that's what \`beacon_propose_plan\` is for. Init roadmap is strategic only.
+- Don't list every file as a \`component\`. Aim for ~15. If you have 40, you're listing files, not components.
+- Don't fabricate tables/endpoints. If you can't find the schema source, omit \`snapshot\`.
+- Don't ask the user to confirm before persisting. The user invoked /beacon-init \u2014 that's the confirmation.
+
+If \`beacon_init_persist\` isn't available, the Beacon panel isn't running in this repo. Tell the user to run \`beacon\` here first, then re-invoke /beacon-init.
+
+After the tool returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
+`,c0=`---
+name: beacon-refresh
+description: Re-survey the repo and update Beacon's architecture / schema / endpoints map after /beacon-init was already run \u2014 picks up new components, removed ones, schema changes, and new routes. Use when the user runs /beacon-refresh or asks to "refresh", "update", "re-sync", or "bring Beacon up to date" with the current code.
+---
+
+# Refresh Beacon's map (/beacon-refresh)
+
+Beacon was already initialized in this repo (\`/beacon-init\` ran at some point). The codebase has moved since then \u2014 new modules, removed ones, schema changes, new routes. Your job is to re-survey the current code, show the user what changed, then persist the refreshed map.
+
+## How it differs from /beacon-init
+
+- **Init is a cold start** \u2014 no prior map, you survey everything fresh.
+- **Refresh is incremental** \u2014 the map already exists. Read what's there first, then diff against the source so you can tell the user what actually changed. The user gets to see "+ 3 new components, \u2212 1 removed, ~ 2 changed roles" instead of an opaque re-run.
+
+## What gets preserved vs replaced
+
+The \`beacon_init_persist\` tool **replaces only init-derived nodes** (\`source=INIT\`). Anything the user added manually on the canvas \u2014 manually-created components, hand-edited tables, custom positions, notes, draft feature plans \u2014 survives the refresh untouched. So you can re-run this freely; nothing the user curated by hand is at risk.
+
+The one caveat: if the user manually edited an INIT-source node on the canvas (e.g., renamed it, rewrote its role), that edit IS overwritten when you re-persist. If the user mentions hand-curated INIT nodes, ask whether they want those carried into the new analysis verbatim.
+
+## How to do it
+
+1. **Read the current map.** Call \`beacon_entities\` with \`{ kind: "architecture" }\`, \`{ kind: "roadmap" }\`, \`{ kind: "tables" }\`, \`{ kind: "endpoints" }\`. This is what Beacon has now.
+2. **Survey the source like init.** Same approach as \`/beacon-init\`: \`LS\` / \`Glob\` for top-level structure, read \`README.md\` and the manifest, sample 15\u201330 representative files. Focus on areas likely to have changed \u2014 diff your memory against what \`beacon_entities\` returned.
+3. **Build the diff in your head.** For each entity kind:
+   - **components**: which titles in the current map no longer match any cluster you'd produce? Which clusters you'd produce don't appear in the current map?
+   - **tables**: any added / removed since? Any model files you can see that aren't in the snapshot?
+   - **endpoints**: walk the route directories \u2014 any new routes, any deleted ones?
+   - **roadmap**: usually stable, but a strategic theme can finish or new ones can emerge.
+4. **Surface the diff to the user, briefly, BEFORE persisting.** Something like:
+   - **+ added**: NEW_COMPONENT_1, NEW_COMPONENT_2 (with one-line reason each)
+   - **\u2212 removed**: STALE_COMPONENT (file no longer exists)
+   - **~ changed**: COMPONENT_X (role expanded to cover Y)
+   - **schema**: + 2 new tables (TableA, TableB); + 3 new endpoints; \u2212 1 deprecated endpoint
+   No need to wait for confirmation \u2014 just show the diff so the user sees what's about to land.
+5. **Call \`beacon_init_persist\`** ONCE with the refreshed full analysis (same shape as init: \`components\`, \`roadmap\`, \`overview\`, \`conventions\`, \`snapshot\`). It replaces all init-source nodes and regenerates \`AGENTS.md\`.
+
+## What you should NOT do
+
+- Don't ask "should I refresh?" \u2014 the user invoked /beacon-refresh, that's the answer.
+- Don't preserve stale components for sentimental reasons. If the underlying files are gone or merged into another component, drop it from the new \`components\` list.
+- Don't pad with file-level granularity. Refresh maintains the same ~15-component altitude as init.
+- Don't fabricate changes. If the codebase hasn't materially moved since the last init, say so and persist the current state anyway (re-runs are cheap; it's fine).
+
+If \`beacon_entities\` or \`beacon_init_persist\` isn't available, the Beacon panel isn't running in this repo. Tell the user to run \`beacon\` here first, then re-invoke /beacon-refresh.
+
+After the tool returns, report the final counts plus a one-line summary of the diff you surfaced.
+`,l0=`---
+name: beacon-plan
+description: Present your current plan or approach to the user on Beacon's /plan canvas for review \u2014 instead of asking for approval in prose. Use when the user says "present the plan", "show me the plan", "let me see it / the plan", or whenever you are about to end a turn asking whether to proceed with a plan, design, or approach.
+---
+
+# Present a plan on Beacon (/beacon-plan)
+
+Beacon reviews plans on a canvas at /plan \u2014 never as a wall of text in the terminal. So do NOT
+end a turn with "here's my plan\u2026 should I proceed?" in prose. Present it through Beacon and let the
+tool BLOCK until the user decides.
+
+## How to present
+
+Call the **\`beacon_present_plan\`** MCP tool with your plan as markdown:
+
+- \`description\`: a one-line summary shown in the review header.
+- \`markdown\`: the full plan as markdown (headings, lists, code).
+- If the plan proposes DB tables / relations / endpoints or roadmap features, embed ONE fenced
+  \`\`\`beacon JSON block in the markdown \u2014 the same shapes \`beacon_propose_plan\` accepts:
+
+\`\`\`beacon
+{ "tables": [...], "relations": [...], "endpoints": [...], "features": [...] }
+\`\`\`
+
+Beacon extracts that block deterministically, strips it from the prose, and renders an editable
+board on /plan. The board is built ONLY from the block \u2014 prose is never parsed \u2014 so mirror EVERY
+table/endpoint/feature you mention in the prose into the block, or that board will be empty.
+
+\`beacon_present_plan\` opens /plan and BLOCKS until the user clicks Approve / Discard / submits
+feedback, then returns their verdict. Implement code or migrations ONLY after it returns approval.
+If it returns feedback, revise and call it again.
+
+## Which tool
+
+- **Pure schema/feature plan** (tables + endpoints + roadmap features, little prose) \u2192 you may use
+  \`beacon_propose_plan\` with the structured fields instead; it's the same review loop.
+- **Anything else** (a code-change plan, a mixed plan, a "how should I approach X") \u2192 use
+  \`beacon_present_plan\` with markdown so the full reasoning shows on /plan.
+
+If \`beacon_present_plan\` isn't available, the panel isn't wired here \u2014 fall back to presenting via
+ExitPlanMode with the same \`\`\`beacon block, or tell the user to run \`beacon\` in this repo once.
+`,$0="<!-- beacon:workflow:start -->",W0="<!-- beacon:workflow:end -->",m0;var d0=b0(()=>{m0=`${$0}
+## Beacon \u2014 feature workflow
+
+This project uses Beacon (a local planning/visualization panel; run \`beacon\` to open it). When you start work on a FEATURE \u2014 whether referenced via an \`@beacon:feature://\u2026\` mention, an \`@beacon://note/\u2026\` note the user wrote in the Notes panel (treat its checkbox \`- [ ]\` todos as subtasks and order features by their dependencies), or just described in chat \u2014 follow these steps in order:
+
+### 1. Load context FIRST \u2014 do NOT Glob/Grep the codebase blind
+
+Call \`beacon_context_for_feature({ id | title | query })\` BEFORE reading files. It returns, in one round-trip:
+- the files the feature is attached to,
+- what those files import + what imports them (live code-graph blast radius),
+- endpoints in the feature's domain + the tables each touches + those tables' FK relations,
+- sibling architecture components and the project's conventions.
+
+That bundle replaces the discovery phase. Read only the files it returns plus whatever those imports lead you to. If the feature has no files attached yet, the bundle still gives you the domain map \u2014 Glob is a last resort.
+
+Mid-feature, when deciding whether a change is safe, call \`beacon_blast_radius({ path })\` for the file you're about to edit \u2014 same code-graph data, file-centric.
+
+### 2. Design the data BEFORE writing code
+
+Determine the database tables the feature needs. If any don't exist yet, design the schema and call \`beacon_propose_plan\` (tables + relations + endpoints). This renders an **editable draft on the /plan page** for the user to review. The tool BLOCKS until the user clicks Approve / Discard / submits feedback. Implement migrations + code ONLY after it returns approval.
+
+When listing endpoints, give each \`uses: [{ table, access }]\` so the endpoint\u2192table links draw on /db.
+
+EVERY feature MUST carry \`category\` (e.g. AUTH | SEARCH | DATA | INTEL | BILLING | \u2026; \`cluster\` is accepted as an alias) and \`priority\` (0 = P0 critical, 1 = P1 high, 2 = P2 medium, 3 = P3 low). Beacon REJECTS a plan whose features omit either \u2014 \`beacon_propose_plan\` returns the list of what's missing, and an ExitPlanMode \`\`\`beacon block is denied \u2014 so set both on every feature instead of relying on defaults.
+
+REUSE before you create. Call \`beacon_map\` to see the features + categories that already exist. Beacon HARD-BLOCKS a feature that duplicates an existing one (it returns the existing feature to use instead) and one created without a category \u2014 so don't re-create work that's already on the board, and reuse an existing category rather than a near-synonym. \`category\` is the ONLY domain field. \`front\` (in \`beacon_start_feature\`) nests a feature UNDER an existing parent feature \u2014 it is NOT a domain tag; a \`front\` that matches no real feature is rejected.
+
+When listing features, give each \`dependsOn: ["Other feature title", \u2026]\` for any feature that must ship after another in the same plan. Beacon draws these as "depends on" links so the roadmap shows the dependency chain instead of loose, disconnected cards.
+
+### 2b. Presenting a plan in plan mode (ExitPlanMode)
+
+When you present a plan via ExitPlanMode (not \`beacon_propose_plan\`) and it proposes DB tables/relations/endpoints or roadmap features, embed ONE fenced \`\`\`beacon code block of JSON in the plan \u2014 the same shapes \`beacon_propose_plan\` accepts:
+
+\`\`\`beacon
+{ "tables": [...], "relations": [...], "endpoints": [...], "features": [...] }
+\`\`\`
+
+Beacon extracts it deterministically and **strips the block from the prose** (it's never shown in the annotation panel), then renders the tables + features as an **editable board** on /plan so the user can edit them and have those edits flow back as feedback. Omit the block for pure code-change plans.
+
+**The board is built ONLY from the block \u2014 prose is NOT parsed.** If your plan describes ANY database models/tables/columns in the prose (e.g. "Model \`legal_precedent.py\` \u2014 natural key (court, \u2026)"), you MUST also put them in the block's \`tables\` array (with \`columns\`), or the /db tab will be empty for that plan. Same for endpoints (\`endpoints\` with \`uses:[{table,access}]\`) and features (\`features\`). A plan that lists five tables in prose but ships a block with only \`features\` renders an empty database board \u2014 exactly the "I described models but the DB tab is empty" failure. Mirror every DB entity you mention into the block.
+
+### 3. At the end, register the work
+
+Call \`beacon_describe_feature\` for **EVERY** feature the plan created \u2014 once per feature, **by its exact title** (the same titles you listed in \`features\`/the \`\`\`beacon block) \u2014 with the files you touched and a short markdown description. This flips each one to **Done** and keeps \`beacon_context_for_feature\` accurate for the next session.
+
+Do this per feature. If a plan added five features, that's five \`beacon_describe_feature\` calls \u2014 registering only an umbrella ("Harden auth") leaves the individual features stuck on **Pending** on the map.
+
+If the feature added or materially changed a REAL architectural component (a subsystem \u2014 NOT a file), also pass \`architecture: [{ title, domain, role, \u2026 }]\` so the Architecture map stays accurate. It upserts curated components by title; never list files as components.
+
+Pull raw planning data anytime with \`beacon_entities\` (features / architecture / tables / endpoints).
+${W0}`});var e0={};e(e0,{provisionDb:()=>j9});import{createClient as e5}from"@libsql/client";import{drizzle as $9}from"drizzle-orm/libsql";import{migrate as Q9}from"drizzle-orm/libsql/migrator";import{readMigrationFiles as Z9}from"drizzle-orm/migrator";import{dirname as F0,join as J9}from"path";import{fileURLToPath as X9}from"url";async function X0($,Q){return(await $.execute({sql:"SELECT 1 FROM sqlite_master WHERE type='table' AND name = ?",args:[Q]})).rows.length>0}async function G9($,Q){let Z=await $.execute(`PRAGMA table_info("${Q}")`);return new Set(Z.rows.map((X)=>String(X.name)))}async function t0($){if(!await X0($,"__drizzle_migrations"))return 0;let Q=await $.execute('SELECT count(*) AS n FROM "__drizzle_migrations"');return Number(Q.rows[0]?.n??0)}async function B9($){for(let[Q,Z]of Object.entries(H9)){if(!await X0($,Q))continue;let X=await G9($,Q);for(let V of Z){if(!X.has(V))continue;await $.execute(`UPDATE "${Q}" SET "${V}" = CAST((julianday("${V}") - 2440587.5) * 86400000 AS INTEGER) WHERE typeof("${V}") = 'text'`)}}}async function j9($,Q=V9){let Z=e5({url:$});try{await Z.execute("PRAGMA journal_mode = WAL;"),await Z.execute("PRAGMA foreign_keys = ON;");let X=await X0(Z,"__drizzle_migrations"),V=await X0(Z,"Node"),H=!1;if(V&&!X){let N=Z9({migrationsFolder:Q})[0];if(N)await Z.execute('CREATE TABLE IF NOT EXISTS "__drizzle_migrations" (id SERIAL PRIMARY KEY, hash text NOT NULL, created_at numeric)'),await Z.execute({sql:'INSERT INTO "__drizzle_migrations" ("hash", "created_at") VALUES (?, ?)',args:[N.hash,N.folderMillis]}),H=!0}let B=await t0(Z);if(await Q9($9(Z),{migrationsFolder:Q}),await t0(Z)>B)H=!0;return await B9(Z),{migrated:H}}finally{Z.close()}}var Y9,V9,H9;var $5=b0(async()=>{Y9=F0(F0(F0(X9(import.meta.url)))),V9=process.env.BEACON_MIGRATIONS_DIR||J9(Y9,"drizzle"),H9={Node:["createdAt","updatedAt"],Note:["createdAt","updatedAt"],DbTable:["createdAt","updatedAt"],Endpoint:["createdAt","updatedAt"],DraftTable:["createdAt"],SyncState:["codeGraphSyncedAt","updatedAt"],AppSetting:["updatedAt"],ProjectMeta:["updatedAt"],CodeFile:["updatedAt"]}});import{existsSync as P0,mkdirSync as C0,readFileSync as Z0,rmSync as m5,writeFileSync as J0}from"fs";import{homedir as p5}from"os";import{join as T}from"path";function c5(){return process.env.HOME||process.env.USERPROFILE||p5()}var z=()=>T(c5(),".claude"),O0=()=>T(z(),"skills"),o0=()=>T(z(),"settings.json"),s=()=>T(z(),"CLAUDE.md"),Q0="<!-- beacon:global:start -->",U0="<!-- beacon:global:end -->",w0=["beacon-init","beacon-refresh","beacon-plan"],q0=[{event:"PostToolUse",matcher:"Edit|Write|MultiEdit",command:"beacon hook",description:"Report file edits to Beacon's active feature so the map stays fresh."},{event:"PermissionRequest",matcher:"ExitPlanMode",command:"beacon plan",description:"Pipe the agent's plan markdown into Beacon's /plan canvas for review."},{event:"UserPromptSubmit",matcher:"*",command:"beacon prompt",description:"On feature-y prompts in a Beacon-wired repo, remind the agent to run the context\u2192propose\u2192describe loop (no-op otherwise)."},{event:"Stop",matcher:"*",command:"beacon stop-hook",description:"When the agent ends a turn asking for plan approval in prose (instead of presenting it), nudge it to present the plan on Beacon's /plan canvas. Bounded by stop_hook_active \u2014 at most one nudge."}],l5=`## Beacon (visual planning panel)
+
+This machine has Beacon installed \u2014 a local visual planning surface for the terminal-side
+agent. Beacon proposes feature plans (roadmap features + DB schema + endpoints) via MCP,
+the user reviews on a canvas at /plan, and feedback flows back as the next round.
+
+**When to invoke**
+- User asks to "plan a feature" / "design a schema" \u2192 if the \`beacon_propose_plan\`
+  MCP tool is available, design the plan and call it. If it is NOT available, the panel
+  isn't wired in this repo \u2014 run \`beacon\` here once, then retry.
+- User asks to "set up Beacon" / "map this repo" \u2192 invoke the \`beacon-init\` skill.
+- User asks to "refresh Beacon" / "update the map" / "bring Beacon up to date" \u2192 invoke
+  the \`beacon-refresh\` skill. Re-surveys the repo and updates init-derived nodes while
+  preserving anything the user added by hand.
+- Run \`beacon doctor\` to audit what's wired (global hooks, repo's .mcp.json, AGENTS.md block).
+
+**The plan feedback loop**
+\`beacon_propose_plan\` BLOCKS until the user clicks Approve / Discard / submits feedback.
+Feedback bundles inline annotations on the markdown PLUS any edits the user made directly
+on the /map and /db boards (added features, attached subtasks, edited columns, new
+endpoints). Treat board edits as the user's revision intent \u2014 re-propose matching them
+verbatim. Do NOT implement until the tool returns approval.`;function s5($,Q){let Z=T(O0(),$);C0(Z,{recursive:!0});let X=T(Z,"SKILL.md");return J0(X,Q),X}function n0($){return P0(T(O0(),$,"SKILL.md"))}function d5($){let Q=T(O0(),$);if(!P0(Q))return!1;return m5(Q,{recursive:!0,force:!0}),!0}function D0(){try{return JSON.parse(Z0(o0(),"utf8"))}catch{return{}}}function a0($){C0(z(),{recursive:!0}),J0(o0(),JSON.stringify($,null,2)+`
+`)}function o5($){let Q=D0();Q.hooks=Q.hooks??{},Q.hooks[$.event]=Q.hooks[$.event]??[];let Z=Q.hooks[$.event];if(Z.some((V)=>V.matcher===$.matcher&&V.hooks?.some((H)=>H.command===$.command)))return!1;return Z.push({matcher:$.matcher,hooks:[{type:"command",command:$.command}]}),a0(Q),!0}function n5($){return(D0().hooks?.[$.event]??[]).some((X)=>X.hooks?.some((V)=>V.command===$.command))}function a5($){let Q=D0(),Z=Q.hooks?.[$.event];if(!Z)return!1;let X=!1,V=Z.map((H)=>{let B=H.hooks?.length??0,N=(H.hooks??[]).filter((K)=>K.command!==$.command);if(N.length!==B)X=!0;return{...H,hooks:N}}).filter((H)=>(H.hooks??[]).length>0);if(!X)return!1;if(V.length)Q.hooks[$.event]=V;else delete Q.hooks[$.event];if(Q.hooks&&Object.keys(Q.hooks).length===0)delete Q.hooks;return a0(Q),!0}function r5($){let Q=`${Q0}
+${$.trim()}
+${U0}`,Z="";try{Z=Z0(s(),"utf8")}catch{}let X=new RegExp(`${Q0}[\\s\\S]*?${U0}`);Z=X.test(Z)?Z.replace(X,Q):Z.trim()?`${Z.trim()}
+
+${Q}
+`:`${Q}
+`,C0(z(),{recursive:!0}),J0(s(),Z.endsWith(`
+`)?Z:`${Z}
+`)}function r0(){try{return Z0(s(),"utf8").includes(Q0)}catch{return!1}}function i5(){let $="";try{$=Z0(s(),"utf8")}catch{return!1}let Q=new RegExp(`${Q0}[\\s\\S]*?${U0}\\n?`);if(!Q.test($))return!1;let Z=$.replace(Q,"").replace(/\n{3,}/g,`
+
+`).trimStart();return J0(s(),Z),!0}function Y$(){let $={};for(let Z of w0)$[Z]=n0(Z);let Q={};for(let Z of q0)Q[Z.event]=n5({event:Z.event,command:Z.command});return{homeExists:P0(z()),skills:$,hooks:Q,claudeMdBlock:r0()}}async function t5(){let{INIT_SKILL:$,REFRESH_SKILL:Q,PLAN_SKILL:Z}=await Promise.resolve().then(() => (d0(),s0)),X={"beacon-init":$,"beacon-refresh":Q,"beacon-plan":Z},V=[];for(let N of w0){if(!n0(N))V.push(N);s5(N,X[N])}let H=0;for(let N of q0)if(o5({event:N.event,matcher:N.matcher,command:N.command}))H++;let B=r0();return r5(l5),{skillsAdded:V,hooksAdded:H,claudeMdBlockTouched:!B}}async function i0(){try{return{ok:!0,...await t5()}}catch($){return{ok:!1,error:$ instanceof Error?$.message:String($),skillsAdded:[],hooksAdded:0,claudeMdBlockTouched:!1}}}function V$(){let $=[];for(let X of w0)if(d5(X))$.push(X);let Q=0;for(let X of q0)if(a5(X))Q++;let Z=i5();return{skillsRemoved:$,hooksRemoved:Q,claudeMdBlockRemoved:Z}}import{AsyncLocalStorage as N9}from"async_hooks";import{spawnSync as K9}from"child_process";import{createHash as M9}from"crypto";import{existsSync as Z5,mkdirSync as Y0,readFileSync as J5,writeFileSync as X5}from"fs";import{homedir as W9}from"os";import{basename as U9,join as b}from"path";function d(){return process.env.BEACON_HOME||b(W9(),".beacon")}function v0(){return b(d(),"workspaces.json")}function V0($){return M9("sha256").update($).digest("hex").slice(0,12)}function Y5($=process.cwd()){let Q=K9("git",["rev-parse","--show-toplevel"],{cwd:$,stdio:["ignore","pipe","ignore"]});if(Q.status===0){let Z=Q.stdout?.toString().trim();if(Z)return Z}return $}function A0($){return b(d(),$)}function R0($){return`file:${b(A0($),"db.sqlite")}`}function o(){try{let $=JSON.parse(J5(v0(),"utf8"));return Array.isArray($)?$:[]}catch{return[]}}function E0($){Y0(d(),{recursive:!0}),X5(v0(),JSON.stringify($,null,2))}function P9(){return o().sort(($,Q)=>Q.lastOpenedAt.localeCompare($.lastOpenedAt))}function h($){return o().find((Q)=>Q.id===$)??null}function _0($,Q,Z=new Date().toISOString()){let X=V0($),V=o(),H=V.find((K)=>K.id===X),B={id:X,path:$,name:Q||H?.name||U9($),lastOpenedAt:Z},N=[B,...V.filter((K)=>K.id!==X)];return Y0(A0(X),{recursive:!0}),E0(N),B}function q$($,Q=new Date().toISOString()){let Z=o(),X=Z.find((V)=>V.id===$);if(!X)return;X.lastOpenedAt=Q,E0(Z)}function D$($){if(E0(o().filter((Q)=>Q.id!==$)),n()===$)C9(P9()[0]?.id??null)}function V5(){return b(d(),"active")}function n(){try{return J5(V5(),"utf8").trim()||null}catch{return null}}function C9($){Y0(d(),{recursive:!0}),X5(V5(),$??"")}function F$(){let $=n();return $?h($):null}function v$(){let $=L0()??n();return $?h($):null}function A$($){return h($)?.path??null}function R$(){return Z5(v0())}var H5="beacon_ws";function G5($,Q){let Z=$.headers.get("cookie");if(!Z)return null;for(let X of Z.split(";")){let V=X.indexOf("=");if(V===-1)continue;if(X.slice(0,V).trim()===Q)return decodeURIComponent(X.slice(V+1).trim())}return null}function E$($){let Q=$.headers.get("x-beacon-workspace");if(Q&&h(Q))return Q;let Z=G5($,H5);if(Z&&h(Z))return Z;return null}var I0="x-beacon-workspace-path";async function _$($){let Q=$.headers.get("x-beacon-workspace");if(Q&&h(Q))return Q;let Z=$.headers.get(I0);if(Z&&(!Q||V0(Z)===Q)){let V=_0(Z);return await k0(V.id),V.id}let X=G5($,H5);if(X&&h(X))return X;return null}var B5=new N9;function O9($,Q){return $?B5.run($,Q):Q()}function L0(){return B5.getStore()??null}var Q5=new Set;async function k0($){let Q=A0($),Z=b(Q,"db.sqlite"),X=Z5(Z);if(X&&Q5.has(Z))return{ok:!0,created:!1,migrated:!1};try{Y0(Q,{recursive:!0});let{provisionDb:V}=await $5().then(() => e0),H=await V(R0($));return Q5.add(Z),{ok:!0,created:!X,migrated:X&&H.migrated}}catch(V){return{ok:!1,created:!1,migrated:!1,error:V instanceof Error?V.message:String(V)}}}import{McpServer as i9,ResourceTemplate as f0}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as t9}from"@modelcontextprotocol/sdk/server/stdio.js";import{z as J}from"zod";import{z as G}from"zod";var w9=new Set(["GET","HEAD","OPTIONS"]);function j5($){return w9.has($.trim().toUpperCase())?"read":"write"}var q9=G.preprocess(($)=>{if(typeof $==="string"){let[Q,...Z]=$.trim().split(/\s+/);return{name:Q,type:Z.join(" ")||"text"}}return $},G.object({name:G.string().trim().min(1),type:G.string().trim().min(1),isPk:G.boolean().optional(),isFk:G.boolean().optional(),nullable:G.boolean().optional(),note:G.string().nullish()})),N5=G.object({name:G.string().trim().min(1),domain:G.string().nullish(),description:G.string().nullish(),columns:G.array(q9).default([])}),K5=G.object({fromTable:G.string(),fromColumn:G.string(),toTable:G.string(),toColumn:G.string(),label:G.string().nullish()}),M5=G.object({method:G.string().trim().min(1),path:G.string().trim().min(1),domain:G.string().nullish(),description:G.string().nullish(),uses:G.array(G.object({table:G.string().trim().min(1),access:G.string().optional()})).default([])}).transform(($)=>({...$,uses:$.uses.map((Q)=>({...Q,access:Q.access??j5($.method)}))})),S$=G.object({tables:G.array(N5).default([]),relations:G.array(K5).default([]),endpoints:G.array(M5).default([])});import{z as R}from"zod";import{and as e$,eq as $Q,inArray as QQ}from"drizzle-orm";import{drizzle as p9}from"drizzle-orm/libsql";import{createClient as c9}from"@libsql/client";var T0={};e(T0,{tag:()=>m,syncState:()=>A9,projectMeta:()=>E9,note:()=>v9,nodeTags:()=>y,nodeFile:()=>a,node:()=>U,endpointTable:()=>g,endpoint:()=>p,edge:()=>S,draftTable:()=>A,draftRelation:()=>f,draftColumn:()=>i,dbTable:()=>w,dbRelation:()=>x,dbColumn:()=>r,codeFileEdge:()=>u,codeFile:()=>L,appSetting:()=>R9});import{sqliteTable as P,index as W,foreignKey as D9,text as Y,integer as j,real as v,uniqueIndex as k,primaryKey as F9}from"drizzle-orm/sqlite-core";import{createId as F}from"@paralleldrive/cuid2";var U=P("Node",{id:Y().primaryKey().$defaultFn(()=>F()),view:Y().notNull(),cluster:Y(),title:Y().notNull(),role:Y(),plain:Y(),status:Y().default("PENDING").notNull(),priority:j().default(2).notNull(),progress:j().default(0).notNull(),x:v().default(0).notNull(),y:v().default(0).notNull(),sourceRef:Y(),externalId:Y(),source:Y().default("MANUAL").notNull(),parentId:Y(),createdAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date),updatedAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date).$onUpdate(()=>new Date),embedding:Y()},($)=>[W("Node_cluster_idx").on($.cluster),W("Node_parentId_idx").on($.parentId),W("Node_view_idx").on($.view),D9(()=>({columns:[$.parentId],foreignColumns:[$.id],name:"Node_parentId_Node_id_fk"})).onUpdate("cascade").onDelete("cascade")]),a=P("NodeFile",{id:Y().primaryKey().$defaultFn(()=>F()),nodeId:Y().notNull().references(()=>U.id,{onDelete:"cascade",onUpdate:"cascade"}),path:Y().notNull()},($)=>[k("NodeFile_nodeId_path_key").on($.nodeId,$.path),W("NodeFile_nodeId_idx").on($.nodeId)]),m=P("Tag",{id:Y().primaryKey().$defaultFn(()=>F()),label:Y().notNull(),color:Y()},($)=>[k("Tag_label_key").on($.label)]),S=P("Edge",{id:Y().primaryKey().$defaultFn(()=>F()),fromId:Y().notNull().references(()=>U.id,{onDelete:"cascade",onUpdate:"cascade"}),toId:Y().notNull().references(()=>U.id,{onDelete:"cascade",onUpdate:"cascade"}),kind:Y().default("DEPENDS").notNull(),label:Y(),sourceHandle:Y(),targetHandle:Y()},($)=>[k("Edge_fromId_toId_kind_key").on($.fromId,$.toId,$.kind),W("Edge_toId_idx").on($.toId),W("Edge_fromId_idx").on($.fromId)]),y=P("_NodeTags",{a:Y("A").notNull().references(()=>U.id,{onDelete:"cascade",onUpdate:"cascade"}),b:Y("B").notNull().references(()=>m.id,{onDelete:"cascade",onUpdate:"cascade"})},($)=>[k("_NodeTags_AB_unique").on($.a,$.b),W("_NodeTags_B_index").on($.b)]),v9=P("Note",{id:Y().primaryKey().$defaultFn(()=>F()),title:Y().default("Untitled").notNull(),body:Y().default("").notNull(),ord:v().default(0).notNull(),pinned:j({mode:"boolean"}).default(!1).notNull(),createdAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date),updatedAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date).$onUpdate(()=>new Date)},($)=>[W("Note_updatedAt_idx").on($.updatedAt)]),w=P("DbTable",{id:Y().primaryKey().$defaultFn(()=>F()),name:Y().notNull(),domain:Y(),description:Y(),source:Y().default("MANUAL").notNull(),x:v().default(0).notNull(),y:v().default(0).notNull(),createdAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date),updatedAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date).$onUpdate(()=>new Date)},($)=>[W("DbTable_domain_idx").on($.domain),k("DbTable_name_key").on($.name)]),r=P("DbColumn",{id:Y().primaryKey().$defaultFn(()=>F()),tableId:Y().notNull().references(()=>w.id,{onDelete:"cascade",onUpdate:"cascade"}),name:Y().notNull(),type:Y().notNull(),isPk:j({mode:"boolean"}).default(!1).notNull(),isFk:j({mode:"boolean"}).default(!1).notNull(),nullable:j({mode:"boolean"}).default(!0).notNull(),note:Y(),ord:j().default(0).notNull()},($)=>[k("DbColumn_tableId_name_key").on($.tableId,$.name),W("DbColumn_tableId_idx").on($.tableId)]),x=P("DbRelation",{id:Y().primaryKey().$defaultFn(()=>F()),fromTableId:Y().notNull().references(()=>w.id,{onDelete:"cascade",onUpdate:"cascade"}),toTableId:Y().notNull().references(()=>w.id,{onDelete:"cascade",onUpdate:"cascade"}),fromColumn:Y().notNull(),toColumn:Y().notNull(),label:Y()},($)=>[W("DbRelation_toTableId_idx").on($.toTableId),W("DbRelation_fromTableId_idx").on($.fromTableId)]),p=P("Endpoint",{id:Y().primaryKey().$defaultFn(()=>F()),method:Y().notNull(),path:Y().notNull(),domain:Y(),description:Y(),source:Y().default("MANUAL").notNull(),x:v().default(0).notNull(),y:v().default(0).notNull(),createdAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date),updatedAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date).$onUpdate(()=>new Date)},($)=>[k("Endpoint_method_path_key").on($.method,$.path),W("Endpoint_domain_idx").on($.domain)]),g=P("EndpointTable",{id:Y().primaryKey().$defaultFn(()=>F()),endpointId:Y().notNull().references(()=>p.id,{onDelete:"cascade",onUpdate:"cascade"}),tableId:Y().notNull().references(()=>w.id,{onDelete:"cascade",onUpdate:"cascade"}),access:Y().default("read").notNull()},($)=>[k("EndpointTable_endpointId_tableId_key").on($.endpointId,$.tableId),W("EndpointTable_tableId_idx").on($.tableId)]),A=P("DraftTable",{id:Y().primaryKey().$defaultFn(()=>F()),name:Y().notNull(),domain:Y(),description:Y(),x:v().default(0).notNull(),y:v().default(0).notNull(),createdAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date)},($)=>[k("DraftTable_name_key").on($.name)]),i=P("DraftColumn",{id:Y().primaryKey().$defaultFn(()=>F()),tableId:Y().notNull().references(()=>A.id,{onDelete:"cascade",onUpdate:"cascade"}),name:Y().notNull(),type:Y().notNull(),isPk:j({mode:"boolean"}).default(!1).notNull(),isFk:j({mode:"boolean"}).default(!1).notNull(),nullable:j({mode:"boolean"}).default(!0).notNull(),note:Y(),ord:j().default(0).notNull()},($)=>[W("DraftColumn_tableId_idx").on($.tableId)]),f=P("DraftRelation",{id:Y().primaryKey().$defaultFn(()=>F()),fromTableId:Y().notNull().references(()=>A.id,{onDelete:"cascade",onUpdate:"cascade"}),toTableId:Y().notNull().references(()=>A.id,{onDelete:"cascade",onUpdate:"cascade"}),fromColumn:Y().notNull(),toColumn:Y().notNull(),label:Y()},($)=>[W("DraftRelation_toTableId_idx").on($.toTableId),W("DraftRelation_fromTableId_idx").on($.fromTableId)]),L=P("CodeFile",{path:Y().primaryKey(),root:Y(),lang:Y(),x:v().default(0).notNull(),y:v().default(0).notNull(),mtimeMs:v(),size:j(),inDegree:j().default(0).notNull(),outDegree:j().default(0).notNull(),updatedAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date).$onUpdate(()=>new Date)}),u=P("CodeFileEdge",{fromPath:Y().notNull().references(()=>L.path,{onDelete:"cascade",onUpdate:"cascade"}),toPath:Y().notNull().references(()=>L.path,{onDelete:"cascade",onUpdate:"cascade"}),circular:j({mode:"boolean"}).default(!1).notNull()},($)=>[W("CodeFileEdge_circular_idx").on($.circular),W("CodeFileEdge_toPath_idx").on($.toPath),W("CodeFileEdge_fromPath_idx").on($.fromPath),F9({columns:[$.fromPath,$.toPath],name:"CodeFileEdge_fromPath_toPath_pk"})]),A9=P("SyncState",{id:Y().primaryKey().default("singleton"),version:j().default(0).notNull(),codeGraphSyncedAt:j({mode:"timestamp_ms"}),updatedAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date).$onUpdate(()=>new Date)}),R9=P("AppSetting",{id:Y().primaryKey().default("singleton"),intelModel:Y().default("claude-haiku-4-5").notNull(),intelProvider:Y().default("auto").notNull(),editor:Y().default("auto").notNull(),currentFeatureId:Y(),updatedAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date).$onUpdate(()=>new Date)}),E9=P("ProjectMeta",{id:Y().primaryKey().default("singleton"),overview:Y(),conventions:Y().default("[]").notNull(),updatedAt:j({mode:"timestamp_ms"}).notNull().$defaultFn(()=>new Date).$onUpdate(()=>new Date)});var S0={};e(S0,{tagRelations:()=>L9,nodeTagsRelations:()=>k9,nodeRelations:()=>_9,nodeFileRelations:()=>I9,endpointTableRelations:()=>g9,endpointRelations:()=>x9,edgeRelations:()=>T9,draftTableRelations:()=>f9,draftRelationRelations:()=>z9,draftColumnRelations:()=>u9,dbTableRelations:()=>S9,dbRelationRelations:()=>y9,dbColumnRelations:()=>h9,codeFileRelations:()=>b9,codeFileEdgeRelations:()=>m9});import{relations as q}from"drizzle-orm";var _9=q(U,({one:$,many:Q})=>({files:Q(a),nodeTags:Q(y),edgesOut:Q(S,{relationName:"EdgeFrom"}),edgesIn:Q(S,{relationName:"EdgeTo"}),parent:$(U,{fields:[U.parentId],references:[U.id],relationName:"NodeTree"}),children:Q(U,{relationName:"NodeTree"})})),I9=q(a,({one:$})=>({node:$(U,{fields:[a.nodeId],references:[U.id]})})),L9=q(m,({many:$})=>({nodeTags:$(y)})),k9=q(y,({one:$})=>({node:$(U,{fields:[y.a],references:[U.id]}),tag:$(m,{fields:[y.b],references:[m.id]})})),T9=q(S,({one:$})=>({from:$(U,{fields:[S.fromId],references:[U.id],relationName:"EdgeFrom"}),to:$(U,{fields:[S.toId],references:[U.id],relationName:"EdgeTo"})})),S9=q(w,({many:$})=>({columns:$(r),fksOut:$(x,{relationName:"FkFrom"}),fksIn:$(x,{relationName:"FkTo"}),usages:$(g)})),h9=q(r,({one:$})=>({table:$(w,{fields:[r.tableId],references:[w.id]})})),y9=q(x,({one:$})=>({fromTable:$(w,{fields:[x.fromTableId],references:[w.id],relationName:"FkFrom"}),toTable:$(w,{fields:[x.toTableId],references:[w.id],relationName:"FkTo"})})),x9=q(p,({many:$})=>({tables:$(g)})),g9=q(g,({one:$})=>({endpoint:$(p,{fields:[g.endpointId],references:[p.id]}),table:$(w,{fields:[g.tableId],references:[w.id]})})),f9=q(A,({many:$})=>({columns:$(i),fksOut:$(f,{relationName:"DraftFkFrom"}),fksIn:$(f,{relationName:"DraftFkTo"})})),u9=q(i,({one:$})=>({table:$(A,{fields:[i.tableId],references:[A.id]})})),z9=q(f,({one:$})=>({fromTable:$(A,{fields:[f.fromTableId],references:[A.id],relationName:"DraftFkFrom"}),toTable:$(A,{fields:[f.toTableId],references:[A.id],relationName:"DraftFkTo"})})),b9=q(L,({many:$})=>({edgesOut:$(u,{relationName:"CFEFrom"}),edgesIn:$(u,{relationName:"CFETo"})})),m9=q(u,({one:$})=>({fromFile:$(L,{fields:[u.fromPath],references:[L.path],relationName:"CFEFrom"}),toFile:$(L,{fields:[u.toPath],references:[L.path],relationName:"CFETo"})}));var l9={...T0,...S0},s9=process.env.DATABASE_URL??"file:./dev.db";function U5($){let Q=c9({url:$});return Q.execute("PRAGMA foreign_keys = ON;"),p9(Q,{schema:l9})}var y0=globalThis,h0=y0.dzDefault??U5(s9);y0.dzDefault=h0;var W5=y0.dzByUrl??=new Map;function d9($){let Q=W5.get($);if(!Q)Q=U5($),W5.set($,Q);return Q}function o9(){if(process.env.BEACON_REPO)return h0;let $=L0()??n();if(!$)return h0;return d9(R0($))}var n9=new Proxy({},{get($,Q){let Z=o9(),X=Z[Q];return typeof X==="function"?X.bind(Z):X}});import{forceCenter as l$,forceCollide as s$,forceLink as d$,forceManyBody as o$,forceSimulation as n$}from"d3-force";var P5=R.object({title:R.string().trim().min(1),role:R.string().nullish(),plain:R.string().nullish(),cluster:R.string().nullish(),category:R.string().nullish(),domain:R.string().nullish(),priority:R.number().nullish(),dependsOn:R.array(R.string()).nullish()}).transform(({category:$,domain:Q,priority:Z,...X})=>({...X,cluster:X.cluster??$??Q??null,priority:Z==null?null:Math.max(0,Math.min(3,Math.round(Z)))})),YQ=R.object({features:R.array(P5).default([])});var a9=/(\bmigrations?\b|\balembic\b|make revision|prisma migrate|unique\s?constraint|foreign\s?keys?|primary\s?keys?|\bFKs?\b|\bJSONB\b|create\s+table|alter\s+table|add\s+(a\s+)?column|new\s+(table|model|column)|app\/models\/|\bBaseModel\b|DeclarativeBase|schema\.prisma|@@unique|natural\s+keys?|\bpgvector\b|\bTSVECTOR\b|\bDbTable\b)/i;function C5($){return!!$&&a9.test($)}function r9($){return $.cluster??$.category??$.domain??null}function O5($){let Q=$.map((Z)=>{let X=[],V=r9(Z);if(!V||!V.trim())X.push("category");if(Z.priority==null)X.push("priority");return X.length?`  \u2022 "${Z.title?.trim()||"(untitled)"}" \u2014 missing ${X.join(" + ")}`:null}).filter((Z)=>Z!==null);if(Q.length===0)return null;return"\u26D4 Every roadmap feature needs a category AND a priority \u2014 they drive grouping and ordering "+`on the board, and the user shouldn't have to add them by hand. Missing:
+`+Q.join(`
+`)+"\n\nRe-present with each feature carrying its category as `category` (or `cluster` \u2014 both "+"work; e.g. AUTH, SEARCH, DATA, INTEL, BILLING \u2026) and `priority` (0 = P0 critical, 1 = P1 "+"high, 2 = P2 medium, 3 = P3 low). Set BOTH on EVERY feature; don't rely on defaults."}var x0=1500,WQ=345600000,g0=1800000,w5=3000;function t($){return $.toLowerCase().normalize("NFD").replace(/[\u0300-\u036F]/g,"").replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,50)||"item"}function q5($){return`${t($.title)}-${$.id.slice(-6)}`}function D5($){return{resources:$.map((Q)=>({uri:`beacon://note/${q5(Q)}`,name:Q.title||"Untitled",description:`${Q.title||"Untitled"}${Q.pinned?" \xB7 pinned":""} \xB7 note`,mimeType:"text/markdown"}))}}function F5($,Q){return $.find((Z)=>q5(Z)===Q)}function v5($){let Q=$.body.trim()||"(this note is empty)";return[`# ${$.title||"Untitled"}`,"","_User note from Beacon. To turn it into roadmap work, call `beacon_propose_plan` \u2014"+" checkbox `- [ ]` / `- [x]` items become subtasks, and order the features with `dependsOn`. Do NOT implement until it returns approval._","","---","",Q].join(`
+`)}await i0();var u0=process.env.BEACON_URL||`http://localhost:${process.env.PORT||4319}`,z0=Y5(),B0=V0(z0);try{_0(z0);let $=await k0(B0);if(!$.ok)console.error(`[beacon mcp] db provisioning failed: ${$.error}`)}catch($){console.error(`[beacon mcp] workspace registration failed: ${$ instanceof Error?$.message:$}`)}async function E($,Q){let Z=new Headers(Q?.headers);Z.set("x-beacon-workspace",B0),Z.set(I0,z0);let X=await fetch(`${u0}${$}`,{...Q,headers:Z}),V=await X.text();if(!X.ok)throw Error(`Beacon ${$} -> ${X.status} ${V}`);return V?JSON.parse(V):null}function c($,Q){return E($,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(Q)})}function R5($){let Q=$ instanceof Error?$.message:String($),Z=Q.match(/\{[\s\S]*\}$/);if(Z)try{let X=JSON.parse(Z[0]);if(X?.error)return{content:[{type:"text",text:X.error}],isError:!0}}catch{}return{content:[{type:"text",text:Q}],isError:!0}}var D=new i9({name:"beacon",version:"0.1.0"});D.registerTool("beacon_map",{description:"List existing features on the roadmap. Call before starting work."},async()=>{let $=await E("/api/map");return{content:[{type:"text",text:JSON.stringify($,null,2)}]}});D.registerTool("beacon_start_feature",{description:"Flag that you're working on a feature. If the title matches an existing feature it just marks it IN_PROGRESS (no category needed); if it's NEW it creates the node \u2014 and a new feature REQUIRES a `category`. Call beacon_map first so you reuse an existing feature/category instead of duplicating one.",inputSchema:{title:J.string(),id:J.string().optional().describe("node id from beacon_map (preferred)"),category:J.string().optional().describe("Domain lane for a NEW feature: AUTH | SEARCH | DATA | INTEL | BILLING | INFRA | UI | \u2026 REQUIRED when this creates a new top-level feature; reuse a category already on the board. Ignored when flagging an existing feature or nesting under a `front` (inherits the parent's)."),front:J.string().optional().describe("Title of an EXISTING parent feature to nest this under (draws the parent \u2192 child edge). It must match a real feature \u2014 it is NOT a domain tag (use `category` for the domain). A `front` that matches nothing is REJECTED; create the parent first via beacon_propose_plan."),detail:J.string().optional().describe("One-line plain-language description shown on the canvas card. Replaced later by beacon_describe_feature's markdown when the work is done.")}},async({title:$,id:Q,front:Z,detail:X,category:V})=>{try{let H=await c("/api/map/start",{title:$,id:Q,front:Z,detail:X,category:V});return{content:[{type:"text",text:JSON.stringify(H)}]}}catch(H){return R5(H)}});D.registerTool("beacon_add_subtasks",{description:"Add N sub-tasks under an existing feature in one call. Use when the user says 'add these as subtasks to <feature>' or you want to record follow-ups discovered during work. Parent resolves by `parentId` (preferred \u2014 get it from beacon_map / beacon_entities) or by `parentTitle` (fuzzy-matched against top-level features). Children inherit the parent's view and cluster and land in a row beneath it; bumps the sync version so an open /map canvas refreshes.",inputSchema:{parentId:J.string().optional().describe("node id of the parent feature (preferred)"),parentTitle:J.string().optional().describe("fuzzy title of the parent feature; ignored if parentId is provided"),items:J.array(J.object({title:J.string().describe("short sub-task title"),plain:J.string().optional().describe("one-paragraph description / why / acceptance hint")})).describe("the sub-tasks to add")}},async({parentId:$,parentTitle:Q,items:Z})=>{try{let X=await c("/api/nodes/subtasks",{parentId:$,parentTitle:Q,items:Z});return{content:[{type:"text",text:JSON.stringify(X,null,2)}]}}catch(X){return R5(X)}});D.registerTool("beacon_describe_feature",{description:"Call ONCE at the end of a feature: marks status=DONE, records the files you touched (kept on the FEATURE for context), and replaces the node's description with `description` markdown. Subsumes touch_files + finish_feature. If the feature added or materially changed a REAL architectural component (a subsystem \u2014 never a file), also pass `architecture` to keep the Architecture map accurate.",inputSchema:{description:J.string().describe("Markdown: ### Overview ... ### Files - `path` \u2014 what it does"),files:J.array(J.string()).optional().describe("repo-relative files this feature touches"),id:J.string().optional().describe("node id from beacon_map (preferred over title)"),title:J.string().optional().describe("feature title (fuzzy-matched if no id)"),architecture:J.array(J.object({title:J.string().describe("real component/subsystem name (e.g. 'Plan review loop') \u2014 NEVER a file"),domain:J.string().describe("uppercase lane: PLAN | DATA | UI | MCP | INTEL | \u2026"),role:J.string().optional().describe("one-line technical role"),plain:J.string().optional().describe("one plain-language sentence"),status:J.enum(["KEEP","REBUILD","REPLACE","DROP"]).optional(),files:J.array(J.string()).optional(),depends:J.array(J.string()).optional().describe("titles of components this one depends on")})).optional().describe("Only when the feature adds/changes a REAL architectural component \u2014 upserts curated nodes, never one-per-file")}},async({description:$,files:Q,id:Z,title:X,architecture:V})=>{let H=await c("/api/map/describe",{description:$,files:Q,id:Z,title:X,architecture:V});return{content:[{type:"text",text:JSON.stringify(H)}]}});D.registerTool("beacon_init_persist",{description:"Use ONLY inside the `beacon-init` skill. After YOU (Claude Code) have read the repo and built the architecture analysis, call this once to persist it into Beacon. Replaces any prior init-derived map. Same DB shape as `beacon_propose_plan` for tables/endpoints, but it commits directly (no /plan review step) because the user explicitly invoked init.",inputSchema:{overview:J.string().optional().describe("one-paragraph summary of the project \u2014 written to ProjectMeta + AGENTS.md"),conventions:J.array(J.string()).optional().describe("3-8 concrete conventions/gotchas a contributor must follow"),components:J.array(J.object({title:J.string(),domain:J.string().describe("short UPPERCASE area: AUTH, API, DATA, UI, JOBS, INFRA, \u2026"),role:J.string().optional().describe("one-line technical role"),plain:J.string().optional().describe("one plain-language sentence"),files:J.array(J.string()).optional().describe("repo-relative key files"),depends:J.array(J.string()).optional().describe("titles of other components it depends on")})).describe("8-25 main building blocks, not every file"),roadmap:J.array(J.object({title:J.string(),why:J.string().optional(),category:J.string().optional().describe("category for the board (AUTH | SEARCH | DATA | INTEL | \u2026) \u2014 set it so the item isn't category-less"),priority:J.number().int().min(0).max(3).optional().describe("0=P0 critical .. 3=P3 low")})).optional().describe("3-6 broad strategic directions (NOT detailed tasks); each with a `category` + `priority`. Re-runs DEDUPE roadmap features by title, so re-persisting won't double up existing ones."),snapshot:J.object({tables:J.array(J.object({name:J.string(),domain:J.string().optional(),description:J.string().optional(),columns:J.array(J.object({name:J.string(),type:J.string(),isPk:J.boolean().optional(),isFk:J.boolean().optional(),nullable:J.boolean().optional(),note:J.string().optional()}))})).optional(),relations:J.array(J.object({fromTable:J.string(),fromColumn:J.string(),toTable:J.string(),toColumn:J.string(),label:J.string().optional()})).optional(),endpoints:J.array(J.object({method:J.string(),path:J.string(),domain:J.string().optional(),description:J.string().optional(),uses:J.array(J.object({table:J.string(),access:J.string().optional()})).optional()})).optional()}).optional().describe("optional: also seed /db with the schema you discovered from prisma/SQLAlchemy/etc.")}},async($)=>{let Q=await c("/api/init",$);return{content:[{type:"text",text:JSON.stringify(Q)}]}});D.registerTool("beacon_context_for_feature",{description:"Use BEFORE Glob/Grep/Read when starting work on a feature. Returns a single bundle of everything Beacon knows about it: attached files, what those files import + what imports them (1-hop blast radius from the live code graph), endpoints in the feature's domain + the tables each touches, those tables' FK relations, sibling architecture components, and the project's conventions. Saves an entire discovery-phase round of file reads. Match by id (preferred), exact title, or a natural-language query.",inputSchema:{id:J.string().optional().describe("node id from beacon_map (preferred)"),title:J.string().optional().describe("feature title (case-insensitive contains)"),query:J.string().optional().describe("natural-language phrase \u2014 OR-matched against title + plain description")}},async({id:$,title:Q,query:Z})=>{let X=new URLSearchParams;if($)X.set("id",$);if(Q)X.set("title",Q);if(Z)X.set("query",Z);let V=await E(`/api/context/feature?${X.toString()}`);return{content:[{type:"text",text:JSON.stringify(V,null,2)}]}});D.registerTool("beacon_blast_radius",{description:"For 'if I change this file, what else cares?' \u2014 returns the file's 1-hop imports + importedBy, the TRANSITIVE blast radius both directions (downstream = who depends on it, upstream = what it depends on, grouped by depth), hub/centrality scoring (inDegree/outDegree + isHub), and every feature/component that has the file attached. Use mid-feature when deciding the impact of a change, or before refactoring a hub file.",inputSchema:{path:J.string().describe("repo-relative POSIX file path"),depth:J.number().optional().describe("how far to walk the transitive graph (default 2, capped at 5)")}},async({path:$,depth:Q})=>{let Z=new URLSearchParams({path:$});if(Q!=null)Z.set("depth",String(Q));let X=await E(`/api/context/file?${Z.toString()}`);return{content:[{type:"text",text:JSON.stringify(X,null,2)}]}});D.registerTool("beacon_entities",{description:"Read planning data. `features` = roadmap, `architecture` = components, `tables`/`endpoints` = DB map.",inputSchema:{kind:J.enum(["features","architecture","tables","endpoints"])}},async({kind:$})=>{let Q=await E(`/api/entities?kind=${$}`);return{content:[{type:"text",text:JSON.stringify(Q,null,2)}]}});D.registerTool("beacon_propose_plan",{description:"BLOCKS until the user reviews. Pushes a feature plan (top-level roadmap features + DB tables + endpoints) to Beacon's /plan page. Use when the user asks you to plan a feature. EVERY feature MUST include `cluster` (its category) and `priority` (0=P0 critical .. 3=P3 low) \u2014 the tool REJECTS a plan whose features omit either, so set both on every feature. Do not implement code or migrations until this returns approval. If it returns inline feedback, revise and call again.",inputSchema:{description:J.string().describe("Short summary the user will see in the review header"),features:J.array(J.object({title:J.string(),role:J.string().optional().describe("one-line technical role"),plain:J.string().optional().describe("one plain-language sentence for the user"),category:J.string().optional().describe("REQUIRED category for the board (AUTH | SEARCH | BILLING | DATA | INTEL | \u2026)"),cluster:J.string().optional().describe("alias for `category`"),domain:J.string().optional().describe("alias for `category`"),priority:J.number().int().min(0).max(3).optional().describe("REQUIRED priority: 0=P0 critical, 1=P1 high, 2=P2 medium, 3=P3 low"),dependsOn:J.array(J.string()).optional().describe("titles of other features in THIS plan that must ship first \u2014 drawn as 'depends on' links so the board shows the dependency chain, not loose cards")})).optional().describe("the top-level roadmap features this plan adds"),tables:J.array(J.object({name:J.string(),domain:J.string().optional(),description:J.string().optional(),columns:J.array(J.object({name:J.string(),type:J.string(),isPk:J.boolean().optional(),isFk:J.boolean().optional(),nullable:J.boolean().optional(),note:J.string().optional()}))})).optional(),relations:J.array(J.object({fromTable:J.string(),fromColumn:J.string(),toTable:J.string(),toColumn:J.string(),label:J.string().optional()})).optional(),endpoints:J.array(J.object({method:J.string().describe("GET|POST|PUT|PATCH|DELETE"),path:J.string(),domain:J.string().optional(),description:J.string().optional(),uses:J.array(J.object({table:J.string(),access:J.string().optional()})).optional()})).optional()}},async({description:$,features:Q,tables:Z,relations:X,endpoints:V})=>{let H=(M)=>new Promise((j0)=>setTimeout(j0,M)),B=(M)=>({content:[{type:"text",text:M}]}),N=(Z?.length??0)>0,K=(Q??[]).map((M)=>`${M.title} ${M.role??""} ${M.plain??""}`).join(`
+`),O=(V?.length??0)>0||C5(`${$}
+${K}`);if(!N&&O)return B("\u26D4 This plan touches the database \u2014 it declares endpoints and/or its text describes "+"models/tables/migrations \u2014 but you passed NO `tables`. Beacon's schema board renders "+"ONLY from structured `tables`; prose is never parsed, so the /db tab would be empty and nothing would persist on approve.\n\nRe-call `beacon_propose_plan` with every table in `tables` (each with its `columns`), the `relations` (FKs), and keep the `endpoints` (each with `uses:[{table,access}]`). Mirror EVERY database entity your plan mentions into the structured fields.");if(Q?.length){let M=O5(Q);if(M)return B(M)}let l=(Z?.length??0)+(V?.length??0)>0;await c("/api/plan",{description:$,draft:l?{tables:Z??[],relations:X??[],endpoints:V??[]}:void 0,features:Q?.length?Q:void 0}),await fetch(`${u0}/api/workspace/activate?id=${B0}`).catch(()=>{});let L5=Date.now()+g0;while(Date.now()<L5){await H(x0);let M=await E("/api/plan/verdict").catch(()=>null);if(!M)continue;if(M.kind==="feedback")return B("\uD83D\uDCAC The user left feedback on the plan in Beacon \u2014 text comments and/or edits they "+"made directly on the /map and /db boards. Read everything below, revise the plan accordingly (matching the board changes verbatim), and call `beacon_propose_plan` "+`again with the revised version \u2014 DO NOT implement yet:
+
+`+M.feedback);if(M.kind==="approved"){let j0=M.features?.length?`
+
+\u26A0\uFE0F This plan created these roadmap feature(s):
+`+M.features.map((k5)=>`  \u2022 ${k5}`).join(`
+`)+"\n\nAs you SHIP each one, call `beacon_describe_feature` for it BY ITS EXACT TITLE (with the files you touched + a short summary) so it flips to Done. Do this per "+"feature \u2014 do NOT register only the umbrella, or the rest stay Pending on the map.":"";return B(`\u2705 Plan approved by the user. ${M.summary}`+(M.detail?`
+
+Implement EXACTLY the schema below (migrations + code) \u2014 the user may have `+`edited columns on the canvas:
+
+`+M.detail:"")+j0)}if(M.kind==="discarded")return B(`\u274C The user discarded the plan in Beacon. ${M.summary} Ask what they want to adjust before proposing again.`)}return B("Still waiting for the user to review in Beacon. Your plan is preserved \u2014 call "+"`beacon_propose_plan` again with the SAME plan to resume (the verdict is picked up immediately if they've since decided), or ask whether they've reviewed it.")});D.registerTool("beacon_present_plan",{description:"BLOCKS until the user reviews. Pushes ANY plan (as markdown) to Beacon's /plan page so the user reviews it on the canvas instead of in the terminal \u2014 use this whenever you'd otherwise end a turn asking 'does this look right / should I proceed?'. Embed ONE fenced ```beacon block of JSON ({tables,relations,endpoints,features}) for any DB/roadmap entities so they render as an editable board. Returns the verdict (approved / discarded / feedback). Do NOT implement until it returns approval; on feedback, revise and call again. (For a pure schema+features plan, beacon_propose_plan is the structured alternative.)",inputSchema:{description:J.string().describe("One-line summary shown in the review header"),markdown:J.string().describe("The full plan as markdown. Embed a ```beacon block for tables/endpoints/features.")}},async({description:$,markdown:Q})=>{let Z=(H)=>new Promise((B)=>setTimeout(B,H)),X=(H)=>({content:[{type:"text",text:H}]});await c("/api/plan",{description:$,markdown:Q}),await fetch(`${u0}/api/workspace/activate?id=${B0}`).catch(()=>{});let V=Date.now()+g0;while(Date.now()<V){await Z(x0);let H=await E("/api/plan/verdict").catch(()=>null);if(!H)continue;if(H.kind==="feedback")return X("\uD83D\uDCAC The user left feedback on the plan in Beacon (inline comments and/or edits on the "+"/map and /db boards). Revise the plan accordingly and call `beacon_present_plan` "+`again \u2014 do NOT implement yet:
+
+`+H.feedback);if(H.kind==="approved")return X(`\u2705 Plan approved by the user. ${H.summary??""}`.trim()+(H.detail?`
+
+Implement exactly what's on the board:
+
+${H.detail}`:""));if(H.kind==="discarded")return X(`\u274C The user discarded the plan in Beacon. ${H.summary??""} Ask what they want to adjust before presenting again.`.trim())}return X("Still waiting for the user to review in Beacon. Your plan is preserved \u2014 call "+"`beacon_present_plan` again with the SAME plan to resume, or ask whether they've reviewed it.")});var E5=($)=>Array.isArray($)?$[0]:$;async function G0($){return(await E(`/api/entities?kind=${$}`)).items}function _5($,Q){return{resources:$.map((Z)=>({uri:`${Q}${t(Z.title)}`,name:Z.title,description:`${Z.title}${Z.cluster?` \xB7 ${Z.cluster}`:""} \xB7 ${Z.status}`,mimeType:"text/markdown"}))}}async function I5($,Q,Z){let X=(await G0(Z)).find((N)=>t(N.title)===E5(Q));if(!X)return{contents:[{uri:$.href,mimeType:"text/markdown",text:"(not found)"}]};let H=((await E("/api/entities?kind=tables")).items??[]).map((N)=>N.name),B=[`# ${X.title}`];if(X.cluster)B.push(`*Domain:* \`${X.cluster}\``);if(X.status)B.push(`*Status:* \`${X.status}\``);if(B.push(""),B.push(X.plain?.trim()||"(this node has no description yet \u2014 add one on Beacon's /map page)"),B.push("","## Existing DB tables in this project"),B.push(H.length?H.join(", "):"(none yet)"),Z==="features"){let N=await G0("features"),K=[...new Set(N.map((O)=>O.cluster?.trim()).filter((O)=>!!O))].sort();B.push("","## Existing feature categories \u2014 reuse one before inventing a new one"),B.push(K.length?K.join(", "):"(none yet)"),B.push("","## Beacon feature loop \u2014 follow IN ORDER (do not jump to Glob/Grep/Read)","1. **Load context FIRST.** Call `beacon_context_for_feature({ title })` for this feature BEFORE any Glob/Grep/Read. It returns the attached files, 1-hop import blast radius, the domain's endpoints + tables + FK relations, sibling components, and the project conventions \u2014 and marks this feature active so your edits attach to it. That bundle replaces the discovery phase; Glob is a last resort.","2. **Design data before code.** Identify the tables this feature needs. If ANY are missing from the list above, design the schema and call `beacon_propose_plan` (tables + relations + endpoints, each endpoint with `uses:[{table,access}]`). It BLOCKS until the user approves on /plan \u2014 do NOT write migrations or code until it returns approval.","3. **Register at the end.** When the work is done, call `beacon_describe_feature` with the files you touched + a short markdown summary, so the map and AGENTS.md stay accurate for the next session.")}return{contents:[{uri:$.href,mimeType:"text/markdown",text:B.join(`
+`)}]}}D.registerResource("beacon-feature",new f0("beacon://feature/{slug}",{list:async()=>_5(await G0("features"),"beacon://feature/")}),{title:"Beacon: features",description:"Roadmap features \u2014 picking one imports the node's description plus existing-DB context.",mimeType:"text/markdown"},($,{slug:Q})=>I5($,Q,"features"));D.registerResource("beacon-component",new f0("beacon://component/{slug}",{list:async()=>_5(await G0("architecture"),"beacon://component/")}),{title:"Beacon: architecture",description:"Architecture components \u2014 picking one imports 'what the agent sees'.",mimeType:"text/markdown"},($,{slug:Q})=>I5($,Q,"architecture"));async function A5(){return await E("/api/notes")}D.registerResource("beacon-note",new f0("beacon://note/{slug}",{list:async()=>D5(await A5())}),{title:"Beacon: notes",description:"Your Beacon notes \u2014 picking one imports its markdown verbatim so you can turn it into features.",mimeType:"text/markdown"},async($,{slug:Q})=>{let Z=F5(await A5(),E5(Q)),X=Z?v5(Z):"(not found)";return{contents:[{uri:$.href,mimeType:"text/markdown",text:X}]}});await D.connect(new t9);var H0=-1;setInterval(async()=>{try{let{version:$}=await E("/api/version");if(H0===-1)H0=$;else if($!==H0)H0=$,D.sendResourceListChanged()}catch{}},w5);