@tryhuset/foundation-utils 4.85.0 → 4.85.1

package/README.md

@@ -53,13 +53,33 @@ foundation-utils docker update --no-backup
 foundation-utils docker backup --restore ./docker_image_backups/docker-compose_20260101T120000.yaml --force
 foundation-utils docker update --force
 
-# Restart a specific service
+# Restart service(s) (interactive multi-select, or -s to skip)
+foundation-utils docker restart
 foundation-utils docker restart -s <service-name>
+foundation-utils docker restart -s api worker
 
 # List containers (docker compose ps)
 foundation-utils docker list
+
+# Container logs (interactive service picker; or pass -s / --all)
+foundation-utils docker logs
+foundation-utils docker logs --all
+foundation-utils docker logs -s <service-name> --follow
+foundation-utils docker logs -n 200
+
+# Restore stack from a saved backup (interactive list of docker-compose_*.yaml)
+foundation-utils docker restore
+foundation-utils docker restore -d ./docker_image_backups
+foundation-utils docker restore ./docker_image_backups/docker-compose_20260101T120000.yaml
+foundation-utils docker restore --force
 ```
 
+**docker logs** – Runs `docker compose logs`. With no `-s`, opens an interactive list (all services or a single service from `docker compose config --services`). Use `--all` to skip the picker and show every service. Use `-s, --service` to target one service without prompting. `--follow` and `-n, --tail` work as in Docker.
+
+**docker restart** – Runs `docker compose restart`. With no `-s`, opens an interactive **checkbox** (space to toggle, enter to confirm) from `docker compose config --services`. Use `-s, --service <names...>` for one or more services without prompting, e.g. `-s api worker`.
+
+**docker restore** – Lists backups under `./docker_image_backups` (newest first) and prompts you to pick one, then runs the same flow as `docker backup --restore`. Pass a path to skip the list. Use `-d, --dir` to scan another folder.
+
 ## Programmatic Usage
 
 ```typescript
@@ -73,7 +93,9 @@ import {
   dbRestore,
   dockerBackup,
   dockerList,
+  dockerLogs,
   dockerRestart,
+  dockerRestore,
   dockerUpdate
 } from '@tryhuset/foundation-utils';
 
@@ -105,8 +127,19 @@ await dockerUpdate({ force: true });
 // Restore stack from backup compose file (same as: docker backup --restore <path>)
 await dockerUpdate({ backupFile: './docker_image_backups/docker-compose_20260101T120000.yaml', force: true });
 
-// Restart a service
+// Interactive restore (list backups, then pick) or pass a path
+await dockerRestore();
+await dockerRestore({ backupCompose: './docker_image_backups/docker-compose_20260101T120000.yaml' });
+
+// Logs: interactive picker, or allServices / explicit service
+await dockerLogs({ follow: true, tail: 200 });
+await dockerLogs({ allServices: true, follow: true });
+await dockerLogs({ follow: true, tail: 200, service: 'api' });
+
+// Restart (interactive multi-select) or pass service(s)
+await dockerRestart();
 await dockerRestart({ service: 'api' });
+await dockerRestart({ services: ['api', 'worker'] });
 
 // List containers
 await dockerList();

package/dist/src/commands/docker/backup.d.ts

@@ -1,3 +1,5 @@
+/** Default directory for backup compose files and image info (see docker backup). */
+export declare const DOCKER_IMAGE_BACKUP_DIR = "./docker_image_backups";
 export interface DockerBackupOptions {
     file?: string;
 }

package/dist/src/commands/docker/backup.js

@@ -3,7 +3,9 @@ import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
 import { Chalk } from 'chalk';
 import { resolveComposeFile } from '../../utils/resolveComposeFile.js';
 const chalk = new Chalk();
-const BACKUP_DIR = './docker_image_backups';
+/** Default directory for backup compose files and image info (see docker backup). */
+export const DOCKER_IMAGE_BACKUP_DIR = './docker_image_backups';
+const BACKUP_DIR = DOCKER_IMAGE_BACKUP_DIR;
 /**
  * Creates a backup of current Docker images (tags and compose file).
  * Does not pull or restart anything.

package/dist/src/commands/docker/backup.js.map

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

package/dist/src/commands/docker/composeServices.d.ts

@@ -0,0 +1,5 @@
+/** Sentinel for logs picker: stream all services. */
+export declare const ALL_SERVICES_LOGS_VALUE = "__all__";
+export declare function listComposeServiceNames(composeFile: string): string[];
+export declare function promptComposeServiceForLogs(composeFile: string): Promise<string | undefined>;
+export declare function promptComposeServiceForRestart(composeFile: string): Promise<string[]>;

