Minos.NET.Recording 1.11.0

Minos.NET.Recording

A decision recorder for Minos.NET: one pipeline stage writes a record of every decision, with its question set, state, answers and usage, to a JSONL file or a sink of your own. Outcomes are attached to a record later by its decision id, and records are erased by a key you choose. The stage never delays or fails a decision, runs your redaction before anything is kept, and never puts the state, an id or a key in a log, a trace or a metric. Native AOT-compatible.

dotnet add package Minos.NET.Recording

using Minos;
using Minos.Recording;

await using var sink = new JsonlDecisionRecordSink("decisions.jsonl");
await using var recorder = new DecisionRecorder(sink);

// Outermost, so one decision is one record.
using var recorded = client.AsBuilder().UseRecording(recorder).Build();

using (var scope = DecisionRecording.Begin(erasureKey: customerId))
{
    var answers = await recorded.EvaluateAsync<Triage>(message);
    await recorder.AddOutcomeAsync(
        scope.DecisionId!,
        DecisionOutcome.Signal("mailer", DateTimeOffset.UtcNow, "complained"));
}

// Completes after the sink has erased the customer's records, or throws RecordingException.
await recorder.EraseAsync(customerId);

await foreach (var decision in DecisionRecordFile.ReadAsync("decisions.jsonl", CancellationToken.None))
{
    Console.WriteLine($"{decision.Record.DecisionId}: {decision.Outcomes.Count} outcomes");
}

Shadow mode runs a candidate provider beside the primary in the background, without changing the primary's result, and keeps its answers in the decision's record. UseRecording(new ShadowOptions(candidate, dailyCap: 500), recorder) turns it on; ShadowReport in Minos.NET.Evaluation and minos shadow-report then compare the two:

// The candidate must not record its own decisions. Share one ShadowOptions per candidate, so its cap is shared.
var shadow = new ShadowOptions(localClient, dailyCap: 500);
using var shadowed = client.AsBuilder().UseRecording(shadow, recorder).Build();

For a candidate that is a client registered in the container, UseShadowRecording(provider => provider.GetRequiredService<ShadowOptions>()) creates the options from the container, and takes the recorder from it too. Register the ShadowOptions as a singleton, so its cap is shared.

Documentation: Recording decisions. Source and issues: github.com/MarcelRoozekrans/Minos.NET. Licensed under the MIT license.