crewly 1.20.303 → 1.20.304

package/dist/backend/backend/src/services/team-move/team-move-git.js

@@ -0,0 +1,198 @@
+/**
+ * Git side of the team move: read a repository's state on the source, and put
+ * a repository back at a recorded branch and commit on the target.
+ *
+ * Code never travels in the package. The source records where each project's
+ * repository lives (remote, branch, head, dirty) and refuses to move while
+ * work exists only on that machine; the target fetches the code itself with
+ * its own git credentials.
+ *
+ * @module services/team-move/team-move-git
+ */
+import { execFile } from 'node:child_process';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { promisify } from 'node:util';
+import { TEAM_MOVE_CONSTANTS } from '../../constants.js';
+const execFileAsync = promisify(execFile);
+/** Git probes are quick; a hung one must not stall the export. */
+const PROBE_TIMEOUT_MS = 20_000;
+/** Never prompt: a missing credential must fail, not hang. */
+const NON_INTERACTIVE_ENV = {
+    GIT_TERMINAL_PROMPT: '0',
+    GIT_SSH_COMMAND: 'ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new',
+};
+/**
+ * Run git in a directory.
+ *
+ * @param cwd - Working directory
+ * @param args - Git arguments
+ * @param timeoutMs - Kill after this long
+ * @returns Trimmed stdout
+ * @throws Error with git's stderr
+ */
+export async function git(cwd, args, timeoutMs = PROBE_TIMEOUT_MS) {
+    try {
+        const { stdout } = await execFileAsync('git', ['-C', cwd, ...args], {
+            timeout: timeoutMs,
+            env: { ...process.env, ...NON_INTERACTIVE_ENV },
+            maxBuffer: 16 * 1024 * 1024,
+        });
+        return stdout.trim();
+    }
+    catch (error) {
+        const e = error;
+        throw new Error((e.stderr?.trim() || e.message || 'git failed').split('\n').slice(0, 3).join(' | '));
+    }
+}
+/** Like {@link git} but null on failure. */
+async function gitOrNull(cwd, args) {
+    try {
+        const out = await git(cwd, args);
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the state of the repository a project lives in.
+ *
+ * `.crewly/` is ignored when judging "dirty": Crewly's own data goes through
+ * the package, so it must not block a move. The remote is read as configured
+ * (`git config`), not through `url.*.insteadOf` rewrites, which are local to
+ * this machine.
+ *
+ * @param project - Project identity
+ * @param project.id - Project id
+ * @param project.name - Project name
+ * @param project.path - Absolute project path
+ * @returns Repo record (never throws)
+ */
+export async function inspectRepo(project) {
+    const base = {
+        projectId: project.id,
+        projectName: project.name,
+        path: project.path,
+        remoteUrl: null,
+        branch: null,
+        headSha: null,
+        dirty: false,
+        unpushed: 0,
+    };
+    const exists = await fs.stat(project.path).then((s) => s.isDirectory(), () => false);
+    if (!exists)
+        return { ...base, note: 'project folder does not exist on this machine' };
+    const top = await gitOrNull(project.path, ['rev-parse', '--show-toplevel']);
+    if (!top)
+        return { ...base, note: 'not a git repository — files are not moved, only Crewly data' };
+    const [remoteUrl, branch, headSha, status] = await Promise.all([
+        gitOrNull(project.path, ['config', '--get', 'remote.origin.url']),
+        gitOrNull(project.path, ['symbolic-ref', '--quiet', '--short', 'HEAD']),
+        gitOrNull(project.path, ['rev-parse', 'HEAD']),
+        gitOrNull(project.path, ['status', '--porcelain', '--untracked-files=normal', '--', '.', ':(exclude).crewly']),
+    ]);
+    // Commits that no remote-tracking branch has: work that exists only here.
+    const unpushedRaw = headSha ? await gitOrNull(project.path, ['rev-list', '--count', 'HEAD', '--not', '--remotes']) : null;
+    const unpushed = unpushedRaw ? Number.parseInt(unpushedRaw, 10) || 0 : 0;
+    return {
+        ...base,
+        remoteUrl,
+        branch,
+        headSha,
+        dirty: status !== null,
+        unpushed,
+        ...(remoteUrl ? {} : { note: 'no git remote — the target cannot fetch this code' }),
+    };
+}
+/**
+ * Describe what the owner has to push or commit before a move.
+ *
+ * @param repos - Repos from {@link inspectRepo}
+ * @returns One line per repo that blocks the move (empty when none)
+ */
+export function describeBlockingRepos(repos) {
+    const lines = [];
+    for (const r of repos) {
+        const problems = [];
+        if (r.dirty)
+            problems.push('uncommitted changes (commit and push them)');
+        if (r.unpushed > 0)
+            problems.push(`${r.unpushed} commit${r.unpushed === 1 ? '' : 's'} not pushed${r.branch ? ` on ${r.branch}` : ''}`);
+        if (problems.length > 0)
+            lines.push(`${r.projectName} (${r.path}): ${problems.join(', ')}`);
+    }
+    return lines;
+}
+/**
+ * Put a repository at the recorded remote, branch and commit. Works for an
+ * empty folder, a folder that only holds `.crewly/` and an existing clone.
+ * Never discards local changes and never prompts for credentials.
+ *
+ * @param dest - Target folder (created when missing)
+ * @param repo - Recorded state from the source
+ * @param timeoutMs - Per git network call
+ * @returns Result (never throws)
+ */
+export async function restoreRepo(dest, repo, timeoutMs = TEAM_MOVE_CONSTANTS.GIT_TIMEOUT_MS) {
+    const warnings = [];
+    if (!repo.remoteUrl)
+        return { ok: false, branch: null, headSha: null, warnings, error: 'the source repository has no remote' };
+    try {
+        await fs.mkdir(dest, { recursive: true });
+        const hasGit = await fs.stat(path.join(dest, '.git')).then(() => true, () => false);
+        if (!hasGit)
+            await git(dest, ['init', '-q']);
+        const currentRemote = await gitOrNull(dest, ['config', '--get', 'remote.origin.url']);
+        if (!currentRemote)
+            await git(dest, ['remote', 'add', 'origin', repo.remoteUrl]);
+        else if (currentRemote !== repo.remoteUrl)
+            warnings.push(`origin is ${currentRemote}, expected ${repo.remoteUrl}; kept as is`);
+        await git(dest, ['fetch', '--tags', '--prune', 'origin'], timeoutMs);
+        const dirty = (await gitOrNull(dest, ['status', '--porcelain', '--untracked-files=no'])) !== null;
+        const head = await gitOrNull(dest, ['rev-parse', '--verify', '--quiet', 'HEAD']);
+        if (dirty) {
+            warnings.push('the folder already has local changes; the checkout was left alone');
+        }
+        else if (repo.branch) {
+            const remoteBranch = `origin/${repo.branch}`;
+            const remoteHas = await gitOrNull(dest, ['rev-parse', '--verify', '--quiet', `${remoteBranch}^{commit}`]);
+            if (!remoteHas) {
+                warnings.push(`branch ${repo.branch} is not on the remote`);
+            }
+            else {
+                let target = remoteBranch;
+                if (repo.headSha) {
+                    const sha = await gitOrNull(dest, ['rev-parse', '--verify', '--quiet', `${repo.headSha}^{commit}`]);
+                    if (sha)
+                        target = sha;
+                    else
+                        warnings.push(`recorded commit ${repo.headSha.slice(0, 8)} is not on the remote; using the tip of ${repo.branch}`);
+                }
+                // `-B` moves the branch to the recorded commit; untracked files (.crewly) stay.
+                await git(dest, ['checkout', '-q', '-B', repo.branch, target]);
+                await gitOrNull(dest, ['branch', '--set-upstream-to', remoteBranch, repo.branch]);
+            }
+        }
+        else if (repo.headSha) {
+            const sha = await gitOrNull(dest, ['rev-parse', '--verify', '--quiet', `${repo.headSha}^{commit}`]);
+            if (sha)
+                await git(dest, ['checkout', '-q', '--detach', sha]);
+            else
+                warnings.push(`recorded commit ${repo.headSha.slice(0, 8)} is not on the remote`);
+        }
+        else if (!head) {
+            warnings.push('no branch or commit was recorded; nothing was checked out');
+        }
+        return {
+            ok: true,
+            branch: await gitOrNull(dest, ['symbolic-ref', '--quiet', '--short', 'HEAD']),
+            headSha: await gitOrNull(dest, ['rev-parse', 'HEAD']),
+            warnings,
+        };
+    }
+    catch (error) {
+        return { ok: false, branch: null, headSha: null, warnings, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+//# sourceMappingURL=team-move-git.js.map

package/dist/backend/backend/src/services/team-move/team-move-git.js.map

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

package/dist/backend/backend/src/services/team-move/team-move-importer.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Team move importer (target machine).
+ *
+ * Takes a downloaded, encrypted package and applies it to this machine in
+ * idempotent, journaled steps, so a crash or restart resumes where it stopped:
+ *
+ *   decrypt -> validate -> projects -> repos -> project data -> agents ->
+ *   records -> team -> start -> report
+ *
+ * The team is registered (and therefore started) only after every other piece
+ * is in place. Project folders are relocated under this machine's projects
+ * root; the mapping is recorded and absolute paths inside the moved text files
+ * are rewritten to match. Repositories are cloned at the recorded branch and
+ * commit with this machine's own git credentials.
+ *
+ * @module services/team-move/team-move-importer
+ */
+import type { Project, ScheduledMessage, Team } from '../../types/index.js';
+import type { WorkItem } from '../../types/v2/work-item.types.js';
+import { type ApplyChatResult, type ChatRecords } from './team-move-chat.js';
+import { restoreRepo } from './team-move-git.js';
+import { MoveJournal } from './team-move-journal.js';
+import type { TeamMoveImportReport } from './team-move.types.js';
+/** Thrown for a package this machine must not apply. */
+export declare class TeamMoveImportError extends Error {
+    readonly code: 'invalid_package' | 'conflict' | 'no_space' | 'unsupported';
+    constructor(message: string, code?: 'invalid_package' | 'conflict' | 'no_space' | 'unsupported');
+}
+/** Collaborators of the importer. */
+export interface ImportDeps {
+    home?: string;
+    crewlyVersion: string;
+    storage: {
+        getTeams(): Promise<Team[]>;
+        getProjects(): Promise<Project[]>;
+        saveProject(project: Project): Promise<void>;
+        saveTeam(team: Team): Promise<void>;
+        getScheduledMessages(): Promise<ScheduledMessage[]>;
+        saveScheduledMessage(message: ScheduledMessage): Promise<void>;
+    };
+    /** Add work items that are not in the pool yet; returns how many were added. */
+    addWorkItems: (items: WorkItem[]) => Promise<number>;
+    /** Add decisions that are not there yet; returns how many were added. */
+    addDecisions: (decisions: Array<Record<string, unknown>>) => Promise<number>;
+    /** Make the Slack channel mapping known before the team exists (no duplicate channel). */
+    adoptSlackMapping: (mapping: Record<string, unknown>) => Promise<boolean>;
+    /** Add chat channels and members (defaults to writing the chat-v2 database). */
+    applyChat?: (records: ChatRecords) => ApplyChatResult;
+    /** Start the team; returns ok/error. Omit to import without starting. */
+    startTeam?: (teamId: string) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** Which tools exist here (default: PATH lookup). */
+    hasCommand?: (binary: string) => boolean;
+    /** Runtime id to logged-in. */
+    runtimeLogins?: () => Promise<Record<string, boolean>>;
+    /** Free disk bytes (tests). */
+    freeDisk?: (dir: string) => Promise<number | null>;
+    restoreRepo?: typeof restoreRepo;
+    now?: () => string;
+}
+/** Inputs of one import. */
+export interface ImportInput {
+    moveId: string;
+    /** Downloaded ciphertext. */
+    packageFile: string;
+    /** Base64 PKCS8 private key of this move. */
+    privateKey: string;
+    /** Expected ciphertext hash (from Cloud), verified before decrypting. */
+    expectedSha256?: string;
+}
+/** The projects root of this machine. */
+export declare function projectsRoot(env?: NodeJS.ProcessEnv, homeDir?: string): string;
+/** The importer. */
+export declare class TeamMoveImporter {
+    private readonly deps;
+    private readonly home;
+    private readonly now;
+    private readonly restore;
+    constructor(deps: ImportDeps);
+    /**
+     * Apply a package. Safe to call again for the same move: finished steps are
+     * skipped.
+     *
+     * @param input - Move id, package file and key
+     * @param journal - Journal of this move
+     * @returns The report for the owner
+     * @throws TeamMoveImportError for a package that must not be applied
+     */
+    run(input: ImportInput, journal?: MoveJournal): Promise<TeamMoveImportReport>;
+    private validate;
+    /**
+     * Decide where each project lives here and register it under its own id.
+     * A project that already exists here (same id) keeps its folder.
+     */
+    private registerProjects;
+    private hasForeignContent;
+    /** Clone each project's repository at the recorded branch and commit. */
+    private cloneRepos;
+    /**
+     * Copy a package directory into a destination. A file that exists with other
+     * content is replaced (the package is the team's state) and the old copy is
+     * kept next to it as `<name>.pre-move-<id>`. Text files get this machine's
+     * paths. Writes are atomic, so a crash never leaves a half file.
+     */
+    private copyTree;
+    /** Project data, agent memory and handover notes. */
+    private importData;
+    private projectDataDir;
+    /** Source path to target path rewrites for the moved text files. */
+    private rewritesFor;
+    private readRecord;
+    /** Task-pool items, decisions, scheduled messages, chat channels, Slack mapping. */
+    private importRecords;
+    /** Copy the team folder, then register the team (its first save announces it everywhere). */
+    private registerTeam;
+    private startTeam;
+    private buildReport;
+}
+//# sourceMappingURL=team-move-importer.d.ts.map

package/dist/backend/backend/src/services/team-move/team-move-importer.d.ts.map

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