@hiai-gg/docsmint 0.6.2 → 0.6.6

package/README.md

@@ -40,10 +40,23 @@ server.
 - **Own the full stack**: application data, vectors, graph, queue, and files run
   on infrastructure you control.
 
-## What's new in DocsMint 0.6.2?
+## What's new in DocsMint 0.6.6?
+
+- **Safe explicit index recovery.** Admin document reindexing keeps the active
+  generation searchable until a new generation has passed embedding, graph,
+  summary, and finalize stages.
+- **Truthful queue admission.** Maintenance requests force a replacement
+  generation and report an error when durable enqueue fails instead of
+  returning a false-positive success.
+- **Verified MCP distribution.** The official MCP Registry manifest, npm stdio
+  package, hosted Streamable HTTP endpoint, bundled Skill, prompts, resources,
+  and 17-tool catalog remain one versioned contract.
+
+DocsMint 0.6.6 includes the registry metadata fixes released in 0.6.3-0.6.5
+and the complete MCP foundation introduced in 0.6.2:
 
 - **Official MCP identity.** DocsMint now publishes the verified
-  `io.github.hiai-gg/docsmint` registry identity for both the npm stdio server
+  `io.github.HiAi-gg/docsmint` registry identity for both the npm stdio server
   and the hosted Streamable HTTP endpoint.
 - **One capability implementation.** The public `@hiai-gg/docsmint/mcp`
   contract lets hosts provide a scoped API client while reusing the same 17

package/dist/backend/index.js

@@ -194473,7 +194473,7 @@ async function claimEnqueueSlot(docId, workspaceId) {
     return true;
   }
 }
