trybeacon 0.1.62 → 0.1.63

package/.next/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":31723143,"timestamp":51732523,"id":14,"parentId":1,"tags":{},"startTime":1781790421620,"traceId":"cfff94ac927b72e8"},{"name":"run-typescript","duration":13849520,"timestamp":83458662,"id":4492,"parentId":1,"tags":{},"startTime":1781790453346,"traceId":"cfff94ac927b72e8"},{"name":"static-check","duration":747505,"timestamp":97387694,"id":4495,"parentId":1,"tags":{},"startTime":1781790467275,"traceId":"cfff94ac927b72e8"},{"name":"static-generation","duration":5138022,"timestamp":98790679,"id":4657,"parentId":1,"tags":{},"startTime":1781790468678,"traceId":"cfff94ac927b72e8"},{"name":"collect-build-traces","duration":14423137,"timestamp":98138099,"id":4654,"parentId":1,"tags":{},"startTime":1781790468025,"traceId":"cfff94ac927b72e8"},{"name":"telemetry-flush","duration":63,"timestamp":112565241,"id":4666,"parentId":1,"tags":{},"startTime":1781790482452,"traceId":"cfff94ac927b72e8"},{"name":"next-build","duration":60955566,"timestamp":51609750,"id":1,"tags":{"buildMode":"default","version":"16.2.7","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1781790421497,"traceId":"cfff94ac927b72e8"}]
+[{"name":"run-webpack","duration":29846558,"timestamp":48508277,"id":14,"parentId":1,"tags":{},"startTime":1781795653315,"traceId":"f07316b58a4dfbe0"},{"name":"run-typescript","duration":13339604,"timestamp":78357552,"id":4492,"parentId":1,"tags":{},"startTime":1781795683165,"traceId":"f07316b58a4dfbe0"},{"name":"static-check","duration":766007,"timestamp":91710638,"id":4495,"parentId":1,"tags":{},"startTime":1781795696518,"traceId":"f07316b58a4dfbe0"},{"name":"static-generation","duration":4550703,"timestamp":93045349,"id":4657,"parentId":1,"tags":{},"startTime":1781795697852,"traceId":"f07316b58a4dfbe0"},{"name":"collect-build-traces","duration":12238223,"timestamp":92479402,"id":4654,"parentId":1,"tags":{},"startTime":1781795697286,"traceId":"f07316b58a4dfbe0"},{"name":"telemetry-flush","duration":54,"timestamp":104721434,"id":4666,"parentId":1,"tags":{},"startTime":1781795709528,"traceId":"f07316b58a4dfbe0"},{"name":"next-build","duration":56328923,"timestamp":48392576,"id":1,"tags":{"buildMode":"default","version":"16.2.7","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1781795653200,"traceId":"f07316b58a4dfbe0"}]

package/dist/bin/beacon.js

@@ -1,19 +1,20 @@
 #!/usr/bin/env bun
 // @bun
-import{execSync as _,spawn as m}from"child_process";import{existsSync as u,mkdirSync as g,openSync as c,readFileSync as d,writeFileSync as p}from"fs";import{homedir as t,platform as L}from"os";import{basename as l,dirname as j,join as U}from"path";import{fileURLToPath as a}from"url";var T=j(a(import.meta.url)),O=l(j(T))==="dist",V=O?j(j(T)):j(T),P=process.cwd(),v=process.env.BEACON_HOME||U(t(),".beacon"),A=U(v,"server.json"),w=process.env.PORT||"4319";if(!process.env.BEACON_MIGRATIONS_DIR)process.env.BEACON_MIGRATIONS_DIR=U(V,"drizzle");function Q(z){if(!O)return U(V,z);return U(V,"dist",z.replace(/\.ts$/,".js"))}var Y=process.argv[2];if(Y==="mcp")await import(Q("bin/mcp.ts"));else if(Y==="hook")await import(Q("bin/hook.ts"));else if(Y==="guard")await import(Q("bin/guard.ts"));else if(Y==="plan")await import(Q("bin/plan.ts"));else if(Y==="prompt")await import(Q("bin/prompt.ts"));else if(Y==="stop-hook")await import(Q("bin/stop-hook.ts"));else if(Y==="stop")f();else if(Y==="remove")await import(Q("bin/remove.ts"));else if(Y==="setup")await E(D()||P);else if(Y==="doctor")await import(Q("bin/doctor.ts"));else if(Y==="uninstall")await import(Q("bin/uninstall.ts"));else if(Y==="update")await zz(process.argv.includes("--force")||process.argv.includes("-f"));else if(Y==="telemetry")await e(process.argv[3]);else if(Y==="version"||Y==="--version"||Y==="-v")console.log(x());else await r();async function E(z,Z=!1){let{installInitSkill:X,installRefreshSkill:J,installCodexRepoSkills:K,ensureMcp:G,ensureWorkflowDoc:W}=await import(Q("lib/assets.ts")),{selfHealGlobal:F}=await import(Q("lib/global-install.ts")),{codexDetected:M}=await import(Q("lib/codex-install.ts")),N=await F(),H=X(z),B=J(z);W(z);let $=G(z),y=M()?K(z):[];if(Z){if($.added||$.updated)console.log(`[beacon] ${$.added?"registered":"updated"} Beacon MCP in ${$.path} \u2014 restart your agent CLI`+($.updated?" to apply the longer plan-review timeout.":" to use @beacon mentions."))}else{console.log(`
-  \u25C9 Beacon setup \xB7 ${z}`),console.log(`  \u2713 skill:  ${H}`),console.log(`  \u2713 skill:  ${B}`);for(let I of y)console.log(`  \u2713 skill:  ${I}`);console.log(`  ${$.added?"\u2713 added ":"\xB7 kept  "} Beacon MCP in ${$.path}`),console.log(`  \u2192 in this repo, run /beacon-init in your agent (Claude Code or Codex) to map the repo.
-`)}return{initSkill:H,refreshSkill:B,mcp:$,codexSkills:y,heal:N}}function D(){try{return _("git rev-parse --show-toplevel",{cwd:P,stdio:["ignore","pipe","ignore"]}).toString().trim()}catch{return""}}function k(z){try{return process.kill(z,0),!0}catch{return!1}}function R(z){try{return JSON.parse(d(z,"utf8"))}catch{return null}}async function S(z){try{return(await fetch(z)).ok}catch{return!1}}async function n(z,Z=60){for(let X=0;X<Z;X++){if(await S(z))return!0;await new Promise((J)=>setTimeout(J,500))}return!1}function i(z){g(v,{recursive:!0});let Z=c(U(v,"server.log"),"a"),X={...process.env,PORT:z,BEACON_NO_OPEN:"1",BEACON_MIGRATIONS_DIR:U(V,"drizzle")};delete X.BEACON_REPO,delete X.BEACON_DATA_DIR,delete X.DATABASE_URL;let K=m("bun",O?["run","start"]:["run","dev"],{cwd:V,env:X,detached:!0,stdio:["ignore",Z,Z]});K.unref();let G={pid:K.pid??0,port:z};return p(A,JSON.stringify(G)),G}async function s(){let z=R(A);if(z&&k(z.pid)&&await S(`http://localhost:${z.port}/api/workspace`))return z.port;let{findAvailablePort:Z}=await import(Q("lib/daemon-port.ts")),X=String(await Z(Number(w)));console.log(X===w?"[beacon] starting the Beacon server\u2026":`[beacon] port ${w} is busy \u2014 starting the Beacon server on port ${X}\u2026`);let{port:J}=i(X);if(!await n(`http://localhost:${J}/api/workspace`))console.log("[beacon] (server is taking a while \u2014 it may still be compiling)");return J}function o(z){if(process.env.BEACON_NO_OPEN)return;let Z=L()==="darwin"?"open":L()==="win32"?"start":"xdg-open";try{_(`${Z} "${z}"`,{stdio:"ignore"})}catch{}}async function r(){let z=D()||P,{registerWorkspaceExplicit:Z,idForPath:X,dataDirFor:J,ensureWorkspaceDb:K,isRegistrableWorkspacePath:G}=await import(Q("lib/workspaces.ts"));if(!G(z))console.error(`[beacon] refusing to open Beacon in ${z} \u2014 that's your home directory, not a project.
-`+"          cd into a repo (or run `git init` there) and try again."),process.exit(1);let W=X(z),F=J(W),M=!u(U(F,"db.sqlite"));if(M)console.log(`[beacon] first run for ${z} \u2014 creating database\u2026`);let N=await K(W);if(!N.ok)console.error(`[beacon] failed to provision database: ${N.error}`);if(M)console.log("[beacon] tip: already have code here? run `/beacon-init` in your agent (Claude Code or Codex) to map the project.");let{heal:H}=await E(z,!0),B=[];if(H.skillsAdded.length)B.push(`skills ${H.skillsAdded.join(", ")}`);if(H.hooksAdded)B.push(`${H.hooksAdded} Claude Code hook${H.hooksAdded===1?"":"s"}`);if(H.claudeMdBlockTouched)B.push("global CLAUDE.md block");if(B.length)console.log(`[beacon] wired into ~/.claude/: ${B.join(" + ")}.`);let $=H.codex;if($){let q=[];if($.skillsAdded.length)q.push(`skills ${$.skillsAdded.join(", ")}`);if($.hooksAdded)q.push(`${$.hooksAdded} Codex hook${$.hooksAdded===1?"":"s"}`);if($.agentsMdBlockTouched)q.push("global AGENTS.md block");if($.mcp.added)q.push("MCP entry in config.toml");if(q.length)console.log(`[beacon] wired into ~/.codex/: ${q.join(" + ")}.`);if($.mcp.error)console.log(`[beacon] codex MCP not wired: ${$.mcp.error}`)}try{let q=await import(Q("lib/telemetry.ts"));if(!q.telemetryStatus().machineId){let b=q.telemetryStatus().enabled;console.log(`[beacon] telemetry: Beacon sends an anonymous heartbeat (random machine id, version, OS,
+import{execSync as _,spawn as g}from"child_process";import{existsSync as c,mkdirSync as d,openSync as p,readFileSync as k,writeFileSync as l}from"fs";import{homedir as t,platform as T}from"os";import{basename as n,dirname as N,join as B}from"path";import{fileURLToPath as a}from"url";var O=N(a(import.meta.url)),P=n(N(O))==="dist",F=P?N(N(O)):N(O),y=process.cwd(),w=process.env.BEACON_HOME||B(t(),".beacon"),A=B(w,"server.json"),v=process.env.PORT||"4319";if(!process.env.BEACON_MIGRATIONS_DIR)process.env.BEACON_MIGRATIONS_DIR=B(F,"drizzle");function Q(z){if(!P)return B(F,z);return B(F,"dist",z.replace(/\.ts$/,".js"))}var q=process.argv[2];if(q==="mcp")await import(Q("bin/mcp.ts"));else if(q==="hook")await import(Q("bin/hook.ts"));else if(q==="guard")await import(Q("bin/guard.ts"));else if(q==="plan")await import(Q("bin/plan.ts"));else if(q==="prompt")await import(Q("bin/prompt.ts"));else if(q==="stop-hook")await import(Q("bin/stop-hook.ts"));else if(q==="stop")f();else if(q==="remove")await import(Q("bin/remove.ts"));else if(q==="setup")await x(R()||y);else if(q==="init-persist")await s(process.argv[3]);else if(q==="doctor")await import(Q("bin/doctor.ts"));else if(q==="uninstall")await import(Q("bin/uninstall.ts"));else if(q==="update")await Xz(process.argv.includes("--force")||process.argv.includes("-f"));else if(q==="telemetry")await zz(process.argv[3]);else if(q==="version"||q==="--version"||q==="-v")console.log(D());else await e();async function x(z,X=!1){let{installInitSkill:Z,installRefreshSkill:J,installCodexRepoSkills:K,ensureMcp:G,ensureWorkflowDoc:H}=await import(Q("lib/assets.ts")),{selfHealGlobal:V}=await import(Q("lib/global-install.ts")),{codexDetected:W}=await import(Q("lib/codex-install.ts")),j=await V(),Y=Z(z),I=J(z);H(z);let $=G(z),L=W()?K(z):[];if(X){if($.added||$.updated)console.log(`[beacon] ${$.added?"registered":"updated"} Beacon MCP in ${$.path} \u2014 restart your agent CLI`+($.updated?" to apply the longer plan-review timeout.":" to use @beacon mentions."))}else{console.log(`
+  \u25C9 Beacon setup \xB7 ${z}`),console.log(`  \u2713 skill:  ${Y}`),console.log(`  \u2713 skill:  ${I}`);for(let M of L)console.log(`  \u2713 skill:  ${M}`);console.log(`  ${$.added?"\u2713 added ":"\xB7 kept  "} Beacon MCP in ${$.path}`),console.log(`  \u2192 in this repo, run /beacon-init in your agent (Claude Code or Codex) to map the repo.
+`)}return{initSkill:Y,refreshSkill:I,mcp:$,codexSkills:L,heal:j}}async function s(z){let X=R()||y,{idForPath:Z,isRegistrableWorkspacePath:J,BEACON_WS_PATH_HEADER:K}=await import(Q("lib/workspaces.ts"));if(!J(X))console.error(`[beacon] refusing to init ${X} \u2014 that's your home directory, not a project.
+`+"          cd into a repo (or run `git init` there) and try again."),process.exit(1);let G="";try{G=k(z??0,"utf8").trim()}catch(Y){console.error(`[beacon] could not read the init analysis ${z?`from ${z}`:"from stdin"}: ${Y instanceof Error?Y.message:Y}`),process.exit(1)}if(!G)console.error("[beacon] empty init analysis \u2014 pass the JSON as a file argument (`beacon init-persist analysis.json`) or on stdin."),process.exit(1);await x(X,!0);let H=await b(),V=Z(X),W;try{W=await fetch(`http://localhost:${H}/api/init`,{method:"POST",headers:{"content-type":"application/json","x-beacon-workspace":V,[K]:X},body:G})}catch(Y){console.error(`[beacon] could not reach the Beacon daemon on port ${H}: ${Y instanceof Error?Y.message:Y}`),process.exit(1)}let j=await W.text();if(!W.ok)console.error(`[beacon] init failed (HTTP ${W.status}): ${j}`),process.exit(1);console.log(`[beacon] mapped ${X} into Beacon: ${j}`),console.log(`[beacon] open the panel \u2192 http://localhost:${H}/map`)}function R(){try{return _("git rev-parse --show-toplevel",{cwd:y,stdio:["ignore","pipe","ignore"]}).toString().trim()}catch{return""}}function S(z){try{return process.kill(z,0),!0}catch{return!1}}function C(z){try{return JSON.parse(k(z,"utf8"))}catch{return null}}async function h(z){try{return(await fetch(z)).ok}catch{return!1}}async function i(z,X=60){for(let Z=0;Z<X;Z++){if(await h(z))return!0;await new Promise((J)=>setTimeout(J,500))}return!1}function o(z){d(w,{recursive:!0});let X=p(B(w,"server.log"),"a"),Z={...process.env,PORT:z,BEACON_NO_OPEN:"1",BEACON_MIGRATIONS_DIR:B(F,"drizzle")};delete Z.BEACON_REPO,delete Z.BEACON_DATA_DIR,delete Z.DATABASE_URL;let K=g("bun",P?["run","start"]:["run","dev"],{cwd:F,env:Z,detached:!0,stdio:["ignore",X,X]});K.unref();let G={pid:K.pid??0,port:z};return l(A,JSON.stringify(G)),G}async function b(){let z=C(A);if(z&&S(z.pid)&&await h(`http://localhost:${z.port}/api/workspace`))return z.port;let{findAvailablePort:X}=await import(Q("lib/daemon-port.ts")),Z=String(await X(Number(v)));console.log(Z===v?"[beacon] starting the Beacon server\u2026":`[beacon] port ${v} is busy \u2014 starting the Beacon server on port ${Z}\u2026`);let{port:J}=o(Z);if(!await i(`http://localhost:${J}/api/workspace`))console.log("[beacon] (server is taking a while \u2014 it may still be compiling)");return J}function r(z){if(process.env.BEACON_NO_OPEN)return;let X=T()==="darwin"?"open":T()==="win32"?"start":"xdg-open";try{_(`${X} "${z}"`,{stdio:"ignore"})}catch{}}async function e(){let z=R()||y,{registerWorkspaceExplicit:X,idForPath:Z,dataDirFor:J,ensureWorkspaceDb:K,isRegistrableWorkspacePath:G}=await import(Q("lib/workspaces.ts"));if(!G(z))console.error(`[beacon] refusing to open Beacon in ${z} \u2014 that's your home directory, not a project.
+`+"          cd into a repo (or run `git init` there) and try again."),process.exit(1);let H=Z(z),V=J(H),W=!c(B(V,"db.sqlite"));if(W)console.log(`[beacon] first run for ${z} \u2014 creating database\u2026`);let j=await K(H);if(!j.ok)console.error(`[beacon] failed to provision database: ${j.error}`);if(W)console.log("[beacon] tip: already have code here? run `/beacon-init` in your agent (Claude Code or Codex) to map the project.");let{heal:Y}=await x(z,!0),I=[];if(Y.skillsAdded.length)I.push(`skills ${Y.skillsAdded.join(", ")}`);if(Y.hooksAdded)I.push(`${Y.hooksAdded} Claude Code hook${Y.hooksAdded===1?"":"s"}`);if(Y.claudeMdBlockTouched)I.push("global CLAUDE.md block");if(I.length)console.log(`[beacon] wired into ~/.claude/: ${I.join(" + ")}.`);let $=Y.codex;if($){let U=[];if($.skillsAdded.length)U.push(`skills ${$.skillsAdded.join(", ")}`);if($.hooksAdded)U.push(`${$.hooksAdded} Codex hook${$.hooksAdded===1?"":"s"}`);if($.agentsMdBlockTouched)U.push("global AGENTS.md block");if($.mcp.added)U.push("MCP entry in config.toml");if(U.length)console.log(`[beacon] wired into ~/.codex/: ${U.join(" + ")}.`);if($.mcp.error)console.log(`[beacon] codex MCP not wired: ${$.mcp.error}`)}try{let U=await import(Q("lib/telemetry.ts"));if(!U.telemetryStatus().machineId){let u=U.telemetryStatus().enabled;console.log(`[beacon] telemetry: Beacon sends an anonymous heartbeat (random machine id, version, OS,
 `+`         architecture \u2014 never repo names, paths, or code) at most every 12h to count
 `+`         active installs. Opt out: \`beacon telemetry off\`, BEACON_TELEMETRY_DISABLED=1,
-         or DO_NOT_TRACK=1. Details: beacon telemetry status.${b?"":" (currently disabled by your env)"}`),q.ensureTelemetryId()}}catch{}Z(z);let I=`http://localhost:${await s()}`,C=`/map?ws=${W}`,h=`${I}/api/workspace/activate?id=${W}&redirect=${encodeURIComponent(C)}`;if(console.log(`
+         or DO_NOT_TRACK=1. Details: beacon telemetry status.${u?"":" (currently disabled by your env)"}`),U.ensureTelemetryId()}}catch{}X(z);let M=`http://localhost:${await b()}`,E=`/map?ws=${H}`,m=`${M}/api/workspace/activate?id=${H}&redirect=${encodeURIComponent(E)}`;if(console.log(`
   \u25C9 Beacon
   repo:  ${z}
-  data:  ${F}
-  url:   ${I}
-`),console.log("  (the server keeps running in the background \u2014 `beacon stop` to stop it)\n"),await fetch(`${I}/api/tab/presence`,{headers:{"x-beacon-workspace":W}}).then((q)=>q.json()).then((q)=>!!q?.live).catch(()=>!1))await fetch(`${I}/api/tab/nav`,{method:"POST",headers:{"content-type":"application/json","x-beacon-workspace":W},body:JSON.stringify({path:C})}).catch(()=>{}),console.log(`  \u21BB reusing your open Beacon tab \u2014 switch to your browser.
-`);else o(h)}function x(){return R(U(V,"package.json"))?.version??"0.0.0"}async function e(z){let Z=await import(Q("lib/telemetry.ts"));if(z==="on"||z==="off"){Z.setTelemetryEnabled(z==="on"),console.log(`[beacon] telemetry ${z==="on"?"enabled":"disabled"}.`);return}if(z&&z!=="status")console.error("usage: beacon telemetry [on|off|status]"),process.exit(1);let X=Z.telemetryStatus(),J=X.reason==="env:BEACON_TELEMETRY_DISABLED"?" (BEACON_TELEMETRY_DISABLED=1)":X.reason==="env:DO_NOT_TRACK"?" (DO_NOT_TRACK)":X.reason==="preference"?" (beacon telemetry off)":"";if(console.log(`
-  \u25C9 Beacon telemetry: ${X.enabled?"enabled":"disabled"}${J}`),console.log(`  machine id: ${X.machineId??"(not generated yet \u2014 created on first `beacon` run)"}`),X.machineId)console.log(`  payload:    ${JSON.stringify(Z.heartbeatPayload(x()))}`);console.log(`  sent at most every 12h while the daemon runs \u2014 never repo names, paths, or code.
-`+"  toggle: `beacon telemetry on|off` \xB7 env: BEACON_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1\n")}async function zz(z){let Z=x(),{INSTALL_COMMAND:X,NPM_LATEST_URL:J}=await import(Q("lib/release.ts"));if(L()==="win32"){console.log(`[beacon] current version v${Z}.`),console.log(`[beacon] on Windows, update with your package manager:
-  npm i -g trybeacon@latest`);return}let K=null;try{let G=await fetch(J);if(G.ok)K=(await G.json()).version??null}catch{}if(K&&!z){let{isNewerVersion:G}=await import(Q("lib/semver.ts"));if(!G(K,Z)){console.log(`[beacon] already on the latest version (v${Z}).`),console.log("         run `beacon update --force` to reinstall anyway.");return}}console.log(K?`[beacon] updating Beacon v${Z} \u2192 v${K}\u2026`:`[beacon] reinstalling Beacon (current v${Z})\u2026`);try{_(X,{stdio:"inherit"})}catch{console.error(`[beacon] update failed. Run it manually:
-  ${X}`),process.exitCode=1;return}f(),console.log("[beacon] updated. Run `beacon` to relaunch on the new version.")}function f(){let z=R(A);if(z&&k(z.pid))try{try{process.kill(-z.pid)}catch{process.kill(z.pid)}console.log(`[beacon] stopped the server (pid ${z.pid}).`)}catch{console.log("[beacon] could not stop the server.")}else console.log("[beacon] no server running.")}
+  data:  ${V}
+  url:   ${M}
+`),console.log("  (the server keeps running in the background \u2014 `beacon stop` to stop it)\n"),await fetch(`${M}/api/tab/presence`,{headers:{"x-beacon-workspace":H}}).then((U)=>U.json()).then((U)=>!!U?.live).catch(()=>!1))await fetch(`${M}/api/tab/nav`,{method:"POST",headers:{"content-type":"application/json","x-beacon-workspace":H},body:JSON.stringify({path:E})}).catch(()=>{}),console.log(`  \u21BB reusing your open Beacon tab \u2014 switch to your browser.
+`);else r(m)}function D(){return C(B(F,"package.json"))?.version??"0.0.0"}async function zz(z){let X=await import(Q("lib/telemetry.ts"));if(z==="on"||z==="off"){X.setTelemetryEnabled(z==="on"),console.log(`[beacon] telemetry ${z==="on"?"enabled":"disabled"}.`);return}if(z&&z!=="status")console.error("usage: beacon telemetry [on|off|status]"),process.exit(1);let Z=X.telemetryStatus(),J=Z.reason==="env:BEACON_TELEMETRY_DISABLED"?" (BEACON_TELEMETRY_DISABLED=1)":Z.reason==="env:DO_NOT_TRACK"?" (DO_NOT_TRACK)":Z.reason==="preference"?" (beacon telemetry off)":"";if(console.log(`
+  \u25C9 Beacon telemetry: ${Z.enabled?"enabled":"disabled"}${J}`),console.log(`  machine id: ${Z.machineId??"(not generated yet \u2014 created on first `beacon` run)"}`),Z.machineId)console.log(`  payload:    ${JSON.stringify(X.heartbeatPayload(D()))}`);console.log(`  sent at most every 12h while the daemon runs \u2014 never repo names, paths, or code.
+`+"  toggle: `beacon telemetry on|off` \xB7 env: BEACON_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1\n")}async function Xz(z){let X=D(),{INSTALL_COMMAND:Z,NPM_LATEST_URL:J}=await import(Q("lib/release.ts"));if(T()==="win32"){console.log(`[beacon] current version v${X}.`),console.log(`[beacon] on Windows, update with your package manager:
+  npm i -g trybeacon@latest`);return}let K=null;try{let G=await fetch(J);if(G.ok)K=(await G.json()).version??null}catch{}if(K&&!z){let{isNewerVersion:G}=await import(Q("lib/semver.ts"));if(!G(K,X)){console.log(`[beacon] already on the latest version (v${X}).`),console.log("         run `beacon update --force` to reinstall anyway.");return}}console.log(K?`[beacon] updating Beacon v${X} \u2192 v${K}\u2026`:`[beacon] reinstalling Beacon (current v${X})\u2026`);try{_(Z,{stdio:"inherit"})}catch{console.error(`[beacon] update failed. Run it manually:
+  ${Z}`),process.exitCode=1;return}f(),console.log("[beacon] updated. Run `beacon` to relaunch on the new version.")}function f(){let z=C(A);if(z&&S(z.pid))try{try{process.kill(-z.pid)}catch{process.kill(z.pid)}console.log(`[beacon] stopped the server (pid ${z.pid}).`)}catch{console.log("[beacon] could not stop the server.")}else console.log("[beacon] no server running.")}

package/dist/bin/doctor.js

@@ -52,9 +52,17 @@ A single \`beacon_init_persist\` MCP tool call with:
 - 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.
+## If \`beacon_init_persist\` is NOT in your tools (or the call can't reach the daemon)
 
-After the tool returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
+That happens when this repo was never opened with \`beacon\`: there's no \`.mcp.json\`, so the Beacon MCP server isn't in this session \u2014 and MCP tools can't be added mid-session. (It also covers a wired repo whose daemon is down, so the tool call errors.) **Do NOT stop and tell the user to run \`beacon\` first.** /beacon-init bootstraps itself: write the EXACT analysis object you'd have passed to \`beacon_init_persist\` to a temp JSON file, then persist it through the CLI:
+
+\`\`\`bash
+beacon init-persist /tmp/beacon-init.json   # or: beacon init-persist < /tmp/beacon-init.json
+\`\`\`
+
+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.
 `,vQ=`---
 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.

package/dist/bin/hook.js

@@ -52,9 +52,17 @@ A single \`beacon_init_persist\` MCP tool call with:
 - 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.
+## If \`beacon_init_persist\` is NOT in your tools (or the call can't reach the daemon)
 
-After the tool returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
+That happens when this repo was never opened with \`beacon\`: there's no \`.mcp.json\`, so the Beacon MCP server isn't in this session \u2014 and MCP tools can't be added mid-session. (It also covers a wired repo whose daemon is down, so the tool call errors.) **Do NOT stop and tell the user to run \`beacon\` first.** /beacon-init bootstraps itself: write the EXACT analysis object you'd have passed to \`beacon_init_persist\` to a temp JSON file, then persist it through the CLI:
+
+\`\`\`bash
+beacon init-persist /tmp/beacon-init.json   # or: beacon init-persist < /tmp/beacon-init.json
+\`\`\`
+
+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.
 `,$Q=`---
 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.

package/dist/bin/mcp.js

@@ -52,9 +52,17 @@ A single \`beacon_init_persist\` MCP tool call with:
 - 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.
+## If \`beacon_init_persist\` is NOT in your tools (or the call can't reach the daemon)
 
-After the tool returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
+That happens when this repo was never opened with \`beacon\`: there's no \`.mcp.json\`, so the Beacon MCP server isn't in this session \u2014 and MCP tools can't be added mid-session. (It also covers a wired repo whose daemon is down, so the tool call errors.) **Do NOT stop and tell the user to run \`beacon\` first.** /beacon-init bootstraps itself: write the EXACT analysis object you'd have passed to \`beacon_init_persist\` to a temp JSON file, then persist it through the CLI:
+
+\`\`\`bash
+beacon init-persist /tmp/beacon-init.json   # or: beacon init-persist < /tmp/beacon-init.json
+\`\`\`
+
+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.
 `,a0=`---
 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.

package/dist/bin/plan.js

@@ -52,9 +52,17 @@ A single \`beacon_init_persist\` MCP tool call with:
 - 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.
+## If \`beacon_init_persist\` is NOT in your tools (or the call can't reach the daemon)
 
-After the tool returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
+That happens when this repo was never opened with \`beacon\`: there's no \`.mcp.json\`, so the Beacon MCP server isn't in this session \u2014 and MCP tools can't be added mid-session. (It also covers a wired repo whose daemon is down, so the tool call errors.) **Do NOT stop and tell the user to run \`beacon\` first.** /beacon-init bootstraps itself: write the EXACT analysis object you'd have passed to \`beacon_init_persist\` to a temp JSON file, then persist it through the CLI:
+
+\`\`\`bash
+beacon init-persist /tmp/beacon-init.json   # or: beacon init-persist < /tmp/beacon-init.json
+\`\`\`
+
+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.
 `,qQ=`---
 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.

package/dist/bin/uninstall.js

@@ -52,9 +52,17 @@ A single \`beacon_init_persist\` MCP tool call with:
 - 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.
+## If \`beacon_init_persist\` is NOT in your tools (or the call can't reach the daemon)
 
-After the tool returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
+That happens when this repo was never opened with \`beacon\`: there's no \`.mcp.json\`, so the Beacon MCP server isn't in this session \u2014 and MCP tools can't be added mid-session. (It also covers a wired repo whose daemon is down, so the tool call errors.) **Do NOT stop and tell the user to run \`beacon\` first.** /beacon-init bootstraps itself: write the EXACT analysis object you'd have passed to \`beacon_init_persist\` to a temp JSON file, then persist it through the CLI:
+
+\`\`\`bash
+beacon init-persist /tmp/beacon-init.json   # or: beacon init-persist < /tmp/beacon-init.json
+\`\`\`
+
+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.
 `,BQ=`---
 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.

package/dist/lib/assets.js

@@ -51,9 +51,17 @@ A single \`beacon_init_persist\` MCP tool call with:
 - 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.
+## If \`beacon_init_persist\` is NOT in your tools (or the call can't reach the daemon)
 
-After the tool returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
+That happens when this repo was never opened with \`beacon\`: there's no \`.mcp.json\`, so the Beacon MCP server isn't in this session \u2014 and MCP tools can't be added mid-session. (It also covers a wired repo whose daemon is down, so the tool call errors.) **Do NOT stop and tell the user to run \`beacon\` first.** /beacon-init bootstraps itself: write the EXACT analysis object you'd have passed to \`beacon_init_persist\` to a temp JSON file, then persist it through the CLI:
+
+\`\`\`bash
+beacon init-persist /tmp/beacon-init.json   # or: beacon init-persist < /tmp/beacon-init.json
+\`\`\`
+
+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.
 `,P=`---
 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.

package/dist/lib/codex-install.js

@@ -51,9 +51,17 @@ A single \`beacon_init_persist\` MCP tool call with:
 - 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.
+## If \`beacon_init_persist\` is NOT in your tools (or the call can't reach the daemon)
 
-After the tool returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
+That happens when this repo was never opened with \`beacon\`: there's no \`.mcp.json\`, so the Beacon MCP server isn't in this session \u2014 and MCP tools can't be added mid-session. (It also covers a wired repo whose daemon is down, so the tool call errors.) **Do NOT stop and tell the user to run \`beacon\` first.** /beacon-init bootstraps itself: write the EXACT analysis object you'd have passed to \`beacon_init_persist\` to a temp JSON file, then persist it through the CLI:
+
+\`\`\`bash
+beacon init-persist /tmp/beacon-init.json   # or: beacon init-persist < /tmp/beacon-init.json
+\`\`\`
+
+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.
 `,L=`---
 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.

package/dist/lib/global-install.js

@@ -51,9 +51,17 @@ A single \`beacon_init_persist\` MCP tool call with:
 - 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.
+## If \`beacon_init_persist\` is NOT in your tools (or the call can't reach the daemon)
 
-After the tool returns, tell the user the counts (components / roadmap / tables / endpoints) and point them at the running Beacon panel.
+That happens when this repo was never opened with \`beacon\`: there's no \`.mcp.json\`, so the Beacon MCP server isn't in this session \u2014 and MCP tools can't be added mid-session. (It also covers a wired repo whose daemon is down, so the tool call errors.) **Do NOT stop and tell the user to run \`beacon\` first.** /beacon-init bootstraps itself: write the EXACT analysis object you'd have passed to \`beacon_init_persist\` to a temp JSON file, then persist it through the CLI:
+
+\`\`\`bash
+beacon init-persist /tmp/beacon-init.json   # or: beacon init-persist < /tmp/beacon-init.json
+\`\`\`
+
+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.
 `,n=`---
 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.

package/package.json

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