package/dist/src/commands/docker/composeServices.js

@@ -0,0 +1,58 @@
+import { execSync } from 'child_process';
+import { Chalk } from 'chalk';
+import inquirer from 'inquirer';
+import { exitProcess } from '../../utils/processExit.js';
+const chalk = new Chalk();
+/** Sentinel for logs picker: stream all services. */
+export const ALL_SERVICES_LOGS_VALUE = '__all__';
+export function listComposeServiceNames(composeFile) {
+    const out = execSync(`docker compose -f "${composeFile}" config --services`, {
+        encoding: 'utf8'
+    })
+        .trim()
+        .split('\n')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    return [...new Set(out)].sort((a, b) => a.localeCompare(b));
+}
+export async function promptComposeServiceForLogs(composeFile) {
+    const services = listComposeServiceNames(composeFile);
+    if (services.length === 0) {
+        console.error(chalk.red('No services found in the compose file.'));
+        exitProcess(1);
+    }
+    console.log(chalk.blue(`Compose services (${composeFile}):`));
+    const { selected } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'selected',
+            message: 'Select service for logs',
+            choices: [
+                { name: 'All services', value: ALL_SERVICES_LOGS_VALUE },
+                ...services.map((s) => ({ name: s, value: s }))
+            ],
+            pageSize: Math.min(20, Math.max(10, services.length + 1))
+        }
+    ]);
+    return selected === ALL_SERVICES_LOGS_VALUE ? undefined : selected;
+}
+export async function promptComposeServiceForRestart(composeFile) {
+    const services = listComposeServiceNames(composeFile);
+    if (services.length === 0) {
+        console.error(chalk.red('No services found in the compose file.'));
+        exitProcess(1);
+    }
+    console.log(chalk.blue(`Compose services (${composeFile}):`));
+    const { selected } = await inquirer.prompt([
+        {
+            type: 'checkbox',
+            name: 'selected',
+            message: 'Select service(s) to restart (space to toggle, enter to confirm)',
+            choices: services.map((s) => ({ name: s, value: s })),
+            pageSize: Math.min(20, Math.max(10, services.length)),
+            validate: (answer) => answer.length > 0 ? true : 'Select at least one service'
+        }
+    ]);
+    return selected;
+}
+//# sourceMappingURL=composeServices.js.map

package/dist/src/commands/docker/composeServices.js.map

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

package/dist/src/commands/docker/index.d.ts

@@ -1,9 +1,11 @@
 import type { Command } from 'commander';
 import { dockerBackup } from './backup.js';
 import { dockerList } from './list.js';
+import { dockerLogs } from './logs.js';
 import { dockerRestart } from './restart.js';
+import { dockerRestore } from './restore.js';
 import { dockerUpdate } from './update.js';
