crewly 1.11.4 → 1.11.6

package/dist/cli/backend/src/services/backup/backup-restore.service.js

@@ -0,0 +1,358 @@
+/**
+ * Backup Restore Service (P1)
+ *
+ * Restores a workspace archive (produced by BackupArchiveService) onto this
+ * machine to resume work after a machine dies / is replaced.
+ *
+ * Safety model:
+ *   - `preview()` is non-destructive (dry-run) — reports the plan + conflicts.
+ *   - `restore()` snapshots the CURRENT CREWLY_HOME first (rollback), refuses
+ *     on overlapping ids unless mode='overwrite', then applies and — on any
+ *     failure — rolls back from the snapshot.
+ *   - device.json is NEVER in the archive, so the target keeps its own identity.
+ *   - cron `nextRunAt` is reset to null so the scheduler recomputes from
+ *     `cronExpression` (no stale fires); runtime/session state is wiped so
+ *     agents start clean.
+ *
+ * See specs/2026-06-07-workspace-backup.md.
+ *
+ * @module services/backup/backup-restore.service
+ */
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { extract as tarExtract } from 'tar';
+import { getCrewlyHomePath } from '../core/crewly-home.utils.js';
+import { LoggerService } from '../core/logger.service.js';
+import { BACKUP_SCHEMA_VERSION, } from './backup.types.js';
+/** Runtime/session state wiped on restore so agents start clean (relative to home). */
+const RUNTIME_WIPE = ['runtime.json', '.orchestrator-state', 'session-state.json'];
+/** Cron files whose `nextRunAt` is reset so the scheduler recomputes. */
+const CRON_FILES = ['recurring-checks.json', 'one-time-checks.json'];
+/** Thrown by restore() when mode='abort' and the target has overlapping data. */
+export class RestoreConflictError extends Error {
+    plan;
+    constructor(message, plan) {
+        super(message);
+        this.plan = plan;
+        this.name = 'RestoreConflictError';
+    }
+}
+/**
+ * Service that restores workspace backup archives.
+ */
+export class BackupRestoreService {
+    logger;
+    constructor(logger) {
+        this.logger = logger ?? LoggerService.getInstance().createComponentLogger('BackupRestore');
+    }
+    /**
+     * Non-destructive restore plan (dry-run): what would be created/overwritten,
+     * id conflicts, resolved project paths, and what's regenerated/discarded.
+     *
+     * @param options - Restore options (mode/pathMap affect conflict + path resolution)
+     * @returns The plan; never writes to disk
+     */
+    async preview(options) {
+        const home = options.homePath ?? getCrewlyHomePath();
+        const temp = await this.extract(options.archivePath);
+        try {
+            const manifest = await this.readManifest(temp);
+            return await this.buildPlan(manifest, home, options);
+        }
+        finally {
+            await fs.rm(temp, { recursive: true, force: true }).catch(() => undefined);
+        }
+    }
+    /**
+     * Restore the archive onto this machine.
+     *
+     * @param options - Restore options
+     * @returns Summary of what was restored
+     * @throws RestoreConflictError when mode='abort' and ids overlap
+     * @throws Error on integrity failure or unsupported schema (no changes applied)
+     */
+    async restore(options) {
+        const home = options.homePath ?? getCrewlyHomePath();
+        const mode = options.mode ?? 'abort';
+        const temp = await this.extract(options.archivePath);
+        try {
+            const manifest = await this.readManifest(temp);
+            if (manifest.schemaVersion > BACKUP_SCHEMA_VERSION) {
+                throw new Error(`Backup schemaVersion ${manifest.schemaVersion} is newer than supported ${BACKUP_SCHEMA_VERSION}; upgrade Crewly to restore it`);
+            }
+            await this.verifyChecksums(temp, manifest);
+            const plan = await this.buildPlan(manifest, home, options);
+            if (mode === 'abort' && (plan.conflicts.teams.length > 0 || plan.conflicts.projects.length > 0)) {
+                throw new RestoreConflictError(`Restore aborted: target already has ${plan.conflicts.teams.length} team(s) and ${plan.conflicts.projects.length} project(s) from this backup. Re-run with mode='overwrite' to replace them.`, plan);
+            }
+            // 1) Snapshot current home for rollback (best-effort full copy, sans backups/).
+            const rollbackSnapshotPath = path.join(home, 'backups', `pre-restore-${options.now.replace(/[:.]/g, '-')}`);
+            await fs.mkdir(home, { recursive: true });
+            await this.copyTree(home, rollbackSnapshotPath, new Set(['backups']));
+            try {
+                // 2) Apply
+                const restoredGlobalFiles = await this.applyGlobals(temp, home);
+                const restoredProjects = await this.applyProjects(temp, manifest, plan);
+                const chatDbRestored = await this.applyChatDb(temp, home, manifest);
+                await this.rewriteProjectsJson(home, plan);
+                await this.resetCron(home);
+                await this.wipeRuntime(home);
+                this.logger.info('Workspace restore applied', {
+                    restoredGlobalFiles,
+                    restoredProjects,
+                    chatDbRestored,
+                    rollbackSnapshotPath,
+                });
+                return { restoredGlobalFiles, restoredProjects, chatDbRestored, rollbackSnapshotPath, warnings: plan.warnings };
+            }
+            catch (applyErr) {
+                // 3) Rollback from the pre-restore snapshot.
+                this.logger.error('Restore failed mid-apply — rolling back', {
+                    error: applyErr instanceof Error ? applyErr.message : String(applyErr),
+                });
+                await this.copyTree(rollbackSnapshotPath, home, new Set(['backups'])).catch(() => undefined);
+                throw applyErr;
+            }
+        }
+        finally {
+            await fs.rm(temp, { recursive: true, force: true }).catch(() => undefined);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    /** Extract the archive to a fresh temp dir; returns its path. */
+    async extract(archivePath) {
+        if (!(await fs.stat(archivePath).catch(() => null))?.isFile()) {
+            throw new Error(`Backup archive not found: ${archivePath}`);
+        }
+        const temp = await fs.mkdtemp(path.join(os.tmpdir(), 'crewly-restore-'));
+        await tarExtract({ file: archivePath, cwd: temp });
+        return temp;
+    }
+    /** Read + minimally validate the manifest from an extracted archive. */
+    async readManifest(temp) {
+        const raw = await fs.readFile(path.join(temp, 'manifest.json'), 'utf8').catch(() => null);
+        if (!raw)
+            throw new Error('Invalid backup: manifest.json missing');
+        let manifest;
+        try {
+            manifest = JSON.parse(raw);
+        }
+        catch {
+            throw new Error('Invalid backup: manifest.json is not valid JSON');
+        }
+        if (typeof manifest.schemaVersion !== 'number' || !Array.isArray(manifest.global)) {
+            throw new Error('Invalid backup: manifest is missing required fields');
+        }
+        return manifest;
+    }
+    /** Verify every recorded file's sha256 against the extracted bytes. */
+    async verifyChecksums(temp, manifest) {
+        const entries = [
+            ...manifest.global,
+            ...manifest.projects.flatMap((p) => p.files),
+        ];
+        if (manifest.chatDb.included && manifest.chatDb.sha256) {
+            entries.push({ path: 'chat.db', sha256: manifest.chatDb.sha256 });
+        }
+        for (const e of entries) {
+            const abs = path.join(temp, ...e.path.split('/'));
+            const actual = await sha256File(abs).catch(() => null);
+            if (actual !== e.sha256) {
+                throw new Error(`Backup integrity check failed for ${e.path} (checksum mismatch or missing)`);
+            }
+        }
+    }
+    /** Build the dry-run plan (conflicts, resolved project paths, warnings). */
+    async buildPlan(manifest, home, options) {
+        const warnings = [];
+        // Teams present in the backup (ids parsed from home/teams/<id>/...).
+        const backupTeamIds = new Set();
+        for (const g of manifest.global) {
+            const m = g.path.match(/^home\/teams\/([^/]+)\//);
+            if (m && m[1] !== 'orchestrator')
+                backupTeamIds.add(m[1]);
+        }
+        const targetTeamIds = new Set((await fs.readdir(path.join(home, 'teams'), { withFileTypes: true }).catch(() => []))
+            .filter((d) => d.isDirectory() && d.name !== 'orchestrator')
+            .map((d) => d.name));
+        const conflictTeams = [...backupTeamIds].filter((id) => targetTeamIds.has(id));
+        const targetProjectIds = new Set((await this.readJson(path.join(home, 'projects.json'), [])).map((p) => p.id));
+        const conflictProjects = manifest.projects.map((p) => p.id).filter((id) => targetProjectIds.has(id));
+        const projects = [];
+        for (const p of manifest.projects) {
+            const mapped = options.pathMap?.[p.sourcePath];
+            let targetPath = null;
+            if (mapped)
+                targetPath = mapped;
+            else if (await this.pathExists(p.sourcePath))
+                targetPath = p.sourcePath;
+            const targetExists = targetPath ? await this.pathExists(targetPath) : false;
+            if (!targetPath) {
+                warnings.push(`Project "${p.name}" (${p.sourcePath}) has no target path on this machine — re-clone ${p.git.remote ?? 'the repo'} and pass --map ${p.sourcePath}=<new-path> to restore its .crewly data.`);
+            }
+            else if (!targetExists) {
+                warnings.push(`Project "${p.name}" target path ${targetPath} does not exist yet — its .crewly will be created there.`);
+            }
+            projects.push({ id: p.id, name: p.name, sourcePath: p.sourcePath, targetPath, git: p.git, targetExists });
+        }
+        return {
+            ok: !(options.mode !== 'overwrite' && (conflictTeams.length > 0 || conflictProjects.length > 0)),
+            manifestCreatedAt: manifest.createdAt,
+            sourceHomePath: manifest.sourceHomePath,
+            conflicts: { teams: conflictTeams, projects: conflictProjects },
+            globalFileCount: manifest.global.length,
+            projects,
+            chatDbIncluded: manifest.chatDb.included,
+            regenerated: ['device.json (kept this machine\'s identity — not in backup)'],
+            discarded: [...RUNTIME_WIPE, 'in-flight cron nextRunAt (recomputed)'],
+            warnings,
+        };
+    }
+    /** Copy every manifest global file from temp/home/* into CREWLY_HOME. */
+    async applyGlobals(temp, home) {
+        let n = 0;
+        for (const g of (await this.readManifest(temp)).global) {
+            // g.path = 'home/<rel>'
+            const rel = g.path.replace(/^home\//, '');
+            const src = path.join(temp, ...g.path.split('/'));
+            const dest = path.join(home, ...rel.split('/'));
+            await fs.mkdir(path.dirname(dest), { recursive: true });
+            await fs.copyFile(src, dest);
+            n += 1;
+        }
+        return n;
+    }
+    /** Copy each resolved project's `.crewly/` from the archive to its target path. */
+    async applyProjects(temp, manifest, plan) {
+        let n = 0;
+        const planById = new Map(plan.projects.map((p) => [p.id, p]));
+        for (const proj of manifest.projects) {
+            const target = planById.get(proj.id)?.targetPath;
+            if (!target)
+                continue; // unresolved — warned in the plan
+            for (const f of proj.files) {
+                // f.path = 'projects/<id>/.crewly/<rel>' → dest = <target>/.crewly/<rel>
+                const rel = f.path.replace(new RegExp(`^projects/${proj.id}/`), '');
+                const src = path.join(temp, ...f.path.split('/'));
+                const dest = path.join(target, ...rel.split('/'));
+                await fs.mkdir(path.dirname(dest), { recursive: true });
+                await fs.copyFile(src, dest);
+            }
+            n += 1;
+        }
+        return n;
+    }
+    /** Atomically swap chat.db into place (temp copy → rename). */
+    async applyChatDb(temp, home, manifest) {
+        if (!manifest.chatDb.included)
+            return false;
+        const src = path.join(temp, 'chat.db');
+        const finalDest = path.join(home, 'chat.db');
+        const tmpDest = path.join(home, `chat.db.restore-${Date.now()}.tmp`);
+        await fs.mkdir(home, { recursive: true });
+        await fs.copyFile(src, tmpDest);
+        await fs.rename(tmpDest, finalDest);
+        // Drop stale WAL/SHM sidecars so SQLite reopens cleanly from the restored db.
+        for (const sidecar of ['chat.db-wal', 'chat.db-shm']) {
+            await fs.rm(path.join(home, sidecar), { force: true }).catch(() => undefined);
+        }
+        return true;
+    }
+    /** Rewrite projects.json `path` entries using the resolved plan mapping. */
+    async rewriteProjectsJson(home, plan) {
+        const file = path.join(home, 'projects.json');
+        const projects = await this.readJson(file, []);
+        if (projects.length === 0)
+            return;
+        const targetById = new Map(plan.projects.map((p) => [p.id, p.targetPath]));
+        let changed = false;
+        for (const proj of projects) {
+            const target = targetById.get(proj.id);
+            if (target && target !== proj.path) {
+                proj.path = target;
+                changed = true;
+            }
+        }
+        if (changed)
+            await fs.writeFile(file, JSON.stringify(projects, null, 2), 'utf8');
+    }
+    /** Reset cron `nextRunAt` so the scheduler recomputes from cronExpression. */
+    async resetCron(home) {
+        for (const name of CRON_FILES) {
+            const file = path.join(home, name);
+            const items = await this.readJson(file, []);
+            if (!Array.isArray(items) || items.length === 0)
+                continue;
+            let changed = false;
+            for (const item of items) {
+                if ('nextRunAt' in item) {
+                    item.nextRunAt = null;
+                    changed = true;
+                }
+            }
+            if (changed)
+                await fs.writeFile(file, JSON.stringify(items, null, 2), 'utf8');
+        }
+    }
+    /** Remove runtime/session state so agents start clean on the restored machine. */
+    async wipeRuntime(home) {
+        for (const name of RUNTIME_WIPE) {
+            await fs.rm(path.join(home, name), { recursive: true, force: true }).catch(() => undefined);
+        }
+    }
+    // ---- small fs helpers ----
+    /** Recursively copy a directory tree, skipping top-level names in `skipTop`. */
+    async copyTree(srcDir, destDir, skipTop) {
+        const entries = await fs.readdir(srcDir, { withFileTypes: true }).catch(() => []);
+        await fs.mkdir(destDir, { recursive: true });
+        for (const e of entries) {
+            if (skipTop.has(e.name))
+                continue;
+            const s = path.join(srcDir, e.name);
+            const d = path.join(destDir, e.name);
+            if (e.isDirectory())
+                await this.copyTreeRec(s, d);
+            else if (e.isFile())
+                await fs.copyFile(s, d);
+        }
+    }
+    /** Recursive copy without the top-level skip filter. */
+    async copyTreeRec(srcDir, destDir) {
+        await fs.mkdir(destDir, { recursive: true });
+        for (const e of await fs.readdir(srcDir, { withFileTypes: true })) {
+            const s = path.join(srcDir, e.name);
+            const d = path.join(destDir, e.name);
+            if (e.isDirectory())
+                await this.copyTreeRec(s, d);
+            else if (e.isFile())
+                await fs.copyFile(s, d);
+        }
+    }
+    async pathExists(p) {
+        return !!(await fs.stat(p).catch(() => null));
+    }
+    async readJson(file, fallback) {
+        try {
+            return JSON.parse(await fs.readFile(file, 'utf8'));
+        }
+        catch {
+            return fallback;
+        }
+    }
+}
+/** Stream a file through SHA-256 → hex digest. */
+async function sha256File(filePath) {
+    return new Promise((resolve, reject) => {
+        const hash = createHash('sha256');
+        const stream = createReadStream(filePath);
+        stream.on('data', (c) => hash.update(c));
+        stream.on('error', reject);
+        stream.on('end', () => resolve(hash.digest('hex')));
+    });
+}
+//# sourceMappingURL=backup-restore.service.js.map

package/dist/cli/backend/src/services/backup/backup-restore.service.js.map

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

package/dist/cli/backend/src/services/backup/backup.types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Types for the Workspace Backup feature.
+ *
+ * A backup is a single `.tar.gz` archive containing a top-level
+ * `manifest.json` plus the captured `CREWLY_HOME` globals, each project's
+ * `.crewly/` tree, and (optionally) `chat.db`. See
+ * specs/2026-06-07-workspace-backup.md.
+ *
+ * @module services/backup/backup.types
+ */
+/** Manifest schema version — bump on any breaking layout/field change. */
+export declare const BACKUP_SCHEMA_VERSION = 1;
+/** A single captured file recorded in the manifest for integrity + listing. */
+export interface BackupFileEntry {
+    /** Path inside the archive, relative to the archive root. */
+    path: string;
+    /** SHA-256 of the file content (hex). */
+    sha256: string;
+    /** Size in bytes. */
+    bytes: number;
+}
+/** Git provenance for a captured project so restore can re-clone the source tree. */
+export interface BackupProjectGit {
+    /** `origin` remote URL, or null when not a git repo / no origin. */
+    remote: string | null;
+    /** HEAD commit sha, or null when unavailable. */
+    commit: string | null;
+}
+/** One project's captured `.crewly/` data + provenance. */
+export interface BackupProjectEntry {
+    /** Stable project id (from projects.json). */
+    id: string;
+    /** Human-readable project name. */
+    name: string;
+    /** Absolute path on the SOURCE machine (used for restore path-rewriting). */
+    sourcePath: string;
+    /** Git provenance for re-clone on restore. */
+    git: BackupProjectGit;
+    /** Captured files under `projects/<id>/` in the archive. */
+    files: BackupFileEntry[];
+}
+/** chat.db capture record. */
+export interface BackupChatDb {
+    /** Whether chat.db was included (false when excluded or the native module is absent). */
+    included: boolean;
+    /** SHA-256 of the captured db, when included. */
+    sha256?: string;
+    /** Size in bytes, when included. */
+    bytes?: number;
+    /** Reason it was skipped, when not included. */
+    skippedReason?: string;
+}
+/** Encryption envelope descriptor. v1 archives are unencrypted on disk; Cloud adds SSE. */
+export interface BackupCrypto {
+    /** `none` for v1 local archives. `sse` once parked in the cloud. */
+    mode: 'none' | 'sse';
+}
+/** Top-level archive manifest. */
+export interface BackupManifest {
+    schemaVersion: number;
+    crewlyVersion: string;
+    /** ISO timestamp — the logical point-in-time of the snapshot. */
+    createdAt: string;
+    /** Source device id (observability only; NEVER restored). */
+    sourceDeviceId: string | null;
+    sourceDeviceName: string | null;
+    /** Source `CREWLY_HOME` absolute path — restore uses it for path rewriting. */
+    sourceHomePath: string;
+    /** Owner account (JWT `sub`/googleId). Null for local-only archives; stamped by Cloud on upload. */
+    ownerSub: string | null;
+    /** Captured CREWLY_HOME global files (relative to `home/` in the archive). */
+    global: BackupFileEntry[];
+    /** Captured per-project `.crewly/` data. */
+    projects: BackupProjectEntry[];
+    chatDb: BackupChatDb;
+    crypto: BackupCrypto;
+}
+/** Options for building an archive. */
+export interface CreateBackupOptions {
+    /** Output archive path. Defaults to `CREWLY_HOME/backups/workspace-<ts>.tar.gz`. */
+    outPath?: string;
+    /** Exclude chat.db (smaller archive, avoids SQLite capture). Default false. */
+    excludeChatDb?: boolean;
+    /** Override CREWLY_HOME (tests). Defaults to getCrewlyHomePath(). */
+    homePath?: string;
+    /** ISO timestamp for the snapshot point. Defaults to caller-supplied now (no Date in lib). */
+    createdAt: string;
+    /** Owner sub to stamp (usually null locally; Cloud stamps on upload). */
+    ownerSub?: string | null;
+    /** Source device id/name for the manifest (observability). */
+    sourceDeviceId?: string | null;
+    sourceDeviceName?: string | null;
+}
+/** Result of a successful archive build. */
+export interface CreateBackupResult {
+    archivePath: string;
+    manifest: BackupManifest;
+    /** Total uncompressed bytes captured (for quota/UX). */
+    totalBytes: number;
+}
+/** How to handle a target that already has overlapping data. */
+export type RestoreMode = 'abort' | 'overwrite';
+/** Options for restoring an archive onto this machine. */
+export interface RestoreOptions {
+    /** Archive (.tar.gz) to restore. */
+    archivePath: string;
+    /** Target CREWLY_HOME. Defaults to getCrewlyHomePath(). */
+    homePath?: string;
+    /** Conflict policy. Default 'abort'. */
+    mode?: RestoreMode;
+    /**
+     * Source→target absolute path remap for projects, e.g.
+     * `{ '/Users/alice/web': '/Users/bob/web' }`. When a source path isn't
+     * mapped, restore reuses it if it exists on the target, else records a
+     * warning and skips that project's `.crewly/` write.
+     */
+    pathMap?: Record<string, string>;
+    /** ISO timestamp used to name the pre-restore rollback snapshot. */
+    now: string;
+}
+/** One project's restore plan entry. */
+export interface RestoreProjectPlan {
+    id: string;
+    name: string;
+    sourcePath: string;
+    /** Resolved target path (pathMap → existing sourcePath → null when unresolved). */
+    targetPath: string | null;
+    git: {
+        remote: string | null;
+        commit: string | null;
+    };
+    /** Whether the resolved target path currently exists on this machine. */
+    targetExists: boolean;
+}
+/** Non-destructive restore plan (dry-run). */
+export interface RestorePlan {
+    /** False when mode='abort' and conflicts exist (apply would refuse). */
+    ok: boolean;
+    manifestCreatedAt: string;
+    sourceHomePath: string;
+    /** Stable ids present on BOTH the backup and this machine (would be overwritten). */
+    conflicts: {
+        teams: string[];
+        projects: string[];
+    };
+    globalFileCount: number;
+    projects: RestoreProjectPlan[];
+    chatDbIncluded: boolean;
+    /** Things to regenerate (device identity) / discard (runtime/session). */
+    regenerated: string[];
+    discarded: string[];
+    warnings: string[];
+}
+/** Result of an applied restore. */
+export interface RestoreResult {
+    restoredGlobalFiles: number;
+    restoredProjects: number;
+    chatDbRestored: boolean;
+    /** Where the pre-restore snapshot of the current CREWLY_HOME was saved. */
+    rollbackSnapshotPath: string;
+    warnings: string[];
+}
+//# sourceMappingURL=backup.types.d.ts.map

package/dist/cli/backend/src/services/backup/backup.types.d.ts.map

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

package/dist/cli/backend/src/services/backup/backup.types.js

@@ -0,0 +1,13 @@
+/**
+ * Types for the Workspace Backup feature.
+ *
+ * A backup is a single `.tar.gz` archive containing a top-level
+ * `manifest.json` plus the captured `CREWLY_HOME` globals, each project's
+ * `.crewly/` tree, and (optionally) `chat.db`. See
+ * specs/2026-06-07-workspace-backup.md.
+ *
+ * @module services/backup/backup.types
+ */
+/** Manifest schema version — bump on any breaking layout/field change. */
+export const BACKUP_SCHEMA_VERSION = 1;
+//# sourceMappingURL=backup.types.js.map

package/dist/cli/backend/src/services/backup/backup.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/backup/backup.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC"}