npm - @jagilber-org/index-server - Versions diffs - 1.28.5 → 1.28.8 - Mend

@jagilber-org/index-server 1.28.5 → 1.28.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +2 -0
package/dist/dashboard/client/admin.html +27 -27
package/dist/services/mcpConfig/flagCatalog.js +2 -2
package/package.json +1 -1
package/scripts/build/setup-wizard.mjs +46 -18
package/server.json +2 -2

package/README.md CHANGED Viewed

@@ -51,6 +51,8 @@ index-server --dashboard
 > **No-install alternative:** `npx -y @jagilber-org/index-server@latest --setup` works too (resolves from npmjs.org). Use it for a one-shot try; prefer `-g` for routine use. The GitHub Packages mirror requires authentication, so `npx` against `npm.pkg.github.com` needs a per-scope `.npmrc` plus a `GITHUB_TOKEN` with `read:packages`.
+> **Upgrading or hitting "unsupported INDEX_SERVER key" / "Cannot find module" errors after install?** See [Upgrading and Uninstalling](docs/quickstart.md#upgrading-and-uninstalling) for the clean-uninstall steps that clear stale non-global installs.
 #### Bootstrap HTTPS for the dashboard
 Generate a self-signed TLS cert+key in one command:

package/dist/dashboard/client/admin.html CHANGED Viewed

@@ -1,30 +1,30 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
-    <meta name="dashboard-build-version" content="1.28.5-0009101e">
+    <meta name="dashboard-build-version" content="1.28.8-0009101e">
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Index Server Admin</title>
-    <link rel="stylesheet" href="css/admin.css?v=1.28.5-0009101e">
-    <script defer src="js/admin.utils.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.auth.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.overview.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.sessions.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.monitor.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.events.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.graph.js?v=1.28.5-0009101e"></script>
+    <link rel="stylesheet" href="css/admin.css?v=1.28.8-0009101e">
+    <script defer src="js/admin.utils.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.auth.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.overview.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.sessions.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.monitor.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.events.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.graph.js?v=1.28.8-0009101e"></script>
     <script defer src="js/marked.umd.js"></script>
-    <script defer src="js/admin.instructions.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.logs.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.maintenance.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.config.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.performance.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.instances.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.embeddings.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.messaging.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.sqlite.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.boot.js?v=1.28.5-0009101e"></script>
-    <script defer src="js/admin.feedback.js?v=1.28.5-0009101e"></script>
+    <script defer src="js/admin.instructions.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.logs.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.maintenance.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.config.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.performance.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.instances.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.embeddings.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.messaging.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.sqlite.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.boot.js?v=1.28.8-0009101e"></script>
+    <script defer src="js/admin.feedback.js?v=1.28.8-0009101e"></script>
 </head>
 <body>
     <div class="admin-container admin-root">
@@ -909,10 +909,10 @@
             }
         }
-        // Graph logic was extracted to js/admin.graph.js?v=1.28.5-0009101e
+        // Graph logic was extracted to js/admin.graph.js?v=1.28.8-0009101e
         // Functions available globally: reloadGraphMermaid, initGraphScopeDefaults, copyMermaidSource, toggleGraphEdit, applyGraphEdit, cancelGraphEdit, refreshDrillCategories, loadDrillInstructions, clearSelections
-        <!-- overview functions moved to js/admin.overview.js?v=1.28.5-0009101e -->
+        <!-- overview functions moved to js/admin.overview.js?v=1.28.8-0009101e -->
         // Lightweight overview-level maintenance display (optional)
         // Intentionally minimal to avoid blocking overview rendering.
@@ -1097,7 +1097,7 @@
         }
         // --- Backup / Restore ---
-        // Extracted to js/admin.maintenance.js?v=1.28.5-0009101e
+        // Extracted to js/admin.maintenance.js?v=1.28.8-0009101e
         async function performBackup() {
             try {
@@ -1163,7 +1163,7 @@
         }
                 async function loadConfiguration() {
-                    // Primary implementation in js/admin.config.js?v=1.28.5-0009101e (loaded via defer).
+                    // Primary implementation in js/admin.config.js?v=1.28.8-0009101e (loaded via defer).
                     // This inline fallback only fires if the external script failed to load.
                     if (window.__configExternalLoaded) return;
                     try {
@@ -1223,10 +1223,10 @@
                         return false;
                 }
-        // Monitoring functions moved to js/admin.monitor.js?v=1.28.5-0009101e
+        // Monitoring functions moved to js/admin.monitor.js?v=1.28.8-0009101e
         // ===== Log Viewer =====
-        // Extracted to js/admin.logs.js?v=1.28.5-0009101e
+        // Extracted to js/admin.logs.js?v=1.28.8-0009101e
         // ===== Instruction Management =====
         let instructionEditing = null;
@@ -1723,7 +1723,7 @@
             setInterval(fetchResourceTrends, 10000);
         })();