-export { dockerBackup, dockerList, dockerRestart, dockerUpdate };
+export { dockerBackup, dockerList, dockerLogs, dockerRestart, dockerRestore, dockerUpdate };
 /**
  * Registers `docker` subcommands on the given Commander program.
  * @param program Commander root or parent command.

package/dist/src/commands/docker/index.js

@@ -1,8 +1,10 @@
 import { dockerBackup } from './backup.js';
 import { dockerList } from './list.js';
+import { dockerLogs } from './logs.js';
 import { dockerRestart } from './restart.js';
+import { dockerRestore } from './restore.js';
 import { dockerUpdate } from './update.js';
-export { dockerBackup, dockerList, dockerRestart, dockerUpdate };
+export { dockerBackup, dockerList, dockerLogs, dockerRestart, dockerRestore, dockerUpdate };
 /**
  * Registers `docker` subcommands on the given Commander program.
  * @param program Commander root or parent command.
@@ -38,14 +40,48 @@ export function registerDockerCommands(program) {
     }));
     docker
         .command('restart')
-        .description('Restart a specific container/service')
-        .requiredOption('-s, --service <name>', 'Service name to restart')
+        .description('Restart service(s) (interactive multi-select if no -s)')
+        .option('-s, --service <names...>', 'Service(s) to restart, e.g. -s api worker (skips interactive picker)')
         .option('-f, --file <path>', 'Path to compose file (default: ./compose.yaml)')
-        .action((opts) => dockerRestart(opts));
+        .action((opts) => {
+        const raw = opts.service;
+        const services = raw === undefined ? undefined : Array.isArray(raw) ? raw : [raw];
+        return dockerRestart({ file: opts.file, services });
+    });
     docker
         .command('list')
         .description('List containers (docker compose ps)')
         .option('-f, --file <path>', 'Path to compose file (default: ./compose.yaml)')
         .action((opts) => dockerList(opts));
+    docker
+        .command('logs')
+        .description('Stream or print container logs (docker compose logs)')
+        .option('-f, --file <path>', 'Path to compose file (default: ./compose.yaml)')
+        .option('--follow', 'Follow log output')
+        .option('-n, --tail <n>', 'Number of lines to show from the end of the logs')
+        .option('-s, --service <name>', 'Service name (skips interactive picker)')
+        .option('--all', 'All services without prompting (skip the picker)')
+        .action((opts) => {
+        const tailNum = opts.tail !== undefined ? parseInt(opts.tail, 10) : undefined;
+        const tail = tailNum !== undefined && Number.isFinite(tailNum) && tailNum > 0 ? tailNum : undefined;
+        return dockerLogs({
+            file: opts.file,
+            follow: opts.follow,
+            tail,
+            service: opts.service,
+            allServices: opts.all === true
+        });
+    });
+    docker
+        .command('restore')
+        .description('Restore stack from a backup compose file (interactive list, or pass a path)')
+        .argument('[backup]', 'Path to backup compose file (optional)')
+        .option('-d, --dir <path>', 'Directory to scan for backups (default: ./docker_image_backups)')
+        .option('--force', 'Skip confirmation before restore')
+        .action((backup, opts) => dockerRestore({
+        backupCompose: backup,
+        backupDir: opts.dir,
+        force: opts.force
+    }));
 }
 //# sourceMappingURL=index.js.map

package/dist/src/commands/docker/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/docker/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AAEjE;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAElF,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iEAAiE,CAAC;SAC9E,MAAM,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;SAC7E,MAAM,CACL,kBAAkB,EAClB,wFAAwF,CACzF;SACA,MAAM,CAAC,SAAS,EAAE,yCAAyC,CAAC;SAC5D,MAAM,CAAC,CAAC,IAA0D,EAAE,EAAE;QACrE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC;gBAClB,UAAU,EAAE,IAAI,CAAC,OAAO;gBACxB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;QACD,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;SAC7E,MAAM,CAAC,SAAS,EAAE,0BAA0B,CAAC;SAC7C,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;SAC/D,MAAM,CAAC,CAAC,IAA0D,EAAE,EAAE,CACrE,YAAY,CAAC;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,MAAM,KAAK,KAAK;KAChC,CAAC,CACH,CAAC;IAEJ,MAAM;SACH,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,sCAAsC,CAAC;SACnD,cAAc,CAAC,sBAAsB,EAAE,yBAAyB,CAAC;SACjE,MAAM,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;SAC7E,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzC,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;SAC7E,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/docker/index.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/docker/logs.d.ts

@@ -0,0 +1,20 @@
+export interface DockerLogsOptions {
+    file?: string;
+    /** Follow log output (docker compose logs -f). */
+    follow?: boolean;
+    /** Number of lines from the end (docker compose logs --tail). */
+    tail?: number;
+    /** Compose service name; skips the picker when set. */
+    service?: string;
+    /**
+     * When true, show logs for all services without prompting.
+     * Use when `service` is omitted and you do not want the interactive picker.
+     */
+    allServices?: boolean;
+}
+/**
+ * Streams or prints logs from the compose stack (docker compose logs).
+ * With no service and without allServices, prompts for a service (or all).
+ * @param options Logs options.
+ */
+export declare function dockerLogs(options?: DockerLogsOptions): Promise<void>;

package/dist/src/commands/docker/logs.js

@@ -0,0 +1,28 @@
+import { execSync } from 'child_process';
+import { resolveComposeFile } from '../../utils/resolveComposeFile.js';
+import { promptComposeServiceForLogs } from './composeServices.js';
+/**
+ * Streams or prints logs from the compose stack (docker compose logs).
+ * With no service and without allServices, prompts for a service (or all).
+ * @param options Logs options.
+ */
+export async function dockerLogs(options = {}) {
+    const composeFile = resolveComposeFile(options.file);
+    const { follow, tail, allServices } = options;
+    let service = options.service;
+    if (!service && !allServices) {
+        service = await promptComposeServiceForLogs(composeFile);
+    }
+    const parts = [`docker compose -f "${composeFile}" logs`];
+    if (tail != null && tail > 0) {
+        parts.push(`--tail ${Math.floor(tail)}`);
+    }
+    if (follow) {
+        parts.push('-f');
+    }
+    if (service) {
+        parts.push(`"${service}"`);
+    }
+    execSync(parts.join(' '), { stdio: 'inherit' });
+}
+//# sourceMappingURL=logs.js.map

