ctx-sync 1.0.0

package/dist/commands/push.js

@@ -0,0 +1,94 @@
+/**
+ * `ctx-sync push` command.
+ *
+ * Commits all encrypted state files (.age + manifest.json) and pushes to
+ * the remote. Does NOT pull first — this is a one-way push operation.
+ *
+ * Validates remote URL (transport security) before every push.
+ *
+ * @module commands/push
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { withErrorHandler } from '../utils/errors.js';
+import { commitState, pushState } from '../core/git-sync.js';
+import { readManifest, writeManifest } from '../core/state-manager.js';
+import { validateSyncRemote, collectSyncFiles } from './sync.js';
+import { getSyncDir } from './init.js';
+/**
+ * Execute the push command logic.
+ *
+ * 1. Validate remote URL.
+ * 2. Update manifest timestamp.
+ * 3. Commit all .age files + manifest.json.
+ * 4. Push to remote.
+ *
+ * @returns Push result with operation details.
+ */
+export async function executePush() {
+    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.');
+    }
+    const result = {
+        committed: false,
+        pushed: false,
+        commitHash: null,
+        fileCount: 0,
+        hasRemote: false,
+    };
+    // 1. Validate remote
+    const remoteUrl = await validateSyncRemote(syncDir);
+    result.hasRemote = remoteUrl !== null;
+    // 2. Update manifest timestamp
+    const manifest = readManifest(syncDir) ?? {
+        version: '1.0.0',
+        lastSync: new Date().toISOString(),
+        files: {},
+    };
+    manifest.lastSync = new Date().toISOString();
+    writeManifest(syncDir, manifest);
+    // 3. Collect and commit all sync files
+    const files = collectSyncFiles(syncDir);
+    result.fileCount = files.length;
+    if (files.length > 0) {
+        const hash = await commitState(syncDir, files, 'sync: push encrypted state');
+        result.committed = hash !== null;
+        result.commitHash = hash;
+    }
+    // 4. Push to remote
+    if (result.hasRemote) {
+        await pushState(syncDir);
+        result.pushed = true;
+    }
+    return result;
+}
+/**
+ * Register the `push` command on the given Commander program.
+ */
+export function registerPushCommand(program) {
+    program
+        .command('push')
+        .description('Commit and push encrypted state to remote')
+        .action(withErrorHandler(async () => {
+        const chalk = (await import('chalk')).default;
+        const { default: ora } = await import('ora');
+        const spinner = ora('Pushing...').start();
+        const result = await executePush();
+        spinner.stop();
+        if (result.committed) {
+            console.log(chalk.green(`✅ Committed ${result.fileCount} file(s)`));
+        }
+        else {
+            console.log(chalk.dim('   No changes to commit'));
+        }
+        if (result.pushed) {
+            console.log(chalk.green('✅ Pushed to remote'));
+        }
+        else if (!result.hasRemote) {
+            console.log(chalk.yellow('⚠ No remote configured — committed locally only'));
+        }
+    }));
+}
+//# sourceMappingURL=push.js.map

package/dist/commands/push.js.map

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

package/dist/commands/restore.d.ts

