@karmaniverous/jeeves-server 3.4.2 → 3.5.0

package/dist/client/assets/theme-CPpIxvB0.js

@@ -0,0 +1,2 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/dist-2YqVIvgv.js","assets/dist-B2t4dYA2.js","assets/dist-5vamY028.js","assets/dist-Kr-mUYW1.js","assets/dist-DUcac0X_.js","assets/dist-BPy6CnYN.js","assets/dist-ui4J6fvl.js","assets/dist-qiU0qoeK.js","assets/dist-DSgLBuTS.js","assets/dist-B2SZD_eN.js","assets/dist-B5gFYAn7.js","assets/dist-DcTcc-BG.js","assets/dist-CL6VCrQn.js","assets/dist-DvfTyWk_.js","assets/dist-Dz1Ulpqa.js","assets/dist-B0kq1DQG.js","assets/dist-CnFc5Ssx.js","assets/dist-CWsHar9N.js","assets/dist-OX4k3MMG.js","assets/dist-6_auAGci.js"])))=>i.map(i=>d[i]);
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),s=(e,n)=>{let r={};for(var i in e)t(r,i,{get:e[i],enumerable:!0});return n||t(r,Symbol.toStringTag,{value:`Module`}),r},c=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},l=(n,r,a)=>(a=n==null?{}:e(i(n)),c(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n)),u=o((e=>{var t=Symbol.for(`react.transitional.element`),n=Symbol.for(`react.portal`),r=Symbol.for(`react.fragment`),i=Symbol.for(`react.strict_mode`),a=Symbol.for(`react.profiler`),o=Symbol.for(`react.consumer`),s=Symbol.for(`react.context`),c=Symbol.for(`react.forward_ref`),l=Symbol.for(`react.suspense`),u=Symbol.for(`react.memo`),d=Symbol.for(`react.lazy`),f=Symbol.for(`react.activity`),p=Symbol.iterator;function m(e){return typeof e!=`object`||!e?null:(e=p&&e[p]||e[`@@iterator`],typeof e==`function`?e:null)}var h={isMounted:function(){return!1},enqueueForceUpdate:function(){},enqueueReplaceState:function(){},enqueueSetState:function(){}},g=Object.assign,_={};function v(e,t,n){this.props=e,this.context=t,this.refs=_,this.updater=n||h}v.prototype.isReactComponent={},v.prototype.setState=function(e,t){if(typeof e!=`object`&&typeof e!=`function`&&e!=null)throw Error(`takes an object of state variables to update or a function which returns an object of state variables.`);this.updater.enqueueSetState(this,e,t,`setState`)},v.prototype.forceUpdate=function(e){this.updater.enqueueForceUpdate(this,e,`forceUpdate`)};function y(){}y.prototype=v.prototype;function b(e,t,n){this.props=e,this.context=t,this.refs=_,this.updater=n||h}var x=b.prototype=new y;x.constructor=b,g(x,v.prototype),x.isPureReactComponent=!0;var S=Array.isArray;function C(){}var w={H:null,A:null,T:null,S:null},T=Object.prototype.hasOwnProperty;function E(e,n,r){var i=r.ref;return{$$typeof:t,type:e,key:n,ref:i===void 0?null:i,props:r}}function D(e,t){return E(e.type,t,e.props)}function O(e){return typeof e==`object`&&!!e&&e.$$typeof===t}function k(e){var t={"=":`=0`,":":`=2`};return`$`+e.replace(/[=:]/g,function(e){return t[e]})}var A=/\/+/g;function j(e,t){return typeof e==`object`&&e&&e.key!=null?k(``+e.key):t.toString(36)}function M(e){switch(e.status){case`fulfilled`:return e.value;case`rejected`:throw e.reason;default:switch(typeof e.status==`string`?e.then(C,C):(e.status=`pending`,e.then(function(t){e.status===`pending`&&(e.status=`fulfilled`,e.value=t)},function(t){e.status===`pending`&&(e.status=`rejected`,e.reason=t)})),e.status){case`fulfilled`:return e.value;case`rejected`:throw e.reason}}throw e}function N(e,r,i,a,o){var s=typeof e;(s===`undefined`||s===`boolean`)&&(e=null);var c=!1;if(e===null)c=!0;else switch(s){case`bigint`:case`string`:case`number`:c=!0;break;case`object`:switch(e.$$typeof){case t:case n:c=!0;break;case d:return c=e._init,N(c(e._payload),r,i,a,o)}}if(c)return o=o(e),c=a===``?`.`+j(e,0):a,S(o)?(i=``,c!=null&&(i=c.replace(A,`$&/`)+`/`),N(o,r,i,``,function(e){return e})):o!=null&&(O(o)&&(o=D(o,i+(o.key==null||e&&e.key===o.key?``:(``+o.key).replace(A,`$&/`)+`/`)+c)),r.push(o)),1;c=0;var l=a===``?`.`:a+`:`;if(S(e))for(var u=0;u<e.length;u++)a=e[u],s=l+j(a,u),c+=N(a,r,i,s,o);else if(u=m(e),typeof u==`function`)for(e=u.call(e),u=0;!(a=e.next()).done;)a=a.value,s=l+j(a,u++),c+=N(a,r,i,s,o);else if(s===`object`){if(typeof e.then==`function`)return N(M(e),r,i,a,o);throw r=String(e),Error(`Objects are not valid as a React child (found: `+(r===`[object Object]`?`object with keys {`+Object.keys(e).join(`, `)+`}`:r)+`). If you meant to render a collection of children, use an array instead.`)}return c}function P(e,t,n){if(e==null)return e;var r=[],i=0;return N(e,r,``,``,function(e){return t.call(n,e,i++)}),r}function F(e){if(e._status===-1){var t=e._result;t=t(),t.then(function(t){(e._status===0||e._status===-1)&&(e._status=1,e._result=t)},function(t){(e._status===0||e._status===-1)&&(e._status=2,e._result=t)}),e._status===-1&&(e._status=0,e._result=t)}if(e._status===1)return e._result.default;throw e._result}var I=typeof reportError==`function`?reportError:function(e){if(typeof window==`object`&&typeof window.ErrorEvent==`function`){var t=new window.ErrorEvent(`error`,{bubbles:!0,cancelable:!0,message:typeof e==`object`&&e&&typeof e.message==`string`?String(e.message):String(e),error:e});if(!window.dispatchEvent(t))return}else if(typeof process==`object`&&typeof process.emit==`function`){process.emit(`uncaughtException`,e);return}console.error(e)},L={map:P,forEach:function(e,t,n){P(e,function(){t.apply(this,arguments)},n)},count:function(e){var t=0;return P(e,function(){t++}),t},toArray:function(e){return P(e,function(e){return e})||[]},only:function(e){if(!O(e))throw Error(`React.Children.only expected to receive a single React element child.`);return e}};e.Activity=f,e.Children=L,e.Component=v,e.Fragment=r,e.Profiler=a,e.PureComponent=b,e.StrictMode=i,e.Suspense=l,e.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE=w,e.__COMPILER_RUNTIME={__proto__:null,c:function(e){return w.H.useMemoCache(e)}},e.cache=function(e){return function(){return e.apply(null,arguments)}},e.cacheSignal=function(){return null},e.cloneElement=function(e,t,n){if(e==null)throw Error(`The argument must be a React element, but you passed `+e+`.`);var r=g({},e.props),i=e.key;if(t!=null)for(a in t.key!==void 0&&(i=``+t.key),t)!T.call(t,a)||a===`key`||a===`__self`||a===`__source`||a===`ref`&&t.ref===void 0||(r[a]=t[a]);var a=arguments.length-2;if(a===1)r.children=n;else if(1<a){for(var o=Array(a),s=0;s<a;s++)o[s]=arguments[s+2];r.children=o}return E(e.type,i,r)},e.createContext=function(e){return e={$$typeof:s,_currentValue:e,_currentValue2:e,_threadCount:0,Provider:null,Consumer:null},e.Provider=e,e.Consumer={$$typeof:o,_context:e},e},e.createElement=function(e,t,n){var r,i={},a=null;if(t!=null)for(r in t.key!==void 0&&(a=``+t.key),t)T.call(t,r)&&r!==`key`&&r!==`__self`&&r!==`__source`&&(i[r]=t[r]);var o=arguments.length-2;if(o===1)i.children=n;else if(1<o){for(var s=Array(o),c=0;c<o;c++)s[c]=arguments[c+2];i.children=s}if(e&&e.defaultProps)for(r in o=e.defaultProps,o)i[r]===void 0&&(i[r]=o[r]);return E(e,a,i)},e.createRef=function(){return{current:null}},e.forwardRef=function(e){return{$$typeof:c,render:e}},e.isValidElement=O,e.lazy=function(e){return{$$typeof:d,_payload:{_status:-1,_result:e},_init:F}},e.memo=function(e,t){return{$$typeof:u,type:e,compare:t===void 0?null:t}},e.startTransition=function(e){var t=w.T,n={};w.T=n;try{var r=e(),i=w.S;i!==null&&i(n,r),typeof r==`object`&&r&&typeof r.then==`function`&&r.then(C,I)}catch(e){I(e)}finally{t!==null&&n.types!==null&&(t.types=n.types),w.T=t}},e.unstable_useCacheRefresh=function(){return w.H.useCacheRefresh()},e.use=function(e){return w.H.use(e)},e.useActionState=function(e,t,n){return w.H.useActionState(e,t,n)},e.useCallback=function(e,t){return w.H.useCallback(e,t)},e.useContext=function(e){return w.H.useContext(e)},e.useDebugValue=function(){},e.useDeferredValue=function(e,t){return w.H.useDeferredValue(e,t)},e.useEffect=function(e,t){return w.H.useEffect(e,t)},e.useEffectEvent=function(e){return w.H.useEffectEvent(e)},e.useId=function(){return w.H.useId()},e.useImperativeHandle=function(e,t,n){return w.H.useImperativeHandle(e,t,n)},e.useInsertionEffect=function(e,t){return w.H.useInsertionEffect(e,t)},e.useLayoutEffect=function(e,t){return w.H.useLayoutEffect(e,t)},e.useMemo=function(e,t){return w.H.useMemo(e,t)},e.useOptimistic=function(e,t){return w.H.useOptimistic(e,t)},e.useReducer=function(e,t,n){return w.H.useReducer(e,t,n)},e.useRef=function(e){return w.H.useRef(e)},e.useState=function(e){return w.H.useState(e)},e.useSyncExternalStore=function(e,t,n){return w.H.useSyncExternalStore(e,t,n)},e.useTransition=function(){return w.H.useTransition()},e.version=`19.2.4`})),d=o(((e,t)=>{t.exports=u()})),f=`modulepreload`,p=function(e){return`/app/`+e},m={},h=function(e,t,n){let r=Promise.resolve();if(t&&t.length>0){let e=document.getElementsByTagName(`link`),i=document.querySelector(`meta[property=csp-nonce]`),a=i?.nonce||i?.getAttribute(`nonce`);function o(e){return Promise.all(e.map(e=>Promise.resolve(e).then(e=>({status:`fulfilled`,value:e}),e=>({status:`rejected`,reason:e}))))}r=o(t.map(t=>{if(t=p(t,n),t in m)return;m[t]=!0;let r=t.endsWith(`.css`),i=r?`[rel="stylesheet"]`:``;if(n)for(let n=e.length-1;n>=0;n--){let i=e[n];if(i.href===t&&(!r||i.rel===`stylesheet`))return}else if(document.querySelector(`link[href="${t}"]${i}`))return;let o=document.createElement(`link`);if(o.rel=r?`stylesheet`:f,r||(o.as=`script`),o.crossOrigin=``,o.href=t,a&&o.setAttribute(`nonce`,a),document.head.appendChild(o),r)return new Promise((e,n)=>{o.addEventListener(`load`,e),o.addEventListener(`error`,()=>n(Error(`Unable to preload CSS for ${t}`)))})}))}function i(e){let t=new Event(`vite:preloadError`,{cancelable:!0});if(t.payload=e,window.dispatchEvent(t),!t.defaultPrevented)throw e}return r.then(t=>{for(let e of t||[])e.status===`rejected`&&i(e.reason);return e().catch(i)})},g=o((e=>{var t=Symbol.for(`react.transitional.element`),n=Symbol.for(`react.fragment`);function r(e,n,r){var i=null;if(r!==void 0&&(i=``+r),n.key!==void 0&&(i=``+n.key),`key`in n)for(var a in r={},n)a!==`key`&&(r[a]=n[a]);else r=n;return n=r.ref,{$$typeof:t,type:e,key:i,ref:n===void 0?null:n,props:r}}e.Fragment=n,e.jsx=r,e.jsxs=r})),_=o(((e,t)=>{t.exports=g()}));async function v(){let[{EditorView:e,basicSetup:t},{EditorState:n},{keymap:r},{oneDark:i}]=await Promise.all([h(()=>import(`./dist-2YqVIvgv.js`),__vite__mapDeps([0,1,2,3,4])),h(()=>import(`./dist-Kr-mUYW1.js`).then(e=>e.x),[]),h(()=>import(`./dist-DUcac0X_.js`).then(e=>e.c),__vite__mapDeps([4,3])),h(()=>import(`./dist-BPy6CnYN.js`),__vite__mapDeps([5,2,3,4]))]);return{EditorView:e,EditorState:n,basicSetup:t,keymap:r,oneDark:i}}async function y(e){switch(e.toLowerCase()){case`js`:case`jsx`:case`mjs`:case`cjs`:return(await h(async()=>{let{javascript:e}=await import(`./dist-ui4J6fvl.js`).then(e=>e.t);return{javascript:e}},__vite__mapDeps([6,1,2,3,4,7]))).javascript({jsx:e.includes(`x`)});case`ts`:case`tsx`:case`mts`:case`cts`:return(await h(async()=>{let{javascript:e}=await import(`./dist-ui4J6fvl.js`).then(e=>e.t);return{javascript:e}},__vite__mapDeps([6,1,2,3,4,7]))).javascript({jsx:e.includes(`x`),typescript:!0});case`html`:case`htm`:return(await h(async()=>{let{html:e}=await import(`./dist-DSgLBuTS.js`);return{html:e}},__vite__mapDeps([8,9,2,3,4,7,6,1]))).html();case`css`:case`scss`:return(await h(async()=>{let{css:e}=await import(`./dist-B2SZD_eN.js`).then(e=>e.r);return{css:e}},__vite__mapDeps([9,2,3,4,7]))).css();case`json`:case`jsonl`:return(await h(async()=>{let{json:e}=await import(`./dist-B5gFYAn7.js`);return{json:e}},__vite__mapDeps([10,2,3,4,7]))).json();case`md`:case`mdx`:case`markdown`:return(await h(async()=>{let{markdown:e}=await import(`./dist-DcTcc-BG.js`);return{markdown:e}},__vite__mapDeps([11,1,2,3,4,8,9,7,6]))).markdown();case`py`:case`pyw`:return(await h(async()=>{let{python:e}=await import(`./dist-CL6VCrQn.js`);return{python:e}},__vite__mapDeps([12,1,2,3,4,7]))).python();case`xml`:case`svg`:case`xsl`:case`xhtml`:return(await h(async()=>{let{xml:e}=await import(`./dist-DvfTyWk_.js`);return{xml:e}},__vite__mapDeps([13,2,3,4,7]))).xml();case`yaml`:case`yml`:return(await h(async()=>{let{yaml:e}=await import(`./dist-Dz1Ulpqa.js`);return{yaml:e}},__vite__mapDeps([14,2,3,4,7]))).yaml();case`c`:case`h`:case`cpp`:case`hpp`:case`cc`:case`cxx`:return(await h(async()=>{let{cpp:e}=await import(`./dist-B0kq1DQG.js`);return{cpp:e}},__vite__mapDeps([15,2,3,4,7]))).cpp();case`java`:return(await h(async()=>{let{java:e}=await import(`./dist-CnFc5Ssx.js`);return{java:e}},__vite__mapDeps([16,2,3,4,7]))).java();case`rs`:return(await h(async()=>{let{rust:e}=await import(`./dist-CWsHar9N.js`);return{rust:e}},__vite__mapDeps([17,2,3,4,7]))).rust();case`sql`:return(await h(async()=>{let{sql:e}=await import(`./dist-OX4k3MMG.js`);return{sql:e}},__vite__mapDeps([18,1,2,3,4,7]))).sql();case`php`:return(await h(async()=>{let{php:e}=await import(`./dist-6_auAGci.js`);return{php:e}},__vite__mapDeps([19,8,9,2,3,4,7,6,1]))).php();default:return null}}var b=l(d(),1);function x(e){e===`dark`?document.documentElement.classList.add(`dark`):document.documentElement.classList.remove(`dark`)}function S(){let[e,t]=(0,b.useState)(()=>{let e=localStorage.getItem(`jeeves-theme`)===`dark`?`dark`:`light`;return x(e),e});return(0,b.useEffect)(()=>{x(e)},[e]),[e,(0,b.useCallback)(()=>{t(e=>{let t=e===`dark`?`light`:`dark`;return localStorage.setItem(`jeeves-theme`,t),t})},[])]}export{h as a,s as c,_ as i,l,y as n,d as o,v as r,o as s,S as t};

