trybeacon 0.1.65 → 0.1.67

package/dist/bin/doctor.js

@@ -1,22 +1,22 @@
 #!/usr/bin/env bun
 // @bun
-var uZ=Object.defineProperty;var RZ=(Q)=>Q;function gZ(Q,Z){this[Q]=RZ.bind(null,Z)}var BQ=(Q,Z)=>{for(var $ in Z)uZ(Q,$,{get:Z[$],enumerable:!0,configurable:!0,set:gZ.bind(Z,$)})};var F=(Q,Z)=>()=>(Q&&(Z=Q(Q=0)),Z);var m0=1500,p0=480000,c0=1800000,k=3600000,l0=3000;var pQ=()=>{};var KQ={};BQ(KQ,{removeRepoAssets:()=>_Z,installRefreshSkill:()=>IZ,installPlanSkill:()=>DZ,installInitSkill:()=>EZ,installCodexRepoSkills:()=>yZ,ensureWorkflowDoc:()=>AZ,ensureMcp:()=>bZ,auditRepo:()=>xQ,REFRESH_SKILL:()=>PQ,PLAN_SKILL:()=>lQ,INIT_SKILL:()=>NQ});import{existsSync as u,mkdirSync as h,readFileSync as K,rmSync as S,writeFileSync as P}from"fs";import{join as U}from"path";function EZ(Q){let Z=U(Q,".claude","skills","beacon-init");h(Z,{recursive:!0});let $=U(Z,"SKILL.md");return P($,NQ),$}function IZ(Q){let Z=U(Q,".claude","skills","beacon-refresh");h(Z,{recursive:!0});let $=U(Z,"SKILL.md");return P($,PQ),$}function DZ(Q){let Z=U(Q,".claude","skills","beacon-plan");h(Z,{recursive:!0});let $=U(Z,"SKILL.md");return P($,lQ),$}function yZ(Q){let Z=[];for(let $ of OZ){let J=U(Q,".agents","skills",$.name);h(J,{recursive:!0});let Y=U(J,"SKILL.md");P(Y,$.body()),Z.push(Y)}return Z}function AZ(Q){let Z=U(Q,"AGENTS.md"),$="";try{$=K(Z,"utf8")}catch{}let J=new RegExp(`${m}[\\s\\S]*?${GQ}`);$=J.test($)?$.replace(J,cQ):`${$.trim()}
+var uZ=Object.defineProperty;var gZ=(Q)=>Q;function EZ(Q,Z){this[Q]=gZ.bind(null,Z)}var BQ=(Q,Z)=>{for(var $ in Z)uZ(Q,$,{get:Z[$],enumerable:!0,configurable:!0,set:EZ.bind(Z,$)})};var F=(Q,Z)=>()=>(Q&&(Z=Q(Q=0)),Z);var n0=1500,s0=480000,t0=1800000,S=3600000,a0=3000;var pQ=()=>{};var KQ={};BQ(KQ,{removeRepoAssets:()=>LZ,installRefreshSkill:()=>IZ,installPlanSkill:()=>OZ,installInitSkill:()=>DZ,installExplainSkill:()=>yZ,installCodexRepoSkills:()=>bZ,ensureWorkflowDoc:()=>_Z,ensureMcp:()=>kZ,auditRepo:()=>xQ,REFRESH_SKILL:()=>GQ,PLAN_SKILL:()=>lQ,INIT_SKILL:()=>NQ,EXPLAIN_SKILL:()=>nQ});import{existsSync as R,mkdirSync as I,readFileSync as K,rmSync as h,writeFileSync as N}from"fs";import{join as X}from"path";function DZ(Q){let Z=X(Q,".claude","skills","beacon-init");I(Z,{recursive:!0});let $=X(Z,"SKILL.md");return N($,NQ),$}function IZ(Q){let Z=X(Q,".claude","skills","beacon-refresh");I(Z,{recursive:!0});let $=X(Z,"SKILL.md");return N($,GQ),$}function OZ(Q){let Z=X(Q,".claude","skills","beacon-plan");I(Z,{recursive:!0});let $=X(Z,"SKILL.md");return N($,lQ),$}function yZ(Q){let Z=X(Q,".claude","skills","beacon-explain");I(Z,{recursive:!0});let $=X(Z,"SKILL.md");return N($,nQ),$}function bZ(Q){let Z=[];for(let $ of AZ){let J=X(Q,".agents","skills",$.name);I(J,{recursive:!0});let Y=X(J,"SKILL.md");N(Y,$.body()),Z.push(Y)}return Z}function _Z(Q){let Z=X(Q,"AGENTS.md"),$="";try{$=K(Z,"utf8")}catch{}let J=new RegExp(`${m}[\\s\\S]*?${PQ}`);$=J.test($)?$.replace(J,cQ):`${$.trim()}
 
 ${cQ}
-`.trimStart(),P(Z,$.endsWith(`
+`.trimStart(),N(Z,$.endsWith(`
 `)?$:`${$}
-`);let Y=U(Q,"CLAUDE.md"),V="";try{V=K(Y,"utf8")}catch{}if(!/@AGENTS\.md/.test(V))P(Y,`${V?`${V.trim()}
+`);let Y=X(Q,"CLAUDE.md"),V="";try{V=K(Y,"utf8")}catch{}if(!/@AGENTS\.md/.test(V))N(Y,`${V?`${V.trim()}
 
 `:""}@AGENTS.md
-`)}function bZ(Q){let Z=U(Q,".mcp.json"),$={};try{$=JSON.parse(K(Z,"utf8"))}catch{}$.mcpServers=$.mcpServers??{};let J=$.mcpServers.beacon;if(J){if(!J.timeout||J.timeout<k)return J.timeout=k,P(Z,JSON.stringify($,null,2)+`
-`),{path:Z,added:!1,updated:!0};return{path:Z,added:!1,updated:!1}}return $.mcpServers.beacon={command:"beacon",args:["mcp"],timeout:k},P(Z,JSON.stringify($,null,2)+`
-`),{path:Z,added:!0,updated:!1}}function xQ(Q){let Z=U(Q,".mcp.json"),$=!1;try{$=!!JSON.parse(K(Z,"utf8")).mcpServers?.beacon}catch{}let J=!1;try{J=K(U(Q,"AGENTS.md"),"utf8").includes(m)}catch{}let Y=!1;try{Y=/@AGENTS\.md/.test(K(U(Q,"CLAUDE.md"),"utf8"))}catch{}return{repo:Q,mcpRegistered:$,agentsMdBlock:J,claudeMdImport:Y,skills:{"beacon-init":u(U(Q,".claude","skills","beacon-init","SKILL.md")),"beacon-refresh":u(U(Q,".claude","skills","beacon-refresh","SKILL.md"))},codexSkills:{"beacon-init":u(U(Q,".agents","skills","beacon-init","SKILL.md")),"beacon-refresh":u(U(Q,".agents","skills","beacon-refresh","SKILL.md"))}}}function _Z(Q){let Z=[];for(let z of["beacon-init","beacon-refresh","beacon-db-design"]){let v=U(Q,".claude","skills",z);if(u(v))S(v,{recursive:!0,force:!0}),Z.push(z)}for(let z of["beacon-init","beacon-refresh"]){let v=U(Q,".agents","skills",z);if(u(v))S(v,{recursive:!0,force:!0}),Z.push(`codex:${z}`)}let $=!1,J=U(Q,".mcp.json");try{let z=JSON.parse(K(J,"utf8"));if(z.mcpServers?.beacon){if(delete z.mcpServers.beacon,$=!0,z.mcpServers&&Object.keys(z.mcpServers).length===0)delete z.mcpServers;if(Object.keys(z).length===0)S(J,{force:!0});else P(J,JSON.stringify(z,null,2)+`
-`)}}catch{}let Y=!1,V=U(Q,"AGENTS.md");try{let z=K(V,"utf8"),v=new RegExp(`\\n?${m}[\\s\\S]*?${GQ}\\n?`);if(v.test(z)){let vQ=z.replace(v,`
+`)}function kZ(Q){let Z=X(Q,".mcp.json"),$={};try{$=JSON.parse(K(Z,"utf8"))}catch{}$.mcpServers=$.mcpServers??{};let J=$.mcpServers.beacon;if(J){if(!J.timeout||J.timeout<S)return J.timeout=S,N(Z,JSON.stringify($,null,2)+`
+`),{path:Z,added:!1,updated:!0};return{path:Z,added:!1,updated:!1}}return $.mcpServers.beacon={command:"beacon",args:["mcp"],timeout:S},N(Z,JSON.stringify($,null,2)+`
+`),{path:Z,added:!0,updated:!1}}function xQ(Q){let Z=X(Q,".mcp.json"),$=!1;try{$=!!JSON.parse(K(Z,"utf8")).mcpServers?.beacon}catch{}let J=!1;try{J=K(X(Q,"AGENTS.md"),"utf8").includes(m)}catch{}let Y=!1;try{Y=/@AGENTS\.md/.test(K(X(Q,"CLAUDE.md"),"utf8"))}catch{}return{repo:Q,mcpRegistered:$,agentsMdBlock:J,claudeMdImport:Y,skills:{"beacon-init":R(X(Q,".claude","skills","beacon-init","SKILL.md")),"beacon-refresh":R(X(Q,".claude","skills","beacon-refresh","SKILL.md"))},codexSkills:{"beacon-init":R(X(Q,".agents","skills","beacon-init","SKILL.md")),"beacon-refresh":R(X(Q,".agents","skills","beacon-refresh","SKILL.md"))}}}function LZ(Q){let Z=[];for(let z of["beacon-init","beacon-refresh","beacon-db-design"]){let U=X(Q,".claude","skills",z);if(R(U))h(U,{recursive:!0,force:!0}),Z.push(z)}for(let z of["beacon-init","beacon-refresh"]){let U=X(Q,".agents","skills",z);if(R(U))h(U,{recursive:!0,force:!0}),Z.push(`codex:${z}`)}let $=!1,J=X(Q,".mcp.json");try{let z=JSON.parse(K(J,"utf8"));if(z.mcpServers?.beacon){if(delete z.mcpServers.beacon,$=!0,z.mcpServers&&Object.keys(z.mcpServers).length===0)delete z.mcpServers;if(Object.keys(z).length===0)h(J,{force:!0});else N(J,JSON.stringify(z,null,2)+`
+`)}}catch{}let Y=!1,V=X(Q,"AGENTS.md");try{let z=K(V,"utf8"),U=new RegExp(`\\n?${m}[\\s\\S]*?${PQ}\\n?`);if(U.test(z)){let vQ=z.replace(U,`
 `).replace(/\n{3,}/g,`
 
-`).trimStart();P(V,vQ.endsWith(`
+`).trimStart();N(V,vQ.endsWith(`
 `)?vQ:`${vQ}
-`),Y=!0}}catch{}let q=!1,X=U(Q,"CLAUDE.md");try{let z=K(X,"utf8"),v=z.replace(/^[ \t]*@AGENTS\.md[ \t]*\n?/m,"");if(v!==z){if(!v.trim())S(X,{force:!0});else P(X,v);q=!0}}catch{}return{skillsRemoved:Z,mcpUnregistered:$,agentsBlockRemoved:Y,claudeImportRemoved:q}}var NQ=`---
+`),Y=!0}}catch{}let q=!1,H=X(Q,"CLAUDE.md");try{let z=K(H,"utf8"),U=z.replace(/^[ \t]*@AGENTS\.md[ \t]*\n?/m,"");if(U!==z){if(!U.trim())h(H,{force:!0});else N(H,U);q=!0}}catch{}return{skillsRemoved:Z,mcpUnregistered:$,agentsBlockRemoved:Y,claudeImportRemoved:q}}var NQ=`---
 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.
 ---
@@ -63,7 +63,7 @@ beacon init-persist /tmp/beacon-init.json   # or: beacon init-persist < /tmp/bea
 That one command wires the repo (writes \`.mcp.json\` + skills so your NEXT session gets the \`beacon_*\` tools natively, heals the global install), starts the Beacon daemon if it isn't running, registers + provisions this workspace, and POSTs your analysis to the same \`/api/init\` endpoint the MCP tool uses \u2014 so init completes in THIS session. Read the counts it prints and report them.
 
 After the tool (or \`beacon init-persist\`) returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
-`,PQ=`---
+`,GQ=`---
 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.
 ---
@@ -158,7 +158,77 @@ 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.
-`,OZ,m="<!-- beacon:workflow:start -->",GQ="<!-- beacon:workflow:end -->",cQ;var p=F(()=>{pQ();OZ=[{name:"beacon-init",body:()=>NQ},{name:"beacon-refresh",body:()=>PQ}];cQ=`${m}
+`,nQ=`---
+name: beacon-explain
+description: Teach the user part of THIS codebase as an interactive visual lesson on Beacon's /learn page \u2014 a concept map + plain-English narrative they can question \u2014 instead of a wall of text. Use when the user says "explain", "teach me", "walk me through", "how does X work", or "help me understand the Y category".
+---
+
+# Explain the codebase visually (/beacon-explain)
+
+When the user wants to UNDERSTAND part of the code (not build something), don't dump prose in the
+terminal and don't open a plan \u2014 plans are for building. Author an interactive **Lesson** and push it
+with the \`beacon_explain\` MCP tool: a curated concept map (boxes + labeled arrows) beside a
+plain-English narrative on Beacon's /learn page. The tool BLOCKS while the user reads, highlights text
+to ask questions, and drops question notes; it returns their questions, you ANSWER and re-push, looping
+until they Save the lesson. There is NO approve/discard \u2014 understanding, not building.
+
+## 1. Load context first \u2014 don't explain blind
+
+Before writing, call \`beacon_context_for_feature\` / \`beacon_map\` and read the relevant files so the
+lesson is accurate. Name real files, functions, tables, and endpoints \u2014 never vague descriptions.
+
+## 2. Write like a great teacher \u2014 the house style (this is the whole point)
+
+Every lesson must read like a patient senior engineer explaining to a sharp newcomer:
+
+- **Plain English, always.** Define any term the first time it appears. No unexplained jargon, no
+  wall of nouns.
+- **Problem-first.** Open each component with the PROBLEM it solves \u2014 a concrete human scenario, the
+  tension that forced the design, then the decision and what it means. (e.g. "When a salesperson
+  confirms an order it must also land in the ERP \u2014 but the ERP can be slow or down, and you do *not*
+  want confirmation to hang. So the sync is *decoupled*: confirming succeeds immediately and the push
+  happens in the background, with retries.")
+- **Concrete step-by-step flow.** Walk the real path as a numbered list. Each step is ONE clear
+  action and names the real identifier in backticks \u2014 file (\`order-placed-sync-erp.ts\`), function
+  (\`syncOrderToErpWorkflow\`), event (\`order.placed\`), column (\`erp_sync_record\`), value
+  (\`requires_human_action\`). Enumerate the cases (success / retryable / rejected / \u2026) with the plain
+  meaning of each.
+- **Anticipate-and-answer "Why X?".** After the flow, add short sections that answer the confusions a
+  reader will actually have ("Why two status columns?", "Why is the ledger append-only?"). ALWAYS
+  explain why the alternative is worse ("claiming success could hide a real failure; claiming hard
+  failure could cause a duplicate order later").
+- **A worked example with real data.** Show the mechanism running on one concrete case \u2014 ideally a
+  small markdown table of state transitions \u2014 and land the insight ("that's 8 rows for one order, and
+  that's the point").
+- **Typographic discipline.** **Bold** the decisions, *italic* the concepts being introduced, and put
+  \`inline code\` around every real identifier \u2014 on /learn, backticked real file paths become clickable
+  to open in the user's editor.
+
+## 3. Map the prose to the board
+
+Every component/flow you NAME in the narrative becomes a \`node\` (title + a one-line \`summary\` for its
+face + a fuller \`detail\` + the real \`files\` it maps to). Every "A does X to B" becomes an \`edge\` with
+a relationship VERB \u2014 one of: imports, calls, persists to, reads from, writes to, routes to, depends
+on, emits, returns, contains, extends \u2014 never a bare line. Keep the resting set small (~4\u20137 nodes);
+push depth into \`detail\`, not the node face. Supply \`steps\` for the guided walkthrough: the first step
+is the overview (empty \`focusIds\`), then teach one node (or a few) per step in order, each with its
+\`focusIds\`.
+
+When the topic involves DATABASE tables, pass them in \`tables\` (they render as annotated schema cards
+on the SAME board, not just raw schemas). For each table give a one-line \`note\` (why it exists), mark
+the key columns \`isPk\`, point FKs at another table with \`fkTo: "<that table's id>"\`, give EVERY column a
+short plain-English \`note\`, and add a \`sample\` row or two (the worked example, made concrete). Connect a
+concept to its table with an \`edge\` (e.g. \`persists to\` / \`reads from\`) whose \`toId\` is the table's id \u2014
+so the learner sees the table IN CONTEXT, wired to the code that uses it.
+
+## 4. Answer in the loop \u2014 don't stop after one round
+
+\`beacon_explain\` returns the user's questions, each tagged \`[q:ID]\`. Answer EACH by calling
+\`beacon_explain\` AGAIN with the SAME lesson plus \`answers: [{ questionId, answer }]\` (keyed by the id).
+Every answer must ADD understanding (rationale, trade-off) \u2014 never just restate the question. Expand
+the narrative or add nodes where it helps. Keep looping until the tool reports the user saved or closed
+the lesson.
+`,AZ,m="<!-- beacon:workflow:start -->",PQ="<!-- beacon:workflow:end -->",cQ;var p=F(()=>{pQ();AZ=[{name:"beacon-init",body:()=>NQ},{name:"beacon-refresh",body:()=>GQ}];cQ=`${m}
 ## 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:
@@ -230,18 +300,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. If you found a bug or something worth investigating in a component's code, add \`bugs: [{ note }]\` to its architecture entry \u2014 it renders as a bug flag on the node (attributed to the agent); identical open flags are not duplicated. Only flag what you actually saw in the code.
 
 Pull raw planning data anytime with \`beacon_entities\` (features / architecture / tables / endpoints).
-${GQ}`});import{existsSync as c,mkdirSync as CQ,readdirSync as LZ,readFileSync as I,rmSync as kZ,writeFileSync as l}from"fs";import{dirname as nQ,join as w}from"path";function sQ(){return!!process.env.CLAUDE_PLUGIN_ROOT}function n(Q=process.env.HOME||process.env.USERPROFILE||""){if(!Q)return null;let Z=w(Q,".claude","plugins");if(!c(Z))return null;let $=[Z];for(let J=0;J<3&&$.length;J++){let Y=[];for(let V of $){let q=w(V,".claude-plugin","plugin.json");try{if(c(q)&&JSON.parse(I(q,"utf8")).name==="beacon")return V}catch{}try{for(let X of LZ(V,{withFileTypes:!0}))if(X.isDirectory())Y.push(w(V,X.name))}catch{}}$=Y}return null}function tQ(Q){return n(Q)!==null}function MQ(Q){try{return JSON.parse(I(Q,"utf8"))}catch{return{}}}function aQ(Q,Z){CQ(nQ(Q),{recursive:!0}),l(Q,JSON.stringify(Z,null,2)+`
-`)}function t(Q,Z){let $=MQ(Q);$.hooks=$.hooks??{},$.hooks[Z.event]=$.hooks[Z.event]??[];let J=$.hooks[Z.event];if(J.some((V)=>V.matcher===Z.matcher&&V.hooks?.some((q)=>q.command===Z.command)))return!1;return J.push({matcher:Z.matcher,hooks:[{type:"command",command:Z.command}]}),aQ(Q,$),!0}function a(Q,Z){return(MQ(Q).hooks?.[Z.event]??[]).some((Y)=>Y.hooks?.some((V)=>V.command===Z.command))}function d(Q,Z){let $=MQ(Q),J=$.hooks?.[Z.event];if(!J)return!1;let Y=!1,V=J.map((q)=>{let X=q.hooks?.length??0,z=(q.hooks??[]).filter((v)=>v.command!==Z.command);if(z.length!==X)Y=!0;return{...q,hooks:z}}).filter((q)=>(q.hooks??[]).length>0);if(!Y)return!1;if(V.length)$.hooks[Z.event]=V;else delete $.hooks[Z.event];if($.hooks&&Object.keys($.hooks).length===0)delete $.hooks;return aQ(Q,$),!0}function r(Q,Z,$,J){let Y=`${Z}
+${PQ}`});import{existsSync as c,mkdirSync as CQ,readdirSync as SZ,readFileSync as u,rmSync as hZ,writeFileSync as l}from"fs";import{dirname as sQ,join as C}from"path";function tQ(){return!!process.env.CLAUDE_PLUGIN_ROOT}function n(Q=process.env.HOME||process.env.USERPROFILE||""){if(!Q)return null;let Z=C(Q,".claude","plugins");if(!c(Z))return null;let $=[Z];for(let J=0;J<3&&$.length;J++){let Y=[];for(let V of $){let q=C(V,".claude-plugin","plugin.json");try{if(c(q)&&JSON.parse(u(q,"utf8")).name==="beacon")return V}catch{}try{for(let H of SZ(V,{withFileTypes:!0}))if(H.isDirectory())Y.push(C(V,H.name))}catch{}}$=Y}return null}function aQ(Q){return n(Q)!==null}function mZ(Q){return/[\\/]\.claude[\\/]plugins[\\/]/.test(Q)}function pZ(Q=process.env.HOME||process.env.USERPROFILE||""){if(!Q)return null;try{let Z=JSON.parse(u(C(Q,".claude","plugins","installed_plugins.json"),"utf8"));for(let $ of Object.keys(Z.plugins??{}))if(/^beacon@/.test($))return{key:$,marketplace:$.split("@")[1]??""}}catch{}return null}function MQ(Q){try{return JSON.parse(u(Q,"utf8"))}catch{return{}}}function dQ(Q,Z){CQ(sQ(Q),{recursive:!0}),l(Q,JSON.stringify(Z,null,2)+`
+`)}function t(Q,Z){let $=MQ(Q);$.hooks=$.hooks??{},$.hooks[Z.event]=$.hooks[Z.event]??[];let J=$.hooks[Z.event];if(J.some((V)=>V.matcher===Z.matcher&&V.hooks?.some((q)=>q.command===Z.command)))return!1;return J.push({matcher:Z.matcher,hooks:[{type:"command",command:Z.command}]}),dQ(Q,$),!0}function a(Q,Z){return(MQ(Q).hooks?.[Z.event]??[]).some((Y)=>Y.hooks?.some((V)=>V.command===Z.command))}function d(Q,Z){let $=MQ(Q),J=$.hooks?.[Z.event];if(!J)return!1;let Y=!1,V=J.map((q)=>{let H=q.hooks?.length??0,z=(q.hooks??[]).filter((U)=>U.command!==Z.command);if(z.length!==H)Y=!0;return{...q,hooks:z}}).filter((q)=>(q.hooks??[]).length>0);if(!Y)return!1;if(V.length)$.hooks[Z.event]=V;else delete $.hooks[Z.event];if($.hooks&&Object.keys($.hooks).length===0)delete $.hooks;return dQ(Q,$),!0}function r(Q,Z,$,J){let Y=`${Z}
 ${J.trim()}
-${$}`,V="";try{V=I(Q,"utf8")}catch{}let q=new RegExp(`${Z}[\\s\\S]*?${$}`);V=q.test(V)?V.replace(q,Y):V.trim()?`${V.trim()}
+${$}`,V="";try{V=u(Q,"utf8")}catch{}let q=new RegExp(`${Z}[\\s\\S]*?${$}`);V=q.test(V)?V.replace(q,Y):V.trim()?`${V.trim()}
 
 ${Y}
 `:`${Y}
-`,CQ(nQ(Q),{recursive:!0}),l(Q,V.endsWith(`
+`,CQ(sQ(Q),{recursive:!0}),l(Q,V.endsWith(`
 `)?V:`${V}
-`)}function D(Q,Z){try{return I(Q,"utf8").includes(Z)}catch{return!1}}function o(Q,Z,$){let J="";try{J=I(Q,"utf8")}catch{return!1}let Y=new RegExp(`${Z}[\\s\\S]*?${$}\\n?`);if(!Y.test(J))return!1;let V=J.replace(Y,"").replace(/\n{3,}/g,`
+`)}function O(Q,Z){try{return u(Q,"utf8").includes(Z)}catch{return!1}}function o(Q,Z,$){let J="";try{J=u(Q,"utf8")}catch{return!1}let Y=new RegExp(`${Z}[\\s\\S]*?${$}\\n?`);if(!Y.test(J))return!1;let V=J.replace(Y,"").replace(/\n{3,}/g,`
 
-`).trimStart();return l(Q,V),!0}function i(Q,Z,$){let J=w(Q,Z);CQ(J,{recursive:!0});let Y=w(J,"SKILL.md");return l(Y,$),Y}function O(Q,Z){return c(w(Q,Z,"SKILL.md"))}function e(Q,Z){let $=w(Q,Z);if(!c($))return!1;return kZ($,{recursive:!0,force:!0}),!0}var B,s=`## Beacon (visual planning panel)
+`).trimStart();return l(Q,V),!0}function i(Q,Z,$){let J=C(Q,Z);CQ(J,{recursive:!0});let Y=C(J,"SKILL.md");return l(Y,$),Y}function y(Q,Z){return c(C(Q,Z,"SKILL.md"))}function e(Q,Z){let $=C(Q,Z);if(!c($))return!1;return hZ($,{recursive:!0,force:!0}),!0}var B,s=`## 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,
@@ -255,6 +325,9 @@ the user reviews on a canvas at /plan, and feedback flows back as the next round
 - 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.
+- User asks to "explain" / "teach me" / "walk me through" / "how does X work" \u2192 if the
+  \`beacon_explain\` MCP tool is available, author an interactive Lesson (a concept map +
+  plain-English narrative on /learn the user questions back) via the \`beacon-explain\` skill.
 - Run \`beacon doctor\` to audit what's wired (global hooks, repo's .mcp.json, AGENTS.md block).
 
 **The plan feedback loop**
@@ -262,19 +335,19 @@ 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 wQ=F(()=>{B=["beacon-init","beacon-refresh","beacon-plan"]});import{mkdirSync as SZ,renameSync as hZ,rmSync as mZ,writeFileSync as pZ}from"fs";import{dirname as cZ}from"path";function QQ(Q,Z){SZ(cZ(Q),{recursive:!0});let $=`${Q}.tmp`;try{pZ($,Z),hZ($,Q)}catch(J){throw mZ($,{force:!0}),J}}function Q1(Q,Z,$=!1){QQ(Q,JSON.stringify(Z,null,$?2:void 0))}var dQ=()=>{};var $Z={};BQ($Z,{setupCodexAssets:()=>sZ,removeCodexMcp:()=>ZZ,removeCodexArtifacts:()=>tZ,hasCodexMcp:()=>uQ,ensureCodexMcp:()=>QZ,codexMcpProblem:()=>RQ,codexDetected:()=>VQ,auditCodex:()=>gQ,CODEX_HOOKS:()=>f});import{readFileSync as YQ}from"fs";import{homedir as lZ}from"os";import{join as b}from"path";function rQ(){return process.env.HOME||process.env.USERPROFILE||lZ()}function VQ(){if(process.env.BEACON_CODEX==="1")return!0;if(process.env.BEACON_CODEX==="0")return!1;if(fQ===void 0)fQ=Bun.which("codex")!==null;return fQ}function A(Q){try{return Bun.TOML.parse(Q)}catch{return null}}function uQ(){try{return Boolean(A(YQ(R(),"utf8"))?.mcp_servers?.beacon)}catch{return!1}}function RQ(){let Q="";try{Q=YQ(R(),"utf8")}catch{return null}let Z=A(Q);if(!Z)return`~/.codex/config.toml does not parse \u2014 ${y}`;if(Z.mcp_servers?.beacon)return null;if(/^\s*mcp_servers\s*=/m.test(Q))return`mcp_servers is an inline table \u2014 ${y}`;return null}function QZ(){let Q="",Z=!1;try{Q=YQ(R(),"utf8"),Z=!0}catch{}if(Z){let V=A(Q);if(!V)return{added:!1,error:`~/.codex/config.toml does not parse \u2014 ${y}`};if(V.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 ${y}`}}let $=!Q?"":Q.endsWith(`
+verbatim. Do NOT implement until the tool returns approval.`;var wQ=F(()=>{B=["beacon-init","beacon-refresh","beacon-plan","beacon-explain"]});import{mkdirSync as cZ,renameSync as lZ,rmSync as nZ,writeFileSync as sZ}from"fs";import{dirname as tZ}from"path";function QQ(Q,Z){cZ(tZ(Q),{recursive:!0});let $=`${Q}.tmp`;try{sZ($,Z),lZ($,Q)}catch(J){throw nZ($,{force:!0}),J}}function Y1(Q,Z,$=!1){QQ(Q,JSON.stringify(Z,null,$?2:void 0))}var rQ=()=>{};var JZ={};BQ(JZ,{setupCodexAssets:()=>rZ,removeCodexMcp:()=>$Z,removeCodexArtifacts:()=>oZ,hasCodexMcp:()=>RQ,ensureCodexMcp:()=>ZZ,codexMcpProblem:()=>uQ,codexDetected:()=>VQ,auditCodex:()=>gQ,CODEX_HOOKS:()=>f});import{readFileSync as YQ}from"fs";import{homedir as aZ}from"os";import{join as _}from"path";function oQ(){return process.env.HOME||process.env.USERPROFILE||aZ()}function VQ(){if(process.env.BEACON_CODEX==="1")return!0;if(process.env.BEACON_CODEX==="0")return!1;if(fQ===void 0)fQ=Bun.which("codex")!==null;return fQ}function b(Q){try{return Bun.TOML.parse(Q)}catch{return null}}function RQ(){try{return Boolean(b(YQ(g(),"utf8"))?.mcp_servers?.beacon)}catch{return!1}}function uQ(){let Q="";try{Q=YQ(g(),"utf8")}catch{return null}let Z=b(Q);if(!Z)return`~/.codex/config.toml does not parse \u2014 ${A}`;if(Z.mcp_servers?.beacon)return null;if(/^\s*mcp_servers\s*=/m.test(Q))return`mcp_servers is an inline table \u2014 ${A}`;return null}function ZZ(){let Q="",Z=!1;try{Q=YQ(g(),"utf8"),Z=!0}catch{}if(Z){let V=b(Q);if(!V)return{added:!1,error:`~/.codex/config.toml does not parse \u2014 ${A}`};if(V.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 ${A}`}}let $=!Q?"":Q.endsWith(`
 `)?`
 `:`
 
-`,J=Q+$+nZ;if(A(J)?.mcp_servers?.beacon?.command!=="beacon")return{added:!1,error:`could not safely append [mcp_servers.beacon] \u2014 ${y}`};return QQ(R(),J),{added:!0}}function ZZ(){let Q="";try{Q=YQ(R(),"utf8")}catch{return{removed:!1}}let Z=Q.split(`
-`),$=Z.indexOf(iQ);if($===-1)return{removed:!1,skipped:uQ()};let J=Z.indexOf(eQ,$);if(J===-1)return{removed:!1,skipped:!0};Z.splice($,J-$+1);let Y=Z.join(`
+`,J=Q+$+dZ;if(b(J)?.mcp_servers?.beacon?.command!=="beacon")return{added:!1,error:`could not safely append [mcp_servers.beacon] \u2014 ${A}`};return QQ(g(),J),{added:!0}}function $Z(){let Q="";try{Q=YQ(g(),"utf8")}catch{return{removed:!1}}let Z=Q.split(`
+`),$=Z.indexOf(eQ);if($===-1)return{removed:!1,skipped:RQ()};let J=Z.indexOf(QZ,$);if(J===-1)return{removed:!1,skipped:!0};Z.splice($,J-$+1);let Y=Z.join(`
 `).replace(/\n{3,}/g,`
 
-`).replace(/^\n+/,"");if(A(Y)===null)return{removed:!1,skipped:!0};return QQ(R(),Y),{removed:!0}}async function sZ(){let{INIT_SKILL:Q,REFRESH_SKILL:Z,PLAN_SKILL:$}=await Promise.resolve().then(() => (p(),KQ)),J={"beacon-init":Q,"beacon-refresh":Z,"beacon-plan":$},Y=[];for(let z of B){if(!O($Q(),z))Y.push(z);i($Q(),z,J[z])}let V=0;for(let z of f)if(t(FQ(),{event:z.event,matcher:z.matcher,command:z.command}))V++;let q=D(ZQ(),JQ);r(ZQ(),JQ,oQ,s);let X=QZ();return{skillsAdded:Y,hooksAdded:V,agentsMdBlockTouched:!q,mcp:X}}function gQ(){let Q={};for(let $ of B)Q[$]=O($Q(),$);let Z={};for(let $ of f)Z[$.event]=a(FQ(),{event:$.event,command:$.command});return{detected:VQ(),skills:Q,hooks:Z,agentsMdBlock:D(ZQ(),JQ),mcp:uQ()}}function tZ(){let Q=[];for(let Y of B)if(e($Q(),Y))Q.push(Y);let Z=0;for(let Y of f)if(d(FQ(),{event:Y.event,command:Y.command}))Z++;let $=o(ZQ(),JQ,oQ),J=ZZ();return{skillsRemoved:Q,hooksRemoved:Z,agentsMdBlockRemoved:$,mcpRemoved:J.removed,mcpSkipped:J.skipped}}var TQ=()=>b(rQ(),".codex"),FQ=()=>b(TQ(),"hooks.json"),R=()=>b(TQ(),"config.toml"),ZQ=()=>b(TQ(),"AGENTS.md"),$Q=()=>b(rQ(),".agents","skills"),JQ="<!-- beacon:global:start -->",oQ="<!-- beacon:global:end -->",f,fQ,iQ="# beacon:start (managed by Beacon \u2014 `beacon uninstall` removes this block)",eQ="# beacon:end",nZ,y="add it manually: codex mcp add beacon -- beacon mcp";var EQ=F(()=>{wQ();dQ();f=[{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."}];nZ=`${iQ}
+`).replace(/^\n+/,"");if(b(Y)===null)return{removed:!1,skipped:!0};return QQ(g(),Y),{removed:!0}}async function rZ(){let{INIT_SKILL:Q,REFRESH_SKILL:Z,PLAN_SKILL:$,EXPLAIN_SKILL:J}=await Promise.resolve().then(() => (p(),KQ)),Y={"beacon-init":Q,"beacon-refresh":Z,"beacon-plan":$,"beacon-explain":J},V=[];for(let U of B){if(!y($Q(),U))V.push(U);i($Q(),U,Y[U])}let q=0;for(let U of f)if(t(FQ(),{event:U.event,matcher:U.matcher,command:U.command}))q++;let H=O(ZQ(),JQ);r(ZQ(),JQ,iQ,s);let z=ZZ();return{skillsAdded:V,hooksAdded:q,agentsMdBlockTouched:!H,mcp:z}}function gQ(){let Q={};for(let $ of B)Q[$]=y($Q(),$);let Z={};for(let $ of f)Z[$.event]=a(FQ(),{event:$.event,command:$.command});return{detected:VQ(),skills:Q,hooks:Z,agentsMdBlock:O(ZQ(),JQ),mcp:RQ()}}function oZ(){let Q=[];for(let Y of B)if(e($Q(),Y))Q.push(Y);let Z=0;for(let Y of f)if(d(FQ(),{event:Y.event,command:Y.command}))Z++;let $=o(ZQ(),JQ,iQ),J=$Z();return{skillsRemoved:Q,hooksRemoved:Z,agentsMdBlockRemoved:$,mcpRemoved:J.removed,mcpSkipped:J.skipped}}var TQ=()=>_(oQ(),".codex"),FQ=()=>_(TQ(),"hooks.json"),g=()=>_(TQ(),"config.toml"),ZQ=()=>_(TQ(),"AGENTS.md"),$Q=()=>_(oQ(),".agents","skills"),JQ="<!-- beacon:global:start -->",iQ="<!-- beacon:global:end -->",f,fQ,eQ="# beacon:start (managed by Beacon \u2014 `beacon uninstall` removes this block)",QZ="# beacon:end",dZ,A="add it manually: codex mcp add beacon -- beacon mcp";var EQ=F(()=>{wQ();rQ();f=[{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."}];dZ=`${eQ}
 [mcp_servers.beacon]
 command = "beacon"
 args = ["mcp"]
-${eQ}
-`});var XZ={};BQ(XZ,{provisionDb:()=>x0});import{createClient as q0}from"@libsql/client";import{drizzle as X0}from"drizzle-orm/libsql";import{migrate as U0}from"drizzle-orm/libsql/migrator";import{readMigrationFiles as W0}from"drizzle-orm/migrator";import{dirname as AQ,join as H0}from"path";import{fileURLToPath as j0}from"url";async function XQ(Q,Z){return(await Q.execute({sql:"SELECT 1 FROM sqlite_master WHERE type='table' AND name = ?",args:[Z]})).rows.length>0}async function P0(Q,Z){let $=await Q.execute(`PRAGMA table_info("${Z}")`);return new Set($.rows.map((J)=>String(J.name)))}async function qZ(Q){if(!await XQ(Q,"__drizzle_migrations"))return 0;let Z=await Q.execute('SELECT count(*) AS n FROM "__drizzle_migrations"');return Number(Z.rows[0]?.n??0)}async function G0(Q){for(let[Z,$]of Object.entries(N0)){if(!await XQ(Q,Z))continue;let J=await P0(Q,Z);for(let Y of $){if(!J.has(Y))continue;await Q.execute(`UPDATE "${Z}" SET "${Y}" = CAST((julianday("${Y}") - 2440587.5) * 86400000 AS INTEGER) WHERE typeof("${Y}") = 'text'`)}}}async function x0(Q,Z=B0){let $=q0({url:Q});try{await $.execute("PRAGMA journal_mode = WAL;"),await $.execute("PRAGMA foreign_keys = ON;"),await $.execute("PRAGMA busy_timeout = 5000;");let J=await XQ($,"__drizzle_migrations"),Y=await XQ($,"Node"),V=!1;if(Y&&!J){let X=W0({migrationsFolder:Z})[0];if(X)await $.execute('CREATE TABLE IF NOT EXISTS "__drizzle_migrations" (id SERIAL PRIMARY KEY, hash text NOT NULL, created_at numeric)'),await $.execute({sql:'INSERT INTO "__drizzle_migrations" ("hash", "created_at") VALUES (?, ?)',args:[X.hash,X.folderMillis]}),V=!0}let q=await qZ($);if(await U0(X0($),{migrationsFolder:Z}),await qZ($)>q)V=!0;return await G0($),{migrated:V}}finally{$.close()}}var v0,B0,N0;var UZ=F(async()=>{v0=AQ(AQ(AQ(j0(import.meta.url)))),B0=process.env.BEACON_MIGRATIONS_DIR||H0(v0,"drizzle"),N0={Node:["createdAt","updatedAt"],Note:["createdAt","updatedAt"],DbTable:["createdAt","updatedAt"],Endpoint:["createdAt","updatedAt"],DraftTable:["createdAt"],SyncState:["codeGraphSyncedAt","updatedAt"],AppSetting:["updatedAt"],ProjectMeta:["updatedAt"],CodeFile:["updatedAt"]}});wQ();import{existsSync as aZ}from"fs";import{homedir as dZ}from"os";import{join as zQ}from"path";function rZ(){return process.env.HOME||process.env.USERPROFILE||dZ()}var qQ=()=>zQ(rZ(),".claude"),IQ=()=>zQ(qQ(),"skills"),DQ=()=>zQ(qQ(),"settings.json"),OQ=()=>zQ(qQ(),"CLAUDE.md"),yQ="<!-- beacon:global:start -->",JZ="<!-- beacon:global:end -->";var oZ=s,g=[{event:"PreToolUse",matcher:"Edit|Write|MultiEdit",command:"beacon guard",description:"Gate edits against the active plan's scope contract (when the scope-guard flag is on): in-scope \u2192 allow, off-scope \u2192 ask the user to authorize. No-op + fail-open otherwise."},{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 iZ(Q,Z){return i(IQ(),Q,Z)}function YZ(Q){return O(IQ(),Q)}function eZ(Q){return e(IQ(),Q)}function Q0(Q){return t(DQ(),Q)}function Z0(Q){return a(DQ(),Q)}function $0(Q){return d(DQ(),Q)}function J0(Q){r(OQ(),yQ,JZ,Q)}function VZ(){return D(OQ(),yQ)}function Y0(){return o(OQ(),yQ,JZ)}function zZ(){let Q={};for(let $ of B)Q[$]=YZ($);let Z={};for(let $ of g)Z[$.event]=Z0({event:$.event,command:$.command});return{homeExists:aZ(qQ()),skills:Q,hooks:Z,claudeMdBlock:VZ()}}async function V0(){let{INIT_SKILL:Q,REFRESH_SKILL:Z,PLAN_SKILL:$}=await Promise.resolve().then(() => (p(),KQ)),J={"beacon-init":Q,"beacon-refresh":Z,"beacon-plan":$},Y=[];for(let X of B){if(!YZ(X))Y.push(X);iZ(X,J[X])}let V=0;for(let X of g)if(Q0({event:X.event,matcher:X.matcher,command:X.command}))V++;let q=VZ();return J0(oZ),{skillsAdded:Y,hooksAdded:V,claudeMdBlockTouched:!q}}async function H1(){if(sQ())return{ok:!0,skipped:"plugin",skillsAdded:[],hooksAdded:0,claudeMdBlockTouched:!1};let Q;if(tQ()){try{z0()}catch{}Q={ok:!0,skipped:"plugin-present",skillsAdded:[],hooksAdded:0,claudeMdBlockTouched:!1}}else try{Q={ok:!0,...await V0()}}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(() => (EQ(),$Z));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 z0(){let Q=[];for(let J of B)if(eZ(J))Q.push(J);let Z=0;for(let J of g)if($0(J))Z++;let $=Y0();return{skillsRemoved:Q,hooksRemoved:Z,claudeMdBlockRemoved:$}}import{AsyncLocalStorage as K0}from"async_hooks";import{spawnSync as C0}from"child_process";import{createHash as M0}from"crypto";import{existsSync as HZ,mkdirSync as _,readFileSync as _Q,writeFileSync as LQ}from"fs";import{homedir as jZ}from"os";import{basename as w0,join as C,parse as f0,resolve as WZ}from"path";function G(){return process.env.BEACON_HOME||C(jZ(),".beacon")}function kQ(){return C(G(),"workspaces.json")}function UQ(Q){return M0("sha256").update(Q).digest("hex").slice(0,12)}function F1(Q=process.cwd()){let Z=C0("git",["rev-parse","--show-toplevel"],{cwd:Q,stdio:["ignore","pipe","ignore"]});if(Z.status===0){let $=Z.stdout?.toString().trim();if($)return $}return Q}function vZ(Q){let Z=WZ(Q);return Z!==WZ(jZ())&&Z!==f0(Z).root}function BZ(){return C(G(),"deleted.json")}function SQ(){try{let Q=JSON.parse(_Q(BZ(),"utf8"));return Array.isArray(Q)?Q:[]}catch{return[]}}function NZ(Q){_(G(),{recursive:!0}),LQ(BZ(),JSON.stringify(Q,null,2))}function PZ(Q){return SQ().includes(Q)}function u1(Q){let Z=SQ();if(!Z.includes(Q))NZ([...Z,Q])}function T0(Q){let Z=SQ();if(Z.includes(Q))NZ(Z.filter(($)=>$!==Q))}function WQ(Q){return C(G(),Q)}function F0(Q){return`file:${C(WQ(Q),"db.sqlite")}`}function L(){try{let Q=JSON.parse(_Q(kQ(),"utf8"));return Array.isArray(Q)?Q:[]}catch{return[]}}function hQ(Q){_(G(),{recursive:!0}),LQ(kQ(),JSON.stringify(Q,null,2))}function HQ(){return L().sort((Q,Z)=>Z.lastOpenedAt.localeCompare(Q.lastOpenedAt))}function T(Q){return L().find((Z)=>Z.id===Q)??null}function GZ(Q,Z,$=new Date().toISOString()){if(!vZ(Q))throw Error(`beacon: refusing to register a non-repo path as a workspace: ${Q}`);let J=UQ(Q);if(PZ(J))throw Error(`beacon: workspace ${J} (${Q}) was deleted \u2014 run \`beacon\` or /beacon-init to re-add it`);let Y=L(),V=Y.find((z)=>z.id===J),q={id:J,path:Q,name:Z||V?.name||w0(Q),lastOpenedAt:$},X=[q,...Y.filter((z)=>z.id!==J)];return _(WQ(J),{recursive:!0}),hQ(X),q}function R1(Q,Z){return T0(UQ(Q)),GZ(Q,Z)}function g1(Q,Z=new Date().toISOString()){let $=L(),J=$.find((Y)=>Y.id===Q);if(!J)return;J.lastOpenedAt=Z,hQ($)}function E1(Q){if(hQ(L().filter((Z)=>Z.id!==Q)),mQ()===Q)u0(HQ()[0]?.id??null)}function xZ(){return C(G(),"active")}function mQ(){try{return _Q(xZ(),"utf8").trim()||null}catch{return null}}function u0(Q){_(G(),{recursive:!0}),LQ(xZ(),Q??"")}function I1(){let Q=mQ();return Q?T(Q):null}function D1(){let Q=E0()??mQ();return Q?T(Q):null}function O1(Q){return T(Q)?.path??null}function y1(){return HZ(kQ())}var KZ="beacon_ws";function CZ(Q,Z){let $=Q.headers.get("cookie");if(!$)return null;for(let J of $.split(";")){let Y=J.indexOf("=");if(Y===-1)continue;if(J.slice(0,Y).trim()===Z)return decodeURIComponent(J.slice(Y+1).trim())}return null}function A1(Q){let Z=Q.headers.get("x-beacon-workspace");if(Z&&T(Z))return Z;let $=CZ(Q,KZ);if($&&T($))return $;return R0()}function R0(){let Q=HQ();return Q.length===1?Q[0].id:null}var g0="x-beacon-workspace-path";async function b1(Q){let Z=Q.headers.get("x-beacon-workspace");if(Z&&T(Z))return Z;let $=Q.headers.get(g0);if($&&vZ($)&&!PZ(UQ($))&&(!Z||UQ($)===Z)){let Y=GZ($);return await I0(Y.id),Y.id}let J=CZ(Q,KZ);if(J&&T(J))return J;return null}var MZ=new K0;function _1(Q,Z){return Q?MZ.run(Q,Z):Z()}function E0(){return MZ.getStore()??null}var bQ=new Set;function L1(Q){bQ.delete(C(WQ(Q),"db.sqlite"))}async function I0(Q){let Z=WQ(Q),$=C(Z,"db.sqlite"),J=HZ($);if(J&&bQ.has($))return{ok:!0,created:!1,migrated:!1};try{_(Z,{recursive:!0});let{provisionDb:Y}=await UZ().then(() => XZ),V=await Y(F0(Q));return bQ.add($),{ok:!0,created:!J,migrated:J&&V.migrated}}catch(Y){return{ok:!1,created:!1,migrated:!1,error:Y instanceof Error?Y.message:String(Y)}}}p();EQ();import{execSync as D0,spawnSync as fZ}from"child_process";import{existsSync as O0,readFileSync as y0}from"fs";import{join as TZ}from"path";var W=(Q)=>`\x1B[32m\u2713\x1B[0m ${Q}`,H=(Q)=>`\x1B[31m\u2717\x1B[0m ${Q}`,x=(Q)=>`\x1B[2m${Q}\x1B[0m`,E=(Q)=>`
-\x1B[1m${Q}\x1B[0m`;function A0(){try{return D0("git rev-parse --show-toplevel",{cwd:process.cwd(),stdio:["ignore","pipe","ignore"]}).toString().trim()}catch{return""}}function b0(){let Q=TZ(G(),"server.json");try{let Z=JSON.parse(y0(Q,"utf8"));if(!Z.pid)return H("daemon: no server.json yet");try{return process.kill(Z.pid,0),W(`daemon running (pid ${Z.pid}, port ${Z.port??"?"})`)}catch{return H(`daemon NOT running (server.json stale: pid ${Z.pid})`)}}catch{return H("daemon: no server.json (never started)")}}function _0(){let Q=fZ("bun",["--version"],{stdio:["ignore","pipe","ignore"]});if(Q.status===0)return W(`bun ${Q.stdout.toString().trim()}`);return H("bun NOT found on PATH (required to run Beacon)")}function L0(){return A0()||process.cwd()}var jQ=L0(),M=zZ(),FZ=HQ(),k0=FZ.some((Q)=>Q.path===jQ),j=k0||O0(TZ(jQ,".mcp.json"))?xQ(jQ):null;console.log(E("Beacon \xB7 doctor"));console.log(E("Runtime"));console.log(`  ${_0()}`);console.log(`  ${b0()}`);console.log(`  ${W(`home: ${G()}`)}`);console.log(`  ${W(`workspaces registered: ${FZ.length}`)}`);console.log(E("Global (~/.claude/)"));for(let Q of B)console.log(`  ${M.skills[Q]?W(`skill ${Q}`):H(`skill ${Q} \u2014 missing`)}`);for(let Q of g)console.log(`  ${M.hooks[Q.event]?W(`hook ${Q.event} \u2192 ${Q.command}`):H(`hook ${Q.event} \u2192 ${Q.command} \u2014 missing`)}   ${x(Q.description)}`);console.log(`  ${M.claudeMdBlock?W("global CLAUDE.md block"):H("global CLAUDE.md block \u2014 missing (every Claude session won't auto-discover Beacon)")}`);console.log(E("Plugin (Claude Code)"));var wZ=n();if(wZ)if(console.log(`  ${W(`installed as a Claude Code plugin \u2192 ${wZ}`)}`),console.log(`  ${x("the plugin owns the Claude-side skills/hooks/MCP")}`),M.hooks.PostToolUse||B.some((Q)=>M.skills[Q]))console.log(`  ${x("npm-global ~/.claude entries still present \u2014 they'll be removed automatically on the next `beacon` run (run `beacon` once to deconflict now).")}`);else console.log(`  ${W("npm-global ~/.claude layer stepped aside \u2014 no double-registration")}`);else console.log(`  ${x("not installed as a Claude Code plugin (using the npm `trybeacon` CLI).")}`);console.log(E("Codex (~/.codex/ + ~/.agents/)"));var N=VQ()?gQ():null;if(!N)console.log(`  ${x("codex not on PATH \u2014 Codex integration inactive (wires automatically once codex is installed)")}`);else{let Q=fZ("codex",["--version"],{stdio:["ignore","pipe","ignore"]});console.log(`  ${Q.status===0?W(`codex ${Q.stdout.toString().trim()}`):x("codex version unavailable (BEACON_CODEX override?)")}`);for(let $ of B)console.log(`  ${N.skills[$]?W(`skill ${$} (~/.agents/skills)`):H(`skill ${$} (~/.agents/skills) \u2014 missing`)}`);for(let $ of f)console.log(`  ${N.hooks[$.event]?W(`hook ${$.event} \u2192 ${$.command}`):H(`hook ${$.event} \u2192 ${$.command} \u2014 missing`)}   ${x($.description)}`);console.log(`  ${N.agentsMdBlock?W("global ~/.codex/AGENTS.md block"):H("global ~/.codex/AGENTS.md block \u2014 missing")}`);let Z=RQ();console.log(`  ${N.mcp?W("config.toml has [mcp_servers.beacon]"):H(`config.toml missing [mcp_servers.beacon]${Z?` \u2014 ${Z}`:""}`)}`)}console.log(E(`Current repo (${jQ})`));if(!j)console.log(`  ${x("not registered with Beacon and no .mcp.json \u2014 run `beacon` here to wire it.")}`);else if(console.log(`  ${j.mcpRegistered?W(".mcp.json has beacon entry"):H(".mcp.json missing beacon entry")}`),console.log(`  ${j.agentsMdBlock?W("AGENTS.md has Beacon workflow block"):H("AGENTS.md missing Beacon workflow block")}`),console.log(`  ${j.claudeMdImport?W("CLAUDE.md @-imports AGENTS.md"):H("CLAUDE.md does NOT @-import AGENTS.md")}`),console.log(`  ${j.skills["beacon-init"]?W("skill beacon-init (repo)"):H("skill beacon-init (repo) \u2014 missing")}`),console.log(`  ${j.skills["beacon-refresh"]?W("skill beacon-refresh (repo)"):H("skill beacon-refresh (repo) \u2014 missing")}`),N)console.log(`  ${j.codexSkills["beacon-init"]?W("skill beacon-init (.agents/skills)"):H("skill beacon-init (.agents/skills) \u2014 missing")}`),console.log(`  ${j.codexSkills["beacon-refresh"]?W("skill beacon-refresh (.agents/skills)"):H("skill beacon-refresh (.agents/skills) \u2014 missing")}`);var S0=B.some((Q)=>!M.skills[Q])||g.some((Q)=>!M.hooks[Q.event])||!M.claudeMdBlock||(N?B.some((Q)=>!N.skills[Q])||f.some((Q)=>!N.hooks[Q.event])||!N.agentsMdBlock||!N.mcp:!1)||(j?!j.mcpRegistered||!j.agentsMdBlock||!j.claudeMdImport||!j.skills["beacon-init"]||!j.skills["beacon-refresh"]||(N?!j.codexSkills["beacon-init"]||!j.codexSkills["beacon-refresh"]:!1):!1);if(S0)console.log(`
+${QZ}
+`});var UZ={};BQ(UZ,{provisionDb:()=>w0});import{createClient as H0}from"@libsql/client";import{drizzle as j0}from"drizzle-orm/libsql";import{migrate as v0}from"drizzle-orm/libsql/migrator";import{readMigrationFiles as B0}from"drizzle-orm/migrator";import{dirname as AQ,join as N0}from"path";import{fileURLToPath as G0}from"url";async function XQ(Q,Z){return(await Q.execute({sql:"SELECT 1 FROM sqlite_master WHERE type='table' AND name = ?",args:[Z]})).rows.length>0}async function C0(Q,Z){let $=await Q.execute(`PRAGMA table_info("${Z}")`);return new Set($.rows.map((J)=>String(J.name)))}async function XZ(Q){if(!await XQ(Q,"__drizzle_migrations"))return 0;let Z=await Q.execute('SELECT count(*) AS n FROM "__drizzle_migrations"');return Number(Z.rows[0]?.n??0)}async function M0(Q){for(let[Z,$]of Object.entries(K0)){if(!await XQ(Q,Z))continue;let J=await C0(Q,Z);for(let Y of $){if(!J.has(Y))continue;await Q.execute(`UPDATE "${Z}" SET "${Y}" = CAST((julianday("${Y}") - 2440587.5) * 86400000 AS INTEGER) WHERE typeof("${Y}") = 'text'`)}}}async function w0(Q,Z=x0){let $=H0({url:Q});try{await $.execute("PRAGMA journal_mode = WAL;"),await $.execute("PRAGMA foreign_keys = ON;"),await $.execute("PRAGMA busy_timeout = 5000;");let J=await XQ($,"__drizzle_migrations"),Y=await XQ($,"Node"),V=!1;if(Y&&!J){let H=B0({migrationsFolder:Z})[0];if(H)await $.execute('CREATE TABLE IF NOT EXISTS "__drizzle_migrations" (id SERIAL PRIMARY KEY, hash text NOT NULL, created_at numeric)'),await $.execute({sql:'INSERT INTO "__drizzle_migrations" ("hash", "created_at") VALUES (?, ?)',args:[H.hash,H.folderMillis]}),V=!0}let q=await XZ($);if(await v0(j0($),{migrationsFolder:Z}),await XZ($)>q)V=!0;return await M0($),{migrated:V}}finally{$.close()}}var P0,x0,K0;var WZ=F(async()=>{P0=AQ(AQ(AQ(G0(import.meta.url)))),x0=process.env.BEACON_MIGRATIONS_DIR||N0(P0,"drizzle"),K0={Node:["createdAt","updatedAt"],Note:["createdAt","updatedAt"],DbTable:["createdAt","updatedAt"],Endpoint:["createdAt","updatedAt"],DraftTable:["createdAt"],SyncState:["codeGraphSyncedAt","updatedAt"],AppSetting:["updatedAt"],ProjectMeta:["updatedAt"],CodeFile:["updatedAt"]}});wQ();import{existsSync as iZ}from"fs";import{homedir as eZ}from"os";import{join as zQ}from"path";function Q0(){return process.env.HOME||process.env.USERPROFILE||eZ()}var qQ=()=>zQ(Q0(),".claude"),DQ=()=>zQ(qQ(),"skills"),IQ=()=>zQ(qQ(),"settings.json"),OQ=()=>zQ(qQ(),"CLAUDE.md"),yQ="<!-- beacon:global:start -->",YZ="<!-- beacon:global:end -->";var Z0=s,E=[{event:"PreToolUse",matcher:"Edit|Write|MultiEdit",command:"beacon guard",description:"Gate edits against the active plan's scope contract (when the scope-guard flag is on): in-scope \u2192 allow, off-scope \u2192 ask the user to authorize. No-op + fail-open otherwise."},{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 $0(Q,Z){return i(DQ(),Q,Z)}function VZ(Q){return y(DQ(),Q)}function J0(Q){return e(DQ(),Q)}function Y0(Q){return t(IQ(),Q)}function V0(Q){return a(IQ(),Q)}function z0(Q){return d(IQ(),Q)}function q0(Q){r(OQ(),yQ,YZ,Q)}function zZ(){return O(OQ(),yQ)}function X0(){return o(OQ(),yQ,YZ)}function qZ(){let Q={};for(let $ of B)Q[$]=VZ($);let Z={};for(let $ of E)Z[$.event]=V0({event:$.event,command:$.command});return{homeExists:iZ(qQ()),skills:Q,hooks:Z,claudeMdBlock:zZ()}}async function U0(){let{INIT_SKILL:Q,REFRESH_SKILL:Z,PLAN_SKILL:$,EXPLAIN_SKILL:J}=await Promise.resolve().then(() => (p(),KQ)),Y={"beacon-init":Q,"beacon-refresh":Z,"beacon-plan":$,"beacon-explain":J},V=[];for(let z of B){if(!VZ(z))V.push(z);$0(z,Y[z])}let q=0;for(let z of E)if(Y0({event:z.event,matcher:z.matcher,command:z.command}))q++;let H=zZ();return q0(Z0),{skillsAdded:V,hooksAdded:q,claudeMdBlockTouched:!H}}async function N1(){if(tQ())return{ok:!0,skipped:"plugin",skillsAdded:[],hooksAdded:0,claudeMdBlockTouched:!1};let Q;if(aQ()){try{W0()}catch{}Q={ok:!0,skipped:"plugin-present",skillsAdded:[],hooksAdded:0,claudeMdBlockTouched:!1}}else try{Q={ok:!0,...await U0()}}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(() => (EQ(),JZ));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 W0(){let Q=[];for(let J of B)if(J0(J))Q.push(J);let Z=0;for(let J of E)if(z0(J))Z++;let $=X0();return{skillsRemoved:Q,hooksRemoved:Z,claudeMdBlockRemoved:$}}import{AsyncLocalStorage as f0}from"async_hooks";import{spawnSync as T0}from"child_process";import{createHash as F0}from"crypto";import{existsSync as jZ,mkdirSync as k,readFileSync as _Q,writeFileSync as kQ}from"fs";import{homedir as vZ}from"os";import{basename as R0,join as M,parse as u0,resolve as HZ}from"path";function P(){return process.env.BEACON_HOME||M(vZ(),".beacon")}function LQ(){return M(P(),"workspaces.json")}function UQ(Q){return F0("sha256").update(Q).digest("hex").slice(0,12)}function E1(Q=process.cwd()){let Z=T0("git",["rev-parse","--show-toplevel"],{cwd:Q,stdio:["ignore","pipe","ignore"]});if(Z.status===0){let $=Z.stdout?.toString().trim();if($)return $}return Q}function BZ(Q){let Z=HZ(Q);return Z!==HZ(vZ())&&Z!==u0(Z).root}function NZ(){return M(P(),"deleted.json")}function SQ(){try{let Q=JSON.parse(_Q(NZ(),"utf8"));return Array.isArray(Q)?Q:[]}catch{return[]}}function GZ(Q){k(P(),{recursive:!0}),kQ(NZ(),JSON.stringify(Q,null,2))}function PZ(Q){return SQ().includes(Q)}function D1(Q){let Z=SQ();if(!Z.includes(Q))GZ([...Z,Q])}function g0(Q){let Z=SQ();if(Z.includes(Q))GZ(Z.filter(($)=>$!==Q))}function WQ(Q){return M(P(),Q)}function E0(Q){return`file:${M(WQ(Q),"db.sqlite")}`}function L(){try{let Q=JSON.parse(_Q(LQ(),"utf8"));return Array.isArray(Q)?Q:[]}catch{return[]}}function hQ(Q){k(P(),{recursive:!0}),kQ(LQ(),JSON.stringify(Q,null,2))}function HQ(){return L().sort((Q,Z)=>Z.lastOpenedAt.localeCompare(Q.lastOpenedAt))}function T(Q){return L().find((Z)=>Z.id===Q)??null}function xZ(Q,Z,$=new Date().toISOString()){if(!BZ(Q))throw Error(`beacon: refusing to register a non-repo path as a workspace: ${Q}`);let J=UQ(Q);if(PZ(J))throw Error(`beacon: workspace ${J} (${Q}) was deleted \u2014 run \`beacon\` or /beacon-init to re-add it`);let Y=L(),V=Y.find((z)=>z.id===J),q={id:J,path:Q,name:Z||V?.name||R0(Q),lastOpenedAt:$},H=[q,...Y.filter((z)=>z.id!==J)];return k(WQ(J),{recursive:!0}),hQ(H),q}function I1(Q,Z){return g0(UQ(Q)),xZ(Q,Z)}function O1(Q,Z=new Date().toISOString()){let $=L(),J=$.find((Y)=>Y.id===Q);if(!J)return;J.lastOpenedAt=Z,hQ($)}function y1(Q){if(hQ(L().filter((Z)=>Z.id!==Q)),mQ()===Q)D0(HQ()[0]?.id??null)}function KZ(){return M(P(),"active")}function mQ(){try{return _Q(KZ(),"utf8").trim()||null}catch{return null}}function D0(Q){k(P(),{recursive:!0}),kQ(KZ(),Q??"")}function A1(){let Q=mQ();return Q?T(Q):null}function b1(){let Q=y0()??mQ();return Q?T(Q):null}function _1(Q){return T(Q)?.path??null}function k1(){return jZ(LQ())}var CZ="beacon_ws";function MZ(Q,Z){let $=Q.headers.get("cookie");if(!$)return null;for(let J of $.split(";")){let Y=J.indexOf("=");if(Y===-1)continue;if(J.slice(0,Y).trim()===Z)return decodeURIComponent(J.slice(Y+1).trim())}return null}function L1(Q){let Z=Q.headers.get("x-beacon-workspace");if(Z&&T(Z))return Z;let $=MZ(Q,CZ);if($&&T($))return $;return I0()}function I0(){let Q=HQ();return Q.length===1?Q[0].id:null}var O0="x-beacon-workspace-path";async function S1(Q){let Z=Q.headers.get("x-beacon-workspace");if(Z&&T(Z))return Z;let $=Q.headers.get(O0);if($&&BZ($)&&!PZ(UQ($))&&(!Z||UQ($)===Z)){let Y=xZ($);return await A0(Y.id),Y.id}let J=MZ(Q,CZ);if(J&&T(J))return J;return null}var wZ=new f0;function h1(Q,Z){return Q?wZ.run(Q,Z):Z()}function y0(){return wZ.getStore()??null}var bQ=new Set;function m1(Q){bQ.delete(M(WQ(Q),"db.sqlite"))}async function A0(Q){let Z=WQ(Q),$=M(Z,"db.sqlite"),J=jZ($);if(J&&bQ.has($))return{ok:!0,created:!1,migrated:!1};try{k(Z,{recursive:!0});let{provisionDb:Y}=await WZ().then(() => UZ),V=await Y(E0(Q));return bQ.add($),{ok:!0,created:!J,migrated:J&&V.migrated}}catch(Y){return{ok:!1,created:!1,migrated:!1,error:Y instanceof Error?Y.message:String(Y)}}}p();EQ();import{execSync as b0,spawnSync as TZ}from"child_process";import{existsSync as _0,readFileSync as k0}from"fs";import{join as FZ}from"path";var W=(Q)=>`\x1B[32m\u2713\x1B[0m ${Q}`,j=(Q)=>`\x1B[31m\u2717\x1B[0m ${Q}`,x=(Q)=>`\x1B[2m${Q}\x1B[0m`,D=(Q)=>`
+\x1B[1m${Q}\x1B[0m`;function L0(){try{return b0("git rev-parse --show-toplevel",{cwd:process.cwd(),stdio:["ignore","pipe","ignore"]}).toString().trim()}catch{return""}}function S0(){let Q=FZ(P(),"server.json");try{let Z=JSON.parse(k0(Q,"utf8"));if(!Z.pid)return j("daemon: no server.json yet");try{return process.kill(Z.pid,0),W(`daemon running (pid ${Z.pid}, port ${Z.port??"?"})`)}catch{return j(`daemon NOT running (server.json stale: pid ${Z.pid})`)}}catch{return j("daemon: no server.json (never started)")}}function h0(){let Q=TZ("bun",["--version"],{stdio:["ignore","pipe","ignore"]});if(Q.status===0)return W(`bun ${Q.stdout.toString().trim()}`);return j("bun NOT found on PATH (required to run Beacon)")}function m0(){return L0()||process.cwd()}var jQ=m0(),w=qZ(),RZ=HQ(),p0=RZ.some((Q)=>Q.path===jQ),v=p0||_0(FZ(jQ,".mcp.json"))?xQ(jQ):null;console.log(D("Beacon \xB7 doctor"));console.log(D("Runtime"));console.log(`  ${h0()}`);console.log(`  ${S0()}`);console.log(`  ${W(`home: ${P()}`)}`);console.log(`  ${W(`workspaces registered: ${RZ.length}`)}`);console.log(D("Global (~/.claude/)"));for(let Q of B)console.log(`  ${w.skills[Q]?W(`skill ${Q}`):j(`skill ${Q} \u2014 missing`)}`);for(let Q of E)console.log(`  ${w.hooks[Q.event]?W(`hook ${Q.event} \u2192 ${Q.command}`):j(`hook ${Q.event} \u2192 ${Q.command} \u2014 missing`)}   ${x(Q.description)}`);console.log(`  ${w.claudeMdBlock?W("global CLAUDE.md block"):j("global CLAUDE.md block \u2014 missing (every Claude session won't auto-discover Beacon)")}`);console.log(D("Plugin (Claude Code)"));var fZ=n();if(fZ)if(console.log(`  ${W(`installed as a Claude Code plugin \u2192 ${fZ}`)}`),console.log(`  ${x("the plugin owns the Claude-side skills/hooks/MCP")}`),w.hooks.PostToolUse||B.some((Q)=>w.skills[Q]))console.log(`  ${x("npm-global ~/.claude entries still present \u2014 they'll be removed automatically on the next `beacon` run (run `beacon` once to deconflict now).")}`);else console.log(`  ${W("npm-global ~/.claude layer stepped aside \u2014 no double-registration")}`);else console.log(`  ${x("not installed as a Claude Code plugin (using the npm `trybeacon` CLI).")}`);console.log(D("Codex (~/.codex/ + ~/.agents/)"));var G=VQ()?gQ():null;if(!G)console.log(`  ${x("codex not on PATH \u2014 Codex integration inactive (wires automatically once codex is installed)")}`);else{let Q=TZ("codex",["--version"],{stdio:["ignore","pipe","ignore"]});console.log(`  ${Q.status===0?W(`codex ${Q.stdout.toString().trim()}`):x("codex version unavailable (BEACON_CODEX override?)")}`);for(let $ of B)console.log(`  ${G.skills[$]?W(`skill ${$} (~/.agents/skills)`):j(`skill ${$} (~/.agents/skills) \u2014 missing`)}`);for(let $ of f)console.log(`  ${G.hooks[$.event]?W(`hook ${$.event} \u2192 ${$.command}`):j(`hook ${$.event} \u2192 ${$.command} \u2014 missing`)}   ${x($.description)}`);console.log(`  ${G.agentsMdBlock?W("global ~/.codex/AGENTS.md block"):j("global ~/.codex/AGENTS.md block \u2014 missing")}`);let Z=uQ();console.log(`  ${G.mcp?W("config.toml has [mcp_servers.beacon]"):j(`config.toml missing [mcp_servers.beacon]${Z?` \u2014 ${Z}`:""}`)}`)}console.log(D(`Current repo (${jQ})`));if(!v)console.log(`  ${x("not registered with Beacon and no .mcp.json \u2014 run `beacon` here to wire it.")}`);else if(console.log(`  ${v.mcpRegistered?W(".mcp.json has beacon entry"):j(".mcp.json missing beacon entry")}`),console.log(`  ${v.agentsMdBlock?W("AGENTS.md has Beacon workflow block"):j("AGENTS.md missing Beacon workflow block")}`),console.log(`  ${v.claudeMdImport?W("CLAUDE.md @-imports AGENTS.md"):j("CLAUDE.md does NOT @-import AGENTS.md")}`),console.log(`  ${v.skills["beacon-init"]?W("skill beacon-init (repo)"):j("skill beacon-init (repo) \u2014 missing")}`),console.log(`  ${v.skills["beacon-refresh"]?W("skill beacon-refresh (repo)"):j("skill beacon-refresh (repo) \u2014 missing")}`),G)console.log(`  ${v.codexSkills["beacon-init"]?W("skill beacon-init (.agents/skills)"):j("skill beacon-init (.agents/skills) \u2014 missing")}`),console.log(`  ${v.codexSkills["beacon-refresh"]?W("skill beacon-refresh (.agents/skills)"):j("skill beacon-refresh (.agents/skills) \u2014 missing")}`);var c0=B.some((Q)=>!w.skills[Q])||E.some((Q)=>!w.hooks[Q.event])||!w.claudeMdBlock||(G?B.some((Q)=>!G.skills[Q])||f.some((Q)=>!G.hooks[Q.event])||!G.agentsMdBlock||!G.mcp:!1)||(v?!v.mcpRegistered||!v.agentsMdBlock||!v.claudeMdImport||!v.skills["beacon-init"]||!v.skills["beacon-refresh"]||(G?!v.codexSkills["beacon-init"]||!v.codexSkills["beacon-refresh"]:!1):!1);if(c0)console.log(`
 ${x("Fix everything marked \u2717 by running")} \x1B[1mbeacon\x1B[0m ${x("in this repo.")}`);console.log();