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

@jagilber-org/index-server 1.28.8 → 1.28.10

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 (8) hide show

package/dist/dashboard/client/admin.html +27 -27
package/dist/services/mcpConfig/formats.js +6 -2
package/dist/services/messaging/agentMailbox.d.ts +6 -1
package/dist/services/messaging/agentMailbox.js +10 -3
package/dist/services/seedBootstrap.js +16 -7
package/package.json +1 -1
package/scripts/build/setup-wizard.mjs +6 -3
package/server.json +2 -2

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.8-0009101e">
+    <meta name="dashboard-build-version" content="1.28.10-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.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>
+    <link rel="stylesheet" href="css/admin.css?v=1.28.10-0009101e">
+    <script defer src="js/admin.utils.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.auth.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.overview.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.sessions.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.monitor.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.events.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.graph.js?v=1.28.10-0009101e"></script>
     <script defer src="js/marked.umd.js"></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>
+    <script defer src="js/admin.instructions.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.logs.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.maintenance.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.config.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.performance.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.instances.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.embeddings.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.messaging.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.sqlite.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.boot.js?v=1.28.10-0009101e"></script>
+    <script defer src="js/admin.feedback.js?v=1.28.10-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.8-0009101e
+        // Graph logic was extracted to js/admin.graph.js?v=1.28.10-0009101e
         // Functions available globally: reloadGraphMermaid, initGraphScopeDefaults, copyMermaidSource, toggleGraphEdit, applyGraphEdit, cancelGraphEdit, refreshDrillCategories, loadDrillInstructions, clearSelections
