@uxmaltech/collab-cli 0.1.0

package/dist/commands/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommands = registerCommands;
+const canon_1 = require("./canon");
+const compose_1 = require("./compose");
+const doctor_1 = require("./doctor");
+const infra_1 = require("./infra");
+const init_1 = require("./init");
+const mcp_1 = require("./mcp");
+const seed_1 = require("./seed");
+const up_1 = require("./up");
+const uninstall_1 = require("./uninstall");
+const update_canons_1 = require("./update-canons");
+const upgrade_1 = require("./upgrade");
+function registerCommands(program) {
+    (0, init_1.registerInitCommand)(program);
+    (0, canon_1.registerCanonCommand)(program);
+    (0, compose_1.registerComposeCommand)(program);
+    (0, infra_1.registerInfraCommand)(program);
+    (0, mcp_1.registerMcpCommand)(program);
+    (0, up_1.registerUpCommand)(program);
+    (0, seed_1.registerSeedCommand)(program);
+    (0, doctor_1.registerDoctorCommand)(program);
+    (0, update_canons_1.registerUpdateCanonsCommand)(program);
+    (0, upgrade_1.registerUpgradeCommand)(program);
+    (0, uninstall_1.registerUninstallCommand)(program);
+}

package/dist/commands/infra/down.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInfraDownCommand = registerInfraDownCommand;
+const command_context_1 = require("../../lib/command-context");
+const shared_1 = require("./shared");
+function registerInfraDownCommand(program) {
+    program
+        .command('down')
+        .description('Stop infrastructure services (Qdrant + Nebula)')
+        .option('--file <path>', 'Compose file to use')
+        .option('--output-dir <directory>', 'Directory used to locate generated compose files')
+        .addHelpText('after', `
+Examples:
+  collab infra down
+  collab infra down --file docker-compose.yml
+`)
+        .action(async (options, command) => {
+        const context = (0, command_context_1.createCommandContext)(command);
+        const selection = (0, shared_1.resolveInfraComposeFile)(context.config, options.outputDir, options.file);
+        await (0, shared_1.runInfraCompose)(context.logger, context.executor, context.config, selection, 'stop');
+        context.logger.result(`Infrastructure stopped using ${selection.filePath}`);
+    });
+}

package/dist/commands/infra/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInfraCommand = registerInfraCommand;
+const down_1 = require("./down");
+const status_1 = require("./status");
+const up_1 = require("./up");
+function registerInfraCommand(program) {
+    const infra = program
+        .command('infra')
+        .description('Manage infrastructure services used by collab')
+        .addHelpText('after', `
+Examples:
+  collab infra up
+  collab infra down
+  collab infra status
+`);
+    (0, up_1.registerInfraUpCommand)(infra);
+    (0, down_1.registerInfraDownCommand)(infra);
+    (0, status_1.registerInfraStatusCommand)(infra);
+}

package/dist/commands/infra/shared.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INFRA_SERVICES = void 0;
+exports.resolveInfraComposeFile = resolveInfraComposeFile;
+exports.runInfraCompose = runInfraCompose;
+const node_path_1 = __importDefault(require("node:path"));
+const compose_paths_1 = require("../../lib/compose-paths");
+const docker_compose_1 = require("../../lib/docker-compose");
+const errors_1 = require("../../lib/errors");
+const preconditions_1 = require("../../lib/preconditions");
+const service_health_1 = require("../../lib/service-health");
+exports.INFRA_SERVICES = ['qdrant', 'metad0', 'storaged0', 'graphd'];
+/**
+ * Resolves the compose file to use for infrastructure services.
+ * Prefers an explicit `--file` flag, then falls back to compose-paths resolution.
+ */
+function resolveInfraComposeFile(config, outputDirectory, explicitFile) {
+    if (explicitFile) {
+        const filePath = node_path_1.default.resolve(config.workspaceDir, explicitFile);
+        return { filePath, source: 'split' };
+    }
+    const paths = (0, compose_paths_1.getComposeFilePaths)(config, outputDirectory);
+    const selected = (0, compose_paths_1.selectInfraComposeFile)(paths);
+    return {
+        filePath: selected.file,
+        source: selected.source,
+    };
+}
+/**
+ * Runs a docker compose action for infrastructure services (Qdrant, NebulaGraph).
+ * When the action is `'up'`, waits for health checks to pass.
+ */
+async function runInfraCompose(logger, executor, config, selection, action, options = {}) {
+    (0, preconditions_1.ensureCommandAvailable)('docker', { dryRun: executor.dryRun });
+    if (!executor.dryRun) {
+        (0, preconditions_1.ensureFileExists)(selection.filePath, 'Compose file');
+    }
+    const args = action === 'up' ? ['up', '-d'] : action === 'stop' ? ['stop'] : ['ps'];
+    const services = selection.source === 'consolidated' ? [...exports.INFRA_SERVICES] : [];
+    (0, docker_compose_1.runDockerCompose)({
+        executor,
+        files: [selection.filePath],
+        arguments: [...args, ...services],
+        cwd: config.workspaceDir,
+        projectName: config.compose.projectName,
+    });
+    if (action !== 'up') {
+        return;
+    }
+    const env = (0, service_health_1.loadRuntimeEnv)(config);
+    const health = await (0, service_health_1.waitForInfraHealth)(env, (0, service_health_1.dryRunHealthOptions)(executor, options.health ?? {}));
+    (0, service_health_1.logServiceHealth)(logger, 'infra health', health);
+    if (!health.ok) {
+        throw new errors_1.CliError('Infrastructure services did not become healthy in time.');
+    }
+}