@@ -0,0 +1,116 @@
+/**
+ * `ctx-sync restore <project>` command.
+ *
+ * Decrypts all state files and restores a project's context on a new
+ * (or existing) machine:
+ *   1. Decrypt state.age → find the project entry.
+ *   2. Display project info (directory, branch, env var count).
+ *   3. Display mental context (if available).
+ *   4. Collect commands to execute (Docker services, auto-start services).
+ *   5. Present commands for user approval (MANDATORY — no bypass).
+ *   6. Execute approved commands.
+ *   7. Set up env vars (.env file) in the project directory.
+ *   8. Checkout correct git branch (if repo exists locally).
+ *
+ * **Security:** Commands are NEVER auto-executed. There is no `--yes` or
+ * `--no-confirm` flag. In `--no-interactive` mode, commands are displayed
+ * but not executed.
+ *
+ * @module commands/restore
+ */
+import type { Command } from 'commander';
+import type { Project, ProjectMentalContext } from '@ctx-sync/shared';
+import type { PendingCommand, ApprovalResult } from '../core/command-validator.js';
+/** Options for the restore command */
+export interface RestoreOptions {
+    /** Non-interactive mode: display commands but skip execution */
+    noInteractive?: boolean;
+    /** Override for the prompt function (for testing) */
+    promptFn?: (commands: PendingCommand[]) => Promise<'all' | 'none' | 'select'>;
+    /** Override for the select function (for testing) */
+    selectFn?: (cmd: PendingCommand, index: number) => Promise<boolean>;
+}
+/** Result of a restore operation */
+export interface RestoreResult {
+    /** The project that was restored */
+    project: Project;
+    /** Number of env vars available for the project */
+    envVarCount: number;
+    /** Whether env vars were written to a .env file */
+    envFileWritten: boolean;
+    /** Whether the git branch was checked out */
+    branchCheckedOut: boolean;
+    /** Mental context for the project (if available) */
+    mentalContext: ProjectMentalContext | null;
+    /** Commands that were presented for approval */
+    commandsPresented: PendingCommand[];
+    /** Approval result */
+    approval: ApprovalResult;
+    /** Commands that were executed */
+    executedCommands: string[];
+    /** Commands that failed */
+    failedCommands: Array<{
+        command: string;
+        error: string;
+    }>;
+}
+/**
+ * Collect all commands that need to be executed for a project restore.
+ *
+ * Gathers Docker service commands and auto-start service commands from
+ * the encrypted state files.
+ *
+ * @param projectName - The name of the project to restore.
+ * @param syncDir - The sync directory path.
+ * @param privateKey - The Age private key for decryption.
+ * @returns List of pending commands for approval.
+ */
+export declare function collectRestoreCommands(projectName: string, syncDir: string, privateKey: string): Promise<PendingCommand[]>;
+/**
+ * Write env vars to a .env file in the project directory.
+ *
+ * Creates or overwrites the .env file with all env vars for the project.
+ * If the project directory does not exist, skips writing.
+ *
+ * @param projectPath - The absolute path to the project directory.
+ * @param envVars - The decrypted env vars for the project.
+ * @returns Whether the file was written.
+ */
+export declare function writeEnvFile(projectPath: string, envVars: Record<string, {
+    value: string;
+    addedAt: string;
+}>): boolean;
+/**
+ * Attempt to checkout the correct git branch in the project directory.
+ *
+ * If the project has a local git repo and the branch exists, checks it out.
+ * Does not fail if the branch doesn't exist or git is not available.
+ *
+ * @param projectPath - The absolute path to the project directory.
+ * @param branch - The branch to checkout.
+ * @returns Whether the branch was checked out.
+ */
+export declare function checkoutBranch(projectPath: string, branch: string): Promise<boolean>;
+/**
+ * Execute the restore command logic.
+ *
+ * Decrypts state, displays project context, presents commands for
+ * approval, and restores env vars and git branch.
+ *
+ * @param projectName - The name of the project to restore.
+ * @param options - Restore command options.
+ * @returns Restore result with all operation details.
+ */
+export declare function executeRestore(projectName: string, options?: RestoreOptions): Promise<RestoreResult>;
+/**
+ * Format mental context for terminal display.
+ *
+ * @param context - The mental context to display.
+ * @returns Formatted string for terminal output.
+ */
+export declare function formatMentalContext(context: ProjectMentalContext): string;
+/**
+ * Register the `restore` command on the given Commander program.
+ */
+export declare function registerRestoreCommand(program: Command): void;
+//# sourceMappingURL=restore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/commands/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAEV,OAAO,EAKP,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInF,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC9E,qDAAqD;IACrD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,cAAc,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,aAAa,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,gDAAgD;IAChD,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC,sBAAsB;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,2BAA2B;IAC3B,cAAc,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,EAAE,CAAC,CAwC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,OAAO,CAsBT;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAuGxB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAiDzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkE7D"}

package/dist/commands/restore.js

