@nemus-cli/nemus 0.2.1

package/dist/utils/pi-extensions.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * Pi extension management — install/uninstall Pi extensions that replicate
+ * Claude Code hooks and MCP functionality.
+ *
+ * Pi uses TypeScript extensions instead of:
+ *   - settings.json hooks (Stop, SessionStart, PostToolUse)
+ *   - .mcp.json / `claude mcp add` (MCP servers)
+ *
+ * This module generates and installs extensions from bundled templates.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installPiExtensions = installPiExtensions;
+exports.uninstallPiExtensions = uninstallPiExtensions;
+exports.getPiExtensionStatus = getPiExtensionStatus;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const logger_1 = require("./logger");
+const PI_EXTENSIONS_DIR = path.join(os.homedir(), '.pi', 'agent', 'extensions');
+/** Marker comment that identifies workspace-manager managed extensions */
+const MANAGED_MARKER = '(auto-generated by workspace-manager)';
+function getTemplatesDir() {
+    // When compiled: dist/utils/ -> dist/pi-extensions/
+    const distPath = path.resolve(__dirname, '..', 'pi-extensions');
+    // When running from source: src/utils/ -> src/pi-extensions/
+    const srcPath = path.resolve(__dirname, '..', '..', 'src', 'pi-extensions');
+    if (fs.existsSync(distPath))
+        return distPath;
+    if (fs.existsSync(srcPath))
+        return srcPath;
+    throw new Error('Could not find pi-extensions/ directory.');
+}
+function getSyncPermissionsScript() {
+    const scriptPath = path.resolve(__dirname, '..', '..', 'sync-permissions.sh');
+    if (fs.existsSync(scriptPath))
+        return scriptPath;
+    throw new Error('Could not find sync-permissions.sh');
+}
+function getExtensionTemplates(options = {}) {
+    let syncScript;
+    try {
+        syncScript = getSyncPermissionsScript();
+    }
+    catch {
+        (0, logger_1.logWarning)('Could not locate sync-permissions.sh — permission-sync extension will need manual path configuration');
+        syncScript = ''; // Empty placeholder — user must configure manually
+    }
+    const templates = [
+        {
+            templateFile: 'permission-sync.ts.template',
+            installedName: 'ws-permission-sync.ts',
+            replacements: syncScript ? { '__SYNC_PERMISSIONS_SCRIPT__': syncScript } : {},
+        },
+        {
+            templateFile: 'review-reminder.ts.template',
+            installedName: 'ws-review-reminder.ts',
+        },
+        {
+            templateFile: 'permissions-gate.ts.template',
+            installedName: 'ws-permissions-gate.ts',
+        },
+        {
+            templateFile: 'pr-fix-trigger.ts.template',
+            installedName: 'ws-pr-fix-trigger.ts',
+        },
+    ];
+    // Workspace input-status widget — enabled by default, opt-out via config
+    if (options.workspaceInputStatus !== false) {
+        templates.push({
+            templateFile: 'workspace-input-status.ts.template',
+            installedName: 'ws-workspace-input-status.ts',
+        });
+    }
+    return templates;
+}
+/**
+ * Install all workspace-manager Pi extensions.
+ * Idempotent — overwrites existing managed extensions with latest templates.
+ *
+ * @param extensionsDir Override the extensions directory (for testing).
+ */
+function installPiExtensions(extensionsDir, options = {}) {
+    const targetDir = extensionsDir ?? PI_EXTENSIONS_DIR;
+    let templatesDir;
+    try {
+        templatesDir = getTemplatesDir();
+    }
+    catch {
+        (0, logger_1.logWarning)('Could not find Pi extension templates — skipping');
+        return;
+    }
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    const templates = getExtensionTemplates(options);
+    let installed = 0;
+    for (const tpl of templates) {
+        const templatePath = path.join(templatesDir, tpl.templateFile);
+        if (!fs.existsSync(templatePath)) {
+            (0, logger_1.logWarning)(`Template not found: ${tpl.templateFile} — skipping`);
+            continue;
+        }
+        let content = fs.readFileSync(templatePath, 'utf-8');
+        // Apply replacements
+        if (tpl.replacements) {
+            for (const [placeholder, value] of Object.entries(tpl.replacements)) {
+                content = content.replace(new RegExp(escapeRegex(placeholder), 'g'), value);
+            }
+        }
+        const targetPath = path.join(targetDir, tpl.installedName);
+        fs.writeFileSync(targetPath, content, 'utf-8');
+        installed++;
+    }
+    if (installed > 0) {
+        (0, logger_1.logSuccess)(`Installed ${installed} Pi extension(s) in ${targetDir}`);
+    }
+}
+/**
+ * Uninstall workspace-manager managed Pi extensions.
+ * Only removes extensions that contain the managed marker or match
+ * known installed names.
+ *
+ * @param extensionsDir Override the extensions directory (for testing).
+ */
+/**
+ * Uninstall workspace-manager managed Pi extensions.
+ * Pass `onlyNames` to remove only specific extension files (for opt-out).
+ *
+ * @param extensionsDir Override the extensions directory (for testing).
+ * @param options.onlyNames If set, only remove files in this list.
+ */
+function uninstallPiExtensions(extensionsDir, options) {
+    const targetDir = extensionsDir ?? PI_EXTENSIONS_DIR;
+    if (!fs.existsSync(targetDir))
+        return;
+    const templates = getExtensionTemplates({ workspaceInputStatus: true });
+    const knownNames = new Set(templates.map(t => t.installedName));
+    const onlyNames = options?.onlyNames ? new Set(options.onlyNames) : null;
+    let removed = 0;
+    for (const file of fs.readdirSync(targetDir)) {
+        if (!file.endsWith('.ts'))
+            continue;
+        // When onlyNames is set, skip files not in that list
+        if (onlyNames && !onlyNames.has(file))
+            continue;
+        const filePath = path.join(targetDir, file);
+        // Remove if it matches a known managed name
+        if (knownNames.has(file)) {
+            fs.unlinkSync(filePath);
+            removed++;
+            continue;
+        }
+        // Also remove if it contains the managed marker (for renamed files)
+        if (!onlyNames) {
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                if (content.includes(MANAGED_MARKER)) {
+                    fs.unlinkSync(filePath);
+                    removed++;
+                }
+            }
+            catch { /* ignore read errors */ }
+        }
+    }
+    if (removed > 0) {
+        (0, logger_1.logSuccess)(`Removed ${removed} Pi extension(s) from ${targetDir}`);
+    }
+}
+/**
+ * Check which managed Pi extensions are installed.
+ */
+function getPiExtensionStatus(extensionsDir) {
+    const targetDir = extensionsDir ?? PI_EXTENSIONS_DIR;
+    const templates = getExtensionTemplates({ workspaceInputStatus: true });
+    const installed = [];
+    const missing = [];
+    for (const tpl of templates) {
+        const targetPath = path.join(targetDir, tpl.installedName);
+        if (fs.existsSync(targetPath)) {
+            installed.push(tpl.installedName);
+        }
+        else {
+            missing.push(tpl.installedName);
+        }
+    }
+    return { installed, missing };
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

package/dist/utils/progress.js

@@ -0,0 +1,92 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSimpleProgressBar = exports.ProgressTracker = void 0;
+const cliProgress = __importStar(require("cli-progress"));
+class ProgressTracker {
+    constructor() {
+        this.multibar = new cliProgress.MultiBar({
+            clearOnComplete: false,
+            hideCursor: true,
+            format: ' {bar} | {percentage}% | {value}/{total} | {task} | {duration}',
+        }, cliProgress.Presets.shades_classic);
+        this.bars = new Map();
+        this.startTimes = new Map();
+    }
+    addTask(taskId, total, taskName) {
+        const bar = this.multibar.create(total, 0, { task: taskName, duration: '0s' });
+        this.bars.set(taskId, bar);
+        this.startTimes.set(taskId, Date.now());
+    }
+    updateTask(taskId, current, taskName) {
+        const bar = this.bars.get(taskId);
+        const startTime = this.startTimes.get(taskId);
+        if (bar && startTime) {
+            const elapsed = Math.floor((Date.now() - startTime) / 1000);
+            const duration = this.formatDuration(elapsed);
+            bar.update(current, {
+                task: taskName || 'Processing',
+                duration,
+            });
+        }
+    }
+    completeTask(taskId) {
+        const bar = this.bars.get(taskId);
+        if (bar) {
+            bar.stop();
+            this.bars.delete(taskId);
+            this.startTimes.delete(taskId);
+        }
+    }
+    stop() {
+        this.multibar.stop();
+    }
+    formatDuration(seconds) {
+        if (seconds < 60) {
+            return `${seconds}s`;
+        }
+        const minutes = Math.floor(seconds / 60);
+        const remainingSeconds = seconds % 60;
+        return `${minutes}m ${remainingSeconds}s`;
+    }
+}
+exports.ProgressTracker = ProgressTracker;
+const createSimpleProgressBar = (total, taskName) => {
+    return new cliProgress.SingleBar({
+        format: ` ${taskName} | {bar} | {percentage}% | {value}/{total} | {duration}`,
+        hideCursor: true,
+    }, cliProgress.Presets.shades_classic);
+};
+exports.createSimpleProgressBar = createSimpleProgressBar;

package/dist/utils/prompts.js

@@ -0,0 +1,279 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptMultiWorkspaceSelection = exports.promptWorkspaceSelection = exports.confirmWorkspaceCreation = exports.promptWorkspaceName = exports.promptRepositorySelection = exports.promptInstanceSuffix = void 0;
+const inquirer_1 = __importDefault(require("inquirer"));
+const inquirer_autocomplete_prompt_1 = __importDefault(require("inquirer-autocomplete-prompt"));
+const fuzzy = __importStar(require("fuzzy"));
+const validation_1 = require("./validation");
+const colors_1 = require("./colors");
+// Register autocomplete prompt type
+inquirer_1.default.registerPrompt('autocomplete', inquirer_autocomplete_prompt_1.default);
+const promptInstanceSuffix = async (repoName, existingDirectoryNames) => {
+    const { suffix } = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'suffix',
+            message: `"${repoName}" already exists. Enter a suffix for this instance:`,
+            validate: (input) => {
+                if (!input || input.trim().length === 0) {
+                    return 'Suffix cannot be empty';
+                }
+                const trimmed = input.trim();
+                // Validate characters (alphanumeric, hyphens, underscores)
+                if (!/^[a-zA-Z0-9_-]+$/.test(trimmed)) {
+                    return 'Suffix can only contain letters, numbers, hyphens, and underscores';
+                }
+                const candidateName = `${repoName}-${trimmed}`;
+                if (existingDirectoryNames.includes(candidateName)) {
+                    return `"${candidateName}" already exists. Choose a different suffix`;
+                }
+                return true;
+            },
+        },
+    ]);
+    return suffix.trim();
+};
+exports.promptInstanceSuffix = promptInstanceSuffix;
+const promptRepositorySelection = async (repos, existingDirectoryNames = []) => {
+    const selectedEntries = [];
+    const repoMap = new Map(repos.map(repo => [repo.name, repo]));
+    // Track all directory names (existing + newly selected) for collision detection
+    const allDirectoryNames = [...existingDirectoryNames];
+    console.log('\n' + (0, colors_1.colorize)('Repository Selection', 'bright'));
+    console.log('Type to search repositories. Use arrow keys to navigate, Enter to select.');
+    console.log('Type "done" when finished selecting repositories.\n');
+    while (true) {
+        try {
+            const { repoName } = await inquirer_1.default.prompt([
+                {
+                    type: 'autocomplete',
+                    name: 'repoName',
+                    message: `Search and select repository (${(0, colors_1.colorize)(String(selectedEntries.length), 'cyan')} selected):`,
+                    source: async (_answersSoFar, input) => {
+                        const searchInput = input || '';
+                        // Always include done option
+                        const doneOption = { name: (0, colors_1.colorize)('done - Finish selection', 'green'), value: 'done' };
+                        // If no input or "done" typed, show done + top repos
+                        if (!searchInput || searchInput.toLowerCase().startsWith('done')) {
+                            return [
+                                doneOption,
+                                ...repos.slice(0, 15).map(repo => ({
+                                    name: `${repo.name}${repo.description ? ` - ${(0, colors_1.colorize)(repo.description, 'gray')}` : ''}`,
+                                    value: repo.name,
+                                }))
+                            ];
+                        }
+                        // Perform fuzzy search
+                        const results = fuzzy.filter(searchInput, repos, {
+                            extract: (repo) => `${repo.name} ${repo.description || ''}`,
+                        });
+                        const suggestions = results.slice(0, 15).map(result => ({
+                            name: `${result.original.name}${result.original.description ? ` - ${(0, colors_1.colorize)(result.original.description, 'gray')}` : ''}`,
+                            value: result.original.name,
+                        }));
+                        return [doneOption, ...suggestions];
+                    },
+                    pageSize: 16,
+                },
+            ]);
+            if (repoName === 'done') {
+                if (selectedEntries.length === 0) {
+                    console.log((0, colors_1.colorize)('\nYou must select at least one repository\n', 'yellow'));
+                    continue;
+                }
+                break;
+            }
+            const repo = repoMap.get(repoName);
+            if (!repo)
+                continue;
+            let directoryName = repo.name;
+            // Check if this directory name already exists (in workspace or in current selection)
+            if (allDirectoryNames.includes(directoryName)) {
+                const suffix = await (0, exports.promptInstanceSuffix)(repo.name, allDirectoryNames);
+                directoryName = `${repo.name}-${suffix}`;
+            }
+            selectedEntries.push({ repo, directoryName });
+            allDirectoryNames.push(directoryName);
+            const displayName = directoryName !== repo.name
+                ? `${directoryName} (${repo.name})`
+                : repo.name;
+            console.log((0, colors_1.colorize)(`Added: ${displayName}`, 'green'));
+        }
+        catch (error) {
+            // Handle Ctrl+C
+            console.log('\n');
+            process.exit(0);
+        }
+    }
+    console.log(`\n${(0, colors_1.colorize)(`Selected ${selectedEntries.length} repositories:`, 'cyan')}`);
+    selectedEntries.forEach(entry => {
+        const displayName = entry.directoryName !== entry.repo.name
+            ? `${entry.directoryName} (${entry.repo.name})`
+            : entry.repo.name;
+        console.log(`  - ${displayName}`);
+    });
+    console.log('');
+    return selectedEntries;
+};
+exports.promptRepositorySelection = promptRepositorySelection;
+const promptWorkspaceName = async () => {
+    const { workspaceName } = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'workspaceName',
+            message: 'Enter workspace name:',
+            validate: (input) => {
+                const validationResult = (0, validation_1.validateWorkspaceName)(input);
+                if (validationResult !== true) {
+                    return validationResult;
+                }
+                return true;
+            },
+            filter: (input) => (0, validation_1.sanitizeWorkspaceName)(input),
+        },
+    ]);
+    return workspaceName;
+};
+exports.promptWorkspaceName = promptWorkspaceName;
+const confirmWorkspaceCreation = async (workspaceName, repoCount, workspacePath) => {
+    console.log('\n' + '='.repeat(60));
+    console.log('Workspace Configuration');
+    console.log('='.repeat(60));
+    console.log(`Name: ${(0, colors_1.colorize)(workspaceName, 'cyan')}`);
+    console.log(`Location: ${(0, colors_1.colorize)(workspacePath, 'gray')}`);
+    console.log(`Repositories: ${(0, colors_1.colorize)(String(repoCount), 'yellow')}`);
+    console.log('='.repeat(60) + '\n');
+    const { confirmed } = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'confirmed',
+            message: 'Create workspace with these settings?',
+            default: true,
+        },
+    ]);
+    return confirmed;
+};
+exports.confirmWorkspaceCreation = confirmWorkspaceCreation;
+const promptWorkspaceSelection = async (workspaces) => {
+    if (workspaces.length === 0) {
+        throw new Error('No workspaces found. Create one first with: workspace create');
+    }
+    const choices = workspaces.map(ws => ({
+        name: ws.metadata
+            ? `${ws.name} (${ws.metadata.repositories.length} repos)`
+            : ws.name,
+        value: ws.name,
+        short: ws.name,
+    }));
+    const { workspaceName } = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'workspaceName',
+            message: 'Select workspace to update:',
+            choices,
+            pageSize: 15,
+        },
+    ]);
+    return workspaceName;
+};
+exports.promptWorkspaceSelection = promptWorkspaceSelection;
+const promptMultiWorkspaceSelection = async (workspaces) => {
+    const selectedNames = [];
+    const workspaceNames = workspaces.map(ws => ws.name);
+    console.log('\n' + (0, colors_1.colorize)('Workspace Selection', 'bright'));
+    console.log('Type to search workspaces. Use arrow keys to navigate, Enter to select.');
+    console.log('Type "done" when finished selecting workspaces.\n');
+    while (true) {
+        try {
+            const availableNames = workspaceNames.filter(name => !selectedNames.includes(name));
+            if (availableNames.length === 0) {
+                console.log((0, colors_1.colorize)('All workspaces selected.', 'yellow'));
+                break;
+            }
+            const { workspaceName } = await inquirer_1.default.prompt([
+                {
+                    type: 'autocomplete',
+                    name: 'workspaceName',
+                    message: `Search and select workspace (${(0, colors_1.colorize)(String(selectedNames.length), 'cyan')} selected):`,
+                    source: async (_answersSoFar, input) => {
+                        const searchInput = input || '';
+                        const doneOption = { name: (0, colors_1.colorize)('done - Finish selection', 'green'), value: 'done' };
+                        if (!searchInput || searchInput.toLowerCase().startsWith('done')) {
+                            return [
+                                doneOption,
+                                ...availableNames.slice(0, 15).map(name => ({
+                                    name,
+                                    value: name,
+                                }))
+                            ];
+                        }
+                        const results = fuzzy.filter(searchInput, availableNames);
+                        const suggestions = results.slice(0, 15).map(result => ({
+                            name: result.original,
+                            value: result.original,
+                        }));
+                        return [doneOption, ...suggestions];
+                    },
+                    pageSize: 16,
+                },
+            ]);
+            if (workspaceName === 'done') {
+                if (selectedNames.length === 0) {
+                    console.log((0, colors_1.colorize)('\nYou must select at least one workspace\n', 'yellow'));
+                    continue;
+                }
+                break;
+            }
+            selectedNames.push(workspaceName);
+            console.log((0, colors_1.colorize)(`Added: ${workspaceName}`, 'green'));
+        }
+        catch (error) {
+            // Handle Ctrl+C
+            console.log('\n');
+            process.exit(0);
+        }
+    }
+    console.log(`\n${(0, colors_1.colorize)(`Selected ${selectedNames.length} workspace${selectedNames.length === 1 ? '' : 's'}:`, 'cyan')}`);
+    selectedNames.forEach(name => {
+        console.log(`  - ${name}`);
+    });
+    console.log('');
+    return selectedNames;
+};
+exports.promptMultiWorkspaceSelection = promptMultiWorkspaceSelection;