ctx-sync 1.0.0

package/dist/commands/dir.d.ts

@@ -0,0 +1,56 @@
+/**
+ * `ctx-sync dir` command group.
+ *
+ * Manages working directory state:
+ *   - `dir visit <path>` — record a directory visit.
+ *   - `dir pin <path>` — pin a directory.
+ *   - `dir unpin <path>` — unpin a directory.
+ *   - `dir list` — list recent and pinned directories.
+ *   - `dir remove <path>` — remove a directory from the recent list.
+ *
+ * @module commands/dir
+ */
+import type { Command } from 'commander';
+/**
+ * Execute `ctx-sync dir visit <path>`.
+ */
+export declare function executeDirVisit(dirPath: string, noSync?: boolean): Promise<{
+    path: string;
+}>;
+/**
+ * Execute `ctx-sync dir pin <path>`.
+ */
+export declare function executeDirPin(dirPath: string, noSync?: boolean): Promise<{
+    path: string;
+    alreadyPinned: boolean;
+}>;
+/**
+ * Execute `ctx-sync dir unpin <path>`.
+ */
+export declare function executeDirUnpin(dirPath: string, noSync?: boolean): Promise<{
+    path: string;
+    wasPinned: boolean;
+}>;
+/**
+ * Execute `ctx-sync dir remove <path>`.
+ */
+export declare function executeDirRemove(dirPath: string, noSync?: boolean): Promise<{
+    path: string;
+    wasRemoved: boolean;
+}>;
+/**
+ * Execute `ctx-sync dir list`.
+ */
+export declare function executeDirList(limit?: number): Promise<{
+    pinned: string[];
+    recent: Array<{
+        path: string;
+        frequency: number;
+        lastVisit: string;
+    }>;
+}>;
+/**
+ * Register the `ctx-sync dir` command group on the given program.
+ */
+export declare function registerDirCommand(program: Command): void;
+//# sourceMappingURL=dir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dir.d.ts","sourceRoot":"","sources":["../../src/commands/dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,UAAQ,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB3B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,UAAQ,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC,CAkBnD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,UAAQ,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAkB/C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,UAAQ,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAuBhD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,SAAK,GACT,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE,CAAC,CAUD;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsFzD"}

package/dist/commands/dir.js

