@gracker/smartperfetto 1.0.13

package/dist/services/runtimeSnapshotStore.d.ts

@@ -0,0 +1,19 @@
+export declare const CLAUDE_SESSION_MAP_RUNTIME_TYPE = "claude-session-map";
+export interface ClaudeSessionMapRuntimeEntry {
+    sdkSessionId: string;
+    updatedAt: number;
+    mode?: 'full';
+}
+export interface RuntimeSnapshotScope {
+    tenantId: string;
+    workspaceId: string;
+    userId?: string;
+    sessionId: string;
+    runId?: string;
+    traceId?: string;
+}
+export declare function loadClaudeSessionMapFromRuntimeSnapshots(maxAgeMs: number, now?: number): Map<string, ClaudeSessionMapRuntimeEntry>;
+export declare function saveClaudeSessionMapToRuntimeSnapshots(scope: RuntimeSnapshotScope, sessionMapKey: string, entry: ClaudeSessionMapRuntimeEntry): void;
+export declare function deleteClaudeSessionMapRuntimeSnapshots(sessionId: string): number;
+export declare function deleteClaudeSessionMapRuntimeSnapshot(sessionId: string, sessionMapKey: string, scope?: Pick<RuntimeSnapshotScope, 'tenantId' | 'workspaceId'>): number;
+//# sourceMappingURL=runtimeSnapshotStore.d.ts.map

package/dist/services/runtimeSnapshotStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeSnapshotStore.d.ts","sourceRoot":"","sources":["../../src/services/runtimeSnapshotStore.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,+BAA+B,uBAAuB,CAAC;AAIpE,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAyJD,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAmB,GACvB,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAmB3C;AAED,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,oBAAoB,EAC3B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,4BAA4B,GAClC,IAAI,CA+BN;AAED,wBAAgB,sCAAsC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA4BhF;AAED,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,aAAa,CAAC,GAC7D,MAAM,CAkCR"}

package/dist/services/runtimeSnapshotStore.js