package/dist/commands/infra/status.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInfraStatusCommand = registerInfraStatusCommand;
+const command_context_1 = require("../../lib/command-context");
+const docker_compose_1 = require("../../lib/docker-compose");
+const docker_status_1 = require("../../lib/docker-status");
+const health_checker_1 = require("../../lib/health-checker");
+const preconditions_1 = require("../../lib/preconditions");
+const service_health_1 = require("../../lib/service-health");
+const shared_1 = require("./shared");
+/** Fast health check options for status display (no retries). */
+const QUICK_HEALTH_OPTIONS = { timeoutMs: 2_000, retries: 1, retryDelayMs: 0 };
+function registerInfraStatusCommand(program) {
+    program
+        .command('status')
+        .description('Show infrastructure service status')
+        .option('--file <path>', 'Compose file to use')
+        .option('--output-dir <directory>', 'Directory used to locate generated compose files')
+        .addHelpText('after', `
+Examples:
+  collab infra status
+  collab infra status --file docker-compose.infra.yml
+`)
+        .action(async (options, command) => {
+        const context = (0, command_context_1.createCommandContext)(command);
+        const selection = (0, shared_1.resolveInfraComposeFile)(context.config, options.outputDir, options.file);
+        (0, preconditions_1.ensureCommandAvailable)('docker', { dryRun: context.executor.dryRun });
+        if (!context.executor.dryRun) {
+            (0, preconditions_1.ensureFileExists)(selection.filePath, 'Compose file');
+        }
+        // Query container status via docker compose ps --format json
+        const serviceScope = selection.source === 'consolidated' ? [...shared_1.INFRA_SERVICES] : [];
+        let containers = [];
+        try {
+            const result = (0, docker_compose_1.runDockerCompose)({
+                executor: context.executor,
+                files: [selection.filePath],
+                arguments: ['ps', '--format', 'json', ...serviceScope],
+                cwd: context.config.workspaceDir,
+                projectName: context.config.compose.projectName,
+                check: false,
+            });
+            containers = (0, docker_status_1.parseComposePs)(result.stdout);
+        }
+        catch {
+            // docker compose ps failed — treat as no running containers
+        }
+        // Run quick health checks (skip in dry-run mode)
+        const env = (0, service_health_1.loadRuntimeEnv)(context.config);
+        const qdrantHost = env['QDRANT_HOST'] || '127.0.0.1';
+        const qdrantPort = Number(env['QDRANT_PORT']) || 6333;
+        const nebulaHost = env['NEBULA_HOST'] || '127.0.0.1';
+        const nebulaPort = Number(env['NEBULA_GRAPHD_PORT']) || 9669;
+        const healthChecks = context.executor.dryRun
+            ? []
+            : await Promise.all([
+                (0, health_checker_1.checkHttpHealth)('qdrant', `http://${qdrantHost}:${qdrantPort}/collections`, QUICK_HEALTH_OPTIONS),
+                (0, health_checker_1.checkTcpHealth)('graphd', nebulaHost, nebulaPort, QUICK_HEALTH_OPTIONS),
+            ]);
+        // Build and display status table
+        const services = (0, docker_status_1.buildServiceStatusList)([...shared_1.INFRA_SERVICES], containers, healthChecks);
+        (0, docker_status_1.printStatusTable)(context.logger, 'Infrastructure Services', services, selection.filePath);
+    });
+}

package/dist/commands/infra/up.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInfraUpCommand = registerInfraUpCommand;
+const command_context_1 = require("../../lib/command-context");
+const parsers_1 = require("../../lib/parsers");
+const shared_1 = require("./shared");
+function registerInfraUpCommand(program) {
+    program
+        .command('up')
+        .description('Start infrastructure services (Qdrant + Nebula) and wait for health')
+        .option('--file <path>', 'Compose file to use')
+        .option('--output-dir <directory>', 'Directory used to locate generated compose files')
+        .option('--timeout-ms <ms>', 'Per-check timeout in milliseconds', '5000')
+        .option('--retries <count>', 'Health check retries', '15')
+        .option('--retry-delay-ms <ms>', 'Delay between retries in milliseconds', '2000')
+        .addHelpText('after', `
+Examples:
+  collab infra up
+  collab infra up --file docker-compose.infra.yml --timeout-ms 3000 --retries 20
+`)
+        .action(async (options, command) => {
+        const context = (0, command_context_1.createCommandContext)(command);
+        const selection = (0, shared_1.resolveInfraComposeFile)(context.config, options.outputDir, options.file);
+        await (0, shared_1.runInfraCompose)(context.logger, context.executor, context.config, selection, 'up', {
+            health: (0, parsers_1.parseHealthOptions)(options),
+        });
+        context.logger.result(`Infrastructure started using ${selection.filePath}`);
+    });
+}