dtourolleandClaude Opus 5
3b24fe1b3c
jRay had no requirement IDs, so nothing in this repo could be traced to and the CI gate had no denominator to read. The other two components had already moved to registers; this brings the plugin level with them. Adds docs/requirements.md with 46 permanent JR-nnn IDs, each carrying a parent requirement, priority, status and verification tier, plus a per-requirement verification plan. JR is flat rather than split by theme: the plugin is one deployable with one audience, and JRay-public-server already ships UR/DR, so a second repo using those prefixes would make UR-007 ambiguous across registers. Rewrites SPEC.md as requirements prose with Current:/Gap: on every one. It had drifted into a format-plus-API reference that documented schema_version 1 while owning a format whose v2 shape was specified only in the other two repos, said nothing about SR-002's scene-scoped semantics, and carried the manifest exchange as a "planned" aside while its configuration classes were already implemented. Plugin-side exchange obligations move here from the server's spec, where they were an ownership inversion. Adds JR-038..041 for PR-005, which had no software row in any repo -- it was held structurally by SR-004 and GR-005 both being prohibitions, and a goal preserved only by prohibitions is the kind that erodes unnoticed. jRay is the component that actually opens a socket. Tags 18 units with the requirements they satisfy. Tags name what the code satisfies, so FileTransformationRegistration is not tagged JR-021: that requirement is a prohibition and was still violated elsewhere when this was written. Vendors jray-project as a submodule for the system spec and shared gate. TRACES: JR-001, JR-004, JR-005, JR-007, JR-008, JR-009, JR-010, JR-011 TRACES: JR-012, JR-013, JR-014, JR-015, JR-016, JR-017, JR-018, JR-019 TRACES: JR-020, JR-024, JR-025, JR-036, JR-038 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 detected in the film, each with their on-screen scene windows.
|
|
/// </summary>
|
|
[JsonPropertyName("actors")]
|
|
[JsonObjectCreationHandling(JsonObjectCreationHandling.Populate)]
|
|
public Collection<TruthActor> Actors { get; } = new();
|
|
}
|