crewly 1.20.303 → 1.20.305

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

@@ -0,0 +1,182 @@
+/**
+ * Team move exporter (source machine).
+ *
+ * Collects everything Crewly owns about ONE team into a staging directory,
+ * writes a manifest with a hash for every file, runs the secret scan, and (in
+ * {@link buildEncryptedPackage}) turns the staging directory into an encrypted
+ * `tar.gz` stream.
+ *
+ * Package layout (POSIX paths):
+ *
+ *   manifest.json
+ *   team/**                 the team's folder: config, prompts, norms, SOPs,
+ *                           wiki vault, cron tasks
+ *   agents/<session>/**     agent memory, standing answers, session summaries
+ *   handover/<file>         newest handover notes per agent
+ *   records/*.json          task-pool items, decisions, chat channels and
+ *                           rooms, Slack channel mapping, scheduled messages
+ *   projects/<id>/data/**   `<project>/.crewly/**` (or the package-tree stores)
+ *
+ * Not in it: credentials, tokens, runtime logins, logs and transcripts,
+ * node_modules/build output and repository working trees (the repo list in
+ * the manifest lets the target clone them).
+ *
+ * @module services/team-move/team-move-exporter
+ */
+import type { Project, Team } from '../../types/index.js';
+import { type SecretEnvValue } from '../../utils/secret-env.js';
+import { StagingArea } from './team-move-fs.js';
+import { inspectRepo as defaultInspectRepo } from './team-move-git.js';
+import type { CloudManifestSummary, PackageFileEntry, PackageRepo, TeamMoveManifest } from './team-move.types.js';
+/** Thrown when a repository holds work that exists only on the source. */
+export declare class TeamMoveBlockedError extends Error {
+    readonly lines: string[];
+    constructor(lines: string[]);
+}
+/** Collaborators of the exporter. */
+export interface ExportDeps {
+    /** Crewly home of this machine. */
+    home?: string;
+    getTeams: () => Promise<Team[]>;
+    getProjects: () => Promise<Project[]>;
+    crewlyVersion: string;
+    source: {
+        instanceId: string | null;
+        deviceName: string | null;
+    };
+    /** Exact secret values this machine holds (env, settings). */
+    knownSecrets?: () => Promise<SecretEnvValue[]>;
+    inspectRepo?: typeof defaultInspectRepo;
+    now?: () => string;
+    /** Caps for the working files of non-git projects; default from constants / env. */
+    workLimits?: WorkFileLimits;
+}
+/** Size caps for the working files of projects that are not git repositories. */
+export interface WorkFileLimits {
+    /** All such projects together. */
+    totalBytes: number;
+    /** One file. */
+    fileBytes: number;
+}
+/**
+ * The caps for non-git project files: constants, overridable in megabytes by
+ * `CREWLY_TEAM_MOVE_WORK_MAX_MB` and `CREWLY_TEAM_MOVE_WORK_FILE_MAX_MB`.
+ *
+ * @param env - Environment to read overrides from
+ * @returns The caps in bytes
+ */
+export declare function resolveWorkFileLimits(env?: NodeJS.ProcessEnv): WorkFileLimits;
+/** Whether a repo record says the folder is not a git repository (its files travel instead of being cloned). */
+export declare function isPlainFolder(repo: PackageRepo): boolean;
+/** Options of one export. */
+export interface ExportOptions {
+    teamId: string;
+    moveId: string;
+    /** Directory the package is assembled in (created). */
+    stagingDir: string;
+    /** Move although a repository has uncommitted or unpushed work. */
+    allowDirty?: boolean;
+    /** Leave files with secrets out of the package instead of aborting (only free-form notes and project files). */
+    skipFlagged?: boolean;
+}
+/** What an export produced. */
+export interface ExportResult {
+    manifest: TeamMoveManifest;
+    staging: StagingArea;
+    /** What Cloud receives with `package/init`. */
+    summary: CloudManifestSummary;
+    /** Lines describing uncommitted/unpushed work that was allowed through. */
+    dirtyRepos: string[];
+}
+/**
+ * Prepare a team config for another machine: nothing is running there yet.
+ *
+ * @param raw - Parsed `config.json`
+ * @returns Copy with runtime state cleared
+ */
+export declare function sanitizeTeamForMove(raw: Record<string, unknown>): Record<string, unknown>;
+/** The exporter. */
+export declare class TeamMoveExporter {
+    private readonly deps;
+    private readonly home;
+    private readonly now;
+    private readonly inspect;
+    constructor(deps: ExportDeps);
+    /**
+     * Check, before anything is built, that no repository holds work only this
+     * machine has. Used by the REST entry point so the owner learns what to
+     * push before a move is even requested.
+     *
+     * @param teamId - Team to move
+     * @returns The repos and the lines that block the move
+     */
+    checkRepos(teamId: string): Promise<{
+        repos: PackageRepo[];
+        blocking: string[];
+    }>;
+    private requireTeam;
+    private teamProjects;
+    /**
+     * Collect, scan and describe the package.
+     *
+     * @param options - Team, move, staging directory, policy flags
+     * @returns Manifest, staging area and the Cloud summary
+     * @throws TeamMoveBlockedError for unpushed work; TeamMoveSecretScanError for secrets
+     */
+    export(options: ExportOptions): Promise<ExportResult>;
+    /** The things a move deliberately leaves out, shown to the owner. */
+    private notMovedList;
+    /** Global-store records of the team. */
+    private collectRecords;
+    /**
+     * Copy each project's Crewly data under the size caps.
+     *
+     * @returns Manifest entries of the projects
+     */
+    private collectProjects;
+    /**
+     * Copy the working files of projects that are not git repositories (a git
+     * project is cloned on the target instead). Dependencies, build output,
+     * logs and `.DS_Store` stay out; the caps leave the biggest files behind
+     * and every skipped file is listed in the manifest.
+     */
+    private collectWorkFiles;
+    /** Tools and connectors the team's own words mention (prompts, norms, SOPs, cron tasks). */
+    private detectNeeds;
+}
+/**
+ * The small summary Cloud receives (kept far below its 64 KB limit).
+ *
+ * @param manifest - Full manifest
+ * @returns Summary without file names
+ */
+export declare function summarize(manifest: TeamMoveManifest): CloudManifestSummary;
+/** Result of {@link buildEncryptedPackage}. */
+export interface EncryptedPackage {
+    /** Absolute path of the ciphertext file. */
+    file: string;
+    /** Ciphertext size in bytes. */
+    size: number;
+    /** Hex SHA-256 of the ciphertext. */
+    sha256: string;
+    /** Upload chunks (8 MiB each, the last shorter). */
+    chunks: number;
+}
+/**
+ * Tar+gzip a staging directory and encrypt it for the target.
+ *
+ * @param stagingDir - Directory built by {@link TeamMoveExporter.export}
+ * @param outFile - Where the ciphertext is written
+ * @param recipientPublicKey - Target's base64 X25519 public key
+ * @param moveId - Move id (bound into the encryption)
+ * @returns File, size, hash and chunk count of the ciphertext
+ */
+export declare function buildEncryptedPackage(stagingDir: string, outFile: string, recipientPublicKey: string, moveId: string): Promise<EncryptedPackage>;
+/**
+ * Package entries sorted for stable comparisons in tests.
+ *
+ * @param files - Manifest file entries
+ * @returns Paths
+ */
+export declare function packagePaths(files: readonly PackageFileEntry[]): string[];
+//# sourceMappingURL=team-move-exporter.d.ts.map

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

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