-async function enqueueReembed(docIds, workspaceId) {
+async function enqueueReembed(docIds, workspaceId, options = {}) {
   const unique = new Set;
   for (const id2 of docIds) {
     if (typeof id2 !== "string" || id2.trim().length === 0)
@@ -194482,9 +194482,10 @@ async function enqueueReembed(docIds, workspaceId) {
   }
   let pushed = 0;
   for (const id2 of unique) {
-    if (await claimEnqueueSlot(id2, workspaceId)) {
-      enqueueEmbedding(id2, "interactive", workspaceId);
-      pushed += 1;
+    if (options.bypassDedup || await claimEnqueueSlot(id2, workspaceId)) {
+      const queued = await enqueueEmbedding(id2, options.source ?? "interactive", workspaceId, { forceNewGeneration: options.forceNewGeneration });
+      if (queued)
+        pushed += 1;
     }
   }
   return pushed;
@@ -194620,14 +194621,20 @@ var adminRoutes = new Elysia({ prefix: "/api/admin" }).post("/reindex/:docId", a
       set2.status = 404;
       return { error: "Document not found" };
     }
-    await withTenant(adminTenantContextBound(), async (tx) => {
-      await tx.delete(documentEmbeddings).where(eq(documentEmbeddings.documentId, params.docId));
+    const enqueued = await enqueueReembed([params.docId], undefined, {
+      bypassDedup: true,
+      forceNewGeneration: true,
+      source: "reindex"
     });
-    enqueueReembed([params.docId]);
+    if (enqueued !== 1) {
+      set2.status = 503;
+      return { error: "Failed to queue document reindex" };
+    }
     return {
       success: true,
       documentId: params.docId,
-      message: "Existing embeddings cleared and document re-queued"
+      enqueued,
+      message: "Document reindex queued with a new generation"
     };
   } catch (err) {
     logger3.error({ err, docId: params.docId }, "Admin reindex failed");
@@ -234946,7 +234953,7 @@ var swaggerConfig = {
     },
     info: {
       title: "DocsMint API",
-      version: "0.6.2",
+      version: "0.6.6",
       description: "Self-hosted AI-first documentation platform. Full-text + semantic search, version history, sharing, and folder organization.",
       contact: { name: "HiAi-gg", url: "https://github.com/HiAi-gg/docsmint" },
       license: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hiai-gg/docsmint",
-  "mcpName": "io.github.hiai-gg/docsmint",
-  "version": "0.6.2",
+  "mcpName": "io.github.HiAi-gg/docsmint",
+  "version": "0.6.6",
   "type": "module",
   "browser": {
     "./dist/backend-launcher.js": false,

package/packages/cli/src/index.ts

@@ -8,53 +8,50 @@
  * Bun-native. ESM-only. No external color/formatting libraries.
  */
 
-import { Command } from "commander";
-import { configFilePath, loadConfig, saveConfig } from "./config.js";
-import { client, type HiaiDocsClient } from "./client.js";
-import { registerConfig } from "./commands/config.js";
-import { registerCreate } from "./commands/create.js";
-import { registerDelete } from "./commands/delete.js";
-import { registerExport } from "./commands/export.js";
-import { registerFolders } from "./commands/folders.js";
-import { registerHistory } from "./commands/history.js";
-import { registerList } from "./commands/list.js";
-import { registerRead } from "./commands/read.js";
-import { registerRestore } from "./commands/restore.js";
-import { registerSearch } from "./commands/search.js";
-import { registerSnapshot } from "./commands/snapshot.js";
-import { registerUpdate } from "./commands/update.js";
+import { Command } from 'commander';
+import { configFilePath, loadConfig, saveConfig } from './config.js';
+import { client, type HiaiDocsClient } from './client.js';
+import { registerConfig } from './commands/config.js';
+import { registerCreate } from './commands/create.js';
+import { registerDelete } from './commands/delete.js';
+import { registerExport } from './commands/export.js';
+import { registerFolders } from './commands/folders.js';
+import { registerHistory } from './commands/history.js';
+import { registerList } from './commands/list.js';
+import { registerRead } from './commands/read.js';
+import { registerRestore } from './commands/restore.js';
+import { registerSearch } from './commands/search.js';
+import { registerSnapshot } from './commands/snapshot.js';
+import { registerUpdate } from './commands/update.js';
 
-const VERSION = "0.6.2";
+const VERSION = '0.6.6';
 
 const program = new Command();
-program
-	.name("hiai-docs")
-	.description("CLI for the hiai-docs knowledge base")
-	.version(VERSION);
+program.name('hiai-docs').description('CLI for the hiai-docs knowledge base').version(VERSION);
 
 const getClient = (): HiaiDocsClient => client;
 
 // Bootstrap command — interactive first-run helper.
 program
-	.command("init")
-	.description("Initialize the CLI (writes ~/.hiai-docs/config.json)")
-	.option("--url <url>", "API base URL")
-	.option("--key <key>", "API key")
-	.action(async (opts: { url?: string; key?: string }) => {
-		const current = loadConfig();
-		const next = {
-			url: opts.url ?? current.url,
-			apiKey: opts.key ?? current.apiKey,
-		};
-		saveConfig(next);
-		process.stdout.write(`Config written to ${configFilePath()}\n`);
-		process.stdout.write(`url:  ${next.url}\n`);
-		if (next.apiKey) {
-			process.stdout.write(`key:  ${next.apiKey.slice(0, 4)}…(redacted)\n`);
-		} else {
-			process.stdout.write("key:  (unset)\n");
-		}
-	});
+  .command('init')
+  .description('Initialize the CLI (writes ~/.hiai-docs/config.json)')
+  .option('--url <url>', 'API base URL')
+  .option('--key <key>', 'API key')
+  .action(async (opts: { url?: string; key?: string }) => {
+    const current = loadConfig();
+    const next = {
+      url: opts.url ?? current.url,
+      apiKey: opts.key ?? current.apiKey,
+    };
+    saveConfig(next);
+    process.stdout.write(`Config written to ${configFilePath()}\n`);
+    process.stdout.write(`url:  ${next.url}\n`);
+    if (next.apiKey) {
+      process.stdout.write(`key:  ${next.apiKey.slice(0, 4)}…(redacted)\n`);
+    } else {
+      process.stdout.write('key:  (unset)\n');
+    }
+  });
 
 // Register the spec'd commands.
 registerSearch(program, getClient);

package/packages/mcp-server/src/server.ts

@@ -81,7 +81,7 @@ export interface CreateDocsmintMcpServerOptions {
 }
 
 export function createDocsmintMcpServer(options: CreateDocsmintMcpServerOptions = {}): McpServer {
-  const server = new McpServer({ name: 'docsmint', version: '0.6.2' });
+  const server = new McpServer({ name: 'docsmint', version: '0.6.6' });
   registerDocsmintMcpCapabilities(server, options.client ?? defaultClient);
   return server;
 }

package/server.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.hiai-gg/docsmint",
+  "name": "io.github.HiAi-gg/docsmint",
   "title": "DocsMint",
   "description": "Manage scoped DocsMint documents, folders, categories, search, GraphRAG, and indexing through MCP.",
   "repository": {
@@ -8,12 +8,12 @@
     "source": "github",
     "id": "1249550690"
   },
-  "version": "0.6.2",
+  "version": "0.6.6",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@hiai-gg/docsmint",
-      "version": "0.6.2",
+      "version": "0.6.6",
       "transport": {
         "type": "stdio"
       },