docstar-cli 0.0.0 → 1.0.3

package/oclif.manifest.json

@@ -9,7 +9,7 @@
           "required": true
         }
       },
-      "description": "Discover published modules for a DocStar docs site, pick which ones to install, and register their CLI commands",
+      "description": "Discover published modules for a DocStar docs site, pick which ones to install, and register their CLI commands.\nYou can run this against multiple docs sites/collections — each is kept separate under its own CLI name (`docstar-cli <cli-name> <module> <command>`).\nAfter installing, run `docstar-cli list` to see what got installed.",
       "examples": [
         "<%= config.bin %> <%= command.id %> docs.msg91.com",
         "<%= config.bin %> <%= command.id %> localhost:3000 --collectionId paM4R4A26Hvb"
@@ -38,14 +38,63 @@
         "init.js"
       ]
     },
-    "slack:list": {
+    "list": {
+      "aliases": [],
+      "args": {
+        "collection": {
+          "description": "Show modules installed for this collection (CLI name), e.g. msg91",
+          "name": "collection",
+          "required": false
+        },
+        "module": {
+          "description": "Show all endpoints for this module within the collection, e.g. slack",
+          "name": "module",
+          "required": false
+        }
+      },
+      "description": "List installed collections, the modules within one, or every endpoint of one module",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>              # list every installed collection",
+        "<%= config.bin %> <%= command.id %> --all        # same as above",
+        "<%= config.bin %> <%= command.id %> msg91         # list modules installed for the \"msg91\" collection",
+        "<%= config.bin %> <%= command.id %> msg91 slack   # list all of Slack's installed endpoints in \"msg91\""
+      ],
+      "flags": {
+        "all": {
+          "description": "List every installed collection (default when no arguments are given)",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "list",
+      "pluginAlias": "docstar-cli",
+      "pluginName": "docstar-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "list.js"
+      ]
+    },
+    "mcp": {
       "aliases": [],
       "args": {},
-      "description": "List installed APIs for the slack module",
+      "description": "Start an MCP (Model Context Protocol) server exposing every installed endpoint (across all installed collections) as a callable tool for AI clients (Claude Desktop, Claude Code, etc.).\nEach endpoint becomes one tool named `<cli-name>__<module>__<command>`, e.g. `msg91__slack__send-message-1`. Run `docstar-cli init <domain>` first so there is at least one installed module to expose.\nThis command does not exit on its own — it stays running and communicates over stdio for as long as the connecting AI client keeps the connection open.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "# Then register it in an MCP client config, e.g. .mcp.json:",
+        "# { \"mcpServers\": { \"docstar\": { \"command\": \"docstar-cli\", \"args\": [\"mcp\"] } } }"
+      ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "slack:list",
+      "id": "mcp",
       "pluginAlias": "docstar-cli",
       "pluginName": "docstar-cli",
       "pluginType": "core",
@@ -55,18 +104,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "slack",
-        "list.js"
+        "mcp.js"
       ]
     },