@@ -0,0 +1,172 @@
+/**
+ * `ctx-sync dir` command group.
+ *
+ * Manages working directory state:
+ *   - `dir visit <path>` — record a directory visit.
+ *   - `dir pin <path>` — pin a directory.
+ *   - `dir unpin <path>` — unpin a directory.
+ *   - `dir list` — list recent and pinned directories.
+ *   - `dir remove <path>` — remove a directory from the recent list.
+ *
+ * @module commands/dir
+ */
+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 { commitState } from '../core/git-sync.js';
+import { visitDirectory, pinDirectory, unpinDirectory, removeRecentDirectory, getTopDirectories, getPinnedDirectories, } from '../core/directories-handler.js';
+import { getConfigDir, getSyncDir } from './init.js';
+// ─── Core Logic ───────────────────────────────────────────────────────────
+/**
+ * Execute `ctx-sync dir visit <path>`.
+ */
+export async function executeDirVisit(dirPath, noSync = false) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    const publicKey = await identityToRecipient(privateKey);
+    await visitDirectory(syncDir, dirPath, publicKey, privateKey);
+    if (!noSync) {
+        await commitState(syncDir, [STATE_FILES.DIRECTORIES, STATE_FILES.MANIFEST], `dir: visit ${dirPath}`);
+    }
+    return { path: dirPath };
+}
+/**
+ * Execute `ctx-sync dir pin <path>`.
+ */
+export async function executeDirPin(dirPath, noSync = false) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    const publicKey = await identityToRecipient(privateKey);
+    const pinned = await pinDirectory(syncDir, dirPath, publicKey, privateKey);
+    if (pinned && !noSync) {
+        await commitState(syncDir, [STATE_FILES.DIRECTORIES, STATE_FILES.MANIFEST], `dir: pin ${dirPath}`);
+    }
+    return { path: dirPath, alreadyPinned: !pinned };
+}
+/**
+ * Execute `ctx-sync dir unpin <path>`.
+ */
+export async function executeDirUnpin(dirPath, noSync = false) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    const publicKey = await identityToRecipient(privateKey);
+    const unpinned = await unpinDirectory(syncDir, dirPath, publicKey, privateKey);
+    if (unpinned && !noSync) {
+        await commitState(syncDir, [STATE_FILES.DIRECTORIES, STATE_FILES.MANIFEST], `dir: unpin ${dirPath}`);
+    }
+    return { path: dirPath, wasPinned: unpinned };
+}
+/**
+ * Execute `ctx-sync dir remove <path>`.
+ */
+export async function executeDirRemove(dirPath, noSync = false) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    const publicKey = await identityToRecipient(privateKey);
+    const removed = await removeRecentDirectory(syncDir, dirPath, publicKey, privateKey);
+    if (removed && !noSync) {
+        await commitState(syncDir, [STATE_FILES.DIRECTORIES, STATE_FILES.MANIFEST], `dir: remove ${dirPath}`);
+    }
+    return { path: dirPath, wasRemoved: removed };
+}
+/**
+ * Execute `ctx-sync dir list`.
+ */
+export async function executeDirList(limit = 10) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    const pinned = await getPinnedDirectories(syncDir, privateKey);
+    const recent = await getTopDirectories(syncDir, privateKey, limit);
+    return { pinned, recent };
+}
+// ─── Commander Registration ───────────────────────────────────────────────
+/**
+ * Register the `ctx-sync dir` command group on the given program.
+ */
+export function registerDirCommand(program) {
+    const dirCmd = program
+        .command('dir')
+        .description('Manage tracked working directories');
+    // ── dir visit ─────────────────────────────────────────────────────
+    dirCmd
+        .command('visit <path>')
+        .description('Record a directory visit')
+        .option('--no-sync', 'Skip committing to sync repo')
+        .action(withErrorHandler(async (dirPath, opts) => {
+        await executeDirVisit(dirPath, !opts.sync);
+        console.log(`✓ Recorded visit to ${dirPath}`);
+    }));
+    // ── dir pin ───────────────────────────────────────────────────────
+    dirCmd
+        .command('pin <path>')
+        .description('Pin a directory')
+        .option('--no-sync', 'Skip committing to sync repo')
+        .action(withErrorHandler(async (dirPath, opts) => {
+        const result = await executeDirPin(dirPath, !opts.sync);
+        if (result.alreadyPinned) {
+            console.log(`Directory already pinned: ${result.path}`);
+        }
+        else {
+            console.log(`✓ Pinned ${result.path}`);
+        }
+    }));
+    // ── dir unpin ─────────────────────────────────────────────────────
+    dirCmd
+        .command('unpin <path>')
+        .description('Unpin a directory')
+        .option('--no-sync', 'Skip committing to sync repo')
+        .action(withErrorHandler(async (dirPath, opts) => {
+        const result = await executeDirUnpin(dirPath, !opts.sync);
+        if (result.wasPinned) {
+            console.log(`✓ Unpinned ${result.path}`);
+        }
+        else {
+            console.log(`Directory was not pinned: ${result.path}`);
+        }
+    }));
+    // ── dir remove ────────────────────────────────────────────────────
+    dirCmd
+        .command('remove <path>')
+        .description('Remove a directory from the recent list')
+        .option('--no-sync', 'Skip committing to sync repo')
+        .action(withErrorHandler(async (dirPath, opts) => {
+        const result = await executeDirRemove(dirPath, !opts.sync);
+        if (result.wasRemoved) {
+            console.log(`✓ Removed ${result.path} from recent directories`);
+        }
+        else {
+            console.log(`Directory not found in recent list: ${result.path}`);
+        }
+    }));
+    // ── dir list ──────────────────────────────────────────────────────
+    dirCmd
+        .command('list')
+        .description('List recent and pinned directories')
+        .option('-l, --limit <n>', 'Number of recent directories to show', '10')
+        .action(withErrorHandler(async (opts) => {
+        const result = await executeDirList(parseInt(opts.limit, 10));
+        if (result.pinned.length === 0 && result.recent.length === 0) {
+            console.log('No directories tracked.');
+            return;
+        }
+        if (result.pinned.length > 0) {
+            console.log('\n📌 Pinned directories:');
+            for (const p of result.pinned) {
+                console.log(`  ${p}`);
+            }
+        }
+        if (result.recent.length > 0) {
+            console.log('\n📁 Recent directories:');
+            for (const d of result.recent) {
+                console.log(`  ${d.path} (visited ${String(d.frequency)}x, last: ${d.lastVisit})`);
+            }
+        }
+    }));
+}
+//# sourceMappingURL=dir.js.map

