ctx-sync 1.0.0

package/dist/commands/docker.js

@@ -0,0 +1,380 @@
+/**
+ * `ctx-sync docker` command group.
+ *
+ * Manages Docker container state for tracked projects:
+ *   - `docker track <project>` — detect and save Docker Compose state.
+ *   - `docker start <project>` — show Docker commands for approval, then execute.
+ *   - `docker stop <project>` — stop tracked services.
+ *   - `docker status [project]` — show running / tracked services.
+ *
+ * **Security:** `docker start` commands go through the command validator.
+ * All start commands require explicit user confirmation — there is no
+ * `--yes` or `--no-confirm` bypass.
+ *
+ * @module commands/docker
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+import { withErrorHandler } from '../utils/errors.js';
+import { STATE_FILES } from '@ctx-sync/shared';
+import { identityToRecipient } from 'age-encryption';
+import { loadKey } from '../core/key-store.js';
+import { readState } from '../core/state-manager.js';
+import { commitState } from '../core/git-sync.js';
+import { formatCommandsForDisplay, presentCommandsForApproval, } from '../core/command-validator.js';
+import { detectDockerCompose, buildDockerStateEntry, saveDockerState, loadDockerState, loadAllDockerState, isDockerAvailable, } from '../core/docker-handler.js';
+import { getConfigDir, getSyncDir } from './init.js';
+// ─── Track Logic ──────────────────────────────────────────────────────────
+/**
+ * Execute Docker track: detect and save Docker Compose state.
+ *
+ * @param options - Track options.
+ * @returns Track result.
+ */
+export async function executeDockerTrack(options = {}) {
+    const projectDir = options.path ?? process.cwd();
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    // Verify sync dir exists
+    if (!fs.existsSync(syncDir) || !fs.existsSync(path.join(syncDir, '.git'))) {
+        throw new Error('No sync repository found. Run `ctx-sync init` first.');
+    }
+    // Load key
+    const privateKey = loadKey(configDir);
+    const publicKey = await identityToRecipient(privateKey);
+    // Determine project name
+    let projectName = options.project;
+    if (!projectName) {
+        // Try to find from tracked projects
+        const state = await readState(syncDir, privateKey, 'state');
+        const matchingProject = state?.projects.find((p) => p.path === path.resolve(projectDir));
+        projectName = matchingProject?.name ?? path.basename(path.resolve(projectDir));
+    }
+    // Detect compose file
+    const compose = detectDockerCompose(projectDir);
+    if (!compose.found || !compose.filePath) {
+        throw new Error(`No Docker Compose file found in ${projectDir}.\n` +
+            'Expected: docker-compose.yml, docker-compose.yaml, compose.yml, or compose.yaml');
+    }
+    // Build and save Docker state
+    const entry = buildDockerStateEntry(projectName, projectDir);
+    if (!entry) {
+        throw new Error('Failed to parse Docker Compose file.');
+    }
+    await saveDockerState(syncDir, projectName, entry, publicKey, privateKey);
+    // Commit if requested
+    if (!options.noSync) {
+        await commitState(syncDir, [STATE_FILES.DOCKER_STATE, STATE_FILES.MANIFEST], `feat: track Docker services for ${projectName}`);
+    }
+    return {
+        projectName,
+        serviceCount: entry.services.length,
+        serviceNames: entry.services.map((s) => s.name),
+        composeFile: compose.filePath,
+        networks: entry.networks ?? [],
+    };
+}
+// ─── Start Logic ──────────────────────────────────────────────────────────
+/**
+ * Build pending commands from tracked Docker services.
+ *
+ * @param projectName - The project name.
+ * @param projectDocker - The Docker state for the project.
+ * @returns List of pending commands for approval.
+ */
+export function buildDockerStartCommands(projectName, projectDocker) {
+    const commands = [];
+    for (const service of projectDocker.services) {
+        if (service.autoStart) {
+            commands.push({
+                command: `docker compose up -d ${service.name}`,
+                label: '🐳 Docker services',
+                port: service.port > 0 ? service.port : undefined,
+                image: service.image || undefined,
+                cwd: projectDocker.composeFile
+                    ? path.dirname(projectDocker.composeFile)
+                    : undefined,
+            });
+        }
+    }
+    return commands;
+}
+/**
+ * Execute Docker start: show Docker commands for approval and execute.
+ *
+ * @param projectName - The project name.
+ * @param options - Start options.
+ * @returns Start result.
+ */
+export async function executeDockerStart(projectName, options = {}) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    if (!fs.existsSync(syncDir) || !fs.existsSync(path.join(syncDir, '.git'))) {
+        throw new Error('No sync repository found. Run `ctx-sync init` first.');
+    }
+    const privateKey = loadKey(configDir);
+    // Load Docker state for the project
+    const projectDocker = await loadDockerState(syncDir, projectName, privateKey);
+    if (!projectDocker) {
+        throw new Error(`No Docker state found for project "${projectName}".\n` +
+            'Run `ctx-sync docker track` in the project directory first.');
+    }
+    // Build commands
+    const commandsPresented = buildDockerStartCommands(projectName, projectDocker);
+    if (commandsPresented.length === 0) {
+        return {
+            projectName,
+            commandsPresented: [],
+            approval: { approved: [], rejected: [], skippedAll: false },
+            executedCommands: [],
+            failedCommands: [],
+        };
+    }
+    // Present for approval
+    const approval = await presentCommandsForApproval(commandsPresented, {
+        interactive: !options.noInteractive,
+        promptFn: options.promptFn,
+        selectFn: options.selectFn,
+    });
+    // Execute approved commands
+    const executedCommands = [];
+    const failedCommands = [];
+    for (const cmd of approval.approved) {
+        try {
+            execSync(cmd.command, {
+                cwd: cmd.cwd ?? process.cwd(),
+                stdio: 'pipe',
+                timeout: 60000,
+            });
+            executedCommands.push(cmd.command);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            failedCommands.push({ command: cmd.command, error: message });
+        }
+    }
+    return {
+        projectName,
+        commandsPresented,
+        approval,
+        executedCommands,
+        failedCommands,
+    };
+}
+// ─── Stop Logic ───────────────────────────────────────────────────────────
+/**
+ * Execute Docker stop: stop all tracked services for a project.
+ *
+ * @param projectName - The project name.
+ * @returns Stop result.
+ */
+export async function executeDockerStop(projectName) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    if (!fs.existsSync(syncDir) || !fs.existsSync(path.join(syncDir, '.git'))) {
+        throw new Error('No sync repository found. Run `ctx-sync init` first.');
+    }
+    const privateKey = loadKey(configDir);
+    const projectDocker = await loadDockerState(syncDir, projectName, privateKey);
+    if (!projectDocker) {
+        return {
+            projectName,
+            composeFound: false,
+            stopped: false,
+            error: `No Docker state found for project "${projectName}".`,
+        };
+    }
+    const composeDir = projectDocker.composeFile
+        ? path.dirname(projectDocker.composeFile)
+        : null;
+    if (!composeDir || !fs.existsSync(composeDir)) {
+        return {
+            projectName,
+            composeFound: false,
+            stopped: false,
+            error: `Compose directory not found: ${composeDir ?? 'unknown'}`,
+        };
+    }
+    try {
+        execSync('docker compose down', {
+            cwd: composeDir,
+            stdio: 'pipe',
+            timeout: 30000,
+        });
+        return {
+            projectName,
+            composeFound: true,
+            stopped: true,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            projectName,
+            composeFound: true,
+            stopped: false,
+            error: message,
+        };
+    }
+}
+// ─── Status Logic ─────────────────────────────────────────────────────────
+/**
+ * Execute Docker status: show all tracked Docker projects and services.
+ *
+ * @param projectFilter - Optional project name to filter.
+ * @returns Status result.
+ */
+export async function executeDockerStatus(projectFilter) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    if (!fs.existsSync(syncDir) || !fs.existsSync(path.join(syncDir, '.git'))) {
+        throw new Error('No sync repository found. Run `ctx-sync init` first.');
+    }
+    const privateKey = loadKey(configDir);
+    const allDocker = await loadAllDockerState(syncDir, privateKey);
+    if (!allDocker) {
+        return { projects: [] };
+    }
+    const projects = [];
+    for (const [name, entry] of Object.entries(allDocker)) {
+        if (projectFilter && name !== projectFilter)
+            continue;
+        projects.push({
+            projectName: name,
+            composeFile: entry.composeFile,
+            services: entry.services.map((s) => ({
+                name: s.name,
+                image: s.image,
+                port: s.port,
+                autoStart: s.autoStart,
+                composeFile: entry.composeFile,
+            })),
+        });
+    }
+    return { projects };
+}
+// ─── CLI Registration ─────────────────────────────────────────────────────
+/**
+ * Register the `docker` command group on the given Commander program.
+ */
+export function registerDockerCommand(program) {
+    const docker = program
+        .command('docker')
+        .description('Manage Docker container state for tracked projects');
+    // docker track
+    docker
+        .command('track')
+        .description('Track Docker Compose services for the current project')
+        .option('-p, --path <path>', 'Project directory path (default: current directory)')
+        .option('--project <name>', 'Project name override')
+        .option('--no-sync', 'Skip syncing to Git after tracking')
+        .action(withErrorHandler(async (opts) => {
+        const options = {
+            path: opts['path'],
+            project: opts['project'],
+            noSync: opts['sync'] === false,
+        };
+        const chalk = (await import('chalk')).default;
+        const result = await executeDockerTrack(options);
+        console.log(chalk.green(`\n✅ Docker services tracked for ${result.projectName}`));
+        console.log(`   Compose file: ${result.composeFile}`);
+        console.log(`   Services (${result.serviceCount}):`);
+        for (const name of result.serviceNames) {
+            console.log(`     • ${name}`);
+        }
+        if (result.networks.length > 0) {
+            console.log(`   Networks: ${result.networks.join(', ')}`);
+        }
+        console.log(chalk.dim('\n   State encrypted and saved to docker-state.age'));
+    }));
+    // docker start <project>
+    docker
+        .command('start <project>')
+        .description('Start tracked Docker services (with confirmation)')
+        .option('--no-interactive', 'Show commands but skip execution')
+        .action(withErrorHandler(async (projectName, opts) => {
+        const options = {
+            noInteractive: opts['interactive'] === false,
+        };
+        const chalk = (await import('chalk')).default;
+        if (!isDockerAvailable()) {
+            console.error(chalk.red('Error: Docker is not available on this machine.'));
+            process.exitCode = 1;
+            return;
+        }
+        const result = await executeDockerStart(projectName, options);
+        if (result.commandsPresented.length === 0) {
+            console.log(chalk.yellow('No auto-start Docker services configured.'));
+            return;
+        }
+        console.log(chalk.yellow('\n⚠️  The following Docker commands will be executed:'));
+        console.log(formatCommandsForDisplay(result.commandsPresented));
+        console.log('');
+        if (result.approval.skippedAll) {
+            console.log(chalk.dim('Skipped (non-interactive mode)'));
+        }
+        else {
+            for (const cmd of result.executedCommands) {
+                console.log(chalk.green(`   ✓ ${cmd}`));
+            }
+            for (const { command, error } of result.failedCommands) {
+                console.log(chalk.red(`   ✗ ${command}: ${error}`));
+            }
+            for (const cmd of result.approval.rejected) {
+                console.log(chalk.dim(`   ⏭️  Skipped: ${cmd.command}`));
+            }
+        }
+    }));
+    // docker stop <project>
+    docker
+        .command('stop <project>')
+        .description('Stop tracked Docker services')
+        .action(withErrorHandler(async (projectName) => {
+        const chalk = (await import('chalk')).default;
+        const { default: ora } = await import('ora');
+        if (!isDockerAvailable()) {
+            console.error(chalk.red('Error: Docker is not available on this machine.'));
+            process.exitCode = 1;
+            return;
+        }
+        const spinner = ora(`Stopping Docker services for ${projectName}...`).start();
+        const result = await executeDockerStop(projectName);
+        spinner.stop();
+        if (!result.composeFound) {
+            console.log(chalk.yellow(result.error ?? 'No Docker state found.'));
+            return;
+        }
+        if (result.stopped) {
+            console.log(chalk.green(`✅ Docker services stopped for ${projectName}`));
+        }
+        else {
+            console.error(chalk.red(`Failed to stop: ${result.error}`));
+            process.exitCode = 1;
+        }
+    }));
+    // docker status [project]
+    docker
+        .command('status [project]')
+        .description('Show tracked Docker services')
+        .action(withErrorHandler(async (projectFilter) => {
+        const chalk = (await import('chalk')).default;
+        const result = await executeDockerStatus(projectFilter);
+        if (result.projects.length === 0) {
+            console.log(chalk.yellow('No Docker services tracked.'));
+            console.log(chalk.dim('Run `ctx-sync docker track` in a project with a Docker Compose file.'));
+            return;
+        }
+        for (const project of result.projects) {
+            console.log(chalk.bold(`\n🐳 ${project.projectName}`));
+            console.log(chalk.dim(`   Compose: ${project.composeFile}`));
+            for (const svc of project.services) {
+                const portStr = svc.port > 0 ? ` (port ${svc.port})` : '';
+                const autoStr = svc.autoStart ? ' [auto-start]' : '';
+                const imageStr = svc.image ? ` — ${svc.image}` : '';
+                console.log(`   • ${svc.name}${imageStr}${portStr}${autoStr}`);
+            }
+        }
+    }));
+}
+//# sourceMappingURL=docker.js.map

