docstar-cli 1.1.0 → 1.2.1-beta.0

package/bin/run.js

@@ -1,5 +1,15 @@
 #!/usr/bin/env node
 
 import {execute} from '@oclif/core'
+import {readFileSync} from 'node:fs'
+
+// oclif's built-in --version prints `docstar-cli/1.2.0 darwin-arm64 node-v22.22.3`. We only want
+// the bare version number, so intercept it here before oclif ever sees the flag.
+const args = process.argv.slice(2)
+if (args.length === 1 && (args[0] === '--version' || args[0] === '-v')) {
+  const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
+  console.log(pkg.version)
+  process.exit(0)
+}
 
 await execute({dir: import.meta.url})

package/dist/commands/clean.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class Clean extends Command {
+    static args: {
+        collection: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/clean.js

@@ -0,0 +1,88 @@
+import { checkbox, confirm } from '@inquirer/prompts';
+import { Args, Command, Flags } from '@oclif/core';
+import { readFile, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { collectionModulesDir, configPath, modulePath } from '../lib/paths.js';
+export default class Clean extends Command {
+    static args = {
+        collection: Args.string({ description: 'The collection (CLI name) to clean up, e.g. msg91', required: true }),
+    };
+    static description = [
+        'Uninstall modules from a collection, or the entire collection.',
+        'By default shows a checklist of the collection\'s installed modules to remove.',
+        '`--all` targets the whole collection instead; combine with `--force` to skip the confirmation prompt.',
+    ].join('\n');
+    static examples = [
+        '<%= config.bin %> <%= command.id %> msg91                # pick modules to remove from "msg91"',
+        '<%= config.bin %> <%= command.id %> msg91 --all           # remove the whole "msg91" collection (asks to confirm)',
+        '<%= config.bin %> <%= command.id %> msg91 --all --force   # remove the whole "msg91" collection without asking',
+    ];
+    static flags = {
+        all: Flags.boolean({ description: 'Remove the entire collection instead of picking modules' }),
+        force: Flags.boolean({ description: 'Skip the confirmation prompt (only relevant with --all)' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Clean);
+        let savedConfig;
+        try {
+            savedConfig = JSON.parse(await readFile(configPath(), 'utf8'));
+        }
+        catch {
+            this.error('No installed modules found. Run `docstar-cli init <domain>` first.');
+        }
+        const collection = savedConfig.collections.find((c) => c.cliName === args.collection);
+        if (!collection) {
+            this.error(`Collection "${args.collection}" isn't installed. Run \`docstar-cli list\` to see installed collections.`);
+        }
+        if (flags.all) {
+            if (!flags.force) {
+                const shouldDelete = await confirm({
+                    default: false,
+                    message: `Delete the entire "${collection.cliName}" collection and all ${collection.modules.length} installed module(s)?`,
+                });
+                if (!shouldDelete) {
+                    this.log('Aborted, nothing was removed.');
+                    return;
+                }
+            }
+            await rm(collectionModulesDir(collection.cliName), { force: true, recursive: true });
+            await rm(join(this.config.root, 'dist', 'commands', collection.cliName), { force: true, recursive: true });
+            savedConfig.collections = savedConfig.collections.filter((c) => c.cliName !== collection.cliName);
+            await writeFile(configPath(), JSON.stringify(savedConfig, null, 2));
+            this.log(`Removed collection "${collection.cliName}" and its ${collection.modules.length} module(s).`);
+            return;
+        }
+        if (collection.modules.length === 0) {
+            this.log(`Collection "${collection.cliName}" has no installed modules.`);
+            return;
+        }
+        const SELECT_ALL = '__select_all__';
+        const rawSelection = await checkbox({
+            choices: [
+                ...collection.modules.map((module) => ({ checked: false, name: `${module.name} (${module.path})`, value: module.path })),
+                { checked: false, name: '➤ Select all modules', value: SELECT_ALL },
+            ],
+            message: `Select modules to remove from "${collection.cliName}" (space to toggle, enter to confirm)`,
+        });
+        const selectedPaths = rawSelection.includes(SELECT_ALL) ? collection.modules.map((module) => module.path) : rawSelection;
+        if (selectedPaths.length === 0) {
+            this.log('No modules selected, nothing removed.');
+            return;
+        }
+        for (const path of selectedPaths) {
+            // eslint-disable-next-line no-await-in-loop
+            await rm(modulePath(collection.cliName, path), { force: true });
+            // eslint-disable-next-line no-await-in-loop
+            await rm(join(this.config.root, 'dist', 'commands', collection.cliName, path), { force: true, recursive: true });
+            this.log(`  removed: ${collection.cliName} ${path}`);
+        }
+        collection.modules = collection.modules.filter((module) => !selectedPaths.includes(module.path));
+        if (collection.modules.length === 0) {
+            await rm(collectionModulesDir(collection.cliName), { force: true, recursive: true });
+            savedConfig.collections = savedConfig.collections.filter((c) => c.cliName !== collection.cliName);
+            this.log(`Collection "${collection.cliName}" has no modules left, removed it entirely.`);
+        }
+        await writeFile(configPath(), JSON.stringify(savedConfig, null, 2));
+        this.log(`Removed ${selectedPaths.length} module(s) from "${collection.cliName}".`);
+    }
+}

package/oclif.manifest.json

@@ -1,5 +1,49 @@
 {
   "commands": {
+    "clean": {
+      "aliases": [],
+      "args": {
+        "collection": {
+          "description": "The collection (CLI name) to clean up, e.g. msg91",
+          "name": "collection",
+          "required": true
+        }
+      },
+      "description": "Uninstall modules from a collection, or the entire collection.\nBy default shows a checklist of the collection's installed modules to remove.\n`--all` targets the whole collection instead; combine with `--force` to skip the confirmation prompt.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> msg91                # pick modules to remove from \"msg91\"",
+        "<%= config.bin %> <%= command.id %> msg91 --all           # remove the whole \"msg91\" collection (asks to confirm)",
+        "<%= config.bin %> <%= command.id %> msg91 --all --force   # remove the whole \"msg91\" collection without asking"
+      ],
+      "flags": {
+        "all": {
+          "description": "Remove the entire collection instead of picking modules",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Skip the confirmation prompt (only relevant with --all)",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "clean",
+      "pluginAlias": "docstar-cli",
+      "pluginName": "docstar-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "clean.js"
+      ]
+    },
     "complete": {
       "aliases": [],
       "args": {
@@ -160,5 +204,5 @@
       ]
     }
   },
-  "version": "1.1.0"
+  "version": "1.2.1-beta.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docstar-cli",
   "description": "Call published DocStar API endpoints directly from your terminal, or expose them as MCP tools for AI clients.",
-  "version": "1.1.0",
+  "version": "1.2.1-beta.0",
   "author": "Swayam Maheshwari",
   "bin": {
     "docstar-cli": "./bin/run.js"
@@ -12,7 +12,6 @@
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
-    "@oclif/plugin-plugins": "^5",
     "zod": "^4.4.3"
   },
   "devDependencies": {
@@ -52,13 +51,9 @@
     "dirname": "docstar-cli",
     "commands": "./dist/commands",
     "plugins": [
-      "@oclif/plugin-help",
-      "@oclif/plugin-plugins"
+      "@oclif/plugin-help"
     ],
-    "topicSeparator": " ",
-    "additionalVersionFlags": [
-      "-v"
-    ]
+    "topicSeparator": " "
   },
   "repository": "swayammaheshwari/docstar-cli",
   "scripts": {