hoi4-agent-tools 0.0.0-bootstrap.1 → 0.1.2

package/dist/hoi4_agent_tools/core/diff.js

@@ -0,0 +1,93 @@
+const defaultMaxMatrixCells = 16_000_000;
+function splitLines(text) {
+    if (text.length === 0)
+        return [];
+    return text.match(/[^\r\n]*(?:\r\n|\r|\n)|[^\r\n]+$/gu) ?? [];
+}
+function lineContent(line) {
+    return line.replace(/(?:\r\n|\r|\n)$/u, '');
+}
+export function unifiedTextDiff(oldText, newText, oldName, newName, options = {}) {
+    options.signal?.throwIfAborted();
+    if (oldText === newText)
+        return '';
+    const oldLines = splitLines(oldText);
+    const newLines = splitLines(newText);
+    const rows = lcsDiff(oldLines, newLines, options);
+    return [
+        `--- ${oldName}`,
+        `+++ ${newName}`,
+        `@@ -1,${oldLines.length} +1,${newLines.length} @@`,
+        ...rows,
+    ].join('\n');
+}
+function lcsDiff(oldLines, newLines, options) {
+    const columns = newLines.length + 1;
+    const cells = (oldLines.length + 1) * columns;
+    const maxMatrixCells = options.maxMatrixCells ?? defaultMaxMatrixCells;
+    if (!Number.isSafeInteger(cells) || cells > maxMatrixCells) {
+        throw new ServiceError('DIFF_COMPLEXITY_LIMIT', 'Exact source diff exceeds the configured deterministic memory bound', { oldLines: oldLines.length, newLines: newLines.length, cells, maxMatrixCells });
+    }
+    const table = new Uint32Array(cells);
+    for (let oldIndex = oldLines.length - 1; oldIndex >= 0; oldIndex -= 1) {
+        if ((oldIndex & 0x3f) === 0)
+            options.signal?.throwIfAborted();
+        for (let newIndex = newLines.length - 1; newIndex >= 0; newIndex -= 1) {
+            if ((newIndex & 0xfff) === 0)
+                options.signal?.throwIfAborted();
+            const current = oldIndex * columns + newIndex;
+            table[current] =
+                oldLines[oldIndex] === newLines[newIndex]
+                    ? table[(oldIndex + 1) * columns + newIndex + 1] + 1
+                    : Math.max(table[(oldIndex + 1) * columns + newIndex], table[oldIndex * columns + newIndex + 1]);
+        }
+    }
+    const result = [];
+    let oldIndex = 0;
+    let newIndex = 0;
+    while (oldIndex < oldLines.length || newIndex < newLines.length) {
+        if (((oldIndex + newIndex) & 0xff) === 0)
+            options.signal?.throwIfAborted();
+        if (oldIndex < oldLines.length &&
+            newIndex < newLines.length &&
+            oldLines[oldIndex] === newLines[newIndex]) {
+            result.push(` ${lineContent(oldLines[oldIndex])}`);
+            oldIndex += 1;
+            newIndex += 1;
+        }
+        else if (newIndex < newLines.length &&
+            (oldIndex === oldLines.length ||
+                table[oldIndex * columns + newIndex + 1] >= table[(oldIndex + 1) * columns + newIndex])) {
+            result.push(`+${lineContent(newLines[newIndex])}`);
+            newIndex += 1;
+        }
+        else {
+            result.push(`-${lineContent(oldLines[oldIndex])}`);
+            oldIndex += 1;
+        }
+    }
+    return result;
+}
+export function binaryDiff(oldBytes, newBytes) {
+    const length = Math.max(oldBytes.length, newBytes.length);
+    let changedBytes = 0;
+    let firstChangedOffset;
+    let lastChangedOffset;
+    for (let index = 0; index < length; index += 1) {
+        if (oldBytes[index] !== newBytes[index]) {
+            changedBytes += 1;
+            firstChangedOffset ??= index;
+            lastChangedOffset = index;
+        }
+    }
+    return {
+        oldSize: oldBytes.length,
+        newSize: newBytes.length,
+        changedBytes,
+        ...(firstChangedOffset === undefined
+            ? {}
+            : { firstChangedOffset, lastChangedOffset: lastChangedOffset }),
+    };
+}
+import { ServiceError } from './result.js';
+//# sourceMappingURL=diff.js.map

