@inkeep/open-knowledge 0.1.1 → 0.2.0

package/dist/cli.mjs

@@ -1,5 +1,13 @@
 #!/usr/bin/env node
-import{T as e,bt as t,d as n,et as r,g as i,it as a,nt as o,r as s,rt as c,tt as l,xt as u}from"./src-ZI61hw95.mjs";import{a as d,i as f,o as p}from"./constants-CTaXJDQW.mjs";import{n as m,t as h}from"./paths-CV2EYsvK.mjs";import{a as g,r as _}from"./init-CIcYCLDG.mjs";import{n as v}from"./colors-DUgdVug3.mjs";import{t as y}from"./is-object-Miw4czsU.mjs";import{t as b}from"./loader-DqbeQ0oE.mjs";import"./src-D1kuMCGT.mjs";import{Command as x}from"commander";import{closeSync as S,existsSync as C,mkdirSync as w,openSync as T,readFileSync as E,statSync as D,unlinkSync as O}from"node:fs";import{basename as k,isAbsolute as A,join as j,relative as M,resolve as N}from"node:path";import{hostname as ee}from"node:os";import{fileURLToPath as te}from"node:url";import{randomUUID as ne}from"node:crypto";import{readFile as re,readdir as ie,stat as ae}from"node:fs/promises";import oe from"simple-git";import se from"picomatch";import{createServer as ce,request as le}from"node:http";import{spawn as ue}from"node:child_process";import{McpServer as de}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as fe}from"@modelcontextprotocol/sdk/server/stdio.js";import{RootsListChangedNotificationSchema as pe}from"@modelcontextprotocol/sdk/types.js";import{z as P}from"zod";import{Bash as me,ReadWriteFs as he}from"just-bash";import ge from"shell-quote";import{parse as _e}from"yaml";function ve(e,t,n={}){let a=i(e,t);if(!C(a))return{status:`missing`,lockPath:a};let o;try{o=JSON.parse(E(a,`utf-8`))}catch{return{status:`corrupt`,lockPath:a}}if(!o||typeof o!=`object`||typeof o.pid!=`number`)return{status:`corrupt`,lockPath:a};let s=o,c=n.host??ee();return s.hostname===c?(n.isAlive??r)(s.pid)?{status:`alive`,lockPath:a,lock:s}:{status:`dead-pid`,lockPath:a,lock:s}:{status:`foreign-host`,lockPath:a,lock:s}}function ye(e,t){let n=[];for(let[r,i]of[[`server`,e],[`ui`,t]])(i.status===`dead-pid`||i.status===`corrupt`)&&n.push({name:r,lockPath:i.lockPath,reason:i.status});return{prune:n}}function be(e){let t=e.inspect??(t=>ve(e.lockDir,t)),n=e.unlink??(e=>O(e)),r=e.log??(e=>console.log(e)),i=e.error??(e=>console.error(e)),a=ye(t(`server`),t(`ui`));if(a.prune.length===0)return r(`No stale locks.`),{pruned:[],failed:[]};let o=[],s=[];for(let e of a.prune)try{n(e.lockPath),o.push(e)}catch(t){s.push({target:e,error:t instanceof Error?t.message:String(t)})}if(o.length>0){let e=o.map(e=>`${e.name} (${e.reason})`).join(`, `);r(`Pruned ${o.length} stale lock${o.length===1?``:`s`}: ${e}`)}return s.length>0&&i(`Failed to prune: ${s.map(({target:e,error:t})=>`${e.name} (${e.lockPath}): ${t}`).join(`; `)}`),{pruned:o,failed:s}}function xe(e){return new x(`clean`).description(`Prune stale / corrupt open-knowledge lock files (never touches live locks)`).action(()=>{be({lockDir:m(h(e(),process.cwd()))}).failed.length>0&&(process.exitCode=1)})}function F(e,t){return{content:[{type:`text`,text:e}],...t?{isError:!0}:{}}}function I(e,t,n){return{content:[{type:`text`,text:e}],structuredContent:t,...n?{isError:!0}:{}}}const L="Error: Hocuspocus server is not running. Start it with `open-knowledge start`, then retry.\nFor disk-only writes without real-time sync, use your native Edit tool directly.";async function R(e){return typeof e==`function`?await e():e}function z(e){let t=e.toLowerCase();return t.endsWith(`.md`)?{ok:!0,docName:e.slice(0,-3)}:t.endsWith(`.mdx`)?{ok:!0,docName:e.slice(0,-4)}:t.endsWith(`.markdown`)?{ok:!1,error:`Error: docName "${e}" ends in ".markdown", which is not a supported extension. Use ".md" or ".mdx", or strip the extension to let the server auto-detect.`}:{ok:!0,docName:e}}async function B(e,t){let n;try{n=await fetch(`${e}${t}`,{signal:AbortSignal.timeout(3e4)})}catch(e){return{ok:!1,error:`Server unreachable: ${e instanceof Error?e.message:e}`}}try{return await n.json()}catch{return{ok:!1,error:`Server returned HTTP ${n.status} with non-JSON body`}}}async function V(e,t,n){let r;try{r=await fetch(`${e}${t}`,{method:`POST`,headers:{"Content-Type":`application/json`},body:n?JSON.stringify(n):void 0,signal:AbortSignal.timeout(3e4)})}catch(e){return{ok:!1,error:`Server unreachable: ${e instanceof Error?e.message:e}`}}try{return await r.json()}catch{return{ok:!1,error:`Server returned HTTP ${r.status} with non-JSON body`}}}function Se(e,t){return`Promote existing research on this topic into a canonical article inside the project content directory. **Canonical, not provisional** — the output is the source of truth for future agents.
+import{Ct as e,H as t,U as n,V as r,W as i,Y as a,at as o,et as s,l as c,lt as l,wt as u}from"./src-EGbU552u.mjs";import{a as d,i as f,o as p}from"./constants-yNFhYMHH.mjs";import{n as m,t as h}from"./paths-C7TuvND0.mjs";import{o as g}from"./init-BzEVODBI.mjs";import{n as _}from"./colors-CshxhXdR.mjs";import{t as v}from"./is-object-WgQ3abDo.mjs";import{r as y}from"./init-BH38QtfV.mjs";import{o as b,s as x}from"./start-DqcFf-BT.mjs";import{t as S}from"./loader-CoGCjTcI.mjs";import"./src-B7snRveE.mjs";import{Command as C}from"commander";import{closeSync as w,existsSync as T,mkdirSync as E,openSync as D,readFileSync as O,readdirSync as ee,statSync as k,unlinkSync as A,writeFileSync as te}from"node:fs";import{homedir as ne,hostname as re}from"node:os";import{basename as ie,dirname as ae,isAbsolute as oe,join as se,relative as ce,resolve as j}from"node:path";import{parse as le,stringify as ue}from"yaml";import{createOAuthDeviceAuth as de}from"@octokit/auth-oauth-device";import fe from"@inquirer/password";import{Octokit as pe}from"@octokit/rest";import{fileURLToPath as me}from"node:url";import{randomUUID as he}from"node:crypto";import{execFileSync as ge,spawn as _e}from"node:child_process";import M from"simple-git";import{readFile as ve,readdir as ye,stat as be}from"node:fs/promises";import xe from"picomatch";import{createServer as Se,request as Ce}from"node:http";import{McpServer as we}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as Te}from"@modelcontextprotocol/sdk/server/stdio.js";import{RootsListChangedNotificationSchema as Ee}from"@modelcontextprotocol/sdk/types.js";import{z as N}from"zod";import{Bash as De,ReadWriteFs as Oe}from"just-bash";import ke from"shell-quote";const Ae=`open-knowledge`;var je=class{backend=`keyring`;async get(e){let{Entry:t}=await import(`@napi-rs/keyring`);try{let n=new t(Ae,e).getPassword();return n==null?null:JSON.parse(n)}catch{return null}}async set(e,t,n,r){let{Entry:i}=await import(`@napi-rs/keyring`),a=new i(Ae,e),o={login:t,token:n,...r};a.setPassword(JSON.stringify(o))}async clear(e){let{Entry:t}=await import(`@napi-rs/keyring`);try{new t(Ae,e).deletePassword()}catch{}}},Me=class{backend=`file`;authFile;constructor(e){this.authFile=e??se(ne(),`.open-knowledge`,`auth.yml`)}read(){if(!T(this.authFile))return{};try{return le(O(this.authFile,`utf-8`))??{}}catch(e){let t=e instanceof Error?e.message:`unknown error`;return process.stderr.write(`[auth] Failed to parse ${this.authFile}: ${t}. Starting with empty credentials.\n`),{}}}write(e){let t=ae(this.authFile);T(t)||E(t,{recursive:!0,mode:448}),te(this.authFile,ue(e),{mode:384})}async get(e){return this.read()[e]??null}async set(e,t,n,r){let i=this.read();i[e]={login:t,token:n,...r},this.write(i)}async clear(e){let t=this.read();delete t[e],this.write(t)}};async function Ne(e){try{let{Entry:e}=await import(`@napi-rs/keyring`);return new e(Ae,`__probe__`),process.stderr.write(`[auth] token storage: OS keychain
+`),new je}catch{return process.stderr.write(`[auth] token storage: file (~/.open-knowledge/auth.yml)
+`),new Me(e)}}async function Pe(e,t,n){let r=Fe(await Ie(e)).host??``;if(!r)return 1;let i=await n.get(r);if(i==null)return 1;let a=e=>e.replace(/[\r\n]/g,``);return t.write(`username=${a(i.login)}\npassword=${a(i.token)}\n`),0}function Fe(e){let t={};for(let n of e.split(`
+`)){let e=n.trim();if(e===``)continue;let r=e.indexOf(`=`);r!==-1&&(t[e.slice(0,r)]=e.slice(r+1))}return t}function Ie(e){return new Promise((t,n)=>{let r=[];e.on(`data`,e=>r.push(e)),e.on(`end`,()=>t(Buffer.concat(r).toString(`utf-8`))),e.on(`error`,n)})}function Le(e){let t=new C(`git-credential`);return t.description(`Git credential helper (git credential-helper protocol)`),t.command(`get`).description(`Lookup credentials from TokenStore (called by git)`).action(async()=>{let t=await e(),n=await Pe(process.stdin,process.stdout,t);process.exit(n)}),t}async function Re(e){let{clientId:t,scopes:n=[`repo`,`read:user`,`user:email`],onVerification:r,host:i}=e,a=i&&i!==`github.com`?`https://${i}/api/v3`:`https://api.github.com`,o=de({clientType:`oauth-app`,clientId:t,scopes:n,onVerification:async e=>{await r({verificationUri:e.verification_uri,userCode:e.user_code,expiresIn:e.expires_in,interval:e.interval})},request:a===`https://api.github.com`?void 0:(await import(`@octokit/request`)).request.defaults({baseUrl:a})}),s;try{s=await o({type:`oauth`})}catch(e){if(e instanceof Error){let t=e.message.toLowerCase();throw t.includes(`access_denied`)?Error(`Device-flow authorization was denied.`):t.includes(`expired_token`)||t.includes(`timeout`)||t.includes(`timed out`)?Error(`Device-flow code expired before authorization — please try again.`):Error(`GitHub sign-in failed: ${e.message}`)}throw e}return{token:s.token,tokenType:s.tokenType,scopes:s.scopes??[]}}function ze(e){return process.env.OPEN_KNOWLEDGE_GITHUB_CLIENT_ID??e?.github?.oauthAppClientId??`Ov23liqlSd0V1MwR6rhI`}const Be=new Set([`gitlab.com`,`bitbucket.org`,`codeberg.org`,`gitea.com`,`sr.ht`,`sourcehut.org`]);function Ve(e){let t=e.toLowerCase().replace(/:\d+$/,``);Be.has(t)&&(process.stderr.write(`Error: ${e} is not a GitHub host. Only GitHub and GitHub Enterprise Server are supported.\n`),process.exit(1))}function He(e,t){e&&process.stdout.write(`${JSON.stringify(t)}\n`)}async function Ue(e,t,n,r=Re){let i=ze(n),{host:a,json:o}=e;Ve(a),o||process.stderr.write(`Logging in to ${a}…\n`);let s=await r({clientId:i,host:a===`github.com`?void 0:a,onVerification:e=>{e.userCode,e.verificationUri,o?He(!0,{type:`verification`,user_code:e.userCode,verification_uri:e.verificationUri,expires_in:e.expiresIn}):process.stderr.write(`Open: ${e.verificationUri}\nEnter code: ${e.userCode}\n`)}}),c=`unknown`,l,u;try{let e=a===`github.com`?`https://api.github.com`:`https://${a}/api/v3`,t=await fetch(`${e}/user`,{headers:{Authorization:`Bearer ${s.token}`,"User-Agent":`open-knowledge-cli`,Accept:`application/vnd.github+json`}});if(t.ok){let e=await t.json();c=e.login??c,l=e.name??void 0,u=e.email??void 0}}catch{}await t.set(a,c,s.token,{gitProtocol:`https`,name:l,email:u}),o?He(!0,{type:`complete`,host:a,login:c}):process.stderr.write(`✓ Logged in as ${c} on ${a}\n`)}function We(e,t){return new C(`login`).description(`Authenticate with GitHub via Device Flow`).option(`--host <host>`,`GitHub or GitHub Enterprise hostname`,`github.com`).option(`--json`,`Output JSONL progress events`,!1).action(async n=>{await Ue(n,await t(),e())})}async function Ge(e,t,n){let{host:r,json:i}=e;Ve(r);let a=await(n??(()=>fe({message:`Enter PAT:`})))();a||(process.stderr.write(`No token provided
+`),process.exit(1));let o=r===`github.com`?void 0:`https://${r}/api/v3`,s=new pe({auth:a,...o?{baseUrl:o}:{}}),c=`unknown`,l,u;try{let{data:e}=await s.users.getAuthenticated();c=e.login,l=e.name??void 0,u=e.email??void 0}catch{process.stderr.write(`Token validation failed
+`),process.exit(1)}await t.set(r,c,a,{gitProtocol:`https`,name:l,email:u}),i?process.stdout.write(`${JSON.stringify({type:`complete`,host:r,login:c})}\n`):process.stderr.write(`✓ PAT stored for ${c} on ${r}\n`)}function Ke(e){return new C(`pat`).description(`Store a Personal Access Token`).option(`--host <host>`,`GitHub or GitHub Enterprise hostname`,`github.com`).option(`--json`,`Output JSON`,!1).action(async t=>{await Ge(t,await e())})}async function qe(e,t){let{host:n,json:r}=e;Ve(n);let i=await t.get(n);i??(process.stderr.write(`Not logged in to ${n}\n`),process.exit(1));let a=n===`github.com`?void 0:`https://${n}/api/v3`,o=new pe({auth:i.token,...a?{baseUrl:a}:{}}),s=[];for await(let e of o.paginate.iterator(o.repos.listForAuthenticatedUser,{per_page:100,sort:`updated`}))for(let t of e.data)s.push({full_name:t.full_name,clone_url:t.clone_url,private:t.private});if(r)process.stdout.write(`${JSON.stringify({type:`repos`,host:n,repos:s})}\n`);else for(let e of s)process.stdout.write(`${e.full_name}  ${e.clone_url}\n`)}function Je(e){return new C(`repos`).description(`List accessible repositories`).option(`--host <host>`,`GitHub or GitHub Enterprise hostname`,`github.com`).option(`--json`,`Output JSON`,!1).action(async t=>{await qe(t,await e())})}async function Ye(e,t){let{host:n}=e;await t.clear(n),process.stderr.write(`✓ Signed out from ${n}\n`)}function Xe(e){return new C(`signout`).description(`Remove stored credentials`).option(`--host <host>`,`GitHub hostname`,`github.com`).action(async t=>{await Ye(t,await e())})}async function Ze(e,t){let{host:n,json:r}=e;Ve(n);let i=await t.get(n);i??(r?process.stdout.write(`${JSON.stringify({type:`status`,host:n,authenticated:!1})}\n`):process.stderr.write(`Not logged in to ${n}\n`),process.exit(1));let a=n===`github.com`?void 0:`https://${n}/api/v3`,o=new pe({auth:i.token,...a?{baseUrl:a}:{}});try{let{data:e}=await o.users.getAuthenticated();r?process.stdout.write(`${JSON.stringify({type:`status`,host:n,authenticated:!0,login:e.login,name:e.name,email:e.email})}\n`):process.stderr.write(`✓ Logged in as ${e.login} on ${n}\n`)}catch{r?process.stdout.write(JSON.stringify({type:`status`,host:n,authenticated:!1,error:`token invalid`})+`
+`):process.stderr.write(`✗ Token invalid for ${n}\n`),process.exit(1)}}function Qe(e){return new C(`status`).description(`Show authentication status`).option(`--host <host>`,`GitHub or GitHub Enterprise hostname`,`github.com`).option(`--json`,`Output JSON`,!1).action(async t=>{await Ze(t,await e())})}function $e(e){let t=new C(`auth`);t.description(`GitHub authentication management`);let n=()=>Ne(),r=e??(()=>({}));return t.addCommand(We(r,n)),t.addCommand(Qe(n)),t.addCommand(Je(n)),t.addCommand(Xe(n)),t.addCommand(Ke(n)),t.addCommand(Le(n)),t}function et(e,t,n={}){let r=o(e,t);if(!T(r))return{status:`missing`,lockPath:r};let i;try{i=JSON.parse(O(r,`utf-8`))}catch{return{status:`corrupt`,lockPath:r}}if(!i||typeof i!=`object`||typeof i.pid!=`number`)return{status:`corrupt`,lockPath:r};let a=i,s=n.host??re();return a.hostname===s?(n.isAlive??l)(a.pid)?{status:`alive`,lockPath:r,lock:a}:{status:`dead-pid`,lockPath:r,lock:a}:{status:`foreign-host`,lockPath:r,lock:a}}function tt(e,t){let n=[];for(let[r,i]of[[`server`,e],[`ui`,t]])(i.status===`dead-pid`||i.status===`corrupt`)&&n.push({name:r,lockPath:i.lockPath,reason:i.status});return{prune:n}}function nt(e){let t=e.inspect??(t=>et(e.lockDir,t)),n=e.unlink??(e=>A(e)),r=e.log??(e=>console.log(e)),i=e.error??(e=>console.error(e)),a=tt(t(`server`),t(`ui`));if(a.prune.length===0)return r(`No stale locks.`),{pruned:[],failed:[]};let o=[],s=[];for(let e of a.prune)try{n(e.lockPath),o.push(e)}catch(t){s.push({target:e,error:t instanceof Error?t.message:String(t)})}if(o.length>0){let e=o.map(e=>`${e.name} (${e.reason})`).join(`, `);r(`Pruned ${o.length} stale lock${o.length===1?``:`s`}: ${e}`)}return s.length>0&&i(`Failed to prune: ${s.map(({target:e,error:t})=>`${e.name} (${e.lockPath}): ${t}`).join(`; `)}`),{pruned:o,failed:s}}function rt(e){return new C(`clean`).description(`Prune stale / corrupt open-knowledge lock files (never touches live locks)`).action(()=>{nt({lockDir:m(h(e(),process.cwd()))}).failed.length>0&&(process.exitCode=1)})}function it(){try{let e=ge(`gh`,[`auth`,`token`],{encoding:`utf-8`,stdio:[`ignore`,`pipe`,`pipe`],timeout:5e3}).trim();return e.length===0?{available:!1}:{available:!0,token:e}}catch{return{available:!1}}}async function at(e,t,n={},r=it){if(!n.skipGhDetect&&r().available)return{tier:`A`,credentialArgs:[`-c`,`credential.helper=!gh auth git-credential`]};let i=await t.get(e);return i==null?{tier:`none`,credentialArgs:[]}:{tier:i.gitProtocol===`ssh`?`C`:`B`,credentialArgs:[`-c`,`credential.helper=!open-knowledge auth git-credential`]}}function ot(e){return e.replace(/:\d+$/,``)}function st(e){let t=e.trim();if(!t)return null;{let e=/^https?:\/\/([^/?#]+)\/([\w.\-~%]+)\/([\w.\-~%]+?)(?:\.git)?\/?$/.exec(t);if(e)return{protocol:`https`,hostname:ot(e[1]),owner:e[2],name:e[3]}}{let e=/^ssh:\/\/(?:[\w.-]+@)?([^/?#]+)\/([\w.\-~%]+)\/([\w.\-~%]+?)(?:\.git)?\/?$/.exec(t);if(e)return{protocol:`ssh`,hostname:ot(e[1]),owner:e[2],name:e[3]}}{let e=/^git:\/\/([^/?#]+)\/([\w.\-~%]+)\/([\w.\-~%]+?)(?:\.git)?\/?$/.exec(t);if(e)return{protocol:`git`,hostname:ot(e[1]),owner:e[2],name:e[3]}}{let e=/^(?:[\w.-]+@)?([\w.-]+):([\w.\-~%]+)\/([\w.\-~%]+?)(?:\.git)?$/.exec(t);if(e?.[1].includes(`.`)||e&&t.startsWith(`git@`))return{protocol:`ssh`,hostname:e[1],owner:e[2],name:e[3]}}{let e=/^git:([\w.-]+)\/([\w.\-~%]+)\/([\w.\-~%]+?)(?:\.git)?\/?$/.exec(t);if(e)return{protocol:`git`,hostname:e[1],owner:e[2],name:e[3]}}if(!t.includes(`://`)&&!t.includes(`@`)&&!t.startsWith(`/`)){let e=/^([\w.-]+)\/([\w.\-~%]+?)(?:\.git)?$/.exec(t);if(e)return{protocol:`https`,hostname:`github.com`,owner:e[1],name:e[2]}}return null}const ct=[[`count`,0,10],[`compress`,10,20],[`receiv`,20,60],[`resolv`,60,100]];function lt(e){let t=/^([\w ]+):\s+(\d+)%/.exec(e.trim());if(!t)return null;let n=t[1].toLowerCase(),r=Number(t[2]);for(let[e,i,a]of ct)if(n.includes(e))return{stage:t[1],pct:Math.round(i+r/100*(a-i))};return null}function ut(e,t){e&&process.stdout.write(`${JSON.stringify(t)}\n`)}async function dt(e,t,n,r=process.cwd()){let i=st(e);if(!i)throw Error(`Invalid git URL: ${e}`);let a=t.dir?j(r,t.dir):j(r,i.name);if(T(a)&&ee(a).length>0)throw Error(`Target directory is not empty: ${a}`);let o=await Ne(),s=await at(i.hostname,o,{}),c=M({baseDir:r,config:s.credentialArgs.length>=2?[s.credentialArgs[1]]:[]}).env({GIT_TERMINAL_PROMPT:`0`}),l=-1;if(c.outputHandler((e,n,r)=>{r.on(`data`,e=>{let n=e.toString(`utf-8`);for(let e of n.split(`
+`)){let n=lt(e);n&&n.pct!==l&&(l=n.pct,ut(t.json,{type:`progress`,pct:n.pct,stage:n.stage}),t.json||process.stderr.write(`\r  Cloning… ${n.pct}%`))}})}),await c.clone(e,a,[`--progress`]),t.json||process.stderr.write(`
+`),!T(j(a,`.open-knowledge`)))try{let[{runInit:e},{ensureOkGitignoredAtRoot:t}]=await Promise.all([import(`./init-BFZ4vnnX.mjs`),import(`./init-DCZhpKSO.mjs`)]);e({cwd:a,mcp:!1});try{t(a)}catch{}}catch{}return a}function ft(e){return new C(`clone`).description(`Clone a git repository and open it`).argument(`<url>`,`Repository URL or owner/repo shorthand`).argument(`[dir]`,`Target directory (default: ./<repo-name>)`).option(`--json`,`Output JSONL progress events`,!1).action(async(t,n,r)=>{let i=e();try{let a=await dt(t,{json:r.json,dir:n},i);if(r.json)ut(!0,{type:`complete`,dir:a});else{process.stderr.write(`✓ Cloned to ${a}\n`),process.chdir(a);let{startCommand:t}=await import(`./start-BYXBgVJW.mjs`);await t(e).parseAsync([],{from:`user`})}}catch(e){let t=e instanceof Error?e.message:String(e);r.json?ut(!0,{type:`error`,message:t}):process.stderr.write(`✗ ${t}\n`),process.exitCode=1}})}function P(e,t){return{content:[{type:`text`,text:e}],...t?{isError:!0}:{}}}function F(e,t,n){return{content:[{type:`text`,text:e}],structuredContent:t,...n?{isError:!0}:{}}}const I="Error: Hocuspocus server is not running. Start it with `open-knowledge start`, then retry.\nFor disk-only writes without real-time sync, use your native Edit tool directly.";async function L(e){return typeof e==`function`?await e():e}function R(e){let t=e.toLowerCase();return t.endsWith(`.md`)?{ok:!0,docName:e.slice(0,-3)}:t.endsWith(`.mdx`)?{ok:!0,docName:e.slice(0,-4)}:t.endsWith(`.markdown`)?{ok:!1,error:`Error: docName "${e}" ends in ".markdown", which is not a supported extension. Use ".md" or ".mdx", or strip the extension to let the server auto-detect.`}:{ok:!0,docName:e}}async function z(e,t){let n;try{n=await fetch(`${e}${t}`,{signal:AbortSignal.timeout(3e4)})}catch(e){return{ok:!1,error:`Server unreachable: ${e instanceof Error?e.message:e}`}}try{return await n.json()}catch{return{ok:!1,error:`Server returned HTTP ${n.status} with non-JSON body`}}}async function B(e,t,n){let r;try{r=await fetch(`${e}${t}`,{method:`POST`,headers:{"Content-Type":`application/json`},body:n?JSON.stringify(n):void 0,signal:AbortSignal.timeout(3e4)})}catch(e){return{ok:!1,error:`Server unreachable: ${e instanceof Error?e.message:e}`}}try{return await r.json()}catch{return{ok:!1,error:`Server returned HTTP ${r.status} with non-JSON body`}}}function pt(e,t){return`Promote existing research on this topic into a canonical article inside the project content directory. **Canonical, not provisional** — the output is the source of truth for future agents.
 
 Topic: ${e}
 
@@ -141,29 +149,29 @@ superseded_by: <path-to-new-canonical-article>.md
 - **Don't rewrite research prose verbatim** — canonical articles have a different voice (direct, decided) than research (exploratory, provisional)
 - **Don't skip the supersedes / superseded_by links** — the audit trail matters for future readers
 
-Full convention: read \`${d}/AGENTS.md\`.`}const Ce=[`Promote research into a canonical article inside the project content directory. Canonical, not provisional — the output is the source of truth for future agents.`,``,`**Use when:**`,`- A team has made a decision after research and wants the outcome committed as canonical knowledge`,`- Compacting several provisional research notes into one authoritative article`,`- A developer asks to "consolidate" or "finalize" knowledge on a topic`,``,`**Triggers on:**`,`- "consolidate", "finalize", "promote to canonical", "make this official"`,`- User says the team has decided and wants the outcome written as canonical`,`- Research has stabilized and a destination article is needed`].join(`
-`);function we(e,t){e.tool(`consolidate`,Ce,{topic:P.string().describe(`The topic to consolidate into a canonical article`)},e=>I(Se(e.topic,t.content.dir),{previewUrl:null}))}function Te(e){return e.split(`/`).map(encodeURIComponent).join(`/`)}function Ee(e){return e.endsWith(`/`)?e.slice(0,-1):e}function De(e){try{return new URL(e),!0}catch{return!1}}async function H(e,t){let n=await t.resolveCwd(),r=m(h(t.config,n));return W(e,{config:t.config,lockDir:r})}function Oe(e){try{let t=s(e.lockDir);if(t&&t.port>0)return{baseUrl:`http://localhost:${t.port}`,port:t.port}}catch(t){process.stderr.write(`[preview-url] readUiLock failed at ${e.lockDir} while building ui block: ${t instanceof Error?t.message:String(t)}\n`)}return{baseUrl:null,port:null}}async function U(e){let t=await e.resolveCwd(),n=m(h(e.config,t)),r={config:e.config,lockDir:n};return{resolve:e=>W(e,r),ui:Oe(r)}}function ke(e){let t=e.toLowerCase();return t.endsWith(`.md`)?e.slice(0,-3):t.endsWith(`.mdx`)?e.slice(0,-4):e}function W(e,t){let n=`/#/${Te(e)}`,r=process.env.OPEN_KNOWLEDGE_PREVIEW_BASE_URL;if(r&&De(r))return{url:`${Ee(r)}${n}`,source:`env`};try{let e=s(t.lockDir);if(e&&e.port>0)return{url:`http://localhost:${e.port}${n}`,source:`lock`}}catch(e){process.stderr.write(`[preview-url] readUiLock failed at ${t.lockDir}, falling through to config: ${e instanceof Error?e.message:String(e)}\n`)}let i=t.config.preview?.baseUrl;return i&&De(i)?{url:`${Ee(i)}${n}`,source:`config`}:null}const Ae=["**IMPORTANT: Before calling this tool, you MUST first call `get_preview_url` and navigate to the returned URL in your preview browser. If `get_preview_url` returns null, start the server first (`open-knowledge start` or `preview_start`), then call `get_preview_url` again. Do NOT call this tool without the preview open. NEVER manually construct the URL.**",``,`[Requires: Hocuspocus server] Find-and-replace on a live document via the CRDT layer.`,`The patch is applied through Hocuspocus and propagated to all connected editors in real-time.`,"Use `offset` when you need to patch an exact occurrence; omit it to preserve first-match behavior.",``,"**When rewriting prose, add `[[wiki-links]]` aggressively.** If the replacement mentions other documents or entities that should have their own page, link them as `[[Page Name]]`. Over-linking is the goal; underlinked documents lose their value in backlink-driven navigation.",``,`**Parameters:**`,"- `docName` — Document name, typically without extension. A trailing `.md` or `.mdx` is stripped automatically.","- `find` — Text to find (exact match)","- `replace` — Replacement text","- `offset` (optional) — Exact occurrence to patch, as a JavaScript string offset in the current markdown. If the document changed and the text no longer matches there, the server returns a stale-target error; re-run `suggest_links` to get fresh offsets."].join(`
-`);function je(e,t){e.tool(`edit_document`,Ae,{docName:P.string().describe(`Document name to edit`),find:P.string().describe(`Text to find (exact match)`),replace:P.string().describe(`Replacement text`),offset:P.number().int().min(0).optional().describe(`Exact occurrence to patch, as a JavaScript string offset in the current markdown`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=z(e.docName);if(!r.ok)return F(r.error,!0);let i=t.identityRef?.current,a=await V(n,`/api/agent-patch`,{docName:r.docName,find:e.find,replace:e.replace,offset:e.offset,...i?{agentId:i.connectionId,agentName:i.displayName,clientName:i.clientInfo?.name,colorSeed:i.colorSeed}:{}});if(!a.ok)return F(`Error: ${a.error}`,!0);let o=await t.resolveCwd(),s=m(h(t.config,o)),c=W(r.docName,{config:t.config,lockDir:s}),l=(typeof a.subscriberCount==`number`?a.subscriberCount:void 0)===0,u=[`Edit applied successfully.`];c&&u.push(`Preview: ${c.url}`),l&&u.push(c?`Warning: no preview is currently attached to "${r.docName}". Open ${c.url} to watch future edits live.`:`Warning: no preview is currently attached to "${r.docName}".`);let d=u.join(`
-`);if(!c&&!l)return F(d);let f={};return c&&(f.previewUrl=c.url,f.previewUrlSource=c.source),l&&(f.warning={message:`No preview attached to ${r.docName}.`,previewUrl:c?.url??null}),I(d,f)})}const Me=new Set([`cat`,`ls`,`grep`,`find`]),Ne=/\b[\w./-]+\.(md|mdx)\b/g;function G(e){return/\.(md|mdx)$/.test(e)}function K(e){let t=e.trim();return t?(t=t.replace(/\/+/g,`/`),t.startsWith(`./`)&&(t=t.slice(2)),t.endsWith(`/`)&&(t=t.slice(0,-1)),t):``}function q(e){return e.args.slice(1)}function J(e){return e.filter(e=>!e.startsWith(`-`))}function Pe(e){return J(q(e)).filter(G)}function Fe(e,t){let n=J(q(t)),r=n.length>0?n[n.length-1]:``,i=r&&r!==`.`?K(r):``,a=[];i&&a.push(i);for(let t of e.split(`
-`)){let e=t.trim();if(!e||/\.[a-z0-9]+$/i.test(e)&&!G(e))continue;let n=i?`${i}/${e}`:e;a.push(n)}return a}function Ie(e){let t=[];for(let n of e.split(`
-`)){if(!n)continue;let e=n.indexOf(`:`);if(e<0)continue;let r=K(n.slice(0,e));G(r)&&t.push(r)}return t}function Le(e){let t=[];for(let n of e.split(`
-`)){let e=K(n);e&&G(e)&&t.push(e)}return t}function Re(e){return J(q(e)).filter(G)}function ze(e){return J(q(e)).length>0}function Be(e){let t=[],n=e.matchAll(Ne);for(let e of n)t.push(K(e[0]));return t}function Ve(e,t){let n=null;for(let e=t.length-1;e>=0;e--){let r=t[e];if(Me.has(r.command)){n=r;break}if((r.command===`head`||r.command===`tail`)&&ze(r)){n=r;break}}let r;if(!n)r=Be(e);else{switch(n.command){case`cat`:r=Pe(n);break;case`ls`:r=Fe(e,n);break;case`grep`:r=Ie(e);break;case`find`:r=Le(e);break;case`head`:case`tail`:r=Re(n);break;default:r=Be(e)}r.length===0&&(r=Be(e))}let i=new Set,a=[];for(let e of r){let t=K(e);!t||i.has(t)||(i.add(t),a.push(t))}return a}function Y(e){return e===``?`''`:/^[\w.\-/]+$/.test(e)?e:`'${e.replace(/'/g,`'\\''`)}'`}const He=16*1024*1024;var Ue=class extends Error{limitBytes;actualBytes;partial;constructor(e,t,n){super(`Output exceeded ${e} byte buffer (got ${t}); narrow the command`),this.name=`StdoutOverflowError`,this.limitBytes=e,this.actualBytes=t,this.partial=n}};function We(e){if(!A(e))throw Error(`createBashInstance: cwd must be absolute (got: ${e})`);return new me({cwd:`/`,fs:new he({root:N(e),allowSymlinks:!1})})}async function Ge(e,t){let n=await e.exec(t);if(n.stdout.length>He)throw new Ue(He,n.stdout.length,{stdout:n.stdout.slice(0,He),stderr:n.stderr,exitCode:n.exitCode});return{stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode}}function Ke(e){return e.startsWith(`**/`)?e.slice(3):e}async function qe(e,t,n={}){let r=We(t),i=[`-rn`,`-F`];(n.caseInsensitive??!0)&&i.push(`-i`);for(let e of n.include??[])i.push(`--include=${Y(Ke(e))}`);for(let e of n.exclude??[])i.push(`--exclude=${Y(Ke(e))}`),i.push(`--exclude-dir=${Y(Ke(e))}`);let a=n.paths?.length?n.paths.map(Y):[`.`],o=`grep ${i.join(` `)} ${Y(e)} ${a.join(` `)}`,s;try{s=await Ge(r,o)}catch(e){if(e instanceof Ue)s=e.partial;else throw e}if(s.exitCode===1&&!s.stdout)return[];if(s.exitCode!==0&&s.exitCode!==1&&!s.stdout)throw Error(`grep exited ${s.exitCode}: ${s.stderr}`);let c=[],l=n.maxResults??1/0;for(let e of s.stdout.split(`
-`)){if(!e)continue;if(c.length>=l)break;let t=e.indexOf(`:`);if(t===-1)continue;let n=e.indexOf(`:`,t+1);if(n===-1)continue;let r=e.slice(0,t),i=e.slice(t+1,n),a=e.slice(n+1),o=Number.parseInt(i,10);Number.isFinite(o)&&c.push({path:r,line:o,text:a})}return c}const Je=new Set([`.git`,d,`.openknowledge`,`node_modules`,`.changeset`,`.claude`,`.agents`,`dist`,`build`]);async function Ye(e){let t=N(e),n=new Map,r=0,i=!1;async function a(e){if(i)return;let o;try{o=await ie(e,{withFileTypes:!0})}catch{return}for(let s of o){if(i)return;if(s.isDirectory()&&Je.has(s.name))continue;let o=N(e,s.name);if(s.isDirectory()){await a(o);continue}if(s.isFile()){if(r>=1e3){i=!0;return}try{let e=await ae(o);n.set(M(t,o),e.mtimeMs),r++}catch{}}}}return await a(t),{snapshot:n,truncated:i}}function Xe(e,t){let n=[];for(let[r,i]of t){let t=e.get(r);(t===void 0||t!==i)&&n.push(r)}for(let[r]of e)t.has(r)||n.push(r);return{changed:n}}const Ze=[`node_modules`,`.git`,`dist`,`build`,`.next`,`.turbo`,`.nuxt`,`coverage`,`.cache`,`.parcel-cache`,`.vercel`,d,`.claude`];function Qe(e){return e===`--recursive`||e===`--dereference-recursive`?!0:e.startsWith(`--`)||!e.startsWith(`-`)?!1:/[rR]/.test(e.slice(1))}const $e=[{command:`grep`,applies:e=>e.slice(1).some(Qe),hasUserExcludes:e=>e.some(e=>e===`--exclude-dir`||e.startsWith(`--exclude-dir=`)),buildExcludeArgs:e=>e.map(e=>`--exclude-dir=${e}`),insertionIndex:()=>1},{command:`find`,applies:()=>!0,hasUserExcludes:e=>e.slice(1).some(e=>e===`-not`||e===`!`||e===`-prune`),buildExcludeArgs:e=>{let t=[];for(let n of e)t.push(`-not`,`-path`,`*/${n}/*`);return t},insertionIndex:e=>{for(let t=1;t<e.length;t++)if(e[t].startsWith(`-`))return t;return e.length}}];function et(e){return e.map(e=>{let t=$e.find(t=>t.command===e.command);if(!t||!t.applies(e.args)||t.hasUserExcludes(e.args))return e;let n=t.buildExcludeArgs(Ze),r=t.insertionIndex(e.args);return{command:e.command,args:[...e.args.slice(0,r),...n,...e.args.slice(r)]}})}function tt(e){return e.map(e=>e.args.map(Y).join(` `)).join(` | `)}const nt=new Set([`cat`,`ls`,`grep`,`find`,`head`,`tail`,`wc`,`sort`,`uniq`,`cut`]),rt=new Set([`>`,`>>`,`<`,`>&`,`<&`,`|&`]),it=new Set([`&`,`;`,`;;`,`&&`,`||`,`(`,`)`,`<(`,`>(`,`<<`,`<<-`]),at=new Set([`-o`,`--output-file`,`--output`]),ot=[`-o=`,`--output-file=`,`--output=`],st=new Set([`-exec`,`-execdir`,`-delete`,`-fprint`,`-fprintf`,`-fprint0`,`-ok`,`-okdir`]),ct=/[`]|\$\(|\$\{|\$'/;function lt(e){return typeof e==`object`&&!!e&&`op`in e}function ut(e){let t=typeof e.op==`string`?e.op:`(unknown)`;return rt.has(t)?{category:`write_blocked`,message:`Write operation blocked: '${t}'. exec is read-only. For document changes, use write_document or edit_document.`}:it.has(t)?{category:`shell_construct_blocked`,message:`Shell construct '${t}' is not supported. Only pipes (|) are allowed between allowlisted stages.`}:{category:`shell_construct_blocked`,message:`Operator '${t}' is not supported.`}}function dt(e){let t=[];for(let n of e){if(typeof n==`string`){if(ct.test(n))return{error:{category:`shell_construct_blocked`,message:`Argument '${n}' contains a shell-injection pattern (backtick, $(), or \${}); not supported.`}};t.push(n);continue}if(!lt(n))return{error:{category:`shell_construct_blocked`,message:`Unrecognized token shape.`}};if(n.op===`glob`&&typeof n.pattern==`string`){t.push(n.pattern);continue}return typeof n.comment==`string`?{error:{category:`shell_construct_blocked`,message:`Comments are not allowed in exec commands.`}}:{error:ut(n)}}return{args:t}}function ft(e){if(!nt.has(e.command))return{category:`unknown_command`,message:`Command '${e.command}' is not in the allowlist. For pattern matching try 'grep'; for file listing try 'ls' or 'find'. Allowlist: cat, ls, grep, find, head, tail, wc, sort, uniq, cut.`};for(let t of e.args.slice(1)){if(at.has(t)||ot.some(e=>t.startsWith(e)))return{category:`write_blocked`,message:`Write operation blocked: '${t}'. exec is read-only. For document changes, use write_document or edit_document.`};if(e.command===`find`&&st.has(t))return{category:`write_blocked`,message:`find flag '${t}' is blocked (executes commands or deletes files). Use exec for read-only discovery; chain with another allowlisted tool via '|' if you need to transform output.`}}return null}function pt(e){let t=e.trim();if(!t)return{error:{category:`unknown_command`,message:`Empty command.`}};let n;try{n=ge.parse(t)}catch{return{error:{category:`shell_construct_blocked`,message:`Failed to parse command — likely malformed quoting or an unsupported construct.`}}}let r=[],i=[];for(let e of n){if(lt(e)&&e.op===`|`){r.push(i),i=[];continue}i.push(e)}r.push(i);let a=[];for(let e of r){let t=dt(e);if(`error`in t)return t;if(t.args.length===0)return{error:{category:`shell_construct_blocked`,message:`Empty pipeline stage (trailing pipe or leading pipe).`}};let n={command:t.args[0],args:t.args},r=ft(n);if(r)return{error:r};a.push(n)}return{stages:a}}const mt=/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/;function ht(e,t){let n=e.match(mt);if(!n)return null;try{let e=_e(n[1]);if(y(e)){if(t){let n=t.safeParse(e);return n.success?n.data:null}return e}}catch{}return null}const gt=new WeakMap;function _t(e){let t=gt.get(e);if(t)return t;let n=e.map(e=>se(e.match,{dot:!0}));return gt.set(e,n),n}function vt(e,t){if(e.length===0)return{};let n=_t(e),r={},i=[],a=!1;for(let o=0;o<e.length;o++){if(!n[o](t))continue;a=!0;let s=e[o].frontmatter;if(s.title!==void 0&&(r.title=s.title),s.description!==void 0&&(r.description=s.description),s.tags!==void 0)for(let e of s.tags)i.includes(e)||i.push(e)}return a?(i.length>0&&(r.tags=i),r):{}}function yt(e){try{return D(N(e,`.git`)).isDirectory()}catch{return!1}}function bt(e){return oe({baseDir:N(e),timeout:{block:5e3}})}async function xt(e,t,n=5){if(!yt(e))return{commits:[],source:`git-absent`};let r=bt(e),i=``;try{i=await r.raw(`log`,`-${Math.max(1,n)}`,`--format=%H|%aI|%an|%s`,`--follow`,`--`,t)}catch{return{commits:[],source:`git`}}let a=[];for(let e of i.split(`
-`)){if(!e)continue;let t=e.indexOf(`|`);if(t<0)continue;let n=e.indexOf(`|`,t+1);if(n<0)continue;let r=e.indexOf(`|`,n+1);r<0||a.push({hash:e.slice(0,t),date:e.slice(t+1,n),authorName:e.slice(n+1,r),subject:e.slice(r+1)})}return{commits:a,source:`git`}}const St=5e3;async function Ct(e){try{let t=(await oe({baseDir:e,timeout:{block:St}}).revparse([`--abbrev-ref`,`HEAD`])).trim();return t&&t!==`HEAD`?t:null}catch{return null}}function wt(e,t){return oe({baseDir:t,timeout:{block:St}}).env({GIT_DIR:e,GIT_WORK_TREE:t})}function Tt(e,t){let n=o(t);return e.startsWith(n)?e.slice(n.length):e}async function Et(e,t,n,r,i){let o=``;try{o=await e.raw(`log`,t,`-${Math.max(1,i*2)}`,`--format=%H%x00%aI%x00%an%x00%s%x00%B%x1e`,`--`,n)}catch{return[]}let s=Tt(t,r),l=a(s),u=[];for(let e of o.split(``)){let t=e.trimStart();if(!t)continue;let[n=``,i=``,a=``,o=``,d=``]=t.split(`\0`),f=n.trim();f.length===40&&u.push({hash:f,date:i,writerName:a,message:o,contributors:c(d),writerId:s,isAgent:l.isAgent,writerClassification:l.classification,branch:r})}return u}async function Dt(e,t,n=5){let r=l(e);if(!r)return{commits:[],source:`shadow-repo-absent`};let i=await Ct(e);if(!i)return{commits:[],source:`shadow-repo`};let a=wt(r,N(e)),s=``;try{s=await a.raw(`for-each-ref`,o(i),`--format=%(refname)`)}catch{return{commits:[],source:`shadow-repo`}}let c=s.split(`
-`).map(e=>e.trim()).filter(Boolean);return c.length===0?{commits:[],source:`shadow-repo`}:{commits:(await Promise.all(c.map(e=>Et(a,e,t,i,n)))).flat().sort((e,t)=>t.date.localeCompare(e.date)).slice(0,n),source:`shadow-repo`}}const Ot=1e3,kt=new Set([`.git`,d,`.openknowledge`,`node_modules`,`.changeset`,`.claude`,`.agents`,`dist`,`build`]),At=/\.(md|mdx)$/i,jt=P.object({title:P.string().optional(),description:P.string().optional(),tags:P.array(P.string()).default([])});function Mt(e){return e.replace(/\.md$/,``).replace(/\.mdx$/,``)}async function Nt(e){try{let t=ht(await re(e,`utf-8`),jt);return t?{title:t.title,description:t.description,tags:t.tags??[]}:{tags:[]}}catch{return null}}async function Pt(e,t){if(!e)return null;let n=await B(e,`/api/backlinks?docName=${encodeURIComponent(t)}`);if(!n.ok)return null;let r=n.backlinks??n.results??n.links;if(!Array.isArray(r))return[];let i=[];for(let e of r){if(typeof e!=`object`||!e)continue;let t=e,n=typeof t.docName==`string`?t.docName:typeof t.source==`string`?t.source:typeof t.page==`string`?t.page:void 0;n&&i.push({source:n,title:typeof t.title==`string`?t.title:void 0,snippet:typeof t.snippet==`string`?t.snippet:null})}return i}async function Ft(e,t){if(!e||t.length===0)return null;let n=[...new Set(t)],r=[];for(let e=0;e<n.length;e+=100)r.push(n.slice(e,e+100));let i=await Promise.all(r.map(async t=>{let n=await B(e,`/api/backlink-counts?docNames=${encodeURIComponent(t.join(`,`))}`);return n.ok?n.counts??{}:null})),a=new Map,o=!1;for(let e of i)if(e){o=!0;for(let[t,n]of Object.entries(e))typeof n==`number`&&Number.isFinite(n)&&a.set(t,n)}return o?a:null}async function It(e,t){if(!e)return null;let n=await B(e,`/api/forward-links?docName=${encodeURIComponent(t)}`);if(!n.ok)return null;let r=n.forwardLinks??n.links??n.results;if(!Array.isArray(r))return[];let i=[];for(let e of r){if(typeof e!=`object`||!e)continue;let t=e;if(t.kind===`external`&&typeof t.url==`string`){i.push({kind:`external`,url:t.url,title:typeof t.title==`string`?t.title:void 0,snippet:typeof t.snippet==`string`?t.snippet:null});continue}let n=typeof t.docName==`string`?t.docName:void 0;n&&i.push({kind:`doc`,docName:n,title:typeof t.title==`string`?t.title:void 0,snippet:typeof t.snippet==`string`?t.snippet:null})}return i}function Lt(e,t,n){let r=t??[],i=r.length===0?{}:vt(r,n),a=e?.title??i.title,o=e?.description??i.description,s=e?.tags??[],c=i.tags??[],l;if(c.length===0)l=s;else{let e=new Set;l=[];for(let t of c)e.has(t)||(e.add(t),l.push(t));for(let t of s)e.has(t)||(e.add(t),l.push(t))}return{title:a,description:o,tags:l}}async function Rt(e,t,n={}){let r=e.replace(/^\.\//,``).replace(/^\/+/,``),i=N(t.projectDir,r),a=t.historyDepth??5,o=n.includeRichFields===!0,s=Nt(i);if(!o){let e=Lt(await s,t.folderRules,r);return{path:r,title:e.title,description:e.description,tags:e.tags,backlinkCount:null,backlinks:null,forwardLinkCount:null,forwardLinks:null,history:null,historySource:null,projectHistory:null,projectHistorySource:null}}let[c,l,u,d,f]=await Promise.all([s,Pt(t.serverUrl,Mt(r)).catch(()=>null),It(t.serverUrl,Mt(r)).catch(()=>null),Dt(t.projectDir,r,a).catch(()=>({commits:[],source:`shadow-repo`})),xt(t.projectDir,r,a).catch(()=>({commits:[],source:`git`}))]),p=Lt(c,t.folderRules,r);return{path:r,title:p.title,description:p.description,tags:p.tags,backlinkCount:l?.length??null,backlinks:l,forwardLinkCount:u?.length??null,forwardLinks:u,history:d.commits,historySource:d.source,projectHistory:f.commits,projectHistorySource:f.source}}async function zt(e,t){let n={directMdCount:0,recursiveMdCount:0,childDirCount:0,mostRecent:null,truncated:!1},r=0,i=[{path:e,depth:0}];for(;i.length>0;){let e=i.shift();if(!e)break;if(r>=Ot){n.truncated=!0;break}let a;try{a=await ie(e.path,{withFileTypes:!0})}catch{continue}for(let o of a){if(r>=Ot){n.truncated=!0;break}r++;let a=o.name;if(o.isDirectory()){if(kt.has(a)||a.startsWith(`.`))continue;e.depth===0&&n.childDirCount++,i.push({path:`${e.path}/${a}`,depth:e.depth+1})}else if(o.isFile()&&At.test(a)){n.recursiveMdCount++,e.depth===0&&n.directMdCount++;let r=`${e.path}/${a}`;try{let e=await ae(r);(!n.mostRecent||e.mtimeMs>n.mostRecent.mtimeMs)&&(n.mostRecent={absPath:r,relPath:M(t,r).split(/[\\/]/).filter(Boolean).join(`/`),mtimeMs:e.mtimeMs})}catch{}}}}return n}async function Bt(e,t){let n=e.replace(/^\.\//,``).replace(/^\/+/,``).replace(/\/+$/,``),r=await zt(N(t.projectDir,n),t.projectDir),i;if(r.mostRecent){let e=await Nt(r.mostRecent.absPath);i={path:r.mostRecent.relPath,title:e?.title??k(r.mostRecent.relPath),updatedAt:new Date(r.mostRecent.mtimeMs).toISOString()}}let a={path:n,type:`directory`,directMdCount:r.directMdCount,recursiveMdCount:r.recursiveMdCount,childDirCount:r.childDirCount,mostRecentMd:i,truncated:r.truncated},o=t.folderRules??[];if(o.length>0){let e=vt(o,n);e.title!==void 0&&(a.title=e.title),e.description!==void 0&&(a.description=e.description),e.tags!==void 0&&e.tags.length>0&&(a.tags=e.tags)}return a}const Vt=50*1024,Ht=/\.(png|jpe?g|gif|webp|svg|pdf|zip|tar|gz|tgz|mp4|mov|mp3|wav|ico|bmp)$/i,Ut=[`Run a read-only bash-like command against the project content directory. Returns raw stdout plus enriched metadata for every wiki file referenced (frontmatter, backlink/forward-link counts, shadow-repo activity with agent/human attribution).`,``,`Allowlist: cat, ls, grep, find, head, tail, wc, sort, uniq, cut. Pipes (|) work between stages. Redirections, subshells, and writes are rejected.`,``,"cwd: the command runs in the MCP client's first advertised root (the project the user is working in). Pass an explicit absolute `cwd` to run against a different directory. Paths inside the command resolve relative to that cwd; traversal above it is rejected.",``,"Stdout provenance headers (GNU-style): `ls <dir>/` prepends `<dir>/:`, single-file `cat`/`head`/`tail` prepends `==> <path> <==`, so the subject of the command is visible in raw output. Multi-file `cat a b` emits no header — the `enrichedPaths` array still lists every file. `head`/`tail` used as pipe trimmers (no file arg) defer to the upstream producer.",``,`Examples:`,'- `exec({ command: "cat articles/auth.md" })` — file contents + full enrichment','- `exec({ command: "ls articles/" })` — listing + per-file enrichment (slim)','- `exec({ command: "grep -rn oauth articles/ | head -5" })` — pipe with enrichment on matched files','- `exec({ command: "ls", cwd: "/abs/path/to/other-repo" })` — run in a different project'].join(`
-`);function Wt(e){let t=e.split(`
-`),n=t[t.length-1]===``?t.length-1:t.length;if(n<=500&&e.length<=Vt)return{text:e,truncated:!1,omittedLines:0};let r=Math.min(n,500),i=0,a=0;for(let e=0;e<r;e++){let n=t[e];if(i+=n.length+1,i>Vt)break;a++}let o=t.slice(0,a).join(`
-`),s=n-a;return{text:`${o}\n<truncated: ${s} more lines — re-run with a more-specific query>`,truncated:!0,omittedLines:s}}function Gt(e){let t=[];for(let n of e)if(n.command===`cat`)for(let e of n.args.slice(1))e.startsWith(`-`)||Ht.test(e)&&t.push(e);return t}function Kt(e){for(let t=1;t<e.length;t++){let n=e[t],r=n.match(/^--lines=(\d+)$/);if(r)return Number(r[1]);if(n===`--lines`&&t+1<e.length){let n=Number(e[t+1]);if(Number.isFinite(n))return n}if(n===`-n`&&t+1<e.length){let n=Number(e[t+1]);if(Number.isFinite(n))return n}let i=n.match(/^-n(\d+)$/);if(i)return Number(i[1]);let a=n.match(/^-(\d+)$/);if(a)return Number(a[1])}return 10}function qt(e,t){if(e.length<2)return null;let n=e[e.length-1];if(n.command!==`head`&&n.command!==`tail`)return null;let r=Kt(n.args),i=t.split(`
-`),a=i[i.length-1]===``?i.length-1:i.length;if(a<r)return null;let o=i.slice(0,a),s=new Set(o.map(e=>{let t=e.indexOf(`:`);return t>0?e.slice(0,t):e})).size,c=e.slice(0,-1).map(e=>e.command).join(` | `);return{banner:`Output hit \`${n.command} -${r}\` cap (${a} lines, ${s} unique file${s===1?``:`s`}). The \`${c}\` stage may have had more matches that never reached stdout. For existence checks across many files, prefer \`grep -rl PATTERN <dir>\` (list files only, no head). For enumeration, drop the \`| ${n.command}\` or widen the cap.`}}function Jt(e){return e.type===`directory`}function Yt(e){let t=[e.title?`**${e.title}** (${e.path}/)`:`**${e.path}/** (directory)`];e.description&&t.push(e.description),e.tags&&e.tags.length>0&&t.push(`tags: ${e.tags.join(`, `)}`);let n=[];return n.push(`${e.recursiveMdCount} md file${e.recursiveMdCount===1?``:`s`}`),e.childDirCount>0&&n.push(`${e.childDirCount} subdir${e.childDirCount===1?``:`s`}`),t.push(n.join(`, `)),e.mostRecentMd&&t.push(`most recent: ${e.mostRecentMd.title??e.mostRecentMd.path} (${e.mostRecentMd.path})`),e.truncated&&t.push(`scan truncated`),`- ${t.join(` — `)}`}function Xt(e){let t=[`**${e.title??e.path}** (${e.path})`];if(e.description&&t.push(e.description),e.tags.length>0&&t.push(`tags: ${e.tags.join(`, `)}`),e.backlinkCount!==null&&t.push(`backlinks: ${e.backlinkCount}`),e.forwardLinkCount!==null&&t.push(`forward links: ${e.forwardLinkCount}`),e.history&&e.history.length>0){let n=e.history.map(e=>{let t=e.writerClassification===`agent`?`agent: ${e.writerName}`:e.writerClassification===`human`?`human: ${e.writerName}`:`${e.writerClassification}: ${e.writerName}`;return`${e.hash.slice(0,7)} [${t}] ${e.message}`});t.push(`OK edits: ${n.join(` · `)}`)}if(e.projectHistory&&e.projectHistory.length>0){let n=e.projectHistory.map(e=>`${e.hash.slice(0,7)} ${e.authorName}: ${e.subject}`);t.push(`commits: ${n.join(` · `)}`)}return`- ${t.join(` — `)}`}function Zt(e,t,n){let r=null;for(let t=e.length-1;t>=0;t--){let n=e[t],i=n.command;if(i===`ls`||i===`cat`){r=n;break}if((i===`head`||i===`tail`)&&J(q(n)).length>0){r=n;break}}if(!r)return``;let i=J(q(r));if(r.command===`ls`){let e=i[i.length-1];if(!e||e===`.`)return``;let n=e.replace(/\/+/g,`/`);return n.startsWith(`./`)&&(n=n.slice(2)),n.endsWith(`/`)&&(n=n.slice(0,-1)),!n||!t.has(n)?``:`${n}/:\n`}let a=i.filter(e=>/\.(md|mdx)$/.test(e)&&n.has(e));return a.length===1?`==> ${a[0]} <==\n`:``}function Qt(e){if(e.length===0)return``;let t=[``,`### Referenced files`,``];for(let n of e)t.push(Jt(n)?Yt(n):Xt(n));return t.join(`
-`)}async function $t(e,t){let n=[],r=[];return await Promise.all(t.map(async t=>{try{let i=await ae(N(e,t));i.isDirectory()?r.push(t):i.isFile()&&n.push(t)}catch{/\.(md|mdx)$/i.test(t)&&n.push(t)}})),{files:n,dirs:r}}function X(e,t){return I(t,{enrichedPaths:[],error:{category:e,message:t}},!0)}function en(e,t){return e.map(e=>{let n=t(ke(e.path));return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}})}async function tn(e,t){let n=await t.resolveCwd(e.cwd),r=await R(t.serverUrl),i=pt(e.command);if(`error`in i)return X(i.error.category,i.error.message);let a=et(i.stages),o=tt(a),s=await Ye(n),c=We(n),l=``,u=``;try{let e=await Ge(c,o);l=e.stdout,u=e.stderr}catch(e){return e instanceof Ue?X(`output_overflow`,`Output exceeded 16 MB buffer. Narrow the command (e.g., add a more specific grep pattern, use head, restrict the path).`):X(`shell_construct_blocked`,`exec failed: ${e instanceof Error?e.message:String(e)}`)}let d=await Ye(n),f=Xe(s.snapshot,d.snapshot);if(f.changed.length>0)return X(`security_invariant_violation`,`Security invariant violated: file(s) in the content directory were modified during a read-only exec call: ${f.changed.join(`, `)}. This indicates a parser bug; the command has been logged.`);let p=Wt(l),m=Ve(l,a),{files:h,dirs:g}=await $t(n,m),_=a.length===1&&a[0].command===`cat`&&h.length===1,v=t.config.folders,y=await Promise.all(h.map(e=>Rt(e,{projectDir:n,serverUrl:r,folderRules:v},{includeRichFields:_}).catch(()=>({path:e,tags:[],backlinkCount:null,backlinks:null,forwardLinkCount:null,forwardLinks:null,history:null,historySource:null,projectHistory:null,projectHistorySource:null})))),b=await Promise.all(g.map(e=>Bt(e,{projectDir:n,folderRules:v}).catch(()=>({path:e,type:`directory`,directMdCount:0,recursiveMdCount:0,childDirCount:0,truncated:!1}))));if(!_&&r&&y.length>0){let e=await Ft(r,y.map(e=>Mt(e.path))).catch(()=>null);if(e)for(let t of y){let n=e.get(Mt(t.path));typeof n==`number`&&(t.backlinkCount=n)}}let x=new Map(y.map(e=>[e.path,e])),S=new Map(b.map(e=>[e.path,e])),C=[];for(let e of m){let t=x.get(e);if(t){C.push(t);continue}let n=S.get(e);n&&C.push(n)}let w=Gt(a),T=[];w.length>0&&T.push(`File${w.length>1?`s`:``} ${w.join(`, `)} appear${w.length===1?`s`:``} to be binary (image/PDF/etc.) — exec returns text only (NG8). For binary retrieval, use native Read.`);let E=qt(a,l);E&&T.push(E.banner),u&&T.push(`stderr: ${u.trim()}`);let D=T.length>0?`${T.join(`
-`)}\n\n`:``,O=Zt(a,S,x)+p.text,k=`${D}${O}${Qt(C)}`,A,j;if(t.config){let{resolve:e,ui:r}=await U({config:t.config,resolveCwd:async()=>n});A=en(C,e),j=r}else A=C.map(e=>({...e,previewUrl:null}));return I(k,{enrichedPaths:A,stdout:O,stdoutTruncated:p.truncated,...j?{ui:j}:{},...T.length>0?{warnings:T}:{}})}function nn(e,t){e.tool(`exec`,Ut,{command:P.string().describe(`Read-only bash command (allowlist: cat, ls, grep, find, head, tail, wc, sort, uniq, cut; pipes OK)`),cwd:P.string().optional().describe(`Absolute host path to run the command from. Defaults to the MCP client's first advertised root, then the server startup cwd.`)},async e=>{try{return await tn(e,t)}catch(e){return X(`shell_construct_blocked`,`exec handler error: ${e instanceof Error?e.message:String(e)}`)}})}const rn=[`[Requires: Hocuspocus server] Find all pages that link to a given page.`,`Returns source page names, resolved titles, and context snippets as JSON.`,``,`**Parameters:**`,'- `docName` — Target page docName, typically without extension (for example, "articles/project-alpha"). A trailing `.md` or `.mdx` is stripped automatically.'].join(`
-`);function an(e,t){e.tool(`get_backlinks`,rn,{docName:P.string().describe(`Target page docName`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=z(e.docName);if(!r.ok)return F(r.error,!0);let i=await B(n,`/api/backlinks?docName=${encodeURIComponent(r.docName)}`);if(!i.ok)return F(`Error: ${i.error}`,!0);let{ok:a,...o}=i,s=o,{resolve:c,ui:l}=await U(t),u=(s.backlinks??[]).map(e=>{let t=typeof e.source==`string`?e.source:null,n=t?c(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),d={...s,backlinks:u,ui:l};return I(JSON.stringify(d,null,2),d)})}const on=[`[Requires: Hocuspocus server] Find missing internal page targets across the corpus.`,`Returns grouped dead links keyed by missing target with source-doc rows as JSON.`,``,`**Parameters:**`,"- `sourceDocNames` (optional) — Referring source docs to narrow the audit with OR semantics"].join(`
-`);function sn(e,t){e.tool(`get_dead_links`,on,{sourceDocNames:P.array(P.string()).optional().describe(`Referring source docs to narrow the audit with OR semantics`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=new URLSearchParams;for(let t of e.sourceDocNames??[]){let e=z(t);if(!e.ok)return F(e.error,!0);r.append(`sourceDocName`,e.docName)}let i=r.toString(),a=await B(n,`/api/dead-links${i?`?${i}`:``}`);if(!a.ok)return F(`Error: ${a.error}`,!0);let{ok:o,...s}=a,c=s,{resolve:l,ui:u}=await U(t),d=(c.deadLinks??[]).map(e=>{let t=typeof e.target==`string`?e.target:null,n=t?l(t):null,r=(e.sources??[]).map(e=>{let t=typeof e.source==`string`?e.source:null,n=t?l(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}});return{...e,sources:r,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),f={...c,deadLinks:d,ui:u};return I(JSON.stringify(f,null,2),f)})}const cn=[`[Requires: Hocuspocus server] Find all pages that a given page links to.`,`Returns forward links as JSON.`,``,`**Parameters:**`,"- `docName` — Source page docName, typically without extension. A trailing `.md` or `.mdx` is stripped automatically."].join(`
-`);function ln(e,t){e.tool(`get_forward_links`,cn,{docName:P.string().describe(`Source page docName`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=z(e.docName);if(!r.ok)return F(r.error,!0);let i=await B(n,`/api/forward-links?docName=${encodeURIComponent(r.docName)}`);if(!i.ok)return F(`Error: ${i.error}`,!0);let{ok:a,...o}=i,s=o,{resolve:c,ui:l}=await U(t),u=(s.forwardLinks??[]).map(e=>{let t=e.kind===`doc`&&typeof e.docName==`string`?e.docName:null,n=t?c(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),d={...s,forwardLinks:u,ui:l};return I(JSON.stringify(d,null,2),d)})}const un=[`[Requires: Hocuspocus server] List version history for a document.`,`Returns timeline entries from the shadow repo, sorted by timestamp descending.`,"Each entry includes a commit SHA that can be passed to `rollback_to_version`.",``,`**Parameters:**`,"- `docName` — Document name to query history for, typically without extension. A trailing `.md` or `.mdx` is stripped automatically.","- `branch` (optional) — Branch name (default: current branch)","- `limit` (optional) — Maximum entries to return (default 50, max 200)","- `offset` (optional) — Number of entries to skip for pagination (default 0)",'- `type` (optional) — Filter by entry type: "checkpoint", "upstream", or "wip"',"- `author` (optional) — Filter to entries by this author name or email","- `excludeAuthor` (optional) — Exclude entries by this author name or email"].join(`
-`);function dn(e,t){e.tool(`get_history`,un,{docName:P.string().describe(`Document name to query history for`),branch:P.string().optional().describe(`Branch name (default: current branch)`),limit:P.number().int().min(1).max(200).optional().describe(`Maximum entries to return (default 50, max 200)`),offset:P.number().int().min(0).optional().describe(`Number of entries to skip for pagination (default 0)`),type:P.enum([`checkpoint`,`upstream`,`wip`]).optional().describe(`Filter by entry type`),author:P.string().optional().describe(`Filter to entries by this author name or email`),excludeAuthor:P.string().optional().describe(`Exclude entries by this author name or email`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=z(e.docName);if(!r.ok)return F(r.error,!0);let i=new URLSearchParams;i.set(`docName`,r.docName),e.branch&&i.set(`branch`,e.branch),e.limit!=null&&i.set(`limit`,String(e.limit)),e.offset!=null&&i.set(`offset`,String(e.offset)),e.type&&i.set(`type`,e.type),e.author&&i.set(`author`,e.author),e.excludeAuthor&&i.set(`excludeAuthor`,e.excludeAuthor);let a=await B(n,`/api/history?${i.toString()}`);if(!a.ok)return F(`Error: ${a.error}`,!0);let{ok:o,...s}=a,c=await H(r.docName,{config:t.config,resolveCwd:t.resolveCwd});return I(JSON.stringify(s,null,2),{...s,previewUrl:c?.url??null,...c?{previewUrlSource:c.source}:{}})})}const fn=[`[Requires: Hocuspocus server] Find the most-linked pages in the knowledge graph.`,`Returns hub pages ordered by inbound link count as JSON.`,``,`**Parameters:**`,"- `limit` (optional) — Maximum number of hubs to return (default 20)"].join(`
-`);function pn(e,t){e.tool(`get_hubs`,fn,{limit:P.number().int().positive().optional().describe(`Maximum number of hubs to return`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=await B(n,`/api/hubs${e.limit?`?limit=${encodeURIComponent(String(e.limit))}`:``}`);if(!r.ok)return F(`Error: ${r.error}`,!0);let{ok:i,...a}=r,o=a,{resolve:s,ui:c}=await U(t),l=(o.hubs??[]).map(e=>{let t=typeof e.docName==`string`?e.docName:null,n=t?s(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),u={...o,hubs:l,ui:c};return I(JSON.stringify(u,null,2),u)})}const mn=[`[Requires: Hocuspocus server] Find disconnected pages in the knowledge graph.`,`Returns orphaned pages as JSON.`,``,`**Parameters:**`,"- `mode` (optional) — Orphan lens: `incoming`, `outgoing`, or `both` (default `both`)"].join(`
-`);function hn(e,t){e.tool(`get_orphans`,mn,{mode:P.enum(u).optional().describe(`Filter which type of graph disconnection to surface`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=await B(n,`/api/orphans${e.mode?`?mode=${encodeURIComponent(e.mode)}`:``}`);if(!r.ok)return F(`Error: ${r.error}`,!0);let{ok:i,...a}=r,o=a,{resolve:s,ui:c}=await U(t),l=(o.orphans??[]).map(e=>{let t=typeof e.docName==`string`?e.docName:null,n=t?s(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),u={...o,orphans:l,ui:c};return I(JSON.stringify(u,null,2),u)})}const gn=["Return a browser URL for the given wiki docName. Agents should call this IMMEDIATELY BEFORE `write_document` / `edit_document` so they can navigate the preview browser to the doc first and watch the CRDT edit land live.",``,`**Parameters:**`,"- `docName` — Wiki doc name, typically without extension.",``,"Returns `{ previewUrl, previewUrlSource }` (source: `env` / `lock` / `config`). When no source is configured, returns `{ previewUrl: null }` and the agent may proceed without navigation."].join(`
-`);async function _n(t,n){let r=z(t.docName);if(!r.ok)return{ok:!1,error:r.error};let i=r.docName,a=await n.resolveCwd(),o=h(n.config,a),s;try{s=e({projectDir:a,contentDir:o,includePatterns:n.config.content.include,excludePatterns:n.config.content.exclude})}catch(e){return{ok:!1,error:`Cannot evaluate content filter: ${e instanceof Error?e.message:String(e)}`}}if(![`${i}.md`,`${i}.mdx`].some(e=>!s.isExcluded(e)))return{ok:!1,error:`Error: docName "${i}" is not inside content.include globs (${n.config.content.include.join(`, `)}). This tool only returns URLs for docs that match those globs.`};let c=m(o),l=W(i,{config:n.config,lockDir:c});return l?{ok:!0,result:{previewUrl:l.url,previewUrlSource:l.source},text:`Preview URL for "${i}" (source: ${l.source}):\n${l.url}`}:{ok:!0,result:{previewUrl:null},text:`No preview URL resolvable for "${i}". The server is likely not running yet. Start it with \`open-knowledge start\` (or \`preview_start\`), then **call \`get_preview_url\` again** — the server writes a lock file that this tool reads to resolve the URL. NEVER guess or manually construct the preview URL. Alternatively, set \`OPEN_KNOWLEDGE_PREVIEW_BASE_URL\` or add \`preview.baseUrl\` to .open-knowledge/config.yml.`}}function vn(e,t){e.tool(`get_preview_url`,gn,{docName:P.string().min(1)},async e=>{let n=await _n(e,t);return n.ok?I(n.text,n.result):F(n.error,!0)})}function yn(e,t){return`Capture this external source into the project knowledge base as raw reference material. **Raw preservation only** — no summary, no analysis, no interpretation. Summarizing is the job of the \`research\` tool later.
+Full convention: read \`${d}/AGENTS.md\`.`}const mt=[`Promote research into a canonical article inside the project content directory. Canonical, not provisional — the output is the source of truth for future agents.`,``,`**Use when:**`,`- A team has made a decision after research and wants the outcome committed as canonical knowledge`,`- Compacting several provisional research notes into one authoritative article`,`- A developer asks to "consolidate" or "finalize" knowledge on a topic`,``,`**Triggers on:**`,`- "consolidate", "finalize", "promote to canonical", "make this official"`,`- User says the team has decided and wants the outcome written as canonical`,`- Research has stabilized and a destination article is needed`].join(`
+`);function ht(e,t){e.tool(`consolidate`,mt,{topic:N.string().describe(`The topic to consolidate into a canonical article`)},e=>F(pt(e.topic,t.content.dir),{previewUrl:null}))}function gt(e){return e.split(`/`).map(encodeURIComponent).join(`/`)}function _t(e){return e.endsWith(`/`)?e.slice(0,-1):e}function vt(e){try{return new URL(e),!0}catch{return!1}}async function V(e,t){let n=await t.resolveCwd(),r=m(h(t.config,n));return U(e,{config:t.config,lockDir:r})}function yt(e){try{let t=a(e.lockDir);if(t&&t.port>0)return{baseUrl:`http://localhost:${t.port}`,port:t.port}}catch(t){process.stderr.write(`[preview-url] readUiLock failed at ${e.lockDir} while building ui block: ${t instanceof Error?t.message:String(t)}\n`)}return{baseUrl:null,port:null}}async function H(e){let t=await e.resolveCwd(),n=m(h(e.config,t)),r={config:e.config,lockDir:n};return{resolve:e=>U(e,r),ui:yt(r)}}function bt(e){let t=e.toLowerCase();return t.endsWith(`.md`)?e.slice(0,-3):t.endsWith(`.mdx`)?e.slice(0,-4):e}function U(e,t){let n=`/#/${gt(e)}`,r=process.env.OPEN_KNOWLEDGE_PREVIEW_BASE_URL;if(r&&vt(r))return{url:`${_t(r)}${n}`,source:`env`};try{let e=a(t.lockDir);if(e&&e.port>0)return{url:`http://localhost:${e.port}${n}`,source:`lock`}}catch(e){process.stderr.write(`[preview-url] readUiLock failed at ${t.lockDir}, falling through to config: ${e instanceof Error?e.message:String(e)}\n`)}let i=t.config.preview?.baseUrl;return i&&vt(i)?{url:`${_t(i)}${n}`,source:`config`}:null}const xt=["**IMPORTANT: Before calling this tool, you MUST first call `get_preview_url` and navigate to the returned URL in your preview browser. If `get_preview_url` returns null, start the server first (`open-knowledge start` or `preview_start`), then call `get_preview_url` again. Do NOT call this tool without the preview open. NEVER manually construct the URL.**",``,`[Requires: Hocuspocus server] Find-and-replace on a live document via the CRDT layer.`,`The patch is applied through Hocuspocus and propagated to all connected editors in real-time.`,"Use `offset` when you need to patch an exact occurrence; omit it to preserve first-match behavior.",``,"**When rewriting prose, add `[[wiki-links]]` aggressively.** If the replacement mentions other documents or entities that should have their own page, link them as `[[Page Name]]`. Over-linking is the goal; underlinked documents lose their value in backlink-driven navigation.",``,`**Parameters:**`,"- `docName` — Document name, typically without extension. A trailing `.md` or `.mdx` is stripped automatically.","- `find` — Text to find (exact match)","- `replace` — Replacement text","- `offset` (optional) — Exact occurrence to patch, as a JavaScript string offset in the current markdown. If the document changed and the text no longer matches there, the server returns a stale-target error; re-run `suggest_links` to get fresh offsets."].join(`
+`);function St(e,t){e.tool(`edit_document`,xt,{docName:N.string().describe(`Document name to edit`),find:N.string().describe(`Text to find (exact match)`),replace:N.string().describe(`Replacement text`),offset:N.number().int().min(0).optional().describe(`Exact occurrence to patch, as a JavaScript string offset in the current markdown`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=R(e.docName);if(!r.ok)return P(r.error,!0);let i=t.identityRef?.current,a=await B(n,`/api/agent-patch`,{docName:r.docName,find:e.find,replace:e.replace,offset:e.offset,...i?{agentId:i.connectionId,agentName:i.displayName,clientName:i.clientInfo?.name,colorSeed:i.colorSeed}:{}});if(!a.ok)return P(`Error: ${a.error}`,!0);let o=await t.resolveCwd(),s=m(h(t.config,o)),c=U(r.docName,{config:t.config,lockDir:s}),l=(typeof a.subscriberCount==`number`?a.subscriberCount:void 0)===0,u=[`Edit applied successfully.`];c&&u.push(`Preview: ${c.url}`),l&&u.push(c?`Warning: no preview is currently attached to "${r.docName}". Open ${c.url} to watch future edits live.`:`Warning: no preview is currently attached to "${r.docName}".`);let d=u.join(`
+`);if(!c&&!l)return P(d);let f={};return c&&(f.previewUrl=c.url,f.previewUrlSource=c.source),l&&(f.warning={message:`No preview attached to ${r.docName}.`,previewUrl:c?.url??null}),F(d,f)})}const Ct=new Set([`cat`,`ls`,`grep`,`find`]),wt=/\b[\w./-]+\.(md|mdx)\b/g;function W(e){return/\.(md|mdx)$/.test(e)}function G(e){let t=e.trim();return t?(t=t.replace(/\/+/g,`/`),t.startsWith(`./`)&&(t=t.slice(2)),t.endsWith(`/`)&&(t=t.slice(0,-1)),t):``}function K(e){return e.args.slice(1)}function q(e){return e.filter(e=>!e.startsWith(`-`))}function Tt(e){return q(K(e)).filter(W)}function Et(e,t){let n=q(K(t)),r=n.length>0?n[n.length-1]:``,i=r&&r!==`.`?G(r):``,a=[];i&&a.push(i);for(let t of e.split(`
+`)){let e=t.trim();if(!e||/\.[a-z0-9]+$/i.test(e)&&!W(e))continue;let n=i?`${i}/${e}`:e;a.push(n)}return a}function Dt(e){let t=[];for(let n of e.split(`
+`)){if(!n)continue;let e=n.indexOf(`:`);if(e<0)continue;let r=G(n.slice(0,e));W(r)&&t.push(r)}return t}function Ot(e){let t=[];for(let n of e.split(`
+`)){let e=G(n);e&&W(e)&&t.push(e)}return t}function kt(e){return q(K(e)).filter(W)}function At(e){return q(K(e)).length>0}function jt(e){let t=[],n=e.matchAll(wt);for(let e of n)t.push(G(e[0]));return t}function Mt(e,t){let n=null;for(let e=t.length-1;e>=0;e--){let r=t[e];if(Ct.has(r.command)){n=r;break}if((r.command===`head`||r.command===`tail`)&&At(r)){n=r;break}}let r;if(!n)r=jt(e);else{switch(n.command){case`cat`:r=Tt(n);break;case`ls`:r=Et(e,n);break;case`grep`:r=Dt(e);break;case`find`:r=Ot(e);break;case`head`:case`tail`:r=kt(n);break;default:r=jt(e)}r.length===0&&(r=jt(e))}let i=new Set,a=[];for(let e of r){let t=G(e);!t||i.has(t)||(i.add(t),a.push(t))}return a}function J(e){return e===``?`''`:/^[\w.\-/]+$/.test(e)?e:`'${e.replace(/'/g,`'\\''`)}'`}const Nt=16*1024*1024;var Pt=class extends Error{limitBytes;actualBytes;partial;constructor(e,t,n){super(`Output exceeded ${e} byte buffer (got ${t}); narrow the command`),this.name=`StdoutOverflowError`,this.limitBytes=e,this.actualBytes=t,this.partial=n}};function Ft(e){if(!oe(e))throw Error(`createBashInstance: cwd must be absolute (got: ${e})`);return new De({cwd:`/`,fs:new Oe({root:j(e),allowSymlinks:!1})})}async function It(e,t){let n=await e.exec(t);if(n.stdout.length>Nt)throw new Pt(Nt,n.stdout.length,{stdout:n.stdout.slice(0,Nt),stderr:n.stderr,exitCode:n.exitCode});return{stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode}}function Lt(e){return e.startsWith(`**/`)?e.slice(3):e}async function Rt(e,t,n={}){let r=Ft(t),i=[`-rn`,`-F`];(n.caseInsensitive??!0)&&i.push(`-i`);for(let e of n.include??[])i.push(`--include=${J(Lt(e))}`);for(let e of n.exclude??[])i.push(`--exclude=${J(Lt(e))}`),i.push(`--exclude-dir=${J(Lt(e))}`);let a=n.paths?.length?n.paths.map(J):[`.`],o=`grep ${i.join(` `)} ${J(e)} ${a.join(` `)}`,s;try{s=await It(r,o)}catch(e){if(e instanceof Pt)s=e.partial;else throw e}if(s.exitCode===1&&!s.stdout)return[];if(s.exitCode!==0&&s.exitCode!==1&&!s.stdout)throw Error(`grep exited ${s.exitCode}: ${s.stderr}`);let c=[],l=n.maxResults??1/0;for(let e of s.stdout.split(`
+`)){if(!e)continue;if(c.length>=l)break;let t=e.indexOf(`:`);if(t===-1)continue;let n=e.indexOf(`:`,t+1);if(n===-1)continue;let r=e.slice(0,t),i=e.slice(t+1,n),a=e.slice(n+1),o=Number.parseInt(i,10);Number.isFinite(o)&&c.push({path:r,line:o,text:a})}return c}const zt=new Set([`.git`,d,`.openknowledge`,`node_modules`,`.changeset`,`.claude`,`.agents`,`dist`,`build`]);async function Bt(e){let t=j(e),n=new Map,r=0,i=!1;async function a(e){if(i)return;let o;try{o=await ye(e,{withFileTypes:!0})}catch{return}for(let s of o){if(i)return;if(s.isDirectory()&&zt.has(s.name))continue;let o=j(e,s.name);if(s.isDirectory()){await a(o);continue}if(s.isFile()){if(r>=1e3){i=!0;return}try{let e=await be(o);n.set(ce(t,o),e.mtimeMs),r++}catch{}}}}return await a(t),{snapshot:n,truncated:i}}function Vt(e,t){let n=[];for(let[r,i]of t){let t=e.get(r);(t===void 0||t!==i)&&n.push(r)}for(let[r]of e)t.has(r)||n.push(r);return{changed:n}}const Ht=[`node_modules`,`.git`,`dist`,`build`,`.next`,`.turbo`,`.nuxt`,`coverage`,`.cache`,`.parcel-cache`,`.vercel`,d,`.claude`];function Ut(e){return e===`--recursive`||e===`--dereference-recursive`?!0:e.startsWith(`--`)||!e.startsWith(`-`)?!1:/[rR]/.test(e.slice(1))}const Wt=[{command:`grep`,applies:e=>e.slice(1).some(Ut),hasUserExcludes:e=>e.some(e=>e===`--exclude-dir`||e.startsWith(`--exclude-dir=`)),buildExcludeArgs:e=>e.map(e=>`--exclude-dir=${e}`),insertionIndex:()=>1},{command:`find`,applies:()=>!0,hasUserExcludes:e=>e.slice(1).some(e=>e===`-not`||e===`!`||e===`-prune`),buildExcludeArgs:e=>{let t=[];for(let n of e)t.push(`-not`,`-path`,`*/${n}/*`);return t},insertionIndex:e=>{for(let t=1;t<e.length;t++)if(e[t].startsWith(`-`))return t;return e.length}}];function Gt(e){return e.map(e=>{let t=Wt.find(t=>t.command===e.command);if(!t||!t.applies(e.args)||t.hasUserExcludes(e.args))return e;let n=t.buildExcludeArgs(Ht),r=t.insertionIndex(e.args);return{command:e.command,args:[...e.args.slice(0,r),...n,...e.args.slice(r)]}})}function Kt(e){return e.map(e=>e.args.map(J).join(` `)).join(` | `)}const qt=new Set([`cat`,`ls`,`grep`,`find`,`head`,`tail`,`wc`,`sort`,`uniq`,`cut`]),Jt=new Set([`>`,`>>`,`<`,`>&`,`<&`,`|&`]),Yt=new Set([`&`,`;`,`;;`,`&&`,`||`,`(`,`)`,`<(`,`>(`,`<<`,`<<-`]),Xt=new Set([`-o`,`--output-file`,`--output`]),Zt=[`-o=`,`--output-file=`,`--output=`],Qt=new Set([`-exec`,`-execdir`,`-delete`,`-fprint`,`-fprintf`,`-fprint0`,`-ok`,`-okdir`]),$t=/[`]|\$\(|\$\{|\$'/;function en(e){return typeof e==`object`&&!!e&&`op`in e}function tn(e){let t=typeof e.op==`string`?e.op:`(unknown)`;return Jt.has(t)?{category:`write_blocked`,message:`Write operation blocked: '${t}'. exec is read-only. For document changes, use write_document or edit_document.`}:Yt.has(t)?{category:`shell_construct_blocked`,message:`Shell construct '${t}' is not supported. Only pipes (|) are allowed between allowlisted stages.`}:{category:`shell_construct_blocked`,message:`Operator '${t}' is not supported.`}}function nn(e){let t=[];for(let n of e){if(typeof n==`string`){if($t.test(n))return{error:{category:`shell_construct_blocked`,message:`Argument '${n}' contains a shell-injection pattern (backtick, $(), or \${}); not supported.`}};t.push(n);continue}if(!en(n))return{error:{category:`shell_construct_blocked`,message:`Unrecognized token shape.`}};if(n.op===`glob`&&typeof n.pattern==`string`){t.push(n.pattern);continue}return typeof n.comment==`string`?{error:{category:`shell_construct_blocked`,message:`Comments are not allowed in exec commands.`}}:{error:tn(n)}}return{args:t}}function rn(e){if(!qt.has(e.command))return{category:`unknown_command`,message:`Command '${e.command}' is not in the allowlist. For pattern matching try 'grep'; for file listing try 'ls' or 'find'. Allowlist: cat, ls, grep, find, head, tail, wc, sort, uniq, cut.`};for(let t of e.args.slice(1)){if(Xt.has(t)||Zt.some(e=>t.startsWith(e)))return{category:`write_blocked`,message:`Write operation blocked: '${t}'. exec is read-only. For document changes, use write_document or edit_document.`};if(e.command===`find`&&Qt.has(t))return{category:`write_blocked`,message:`find flag '${t}' is blocked (executes commands or deletes files). Use exec for read-only discovery; chain with another allowlisted tool via '|' if you need to transform output.`}}return null}function an(e){let t=e.trim();if(!t)return{error:{category:`unknown_command`,message:`Empty command.`}};let n;try{n=ke.parse(t)}catch{return{error:{category:`shell_construct_blocked`,message:`Failed to parse command — likely malformed quoting or an unsupported construct.`}}}let r=[],i=[];for(let e of n){if(en(e)&&e.op===`|`){r.push(i),i=[];continue}i.push(e)}r.push(i);let a=[];for(let e of r){let t=nn(e);if(`error`in t)return t;if(t.args.length===0)return{error:{category:`shell_construct_blocked`,message:`Empty pipeline stage (trailing pipe or leading pipe).`}};let n={command:t.args[0],args:t.args},r=rn(n);if(r)return{error:r};a.push(n)}return{stages:a}}const on=/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/;function sn(e,t){let n=e.match(on);if(!n)return null;try{let e=le(n[1]);if(v(e)){if(t){let n=t.safeParse(e);return n.success?n.data:null}return e}}catch{}return null}const cn=new WeakMap;function ln(e){let t=cn.get(e);if(t)return t;let n=e.map(e=>xe(e.match,{dot:!0}));return cn.set(e,n),n}function un(e,t){if(e.length===0)return{};let n=ln(e),r={},i=[],a=!1;for(let o=0;o<e.length;o++){if(!n[o](t))continue;a=!0;let s=e[o].frontmatter;if(s.title!==void 0&&(r.title=s.title),s.description!==void 0&&(r.description=s.description),s.tags!==void 0)for(let e of s.tags)i.includes(e)||i.push(e)}return a?(i.length>0&&(r.tags=i),r):{}}function dn(e){try{return k(j(e,`.git`)).isDirectory()}catch{return!1}}function fn(e){return M({baseDir:j(e),timeout:{block:5e3}})}async function pn(e,t,n=5){if(!dn(e))return{commits:[],source:`git-absent`};let r=fn(e),i=``;try{i=await r.raw(`log`,`-${Math.max(1,n)}`,`--format=%H|%aI|%an|%s`,`--follow`,`--`,t)}catch{return{commits:[],source:`git`}}let a=[];for(let e of i.split(`
+`)){if(!e)continue;let t=e.indexOf(`|`);if(t<0)continue;let n=e.indexOf(`|`,t+1);if(n<0)continue;let r=e.indexOf(`|`,n+1);r<0||a.push({hash:e.slice(0,t),date:e.slice(t+1,n),authorName:e.slice(n+1,r),subject:e.slice(r+1)})}return{commits:a,source:`git`}}const mn=5e3;async function hn(e){try{let t=(await M({baseDir:e,timeout:{block:mn}}).revparse([`--abbrev-ref`,`HEAD`])).trim();return t&&t!==`HEAD`?t:null}catch{return null}}function gn(e,t){return M({baseDir:t,timeout:{block:mn}}).env({GIT_DIR:e,GIT_WORK_TREE:t})}function _n(e,n){let r=t(n);return e.startsWith(r)?e.slice(r.length):e}async function vn(e,t,r,a,o){let s=``;try{s=await e.raw(`log`,t,`-${Math.max(1,o*2)}`,`--format=%H%x00%aI%x00%an%x00%s%x00%B%x1e`,`--`,r)}catch{return[]}let c=_n(t,a),l=i(c),u=[];for(let e of s.split(``)){let t=e.trimStart();if(!t)continue;let[r=``,i=``,o=``,s=``,d=``]=t.split(`\0`),f=r.trim();f.length===40&&u.push({hash:f,date:i,writerName:o,message:s,contributors:n(d),writerId:c,isAgent:l.isAgent,writerClassification:l.classification,branch:a})}return u}async function yn(e,n,i=5){let a=r(e);if(!a)return{commits:[],source:`shadow-repo-absent`};let o=await hn(e);if(!o)return{commits:[],source:`shadow-repo`};let s=gn(a,j(e)),c=``;try{c=await s.raw(`for-each-ref`,t(o),`--format=%(refname)`)}catch{return{commits:[],source:`shadow-repo`}}let l=c.split(`
+`).map(e=>e.trim()).filter(Boolean);return l.length===0?{commits:[],source:`shadow-repo`}:{commits:(await Promise.all(l.map(e=>vn(s,e,n,o,i)))).flat().sort((e,t)=>t.date.localeCompare(e.date)).slice(0,i),source:`shadow-repo`}}const bn=1e3,xn=new Set([`.git`,d,`.openknowledge`,`node_modules`,`.changeset`,`.claude`,`.agents`,`dist`,`build`]),Sn=/\.(md|mdx)$/i,Cn=N.object({title:N.string().optional(),description:N.string().optional(),tags:N.array(N.string()).default([])});function wn(e){return e.replace(/\.md$/,``).replace(/\.mdx$/,``)}async function Tn(e){try{let t=sn(await ve(e,`utf-8`),Cn);return t?{title:t.title,description:t.description,tags:t.tags??[]}:{tags:[]}}catch{return null}}async function En(e,t){if(!e)return null;let n=await z(e,`/api/backlinks?docName=${encodeURIComponent(t)}`);if(!n.ok)return null;let r=n.backlinks??n.results??n.links;if(!Array.isArray(r))return[];let i=[];for(let e of r){if(typeof e!=`object`||!e)continue;let t=e,n=typeof t.docName==`string`?t.docName:typeof t.source==`string`?t.source:typeof t.page==`string`?t.page:void 0;n&&i.push({source:n,title:typeof t.title==`string`?t.title:void 0,snippet:typeof t.snippet==`string`?t.snippet:null})}return i}async function Dn(e,t){if(!e||t.length===0)return null;let n=[...new Set(t)],r=[];for(let e=0;e<n.length;e+=100)r.push(n.slice(e,e+100));let i=await Promise.all(r.map(async t=>{let n=await z(e,`/api/backlink-counts?docNames=${encodeURIComponent(t.join(`,`))}`);return n.ok?n.counts??{}:null})),a=new Map,o=!1;for(let e of i)if(e){o=!0;for(let[t,n]of Object.entries(e))typeof n==`number`&&Number.isFinite(n)&&a.set(t,n)}return o?a:null}async function On(e,t){if(!e)return null;let n=await z(e,`/api/forward-links?docName=${encodeURIComponent(t)}`);if(!n.ok)return null;let r=n.forwardLinks??n.links??n.results;if(!Array.isArray(r))return[];let i=[];for(let e of r){if(typeof e!=`object`||!e)continue;let t=e;if(t.kind===`external`&&typeof t.url==`string`){i.push({kind:`external`,url:t.url,title:typeof t.title==`string`?t.title:void 0,snippet:typeof t.snippet==`string`?t.snippet:null});continue}let n=typeof t.docName==`string`?t.docName:void 0;n&&i.push({kind:`doc`,docName:n,title:typeof t.title==`string`?t.title:void 0,snippet:typeof t.snippet==`string`?t.snippet:null})}return i}function kn(e,t,n){let r=t??[],i=r.length===0?{}:un(r,n),a=e?.title??i.title,o=e?.description??i.description,s=e?.tags??[],c=i.tags??[],l;if(c.length===0)l=s;else{let e=new Set;l=[];for(let t of c)e.has(t)||(e.add(t),l.push(t));for(let t of s)e.has(t)||(e.add(t),l.push(t))}return{title:a,description:o,tags:l}}async function An(e,t,n={}){let r=e.replace(/^\.\//,``).replace(/^\/+/,``),i=j(t.projectDir,r),a=t.historyDepth??5,o=n.includeRichFields===!0,s=Tn(i);if(!o){let e=kn(await s,t.folderRules,r);return{path:r,title:e.title,description:e.description,tags:e.tags,backlinkCount:null,backlinks:null,forwardLinkCount:null,forwardLinks:null,history:null,historySource:null,projectHistory:null,projectHistorySource:null}}let[c,l,u,d,f]=await Promise.all([s,En(t.serverUrl,wn(r)).catch(()=>null),On(t.serverUrl,wn(r)).catch(()=>null),yn(t.projectDir,r,a).catch(()=>({commits:[],source:`shadow-repo`})),pn(t.projectDir,r,a).catch(()=>({commits:[],source:`git`}))]),p=kn(c,t.folderRules,r);return{path:r,title:p.title,description:p.description,tags:p.tags,backlinkCount:l?.length??null,backlinks:l,forwardLinkCount:u?.length??null,forwardLinks:u,history:d.commits,historySource:d.source,projectHistory:f.commits,projectHistorySource:f.source}}async function jn(e,t){let n={directMdCount:0,recursiveMdCount:0,childDirCount:0,mostRecent:null,truncated:!1},r=0,i=[{path:e,depth:0}];for(;i.length>0;){let e=i.shift();if(!e)break;if(r>=bn){n.truncated=!0;break}let a;try{a=await ye(e.path,{withFileTypes:!0})}catch{continue}for(let o of a){if(r>=bn){n.truncated=!0;break}r++;let a=o.name;if(o.isDirectory()){if(xn.has(a)||a.startsWith(`.`))continue;e.depth===0&&n.childDirCount++,i.push({path:`${e.path}/${a}`,depth:e.depth+1})}else if(o.isFile()&&Sn.test(a)){n.recursiveMdCount++,e.depth===0&&n.directMdCount++;let r=`${e.path}/${a}`;try{let e=await be(r);(!n.mostRecent||e.mtimeMs>n.mostRecent.mtimeMs)&&(n.mostRecent={absPath:r,relPath:ce(t,r).split(/[\\/]/).filter(Boolean).join(`/`),mtimeMs:e.mtimeMs})}catch{}}}}return n}async function Mn(e,t){let n=e.replace(/^\.\//,``).replace(/^\/+/,``).replace(/\/+$/,``),r=await jn(j(t.projectDir,n),t.projectDir),i;if(r.mostRecent){let e=await Tn(r.mostRecent.absPath);i={path:r.mostRecent.relPath,title:e?.title??ie(r.mostRecent.relPath),updatedAt:new Date(r.mostRecent.mtimeMs).toISOString()}}let a={path:n,type:`directory`,directMdCount:r.directMdCount,recursiveMdCount:r.recursiveMdCount,childDirCount:r.childDirCount,mostRecentMd:i,truncated:r.truncated},o=t.folderRules??[];if(o.length>0){let e=un(o,n);e.title!==void 0&&(a.title=e.title),e.description!==void 0&&(a.description=e.description),e.tags!==void 0&&e.tags.length>0&&(a.tags=e.tags)}return a}const Nn=50*1024,Pn=/\.(png|jpe?g|gif|webp|svg|pdf|zip|tar|gz|tgz|mp4|mov|mp3|wav|ico|bmp)$/i,Fn=[`Run a read-only bash-like command against the project content directory. Returns raw stdout plus enriched metadata for every wiki file referenced (frontmatter, backlink/forward-link counts, shadow-repo activity with agent/human attribution).`,``,`Allowlist: cat, ls, grep, find, head, tail, wc, sort, uniq, cut. Pipes (|) work between stages. Redirections, subshells, and writes are rejected.`,``,"cwd: the command runs in the MCP client's first advertised root (the project the user is working in). Pass an explicit absolute `cwd` to run against a different directory. Paths inside the command resolve relative to that cwd; traversal above it is rejected.",``,"Stdout provenance headers (GNU-style): `ls <dir>/` prepends `<dir>/:`, single-file `cat`/`head`/`tail` prepends `==> <path> <==`, so the subject of the command is visible in raw output. Multi-file `cat a b` emits no header — the `enrichedPaths` array still lists every file. `head`/`tail` used as pipe trimmers (no file arg) defer to the upstream producer.",``,`Examples:`,'- `exec({ command: "cat articles/auth.md" })` — file contents + full enrichment','- `exec({ command: "ls articles/" })` — listing + per-file enrichment (slim)','- `exec({ command: "grep -rn oauth articles/ | head -5" })` — pipe with enrichment on matched files','- `exec({ command: "ls", cwd: "/abs/path/to/other-repo" })` — run in a different project'].join(`
+`);function In(e){let t=e.split(`
+`),n=t[t.length-1]===``?t.length-1:t.length;if(n<=500&&e.length<=Nn)return{text:e,truncated:!1,omittedLines:0};let r=Math.min(n,500),i=0,a=0;for(let e=0;e<r;e++){let n=t[e];if(i+=n.length+1,i>Nn)break;a++}let o=t.slice(0,a).join(`
+`),s=n-a;return{text:`${o}\n<truncated: ${s} more lines — re-run with a more-specific query>`,truncated:!0,omittedLines:s}}function Ln(e){let t=[];for(let n of e)if(n.command===`cat`)for(let e of n.args.slice(1))e.startsWith(`-`)||Pn.test(e)&&t.push(e);return t}function Rn(e){for(let t=1;t<e.length;t++){let n=e[t],r=n.match(/^--lines=(\d+)$/);if(r)return Number(r[1]);if(n===`--lines`&&t+1<e.length){let n=Number(e[t+1]);if(Number.isFinite(n))return n}if(n===`-n`&&t+1<e.length){let n=Number(e[t+1]);if(Number.isFinite(n))return n}let i=n.match(/^-n(\d+)$/);if(i)return Number(i[1]);let a=n.match(/^-(\d+)$/);if(a)return Number(a[1])}return 10}function zn(e,t){if(e.length<2)return null;let n=e[e.length-1];if(n.command!==`head`&&n.command!==`tail`)return null;let r=Rn(n.args),i=t.split(`
+`),a=i[i.length-1]===``?i.length-1:i.length;if(a<r)return null;let o=i.slice(0,a),s=new Set(o.map(e=>{let t=e.indexOf(`:`);return t>0?e.slice(0,t):e})).size,c=e.slice(0,-1).map(e=>e.command).join(` | `);return{banner:`Output hit \`${n.command} -${r}\` cap (${a} lines, ${s} unique file${s===1?``:`s`}). The \`${c}\` stage may have had more matches that never reached stdout. For existence checks across many files, prefer \`grep -rl PATTERN <dir>\` (list files only, no head). For enumeration, drop the \`| ${n.command}\` or widen the cap.`}}function Bn(e){return e.type===`directory`}function Vn(e){let t=[e.title?`**${e.title}** (${e.path}/)`:`**${e.path}/** (directory)`];e.description&&t.push(e.description),e.tags&&e.tags.length>0&&t.push(`tags: ${e.tags.join(`, `)}`);let n=[];return n.push(`${e.recursiveMdCount} md file${e.recursiveMdCount===1?``:`s`}`),e.childDirCount>0&&n.push(`${e.childDirCount} subdir${e.childDirCount===1?``:`s`}`),t.push(n.join(`, `)),e.mostRecentMd&&t.push(`most recent: ${e.mostRecentMd.title??e.mostRecentMd.path} (${e.mostRecentMd.path})`),e.truncated&&t.push(`scan truncated`),`- ${t.join(` — `)}`}function Hn(e){let t=[`**${e.title??e.path}** (${e.path})`];if(e.description&&t.push(e.description),e.tags.length>0&&t.push(`tags: ${e.tags.join(`, `)}`),e.backlinkCount!==null&&t.push(`backlinks: ${e.backlinkCount}`),e.forwardLinkCount!==null&&t.push(`forward links: ${e.forwardLinkCount}`),e.history&&e.history.length>0){let n=e.history.map(e=>{let t=e.writerClassification===`agent`?`agent: ${e.writerName}`:e.writerClassification===`human`?`human: ${e.writerName}`:`${e.writerClassification}: ${e.writerName}`;return`${e.hash.slice(0,7)} [${t}] ${e.message}`});t.push(`OK edits: ${n.join(` · `)}`)}if(e.projectHistory&&e.projectHistory.length>0){let n=e.projectHistory.map(e=>`${e.hash.slice(0,7)} ${e.authorName}: ${e.subject}`);t.push(`commits: ${n.join(` · `)}`)}return`- ${t.join(` — `)}`}function Un(e,t,n){let r=null;for(let t=e.length-1;t>=0;t--){let n=e[t],i=n.command;if(i===`ls`||i===`cat`){r=n;break}if((i===`head`||i===`tail`)&&q(K(n)).length>0){r=n;break}}if(!r)return``;let i=q(K(r));if(r.command===`ls`){let e=i[i.length-1];if(!e||e===`.`)return``;let n=e.replace(/\/+/g,`/`);return n.startsWith(`./`)&&(n=n.slice(2)),n.endsWith(`/`)&&(n=n.slice(0,-1)),!n||!t.has(n)?``:`${n}/:\n`}let a=i.filter(e=>/\.(md|mdx)$/.test(e)&&n.has(e));return a.length===1?`==> ${a[0]} <==\n`:``}function Wn(e){if(e.length===0)return``;let t=[``,`### Referenced files`,``];for(let n of e)t.push(Bn(n)?Vn(n):Hn(n));return t.join(`
+`)}async function Gn(e,t){let n=[],r=[];return await Promise.all(t.map(async t=>{try{let i=await be(j(e,t));i.isDirectory()?r.push(t):i.isFile()&&n.push(t)}catch{/\.(md|mdx)$/i.test(t)&&n.push(t)}})),{files:n,dirs:r}}function Y(e,t){return F(t,{enrichedPaths:[],error:{category:e,message:t}},!0)}function Kn(e,t){return e.map(e=>{let n=t(bt(e.path));return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}})}async function qn(e,t){let n=await t.resolveCwd(e.cwd),r=await L(t.serverUrl),i=an(e.command);if(`error`in i)return Y(i.error.category,i.error.message);let a=Gt(i.stages),o=Kt(a),s=await Bt(n),c=Ft(n),l=``,u=``;try{let e=await It(c,o);l=e.stdout,u=e.stderr}catch(e){return e instanceof Pt?Y(`output_overflow`,`Output exceeded 16 MB buffer. Narrow the command (e.g., add a more specific grep pattern, use head, restrict the path).`):Y(`shell_construct_blocked`,`exec failed: ${e instanceof Error?e.message:String(e)}`)}let d=await Bt(n),f=Vt(s.snapshot,d.snapshot);if(f.changed.length>0)return Y(`security_invariant_violation`,`Security invariant violated: file(s) in the content directory were modified during a read-only exec call: ${f.changed.join(`, `)}. This indicates a parser bug; the command has been logged.`);let p=In(l),m=Mt(l,a),{files:h,dirs:g}=await Gn(n,m),_=a.length===1&&a[0].command===`cat`&&h.length===1,v=t.config.folders,y=await Promise.all(h.map(e=>An(e,{projectDir:n,serverUrl:r,folderRules:v},{includeRichFields:_}).catch(()=>({path:e,tags:[],backlinkCount:null,backlinks:null,forwardLinkCount:null,forwardLinks:null,history:null,historySource:null,projectHistory:null,projectHistorySource:null})))),b=await Promise.all(g.map(e=>Mn(e,{projectDir:n,folderRules:v}).catch(()=>({path:e,type:`directory`,directMdCount:0,recursiveMdCount:0,childDirCount:0,truncated:!1}))));if(!_&&r&&y.length>0){let e=await Dn(r,y.map(e=>wn(e.path))).catch(()=>null);if(e)for(let t of y){let n=e.get(wn(t.path));typeof n==`number`&&(t.backlinkCount=n)}}let x=new Map(y.map(e=>[e.path,e])),S=new Map(b.map(e=>[e.path,e])),C=[];for(let e of m){let t=x.get(e);if(t){C.push(t);continue}let n=S.get(e);n&&C.push(n)}let w=Ln(a),T=[];w.length>0&&T.push(`File${w.length>1?`s`:``} ${w.join(`, `)} appear${w.length===1?`s`:``} to be binary (image/PDF/etc.) — exec returns text only (NG8). For binary retrieval, use native Read.`);let E=zn(a,l);E&&T.push(E.banner),u&&T.push(`stderr: ${u.trim()}`);let D=T.length>0?`${T.join(`
+`)}\n\n`:``,O=Un(a,S,x)+p.text,ee=`${D}${O}${Wn(C)}`,k,A;if(t.config){let{resolve:e,ui:r}=await H({config:t.config,resolveCwd:async()=>n});k=Kn(C,e),A=r}else k=C.map(e=>({...e,previewUrl:null}));return F(ee,{enrichedPaths:k,stdout:O,stdoutTruncated:p.truncated,...A?{ui:A}:{},...T.length>0?{warnings:T}:{}})}function Jn(e,t){e.tool(`exec`,Fn,{command:N.string().describe(`Read-only bash command (allowlist: cat, ls, grep, find, head, tail, wc, sort, uniq, cut; pipes OK)`),cwd:N.string().optional().describe(`Absolute host path to run the command from. Defaults to the MCP client's first advertised root, then the server startup cwd.`)},async e=>{try{return await qn(e,t)}catch(e){return Y(`shell_construct_blocked`,`exec handler error: ${e instanceof Error?e.message:String(e)}`)}})}const Yn=[`[Requires: Hocuspocus server] Find all pages that link to a given page.`,`Returns source page names, resolved titles, and context snippets as JSON.`,``,`**Parameters:**`,'- `docName` — Target page docName, typically without extension (for example, "articles/project-alpha"). A trailing `.md` or `.mdx` is stripped automatically.'].join(`
+`);function Xn(e,t){e.tool(`get_backlinks`,Yn,{docName:N.string().describe(`Target page docName`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=R(e.docName);if(!r.ok)return P(r.error,!0);let i=await z(n,`/api/backlinks?docName=${encodeURIComponent(r.docName)}`);if(!i.ok)return P(`Error: ${i.error}`,!0);let{ok:a,...o}=i,s=o,{resolve:c,ui:l}=await H(t),u=(s.backlinks??[]).map(e=>{let t=typeof e.source==`string`?e.source:null,n=t?c(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),d={...s,backlinks:u,ui:l};return F(JSON.stringify(d,null,2),d)})}const Zn=[`[Requires: Hocuspocus server] Find missing internal page targets across the corpus.`,`Returns grouped dead links keyed by missing target with source-doc rows as JSON.`,``,`**Parameters:**`,"- `sourceDocNames` (optional) — Referring source docs to narrow the audit with OR semantics"].join(`
+`);function Qn(e,t){e.tool(`get_dead_links`,Zn,{sourceDocNames:N.array(N.string()).optional().describe(`Referring source docs to narrow the audit with OR semantics`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=new URLSearchParams;for(let t of e.sourceDocNames??[]){let e=R(t);if(!e.ok)return P(e.error,!0);r.append(`sourceDocName`,e.docName)}let i=r.toString(),a=await z(n,`/api/dead-links${i?`?${i}`:``}`);if(!a.ok)return P(`Error: ${a.error}`,!0);let{ok:o,...s}=a,c=s,{resolve:l,ui:u}=await H(t),d=(c.deadLinks??[]).map(e=>{let t=typeof e.target==`string`?e.target:null,n=t?l(t):null,r=(e.sources??[]).map(e=>{let t=typeof e.source==`string`?e.source:null,n=t?l(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}});return{...e,sources:r,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),f={...c,deadLinks:d,ui:u};return F(JSON.stringify(f,null,2),f)})}const $n=[`[Requires: Hocuspocus server] Find all pages that a given page links to.`,`Returns forward links as JSON.`,``,`**Parameters:**`,"- `docName` — Source page docName, typically without extension. A trailing `.md` or `.mdx` is stripped automatically."].join(`
+`);function er(e,t){e.tool(`get_forward_links`,$n,{docName:N.string().describe(`Source page docName`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=R(e.docName);if(!r.ok)return P(r.error,!0);let i=await z(n,`/api/forward-links?docName=${encodeURIComponent(r.docName)}`);if(!i.ok)return P(`Error: ${i.error}`,!0);let{ok:a,...o}=i,s=o,{resolve:c,ui:l}=await H(t),u=(s.forwardLinks??[]).map(e=>{let t=e.kind===`doc`&&typeof e.docName==`string`?e.docName:null,n=t?c(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),d={...s,forwardLinks:u,ui:l};return F(JSON.stringify(d,null,2),d)})}const tr=[`[Requires: Hocuspocus server] List version history for a document.`,`Returns timeline entries from the shadow repo, sorted by timestamp descending.`,"Each entry includes a commit SHA that can be passed to `rollback_to_version`.",``,`**Parameters:**`,"- `docName` — Document name to query history for, typically without extension. A trailing `.md` or `.mdx` is stripped automatically.","- `branch` (optional) — Branch name (default: current branch)","- `limit` (optional) — Maximum entries to return (default 50, max 200)","- `offset` (optional) — Number of entries to skip for pagination (default 0)",'- `type` (optional) — Filter by entry type: "checkpoint", "upstream", or "wip"',"- `author` (optional) — Filter to entries by this author name or email","- `excludeAuthor` (optional) — Exclude entries by this author name or email"].join(`
+`);function nr(e,t){e.tool(`get_history`,tr,{docName:N.string().describe(`Document name to query history for`),branch:N.string().optional().describe(`Branch name (default: current branch)`),limit:N.number().int().min(1).max(200).optional().describe(`Maximum entries to return (default 50, max 200)`),offset:N.number().int().min(0).optional().describe(`Number of entries to skip for pagination (default 0)`),type:N.enum([`checkpoint`,`upstream`,`wip`]).optional().describe(`Filter by entry type`),author:N.string().optional().describe(`Filter to entries by this author name or email`),excludeAuthor:N.string().optional().describe(`Exclude entries by this author name or email`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=R(e.docName);if(!r.ok)return P(r.error,!0);let i=new URLSearchParams;i.set(`docName`,r.docName),e.branch&&i.set(`branch`,e.branch),e.limit!=null&&i.set(`limit`,String(e.limit)),e.offset!=null&&i.set(`offset`,String(e.offset)),e.type&&i.set(`type`,e.type),e.author&&i.set(`author`,e.author),e.excludeAuthor&&i.set(`excludeAuthor`,e.excludeAuthor);let a=await z(n,`/api/history?${i.toString()}`);if(!a.ok)return P(`Error: ${a.error}`,!0);let{ok:o,...s}=a,c=await V(r.docName,{config:t.config,resolveCwd:t.resolveCwd});return F(JSON.stringify(s,null,2),{...s,previewUrl:c?.url??null,...c?{previewUrlSource:c.source}:{}})})}const rr=[`[Requires: Hocuspocus server] Find the most-linked pages in the knowledge graph.`,`Returns hub pages ordered by inbound link count as JSON.`,``,`**Parameters:**`,"- `limit` (optional) — Maximum number of hubs to return (default 20)"].join(`
+`);function ir(e,t){e.tool(`get_hubs`,rr,{limit:N.number().int().positive().optional().describe(`Maximum number of hubs to return`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=await z(n,`/api/hubs${e.limit?`?limit=${encodeURIComponent(String(e.limit))}`:``}`);if(!r.ok)return P(`Error: ${r.error}`,!0);let{ok:i,...a}=r,o=a,{resolve:s,ui:c}=await H(t),l=(o.hubs??[]).map(e=>{let t=typeof e.docName==`string`?e.docName:null,n=t?s(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),u={...o,hubs:l,ui:c};return F(JSON.stringify(u,null,2),u)})}const ar=[`[Requires: Hocuspocus server] Find disconnected pages in the knowledge graph.`,`Returns orphaned pages as JSON.`,``,`**Parameters:**`,"- `mode` (optional) — Orphan lens: `incoming`, `outgoing`, or `both` (default `both`)"].join(`
+`);function or(e,t){e.tool(`get_orphans`,ar,{mode:N.enum(u).optional().describe(`Filter which type of graph disconnection to surface`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=await z(n,`/api/orphans${e.mode?`?mode=${encodeURIComponent(e.mode)}`:``}`);if(!r.ok)return P(`Error: ${r.error}`,!0);let{ok:i,...a}=r,o=a,{resolve:s,ui:c}=await H(t),l=(o.orphans??[]).map(e=>{let t=typeof e.docName==`string`?e.docName:null,n=t?s(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),u={...o,orphans:l,ui:c};return F(JSON.stringify(u,null,2),u)})}const sr=["Return a browser URL for the given wiki docName. Agents should call this IMMEDIATELY BEFORE `write_document` / `edit_document` so they can navigate the preview browser to the doc first and watch the CRDT edit land live.",``,`**Parameters:**`,"- `docName` — Wiki doc name, typically without extension.",``,"Returns `{ previewUrl, previewUrlSource }` (source: `env` / `lock` / `config`). When no source is configured, returns `{ previewUrl: null }` and the agent may proceed without navigation."].join(`
+`);async function cr(e,t){let n=R(e.docName);if(!n.ok)return{ok:!1,error:n.error};let r=n.docName,i=await t.resolveCwd(),a=h(t.config,i),o;try{o=c({projectDir:i,contentDir:a,includePatterns:t.config.content.include,excludePatterns:t.config.content.exclude})}catch(e){return{ok:!1,error:`Cannot evaluate content filter: ${e instanceof Error?e.message:String(e)}`}}if(![`${r}.md`,`${r}.mdx`].some(e=>!o.isExcluded(e)))return{ok:!1,error:`Error: docName "${r}" is not inside content.include globs (${t.config.content.include.join(`, `)}). This tool only returns URLs for docs that match those globs.`};let s=m(a),l=U(r,{config:t.config,lockDir:s});return l?{ok:!0,result:{previewUrl:l.url,previewUrlSource:l.source},text:`Preview URL for "${r}" (source: ${l.source}):\n${l.url}`}:{ok:!0,result:{previewUrl:null},text:`No preview URL resolvable for "${r}". The server is likely not running yet. Start it with \`open-knowledge start\` (or \`preview_start\`), then **call \`get_preview_url\` again** — the server writes a lock file that this tool reads to resolve the URL. NEVER guess or manually construct the preview URL. Alternatively, set \`OPEN_KNOWLEDGE_PREVIEW_BASE_URL\` or add \`preview.baseUrl\` to .open-knowledge/config.yml.`}}function lr(e,t){e.tool(`get_preview_url`,sr,{docName:N.string().min(1)},async e=>{let n=await cr(e,t);return n.ok?F(n.text,n.result):P(n.error,!0)})}function ur(e,t){return`Capture this external source into the project knowledge base as raw reference material. **Raw preservation only** — no summary, no analysis, no interpretation. Summarizing is the job of the \`research\` tool later.
 
 Source: ${e}
 
@@ -218,8 +226,8 @@ tags:
 - **No promotion to a canonical article** — that's the \`consolidate\` tool's job, later
 - **No deduplication** — if the same source is ingested twice, let it happen; cleanup is a separate concern
 
-Full convention: read \`${d}/AGENTS.md\`.`}const bn=[`Fetch an external source (URL or local file) and save raw content as reference material in the project content directory.`,`Raw preservation only — no analysis or interpretation.`,``,`**Use when:**`,`- Capturing reference material for the project knowledge base`,`- Saving a URL or document for later research`,`- Archiving an external source alongside the codebase`,`- The user shares a URL or document they want preserved`,``,`**Triggers on:**`,`- "ingest", "save this source", "capture this URL", "add to external sources"`,`- User shares a URL, article, or document to preserve in the knowledge base`,`- Research workflow needs raw sources before analysis`].join(`
-`);function xn(e,t){e.tool(`ingest`,bn,{source:P.string().describe(`URL, file path, or identifier of the source to ingest`)},e=>I(yn(e.source,t.content.dir),{previewUrl:null}))}function Sn(e){return`Initialize a project knowledge base at \`${e}\` for this repository.
+Full convention: read \`${d}/AGENTS.md\`.`}const dr=[`Fetch an external source (URL or local file) and save raw content as reference material in the project content directory.`,`Raw preservation only — no analysis or interpretation.`,``,`**Use when:**`,`- Capturing reference material for the project knowledge base`,`- Saving a URL or document for later research`,`- Archiving an external source alongside the codebase`,`- The user shares a URL or document they want preserved`,``,`**Triggers on:**`,`- "ingest", "save this source", "capture this URL", "add to external sources"`,`- User shares a URL, article, or document to preserve in the knowledge base`,`- Research workflow needs raw sources before analysis`].join(`
+`);function fr(e,t){e.tool(`ingest`,dr,{source:N.string().describe(`URL, file path, or identifier of the source to ingest`)},e=>F(ur(e.source,t.content.dir),{previewUrl:null}))}function pr(e){return`Initialize a project knowledge base at \`${e}\` for this repository.
 
 The content directory for this project is **\`${e}\`** (from \`${d}/config.yml\`).
 
@@ -314,16 +322,16 @@ Depending on the project, consider articles covering:
 - **Don't write articles for things that change often** (dependency versions, file counts); focus on stable understanding
 - **Don't create scaffolded subfolders you won't fill** — empty \`articles/\`/\`research/\`/\`external-sources/\` folders are clutter; organize as you actually need
 
-Full convention: read \`${d}/AGENTS.md\`.`}const Cn=[`Bootstrap the project knowledge base by reading the codebase and writing initial knowledge articles grouped by topic.`,``,`**Use when:**`,`- Setting up a knowledge base for the first time in a repo`,`- Onboarding to a new codebase and capturing initial understanding`,`- The content directory is empty or sparse`,``,`**Triggers on:**`,`- "init content", "bootstrap knowledge base", "populate articles", "set up project knowledge"`,`- User asks to document or catalog the codebase`].join(`
-`);function wn(e,t){e.tool(`init-content`,Cn,async()=>{let e=Sn(t.config.content.dir),n=await t.resolveCwd(),r=m(h(t.config,n));return I(e,{ui:Oe({config:t.config,lockDir:r})})})}const Tn=[`[Requires: Hocuspocus server] List available documents from the Hocuspocus server.`,`Returns document names, optionally filtered by directory.`,``,`**Parameters:**`,"- `dir` (optional) — Filter to documents in this directory"].join(`
-`);function En(e,t){e.tool(`list_documents`,Tn,{dir:P.string().optional().describe(`Optional directory to filter documents`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=await B(n,`/api/documents${e.dir?`?dir=${encodeURIComponent(e.dir)}`:``}`);if(!r.ok)return F(`Error: ${r.error}`,!0);let{ok:i,...a}=r,o=a,{resolve:s,ui:c}=await U(t),l=(o.documents??[]).map(e=>{let t=typeof e.docName==`string`?e.docName:null,n=t?s(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),u={...o,documents:l,ui:c};return I(JSON.stringify(u,null,2),u)})}const Dn=[`Read a wiki file with enriched context: contents + frontmatter metadata + recent shadow-repo activity (agent vs human attribution) + backlink/forward-link context.`,``,`**Use when:**`,`- Loading an article for context`,`- Understanding who changed a file recently and whether it was an agent or human`,`- Seeing how this page links out and what links back to it`,``,"Prefer this over your native `Read` for wiki files — one call returns what otherwise takes 3-4.",``,`**Parameters:**`,"- `path` — Project-root-relative path to the file, including extension (e.g. `articles/auth/sso.md`). To pass this document to `edit_document` / `write_document` / `get_backlinks`, strip the extension (they take extension-less `docName`).","- `since` (reserved) — Reserved for shadow-log since-filter; currently unused."].join(`
-`);function On(e){if(!e||e.length===0)return``;let t=[``,`### Recent activity (OK edits)`,``];for(let n of e){let e=n.writerClassification===`agent`?`agent: ${n.writerName}`:n.writerClassification===`human`?`human: ${n.writerName}`:`${n.writerClassification}: ${n.writerName}`,r=n.hash.slice(0,7);t.push(`- ${r} ${n.date} [${e}] ${n.message}`)}return t.join(`
-`)}function kn(e){if(!e||e.length===0)return``;let t=[``,`### Commit history (project git)`,``];for(let n of e){let e=n.hash.slice(0,7);t.push(`- ${e} ${n.date} ${n.authorName} — ${n.subject}`)}return t.join(`
-`)}function An(e){if(!e||e.length===0)return``;let t=[``,`### Backlinks (${e.length})`,``];for(let n of e){let e=n.title?` — "${n.title}"`:``,r=n.snippet?` — "${n.snippet}"`:``;t.push(`- ${n.source}${e}${r}`)}return t.join(`
-`)}function jn(e){if(!e||e.length===0)return``;let t=[``,`### Forward links (${e.length})`,``];for(let n of e){if(n.kind===`external`){let e=n.title?` — "${n.title}"`:``,r=n.snippet?` — "${n.snippet}"`:``;t.push(`- ${n.url}${e}${r}`);continue}let e=n.title?` — "${n.title}"`:``,r=n.snippet?` — "${n.snippet}"`:``;t.push(`- ${n.docName}${e}${r}`)}return t.join(`
-`)}function Mn(e){return e.replace(/^\.\//,``).replace(/^\/+/,``)}function Nn(e){return e.replace(/\.(md|mdx)$/i,``)}async function Pn(e,t){let n=await t.resolveCwd(e.cwd),r=Mn(e.path),i=N(n,r),a=t.config.mcp.tools.read_document.historyDepth,o=await R(t.serverUrl),[s,c]=await Promise.all([re(i,`utf-8`),Rt(r,{projectDir:n,serverUrl:o,historyDepth:a,folderRules:t.config.folders},{includeRichFields:!0})]),l=r.split(`/`).pop()?.replace(/\.md$/,``).replace(/\.mdx$/,``)??r,u=c.title??l,d=c.description??``,f=c.tags,p=[];p.push(`## ${u}`),d&&p.push(`**Description:** ${d}`),f.length>0&&p.push(`**Tags:** ${f.join(`, `)}`),p.push(`**Path:** ${r}`);let m=On(c.history);m&&p.push(m);let h=kn(c.projectHistory);h&&p.push(h);let g=An(c.backlinks);g&&p.push(g);let _=jn(c.forwardLinks);return _&&p.push(_),p.push(``,`### Content`,``,s),p.join(`
-`)}function Fn(e,t){e.tool(`read_document`,Dn,{path:P.string().describe(`Project-root-relative path to the file`),since:P.string().optional().describe(`Reserved; currently unused (§15 Future Work)`),cwd:P.string().optional().describe("Absolute host path to resolve `path` against. Defaults to the MCP client's first advertised root.")},async e=>{try{let n=await Pn(e,t),r=await H(Nn(Mn(e.path)),{config:t.config,resolveCwd:t.resolveCwd});return r?I(n,{previewUrl:r.url,previewUrlSource:r.source}):I(n,{previewUrl:null})}catch(e){return F(`Error: ${e instanceof Error?e.message:String(e)}`,!0)}})}const In=["[Requires: Hocuspocus server] Rename a document through the managed rename flow at `POST /api/rename`.",`Renames the target document and rewrites inbound wiki-links plus supported internal inline Markdown links in affected docs.`,``,`**Parameters:**`,"- `docName` — Current document name, typically without extension. A trailing `.md` or `.mdx` is stripped automatically.","- `newDocName` — New document name, typically without extension. A trailing `.md` or `.mdx` is stripped automatically."].join(`
-`);function Ln(e){return Array.isArray(e)?e.flatMap(e=>{if(!e||typeof e!=`object`)return[];let{fromDocName:t,toDocName:n}=e;return typeof t==`string`&&typeof n==`string`?[{fromDocName:t,toDocName:n}]:[]}):[]}function Rn(e){return Array.isArray(e)?e.flatMap(e=>{if(!e||typeof e!=`object`)return[];let{docName:t,rewrites:n}=e;return typeof t==`string`&&typeof n==`number`?[{docName:t,rewrites:n}]:[]}):[]}function zn(e,t,n=`${t}s`){return e===1?t:n}function Bn(e,t){e.tool(`rename_document`,In,{docName:P.string().describe(`Current document name`),newDocName:P.string().describe(`New document name`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=z(e.docName);if(!r.ok)return F(r.error,!0);let i=z(e.newDocName);if(!i.ok)return F(i.error,!0);let a=await V(n,`/api/rename`,{docName:r.docName,newDocName:i.docName});if(!a.ok){let e=typeof a.error==`string`?a.error:`Rename failed`,t={ok:!1,error:e};return I(`Error: ${e}`,t,!0)}let o=Ln(a.renamed),s=Rn(a.rewrittenDocs),c=o.map(({fromDocName:e,toDocName:t})=>`${e} -> ${t}`).join(`, `)||`${r.docName} -> ${i.docName}`,l=s.length===0?`No inbound links required updates.`:`Rewrote ${s.length} ${zn(s.length,`document`)}.`,u={config:t.config,resolveCwd:t.resolveCwd},d=await H(i.docName,u),f=await H(r.docName,u),p={ok:!0,renamed:o,rewrittenDocs:s,previewUrl:d?.url??null,...d?{previewUrlSource:d.source}:{},...f?{previousPreviewUrl:f.url}:{}};return I(`Renamed ${c}. ${l}`,p)})}function Vn(e,t){return`Research this topic and write provisional findings inside the project content directory. Research is **provisional, not canonical** — it captures findings, trade-offs, and open questions at a point in time. Promoting to canonical articles is a deliberate later step (via the \`consolidate\` tool).
+Full convention: read \`${d}/AGENTS.md\`.`}const mr=[`Bootstrap the project knowledge base by reading the codebase and writing initial knowledge articles grouped by topic.`,``,`**Use when:**`,`- Setting up a knowledge base for the first time in a repo`,`- Onboarding to a new codebase and capturing initial understanding`,`- The content directory is empty or sparse`,``,`**Triggers on:**`,`- "init content", "bootstrap knowledge base", "populate articles", "set up project knowledge"`,`- User asks to document or catalog the codebase`].join(`
+`);function hr(e,t){e.tool(`init-content`,mr,async()=>{let e=pr(t.config.content.dir),n=await t.resolveCwd(),r=m(h(t.config,n));return F(e,{ui:yt({config:t.config,lockDir:r})})})}const gr=[`[Requires: Hocuspocus server] List available documents from the Hocuspocus server.`,`Returns document names, optionally filtered by directory.`,``,`**Parameters:**`,"- `dir` (optional) — Filter to documents in this directory"].join(`
+`);function _r(e,t){e.tool(`list_documents`,gr,{dir:N.string().optional().describe(`Optional directory to filter documents`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=await z(n,`/api/documents${e.dir?`?dir=${encodeURIComponent(e.dir)}`:``}`);if(!r.ok)return P(`Error: ${r.error}`,!0);let{ok:i,...a}=r,o=a,{resolve:s,ui:c}=await H(t),l=(o.documents??[]).map(e=>{let t=typeof e.docName==`string`?e.docName:null,n=t?s(t):null;return{...e,previewUrl:n?.url??null,...n?{previewUrlSource:n.source}:{}}}),u={...o,documents:l,ui:c};return F(JSON.stringify(u,null,2),u)})}const vr=[`Read a wiki file with enriched context: contents + frontmatter metadata + recent shadow-repo activity (agent vs human attribution) + backlink/forward-link context.`,``,`**Use when:**`,`- Loading an article for context`,`- Understanding who changed a file recently and whether it was an agent or human`,`- Seeing how this page links out and what links back to it`,``,"Prefer this over your native `Read` for wiki files — one call returns what otherwise takes 3-4.",``,`**Parameters:**`,"- `path` — Project-root-relative path to the file, including extension (e.g. `articles/auth/sso.md`). To pass this document to `edit_document` / `write_document` / `get_backlinks`, strip the extension (they take extension-less `docName`).","- `since` (reserved) — Reserved for shadow-log since-filter; currently unused."].join(`
+`);function yr(e){if(!e||e.length===0)return``;let t=[``,`### Recent activity (OK edits)`,``];for(let n of e){let e=n.writerClassification===`agent`?`agent: ${n.writerName}`:n.writerClassification===`human`?`human: ${n.writerName}`:`${n.writerClassification}: ${n.writerName}`,r=n.hash.slice(0,7);t.push(`- ${r} ${n.date} [${e}] ${n.message}`)}return t.join(`
+`)}function br(e){if(!e||e.length===0)return``;let t=[``,`### Commit history (project git)`,``];for(let n of e){let e=n.hash.slice(0,7);t.push(`- ${e} ${n.date} ${n.authorName} — ${n.subject}`)}return t.join(`
+`)}function xr(e){if(!e||e.length===0)return``;let t=[``,`### Backlinks (${e.length})`,``];for(let n of e){let e=n.title?` — "${n.title}"`:``,r=n.snippet?` — "${n.snippet}"`:``;t.push(`- ${n.source}${e}${r}`)}return t.join(`
+`)}function Sr(e){if(!e||e.length===0)return``;let t=[``,`### Forward links (${e.length})`,``];for(let n of e){if(n.kind===`external`){let e=n.title?` — "${n.title}"`:``,r=n.snippet?` — "${n.snippet}"`:``;t.push(`- ${n.url}${e}${r}`);continue}let e=n.title?` — "${n.title}"`:``,r=n.snippet?` — "${n.snippet}"`:``;t.push(`- ${n.docName}${e}${r}`)}return t.join(`
+`)}function Cr(e){return e.replace(/^\.\//,``).replace(/^\/+/,``)}function wr(e){return e.replace(/\.(md|mdx)$/i,``)}async function Tr(e,t){let n=await t.resolveCwd(e.cwd),r=Cr(e.path),i=j(n,r),a=t.config.mcp.tools.read_document.historyDepth,o=await L(t.serverUrl),[s,c]=await Promise.all([ve(i,`utf-8`),An(r,{projectDir:n,serverUrl:o,historyDepth:a,folderRules:t.config.folders},{includeRichFields:!0})]),l=r.split(`/`).pop()?.replace(/\.md$/,``).replace(/\.mdx$/,``)??r,u=c.title??l,d=c.description??``,f=c.tags,p=[];p.push(`## ${u}`),d&&p.push(`**Description:** ${d}`),f.length>0&&p.push(`**Tags:** ${f.join(`, `)}`),p.push(`**Path:** ${r}`);let m=yr(c.history);m&&p.push(m);let h=br(c.projectHistory);h&&p.push(h);let g=xr(c.backlinks);g&&p.push(g);let _=Sr(c.forwardLinks);return _&&p.push(_),p.push(``,`### Content`,``,s),p.join(`
+`)}function Er(e,t){e.tool(`read_document`,vr,{path:N.string().describe(`Project-root-relative path to the file`),since:N.string().optional().describe(`Reserved; currently unused (§15 Future Work)`),cwd:N.string().optional().describe("Absolute host path to resolve `path` against. Defaults to the MCP client's first advertised root.")},async e=>{try{let n=await Tr(e,t),r=await V(wr(Cr(e.path)),{config:t.config,resolveCwd:t.resolveCwd});return r?F(n,{previewUrl:r.url,previewUrlSource:r.source}):F(n,{previewUrl:null})}catch(e){return P(`Error: ${e instanceof Error?e.message:String(e)}`,!0)}})}const Dr=["[Requires: Hocuspocus server] Rename a document through the managed rename flow at `POST /api/rename`.",`Renames the target document and rewrites inbound wiki-links plus supported internal inline Markdown links in affected docs.`,``,`**Parameters:**`,"- `docName` — Current document name, typically without extension. A trailing `.md` or `.mdx` is stripped automatically.","- `newDocName` — New document name, typically without extension. A trailing `.md` or `.mdx` is stripped automatically."].join(`
+`);function Or(e){return Array.isArray(e)?e.flatMap(e=>{if(!e||typeof e!=`object`)return[];let{fromDocName:t,toDocName:n}=e;return typeof t==`string`&&typeof n==`string`?[{fromDocName:t,toDocName:n}]:[]}):[]}function kr(e){return Array.isArray(e)?e.flatMap(e=>{if(!e||typeof e!=`object`)return[];let{docName:t,rewrites:n}=e;return typeof t==`string`&&typeof n==`number`?[{docName:t,rewrites:n}]:[]}):[]}function Ar(e,t,n=`${t}s`){return e===1?t:n}function jr(e,t){e.tool(`rename_document`,Dr,{docName:N.string().describe(`Current document name`),newDocName:N.string().describe(`New document name`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=R(e.docName);if(!r.ok)return P(r.error,!0);let i=R(e.newDocName);if(!i.ok)return P(i.error,!0);let a=await B(n,`/api/rename`,{docName:r.docName,newDocName:i.docName});if(!a.ok){let e=typeof a.error==`string`?a.error:`Rename failed`,t={ok:!1,error:e};return F(`Error: ${e}`,t,!0)}let o=Or(a.renamed),s=kr(a.rewrittenDocs),c=o.map(({fromDocName:e,toDocName:t})=>`${e} -> ${t}`).join(`, `)||`${r.docName} -> ${i.docName}`,l=s.length===0?`No inbound links required updates.`:`Rewrote ${s.length} ${Ar(s.length,`document`)}.`,u={config:t.config,resolveCwd:t.resolveCwd},d=await V(i.docName,u),f=await V(r.docName,u),p={ok:!0,renamed:o,rewrittenDocs:s,previewUrl:d?.url??null,...d?{previewUrlSource:d.source}:{},...f?{previousPreviewUrl:f.url}:{}};return F(`Renamed ${c}. ${l}`,p)})}function Mr(e,t){return`Research this topic and write provisional findings inside the project content directory. Research is **provisional, not canonical** — it captures findings, trade-offs, and open questions at a point in time. Promoting to canonical articles is a deliberate later step (via the \`consolidate\` tool).
 
 Topic: ${e}
 
@@ -473,15 +481,15 @@ Research articles are discovery surfaces — they should link out to **every** r
 - **Don't skip \`ingest\`** — always capture raw sources first, then analyze
 - **Don't overwrite existing research** — if the topic was researched before, either iterate on the existing file or create a clearly-named successor (e.g., \`crdt-alternatives-2.md\`) and mark the old one as superseded
 
-Full convention: read \`${d}/AGENTS.md\`.`}const Hn=[`Analyze a topic by gathering sources via ingest and writing provisional findings into the project content directory.`,`Provisional, not canonical — findings live here until decisions solidify.`,``,`**Use when:**`,`- Researching a topic before committing to an approach`,`- Exploring a decision space or comparing alternatives`,`- Synthesizing multiple sources into structured analysis`,`- Spec conversations and exploratory work that is not yet canonical`,``,`**Triggers on:**`,`- "research", "investigate", "compare options for", "analyze alternatives"`,`- User asks to explore trade-offs, gather evidence, or evaluate approaches`,`- A decision needs structured analysis grounded in external sources`].join(`
-`);function Un(e,t){e.tool(`research`,Hn,{topic:P.string().describe(`The topic, question, or anchor URL to research`)},e=>I(Vn(e.topic,t.content.dir),{previewUrl:null}))}const Wn=[`[Requires: Hocuspocus server] Restore a document to a historical version via the CRDT layer.`,`The restore is append-only — it creates a new version with the old content,`,`preserving all history. All connected editors see the change in real-time.`,``,`**Parameters:**`,"- `docName` — Document name to restore, typically without extension. A trailing `.md` or `.mdx` is stripped automatically.","- `commitSha` — The 40-character SHA of the shadow repo commit to restore to.","  Use `get_history` to find available versions."].join(`
-`);function Gn(e,t){e.tool(`rollback_to_version`,Wn,{docName:P.string().describe(`Document name to restore`),commitSha:P.string().length(40).regex(/^[0-9a-f]+$/i).describe(`40-character commit SHA from the shadow repo timeline`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=z(e.docName);if(!r.ok)return F(r.error,!0);let i=r.docName,a=await B(n,`/api/history/${e.commitSha}?docName=${encodeURIComponent(i)}`);if(!a.ok)return F(`Error: ${a.error??`Version not found`}`,!0);let o=await V(n,`/api/rollback`,{docName:i,commitSha:e.commitSha});if(!o.ok)return F(`Error: ${o.error}`,!0);let s=`Restored "${i}" to version ${e.commitSha.slice(0,8)} (${a.author}, ${a.timestamp}). The change has been applied to all connected editors.`,c=await H(i,{config:t.config,resolveCwd:t.resolveCwd});return I(s,{previewUrl:c?.url??null,...c?{previewUrlSource:c.source}:{}})})}const Kn=[`[Requires: Hocuspocus server] Save a version checkpoint of all documents.`,`Creates a checkpoint commit in the shadow repo and project repo,`,`preserving the current state of all documents. The checkpoint can later`,"be found via `get_history` and restored via `rollback_to_version`."].join(`
-`);function qn(e,t,n){e.tool(`save_version`,Kn,{},async()=>{let e=await R(t);if(!e)return F(L,!0);let r=n?.current,i=await V(e,`/api/save-version`,{...r?{writers:[{id:`agent-${r.connectionId}`,name:r.displayName,email:`agent-${r.connectionId}@openknowledge.local`}]}:{}});return i.ok?I(`Version saved. Checkpoint ref: ${i.checkpointRef}`,{checkpointRef:i.checkpointRef,previewUrl:null}):F(`Error: ${i.error}`,!0)})}const Jn=[`Search wiki content with metadata-enriched results. Matches are grouped by file; each file is annotated with its title, description, and tags so you can judge relevance without opening it first.`,``,`**Use when:**`,`- Finding all articles mentioning a topic`,`- Locating a specific term across the wiki before deciding which file to read`,``,"Prefer this over your native `Grep` for wiki search — results include article metadata so you can skip irrelevant matches without extra reads.",``,`**Parameters:**`,"- `query` — Literal text to search for (fixed-string match, no regex)","- `case_sensitive` (optional, default false) — case-sensitive match"].join(`
-`);function Yn(e){let t=new Map;for(let n of e){let e=t.get(n.path);e?e.push(n):t.set(n.path,[n])}return[...t.entries()].map(([e,t])=>({path:e,matches:t}))}async function Xn(e,t){let n=await t.resolveCwd(e.cwd),r=t.config.mcp.tools.search.maxResults,i=t.config.content.include,a=t.config.content.exclude,o=await qe(e.query,n,{caseInsensitive:!(e.case_sensitive??!1),include:i,exclude:[...a,`node_modules`,`.git`,`.claude`,`.changeset`,d],maxResults:r+1}),s=o.length>r,c=s?o.slice(0,r):o,{resolve:l,ui:u}=await U({config:t.config,resolveCwd:async()=>n});if(c.length===0)return{text:`No matches for "${e.query}".`,structured:{query:e.query,matchCount:0,fileCount:0,truncated:!1,results:[],ui:u}};let f=Yn(c),p=new Map,m=await R(t.serverUrl),h=t.config.folders;await Promise.all(f.map(async e=>{try{let t=await Rt(e.path,{projectDir:n,serverUrl:m,folderRules:h});p.set(e.path,t)}catch{}}));let g=[];g.push(`## Search results for "${e.query}" (${c.length} match${c.length===1?``:`es`} in ${f.length} file${f.length===1?``:`s`})`,``);let _=[];for(let e of f){let t=p.get(e.path),n=t?.title??e.path;g.push(`### ${n} (${e.path})`),t?.tags?.length&&g.push(`Tags: ${t.tags.join(`, `)}`),t?.description&&g.push(`${t.description}`);for(let t of e.matches)g.push(`- Line ${t.line}: ${t.text}`);g.push(``);let r=ke(e.path),i=l(r);_.push({path:e.path,docName:r,title:t?.title??null,description:t?.description??null,tags:t?.tags??[],matches:e.matches.map(e=>({line:e.line,text:e.text})),previewUrl:i?.url??null,...i?{previewUrlSource:i.source}:{}})}return s&&g.push(`_${c.length} of ${o.length}+ matches shown. Raise \`mcp.tools.search.maxResults\` in config.yml to see more._`),{text:g.join(`
-`),structured:{query:e.query,matchCount:c.length,fileCount:f.length,truncated:s,results:_,ui:u}}}function Zn(e,t){e.tool(`search`,Jn,{query:P.string().describe(`Literal text to search for`),case_sensitive:P.boolean().optional().describe(`Case-sensitive search (default false)`),cwd:P.string().optional().describe(`Absolute host path to search in. Defaults to the MCP client's first advertised root.`)},async e=>{try{let{text:n,structured:r}=await Xn(e,t);return r?I(n,r):F(n)}catch(e){return F(`Error: ${e instanceof Error?e.message:String(e)}`,!0)}})}const Qn=[`[Requires: Hocuspocus server] Find missing link candidates for a target page.`,"Returns JSON with structure: `{ target: { docName, title, aliases }, mentions: [{ source, excerpt, offset }], truncated }`.","Each mention includes an `offset` you can pass to `edit_document` for precision patching.","When `truncated` is true, the scan hit its time budget before reading every admitted document.",``,`**Parameters:**`,'- `docName` — Target page docName, typically without extension (for example, "articles/project-alpha"). A trailing `.md` or `.mdx` is stripped automatically.'].join(`
-`);function $n(e,t){e.tool(`suggest_links`,Qn,{docName:P.string().describe(`Target page docName`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=z(e.docName);if(!r.ok)return F(r.error,!0);let i=await B(n,`/api/suggest-links?docName=${encodeURIComponent(r.docName)}`);if(!i.ok)return F(`Error: ${i.error}`,!0);let{ok:a,...o}=i,s=await H(r.docName,{config:t.config,resolveCwd:t.resolveCwd});return I(JSON.stringify(o,null,2),{...o,previewUrl:s?.url??null,...s?{previewUrlSource:s.source}:{}})})}const er=["**IMPORTANT: Before calling this tool, you MUST first call `get_preview_url` and navigate to the returned URL in your preview browser. If `get_preview_url` returns null, start the server first (`open-knowledge start` or `preview_start`), then call `get_preview_url` again. Do NOT call this tool without the preview open. NEVER manually construct the URL.**",``,`[Requires: Hocuspocus server] Write markdown content to a document via the CRDT layer.`,`Content is applied through Hocuspocus and propagated to all connected editors in real-time.`,``,'**Link liberally.** Every noun-phrase that names another document in this knowledge base should be a `[[wiki-link]]`, not plain prose. Backlinks are the primary navigation surface — underlinked documents become islands. Redlinks (links to pages that don\'t exist yet) are fine; they signal "this should exist." Prefer `[[Page Name]]` over Markdown `[text](./page.md)` — only wiki-links participate in the backlinks index.',``,`**Parameters:**`,'- `docName` — Document name, typically without extension (e.g., "my-doc" or "notes/meeting"). A trailing `.md` or `.mdx` is stripped automatically. New documents are created as `.md` by default; to create a `.mdx` file, first place it on disk, then use this tool for edits.',"- `markdown` — Markdown content to write",'- `position` — Where to insert: "append", "prepend", or "replace"'].join(`
-`);function tr(e,t){e.tool(`write_document`,er,{docName:P.string().describe(`Document name to write to`),markdown:P.string().describe(`Markdown content to write`),position:P.enum([`append`,`prepend`,`replace`]).describe(`Where to insert the content`)},async e=>{let n=await R(t.serverUrl);if(!n)return F(L,!0);let r=z(e.docName);if(!r.ok)return F(r.error,!0);let i=t.identityRef?.current,a=await V(n,`/api/agent-write-md`,{docName:r.docName,markdown:e.markdown,position:e.position,...i?{agentId:i.connectionId,agentName:i.displayName,clientName:i.clientInfo?.name,colorSeed:i.colorSeed}:{}});if(!a.ok)return F(`Error: ${a.error}`,!0);let o=await t.resolveCwd(),s=m(h(t.config,o)),c=W(r.docName,{config:t.config,lockDir:s}),l=(typeof a.subscriberCount==`number`?a.subscriberCount:void 0)===0,u=Array.isArray(a.hints)?a.hints:void 0,d=[`Written successfully (${e.position}).`];if(c&&d.push(`Preview: ${c.url}`),l&&d.push(c?`Warning: no preview is currently attached to "${r.docName}". Open ${c.url} to watch future edits live.`:`Warning: no preview is currently attached to "${r.docName}".`),u)for(let e of u)e.message&&d.push(e.message);let f=d.join(`
-`);if(!c&&!l&&!u)return F(f);let p={};return c&&(p.previewUrl=c.url,p.previewUrlSource=c.source),l&&(p.warning={message:`No preview attached to ${r.docName}.`,previewUrl:c?.url??null}),u&&(p.hints=u),I(f,p)})}const nr={exec:Ut,"init-content":Cn,ingest:bn,research:Hn,consolidate:Ce,read_document:Dn,rename_document:In,search:Jn,suggest_links:Qn,write_document:er,edit_document:Ae,get_history:un,save_version:Kn,rollback_to_version:Wn,list_documents:Tn,get_backlinks:rn,get_forward_links:cn,get_orphans:mn,get_hubs:fn,get_dead_links:on,get_preview_url:gn};function rr(e,t){nn(e,{resolveCwd:t.resolveCwd,serverUrl:t.serverUrl,config:t.config}),wn(e,{config:t.config,resolveCwd:t.resolveCwd}),xn(e,t.config),Un(e,t.config),we(e,t.config),Fn(e,{resolveCwd:t.resolveCwd,config:t.config,serverUrl:t.serverUrl}),Zn(e,{resolveCwd:t.resolveCwd,config:t.config,serverUrl:t.serverUrl}),$n(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),tr(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd,identityRef:t.identityRef}),je(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd,identityRef:t.identityRef}),Bn(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),dn(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),qn(e,t.serverUrl,t.identityRef),Gn(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),En(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),an(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),ln(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),hn(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),pn(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),sn(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),vn(e,{resolveCwd:t.resolveCwd,config:t.config})}function Z(e){process.stderr.write(`${v(`[mcp]`)} ${e}\n`)}function ir(e){let{dir:t,include:n,exclude:r}=e.content,i=r.length>0?r.map(e=>`\`${e}\``).join(`, `):`(none)`;return`# MCP Instructions v2 — exec-primary (2026-04-13)
+Full convention: read \`${d}/AGENTS.md\`.`}const Nr=[`Analyze a topic by gathering sources via ingest and writing provisional findings into the project content directory.`,`Provisional, not canonical — findings live here until decisions solidify.`,``,`**Use when:**`,`- Researching a topic before committing to an approach`,`- Exploring a decision space or comparing alternatives`,`- Synthesizing multiple sources into structured analysis`,`- Spec conversations and exploratory work that is not yet canonical`,``,`**Triggers on:**`,`- "research", "investigate", "compare options for", "analyze alternatives"`,`- User asks to explore trade-offs, gather evidence, or evaluate approaches`,`- A decision needs structured analysis grounded in external sources`].join(`
+`);function Pr(e,t){e.tool(`research`,Nr,{topic:N.string().describe(`The topic, question, or anchor URL to research`)},e=>F(Mr(e.topic,t.content.dir),{previewUrl:null}))}const Fr=[`[Requires: Hocuspocus server] Restore a document to a historical version via the CRDT layer.`,`The restore is append-only — it creates a new version with the old content,`,`preserving all history. All connected editors see the change in real-time.`,``,`**Parameters:**`,"- `docName` — Document name to restore, typically without extension. A trailing `.md` or `.mdx` is stripped automatically.","- `commitSha` — The 40-character SHA of the shadow repo commit to restore to.","  Use `get_history` to find available versions."].join(`
+`);function Ir(e,t){e.tool(`rollback_to_version`,Fr,{docName:N.string().describe(`Document name to restore`),commitSha:N.string().length(40).regex(/^[0-9a-f]+$/i).describe(`40-character commit SHA from the shadow repo timeline`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=R(e.docName);if(!r.ok)return P(r.error,!0);let i=r.docName,a=await z(n,`/api/history/${e.commitSha}?docName=${encodeURIComponent(i)}`);if(!a.ok)return P(`Error: ${a.error??`Version not found`}`,!0);let o=await B(n,`/api/rollback`,{docName:i,commitSha:e.commitSha});if(!o.ok)return P(`Error: ${o.error}`,!0);let s=`Restored "${i}" to version ${e.commitSha.slice(0,8)} (${a.author}, ${a.timestamp}). The change has been applied to all connected editors.`,c=await V(i,{config:t.config,resolveCwd:t.resolveCwd});return F(s,{previewUrl:c?.url??null,...c?{previewUrlSource:c.source}:{}})})}const Lr=[`[Requires: Hocuspocus server] Save a version checkpoint of all documents.`,`Creates a checkpoint commit in the shadow repo and project repo,`,`preserving the current state of all documents. The checkpoint can later`,"be found via `get_history` and restored via `rollback_to_version`."].join(`
+`);function Rr(e,t,n){e.tool(`save_version`,Lr,{},async()=>{let e=await L(t);if(!e)return P(I,!0);let r=n?.current,i=await B(e,`/api/save-version`,{...r?{writers:[{id:`agent-${r.connectionId}`,name:r.displayName,email:`agent-${r.connectionId}@openknowledge.local`}]}:{}});return i.ok?F(`Checkpoint saved. Checkpoint ref: ${i.checkpointRef}`,{checkpointRef:i.checkpointRef,previewUrl:null}):P(`Error: ${i.error}`,!0)})}const zr=[`Search wiki content with metadata-enriched results. Matches are grouped by file; each file is annotated with its title, description, and tags so you can judge relevance without opening it first.`,``,`**Use when:**`,`- Finding all articles mentioning a topic`,`- Locating a specific term across the wiki before deciding which file to read`,``,"Prefer this over your native `Grep` for wiki search — results include article metadata so you can skip irrelevant matches without extra reads.",``,`**Parameters:**`,"- `query` — Literal text to search for (fixed-string match, no regex)","- `case_sensitive` (optional, default false) — case-sensitive match"].join(`
+`);function Br(e){let t=new Map;for(let n of e){let e=t.get(n.path);e?e.push(n):t.set(n.path,[n])}return[...t.entries()].map(([e,t])=>({path:e,matches:t}))}async function Vr(e,t){let n=await t.resolveCwd(e.cwd),r=t.config.mcp.tools.search.maxResults,i=t.config.content.include,a=t.config.content.exclude,o=await Rt(e.query,n,{caseInsensitive:!(e.case_sensitive??!1),include:i,exclude:[...a,`node_modules`,`.git`,`.claude`,`.changeset`,d],maxResults:r+1}),s=o.length>r,c=s?o.slice(0,r):o,{resolve:l,ui:u}=await H({config:t.config,resolveCwd:async()=>n});if(c.length===0)return{text:`No matches for "${e.query}".`,structured:{query:e.query,matchCount:0,fileCount:0,truncated:!1,results:[],ui:u}};let f=Br(c),p=new Map,m=await L(t.serverUrl),h=t.config.folders;await Promise.all(f.map(async e=>{try{let t=await An(e.path,{projectDir:n,serverUrl:m,folderRules:h});p.set(e.path,t)}catch{}}));let g=[];g.push(`## Search results for "${e.query}" (${c.length} match${c.length===1?``:`es`} in ${f.length} file${f.length===1?``:`s`})`,``);let _=[];for(let e of f){let t=p.get(e.path),n=t?.title??e.path;g.push(`### ${n} (${e.path})`),t?.tags?.length&&g.push(`Tags: ${t.tags.join(`, `)}`),t?.description&&g.push(`${t.description}`);for(let t of e.matches)g.push(`- Line ${t.line}: ${t.text}`);g.push(``);let r=bt(e.path),i=l(r);_.push({path:e.path,docName:r,title:t?.title??null,description:t?.description??null,tags:t?.tags??[],matches:e.matches.map(e=>({line:e.line,text:e.text})),previewUrl:i?.url??null,...i?{previewUrlSource:i.source}:{}})}return s&&g.push(`_${c.length} of ${o.length}+ matches shown. Raise \`mcp.tools.search.maxResults\` in config.yml to see more._`),{text:g.join(`
+`),structured:{query:e.query,matchCount:c.length,fileCount:f.length,truncated:s,results:_,ui:u}}}function Hr(e,t){e.tool(`search`,zr,{query:N.string().describe(`Literal text to search for`),case_sensitive:N.boolean().optional().describe(`Case-sensitive search (default false)`),cwd:N.string().optional().describe(`Absolute host path to search in. Defaults to the MCP client's first advertised root.`)},async e=>{try{let{text:n,structured:r}=await Vr(e,t);return r?F(n,r):P(n)}catch(e){return P(`Error: ${e instanceof Error?e.message:String(e)}`,!0)}})}const Ur=[`[Requires: Hocuspocus server] Find missing link candidates for a target page.`,"Returns JSON with structure: `{ target: { docName, title, aliases }, mentions: [{ source, excerpt, offset }], truncated }`.","Each mention includes an `offset` you can pass to `edit_document` for precision patching.","When `truncated` is true, the scan hit its time budget before reading every admitted document.",``,`**Parameters:**`,'- `docName` — Target page docName, typically without extension (for example, "articles/project-alpha"). A trailing `.md` or `.mdx` is stripped automatically.'].join(`
+`);function Wr(e,t){e.tool(`suggest_links`,Ur,{docName:N.string().describe(`Target page docName`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=R(e.docName);if(!r.ok)return P(r.error,!0);let i=await z(n,`/api/suggest-links?docName=${encodeURIComponent(r.docName)}`);if(!i.ok)return P(`Error: ${i.error}`,!0);let{ok:a,...o}=i,s=await V(r.docName,{config:t.config,resolveCwd:t.resolveCwd});return F(JSON.stringify(o,null,2),{...o,previewUrl:s?.url??null,...s?{previewUrlSource:s.source}:{}})})}const Gr=["**IMPORTANT: Before calling this tool, you MUST first call `get_preview_url` and navigate to the returned URL in your preview browser. If `get_preview_url` returns null, start the server first (`open-knowledge start` or `preview_start`), then call `get_preview_url` again. Do NOT call this tool without the preview open. NEVER manually construct the URL.**",``,`[Requires: Hocuspocus server] Write markdown content to a document via the CRDT layer.`,`Content is applied through Hocuspocus and propagated to all connected editors in real-time.`,``,'**Link liberally.** Every noun-phrase that names another document in this knowledge base should be a `[[wiki-link]]`, not plain prose. Backlinks are the primary navigation surface — underlinked documents become islands. Redlinks (links to pages that don\'t exist yet) are fine; they signal "this should exist." Prefer `[[Page Name]]` over Markdown `[text](./page.md)` — only wiki-links participate in the backlinks index.',``,`**Parameters:**`,'- `docName` — Document name, typically without extension (e.g., "my-doc" or "notes/meeting"). A trailing `.md` or `.mdx` is stripped automatically. New documents are created as `.md` by default; to create a `.mdx` file, first place it on disk, then use this tool for edits.',"- `markdown` — Markdown content to write",'- `position` — Where to insert: "append", "prepend", or "replace"'].join(`
+`);function Kr(e,t){e.tool(`write_document`,Gr,{docName:N.string().describe(`Document name to write to`),markdown:N.string().describe(`Markdown content to write`),position:N.enum([`append`,`prepend`,`replace`]).describe(`Where to insert the content`)},async e=>{let n=await L(t.serverUrl);if(!n)return P(I,!0);let r=R(e.docName);if(!r.ok)return P(r.error,!0);let i=t.identityRef?.current,a=await B(n,`/api/agent-write-md`,{docName:r.docName,markdown:e.markdown,position:e.position,...i?{agentId:i.connectionId,agentName:i.displayName,clientName:i.clientInfo?.name,colorSeed:i.colorSeed}:{}});if(!a.ok)return P(`Error: ${a.error}`,!0);let o=await t.resolveCwd(),s=m(h(t.config,o)),c=U(r.docName,{config:t.config,lockDir:s}),l=(typeof a.subscriberCount==`number`?a.subscriberCount:void 0)===0,u=Array.isArray(a.hints)?a.hints:void 0,d=[`Written successfully (${e.position}).`];if(c&&d.push(`Preview: ${c.url}`),l&&d.push(c?`Warning: no preview is currently attached to "${r.docName}". Open ${c.url} to watch future edits live.`:`Warning: no preview is currently attached to "${r.docName}".`),u)for(let e of u)e.message&&d.push(e.message);let f=d.join(`
+`);if(!c&&!l&&!u)return P(f);let p={};return c&&(p.previewUrl=c.url,p.previewUrlSource=c.source),l&&(p.warning={message:`No preview attached to ${r.docName}.`,previewUrl:c?.url??null}),u&&(p.hints=u),F(f,p)})}const qr={exec:Fn,"init-content":mr,ingest:dr,research:Nr,consolidate:mt,read_document:vr,rename_document:Dr,search:zr,suggest_links:Ur,write_document:Gr,edit_document:xt,get_history:tr,save_version:Lr,rollback_to_version:Fr,list_documents:gr,get_backlinks:Yn,get_forward_links:$n,get_orphans:ar,get_hubs:rr,get_dead_links:Zn,get_preview_url:sr};function Jr(e,t){Jn(e,{resolveCwd:t.resolveCwd,serverUrl:t.serverUrl,config:t.config}),hr(e,{config:t.config,resolveCwd:t.resolveCwd}),fr(e,t.config),Pr(e,t.config),ht(e,t.config),Er(e,{resolveCwd:t.resolveCwd,config:t.config,serverUrl:t.serverUrl}),Hr(e,{resolveCwd:t.resolveCwd,config:t.config,serverUrl:t.serverUrl}),Wr(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),Kr(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd,identityRef:t.identityRef}),St(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd,identityRef:t.identityRef}),jr(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),nr(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),Rr(e,t.serverUrl,t.identityRef),Ir(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),_r(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),Xn(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),er(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),or(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),ir(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),Qn(e,{serverUrl:t.serverUrl,config:t.config,resolveCwd:t.resolveCwd}),lr(e,{resolveCwd:t.resolveCwd,config:t.config})}function X(e){process.stderr.write(`${_(`[mcp]`)} ${e}\n`)}function Yr(e){let{dir:t,include:n,exclude:r}=e.content,i=r.length>0?r.map(e=>`\`${e}\``).join(`, `):`(none)`;return`# MCP Instructions v2 — exec-primary (2026-04-13)
 
 ## This project's content layout (live config)
 
@@ -579,8 +587,9 @@ Folder metadata lives in \`config.yml\`, **not** in content files — this is in
 **Typed call sites (advanced) — prefer \`exec\` for common reads:**
 - \`read_document\`, \`search\`, \`list_documents\`, \`get_backlinks\`, \`get_forward_links\`, \`get_orphans\`, \`get_hubs\`.
 
-${Object.entries(nr).map(([e,t])=>`### \`${e}\`\n${t}`).join(`
+${Object.entries(qr).map(([e,t])=>`### \`${e}\`\n${t}`).join(`
 
 `)}
-`}async function ar(e){try{let t=e.replace(`ws://`,`http://`).replace(`wss://`,`https://`);return(await fetch(`${t}/api/agent-undo-status`,{signal:AbortSignal.timeout(2e3)})).ok}catch(e){return Z(`Hocuspocus check failed: ${e instanceof Error?e.message:String(e)}`),!1}}async function or(e){let{projectDir:t,serverUrl:r,config:i}=e;Z(r?await ar(r)?`Hocuspocus detected at ${r}`:`Hocuspocus not available at ${r} — using disk-only mode`:`No explicit server URL — will discover lazily from server.lock per call`);let a=new de({name:f,version:p},{instructions:ir(i)}),o=[],s=!1;async function c(){try{o=(await a.server.listRoots()).roots.map(e=>e.uri).filter(e=>e.startsWith(`file://`)).map(e=>te(e)),Z(o.length>0?`roots: ${o.join(`, `)}`:`client advertised no roots — falling back to startup cwd`)}catch(e){Z(`listRoots unsupported by client (using startup cwd): ${e instanceof Error?e.message:String(e)}`)}finally{s=!0}}let l=!1;async function u(e){return e||(s||await c(),o.length===0?(l||=(Z(`no client roots — falling back to startup cwd: ${t}`),!0),t):(l&&=(Z(`client roots now available — using ${o[0]}`),!1),o[0]))}a.server.setNotificationHandler(pe,async()=>{s=!1,await c()});let d=r?r.replace(`ws://`,`http://`).replace(`wss://`,`https://`):void 0,g=new Map,_=async()=>{if(d)return d;let e=await u(),t=Date.now(),r=g.get(e);if(r&&r.expiresAt>t)return r.url;let a=n(m(h(i,e))),o=a&&a.port>0?`http://localhost:${a.port}`:void 0;return g.set(e,{url:o,expiresAt:t+1e3}),o},v=ne(),y=process.env.AGENT_LABEL||void 0,b={current:{connectionId:v,label:y,displayName:y??`Agent`,colorSeed:y??v}};a.server.oninitialized=()=>{let e=a.server.getClientVersion();b.current={connectionId:v,clientInfo:e?{name:e.name,version:e.version}:void 0,label:y,displayName:y??e?.name??`Agent`,colorSeed:y??e?.name??v},Z(`Agent identity: ${b.current.displayName} (${v.slice(0,8)})`)},rr(a,{serverUrl:_,resolveCwd:u,startupCwd:t,config:i,identityRef:b});let x=new fe;await a.connect(x),Z(`MCP server running (stdio)`),c().catch(()=>{});let{startKeepalive:S}=await import(`./keepalive-B3k7ffvp.mjs`),C=S({resolveWsUrl:async()=>{let e=await _();if(e)return e.replace(/^http:/,`ws:`).replace(/^https:/,`wss:`)},log:Z}),w=()=>{try{C.close()}catch{}process.exit(0)};process.on(`SIGINT`,w),process.on(`SIGTERM`,w)}function sr(){let e=process.execPath,t=process.argv[1];return t?{command:e,prefixArgs:[t]}:(console.warn(`[self-spawn] process.argv[1] is empty — falling back to \`npx @inkeep/open-knowledge\`. This re-introduces the version-drift surface that re-exec was fixing. Observed argv: ${JSON.stringify(process.argv)}`),{command:`npx`,prefixArgs:[`@inkeep/open-knowledge`]})}function cr(e){if(e===void 0||e===``)return;let t=Number.parseInt(e,10);if(!(Number.isNaN(t)||t<=0))return t}function lr(e){if(e.portOverride!==void 0){let t=Number.parseInt(e.portOverride,10);if(Number.isNaN(t))return{action:`disk-only`,message:`invalid --port value '${e.portOverride}' — disk-only mode`};if(t>0){let n=`ws://${e.host}:${t}`;return{action:`connect`,url:n,message:`using --port override, connecting to ${n}`}}return{action:`disk-only`,message:`--port=0 — disk-only mode`}}let t=e.readLock();if(t&&t.port>0&&e.isAlive(t.pid)){let e=`ws://localhost:${t.port}`;return{action:`connect`,url:e,message:`connected to running instance at ${e} (pid ${t.pid})`}}return e.envAutoStart===`0`?{action:`disk-only`,message:`auto-spawn disabled via OK_MCP_AUTOSTART=0 — disk-only mode`}:e.configAutoStart?t?{action:`spawn`,message:`existing lock is not usable (port=${t.port}, pid=${t.pid}) — spawning ok start`}:{action:`spawn`,message:`no running instance — spawning ok start`}:{action:`disk-only`,message:`auto-spawn disabled via config.mcp.autoStart=false — disk-only mode`}}async function ur(e){let t=e.readLock??(()=>n(e.lockDir)),i=e.isAlive??r,a=e.sleep??(e=>new Promise(t=>setTimeout(t,e))),o=e.spawn??ue,s=e.readErrorLog??(e=>C(e)?E(e,`utf-8`).trim():``),c=e.openErrorLog??(e=>T(e,`w`)),l=e.closeFd??(e=>S(e)),u=e.timeoutMs??5e3,d=e.pollIntervalMs??100,f=lr({host:e.host,portOverride:e.portOverride,envAutoStart:e.envAutoStart,configAutoStart:e.configAutoStart,readLock:t,isAlive:i});if(f.action===`connect`)return{serverUrl:f.url,message:f.message};if(f.action===`disk-only`)return{serverUrl:void 0,message:f.message};C(e.lockDir)||w(e.lockDir,{recursive:!0});let p=j(e.lockDir,`last-spawn-error.log`),m=c(p),h,g,_=sr();try{try{h=o(_.command,[..._.prefixArgs,`start`],{detached:!0,stdio:[`ignore`,`ignore`,m],cwd:e.contentDir}),h.on(`error`,e=>{g=e instanceof Error?e.message:String(e)}),h.unref()}catch(e){g=e instanceof Error?e.message:String(e)}}finally{try{l(m)}catch{}}let v=Date.now()+u;for(;Date.now()<v;){if(g){let e=s(p);throw Error(`OK: spawn failed: ${g}${e?` stderr:\n${e}`:``}`)}await a(d);let e=t();if(e&&e.port>0&&i(e.pid)){let t=`ws://localhost:${e.port}`;return{serverUrl:t,message:`spawned ok start; connected at ${t} (pid ${e.pid})`}}}if(g){let e=s(p);throw Error(`OK: spawn failed: ${g}${e?` stderr:\n${e}`:``}`)}let y=s(p),b=(u/1e3).toFixed(u%1e3==0?0:2),x=h?.pid,D=``;throw typeof x==`number`&&(D=i(x)?` child pid=${x} is still running — raise OK_MCP_SPAWN_TIMEOUT_MS if this is a slow boot.`:` child pid=${x} exited — check last-spawn-error.log.`),Error(`OK: server did not start within ${b}s.${D}${y?` stderr:\n${y}`:``}`)}function dr(e){return new x(`mcp`).description(`Start MCP stdio server for project knowledge base`).option(`-p, --port <port>`,`Override port discovery and connect to this port (0 = disk-only)`,void 0).action(async t=>{try{let n=e(),r=process.cwd(),i=h(n,r),{serverUrl:a,message:o}=await ur({lockDir:m(i),contentDir:i,host:n.server.host,portOverride:t.port,envAutoStart:process.env.OK_MCP_AUTOSTART,configAutoStart:n.mcp.autoStart,timeoutMs:cr(process.env.OK_MCP_SPAWN_TIMEOUT_MS)});process.stderr.write(`[mcp] ${o}\n`),await or({projectDir:r,serverUrl:a,config:n})}catch(e){process.stderr.write(`MCP server failed to start: ${e instanceof Error?e.message:String(e)}\n`),process.exitCode=1}})}function fr(e){return new x(`preview`).description(`Show what content the watcher will track (read-only)`).action(async()=>{let{previewContent:t,formatPreviewBlock:n}=await import(`./preview-UvmK-nj9.mjs`),r=e(),i=process.cwd(),a=h(r,i),o;try{o=t({projectDir:i,contentDir:a,include:r.content.include,exclude:r.content.exclude})}catch(e){console.error(`Content preview failed: ${e instanceof Error?e.message:String(e)}`),process.exitCode=1;return}process.stdout.write(`${n(o,i)}\n`),o.totalCount===0&&o.warnings.length>0&&(process.exitCode=1)})}function pr(e){return e.uiLock?e.isAlive(e.uiLock.pid)?{action:`skip`,reason:`alive`,pid:e.uiLock.pid,port:e.uiLock.port}:{action:`spawn`,reason:`stale`,stalePid:e.uiLock.pid}:{action:`spawn`,reason:`absent`}}function mr(e){C(e.lockDir)||w(e.lockDir,{recursive:!0});let t=T(j(e.lockDir,`last-spawn-error.log`),`w`),n=e.spawn??ue,{PORT:r,...i}=process.env,a=sr();try{let r=n(a.command,[...a.prefixArgs,...e.args??[`ui`]],{detached:!0,stdio:[`ignore`,`ignore`,t],cwd:e.cwd,env:i});return r.unref(),r}finally{try{S(t)}catch{}}}function hr(e){let t=e.sigtermGraceMs??1e4,n=e.sigtermPollIntervalMs??200,r=e.sleep??(e=>new Promise(t=>setTimeout(t,e)));return async()=>{try{let i=e.readUiLock();if(i&&e.isAlive(i.pid))try{e.killPid(i.pid,`SIGTERM`),e.log?.info({pid:i.pid,port:i.port},`idle-shutdown: SIGTERM UI sibling`);let a=Date.now()+t;for(;Date.now()<a&&e.isAlive(i.pid);)await r(n);if(e.isAlive(i.pid))try{e.killPid(i.pid,`SIGKILL`),e.log?.warn({pid:i.pid,graceMs:t},`idle-shutdown: SIGTERM grace expired — escalated to SIGKILL`)}catch(t){e.log?.error({pid:i.pid,err:t instanceof Error?t.message:String(t)},`idle-shutdown: SIGKILL failed`)}}catch(t){e.log?.warn({pid:i.pid,err:t instanceof Error?t.message:String(t)},`idle-shutdown: failed to SIGTERM UI sibling`)}}catch(t){e.log?.warn({err:t instanceof Error?t.message:String(t)},`idle-shutdown: UI lookup failed; proceeding with destroy`)}await e.destroy()}}async function gr(e){let{config:t,cwd:n}=e,r=e.skipAutoInit??!1,i=e.skipUiAutoSpawn??!1,a=e.idleThresholdMs??18e5,{existsSync:o,mkdirSync:s}=await import(`node:fs`),{createServer:c}=await import(`node:http`),{resolve:l}=await import(`node:path`),{attachIdleShutdown:u,createServer:f,getLogger:p,isProcessAlive:m,readUiLock:h,updateServerLockPort:g}=await import(`./src-BBqAZd3w.mjs`),{resolveContentDir:_}=await import(`./paths-CeCijg6T.mjs`),{WebSocketServer:v}=await import(`ws`),y=e.log??p(`start`),b=!1;if(!o(l(n,`.open-knowledge`))&&!r)try{let{runInit:e}=await import(`./init-eC_P2JgE.mjs`),t=e({cwd:n,mcp:!1});t.mcpAction===`failed`?console.warn(`Auto-init: ${t.mcpError??`unknown error`}`):b=!0}catch(e){console.warn(`Auto-init failed:`,e instanceof Error?e.message:e)}let x=_(t,n);o(x)||(s(x,{recursive:!0}),y.info({contentDir:x},`Created content directory`));let S=!1,C=l(x,d),w=t.server.openOnAgentEdit?()=>{if(S)return;let e=h(C);if(!e||e.port<=0||!m(e.pid))return;S=!0;let t=`http://localhost:${e.port}`;import(`./open-browser-YjPpHsbF.mjs`).then(({openBrowser:e})=>e(t)).catch(()=>{})}:void 0,{hocuspocus:T,destroy:E,ready:D,degraded:O,lockDir:k}=f({contentDir:x,projectDir:n,contentRoot:t.content.dir,port:t.server.port,host:t.server.host,quiet:!1,debounce:t.persistence.debounceMs,maxDebounce:t.persistence.maxDebounceMs,includePatterns:t.content.include,excludePatterns:t.content.exclude,onAgentWrite:w}),A=pr({uiLock:h(k),isAlive:m});if(A.action===`spawn`&&!i)try{mr({lockDir:k,cwd:n,spawn:e.spawn}),y.info({reason:A.reason},`[start] auto-spawned ok ui sibling`)}catch(e){console.warn(`[start] failed to auto-spawn ok ui: ${e instanceof Error?e.message:String(e)}`)}else A.action===`skip`&&y.info({port:A.port,pid:A.pid},`UI already running at port ${A.port}`);let j=c((e,t)=>{let n=e.url?.split(`?`)[0];if(n?.startsWith(`/api/`)){T.hooks(`onRequest`,{request:e,response:t}).then(()=>{t.writableEnded||(t.statusCode=404,t.setHeader(`Content-Type`,`application/json`),t.end(JSON.stringify({error:`API route not found`,path:n})))}).catch(e=>{console.error(`[api] Unhandled onRequest error:`,e),t.writableEnded||(t.writeHead(500),t.end(`Internal server error`))});return}t.writeHead(404,{"Content-Type":`application/json`}),t.end(JSON.stringify({error:"Not found. The React UI is served by `ok ui` (default port 3000).",path:n??`/`}))}),M=new v({noServer:!0});M.on(`error`,e=>{y.error({err:e},`WebSocketServer error`)}),j.on(`upgrade`,(e,t,n)=>{if(e.url?.startsWith(`/collab/keepalive`)){t.on(`error`,e=>{y.error({err:e},`MCP keepalive socket error`)}),M.handleUpgrade(e,t,n,e=>{let t=setInterval(()=>{try{e.ping()}catch{}},3e4);t.unref?.(),e.on(`close`,()=>clearInterval(t)),e.on(`error`,t=>{y.error({err:t},`MCP keepalive WS error`),e.terminate()})});return}e.url?.startsWith(`/collab`)&&(t.on(`error`,e=>{y.error({err:e},`Upgrade socket error`)}),M.handleUpgrade(e,t,n,t=>{let n=T.handleConnection(t,e);t.on(`message`,e=>{n.handleMessage((e instanceof ArrayBuffer,new Uint8Array(e)))}),t.on(`close`,(e,t)=>{n.handleClose({code:e,reason:t.toString()})}),t.on(`error`,e=>{y.error({err:e},`WebSocket error`),t.terminate()})}))});let N=u({httpServer:j,thresholdMs:a,log:y,onShutdown:hr({readUiLock:()=>h(k),isAlive:m,killPid:(e,t)=>{process.kill(e,t)},destroy:async()=>{await E()},log:y})});await new Promise((e,n)=>{let r=e=>n(e);j.once(`error`,r),j.listen(t.server.port,t.server.host,()=>{j.removeListener(`error`,r),e()})});let ee=j.address(),te=typeof ee==`object`&&ee?ee.port:t.server.port;g(k,te);let ne=!1;return{httpServer:j,destroy:async()=>{ne||(ne=!0,N.detach(),await new Promise(e=>{j.close(()=>e())}),await E())},lockDir:k,contentDir:x,port:te,ready:D,degraded:O,uiSpawnDecision:A,didAutoInit:b}}function _r(e){return new x(`start`).description(`Start the knowledge base collab server`).option(`-p, --port <port>`,`Server port`,void 0).option(`-H, --host <host>`,`Server host`,void 0).option(`--open`,`Open browser after start`).option(`--no-init`,`Skip auto-scaffolding of ${d}/`).action(async t=>{let{renderBanner:n}=await import(`./banner-D0kciHvM.mjs`),{dim:r,error:i,info:a,warning:o}=await import(`./colors-DGfDzbma.mjs`),s=e(),c=process.cwd();t.port!==void 0&&(s.server.port=Number(t.port)),t.host!==void 0&&(s.server.host=t.host);let l;try{l=await gr({config:s,cwd:c,skipAutoInit:t.init===!1})}catch(e){console.error(`${i(`Failed to start:`)} ${e instanceof Error?e.stack??e.message:String(e)}`),process.exit(1)}let u=!1,f=async e=>{if(!u){u=!0,console.log(r(`\nShutting down (${e})...`));try{await l.destroy()}catch(e){console.error(`${i(`destroy() failed:`)} ${e instanceof Error?e.stack??e.message:String(e)}`),process.exitCode=1}process.exit(process.exitCode??0)}};process.once(`SIGINT`,()=>{f(`SIGINT`)}),process.once(`SIGTERM`,()=>{f(`SIGTERM`)});let m=`http://${s.server.host}:${l.port}`,h=s.server.host===`0.0.0.0`||s.server.host===`::`?`http://0.0.0.0:${l.port}`:void 0,g=l.uiSpawnDecision,_=g.action===`skip`?g.port:3e3,v=_>0?`http://${s.server.host}:${_}`:m;console.log(n({name:`open-knowledge`,version:p,localUrl:v,apiUrl:v===m?void 0:m,networkUrl:h})),l.didAutoInit&&(console.log(`  ${a(`✓`)} Scaffolded ${d}/ (first run)`),console.log(`  ${r("Tip: Run `open-knowledge init` to register MCP tools for Claude Code")}\n`));let y={"shadow-repo":`Version history and branch-switch safety unavailable`,"file-watcher":`External file changes will not sync to the editor`,"head-watcher":`Git branch switches may cause document inconsistency`};l.ready.then(async()=>{if(l.degraded.length>0){console.log();for(let e of l.degraded){let t=y[e]??`${e} (check server logs for details)`;console.warn(`  ${o(`⚠`)} ${o(e)}: ${r(t)}`)}console.log()}if(l.didAutoInit)try{let{previewContent:e,formatPreviewBlock:t}=await import(`./preview-UvmK-nj9.mjs`),n=e({projectDir:c,contentDir:l.contentDir,include:s.content.include,exclude:s.content.exclude});console.log(`\n${t(n,c)}\n`)}catch(e){console.warn(`Content preview unavailable: ${e instanceof Error?e.message:String(e)}`)}if(t.open){let{openBrowser:e}=await import(`./open-browser-YjPpHsbF.mjs`);e(v)}}).catch(e=>{console.error(`  ${i(`Server initialization failed:`)} ${e instanceof Error?e.message:String(e)}`)})})}function vr(e,t){return{server:yr(`server`,e),ui:yr(`ui`,t)}}function yr(e,t){switch(t.status){case`missing`:return{name:e,state:`missing`,alive:!1};case`corrupt`:return{name:e,state:`corrupt`,alive:!1};case`foreign-host`:return{name:e,state:`foreign-host`,pid:t.lock.pid,port:t.lock.port,startedAt:t.lock.startedAt,host:t.lock.hostname,alive:`unknown`};case`dead-pid`:return{name:e,state:`dead-pid`,pid:t.lock.pid,port:t.lock.port,startedAt:t.lock.startedAt,host:t.lock.hostname,alive:!1};case`alive`:return{name:e,state:`alive`,pid:t.lock.pid,port:t.lock.port,startedAt:t.lock.startedAt,host:t.lock.hostname,alive:!0}}}function br(e){return`${xr(e.server)}\n${xr(e.ui)}`}function xr(e){let t=e.name===`server`?`server`:`ui    `;return e.state===`missing`?`${t}  not running`:e.state===`corrupt`?`${t}  lock file corrupt — run \`ok clean\``:e.state===`foreign-host`?`${t}  foreign host (${e.host}) pid=${e.pid} port=${e.port}`:e.state===`dead-pid`?`${t}  stale (dead pid=${e.pid}) — run \`ok clean\``:`${t}  alive  pid=${e.pid} port=${e.port} started=${e.startedAt}`}function Sr(e){let t=e.inspect??(t=>ve(e.lockDir,t)),n=e.log??(e=>console.log(e)),r=vr(t(`server`),t(`ui`));return e.json?n(JSON.stringify(r,null,2)):n(br(r)),r}function Cr(e){return new x(`status`).description(`Show live state of the server + ui lockfiles for this project`).option(`--json`,`Emit structured JSON instead of formatted text`).action(t=>{Sr({lockDir:m(h(e(),process.cwd())),json:t.json===!0})})}function wr(e,t){let n=[];return e.status===`alive`&&n.push({name:`server`,pid:e.lock.pid,port:e.lock.port}),t.status===`alive`&&n.push({name:`ui`,pid:t.lock.pid,port:t.lock.port}),{targets:n}}function Tr(e){let t=e.inspect??(t=>ve(e.lockDir,t)),n=e.kill??((e,t)=>process.kill(e,t)),r=e.log??(e=>console.log(e)),i=e.error??(e=>console.error(e)),a=wr(t(`server`),t(`ui`));if(a.targets.length===0)return r(`No running open-knowledge processes.`),{stopped:[],failed:[],hadTargets:!1};let o=[],s=[];for(let e of a.targets)try{n(e.pid,`SIGTERM`),o.push(e)}catch(t){s.push({target:e,error:t instanceof Error?t.message:String(t)})}return o.length>0&&r(`Stopped: ${o.map(e=>`${e.name} (pid=${e.pid}, port=${e.port})`).join(`, `)}`),s.length>0&&i(`Failed to stop: ${s.map(({target:e,error:t})=>`${e.name} (pid=${e.pid}): ${t}`).join(`; `)}`),{stopped:o,failed:s,hadTargets:!0}}function Er(e){return new x(`stop`).description(`Stop the running open-knowledge server and UI (live only)`).action(()=>{Tr({lockDir:m(h(e(),process.cwd()))}).failed.length>0&&(process.exitCode=1)})}const Dr=[`connection`,`keep-alive`,`proxy-authenticate`,`proxy-authorization`,`te`,`trailer`,`transfer-encoding`,`upgrade`,`cookie`,`set-cookie`];async function Or(e){let t=e.upstreamTimeoutMs??1e4,n=ce((n,r)=>{Ar(n,r,e.upstreamHost,e.upstreamPort,t)});await new Promise((t,r)=>{let i=e=>r(e);n.once(`error`,i),n.listen(e.listenPort,e.host,()=>{n.off(`error`,i),t()})});let r=n.address();return{httpServer:n,port:typeof r==`object`&&r?r.port:e.listenPort,close:()=>new Promise(e=>{n.close(()=>e())})}}function kr(e,t,n){Ar(e,t,n.upstreamHost,n.upstreamPort,n.upstreamTimeoutMs??1e4)}function Ar(e,t,n,r,i){let a={...e.headers};delete a.host;for(let e of Dr)delete a[e];e.setTimeout(3e4,()=>{if(t.headersSent)try{t.end()}catch{}else try{t.writeHead(408,{"Content-Type":`text/plain`}),t.end(`Request Timeout`)}catch{}try{e.socket?.destroy()}catch{}});let o=le({host:n,port:r,method:e.method,path:e.url,headers:{...a,host:`${n}:${r}`}},e=>{let n={...e.headers};for(let e of Dr)delete n[e];t.writeHead(e.statusCode??502,n),e.pipe(t),e.once(`error`,()=>{try{t.end()}catch{}})});i>0&&o.setTimeout(i,()=>{if(!t.headersSent)t.writeHead(504,{"Content-Type":`text/plain`}),t.end(`Gateway Timeout`);else try{t.end()}catch{}o.destroy()}),o.on(`error`,()=>{if(!t.headersSent)t.writeHead(502,{"Content-Type":`text/plain`}),t.end(`Bad Gateway`);else try{t.end()}catch{}}),e.on(`error`,()=>{o.destroy()}),e.pipe(o)}async function jr(e){await Promise.all(e.map(e=>new Promise(t=>{e.close(()=>t())})))}async function Mr(e){let{existsSync:n}=await import(`node:fs`),{createServer:r}=await import(`node:http`),{resolve:i}=await import(`node:path`),{acquireUiLock:a,readServerLock:o,releaseUiLock:s,updateUiLockPort:c}=await import(`./src-BBqAZd3w.mjs`),{default:l}=await import(`sirv`),{resolveContentDir:u,resolveLockDir:d}=await import(`./paths-CeCijg6T.mjs`),f=u(e.config,e.cwd),p=d(f);a(p,{port:0,worktreeRoot:e.cwd});let m=import.meta.dirname??new URL(`.`,import.meta.url).pathname,h=[i(m,`public`),i(m,`../../app/dist`),i(m,`../../../app/dist`)].find(e=>n(e)),g=h?l(h,{single:!0,gzip:!0,immutable:!0}):null,_=n(f)?l(f,{dotfiles:!1}):null,v=e.port,y=null,b=(e,t)=>{let n=e.url?.split(`?`)[0];if(n===`/api/config`&&(e.method===`GET`||e.method===`HEAD`)){y?.();let n=o(p),r=n&&n.port>0?`ws://localhost:${n.port}/collab`:null,i=JSON.stringify({collabUrl:r,previewUrl:null,port:v});t.setHeader(`Content-Type`,`application/json`),t.setHeader(`Cache-Control`,`no-store`),t.setHeader(`X-Content-Type-Options`,`nosniff`),t.statusCode=200,e.method===`HEAD`?t.end():t.end(i);return}if(n?.startsWith(`/api/`)){y?.();let r=o(p);if(!r||r.port<=0){t.writeHead(503,{"Content-Type":`application/json`,"Cache-Control":`no-store`}),t.end(JSON.stringify({error:"Collab server not running. Start `ok start` or run `ok status`.",path:n}));return}kr(e,t,{upstreamHost:`localhost`,upstreamPort:r.port});return}if(decodeURIComponent(n?.replace(/^\//,``)??``)&&_){t.setHeader(`X-Content-Type-Options`,`nosniff`),_(e,t,()=>{g?g(e,t):Nr(t)});return}if(g){g(e,t);return}Nr(t)},x=e.host===void 0?[`::1`,`127.0.0.1`]:[e.host],S=[],C=e.port;try{for(let e of x){let t=r(b);S.push(t),await new Promise((n,r)=>{let i=e=>r(e);t.once(`error`,i),t.listen(C,e,()=>{t.off(`error`,i);let e=t.address();typeof e==`object`&&e&&(C=e.port),n()})})}}catch(e){await Promise.all(S.map(e=>new Promise(t=>{try{e.close(()=>t())}catch{t()}})));try{s(p)}catch{}throw e}let w=C;v=w,c(p,w);let T=e.scheduler??t,E=e.safetyNetMs??432e5,D=null,O=!1,k=!1,A=()=>{O||(O=!0,D!==null&&(T.clearTimeout(D),D=null))},j=()=>{if(A(),!k){k=!0;try{s(p)}catch{}}},M=()=>{O||E<=0||(D!==null&&(T.clearTimeout(D),D=null),D=T.setTimeout(()=>{D=null,console.warn(`[ui] safety-net (${E}ms) reached — shutting down (D-025 backstop)`);try{e.onSafetyNet?.()}catch{}for(let e of S)try{e.close()}catch{}j()},E))},N=()=>{O||E<=0||M()};return y=N,M(),{httpServers:S,port:w,release:j,detachSafetyNet:A,nudgeSafetyNet:N}}function Nr(e){e.writeHead(404),e.end(`Not found`)}function Pr(e,t){if(e!==void 0){let t=Number.parseInt(e,10);if(Number.isNaN(t)||t<0||t>65535)throw Error(`Invalid --port value '${e}'`);return t}if(t!==void 0&&t!==``){let e=Number.parseInt(t,10);if(Number.isNaN(e)||e<0||e>65535)throw Error(`Invalid PORT env value '${t}'`);return e}return 0}async function Fr(e){let t=e.readLock??(async()=>{let{readUiLock:t}=await import(`./src-BBqAZd3w.mjs`);return t(e.lockDir)}),n=await t();if(!n)throw Error(`UI lock collision reported but the lock disappeared before handling — retry acquiring.`);if(n.port===e.requestedPort&&n.port>0)return{mode:`already-running`,port:n.port};let r=n.port;if(r===0){let n=Date.now()+(e.pollDeadlineMs??2e3),i=e.pollIntervalMs??100;for(;Date.now()<n;){await new Promise(e=>{setTimeout(e,i)});let e=await t();if(e&&e.port>0){r=e.port;break}}if(r===0)throw Error("UI did not bind within 2s; run `ok clean`");if(r===e.requestedPort)return{mode:`already-running`,port:r}}return{mode:`proxy`,handle:await Or({listenPort:e.requestedPort,host:e.host,upstreamHost:`localhost`,upstreamPort:r}),upstreamPort:r}}function Ir(e){return new x(`ui`).description(`Serve the Open Knowledge React editor UI`).option(`-p, --port <port>`,`UI port (default: $PORT env or 0 / kernel-allocated)`).option(`-H, --host <host>`,"UI host. Default: two-socket loopback bind (`[::1]` + `127.0.0.1`) so cross-family collisions fail loud (D-033). Pass an explicit host (e.g. `127.0.0.1`, `0.0.0.0`) to bind a single socket on that host.").action(async t=>{let{dim:n}=await import(`./colors-DGfDzbma.mjs`),{UiLockCollisionError:r}=await import(`./src-BBqAZd3w.mjs`),{resolveContentDir:i,resolveLockDir:a}=await import(`./paths-CeCijg6T.mjs`),o=e(),s=t.host,c;try{c=Pr(t.port,process.env.PORT)}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exitCode=1;return}try{let e=await Mr({config:o,cwd:process.cwd(),port:c,host:s}),t=s===void 0||s===`::`||s===`0.0.0.0`?`localhost`:s;console.log(`${n(`[ui]`)} listening on http://${t}:${e.port}`);let r=!1,i=t=>{if(r)return;r=!0,console.log(n(`\n[ui] Shutting down (${t})...`)),e.detachSafetyNet();let i=()=>{try{e.release()}finally{process.exit(process.exitCode??0)}};jr(e.httpServers).then(i,i),setTimeout(i,2e3).unref()};process.once(`SIGINT`,()=>i(`SIGINT`)),process.once(`SIGTERM`,()=>i(`SIGTERM`));return}catch(e){if(!(e instanceof r))throw e;let t=a(i(o,process.cwd())),l=s??`localhost`,u;try{u=await Fr({requestedPort:c,host:l,lockDir:t})}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exit(1)}u.mode===`already-running`&&(console.log(`UI already running at http://${l}:${u.port}`),process.exit(0)),console.log(`UI running at http://${l}:${u.upstreamPort}; acting as HTTP proxy on port ${u.handle.port}`);let d=!1,f=e=>{d||(d=!0,console.log(n(`\n[ui-proxy] Shutting down (${e})...`)),u.handle.close().finally(()=>process.exit(process.exitCode??0)),setTimeout(()=>process.exit(process.exitCode??0),2e3).unref())};process.once(`SIGINT`,()=>f(`SIGINT`)),process.once(`SIGTERM`,()=>f(`SIGTERM`))}})}process.argv.includes(`--no-color`)?(process.env.NO_COLOR=`1`,delete process.env.FORCE_COLOR):process.argv.includes(`--color`)&&(process.env.FORCE_COLOR=`1`,delete process.env.NO_COLOR);const Q=new x;let $;Q.name(`open-knowledge`).description(`Local-first knowledge base with CRDT collaboration`).version(p).option(`--cwd <path>`,`Working directory`).option(`--log-level <level>`,`Log level`,`info`).option(`--no-color`,`Disable color output`).option(`--color`,`Force color output`).hook(`preAction`,e=>{let t=e.opts(),n=t.cwd;n!==void 0&&process.chdir(n);let{config:r}=b(n),i=e.args.length===0?t:e.commands[0]?.opts()??{};i.port!==void 0&&(r.server.port=Number(i.port)),i.host!==void 0&&(r.server.host=i.host),process.env.PORT&&(r.server.port=Number(process.env.PORT)),process.env.HOST&&(r.server.host=process.env.HOST),$=r});const Lr=_r(()=>$);Q.addCommand(Lr,{isDefault:!0});const Rr=dr(()=>$);Q.addCommand(Rr),Q.addCommand(_());const zr=fr(()=>$);Q.addCommand(zr);const Br=Ir(()=>$);Q.addCommand(Br),Q.addCommand(Er(()=>$)),Q.addCommand(xe(()=>$)),Q.addCommand(Cr(()=>$)),await Q.parseAsync();export{};
+`}async function Xr(e){try{let t=e.replace(`ws://`,`http://`).replace(`wss://`,`https://`);return(await fetch(`${t}/api/agent-undo-status`,{signal:AbortSignal.timeout(2e3)})).ok}catch(e){return X(`Hocuspocus check failed: ${e instanceof Error?e.message:String(e)}`),!1}}async function Zr(e){let{projectDir:t,serverUrl:n,config:r}=e;X(n?await Xr(n)?`Hocuspocus detected at ${n}`:`Hocuspocus not available at ${n} — using disk-only mode`:`No explicit server URL — will discover lazily from server.lock per call`);let i=new we({name:f,version:p},{instructions:Yr(r)}),a=[],o=!1;async function c(){try{a=(await i.server.listRoots()).roots.map(e=>e.uri).filter(e=>e.startsWith(`file://`)).map(e=>me(e)),X(a.length>0?`roots: ${a.join(`, `)}`:`client advertised no roots — falling back to startup cwd`)}catch(e){X(`listRoots unsupported by client (using startup cwd): ${e instanceof Error?e.message:String(e)}`)}finally{o=!0}}let l=!1;async function u(e){return e||(o||await c(),a.length===0?(l||=(X(`no client roots — falling back to startup cwd: ${t}`),!0),t):(l&&=(X(`client roots now available — using ${a[0]}`),!1),a[0]))}i.server.setNotificationHandler(Ee,async()=>{o=!1,await c()});let d=n?n.replace(`ws://`,`http://`).replace(`wss://`,`https://`):void 0,g=new Map,_=async()=>{if(d)return d;let e=await u(),t=Date.now(),n=g.get(e);if(n&&n.expiresAt>t)return n.url;let i=s(m(h(r,e))),a=i&&i.port>0?`http://localhost:${i.port}`:void 0;return g.set(e,{url:a,expiresAt:t+1e3}),a},v=he(),y=process.env.AGENT_LABEL||void 0,b={current:{connectionId:v,label:y,displayName:y??`Agent`,colorSeed:y??v}};i.server.oninitialized=()=>{let e=i.server.getClientVersion();b.current={connectionId:v,clientInfo:e?{name:e.name,version:e.version}:void 0,label:y,displayName:y??e?.name??`Agent`,colorSeed:y??e?.name??v},X(`Agent identity: ${b.current.displayName} (${v.slice(0,8)})`)},Jr(i,{serverUrl:_,resolveCwd:u,startupCwd:t,config:r,identityRef:b});let x=new Te;await i.connect(x),X(`MCP server running (stdio)`),c().catch(()=>{});let{startKeepalive:S}=await import(`./keepalive-Bp0nJiwT.mjs`),C=S({resolveWsUrl:async()=>{let e=await _();if(e)return e.replace(/^http:/,`ws:`).replace(/^https:/,`wss:`)},log:X}),w=()=>{try{C.close()}catch{}process.exit(0)};process.on(`SIGINT`,w),process.on(`SIGTERM`,w)}function Qr(e){if(e===void 0||e===``)return;let t=Number.parseInt(e,10);if(!(Number.isNaN(t)||t<=0))return t}function $r(e){if(e.portOverride!==void 0){let t=Number.parseInt(e.portOverride,10);if(Number.isNaN(t))return{action:`disk-only`,message:`invalid --port value '${e.portOverride}' — disk-only mode`};if(t>0){let n=`ws://${e.host}:${t}`;return{action:`connect`,url:n,message:`using --port override, connecting to ${n}`}}return{action:`disk-only`,message:`--port=0 — disk-only mode`}}let t=e.readLock();if(t&&t.port>0&&e.isAlive(t.pid)){let e=`ws://localhost:${t.port}`;return{action:`connect`,url:e,message:`connected to running instance at ${e} (pid ${t.pid})`}}return e.envAutoStart===`0`?{action:`disk-only`,message:`auto-spawn disabled via OK_MCP_AUTOSTART=0 — disk-only mode`}:e.configAutoStart?t?{action:`spawn`,message:`existing lock is not usable (port=${t.port}, pid=${t.pid}) — spawning ok start`}:{action:`spawn`,message:`no running instance — spawning ok start`}:{action:`disk-only`,message:`auto-spawn disabled via config.mcp.autoStart=false — disk-only mode`}}async function ei(e){let t=e.readLock??(()=>s(e.lockDir)),n=e.isAlive??l,r=e.sleep??(e=>new Promise(t=>setTimeout(t,e))),i=e.spawn??_e,a=e.readErrorLog??(e=>T(e)?O(e,`utf-8`).trim():``),o=e.openErrorLog??(e=>D(e,`w`)),c=e.closeFd??(e=>w(e)),u=e.timeoutMs??5e3,d=e.pollIntervalMs??100,f=$r({host:e.host,portOverride:e.portOverride,envAutoStart:e.envAutoStart,configAutoStart:e.configAutoStart,readLock:t,isAlive:n});if(f.action===`connect`)return{serverUrl:f.url,message:f.message};if(f.action===`disk-only`)return{serverUrl:void 0,message:f.message};T(e.lockDir)||E(e.lockDir,{recursive:!0});let p=se(e.lockDir,`last-spawn-error.log`),m=o(p),h,g,_=x();try{try{h=i(_.command,[..._.prefixArgs,`start`],{detached:!0,stdio:[`ignore`,`ignore`,m],cwd:e.contentDir}),h.on(`error`,e=>{g=e instanceof Error?e.message:String(e)}),h.unref()}catch(e){g=e instanceof Error?e.message:String(e)}}finally{try{c(m)}catch{}}let v=Date.now()+u;for(;Date.now()<v;){if(g){let e=a(p);throw Error(`OK: spawn failed: ${g}${e?` stderr:\n${e}`:``}`)}await r(d);let e=t();if(e&&e.port>0&&n(e.pid)){let t=`ws://localhost:${e.port}`;return{serverUrl:t,message:`spawned ok start; connected at ${t} (pid ${e.pid})`}}}if(g){let e=a(p);throw Error(`OK: spawn failed: ${g}${e?` stderr:\n${e}`:``}`)}let y=a(p),b=(u/1e3).toFixed(u%1e3==0?0:2),S=h?.pid,C=``;throw typeof S==`number`&&(C=n(S)?` child pid=${S} is still running — raise OK_MCP_SPAWN_TIMEOUT_MS if this is a slow boot.`:` child pid=${S} exited — check last-spawn-error.log.`),Error(`OK: server did not start within ${b}s.${C}${y?` stderr:\n${y}`:``}`)}function ti(e){return new C(`mcp`).description(`Start MCP stdio server for project knowledge base`).option(`-p, --port <port>`,`Override port discovery and connect to this port (0 = disk-only)`,void 0).action(async t=>{try{let n=e(),r=process.cwd(),i=h(n,r),{serverUrl:a,message:o}=await ei({lockDir:m(i),contentDir:i,host:n.server.host,portOverride:t.port,envAutoStart:process.env.OK_MCP_AUTOSTART,configAutoStart:n.mcp.autoStart,timeoutMs:Qr(process.env.OK_MCP_SPAWN_TIMEOUT_MS)});process.stderr.write(`[mcp] ${o}\n`),await Zr({projectDir:r,serverUrl:a,config:n})}catch(e){process.stderr.write(`MCP server failed to start: ${e instanceof Error?e.message:String(e)}\n`),process.exitCode=1}})}function ni(e){return new C(`preview`).description(`Show what content the watcher will track (read-only)`).action(async()=>{let{previewContent:t,formatPreviewBlock:n}=await import(`./preview-C-NvAf2r.mjs`),r=e(),i=process.cwd(),a=h(r,i),o;try{o=t({projectDir:i,contentDir:a,include:r.content.include,exclude:r.content.exclude})}catch(e){console.error(`Content preview failed: ${e instanceof Error?e.message:String(e)}`),process.exitCode=1;return}process.stdout.write(`${n(o,i)}\n`),o.totalCount===0&&o.warnings.length>0&&(process.exitCode=1)})}function Z(e,t){e&&process.stdout.write(`${JSON.stringify(t)}\n`)}async function ri(e,t,n=process.cwd()){let r=e.op??`sync`,i=s(m(h(t,n)));if(i&&i.port>0){let t=`http://127.0.0.1:${i.port}/api/sync/trigger`;e.json||process.stderr.write(`Triggering ${r} via running server (port ${i.port})…\n`);try{let n=await fetch(t,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({op:r})});if(!n.ok){let e=await n.json().catch(()=>({}));throw Error(e.error??`Server responded with ${n.status}`)}Z(e.json,{type:`triggered`,op:r,port:i.port}),e.json||process.stderr.write(`✓ ${r} triggered\n`);return}catch(t){let n=t instanceof Error?t.message:String(t);e.json||process.stderr.write(`Server trigger failed (${n}), running directly…\n`)}}e.json||process.stderr.write(`Running ${r} directly (no live server)…\n`);let a=M({baseDir:n});if(r===`sync`||r===`pull`){Z(e.json,{type:`step`,step:`pull`});let t=await a.pull();Z(e.json,{type:`pull`,summary:t.summary}),e.json||process.stderr.write(`  pull: ${t.summary.changes} changes\n`)}(r===`sync`||r===`push`)&&(Z(e.json,{type:`step`,step:`push`}),await a.push(),Z(e.json,{type:`push`,ok:!0}),e.json||process.stderr.write(`  push: ok
+`)),Z(e.json,{type:`complete`,op:r}),e.json||process.stderr.write(`✓ ${r} complete\n`)}function ii(e){return new C(`sync`).description(`Commit, pull, and push to the remote`).option(`--json`,`Output JSONL progress events`,!1).action(async t=>{try{await ri({json:t.json,op:`sync`},e())}catch(e){let n=e instanceof Error?e.message:String(e);t.json?process.stdout.write(`${JSON.stringify({type:`error`,message:n})}\n`):process.stderr.write(`✗ sync failed: ${n}\n`),process.exit(1)}})}function ai(e){return new C(`pull`).description(`Pull changes from the remote`).option(`--json`,`Output JSONL progress events`,!1).action(async t=>{try{await ri({json:t.json,op:`pull`},e())}catch(e){let n=e instanceof Error?e.message:String(e);t.json?process.stdout.write(`${JSON.stringify({type:`error`,message:n})}\n`):process.stderr.write(`✗ pull failed: ${n}\n`),process.exit(1)}})}function oi(e){return new C(`push`).description(`Push commits to the remote`).option(`--json`,`Output JSONL progress events`,!1).action(async t=>{try{await ri({json:t.json,op:`push`},e())}catch(e){let n=e instanceof Error?e.message:String(e);t.json?process.stdout.write(`${JSON.stringify({type:`error`,message:n})}\n`):process.stderr.write(`✗ push failed: ${n}\n`),process.exit(1)}})}function si(e,t){return{server:ci(`server`,e),ui:ci(`ui`,t)}}function ci(e,t){switch(t.status){case`missing`:return{name:e,state:`missing`,alive:!1};case`corrupt`:return{name:e,state:`corrupt`,alive:!1};case`foreign-host`:return{name:e,state:`foreign-host`,pid:t.lock.pid,port:t.lock.port,startedAt:t.lock.startedAt,host:t.lock.hostname,alive:`unknown`};case`dead-pid`:return{name:e,state:`dead-pid`,pid:t.lock.pid,port:t.lock.port,startedAt:t.lock.startedAt,host:t.lock.hostname,alive:!1};case`alive`:return{name:e,state:`alive`,pid:t.lock.pid,port:t.lock.port,startedAt:t.lock.startedAt,host:t.lock.hostname,alive:!0}}}function li(e){return`${ui(e.server)}\n${ui(e.ui)}`}function ui(e){let t=e.name===`server`?`server`:`ui    `;return e.state===`missing`?`${t}  not running`:e.state===`corrupt`?`${t}  lock file corrupt — run \`ok clean\``:e.state===`foreign-host`?`${t}  foreign host (${e.host}) pid=${e.pid} port=${e.port}`:e.state===`dead-pid`?`${t}  stale (dead pid=${e.pid}) — run \`ok clean\``:`${t}  alive  pid=${e.pid} port=${e.port} started=${e.startedAt}`}function di(e){let t=e.inspect??(t=>et(e.lockDir,t)),n=e.log??(e=>console.log(e)),r=si(t(`server`),t(`ui`));return e.json?n(JSON.stringify(r,null,2)):n(li(r)),r}function fi(e){return new C(`status`).description(`Show live state of the server + ui lockfiles for this project`).option(`--json`,`Emit structured JSON instead of formatted text`).action(t=>{di({lockDir:m(h(e(),process.cwd())),json:t.json===!0})})}function pi(e,t){let n=[];return e.status===`alive`&&n.push({name:`server`,pid:e.lock.pid,port:e.lock.port}),t.status===`alive`&&n.push({name:`ui`,pid:t.lock.pid,port:t.lock.port}),{targets:n}}function mi(e){let t=e.inspect??(t=>et(e.lockDir,t)),n=e.kill??((e,t)=>process.kill(e,t)),r=e.log??(e=>console.log(e)),i=e.error??(e=>console.error(e)),a=pi(t(`server`),t(`ui`));if(a.targets.length===0)return r(`No running open-knowledge processes.`),{stopped:[],failed:[],hadTargets:!1};let o=[],s=[];for(let e of a.targets)try{n(e.pid,`SIGTERM`),o.push(e)}catch(t){s.push({target:e,error:t instanceof Error?t.message:String(t)})}return o.length>0&&r(`Stopped: ${o.map(e=>`${e.name} (pid=${e.pid}, port=${e.port})`).join(`, `)}`),s.length>0&&i(`Failed to stop: ${s.map(({target:e,error:t})=>`${e.name} (pid=${e.pid}): ${t}`).join(`; `)}`),{stopped:o,failed:s,hadTargets:!0}}function hi(e){return new C(`stop`).description(`Stop the running open-knowledge server and UI (live only)`).action(()=>{mi({lockDir:m(h(e(),process.cwd()))}).failed.length>0&&(process.exitCode=1)})}const gi=[`connection`,`keep-alive`,`proxy-authenticate`,`proxy-authorization`,`te`,`trailer`,`transfer-encoding`,`upgrade`,`cookie`,`set-cookie`];async function _i(e){let t=e.upstreamTimeoutMs??1e4,n=Se((n,r)=>{yi(n,r,e.upstreamHost,e.upstreamPort,t)});await new Promise((t,r)=>{let i=e=>r(e);n.once(`error`,i),n.listen(e.listenPort,e.host,()=>{n.off(`error`,i),t()})});let r=n.address();return{httpServer:n,port:typeof r==`object`&&r?r.port:e.listenPort,close:()=>new Promise(e=>{n.close(()=>e())})}}function vi(e,t,n){yi(e,t,n.upstreamHost,n.upstreamPort,n.upstreamTimeoutMs??1e4)}function yi(e,t,n,r,i){let a={...e.headers};delete a.host;for(let e of gi)delete a[e];e.setTimeout(3e4,()=>{if(t.headersSent)try{t.end()}catch{}else try{t.writeHead(408,{"Content-Type":`text/plain`}),t.end(`Request Timeout`)}catch{}try{e.socket?.destroy()}catch{}});let o=Ce({host:n,port:r,method:e.method,path:e.url,headers:{...a,host:`${n}:${r}`}},e=>{let n={...e.headers};for(let e of gi)delete n[e];t.writeHead(e.statusCode??502,n),e.pipe(t),e.once(`error`,()=>{try{t.end()}catch{}})});i>0&&o.setTimeout(i,()=>{if(!t.headersSent)t.writeHead(504,{"Content-Type":`text/plain`}),t.end(`Gateway Timeout`);else try{t.end()}catch{}o.destroy()}),o.on(`error`,()=>{if(!t.headersSent)t.writeHead(502,{"Content-Type":`text/plain`}),t.end(`Bad Gateway`);else try{t.end()}catch{}}),e.on(`error`,()=>{o.destroy()}),e.pipe(o)}async function bi(e){await Promise.all(e.map(e=>new Promise(t=>{e.close(()=>t())})))}async function xi(t){let{existsSync:n}=await import(`node:fs`),{createServer:r}=await import(`node:http`),{resolve:i}=await import(`node:path`),{acquireUiLock:a,readServerLock:o,releaseUiLock:s,updateUiLockPort:c}=await import(`./src-CEP6NuWY.mjs`),{default:l}=await import(`sirv`),{resolveContentDir:u,resolveLockDir:d}=await import(`./paths-CWTmBbr0.mjs`),f=u(t.config,t.cwd),p=d(f);a(p,{port:0,worktreeRoot:t.cwd});let m=import.meta.dirname??new URL(`.`,import.meta.url).pathname,h=[i(m,`public`),i(m,`../../app/dist`),i(m,`../../../app/dist`)].find(e=>n(e)),g=h?l(h,{single:!0,gzip:!0,immutable:!0}):null,_=n(f)?l(f,{dotfiles:!1}):null,v=t.port,y=null,b=(e,t)=>{let n=e.url?.split(`?`)[0];if(n===`/api/config`&&(e.method===`GET`||e.method===`HEAD`)){y?.();let n=o(p),r=n&&n.port>0?`ws://localhost:${n.port}/collab`:null,i=JSON.stringify({collabUrl:r,previewUrl:null,port:v});t.setHeader(`Content-Type`,`application/json`),t.setHeader(`Cache-Control`,`no-store`),t.setHeader(`X-Content-Type-Options`,`nosniff`),t.statusCode=200,e.method===`HEAD`?t.end():t.end(i);return}if(n?.startsWith(`/api/`)){y?.();let r=o(p);if(!r||r.port<=0){t.writeHead(503,{"Content-Type":`application/json`,"Cache-Control":`no-store`}),t.end(JSON.stringify({error:"Collab server not running. Start `ok start` or run `ok status`.",path:n}));return}vi(e,t,{upstreamHost:`localhost`,upstreamPort:r.port});return}if(decodeURIComponent(n?.replace(/^\//,``)??``)&&_){t.setHeader(`X-Content-Type-Options`,`nosniff`),_(e,t,()=>{g?g(e,t):Si(t)});return}if(g){g(e,t);return}Si(t)},x=t.host===void 0?[`::1`,`127.0.0.1`]:[t.host],S=[],C=t.port;try{for(let e of x){let t=r(b);S.push(t),await new Promise((n,r)=>{let i=e=>r(e);t.once(`error`,i),t.listen(C,e,()=>{t.off(`error`,i);let e=t.address();typeof e==`object`&&e&&(C=e.port),n()})})}}catch(e){await Promise.all(S.map(e=>new Promise(t=>{try{e.close(()=>t())}catch{t()}})));try{s(p)}catch{}throw e}let w=C;v=w,c(p,w);let T=t.scheduler??e,E=t.safetyNetMs??432e5,D=null,O=!1,ee=!1,k=()=>{O||(O=!0,D!==null&&(T.clearTimeout(D),D=null))},A=()=>{if(k(),!ee){ee=!0;try{s(p)}catch{}}},te=()=>{O||E<=0||(D!==null&&(T.clearTimeout(D),D=null),D=T.setTimeout(()=>{D=null,console.warn(`[ui] safety-net (${E}ms) reached — shutting down (D-025 backstop)`);try{t.onSafetyNet?.()}catch{}for(let e of S)try{e.close()}catch{}A()},E))},ne=()=>{O||E<=0||te()};return y=ne,te(),{httpServers:S,port:w,release:A,detachSafetyNet:k,nudgeSafetyNet:ne}}function Si(e){e.writeHead(404),e.end(`Not found`)}function Ci(e,t){if(e!==void 0){let t=Number.parseInt(e,10);if(Number.isNaN(t)||t<0||t>65535)throw Error(`Invalid --port value '${e}'`);return t}if(t!==void 0&&t!==``){let e=Number.parseInt(t,10);if(Number.isNaN(e)||e<0||e>65535)throw Error(`Invalid PORT env value '${t}'`);return e}return 0}async function wi(e){let t=e.readLock??(async()=>{let{readUiLock:t}=await import(`./src-CEP6NuWY.mjs`);return t(e.lockDir)}),n=await t();if(!n)throw Error(`UI lock collision reported but the lock disappeared before handling — retry acquiring.`);if(n.port===e.requestedPort&&n.port>0)return{mode:`already-running`,port:n.port};let r=n.port;if(r===0){let n=Date.now()+(e.pollDeadlineMs??2e3),i=e.pollIntervalMs??100;for(;Date.now()<n;){await new Promise(e=>{setTimeout(e,i)});let e=await t();if(e&&e.port>0){r=e.port;break}}if(r===0)throw Error("UI did not bind within 2s; run `ok clean`");if(r===e.requestedPort)return{mode:`already-running`,port:r}}return{mode:`proxy`,handle:await _i({listenPort:e.requestedPort,host:e.host,upstreamHost:`localhost`,upstreamPort:r}),upstreamPort:r}}function Ti(e){return new C(`ui`).description(`Serve the Open Knowledge React editor UI`).option(`-p, --port <port>`,`UI port (default: $PORT env or 0 / kernel-allocated)`).option(`-H, --host <host>`,"UI host. Default: two-socket loopback bind (`[::1]` + `127.0.0.1`) so cross-family collisions fail loud (D-033). Pass an explicit host (e.g. `127.0.0.1`, `0.0.0.0`) to bind a single socket on that host.").action(async t=>{let{dim:n}=await import(`./colors-C2vrt_OY.mjs`),{UiLockCollisionError:r}=await import(`./src-CEP6NuWY.mjs`),{resolveContentDir:i,resolveLockDir:a}=await import(`./paths-CWTmBbr0.mjs`),o=e(),s=t.host,c;try{c=Ci(t.port,process.env.PORT)}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exitCode=1;return}try{let e=await xi({config:o,cwd:process.cwd(),port:c,host:s}),t=s===void 0||s===`::`||s===`0.0.0.0`?`localhost`:s;console.log(`${n(`[ui]`)} listening on http://${t}:${e.port}`);let r=!1,i=t=>{if(r)return;r=!0,console.log(n(`\n[ui] Shutting down (${t})...`)),e.detachSafetyNet();let i=()=>{try{e.release()}finally{process.exit(process.exitCode??0)}};bi(e.httpServers).then(i,i),setTimeout(i,2e3).unref()};process.once(`SIGINT`,()=>i(`SIGINT`)),process.once(`SIGTERM`,()=>i(`SIGTERM`));return}catch(e){if(!(e instanceof r))throw e;let t=a(i(o,process.cwd())),l=s??`localhost`,u;try{u=await wi({requestedPort:c,host:l,lockDir:t})}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exit(1)}u.mode===`already-running`&&(console.log(`UI already running at http://${l}:${u.port}`),process.exit(0)),console.log(`UI running at http://${l}:${u.upstreamPort}; acting as HTTP proxy on port ${u.handle.port}`);let d=!1,f=e=>{d||(d=!0,console.log(n(`\n[ui-proxy] Shutting down (${e})...`)),u.handle.close().finally(()=>process.exit(process.exitCode??0)),setTimeout(()=>process.exit(process.exitCode??0),2e3).unref())};process.once(`SIGINT`,()=>f(`SIGINT`)),process.once(`SIGTERM`,()=>f(`SIGTERM`))}})}process.argv.includes(`--no-color`)?(process.env.NO_COLOR=`1`,delete process.env.FORCE_COLOR):process.argv.includes(`--color`)&&(process.env.FORCE_COLOR=`1`,delete process.env.NO_COLOR);const Q=new C;let $;Q.name(`open-knowledge`).description(`Local-first knowledge base with CRDT collaboration`).version(p).option(`--cwd <path>`,`Working directory`).option(`--log-level <level>`,`Log level`,`info`).option(`--no-color`,`Disable color output`).option(`--color`,`Force color output`).hook(`preAction`,e=>{let t=e.opts(),n=t.cwd;n!==void 0&&process.chdir(n);let{config:r}=S(n),i=e.args.length===0?t:e.commands[0]?.opts()??{};i.port!==void 0&&(r.server.port=Number(i.port)),i.host!==void 0&&(r.server.host=i.host),process.env.PORT&&(r.server.port=Number(process.env.PORT)),process.env.HOST&&(r.server.host=process.env.HOST),$=r});const Ei=b(()=>$);Q.addCommand(Ei,{isDefault:!0});const Di=ti(()=>$);Q.addCommand(Di),Q.addCommand(y());const Oi=ni(()=>$);Q.addCommand(Oi);const ki=Ti(()=>$);Q.addCommand(ki),Q.addCommand(hi(()=>$)),Q.addCommand(rt(()=>$)),Q.addCommand(fi(()=>$)),Q.addCommand($e(()=>$)),Q.addCommand(ft(()=>$)),Q.addCommand(ii(()=>$)),Q.addCommand(oi(()=>$)),Q.addCommand(ai(()=>$)),await Q.parseAsync();export{};
 //# sourceMappingURL=cli.mjs.map