-        <!-- overview functions moved to js/admin.overview.js?v=1.28.8-0009101e -->
+        <!-- overview functions moved to js/admin.overview.js?v=1.28.10-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.8-0009101e
+        // Extracted to js/admin.maintenance.js?v=1.28.10-0009101e
         async function performBackup() {
             try {
@@ -1163,7 +1163,7 @@
         }
                 async function loadConfiguration() {
-                    // Primary implementation in js/admin.config.js?v=1.28.8-0009101e (loaded via defer).
+                    // Primary implementation in js/admin.config.js?v=1.28.10-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.8-0009101e
+        // Monitoring functions moved to js/admin.monitor.js?v=1.28.10-0009101e
         // ===== Log Viewer =====
-        // Extracted to js/admin.logs.js?v=1.28.8-0009101e
+        // Extracted to js/admin.logs.js?v=1.28.10-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.8-0009101e
+        // Instruction management logic extracted to js/admin.instructions.js?v=1.28.10-0009101e
         // Functions exposed globally: loadInstructions, renderInstructionList, editInstruction, saveInstruction, deleteInstruction, etc.
         function startAutoRefresh() {

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

@@ -77,8 +77,12 @@ function buildServerEntry(format, config, paths, envOverrides = {}) {
         entry.cwd = (0, flagCatalog_1.toForwardSlashes)(launch.cwd);
     if (format === 'vscode-global' && launch.command === 'node') {
         const firstArg = launch.args[0] ?? '';
-        entry.args = [path_1.default.isAbsolute(firstArg) ? (0, flagCatalog_1.toForwardSlashes)(firstArg) : (0, flagCatalog_1.toForwardSlashes)(path_1.default.resolve(launch.cwd ?? config.root, firstArg))];
-        entry.cwd = (0, flagCatalog_1.toForwardSlashes)(path_1.default.resolve(__dirname, '..', '..', '..'));
+        const baseCwd = launch.cwd ?? config.root;
+        entry.args = [path_1.default.isAbsolute(firstArg) ? (0, flagCatalog_1.toForwardSlashes)(firstArg) : (0, flagCatalog_1.toForwardSlashes)(path_1.default.resolve(baseCwd, firstArg))];
+        // Prefer the launch cwd (config.root for 'local' source — a stable user-scope
+        // directory). Fall back to package root only when the runtime hasn't been
+        // self-deployed under config.root (e.g. 'packaged' source straight out of npm-global).
+        entry.cwd = (0, flagCatalog_1.toForwardSlashes)(launch.cwd ?? path_1.default.resolve(__dirname, '..', '..', '..'));
     }
     return entry;
 }

package/dist/services/messaging/agentMailbox.d.ts CHANGED Viewed

@@ -15,7 +15,12 @@ export declare class AgentMailbox {
     read(opts?: ReadMessagesOptions): AgentMessage[];
     /** List all channels with message counts. */
     listChannels(): ChannelInfo[];
-    /** Acknowledge messages by marking them read. Returns count acknowledged. */
+    /**
+     * Acknowledge messages by marking them read.
+     * Idempotent: returns the count of message IDs successfully resolved and ack'd
+     * for the reader, regardless of whether the reader had already been added by a
+     * prior `read({ markRead: true })` call. Unknown IDs are silently skipped.
+     */
     ack(messageIds: string[], reader: string): number;
     /** Get stats for a reader. */
     getStats(reader: string): MessagingStats;

package/dist/services/messaging/agentMailbox.js CHANGED Viewed

@@ -135,10 +135,16 @@ class AgentMailbox {
             latestAt: info.latest,
         }));
     }
-    /** Acknowledge messages by marking them read. Returns count acknowledged. */
+    /**
+     * Acknowledge messages by marking them read.
+     * Idempotent: returns the count of message IDs successfully resolved and ack'd
+     * for the reader, regardless of whether the reader had already been added by a
+     * prior `read({ markRead: true })` call. Unknown IDs are silently skipped.
+     */
     ack(messageIds, reader) {
         this.ensureLoaded();
         let count = 0;
+        let dirty = false;
         for (const id of messageIds) {
             const key = this.idIndex.get(id);
             if (!key)
@@ -150,10 +156,11 @@ class AgentMailbox {
                 msg.readBy = [];
             if (!msg.readBy.includes(reader)) {
                 msg.readBy.push(reader);
-                count++;
+                dirty = true;
             }
+            count++;
         }
-        if (count > 0)
+        if (dirty)
             this.persistAll();
         return count;
     }

package/dist/services/seedBootstrap.js CHANGED Viewed

@@ -156,12 +156,14 @@ docker compose up  # HTTP on :8787
 Restart your MCP client after configuration changes. Verify with \`health_check\`.
 For full configuration options: see \`docs/mcp_configuration.md\` and \`docs/configuration.md\`.`,
-            audience: 'agents',
-            requirement: 'required',
+            audience: 'all',
+            requirement: 'mandatory',
             priority: 100,
+            priorityTier: 'P1',
+            contentType: 'instruction',
             categories: ['bootstrap', 'mcp-activation', 'quick-start', 'documentation'],
             owner: 'system',
-            version: 3,
+            version: '3.0.0',
             schemaVersion: '5',
             semanticSummary: 'Index Server quick start: search-first workflow, knowledge contribution, copilot instructions setup, and MCP client configuration for AI agents'
         }
@@ -173,12 +175,14 @@ For full configuration options: see \`docs/mcp_configuration.md\` and \`docs/con
             id: '001-lifecycle-bootstrap',
             title: 'Lifecycle Bootstrap: Local-First Instruction Strategy',
             body: 'Purpose: Early lifecycle guidance after bootstrap confirmation. Keep index minimal; prefer local-first P0/P1 additions; promote only after stability.',
-            audience: 'agents',
+            audience: 'all',
             requirement: 'recommended',
-            priorityTier: 'p1',
+            priority: 99,
+            priorityTier: 'P1',
+            contentType: 'instruction',
             categories: ['bootstrap', 'lifecycle'],
             owner: 'system',
-            version: 1,
+            version: '1.0.0',
             schemaVersion: '5',
             semanticSummary: 'Lifecycle and promotion guardrails after bootstrap confirmation',
             reviewIntervalDays: 120
@@ -226,7 +230,12 @@ function autoSeedBootstrap() {
             // Inject timestamps at write time so loaders never trigger
             // [invariant-repair] firstSeenTs WARN noise on subsequent reads.
             const nowIso = new Date().toISOString();
-            const stamped = { createdAt: nowIso, firstSeenTs: nowIso, ...seed.json };
+            // Bake-in sourceHash so integrity_verify reports zero drift on a fresh install.
+            // Schema requires sha256(body) for the body field; without this seeds appear
+            // as drift forever (expected hash empty, actual populated).
+            const bodyStr = typeof seed.json.body === 'string' ? seed.json.body : '';
+            const sourceHash = crypto_1.default.createHash('sha256').update(bodyStr, 'utf8').digest('hex');
+            const stamped = { createdAt: nowIso, updatedAt: nowIso, firstSeenTs: nowIso, sourceHash, ...seed.json };
             fs_1.default.writeFileSync(tmp, JSON.stringify(stamped, null, 2), { encoding: 'utf8' });
             fs_1.default.renameSync(tmp, target);
             summary.created.push(seed.file);

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@jagilber-org/index-server",
-  "version": "1.28.8",
+  "version": "1.28.10",
   "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

@@ -648,6 +648,12 @@ Non-interactive mode:
     console.log(`\n✅ .env written to: ${envPath}`);
   }
+  // ── Deploy runtime BEFORE config generation ─────────────────────────
+  // resolveServerLaunch picks 'local' source (cwd = config.root) only when
+  // <config.root>/dist/server/index-server.js exists. Deploy first so configs
+  // are emitted with stable user-data-root paths instead of npm-global paths.
+  await deployRuntime(config);
   // ── Multi-target config generation ──────────────────────────────────
   const configTargets = resolveConfigPaths(config);
@@ -705,9 +711,6 @@ Non-interactive mode:
     }
   }
-  // ── Deploy runtime if target root differs from package root ─────────
-  await deployRuntime(config);
   // ── Next steps ──────────────────────────────────────────────────────
   const proto = (config.profile === 'enhanced' || config.profile === 'experimental') ? 'https' : 'http';
   const launch = resolveServerLaunch(config);

package/server.json CHANGED Viewed

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