@karmaniverous/jeeves-server 3.4.2 → 3.5.1

package/dist/src/routes/config.js

@@ -5,8 +5,9 @@
  *
  * @packageDocumentation
  */
-import { createConfigQueryHandler } from '@karmaniverous/jeeves';
+import { createConfigApplyHandler, createConfigQueryHandler, } from '@karmaniverous/jeeves';
 import { getConfig } from '../config/index.js';
+import { serverDescriptor } from '../descriptor.js';
 /** Return a sanitized copy of the config (redact sensitive fields). */
 export function sanitizeConfig(config) {
     return {
@@ -29,7 +30,7 @@ export function sanitizeConfig(config) {
         })),
     };
 }
-/** Register the GET /config route. */
+/** Register the GET /config and POST /config/apply routes. */
 export function registerConfigRoute(app) {
     const configHandler = createConfigQueryHandler(() => sanitizeConfig(getConfig()));
     app.get('/config', async (request, reply) => {
@@ -37,4 +38,9 @@ export function registerConfigRoute(app) {
         const result = await configHandler({ path });
         return reply.status(result.status).send(result.body);
     });
+    const applyHandler = createConfigApplyHandler(serverDescriptor);
+    app.post('/config/apply', async (request, reply) => {
+        const result = await applyHandler(request.body);
+        return reply.status(result.status).send(result.body);
+    });
 }

package/dist/src/routes/keys.js

@@ -53,7 +53,7 @@ export const keysRoute = async (fastify) => {
             const insiderResult = resolveInsiderKeyAuth(config, provided);
             if (insiderResult.valid && insiderResult.email) {
                 // Insider key rotation
-                return await rotateInsiderSeed(insiderResult.email, config);
+                return rotateInsiderSeed(insiderResult.email, config);
             }
             // Machine key rotation is not supported with TS config
             const matched = config.resolvedKeys.find((rk) => timingSafeEqual(provided, computeInsiderKey(rk.seed)));
@@ -67,7 +67,7 @@ export const keysRoute = async (fastify) => {
         // Try session-based auth
         const sessionResult = resolveSessionAuth(config, request);
         if (sessionResult.valid && sessionResult.email) {
-            return await rotateInsiderSeed(sessionResult.email, config);
+            return rotateInsiderSeed(sessionResult.email, config);
         }
         return reply.code(401).send({ error: 'Invalid insider key' });
     });
@@ -93,7 +93,7 @@ export const keysRoute = async (fastify) => {
         return reply.code(401).send({ error: 'Invalid insider key' });
     });
 };
