@runcore-sh/runcore 0.1.2

package/dist/files/manager.d.ts

@@ -0,0 +1,117 @@
+/**
+ * FileManager — central orchestrator for file operations (DASH-65).
+ * Composes: FileStore, validation, compression, versioning, Google Drive sync.
+ * Singleton pattern — one instance per process.
+ *
+ * Never throws — all public methods return { ok, data?, message }.
+ */
+import { FileStore } from "./store.js";
+import type { FileEntry, FileCategory, FileOrigin, FileFilter, FileSettings, StorageUsage, VersionInfo } from "./types.js";
+export interface UploadOptions {
+    buffer: Buffer;
+    originalName: string;
+    mimeType: string;
+    category?: FileCategory;
+    origin?: FileOrigin;
+    tags?: string[];
+    taskId?: string;
+    actor?: string;
+    encrypt?: boolean;
+}
+export declare class FileManager {
+    private readonly store;
+    private readonly syncStore;
+    private readonly storageRoot;
+    private readonly brainDir;
+    private settings;
+    private syncTimer;
+    private constructor();
+    /**
+     * Initialize the singleton FileManager.
+     * Call once during server startup.
+     */
+    static init(brainDir: string, storageRoot: string, settings?: Partial<FileSettings>): Promise<FileManager>;
+    /**
+     * Get the singleton instance (null if not initialized).
+     */
+    static getInstance(): FileManager | null;
+    /**
+     * Shutdown — stop timers, release resources.
+     */
+    shutdown(): Promise<void>;
+    private ensureDirectories;
+    /**
+     * Upload a file: validate, store, compress, register.
+     */
+    upload(opts: UploadOptions): Promise<{
+        ok: boolean;
+        file?: FileEntry;
+        message: string;
+    }>;
+    /**
+     * Read file contents by ID.
+     */
+    read(fileId: string): Promise<{
+        ok: boolean;
+        data?: Buffer;
+        entry?: FileEntry;
+        message: string;
+    }>;
+    get(fileId: string): Promise<FileEntry | null>;
+    list(filter?: FileFilter): Promise<FileEntry[]>;
+    updateMetadata(fileId: string, patch: Partial<Pick<FileEntry, "name" | "tags" | "category" | "visibility" | "meta">>): Promise<{
+        ok: boolean;
+        file?: FileEntry;
+        message: string;
+    }>;
+    archive(fileId: string, actor: string): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    restore(fileId: string, actor: string): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    /**
+     * Update a file's content, creating a new version of the old content.
+     */
+    updateContent(fileId: string, newBuffer: Buffer, actor: string): Promise<{
+        ok: boolean;
+        file?: FileEntry;
+        message: string;
+    }>;
+    getVersionHistory(fileId: string): Promise<VersionInfo[]>;
+    rollback(fileId: string, targetVersion: number): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    syncDrive(): Promise<{
+        ok: boolean;
+        synced: number;
+        errors: number;
+        message: string;
+    }>;
+    getDriveStatus(): Promise<{
+        connected: boolean;
+        folderId: string | null;
+        syncEnabled: boolean;
+        fileCount: number;
+        lastSync: string | null;
+    }>;
+    updateDriveConfig(config: Partial<FileSettings["gdrive"]>): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    private startSyncTimer;
+    getStats(): Promise<StorageUsage>;
+    compact(): Promise<{
+        registry: {
+            before: number;
+            after: number;
+        };
+    }>;
+    getStore(): FileStore;
+    getStorageRoot(): string;
+    getSettings(): FileSettings;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/files/manager.d.ts.map

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

package/dist/files/manager.js

@@ -0,0 +1,306 @@
+/**
+ * FileManager — central orchestrator for file operations (DASH-65).
+ * Composes: FileStore, validation, compression, versioning, Google Drive sync.
+ * Singleton pattern — one instance per process.
+ *
+ * Never throws — all public methods return { ok, data?, message }.
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, extname } from "node:path";
+import { createHash } from "node:crypto";
+import { createLogger } from "../utils/logger.js";
+import { FileStore, generateFileId } from "./store.js";
+import { validateUpload, slugify, sanitizeSvgBuffer } from "./validate.js";
+import { compressFile, generateThumbnail } from "./compress.js";
+import { createVersion, listVersions, rollbackToVersion } from "./version.js";
+import { GDriveSyncStore, syncToDrive, getDriveSyncStatus } from "./gdrive.js";
+import { initAgentFileApi } from "./agent-api.js";
+import { DEFAULT_FILE_SETTINGS as DEFAULTS } from "./types.js";
+const log = createLogger("files.manager");
+// ── FileManager ─────────────────────────────────────────────────────────────
+let instance = null;
+export class FileManager {
+    store;
+    syncStore;
+    storageRoot;
+    brainDir;
+    settings;
+    syncTimer = null;
+    constructor(brainDir, storageRoot, settings) {
+        this.brainDir = brainDir;
+        this.storageRoot = storageRoot;
+        this.store = new FileStore(brainDir);
+        this.syncStore = new GDriveSyncStore(brainDir);
+        this.settings = { ...DEFAULTS, ...settings };
+    }
+    /**
+     * Initialize the singleton FileManager.
+     * Call once during server startup.
+     */
+    static async init(brainDir, storageRoot, settings) {
+        if (instance)
+            return instance;
+        const fm = new FileManager(brainDir, storageRoot, settings);
+        // Ensure storage directories exist
+        await fm.ensureDirectories();
+        // Wire up the agent API
+        initAgentFileApi(fm.store, storageRoot);
+        // Start Drive sync timer if enabled
+        if (fm.settings.gdrive.syncEnabled) {
+            fm.startSyncTimer();
+        }
+        instance = fm;
+        log.info("FileManager initialized", { storageRoot, brainDir });
+        return fm;
+    }
+    /**
+     * Get the singleton instance (null if not initialized).
+     */
+    static getInstance() {
+        return instance;
+    }
+    /**
+     * Shutdown — stop timers, release resources.
+     */
+    async shutdown() {
+        if (this.syncTimer) {
+            clearInterval(this.syncTimer);
+            this.syncTimer = null;
+        }
+        instance = null;
+        log.info("FileManager shut down");
+    }
+    // ── Directory setup ───────────────────────────────────────────────────
+    async ensureDirectories() {
+        const dirs = [
+            this.storageRoot,
+            join(this.storageRoot, "uploads"),
+            join(this.storageRoot, "generated"),
+            join(this.storageRoot, "templates"),
+            join(this.storageRoot, "versions"),
+            join(this.storageRoot, "thumbnails"),
+            join(this.storageRoot, "tmp"),
+        ];
+        for (const dir of dirs) {
+            await mkdir(dir, { recursive: true });
+        }
+    }
+    // ── Upload ────────────────────────────────────────────────────────────
+    /**
+     * Upload a file: validate, store, compress, register.
+     */
+    async upload(opts) {
+        // 1. Validate
+        const validation = await validateUpload(opts.buffer, opts.originalName, opts.mimeType, this.settings.maxUploadBytes);
+        if (!validation.valid) {
+            log.warn("upload rejected", { name: opts.originalName, reason: validation.rejected });
+            return { ok: false, message: `Upload rejected: ${validation.rejected}` };
+        }
+        // 2. Check storage quota
+        const usage = await this.store.getStorageUsage();
+        if (usage.totalBytes + opts.buffer.length > this.settings.maxStorageBytes) {
+            return { ok: false, message: "Storage quota exceeded" };
+        }
+        try {
+            // 3. Determine storage path
+            const now = new Date();
+            const year = now.getFullYear().toString();
+            const month = (now.getMonth() + 1).toString().padStart(2, "0");
+            const fileId = generateFileId();
+            const slug = slugify(validation.sanitizedName.replace(/\.[^.]+$/, ""));
+            const ext = validation.detectedExt || extname(opts.originalName);
+            const subDir = opts.origin === "agent" ? "generated" : "uploads";
+            const storagePath = join(subDir, year, month, `${fileId}_${slug}${ext}`);
+            const fullPath = join(this.storageRoot, storagePath);
+            // 4. Ensure target directory
+            await mkdir(join(this.storageRoot, subDir, year, month), { recursive: true });
+            // 5. SVG sanitization
+            let buffer = opts.buffer;
+            if (ext === ".svg") {
+                buffer = sanitizeSvgBuffer(buffer);
+            }
+            // 6. Write file
+            await writeFile(fullPath, buffer);
+            // 7. Compute checksum
+            const checksum = createHash("sha256").update(buffer).digest("hex");
+            // 8. Extract text preview for searchable files
+            let textPreview;
+            const textExts = new Set([".txt", ".md", ".csv", ".json", ".yaml", ".yml", ".log"]);
+            if (textExts.has(ext)) {
+                const text = buffer.toString("utf-8");
+                textPreview = text.slice(0, 500);
+            }
+            // 9. Register in store
+            const entry = await this.store.create({
+                name: validation.sanitizedName,
+                slug,
+                mimeType: validation.detectedMime || opts.mimeType,
+                sizeBytes: buffer.length,
+                category: opts.category ?? "upload",
+                tags: opts.tags ?? [],
+                origin: opts.origin ?? "user-upload",
+                ownerId: opts.actor ?? null,
+                taskId: opts.taskId ?? null,
+                parentId: null,
+                version: 1,
+                storagePath,
+                checksum,
+                encrypted: opts.encrypt ?? false,
+                visibility: opts.origin === "agent" ? "agents" : "private",
+                status: "active",
+                textPreview,
+            });
+            // 10. Post-upload: compression (fire-and-forget)
+            if (this.settings.autoCompress) {
+                compressFile(fullPath, entry.mimeType).then((result) => {
+                    if (result) {
+                        this.store.logEvent(entry.id, "compressed", "system", result.action);
+                    }
+                }).catch(() => { });
+            }
+            // 11. Post-upload: thumbnail (fire-and-forget)
+            if (this.settings.autoThumbnail) {
+                generateThumbnail(fullPath, entry.mimeType, join(this.storageRoot, "thumbnails"), entry.id).catch(() => { });
+            }
+            log.info("file uploaded", {
+                id: entry.id,
+                name: entry.name,
+                size: entry.sizeBytes,
+                category: entry.category,
+            });
+            return { ok: true, file: entry, message: "File uploaded" };
+        }
+        catch (err) {
+            log.error("upload failed", { name: opts.originalName, error: err.message });
+            return { ok: false, message: `Upload failed: ${err.message}` };
+        }
+    }
+    // ── Read / Download ───────────────────────────────────────────────────
+    /**
+     * Read file contents by ID.
+     */
+    async read(fileId) {
+        const entry = await this.store.get(fileId);
+        if (!entry)
+            return { ok: false, message: `File not found: ${fileId}` };
+        if (entry.status === "quarantined")
+            return { ok: false, message: "File is quarantined" };
+        try {
+            const filePath = join(this.storageRoot, entry.storagePath);
+            const data = await readFile(filePath);
+            await this.store.logEvent(fileId, "downloaded", "system");
+            return { ok: true, data, entry, message: "OK" };
+        }
+        catch (err) {
+            return { ok: false, message: `Read failed: ${err.message}` };
+        }
+    }
+    // ── Metadata ──────────────────────────────────────────────────────────
+    async get(fileId) {
+        return this.store.get(fileId);
+    }
+    async list(filter) {
+        return this.store.list(filter);
+    }
+    async updateMetadata(fileId, patch) {
+        const updated = await this.store.update(fileId, patch);
+        if (!updated)
+            return { ok: false, message: `File not found: ${fileId}` };
+        return { ok: true, file: updated, message: "Updated" };
+    }
+    // ── Archive / Restore ─────────────────────────────────────────────────
+    async archive(fileId, actor) {
+        return this.store.archive(fileId, actor);
+    }
+    async restore(fileId, actor) {
+        return this.store.restore(fileId, actor);
+    }
+    // ── Versioning ────────────────────────────────────────────────────────
+    /**
+     * Update a file's content, creating a new version of the old content.
+     */
+    async updateContent(fileId, newBuffer, actor) {
+        const entry = await this.store.get(fileId);
+        if (!entry)
+            return { ok: false, message: `File not found: ${fileId}` };
+        // Create version of current content
+        const vResult = await createVersion(entry, this.storageRoot, this.store, this.settings.maxVersions);
+        if (!vResult.ok)
+            return { ok: false, message: vResult.message };
+        try {
+            // Overwrite primary file
+            const fullPath = join(this.storageRoot, entry.storagePath);
+            await writeFile(fullPath, newBuffer);
+            const checksum = createHash("sha256").update(newBuffer).digest("hex");
+            const updated = await this.store.update(fileId, {
+                version: vResult.version,
+                sizeBytes: newBuffer.length,
+                checksum,
+            });
+            log.info("file content updated", { fileId, version: vResult.version });
+            return { ok: true, file: updated ?? undefined, message: `Updated to v${vResult.version}` };
+        }
+        catch (err) {
+            return { ok: false, message: `Update failed: ${err.message}` };
+        }
+    }
+    async getVersionHistory(fileId) {
+        return listVersions(fileId, this.storageRoot);
+    }
+    async rollback(fileId, targetVersion) {
+        const entry = await this.store.get(fileId);
+        if (!entry)
+            return { ok: false, message: `File not found: ${fileId}` };
+        return rollbackToVersion(entry, targetVersion, this.storageRoot, this.store);
+    }
+    // ── Google Drive ──────────────────────────────────────────────────────
+    async syncDrive() {
+        return syncToDrive(this.store, this.syncStore, this.storageRoot, this.settings.gdrive);
+    }
+    async getDriveStatus() {
+        return getDriveSyncStatus(this.syncStore, this.settings.gdrive);
+    }
+    async updateDriveConfig(config) {
+        this.settings.gdrive = { ...this.settings.gdrive, ...config };
+        // Restart sync timer if settings changed
+        if (this.syncTimer) {
+            clearInterval(this.syncTimer);
+            this.syncTimer = null;
+        }
+        if (this.settings.gdrive.syncEnabled) {
+            this.startSyncTimer();
+        }
+        log.info("Drive config updated", { config });
+        return { ok: true, message: "Drive config updated" };
+    }
+    startSyncTimer() {
+        const interval = this.settings.gdrive.syncIntervalMs;
+        this.syncTimer = setInterval(() => {
+            this.syncDrive().catch((err) => {
+                log.error("Drive sync timer error", { error: err.message });
+            });
+        }, interval);
+        log.info("Drive sync timer started", { intervalMs: interval });
+    }
+    // ── Storage stats ─────────────────────────────────────────────────────
+    async getStats() {
+        return this.store.getStorageUsage();
+    }
+    // ── Compaction ────────────────────────────────────────────────────────
+    async compact() {
+        const registry = await this.store.compact();
+        await this.syncStore.compact();
+        return { registry };
+    }
+    // ── Accessors for sub-modules ─────────────────────────────────────────
+    getStore() {
+        return this.store;
+    }
+    getStorageRoot() {
+        return this.storageRoot;
+    }
+    getSettings() {
+        return { ...this.settings };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/files/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/files/manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAoB,KAAK,EAAQ,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAoB,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAWlD,OAAO,EAAE,qBAAqB,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAgB1C,+EAA+E;AAE/E,IAAI,QAAQ,GAAuB,IAAI,CAAC;AAExC,MAAM,OAAO,WAAW;IACL,KAAK,CAAY;IACjB,SAAS,CAAkB;IAC3B,WAAW,CAAS;IACpB,QAAQ,CAAS;IAC1B,QAAQ,CAAe;IACvB,SAAS,GAA0C,IAAI,CAAC;IAEhE,YAAoB,QAAgB,EAAE,WAAmB,EAAE,QAAgC;QACzF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,QAAgB,EAChB,WAAmB,EACnB,QAAgC;QAEhC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAE5D,mCAAmC;QACnC,MAAM,EAAE,CAAC,iBAAiB,EAAE,CAAC;QAE7B,wBAAwB;QACxB,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAExC,oCAAoC;QACpC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACnC,EAAE,CAAC,cAAc,EAAE,CAAC;QACtB,CAAC;QAED,QAAQ,GAAG,EAAE,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,CAAC;IAED,yEAAyE;IAEjE,KAAK,CAAC,iBAAiB;QAC7B,MAAM,IAAI,GAAG;YACX,IAAI,CAAC,WAAW;YAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC;SAC9B,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,yEAAyE;IAEzE;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAmB;QAC9B,cAAc;QACd,MAAM,UAAU,GAAG,MAAM,cAAc,CACrC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,QAAQ,CAAC,cAAc,CAC7B,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC3E,CAAC;QAED,yBAAyB;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC1E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC;YACH,4BAA4B;YAC5B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YACvE,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;YACjE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;YACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YAErD,6BAA6B;YAC7B,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE9E,sBAAsB;YACtB,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACzB,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;YAED,gBAAgB;YAChB,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAElC,sBAAsB;YACtB,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEnE,+CAA+C;YAC/C,IAAI,WAA+B,CAAC;YACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YACpF,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACtC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACnC,CAAC;YAED,uBAAuB;YACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;gBACpC,IAAI,EAAE,UAAU,CAAC,aAAa;gBAC9B,IAAI;gBACJ,QAAQ,EAAE,UAAU,CAAC,YAAY,IAAI,IAAI,CAAC,QAAQ;gBAClD,SAAS,EAAE,MAAM,CAAC,MAAM;gBACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa;gBACpC,OAAO,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;gBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;gBAC3B,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW;gBACX,QAAQ;gBACR,SAAS,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;gBAChC,UAAU,EAAE,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBAC1D,MAAM,EAAE,QAAQ;gBAChB,WAAW;aACZ,CAAC,CAAC;YAEH,iDAAiD;YACjD,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAC/B,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;oBACrD,IAAI,MAAM,EAAE,CAAC;wBACX,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;oBACvE,CAAC;gBACH,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrB,CAAC;YAED,+CAA+C;YAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAChC,iBAAiB,CACf,QAAQ,EACR,KAAK,CAAC,QAAQ,EACd,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EACpC,KAAK,CAAC,EAAE,CACT,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACpB,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE;gBACxB,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,SAAS;gBACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QACjE,CAAC;IACH,CAAC;IAED,yEAAyE;IAEzE;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;QACvE,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;QAEzF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;YAC1D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAClD,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,yEAAyE;IAEzE,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAmB;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,MAAc,EACd,KAAqF;QAErF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;QACzE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACzD,CAAC;IAED,yEAAyE;IAEzE,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,KAAa;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,KAAa;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,yEAAyE;IAEzE;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,MAAc,EACd,SAAiB,EACjB,KAAa;QAEb,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;QAEvE,oCAAoC;QACpC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACpG,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QAEhE,IAAI,CAAC;YACH,yBAAyB;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3D,MAAM,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAErC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;gBAC9C,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,SAAS,EAAE,SAAS,CAAC,MAAM;gBAC3B,QAAQ;aACT,CAAC,CAAC;YAEH,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,SAAS,EAAE,OAAO,EAAE,eAAe,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7F,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QACjE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,MAAc;QACpC,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,aAAqB;QAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;QACvE,OAAO,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;IAED,yEAAyE;IAEzE,KAAK,CAAC,SAAS;QACb,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,MAAuC;QAEvC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAE9D,yCAAyC;QACzC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;IACvD,CAAC;IAEO,cAAc;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC7B,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,QAAQ,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,yEAAyE;IAEzE,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;IACtC,CAAC;IAED,yEAAyE;IAEzE,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5C,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;IAED,yEAAyE;IAEzE,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,WAAW;QACT,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/files/store.d.ts

@@ -0,0 +1,41 @@
+/**
+ * File store — append-only JSONL persistence for FileEntry and FileEvent.
+ * Follows src/queue/store.ts pattern: in-memory Map cache, last-occurrence-wins.
+ *
+ * Files:
+ *   brain/files/registry.jsonl — file metadata
+ *   brain/files/events.jsonl   — audit trail
+ */
+import type { FileEntry, FileEvent, FileAction, FileFilter, StorageUsage } from "./types.js";
+/** Generate a file ID: file_<timestamp>_<8-hex>. */
+export declare function generateFileId(): string;
+export declare class FileStore {
+    private cache;
+    private readonly registryPath;
+    private readonly eventsPath;
+    constructor(brainDir: string);
+    private ensureFile;
+    private load;
+    private appendRegistry;
+    private appendEvent;
+    logEvent(fileId: string, action: FileAction, actor: string, detail?: string): Promise<FileEvent>;
+    list(filter?: FileFilter): Promise<FileEntry[]>;
+    get(id: string): Promise<FileEntry | null>;
+    create(fields: Omit<FileEntry, "id" | "createdAt" | "updatedAt">): Promise<FileEntry>;
+    update(id: string, patch: Partial<FileEntry>): Promise<FileEntry | null>;
+    archive(id: string, actor: string): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    restore(id: string, actor: string): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    getStorageUsage(): Promise<StorageUsage>;
+    compact(): Promise<{
+        before: number;
+        after: number;
+    }>;
+    getEvents(fileId: string): Promise<FileEvent[]>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/files/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/files/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EAEV,YAAY,EACb,MAAM,YAAY,CAAC;AAqBpB,oDAAoD;AACpD,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AASD,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,QAAQ,EAAE,MAAM;YAOd,UAAU;YASV,IAAI;YAwBJ,cAAc;YAId,WAAW;IAOnB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAgBhG,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAyC/C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAK1C,MAAM,CACV,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GACxD,OAAO,CAAC,SAAS,CAAC;IAgBf,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAuBxE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAkB7E,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoB7E,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IAsBxC,OAAO,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAerD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAgBtD"}