@hiai-gg/docsmint 0.9.2 → 0.10.0

package/dist/types.d.ts

@@ -141,6 +141,15 @@ export interface DocsTag {
     createdAt?: string;
     documentCount?: number;
 }
+export interface DocsTrashResponse {
+    documents: Array<{
+        id: string;
+        title: string;
+        deletedAt: string;
+        purgeAfter: string | null;
+    }>;
+    folders: [];
+}
 /**
  * Search hit as returned by `GET /api/search`. The backend uses
  * snake_case in the JSON payload — we mirror that exactly here so

package/package.json

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

package/packages/cli/src/index.ts

@@ -25,7 +25,7 @@ import { registerSearch } from './commands/search.js';
 import { registerSnapshot } from './commands/snapshot.js';
 import { registerUpdate } from './commands/update.js';
 
-const VERSION = '0.9.2';
+const VERSION = '0.10.0';
 
 const program = new Command();
 program.name('docsmint').description('CLI for the DocsMint knowledge workspace').version(VERSION);

package/server.json

@@ -10,7 +10,7 @@
     "id": "1249550690",
     "subfolder": "packages/mcp-server"
   },
-  "version": "0.9.2",
+  "version": "0.10.0",
   "icons": [
     {
       "src": "https://raw.githubusercontent.com/HiAi-gg/docsmint/main/frontend/static/logo-dark.png",
@@ -34,7 +34,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@hiai-gg/docsmint",
-      "version": "0.9.2",
+      "version": "0.10.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"
@@ -87,7 +87,7 @@
       "licenseFile": "https://github.com/HiAi-gg/docsmint/blob/main/LICENSE",
       "documentationUrl": "https://docsmint.com/mcp/connect?source=mcp_registry",
       "catalog": {
-        "tools": 21,
+        "tools": 20,
         "prompts": 2,
         "resources": 3
       }

package/skills/docsmint-document-manager/SKILL.md

@@ -17,17 +17,18 @@ Use this skill when an agent must create, organize, edit, or research documents
 
 ## Retrieval workflow
 
-1. Use `search_documents` with the user's original language.
-2. Read the most relevant documents with `get_document`.
-3. Use `get_related_documents` or `search_knowledge_graph` only with authorized document IDs returned by search.
+1. Use `find_documents(mode=search)` with the user's original language; use `mode=list` for paginated browsing by folder or tag UUID.
+2. Read relevant content with `read_document(view=detail)` or export Markdown with `view=markdown`.
+3. Use `explore_graph(mode=neighbors|search)` only with authorized document IDs returned by `find_documents`.
 4. Cite document IDs and distinguish retrieved facts from inference.
 
 ## Document management workflow
 
-1. Inspect `list_categories`, `list_folders`, and `list_tags` before organizing content.
-2. Create categories only with a workspace-scoped key.
-3. Create folders and documents within the active scope.
-4. After an update, inspect `get_document_index_status`; use `refresh_document_index` only when indexing is stale or failed.
-5. Use snapshots before a substantial rewrite when version history is important.
+1. Inspect `list_workspace_structure(kind=categories|folders|tags)` before organizing content.
+2. Create or update categories with `save_category(action=create|update)` only with a workspace-scoped key.
+3. Use `save_folder`, `save_document`, `save_tag`, and `set_document_tag` with explicit actions and stay in the active scope.
+4. After a document update, inspect `get_document_index_status`; use `refresh_document_index` only when indexing is stale or failed.
+5. Use `create_snapshot` before a substantial rewrite; choose a version through `read_document(view=versions)` before `restore_document_version`.
+6. Treat `delete_document`, `restore_trashed_document`, and `permanently_delete_document` as distinct lifecycle actions. Purge only on an explicit request.
 
 DocsMint owns chunking, embeddings, multilingual hybrid retrieval, cross-encoder rerank, entity extraction, and GraphRAG indexing. Agents must use the MCP tools and never write those persistence layers directly.