@@ -0,0 +1,336 @@
+/**
+ * `ctx-sync restore <project>` command.
+ *
+ * Decrypts all state files and restores a project's context on a new
+ * (or existing) machine:
+ *   1. Decrypt state.age → find the project entry.
+ *   2. Display project info (directory, branch, env var count).
+ *   3. Display mental context (if available).
+ *   4. Collect commands to execute (Docker services, auto-start services).
+ *   5. Present commands for user approval (MANDATORY — no bypass).
+ *   6. Execute approved commands.
+ *   7. Set up env vars (.env file) in the project directory.
+ *   8. Checkout correct git branch (if repo exists locally).
+ *
+ * **Security:** Commands are NEVER auto-executed. There is no `--yes` or
+ * `--no-confirm` flag. In `--no-interactive` mode, commands are displayed
+ * but not executed.
+ *
+ * @module commands/restore
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { identityToRecipient } from 'age-encryption';
+import { loadKey } from '../core/key-store.js';
+import { readState } from '../core/state-manager.js';
+import { formatCommandsForDisplay, presentCommandsForApproval, } from '../core/command-validator.js';
+import { getConfigDir, getSyncDir } from './init.js';
+import { withErrorHandler } from '../utils/errors.js';
+/**
+ * Collect all commands that need to be executed for a project restore.
+ *
+ * Gathers Docker service commands and auto-start service commands from
+ * the encrypted state files.
+ *
+ * @param projectName - The name of the project to restore.
+ * @param syncDir - The sync directory path.
+ * @param privateKey - The Age private key for decryption.
+ * @returns List of pending commands for approval.
+ */
+export async function collectRestoreCommands(projectName, syncDir, privateKey) {
+    const commands = [];
+    // Collect Docker service commands
+    const dockerState = await readState(syncDir, privateKey, 'docker-state');
+    if (dockerState && dockerState[projectName]) {
+        const projectDocker = dockerState[projectName];
+        if (projectDocker) {
+            for (const service of projectDocker.services) {
+                if (service.autoStart) {
+                    commands.push({
+                        command: `docker compose up -d ${service.name}`,
+                        label: '🐳 Docker services',
+                        port: service.port,
+                        image: service.image,
+                        cwd: projectDocker.composeFile
+                            ? path.dirname(projectDocker.composeFile)
+                            : undefined,
+                    });
+                }
+            }
+        }
+    }
+    // Collect auto-start service commands
+    const serviceState = await readState(syncDir, privateKey, 'services');
+    if (serviceState) {
+        const projectServices = serviceState.services.filter((s) => s.project === projectName && s.autoStart);
+        for (const service of projectServices) {
+            commands.push({
+                command: service.command,
+                label: '⚡ Auto-start services',
+                port: service.port,
+            });
+        }
+    }
+    return commands;
+}
+/**
+ * Write env vars to a .env file in the project directory.
+ *
+ * Creates or overwrites the .env file with all env vars for the project.
+ * If the project directory does not exist, skips writing.
+ *
+ * @param projectPath - The absolute path to the project directory.
+ * @param envVars - The decrypted env vars for the project.
+ * @returns Whether the file was written.
+ */
+export function writeEnvFile(projectPath, envVars) {
+    if (!fs.existsSync(projectPath)) {
+        return false;
+    }
+    const lines = [];
+    lines.push('# Generated by ctx-sync restore');
+    lines.push(`# ${new Date().toISOString()}`);
+    lines.push('');
+    for (const [key, entry] of Object.entries(envVars)) {
+        // Quote values that contain spaces, newlines, or special characters
+        const needsQuotes = /[\s"'\\#]/.test(entry.value) || entry.value === '';
+        const escapedValue = needsQuotes
+            ? `"${entry.value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n')}"`
+            : entry.value;
+        lines.push(`${key}=${escapedValue}`);
+    }
+    const envPath = path.join(projectPath, '.env');
+    fs.writeFileSync(envPath, lines.join('\n') + '\n', 'utf-8');
+    return true;
+}
+/**
+ * Attempt to checkout the correct git branch in the project directory.
+ *
+ * If the project has a local git repo and the branch exists, checks it out.
+ * Does not fail if the branch doesn't exist or git is not available.
+ *
+ * @param projectPath - The absolute path to the project directory.
+ * @param branch - The branch to checkout.
+ * @returns Whether the branch was checked out.
+ */
+export async function checkoutBranch(projectPath, branch) {
+    if (!fs.existsSync(path.join(projectPath, '.git'))) {
+        return false;
+    }
+    if (!branch || branch === 'unknown') {
+        return false;
+    }
+    try {
+        const { simpleGit } = await import('simple-git');
+        const git = simpleGit(projectPath);
+        // Check current branch — skip if already on the right branch
+        const branchResult = await git.branch();
+        if (branchResult.current === branch) {
+            return true;
+        }
+        // Try to checkout the branch
+        await git.checkout(branch);
+        return true;
+    }
+    catch {
+        // Branch may not exist locally — that's OK
+        return false;
+    }
+}
+/**
+ * Execute the restore command logic.
+ *
+ * Decrypts state, displays project context, presents commands for
+ * approval, and restores env vars and git branch.
+ *
+ * @param projectName - The name of the project to restore.
+ * @param options - Restore command options.
+ * @returns Restore result with all operation details.
+ */
+export async function executeRestore(projectName, options = {}) {
+    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);
+    // publicKey is available for future use (re-encryption after restore)
+    void publicKey;
+    // 1. Decrypt state and find the project
+    const state = await readState(syncDir, privateKey, 'state');
+    if (!state) {
+        throw new Error('No state file found. Track a project first with `ctx-sync track`.');
+    }
+    const project = state.projects.find((p) => p.name === projectName || p.id === projectName);
+    if (!project) {
+        const availableNames = state.projects.map((p) => p.name).join(', ');
+        throw new Error(`Project "${projectName}" not found.\n` +
+            (availableNames
+                ? `Available projects: ${availableNames}`
+                : 'No projects tracked yet. Run `ctx-sync track` first.'));
+    }
+    // 2. Count env vars
+    const envVars = await readState(syncDir, privateKey, 'env-vars');
+    const projectEnvVars = envVars?.[project.name] ?? {};
+    const envVarCount = Object.keys(projectEnvVars).length;
+    // 3. Load mental context
+    const mentalContextData = await readState(syncDir, privateKey, 'mental-context');
+    const mentalContext = mentalContextData?.[project.name] ?? null;
+    // 4. Collect commands to be executed
+    const commandsPresented = await collectRestoreCommands(project.name, syncDir, privateKey);
+    // 5. Present commands for approval
+    const approval = await presentCommandsForApproval(commandsPresented, {
+        interactive: !options.noInteractive,
+        promptFn: options.promptFn,
+        selectFn: options.selectFn,
+    });
+    // 6. Execute approved commands
+    const executedCommands = [];
+    const failedCommands = [];
+    for (const cmd of approval.approved) {
+        try {
+            const { execSync } = await import('node:child_process');
+            execSync(cmd.command, {
+                cwd: cmd.cwd ?? project.path,
+                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 });
+        }
+    }
+    // 7. Write env vars to .env file
+    let envFileWritten = false;
+    if (envVarCount > 0 && fs.existsSync(project.path)) {
+        envFileWritten = writeEnvFile(project.path, projectEnvVars);
+    }
+    // 8. Checkout git branch
+    const branchCheckedOut = await checkoutBranch(project.path, project.git.branch);
+    return {
+        project,
+        envVarCount,
+        envFileWritten,
+        branchCheckedOut,
+        mentalContext,
+        commandsPresented,
+        approval,
+        executedCommands,
+        failedCommands,
+    };
+}
+/**
+ * Format mental context for terminal display.
+ *
+ * @param context - The mental context to display.
+ * @returns Formatted string for terminal output.
+ */
+export function formatMentalContext(context) {
+    const lines = [];
+    if (context.currentTask) {
+        lines.push(`📝 You were working on:`);
+        lines.push(`   "${context.currentTask}"`);
+    }
+    if (context.lastWorkingOn) {
+        lines.push('');
+        lines.push(`   Last file: ${context.lastWorkingOn.file}:${context.lastWorkingOn.line}`);
+        if (context.lastWorkingOn.description) {
+            lines.push(`   ${context.lastWorkingOn.description}`);
+        }
+    }
+    if (context.blockers.length > 0) {
+        lines.push('');
+        lines.push('   ⛔ Blockers:');
+        for (const blocker of context.blockers) {
+            lines.push(`   • ${blocker.description}`);
+        }
+    }
+    if (context.nextSteps.length > 0) {
+        lines.push('');
+        lines.push('   Next steps:');
+        for (const step of context.nextSteps) {
+            lines.push(`   • ${step}`);
+        }
+    }
+    if (context.relatedLinks.length > 0) {
+        lines.push('');
+        lines.push('   🔗 Related:');
+        for (const link of context.relatedLinks) {
+            lines.push(`   • ${link.title}: ${link.url}`);
+        }
+    }
+    if (context.breadcrumbs.length > 0) {
+        lines.push('');
+        lines.push('   🍞 Breadcrumbs:');
+        for (const crumb of context.breadcrumbs) {
+            lines.push(`   • ${crumb.note}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Register the `restore` command on the given Commander program.
+ */
+export function registerRestoreCommand(program) {
+    program
+        .command('restore <project>')
+        .description('Restore a tracked project on this machine')
+        .option('--no-interactive', 'Show commands but skip execution (safe default)')
+        .action(withErrorHandler(async (projectName, opts) => {
+        const options = {
+            noInteractive: opts['interactive'] === false,
+        };
+        const chalk = (await import('chalk')).default;
+        const { default: ora } = await import('ora');
+        const spinner = ora('Decrypting state files...').start();
+        const result = await executeRestore(projectName, options);
+        spinner.stop();
+        // Display project info
+        console.log(chalk.green(`\n✅ Restored: ${result.project.name}`));
+        console.log('');
+        console.log(`📂 Directory: ${result.project.path}`);
+        console.log(`🌿 Branch: ${result.project.git.branch}`);
+        console.log(`🔐 Env vars: ${result.envVarCount} decrypted`);
+        if (result.branchCheckedOut) {
+            console.log(chalk.dim('   Git branch checked out'));
+        }
+        if (result.envFileWritten) {
+            console.log(chalk.dim('   .env file written'));
+        }
+        // Display mental context
+        if (result.mentalContext) {
+            console.log('');
+            console.log(formatMentalContext(result.mentalContext));
+        }
+        // Display commands
+        if (result.commandsPresented.length > 0) {
+            console.log('');
+            console.log(chalk.yellow('⚠️  The following commands will be executed:'));
+            console.log(formatCommandsForDisplay(result.commandsPresented));
+            console.log('');
+            if (result.approval.skippedAll) {
+                console.log(chalk.dim('Skipped (non-interactive mode)'));
+            }
+            else {
+                // Show execution results
+                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}`));
+                }
+            }
+        }
+        console.log('');
+        console.log(chalk.green('Ready to work! 🚀'));
+    }));
+}
+//# sourceMappingURL=restore.js.map