-        // Instruction management logic extracted to js/admin.instructions.js?v=1.28.5-0009101e
+        // Instruction management logic extracted to js/admin.instructions.js?v=1.28.8-0009101e
         // Functions exposed globally: loadInstructions, renderInstructionList, editInstruction, saveInstruction, deleteInstruction, etc.
         function startAutoRefresh() {

package/dist/services/mcpConfig/flagCatalog.js CHANGED Viewed

@@ -231,8 +231,8 @@ function buildEnvCatalog(config, paths) {
         { key: 'INDEX_SERVER_MUTATION', desc: 'Enable write operations', active: true, value: config.mutation ? '1' : '0' },
         { key: 'INDEX_SERVER_ADMIN_API_KEY', desc: 'Dashboard admin API key', active: false, value: '' },
         { key: 'INDEX_SERVER_DASHBOARD_TLS', desc: 'Enable HTTPS dashboard', active: config.tls, value: config.tls ? '1' : '0' },
-        { key: 'INDEX_SERVER_DASHBOARD_TLS_CERT', desc: 'Path to TLS certificate file', active: false, value: `${paths.certs}/server.crt` },
-        { key: 'INDEX_SERVER_DASHBOARD_TLS_KEY', desc: 'Path to TLS private key file', active: false, value: `${paths.certs}/server.key` },
+        { key: 'INDEX_SERVER_DASHBOARD_TLS_CERT', desc: 'Path to TLS certificate file', active: config.tls, value: `${paths.certs}/server.crt` },
+        { key: 'INDEX_SERVER_DASHBOARD_TLS_KEY', desc: 'Path to TLS private key file', active: config.tls, value: `${paths.certs}/server.key` },
         { key: 'INDEX_SERVER_DASHBOARD_TLS_CA', desc: 'Path to CA certificate', active: false, value: '' },
         { section: 'Semantic Search - embeddings' },
         { key: 'INDEX_SERVER_SEMANTIC_ENABLED', desc: 'Enable semantic search', active: isEnhanced, value: isEnhanced ? '1' : '0' },

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@jagilber-org/index-server",
-  "version": "1.28.5",
+  "version": "1.28.8",
   "mcpName": "io.github.jagilber-org/index-server",
   "description": "MCP instruction indexing server with search, CRUD, validation, and cross-repo knowledge promotion.",
   "publishConfig": {

package/scripts/build/setup-wizard.mjs CHANGED Viewed

@@ -32,6 +32,18 @@ function writeTextFile(filePath, content) {
   fs['write' + 'FileSync'](filePath, content, 'utf8');
 }
 const IS_WINDOWS = process.platform === 'win32';
+// Default install root for non-repo installs. Lives under the user profile so
+// neither admin/elevated rights nor a cluttered C:\ root are required, and the
+// runtime self-deploys cleanly there (args + cwd resolve under this root).
+function defaultUserRoot() {
+  if (IS_WINDOWS) {
+    const base = process.env.LOCALAPPDATA || process.env.APPDATA || process.env.USERPROFILE || process.cwd();
+    return path.join(base, 'index-server');
+  }
+  const home = process.env.HOME || process.cwd();
+  return path.join(home, '.local', 'share', 'index-server');
+}
 function parsePositiveTimeout(value, fallback) {
   const parsed = Number(value);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
@@ -147,6 +159,10 @@ function parseNonInteractiveArgs() {
   const config = {
     profile: 'default',
+    // Non-interactive default stays at ROOT (package install dir) so scripted
+    // / CI flows that pass no --root don't trigger deployRuntime. Callers who
+    // want a user-profile install pass --root explicitly. Interactive flow
+    // defaults to defaultUserRoot() instead.
     root: ROOT,
     port: 8787,
     host: '127.0.0.1',
@@ -188,6 +204,8 @@ function parseNonInteractiveArgs() {
   if (config.profile === 'experimental') {
     config.logLevel = 'debug';
   }
+  // When certs are generated, TLS must be active so mcp.json env wires cert paths.
+  if (config.generateCerts) config.tls = true;
   return config;
 }
@@ -214,7 +232,7 @@ async function runInteractiveWizard() {
   });
   // Step 2: Root directory
-  const defaultRoot = IS_WINDOWS ? 'C:\\mcp\\index-server' : '/opt/index-server';
+  const defaultRoot = defaultUserRoot();
   const root = path.resolve(await input({
     message: 'Base directory (all data paths resolve under this root)',
     default: defaultRoot,
@@ -294,7 +312,9 @@ async function runInteractiveWizard() {
     default: 'repo',
   });
-  return { profile, root, serverName, port, host, mutation, logLevel, generateCerts, targets, scope, write: true, preview: true, deploy: true };
+  // When certs are generated TLS must be enabled so mcp.json env wires up cert paths.
+  const tls = generateCerts || profile === 'enhanced' || profile === 'experimental';
+  return { profile, root, serverName, port, host, tls, mutation, logLevel, generateCerts, targets, scope, write: true, preview: true, deploy: true };
 }
 // --------------------------------------------------------------------------
@@ -636,6 +656,23 @@ Non-interactive mode:
     previewConfigs(configTargets, config);
   }
+  // ── Generate TLS certs BEFORE writing configs so cert paths exist
+  //    and the user sees a consistent flow (certs → config wired to them).
+  if (config.generateCerts) {
+    console.log('\n🔐 Generating TLS certificates...');
+    try {
+      const certDir = path.join(config.root, 'certs');
+      execFileSync(
+        process.execPath,
+        [path.join(ROOT, 'scripts', 'build', 'generate-certs.mjs'), '--hostname', 'localhost', '--output', certDir],
+        { stdio: 'inherit' }
+      );
+    } catch {
+      console.error('❌ Certificate generation failed. Run manually:');
+      console.error(`   node scripts/build/generate-certs.mjs --output "${path.join(config.root, 'certs')}"`);
+    }
+  }
   // Write to real files or sidecar
   if (config.write) {
     console.log('📁 Writing configuration files...\n');
@@ -671,22 +708,6 @@ Non-interactive mode:
   // ── Deploy runtime if target root differs from package root ─────────
   await deployRuntime(config);
-  // ── Generate TLS certs ──────────────────────────────────────────────
-  if (config.generateCerts) {
-    console.log('\n🔐 Generating TLS certificates...');
-    try {
-      const certDir = path.join(config.root, 'certs');
-      execFileSync(
-        process.execPath,
-        [path.join(ROOT, 'scripts', 'build', 'generate-certs.mjs'), '--hostname', 'localhost', '--output', certDir],
-        { stdio: 'inherit' }
-      );
-    } catch {
-      console.error('❌ Certificate generation failed. Run manually:');
-      console.error(`   node scripts/build/generate-certs.mjs --output "${path.join(config.root, 'certs')}"`);
-    }
-  }
   // ── Next steps ──────────────────────────────────────────────────────
   const proto = (config.profile === 'enhanced' || config.profile === 'experimental') ? 'https' : 'http';
   const launch = resolveServerLaunch(config);
@@ -724,6 +745,13 @@ Non-interactive mode:
   console.log(`     ${proto}://localhost:${config.port}\n`);
   step++;
+  if (config.tls && config.generateCerts) {
+    console.log(`  ${step}. TLS certificates wired into your MCP config:`);
+    console.log(`     INDEX_SERVER_DASHBOARD_TLS_CERT = ${fwd(path.join(config.root, 'certs', 'server.crt'))}`);
+    console.log(`     INDEX_SERVER_DASHBOARD_TLS_KEY  = ${fwd(path.join(config.root, 'certs', 'server.key'))}\n`);
+    step++;
+  }
   if (config.profile === 'enhanced' || config.profile === 'experimental') {
     console.log(`  ${step}. First-time semantic search:`);
     console.log('     The MiniLM model (~90MB) will download on first query.');

package/server.json CHANGED Viewed

@@ -6,12 +6,12 @@
     "url": "https://github.com/jagilber-org/index-server",
     "source": "github"
   },
-  "version": "1.28.5",
+  "version": "1.28.8",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@jagilber-org/index-server",
-      "version": "1.28.5",
+      "version": "1.28.8",
       "transport": {
         "type": "stdio"
       }