package/dist/client/index.html

@@ -6,8 +6,9 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="robots" content="noindex, nofollow" />
     <title>Jeeves Server</title>
-    <script type="module" crossorigin src="/app/assets/index-jSGuHSeS.js"></script>
-    <link rel="stylesheet" crossorigin href="/app/assets/index-D-RC7ZS6.css">
+    <script type="module" crossorigin src="/app/assets/index-DrBXupPz.js"></script>
+    <link rel="modulepreload" crossorigin href="/app/assets/theme-CPpIxvB0.js">
+    <link rel="stylesheet" crossorigin href="/app/assets/index-Dk_myGs4.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/src/cli/commands/config.test.js

@@ -17,7 +17,10 @@ const VALID_CONFIG = {
     events: {},
 };
 function writeConfig(dir, config) {
-    const filePath = path.join(dir, 'jeeves-server.config.json');
+    // Write to the new convention path: {dir}/jeeves-server/config.json
+    const configDir = path.join(dir, 'jeeves-server');
+    fs.mkdirSync(configDir, { recursive: true });
+    const filePath = path.join(configDir, 'config.json');
     fs.writeFileSync(filePath, JSON.stringify(config));
     return filePath;
 }
@@ -32,13 +35,10 @@ describe('jeeves-server config validate', () => {
     afterEach(() => {
         fs.rmSync(tmpDir, { recursive: true, force: true });
     });
-    it('validates a valid config and prints summary', async () => {
+    it('validates a valid config and prints success', async () => {
         const configPath = writeConfig(tmpDir, VALID_CONFIG);
         const { stdout } = await runCli(['config', 'validate', '-c', configPath]);
         expect(stdout).toContain('Configuration valid');
-        expect(stdout).toContain('Port: 8765');
-        expect(stdout).toContain('Auth modes: keys');
-        expect(stdout).toContain('Keys: 2');
     });
     it('exits with error for invalid config', async () => {
         const configPath = writeConfig(tmpDir, { port: 1234 });
@@ -47,38 +47,3 @@ describe('jeeves-server config validate', () => {
         });
     });
 });
-describe('jeeves-server config show', () => {
-    let tmpDir;
-    beforeEach(() => {
-        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'jeeves-cli-'));
-    });
-    afterEach(() => {
-        fs.rmSync(tmpDir, { recursive: true, force: true });
-    });
-    it('shows resolved config with key and insider details', async () => {
-        const configPath = writeConfig(tmpDir, {
-            ...VALID_CONFIG,
-            insiders: { 'test@example.com': {} },
-            watcherUrl: 'http://localhost:3458',
-        });
-        const { stdout } = await runCli(['config', 'show', '-c', configPath]);
-        expect(stdout).toContain('Config file:');
-        expect(stdout).toContain('port: 8765');
-        expect(stdout).toContain('modes: keys');
-        expect(stdout).toContain('primary:');
-        expect(stdout).toContain('unscoped');
-        expect(stdout).toContain('test@example.com');
-        expect(stdout).toContain('watcherUrl: http://localhost:3458');
-    });
-    it('shows scoped keys correctly', async () => {
-        const configPath = writeConfig(tmpDir, {
-            ...VALID_CONFIG,
-            keys: {
-                ...VALID_CONFIG.keys,
-                scoped: { key: 'c'.repeat(64), scopes: ['/docs'] },
-            },
-        });
-        const { stdout } = await runCli(['config', 'show', '-c', configPath]);
-        expect(stdout).toContain('scoped (allow: 1, deny: 0)');
-    });
-});

