41 lines
2.2 KiB
Text
41 lines
2.2 KiB
Text
|
// SPDX-License-Identifier: AGPL-3.0-only
|
||
|
|
// SPDX-FileCopyrightText: Copyright (C) 2026 Catcrafts®
|
||
|
|
|
||
|
|
export module Crafter.Review:Normalize;
|
||
|
|
import std;
|
||
|
|
import :Json;
|
||
|
|
|
||
|
|
// From the raw structured output of a pass to its discharge, its coverage
|
||
|
|
// contract and its derived verdict; the merge of a lens's parts with the
|
||
|
|
// cross-unit rule; the coverage matrix. The structured output is the model's
|
||
|
|
// JSON and stays JSON, with every field the model wrote.
|
||
|
|
export namespace Crafter::Review::Normalize {
|
||
|
|
// An exact id, else the one id of `universe` it is a prefix of, else
|
||
|
|
// itself.
|
||
|
|
Json ResolveId(const Json& id, std::span<const std::string> universe);
|
||
|
|
|
||
|
|
// v: the raw structured output ({verdict, findings, notes, coverage?}).
|
||
|
|
// Its notes get their items resolved in place, and the result holds them.
|
||
|
|
// inventory: the units THIS pass must cover (null: no coverage contract);
|
||
|
|
// allIds: every inventory id, for prefix resolution.
|
||
|
|
Json NormalizeOutput(Json& v, std::span<const Json> inForce, std::string_view lensFile, std::string_view hash, const Json& inventory,
|
||
|
|
std::span<const std::string> allIds);
|
||
|
|
|
||
|
|
// The distinct values of `items`, first occurrence kept, equal when their
|
||
|
|
// canonical JSON is.
|
||
|
|
std::vector<Json> Dedupe(std::span<const Json> items);
|
||
|
|
|
||
|
|
// parts: normalized outputs (each with partLabel, expectedIds);
|
||
|
|
// missingUnits: unit ids whose process never returned. Coverage: one entry
|
||
|
|
// per unit, blocking > immaterial > the rest, a tie to the later part
|
||
|
|
// (the block, the zoomed view). The cross-unit rule: a unit cited by an
|
||
|
|
// undischarged finding whose merged verdict is not blocking is
|
||
|
|
// overwritten with the lens's blocking verdict.
|
||
|
|
Json MergeParts(std::string_view lens, std::string_view lensFile, std::span<const Json> parts, std::span<const std::string> missingUnits,
|
||
|
|
const Json& stoppedEarly = nullptr);
|
||
|
|
|
||
|
|
// Units x every lens that returned coverage; holes (a reviewed-kind unit
|
||
|
|
// no lens owned) and defects. notReviewed: the unit ids no lens that runs
|
||
|
|
// reads, listed, never holes.
|
||
|
|
Json Matrix(const Json& inventory, std::span<const Json> results, std::span<const std::string> notReviewed = {});
|
||
|
|
}
|