@@ -0,0 +1,222 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLAUDE_SESSION_MAP_RUNTIME_TYPE = void 0;
+exports.loadClaudeSessionMapFromRuntimeSnapshots = loadClaudeSessionMapFromRuntimeSnapshots;
+exports.saveClaudeSessionMapToRuntimeSnapshots = saveClaudeSessionMapToRuntimeSnapshots;
+exports.deleteClaudeSessionMapRuntimeSnapshots = deleteClaudeSessionMapRuntimeSnapshots;
+exports.deleteClaudeSessionMapRuntimeSnapshot = deleteClaudeSessionMapRuntimeSnapshot;
+const crypto_1 = __importDefault(require("crypto"));
+const enterpriseDb_1 = require("./enterpriseDb");
+const enterpriseRepository_1 = require("./enterpriseRepository");
+exports.CLAUDE_SESSION_MAP_RUNTIME_TYPE = 'claude-session-map';
+const SAFE_RUNTIME_ID_RE = /^[a-zA-Z0-9._:-]+$/;
+function assertSafeRuntimeId(value, label) {
+    if (!SAFE_RUNTIME_ID_RE.test(value) || value === '.' || value === '..') {
+        throw new Error(`Unsafe ${label}: ${value}`);
+    }
+    return value;
+}
+function fallbackTraceId(scope) {
+    return scope.traceId || `trace-${scope.sessionId}-runtime-snapshot`;
+}
+function fallbackRunId(scope) {
+    return scope.runId || `run-${scope.sessionId}-runtime-snapshot`;
+}
+function runtimeSnapshotId(tenantId, workspaceId, sessionMapKey) {
+    const digest = crypto_1.default
+        .createHash('sha256')
+        .update(`${tenantId}\0${workspaceId}\0${sessionMapKey}`)
+        .digest('hex')
+        .slice(0, 32);
+    return `claude-session-map-${digest}`;
+}
+function withRuntimeSnapshotDb(fn) {
+    const db = (0, enterpriseDb_1.openEnterpriseDb)();
+    try {
+        return fn(db);
+    }
+    finally {
+        db.close();
+    }
+}
+function parseSnapshotJson(row) {
+    try {
+        const parsed = JSON.parse(row.snapshot_json);
+        if (typeof parsed.sessionMapKey !== 'string' || typeof parsed.sdkSessionId !== 'string') {
+            return null;
+        }
+        const updatedAt = typeof parsed.updatedAt === 'number' && Number.isFinite(parsed.updatedAt)
+            ? parsed.updatedAt
+            : row.created_at;
+        const mode = parsed.mode === 'full' ? parsed.mode : undefined;
+        return [parsed.sessionMapKey, { sdkSessionId: parsed.sdkSessionId, updatedAt, ...(mode ? { mode } : {}) }];
+    }
+    catch {
+        return null;
+    }
+}
+function ensureRuntimeSnapshotGraph(db, scope) {
+    const tenantId = assertSafeRuntimeId(scope.tenantId, 'tenant id');
+    const workspaceId = assertSafeRuntimeId(scope.workspaceId, 'workspace id');
+    const sessionId = assertSafeRuntimeId(scope.sessionId, 'session id');
+    const userId = scope.userId ? assertSafeRuntimeId(scope.userId, 'user id') : null;
+    const traceId = assertSafeRuntimeId(fallbackTraceId(scope), 'trace id');
+    const runId = assertSafeRuntimeId(fallbackRunId(scope), 'run id');
+    const now = Date.now();
+    db.prepare(`
+    INSERT OR IGNORE INTO organizations (id, name, status, plan, created_at, updated_at)
+    VALUES (?, ?, 'active', 'enterprise', ?, ?)
+  `).run(tenantId, tenantId, now, now);
+    db.prepare(`
+    INSERT OR IGNORE INTO workspaces (id, tenant_id, name, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?)
+  `).run(workspaceId, tenantId, workspaceId, now, now);
+    if (userId) {
+        db.prepare(`
+      INSERT INTO users (id, tenant_id, email, display_name, idp_subject, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        email = excluded.email,
+        display_name = excluded.display_name,
+        updated_at = excluded.updated_at
+    `).run(userId, tenantId, `${userId}@runtime.local`, userId, `runtime:${userId}`, now, now);
+    }
+    db.prepare(`
+    INSERT OR IGNORE INTO trace_assets
+      (id, tenant_id, workspace_id, owner_user_id, local_path, size_bytes, status, metadata_json, created_at)
+    VALUES
+      (?, ?, ?, ?, ?, 0, 'metadata_only', ?, ?)
+  `).run(traceId, tenantId, workspaceId, userId, `metadata-only:${traceId}`, JSON.stringify({ source: 'runtime_snapshot', sessionId }), now);
+    db.prepare(`
+    INSERT OR IGNORE INTO analysis_sessions
+      (id, tenant_id, workspace_id, trace_id, created_by, title, visibility, status, created_at, updated_at)
+    VALUES
+      (?, ?, ?, ?, ?, ?, 'private', 'running', ?, ?)
+  `).run(sessionId, tenantId, workspaceId, traceId, userId, `Runtime ${sessionId}`, now, now);
+    db.prepare(`
+    INSERT OR IGNORE INTO analysis_runs
+      (id, tenant_id, workspace_id, session_id, mode, status, question, started_at, completed_at)
+    VALUES
+      (?, ?, ?, ?, 'agent', 'running', '', ?, NULL)
+  `).run(runId, tenantId, workspaceId, sessionId, now);
+    return { tenantId, workspaceId, userId, sessionId, traceId, runId };
+}
+function loadClaudeSessionMapFromRuntimeSnapshots(maxAgeMs, now = Date.now()) {
+    return withRuntimeSnapshotDb((db) => {
+        const rows = db.prepare(`
+      SELECT *
+      FROM runtime_snapshots
+      WHERE runtime_type = ?
+      ORDER BY created_at ASC
+    `).all(exports.CLAUDE_SESSION_MAP_RUNTIME_TYPE);
+        const map = new Map();
+        for (const row of rows) {
+            const parsed = parseSnapshotJson(row);
+            if (!parsed)
+                continue;
+            const [sessionMapKey, entry] = parsed;
+            if (now - entry.updatedAt > maxAgeMs)
+                continue;
+            map.set(sessionMapKey, entry);
+        }
+        return map;
+    });
+}
+function saveClaudeSessionMapToRuntimeSnapshots(scope, sessionMapKey, entry) {
+    withRuntimeSnapshotDb((db) => {
+        const write = db.transaction(() => {
+            const graph = ensureRuntimeSnapshotGraph(db, scope);
+            const id = runtimeSnapshotId(graph.tenantId, graph.workspaceId, sessionMapKey);
+            const snapshotJson = JSON.stringify({
+                sessionMapKey,
+                sdkSessionId: entry.sdkSessionId,
+                updatedAt: entry.updatedAt,
+                ...(entry.mode ? { mode: entry.mode } : {}),
+                traceId: graph.traceId,
+            });
+            const repo = (0, enterpriseRepository_1.createEnterpriseWorkspaceRepository)(db, 'runtime_snapshots');
+            const changes = repo.upsertById({ tenantId: graph.tenantId, workspaceId: graph.workspaceId }, id, {
+                session_id: graph.sessionId,
+                run_id: graph.runId,
+                runtime_type: exports.CLAUDE_SESSION_MAP_RUNTIME_TYPE,
+                snapshot_json: snapshotJson,
+                created_at: entry.updatedAt,
+            });
+            if (changes === 0) {
+                throw new Error('Runtime snapshot id already exists outside the repository scope');
+            }
+        });
+        write();
+    });
+}
+function deleteClaudeSessionMapRuntimeSnapshots(sessionId) {
+    const safeSessionId = assertSafeRuntimeId(sessionId, 'session id');
+    return withRuntimeSnapshotDb((db) => {
+        const rows = db.prepare(`
+      SELECT *
+      FROM runtime_snapshots
+      WHERE runtime_type = ? AND session_id = ?
+    `).all(exports.CLAUDE_SESSION_MAP_RUNTIME_TYPE, safeSessionId);
+        let deleted = 0;
+        const byScope = new Map();
+        for (const row of rows) {
+            const key = `${row.tenant_id}\0${row.workspace_id}`;
+            const scopedRows = byScope.get(key) ?? [];
+            scopedRows.push(row);
+            byScope.set(key, scopedRows);
+        }
+        for (const scopedRows of byScope.values()) {
+            const [first] = scopedRows;
+            const repo = (0, enterpriseRepository_1.createEnterpriseWorkspaceRepository)(db, 'runtime_snapshots');
+            for (const row of scopedRows) {
+                deleted += repo.deleteById({
+                    tenantId: first.tenant_id,
+                    workspaceId: first.workspace_id,
+                }, row.id);
+            }
+        }
+        return deleted;
+    });
+}
+function deleteClaudeSessionMapRuntimeSnapshot(sessionId, sessionMapKey, scope) {
+    const safeSessionId = assertSafeRuntimeId(sessionId, 'session id');
+    const safeSessionMapKey = assertSafeRuntimeId(sessionMapKey, 'session map key');
+    const safeTenantId = scope?.tenantId ? assertSafeRuntimeId(scope.tenantId, 'tenant id') : undefined;
+    const safeWorkspaceId = scope?.workspaceId ? assertSafeRuntimeId(scope.workspaceId, 'workspace id') : undefined;
+    return withRuntimeSnapshotDb((db) => {
+        const scoped = safeTenantId && safeWorkspaceId;
+        const rows = scoped
+            ? db.prepare(`
+          SELECT *
+          FROM runtime_snapshots
+          WHERE runtime_type = ? AND session_id = ? AND tenant_id = ? AND workspace_id = ?
+        `).all(exports.CLAUDE_SESSION_MAP_RUNTIME_TYPE, safeSessionId, safeTenantId, safeWorkspaceId)
+            : db.prepare(`
+          SELECT *
+          FROM runtime_snapshots
+          WHERE runtime_type = ? AND session_id = ?
+        `).all(exports.CLAUDE_SESSION_MAP_RUNTIME_TYPE, safeSessionId);
+        let deleted = 0;
+        const repo = (0, enterpriseRepository_1.createEnterpriseWorkspaceRepository)(db, 'runtime_snapshots');
+        for (const row of rows) {
+            const parsed = parseSnapshotJson(row);
+            if (!parsed)
+                continue;
+            const [rowSessionMapKey] = parsed;
+            if (rowSessionMapKey !== safeSessionMapKey)
+                continue;
+            deleted += repo.deleteById({
+                tenantId: row.tenant_id,
+                workspaceId: row.workspace_id,
+            }, row.id);
+        }
+        return deleted;
+    });
+}
+//# sourceMappingURL=runtimeSnapshotStore.js.map

