mirror of
https://github.com/4gray/iptvnator.git
synced 2026-10-08 17:06:15 -08:00
4grayandClaude Fable 5.1
60d276e573
Resolves conflicts with #1692-#1695: keeps both perf scripts, both README paragraphs, one context-map row, and merges the J1 launch sections into the performance-journeys document next to the renderer.initialBytes contract. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
7.7 KiB
7.7 KiB
Agent context map
Read the row for your task before editing. For a cross-domain change, read each affected contract. This is navigation, not a request to load every linked file. Common constraints remain in AGENTS.md; Claude imports it. Repository skill frontmatter defines triggers. If your client does not discover a listed skill automatically, read its SKILL.md directly. Optional global tools are not prerequisites for reading repository contracts.
Development and maintenance
| Area / code ownership | Canonical documents | Repository skill |
|---|---|---|
| Bootstrap, project placement, dependencies, aliases and lint configuration; root Nx config and project-local project.json files | Nx boundaries, security overrides | Nx architecture |
| Angular conventions; docs and skills maintenance | Agent workflow | Use the area's skill below |
Unit, E2E, lint and coverage; tools/coverage |
Validation map | Use the area's validation section |
Performance journeys, counters, benchmark probes and the CI ratchet; apps/electron-backend-e2e/src/journeys, apps/electron-backend-e2e/src/performance, tools/performance |
Performance journeys | Read the contract directly |
Electron entry/events/preload and CDP; apps/electron-backend |
Debugging and trace flags, Electron security | Use the available global electron skill for automation |
Releases, notes, screenshots, native assets, Linux manager metadata; tools/release |
Release pipeline, note format | Release notes, release cut |
Data, sources and networking
| Area / code ownership | Required contracts | Repository skill |
|---|---|---|
SQLite schema/startup; libs/shared/database; Electron DB events/workers/operations |
DB worker, migration ownership and tests | SQLite worker |
M3U import/state/player, XMLTV, source lifecycle, startup readiness and OS file opening; libs/m3u-state, libs/playlist, libs/epg |
M3U module, adding sources across layers | Read both contracts when adding a source |
Xtream API/store/data sources and routed views; libs/portal/xtream |
Xtream compatibility, category management, detail navigation | Xtream |
Stalker/Ministra protocol, identity, sessions and routed views; libs/portal/stalker |
Stalker portal, Stalker EPG for EPG work, store API baseline for store API changes | Stalker |
Browser runtime, HTTP proxies, redirects and backend networking; apps/web-backend, libs/shared/host-health |
PWA/self-hosting, connectivity guard, Electron security for desktop boundary changes | Read the affected runtime contract |
| Source health and selective cleanup; portal shared data access | Desktop source health, subscription expiry | Read the affected provider skill |
| Backup and restore; playlist persistence | Backup/restore, database migrations | Read the affected persistence skill |
Playback, navigation and UI
| Area / code ownership | Required contracts | Repository skill |
|---|---|---|
Web engines, controls, tracks, PiP, radio and display sleep; libs/ui/playback |
Player controls, inline playback/diagnostics/recovery | Read the contract directly |
Embedded MPV, platform engines, addon, pinned runtime and packaging; Electron native services, tools/embedded-mpv |
Native MPV, runtime build and licensing | Read the contract directly |
| Live panels, keyboard focus, grid/layout conventions; shared UI and portal views | UI guidelines, detail navigation | UI design, theme/style |
Workspace routes, title bar, switcher, collections and dashboard; libs/workspace |
Workspace shell, dashboard, collection/detail navigation | UI/theme skills for visible changes |
Remote control, playback queue, channel return and shortcuts; libs/ui/remote-control, apps/remote-control-web |
Remote control | Provider skill when queue ownership changes |
Downloads, offline details, catch-up and file availability; libs/portal/downloads |
Download manager, provider contract for URL resolution | Read the affected provider skill |
VOD source discovery, factual metadata and failover; libs/portal/shared/data-access |
VOD multi-source | Xtream |
TMDB enrichment, artwork, actors and recommendations; libs/services/src/lib/tmdb |
TMDB contracts, dashboard | UI skill for rendering changes |
| Timezones, catch-up formatting and EPG display offsets | Date handling, Xtream compatibility, M3U EPG | Affected provider skill |
Website, blog and download pages; apps/website |
Website README | Use an available website skill |
Mock servers and fictional release fixtures; apps/stalker-mock-server, apps/xtream-mock-server |
Stalker mock, Xtream mock, release screenshot contract | Release-cut for release captures |
Maintenance rules
Keep unique behavior contracts in the authoritative document, procedures in a
skill or development guide, and universal constraints in AGENTS.md. Update this
map when ownership or a canonical destination changes. Preserve release skill
mirrors; do not create extra copies of other contracts for individual agents.
Use normal Markdown links for document destinations so pnpm run agents:validate
can check them. Do not add root imports for the linked documents.
The migration ledger explains how the original root instructions were accounted for. It is historical audit evidence, not another source of current runtime policy or required task context.