package/dist/hoi4_agent_tools/core/diff.js.map

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

package/dist/hoi4_agent_tools/core/engine.d.ts

@@ -0,0 +1,56 @@
+import type { WorkspaceRegistration } from './configuration.js';
+import type { Diagnostic } from './diagnostics.js';
+import { SymbolIndex, type IndexSkippedSource } from './index.js';
+import { WorkspaceScanner, type ScanOptions, type ScannedFile } from './scanner.js';
+import { ArtifactStore } from './artifacts.js';
+import { TransactionManager } from './transactions.js';
+import type { WorkspaceResolver } from './workspace.js';
+export interface ScanSnapshot {
+    workspaceId: string;
+    revision: string;
+    files: ScannedFile[];
+    index: SymbolIndex;
+    complete: boolean;
+    skippedSourceCount: number;
+    skippedSources: readonly IndexSkippedSource[];
+    diagnostics: Diagnostic[];
+}
+export interface WorkspaceStatus {
+    id: string;
+    name: string;
+    kind: string;
+    writeEnabled: boolean;
+    rootKinds: string[];
+    dependencyCount: number;
+    replacePaths: string[];
+    replacementOwners: Array<{
+        rootKind: string;
+        loadOrder: number;
+        paths: string[];
+    }>;
+    generatedDirectory: '.hoi4-agent';
+}
+export interface CoreEngineServices {
+    scanner?: WorkspaceScanner;
+    artifacts?: ArtifactStore;
+    transactions?: TransactionManager;
+}
+export declare class CoreEngine {
+    #private;
+    readonly resolver: WorkspaceResolver;
+    readonly scanner: WorkspaceScanner;
+    readonly artifacts: ArtifactStore;
+    readonly transactions: TransactionManager;
+    constructor(resolver: WorkspaceResolver, services?: CoreEngineServices);
+    initialize(): Promise<void>;
+    register(registration: WorkspaceRegistration, principal?: string, signal?: AbortSignal): Promise<WorkspaceStatus>;
+    status(workspaceId: string, principal?: string): WorkspaceStatus;
+    list(principal?: string): WorkspaceStatus[];
+    scan(workspaceId: string, options?: Partial<ScanOptions>, principal?: string, signal?: AbortSignal): Promise<ScanSnapshot>;
+    invalidate(workspaceId: string): void;
+    private awaitScanFlight;
+    private withScanAdmission;
+    private drainScanAdmissionQueue;
+    indexFiles(files: readonly ScannedFile[]): SymbolIndex;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/hoi4_agent_tools/core/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/hoi4_agent_tools/core/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC9C,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnF,kBAAkB,EAAE,aAAa,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAkED,qBAAa,UAAU;;aAWH,QAAQ,EAAE,iBAAiB;IAV7C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;gBAQxB,QAAQ,EAAE,iBAAiB,EAC3C,QAAQ,GAAE,kBAAuB;IA4B7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,QAAQ,CACZ,YAAY,EAAE,qBAAqB,EACnC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC;IAe3B,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe;IA2BhE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IAIrC,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,EAClC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC;IAwExB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAYrC,OAAO,CAAC,eAAe;IAyDvB,OAAO,CAAC,iBAAiB;IAqCzB,OAAO,CAAC,uBAAuB;IA6B/B,UAAU,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW;CAGvD"}

package/dist/hoi4_agent_tools/core/engine.js

@@ -0,0 +1,319 @@
+import { compareCodeUnits, hashCanonical } from './canonical.js';
+import { SymbolIndex } from './index.js';
+import { WorkspaceScanner } from './scanner.js';
+import { ArtifactStore } from './artifacts.js';
+import { TransactionManager } from './transactions.js';
+function abortReason(signal) {
+    return signal.reason instanceof Error
+        ? signal.reason
+        : new DOMException('The operation was aborted', 'AbortError');
+}
+function scanFailureReason(reason) {
+    return reason instanceof Error ? reason : new Error('Workspace scan failed', { cause: reason });
+}
+function under(roots, glob) {
+    return roots.map((root) => `${root.replaceAll('\\', '/').replace(/\/$/u, '')}/${glob}`);
+}
+function englishLocalisationPatterns(roots) {
+    return [...under(roots, 'english/**/*.{yml,yaml}'), ...under(roots, '*.{yml,yaml}')];
+}
+function defaultPatterns(workspace) {
+    const roots = workspace.registration.roots;
+    return [
+        ...new Set([
+            ...under(roots.focus, '**/*.txt'),
+            ...under(roots.focus, '**/*.focus-plan.json'),
+            'common/continuous_focus/**/*.txt',
+            ...under(roots.scriptedGui, '**/*.txt'),
+            'common/decisions/**/*.txt',
+            'common/ideas/**/*.txt',
+            'common/characters/**/*.txt',
+            'common/scripted_effects/**/*.txt',
+            'common/scripted_triggers/**/*.txt',
+            'events/**/*.txt',
+            ...under(roots.states, '**/*.txt'),
+            // Binary rasters and positional data tables are domain-selected by Agent
+            // Nudger. The shared symbol scan retains only map sources it can index.
+            ...under(roots.map, '**/*.map'),
+            ...under(roots.map, '**/*.csv'),
+            ...under(roots.map, '**/strategicregions/**/*.txt'),
+            ...under(roots.map, '**/supply_nodes.txt'),
+            ...under(roots.map, '**/railways.txt'),
+            ...under(roots.interface, '**/*.{gui,gfx}'),
+            ...under(roots.gfx, '**/*.gfx'),
+            // Shared scans index the default player language. GUI scenario scans add
+            // the explicitly requested language without retaining every translation.
+            ...englishLocalisationPatterns(roots.localisation),
+        ]),
+    ].sort((left, right) => compareCodeUnits(left, right));
+}
+export class CoreEngine {
+    resolver;
+    scanner;
+    artifacts;
+    transactions;
+    #scanCache = new Map();
+    #scanFlights = new Map();
+    #scanGenerations = new Map();
+    #scanAdmissionQueue = [];
+    #activeScanAdmissions = new Set();
+    constructor(resolver, services = {}) {
+        this.resolver = resolver;
+        this.scanner =
+            services.scanner ??
+                new WorkspaceScanner(resolver.config().scanMaxFiles, resolver.config().scanMaxBytes, resolver.config().scanMaxFileBytes);
+        this.artifacts =
+            services.artifacts ??
+                new ArtifactStore(resolver.config().artifactMaxBytes, resolver.config().artifactMaxEntries, resolver.config().artifactMaxSingleBytes);
+        this.transactions =
+            services.transactions ??
+                new TransactionManager(resolver, this.artifacts, resolver.config().transactionTtlSeconds, resolver.config().transactionMaxJournalBytes, resolver.config().transactionMaxJournals, resolver.serverState());
+    }
+    async initialize() {
+        for (const workspace of this.resolver.list()) {
+            // Recovery is a safety repair, not a newly authorized write. An interrupted
+            // transaction must be restored even if the operator restarts read-only.
+            await this.transactions.recover(workspace.id);
+        }
+    }
+    async register(registration, principal, signal) {
+        signal?.throwIfAborted();
+        const workspace = await this.resolver.register(registration, principal, signal);
+        // Runtime registrations are intentionally not persisted, so startup could not
+        // discover an interrupted journal for this root. Recover it before exposing the
+        // workspace or allowing another write transaction.
+        try {
+            await this.transactions.recover(workspace.id, principal, signal);
+        }
+        catch (error) {
+            this.resolver.unregisterRuntime(workspace.id, principal);
+            throw error;
+        }
+        return this.status(workspace.id, principal);
+    }
+    status(workspaceId, principal) {
+        const workspace = this.resolver.get(workspaceId, principal);
+        return {
+            id: workspace.id,
+            name: workspace.name,
+            kind: workspace.registration.kind,
+            writeEnabled: workspace.writeEnabled,
+            rootKinds: [...new Set(workspace.roots.map(({ kind }) => kind))].sort((a, b) => compareCodeUnits(a, b)),
+            dependencyCount: workspace.dependencyRoots.length,
+            replacePaths: [...workspace.registration.replacePaths].sort((a, b) => compareCodeUnits(a, b)),
+            replacementOwners: workspace.roots
+                .filter(({ replacePaths }) => replacePaths.length > 0)
+                .map(({ kind, loadOrder, replacePaths }) => ({
+                rootKind: kind,
+                loadOrder,
+                paths: [...replacePaths].sort((a, b) => compareCodeUnits(a, b)),
+            }))
+                .sort((left, right) => left.loadOrder - right.loadOrder || compareCodeUnits(left.rootKind, right.rootKind)),
+            generatedDirectory: '.hoi4-agent',
+        };
+    }
+    list(principal) {
+        return this.resolver.list(principal).map(({ id }) => this.status(id, principal));
+    }
+    async scan(workspaceId, options = {}, principal, signal) {
+        signal?.throwIfAborted();
+        const workspace = this.resolver.get(workspaceId, principal);
+        const patterns = options.patterns ?? defaultPatterns(workspace);
+        const ignore = options.ignore;
+        const generation = this.#scanGenerations.get(workspaceId) ?? 0;
+        const requestKey = `${workspaceId}:${generation}:${hashCanonical({
+            patterns: [...patterns].sort(),
+            ignore: [...(ignore ?? [])].sort(),
+            maxFiles: options.maxFiles ?? this.resolver.config().scanMaxFiles,
+            maxBytes: options.maxBytes ?? this.resolver.config().scanMaxBytes,
+        })}`;
+        let flight = this.#scanFlights.get(requestKey);
+        if (flight === undefined) {
+            const controller = new AbortController();
+            const promise = (async () => {
+                return this.withScanAdmission(controller.signal, async () => {
+                    const files = await this.scanner.scan(workspace, {
+                        patterns,
+                        ...(ignore === undefined ? {} : { ignore }),
+                        ...(options.maxFiles === undefined ? {} : { maxFiles: options.maxFiles }),
+                        ...(options.maxBytes === undefined ? {} : { maxBytes: options.maxBytes }),
+                        signal: controller.signal,
+                    });
+                    controller.signal.throwIfAborted();
+                    const revision = hashCanonical(files.map(({ displayPath, loadOrder, sha256 }) => ({ displayPath, loadOrder, sha256 })));
+                    const cacheKey = `${requestKey}:${revision}`;
+                    const cached = this.#scanCache.get(cacheKey);
+                    if (cached !== undefined)
+                        return cached;
+                    const index = SymbolIndex.build(files);
+                    const snapshot = {
+                        workspaceId,
+                        revision,
+                        files,
+                        index,
+                        complete: index.complete,
+                        skippedSourceCount: index.skippedSourceCount,
+                        skippedSources: index.skippedSources,
+                        diagnostics: index.diagnostics,
+                    };
+                    if ((this.#scanGenerations.get(workspaceId) ?? 0) === generation) {
+                        for (const key of this.#scanCache.keys()) {
+                            if (key.startsWith(`${workspaceId}:`))
+                                this.#scanCache.delete(key);
+                        }
+                        this.#scanCache.set(cacheKey, snapshot);
+                    }
+                    return snapshot;
+                });
+            })();
+            flight = { promise, controller, waiters: 0, settled: false };
+            this.#scanFlights.set(requestKey, flight);
+            const createdFlight = flight;
+            void promise.then(() => {
+                createdFlight.settled = true;
+                if (this.#scanFlights.get(requestKey) === createdFlight) {
+                    this.#scanFlights.delete(requestKey);
+                }
+            }, () => {
+                createdFlight.settled = true;
+                if (this.#scanFlights.get(requestKey) === createdFlight) {
+                    this.#scanFlights.delete(requestKey);
+                }
+            });
+        }
+        return this.awaitScanFlight(requestKey, flight, signal);
+    }
+    invalidate(workspaceId) {
+        this.#scanGenerations.set(workspaceId, (this.#scanGenerations.get(workspaceId) ?? 0) + 1);
+        for (const key of this.#scanCache.keys()) {
+            if (key.startsWith(`${workspaceId}:`))
+                this.#scanCache.delete(key);
+        }
+        for (const [key, flight] of this.#scanFlights) {
+            if (!key.startsWith(`${workspaceId}:`))
+                continue;
+            this.#scanFlights.delete(key);
+            flight.controller.abort();
+        }
+    }
+    awaitScanFlight(requestKey, flight, signal) {
+        signal?.throwIfAborted();
+        flight.waiters += 1;
+        return new Promise((resolve, reject) => {
+            let complete = false;
+            const finish = () => {
+                if (complete)
+                    return;
+                complete = true;
+                signal?.removeEventListener('abort', abort);
+                flight.controller.signal.removeEventListener('abort', abortFlight);
+                flight.waiters = Math.max(0, flight.waiters - 1);
+                if (flight.waiters === 0 && !flight.settled) {
+                    if (this.#scanFlights.get(requestKey) === flight)
+                        this.#scanFlights.delete(requestKey);
+                    flight.controller.abort();
+                }
+            };
+            const abort = () => {
+                reject(signal === undefined
+                    ? new DOMException('The operation was aborted', 'AbortError')
+                    : abortReason(signal));
+                finish();
+            };
+            const abortFlight = () => {
+                reject(abortReason(flight.controller.signal));
+                finish();
+            };
+            signal?.addEventListener('abort', abort, { once: true });
+            flight.controller.signal.addEventListener('abort', abortFlight, { once: true });
+            if (signal?.aborted === true) {
+                abort();
+                return;
+            }
+            if (flight.controller.signal.aborted) {
+                abortFlight();
+                return;
+            }
+            void flight.promise.then((snapshot) => {
+                if (complete)
+                    return;
+                finish();
+                resolve(snapshot);
+            }, (error) => {
+                if (complete)
+                    return;
+                reject(scanFailureReason(error));
+                finish();
+            });
+        });
+    }
+    withScanAdmission(signal, action) {
+        return new Promise((resolve, reject) => {
+            const request = {
+                signal,
+                started: false,
+                settled: false,
+                reject,
+                run: () => {
+                    request.started = true;
+                    this.#activeScanAdmissions.add(request);
+                    void Promise.resolve()
+                        .then(() => {
+                        signal.throwIfAborted();
+                        return action();
+                    })
+                        .then(resolve, reject)
+                        .finally(() => {
+                        request.settled = true;
+                        signal.removeEventListener('abort', onAbort);
+                        this.#activeScanAdmissions.delete(request);
+                        this.drainScanAdmissionQueue();
+                    });
+                },
+            };
+            const onAbort = () => {
+                if (!request.started && !request.settled) {
+                    request.settled = true;
+                    request.reject(abortReason(signal));
+                }
+                this.drainScanAdmissionQueue();
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+            this.#scanAdmissionQueue.push(request);
+            this.drainScanAdmissionQueue();
+        });
+    }
+    drainScanAdmissionQueue() {
+        while (this.#scanAdmissionQueue.length > 0) {
+            const request = this.#scanAdmissionQueue[0];
+            if (request === undefined)
+                return;
+            if (request.settled || request.signal.aborted) {
+                this.#scanAdmissionQueue.shift();
+                if (!request.settled) {
+                    request.settled = true;
+                    request.reject(abortReason(request.signal));
+                }
+                continue;
+            }
+            if (this.#activeScanAdmissions.size > 0) {
+                // Normal scans remain globally serialized. A single replacement may
+                // bypass an admitted scan only after that physical scan has been
+                // aborted. Keeping the physical-call ceiling at two prevents repeated
+                // invalidations from accumulating an unbounded number of scanners that
+                // ignore AbortSignal.
+                if (this.#activeScanAdmissions.size >= 2)
+                    return;
+                const active = this.#activeScanAdmissions.values().next().value;
+                if (active?.signal.aborted !== true)
+                    return;
+            }
+            this.#scanAdmissionQueue.shift();
+            request.run();
+        }
+    }
+    indexFiles(files) {
+        return SymbolIndex.build(files);
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/hoi4_agent_tools/core/engine.js.map

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

package/dist/hoi4_agent_tools/core/image-diff.d.ts

@@ -0,0 +1,14 @@
+import { RenderBudget } from './render-budget.js';
+export interface PngComparisonResult {
+    width: number;
+    height: number;
+    changedPixels: number;
+    changedRatio: number;
+    png: Buffer;
+    json: string;
+}
+/** Deterministic transparent review baseline for a newly created renderable target. */
+export declare function createTransparentPng(width: number, height: number, label: string, budget?: RenderBudget): Promise<Buffer>;
+/** Deterministic exact-channel PNG comparison shared by every workbench. */
+export declare function comparePngImages(leftPng: Buffer, rightPng: Buffer, threshold?: number, signal?: AbortSignal, budget?: RenderBudget): Promise<PngComparisonResult>;
+//# sourceMappingURL=image-diff.d.ts.map

package/dist/hoi4_agent_tools/core/image-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-diff.d.ts","sourceRoot":"","sources":["../../../src/hoi4_agent_tools/core/image-diff.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AAG7F,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AA8CD,uFAAuF;AACvF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,eAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,4EAA4E;AAC5E,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAI,EACb,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,eAAqB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAyE9B"}

package/dist/hoi4_agent_tools/core/image-diff.js

@@ -0,0 +1,121 @@
+import sharp from 'sharp';
+import { canonicalJson } from './canonical.js';
+import { assertRenderDimensions, RenderBudget, RENDER_MAX_PIXELS } from './render-budget.js';
+import { ServiceError } from './result.js';
+const IMAGE_DIFF_YIELD_PIXELS = 65_536;
+async function yieldImageDiff(signal) {
+    signal?.throwIfAborted();
+    await new Promise((resolve) => setImmediate(resolve));
+    signal?.throwIfAborted();
+}
+async function imageMetadata(png, label) {
+    try {
+        return await sharp(png, { limitInputPixels: RENDER_MAX_PIXELS }).metadata();
+    }
+    catch (error) {
+        if (error instanceof Error && /pixel limit/iu.test(error.message)) {
+            throw new ServiceError('RENDER_PIXELS_BLOCKED', `${label} exceeds the fixed per-artifact pixel ceiling`, { label, maximumPixels: RENDER_MAX_PIXELS });
+        }
+        throw error;
+    }
+}
+async function normalizeImage(png, sourceWidth, sourceHeight, width, height, label) {
+    assertRenderDimensions(sourceWidth, sourceHeight, `${label} input`);
+    assertRenderDimensions(width, height, `${label} normalized plane`);
+    return sharp(png, { limitInputPixels: RENDER_MAX_PIXELS })
+        .ensureAlpha()
+        .extend({
+        right: Math.max(0, width - sourceWidth),
+        bottom: Math.max(0, height - sourceHeight),
+        background: { r: 0, g: 0, b: 0, alpha: 0 },
+    })
+        .raw()
+        .toBuffer();
+}
+/** Deterministic transparent review baseline for a newly created renderable target. */
+export async function createTransparentPng(width, height, label, budget = new RenderBudget()) {
+    assertRenderDimensions(width, height, label);
+    budget.reserve(width, height, label);
+    return sharp({
+        create: {
+            width,
+            height,
+            channels: 4,
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+        },
+        limitInputPixels: RENDER_MAX_PIXELS,
+    })
+        .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
+        .toBuffer();
+}
+/** Deterministic exact-channel PNG comparison shared by every workbench. */
+export async function comparePngImages(leftPng, rightPng, threshold = 8, signal, budget = new RenderBudget()) {
+    signal?.throwIfAborted();
+    const [leftMetadata, rightMetadata] = await Promise.all([
+        imageMetadata(leftPng, 'left comparison PNG'),
+        imageMetadata(rightPng, 'right comparison PNG'),
+    ]);
+    const leftWidth = leftMetadata.width;
+    const leftHeight = leftMetadata.height;
+    const rightWidth = rightMetadata.width;
+    const rightHeight = rightMetadata.height;
+    assertRenderDimensions(leftWidth, leftHeight, 'left comparison PNG');
+    assertRenderDimensions(rightWidth, rightHeight, 'right comparison PNG');
+    const width = Math.max(leftWidth, rightWidth);
+    const height = Math.max(leftHeight, rightHeight);
+    budget.reserve(width, height, 'left comparison normalized plane');
+    budget.reserve(width, height, 'right comparison normalized plane');
+    budget.reserve(width, height, 'comparison diff plane');
+    const [left, right] = await Promise.all([
+        normalizeImage(leftPng, leftWidth, leftHeight, width, height, 'left comparison PNG'),
+        normalizeImage(rightPng, rightWidth, rightHeight, width, height, 'right comparison PNG'),
+    ]);
+    signal?.throwIfAborted();
+    const output = Buffer.alloc(width * height * 4);
+    let changedPixels = 0;
+    for (let pixel = 0; pixel < width * height; pixel += 1) {
+        if (pixel > 0 && pixel % IMAGE_DIFF_YIELD_PIXELS === 0)
+            await yieldImageDiff(signal);
+        const offset = pixel * 4;
+        const delta = Math.max(Math.abs(left.readUInt8(offset) - right.readUInt8(offset)), Math.abs(left.readUInt8(offset + 1) - right.readUInt8(offset + 1)), Math.abs(left.readUInt8(offset + 2) - right.readUInt8(offset + 2)), Math.abs(left.readUInt8(offset + 3) - right.readUInt8(offset + 3)));
+        if (delta > threshold) {
+            changedPixels += 1;
+            output[offset] = 255;
+            output[offset + 1] = 58;
+            output[offset + 2] = 94;
+            output[offset + 3] = 255;
+        }
+        else {
+            const luminance = Math.round((left.readUInt8(offset) + left.readUInt8(offset + 1) + left.readUInt8(offset + 2)) / 3);
+            output[offset] = luminance;
+            output[offset + 1] = luminance;
+            output[offset + 2] = luminance;
+            output[offset + 3] = 96;
+        }
+    }
+    assertRenderDimensions(width, height, 'comparison diff Sharp raster');
+    const png = await sharp(output, {
+        raw: { width, height, channels: 4 },
+        limitInputPixels: RENDER_MAX_PIXELS,
+    })
+        .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
+        .toBuffer();
+    signal?.throwIfAborted();
+    const changedRatio = changedPixels / (width * height);
+    return {
+        width,
+        height,
+        changedPixels,
+        changedRatio,
+        png,
+        json: `${canonicalJson({
+            offline: true,
+            width,
+            height,
+            changedPixels,
+            changedRatio,
+            threshold,
+        })}\n`,
+    };
+}
+//# sourceMappingURL=image-diff.js.map