@torrent-tv/proxy 2.89.17 → 2.89.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (299) hide show
  1. package/README.md +14 -3
  2. package/package.json +10 -2
  3. package/server.js +0 -11
  4. package/.claude/commands/opsx/apply.md +0 -155
  5. package/.claude/commands/opsx/archive.md +0 -160
  6. package/.claude/commands/opsx/explore.md +0 -174
  7. package/.claude/commands/opsx/propose.md +0 -109
  8. package/.claude/commands/opsx/sync.md +0 -143
  9. package/.claude/skills/openspec-apply-change/SKILL.md +0 -159
  10. package/.claude/skills/openspec-archive-change/SKILL.md +0 -117
  11. package/.claude/skills/openspec-explore/SKILL.md +0 -289
  12. package/.claude/skills/openspec-propose/SKILL.md +0 -113
  13. package/.claude/skills/openspec-sync-specs/SKILL.md +0 -147
  14. package/.dockerignore +0 -5
  15. package/AGENTS.md +0 -363
  16. package/CHANGELOG.md +0 -2377
  17. package/Dockerfile +0 -30
  18. package/biome.json +0 -412
  19. package/corpus.tmp.json +0 -1
  20. package/docs/browser-proxy-contract.md +0 -155
  21. package/docs/container-architecture.md +0 -273
  22. package/docs/download-architecture.md +0 -261
  23. package/docs/encode-architecture.md +0 -765
  24. package/docs/encode-run-state.md +0 -96
  25. package/docs/logs.md +0 -151
  26. package/docs/playback-start-forecast.md +0 -113
  27. package/docs/socks5-egress-research.md +0 -114
  28. package/docs/storage-architecture.md +0 -273
  29. package/knip.json +0 -14
  30. package/main2.cpuprofile +0 -1
  31. package/openspec/changes/adaptive-bitrate/.openspec.yaml +0 -0
  32. package/openspec/changes/adaptive-bitrate/design.md +0 -92
  33. package/openspec/changes/adaptive-bitrate/proposal.md +0 -56
  34. package/openspec/changes/adaptive-bitrate/specs/adaptive-bitrate/spec.md +0 -51
  35. package/openspec/changes/adaptive-bitrate/tasks.md +0 -40
  36. package/openspec/changes/binary-distribution/.openspec.yaml +0 -2
  37. package/openspec/changes/binary-distribution/proposal.md +0 -53
  38. package/openspec/changes/chunked-request-bodies/design.md +0 -81
  39. package/openspec/changes/chunked-request-bodies/proposal.md +0 -53
  40. package/openspec/changes/chunked-request-bodies/specs/chunked-request-bodies/spec.md +0 -30
  41. package/openspec/changes/chunked-request-bodies/tasks.md +0 -40
  42. package/openspec/changes/cold-start/design.md +0 -98
  43. package/openspec/changes/cold-start/proposal.md +0 -62
  44. package/openspec/changes/cold-start/specs/cold-start/spec.md +0 -47
  45. package/openspec/changes/cold-start/tasks.md +0 -48
  46. package/openspec/changes/disk-cap/.openspec.yaml +0 -2
  47. package/openspec/changes/disk-cap/proposal.md +0 -37
  48. package/openspec/changes/disk-cap/specs/disk-cap/spec.md +0 -25
  49. package/openspec/changes/disk-cap/tasks.md +0 -19
  50. package/openspec/changes/proxy-observability/.openspec.yaml +0 -2
  51. package/openspec/changes/proxy-observability/design.md +0 -38
  52. package/openspec/changes/proxy-observability/proposal.md +0 -49
  53. package/openspec/changes/proxy-observability/specs/observability/spec.md +0 -33
  54. package/openspec/changes/proxy-observability/tasks.md +0 -21
  55. package/openspec/changes/seek-debounce/.openspec.yaml +0 -0
  56. package/openspec/changes/seek-debounce/design.md +0 -118
  57. package/openspec/changes/seek-debounce/proposal.md +0 -59
  58. package/openspec/changes/seek-debounce/specs/seek-debounce/spec.md +0 -41
  59. package/openspec/changes/seek-debounce/tasks.md +0 -33
  60. package/openspec/changes/subtitle-language/.openspec.yaml +0 -2
  61. package/openspec/changes/subtitle-language/proposal.md +0 -50
  62. package/openspec/changes/subtitle-language/specs/subtitle-language/spec.md +0 -34
  63. package/openspec/changes/subtitle-language/tasks.md +0 -26
  64. package/openspec/changes/track-selection/.openspec.yaml +0 -2
  65. package/openspec/changes/track-selection/design.md +0 -47
  66. package/openspec/changes/track-selection/proposal.md +0 -45
  67. package/openspec/changes/track-selection/specs/track-selection/spec.md +0 -41
  68. package/openspec/changes/track-selection/tasks.md +0 -20
  69. package/openspec/changes/transcode-quality/.openspec.yaml +0 -2
  70. package/openspec/changes/transcode-quality/proposal.md +0 -51
  71. package/openspec/changes/transcode-quality/specs/transcode-quality/spec.md +0 -139
  72. package/openspec/changes/transcode-quality/tasks.md +0 -63
  73. package/openspec/config.yaml +0 -38
  74. package/public/.well-known/appspecific/com.chrome.devtools.json +0 -1
  75. package/research/delivery-wedge-stand-ladder-2026-09-13.md +0 -329
  76. package/research/double-spawn-2026-09-10.md +0 -171
  77. package/research/handover-2026-09-13.md +0 -209
  78. package/research/handover-reader-claims-removal-2026-09-12.md +0 -166
  79. package/research/piece-withdrawn-but-still-claimed-2026-09-12.md +0 -175
  80. package/research/preset-benchmark-size-scaling-2026-08-22.md +0 -55
  81. package/research/priority-map-is-the-truth-2026-09-12.md +0 -225
  82. package/research/valgrind-replica-2026-08-27/logs.tar.gz +0 -0
  83. package/scripts/build-audio-samples.mjs +0 -31
  84. package/scripts/render-run-graph.js +0 -173
  85. package/test/asset-paths.test.js +0 -28
  86. package/test/audio-buffer-continuity.test.js +0 -77
  87. package/test/audio-calibration.test.js +0 -23
  88. package/test/audio-inventory.test.js +0 -212
  89. package/test/audio-track-bitrate.test.js +0 -40
  90. package/test/audio-warm-recorded.test.js +0 -63
  91. package/test/auto-quality-step.test.js +0 -762
  92. package/test/available-share.test.js +0 -76
  93. package/test/background-fill.test.js +0 -190
  94. package/test/client-log-file.test.js +0 -126
  95. package/test/client-logs-route.test.js +0 -34
  96. package/test/coalesce.test.js +0 -39
  97. package/test/completed-files.test.js +0 -115
  98. package/test/concurrent-cost.test.js +0 -148
  99. package/test/container-media-info.test.js +0 -228
  100. package/test/contention.test.js +0 -76
  101. package/test/core-dumps.test.js +0 -57
  102. package/test/coverage-follows-the-disk.test.js +0 -233
  103. package/test/coverage-map.test.js +0 -195
  104. package/test/cue-push-carries-what-the-walk-found.test.js +0 -58
  105. package/test/cut-times-timeline.test.js +0 -65
  106. package/test/cuts-follow-published-grid.test.js +0 -109
  107. package/test/data-channel-frame.test.js +0 -63
  108. package/test/data-channel-viewer-lifecycle.test.js +0 -193
  109. package/test/dead-torrent-handle.test.js +0 -52
  110. package/test/declared-rates.test.js +0 -116
  111. package/test/declared-tracks.test.js +0 -43
  112. package/test/decode-cost-fit.test.js +0 -202
  113. package/test/decode-cost.test.js +0 -475
  114. package/test/delivery-probe-field.test.js +0 -173
  115. package/test/delivery-probe.test.js +0 -382
  116. package/test/demand-register.test.js +0 -206
  117. package/test/dht-bootstrap.test.js +0 -72
  118. package/test/drain-threat.test.js +0 -65
  119. package/test/duplicate-add.test.js +0 -48
  120. package/test/encode-admission.test.js +0 -170
  121. package/test/encode-cost.test.js +0 -275
  122. package/test/encode-exit.test.js +0 -111
  123. package/test/encode-orchestrator.test.js +0 -426
  124. package/test/encode-plan-viewers.test.js +0 -725
  125. package/test/encode-plan.test.js +0 -545
  126. package/test/encode-run-state.test.js +0 -314
  127. package/test/encode-run.test.js +0 -248
  128. package/test/encode-slope.test.js +0 -46
  129. package/test/encoded-output.test.js +0 -39
  130. package/test/encoder-kinds.test.js +0 -122
  131. package/test/encoder-readings.test.js +0 -68
  132. package/test/episode-naming.test.js +0 -131
  133. package/test/every-claimant-is-told-its-share.test.js +0 -152
  134. package/test/failed-encoder-still-serves-what-exists.test.js +0 -354
  135. package/test/failed-start-breaker.test.js +0 -202
  136. package/test/fastest-wires.test.js +0 -143
  137. package/test/ffmpeg-stream-counts.test.js +0 -101
  138. package/test/file-edges.test.js +0 -191
  139. package/test/files-in-use.test.js +0 -34
  140. package/test/fixtures/audio-frame-boundary.json +0 -1
  141. package/test/fixtures/refused-audio-20261002.json +0 -10
  142. package/test/fmp4-presentation-clock.test.js +0 -148
  143. package/test/fmp4-self-contained.test.js +0 -80
  144. package/test/fmp4-timestamps.test.js +0 -140
  145. package/test/fmp4-track-completeness.test.js +0 -41
  146. package/test/format-keyed-outputs.test.js +0 -78
  147. package/test/health-metrics.test.js +0 -36
  148. package/test/held-read-ownership.test.js +0 -77
  149. package/test/held-request-width.test.js +0 -157
  150. package/test/helpers/encode-run.js +0 -248
  151. package/test/helpers/held-file.js +0 -77
  152. package/test/helpers/manager.js +0 -62
  153. package/test/helpers/matroska-file.js +0 -296
  154. package/test/helpers/output-spec.js +0 -63
  155. package/test/host-load.test.js +0 -68
  156. package/test/index-accuracy-is-about-the-file.test.js +0 -128
  157. package/test/init-compat.test.js +0 -219
  158. package/test/input-lost-quiets-the-plan.test.js +0 -261
  159. package/test/input-unavailable.test.js +0 -48
  160. package/test/installation-id.test.js +0 -39
  161. package/test/keeping-period.test.js +0 -83
  162. package/test/keyframe-index-accuracy.test.js +0 -188
  163. package/test/keyframe-table-budget.test.js +0 -123
  164. package/test/keyframes-belong-to-the-file.test.js +0 -249
  165. package/test/learned-median.test.js +0 -37
  166. package/test/letting-go-asks-who-is-watching.test.js +0 -191
  167. package/test/limit-row-by-area.test.js +0 -60
  168. package/test/link-budget.test.js +0 -111
  169. package/test/link-probe.test.js +0 -56
  170. package/test/local-encoding-data.test.js +0 -273
  171. package/test/logger-repeats.test.js +0 -134
  172. package/test/look-ahead-coverage.test.js +0 -56
  173. package/test/manager-surface.test.js +0 -291
  174. package/test/matroska-blocks.test.js +0 -0
  175. package/test/matroska-cluster-discovery.test.js +0 -323
  176. package/test/matroska-cues-track.test.js +0 -192
  177. package/test/media-time.test.js +0 -62
  178. package/test/memory-budget.test.js +0 -390
  179. package/test/move-cost.test.js +0 -216
  180. package/test/mp4-composition-times.test.js +0 -0
  181. package/test/mp4-subtitles.test.js +0 -173
  182. package/test/one-authority.test.js +0 -285
  183. package/test/one-budget.test.js +0 -149
  184. package/test/one-output-one-session.test.js +0 -273
  185. package/test/one-resource-divided.test.js +0 -185
  186. package/test/one-serving-output-per-height.test.js +0 -458
  187. package/test/orchestrator-wired.test.js +0 -207
  188. package/test/output-catalog.test.js +0 -39
  189. package/test/output-shape.test.js +0 -21
  190. package/test/output-spec.test.js +0 -251
  191. package/test/output-speed.test.js +0 -92
  192. package/test/outputs-being-prepared.test.js +0 -40
  193. package/test/packet-witness-ring.test.js +0 -236
  194. package/test/packet-witness.test.js +0 -148
  195. package/test/piece-completeness.test.js +0 -78
  196. package/test/piece-disk-store.test.js +0 -401
  197. package/test/piece-from-whole-file.test.js +0 -129
  198. package/test/piece-lru.test.js +0 -319
  199. package/test/piece-reader.test.js +0 -162
  200. package/test/piece-selection-offset.test.js +0 -85
  201. package/test/piece-store-eviction.test.js +0 -595
  202. package/test/piece-store-never-refuses.test.js +0 -153
  203. package/test/piece-store-reservations.test.js +0 -403
  204. package/test/piece-store-slow-disk.test.js +0 -159
  205. package/test/piece-tail.test.js +0 -97
  206. package/test/plan-host-timings.test.js +0 -68
  207. package/test/plan-is-steady.test.js +0 -225
  208. package/test/playback-readiness.test.js +0 -518
  209. package/test/playback-start-regressions.test.js +0 -101
  210. package/test/priority-map-download.test.js +0 -174
  211. package/test/priority-map-emptied.test.js +0 -204
  212. package/test/priority-map-per-output.test.js +0 -215
  213. package/test/priority-map.test.js +0 -163
  214. package/test/probe-wedge-certainty.test.js +0 -60
  215. package/test/produced-copy-choice.test.js +0 -213
  216. package/test/published-timeline.test.js +0 -83
  217. package/test/quality-offer.test.js +0 -160
  218. package/test/quality-variants.test.js +0 -1274
  219. package/test/rate-control-in-the-output.test.js +0 -181
  220. package/test/read-survives-withdrawal.test.js +0 -164
  221. package/test/read-window.test.js +0 -365
  222. package/test/reads-not-yet-arrived.test.js +0 -218
  223. package/test/resume-warm.test.js +0 -39
  224. package/test/run-graph-drift.test.js +0 -37
  225. package/test/run-inputs.test.js +0 -80
  226. package/test/run-intervals.test.js +0 -100
  227. package/test/run-position-follows-published-grid.test.js +0 -89
  228. package/test/run-progress.test.js +0 -64
  229. package/test/same-height-switch.test.js +0 -663
  230. package/test/seek-frees-the-viewers-requests.test.js +0 -217
  231. package/test/seek-landing.test.js +0 -109
  232. package/test/seek-target-not-superseded.test.js +0 -195
  233. package/test/segment-closed-on-both-branches.test.js +0 -114
  234. package/test/segment-cut-times.test.js +0 -63
  235. package/test/segment-demand.test.js +0 -80
  236. package/test/segment-hold-supersede.test.js +0 -91
  237. package/test/segment-judged-by-its-own-header.test.js +0 -222
  238. package/test/segment-serve-wiring.test.js +0 -481
  239. package/test/segment-store-eviction.test.js +0 -247
  240. package/test/segment-store.test.js +0 -352
  241. package/test/segment-true-start.test.js +0 -86
  242. package/test/segments-are-shared.test.js +0 -176
  243. package/test/send-chunk-bytes.test.js +0 -86
  244. package/test/serving-existing-output.test.js +0 -111
  245. package/test/serving-output.test.js +0 -102
  246. package/test/shared-piece-store.test.js +0 -310
  247. package/test/sidecar-naming.test.js +0 -142
  248. package/test/soundtrack-rate-bound.test.js +0 -289
  249. package/test/source-file.test.js +0 -133
  250. package/test/source-files-route.test.js +0 -113
  251. package/test/source-registry.test.js +0 -18
  252. package/test/split-a-stretch.test.js +0 -139
  253. package/test/stale-request-after-seek.test.js +0 -158
  254. package/test/startup-readings.test.js +0 -124
  255. package/test/stream-route.test.js +0 -237
  256. package/test/subtitle-cue-framing.test.js +0 -200
  257. package/test/subtitle-cue-source.test.js +0 -102
  258. package/test/subtitle-cue-walk.test.js +0 -385
  259. package/test/subtitle-cursor.test.js +0 -63
  260. package/test/subtitle-defaults.test.js +0 -118
  261. package/test/subtitle-language.test.js +0 -252
  262. package/test/subtitle-metadata.test.js +0 -15
  263. package/test/subtitle-plan-waits.test.js +0 -125
  264. package/test/subtitle-track-numbering.test.js +0 -391
  265. package/test/supply-margin.test.js +0 -190
  266. package/test/swarm-follows-readers.test.js +0 -174
  267. package/test/swarm-reach.test.js +0 -130
  268. package/test/swarm-selection.test.js +0 -220
  269. package/test/tail-duplication.test.js +0 -167
  270. package/test/the-channel-has-both-ends.test.js +0 -91
  271. package/test/the-torrent-thread-serves-bytes.test.js +0 -107
  272. package/test/thread-pool.test.js +0 -53
  273. package/test/timeline.test.js +0 -84
  274. package/test/torrent-contents.test.js +0 -235
  275. package/test/torrent-cost.test.js +0 -71
  276. package/test/torrent-files.test.js +0 -221
  277. package/test/torrent-naming.test.js +0 -255
  278. package/test/tracks-begin-together.test.js +0 -209
  279. package/test/tunnel-renewal.test.js +0 -167
  280. package/test/two-viewers-one-picture.test.js +0 -508
  281. package/test/upload-hurry.test.js +0 -186
  282. package/test/usrsctp-state.test.js +0 -131
  283. package/test/video-facts.test.js +0 -102
  284. package/test/viewer-assignments.test.js +0 -143
  285. package/test/viewer-outputs.test.js +0 -285
  286. package/test/viewer-presence.test.js +0 -116
  287. package/test/viewer-requests-admission.test.js +0 -92
  288. package/test/viewer-starts-on-map.test.js +0 -27
  289. package/test/viewer-states.test.js +0 -192
  290. package/test/viewer-subtitle-subscription.test.js +0 -96
  291. package/test/viewer.test.js +0 -139
  292. package/test/viewing-generations.test.js +0 -390
  293. package/test/visible-rung.test.js +0 -37
  294. package/test/wait-ledger.test.js +0 -100
  295. package/test/webrtc-shim.test.js +0 -149
  296. package/test/wedge-certainty.test.js +0 -131
  297. package/test/whole-file-held-read.test.js +0 -30
  298. package/test/withdraw-piece-claim.test.js +0 -212
  299. package/test/worker-channel.test.js +0 -158