package/dist/commands/restore.js.map

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

package/dist/commands/service.d.ts

@@ -0,0 +1,83 @@
+/**
+ * `ctx-sync service` command group.
+ *
+ * Manages running service state:
+ *   - `service add <project> <name>` — add / update a service.
+ *   - `service remove <project> <name>` — remove a service.
+ *   - `service list [project]` — list tracked services.
+ *   - `service start <project>` — present auto-start commands for approval.
+ *
+ * **Security:** `service start` commands go through the command validator.
+ * All start commands require explicit user confirmation — there is no
+ * `--yes` or `--no-confirm` bypass.
+ *
+ * @module commands/service
+ */
+import type { Command } from 'commander';
+import type { Service } from '@ctx-sync/shared';
+import type { PendingCommand, ApprovalResult } from '../core/command-validator.js';
+/** Options for service add */
+export interface ServiceAddOptions {
+    port: number;
+    command: string;
+    autoStart?: boolean;
+    noSync?: boolean;
+}
+/** Result of service add */
+export interface ServiceAddResult {
+    projectName: string;
+    serviceName: string;
+    port: number;
+    command: string;
+    autoStart: boolean;
+}
+/** Options for service start */
+export interface ServiceStartOptions {
+    /** Non-interactive mode: show commands but skip execution */
+    noInteractive?: boolean;
+    /** Override prompt function (for testing) */
+    promptFn?: (commands: PendingCommand[]) => Promise<'all' | 'none' | 'select'>;
+    /** Override per-command select function (for testing) */
+    selectFn?: (cmd: PendingCommand, index: number) => Promise<boolean>;
+}
+/** Result of service start */
+export interface ServiceStartResult {
+    projectName: string;
+    commandsPresented: PendingCommand[];
+    approval: ApprovalResult;
+    executedCommands: string[];
+    failedCommands: Array<{
+        command: string;
+        error: string;
+    }>;
+}
+/**
+ * Execute `ctx-sync service add <project> <name>`.
+ */
+export declare function executeServiceAdd(project: string, name: string, options: ServiceAddOptions): Promise<ServiceAddResult>;
+/**
+ * Execute `ctx-sync service remove <project> <name>`.
+ */
+export declare function executeServiceRemove(project: string, name: string, noSync?: boolean): Promise<boolean>;
+/**
+ * Build commands for service start (without executing).
+ */
+export declare function buildServiceStartCommands(services: Service[]): PendingCommand[];
+/**
+ * Execute `ctx-sync service start <project>`.
+ *
+ * Shows auto-start services for user approval, then executes approved ones.
+ */
+export declare function executeServiceStart(project: string, options?: ServiceStartOptions): Promise<ServiceStartResult>;
+/**
+ * Execute `ctx-sync service list [project]`.
+ */
+export declare function executeServiceList(project?: string): Promise<{
+    project: string;
+    services: Service[];
+}[]>;
+/**
+ * Register the `ctx-sync service` command group on the given program.
+ */
+export declare function registerServiceCommand(program: Command): void;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/commands/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAa,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAS3D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAenF,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC9E,yDAAyD;IACzD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED,8BAA8B;AAC9B,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC,QAAQ,EAAE,cAAc,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAqBD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAyC3B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,UAAQ,GACb,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAM/E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAkD7B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,EAAE,CAAC,CAmBrD;AAID;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmH7D"}