trybeacon 0.1.18 → 0.1.19

package/dist/lib/codex-install.js

@@ -1,20 +1,20 @@
 // @bun
-var Tq=Object.defineProperty;var Rq=(q)=>q;function Iq(q,z){this[q]=Rq.bind(null,z)}var Pq=(q,z)=>{for(var J in z)Tq(q,J,{get:z[J],enumerable:!0,configurable:!0,set:Iq.bind(z,J)})};var g=(q,z)=>()=>(q&&(z=q(q=0)),z);var d={};Pq(d,{removeRepoAssets:()=>_q,installRefreshSkill:()=>Aq,installPlanSkill:()=>yq,installInitSkill:()=>Eq,installCodexRepoSkills:()=>Dq,ensureWorkflowDoc:()=>hq,ensureMcp:()=>kq,auditRepo:()=>Lq,REFRESH_SKILL:()=>t,PLAN_SKILL:()=>Uq,INIT_SKILL:()=>a});import{existsSync as H,mkdirSync as K,readFileSync as X,rmSync as b,writeFileSync as x}from"fs";import{join as $}from"path";function Eq(q){let z=$(q,".claude","skills","beacon-init");K(z,{recursive:!0});let J=$(z,"SKILL.md");return x(J,a),J}function Aq(q){let z=$(q,".claude","skills","beacon-refresh");K(z,{recursive:!0});let J=$(z,"SKILL.md");return x(J,t),J}function yq(q){let z=$(q,".claude","skills","beacon-plan");K(z,{recursive:!0});let J=$(z,"SKILL.md");return x(J,Uq),J}function Dq(q){let z=[];for(let J of Oq){let Q=$(q,".agents","skills",J.name);K(Q,{recursive:!0});let V=$(Q,"SKILL.md");x(V,J.body()),z.push(V)}return z}function hq(q){let z=$(q,"AGENTS.md"),J="";try{J=X(z,"utf8")}catch{}let Q=new RegExp(`${f}[\\s\\S]*?${c}`);J=Q.test(J)?J.replace(Q,Wq):`${J.trim()}
+var uq=Object.defineProperty;var Xq=(q)=>q;function Gq(q,z){this[q]=Xq.bind(null,z)}var l=(q,z)=>{for(var J in z)uq(q,J,{get:z[J],enumerable:!0,configurable:!0,set:Gq.bind(z,J)})};var b=(q,z)=>()=>(q&&(z=q(q=0)),z);var d={};l(d,{removeRepoAssets:()=>fq,installRefreshSkill:()=>wq,installPlanSkill:()=>gq,installInitSkill:()=>bq,installCodexRepoSkills:()=>Cq,ensureWorkflowDoc:()=>Nq,ensureMcp:()=>Kq,auditRepo:()=>Mq,REFRESH_SKILL:()=>F,PLAN_SKILL:()=>t,INIT_SKILL:()=>E});import{existsSync as v,mkdirSync as g,readFileSync as W,rmSync as w,writeFileSync as B}from"fs";import{join as $}from"path";function bq(q){let z=$(q,".claude","skills","beacon-init");g(z,{recursive:!0});let J=$(z,"SKILL.md");return B(J,E),J}function wq(q){let z=$(q,".claude","skills","beacon-refresh");g(z,{recursive:!0});let J=$(z,"SKILL.md");return B(J,F),J}function gq(q){let z=$(q,".claude","skills","beacon-plan");g(z,{recursive:!0});let J=$(z,"SKILL.md");return B(J,t),J}function Cq(q){let z=[];for(let J of jq){let Q=$(q,".agents","skills",J.name);g(Q,{recursive:!0});let V=$(Q,"SKILL.md");B(V,J.body()),z.push(V)}return z}function Nq(q){let z=$(q,"AGENTS.md"),J="";try{J=W(z,"utf8")}catch{}let Q=new RegExp(`${j}[\\s\\S]*?${k}`);J=Q.test(J)?J.replace(Q,s):`${J.trim()}
 
-${Wq}
-`.trimStart(),x(z,J.endsWith(`
+${s}
+`.trimStart(),B(z,J.endsWith(`
 `)?J:`${J}
-`);let V=$(q,"CLAUDE.md"),Y="";try{Y=X(V,"utf8")}catch{}if(!/@AGENTS\.md/.test(Y))x(V,`${Y?`${Y.trim()}
+`);let V=$(q,"CLAUDE.md"),Y="";try{Y=W(V,"utf8")}catch{}if(!/@AGENTS\.md/.test(Y))B(V,`${Y?`${Y.trim()}
 
 `:""}@AGENTS.md
-`)}function kq(q){let z=$(q,".mcp.json"),J={};try{J=JSON.parse(X(z,"utf8"))}catch{}if(J.mcpServers=J.mcpServers??{},J.mcpServers.beacon)return{path:z,added:!1};return J.mcpServers.beacon={command:"beacon",args:["mcp"]},x(z,JSON.stringify(J,null,2)+`
-`),{path:z,added:!0}}function Lq(q){let z=$(q,".mcp.json"),J=!1;try{J=!!JSON.parse(X(z,"utf8")).mcpServers?.beacon}catch{}let Q=!1;try{Q=X($(q,"AGENTS.md"),"utf8").includes(f)}catch{}let V=!1;try{V=/@AGENTS\.md/.test(X($(q,"CLAUDE.md"),"utf8"))}catch{}return{repo:q,mcpRegistered:J,agentsMdBlock:Q,claudeMdImport:V,skills:{"beacon-init":H($(q,".claude","skills","beacon-init","SKILL.md")),"beacon-refresh":H($(q,".claude","skills","beacon-refresh","SKILL.md"))},codexSkills:{"beacon-init":H($(q,".agents","skills","beacon-init","SKILL.md")),"beacon-refresh":H($(q,".agents","skills","beacon-refresh","SKILL.md"))}}}function _q(q){let z=[];for(let Z of["beacon-init","beacon-refresh","beacon-db-design"]){let U=$(q,".claude","skills",Z);if(H(U))b(U,{recursive:!0,force:!0}),z.push(Z)}for(let Z of["beacon-init","beacon-refresh"]){let U=$(q,".agents","skills",Z);if(H(U))b(U,{recursive:!0,force:!0}),z.push(`codex:${Z}`)}let J=!1,Q=$(q,".mcp.json");try{let Z=JSON.parse(X(Q,"utf8"));if(Z.mcpServers?.beacon){if(delete Z.mcpServers.beacon,J=!0,Z.mcpServers&&Object.keys(Z.mcpServers).length===0)delete Z.mcpServers;if(Object.keys(Z).length===0)b(Q,{force:!0});else x(Q,JSON.stringify(Z,null,2)+`
-`)}}catch{}let V=!1,Y=$(q,"AGENTS.md");try{let Z=X(Y,"utf8"),U=new RegExp(`\\n?${f}[\\s\\S]*?${c}\\n?`);if(U.test(Z)){let S=Z.replace(U,`
+`)}function Kq(q){let z=$(q,".mcp.json"),J={};try{J=JSON.parse(W(z,"utf8"))}catch{}if(J.mcpServers=J.mcpServers??{},J.mcpServers.beacon)return{path:z,added:!1};return J.mcpServers.beacon={command:"beacon",args:["mcp"]},B(z,JSON.stringify(J,null,2)+`
+`),{path:z,added:!0}}function Mq(q){let z=$(q,".mcp.json"),J=!1;try{J=!!JSON.parse(W(z,"utf8")).mcpServers?.beacon}catch{}let Q=!1;try{Q=W($(q,"AGENTS.md"),"utf8").includes(j)}catch{}let V=!1;try{V=/@AGENTS\.md/.test(W($(q,"CLAUDE.md"),"utf8"))}catch{}return{repo:q,mcpRegistered:J,agentsMdBlock:Q,claudeMdImport:V,skills:{"beacon-init":v($(q,".claude","skills","beacon-init","SKILL.md")),"beacon-refresh":v($(q,".claude","skills","beacon-refresh","SKILL.md"))},codexSkills:{"beacon-init":v($(q,".agents","skills","beacon-init","SKILL.md")),"beacon-refresh":v($(q,".agents","skills","beacon-refresh","SKILL.md"))}}}function fq(q){let z=[];for(let Z of["beacon-init","beacon-refresh","beacon-db-design"]){let P=$(q,".claude","skills",Z);if(v(P))w(P,{recursive:!0,force:!0}),z.push(Z)}for(let Z of["beacon-init","beacon-refresh"]){let P=$(q,".agents","skills",Z);if(v(P))w(P,{recursive:!0,force:!0}),z.push(`codex:${Z}`)}let J=!1,Q=$(q,".mcp.json");try{let Z=JSON.parse(W(Q,"utf8"));if(Z.mcpServers?.beacon){if(delete Z.mcpServers.beacon,J=!0,Z.mcpServers&&Object.keys(Z.mcpServers).length===0)delete Z.mcpServers;if(Object.keys(Z).length===0)w(Q,{force:!0});else B(Q,JSON.stringify(Z,null,2)+`
+`)}}catch{}let V=!1,Y=$(q,"AGENTS.md");try{let Z=W(Y,"utf8"),P=new RegExp(`\\n?${j}[\\s\\S]*?${k}\\n?`);if(P.test(Z)){let D=Z.replace(P,`
 `).replace(/\n{3,}/g,`
 
-`).trimStart();x(Y,S.endsWith(`
-`)?S:`${S}
-`),V=!0}}catch{}let P=!1,W=$(q,"CLAUDE.md");try{let Z=X(W,"utf8"),U=Z.replace(/^[ \t]*@AGENTS\.md[ \t]*\n?/m,"");if(U!==Z){if(!U.trim())b(W,{force:!0});else x(W,U);P=!0}}catch{}return{skillsRemoved:z,mcpUnregistered:J,agentsBlockRemoved:V,claudeImportRemoved:P}}var a=`---
+`).trimStart();B(Y,D.endsWith(`
+`)?D:`${D}
+`),V=!0}}catch{}let U=!1,H=$(q,"CLAUDE.md");try{let Z=W(H,"utf8"),P=Z.replace(/^[ \t]*@AGENTS\.md[ \t]*\n?/m,"");if(P!==Z){if(!P.trim())w(H,{force:!0});else B(H,P);U=!0}}catch{}return{skillsRemoved:z,mcpUnregistered:J,agentsBlockRemoved:V,claudeImportRemoved:U}}var E=`---
 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.
 ---
@@ -51,7 +51,7 @@ A single \`beacon_init_persist\` MCP tool call with:
 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.
-`,t=`---
+`,F=`---
 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.
 ---
@@ -98,7 +98,7 @@ The one caveat: if the user manually edited an INIT-source node on the canvas (e
 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.
-`,Uq=`---
+`,t=`---
 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.
 ---
@@ -140,7 +140,7 @@ If it returns feedback, revise and call it again.
 If \`beacon_present_plan\` isn't available, the panel isn't wired here \u2014 fall back to ExitPlanMode
 with the same \`\`\`beacon block (Claude Code only; Codex has no ExitPlanMode), or tell the user to
 run \`beacon\` in this repo once.
-`,Oq,f="<!-- beacon:workflow:start -->",c="<!-- beacon:workflow:end -->",Wq;var n=g(()=>{Oq=[{name:"beacon-init",body:()=>a},{name:"beacon-refresh",body:()=>t}];Wq=`${f}
+`,jq,j="<!-- beacon:workflow:start -->",k="<!-- beacon:workflow:end -->",s;var c=b(()=>{jq=[{name:"beacon-init",body:()=>E},{name:"beacon-refresh",body:()=>F}];s=`${j}
 ## 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:
@@ -194,18 +194,18 @@ Register them all in that single batched call. If a plan added five features, th
 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).
-${c}`});import{existsSync as xq,mkdirSync as r,readFileSync as M,rmSync as mq,writeFileSync as F}from"fs";import{dirname as Xq,join as C}from"path";function s(q){try{return JSON.parse(M(q,"utf8"))}catch{return{}}}function wq(q,z){r(Xq(q),{recursive:!0}),F(q,JSON.stringify(z,null,2)+`
-`)}function T(q,z){let J=s(q);J.hooks=J.hooks??{},J.hooks[z.event]=J.hooks[z.event]??[];let Q=J.hooks[z.event];if(Q.some((Y)=>Y.matcher===z.matcher&&Y.hooks?.some((P)=>P.command===z.command)))return!1;return Q.push({matcher:z.matcher,hooks:[{type:"command",command:z.command}]}),wq(q,J),!0}function R(q,z){return(s(q).hooks?.[z.event]??[]).some((V)=>V.hooks?.some((Y)=>Y.command===z.command))}function I(q,z){let J=s(q),Q=J.hooks?.[z.event];if(!Q)return!1;let V=!1,Y=Q.map((P)=>{let W=P.hooks?.length??0,Z=(P.hooks??[]).filter((U)=>U.command!==z.command);if(Z.length!==W)V=!0;return{...P,hooks:Z}}).filter((P)=>(P.hooks??[]).length>0);if(!V)return!1;if(Y.length)J.hooks[z.event]=Y;else delete J.hooks[z.event];if(J.hooks&&Object.keys(J.hooks).length===0)delete J.hooks;return wq(q,J),!0}function E(q,z,J,Q){let V=`${z}
+${k}`});import{existsSync as n,mkdirSync as O,readFileSync as N,rmSync as Tq,writeFileSync as K}from"fs";import{dirname as r,join as C}from"path";function L(q){try{return JSON.parse(N(q,"utf8"))}catch{return{}}}function o(q,z){O(r(q),{recursive:!0}),K(q,JSON.stringify(z,null,2)+`
+`)}function e(q,z){let J=L(q);J.hooks=J.hooks??{},J.hooks[z.event]=J.hooks[z.event]??[];let Q=J.hooks[z.event];if(Q.some((Y)=>Y.matcher===z.matcher&&Y.hooks?.some((U)=>U.command===z.command)))return!1;return Q.push({matcher:z.matcher,hooks:[{type:"command",command:z.command}]}),o(q,J),!0}function qq(q,z){return(L(q).hooks?.[z.event]??[]).some((V)=>V.hooks?.some((Y)=>Y.command===z.command))}function zq(q,z){let J=L(q),Q=J.hooks?.[z.event];if(!Q)return!1;let V=!1,Y=Q.map((U)=>{let H=U.hooks?.length??0,Z=(U.hooks??[]).filter((P)=>P.command!==z.command);if(Z.length!==H)V=!0;return{...U,hooks:Z}}).filter((U)=>(U.hooks??[]).length>0);if(!V)return!1;if(Y.length)J.hooks[z.event]=Y;else delete J.hooks[z.event];if(J.hooks&&Object.keys(J.hooks).length===0)delete J.hooks;return o(q,J),!0}function Jq(q,z,J,Q){let V=`${z}
 ${Q.trim()}
-${J}`,Y="";try{Y=M(q,"utf8")}catch{}let P=new RegExp(`${z}[\\s\\S]*?${J}`);Y=P.test(Y)?Y.replace(P,V):Y.trim()?`${Y.trim()}
+${J}`,Y="";try{Y=N(q,"utf8")}catch{}let U=new RegExp(`${z}[\\s\\S]*?${J}`);Y=U.test(Y)?Y.replace(U,V):Y.trim()?`${Y.trim()}
 
 ${V}
 `:`${V}
-`,r(Xq(q),{recursive:!0}),F(q,Y.endsWith(`
+`,O(r(q),{recursive:!0}),K(q,Y.endsWith(`
 `)?Y:`${Y}
-`)}function j(q,z){try{return M(q,"utf8").includes(z)}catch{return!1}}function A(q,z,J){let Q="";try{Q=M(q,"utf8")}catch{return!1}let V=new RegExp(`${z}[\\s\\S]*?${J}\\n?`);if(!V.test(Q))return!1;let Y=Q.replace(V,"").replace(/\n{3,}/g,`
+`)}function y(q,z){try{return N(q,"utf8").includes(z)}catch{return!1}}function Qq(q,z,J){let Q="";try{Q=N(q,"utf8")}catch{return!1}let V=new RegExp(`${z}[\\s\\S]*?${J}\\n?`);if(!V.test(Q))return!1;let Y=Q.replace(V,"").replace(/\n{3,}/g,`
 
-`).trimStart();return F(q,Y),!0}function y(q,z,J){let Q=C(q,z);r(Q,{recursive:!0});let V=C(Q,"SKILL.md");return F(V,J),V}function B(q,z){return xq(C(q,z,"SKILL.md"))}function O(q,z){let J=C(q,z);if(!xq(J))return!1;return mq(J,{recursive:!0,force:!0}),!0}var l=()=>{};import{mkdirSync as pq,renameSync as Sq,rmSync as aq,writeFileSync as tq}from"fs";import{dirname as cq}from"path";function i(q,z){pq(cq(q),{recursive:!0});let J=`${q}.tmp`;try{tq(J,z),Sq(J,q)}catch(Q){throw aq(J,{force:!0}),Q}}var Hq=()=>{};import{existsSync as dq}from"fs";import{homedir as nq}from"os";import{join as D}from"path";function rq(){return process.env.HOME||process.env.USERPROFILE||nq()}function sq(q,z){return y(o(),q,z)}function Bq(q){return B(o(),q)}function lq(q){return O(o(),q)}function iq(q){return T(e(),q)}function oq(q){return R(e(),q)}function eq(q){return I(e(),q)}function qz(q){E(qq(),zq,jq,q)}function uq(){return j(qq(),zq)}function zz(){return A(qq(),zq,jq)}function bz(){let q={};for(let J of w)q[J]=Bq(J);let z={};for(let J of Jq)z[J.event]=oq({event:J.event,command:J.command});return{homeExists:dq(h()),skills:q,hooks:z,claudeMdBlock:uq()}}async function Jz(){let{INIT_SKILL:q,REFRESH_SKILL:z,PLAN_SKILL:J}=await Promise.resolve().then(() => (n(),d)),Q={"beacon-init":q,"beacon-refresh":z,"beacon-plan":J},V=[];for(let W of w){if(!Bq(W))V.push(W);sq(W,Q[W])}let Y=0;for(let W of Jq)if(iq({event:W.event,matcher:W.matcher,command:W.command}))Y++;let P=uq();return qz(Qq),{skillsAdded:V,hooksAdded:Y,claudeMdBlockTouched:!P}}async function Kz(){let q;try{q={ok:!0,...await Jz()}}catch(z){q={ok:!1,error:z instanceof Error?z.message:String(z),skillsAdded:[],hooksAdded:0,claudeMdBlockTouched:!1}}try{let z=await Promise.resolve().then(() => (gq(),vq));if(z.codexDetected())q.codex={ok:!0,...await z.setupCodexAssets()}}catch(z){q.codex={ok:!1,error:z instanceof Error?z.message:String(z),skillsAdded:[],hooksAdded:0,agentsMdBlockTouched:!1,mcp:{added:!1}}}return q}function fz(){let q=[];for(let Q of w)if(lq(Q))q.push(Q);let z=0;for(let Q of Jq)if(eq(Q))z++;let J=zz();return{skillsRemoved:q,hooksRemoved:z,claudeMdBlockRemoved:J}}var h=()=>D(rq(),".claude"),o=()=>D(h(),"skills"),e=()=>D(h(),"settings.json"),qq=()=>D(h(),"CLAUDE.md"),zq="<!-- beacon:global:start -->",jq="<!-- beacon:global:end -->",w,Jq,Qq=`## Beacon (visual planning panel)
+`).trimStart();return K(q,Y),!0}function Vq(q,z,J){let Q=C(q,z);O(Q,{recursive:!0});let V=C(Q,"SKILL.md");return K(V,J),V}function h(q,z){return n(C(q,z,"SKILL.md"))}function Yq(q,z){let J=C(q,z);if(!n(J))return!1;return Tq(J,{recursive:!0,force:!0}),!0}var M,i=`## 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,
@@ -226,17 +226,17 @@ the user reviews on a canvas at /plan, and feedback flows back as the next round
 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.`;var Nq=g(()=>{l();w=["beacon-init","beacon-refresh","beacon-plan"],Jq=[{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."}]});var vq={};Pq(vq,{setupCodexAssets:()=>Zz,removeCodexMcp:()=>Fq,removeCodexArtifacts:()=>Pz,hasCodexMcp:()=>$q,ensureCodexMcp:()=>Mq,codexMcpProblem:()=>Yz,codexDetected:()=>Kq,auditCodex:()=>$z,CODEX_HOOKS:()=>p});import{readFileSync as m}from"fs";import{homedir as Qz}from"os";import{join as G}from"path";function Gq(){return process.env.HOME||process.env.USERPROFILE||Qz()}function Kq(){if(process.env.BEACON_CODEX==="1")return!0;if(process.env.BEACON_CODEX==="0")return!1;if(Vq===void 0)Vq=Bun.which("codex")!==null;return Vq}function N(q){try{return Bun.TOML.parse(q)}catch{return null}}function $q(){try{return Boolean(N(m(v(),"utf8"))?.mcp_servers?.beacon)}catch{return!1}}function Yz(){let q="";try{q=m(v(),"utf8")}catch{return null}let z=N(q);if(!z)return`~/.codex/config.toml does not parse \u2014 ${u}`;if(z.mcp_servers?.beacon)return null;if(/^\s*mcp_servers\s*=/m.test(q))return`mcp_servers is an inline table \u2014 ${u}`;return null}function Mq(){let q="",z=!1;try{q=m(v(),"utf8"),z=!0}catch{}if(z){let Y=N(q);if(!Y)return{added:!1,error:`~/.codex/config.toml does not parse \u2014 ${u}`};if(Y.mcp_servers?.beacon)return{added:!1};if(/^\s*mcp_servers\s*=/m.test(q))return{added:!1,error:`mcp_servers is an inline table \u2014 ${u}`}}let J=!q?"":q.endsWith(`
+verbatim. Do NOT implement until the tool returns approval.`;var Zq=b(()=>{M=["beacon-init","beacon-refresh","beacon-plan"]});import{mkdirSync as Iq,renameSync as Rq,rmSync as Aq,writeFileSync as Dq}from"fs";import{dirname as Eq}from"path";function _(q,z){Iq(Eq(q),{recursive:!0});let J=`${q}.tmp`;try{Dq(J,z),Rq(J,q)}catch(Q){throw Aq(J,{force:!0}),Q}}var $q=()=>{};var _q={};l(_q,{setupCodexAssets:()=>Lq,removeCodexMcp:()=>xq,removeCodexArtifacts:()=>hq,hasCodexMcp:()=>a,ensureCodexMcp:()=>vq,codexMcpProblem:()=>Oq,codexDetected:()=>Bq,auditCodex:()=>yq,CODEX_HOOKS:()=>A});import{readFileSync as R}from"fs";import{homedir as Fq}from"os";import{join as G}from"path";function Uq(){return process.env.HOME||process.env.USERPROFILE||Fq()}function Bq(){if(process.env.BEACON_CODEX==="1")return!0;if(process.env.BEACON_CODEX==="0")return!1;if(m===void 0)m=Bun.which("codex")!==null;return m}function X(q){try{return Bun.TOML.parse(q)}catch{return null}}function a(){try{return Boolean(X(R(x(),"utf8"))?.mcp_servers?.beacon)}catch{return!1}}function Oq(){let q="";try{q=R(x(),"utf8")}catch{return null}let z=X(q);if(!z)return`~/.codex/config.toml does not parse \u2014 ${u}`;if(z.mcp_servers?.beacon)return null;if(/^\s*mcp_servers\s*=/m.test(q))return`mcp_servers is an inline table \u2014 ${u}`;return null}function vq(){let q="",z=!1;try{q=R(x(),"utf8"),z=!0}catch{}if(z){let Y=X(q);if(!Y)return{added:!1,error:`~/.codex/config.toml does not parse \u2014 ${u}`};if(Y.mcp_servers?.beacon)return{added:!1};if(/^\s*mcp_servers\s*=/m.test(q))return{added:!1,error:`mcp_servers is an inline table \u2014 ${u}`}}let J=!q?"":q.endsWith(`
 `)?`
 `:`
 
-`,Q=q+J+Vz;if(N(Q)?.mcp_servers?.beacon?.command!=="beacon")return{added:!1,error:`could not safely append [mcp_servers.beacon] \u2014 ${u}`};return i(v(),Q),{added:!0}}function Fq(){let q="";try{q=m(v(),"utf8")}catch{return{removed:!1}}let z=q.split(`
-`),J=z.indexOf(fq);if(J===-1)return{removed:!1,skipped:$q()};let Q=z.indexOf(Cq,J);if(Q===-1)return{removed:!1,skipped:!0};z.splice(J,Q-J+1);let V=z.join(`
+`,Q=q+J+kq;if(X(Q)?.mcp_servers?.beacon?.command!=="beacon")return{added:!1,error:`could not safely append [mcp_servers.beacon] \u2014 ${u}`};return _(x(),Q),{added:!0}}function xq(){let q="";try{q=R(x(),"utf8")}catch{return{removed:!1}}let z=q.split(`
+`),J=z.indexOf(Wq);if(J===-1)return{removed:!1,skipped:a()};let Q=z.indexOf(Hq,J);if(Q===-1)return{removed:!1,skipped:!0};z.splice(J,Q-J+1);let V=z.join(`
 `).replace(/\n{3,}/g,`
 
-`).replace(/^\n+/,"");if(N(V)===null)return{removed:!1,skipped:!0};return i(v(),V),{removed:!0}}async function Zz(){let{INIT_SKILL:q,REFRESH_SKILL:z,PLAN_SKILL:J}=await Promise.resolve().then(() => (n(),d)),Q={"beacon-init":q,"beacon-refresh":z,"beacon-plan":J},V=[];for(let Z of w){if(!B(L(),Z))V.push(Z);y(L(),Z,Q[Z])}let Y=0;for(let Z of p)if(T(Zq(),{event:Z.event,matcher:Z.matcher,command:Z.command}))Y++;let P=j(k(),_);E(k(),_,bq,Qq);let W=Mq();return{skillsAdded:V,hooksAdded:Y,agentsMdBlockTouched:!P,mcp:W}}function $z(){let q={};for(let J of w)q[J]=B(L(),J);let z={};for(let J of p)z[J.event]=R(Zq(),{event:J.event,command:J.command});return{detected:Kq(),skills:q,hooks:z,agentsMdBlock:j(k(),_),mcp:$q()}}function Pz(){let q=[];for(let V of w)if(O(L(),V))q.push(V);let z=0;for(let V of p)if(I(Zq(),{event:V.event,command:V.command}))z++;let J=A(k(),_,bq),Q=Fq();return{skillsRemoved:q,hooksRemoved:z,agentsMdBlockRemoved:J,mcpRemoved:Q.removed,mcpSkipped:Q.skipped}}var Yq=()=>G(Gq(),".codex"),Zq=()=>G(Yq(),"hooks.json"),v=()=>G(Yq(),"config.toml"),k=()=>G(Yq(),"AGENTS.md"),L=()=>G(Gq(),".agents","skills"),_="<!-- beacon:global:start -->",bq="<!-- beacon:global:end -->",p,Vq,fq="# beacon:start (managed by Beacon \u2014 `beacon uninstall` removes this block)",Cq="# beacon:end",Vz,u="add it manually: codex mcp add beacon -- beacon mcp";var gq=g(()=>{l();Hq();Nq();p=[{event:"PostToolUse",matcher:"apply_patch",command:"beacon hook",description:"Report file edits to Beacon's active feature so the map stays fresh."},{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, nudge it to present the plan on Beacon's /plan canvas."}];Vz=`${fq}
+`).replace(/^\n+/,"");if(X(V)===null)return{removed:!1,skipped:!0};return _(x(),V),{removed:!0}}async function Lq(){let{INIT_SKILL:q,REFRESH_SKILL:z,PLAN_SKILL:J}=await Promise.resolve().then(() => (c(),d)),Q={"beacon-init":q,"beacon-refresh":z,"beacon-plan":J},V=[];for(let Z of M){if(!h(T(),Z))V.push(Z);Vq(T(),Z,Q[Z])}let Y=0;for(let Z of A)if(e(p(),{event:Z.event,matcher:Z.matcher,command:Z.command}))Y++;let U=y(f(),I);Jq(f(),I,Pq,i);let H=vq();return{skillsAdded:V,hooksAdded:Y,agentsMdBlockTouched:!U,mcp:H}}function yq(){let q={};for(let J of M)q[J]=h(T(),J);let z={};for(let J of A)z[J.event]=qq(p(),{event:J.event,command:J.command});return{detected:Bq(),skills:q,hooks:z,agentsMdBlock:y(f(),I),mcp:a()}}function hq(){let q=[];for(let V of M)if(Yq(T(),V))q.push(V);let z=0;for(let V of A)if(zq(p(),{event:V.event,command:V.command}))z++;let J=Qq(f(),I,Pq),Q=xq();return{skillsRemoved:q,hooksRemoved:z,agentsMdBlockRemoved:J,mcpRemoved:Q.removed,mcpSkipped:Q.skipped}}var S=()=>G(Uq(),".codex"),p=()=>G(S(),"hooks.json"),x=()=>G(S(),"config.toml"),f=()=>G(S(),"AGENTS.md"),T=()=>G(Uq(),".agents","skills"),I="<!-- beacon:global:start -->",Pq="<!-- beacon:global:end -->",A,m,Wq="# beacon:start (managed by Beacon \u2014 `beacon uninstall` removes this block)",Hq="# beacon:end",kq,u="add it manually: codex mcp add beacon -- beacon mcp";var mq=b(()=>{Zq();$q();A=[{event:"PostToolUse",matcher:"apply_patch",command:"beacon hook",description:"Report file edits to Beacon's active feature so the map stays fresh."},{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, nudge it to present the plan on Beacon's /plan canvas."}];kq=`${Wq}
 [mcp_servers.beacon]
 command = "beacon"
 args = ["mcp"]
-${Cq}
-`});gq();export{Zz as setupCodexAssets,Fq as removeCodexMcp,Pz as removeCodexArtifacts,$q as hasCodexMcp,Mq as ensureCodexMcp,Yz as codexMcpProblem,Kq as codexDetected,$z as auditCodex,p as CODEX_HOOKS};
+${Hq}
+`});mq();export{Lq as setupCodexAssets,xq as removeCodexMcp,hq as removeCodexArtifacts,a as hasCodexMcp,vq as ensureCodexMcp,Oq as codexMcpProblem,Bq as codexDetected,yq as auditCodex,A as CODEX_HOOKS};

package/dist/lib/global-install.js

@@ -0,0 +1,242 @@
+// @bun
+var Fq=Object.defineProperty;var Tq=(q)=>q;function Rq(q,z){this[q]=Tq.bind(null,z)}var Pq=(q,z)=>{for(var J in z)Fq(q,J,{get:z[J],enumerable:!0,configurable:!0,set:Rq.bind(z,J)})};var b=(q,z)=>()=>(q&&(z=q(q=0)),z);var n={};Pq(n,{removeRepoAssets:()=>_q,installRefreshSkill:()=>Eq,installPlanSkill:()=>yq,installInitSkill:()=>Iq,installCodexRepoSkills:()=>Dq,ensureWorkflowDoc:()=>Oq,ensureMcp:()=>hq,auditRepo:()=>kq,REFRESH_SKILL:()=>c,PLAN_SKILL:()=>Uq,INIT_SKILL:()=>t});import{existsSync as H,mkdirSync as f,readFileSync as X,rmSync as G,writeFileSync as x}from"fs";import{join as $}from"path";function Iq(q){let z=$(q,".claude","skills","beacon-init");f(z,{recursive:!0});let J=$(z,"SKILL.md");return x(J,t),J}function Eq(q){let z=$(q,".claude","skills","beacon-refresh");f(z,{recursive:!0});let J=$(z,"SKILL.md");return x(J,c),J}function yq(q){let z=$(q,".claude","skills","beacon-plan");f(z,{recursive:!0});let J=$(z,"SKILL.md");return x(J,Uq),J}function Dq(q){let z=[];for(let J of Aq){let Q=$(q,".agents","skills",J.name);f(Q,{recursive:!0});let V=$(Q,"SKILL.md");x(V,J.body()),z.push(V)}return z}function Oq(q){let z=$(q,"AGENTS.md"),J="";try{J=X(z,"utf8")}catch{}let Q=new RegExp(`${C}[\\s\\S]*?${d}`);J=Q.test(J)?J.replace(Q,Wq):`${J.trim()}
+
+${Wq}
+`.trimStart(),x(z,J.endsWith(`
+`)?J:`${J}
+`);let V=$(q,"CLAUDE.md"),Y="";try{Y=X(V,"utf8")}catch{}if(!/@AGENTS\.md/.test(Y))x(V,`${Y?`${Y.trim()}
+
+`:""}@AGENTS.md
+`)}function hq(q){let z=$(q,".mcp.json"),J={};try{J=JSON.parse(X(z,"utf8"))}catch{}if(J.mcpServers=J.mcpServers??{},J.mcpServers.beacon)return{path:z,added:!1};return J.mcpServers.beacon={command:"beacon",args:["mcp"]},x(z,JSON.stringify(J,null,2)+`
+`),{path:z,added:!0}}function kq(q){let z=$(q,".mcp.json"),J=!1;try{J=!!JSON.parse(X(z,"utf8")).mcpServers?.beacon}catch{}let Q=!1;try{Q=X($(q,"AGENTS.md"),"utf8").includes(C)}catch{}let V=!1;try{V=/@AGENTS\.md/.test(X($(q,"CLAUDE.md"),"utf8"))}catch{}return{repo:q,mcpRegistered:J,agentsMdBlock:Q,claudeMdImport:V,skills:{"beacon-init":H($(q,".claude","skills","beacon-init","SKILL.md")),"beacon-refresh":H($(q,".claude","skills","beacon-refresh","SKILL.md"))},codexSkills:{"beacon-init":H($(q,".agents","skills","beacon-init","SKILL.md")),"beacon-refresh":H($(q,".agents","skills","beacon-refresh","SKILL.md"))}}}function _q(q){let z=[];for(let Z of["beacon-init","beacon-refresh","beacon-db-design"]){let U=$(q,".claude","skills",Z);if(H(U))G(U,{recursive:!0,force:!0}),z.push(Z)}for(let Z of["beacon-init","beacon-refresh"]){let U=$(q,".agents","skills",Z);if(H(U))G(U,{recursive:!0,force:!0}),z.push(`codex:${Z}`)}let J=!1,Q=$(q,".mcp.json");try{let Z=JSON.parse(X(Q,"utf8"));if(Z.mcpServers?.beacon){if(delete Z.mcpServers.beacon,J=!0,Z.mcpServers&&Object.keys(Z.mcpServers).length===0)delete Z.mcpServers;if(Object.keys(Z).length===0)G(Q,{force:!0});else x(Q,JSON.stringify(Z,null,2)+`
+`)}}catch{}let V=!1,Y=$(q,"AGENTS.md");try{let Z=X(Y,"utf8"),U=new RegExp(`\\n?${C}[\\s\\S]*?${d}\\n?`);if(U.test(Z)){let a=Z.replace(U,`
+`).replace(/\n{3,}/g,`
+
+`).trimStart();x(Y,a.endsWith(`
+`)?a:`${a}
+`),V=!0}}catch{}let P=!1,W=$(q,"CLAUDE.md");try{let Z=X(W,"utf8"),U=Z.replace(/^[ \t]*@AGENTS\.md[ \t]*\n?/m,"");if(U!==Z){if(!U.trim())G(W,{force:!0});else x(W,U);P=!0}}catch{}return{skillsRemoved:z,mcpUnregistered:J,agentsBlockRemoved:V,claudeImportRemoved:P}}var t=`---
+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. If you spot a bug or something worth investigating while reading a component's code, add \`bugs: [{ note }]\` to that component \u2014 it renders as a bug flag on the node (attributed to the agent). Only flag what you actually saw in the code; don't speculate.
+- **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.
+`,c=`---
+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\`. Bug flags already on a component survive the refresh (they're carried over by title); add \`bugs: [{ note }]\` for anything NEW you found worth investigating \u2014 identical open flags are not duplicated.
+
+## 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.
+`,Uq=`---
+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 ExitPlanMode
+with the same \`\`\`beacon block (Claude Code only; Codex has no ExitPlanMode), or tell the user to
+run \`beacon\` in this repo once.
+`,Aq,C="<!-- beacon:workflow:start -->",d="<!-- beacon:workflow:end -->",Wq;var r=b(()=>{Aq=[{name:"beacon-init",body:()=>t},{name:"beacon-refresh",body:()=>c}];Wq=`${C}
+## 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)
+
+In Codex (which has no ExitPlanMode), always present plans via \`beacon_present_plan\` / \`beacon_propose_plan\` instead \u2014 this section applies to Claude Code's plan mode only.
+
+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 \u2014 in ONE call
+
+Call \`beacon_describe_feature\` **ONCE** with a \`features\` array \u2014 one entry per feature the plan created \u2014 each with the files you touched and a short markdown description. This flips each one to **Done** \u2014 including its sub-tasks (the cascade completes every PENDING/IN_PROGRESS child; a sub-task you did NOT finish must be set BLOCKED or CANCELLED before registering, so it survives visibly) \u2014 and keeps \`beacon_context_for_feature\` accurate for the next session.
+
+Key each entry by its node \`id\`: the ids are handed back to you when the plan is approved (in the approval message / additionalContext), so you don't fuzzy-match titles or pay a disambiguation round-trip. If you don't have an id, \`title\` still works.
+
+Register them all in that single batched call. If a plan added five features, that's ONE \`beacon_describe_feature\` call with five entries \u2014 NOT five calls, and NOT just an umbrella ("Harden auth"), which leaves the individual features stuck on **Pending**.
+
+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).
+${d}`});import{existsSync as xq,mkdirSync as s,readFileSync as M,rmSync as Lq,writeFileSync as F}from"fs";import{dirname as Xq,join as K}from"path";function l(q){try{return JSON.parse(M(q,"utf8"))}catch{return{}}}function wq(q,z){s(Xq(q),{recursive:!0}),F(q,JSON.stringify(z,null,2)+`
+`)}function R(q,z){let J=l(q);J.hooks=J.hooks??{},J.hooks[z.event]=J.hooks[z.event]??[];let Q=J.hooks[z.event];if(Q.some((Y)=>Y.matcher===z.matcher&&Y.hooks?.some((P)=>P.command===z.command)))return!1;return Q.push({matcher:z.matcher,hooks:[{type:"command",command:z.command}]}),wq(q,J),!0}function I(q,z){return(l(q).hooks?.[z.event]??[]).some((V)=>V.hooks?.some((Y)=>Y.command===z.command))}function E(q,z){let J=l(q),Q=J.hooks?.[z.event];if(!Q)return!1;let V=!1,Y=Q.map((P)=>{let W=P.hooks?.length??0,Z=(P.hooks??[]).filter((U)=>U.command!==z.command);if(Z.length!==W)V=!0;return{...P,hooks:Z}}).filter((P)=>(P.hooks??[]).length>0);if(!V)return!1;if(Y.length)J.hooks[z.event]=Y;else delete J.hooks[z.event];if(J.hooks&&Object.keys(J.hooks).length===0)delete J.hooks;return wq(q,J),!0}function y(q,z,J,Q){let V=`${z}
+${Q.trim()}
+${J}`,Y="";try{Y=M(q,"utf8")}catch{}let P=new RegExp(`${z}[\\s\\S]*?${J}`);Y=P.test(Y)?Y.replace(P,V):Y.trim()?`${Y.trim()}
+
+${V}
+`:`${V}
+`,s(Xq(q),{recursive:!0}),F(q,Y.endsWith(`
+`)?Y:`${Y}
+`)}function v(q,z){try{return M(q,"utf8").includes(z)}catch{return!1}}function A(q,z,J){let Q="";try{Q=M(q,"utf8")}catch{return!1}let V=new RegExp(`${z}[\\s\\S]*?${J}\\n?`);if(!V.test(Q))return!1;let Y=Q.replace(V,"").replace(/\n{3,}/g,`
+
+`).trimStart();return F(q,Y),!0}function D(q,z,J){let Q=K(q,z);s(Q,{recursive:!0});let V=K(Q,"SKILL.md");return F(V,J),V}function j(q,z){return xq(K(q,z,"SKILL.md"))}function O(q,z){let J=K(q,z);if(!xq(J))return!1;return Lq(J,{recursive:!0,force:!0}),!0}var w,T=`## 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.`;var i=b(()=>{w=["beacon-init","beacon-refresh","beacon-plan"]});import{mkdirSync as mq,renameSync as pq,rmSync as Sq,writeFileSync as aq}from"fs";import{dirname as tq}from"path";function o(q,z){mq(tq(q),{recursive:!0});let J=`${q}.tmp`;try{aq(J,z),pq(J,q)}catch(Q){throw Sq(J,{force:!0}),Q}}var Hq=()=>{};var Gq={};Pq(Gq,{setupCodexAssets:()=>rq,removeCodexMcp:()=>bq,removeCodexArtifacts:()=>lq,hasCodexMcp:()=>Jq,ensureCodexMcp:()=>Nq,codexMcpProblem:()=>nq,codexDetected:()=>jq,auditCodex:()=>sq,CODEX_HOOKS:()=>m});import{readFileSync as L}from"fs";import{homedir as cq}from"os";import{join as N}from"path";function gq(){return process.env.HOME||process.env.USERPROFILE||cq()}function jq(){if(process.env.BEACON_CODEX==="1")return!0;if(process.env.BEACON_CODEX==="0")return!1;if(e===void 0)e=Bun.which("codex")!==null;return e}function u(q){try{return Bun.TOML.parse(q)}catch{return null}}function Jq(){try{return Boolean(u(L(g(),"utf8"))?.mcp_servers?.beacon)}catch{return!1}}function nq(){let q="";try{q=L(g(),"utf8")}catch{return null}let z=u(q);if(!z)return`~/.codex/config.toml does not parse \u2014 ${B}`;if(z.mcp_servers?.beacon)return null;if(/^\s*mcp_servers\s*=/m.test(q))return`mcp_servers is an inline table \u2014 ${B}`;return null}function Nq(){let q="",z=!1;try{q=L(g(),"utf8"),z=!0}catch{}if(z){let Y=u(q);if(!Y)return{added:!1,error:`~/.codex/config.toml does not parse \u2014 ${B}`};if(Y.mcp_servers?.beacon)return{added:!1};if(/^\s*mcp_servers\s*=/m.test(q))return{added:!1,error:`mcp_servers is an inline table \u2014 ${B}`}}let J=!q?"":q.endsWith(`
+`)?`
+`:`
+
+`,Q=q+J+dq;if(u(Q)?.mcp_servers?.beacon?.command!=="beacon")return{added:!1,error:`could not safely append [mcp_servers.beacon] \u2014 ${B}`};return o(g(),Q),{added:!0}}function bq(){let q="";try{q=L(g(),"utf8")}catch{return{removed:!1}}let z=q.split(`
+`),J=z.indexOf(Bq);if(J===-1)return{removed:!1,skipped:Jq()};let Q=z.indexOf(uq,J);if(Q===-1)return{removed:!1,skipped:!0};z.splice(J,Q-J+1);let V=z.join(`
+`).replace(/\n{3,}/g,`
+
+`).replace(/^\n+/,"");if(u(V)===null)return{removed:!1,skipped:!0};return o(g(),V),{removed:!0}}async function rq(){let{INIT_SKILL:q,REFRESH_SKILL:z,PLAN_SKILL:J}=await Promise.resolve().then(() => (r(),n)),Q={"beacon-init":q,"beacon-refresh":z,"beacon-plan":J},V=[];for(let Z of w){if(!j(k(),Z))V.push(Z);D(k(),Z,Q[Z])}let Y=0;for(let Z of m)if(R(zq(),{event:Z.event,matcher:Z.matcher,command:Z.command}))Y++;let P=v(h(),_);y(h(),_,vq,T);let W=Nq();return{skillsAdded:V,hooksAdded:Y,agentsMdBlockTouched:!P,mcp:W}}function sq(){let q={};for(let J of w)q[J]=j(k(),J);let z={};for(let J of m)z[J.event]=I(zq(),{event:J.event,command:J.command});return{detected:jq(),skills:q,hooks:z,agentsMdBlock:v(h(),_),mcp:Jq()}}function lq(){let q=[];for(let V of w)if(O(k(),V))q.push(V);let z=0;for(let V of m)if(E(zq(),{event:V.event,command:V.command}))z++;let J=A(h(),_,vq),Q=bq();return{skillsRemoved:q,hooksRemoved:z,agentsMdBlockRemoved:J,mcpRemoved:Q.removed,mcpSkipped:Q.skipped}}var qq=()=>N(gq(),".codex"),zq=()=>N(qq(),"hooks.json"),g=()=>N(qq(),"config.toml"),h=()=>N(qq(),"AGENTS.md"),k=()=>N(gq(),".agents","skills"),_="<!-- beacon:global:start -->",vq="<!-- beacon:global:end -->",m,e,Bq="# beacon:start (managed by Beacon \u2014 `beacon uninstall` removes this block)",uq="# beacon:end",dq,B="add it manually: codex mcp add beacon -- beacon mcp";var fq=b(()=>{i();Hq();m=[{event:"PostToolUse",matcher:"apply_patch",command:"beacon hook",description:"Report file edits to Beacon's active feature so the map stays fresh."},{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, nudge it to present the plan on Beacon's /plan canvas."}];dq=`${Bq}
+[mcp_servers.beacon]
+command = "beacon"
+args = ["mcp"]
+${uq}
+`});i();import{existsSync as iq}from"fs";import{homedir as oq}from"os";import{join as p}from"path";function eq(){return process.env.HOME||process.env.USERPROFILE||oq()}var S=()=>p(eq(),".claude"),Qq=()=>p(S(),"skills"),Vq=()=>p(S(),"settings.json"),Yq=()=>p(S(),"CLAUDE.md"),Zq="<!-- beacon:global:start -->",Cq="<!-- beacon:global:end -->";var qz=T,$q=[{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."}];function zz(q,z){return D(Qq(),q,z)}function Kq(q){return j(Qq(),q)}function Jz(q){return O(Qq(),q)}function Qz(q){return R(Vq(),q)}function Vz(q){return I(Vq(),q)}function Yz(q){return E(Vq(),q)}function Zz(q){y(Yq(),Zq,Cq,q)}function Mq(){return v(Yq(),Zq)}function $z(){return A(Yq(),Zq,Cq)}function Fz(){let q={};for(let J of w)q[J]=Kq(J);let z={};for(let J of $q)z[J.event]=Vz({event:J.event,command:J.command});return{homeExists:iq(S()),skills:q,hooks:z,claudeMdBlock:Mq()}}async function Pz(){let{INIT_SKILL:q,REFRESH_SKILL:z,PLAN_SKILL:J}=await Promise.resolve().then(() => (r(),n)),Q={"beacon-init":q,"beacon-refresh":z,"beacon-plan":J},V=[];for(let W of w){if(!Kq(W))V.push(W);zz(W,Q[W])}let Y=0;for(let W of $q)if(Qz({event:W.event,matcher:W.matcher,command:W.command}))Y++;let P=Mq();return Zz(qz),{skillsAdded:V,hooksAdded:Y,claudeMdBlockTouched:!P}}async function Tz(){let q;try{q={ok:!0,...await Pz()}}catch(z){q={ok:!1,error:z instanceof Error?z.message:String(z),skillsAdded:[],hooksAdded:0,claudeMdBlockTouched:!1}}try{let z=await Promise.resolve().then(() => (fq(),Gq));if(z.codexDetected())q.codex={ok:!0,...await z.setupCodexAssets()}}catch(z){q.codex={ok:!1,error:z instanceof Error?z.message:String(z),skillsAdded:[],hooksAdded:0,agentsMdBlockTouched:!1,mcp:{added:!1}}}return q}function Rz(){let q=[];for(let Q of w)if(Jz(Q))q.push(Q);let z=0;for(let Q of $q)if(Yz(Q))z++;let J=$z();return{skillsRemoved:q,hooksRemoved:z,claudeMdBlockRemoved:J}}export{Pz as setupGlobalAssets,Tz as selfHealGlobal,Jz as removeGlobalSkill,Yz as removeGlobalHook,$z as removeGlobalClaudeMdBlock,Rz as removeBeaconArtifacts,Kq as isGlobalSkillInstalled,zz as installGlobalSkill,Vz as hasGlobalHook,Mq as hasGlobalClaudeMdBlock,Qz as ensureGlobalHook,Zz as ensureGlobalClaudeMdBlock,Fz as auditGlobal,w as GLOBAL_SKILLS,$q as GLOBAL_HOOKS,qz as GLOBAL_CLAUDE_MD_BLOCK};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trybeacon",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "The visual planning surface for the coding agent in your terminal.",
   "homepage": "https://trybeacon.sh",
   "bin": {