package/Dockerfile DELETED
@@ -1,30 +0,0 @@
1
- # syntax=docker/dockerfile:1.7
2
- FROM node:24-alpine
3
-
4
- ENV NODE_ENV=production
5
- ENV PORT=9090
6
- ENV HOST=0.0.0.0
7
-
8
- WORKDIR /app
9
-
10
- # ffmpeg is needed for optional HLS audio transcode mode.
11
- RUN apk add --no-cache ffmpeg
12
-
13
- # Create an unprivileged runtime user.
14
- RUN addgroup -S app && adduser -S -G app app
15
-
16
- # Install only production dependencies first for better layer caching.
17
- COPY package.json package-lock.json ./
18
- RUN npm ci --omit=dev && npm cache clean --force
19
-
20
- # Copy application sources.
21
- COPY --chown=app:app . .
22
-
23
- USER app
24
-
25
- EXPOSE 9090
26
-
27
- HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \
28
- CMD node -e "fetch(`http://127.0.0.1:${process.env.PORT || 9090}/healthz`).then((r)=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
29
-
30
- CMD ["sh", "-ec", "if [ -z \"${SERVER_URL:-}\" ]; then echo 'SERVER_URL is required' >&2; exit 1; fi; exec node ./bin/cli.js --server-url \"$SERVER_URL\" --host \"$HOST\" --port \"$PORT\" ${PROXY_EXTRA_ARGS:-}"]
package/biome.json DELETED
@@ -1,412 +0,0 @@
1
- {
2
- "$schema": "https://biomejs.dev/schemas/2.5.7/schema.json",
3
- "files": {
4
- "includes": [
5
- "**/*.js",
6
- "!**/node_modules/**"
7
- ]
8
- },
9
- "formatter": {
10
- "enabled": false
11
- },
12
- "assist": {
13
- "enabled": false
14
- },
15
- "linter": {
16
- "enabled": true,
17
- "rules": {
18
- "preset": "none",
19
- "correctness": {
20
- "noUndeclaredVariables": "error",
21
- "noUnusedImports": "error",
22
- "noUnusedVariables": "error",
23
- "noUnusedPrivateClassMembers": "error",
24
- "noInvalidUseBeforeDeclaration": "error",
25
- "noPrivateImports": "error"
26
- }
27
- }
28
- },
29
- "overrides": [
30
- {
31
- "includes": [
32
- "services/torrent/demand/**",
33
- "services/encode/segment-formats/**",
34
- "services/encode/output/**",
35
- "services/viewer/**"
36
- ],
37
- "linter": {
38
- "rules": {
39
- "style": {
40
- "noRestrictedImports": {
41
- "level": "error",
42
- "options": {
43
- "patterns": [
44
- {
45
- "group": [
46
- "../**"
47
- ],
48
- "message": "This layer states facts and imports nothing above itself. Anything it needs from outside — a logger, a clock, a way to read bytes — is passed in."
49
- }
50
- ]
51
- }
52
- }
53
- }
54
- }
55
- }
56
- },
57
- {
58
- "includes": [
59
- "services/torrent/*.js"
60
- ],
61
- "linter": {
62
- "rules": {
63
- "style": {
64
- "noRestrictedImports": {
65
- "level": "error",
66
- "options": {
67
- "patterns": [
68
- {
69
- "group": [
70
- "../**",
71
- "!../../utils/**",
72
- "!../storage/keep.js",
73
- "!../viewer/PriorityMap.js"
74
- ],
75
- "message": "THE TORRENT COMPONENT: the swarm, its pieces, what to ask for and in what order, and what a torrent contains. It reads the shape of the priority map (`viewer/PriorityMap.js`) and the keeping period (`storage/keep.js`); the piece store is reached through what it does (`piece-store-of.js`) and is handed in where the thread is assembled (`worker/worker.js`)."
76
- }
77
- ]
78
- }
79
- }
80
- }
81
- }
82
- }
83
- },
84
- {
85
- "includes": [
86
- "services/encode/*.js"
87
- ],
88
- "linter": {
89
- "rules": {
90
- "style": {
91
- "noRestrictedImports": {
92
- "level": "error",
93
- "options": {
94
- "patterns": [
95
- {
96
- "group": [
97
- "../**",
98
- "!../media/ffmpeg-banner.js"
99
- ],
100
- "message": "THE ENCODING COMPONENT imports nothing outside itself: its outputs, cut tables, playlists, container formats and quality budget are directories of it. Anything else it needs — a logger, a viewer's position, a way to read bytes — is passed in."
101
- }
102
- ]
103
- }
104
- }
105
- }
106
- }
107
- }
108
- },
109
- {
110
- "includes": [
111
- "services/storage/*.js"
112
- ],
113
- "linter": {
114
- "rules": {
115
- "style": {
116
- "noRestrictedImports": {
117
- "level": "error",
118
- "options": {
119
- "patterns": [
120
- {
121
- "group": [
122
- "../**",
123
- "!../../utils/**"
124
- ],
125
- "message": "ONE LAYER, FOUR DIRECTORIES — bytes on a medium with a limit. What is held in memory (piece-store/), the produced segments (segment-store/), whole downloaded files (files/), and the one owner of the room all three take (storage/). They may reach each other and nothing above. Written as an exception to `../**` rather than as a list of forbidden layers, because a layer is not a directory: the blanket form cannot say \"my siblings\", and a list of names misses everything it forgets — `../../utils/logger.js` went straight through one on 2026-09-14."
126
- }
127
- ]
128
- }
129
- }
130
- }
131
- }
132
- }
133
- },
134
- {
135
- "includes": [
136
- "services/storage/*/**"
137
- ],
138
- "linter": {
139
- "rules": {
140
- "style": {
141
- "noRestrictedImports": {
142
- "level": "error",
143
- "options": {
144
- "patterns": [
145
- {
146
- "group": [
147
- "../../**",
148
- "!../../../utils/**"
149
- ],
150
- "message": "ONE LAYER, FOUR DIRECTORIES — bytes on a medium with a limit. What is held in memory (piece-store/), the produced segments (segment-store/), whole downloaded files (files/), and the one owner of the room all three take (storage/). They may reach each other and nothing above. Written as an exception to `../**` rather than as a list of forbidden layers, because a layer is not a directory: the blanket form cannot say \"my siblings\", and a list of names misses everything it forgets — `../../utils/logger.js` went straight through one on 2026-09-14."
151
- }
152
- ]
153
- }
154
- }
155
- }
156
- }
157
- }
158
- },
159
- {
160
- "includes": [
161
- "services/encode/quality/**"
162
- ],
163
- "linter": {
164
- "rules": {
165
- "style": {
166
- "noRestrictedImports": {
167
- "level": "error",
168
- "options": {
169
- "patterns": [
170
- {
171
- "group": [
172
- "../**",
173
- "../../**",
174
- "!../output/**",
175
- "!../../media/SourceFile.js",
176
- "!../available-share.js",
177
- "!../hwaccel.js",
178
- "!../learned-median.js",
179
- "!../torrent-cost.js",
180
- "!../encoder-readings.js",
181
- "!../audio-work-rate.js",
182
- "!../contention.js",
183
- "!../args.js",
184
- "!../encode-run-state.js",
185
- "!../throughput.js",
186
- "!../../../utils/**"
187
- ],
188
- "message": "What encoding costs, and which heights follow, is arithmetic over readings. Which sessions belong to one file, how many encoders run, where the viewers stand, what the swarm is delivering — all of it is passed in, so this can be asked without a session manager, a torrent or a disk. What it MAY reach is named one file at a time, and every name is a plain STATEMENT rather than machinery: the ladder and the cut table (output/, which is the same layer — кодирование), what a source decodes like, the measured shares and penalties, and the states a run can be in. `encode/EncodeRun.js` is deliberately not among them — it spawns processes. An ALLOW list rather than a forbid list, because the two fail in opposite directions: a name forgotten here blocks an import that should have been allowed, and a name forgotten in a forbid list lets a whole layer through. The old forbid list named `../container/**`, a directory that stopped existing when the media layer got its own, and would have let all of it in."
189
- }
190
- ]
191
- }
192
- }
193
- }
194
- }
195
- }
196
- },
197
- {
198
- "includes": [
199
- "services/torrent/download/**"
200
- ],
201
- "linter": {
202
- "rules": {
203
- "style": {
204
- "noRestrictedImports": {
205
- "level": "error",
206
- "options": {
207
- "patterns": [
208
- {
209
- "group": [
210
- "../../**",
211
- "../worker/**"
212
- ],
213
- "message": "What the swarm is told is decided from what is wanted (demand/) and what is held (storage/), and from nothing else."
214
- }
215
- ]
216
- }
217
- }
218
- }
219
- }
220
- }
221
- },
222
- {
223
- "includes": [
224
- "services/media/container/**",
225
- "services/media/tracks/**"
226
- ],
227
- "linter": {
228
- "rules": {
229
- "style": {
230
- "noRestrictedImports": {
231
- "level": "error",
232
- "options": {
233
- "patterns": [
234
- {
235
- "group": [
236
- "../**",
237
- "!../container/**",
238
- "!../tracks/**"
239
- ],
240
- "message": "THE MEDIA DOMAIN. A container answers for itself and hands out tracks/; a track is one stream inside one. They know nothing of torrents, encoders, viewers or this proxy's own logger: the four functions a container is built with are its whole outside world. Written as an exception to `../**` rather than as a list of forbidden layers — a list only catches what somebody remembered to write in it, and the list that stood here let `../../utils/logger.js` straight through."
241
- }
242
- ]
243
- }
244
- }
245
- }
246
- }
247
- }
248
- },
249
- {
250
- "includes": [
251
- "services/media/*.js"
252
- ],
253
- "linter": {
254
- "rules": {
255
- "style": {
256
- "noRestrictedImports": {
257
- "level": "error",
258
- "options": {
259
- "patterns": [
260
- {
261
- "group": [
262
- "../**",
263
- "!../../utils/**"
264
- ],
265
- "message": "THE MEDIA LAYER answers what a FILE says about itself: its containers, its tracks, where its keyframes are, and the plan for playing it. It may reach into its own domain and nothing else. What a torrent contains, which clusters may be read, where a viewer stands, what an encoder costs — all of it is passed in, so this can be asked with plain values and no torrent, no thread and no disk. Both reaches that stood here are gone: `torrent-worker/subtitle-cues.js` is now handed to SubtitleOrchestrator at the seam, and `torrent/Contents.js` is handed to the planner."
266
- }
267
- ]
268
- }
269
- }
270
- }
271
- }
272
- }
273
- },
274
- {
275
- "includes": [
276
- "services/server/controllers/**"
277
- ],
278
- "linter": {
279
- "rules": {
280
- "style": {
281
- "noRestrictedImports": {
282
- "level": "error",
283
- "options": {
284
- "patterns": [
285
- {
286
- "group": [
287
- "../../**"
288
- ],
289
- "message": "A controller translates a request for an orchestrator it is handed. It imports nothing of any component: parsing a file, converting it and naming its language are the media component's."
290
- }
291
- ]
292
- }
293
- }
294
- }
295
- }
296
- }
297
- },
298
- {
299
- "includes": [
300
- "services/torrent/worker/**",
301
- "!services/torrent/worker/worker.js"
302
- ],
303
- "linter": {
304
- "rules": {
305
- "style": {
306
- "noRestrictedImports": {
307
- "level": "error",
308
- "options": {
309
- "patterns": [
310
- {
311
- "group": [
312
- "../../server/**",
313
- "../../encode/**",
314
- "../../viewer/**",
315
- "../../storage/**",
316
- "../../transport/**",
317
- "../../media/**"
318
- ],
319
- "message": "The torrent thread serves bytes. What is produced from them, and for whom, is decided in the main thread; what stores them is handed in by `worker.js`, where this thread is assembled."
320
- }
321
- ]
322
- }
323
- }
324
- }
325
- }
326
- }
327
- },
328
- {
329
- "includes": [
330
- "services/torrent/worker/worker.js"
331
- ],
332
- "linter": {
333
- "rules": {
334
- "style": {
335
- "noRestrictedImports": {
336
- "level": "error",
337
- "options": {
338
- "patterns": [
339
- {
340
- "group": [
341
- "../../server/**",
342
- "../../encode/**",
343
- "../../viewer/**",
344
- "../../transport/**",
345
- "../../media/**"
346
- ],
347
- "message": "`worker.js` assembles the torrent thread: it may build the storage component's stores and hand them in, and nothing else outside the torrent component."
348
- }
349
- ]
350
- }
351
- }
352
- }
353
- }
354
- }
355
- },
356
- {
357
- "includes": [
358
- "services/server/*.js",
359
- "!services/server/wire-outputs.js"
360
- ],
361
- "linter": {
362
- "rules": {
363
- "style": {
364
- "noRestrictedImports": {
365
- "level": "error",
366
- "options": {
367
- "patterns": [
368
- {
369
- "group": [
370
- "../**",
371
- "!../encode/output/index.js",
372
- "!../storage/keep.js",
373
- "!../../utils/**",
374
- "!../../../utils/**"
375
- ],
376
- "message": "THE SERVER COMPONENT coordinates one request at a time through the narrow interfaces `wire-outputs.js` hands it. It imports no component's implementation: only the name of an output and of its playlist (`encode/output/index.js`) and the keeping period (`storage/keep.js`), which are definitions shared by both sides of an interface."
377
- }
378
- ]
379
- }
380
- }
381
- }
382
- }
383
- }
384
- },
385
- {
386
- "includes": [
387
- "services/transport/**"
388
- ],
389
- "linter": {
390
- "rules": {
391
- "style": {
392
- "noRestrictedImports": {
393
- "level": "error",
394
- "options": {
395
- "patterns": [
396
- {
397
- "group": [
398
- "../**",
399
- "!../../utils/**",
400
- "!../../../utils/**"
401
- ],
402
- "message": "THE TRANSPORT COMPONENT delivers bytes to a peer and takes requests from it. It imports nothing of another component: what it reports about the machine, and which files of evidence to keep, are handed in by `bin/cli.js`."
403
- }
404
- ]
405
- }
406
- }
407
- }
408
- }
409
- }
410
- }
411
- ]
412
- }