Project boundary: ersatztv owns the fork code, media-management owns channel operations #755
Closed
opened 2026-08-06 20:41:29 +02:00 by timothy
·
3 comments
No Branch/Tag Specified
main
renovate/dotnet-monorepo
renovate/meziantou.analyzer-3.x
renovate/lucene.net
renovate/sqlitepclraw.bundle_e_sqlite3-3.x
renovate/cliwrap-3.x
913-scripted-playout-401
release/v26.15.0-notes
issue-806-guard-populations
scratch/767b-poisoned
scratch/767b-control
release/v26.14.0-notes
release/v26.14.0
docs/510-skill-logo-bug-policy
fix/510-watermark-resolution-policy
fix/629-verdict-classifier-falseopens
fix/609-decisions-edit-token-scope
issue-135-clear-to-none
release/v26.12.0-notes
fix/409b-lastscan-api-parity
fix/401-updatechannel-mirror-422
fix/327-playlist-rename-validation
fix/410-scancancel-log-level
fix/409-447-librariesscreen-neverscanned
fix/338-zap-exit-code
fix/367-plex-budget-message
fix/310-debom-legacy-cs
ci/604-lane-rebalance
feat/388-design-mirror
feat/247-test-ownership
feat/247-primary-action
feat/357-player-owned-playback
feat/357-jellyfin-plugin-poc
fix/289-mcp-hardening
issue58-mcp
feat/244-channels-extract
ci/auto-bump-prod-compose
feat/multi-rerun-collections-api
feat/collections-api
feat/quick-wins
feat/185-docs-part2
feat/140-collections-screen
feat/146-channel-edit
feat/147-classic-ui-link
issue22-renovate-dashboard
feat/91-cutover
feat/63-composite-create
feat/65-library-browse
feat/85-epg
feat/86-schedule-editor
feat/109-dashboard-data
feat/99-session-tracking
fix/dockerfile-node-tag
feat/59-spa-foundation
docs/59-ui-redesign-brief
feat/102-json-guide
feat/111-schedule-durations
feat/104-artwork-upload
feat/103-media-sources-api
feat/playouts-read-api
feat/108-health-api
feat/105-picker-list-endpoints
issue-97-channel-state-api
issue42-jellyfin-musicvideos
issue46-rest-api-error-contract
dependabot/nuget/ErsatzTV.FFmpeg.Tests/multi-d307a2e06f
qsv-improvements
hdr-vulkan-cuda-test
v26.16.0
v26.15.0
v26.14.0
v26.13.0
v26.12.0
v26.11.0
v26.10.0
v26.9.0
v26.8.0
v26.7.0
blazor-final
v26.6.0
v26.5.0
v26.4.0
v26.3.1
v26.3.0
v26.2.0
v26.1.1
v26.1.0
v25.9.0
v25.8.0
v25.7.1
v25.7.0
v25.6.0
v25.5.0
v25.4.0
v25.3.1
v25.3.0
v25.2.0
v25.1.0
v0.8.8-beta
v0.8.7-beta
v0.8.6-beta
v0.8.5-beta
v0.8.4-beta
v0.8.3-beta
v0.8.2-beta
v0.8.1-beta
v0.8.0-beta
v0.7.9-beta
v0.7.8-beta
v0.7.7-beta
v0.7.6-beta
v0.7.5-beta
v0.7.4-beta
v0.7.3-beta
v0.7.2-beta
v0.7.1-beta
v0.7.0-beta
v0.6.9-beta
v0.6.8-beta
v0.6.7-beta
v0.6.6-beta
v0.6.5-beta
v0.6.4-beta
v0.6.3-beta
v0.6.2-beta
v0.6.1-beta
v0.6.0-beta
v0.5.8-beta
v0.5.7-beta
v0.5.6-beta
v0.5.5-beta
v0.5.4-beta
v0.5.3-beta
v0.5.2-beta
v0.5.1-beta
v0.5.0-beta
v0.4.5-alpha
v0.4.4-alpha
v0.4.3-alpha
v0.4.2-alpha
v0.4.1-alpha
v0.4.0-alpha
v0.3.8-alpha
v0.3.7-alpha
develop
v0.3.6-alpha
v0.3.5-alpha
v0.3.4-alpha
v0.3.3-alpha
v0.3.2-alpha
v0.3.1-alpha
v0.3.0-alpha
v0.2.5-alpha
v0.2.4-alpha
v0.2.3-alpha
v0.2.2-alpha
v0.2.1-alpha
v0.2.0-alpha
v0.1.5-alpha
v0.1.4-alpha
v0.1.3-alpha
v0.1.2-alpha
v0.1.1-alpha
v0.1.0-alpha
v0.0.62-alpha
v0.0.61-alpha
v0.0.60-alpha
v0.0.59-alpha
v0.0.58-alpha
v0.0.57-alpha
v0.0.56-alpha
v0.0.55-alpha
v0.0.54-alpha
v0.0.53-alpha
v0.0.52-alpha
v0.0.51-alpha
v0.0.50-alpha
v0.0.49-prealpha
v0.0.48-prealpha
v0.0.47-prealpha
v0.0.46-prealpha
v0.0.45-prealpha
v0.0.44-prealpha
v0.0.43-prealpha
v0.0.42-prealpha
v0.0.41-prealpha
v0.0.40-prealpha
v0.0.39-prealpha
v0.0.38-prealpha
v0.0.37-prealpha
v0.0.36-prealpha
v0.0.35-prealpha
v0.0.34-prealpha
v0.0.33-prealpha
v0.0.32-prealpha
v0.0.31-prealpha
v0.0.30-prealpha
v0.0.29-prealpha
v0.0.28-prealpha
v0.0.27-prealpha
v0.0.26-prealpha
v0.0.25-prealpha
v0.0.24-prealpha
v0.0.23-prealpha
v0.0.22-prealpha
v0.0.21-prealpha
v0.0.20-prealpha
v0.0.19-prealpha
v0.0.18-prealpha
v0.0.17-prealpha
v0.0.16-prealpha
v0.0.15-prealpha
v0.0.14-prealpha
v0.0.13-prealpha
v0.0.12-prealpha
v0.0.11-prealpha
v0.0.10-prealpha
v0.0.9-prealpha
v0.0.8-prealpha
v0.0.7-prealpha
v0.0.6-prealpha
v0.0.5-prealpha
v0.0.4-prealpha
v0.0.3-prealpha
v0.0.2-prealpha
v0.0.1-prealpha
Labels
Clear labels
ad-hoc
api
bug
ci-cd
content
dependencies
enhancement
frontend
in-progress
jellyfin
parked
priority: high
priority: low
priority: medium
review
security
One-off / ad-hoc work not tracked by a dedicated issue
REST API / HTTP endpoints
Something isn't working
Build, test, deploy pipeline
Channel content / schedules / playlists
Dependency updates (Renovate)
New feature or improvement
ChicoryTV React SPA frontend
Claimed by an active session — do not pick up
Jellyfin tuner / IPTV integration
Excluded from automatic queue pickup; work only when explicitly selected
Adversarial review finding
Security / vulnerability fix
No labels
priority: medium
Milestone
No items
No Milestone
Projects
Clear projects
No projects
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: timothy/ersatztv#755
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
CLAUDE.md→ Project Boundaries currently says ersatztv OWNS "channel/collection/schedulemanagement". That is wrong: this repo is for developing the fork — code, CI, releases. Day-to-day
channel operations against the running instance (creating and editing channels, lineups, collections,
schedules, playouts, logos, overlays) belong to
media-management.The two repos actively contradicted each other.
media-management/CLAUDE.mdclaimed it wasauthoritative for the ersatztv skill while this repo claimed the canonical copy is here (#617), and
~/homelab-docs/Operations/Project Boundaries.mdlisted the skill owner asserver-management— threefiles, three answers.
Already fixed outside this repo (media-management
472d83e, homelab-docs1512972):media-management/.claude/skills/ersatztvwas a divergent fork of the skill, last touched2026-07-20, opening with "ErsatzTV is a Blazor server-side app, NOT a traditional REST API … use
Playwright against the web UI or direct SQLite DB manipulation", plus "No auth required" and version
26.3.0. All false since #91b removed the Blazor UI and the api-key filter went fail-closed. Replacedwith a symlink to the canonical copy here; the old text is archived with its false claims labelled.
Remaining, in this repo:
Done-when
CLAUDE.md→ Project Boundaries states the split: ersatztv owns fork code, CI, releases, the/api/v1surface, the MCP server and the ersatztv skill; media-management owns channel operationsdocs/decisions/records/process/captures it, catalog regeneratedmedia-managementalso symlinks itcanonical skill — it is accurate (verified 2026-08-06 against
scripted-schedule.json, all 28operations match) and exists nowhere else
Claiming this (Claude Code session, 2026-08-26). Pre-claim checks per
process.parallel-session-claim: no open PR references #755 (all five open PRs are Renovate), no remote branch names it (git ls-remote --heads origin), no prior comments, freshgit fetch origin mainate8e17f384. Three parallel sessions are active; the branches/labels they hold (#732/#734/#746 in-progress,fix/748-workflow-permissions) are disjoint from this docs+skill scope.Closing record
Outcome: SHIPPED — PR #838 (squashed to
main).CLAUDE.md→ Project Boundaries now states thesplit, a decision record captures it (
process.ersatztv-owns-code-not-operations), the canonicalskill's banner names both symlinks, and the Scripted Schedule API table is folded into the skill.
All five
## Done-whenboxes satisfied.Root cause:
CLAUDE.mdused one phrase — "channel/collection/schedule management" — for twodifferent jobs. Writing a
ProgramSchedulehandler is fork code; creating a schedule on the liveinstance is an operation. Nothing in the wording distinguished them, so three files ended up with
three answers about skill ownership and media-management's copy silently became a divergent fork
describing a Blazor UI that #91b had removed.
Decisions/conventions changed: Added
process.ersatztv-owns-code-not-operations(new record,catalog regenerated). No supersessions.
Reusable knowledge:
docs/endpoint-index.mddoes NOT cover the scripted-schedule API. The scripted spec is aseparate OpenAPI document (
ErsatzTV/wwwroot/openapi/scripted-schedule.json), and the indexgenerator only walks
v1.json—grep -c scripted docs/endpoint-index.mdreturns 0. Anyoneanswering "what endpoints exist" from the index will silently miss all 28 scripted operations.
scripted-schedule.jsonandscripted-schedule-tagged.jsoncarry the same 28 paths and both return 200; they differ only intag grouping, and Scalar's
/docsrenders the-taggedone.buildIdby probing. Measured:unauthenticated both forms are 401 (the api-key filter precedes routing); authenticated with a
non-live build id, both are 404 — including the correct path. Read the route in
ScriptedScheduleController.cs; do not infer it from a status code.one was refuted by execution, across four review rounds: (a) "only the un-tagged spec is
fetchable" (all three return 200); (b) "a wrong path only becomes visible once the key is right"
(the correct path 404s too); (c) an NRE warning built on
System.Text.Jsonsemantics, when thesecontrollers use Newtonsoft (
Startup.cs:506-512,NullValueHandling.Ignore) and MVC's implicit[Required]rejects an explicit null at model validation anyway — 400, never a 500. Each wasindividually plausible and individually wrong. The cheap probe that settled each one took under two
minutes; the source-reading that produced each took longer and was confidently wrong.
mechanism is the stop rule — the paragraph was deleted rather than corrected again, keeping only
the source-verified sentence.
ControlWatermarkOff's own[Description]string. Copying a claim from the code's own documentation is not checking it.Newtonsoft-with-Ignore, Newtonsoft-default and System.Text.Json alike. Only an explicit
"watermark": nulldistinguishes them.Verification:
python3 -m pytest scripts/tests→ 956 passed, 2 skipped.decisions-validate: OK;catalog regenerates byte-identical.
check-doc-narrative --diff origin/main→ 0 warnings. The28-operation table re-derived by an independent
$ref-resolving parser: zero missing, zero extra,zero field mismatches. Both embedded snippets executed verbatim from
~/media-managementand~/server-management→ 28 ops each. Boundary sweep by subject found no surviving stale claim.Four rounds of cold, worktree-isolated adversarial review;
Review-verdict: MERGEABLE @ 70526ce.Full CI green on the merged head (the
web/CI-parity pre-push block was skipped as vacuous — thediff contains no
web/and no.csfiles).Deferred:
behaviour depends on
NullValueHandling.Ignorestaying set, nothing records the dependency, and notest would catch it changing (a formatter swap turns a documented 200 into a 400).
~/homelab-docs/Operations/Project Boundaries.mdstillcontains a stale tree diagram — "ersatztv ├── Owns: ErsatzTV fork code, channel management" — which
contradicts the corrected tables in the same file (lines 15-16, 86-87). homelab-docs is
server-management's to change, so it was not touched here.
Docs updated:
CLAUDE.md,docs/decisions/records/process/ersatztv-owns-code-not-operations.md(new),
docs/decisions/README.md(regenerated),.claude/skills/ersatztv/SKILL.md.Follow-up (vault): the deferred item in the closing record above is now also fixed —
homelab-docs
cf27724.~/homelab-docs/Operations/Project Boundaries.mdcontained an ownership treestill reading "ersatztv — Owns: ErsatzTV fork code, channel management", contradicting the tables in
the same file that commit
1512972had already corrected for this split. The tree now matches, and"media-management (once ready)" is dropped since the repo exists with issues enabled.
Nothing deferred remains for #755 except ersatztv#837, which is tracked separately.