fidelity-kit 0.1.0 → 0.2.0

package/dist/core/hash.test.js

@@ -22,7 +22,14 @@ async function suite() {
 const read = async (root) => JSON.parse(await readFile(join(root, HASHES_FILE), 'utf8'));
 test('hash is deterministic, sorted, covers only served images, and is incremental', async () => {
     const root = await suite();
-    expect(await hashSuite(root)).toEqual({ hashed: 3, reused: 0, total: 3 });
+    const progress = [];
+    expect(await hashSuite(root, { onProgress: (update) => progress.push(update) })).toEqual({
+        hashed: 3,
+        reused: 0,
+        total: 3,
+    });
+    expect(progress.at(-1)).toEqual({ phase: 'Writing hashes', completed: 1, total: 1, unit: 'files' });
+    expect(progress.find((update) => update.phase === 'Hashing' && update.completed === 3)).toBeDefined();
     const first = await readFile(join(root, HASHES_FILE), 'utf8');
     const json = JSON.parse(first);
     expect(json.version).toBe(1);

package/dist/core/hash.test.js.map

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

package/dist/core/process.d.ts

@@ -1,5 +1,7 @@
 import { type ImageMetrics } from './compare.js';
 import { type Suite } from './scan.js';
+import type { FidelityConfig } from './schema.js';
+import type { ProgressCallback } from './progress.js';
 export interface MetricsRecord extends ImageMetrics {
     width: number;
     height: number;
@@ -16,9 +18,56 @@ export interface ProcessResult {
         error: string;
     }[];
 }
-/** Writes metrics + delta for every (scene, output, reference, renderer) pair whose outputs are older than either input, then `index.json`. */
-export declare function processSuite(root: string, opts?: {
+export interface ProcessOptions {
     force?: boolean;
+    concurrency?: number;
     onCompute?: (file: string) => void;
-}): Promise<ProcessResult>;
+    onProgress?: ProgressCallback;
+}
+/** A fixed configuration, small per-scene dependency maps, and one bounded comparison queue. */
+export declare class SuiteProcessor {
+    readonly root: string;
+    private opts;
+    readonly config: FidelityConfig;
+    private suite;
+    private scenes;
+    private metrics;
+    private pending;
+    private unsettled;
+    private epochs;
+    private dirty;
+    private active;
+    private limit;
+    private concurrency;
+    private result;
+    private flushing?;
+    private force;
+    private indexDirty;
+    private progressCompleted;
+    private progressTotal;
+    private reportComparing;
+    private constructor();
+    static create(root: string, opts?: ProcessOptions): Promise<SuiteProcessor>;
+    /** Only source inputs qualify. Generated deltas, metrics, index and temporary files never do. */
+    sceneForInput(path: string): string | null;
+    /** Invalidate synchronously, including work already running; reconciliation happens at the batch boundary. */
+    notify(paths: Iterable<string>, defer?: boolean): void;
+    /** Release one coalesced watcher batch without delaying invalidation of running work. */
+    settle(): void;
+    get needsFlush(): boolean;
+    removeDirectory(path: string, defer?: boolean): void;
+    /** Comparisons start as scenes are discovered; no second walk or metrics reread is needed. */
+    initialize(process?: boolean): Promise<ProcessResult>;
+    flush(): Promise<ProcessResult>;
+    private reconcile;
+    private current;
+    private pump;
+    private readInputs;
+    private processPair;
+    private drain;
+}
+/** Process discovered scenes through the same scheduler used by watch mode. */
+export declare function processSuite(root: string, opts?: ProcessOptions): Promise<ProcessResult>;
+/** One-shot compatibility helper. Watch mode retains its SuiteProcessor instead. */
+export declare function processChanges(root: string, paths: Iterable<string>, onProgress?: ProgressCallback): Promise<ProcessResult>;
 //# sourceMappingURL=process.d.ts.map

package/dist/core/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/core/process.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAwB,KAAK,KAAK,EAAE,MAAM,WAAW,CAAC;AAG7D,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C;AAED,+IAA+I;AAC/I,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GACjE,OAAO,CAAC,aAAa,CAAC,CAqCxB"}
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/core/process.ts"],"names":[],"mappings":"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"}

package/dist/core/process.js

@@ -1,65 +1,464 @@
-import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
+import { mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { availableParallelism } from 'node:os';
+import { join } from 'node:path';
+import pLimit from 'p-limit';
 import { compareImages } from './compare.js';
-import { allScenes, scanSuite } from './scan.js';
+import { readConfig, scanScene, scanSuite } from './scan.js';
 import { deltaFile, imageFile, metricsFile } from './paths.js';
-const mtime = (p) => stat(p).then((s) => s.mtimeMs, () => 0);
-/** Writes metrics + delta for every (scene, output, reference, renderer) pair whose outputs are older than either input, then `index.json`. */
-export async function processSuite(root, opts = {}) {
-    const suite = await scanSuite(root);
-    const refs = suite.config.renderers.filter((r) => r.reference).map((r) => r.id);
-    const result = { computed: 0, skipped: 0, failed: [] };
-    for (const scene of allScenes(suite.root)) {
-        for (const [output, renderers] of Object.entries(scene.images)) {
-            const dir = join(root, scene.path, output);
-            for (const ref of refs.filter((r) => renderers.includes(r))) {
-                for (const r of renderers.filter((x) => x !== ref)) {
-                    const [refPath, testPath] = [join(dir, imageFile(ref)), join(dir, imageFile(r))];
-                    const metricsPath = join(dir, metricsFile(r, ref));
-                    const deltaPath = join(dir, deltaFile(r, ref));
-                    const inputs = Math.max(await mtime(refPath), await mtime(testPath));
-                    const outputs = [metricsPath, ...(suite.config.delta ? [deltaPath] : [])];
-                    const oldest = Math.min(...(await Promise.all(outputs.map(mtime))));
-                    if (!opts.force && oldest > inputs) {
-                        result.skipped += 1;
-                        continue;
+const emptyResult = () => ({ computed: 0, skipped: 0, failed: [] });
+const signatureKey = (inputs) => JSON.stringify(inputs);
+async function signature(path) {
+    try {
+        const s = await stat(path);
+        return s.isFile() ? { mtimeMs: s.mtimeMs, size: s.size } : null;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT' || error.code === 'ENOTDIR')
+            return null;
+        throw error;
+    }
+}
+function validMetrics(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const r = value;
+    return ((r.psnr === null || Number.isFinite(r.psnr)) &&
+        [r.rmse, r.mae, r.maxError].every((n) => Number.isFinite(n) && n >= 0 && n <= 1) &&
+        Number.isInteger(r.width) &&
+        r.width > 0 &&
+        Number.isInteger(r.height) &&
+        r.height > 0 &&
+        typeof r.generatedAt === 'string');
+}
+async function atomicWrite(file, data) {
+    const tmp = `${file}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(tmp, data);
+        await rename(tmp, file);
+    }
+    finally {
+        await rm(tmp, { force: true });
+    }
+}
+/** A fixed configuration, small per-scene dependency maps, and one bounded comparison queue. */
+export class SuiteProcessor {
+    root;
+    opts;
+    config;
+    suite;
+    scenes = new Map();
+    metrics = {};
+    pending = new Set();
+    unsettled = new Set();
+    epochs = new Map();
+    dirty = new Set();
+    active = new Set();
+    limit;
+    concurrency;
+    result = emptyResult();
+    flushing;
+    force;
+    indexDirty = false;
+    progressCompleted = 0;
+    progressTotal = 0;
+    reportComparing() {
+        this.opts.onProgress?.({
+            phase: 'Comparing',
+            completed: this.progressCompleted,
+            total: this.progressTotal,
+            unit: 'pairs',
+        });
+    }
+    constructor(root, config, opts) {
+        this.root = root;
+        this.opts = opts;
+        this.config = config;
+        this.suite = { config, hasReadme: false, root: { path: '', hasReadme: false, groups: [], scenes: [] } };
+        this.concurrency = opts.concurrency ?? availableParallelism();
+        if (!Number.isInteger(this.concurrency) || this.concurrency < 1)
+            throw new Error('Concurrency must be a positive integer');
+        this.limit = pLimit(this.concurrency);
+        this.force = opts.force ?? false;
+    }
+    static async create(root, opts = {}) {
+        return new SuiteProcessor(root, await readConfig(root), opts);
+    }
+    /** Only source inputs qualify. Generated deltas, metrics, index and temporary files never do. */
+    sceneForInput(path) {
+        const parts = path.split('/');
+        if (parts.some((p) => !p || p.startsWith('.')))
+            return null;
+        const file = parts.pop();
+        if (file === 'scene.json' && parts.length)
+            return parts.join('/');
+        if (file === 'README.md')
+            return parts.join('/');
+        if (file.includes('.vs-') && file.endsWith('.delta.avif'))
+            return null;
+        const output = parts.pop();
+        if (!parts.length || !this.config.outputs.some((o) => o.id === output))
+            return null;
+        if (!this.config.renderers.some((r) => imageFile(r.id) === file))
+            return null;
+        return parts.join('/');
+    }
+    /** Invalidate synchronously, including work already running; reconciliation happens at the batch boundary. */
+    notify(paths, defer = false) {
+        for (const path of paths) {
+            const scene = this.sceneForInput(path);
+            if (scene === null)
+                continue;
+            (defer ? this.unsettled : this.pending).add(scene);
+            this.epochs.set(scene, (this.epochs.get(scene) ?? 0) + 1);
+        }
+    }
+    /** Release one coalesced watcher batch without delaying invalidation of running work. */
+    settle() {
+        for (const scene of this.unsettled)
+            this.pending.add(scene);
+        this.unsettled.clear();
+    }
+    get needsFlush() {
+        return !!(this.pending.size || this.active.size || this.indexDirty);
+    }
+    removeDirectory(path, defer = false) {
+        for (const scene of this.scenes.keys()) {
+            if (scene === path || scene.startsWith(`${path}/`) || path.startsWith(`${scene}/`)) {
+                (defer ? this.unsettled : this.pending).add(scene);
+                this.epochs.set(scene, (this.epochs.get(scene) ?? 0) + 1);
+            }
+        }
+    }
+    /** Comparisons start as scenes are discovered; no second walk or metrics reread is needed. */
+    async initialize(process = true) {
+        if (!process) {
+            const index = JSON.parse(await readFile(join(this.root, 'index.json'), 'utf8'));
+            this.metrics = index.metrics;
+        }
+        try {
+            this.suite = await scanSuite(this.root, {
+                config: this.config,
+                onProgress: this.opts.onProgress,
+                onScene: async (scene) => {
+                    await this.reconcile(scene.path, scene, process);
+                },
+            });
+        }
+        catch (error) {
+            this.dirty.clear();
+            await Promise.all(this.active);
+            throw error;
+        }
+        if (!process) {
+            const valid = new Set([...this.scenes.values()].flatMap((scene) => [...scene.pairs.keys()]));
+            for (const key of Object.keys(this.metrics))
+                if (!valid.has(key))
+                    delete this.metrics[key];
+        }
+        this.indexDirty = process;
+        // Events collected during discovery are reconciled even when the initial processing was disabled.
+        return this.flush();
+    }
+    flush() {
+        if (!this.flushing)
+            this.flushing = this.drain().finally(() => {
+                this.flushing = undefined;
+            });
+        return this.flushing;
+    }
+    async reconcile(rel, node, process = true) {
+        const old = this.scenes.get(rel);
+        const pairs = new Map();
+        if (node) {
+            for (const [output, renderers] of Object.entries(node.images)) {
+                const images = new Map(await Promise.all(renderers.map(async (r) => {
+                    const path = `${rel}/${output}/${imageFile(r)}`;
+                    return [r, { path, signature: await signature(join(this.root, path)) }];
+                })));
+                for (const ref of this.config.renderers.filter((r) => r.reference && images.has(r.id))) {
+                    for (const renderer of renderers.filter((r) => r !== ref.id)) {
+                        const a = images.get(ref.id);
+                        const b = images.get(renderer);
+                        if (!a.signature || !b.signature)
+                            continue;
+                        const key = `${rel}/${output}/${metricsFile(renderer, ref.id)}`;
+                        const inputs = { reference: a.signature, renderer: b.signature };
+                        const pair = old?.pairs.get(key) ?? {
+                            key,
+                            scene: rel,
+                            reference: a.path,
+                            renderer: b.path,
+                            delta: `${rel}/${output}/${deltaFile(renderer, ref.id)}`,
+                            inputs,
+                            running: false,
+                            force: this.force,
+                        };
+                        if (signatureKey(pair.inputs) !== signatureKey(inputs)) {
+                            pair.inputs = inputs;
+                            pair.attempted = undefined;
+                            delete this.metrics[key];
+                        }
+                        pairs.set(key, pair);
+                        if (process && pair.attempted !== signatureKey(inputs)) {
+                            if (!this.dirty.has(pair) && !pair.running) {
+                                this.progressTotal++;
+                                this.reportComparing();
+                            }
+                            this.dirty.add(pair);
+                        }
                     }
+                }
+            }
+            this.scenes.set(rel, { node, pairs });
+        }
+        else {
+            this.scenes.delete(rel);
+            this.epochs.delete(rel);
+        }
+        for (const [key, pair] of old?.pairs ?? []) {
+            if (!pairs.has(key)) {
+                this.dirty.delete(pair);
+                delete this.metrics[key];
+            }
+        }
+        replaceScene(this.suite.root, rel, node);
+        this.indexDirty = true;
+        if (process)
+            this.pump();
+    }
+    current(pair, epoch) {
+        return this.scenes.get(pair.scene)?.pairs.get(pair.key) === pair && (this.epochs.get(pair.scene) ?? 0) === epoch;
+    }
+    pump() {
+        for (const pair of this.dirty) {
+            if (this.active.size >= this.concurrency)
+                break;
+            if (pair.running || this.unsettled.has(pair.scene))
+                continue;
+            this.dirty.delete(pair);
+            if (pair.attempted === signatureKey(pair.inputs))
+                continue;
+            pair.running = true;
+            const task = this.limit(() => this.processPair(pair)).finally(() => {
+                this.progressCompleted++;
+                this.reportComparing();
+                pair.running = false;
+                this.active.delete(task);
+                this.pump();
+            });
+            this.active.add(task);
+        }
+    }
+    async readInputs(pair) {
+        const [reference, renderer] = await Promise.all([
+            signature(join(this.root, pair.reference)),
+            signature(join(this.root, pair.renderer)),
+        ]);
+        return reference && renderer ? { reference, renderer } : null;
+    }
+    async processPair(pair) {
+        const epoch = this.epochs.get(pair.scene) ?? 0;
+        const inputs = pair.inputs;
+        const key = signatureKey(inputs);
+        const metricsPath = join(this.root, pair.key);
+        // Bump the recipe version when comparison or encoding semantics change.
+        const source = { version: 1, delta: this.config.delta, ...inputs };
+        const stillCurrent = async () => {
+            const actual = await this.readInputs(pair);
+            return this.current(pair, epoch) && signatureKey(actual) === key;
+        };
+        const retry = () => {
+            if (this.scenes.get(pair.scene)?.pairs.get(pair.key) === pair) {
+                pair.attempted = undefined;
+                if (!this.unsettled.has(pair.scene))
+                    this.pending.add(pair.scene);
+                this.indexDirty = true;
+                delete this.metrics[pair.key];
+            }
+        };
+        try {
+            if (!(await stillCurrent())) {
+                retry();
+                return;
+            }
+            let record;
+            if (!pair.force) {
+                try {
+                    const { source: saved, ...cached } = JSON.parse(await readFile(metricsPath, 'utf8'));
+                    if (JSON.stringify(saved) === JSON.stringify(source) &&
+                        validMetrics(cached) &&
+                        (!this.config.delta || (await signature(join(this.root, pair.delta)))))
+                        record = cached;
+                }
+                catch {
+                    /* Missing or invalid metrics are recomputed. */
+                }
+            }
+            if (record) {
+                if (!(await stillCurrent())) {
+                    retry();
+                    return;
+                }
+                this.result.skipped++;
+            }
+            else {
+                const compared = await compareImages(join(this.root, pair.reference), join(this.root, pair.renderer), {
+                    delta: this.config.delta,
+                });
+                record = {
+                    ...compared.metrics,
+                    width: compared.width,
+                    height: compared.height,
+                    generatedAt: new Date().toISOString(),
+                };
+                if (!(await stillCurrent())) {
+                    retry();
+                    return;
+                }
+                // Metrics are the commit marker: publish them only after all required artifacts exist.
+                if (this.config.delta)
+                    await atomicWrite(join(this.root, pair.delta), compared.deltaImage);
+                await atomicWrite(metricsPath, JSON.stringify({ ...record, source }, null, 2) + '\n');
+                if (!(await stillCurrent())) {
+                    retry();
+                    return;
+                }
+                this.result.computed++;
+                this.opts.onCompute?.(metricsPath);
+            }
+            pair.attempted = key;
+            pair.force = false;
+            this.metrics[pair.key] = record;
+            this.indexDirty = true;
+        }
+        catch (error) {
+            if (!this.current(pair, epoch) || signatureKey(await this.readInputs(pair).catch(() => null)) !== key) {
+                retry();
+                return;
+            }
+            pair.attempted = key; // Wait for changed inputs; do not spin on corrupt images.
+            delete this.metrics[pair.key];
+            this.indexDirty = true;
+            this.result.failed.push({
+                file: join(this.root, pair.renderer),
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    async drain() {
+        do {
+            while (this.pending.size || this.dirty.size || this.active.size) {
+                const pending = [...this.pending];
+                this.pending.clear();
+                let scanned = 0;
+                const reportScanning = () => this.opts.onProgress?.({
+                    phase: 'Scanning changes',
+                    completed: scanned,
+                    total: pending.length,
+                    unit: 'scenes',
+                });
+                if (pending.length)
+                    reportScanning();
+                for (const rel of pending) {
                     try {
-                        const { metrics, width, height, deltaImage } = await compareImages(refPath, testPath);
-                        const rec = { ...metrics, width, height, generatedAt: new Date().toISOString() };
-                        await writeFile(metricsPath, JSON.stringify(rec, null, 2) + '\n');
-                        if (suite.config.delta)
-                            await writeFile(deltaPath, deltaImage);
-                        result.computed += 1;
-                        opts.onCompute?.(metricsPath);
+                        if (!rel) {
+                            this.suite.hasReadme = !!(await signature(join(this.root, 'README.md')));
+                            this.suite.root.hasReadme = this.suite.hasReadme;
+                            this.indexDirty = true;
+                        }
+                        else {
+                            await this.reconcile(rel, await scanScene(this.root, rel, this.config));
+                            // Newly inserted groups and README-only changes need current presence flags too.
+                            let group = this.suite.root;
+                            for (const part of rel.split('/')) {
+                                const path = group.path ? `${group.path}/${part}` : part;
+                                const child = group.groups.find((g) => g.path === path);
+                                if (!child)
+                                    break;
+                                child.hasReadme = !!(await signature(join(this.root, path, 'README.md')));
+                                group = child;
+                            }
+                        }
                     }
-                    catch (e) {
-                        result.failed.push({ file: testPath, error: e instanceof Error ? e.message : String(e) });
+                    catch (error) {
+                        this.result.failed.push({
+                            file: join(this.root, rel),
+                            error: error instanceof Error ? error.message : String(error),
+                        });
                     }
+                    scanned++;
+                    reportScanning();
                 }
+                this.pump();
+                if (this.active.size)
+                    await Promise.race(this.active);
+                else if (!this.pending.size)
+                    break; // Remaining dirty nodes belong to an unsettled watcher batch.
             }
-        }
+            if (this.indexDirty) {
+                this.opts.onProgress?.({ phase: 'Writing index', completed: 0, total: 1, unit: 'files' });
+                const index = {
+                    ...this.suite,
+                    metrics: Object.fromEntries(Object.entries(this.metrics).toSorted(([a], [b]) => a.localeCompare(b))),
+                };
+                await mkdir(this.root, { recursive: true });
+                await atomicWrite(join(this.root, 'index.json'), JSON.stringify(index, null, 2) + '\n');
+                this.indexDirty = false;
+                this.opts.onProgress?.({ phase: 'Writing index', completed: 1, total: 1, unit: 'files' });
+            }
+        } while (this.pending.size);
+        this.force = false;
+        this.progressCompleted = 0;
+        this.progressTotal = 0;
+        const result = this.result;
+        this.result = emptyResult();
+        result.failed.sort((a, b) => a.file.localeCompare(b.file));
+        return result;
     }
-    await writeIndex(root, await scanSuite(root));
-    return result;
 }
-/** `index.json`: the scan plus every metrics record, so the viewer never walks the disk per request. */
-async function writeIndex(root, suite) {
-    const metrics = {};
-    for (const scene of allScenes(suite.root)) {
-        for (const [output, renderers] of Object.entries(scene.images)) {
-            for (const r of renderers) {
-                for (const ref of suite.config.renderers.filter((x) => x.reference)) {
-                    const rel = `${scene.path}/${output}/${metricsFile(r, ref.id)}`;
-                    const raw = await readFile(join(root, rel), 'utf8').catch(() => null);
-                    if (raw)
-                        metrics[rel] = JSON.parse(raw);
-                }
-            }
+/** Process discovered scenes through the same scheduler used by watch mode. */
+export async function processSuite(root, opts = {}) {
+    return (await SuiteProcessor.create(root, opts)).initialize();
+}
+/** One-shot compatibility helper. Watch mode retains its SuiteProcessor instead. */
+export async function processChanges(root, paths, onProgress) {
+    const processor = await SuiteProcessor.create(root, { onProgress });
+    try {
+        await processor.initialize(false);
+    }
+    catch {
+        return processSuite(root, { onProgress });
+    }
+    processor.notify(paths);
+    return processor.flush();
+}
+function replaceScene(root, path, scene) {
+    const parts = path.split('/');
+    const parents = [root];
+    let group = root;
+    for (const part of parts.slice(0, -1)) {
+        const groupPath = group.path ? `${group.path}/${part}` : part;
+        let child = group.groups.find((g) => g.path === groupPath);
+        if (!child && scene) {
+            child = { path: groupPath, hasReadme: false, groups: [], scenes: [] };
+            group.groups.push(child);
+            group.groups.sort((a, b) => a.path.localeCompare(b.path));
         }
+        if (!child)
+            return;
+        group = child;
+        parents.push(group);
+    }
+    group.scenes = group.scenes.filter((s) => s.path !== path);
+    if (scene)
+        group.scenes.push(scene);
+    group.scenes.sort((a, b) => a.path.localeCompare(b.path));
+    for (let i = parents.length - 1; i > 0; i--) {
+        const current = parents[i];
+        if (current.groups.length || current.scenes.length)
+            break;
+        parents[i - 1].groups = parents[i - 1].groups.filter((g) => g !== current);
     }
-    const file = join(root, 'index.json');
-    await mkdir(dirname(file), { recursive: true });
-    await writeFile(file, JSON.stringify({ ...suite, metrics }, null, 2) + '\n');
 }
 //# sourceMappingURL=process.js.map