package/dist/src/cli/index.js

@@ -1,20 +1,14 @@
 #!/usr/bin/env node
 /**
- * @packageDocumentation
- *
  * jeeves-server CLI entrypoint.
- * Commands: start, config validate, config show, service install/uninstall.
+ *
+ * Uses `createServiceCli(descriptor)` from core for all standard commands.
+ * The `start` command uses `descriptor.startCommand` which points to
+ * `start-server.ts` for direct in-process server launch.
+ *
+ * @packageDocumentation
  */
-import { Command } from '@commander-js/extra-typings';
-import { packageVersion } from '../util/packageVersion.js';
-import { registerConfigCommand } from './commands/config.js';
-import { registerServiceCommand } from './commands/service.js';
-import { registerStartCommand } from './commands/start.js';
-const cli = new Command()
-    .name('jeeves-server')
-    .description('Self-hosted file browser, document server, and webhook gateway')
-    .version(packageVersion);
-registerStartCommand(cli);
-registerConfigCommand(cli);
-registerServiceCommand(cli);
+import { createServiceCli } from '@karmaniverous/jeeves';
+import { serverDescriptor } from '../descriptor.js';
+const cli = createServiceCli(serverDescriptor);
 cli.parse();

package/dist/src/cli/start-server.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Minimal server launcher for use by system service managers (NSSM, systemd, launchd).
+ *
+ * This is the entry point referenced by `descriptor.startCommand`. It initializes
+ * config from the `--config` CLI argument and starts the Fastify server directly,
+ * without going through the full Commander CLI.
+ *
+ * The CLI's `start` command uses this same logic in-process.
+ */
+import { initConfig } from '../config/index.js';
+const configIndex = process.argv.indexOf('--config');
+const configPath = configIndex !== -1 ? process.argv[configIndex + 1] : undefined;
+initConfig(configPath);
+// Dynamic import to ensure config is initialized before server modules load
+await import('../server.js');

