docshark 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.7 (2026-03-07)
+
+**Full Changelog**: https://github.com/Michael-Obele/docshark/compare/v0.1.6...v0.1.7
+
 ## 0.1.6 (2026-03-07)
 
 **Full Changelog**: https://github.com/Michael-Obele/docshark/compare/v0.1.5...v0.1.6

package/README.md

@@ -49,14 +49,14 @@ We are actively polishing the integration between the core engine and external M
 
 ### Quick Start (from npm)
 
-You can run DocShark directly without installing it globally using `npx`:
+You can run DocShark directly without installing it globally using `bunx`:
 
 ```bash
 # Add a documentation library to the index
-npx docshark add https://valibot.dev/guides/ --depth 2
+bunx docshark add https://valibot.dev/guides/ --depth 2
 
 # Search your indexed docs
-npx docshark search "schema validation"
+bunx docshark search "schema validation"
 ```
 
 ### Installation
@@ -87,7 +87,7 @@ Add DocShark to your `.vscode/settings.json` or global MCP configuration:
 {
   "mcpServers": {
     "docshark": {
-      "command": "npx",
+      "command": "bunx",
       "args": ["-y", "docshark", "start", "--stdio"]
     }
   }
@@ -100,7 +100,7 @@ Add DocShark to your `.vscode/settings.json` or global MCP configuration:
 2. Click **+ Add New MCP Server**.
 3. Name: `docshark`
 4. Type: `command`
-5. Command: `npx -y docshark start --stdio`
+5. Command: `bunx -y docshark start --stdio`
 
 ### Claude Desktop
 
@@ -113,7 +113,7 @@ Edit your Claude Desktop configuration file:
 {
   "mcpServers": {
     "docshark": {
-      "command": "npx",
+      "command": "bunx",
       "args": ["-y", "docshark", "start", "--stdio"]
     }
   }

package/dist/cli.d.ts

@@ -1,2 +1,2 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 export {};

package/dist/cli.js

@@ -1,20 +1,20 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 // src/cli.ts — DocShark CLI entry point
-import { Command } from 'commander';
-import { startHttpServer } from './http.js';
-import { StdioTransport } from '@tmcp/transport-stdio';
-import { server, db, searchEngine, libraryService } from './server.js';
-import { VERSION } from './version.js';
+import { Command } from "commander";
+import { startHttpServer } from "./http.js";
+import { StdioTransport } from "@tmcp/transport-stdio";
+import { server, db, searchEngine, libraryService } from "./server.js";
+import { VERSION } from "./version.js";
 const program = new Command()
-    .name('docshark')
-    .description('🦈 Documentation MCP Server — scrape, index, and search any doc website')
-    .version(VERSION, '-v, --version', 'output the current version');
+    .name("docshark")
+    .description("🦈 Documentation MCP Server — scrape, index, and search any doc website")
+    .version(VERSION, "-v, --version", "output the current version");
 program
-    .command('start', { isDefault: true })
-    .description('Start the MCP server')
-    .option('-p, --port <port>', 'HTTP server port', '6380')
-    .option('--stdio', 'Run in STDIO mode (for Claude Desktop, Cursor, etc.)')
-    .option('--data-dir <path>', 'Data directory', '')
+    .command("start", { isDefault: true })
+    .description("Start the MCP server")
+    .option("-p, --port <port>", "HTTP server port", "6380")
+    .option("--stdio", "Run in STDIO mode (for Claude Desktop, Cursor, etc.)")
+    .option("--data-dir <path>", "Data directory", "")
     .action(async (opts) => {
     if (opts.dataDir) {
         process.env.DOCSHARK_DATA_DIR = opts.dataDir;
@@ -30,11 +30,11 @@ program
     }
 });
 program
-    .command('add <url>')
-    .description('Add a documentation library and start crawling')
-    .option('-n, --name <name>', 'Library name (auto-generated from URL if omitted)')
-    .option('-d, --depth <n>', 'Max crawl depth', '3')
-    .option('--lib-version <version>', 'Library version')
+    .command("add <url>")
+    .description("Add a documentation library and start crawling")
+    .option("-n, --name <name>", "Library name (auto-generated from URL if omitted)")
+    .option("-d, --depth <n>", "Max crawl depth", "3")
+    .option("--lib-version <version>", "Library version")
     .action(async (url, opts) => {
     db.init();
     try {
@@ -56,10 +56,10 @@ program
     }
 });
 program
-    .command('search <query>')
-    .description('Search indexed documentation')
-    .option('-l, --library <name>', 'Filter by library')
-    .option('--limit <n>', 'Max results', '5')
+    .command("search <query>")
+    .description("Search indexed documentation")
+    .option("-l, --library <name>", "Filter by library")
+    .option("--limit <n>", "Max results", "5")
     .action(async (query, opts) => {
     db.init();
     const results = searchEngine.search(query, {
@@ -78,8 +78,8 @@ program
     }
 });
 program
-    .command('list')
-    .description('List indexed libraries')
+    .command("list")
+    .description("List indexed libraries")
     .action(() => {
     db.init();
     const libs = db.listLibraries();
@@ -93,19 +93,19 @@ program
         Pages: l.page_count,
         Chunks: l.chunk_count,
         Status: l.status,
-        'Last Crawled': l.last_crawled_at || 'never',
+        "Last Crawled": l.last_crawled_at || "never",
     })));
 });
 program
