dtourolleandClaude Opus 5
c04d5a3dcc
Presence was decided by a LINQ predicate inline in the controller, so the semantics SR-002 sets were nowhere stated in code -- the read path complied by accident rather than by requirement. PresenceLookup is now the unit that decides, tagged, with the reasoning next to it. JR-004: windows are served exactly as given. UT-021 pins that [0,10] and [10,20] are not merged despite looking mergeable -- two windows mean a genuine departure and return, and collapsing them answers a different question from the one the truth file asked. UT-022 pins a byte-identical round trip. JR-005: bounds inclusive at both ends, zero-length windows are real sightings rather than degenerate ones to discard, overlaps resolve. The wording was the larger half of JR-005. The overlay rendered a bare list: it asserted nothing, but told the viewer nothing either, and the default reading of a paused frame is "these people are on screen" -- exactly what SR-002 forbids. It now carries an "In this scene" heading. ActorAtTime became ActorInScene, and README no longer contains "on screen" anywhere; it stated the forbidden reading outright in seven places, including the opening sentence. JR-006: measured rather than assumed. UT-023 builds 50 actors x 1000 windows and asserts the response is bounded by actor count, never window count. The lookup is a full scan on purpose -- an early exit on `start > t` would exploit the sortedness the format requires, but would silently under-report the moment one producer emitted windows out of order. UT-020 pins that unsorted input still resolves; WindowsAreSorted is a diagnostic, not a correctness dependency. Third mutation check: making the end bound exclusive fails UT-016 and UT-018 and nothing else. One character turns an inclusive window into a half-open one, dropping an actor at exactly the moment a scene ends. TRACES: UT-016, UT-017, UT-018, UT-019, UT-020, UT-021, UT-022, UT-023 TRACES: JR-004, JR-005, JR-006 | SR-002 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
54 lines
1.9 KiB
C#
54 lines
1.9 KiB
C#
using System.Collections.ObjectModel;
|
|
using System.Text.Json.Serialization;
|
|
|
|
namespace Jellyfin.Plugin.JRay.Models;
|
|
|
|
/// <summary>
|
|
/// Root object of a scene-actor-extraction "truth" file
|
|
/// (schema_version 1, minimal verbosity). See SPEC.md §1.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// JRay <b>owns</b> this format; the extraction pipeline is its producer and the
|
|
/// public server carries a derived envelope. Because three repos ship
|
|
/// independently, breaking changes are batched into one coordinated
|
|
/// <c>schema_version</c> bump rather than made piecemeal.
|
|
///
|
|
/// This type is still the v1 shape. JR-002 replaces it: <c>anneal_sec</c> out,
|
|
/// an <c>extraction</c> provenance block and a <c>cut</c> block in, and
|
|
/// <c>scenes</c> becoming objects that carry belief and identification route.
|
|
/// </remarks>
|
|
// TRACES: JR-001, JR-002 | SR-003
|
|
public class TruthFile
|
|
{
|
|
/// <summary>
|
|
/// Gets or sets the schema version of this file.
|
|
/// </summary>
|
|
[JsonPropertyName("schema_version")]
|
|
public int SchemaVersion { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the source media path at extraction time (informational).
|
|
/// </summary>
|
|
[JsonPropertyName("movie")]
|
|
public string Movie { get; set; } = string.Empty;
|
|
|
|
/// <summary>
|
|
/// Gets or sets the sampling rate (frames per second) used during extraction.
|
|
/// </summary>
|
|
[JsonPropertyName("sample_fps")]
|
|
public double SampleFps { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the gap (seconds) below which consecutive detections were merged into one scene.
|
|
/// </summary>
|
|
[JsonPropertyName("anneal_sec")]
|
|
public double AnnealSec { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets the list of actors in the film, each with their scene-presence windows.
|
|
/// </summary>
|
|
[JsonPropertyName("actors")]
|
|
[JsonObjectCreationHandling(JsonObjectCreationHandling.Populate)]
|
|
public Collection<TruthActor> Actors { get; } = new();
|
|
}
|