package/dist/services/runtimeSnapshotStore.js.map

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

package/dist/services/sceneReport/sceneReportMemoryCache.d.ts

@@ -0,0 +1,38 @@
+/**
+ * SceneReportMemoryCache — tiny process-local LRU for external-RPC traces.
+ *
+ * Why it exists
+ * -------------
+ * File-backed traces get a sha256 content hash and land in the disk store
+ * with a 7-day TTL. External RPC traces (forwarded from a running
+ * trace_processor_shell) have no content to hash, so we keep the last
+ * SCENE_REPORT_MEMORY_CACHE_MAX reports keyed by `traceId` for as long as
+ * the backend process lives — session-local, resets on restart.
+ *
+ * Why hand-rolled instead of `lru-cache`
+ * --------------------------------------
+ * JS `Map` preserves insertion order, so "mark as recently used" is just
+ * `delete(k); set(k, v)` and "oldest entry" is `keys().next().value`. The
+ * whole LRU contract fits in ~30 lines with zero new dependencies.
+ */
+import type { SceneReport } from '../../agent/scene/types';
+export declare class SceneReportMemoryCache {
+    private readonly maxSize;
+    private readonly store;
+    constructor(maxSize: number);
+    /**
+     * Return the cached report for `traceId` and mark it as most-recently-used
+     * by re-inserting it at the tail of the Map. Returns `undefined` on miss.
+     */
+    get(traceId: string): SceneReport | undefined;
+    /**
+     * Insert or update `traceId`. If the cache is full and this is a new key,
+     * evict the least-recently-used entry (the first one in insertion order).
+     * Re-setting an existing key refreshes its position without evicting.
+     */
+    set(traceId: string, report: SceneReport): void;
+    delete(traceId: string): boolean;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=sceneReportMemoryCache.d.ts.map

package/dist/services/sceneReport/sceneReportMemoryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneReportMemoryCache.d.ts","sourceRoot":"","sources":["../../../src/services/sceneReport/sceneReportMemoryCache.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,qBAAa,sBAAsB;IAGrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;gBAE3B,OAAO,EAAE,MAAM;IAQ5C;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAQ7C;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAY/C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIhC,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/services/sceneReport/sceneReportMemoryCache.js

@@ -0,0 +1,55 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SceneReportMemoryCache = void 0;
+class SceneReportMemoryCache {
+    constructor(maxSize) {
+        this.maxSize = maxSize;
+        this.store = new Map();
+        if (!Number.isInteger(maxSize) || maxSize <= 0) {
+            throw new Error(`SceneReportMemoryCache maxSize must be a positive integer, got ${maxSize}`);
+        }
+    }
+    /**
+     * Return the cached report for `traceId` and mark it as most-recently-used
+     * by re-inserting it at the tail of the Map. Returns `undefined` on miss.
+     */
+    get(traceId) {
+        const report = this.store.get(traceId);
+        if (report === undefined)
+            return undefined;
+        this.store.delete(traceId);
+        this.store.set(traceId, report);
+        return report;
+    }
+    /**
+     * Insert or update `traceId`. If the cache is full and this is a new key,
+     * evict the least-recently-used entry (the first one in insertion order).
+     * Re-setting an existing key refreshes its position without evicting.
+     */
+    set(traceId, report) {
+        if (this.store.has(traceId)) {
+            this.store.delete(traceId);
+        }
+        else if (this.store.size >= this.maxSize) {
+            const oldestKey = this.store.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.store.delete(oldestKey);
+            }
+        }
+        this.store.set(traceId, report);
+    }
+    delete(traceId) {
+        return this.store.delete(traceId);
+    }
+    clear() {
+        this.store.clear();
+    }
+    get size() {
+        return this.store.size;
+    }
+}
+exports.SceneReportMemoryCache = SceneReportMemoryCache;
+//# sourceMappingURL=sceneReportMemoryCache.js.map