-async function rotateInsiderSeed(email, config) {
+function rotateInsiderSeed(email, config) {
     const insider = findInsider(config.resolvedInsiders, email);
     if (!insider?.seed)
         return { ok: false, error: 'Insider not found' };
@@ -106,7 +106,7 @@ async function rotateInsiderSeed(email, config) {
         at: timestamp,
     });
     setKeyRotationTimestamp(timestamp);
-    await resetConfig();
+    resetConfig();
     return { ok: true, keyName: insider.email };
 }
 function buildShareResponse(seed, targetPath, expiry) {

package/dist/src/routes/path/index.js

@@ -10,7 +10,7 @@ export const pathRoute = async (fastify) => {
     // Redirect /path/* to /browse/*
     fastify.get('/path/*', async (request, reply) => {
         const reqPath = request.params['*'];
-        const url = new URL(request.url, 'http://localhost');
+        const url = new URL(request.url, 'http://127.0.0.1');
         const query = url.search;
         return reply.redirect(`/browse/${reqPath}${query}`);
     });

package/dist/src/routes/status.js

@@ -1,15 +1,13 @@
 /**
- * Server status endpoint — structured metadata for diagnostics and TOOLS.md generation.
+ * Server status endpoint — uses the SDK's `createStatusHandler` factory.
  *
- * Returns version, uptime, port, connected services reachability,
- * event schemas, insider count (no PII), and export capabilities.
+ * Returns standard `{ name, version, uptime, status, health }` shape
+ * with server-specific details nested under `health`.
  */
+import { createStatusHandler } from '@karmaniverous/jeeves';
 import { getConfig } from '../config/index.js';
-import { getRecentEvents } from '../services/eventLog.js';
 import { packageVersion } from '../util/packageVersion.js';
-const startTime = Date.now();
 async function checkService(url) {
-    // Try /status first (watcher), then /health (runner)
     for (const endpoint of ['/status', '/health']) {
         try {
             const res = await fetch(`${url}${endpoint}`, {
@@ -26,9 +24,10 @@ async function checkService(url) {
     }
     return { url, reachable: false };
 }
-// eslint-disable-next-line @typescript-eslint/require-await
-export const statusRoutes = async (fastify) => {
-    fastify.get('/status', async (request) => {
+const handleStatus = createStatusHandler({
+    name: 'server',
+    version: packageVersion,
+    getHealth: async () => {
         const config = getConfig();
         const [watcher, runner, meta] = await Promise.all([
             config.watcherUrl ? checkService(config.watcherUrl) : null,
@@ -36,8 +35,6 @@ export const statusRoutes = async (fastify) => {
             config.metaUrl ? checkService(config.metaUrl) : null,
         ]);
         return {
-            version: packageVersion,
-            uptime: Math.floor((Date.now() - startTime) / 1000),
             port: config.port,
             chrome: {
                 configured: Boolean(config.chromePath),
@@ -70,11 +67,13 @@ export const statusRoutes = async (fastify) => {
                 runner,
                 meta,
             },
-            ...(request.query.events
-                ? {
-                    eventLog: getRecentEvents(Math.min(parseInt(request.query.events, 10) || 20, 100)),
-                }
-                : {}),
         };
+    },
+});
+// eslint-disable-next-line @typescript-eslint/require-await
+export const statusRoutes = async (fastify) => {
+    fastify.get('/status', async () => {
+        const result = await handleStatus();
+        return result.body;
     });
 };

package/dist/src/routes/status.test.js

@@ -27,7 +27,7 @@ vi.mock('../config/index.js', () => ({
 // Must import AFTER mock
 const { statusRoutes } = await import('./status.js');
 describe('GET /status', () => {
-    it('returns structured status', async () => {
+    it('returns structured status with SDK shape', async () => {
         // Create a minimal Fastify-like test harness
         const routes = {};
         const fakeFastify = {
@@ -40,18 +40,23 @@ describe('GET /status', () => {
         expect(handler).toBeDefined();
         const result = await handler({ accessMode: 'insider', query: {} });
         const status = result;
+        // Standard SDK fields at top level
+        expect(status).toHaveProperty('name', 'server');
         expect(status).toHaveProperty('version');
         expect(status).toHaveProperty('uptime');
-        expect(status.port).toBe(1934);
-        expect(status.chrome.configured).toBe(true);
-        expect(status.auth.insiderCount).toBe(2);
-        expect(status.auth.keyCount).toBe(1);
-        expect(status.events).toHaveLength(2);
-        const exports = status.exports;
+        expect(status).toHaveProperty('status', 'healthy');
+        // Server-specific fields nested under health
+        const health = status.health;
+        expect(health.port).toBe(1934);
+        expect(health.chrome.configured).toBe(true);
+        expect(health.auth.insiderCount).toBe(2);
+        expect(health.auth.keyCount).toBe(1);
+        expect(health.events).toHaveLength(2);
+        const exports = health.exports;
         expect(exports.documents).toEqual(['pdf', 'docx']);
         expect(exports.directories).toEqual(['zip']);
         expect(exports.diagrams).toEqual(['svg', 'png']);
         expect(exports.chromeAvailable).toBe(true);
-        expect(status.diagrams.mermaid).toBe(true);
+        expect(health.diagrams.mermaid).toBe(true);
     });
 });

package/dist/src/server.js

@@ -23,7 +23,7 @@ import { initExportCache } from './services/exportCache.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 async function start() {
     try {
-        const config = isConfigInitialized() ? getConfig() : await initConfig();
+        const config = isConfigInitialized() ? getConfig() : initConfig();
         const fastify = Fastify({
             logger: true,
         });
@@ -49,21 +49,26 @@ async function start() {
                 root: clientDir,
                 prefix: '/app/',
             });
-            // SPA fallback for React routes
-            fastify.get('/', async (_request, reply) => {
-                return reply.sendFile('index.html', clientDir);
-            });
-            fastify.get('/browse', async (_request, reply) => {
-                return reply.sendFile('index.html', clientDir);
-            });
-            fastify.get('/browse/*', async (_request, reply) => {
-                return reply.sendFile('index.html', clientDir);
-            });
-            fastify.get('/runner', async (_request, reply) => {
-                return reply.sendFile('index.html', clientDir);
-            });
-            fastify.get('/runner/*', async (_request, reply) => {
-                return reply.sendFile('index.html', clientDir);
+            // SPA fallback — all these routes serve index.html for client-side routing
+            const spaFallback = async (_request, reply) => reply.sendFile('index.html', clientDir);
+            for (const route of [
+                '/',
+                '/browse',
+                '/browse/*',
+                '/runner',
+                '/runner/*',
+            ]) {
+                fastify.get(route, spaFallback);
+            }
+            // Catch-all: serve SPA for any unmatched GET under /browse or /runner
+            // (handles edge cases like dotfile paths that wildcard routes may miss)
+            fastify.setNotFoundHandler(async (request, reply) => {
+                if (request.method === 'GET' &&
+                    (request.url.startsWith('/browse') ||
+                        request.url.startsWith('/runner'))) {
+                    return reply.sendFile('index.html', clientDir);
+                }
+                return reply.code(404).send({ error: 'Not found' });
             });
         }
         // Initialize caches

package/dist/src/services/markdown.js

@@ -2,6 +2,7 @@
  * Markdown rendering with TOC generation, Windows path linking, and syntax highlighting
  */
 import fs from 'node:fs';
+import * as cheerio from 'cheerio';
 import { marked } from 'marked';
 import { registerDiagram } from './embeddedDiagrams.js';
 /**
@@ -96,7 +97,7 @@ export function parseMarkdown(markdown, options = {}) {
             .replace(/^-|-$/g, '');
         headings.push({
             level,
-            text: renderedText.replace(/<[^>]+>/g, ''),
+            text: cheerio.load(renderedText).text(),
             slug,
         });
         return `<h${String(level)} id="${slug}">${renderedText} <a href="#${slug}" class="anchor">#</a></h${String(level)}>\n`;

package/dist/src/services/markdown.test.js

@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'vitest';
+import { parseMarkdown } from './markdown.js';
+describe('parseMarkdown', () => {
+    it('decodes HTML entities in heading text for TOC', () => {
+        const md = '# Hello & "World"';
+        const { headings } = parseMarkdown(md);
+        expect(headings).toHaveLength(1);
+        expect(headings[0].text).toBe('Hello & "World"');
+    });
+    it('strips HTML tags from heading text for TOC', () => {
+        const md = '## A <em>bold</em> heading';
+        const { headings } = parseMarkdown(md);
+        expect(headings).toHaveLength(1);
+        expect(headings[0].text).toBe('A bold heading');
+    });
+    it('decodes &#39; and &quot; entities in headings', () => {
+        const md = '### It&#39;s a &quot;test&quot;';
+        const { headings } = parseMarkdown(md);
+        expect(headings).toHaveLength(1);
+        expect(headings[0].text).toBe('It\'s a "test"');
+    });
+});

package/dist/src/util/packageVersion.js

@@ -1,25 +1,16 @@
 /**
- * Resolve the service package version by walking up from the caller's directory.
+ * Resolve the service package version using package-directory.
  */
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-function findPackageJson(startDir) {
-    let dir = startDir;
-    while (dir !== path.dirname(dir)) {
-        const candidate = path.join(dir, 'package.json');
-        if (fs.existsSync(candidate)) {
-            const pkg = JSON.parse(fs.readFileSync(candidate, 'utf8'));
-            // Find our package specifically, not the monorepo root
-            if (pkg.name === '@karmaniverous/jeeves-server')
-                return candidate;
-        }
-        dir = path.dirname(dir);
-    }
-    throw new Error('Could not find @karmaniverous/jeeves-server package.json');
-}
+import { packageDirectorySync } from 'package-directory';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const pkgPath = findPackageJson(__dirname);
+const pkgDir = packageDirectorySync({ cwd: __dirname });
+if (!pkgDir) {
+    throw new Error('Could not find package directory for jeeves-server');
+}
+const pkgPath = path.join(pkgDir, 'package.json');
 const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
 /** The package version of the jeeves-server service package. */
 export const packageVersion = pkg.version;

package/dist/src/util/packageVersion.test.js

@@ -0,0 +1,7 @@
+import { describe, expect, it } from 'vitest';
+import { packageVersion } from './packageVersion.js';
+describe('packageVersion', () => {
+    it('returns a valid semver version string', () => {
+        expect(packageVersion).toMatch(/^\d+\.\d+\.\d+/);
+    });
+});

package/guides/api-integration.md

@@ -1,3 +1,7 @@
+---
+title: "API & Integration Guide"
+---
+
 # API & Integration Guide
 
 How to interact with Jeeves Server programmatically — for scripts, bots, AI assistants, and CI/CD pipelines.

package/guides/deployment.md

@@ -1,3 +1,7 @@
+---
+title: "Deployment"
+---
+
 # Deployment
 
 How to run Jeeves Server in production.
@@ -23,8 +27,9 @@ npm install -g @karmaniverous/jeeves-server
 Create your config file (see [Setup & Configuration](setup.md)):
 
 ```bash
-# Example: JSON config
-cat > /etc/jeeves-server.config.json << 'EOF'
+# Example: JSON config (new path convention)
+mkdir -p /etc/jeeves-server
+cat > /etc/jeeves-server/config.json << 'EOF'
 {
   "chromePath": "/usr/bin/chromium-browser",
   "auth": { "modes": ["keys"] },
@@ -48,18 +53,14 @@ The server listens on the configured port (default: 1934) on all interfaces.
 
 ### As a Windows Service (NSSM)
 
-Use the built-in CLI to generate NSSM install commands:
-
-```bash
-jeeves-server service install --config "C:\\config\\jeeves-server.config.json"
-```
-
-This prints the `nssm install` commands. Run them, then:
+The CLI installs and manages the NSSM service directly:
 
 ```bash
+jeeves-server service install --config "C:\\config\\jeeves-server\\config.json"
 jeeves-server service start
 jeeves-server service stop
 jeeves-server service restart
+jeeves-server service status
 ```
 
 Or use NSSM directly:
@@ -84,7 +85,7 @@ After=network.target
 [Service]
 Type=simple
 User=jeeves
-ExecStart=/usr/bin/env jeeves-server start --config /etc/jeeves-server.config.json
+ExecStart=/usr/bin/env jeeves-server start --config /etc/jeeves-server/config.json
 Restart=on-failure
 RestartSec=5
 Environment=NODE_ENV=production

package/guides/event-gateway.md

@@ -1,3 +1,7 @@
+---
+title: "Event Gateway"
+---
+
 # Event Gateway
 
 Jeeves Server includes a webhook gateway that receives HTTP POST requests, validates them against JSON Schema rules, and dispatches matched events to shell commands via a durable queue.

package/guides/exports.md

@@ -1,3 +1,7 @@
+---
+title: "Exporting & Downloads"
+---
+
 # Exporting & Downloads
 
 Jeeves Server can export files as PDF, DOCX, or ZIP — turning Markdown into business-ready documents with one click.

package/guides/index.md

@@ -12,7 +12,7 @@ children:
 
 # Service Guides
 
-- [Setup & Configuration](./setup.md) — Installation, auth modes, cosmiconfig, named scopes, and config reference.
+- [Setup & Configuration](./setup.md) — Installation, auth modes, JSON config, named scopes, and config reference.
 - [Insiders, Outsiders & Sharing](./sharing.md) — The access model, HMAC key derivation, expiring links, and key rotation.
 - [Exporting & Downloads](./exports.md) — PDF, DOCX, SVG, PNG, and ZIP export via Puppeteer and bundled Mermaid/PlantUML.
 - [Event Gateway](./event-gateway.md) — Webhook receiving, JSON Schema matching, JsonMap body transforms, and durable queue processing.

package/guides/setup.md

@@ -1,3 +1,7 @@
+---
+title: "Setup & Configuration"
+---
+
 # Setup & Configuration
 
 ## Prerequisites
@@ -15,26 +19,17 @@ The `postinstall` script automatically downloads the PlantUML jar for local diag
 
 ## Configuration
 
-Jeeves Server uses [cosmiconfig](https://github.com/cosmiconfig/cosmiconfig) for configuration. Create a config file in any supported format:
+Jeeves Server uses **JSON-only** configuration. Config files follow the path convention `<configDir>/jeeves-server/config.json`.
 
 ```bash
-# JSON (recommended for simplicity)
-jeeves-server.config.json
+# Generate a starter config
+jeeves-server init --config /path/to/config-dir
 
-# YAML
-jeeves-server.config.yaml
-
-# TypeScript (for type checking during authoring)
-jeeves-server.config.ts
-
-# Or any cosmiconfig-supported format
+# Or specify an explicit path
+jeeves-server start --config /path/to/jeeves-server/config.json
 ```
 
-The server searches for config files starting from its working directory and walking up. You can also specify an explicit path:
-
-```bash
-jeeves-server start --config /path/to/jeeves-server.config.json
-```
+Legacy paths (`jeeves-server.config.json`) are auto-migrated to the new convention on first use.
 
 ### Config structure (JSON)
 
@@ -96,7 +91,13 @@ String values in the config support `${VAR_NAME}` substitution from `process.env
 jeeves-server config validate [--config <path>]
 ```
 
-This loads and validates the config against the Zod schema, reporting any errors. Use `config show` to see the fully resolved configuration with all derived keys and scope assignments.
+This loads and validates the config against the Zod schema, reporting any errors. Use `config [jsonpath]` to query the fully resolved configuration:
+
+```bash
+jeeves-server config                        # Full resolved config
+jeeves-server config '$.port'               # Query specific field
+jeeves-server config '$.auth.modes'         # Nested query
+```
 
 ### Platform-specific settings
 

package/guides/sharing.md

@@ -1,3 +1,7 @@
+---
+title: "Insiders, Outsiders & Sharing"
+---
+
 # Insiders, Outsiders & Sharing
 
 Jeeves Server has a clear access model built around two roles: **insiders** and **outsiders**. Understanding the difference is key to using sharing effectively.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-server",
-  "version": "3.4.2",
+  "version": "3.5.1",
   "description": "Secure file browser, markdown viewer, and webhook gateway with PDF/DOCX export and expiring share links",
   "keywords": [
     "fastify",
@@ -49,18 +49,18 @@
     "@commander-js/extra-typings": "^14.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/static": "^8.3.0",
-    "@karmaniverous/jeeves": "^0.3.0",
+    "@karmaniverous/jeeves": "^0.4.5",
     "@karmaniverous/jsonmap": "^0.3.1",
     "@mermaid-js/mermaid-cli": "^11.12.0",
     "@turbodocx/html-to-docx": "^1.1.0",
     "ajv": "^8.17.1",
     "archiver": "^7.0.1",
     "cheerio": "^1.2.0",
-    "cosmiconfig": "^9.0.1",
     "fastify": "^5.2.3",
     "lz-string": "^1.5.0",
     "marked": "^17.0.1",
     "mime-types": "^3.0.2",
+    "package-directory": "^8.2.0",
     "picomatch": "^4.0.3",
     "plantuml-encoder": "^1.4.0",
     "puppeteer": "^23.11.1",

package/scripts/download-plantuml.js

@@ -1,5 +1,4 @@
 /* eslint-disable no-undef */
-/* eslint-env node */
 
 /**
  * Downloads a pinned PlantUML jar to vendor/plantuml.jar.

package/src/cli/commands/config.test.ts

@@ -25,7 +25,10 @@ const VALID_CONFIG = {
 };
 
 function writeConfig(dir: string, config: unknown): string {
-  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;
 }
@@ -47,13 +50,10 @@ describe('jeeves-server config validate', () => {
     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');
+    expect(stdout).toContain('Config is valid');
   });
 
   it('exits with error for invalid config', async () => {
@@ -65,43 +65,3 @@ describe('jeeves-server config validate', () => {
     });
   });
 });
-
-describe('jeeves-server config show', () => {
-  let tmpDir: string;
-
-  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/src/cli/index.ts

@@ -1,25 +1,18 @@
 #!/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';
+import { createServiceCli } from '@karmaniverous/jeeves';
 
-const cli = new Command()
-  .name('jeeves-server')
-  .description('Self-hosted file browser, document server, and webhook gateway')
-  .version(packageVersion);
+import { serverDescriptor } from '../descriptor.js';
 
-registerStartCommand(cli);
-registerConfigCommand(cli);
-registerServiceCommand(cli);
+const cli = createServiceCli(serverDescriptor);
 
 cli.parse();

package/src/cli/start-server.ts

@@ -0,0 +1,21 @@
+#!/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');