constructor-research-mcp 0.0.0-stage → 0.3.0

package/dist/files.d.ts

@@ -0,0 +1,122 @@
+import { PlatformApi } from "./api.js";
+import type { DeploymentEngine } from "./deployment.js";
+interface Entry {
+    path: string;
+    type: "file" | "folder";
+    size: number;
+    modified?: string;
+}
+/**
+ * Exclude patterns from a .dockerignore in the build folder: files Docker would not send
+ * to the build are not uploaded. Files with "!" exceptions are not used (we cannot express them).
+ */
+export declare function dockerignore(folder: string): Promise<string[]>;
+export declare class FileManager {
+    readonly api: PlatformApi;
+    readonly engine: DeploymentEngine;
+    /** Last write per disk. Builds started right after an upload failed live. */
+    private written;
+    /**
+     * Files this process uploaded or checksummed: desk|path -> content and the server's
+     * modified time. A repeat sync trusts them while size and modified time are unchanged
+     * instead of asking the server for a checksum again.
+     */
+    private verified;
+    constructor(api: PlatformApi, engine: DeploymentEngine);
+    /** Milliseconds a build on this disk should still wait after the last upload. */
+    settleMs(desk: string): number;
+    /** One folder level; null when the folder does not exist. */
+    private folder;
+    /** Server-side SHA-256 of a file; null when the file is missing. */
+    private checksum;
+    /** Type of a path, or null when missing. */
+    private stat;
+    private mkcol;
+    list(raw: unknown): Promise<{
+        desk_id: string;
+        path: string;
+        entries: Entry[];
+        total: number;
+        truncated: boolean;
+    }>;
+    createFolder(raw: unknown): Promise<{
+        status: string;
+        message: string;
+        path: string;
+        created: string[];
+    }>;
+    move(raw: unknown): Promise<{
+        status: string;
+        message: string;
+        moves: {
+            from: string;
+            to: string;
+            type: string | undefined;
+        }[];
+        issues: string[];
+        moved?: undefined;
+    } | {
+        moves?: undefined;
+        status: string;
+        message: string;
+        moved: string[];
+        issues: string[];
+    }>;
+    remove(raw: unknown): Promise<{
+        status: string;
+        message: string;
+        delete: {
+            path: string;
+            type: string;
+            files?: number;
+            folders?: number;
+            truncated?: boolean;
+        }[];
+        issues: string[];
+        deleted?: undefined;
+    } | {
+        delete?: undefined;
+        status: string;
+        message: string;
+        deleted: string[];
+        issues: string[];
+    }>;
+    sync(raw: unknown): Promise<{
+        new_files: string[];
+        changed_files: string[];
+        unchanged_count: number;
+        folders_to_create: string[];
+        conflicts: string[];
+        skipped: string[];
+        status: string;
+        message: string;
+        uploaded?: undefined;
+        failed?: undefined;
+        remaining_count?: undefined;
+    } | {
+        status: string;
+        message: string;
+        uploaded: string[];
+        failed: string[];
+        conflicts: string[];
+        skipped: string[];
+        unchanged_count: number;
+        remaining_count: number;
+    }>;
+    /** Check each build's Dockerfile on its disk before a build is submitted. */
+    preflight(project: string, sources: BuildSource[]): Promise<{
+        missing: string[];
+        warnings: string[];
+    }>;
+    /** Upload to a fresh temp file, move it over the target, then verify the server checksum. */
+    private upload;
+}
+/** Dockerfile problems the platform will not report clearly: wrong name, missing FROM/EXPOSE, localhost use. */
+export declare function lintDockerfile(path: string, text: string, ports: number[]): string[];
+export interface BuildSource {
+    service: string;
+    desk_id: string;
+    dockerfile: string;
+    ports: number[];
+}
+export {};