-    .command('refresh <name>')
-    .description('Refresh an existing documentation library')
+    .command("refresh <name>")
+    .description("Refresh an existing documentation library")
     .action(async (name) => {
     db.init();
     try {
         const lib = db.getLibraryByName(name);
         if (!lib)
             throw new Error(`Library "${name}" not found.`);
-        const { jobManager } = await import('./server.js');
+        const { jobManager } = await import("./server.js");
         const job = jobManager.startCrawl(lib.id, { incremental: true });
         console.log(`\n🔄 Refreshing "${lib.display_name}" — crawling ${lib.url}...`);
         console.log(`   Job ID: ${job.id}`);
@@ -117,8 +117,8 @@ program
     }
 });
 program
-    .command('remove <name>')
-    .description('Remove a documentation library and its index')
+    .command("remove <name>")
+    .description("Remove a documentation library and its index")
     .action((name) => {
     db.init();
     try {
@@ -134,8 +134,8 @@ program
     }
 });
 program
-    .command('get <url>')
-    .description('Get the full markdown content of a specific indexed page')
+    .command("get <url>")
+    .description("Get the full markdown content of a specific indexed page")
     .action((url) => {
     db.init();
     const page = db.getPage({ url });
@@ -146,23 +146,23 @@ program
     console.log(`\n--- ${page.title} ---`);
     console.log(`Source: ${page.url}\n\n`);
     console.log(page.content_markdown);
-    console.log('\n');
+    console.log("\n");
 });
 program.parse();
 /** Helper to wait for a crawl job to finish (CLI blocking mode) */
 async function waitForCrawl(jobId) {
-    const { jobManager } = await import('./server.js');
+    const { jobManager } = await import("./server.js");
     return new Promise((resolve) => {
         const check = () => {
             const job = jobManager.getJob(jobId);
-            if (!job || job.status === 'completed' || job.status === 'failed') {
-                if (job?.status === 'completed') {
+            if (!job || job.status === "completed" || job.status === "failed") {
+                if (job?.status === "completed") {
                     console.log(`\n🦈 Crawl complete: ${job.pages_crawled} pages, ${job.chunks_created} chunks indexed.`);
                     if (job.pages_failed > 0) {
                         console.log(`   ⚠️  ${job.pages_failed} pages failed.`);
                     }
                 }
-                else if (job?.status === 'failed') {
+                else if (job?.status === "failed") {
                     console.error(`\n❌ Crawl failed: ${job.error_message}`);
                 }
                 resolve();

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.1.6";
+export declare const VERSION = "0.1.7";

package/dist/version.js

@@ -1,2 +1,2 @@
 // This file is automatically updated by release-please
-export const VERSION = '0.1.6'; // x-release-please-version
+export const VERSION = '0.1.7'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docshark",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "🦈 Documentation MCP Server — scrape, index, and search any doc website",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,10 +26,14 @@
     "dev": "bun run --watch src/cli.ts start",
     "cli": "bun run src/cli.ts",
     "check": "tsc --noEmit",
-    "build": "rm -rf dist && tsc",
+    "build": "rm -rf dist && tsc && chmod +x dist/cli.js",
     "prepublishOnly": "bun run build",
     "test:crawl": "bun run src/cli.ts add https://svelte.dev/docs/svelte/overview"
   },
+  "engines": {
+    "node": ">=20",
+    "bun": ">=1.1.0"
+  },
   "keywords": [
     "tmcp",
     "mcp",