@nemus-cli/nemus 0.2.1

package/dist/commands/delete.js

@@ -0,0 +1,194 @@
+"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.registerDeleteCommand = registerDeleteCommand;
+exports.main = main;
+const fs = __importStar(require("fs/promises"));
+const config_1 = require("../utils/config");
+const path = __importStar(require("path"));
+const workspace_meta_1 = require("../utils/workspace-meta");
+const prompts_1 = require("../utils/prompts");
+const logger_1 = require("../utils/logger");
+const colors_1 = require("../utils/colors");
+const inquirer_1 = __importDefault(require("inquirer"));
+const command_helpers_1 = require("../utils/command-helpers");
+function registerDeleteCommand(parent) {
+    parent
+        .command('delete')
+        .aliases(['d', 'del'])
+        .description('Delete a workspace')
+        .option('-w, --workspace <names>', 'Comma-separated workspace names')
+        .action(async (opts, cmd) => {
+        const globalOpts = (0, command_helpers_1.getGlobalOpts)(cmd);
+        await handleDelete({ ...opts, ...globalOpts });
+    });
+}
+async function handleDelete(opts) {
+    console.log('\n' + '='.repeat(60));
+    console.log((0, colors_1.colorize)('Delete Workspace', 'bright'));
+    console.log('='.repeat(60) + '\n');
+    try {
+        // Non-interactive path: workspace names provided via flag
+        if (opts.workspace) {
+            const selectedNames = (0, command_helpers_1.parseList)(opts.workspace);
+            const workspaces = await (0, workspace_meta_1.listWorkspaces)();
+            for (const name of selectedNames) {
+                const workspace = workspaces.find(ws => ws.name === name);
+                const workspacePath = path.join(config_1.WORKSPACES_DIR, name);
+                if (workspace?.metadata) {
+                    console.log(`${(0, colors_1.colorize)(name, 'cyan')}`);
+                    console.log(`  Repositories: ${workspace.metadata.repositories.length}`);
+                    console.log(`  Path: ${workspacePath}`);
+                }
+                else {
+                    console.log(`${(0, colors_1.colorize)(name, 'cyan')}: ${workspacePath}`);
+                }
+            }
+            console.log('');
+            (0, logger_1.logWarning)('This will permanently delete all cloned repositories in the selected workspaces!');
+            if (!opts.yes) {
+                const { confirmed } = await inquirer_1.default.prompt([
+                    {
+                        type: 'confirm',
+                        name: 'confirmed',
+                        message: selectedNames.length === 1
+                            ? `Delete workspace ${selectedNames[0]}?`
+                            : `Delete these ${selectedNames.length} workspaces?`,
+                        default: true,
+                    },
+                ]);
+                if (!confirmed) {
+                    (0, logger_1.logInfo)('Deletion cancelled');
+                    process.exit(0);
+                }
+            }
+            for (const name of selectedNames) {
+                const workspacePath = path.join(config_1.WORKSPACES_DIR, name);
+                try {
+                    await fs.rm(workspacePath, { recursive: true, force: true });
+                    (0, logger_1.logSuccess)(`Deleted "${(0, colors_1.colorize)(name, 'cyan')}"`);
+                }
+                catch (error) {
+                    (0, logger_1.logError)(`Failed to delete "${name}"`);
+                    if (error instanceof Error)
+                        (0, logger_1.logError)(error.message);
+                }
+            }
+            return;
+        }
+        // Interactive path
+        while (true) {
+            const workspaces = await (0, workspace_meta_1.listWorkspaces)();
+            if (workspaces.length === 0) {
+                (0, logger_1.logInfo)('No more workspaces remaining');
+                break;
+            }
+            const selectedNames = await (0, prompts_1.promptMultiWorkspaceSelection)(workspaces);
+            for (const name of selectedNames) {
+                const workspace = workspaces.find(ws => ws.name === name);
+                const workspacePath = path.join(config_1.WORKSPACES_DIR, name);
+                if (workspace?.metadata) {
+                    console.log(`${(0, colors_1.colorize)(name, 'cyan')}`);
+                    console.log(`  Repositories: ${workspace.metadata.repositories.length}`);
+                    console.log(`  Created: ${new Date(workspace.metadata.createdAt).toLocaleString()}`);
+                    console.log(`  Path: ${workspacePath}`);
+                }
+                else {
+                    console.log(`${(0, colors_1.colorize)(name, 'cyan')}`);
+                    console.log(`  Path: ${workspacePath}`);
+                }
+            }
+            console.log('');
+            (0, logger_1.logWarning)('This will permanently delete all cloned repositories in the selected workspaces!');
+            const confirmMessage = selectedNames.length === 1
+                ? `Delete workspace ${selectedNames[0]}?`
+                : `Delete these ${selectedNames.length} workspaces?`;
+            const { confirmed } = await inquirer_1.default.prompt([
+                {
+                    type: 'confirm',
+                    name: 'confirmed',
+                    message: confirmMessage,
+                    default: true,
+                },
+            ]);
+            if (confirmed) {
+                for (const name of selectedNames) {
+                    const workspacePath = path.join(config_1.WORKSPACES_DIR, name);
+                    try {
+                        await fs.rm(workspacePath, { recursive: true, force: true });
+                        (0, logger_1.logSuccess)(`Deleted "${(0, colors_1.colorize)(name, 'cyan')}"`);
+                    }
+                    catch (error) {
+                        (0, logger_1.logError)(`Failed to delete "${name}"`);
+                        if (error instanceof Error)
+                            (0, logger_1.logError)(error.message);
+                    }
+                }
+            }
+            const remaining = await (0, workspace_meta_1.listWorkspaces)();
+            if (remaining.length === 0) {
+                (0, logger_1.logInfo)('No more workspaces remaining');
+                break;
+            }
+            const { deleteMore } = await inquirer_1.default.prompt([
+                {
+                    type: 'confirm',
+                    name: 'deleteMore',
+                    message: 'Delete more workspaces?',
+                    default: false,
+                },
+            ]);
+            if (!deleteMore) {
+                break;
+            }
+        }
+    }
+    catch (error) {
+        (0, logger_1.logError)('Failed to delete workspace');
+        if (error instanceof Error) {
+            (0, logger_1.logError)(error.message);
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Legacy main() for backward compatibility with tests.
+ */
+async function main() {
+    await handleDelete({ yes: false, forceRefresh: false });
+}

package/dist/commands/deprecated-aliases.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDeprecatedAliases = registerDeprecatedAliases;
+const DEPRECATED_SHORT_ALIASES = [
+    { name: 'sc', target: ['suite', 'create'] },
+    { name: 'sls', target: ['suite', 'list'] },
+    { name: 'sd', target: ['suite', 'delete'] },
+    { name: 'se', target: ['suite', 'export'] },
+    { name: 'si', target: ['suite', 'import'] },
+    { name: 'fs', target: ['suite', 'use'] },
+    { name: 'sb', target: ['branch', 'switch'] },
+    { name: 'bc', target: ['branch', 'create'] },
+    { name: 'bm', target: ['branch', 'merge'] },
+    { name: 'br', target: ['branch', 'rebase'] },
+    { name: 'uc', target: ['cache', 'refresh'] },
+];
+const DEPRECATED_FLAT_COMMANDS = [
+    { name: 'suite-create', target: ['suite', 'create'] },
+    { name: 'suite-list', target: ['suite', 'list'] },
+    { name: 'suite-delete', target: ['suite', 'delete'] },
+    { name: 'suite-export', target: ['suite', 'export'] },
+    { name: 'suite-import', target: ['suite', 'import'] },
+    { name: 'from-suite', target: ['suite', 'use'] },
+    { name: 'switch-branch', target: ['branch', 'switch'] },
+    { name: 'branch-create', target: ['branch', 'create'] },
+    { name: 'branch-merge', target: ['branch', 'merge'] },
+    { name: 'branch-rebase', target: ['branch', 'rebase'] },
+    { name: 'update-cache', target: ['cache', 'refresh'] },
+];
+function registerDeprecatedAliases(program) {
+    const all = [...DEPRECATED_SHORT_ALIASES, ...DEPRECATED_FLAT_COMMANDS];
+    for (const alias of all) {
+        program
+            .command(alias.name, { hidden: true })
+            .allowUnknownOption()
+            .allowExcessArguments()
+            .action(async () => {
+            const [group, sub] = alias.target;
+            process.stderr.write(`[nemus] "w ${alias.name}" is deprecated, use "w ${group} ${sub}" instead\n`);
+            // Re-parse with the correct group + subcommand
+            await program.parseAsync([process.argv[0], process.argv[1], group, sub, ...process.argv.slice(3)]);
+        });
+    }
+}

package/dist/commands/diff.js

@@ -0,0 +1,129 @@
+"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.registerDiffCommand = registerDiffCommand;
+const path = __importStar(require("path"));
+const config_1 = require("../utils/config");
+const workspace_meta_1 = require("../utils/workspace-meta");
+const logger_1 = require("../utils/logger");
+const colors_1 = require("../utils/colors");
+const command_helpers_1 = require("../utils/command-helpers");
+const diff_operations_1 = require("../utils/diff-operations");
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+function registerDiffCommand(parent) {
+    parent
+        .command('diff')
+        .alias('di')
+        .description('Show diff summary across all repos')
+        .argument('[workspace]', 'Workspace name')
+        .option('--full', 'Show full diff output')
+        .action(async (workspace, opts) => {
+        await handleDiff(workspace, opts);
+    });
+}
+async function handleDiff(workspaceArg, opts = {}) {
+    try {
+        const selectedWorkspace = await (0, command_helpers_1.resolveWorkspace)(workspaceArg);
+        const workspacePath = path.join(config_1.WORKSPACES_DIR, selectedWorkspace);
+        const metadata = await (0, workspace_meta_1.loadMetadata)(workspacePath);
+        if (!metadata) {
+            (0, logger_1.logError)(`Workspace metadata not found for: ${selectedWorkspace}`);
+            process.exit(1);
+        }
+        const repos = metadata.repositories.filter(r => r.status === 'success');
+        console.log('\n' + (0, colors_1.colorize)('Workspace Diff Summary', 'bright'));
+        console.log((0, colors_1.colorize)('═'.repeat(40), 'gray') + '\n');
+        const diffs = [];
+        let totalStaged = 0;
+        let totalUnstaged = 0;
+        let reposWithChanges = 0;
+        for (const repo of repos) {
+            const repoPath = path.join(workspacePath, repo.directoryName);
+            const displayName = repo.directoryName !== repo.name
+                ? `${repo.directoryName} (${repo.name})`
+                : repo.name;
+            const diff = await (0, diff_operations_1.getRepoDiff)(repoPath, displayName);
+            diffs.push(diff);
+            if (diff.error) {
+                console.log((0, colors_1.colorize)(diff.repo, 'cyan'));
+                console.log(`  ${(0, colors_1.colorize)('⚠', 'yellow')} ${diff.error}\n`);
+                continue;
+            }
+            const hasChanges = diff.staged.files > 0 || diff.unstaged.files > 0;
+            if (hasChanges) {
+                reposWithChanges++;
+                totalStaged += diff.staged.files;
+                totalUnstaged += diff.unstaged.files;
+                console.log((0, colors_1.colorize)(diff.repo, 'cyan'));
+                if (diff.staged.files > 0) {
+                    console.log(`  Staged:   ${diff.staged.files} file(s), ${(0, colors_1.colorize)(`+${diff.staged.insertions}`, 'green')}, ${(0, colors_1.colorize)(`-${diff.staged.deletions}`, 'red')}`);
+                }
+                if (diff.unstaged.files > 0) {
+                    console.log(`  Unstaged: ${diff.unstaged.files} file(s), ${(0, colors_1.colorize)(`+${diff.unstaged.insertions}`, 'green')}, ${(0, colors_1.colorize)(`-${diff.unstaged.deletions}`, 'red')}`);
+                }
+                console.log('');
+                if (opts.full) {
+                    try {
+                        const { stdout: fullDiff } = await execAsync('git diff', { cwd: path.join(workspacePath, repo.directoryName) });
+                        if (fullDiff.trim()) {
+                            console.log((0, colors_1.colorize)('--- Full diff ---', 'gray'));
+                            console.log(fullDiff);
+                            console.log('');
+                        }
+                    }
+                    catch {
+                        // Ignore errors getting full diff
+                    }
+                }
+            }
+            else {
+                console.log((0, colors_1.colorize)(diff.repo, 'cyan'));
+                console.log(`  ${(0, colors_1.colorize)('✓', 'green')} Clean\n`);
+            }
+        }
+        console.log((0, colors_1.colorize)('═'.repeat(40), 'gray'));
+        console.log(`Total: ${(0, colors_1.colorize)(String(totalStaged), 'green')} staged, ${(0, colors_1.colorize)(String(totalUnstaged), 'yellow')} unstaged across ${reposWithChanges} repo(s)`);
+        console.log('');
+    }
+    catch (error) {
+        (0, logger_1.logError)('Failed to get workspace diff');
+        if (error instanceof Error) {
+            (0, logger_1.logError)(error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/doctor.js

@@ -0,0 +1,141 @@
+"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.registerDoctorCommand = registerDoctorCommand;
+const path = __importStar(require("path"));
+const config_1 = require("../utils/config");
+const workspace_meta_1 = require("../utils/workspace-meta");
+const health_checks_1 = require("../utils/health-checks");
+const logger_1 = require("../utils/logger");
+const colors_1 = require("../utils/colors");
+const command_helpers_1 = require("../utils/command-helpers");
+const displayHealthCheck = (result) => {
+    let statusIcon = '';
+    let statusColor = 'green';
+    switch (result.status) {
+        case 'healthy':
+            statusIcon = '✓';
+            statusColor = 'green';
+            break;
+        case 'warning':
+            statusIcon = '⚠';
+            statusColor = 'yellow';
+            break;
+        case 'error':
+            statusIcon = '✗';
+            statusColor = 'red';
+            break;
+    }
+    console.log(`\n${(0, colors_1.colorize)(statusIcon, statusColor)} ${(0, colors_1.colorize)(result.category, 'bright')}`);
+    console.log(`  ${result.message}`);
+    if (result.details) {
+        console.log(`  ${(0, colors_1.colorize)('Details:', 'gray')} ${result.details}`);
+    }
+    if (result.actionable) {
+        console.log(`  ${(0, colors_1.colorize)('→', 'cyan')} ${result.actionable}`);
+    }
+};
+const displayHealthScore = (score) => {
+    let scoreColor = 'green';
+    let rating = 'Excellent';
+    if (score >= 80) {
+        scoreColor = 'green';
+        rating = 'Excellent';
+    }
+    else if (score >= 60) {
+        scoreColor = 'yellow';
+        rating = 'Good';
+    }
+    else if (score >= 40) {
+        scoreColor = 'yellow';
+        rating = 'Fair';
+    }
+    else {
+        scoreColor = 'red';
+        rating = 'Poor';
+    }
+    console.log('\n' + (0, colors_1.colorize)('═'.repeat(60), 'gray'));
+    console.log(`${(0, colors_1.colorize)('Overall Health Score:', 'bright')} ${(0, colors_1.colorize)(String(score), scoreColor)}/100 (${(0, colors_1.colorize)(rating, scoreColor)})`);
+    console.log((0, colors_1.colorize)('═'.repeat(60), 'gray') + '\n');
+};
+function registerDoctorCommand(parent) {
+    parent
+        .command('doctor')
+        .alias('doc')
+        .description('Run comprehensive health checks')
+        .argument('[workspace]', 'Workspace name')
+        .action(async (workspace) => {
+        await handleDoctor(workspace);
+    });
+}
+async function handleDoctor(workspaceArg) {
+    try {
+        const selectedWorkspace = await (0, command_helpers_1.resolveWorkspace)(workspaceArg);
+        const workspacePath = path.join(config_1.WORKSPACES_DIR, selectedWorkspace);
+        const metadata = await (0, workspace_meta_1.loadMetadata)(workspacePath);
+        if (!metadata) {
+            (0, logger_1.logError)(`Workspace metadata not found for: ${selectedWorkspace}`);
+            process.exit(1);
+        }
+        (0, logger_1.logStep)(`Running health checks for workspace: ${(0, colors_1.colorize)(selectedWorkspace, 'cyan')}`);
+        (0, logger_1.logInfo)('This may take a moment...');
+        const results = await (0, health_checks_1.runAllHealthChecks)(workspacePath, metadata);
+        const score = (0, health_checks_1.calculateHealthScore)(results);
+        console.log('\n' + (0, colors_1.colorize)('Health Check Results', 'bright'));
+        console.log((0, colors_1.colorize)('═'.repeat(60), 'gray'));
+        for (const result of results) {
+            displayHealthCheck(result);
+        }
+        displayHealthScore(score);
+        const hasErrors = results.some(r => r.status === 'error');
+        const hasWarnings = results.some(r => r.status === 'warning');
+        if (hasErrors) {
+            (0, logger_1.logError)('Critical issues detected. Please address error items above.');
+        }
+        else if (hasWarnings) {
+            (0, logger_1.logWarning)('Some warnings detected. Review and address when possible.');
+        }
+        else {
+            (0, logger_1.logSuccess)('All health checks passed! Your workspace is in good shape.');
+        }
+    }
+    catch (error) {
+        (0, logger_1.logError)('Failed to run health checks');
+        if (error instanceof Error) {
+            (0, logger_1.logError)(error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/generate-docs.js

@@ -0,0 +1,77 @@
+"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.registerGenerateDocsCommand = registerGenerateDocsCommand;
+const path = __importStar(require("path"));
+const config_1 = require("../utils/config");
+const workspace_meta_1 = require("../utils/workspace-meta");
+const doc_generator_1 = require("../utils/doc-generator");
+const logger_1 = require("../utils/logger");
+const colors_1 = require("../utils/colors");
+const command_helpers_1 = require("../utils/command-helpers");
+function registerGenerateDocsCommand(parent) {
+    parent
+        .command('generate-docs')
+        .alias('gd')
+        .description('Generate workspace documentation')
+        .argument('[workspace]', 'Workspace name')
+        .action(async (workspace) => {
+        await handleGenerateDocs(workspace);
+    });
+}
+async function handleGenerateDocs(workspaceArg) {
+    try {
+        const workspaceName = await (0, command_helpers_1.resolveWorkspace)(workspaceArg);
+        const workspacePath = path.join(config_1.WORKSPACES_DIR, workspaceName);
+        const metadata = await (0, workspace_meta_1.loadMetadata)(workspacePath);
+        if (!metadata) {
+            (0, logger_1.logError)(`Workspace not found: ${workspaceName}`);
+            process.exit(1);
+        }
+        (0, logger_1.logStep)(`Generating documentation for ${(0, colors_1.colorize)(workspaceName, 'cyan')}...`);
+        await (0, doc_generator_1.writeDocs)(workspacePath, metadata);
+        (0, logger_1.logSuccess)('Documentation generated:');
+        console.log(`  • WORKSPACE-README.md`);
+        console.log(`  • DEPENDENCY-GRAPH.md`);
+        console.log(`  • REPOSITORY-INDEX.md`);
+    }
+    catch (error) {
+        (0, logger_1.logError)('Failed to generate documentation');
+        if (error instanceof Error) {
+            (0, logger_1.logError)(error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/ghq-status.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGhqStatusCommand = registerGhqStatusCommand;
+const ghq_integration_1 = require("../utils/ghq-integration");
+const logger_1 = require("../utils/logger");
+const colors_1 = require("../utils/colors");
+const inquirer_1 = __importDefault(require("inquirer"));
+function registerGhqStatusCommand(parent) {
+    parent
+        .command('ghq-status')
+        .description('Check ghq integration status')
+        .action(async () => {
+        await handleGhqStatus();
+    });
+}
+async function handleGhqStatus() {
+    console.log('\n' + '='.repeat(60));
+    console.log((0, colors_1.colorize)('ghq Integration Status', 'bright'));
+    console.log('='.repeat(60) + '\n');
+    try {
+        const status = await (0, ghq_integration_1.getGhqStatus)();
+        if (status.installed) {
+            (0, logger_1.logSuccess)('ghq is installed and active');
+            console.log('');
+            console.log((0, colors_1.colorize)('Configuration:', 'cyan'));
+            console.log(`  Root directory: ${(0, colors_1.colorize)(status.root || 'unknown', 'gray')}`);
+            console.log(`  Managed repositories: ${(0, colors_1.colorize)(String(status.repoCount || 0), 'yellow')}`);
+            console.log('');
+            if (status.repoCount && status.repoCount > 0) {
+                const { showRepos } = await inquirer_1.default.prompt([{
+                        type: 'confirm', name: 'showRepos',
+                        message: `View all ${status.repoCount} managed repositories?`, default: false,
+                    }]);
+                if (showRepos) {
+                    const repos = await (0, ghq_integration_1.ghqList)();
+                    console.log('');
+                    console.log((0, colors_1.colorize)('Managed Repositories:', 'cyan'));
+                    repos.forEach((repo, index) => { console.log(`  ${index + 1}. ${repo}`); });
+                    console.log('');
+                }
+            }
+        }
+        else {
+            (0, logger_1.logWarning)('ghq is not installed');
+            console.log('');
+            console.log('The workspace manager will use direct git clones.');
+            const { showInfo } = await inquirer_1.default.prompt([{
+                    type: 'confirm', name: 'showInfo',
+                    message: 'Show ghq installation information?', default: true,
+                }]);
+            if (showInfo) {
+                (0, ghq_integration_1.displayGhqInfo)();
+            }
+        }
+        console.log((0, colors_1.colorize)('Workspace Manager Behavior:', 'cyan'));
+        console.log('  • Auto-detects ghq installation');
+        console.log('  • Uses ghq when available');
+        console.log('  • Falls back to git clone if needed');
+        console.log('  • Always maintains workspace isolation');
+        console.log('');
+    }
+    catch (error) {
+        (0, logger_1.logError)('Failed to check ghq status');
+        if (error instanceof Error) {
+            (0, logger_1.logError)(error.message);
+        }
+        process.exit(1);
+    }
+}