@inkeep/open-knowledge 0.62.0-beta.6 → 0.62.0-beta.8

package/dist/start-BjZWHsvR.mjs

@@ -0,0 +1 @@
+import{S as e,m as t,p as n,r}from"./start-CC_nXyuU.mjs";export{r as bootStartServer,n as resolveBundledReactShellDir,t as resolveHost,e as startCommand};

package/dist/{start-BqRZMdTT.mjs → start-CC_nXyuU.mjs}

@@ -1,5 +1,5 @@
-import{j as e}from"./sleep-DhRrtbfG.mjs";import{bc as t,fc as n,hc as r,xc as i,yc as a}from"./src-BD1wHyiU.mjs";import{kn as o,o as s,ri as c,t as l}from"./src-B_6tF_Gx.mjs";import{I as u,k as d}from"./fs-traced-2B_-YK-g.mjs";import{r as f}from"./server-lock-RKPNHNqb.mjs";import{C as p,S as m,x as h}from"./resolve-project-root-BjH69ZD8.mjs";import{c as g,f as _,h as v,l as y,n as b,o as x,r as S,s as C,t as w}from"./acp-harness-probe-BN1iQLwU.mjs";import{y as T}from"./init-CSNfwd6d.mjs";import{n as E}from"./constants-CTfV3NOs.mjs";import{spawn as D}from"node:child_process";import{basename as O,dirname as k,resolve as A}from"node:path";import{existsSync as j,realpathSync as M}from"node:fs";import{tmpdir as N}from"node:os";import{rm as P}from"node:fs/promises";import{setTimeout as F}from"node:timers/promises";function I(e,t){return e.bind?.[0]??t.HOST??`127.0.0.1`}function L(e){if(e===`server`)return e;throw new m(`--only must be 'server'`)}function R(e=j){let t=import.meta.dirname??new URL(`.`,import.meta.url).pathname;return[A(t,`public`),A(t,`../../app/dist`),A(t,`../../../app/dist`)].find(t=>e(t))}function z(e){if(e.explicitDir!==void 0)return{dir:e.explicitDir,missingBundle:!1};if(e.only===`server`)return{dir:void 0,missingBundle:!1};let t=e.findBundledDir();return{dir:t,missingBundle:t===void 0}}function B(t){if(t===`off`)return`off`;if(!e.test(t))throw new m(`--idle-shutdown must be 'off' or a duration like 90s, 30m, 2h`);return t}function V(e){return e===`localhost`||e===`::1`||e===`[::1]`||e.startsWith(`127.`)}function H(e){return!e.flagBindSet&&!e.okBindSet&&e.hostEnvSet&&e.fileBindCount>1}function U(e){return!e.openBrowser||e.ephemeral||e.only===`server`||!e.servesUi?!1:(e.explicitOn||V(e.host))&&e.isTTY}function W(e,t){let n;try{n=new URL(t)}catch{throw new m(`${e} is not a valid URL: ${t}`)}if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new m(`${e} must be an http(s) origin (got: ${t})`);return t}function G(e){return W(`--external-url`,e)}function K(e){let t=O(e).replace(/[^\x20-\x7E]/g,``).trim().slice(0,64);return`open-knowledge-server ${t.length>0?t:`unknown`}`}var q=class extends Error{cwd;constructor(e){super("This directory isn't set up yet. Run `ok init` first, then `ok start` again."),this.name=`OkDirMissingError`,this.cwd=e}},J=class extends Error{projectDir;constructor(e){super(`--project-dir must be a throwaway ${l}* directory under the OS temp dir. Refusing to write ephemeral session state into ${e}. Omit --project-dir to let ok start create (and clean up) its own.`),this.name=`EphemeralProjectDirNotThrowawayError`,this.projectDir=e}};function Y(e,t={}){let n=t.tmpdirFn??N,r=t.realpathFn??M,i=e=>{try{return r(e)}catch(t){return t.code===`ENOENT`?A(e):null}},a=A(e),o;try{o=r(a)}catch(e){if(e.code===`ENOENT`){let e=i(k(a));o=e===null?null:A(e,O(a))}else o=null}if(o===null)return!1;let s=i(n());return s===null?!1:k(o)===s&&O(o).startsWith(`ok-ephemeral-`)}function X(e,t,n=e=>P(e,{recursive:!0,force:!0})){return async()=>{try{await e()}finally{if(Y(t))try{await n(t)}catch(e){process.stderr.write(`[start] ephemeral temp dir reap failed for ${t}: ${e instanceof Error?e.message:String(e)}\n`)}else process.stderr.write(`[start] leaving ${t} in place: only ${l}* dirs under the OS temp dir are removed on ephemeral teardown\n`)}}}function Z(e,t={}){let n=t.exit??(e=>process.exit(e)),r=t.getActiveHandles??(()=>{let e=process._getActiveHandles;return e?e.call(process):null});return async()=>{let i=!1;try{await e()}catch(e){i=!0,t.log?.error({err:e},`idle-shutdown: destroy failed — exiting anyway`)}finally{let e=null;try{let t=r();if(t!==null){e={};for(let n of t){let t=n?.constructor?.name??`unknown`;e[t]=(e[t]??0)+1}}}catch{e=null}t.log?.info({event:`idle-shutdown-exit`,exitCode:+!!i,openHandles:e??{},handlesAvailable:e!==null},`idle-shutdown: teardown finished — exiting process`),n(+!!i)}}}async function Q(e){let{config:t,cwd:n,host:r}=e,i=e.skipAutoInit??!1,a=e.idleThresholdMs===void 0?18e5:e.idleThresholdMs,{existsSync:l,mkdirSync:u}=await import(`node:fs`),{basename:d,dirname:f,resolve:p}=await import(`node:path`),{bootServer:m,createEphemeralProjectDir:h,getLogger:g,resolveContentDir:y,resolveLockDir:x,seedEphemeralProjectDir:C,waitForServerLockDrain:E}=await import(`./src-CNzlP6PP.mjs`),D=e.log??g(`start`),O=e.singleFile!==void 0,k=O?s(e.singleFile).canonicalFilePath:void 0,A=k?f(k):void 0,j=k?d(k):void 0,M,N=!1;if(A!==void 0)if(e.projectDir!==void 0){if(M=e.projectDir,!Y(M))throw new J(M);l(p(M,`.ok`,`config.yml`))||C(M,A)}else M=h(A),N=!0;let F=async()=>{if(!(!N||M===void 0)){if(!Y(M)){D.warn({ephemeralProjectDir:M},`[start] refusing to reap self-provisioned ephemeral dir: no longer resolves to an ok-ephemeral-* temp dir`);return}try{await P(M,{recursive:!0,force:!0})}catch(e){D.warn({err:e,ephemeralProjectDir:M},`[start] failed to reap self-provisioned ephemeral temp dir`)}}},I=M;if(!O){if(!i&&!o(n))throw new q(n);let t=process.env.OK_RECLAIM_DISABLE??null,r=e=>{let t=typeof e.event==`string`?e.event:``;(t.endsWith(`-failed`)||t.endsWith(`-error`)||t.endsWith(`-missing`))&&D.warn({event:e},`[start] reclaim sweep reported a problem`)};try{(e.repairMcpConfigsFn??(await import(`./repair-mcp-configs-BQLEiFQa.mjs`)).repairMcpConfigs)({projectDir:n,reclaimDisableEnv:t,logger:r})}catch(e){D.warn({err:e},`[start] mcp-config repair sweep failed; continuing`)}try{(e.repairLaunchJsonFn??(await import(`./repair-launch-json-CRwFywBq.mjs`)).repairLaunchJson)({projectDir:n,reclaimDisableEnv:t,logger:r})}catch(e){D.warn({err:e},`[start] launch.json repair sweep failed; continuing`)}try{await(e.repairSkillsFn??(await import(`./repair-skills-D2u8xMCO.mjs`)).repairSkills)({projectDir:n,reclaimDisableEnv:t,logger:r})}catch(e){D.warn({err:e},`[start] skill repair sweep failed; continuing`)}}let L=A??y(t,n);!O&&!l(L)&&(u(L,{recursive:!0}),D.info({contentDir:L},`Created content directory`));let R=v(),z=c(),B;try{{let e=x(M??n),t=Date.now(),r=await E(e);r!==`no-drain`&&D.info({event:`start-waited-for-draining-predecessor`,outcome:r,waitedMs:Date.now()-t,drainLockDir:e},r===`released`?`[start] predecessor server finished draining — proceeding`:`[start] predecessor server still draining after wait — proceeding to collide`)}B=await m({config:t,contentDir:L,projectDir:M??n,contentRoot:O?void 0:t.content.dir,port:e.port,host:r,quiet:!1,detectGh:_,tokenStore:R,embeddingsKeyStore:z,mcpTomlEditor:T(),...O?{ephemeral:!0,singleDocRelPath:j,gitEnabled:!1,gitPreflight:()=>({ok:!0,version:`0.0.0`,resolvedPath:`git`,source:`PATH`})}:{},localOpCliArgs:[process.execPath,process.argv[1]],probeHarnessManagedMcpEntry:(e,t)=>w(e,t),probePiAcpBridge:e=>S(e),ensurePiAcpBridge:e=>b(e),idleShutdownMs:a,...e.serverRuntime===void 0?{}:{serverRuntime:e.serverRuntime},...e.bind===void 0?{}:{bind:e.bind},skipAutoInit:!0,idleShutdownHandler:t=>{let n=t;return Z(I===void 0?n:X(n,I),{log:D,exit:e.idleExit})},log:D,...e.serveContentAssets===void 0?{}:{serveContentAssets:e.serveContentAssets},...e.reactShellDistDir?{reactShellDistDir:e.reactShellDistDir}:{}})}catch(e){throw await F(),e}let V=B.destroy,H=N?async()=>{try{await V()}finally{await F()}}:V;return{httpServer:B.httpServer,destroy:H,lockDir:B.lockDir,contentDir:L,port:B.port,ready:B.ready,degraded:B.degraded}}function $(e,t,n=()=>u({absPath:d(`user`,process.cwd()),sideline:!1,warn:()=>{}}).value){return t===void 0?e:n()}function ee(e){if(e===`browser`||e===`app`)return e;throw new m(`--mode must be 'browser' or 'app'`)}function te(e){return e.OK_CONSOLE_LEVEL!==void 0||e.LOG_LEVEL!==void 0?null:`warn`}function ne(e){let t=[`Stopping OpenKnowledge…`,`Saving pending changes and releasing the server lock — this can take a few seconds.`];return e===`SIGINT`&&t.push(`Press Ctrl+C again to force quit.`),t}async function re(e,o){let s=$(e,o.singleFile),c=te(process.env);c!==null&&(process.env.OK_CONSOLE_LEVEL=c);let{renderBanner:l}=await import(`./banner-B14xalho.mjs`),{accent:u,dim:d,error:f,warning:p}=await import(`./colors-CpP5E4wV.mjs`),m=process.cwd();process.title=K(m);let h;try{h=i(process.env)}catch(e){throw e instanceof a&&(console.error(f(e.message)),process.exit(78)),e}for(let e of h.diagnostics)console.warn(p(`[config] ${e.message}`));let g=t(s,h.layer),_=h.overrides.some(e=>e.envVar===`OK_BIND`),v=o.bind!==void 0&&o.bind.length>0?o.bind:void 0,y=process.env.HOST,b=y!==void 0&&y.trim()!==``?y:void 0,x=r(g),S=v??(_||b===void 0?[...x.bind]:[b]);H({flagBindSet:v!==void 0,okBindSet:_,hostEnvSet:b!==void 0,fileBindCount:x.bind.length})&&console.warn(p(`[config] HOST=${b} overrides server.bind — dropping the file-configured addresses (${x.bind.join(`, `)}). Use OK_BIND with a space-separated list to keep multiple binds.`));let C=S[0]??`127.0.0.1`,w=S,T=o.externalUrl,D=r(t(g,{server:{bind:w,...T===void 0?{}:{externalUrl:T}}}));if(D.allowExternal&&(!D.loopbackOnly||D.externalUrl)){let e=D.externalUrl??D.bind.join(`, `);console.warn(p([``,`⚠  EXTERNAL ACCESS ENABLED (server.allowExternal) — no server-side authentication.`,`   This server is reachable beyond this machine (${e}). Anyone who can`,`   reach it has FULL control of this knowledge base — sync, publishing, GitHub`,`   credentials, and local operations (clone, sign-in, repo spawn).`,`   Restrict who can reach it at the edge: a Tailscale ACL, a reverse proxy with`,`   auth (Cloudflare Access, oauth2-proxy), or a firewall.`,``].join(`
-`)))}let O=o.port===void 0?void 0:Number(o.port),k=h.overrides.find(e=>e.envVar===`PORT`)?.value,A=O??k??s.server?.port,j=z({explicitDir:o.reactShellDistDir,only:o.only,findBundledDir:R}),M=j.dir;j.missingBundle&&console.warn(`bundled web UI not found — serving /api and /mcp only. Reinstall @inkeep/open-knowledge, or build packages/app in a source checkout.`);let N;try{N=await Q({config:s,cwd:m,host:C,port:A,bind:w,...o.serveContentAssets===void 0?{}:{serveContentAssets:o.serveContentAssets},...M?{reactShellDistDir:M}:{},idleThresholdMs:n(o.idleShutdown??D.idleShutdown),serverRuntime:D,...o.singleFile?{singleFile:o.singleFile}:{},...o.projectDir?{projectDir:o.projectDir}:{}})}catch(e){e instanceof q&&(console.error(f(e.message)),process.exit(1)),e instanceof J&&(console.error(f(e.message)),process.exit(1));let t=await import(`./src-CNzlP6PP.mjs`);if((e instanceof t.GitNotAvailableError||e instanceof t.GitTooOldError)&&process.exit(78),e instanceof t.ExposureConsentError&&(console.error(f(e.message)),process.exit(78)),(e instanceof t.SingleFileNotFoundError||e instanceof t.SingleFileNotAFileError||e instanceof t.SingleFileNotMarkdownError)&&(console.error(f(e.message)),process.exit(1)),e instanceof t.MissingOkConfigError&&(console.error(f(e.message)),process.exit(1)),oe(e,t)){let e=t.resolveLockDir(m),n=null;try{n=await ie({readServerLock:()=>t.readServerLock(e),now:Date.now,sleep:e=>F(e),timeoutMs:3e3,pollIntervalMs:50})}catch(e){process.stderr.write(`[start] spawn-or-reuse: lock poll failed (${e instanceof Error?e.message:String(e)}) — falling back to the collision message\n`)}if(n!==null){let[e,...t]=ae(n);console.log(u(e));for(let e of t)console.log(d(e));process.exit(0)}}let n=se(e,m,t);n!==null&&(console.error(f(n)),process.exit(1)),console.error(`${f(`Failed to start:`)} ${e instanceof Error?e.stack??e.message:String(e)}`),process.exit(1)}let P=!1,I=async e=>{if(P)return;P=!0;let[t,...n]=ne(e);console.log(u(`\n${t}`));for(let e of n)console.log(d(`  ${e}`));try{await N.destroy()}catch(e){console.error(`${f(`destroy() failed:`)} ${e instanceof Error?e.stack??e.message:String(e)}`),process.exitCode=1}process.exit(process.exitCode??0)};process.once(`SIGINT`,()=>{I(`SIGINT`)}),process.once(`SIGTERM`,()=>{I(`SIGTERM`)});let L=`http://${C.includes(`:`)&&!C.startsWith(`[`)?`[${C}]`:C}:${N.port}`,B=C===`0.0.0.0`||C===`::`?`http://0.0.0.0:${N.port}`:void 0,V=L;console.log(l({name:`open-knowledge`,version:E,localUrl:V,networkUrl:B,nextSteps:[`Open the Editor URL in your browser to start editing.`]}));let W={"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`};N.ready.then(async()=>{if(N.degraded.length>0){console.log();for(let e of N.degraded){let t=W[e]??`${e} (check server logs for details)`;console.warn(`  ${p(`⚠`)} ${p(e)}: ${d(t)}`)}console.log()}if(U({openBrowser:o.openBrowser!==!1&&D.openBrowser,explicitOn:o.openBrowser!==!1&&g.server?.openBrowser===!0,host:C,isTTY:process.stdout.isTTY===!0,ephemeral:o.singleFile!==void 0,only:o.only,servesUi:M!==void 0})){let{openBrowser:e}=await import(`./open-browser-BS9zcVt9.mjs`);e(V)}}).catch(e=>{console.error(`  ${f(`Server initialization failed:`)} ${e instanceof Error?e.message:String(e)}`)})}async function ie(e){let t=e.now()+e.timeoutMs,n=e.readServerLock();for(;n!==null&&n.draining!==!0&&n.port<=0&&e.now()<t;)await e.sleep(e.pollIntervalMs),n=e.readServerLock();return n===null||n.draining===!0||n.port<=0?null:f(n)&&n.url!==void 0?{url:n.url,kind:n.kind,pid:n.pid,servesUi:!0}:{url:n.url??`http://127.0.0.1:${n.port}`,kind:n.kind,pid:n.pid,servesUi:!1}}function ae(e){return[`${e.kind===`mcp-spawned`?`An MCP-spawned OpenKnowledge server is already running on this project`:`OpenKnowledge is already running on this project`} (pid ${e.pid}).`,`  ${e.url}`,"Leaving it running — run `ok stop` first if you want a fresh server."]}function oe(e,t){let n=t.ServerLockCollisionError;return n!==void 0&&e instanceof n}function se(e,t,n){let r=n.ServerLockCollisionError;if(r===void 0||!(e instanceof r))return null;try{let e=n.readServerLock(n.resolveLockDir(t));return e&&e.kind===`mcp-spawned`?"An MCP-spawned server holds this lock; it should release on idle-shutdown (~30 min). Or run `ok stop`.":"OpenKnowledge server is already running on this project — check `ok status` or `ok stop`."}catch{return null}}function ce(e){return new h(`start`).description(`Start the OpenKnowledge server (UI + API + MCP + collab on one port)`).option(`-p, --port <port>`,`Server port`,void 0).option(`--bind <address>`,`Bind address (repeatable; default 127.0.0.1 — loopback only)`,(e,t)=>[...t??[],e]).option(`--no-open-browser`,`Do not open the browser after start (interactive loopback starts open it by default)`).option(`--only <module>`,`Serve one module: 'server' (API + MCP only, no shell or browser)`,L).option(`--idle-shutdown <duration>`,`Shut the server down after this long with no connected clients ('off', or a duration like 90s, 30m, 2h; default 30m)`,B).option(`--mode <mode>`,`Force dispatch mode: 'browser' or 'app'`,ee).option(`--serve-content-assets`,`Serve content assets from this server (now the default; kept for compatibility)`).option(`--react-shell-dist-dir <path>`,`Serve React shell from <path>`).addOption(new p(`--single-file <path>`,`No-project ephemeral single-file mode: scope the server to one markdown file (git + MCP off)`).hideHelp()).addOption(new p(`--project-dir <dir>`,`Throwaway project root for --single-file (where ephemeral .ok/ state lives)`).hideHelp()).option(`--external-url <url>`,`Canonical external origin clients dial (sets server.externalUrl for this run) — its host joins the Host/Origin allowlists (CORS + external-Host admission). External exposure additionally requires consent (OK_ALLOW_EXTERNAL=1 or server.allowExternal).`,G).action(async t=>{let n=e();if(t.only===`server`&&t.reactShellDistDir!==void 0&&(process.stderr.write(`error: option '--only server' cannot be combined with '--react-shell-dist-dir'
+import{j as e}from"./sleep-DhRrtbfG.mjs";import{bc as t,fc as n,hc as r,xc as i,yc as a}from"./src-tR2kRwXj.mjs";import{kn as o,o as s,ri as c,t as l}from"./src-BHDHmhMl.mjs";import{I as u,k as d}from"./fs-traced-2B_-YK-g.mjs";import{r as f}from"./server-lock-Dngwkd_U.mjs";import{C as p,S as m,x as h}from"./resolve-project-root-C94rZ_5O.mjs";import{c as g,f as _,h as v,l as y,n as b,o as x,r as S,s as C,t as w}from"./acp-harness-probe-DS_1snlG.mjs";import{y as T}from"./init-D53VmdHm.mjs";import{n as E}from"./constants-M3x5gx4s.mjs";import{spawn as D}from"node:child_process";import{basename as O,dirname as k,resolve as A}from"node:path";import{existsSync as j,realpathSync as M}from"node:fs";import{tmpdir as N}from"node:os";import{rm as P}from"node:fs/promises";import{setTimeout as F}from"node:timers/promises";function I(e,t){return e.bind?.[0]??t.HOST??`127.0.0.1`}function L(e){if(e===`server`)return e;throw new m(`--only must be 'server'`)}function R(e=j){let t=import.meta.dirname??new URL(`.`,import.meta.url).pathname;return[A(t,`public`),A(t,`../../app/dist`),A(t,`../../../app/dist`)].find(t=>e(t))}function z(e){if(e.explicitDir!==void 0)return{dir:e.explicitDir,missingBundle:!1};if(e.only===`server`)return{dir:void 0,missingBundle:!1};let t=e.findBundledDir();return{dir:t,missingBundle:t===void 0}}function B(t){if(t===`off`)return`off`;if(!e.test(t))throw new m(`--idle-shutdown must be 'off' or a duration like 90s, 30m, 2h`);return t}function V(e){return e===`localhost`||e===`::1`||e===`[::1]`||e.startsWith(`127.`)}function H(e){return!e.flagBindSet&&!e.okBindSet&&e.hostEnvSet&&e.fileBindCount>1}function U(e){return!e.openBrowser||e.ephemeral||e.only===`server`||!e.servesUi?!1:(e.explicitOn||V(e.host))&&e.isTTY}function W(e,t){let n;try{n=new URL(t)}catch{throw new m(`${e} is not a valid URL: ${t}`)}if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new m(`${e} must be an http(s) origin (got: ${t})`);return t}function G(e){return W(`--external-url`,e)}function K(e){let t=O(e).replace(/[^\x20-\x7E]/g,``).trim().slice(0,64);return`open-knowledge-server ${t.length>0?t:`unknown`}`}var q=class extends Error{cwd;constructor(e){super("This directory isn't set up yet. Run `ok init` first, then `ok start` again."),this.name=`OkDirMissingError`,this.cwd=e}},J=class extends Error{projectDir;constructor(e){super(`--project-dir must be a throwaway ${l}* directory under the OS temp dir. Refusing to write ephemeral session state into ${e}. Omit --project-dir to let ok start create (and clean up) its own.`),this.name=`EphemeralProjectDirNotThrowawayError`,this.projectDir=e}};function Y(e,t={}){let n=t.tmpdirFn??N,r=t.realpathFn??M,i=e=>{try{return r(e)}catch(t){return t.code===`ENOENT`?A(e):null}},a=A(e),o;try{o=r(a)}catch(e){if(e.code===`ENOENT`){let e=i(k(a));o=e===null?null:A(e,O(a))}else o=null}if(o===null)return!1;let s=i(n());return s===null?!1:k(o)===s&&O(o).startsWith(`ok-ephemeral-`)}function X(e,t,n=e=>P(e,{recursive:!0,force:!0})){return async()=>{try{await e()}finally{if(Y(t))try{await n(t)}catch(e){process.stderr.write(`[start] ephemeral temp dir reap failed for ${t}: ${e instanceof Error?e.message:String(e)}\n`)}else process.stderr.write(`[start] leaving ${t} in place: only ${l}* dirs under the OS temp dir are removed on ephemeral teardown\n`)}}}function Z(e,t={}){let n=t.exit??(e=>process.exit(e)),r=t.getActiveHandles??(()=>{let e=process._getActiveHandles;return e?e.call(process):null});return async()=>{let i=!1;try{await e()}catch(e){i=!0,t.log?.error({err:e},`idle-shutdown: destroy failed — exiting anyway`)}finally{let e=null;try{let t=r();if(t!==null){e={};for(let n of t){let t=n?.constructor?.name??`unknown`;e[t]=(e[t]??0)+1}}}catch{e=null}t.log?.info({event:`idle-shutdown-exit`,exitCode:+!!i,openHandles:e??{},handlesAvailable:e!==null},`idle-shutdown: teardown finished — exiting process`),n(+!!i)}}}async function Q(e){let{config:t,cwd:n,host:r}=e,i=e.skipAutoInit??!1,a=e.idleThresholdMs===void 0?18e5:e.idleThresholdMs,{existsSync:l,mkdirSync:u}=await import(`node:fs`),{basename:d,dirname:f,resolve:p}=await import(`node:path`),{bootServer:m,createEphemeralProjectDir:h,getLogger:g,resolveContentDir:y,resolveLockDir:x,seedEphemeralProjectDir:C,waitForServerLockDrain:E}=await import(`./src-BqEF6smt.mjs`),D=e.log??g(`start`),O=e.singleFile!==void 0,k=O?s(e.singleFile).canonicalFilePath:void 0,A=k?f(k):void 0,j=k?d(k):void 0,M,N=!1;if(A!==void 0)if(e.projectDir!==void 0){if(M=e.projectDir,!Y(M))throw new J(M);l(p(M,`.ok`,`config.yml`))||C(M,A)}else M=h(A),N=!0;let F=async()=>{if(!(!N||M===void 0)){if(!Y(M)){D.warn({ephemeralProjectDir:M},`[start] refusing to reap self-provisioned ephemeral dir: no longer resolves to an ok-ephemeral-* temp dir`);return}try{await P(M,{recursive:!0,force:!0})}catch(e){D.warn({err:e,ephemeralProjectDir:M},`[start] failed to reap self-provisioned ephemeral temp dir`)}}},I=M;if(!O){if(!i&&!o(n))throw new q(n);let t=process.env.OK_RECLAIM_DISABLE??null,r=e=>{let t=typeof e.event==`string`?e.event:``;(t.endsWith(`-failed`)||t.endsWith(`-error`)||t.endsWith(`-missing`))&&D.warn({event:e},`[start] reclaim sweep reported a problem`)};try{(e.repairMcpConfigsFn??(await import(`./repair-mcp-configs-CSIhiWby.mjs`)).repairMcpConfigs)({projectDir:n,reclaimDisableEnv:t,logger:r})}catch(e){D.warn({err:e},`[start] mcp-config repair sweep failed; continuing`)}try{(e.repairLaunchJsonFn??(await import(`./repair-launch-json-CtwUv4CE.mjs`)).repairLaunchJson)({projectDir:n,reclaimDisableEnv:t,logger:r})}catch(e){D.warn({err:e},`[start] launch.json repair sweep failed; continuing`)}try{await(e.repairSkillsFn??(await import(`./repair-skills-BxzzWVm-.mjs`)).repairSkills)({projectDir:n,reclaimDisableEnv:t,logger:r})}catch(e){D.warn({err:e},`[start] skill repair sweep failed; continuing`)}}let L=A??y(t,n);!O&&!l(L)&&(u(L,{recursive:!0}),D.info({contentDir:L},`Created content directory`));let R=v(),z=c(),B;try{{let e=x(M??n),t=Date.now(),r=await E(e);r!==`no-drain`&&D.info({event:`start-waited-for-draining-predecessor`,outcome:r,waitedMs:Date.now()-t,drainLockDir:e},r===`released`?`[start] predecessor server finished draining — proceeding`:`[start] predecessor server still draining after wait — proceeding to collide`)}B=await m({config:t,contentDir:L,projectDir:M??n,contentRoot:O?void 0:t.content.dir,port:e.port,host:r,quiet:!1,detectGh:_,tokenStore:R,embeddingsKeyStore:z,mcpTomlEditor:T(),...O?{ephemeral:!0,singleDocRelPath:j,gitEnabled:!1,gitPreflight:()=>({ok:!0,version:`0.0.0`,resolvedPath:`git`,source:`PATH`})}:{},localOpCliArgs:[process.execPath,process.argv[1]],probeHarnessManagedMcpEntry:(e,t)=>w(e,t),probePiAcpBridge:e=>S(e),ensurePiAcpBridge:e=>b(e),idleShutdownMs:a,...e.serverRuntime===void 0?{}:{serverRuntime:e.serverRuntime},...e.bind===void 0?{}:{bind:e.bind},skipAutoInit:!0,idleShutdownHandler:t=>{let n=t;return Z(I===void 0?n:X(n,I),{log:D,exit:e.idleExit})},log:D,...e.serveContentAssets===void 0?{}:{serveContentAssets:e.serveContentAssets},...e.reactShellDistDir?{reactShellDistDir:e.reactShellDistDir}:{}})}catch(e){throw await F(),e}let V=B.destroy,H=N?async()=>{try{await V()}finally{await F()}}:V;return{httpServer:B.httpServer,destroy:H,lockDir:B.lockDir,contentDir:L,port:B.port,ready:B.ready,degraded:B.degraded}}function $(e,t,n=()=>u({absPath:d(`user`,process.cwd()),sideline:!1,warn:()=>{}}).value){return t===void 0?e:n()}function ee(e){if(e===`browser`||e===`app`)return e;throw new m(`--mode must be 'browser' or 'app'`)}function te(e){return e.OK_CONSOLE_LEVEL!==void 0||e.LOG_LEVEL!==void 0?null:`warn`}function ne(e){let t=[`Stopping OpenKnowledge…`,`Saving pending changes and releasing the server lock — this can take a few seconds.`];return e===`SIGINT`&&t.push(`Press Ctrl+C again to force quit.`),t}async function re(e,o){let s=$(e,o.singleFile),c=te(process.env);c!==null&&(process.env.OK_CONSOLE_LEVEL=c);let{renderBanner:l}=await import(`./banner-B14xalho.mjs`),{accent:u,dim:d,error:f,warning:p}=await import(`./colors-CpP5E4wV.mjs`),m=process.cwd();process.title=K(m);let h;try{h=i(process.env)}catch(e){throw e instanceof a&&(console.error(f(e.message)),process.exit(78)),e}for(let e of h.diagnostics)console.warn(p(`[config] ${e.message}`));let g=t(s,h.layer),_=h.overrides.some(e=>e.envVar===`OK_BIND`),v=o.bind!==void 0&&o.bind.length>0?o.bind:void 0,y=process.env.HOST,b=y!==void 0&&y.trim()!==``?y:void 0,x=r(g),S=v??(_||b===void 0?[...x.bind]:[b]);H({flagBindSet:v!==void 0,okBindSet:_,hostEnvSet:b!==void 0,fileBindCount:x.bind.length})&&console.warn(p(`[config] HOST=${b} overrides server.bind — dropping the file-configured addresses (${x.bind.join(`, `)}). Use OK_BIND with a space-separated list to keep multiple binds.`));let C=S[0]??`127.0.0.1`,w=S,T=o.externalUrl,D=r(t(g,{server:{bind:w,...T===void 0?{}:{externalUrl:T}}}));if(D.allowExternal&&(!D.loopbackOnly||D.externalUrl)){let e=D.externalUrl??D.bind.join(`, `);console.warn(p([``,`⚠  EXTERNAL ACCESS ENABLED (server.allowExternal) — no server-side authentication.`,`   This server is reachable beyond this machine (${e}). Anyone who can`,`   reach it has FULL control of this knowledge base — sync, publishing, GitHub`,`   credentials, and local operations (clone, sign-in, repo spawn).`,`   Restrict who can reach it at the edge: a Tailscale ACL, a reverse proxy with`,`   auth (Cloudflare Access, oauth2-proxy), or a firewall.`,``].join(`
+`)))}let O=o.port===void 0?void 0:Number(o.port),k=h.overrides.find(e=>e.envVar===`PORT`)?.value,A=O??k??s.server?.port,j=z({explicitDir:o.reactShellDistDir,only:o.only,findBundledDir:R}),M=j.dir;j.missingBundle&&console.warn(`bundled web UI not found — serving /api and /mcp only. Reinstall @inkeep/open-knowledge, or build packages/app in a source checkout.`);let N;try{N=await Q({config:s,cwd:m,host:C,port:A,bind:w,...o.serveContentAssets===void 0?{}:{serveContentAssets:o.serveContentAssets},...M?{reactShellDistDir:M}:{},idleThresholdMs:n(o.idleShutdown??D.idleShutdown),serverRuntime:D,...o.singleFile?{singleFile:o.singleFile}:{},...o.projectDir?{projectDir:o.projectDir}:{}})}catch(e){e instanceof q&&(console.error(f(e.message)),process.exit(1)),e instanceof J&&(console.error(f(e.message)),process.exit(1));let t=await import(`./src-BqEF6smt.mjs`);if((e instanceof t.GitNotAvailableError||e instanceof t.GitTooOldError)&&process.exit(78),e instanceof t.ExposureConsentError&&(console.error(f(e.message)),process.exit(78)),(e instanceof t.SingleFileNotFoundError||e instanceof t.SingleFileNotAFileError||e instanceof t.SingleFileNotMarkdownError)&&(console.error(f(e.message)),process.exit(1)),e instanceof t.MissingOkConfigError&&(console.error(f(e.message)),process.exit(1)),oe(e,t)){let e=t.resolveLockDir(m),n=null;try{n=await ie({readServerLock:()=>t.readServerLock(e),now:Date.now,sleep:e=>F(e),timeoutMs:3e3,pollIntervalMs:50})}catch(e){process.stderr.write(`[start] spawn-or-reuse: lock poll failed (${e instanceof Error?e.message:String(e)}) — falling back to the collision message\n`)}if(n!==null){let[e,...t]=ae(n);console.log(u(e));for(let e of t)console.log(d(e));process.exit(0)}}let n=se(e,m,t);n!==null&&(console.error(f(n)),process.exit(1)),console.error(`${f(`Failed to start:`)} ${e instanceof Error?e.stack??e.message:String(e)}`),process.exit(1)}let P=!1,I=async e=>{if(P)return;P=!0;let[t,...n]=ne(e);console.log(u(`\n${t}`));for(let e of n)console.log(d(`  ${e}`));try{await N.destroy()}catch(e){console.error(`${f(`destroy() failed:`)} ${e instanceof Error?e.stack??e.message:String(e)}`),process.exitCode=1}process.exit(process.exitCode??0)};process.once(`SIGINT`,()=>{I(`SIGINT`)}),process.once(`SIGTERM`,()=>{I(`SIGTERM`)});let L=`http://${C.includes(`:`)&&!C.startsWith(`[`)?`[${C}]`:C}:${N.port}`,B=C===`0.0.0.0`||C===`::`?`http://0.0.0.0:${N.port}`:void 0,V=L;console.log(l({name:`open-knowledge`,version:E,localUrl:V,networkUrl:B,nextSteps:[`Open the Editor URL in your browser to start editing.`]}));let W={"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`};N.ready.then(async()=>{if(N.degraded.length>0){console.log();for(let e of N.degraded){let t=W[e]??`${e} (check server logs for details)`;console.warn(`  ${p(`⚠`)} ${p(e)}: ${d(t)}`)}console.log()}if(U({openBrowser:o.openBrowser!==!1&&D.openBrowser,explicitOn:o.openBrowser!==!1&&g.server?.openBrowser===!0,host:C,isTTY:process.stdout.isTTY===!0,ephemeral:o.singleFile!==void 0,only:o.only,servesUi:M!==void 0})){let{openBrowser:e}=await import(`./open-browser-CqoTUuyv.mjs`);e(V)}}).catch(e=>{console.error(`  ${f(`Server initialization failed:`)} ${e instanceof Error?e.message:String(e)}`)})}async function ie(e){let t=e.now()+e.timeoutMs,n=e.readServerLock();for(;n!==null&&n.draining!==!0&&n.port<=0&&e.now()<t;)await e.sleep(e.pollIntervalMs),n=e.readServerLock();return n===null||n.draining===!0||n.port<=0?null:f(n)&&n.url!==void 0?{url:n.url,kind:n.kind,pid:n.pid,servesUi:!0}:{url:n.url??`http://127.0.0.1:${n.port}`,kind:n.kind,pid:n.pid,servesUi:!1}}function ae(e){return[`${e.kind===`mcp-spawned`?`An MCP-spawned OpenKnowledge server is already running on this project`:`OpenKnowledge is already running on this project`} (pid ${e.pid}).`,`  ${e.url}`,"Leaving it running — run `ok stop` first if you want a fresh server."]}function oe(e,t){let n=t.ServerLockCollisionError;return n!==void 0&&e instanceof n}function se(e,t,n){let r=n.ServerLockCollisionError;if(r===void 0||!(e instanceof r))return null;try{let e=n.readServerLock(n.resolveLockDir(t));return e&&e.kind===`mcp-spawned`?"An MCP-spawned server holds this lock; it should release on idle-shutdown (~30 min). Or run `ok stop`.":"OpenKnowledge server is already running on this project — check `ok status` or `ok stop`."}catch{return null}}function ce(e){return new h(`start`).description(`Start the OpenKnowledge server (UI + API + MCP + collab on one port)`).option(`-p, --port <port>`,`Server port`,void 0).option(`--bind <address>`,`Bind address (repeatable; default 127.0.0.1 — loopback only)`,(e,t)=>[...t??[],e]).option(`--no-open-browser`,`Do not open the browser after start (interactive loopback starts open it by default)`).option(`--only <module>`,`Serve one module: 'server' (API + MCP only, no shell or browser)`,L).option(`--idle-shutdown <duration>`,`Shut the server down after this long with no connected clients ('off', or a duration like 90s, 30m, 2h; default 30m)`,B).option(`--mode <mode>`,`Force dispatch mode: 'browser' or 'app'`,ee).option(`--serve-content-assets`,`Serve content assets from this server (now the default; kept for compatibility)`).option(`--react-shell-dist-dir <path>`,`Serve React shell from <path>`).addOption(new p(`--single-file <path>`,`No-project ephemeral single-file mode: scope the server to one markdown file (git + MCP off)`).hideHelp()).addOption(new p(`--project-dir <dir>`,`Throwaway project root for --single-file (where ephemeral .ok/ state lives)`).hideHelp()).option(`--external-url <url>`,`Canonical external origin clients dial (sets server.externalUrl for this run) — its host joins the Host/Origin allowlists (CORS + external-Host admission). External exposure additionally requires consent (OK_ALLOW_EXTERNAL=1 or server.allowExternal).`,G).action(async t=>{let n=e();if(t.only===`server`&&t.reactShellDistDir!==void 0&&(process.stderr.write(`error: option '--only server' cannot be combined with '--react-shell-dist-dir'
 `),process.exit(2)),t.projectDir!==void 0&&t.singleFile===void 0&&(process.stderr.write(`error: option '--project-dir' requires '--single-file'
 `),process.exit(2)),t.mode===`app`){let e=[];if(t.port!==void 0&&e.push(`--port`),t.bind!==void 0&&e.push(`--bind`),t.only!==void 0&&e.push(`--only`),t.idleShutdown!==void 0&&e.push(`--idle-shutdown`),t.openBrowser===!1&&e.push(`--no-open-browser`),t.externalUrl!==void 0&&e.push(`--external-url`),e.length>0){let t=process.env.OK_LOG_LEVEL??`info`;(t===`debug`||t===`trace`)&&console.error(`--mode=app: ignoring ${e.join(`, `)}`)}let n=C(x());if(n.available){g({spawn:D},n);return}console.error(y(n.reason)),process.exit(1)}await re(n,t)})}export{se as C,ce as S,Z as T,te as _,ae as a,U as b,Y as c,B as d,L as f,$ as g,ie as h,K as i,oe as l,I as m,q as n,ne as o,R as p,Q as r,V as s,J as t,G as u,z as v,X as w,H as x,re as y};
-//# sourceMappingURL=start-BqRZMdTT.mjs.map
+//# sourceMappingURL=start-CC_nXyuU.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/open-knowledge",
-  "version": "0.62.0-beta.6",
+  "version": "0.62.0-beta.8",
   "description": "Local-first, agent-friendly Markdown knowledge base with a cross-platform CLI and web editor",
   "keywords": [
     "knowledge-base",
@@ -71,10 +71,10 @@
     "ajv-formats": "^3.0.1",
     "tsdown": "^0.21.7",
     "typescript": "^5.9.3",
-    "@inkeep/open-knowledge-app": "0.62.0-beta.6",
-    "@inkeep/open-knowledge-core": "0.62.0-beta.6",
+    "@inkeep/open-knowledge-core": "0.62.0-beta.8",
     "@inkeep/open-knowledge-native-config": "0.0.0",
-    "@inkeep/open-knowledge-server": "0.62.0-beta.6"
+    "@inkeep/open-knowledge-app": "0.62.0-beta.8",
+    "@inkeep/open-knowledge-server": "0.62.0-beta.8"
   },
   "scripts": {
     "build:cli": "rm -rf dist && tsdown",

package/dist/constants-CTfV3NOs.mjs

@@ -1,2 +0,0 @@
-import"./src-BD1wHyiU.mjs";var e=`0.62.0-beta.6`;const t=`config.yml`,n=e;export{n,t};
-//# sourceMappingURL=constants-CTfV3NOs.mjs.map

package/dist/git-handle-DaYxKcxM.mjs

@@ -1 +0,0 @@
-import{i as e}from"./git-handle-BkSalb6i.mjs";export{e as createGitInstance};

package/dist/init-Bf0McBE9.mjs

@@ -1 +0,0 @@
-import"./src-B_6tF_Gx.mjs";import{g as e}from"./init-CSNfwd6d.mjs";export{e as runInit};

package/dist/loader-DdkFu1fK.mjs

@@ -1 +0,0 @@
-import{n as e}from"./loader-CiSm5ox4.mjs";export{e as loadConfig};

package/dist/md-manager-_lKMHY2F.mjs

@@ -1,2 +0,0 @@
-import{$o as e,do as t,is as n}from"./src-BD1wHyiU.mjs";const r=new t({extensions:e,deriveStructuralFreshness:!0}),i=n(e);export{i as n,r as t};
-//# sourceMappingURL=md-manager-_lKMHY2F.mjs.map

package/dist/preview-ZrB__tgX.mjs

@@ -1 +0,0 @@
-import{n as e,t}from"./preview-Bb2Blh4l.mjs";export{t as formatPreviewBlock,e as previewContent};