-    "slack:send-message-1": {
+    "api-collection-2:viasocket:send-alert": {
       "aliases": [],
       "args": {},
-      "description": "send message",
+      "description": "send alert",
       "flags": {
-        "MY_SECRET_KEY": {
+        "message": {
           "description": "Required parameter",
-          "name": "MY_SECRET_KEY",
+          "name": "message",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -74,7 +122,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "slack:send-message-1",
+      "id": "api-collection-2:viasocket:send-alert",
       "pluginAlias": "docstar-cli",
       "pluginName": "docstar-cli",
       "pluginType": "core",
@@ -84,29 +132,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "slack",
-        "send-message-1.js"
+        "api-collection-2",
+        "viasocket",
+        "send-alert.js"
       ]
     },
-    "hello": {
+    "api-collection:slack:send-message-1": {
       "aliases": [],
-      "args": {
-        "person": {
-          "description": "Person to say hello to",
-          "name": "person",
-          "required": true
-        }
-      },
-      "description": "Say hello",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> friend --from oclif\nhello friend from oclif! (./src/commands/hello/index.ts)\n"
-      ],
+      "args": {},
+      "description": "send message",
       "flags": {
-        "from": {
-          "char": "f",
-          "description": "Who is saying hello",
-          "name": "from",
-          "required": true,
+        "message": {
+          "description": "Required parameter",
+          "name": "message",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -114,7 +152,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hello",
+      "id": "api-collection:slack:send-message-1",
       "pluginAlias": "docstar-cli",
       "pluginName": "docstar-cli",
       "pluginType": "core",
@@ -124,21 +162,48 @@
       "relativePath": [
         "dist",
         "commands",
-        "hello",
-        "index.js"
+        "api-collection",
+        "slack",
+        "send-message-1.js"
       ]
     },
-    "hello:world": {
+    "docstar-apis:public-routes:find-matches-1": {
       "aliases": [],
       "args": {},
-      "description": "Say hello world",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>\nhello world! (./src/commands/hello/world.ts)\n"
-      ],
-      "flags": {},
+      "description": "Find matches",
+      "flags": {
+        "query": {
+          "description": "Required parameter",
+          "name": "query",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "collectionIds": {
+          "description": "Required parameter",
+          "name": "collectionIds",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "getUrl": {
+          "description": "Required parameter",
+          "name": "getUrl",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "allowNonDomain": {
+          "description": "Required parameter",
+          "name": "allowNonDomain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hello:world",
+      "id": "docstar-apis:public-routes:find-matches-1",
       "pluginAlias": "docstar-cli",
       "pluginName": "docstar-cli",
       "pluginType": "core",
@@ -148,10 +213,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "hello",
-        "world.js"
+        "docstar-apis",
+        "public-routes",
+        "find-matches-1.js"
       ]
     }
   },
-  "version": "0.0.0"
+  "version": "1.0.3"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docstar-cli",
-  "description": "A new CLI generated with oclif",
-  "version": "0.0.0",
+  "description": "Call published DocStar API endpoints directly from your terminal, or expose them as MCP tools for AI clients.",
+  "version": "1.0.3",
   "author": "Swayam Maheshwari",
   "bin": {
     "docstar-cli": "./bin/run.js"
@@ -9,9 +9,11 @@
   "bugs": "https://github.com/swayammaheshwari/docstar-cli/issues",
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
-    "@oclif/plugin-plugins": "^5"
+    "@oclif/plugin-plugins": "^5",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@eslint/compat": "^1",
@@ -54,11 +56,9 @@
       "@oclif/plugin-plugins"
     ],
     "topicSeparator": " ",
-    "topics": {
-      "hello": {
-        "description": "Say hello to the world and others"
-      }
-    }
+    "additionalVersionFlags": [
+      "-v"
+    ]
   },
   "repository": "swayammaheshwari/docstar-cli",
   "scripts": {

package/dist/commands/hello/index.d.ts

@@ -1,12 +0,0 @@
-import { Command } from '@oclif/core';
-export default class Hello extends Command {
-    static args: {
-        person: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static description: string;
-    static examples: string[];
-    static flags: {
-        from: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/hello/index.js

@@ -1,19 +0,0 @@
-import { Args, Command, Flags } from '@oclif/core';
-export default class Hello extends Command {
-    static args = {
-        person: Args.string({ description: 'Person to say hello to', required: true }),
-    };
-    static description = 'Say hello';
-    static examples = [
-        `<%= config.bin %> <%= command.id %> friend --from oclif
-hello friend from oclif! (./src/commands/hello/index.ts)
-`,
-    ];
-    static flags = {
-        from: Flags.string({ char: 'f', description: 'Who is saying hello', required: true }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(Hello);
-        this.log(`hello ${args.person} from ${flags.from}! (./src/commands/hello/index.ts)`);
-    }
-}

package/dist/commands/hello/world.js

@@ -1,14 +0,0 @@
-import { Command } from '@oclif/core';
-export default class World extends Command {
-    static args = {};
-    static description = 'Say hello world';
-    static examples = [
-        `<%= config.bin %> <%= command.id %>
-hello world! (./src/commands/hello/world.ts)
-`,
-    ];
-    static flags = {};
-    async run() {
-        this.log('hello world! (./src/commands/hello/world.ts)');
-    }
-}

package/dist/commands/slack/list.js

@@ -1,20 +0,0 @@
-import {Command} from '@oclif/core'
-import {loadModule} from '../../lib/http.js'
-
-export default class GeneratedList extends Command {
-  static description = 'List installed APIs for the slack module'
-
-  async run() {
-    const moduleJson = await loadModule('slack')
-
-    for (const endpoint of moduleJson.endpoints) {
-      const {cli} = endpoint
-      this.log(`${cli.command.name}${cli.command.aliases.filter((alias) => alias !== cli.command.name).length > 0 ? ` (aliases: ${cli.command.aliases.filter((alias) => alias !== cli.command.name).join(', ')})` : ''}`)
-      if (cli.description) this.log(`  ${cli.description}`)
-      this.log(`  ${endpoint.method}`)
-      if (cli.parameters.required.length > 0) this.log(`  required: ${cli.parameters.required.join(', ')}`)
-      if (cli.parameters.optional.length > 0) this.log(`  optional: ${cli.parameters.optional.join(', ')}`)
-      this.log('')
-    }
-  }
-}