package/dist/src/config/index.js

@@ -2,60 +2,71 @@
  * @packageDocumentation
  *
  * Config loading and singleton management.
- * Loads config via cosmiconfig, validates with Zod, applies env var substitution,
+ * Loads config from a JSON file, validates with Zod, applies env var substitution,
  * resolves runtime types via resolve.ts, and exposes getConfig()/resetConfig().
  */
+import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { cosmiconfig } from 'cosmiconfig';
+import { migrateConfigPath } from './migration.js';
 import { buildRuntimeConfig } from './resolve.js';
 import { jeevesConfigSchema } from './schema.js';
 import { substituteEnvVars } from './substituteEnvVars.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const rootDir = path.resolve(__dirname, '../../..');
-const MODULE_NAME = 'jeeves-server';
 /**
- * Load and validate jeeves-server configuration via cosmiconfig.
- *
- * Searches for `jeeves-server.config.{json,yaml,yml,js,ts,cjs,mjs}`
- * or `.jeeves-serverrc` in the package root and parent directories.
+ * Load and validate jeeves-server configuration from a JSON file.
  *
  * @param configPath - Optional explicit path to a config file.
  * @returns Resolved runtime configuration.
  */
-export async function loadConfig(configPath) {
-    const explorer = cosmiconfig(MODULE_NAME, {
-        searchPlaces: [
-            'package.json',
-            `.${MODULE_NAME}rc`,
-            `.${MODULE_NAME}rc.json`,
-            `.${MODULE_NAME}rc.yaml`,
-            `.${MODULE_NAME}rc.yml`,
-            `${MODULE_NAME}.config.json`,
-            `${MODULE_NAME}.config.yaml`,
-            `${MODULE_NAME}.config.yml`,
-            `${MODULE_NAME}.config.js`,
-            `${MODULE_NAME}.config.ts`,
-            `${MODULE_NAME}.config.mjs`,
-            `${MODULE_NAME}.config.cjs`,
-        ],
-    });
-    const result = configPath
-        ? await explorer.load(configPath)
-        : await explorer.search(rootDir);
-    if (!result || result.isEmpty) {
-        throw new Error(`No jeeves-server configuration found. Create a jeeves-server.config.json (or .yaml) file.\n` +
-            `Searched from: ${rootDir}`);
+export function loadConfig(configPath) {
+    const resolvedPath = configPath
+        ? migrateConfigPath(configPath)
+        : findDefaultConfig();
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error(`Configuration file not found: ${resolvedPath}\n` +
+            `Create a jeeves-server config.json file or pass --config <path>.`);
+    }
+    // Reject non-JSON config files
+    const ext = path.extname(resolvedPath).toLowerCase();
+    if (ext && ext !== '.json') {
+        throw new Error(`Unsupported config file format: ${ext}\n` +
+            `Only JSON configuration files are supported. ` +
+            `Please convert your config to JSON format.`);
+    }
+    const rawContent = fs.readFileSync(resolvedPath, 'utf8');
+    let rawConfig;
+    try {
+        rawConfig = JSON.parse(rawContent);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse config file ${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
     }
-    const substituted = substituteEnvVars(result.config);
+    const substituted = substituteEnvVars(rawConfig);
     const parseResult = jeevesConfigSchema.safeParse(substituted);
     if (!parseResult.success) {
         const issues = parseResult.error.issues
             .map((i) => `  - ${i.path.join('.')}: ${i.message}`)
             .join('\n');
-        throw new Error(`Invalid configuration in ${result.filepath}:\n${issues}`);
+        throw new Error(`Invalid configuration in ${resolvedPath}:\n${issues}`);
     }
-    return buildRuntimeConfig(parseResult.data, rootDir, result.filepath);
+    return buildRuntimeConfig(parseResult.data, rootDir, resolvedPath);
+}
+/**
+ * Find the default config file in the package root directory.
+ */
+function findDefaultConfig() {
+    // Try new convention first
+    const newPath = path.join(rootDir, 'jeeves-server', 'config.json');
+    if (fs.existsSync(newPath))
+        return newPath;
+    // Fall back to old convention
+    const oldPath = path.join(rootDir, 'jeeves-server.config.json');
+    if (fs.existsSync(oldPath))
+        return oldPath;
+    // Return new path for error message
+    return newPath;
 }
 let configInstance = null;
 let lastConfigPath;
@@ -79,17 +90,17 @@ export function getConfig() {
  * Initialize the config singleton. Must be called once at startup.
  * @param configPath - Optional explicit path to a config file.
  */
-export async function initConfig(configPath) {
+export function initConfig(configPath) {
     lastConfigPath = configPath;
-    configInstance = await loadConfig(configPath);
+    configInstance = loadConfig(configPath);
     return configInstance;
 }
 /**
  * Reload the config singleton from the last-used config path.
  * Call after mutating state that affects resolved config (e.g., key rotation).
  */
-export async function resetConfig() {
-    configInstance = await loadConfig(lastConfigPath);
+export function resetConfig() {
+    configInstance = loadConfig(lastConfigPath);
 }
 /**
  * Clear the config singleton (for testing only).

package/dist/src/config/loadConfig.test.js

@@ -28,21 +28,23 @@ describe('loadConfig', () => {
         fs.rmSync(tmpDir, { recursive: true, force: true });
         clearConfig();
     });
-    it('loads a valid JSON config file', async () => {
+    it('loads a valid JSON config file', () => {
         const configPath = writeConfig(tmpDir, VALID_CONFIG);
-        const config = await loadConfig(configPath);
+        const config = loadConfig(configPath);
         expect(config.port).toBe(9999);
         expect(config.chromePath).toBe('/usr/bin/chromium');
-        expect(config.configPath).toBe(configPath);
+        // Migration moves jeeves-server.config.json → jeeves-server/config.json
+        const expectedPath = path.join(tmpDir, 'jeeves-server', 'config.json');
+        expect(config.configPath).toBe(expectedPath);
     });
-    it('throws on missing config', async () => {
-        await expect(loadConfig(path.join(tmpDir, 'nonexistent.json'))).rejects.toThrow();
+    it('throws on missing config', () => {
+        expect(() => loadConfig(path.join(tmpDir, 'nonexistent.json'))).toThrow();
     });
-    it('throws on invalid config (missing auth)', async () => {
+    it('throws on invalid config (missing auth)', () => {
         const configPath = writeConfig(tmpDir, { port: 1234 });
-        await expect(loadConfig(configPath)).rejects.toThrow('Invalid configuration');
+        expect(() => loadConfig(configPath)).toThrow('Invalid configuration');
     });
-    it('applies env var substitution', async () => {
+    it('applies env var substitution', () => {
         const original = process.env['TEST_CHROME_PATH'];
         process.env['TEST_CHROME_PATH'] = '/custom/chrome';
         try {
@@ -50,7 +52,7 @@ describe('loadConfig', () => {
                 ...VALID_CONFIG,
                 chromePath: '${TEST_CHROME_PATH}',
             });
-            const config = await loadConfig(configPath);
+            const config = loadConfig(configPath);
             expect(config.chromePath).toBe('/custom/chrome');
         }
         finally {
@@ -60,14 +62,14 @@ describe('loadConfig', () => {
                 process.env['TEST_CHROME_PATH'] = original;
         }
     });
-    it('applies default port when omitted', async () => {
+    it('applies default port when omitted', () => {
         const noPort = { ...VALID_CONFIG };
         delete noPort.port;
         const configPath = writeConfig(tmpDir, noPort);
-        const config = await loadConfig(configPath);
+        const config = loadConfig(configPath);
         expect(config.port).toBe(1934);
     });
-    it('rejects _plugin key with scopes', async () => {
+    it('rejects _plugin key with scopes', () => {
         const configPath = writeConfig(tmpDir, {
             ...VALID_CONFIG,
             keys: {
@@ -75,9 +77,9 @@ describe('loadConfig', () => {
                 _plugin: { key: 'c'.repeat(64), scopes: ['/restricted'] },
             },
         });
-        await expect(loadConfig(configPath)).rejects.toThrow('_plugin key must not have scopes');
+        expect(() => loadConfig(configPath)).toThrow('_plugin key must not have scopes');
     });
-    it('rejects _internal key with scopes', async () => {
+    it('rejects _internal key with scopes', () => {
         const configPath = writeConfig(tmpDir, {
             ...VALID_CONFIG,
             keys: {
@@ -85,9 +87,9 @@ describe('loadConfig', () => {
                 _internal: { key: 'b'.repeat(64), scopes: ['/restricted'] },
             },
         });
-        await expect(loadConfig(configPath)).rejects.toThrow('_internal key must not have scopes');
+        expect(() => loadConfig(configPath)).toThrow('_internal key must not have scopes');
     });
-    it('accepts _plugin key without scopes', async () => {
+    it('accepts _plugin key without scopes', () => {
         const configPath = writeConfig(tmpDir, {
             ...VALID_CONFIG,
             keys: {
@@ -95,10 +97,10 @@ describe('loadConfig', () => {
                 _plugin: 'c'.repeat(64),
             },
         });
-        const config = await loadConfig(configPath);
+        const config = loadConfig(configPath);
         expect(config.resolvedKeys.find((k) => k.name === '_plugin')?.seed).toBe('c'.repeat(64));
     });
-    it('rejects undefined named scope references', async () => {
+    it('rejects undefined named scope references', () => {
         const configPath = writeConfig(tmpDir, {
             ...VALID_CONFIG,
             scopes: { restricted: { allow: ['/**'], deny: ['/secret'] } },
@@ -107,16 +109,16 @@ describe('loadConfig', () => {
                 'b@example.com': { scopes: 'missing' },
             },
         });
-        await expect(loadConfig(configPath)).rejects.toThrow('Scope "missing" is not defined');
+        expect(() => loadConfig(configPath)).toThrow('Scope "missing" is not defined');
     });
-    it('does not treat path globs as named scope references', async () => {
+    it('does not treat path globs as named scope references', () => {
         const configPath = writeConfig(tmpDir, {
             ...VALID_CONFIG,
             insiders: {
                 'a@example.com': { scopes: ['/docs/**'] },
             },
         });
-        const config = await loadConfig(configPath);
+        const config = loadConfig(configPath);
         expect(config.resolvedInsiders.find((i) => i.email === 'a@example.com')?.scopes).toEqual({
             allow: ['/docs/**'],
             deny: [],
@@ -138,15 +140,15 @@ describe('config singleton', () => {
     it('throws if getConfig called before initConfig', () => {
         expect(() => getConfig()).toThrow('Config not initialized');
     });
-    it('initConfig populates getConfig', async () => {
+    it('initConfig populates getConfig', () => {
         const configPath = writeConfig(tmpDir, VALID_CONFIG);
-        await initConfig(configPath);
+        initConfig(configPath);
         const config = getConfig();
         expect(config.port).toBe(9999);
     });
-    it('clearConfig clears the singleton', async () => {
+    it('clearConfig clears the singleton', () => {
         const configPath = writeConfig(tmpDir, VALID_CONFIG);
-        await initConfig(configPath);
+        initConfig(configPath);
         clearConfig();
         expect(() => getConfig()).toThrow('Config not initialized');
     });

package/dist/src/config/migration.js

@@ -0,0 +1,60 @@
+/**
+ * Config path migration — handles old → new config path convention.
+ *
+ * Old convention: `<configDir>/jeeves-server.config.json`
+ * New convention: `<configDir>/jeeves-server/config.json`
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+const NON_JSON_EXTENSIONS = new Set([
+    '.ts',
+    '.yaml',
+    '.yml',
+    '.toml',
+    '.mjs',
+    '.cjs',
+    '.js',
+]);
+/**
+ * Migrate config path from old convention to new convention if needed.
+ *
+ * If the passed path matches the old convention (jeeves-server.config.json)
+ * and the new path does not exist, migrates the file. If non-JSON config
+ * is found, rejects with a clear error.
+ *
+ * @param configPath - The config path passed via --config CLI flag.
+ * @returns The resolved config path (may be the new path after migration).
+ */
+export function migrateConfigPath(configPath) {
+    const ext = path.extname(configPath).toLowerCase();
+    // Reject non-JSON config files
+    if (NON_JSON_EXTENSIONS.has(ext)) {
+        throw new Error(`Unsupported config file format: ${ext}\n` +
+            `Only JSON configuration files are supported. ` +
+            `Please convert your config to JSON format.`);
+    }
+    const basename = path.basename(configPath);
+    const configDir = path.dirname(configPath);
+    // Check if this matches the old convention
+    if (basename !== 'jeeves-server.config.json') {
+        return configPath;
+    }
+    const newDir = path.join(configDir, 'jeeves-server');
+    const newPath = path.join(newDir, 'config.json');
+    // If new path already exists, use it
+    if (fs.existsSync(newPath)) {
+        console.log(`[config-migration] Using new config path: ${newPath} ` +
+            `(old path ${configPath} is superseded)`);
+        return newPath;
+    }
+    // If old path exists, migrate it
+    if (fs.existsSync(configPath)) {
+        console.log(`[config-migration] Migrating config: ${configPath} → ${newPath}`);
+        fs.mkdirSync(newDir, { recursive: true });
+        fs.renameSync(configPath, newPath);
+        console.log(`[config-migration] Migration complete.`);
+        return newPath;
+    }
+    // Neither exists — return the passed path for downstream error handling
+    return configPath;
+}

package/dist/src/config/schema.js

@@ -1,3 +1,4 @@
+import { SERVER_PORT } from '@karmaniverous/jeeves';
 import { z } from 'zod';
 /** Supported authentication methods */
 export const authModeSchema = z.enum(['google', 'keys']);
@@ -88,7 +89,7 @@ function getScopeRefs(scopes) {
 /** Top-level Jeeves Server configuration */
 export const jeevesConfigSchema = z
     .object({
-    port: z.number().int().positive().default(1934),
+    port: z.number().int().positive().default(SERVER_PORT),
     /**
      * Network interface to bind the server to.
      * Default: '0.0.0.0' (all interfaces — required for external access by insiders, share links, etc.)
@@ -115,7 +116,7 @@ export const jeevesConfigSchema = z
     roots: z.record(z.string(), z.string()).optional(),
     /**
      * URL of the jeeves-runner API for process dashboard proxy.
-     * Default: 'http://127.0.0.1:3100'
+     * Default: 'http://127.0.0.1:1937'
      */
     runnerUrl: z.url().optional(),
     /** @deprecated Mermaid is now bundled. This field is ignored but kept for backward compatibility. */
@@ -142,7 +143,7 @@ export const jeevesConfigSchema = z
     diagramCachePath: z.string().optional(),
     /**
      * URL of the jeeves-watcher API for semantic search.
-     * When set, the search UI appears in the header. Example: 'http://localhost:3458'
+     * When set, the search UI appears in the header. Example: 'http://127.0.0.1:1936'
      */
     watcherUrl: z.url().optional(),
     /**

package/dist/src/descriptor.js

@@ -0,0 +1,46 @@
+/**
+ * Server-side JeevesComponentDescriptor for the jeeves-server component.
+ *
+ * @packageDocumentation
+ */
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { jeevesComponentDescriptorSchema, SERVER_PORT, } from '@karmaniverous/jeeves';
+import { jeevesConfigSchema } from './config/schema.js';
+import { packageVersion } from './util/packageVersion.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** Absolute path to the start-server entry point (resolves correctly from any cwd). */
+const startServerPath = path.resolve(__dirname, 'cli', 'start-server.js');
+export const serverDescriptor = jeevesComponentDescriptorSchema.parse({
+    name: 'server',
+    version: packageVersion,
+    servicePackage: '@karmaniverous/jeeves-server',
+    pluginPackage: '@karmaniverous/jeeves-server-openclaw',
+    defaultPort: SERVER_PORT,
+    configSchema: jeevesConfigSchema,
+    configFileName: 'config.json',
+    initTemplate: () => ({
+        chromePath: 'CHANGE_ME_chromePath',
+        auth: {
+            modes: ['keys'],
+            sessionSecret: 'CHANGE_ME_sessionSecret',
+        },
+        keys: {
+            default: 'CHANGE_ME_defaultKey',
+        },
+    }),
+    onConfigApply: async () => {
+        const { resetConfig } = await import('./config/index.js');
+        resetConfig();
+    },
+    startCommand: (configPath) => [
+        'node',
+        startServerPath,
+        '--config',
+        configPath,
+    ],
+    sectionId: 'Server',
+    refreshIntervalSeconds: 61,
+    generateToolsContent: () => '',
+    dependencies: { hard: [], soft: ['watcher', 'runner', 'meta'] },
+});