@nemus-cli/nemus 0.2.1

package/dist/mcp/server.js

@@ -0,0 +1,398 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+// Traversal-safe name for any parameter used to build a filesystem path (a
+// workspace name). Blocks path separators, drive letters, "."/".." and NUL, so an
+// MCP client cannot escape the workspaces sandbox; spaces are allowed because the
+// create path sanitizes them to hyphens. Handlers still call safeWorkspacePath()
+// as the authoritative check 2014 this is defense in depth with a clean client error.
+const WS_NAME_RE = /^[A-Za-z0-9 _-]+$/;
+const wsName = zod_1.z.string().min(1).max(64).regex(WS_NAME_RE, 'may contain only letters, numbers, spaces, hyphens, and underscores (no path separators, "..", or other special characters)');
+const tools_1 = require("./tools");
+const config_1 = require("../utils/config");
+const server = new mcp_js_1.McpServer({
+    name: 'workspace-manager',
+    version: (0, config_1.getPackageVersion)(),
+});
+server.tool('list-workspaces', 'List all workspaces with their repo counts and creation dates', {
+    includeArchived: zod_1.z.boolean().optional().default(false).describe('Include archived workspaces in the listing'),
+}, async ({ includeArchived }) => {
+    try {
+        const result = await (0, tools_1.handleListWorkspaces)(includeArchived);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('archive-workspace', 'Archive a workspace so it is hidden from default listing. Archived workspaces auto-delete after 30 days.', {
+    workspace: wsName.describe('Name of the workspace to archive'),
+}, async ({ workspace }) => {
+    try {
+        const result = await (0, tools_1.handleArchiveWorkspace)(workspace);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('unarchive-workspace', 'Unarchive a previously archived workspace, making it active again', {
+    workspace: wsName.describe('Name of the workspace to unarchive'),
+}, async ({ workspace }) => {
+    try {
+        const result = await (0, tools_1.handleUnarchiveWorkspace)(workspace);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('workspace-status', 'Show git status (branch, clean/dirty, ahead/behind) for all repos in a workspace', { workspace: wsName.describe('Name of the workspace') }, async ({ workspace }) => {
+    try {
+        const result = await (0, tools_1.handleWorkspaceStatus)(workspace);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('workspace-diff', 'Show diff summary (staged/unstaged file counts, insertions, deletions) for all repos in a workspace', {
+    workspace: wsName.describe('Name of the workspace'),
+    full: zod_1.z.boolean().optional().describe('Include full diff output'),
+}, async ({ workspace, full }) => {
+    try {
+        const result = await (0, tools_1.handleWorkspaceDiff)(workspace, full);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('workspace-sync', 'Git pull all repos in a workspace (skips repos with uncommitted changes)', { workspace: wsName.describe('Name of the workspace') }, async ({ workspace }) => {
+    try {
+        const result = await (0, tools_1.handleWorkspaceSync)(workspace);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('run-command', 'Run a shell command across all repos in a workspace (3 concurrent, 5min timeout)', {
+    workspace: wsName.describe('Name of the workspace'),
+    command: zod_1.z.string().describe('Shell command to run in each repo'),
+}, async ({ workspace, command }) => {
+    try {
+        const result = await (0, tools_1.handleRunCommand)(workspace, command);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('list-suites', 'List all saved suites (reusable repo collections) with their repo counts', {}, async () => {
+    try {
+        const result = await (0, tools_1.handleListSuites)();
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('workspace-info', 'Get detailed metadata for a workspace including all repository info, dependencies, and tags', { workspace: wsName.describe('Name of the workspace') }, async ({ workspace }) => {
+    try {
+        const result = await (0, tools_1.handleWorkspaceInfo)(workspace);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('create-workspace', 'Create a new workspace by cloning specified repositories. Provide the workspace name and an array of repository names (e.g., ["api", "web", "shared-lib"]).', {
+    workspace: wsName.describe('Name of the workspace to create'),
+    repos: zod_1.z.array(zod_1.z.string()).describe('Array of repository names to clone'),
+}, async ({ workspace, repos }) => {
+    try {
+        const result = await (0, tools_1.handleCreateWorkspace)(workspace, repos);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('update-workspace', 'Add repositories to an existing workspace. Provide the workspace name and an array of repository names to add. Each entry can be a string (e.g., "partnerships-api") or an object with name and suffix (e.g., {"name": "partnerships-api", "suffix": "v2"}) to add the same repo again under a different directory name (partnerships-api-v2). Skips repos whose target directory name already exists in the workspace.', {
+    workspace: wsName.describe('Name of the existing workspace to update'),
+    repos: zod_1.z.array(zod_1.z.union([
+        zod_1.z.string(),
+        zod_1.z.object({
+            name: zod_1.z.string().describe('repository name'),
+            suffix: zod_1.z.string().describe('Suffix to append to directory name (e.g., "v2" creates "repo-name-v2")'),
+        }),
+    ])).describe('Array of repo names (strings) or objects with {name, suffix} for adding duplicate repos under a different directory'),
+}, async ({ workspace, repos }) => {
+    try {
+        const result = await (0, tools_1.handleUpdateWorkspace)(workspace, repos);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('search-repos', 'Search org repositories by name or description using fuzzy matching', {
+    query: zod_1.z.string().describe('Search query to match against repo names and descriptions'),
+    limit: zod_1.z.number().optional().default(20).describe('Maximum number of results to return'),
+}, async ({ query, limit }) => {
+    try {
+        const result = await (0, tools_1.handleSearchRepos)(query, limit);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('list-org-repos', 'List all organization repositories from GitHub', {
+    forceRefresh: zod_1.z.boolean().optional().default(false).describe('Force refresh the cached repo list'),
+}, async ({ forceRefresh }) => {
+    try {
+        const result = await (0, tools_1.handleListOrgRepos)(forceRefresh);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('delete-workspace', 'Delete one or more workspaces and all their contents permanently. Works even if a workspace has no repos or no metadata file.', {
+    workspaces: zod_1.z.union([
+        wsName,
+        zod_1.z.array(wsName),
+    ]).describe('Name of the workspace(s) to delete — a single string or an array of names'),
+}, async ({ workspaces }) => {
+    try {
+        const result = await (0, tools_1.handleDeleteWorkspace)(workspaces);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('remove-repo', 'Remove a repository from a workspace', {
+    workspace: wsName.describe('Name of the workspace'),
+    repo: zod_1.z.string().describe('Directory name of the repository to remove'),
+}, async ({ workspace, repo }) => {
+    try {
+        const result = await (0, tools_1.handleRemoveRepo)(workspace, repo);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('workspace-doctor', 'Run health checks on a workspace and return a health score (0-100)', {
+    workspace: wsName.describe('Name of the workspace to check'),
+}, async ({ workspace }) => {
+    try {
+        const result = await (0, tools_1.handleWorkspaceDoctor)(workspace);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('analyze-deps', 'Analyze inter-repository dependencies within a workspace and detect circular dependencies', {
+    workspace: wsName.describe('Name of the workspace to analyze'),
+}, async ({ workspace }) => {
+    try {
+        const result = await (0, tools_1.handleAnalyzeDeps)(workspace);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('branch-create', 'Create a new branch across all repos in a workspace', {
+    workspace: wsName.describe('Name of the workspace'),
+    branchName: zod_1.z.string().describe('Name of the new branch to create'),
+    baseBranch: zod_1.z.string().optional().describe('Base branch to create from (defaults to current branch)'),
+}, async ({ workspace, branchName, baseBranch }) => {
+    try {
+        const result = await (0, tools_1.handleBranchCreate)(workspace, branchName, baseBranch);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('switch-branch', 'Switch all repos in a workspace to a specified branch', {
+    workspace: wsName.describe('Name of the workspace'),
+    branch: zod_1.z.string().describe('Target branch to switch to'),
+}, async ({ workspace, branch }) => {
+    try {
+        const result = await (0, tools_1.handleSwitchBranch)(workspace, branch);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('workspace-cleanup', 'Remove node_modules and build artifacts from all repos in a workspace to free disk space', {
+    workspace: wsName.describe('Name of the workspace'),
+    includeNodeModules: zod_1.z.boolean().optional().default(true).describe('Remove node_modules directories'),
+    includeBuildArtifacts: zod_1.z.boolean().optional().default(true).describe('Remove build artifact directories (dist, build, .next, coverage, out)'),
+}, async ({ workspace, includeNodeModules, includeBuildArtifacts }) => {
+    try {
+        const result = await (0, tools_1.handleWorkspaceCleanup)(workspace, includeNodeModules, includeBuildArtifacts);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('update-cache', 'Force refresh the GitHub repository cache so newly added repos become searchable', {}, async () => {
+    try {
+        const result = await (0, tools_1.handleUpdateCache)();
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+// --- Branch merge/rebase ---
+server.tool('branch-merge', 'Merge a source branch into a target branch across all repos in a workspace', {
+    workspace: wsName.describe('Name of the workspace'),
+    sourceBranch: zod_1.z.string().describe('Branch to merge from'),
+    targetBranch: zod_1.z.string().describe('Branch to merge into'),
+    strategy: zod_1.z.enum(['no-ff', 'ff-only', 'squash']).optional().describe('Merge strategy'),
+}, async ({ workspace, sourceBranch, targetBranch, strategy }) => {
+    try {
+        const result = await (0, tools_1.handleBranchMerge)(workspace, sourceBranch, targetBranch, strategy);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('branch-rebase', 'Rebase all repos in a workspace onto a target branch', {
+    workspace: wsName.describe('Name of the workspace'),
+    targetBranch: zod_1.z.string().describe('Branch to rebase onto'),
+}, async ({ workspace, targetBranch }) => {
+    try {
+        const result = await (0, tools_1.handleBranchRebase)(workspace, targetBranch);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+// --- Suite operations ---
+server.tool('suite-create', 'Create a new suite (reusable collection of repositories)', {
+    name: zod_1.z.string().describe('Name for the new suite'),
+    repos: zod_1.z.array(zod_1.z.string()).describe('Array of repository names to include'),
+    description: zod_1.z.string().optional().describe('Optional description of the suite'),
+}, async ({ name, repos, description }) => {
+    try {
+        const result = await (0, tools_1.handleSuiteCreate)(name, repos, description);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('suite-delete', 'Delete a saved suite', {
+    name: zod_1.z.string().describe('Name of the suite to delete'),
+}, async ({ name }) => {
+    try {
+        const result = await (0, tools_1.handleSuiteDelete)(name);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('suite-export', 'Export suite(s) as JSON. Omit name to export all suites.', {
+    name: zod_1.z.string().optional().describe('Name of a specific suite to export (omit for all)'),
+}, async ({ name }) => {
+    try {
+        const result = await (0, tools_1.handleSuiteExport)(name);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('suite-import', 'Import suites from a JSON string (same format as suite-export output)', {
+    content: zod_1.z.string().describe('JSON string containing suites to import'),
+    overwrite: zod_1.z.boolean().optional().default(false).describe('Overwrite existing suites with same name'),
+}, async ({ content, overwrite }) => {
+    try {
+        const result = await (0, tools_1.handleSuiteImport)(content, overwrite);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('suite-use', 'Create a new workspace from a saved suite', {
+    suite: zod_1.z.string().describe('Name of the suite to use'),
+    workspace: wsName.describe('Name for the new workspace to create'),
+}, async ({ suite, workspace }) => {
+    try {
+        const result = await (0, tools_1.handleSuiteUse)(suite, workspace);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool('save-context', 'Save a progress summary to the workspace. Use this to persist important context that should survive /clear or session restarts. The content is saved to CONTEXT.md in the workspace root.', {
+    workspace: wsName.describe('Name of the workspace'),
+    content: zod_1.z.string().describe('The progress summary or context to save (markdown supported)'),
+    append: zod_1.z.boolean().optional().describe('Append to existing context instead of replacing (default: false)'),
+}, async ({ workspace, content, append }) => {
+    try {
+        const result = await (0, tools_1.handleSaveContext)(workspace, content, append);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Unknown error';
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('workspace-manager MCP server started\n');
+}
+main().catch((error) => {
+    process.stderr.write(`MCP server error: ${error}\n`);
+    process.exit(1);
+});