package/dist/commands/dir.js.map

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

package/dist/commands/docker.d.ts

@@ -0,0 +1,140 @@
+/**
+ * `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 type { Command } from 'commander';
+import type { DockerState } from '@ctx-sync/shared';
+import type { PendingCommand, ApprovalResult } from '../core/command-validator.js';
+/** Options for docker track */
+export interface DockerTrackOptions {
+    /** Path to the project directory (default: CWD) */
+    path?: string;
+    /** Project name override */
+    project?: string;
+    /** Skip committing to sync repo */
+    noSync?: boolean;
+}
+/** Result of docker track */
+export interface DockerTrackResult {
+    /** The project name */
+    projectName: string;
+    /** Number of services detected */
+    serviceCount: number;
+    /** Names of detected services */
+    serviceNames: string[];
+    /** Compose file path */
+    composeFile: string;
+    /** Networks defined */
+    networks: string[];
+}
+/** Options for docker start */
+export interface DockerStartOptions {
+    /** 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 docker start */
+export interface DockerStartResult {
+    /** The project name */
+    projectName: string;
+    /** Commands that were presented for approval */
+    commandsPresented: PendingCommand[];
+    /** Approval result */
+    approval: ApprovalResult;
+    /** Commands that were executed successfully */
+    executedCommands: string[];
+    /** Commands that failed */
+    failedCommands: Array<{
+        command: string;
+        error: string;
+    }>;
+}
+/** Result of docker stop */
+export interface DockerStopResult {
+    /** The project name */
+    projectName: string;
+    /** Whether Docker Compose was found */
+    composeFound: boolean;
+    /** Whether the stop command succeeded */
+    stopped: boolean;
+    /** Error message if stop failed */
+    error?: string;
+}
+/** Docker service status info */
+export interface DockerServiceStatus {
+    /** Service name */
+    name: string;
+    /** Docker image */
+    image: string;
+    /** Port */
+    port: number;
+    /** Whether auto-start is enabled */
+    autoStart: boolean;
+    /** Compose file path */
+    composeFile: string;
+}
+/** Result of docker status */
+export interface DockerStatusResult {
+    /** All tracked projects and their services */
+    projects: Array<{
+        projectName: string;
+        composeFile: string;
+        services: DockerServiceStatus[];
+    }>;
+}
+/**
+ * Execute Docker track: detect and save Docker Compose state.
+ *
+ * @param options - Track options.
+ * @returns Track result.
+ */
+export declare function executeDockerTrack(options?: DockerTrackOptions): Promise<DockerTrackResult>;
+/**
+ * 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 declare function buildDockerStartCommands(projectName: string, projectDocker: DockerState[string]): PendingCommand[];
+/**
+ * Execute Docker start: show Docker commands for approval and execute.
+ *
+ * @param projectName - The project name.
+ * @param options - Start options.
+ * @returns Start result.
+ */
+export declare function executeDockerStart(projectName: string, options?: DockerStartOptions): Promise<DockerStartResult>;
+/**
+ * Execute Docker stop: stop all tracked services for a project.
+ *
+ * @param projectName - The project name.
+ * @returns Stop result.
+ */
+export declare function executeDockerStop(projectName: string): Promise<DockerStopResult>;
+/**
+ * Execute Docker status: show all tracked Docker projects and services.
+ *
+ * @param projectFilter - Optional project name to filter.
+ * @returns Status result.
+ */
+export declare function executeDockerStatus(projectFilter?: string): Promise<DockerStatusResult>;
+/**
+ * Register the `docker` command group on the given Commander program.
+ */
+export declare function registerDockerCommand(program: Command): void;
+//# sourceMappingURL=docker.d.ts.map

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

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