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>
86 lines
2.8 KiB
C#
86 lines
2.8 KiB
C#
using System;
|
|
using System.Collections.Generic;
|
|
using Jellyfin.Plugin.JRay.Models;
|
|
|
|
namespace Jellyfin.Plugin.JRay.Services;
|
|
|
|
/// <summary>
|
|
/// Resolves the effective prioritise/ignore action for an item from the
|
|
/// configured rules. More specific scopes win: an Item rule overrides a
|
|
/// Series rule, which overrides a Genre rule. Because a given scope+value can
|
|
/// hold only one action, the only conflicts possible are across scopes, and
|
|
/// specificity resolves those.
|
|
/// </summary>
|
|
// TRACES: JR-016 | PR-003
|
|
public static class PolicyResolver
|
|
{
|
|
/// <summary>
|
|
/// Computes the effective action for an item, or <c>null</c> if no rule matches.
|
|
/// </summary>
|
|
/// <param name="rules">The configured rules.</param>
|
|
/// <param name="itemId">The item's id.</param>
|
|
/// <param name="seriesId">The item's series id, or <see cref="Guid.Empty"/> if it is not an episode.</param>
|
|
/// <param name="genres">The item's genres.</param>
|
|
/// <returns>The effective <see cref="PolicyAction"/>, or <c>null</c> when unruled.</returns>
|
|
public static PolicyAction? Resolve(
|
|
IReadOnlyList<MediaPolicyRule> rules,
|
|
Guid itemId,
|
|
Guid seriesId,
|
|
IReadOnlyList<string> genres)
|
|
{
|
|
ArgumentNullException.ThrowIfNull(rules);
|
|
|
|
PolicyAction? itemAction = null;
|
|
PolicyAction? seriesAction = null;
|
|
PolicyAction? genreAction = null;
|
|
|
|
var itemIdStr = itemId.ToString("D");
|
|
var seriesIdStr = seriesId == Guid.Empty ? null : seriesId.ToString("D");
|
|
|
|
foreach (var rule in rules)
|
|
{
|
|
switch (rule.Scope)
|
|
{
|
|
case PolicyScope.Item:
|
|
if (string.Equals(rule.Value, itemIdStr, StringComparison.OrdinalIgnoreCase))
|
|
{
|
|
itemAction = rule.Action;
|
|
}
|
|
|
|
break;
|
|
|
|
case PolicyScope.Series:
|
|
if (seriesIdStr is not null && string.Equals(rule.Value, seriesIdStr, StringComparison.OrdinalIgnoreCase))
|
|
{
|
|
seriesAction = rule.Action;
|
|
}
|
|
|
|
break;
|
|
|
|
case PolicyScope.Genre:
|
|
if (genres is not null && MatchesGenre(genres, rule.Value))
|
|
{
|
|
genreAction = rule.Action;
|
|
}
|
|
|
|
break;
|
|
}
|
|
}
|
|
|
|
return itemAction ?? seriesAction ?? genreAction;
|
|
}
|
|
|
|
private static bool MatchesGenre(IReadOnlyList<string> genres, string value)
|
|
{
|
|
for (var i = 0; i < genres.Count; i++)
|
|
{
|
|
if (string.Equals(genres[i], value, StringComparison.OrdinalIgnoreCase))
|
|
{
|
|
return true;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
}
|