package/dist/src/commands/docker/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../../src/commands/docker/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAiBnE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAA6B,EAAE;IAC9D,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE9C,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9B,IAAI,CAAC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,OAAO,GAAG,MAAM,2BAA2B,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,sBAAsB,WAAW,QAAQ,CAAC,CAAC;IAC1D,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/src/commands/docker/restart.d.ts

@@ -1,11 +1,13 @@
 export interface DockerRestartOptions {
     file?: string;
-    service: string;
+    /** One service (skips picker); merged with `services` if both are set. */
+    service?: string;
+    /** One or more services (skips picker when non-empty). */
+    services?: string[];
 }
 /**
- * Restarts a specific container/service in the compose stack.
+ * Restarts container(s) in the compose stack.
+ * With no explicit services, prompts for one or more (checkbox).
  * @param options Restart options.
- * @param [options.file] Path to compose file (default ./compose.yaml).
- * @param options.service Service name to restart.
  */
-export declare function dockerRestart(options: DockerRestartOptions): Promise<void>;
+export declare function dockerRestart(options?: DockerRestartOptions): Promise<void>;

package/dist/src/commands/docker/restart.js

@@ -1,15 +1,27 @@
 import { execSync } from 'child_process';
 import { resolveComposeFile } from '../../utils/resolveComposeFile.js';