package/dist/commands/docker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../src/commands/docker.ts"],"names":[],"mappings":"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"}

package/dist/commands/env.d.ts

@@ -0,0 +1,96 @@
+/**
+ * `ctx-sync env` command group.
+ *
+ * Subcommands:
+ *   - `env import <project> <file>` — Import from .env file
+ *   - `env add <project> <key>` — Add single var (hidden input / stdin)
+ *   - `env scan <project>` — Scan current shell environment
+ *   - `env list <project>` — List env vars (values hidden by default)
+ *
+ * Security:
+ *   - Secret values are NEVER accepted as CLI arguments.
+ *   - All env vars encrypted by default (encrypt-by-default).
+ *   - Values are never displayed in CLI output unless --show-values.
+ *
+ * @module commands/env
+ */
+import type { Command } from 'commander';
+import type { ListedEnvVar } from '../core/env-handler.js';
+/**
+ * Options for the env import command.
+ */
+export interface EnvImportOptions {
+    project: string;
+    file?: string;
+    stdin?: boolean;
+    allowPlain?: boolean;
+    noSync?: boolean;
+}
+/**
+ * Result of env import.
+ */
+export interface EnvImportResult {
+    importedCount: number;
+    encryptedCount: number;
+    plainCount: number;
+}
+/**
+ * Execute env import from a file or stdin.
+ */
+export declare function executeEnvImport(options: EnvImportOptions): Promise<EnvImportResult>;
+/**
+ * Options for the env add command.
+ */
+export interface EnvAddOptions {
+    project: string;
+    key: string;
+    stdin?: boolean;
+    fromFd?: number;
+    noSync?: boolean;
+}
+/**
+ * Execute env add (single variable).
+ */
+export declare function executeEnvAdd(options: EnvAddOptions & {
+    value?: string;
+}): Promise<void>;
+/**
+ * Options for env scan.
+ */
+export interface EnvScanOptions {
+    project: string;
+    noSync?: boolean;
+}
+/** A candidate env var from the current shell */
+export interface EnvScanCandidate {
+    key: string;
+    value: string;
+    isProjectRelated: boolean;
+}
+/**
+ * Scan the current shell environment for project-related variables.
+ *
+ * Heuristic: exclude common system vars and PATH-like variables.
+ * Returns candidates for user to select from.
+ */
+export declare function scanEnvironment(): EnvScanCandidate[];
+/**
+ * Execute env scan — import selected vars from current environment.
+ */
+export declare function executeEnvScan(options: EnvScanOptions, selectedKeys: string[]): Promise<number>;
+/**
+ * Options for env list.
+ */
+export interface EnvListOptions {
+    project: string;
+    showValues?: boolean;
+}
+/**
+ * Execute env list.
+ */
+export declare function executeEnvList(options: EnvListOptions): Promise<ListedEnvVar[]>;
+/**
+ * Register the `env` command group on the given Commander program.
+ */
+export declare function registerEnvCommand(program: Command): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/commands/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAW3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAgE1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,EAAE,CAqDpD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,MAAM,CAAC,CAmCjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAWrF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmMzD"}