package/dist/services/sceneReport/sceneReportMemoryCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneReportMemoryCache.js","sourceRoot":"","sources":["../../../src/services/sceneReport/sceneReportMemoryCache.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;;AAsB/D,MAAa,sBAAsB;IAGjC,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;QAF3B,UAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;QAGtD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,kEAAkE,OAAO,EAAE,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,OAAe;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,OAAe,EAAE,MAAmB;QACtC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAA2B,CAAC;YACvE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAnDD,wDAmDC"}

package/dist/services/sceneReport/sceneReportStore.d.ts

@@ -0,0 +1,41 @@
+import type { SceneReport } from '../../agent/scene/types';
+export interface SceneReportStore {
+    save(report: SceneReport): Promise<void>;
+    loadById(reportId: string): Promise<SceneReport | null>;
+    loadByHash(hash: string): Promise<SceneReport | null>;
+    delete(reportId: string): Promise<boolean>;
+    cleanupExpired(nowMs: number): Promise<number>;
+}
+export declare class FileSystemSceneReportStore implements SceneReportStore {
+    private readonly reportDir;
+    /** Single-writer chain — every mutation `await`s the previous one. */
+    private writeQueue;
+    constructor(reportDir: string);
+    private get indexPath();
+    private reportPath;
+    private ensureDir;
+    private emptyIndex;
+    /**
+     * Read+parse the index. Returns an empty index when:
+     *  - The file doesn't exist (first-ever save).
+     *  - The JSON is corrupted (rare, but recoverable — the next save rewrites it).
+     *  - The version is unrecognised.
+     *
+     * Logs a warning on corruption so we notice in CI/dev.
+     */
+    private readIndex;
+    private writeIndex;
+    /**
+     * Schedule `op` after every previously enqueued mutation. The continuation
+     * stored back into `writeQueue` deliberately swallows the result and any
+     * error so a single failing op cannot poison every subsequent write — the
+     * caller still receives the original promise (with the original rejection).
+     */
+    private enqueue;
+    save(report: SceneReport): Promise<void>;
+    loadById(reportId: string): Promise<SceneReport | null>;
+    loadByHash(hash: string): Promise<SceneReport | null>;
+    delete(reportId: string): Promise<boolean>;
+    cleanupExpired(nowMs: number): Promise<number>;
+}
+//# sourceMappingURL=sceneReportStore.d.ts.map