+import { promptComposeServiceForRestart } from './composeServices.js';
+function resolveExplicitServices(options) {
+    const merged = [...(options.services ?? []), ...(options.service ? [options.service] : [])];
+    const uniq = [...new Set(merged.map((s) => s.trim()).filter(Boolean))];
+    return uniq.length > 0 ? uniq : undefined;
+}
+function quoteServiceArg(name) {
+    return `"${name.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
 /**
- * Restarts a specific container/service in the compose stack.
+ * Restarts container(s) in the compose stack.
+ * With no explicit services, prompts for one or more (checkbox).
  * @param options Restart options.
- * @param [options.file] Path to compose file (default ./compose.yaml).
- * @param options.service Service name to restart.
  */
-export async function dockerRestart(options) {
+export async function dockerRestart(options = {}) {
     const composeFile = resolveComposeFile(options.file);
-    const { service } = options;
-    execSync(`docker compose -f "${composeFile}" restart "${service}"`, {
+    let services = resolveExplicitServices(options);
+    if (!services?.length) {
+        services = await promptComposeServiceForRestart(composeFile);
+    }
+    const restartArgs = services.map(quoteServiceArg).join(' ');
+    execSync(`docker compose -f "${composeFile}" restart ${restartArgs}`, {
         stdio: 'inherit'
     });
 }

package/dist/src/commands/docker/restart.js.map

@@ -1 +1 @@
-{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../../../src/commands/docker/restart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAOvE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA6B;IAC/D,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,QAAQ,CAAC,sBAAsB,WAAW,cAAc,OAAO,GAAG,EAAE;QAClE,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../../../src/commands/docker/restart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAUtE,SAAS,uBAAuB,CAAC,OAA6B;IAC5D,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAgC,EAAE;IACpE,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,QAAQ,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,GAAG,MAAM,8BAA8B,CAAC,WAAW,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5D,QAAQ,CAAC,sBAAsB,WAAW,aAAa,WAAW,EAAE,EAAE;QACpE,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/commands/docker/restore.d.ts

@@ -0,0 +1,13 @@
+export interface DockerRestoreOptions {
+    /** Explicit backup compose file (skips interactive list). */
+    backupCompose?: string;
+    /** Directory to scan for docker-compose_*.yaml (default: ./docker_image_backups). */
+    backupDir?: string;
+    /** Skip confirmation before down/pull/up. */
+    force?: boolean;
+}
+/**
+ * Restores the stack from a backup compose file produced by docker backup.
+ * With no backup path, lists backups under the backup dir and prompts for one.
+ */
+export declare function dockerRestore(options?: DockerRestoreOptions): Promise<void>;

package/dist/src/commands/docker/restore.js

@@ -0,0 +1,63 @@
+import { existsSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { Chalk } from 'chalk';
+import inquirer from 'inquirer';
+import { exitProcess } from '../../utils/processExit.js';
+import { DOCKER_IMAGE_BACKUP_DIR } from './backup.js';
+import { dockerUpdate } from './update.js';
+const chalk = new Chalk();
+const BACKUP_FILE_PREFIX = 'docker-compose_';
+const BACKUP_FILE_SUFFIX = '.yaml';
+function listBackupComposeFiles(backupDir) {
+    if (!existsSync(backupDir)) {
+        return [];
+    }
+    const entries = readdirSync(backupDir)
+        .filter((name) => name.startsWith(BACKUP_FILE_PREFIX) && name.endsWith(BACKUP_FILE_SUFFIX))
+        .map((name) => {
+        const fullPath = join(backupDir, name);
+        const mtimeMs = statSync(fullPath).mtimeMs;
+        const stampMatch = name.slice(BACKUP_FILE_PREFIX.length, -BACKUP_FILE_SUFFIX.length);
+        const date = new Date(mtimeMs);
+        const label = `${date.toLocaleString()}  ${stampMatch}`;
+        return { path: fullPath, label, mtimeMs };
+    })
+        .sort((a, b) => b.mtimeMs - a.mtimeMs);
+    return entries.map(({ path, label }) => ({ path, label }));
+}
+/**
+ * Restores the stack from a backup compose file produced by docker backup.
+ * With no backup path, lists backups under the backup dir and prompts for one.
+ */
+export async function dockerRestore(options = {}) {
+    const backupDir = options.backupDir ?? DOCKER_IMAGE_BACKUP_DIR;
+    let backupFile = options.backupCompose;
+    if (!backupFile) {
+        const choices = listBackupComposeFiles(backupDir);
+        if (choices.length === 0) {
+            console.error(chalk.red(`No backup compose files found in ${backupDir} (expected ${BACKUP_FILE_PREFIX}*${BACKUP_FILE_SUFFIX}). Run docker backup first.`));
+            exitProcess(1);
+        }
+        console.log(chalk.blue(`Backups in ${backupDir} (newest first):`));
+        const { selected } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'selected',
+                message: 'Select backup to restore',
+                choices: choices.map((c) => ({ name: c.label, value: c.path })),
+                pageSize: Math.min(20, Math.max(10, choices.length))
+            }
+        ]);
+        backupFile = selected;
+    }
+    if (!existsSync(backupFile)) {
+        console.error(chalk.red(`Error: Backup compose file not found at ${backupFile}`));
+        exitProcess(1);
+    }
+    await dockerUpdate({
+        backupFile,
+        force: options.force,
+        noBackup: true
+    });
+}
+//# sourceMappingURL=restore.js.map

package/dist/src/commands/docker/restore.js.map

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

package/dist/src/commands/index.d.ts

@@ -1,6 +1,6 @@
 import type { Command } from 'commander';
 export { dbEnd, dbExport, dbImport, dbList, dbRestore } from './db/index.js';
-export { dockerBackup, dockerList, dockerRestart, dockerUpdate } from './docker/index.js';
+export { dockerBackup, dockerList, dockerLogs, dockerRestart, dockerRestore, dockerUpdate } from './docker/index.js';
 /**
  * Registers all foundation-utils CLI commands on the given Commander program.
  * @param program Commander program instance.

package/dist/src/commands/index.js

@@ -1,7 +1,7 @@
 import { registerDbCommands } from './db/index.js';
 import { registerDockerCommands } from './docker/index.js';
 export { dbEnd, dbExport, dbImport, dbList, dbRestore } from './db/index.js';
-export { dockerBackup, dockerList, dockerRestart, dockerUpdate } from './docker/index.js';
+export { dockerBackup, dockerList, dockerLogs, dockerRestart, dockerRestore, dockerUpdate } from './docker/index.js';
 /**
  * Registers all foundation-utils CLI commands on the given Commander program.
  * @param program Commander program instance.

package/dist/src/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1F;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/src/index.d.ts

@@ -1 +1 @@
-export { registerCommands, dbEnd, dbExport, dbImport, dbList, dbRestore, dockerBackup, dockerList, dockerRestart, dockerUpdate } from './commands/index.js';
+export { registerCommands, dbEnd, dbExport, dbImport, dbList, dbRestore, dockerBackup, dockerList, dockerLogs, dockerRestart, dockerRestore, dockerUpdate } from './commands/index.js';

package/dist/src/index.js

@@ -1,2 +1,2 @@
-export { registerCommands, dbEnd, dbExport, dbImport, dbList, dbRestore, dockerBackup, dockerList, dockerRestart, dockerUpdate } from './commands/index.js';
+export { registerCommands, dbEnd, dbExport, dbImport, dbList, dbRestore, dockerBackup, dockerList, dockerLogs, dockerRestart, dockerRestore, dockerUpdate } from './commands/index.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,EACb,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACb,MAAM,qBAAqB,CAAC"}