lootforge 0.3.0

package/dist/checks/consistencyOutliers.js

@@ -0,0 +1,156 @@
+const OUTLIER_METRICS = [
+    {
+        name: "clip",
+        keys: ["clip.rawScore", "clip.alignment"],
+    },
+    {
+        name: "lpips",
+        keys: ["lpips.rawScore", "lpips.perceptual_distance"],
+    },
+];
+const DEFAULT_WARNING_THRESHOLD = 1.75;
+const DEFAULT_PENALTY_THRESHOLD = 2.5;
+const DEFAULT_PENALTY_WEIGHT = 25;
+const MIN_SCALE = 1e-6;
+export function computeConsistencyGroupOutliers(targets, options) {
+    const defaultWarningThreshold = options?.warningThreshold ?? DEFAULT_WARNING_THRESHOLD;
+    const defaultPenaltyThreshold = options?.penaltyThreshold ?? DEFAULT_PENALTY_THRESHOLD;
+    const defaultPenaltyWeight = options?.penaltyWeight ?? DEFAULT_PENALTY_WEIGHT;
+    const byTargetId = new Map();
+    const groups = [];
+    const groupsById = new Map();
+    for (const target of targets) {
+        if (!target.consistencyGroup) {
+            continue;
+        }
+        const bucket = groupsById.get(target.consistencyGroup);
+        if (bucket) {
+            bucket.push(target);
+        }
+        else {
+            groupsById.set(target.consistencyGroup, [target]);
+        }
+    }
+    for (const [consistencyGroup, groupTargets] of Array.from(groupsById.entries()).sort((a, b) => a[0].localeCompare(b[0]))) {
+        if (groupTargets.length < 2) {
+            continue;
+        }
+        const metricSeries = new Map();
+        for (const metric of OUTLIER_METRICS) {
+            const byTargetId = new Map();
+            for (const target of groupTargets) {
+                const value = resolveMetricValue(target.candidateMetrics, metric.keys);
+                if (typeof value === "number") {
+                    byTargetId.set(target.targetId, value);
+                }
+            }
+            if (byTargetId.size < 2) {
+                continue;
+            }
+            const values = Array.from(byTargetId.values());
+            const median = medianOf(values);
+            const deviations = values.map((value) => Math.abs(value - median));
+            const mad = medianOf(deviations);
+            const scale = Math.max(mad, Math.abs(median) * 0.1, MIN_SCALE);
+            metricSeries.set(metric.name, { byTargetId, median, scale });
+        }
+        const metricMedians = {};
+        for (const [metricName, series] of metricSeries.entries()) {
+            metricMedians[metricName] = series.median;
+        }
+        const warningTargetIds = [];
+        const outlierTargetIds = [];
+        let maxScore = 0;
+        let totalPenalty = 0;
+        let evaluatedTargetCount = 0;
+        for (const target of groupTargets) {
+            const reasons = [];
+            const metricDeltas = {};
+            let signalCount = 0;
+            let normalizedDriftSum = 0;
+            const warningThreshold = target.consistencyGroupScoring?.warningThreshold ?? defaultWarningThreshold;
+            const penaltyThreshold = target.consistencyGroupScoring?.penaltyThreshold ?? defaultPenaltyThreshold;
+            const penaltyWeight = target.consistencyGroupScoring?.penaltyWeight ?? defaultPenaltyWeight;
+            for (const [metricName, series] of metricSeries.entries()) {
+                const value = series.byTargetId.get(target.targetId);
+                if (typeof value !== "number") {
+                    continue;
+                }
+                signalCount += 1;
+                const delta = Math.abs(value - series.median);
+                const normalizedDrift = delta / series.scale;
+                metricDeltas[`${metricName}Delta`] = delta;
+                normalizedDriftSum += normalizedDrift;
+                if (normalizedDrift >= warningThreshold) {
+                    reasons.push(normalizedDrift >= penaltyThreshold ? `${metricName}_outlier` : `${metricName}_warning`);
+                }
+            }
+            if (signalCount === 0) {
+                continue;
+            }
+            evaluatedTargetCount += 1;
+            const score = normalizedDriftSum / signalCount;
+            const warned = score >= warningThreshold;
+            const penalty = score >= penaltyThreshold ? Math.round(score * penaltyWeight) : 0;
+            if (warned) {
+                warningTargetIds.push(target.targetId);
+            }
+            if (penalty > 0) {
+                outlierTargetIds.push(target.targetId);
+            }
+            maxScore = Math.max(maxScore, score);
+            totalPenalty += penalty;
+            byTargetId.set(target.targetId, {
+                score,
+                warningThreshold,
+                threshold: penaltyThreshold,
+                penaltyThreshold,
+                penaltyWeight,
+                warned,
+                penalty,
+                reasons,
+                metricDeltas,
+            });
+        }
+        groups.push({
+            consistencyGroup,
+            targetCount: groupTargets.length,
+            evaluatedTargetCount,
+            warningTargetIds: warningTargetIds.sort((left, right) => left.localeCompare(right)),
+            outlierTargetIds: outlierTargetIds.sort((left, right) => left.localeCompare(right)),
+            warningCount: warningTargetIds.length,
+            outlierCount: outlierTargetIds.length,
+            maxScore,
+            totalPenalty,
+            metricMedians,
+        });
+    }
+    return {
+        byTargetId,
+        groups,
+    };
+}
+function resolveMetricValue(metrics, keys) {
+    if (!metrics) {
+        return undefined;
+    }
+    for (const key of keys) {
+        const value = metrics[key];
+        if (typeof value === "number" && Number.isFinite(value)) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function medianOf(values) {
+    const sorted = [...values].sort((left, right) => left - right);
+    if (sorted.length === 0) {
+        return 0;
+    }
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 1) {
+        return sorted[mid];
+    }
+    return (sorted[mid - 1] + sorted[mid]) / 2;
+}
+//# sourceMappingURL=consistencyOutliers.js.map

package/dist/checks/consistencyOutliers.js.map

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

package/dist/checks/imageAcceptance.d.ts

@@ -0,0 +1,67 @@
+import { type PackInvariantSummary } from "./packInvariants.js";
+import { type PlannedTarget } from "../providers/types.js";
+export interface ImageAcceptanceIssue {
+    level: "error" | "warning";
+    code: string;
+    targetId: string;
+    imagePath: string;
+    message: string;
+}
+export interface ImageAcceptanceMetrics {
+    seamScore?: number;
+    seamStripPx?: number;
+    wrapGridColumns?: number;
+    wrapGridRows?: number;
+    wrapGridSeamScore?: number;
+    wrapGridSeamStripPx?: number;
+    wrapGridTopologyComparisons?: number;
+    wrapGridTopologyMismatchRatio?: number;
+    wrapGridTopologyThreshold?: number;
+    wrapGridTopologyColorTolerance?: number;
+    styleLineContrast?: number;
+    styleShadingBandCount?: number;
+    styleUiRectilinearity?: number;
+    mattingMaskCoverage?: number;
+    mattingSemiTransparencyRatio?: number;
+    mattingMaskConsistency?: number;
+    mattingHiddenRgbLeak?: number;
+    paletteCompliance?: number;
+    distinctColors?: number;
+    alphaBoundaryPixels?: number;
+    alphaHaloRisk?: number;
+    alphaStrayNoise?: number;
+    alphaEdgeSharpness?: number;
+}
+export interface ImageAcceptanceItemReport {
+    targetId: string;
+    out: string;
+    imagePath: string;
+    exists: boolean;
+    width?: number;
+    height?: number;
+    format?: string;
+    sizeBytes?: number;
+    hasAlphaChannel?: boolean;
+    hasTransparentPixels?: boolean;
+    metrics?: ImageAcceptanceMetrics;
+    issues: ImageAcceptanceIssue[];
+}
+export interface ImageAcceptanceReport {
+    generatedAt: string;
+    imagesDir: string;
+    strict: boolean;
+    total: number;
+    passed: number;
+    failed: number;
+    errors: number;
+    warnings: number;
+    items: ImageAcceptanceItemReport[];
+    packInvariants?: PackInvariantSummary;
+}
+export declare function evaluateImageAcceptance(target: PlannedTarget, imagesDir: string): Promise<ImageAcceptanceItemReport>;
+export declare function runImageAcceptanceChecks(params: {
+    targets: PlannedTarget[];
+    imagesDir: string;
+    strict?: boolean;
+}): Promise<ImageAcceptanceReport>;
+export declare function assertImageAcceptanceReport(report: ImageAcceptanceReport): void;