package/dist/services/sceneReport/sceneReportStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneReportStore.d.ts","sourceRoot":"","sources":["../../../src/services/sceneReport/sceneReportStore.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAgC3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACxD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD;AAcD,qBAAa,0BAA2B,YAAW,gBAAgB;IAIrD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,sEAAsE;IACtE,OAAO,CAAC,UAAU,CAAoC;gBAEzB,SAAS,EAAE,MAAM;IAI9C,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,CAAC,UAAU;YAMJ,SAAS;IAIvB,OAAO,CAAC,UAAU;IAIlB;;;;;;;OAOG;YACW,SAAS;YAwBT,UAAU;IAIxB;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAWT,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAyBvD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAiBrD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0B1C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAkCrD"}

package/dist/services/sceneReport/sceneReportStore.js

@@ -0,0 +1,248 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemSceneReportStore = void 0;
+/**
+ * SceneReportStore — 7-day disk cache for SceneReport JSON.
+ *
+ * On-disk layout
+ * --------------
+ *   {reportDir}/index.json           — single index, see IndexFile
+ *   {reportDir}/{reportId}.json      — one file per report (atomic write)
+ *
+ * The index is the source of truth for `loadByHash` and `cleanupExpired`;
+ * a stray .json file with no index entry is harmless and will be picked
+ * up by the next save that happens to assign a colliding reportId (vanishingly
+ * unlikely with uuid v4) or by future hard-size cleanup work.
+ *
+ * Concurrency
+ * -----------
+ * All mutating operations (`save`, `delete`, `cleanupExpired`) go through a
+ * single-writer promise chain (`writeQueue`). Reads (`loadById`,
+ * `loadByHash`) go directly to disk and may observe an older snapshot —
+ * that's fine because the index is rewritten atomically via `fs.rename`,
+ * so a reader either sees the pre- or post-state, never a torn one.
+ *
+ * Deployment assumption: this guarantee holds only for a *single* Node
+ * process owning the `reportDir`. If the backend is ever scaled to multiple
+ * worker processes / instances sharing the same directory, the writeQueue
+ * lock disappears and concurrent writers can race on the index. A future
+ * cluster deployment would need a file lock (or external coordination)
+ * around `save`/`delete`/`cleanupExpired`.
+ *
+ * Atomicity
+ * ---------
+ * Each write goes to a unique `.tmp.{pid}.{ts}` file then `fs.rename` into
+ * place. POSIX guarantees `rename` is atomic on the same filesystem, which
+ * is exactly what we need so a crashed backend can never leave a half-
+ * written index.json behind.
+ *
+ * Schema versioning
+ * -----------------
+ * `loadById` checks `report.generatedBy.pipelineVersion === 'v2'` and
+ * returns null on mismatch. This means a Stage1/Stage2 contract change
+ * (bump to 'v3') invalidates the cache without requiring a migration.
+ */
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const atomicFileWriter_1 = require("../../utils/atomicFileWriter");
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const INDEX_FILENAME = 'index.json';
+const REPORT_EXT = '.json';
+const SUPPORTED_PIPELINE_VERSION = 'v2';
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+class FileSystemSceneReportStore {
+    constructor(reportDir) {
+        this.reportDir = reportDir;
+        /** Single-writer chain — every mutation `await`s the previous one. */
+        this.writeQueue = Promise.resolve();
+    }
+    // -- path helpers ---------------------------------------------------------
+    get indexPath() {
+        return path_1.default.join(this.reportDir, INDEX_FILENAME);
+    }
+    reportPath(reportId) {
+        return path_1.default.join(this.reportDir, `${reportId}${REPORT_EXT}`);
+    }
+    // -- low-level I/O --------------------------------------------------------
+    async ensureDir() {
+        await fs_1.promises.mkdir(this.reportDir, { recursive: true });
+    }
+    emptyIndex() {
+        return { version: 1, byHash: {}, byReport: {} };
+    }
+    /**
+     * Read+parse the index. Returns an empty index when:
+     *  - The file doesn't exist (first-ever save).
+     *  - The JSON is corrupted (rare, but recoverable — the next save rewrites it).
+     *  - The version is unrecognised.
+     *
+     * Logs a warning on corruption so we notice in CI/dev.
+     */
+    async readIndex() {
+        try {
+            const raw = await fs_1.promises.readFile(this.indexPath, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed.version !== 1 ||
+                typeof parsed.byHash !== 'object' || parsed.byHash === null ||
+                typeof parsed.byReport !== 'object' || parsed.byReport === null) {
+                console.warn('[SceneReportStore] index.json structure unexpected, resetting');
+                return this.emptyIndex();
+            }
+            return parsed;
+        }
+        catch (err) {
+            if (err?.code !== 'ENOENT') {
+                console.warn('[SceneReportStore] index.json unreadable, resetting:', err?.message ?? err);
+            }
+            return this.emptyIndex();
+        }
+    }
+    async writeIndex(index) {
+        await (0, atomicFileWriter_1.atomicWriteFile)(this.indexPath, JSON.stringify(index));
+    }
+    /**
+     * Schedule `op` after every previously enqueued mutation. The continuation
+     * stored back into `writeQueue` deliberately swallows the result and any
+     * error so a single failing op cannot poison every subsequent write — the
+     * caller still receives the original promise (with the original rejection).
+     */
+    enqueue(op) {
+        const next = this.writeQueue.then(() => op());
+        this.writeQueue = next.then(() => undefined, () => undefined);
+        return next;
+    }
+    // -- public API -----------------------------------------------------------
+    async save(report) {
+        return this.enqueue(async () => {
+            await this.ensureDir();
+            const filename = `${report.reportId}${REPORT_EXT}`;
+            const reportFilePath = path_1.default.join(this.reportDir, filename);
+            // 1) Write the report file atomically.
+            await (0, atomicFileWriter_1.atomicWriteFile)(reportFilePath, JSON.stringify(report));
+            // 2) Update the index in-place.
+            const index = await this.readIndex();
+            // If the same hash was already pointing at a different reportId, drop
+            // the stale byReport entry so future loadByHash returns the new one.
+            // We deliberately don't unlink the old report file here — a concurrent
+            // caller may still hold the old reportId for a loadById; the next
+            // cleanupExpired sweep will pick it up via TTL.
+            if (report.traceHash) {
+                const previousId = index.byHash[report.traceHash];
+                if (previousId && previousId !== report.reportId) {
+                    delete index.byReport[previousId];
+                }
+            }
+            index.byReport[report.reportId] = {
+                hash: report.traceHash,
+                expiresAt: report.expiresAt,
+                createdAt: report.createdAt,
+                filename,
+            };
+            if (report.traceHash) {
+                index.byHash[report.traceHash] = report.reportId;
+            }
+            await this.writeIndex(index);
+        });
+    }
+    async loadById(reportId) {
+        try {
+            const raw = await fs_1.promises.readFile(this.reportPath(reportId), 'utf8');
+            const report = JSON.parse(raw);
+            if (report?.generatedBy?.pipelineVersion !== SUPPORTED_PIPELINE_VERSION) {
+                return null;
+            }
+            // TTL gate at read time. Mirrors loadByHash so a direct
+            // `GET /scene-reconstruct/report/:id` call cannot return an
+            // expired report between cleanup sweeps.
+            if (report.expiresAt !== null && report.expiresAt < Date.now()) {
+                return null;
+            }
+            return report;
+        }
+        catch (err) {
+            if (err?.code !== 'ENOENT') {
+                console.warn(`[SceneReportStore] loadById(${reportId}) failed:`, err?.message ?? err);
+            }
+            return null;
+        }
+    }
+    async loadByHash(hash) {
+        const index = await this.readIndex();
+        const reportId = index.byHash[hash];
+        if (!reportId)
+            return null;
+        const entry = index.byReport[reportId];
+        if (!entry)
+            return null;
+        // TTL gate at read time — expired entries return null and will be
+        // garbage-collected by the next cleanupExpired sweep.
+        if (entry.expiresAt !== null && entry.expiresAt < Date.now()) {
+            return null;
+        }
+        return this.loadById(reportId);
+    }
+    async delete(reportId) {
+        return this.enqueue(async () => {
+            const index = await this.readIndex();
+            const entry = index.byReport[reportId];
+            if (!entry)
+                return false;
+            delete index.byReport[reportId];
+            if (entry.hash && index.byHash[entry.hash] === reportId) {
+                delete index.byHash[entry.hash];
+            }
+            await this.writeIndex(index);
+            try {
+                await fs_1.promises.unlink(this.reportPath(reportId));
+            }
+            catch (err) {
+                if (err?.code !== 'ENOENT') {
+                    console.warn(`[SceneReportStore] failed to unlink report ${reportId}:`, err?.message ?? err);
+                }
+            }
+            return true;
+        });
+    }
+    async cleanupExpired(nowMs) {
+        return this.enqueue(async () => {
+            const index = await this.readIndex();
+            const expiredIds = [];
+            for (const [reportId, entry] of Object.entries(index.byReport)) {
+                if (entry.expiresAt !== null && entry.expiresAt < nowMs) {
+                    expiredIds.push(reportId);
+                }
+            }
+            if (expiredIds.length === 0)
+                return 0;
+            for (const reportId of expiredIds) {
+                const entry = index.byReport[reportId];
+                delete index.byReport[reportId];
+                if (entry?.hash && index.byHash[entry.hash] === reportId) {
+                    delete index.byHash[entry.hash];
+                }
+                try {
+                    await fs_1.promises.unlink(this.reportPath(reportId));
+                }
+                catch (err) {
+                    if (err?.code !== 'ENOENT') {
+                        console.warn(`[SceneReportStore] cleanup failed to unlink ${reportId}:`, err?.message ?? err);
+                    }
+                }
+            }
+            await this.writeIndex(index);
+            return expiredIds.length;
+        });
+    }
+}
+exports.FileSystemSceneReportStore = FileSystemSceneReportStore;
+//# sourceMappingURL=sceneReportStore.js.map