@torrent-tv/proxy 2.87.21 → 2.88.1

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 (475) hide show
  1. package/.claude/commands/opsx/apply.md +155 -155
  2. package/.claude/commands/opsx/archive.md +160 -160
  3. package/.claude/commands/opsx/explore.md +174 -174
  4. package/.claude/commands/opsx/propose.md +109 -109
  5. package/.claude/commands/opsx/sync.md +143 -143
  6. package/.claude/skills/openspec-apply-change/SKILL.md +159 -159
  7. package/.claude/skills/openspec-archive-change/SKILL.md +117 -117
  8. package/.claude/skills/openspec-explore/SKILL.md +289 -289
  9. package/.claude/skills/openspec-propose/SKILL.md +113 -113
  10. package/.claude/skills/openspec-sync-specs/SKILL.md +147 -147
  11. package/.dockerignore +5 -5
  12. package/AGENTS.md +322 -322
  13. package/CHANGELOG.md +2242 -2234
  14. package/Dockerfile +30 -30
  15. package/LICENSE +16 -16
  16. package/README.md +369 -369
  17. package/assets/calibration/NOTICE.md +100 -100
  18. package/assets/diagnostics/sctpstate.gdb +31 -31
  19. package/bin/cli.js +684 -684
  20. package/bin/thread-pool.js +30 -30
  21. package/biome.json +411 -411
  22. package/docs/browser-proxy-contract.md +1 -1
  23. package/docs/container-architecture.md +218 -218
  24. package/docs/download-architecture.md +261 -261
  25. package/docs/encode-architecture.md +729 -729
  26. package/docs/encode-run-state.md +96 -96
  27. package/docs/logs.md +97 -97
  28. package/docs/socks5-egress-research.md +114 -114
  29. package/docs/storage-architecture.md +267 -267
  30. package/knip.json +14 -14
  31. package/openspec/changes/adaptive-bitrate/design.md +92 -92
  32. package/openspec/changes/adaptive-bitrate/proposal.md +56 -56
  33. package/openspec/changes/adaptive-bitrate/specs/adaptive-bitrate/spec.md +51 -51
  34. package/openspec/changes/adaptive-bitrate/tasks.md +40 -40
  35. package/openspec/changes/binary-distribution/.openspec.yaml +2 -2
  36. package/openspec/changes/binary-distribution/proposal.md +53 -53
  37. package/openspec/changes/chunked-request-bodies/design.md +81 -81
  38. package/openspec/changes/chunked-request-bodies/proposal.md +53 -53
  39. package/openspec/changes/chunked-request-bodies/specs/chunked-request-bodies/spec.md +30 -30
  40. package/openspec/changes/chunked-request-bodies/tasks.md +40 -40
  41. package/openspec/changes/cold-start/design.md +98 -98
  42. package/openspec/changes/cold-start/proposal.md +62 -62
  43. package/openspec/changes/cold-start/specs/cold-start/spec.md +47 -47
  44. package/openspec/changes/cold-start/tasks.md +48 -48
  45. package/openspec/changes/disk-cap/.openspec.yaml +2 -2
  46. package/openspec/changes/disk-cap/proposal.md +37 -37
  47. package/openspec/changes/disk-cap/specs/disk-cap/spec.md +25 -25
  48. package/openspec/changes/disk-cap/tasks.md +19 -19
  49. package/openspec/changes/proxy-observability/.openspec.yaml +2 -2
  50. package/openspec/changes/proxy-observability/design.md +38 -38
  51. package/openspec/changes/proxy-observability/proposal.md +49 -49
  52. package/openspec/changes/proxy-observability/specs/observability/spec.md +33 -33
  53. package/openspec/changes/proxy-observability/tasks.md +21 -21
  54. package/openspec/changes/seek-debounce/design.md +118 -118
  55. package/openspec/changes/seek-debounce/proposal.md +59 -59
  56. package/openspec/changes/seek-debounce/specs/seek-debounce/spec.md +41 -41
  57. package/openspec/changes/seek-debounce/tasks.md +33 -33
  58. package/openspec/changes/subtitle-language/.openspec.yaml +2 -2
  59. package/openspec/changes/subtitle-language/proposal.md +50 -50
  60. package/openspec/changes/subtitle-language/specs/subtitle-language/spec.md +34 -34
  61. package/openspec/changes/subtitle-language/tasks.md +26 -26
  62. package/openspec/changes/track-selection/.openspec.yaml +2 -2
  63. package/openspec/changes/track-selection/design.md +47 -47
  64. package/openspec/changes/track-selection/proposal.md +45 -45
  65. package/openspec/changes/track-selection/specs/track-selection/spec.md +41 -41
  66. package/openspec/changes/track-selection/tasks.md +20 -20
  67. package/openspec/changes/transcode-quality/.openspec.yaml +2 -2
  68. package/openspec/changes/transcode-quality/proposal.md +51 -51
  69. package/openspec/changes/transcode-quality/specs/transcode-quality/spec.md +139 -139
  70. package/openspec/changes/transcode-quality/tasks.md +63 -63
  71. package/openspec/config.yaml +38 -38
  72. package/package.json +50 -50
  73. package/public/.well-known/appspecific/com.chrome.devtools.json +1 -1
  74. package/research/delivery-wedge-stand-ladder-2026-09-13.md +329 -329
  75. package/research/double-spawn-2026-09-10.md +171 -171
  76. package/research/handover-2026-09-13.md +209 -209
  77. package/research/handover-reader-claims-removal-2026-09-12.md +166 -166
  78. package/research/piece-withdrawn-but-still-claimed-2026-09-12.md +175 -175
  79. package/research/preset-benchmark-size-scaling-2026-08-22.md +55 -55
  80. package/research/priority-map-is-the-truth-2026-09-12.md +225 -225
  81. package/routes/api/client-logs/post.js +86 -86
  82. package/routes/api/delivery-sink/get.js +72 -72
  83. package/routes/api/link-probe/get.js +51 -51
  84. package/routes/api/playback-plan/audio-tracks/post.js +29 -29
  85. package/routes/api/playback-plan/post.js +53 -53
  86. package/routes/api/sources/files/get.js +106 -100
  87. package/routes/api/sources/post.js +36 -36
  88. package/routes/api/sources/stats/get.js +132 -132
  89. package/routes/api/sources/warm/post.js +217 -217
  90. package/routes/api/subtitles/get.js +230 -230
  91. package/routes/api/transcode-sessions/fragment-far/post.js +60 -60
  92. package/routes/api/transcode-sessions/net-report/post.js +138 -138
  93. package/routes/api/transcode-sessions/post.js +173 -173
  94. package/routes/api/transcode-sessions/progress/get.js +27 -27
  95. package/routes/api/transcode-sessions/release/post.js +41 -41
  96. package/routes/api/transcode-sessions/seek/post.js +63 -63
  97. package/routes/health/get.js +13 -13
  98. package/routes/healthz/get.js +13 -13
  99. package/routes/stream/get.js +380 -380
  100. package/routes/transcode/audio-file/get.js +64 -64
  101. package/routes/transcode/audio-warm/get.js +84 -84
  102. package/routes/transcode/session-file/get.js +52 -52
  103. package/routes/transcode/variant-file/get.js +95 -95
  104. package/routes/transcode/variant-warm/get.js +84 -84
  105. package/scripts/render-run-graph.js +173 -173
  106. package/server.js +725 -725
  107. package/services/encode/CoverageMap.js +428 -428
  108. package/services/encode/CushionReport.js +345 -345
  109. package/services/encode/EncodeAdmission.js +376 -376
  110. package/services/encode/EncodeOrchestrator.js +1217 -1217
  111. package/services/encode/EncodePlan.js +1366 -1366
  112. package/services/encode/EncodeRun.js +813 -813
  113. package/services/encode/EncodeRuns.js +1235 -1235
  114. package/services/encode/Encoder.js +142 -142
  115. package/services/encode/EncoderSelection.js +38 -38
  116. package/services/encode/LocalObservations.js +359 -359
  117. package/services/encode/NvencEncoder.js +50 -50
  118. package/services/encode/OutputOpening.js +758 -758
  119. package/services/encode/OutputTimes.js +579 -579
  120. package/services/encode/QsvEncoder.js +58 -58
  121. package/services/encode/Renditions.js +2184 -2184
  122. package/services/encode/RunProgress.js +84 -84
  123. package/services/encode/SegmentDemand.js +95 -95
  124. package/services/encode/SoftwareEncoder.js +121 -121
  125. package/services/encode/V4l2m2mEncoder.js +53 -53
  126. package/services/encode/VaapiEncoder.js +66 -66
  127. package/services/encode/args.js +416 -416
  128. package/services/encode/available-share.js +89 -89
  129. package/services/encode/calibration.js +361 -361
  130. package/services/encode/contention.js +128 -128
  131. package/services/encode/decode-cost-fit.js +363 -363
  132. package/services/encode/encode-exit.js +114 -114
  133. package/services/encode/encode-run-state.js +551 -551
  134. package/services/encode/encoder-readings.js +45 -45
  135. package/services/encode/fingerprint.js +322 -322
  136. package/services/encode/host-load.js +174 -174
  137. package/services/encode/hwaccel.js +1894 -1894
  138. package/services/encode/index.js +9 -9
  139. package/services/encode/learned-median.js +90 -90
  140. package/services/encode/output/EncodedOutput.js +57 -57
  141. package/services/encode/output/Output.js +131 -131
  142. package/services/encode/output/OutputCatalog.js +414 -414
  143. package/services/encode/output/OutputSpec.js +390 -390
  144. package/services/encode/output/Timeline.js +308 -308
  145. package/services/encode/output/cut-grid.js +107 -107
  146. package/services/encode/output/index.js +20 -20
  147. package/services/encode/output/ladder.js +32 -32
  148. package/services/encode/output/playlists.js +284 -284
  149. package/services/encode/output/rates.js +125 -125
  150. package/services/encode/output-key-format.js +21 -21
  151. package/services/encode/quality/EncodeCost.js +1141 -1141
  152. package/services/encode/quality/HostLoad.js +525 -525
  153. package/services/encode/quality/HostTimings.js +249 -249
  154. package/services/encode/quality/OutputQualityState.js +28 -28
  155. package/services/encode/quality/QualityController.js +935 -935
  156. package/services/encode/quality/QualityOffer.js +416 -416
  157. package/services/encode/quality/drain-threat.js +47 -47
  158. package/services/encode/quality/link-budget.js +254 -254
  159. package/services/encode/quality/output-format.js +315 -315
  160. package/services/encode/quality/serving-output.js +216 -216
  161. package/services/encode/quality/visible-rung.js +57 -57
  162. package/services/encode/run-budget.js +97 -97
  163. package/services/encode/run-command.js +754 -754
  164. package/services/encode/run-costs.js +155 -155
  165. package/services/encode/run-inputs.js +42 -42
  166. package/services/encode/segment-formats/fmp4.js +456 -456
  167. package/services/encode/segment-formats/index.js +85 -85
  168. package/services/encode/segment-formats/init-compat.js +324 -324
  169. package/services/encode/segment-formats/mp4-boxes.js +515 -515
  170. package/services/encode/segment-formats/mpegts.js +134 -134
  171. package/services/encode/start-stop-cost.js +178 -178
  172. package/services/encode/throughput.js +97 -97
  173. package/services/encode/torrent-cost.js +88 -88
  174. package/services/identity/installation-id.js +38 -38
  175. package/services/media/ContainerOrchestrator.js +149 -149
  176. package/services/media/KeyframeTables.js +316 -316
  177. package/services/media/SourceFile.js +298 -298
  178. package/services/media/SubtitleCues.js +520 -520
  179. package/services/media/SubtitleOrchestrator.js +167 -167
  180. package/services/media/audio-inventory.js +245 -245
  181. package/services/media/container/AviContainer.js +266 -266
  182. package/services/media/container/Container.js +603 -603
  183. package/services/media/container/ContainerFactory.js +56 -56
  184. package/services/media/container/KeyframeTable.js +272 -272
  185. package/services/media/container/MatroskaContainer.js +1494 -1494
  186. package/services/media/container/Mp4Container.js +1244 -1244
  187. package/services/media/container/SubtitleFileContainer.js +339 -322
  188. package/services/media/container/ebml-reader.js +159 -159
  189. package/services/media/ffmpeg-banner.js +260 -260
  190. package/services/media/keyframe-probe.js +157 -157
  191. package/services/media/media-info-probe.js +93 -93
  192. package/services/media/playback-planner.js +931 -931
  193. package/services/media/tracks/AudioTrack.js +131 -131
  194. package/services/media/tracks/ContainerTrack.js +75 -75
  195. package/services/media/tracks/ImageSubtitleTrack.js +19 -19
  196. package/services/media/tracks/SubtitleTrack.js +38 -38
  197. package/services/media/tracks/TextSubtitleTrack.js +287 -287
  198. package/services/media/tracks/VideoTrack.js +33 -33
  199. package/services/media/tracks/index.js +15 -15
  200. package/services/media/tracks/language-detect.js +174 -174
  201. package/services/server/OutputLifecycle.js +418 -418
  202. package/services/server/SegmentServing.js +1150 -1150
  203. package/services/server/ViewerRequests.js +760 -760
  204. package/services/server/WaitLedger.js +142 -142
  205. package/services/server/controllers/PlaybackController.js +40 -40
  206. package/services/server/controllers/SubtitleController.js +109 -109
  207. package/services/server/http-responses.js +60 -60
  208. package/services/server/playback-readiness.js +696 -696
  209. package/services/server/transcode-session-files.js +325 -325
  210. package/services/server/wire-outputs.js +992 -992
  211. package/services/storage/Diagnostics.js +202 -202
  212. package/services/storage/MachineBudget.js +235 -235
  213. package/services/storage/allowance.js +107 -107
  214. package/services/storage/core-dumps.js +106 -106
  215. package/services/storage/files/CompletedFiles.js +391 -391
  216. package/services/storage/files/piece-from-whole-file.js +118 -118
  217. package/services/storage/free.js +71 -71
  218. package/services/storage/keep.js +48 -48
  219. package/services/storage/machine-memory.js +56 -56
  220. package/services/storage/memory-report.js +575 -575
  221. package/services/storage/piece-store/piece-disk-store.js +539 -539
  222. package/services/storage/piece-store/piece-lru.js +495 -495
  223. package/services/storage/piece-store/shared-piece-store.js +1931 -1931
  224. package/services/storage/returns.js +103 -103
  225. package/services/storage/segment-store/SegmentStore.js +1240 -1240
  226. package/services/storage/wire.js +175 -175
  227. package/services/torrent/Contents.js +382 -324
  228. package/services/torrent/demand/DemandRegister.js +202 -202
  229. package/services/torrent/demand/Urgency.js +137 -137
  230. package/services/torrent/demand/Window.js +118 -118
  231. package/services/torrent/demand/index.js +8 -8
  232. package/services/torrent/demand/pieces.js +140 -140
  233. package/services/torrent/download/SwarmSelection.js +386 -386
  234. package/services/torrent/download/registry.js +102 -102
  235. package/services/torrent/download/withdraw-claim.js +80 -80
  236. package/services/torrent/episode-naming.js +182 -0
  237. package/services/torrent/files.js +455 -455
  238. package/services/torrent/naming.js +619 -619
  239. package/services/torrent/piece-store-of.js +29 -29
  240. package/services/torrent/supply-margin.js +262 -262
  241. package/services/torrent/torrent-pool.js +2675 -2675
  242. package/services/torrent/worker/background-fill.js +213 -213
  243. package/services/torrent/worker/channel.js +271 -271
  244. package/services/torrent/worker/client.js +765 -765
  245. package/services/torrent/worker/fastest-wires.js +342 -342
  246. package/services/torrent/worker/handle-state.js +23 -23
  247. package/services/torrent/worker/held-bytes.js +155 -155
  248. package/services/torrent/worker/install-webrtc-shim.js +32 -32
  249. package/services/torrent/worker/piece-reader.js +1078 -1078
  250. package/services/torrent/worker/pool-adapter.js +371 -371
  251. package/services/torrent/worker/protocol.js +184 -184
  252. package/services/torrent/worker/resume-warm.js +107 -107
  253. package/services/torrent/worker/webrtc-shim.js +219 -219
  254. package/services/torrent/worker/worker.js +1129 -1129
  255. package/services/transport/data-channel-handler.js +1369 -1369
  256. package/services/transport/delivery-probe.js +842 -842
  257. package/services/transport/health-collector.js +53 -53
  258. package/services/transport/nat-classifier.js +231 -231
  259. package/services/transport/packet-witness.js +808 -808
  260. package/services/transport/port-mapper.js +235 -235
  261. package/services/transport/registry-api.js +81 -81
  262. package/services/transport/tunnel-client.js +447 -447
  263. package/services/transport/usrsctp-state.js +175 -175
  264. package/services/transport/webrtc-manager.js +484 -484
  265. package/services/viewer/Assignments.js +340 -340
  266. package/services/viewer/PriorityMap.js +390 -390
  267. package/services/viewer/PriorityOrchestrator.js +325 -325
  268. package/services/viewer/Viewer.js +691 -691
  269. package/services/viewer/Viewers.js +368 -368
  270. package/services/viewer/active-output.js +37 -37
  271. package/services/viewer/audio-start.js +46 -46
  272. package/services/viewer/buffer-trend.js +81 -81
  273. package/services/viewer/choices.js +647 -647
  274. package/services/viewer/positions.js +126 -126
  275. package/services/viewer/report-intake.js +46 -46
  276. package/store/source-registry.js +71 -71
  277. package/test/asset-paths.test.js +28 -28
  278. package/test/audio-inventory.test.js +212 -212
  279. package/test/audio-track-bitrate.test.js +40 -40
  280. package/test/auto-quality-step.test.js +707 -707
  281. package/test/available-share.test.js +76 -76
  282. package/test/background-fill.test.js +190 -190
  283. package/test/client-log-file.test.js +110 -110
  284. package/test/completed-files.test.js +115 -115
  285. package/test/concurrent-cost.test.js +148 -148
  286. package/test/container-media-info.test.js +228 -228
  287. package/test/contention.test.js +76 -76
  288. package/test/core-dumps.test.js +57 -57
  289. package/test/coverage-follows-the-disk.test.js +228 -228
  290. package/test/coverage-map.test.js +195 -195
  291. package/test/cue-push-carries-what-the-walk-found.test.js +58 -58
  292. package/test/cut-times-timeline.test.js +65 -65
  293. package/test/cuts-follow-published-grid.test.js +109 -109
  294. package/test/data-channel-frame.test.js +63 -63
  295. package/test/data-channel-viewer-lifecycle.test.js +92 -92
  296. package/test/dead-torrent-handle.test.js +52 -52
  297. package/test/declared-rates.test.js +116 -116
  298. package/test/declared-tracks.test.js +43 -43
  299. package/test/decode-cost-fit.test.js +202 -202
  300. package/test/decode-cost.test.js +462 -462
  301. package/test/delivery-probe.test.js +393 -393
  302. package/test/demand-register.test.js +206 -206
  303. package/test/dht-bootstrap.test.js +72 -72
  304. package/test/drain-threat.test.js +65 -65
  305. package/test/duplicate-add.test.js +48 -48
  306. package/test/encode-admission.test.js +146 -146
  307. package/test/encode-cost.test.js +283 -283
  308. package/test/encode-exit.test.js +111 -111
  309. package/test/encode-orchestrator.test.js +419 -419
  310. package/test/encode-plan-viewers.test.js +718 -718
  311. package/test/encode-plan.test.js +545 -545
  312. package/test/encode-run-state.test.js +314 -314
  313. package/test/encode-run.test.js +162 -162
  314. package/test/encode-slope.test.js +46 -46
  315. package/test/encoded-output.test.js +39 -39
  316. package/test/encoder-kinds.test.js +122 -122
  317. package/test/encoder-readings.test.js +46 -46
  318. package/test/episode-naming.test.js +131 -0
  319. package/test/every-claimant-is-told-its-share.test.js +152 -152
  320. package/test/failed-encoder-still-serves-what-exists.test.js +354 -354
  321. package/test/failed-start-breaker.test.js +202 -202
  322. package/test/fastest-wires.test.js +143 -143
  323. package/test/ffmpeg-stream-counts.test.js +78 -78
  324. package/test/file-edges.test.js +191 -191
  325. package/test/fmp4-presentation-clock.test.js +147 -147
  326. package/test/fmp4-self-contained.test.js +80 -80
  327. package/test/fmp4-timestamps.test.js +140 -140
  328. package/test/fmp4-track-completeness.test.js +41 -41
  329. package/test/format-keyed-outputs.test.js +78 -78
  330. package/test/health-metrics.test.js +38 -38
  331. package/test/held-request-width.test.js +157 -157
  332. package/test/helpers/encode-run.js +136 -136
  333. package/test/helpers/held-file.js +29 -29
  334. package/test/helpers/manager.js +57 -57
  335. package/test/helpers/output-spec.js +63 -63
  336. package/test/host-load.test.js +68 -68
  337. package/test/index-accuracy-is-about-the-file.test.js +128 -128
  338. package/test/init-compat.test.js +219 -219
  339. package/test/input-lost-quiets-the-plan.test.js +261 -261
  340. package/test/input-unavailable.test.js +48 -48
  341. package/test/installation-id.test.js +39 -39
  342. package/test/keeping-period.test.js +83 -83
  343. package/test/keyframe-index-accuracy.test.js +188 -188
  344. package/test/keyframe-table-budget.test.js +102 -102
  345. package/test/keyframes-belong-to-the-file.test.js +249 -249
  346. package/test/learned-median.test.js +37 -37
  347. package/test/letting-go-asks-who-is-watching.test.js +191 -191
  348. package/test/limit-row-by-area.test.js +60 -60
  349. package/test/link-budget.test.js +111 -111
  350. package/test/link-probe.test.js +56 -56
  351. package/test/local-encoding-data.test.js +273 -273
  352. package/test/logger-repeats.test.js +134 -134
  353. package/test/look-ahead-coverage.test.js +56 -56
  354. package/test/manager-surface.test.js +292 -292
  355. package/test/matroska-cues-track.test.js +192 -192
  356. package/test/memory-budget.test.js +390 -390
  357. package/test/move-cost.test.js +216 -216
  358. package/test/mp4-subtitles.test.js +173 -173
  359. package/test/one-authority.test.js +285 -285
  360. package/test/one-budget.test.js +149 -149
  361. package/test/one-output-one-session.test.js +204 -204
  362. package/test/one-resource-divided.test.js +185 -185
  363. package/test/one-serving-output-per-height.test.js +458 -458
  364. package/test/orchestrator-wired.test.js +206 -206
  365. package/test/output-catalog.test.js +39 -39
  366. package/test/output-shape.test.js +21 -21
  367. package/test/output-spec.test.js +251 -251
  368. package/test/output-speed.test.js +88 -88
  369. package/test/outputs-being-prepared.test.js +40 -40
  370. package/test/packet-witness-ring.test.js +236 -236
  371. package/test/packet-witness.test.js +148 -148
  372. package/test/piece-disk-store.test.js +401 -401
  373. package/test/piece-from-whole-file.test.js +129 -129
  374. package/test/piece-lru.test.js +319 -319
  375. package/test/piece-reader.test.js +162 -162
  376. package/test/piece-selection-offset.test.js +85 -85
  377. package/test/piece-store-eviction.test.js +595 -595
  378. package/test/piece-store-never-refuses.test.js +153 -153
  379. package/test/piece-store-reservations.test.js +403 -403
  380. package/test/piece-store-slow-disk.test.js +159 -159
  381. package/test/piece-tail.test.js +97 -97
  382. package/test/plan-host-timings.test.js +68 -68
  383. package/test/plan-is-steady.test.js +225 -225
  384. package/test/playback-readiness.test.js +453 -453
  385. package/test/playback-start-regressions.test.js +99 -99
  386. package/test/priority-map-download.test.js +174 -174
  387. package/test/priority-map-emptied.test.js +204 -204
  388. package/test/priority-map-per-output.test.js +215 -215
  389. package/test/priority-map.test.js +163 -163
  390. package/test/probe-wedge-certainty.test.js +60 -60
  391. package/test/produced-copy-choice.test.js +213 -213
  392. package/test/published-timeline.test.js +83 -83
  393. package/test/quality-offer.test.js +162 -162
  394. package/test/quality-variants.test.js +1229 -1229
  395. package/test/rate-control-in-the-output.test.js +180 -180
  396. package/test/read-survives-withdrawal.test.js +164 -164
  397. package/test/read-window.test.js +365 -365
  398. package/test/resume-warm.test.js +39 -39
  399. package/test/run-graph-drift.test.js +37 -37
  400. package/test/run-inputs.test.js +80 -80
  401. package/test/run-intervals.test.js +100 -100
  402. package/test/run-position-follows-published-grid.test.js +89 -89
  403. package/test/run-progress.test.js +65 -65
  404. package/test/same-height-switch.test.js +664 -664
  405. package/test/seek-frees-the-viewers-requests.test.js +217 -217
  406. package/test/seek-landing.test.js +109 -109
  407. package/test/seek-target-not-superseded.test.js +195 -195
  408. package/test/segment-closed-on-both-branches.test.js +96 -96
  409. package/test/segment-cut-times.test.js +63 -63
  410. package/test/segment-demand.test.js +80 -80
  411. package/test/segment-hold-supersede.test.js +91 -91
  412. package/test/segment-judged-by-its-own-header.test.js +221 -221
  413. package/test/segment-serve-wiring.test.js +475 -475
  414. package/test/segment-store-eviction.test.js +247 -247
  415. package/test/segment-store.test.js +323 -323
  416. package/test/segment-true-start.test.js +86 -86
  417. package/test/segments-are-shared.test.js +176 -176
  418. package/test/send-chunk-bytes.test.js +86 -86
  419. package/test/serving-existing-output.test.js +102 -102
  420. package/test/serving-output.test.js +102 -102
  421. package/test/shared-piece-store.test.js +310 -310
  422. package/test/sidecar-naming.test.js +142 -142
  423. package/test/source-file.test.js +133 -133
  424. package/test/source-files-route.test.js +12 -2
  425. package/test/source-registry.test.js +18 -18
  426. package/test/split-a-stretch.test.js +139 -139
  427. package/test/stale-request-after-seek.test.js +158 -158
  428. package/test/startup-readings.test.js +124 -124
  429. package/test/stream-route.test.js +209 -209
  430. package/test/subtitle-cue-framing.test.js +200 -200
  431. package/test/subtitle-cue-source.test.js +102 -102
  432. package/test/subtitle-cue-walk.test.js +370 -370
  433. package/test/subtitle-cursor.test.js +63 -63
  434. package/test/subtitle-defaults.test.js +118 -118
  435. package/test/subtitle-language.test.js +252 -252
  436. package/test/subtitle-metadata.test.js +15 -0
  437. package/test/subtitle-track-numbering.test.js +386 -386
  438. package/test/supply-margin.test.js +177 -177
  439. package/test/swarm-follows-readers.test.js +174 -174
  440. package/test/swarm-reach.test.js +130 -130
  441. package/test/swarm-selection.test.js +220 -220
  442. package/test/tail-duplication.test.js +167 -167
  443. package/test/the-channel-has-both-ends.test.js +91 -91
  444. package/test/the-torrent-thread-serves-bytes.test.js +107 -107
  445. package/test/thread-pool.test.js +53 -53
  446. package/test/timeline.test.js +84 -84
  447. package/test/torrent-contents.test.js +235 -235
  448. package/test/torrent-cost.test.js +71 -71
  449. package/test/torrent-files.test.js +221 -221
  450. package/test/torrent-naming.test.js +255 -255
  451. package/test/tracks-begin-together.test.js +209 -209
  452. package/test/tunnel-renewal.test.js +167 -167
  453. package/test/two-viewers-one-picture.test.js +407 -407
  454. package/test/upload-hurry.test.js +186 -186
  455. package/test/usrsctp-state.test.js +131 -131
  456. package/test/video-facts.test.js +102 -102
  457. package/test/viewer-assignments.test.js +143 -143
  458. package/test/viewer-outputs.test.js +285 -285
  459. package/test/viewer-presence.test.js +116 -116
  460. package/test/viewer-requests-admission.test.js +89 -89
  461. package/test/viewer-states.test.js +189 -189
  462. package/test/viewer-subtitle-subscription.test.js +96 -96
  463. package/test/viewer.test.js +139 -139
  464. package/test/viewing-generations.test.js +390 -390
  465. package/test/visible-rung.test.js +37 -37
  466. package/test/wait-ledger.test.js +100 -100
  467. package/test/webrtc-shim.test.js +149 -149
  468. package/test/wedge-certainty.test.js +131 -131
  469. package/test/withdraw-piece-claim.test.js +212 -212
  470. package/test/worker-channel.test.js +158 -158
  471. package/utils/client-log-file.js +151 -151
  472. package/utils/logger.js +312 -312
  473. package/utils/parse-range.js +25 -25
  474. package/utils/perf.js +59 -59
  475. package/utils/torrent-source-key.js +38 -38
@@ -1,57 +1,57 @@
1
- /**
2
- * @file Keep the last few core dumps and no more.
3
- *
4
- * Each is the worker thread's whole address space — 4.18 GB on the field host —
5
- * and four of them had nearly filled a 235 GB disk by 2026-08-21. The newest
6
- * are evidence for a fault that is still open, so they stay; the rest go.
7
- */
8
-
9
- import assert from "node:assert/strict";
10
- import test from "node:test";
11
-
12
- import { dumpsToRemove, isCoreDump } from "../services/storage/core-dumps.js";
13
-
14
- const dumps = [
15
- { name: "core.WorkerThread.81.1787176646", writtenAt: 1787176646000 },
16
- { name: "core.WorkerThread.81.1787224562", writtenAt: 1787224562000 },
17
- { name: "core.WorkerThread.81.1787237468", writtenAt: 1787237468000 },
18
- { name: "core.WorkerThread.81.1787243278", writtenAt: 1787243278000 },
19
- { name: "core.WorkerThread.81.1787292750", writtenAt: 1787292750000 }
20
- ];
21
-
22
- test("the newest two stay and the rest go, oldest first", () => {
23
- assert.deepEqual(dumpsToRemove(dumps), [
24
- "core.WorkerThread.81.1787176646",
25
- "core.WorkerThread.81.1787224562",
26
- "core.WorkerThread.81.1787237468"
27
- ]);
28
- });
29
-
30
- test("fewer than the limit leaves everything alone", () => {
31
- assert.deepEqual(dumpsToRemove(dumps.slice(0, 2)), []);
32
- assert.deepEqual(dumpsToRemove([]), []);
33
- });
34
-
35
- test("order on disk does not decide; the time written does", () => {
36
- const shuffled = [dumps[3], dumps[0], dumps[4], dumps[2], dumps[1]];
37
- assert.deepEqual(dumpsToRemove(shuffled, 1), [
38
- "core.WorkerThread.81.1787176646",
39
- "core.WorkerThread.81.1787224562",
40
- "core.WorkerThread.81.1787237468",
41
- "core.WorkerThread.81.1787243278"
42
- ]);
43
- });
44
-
45
- test("only core dumps are considered", () => {
46
- assert.equal(isCoreDump("core.WorkerThread.81.1787292750"), true);
47
- assert.equal(isCoreDump("proxy.log"), false);
48
- assert.equal(isCoreDump("host-timings.json"), false);
49
- // Not a path, and not a directory called core.
50
- assert.equal(isCoreDump("core.foo/bar"), false);
51
- assert.equal(isCoreDump(""), false);
52
- });
53
-
54
- test("nothing readable is not a reason to delete anything", () => {
55
- assert.deepEqual(dumpsToRemove(null), []);
56
- assert.deepEqual(dumpsToRemove([{ name: 5, writtenAt: "x" }]), []);
57
- });
1
+ /**
2
+ * @file Keep the last few core dumps and no more.
3
+ *
4
+ * Each is the worker thread's whole address space — 4.18 GB on the field host —
5
+ * and four of them had nearly filled a 235 GB disk by 2026-08-21. The newest
6
+ * are evidence for a fault that is still open, so they stay; the rest go.
7
+ */
8
+
9
+ import assert from "node:assert/strict";
10
+ import test from "node:test";
11
+
12
+ import { dumpsToRemove, isCoreDump } from "../services/storage/core-dumps.js";
13
+
14
+ const dumps = [
15
+ { name: "core.WorkerThread.81.1787176646", writtenAt: 1787176646000 },
16
+ { name: "core.WorkerThread.81.1787224562", writtenAt: 1787224562000 },
17
+ { name: "core.WorkerThread.81.1787237468", writtenAt: 1787237468000 },
18
+ { name: "core.WorkerThread.81.1787243278", writtenAt: 1787243278000 },
19
+ { name: "core.WorkerThread.81.1787292750", writtenAt: 1787292750000 }
20
+ ];
21
+
22
+ test("the newest two stay and the rest go, oldest first", () => {
23
+ assert.deepEqual(dumpsToRemove(dumps), [
24
+ "core.WorkerThread.81.1787176646",
25
+ "core.WorkerThread.81.1787224562",
26
+ "core.WorkerThread.81.1787237468"
27
+ ]);
28
+ });
29
+
30
+ test("fewer than the limit leaves everything alone", () => {
31
+ assert.deepEqual(dumpsToRemove(dumps.slice(0, 2)), []);
32
+ assert.deepEqual(dumpsToRemove([]), []);
33
+ });
34
+
35
+ test("order on disk does not decide; the time written does", () => {
36
+ const shuffled = [dumps[3], dumps[0], dumps[4], dumps[2], dumps[1]];
37
+ assert.deepEqual(dumpsToRemove(shuffled, 1), [
38
+ "core.WorkerThread.81.1787176646",
39
+ "core.WorkerThread.81.1787224562",
40
+ "core.WorkerThread.81.1787237468",
41
+ "core.WorkerThread.81.1787243278"
42
+ ]);
43
+ });
44
+
45
+ test("only core dumps are considered", () => {
46
+ assert.equal(isCoreDump("core.WorkerThread.81.1787292750"), true);
47
+ assert.equal(isCoreDump("proxy.log"), false);
48
+ assert.equal(isCoreDump("host-timings.json"), false);
49
+ // Not a path, and not a directory called core.
50
+ assert.equal(isCoreDump("core.foo/bar"), false);
51
+ assert.equal(isCoreDump(""), false);
52
+ });
53
+
54
+ test("nothing readable is not a reason to delete anything", () => {
55
+ assert.deepEqual(dumpsToRemove(null), []);
56
+ assert.deepEqual(dumpsToRemove([{ name: 5, writtenAt: "x" }]), []);
57
+ });
@@ -1,228 +1,228 @@
1
- /**
2
- * @file What the plan believes exists is what the disk holds — with a real
3
- * store, a real directory, and no ffmpeg.
4
- *
5
- * The failure these are written against, field 2026-09-07, twice in one evening
6
- * on `Star.Trek.Strange.New.Worlds.S04E03`:
7
- *
8
- * > `encode: … ready=482 zones=[p100:#0..#0 …] runs=[#0..#0@0.0x] waiting=nobody`
9
- * > `encode-run stopped #0..#0 …, reached #-1 (0 segment(s)) after 2778ms,`
10
- * > `signal SIGTERM: the film is no worse off without it`
11
- * > `encode: … ready=482 … runs=[] waiting=nobody`
12
- *
13
- * The map claimed every one of the film's 482 segments while the directory held
14
- * nothing a header could be lifted out of, so every arrangement scored perfect,
15
- * the only encoder was taken away as unnecessary and none was placed again. The
16
- * viewer's browser asked for the init segment, was never answered, and gave up.
17
- *
18
- * Readiness had been accumulating for the life of the process: the map was told
19
- * what existed and never told what had stopped existing — the word for that
20
- * existed and was called from no line of the product. So these check the one
21
- * property that makes the whole class of failure impossible: what the map says
22
- * is ready is what the store can prove right now, and nothing older.
23
- */
24
-
25
- import test from "node:test";
26
- import assert from "node:assert/strict";
27
- import { EventEmitter } from "node:events";
28
- import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
29
- import os from "node:os";
30
- import path from "node:path";
31
- import { EncodeRun } from "../services/encode/EncodeRun.js";
32
- import { SegmentStore } from "../services/storage/segment-store/SegmentStore.js";
33
- import { SoftwareEncoder } from "../services/encode/SoftwareEncoder.js";
34
- import { EncodeOrchestrator } from "../services/encode/EncodeOrchestrator.js";
35
- import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
36
-
37
- const PICTURE = "torrent:abc:fmt=fmp4:grid=kf@0:video-only:v=0/copy";
38
- const SEGMENTS = 482;
39
-
40
- class FakeProcess extends EventEmitter {
41
- constructor() {
42
- super();
43
- this.pid = 1;
44
- }
45
-
46
- kill(signal) {
47
- this.emit("exit", null, signal);
48
- }
49
- }
50
-
51
- /**
52
- * A store on a real directory, and an orchestrator that owns it.
53
- *
54
- * @returns {{ made: EncodeOrchestrator, store: SegmentStore, dir: string,
55
- * root: string, lines: string[] }}
56
- */
57
- function orchestratorWithAStore() {
58
- const root = mkdtempSync(path.join(os.tmpdir(), "coverage-disk-"));
59
- const lines = [];
60
- const logger = { info: (line) => lines.push(line), warn: (line) => lines.push(line) };
61
- const store = new SegmentStore({ root, logger });
62
- store.useFormat(PICTURE, fmp4Format);
63
- const dir = store.directoryFor(PICTURE);
64
- /** @type {EncodeOrchestrator} */
65
- let made;
66
- made = new EncodeOrchestrator({
67
- maxRunsFor: () => 1,
68
- segmentSeconds: 6,
69
- killCostSec: 0,
70
- firstByteWaitSec: 0.12,
71
- refetchSecPerFilmSecond: () => 0.25,
72
- startingSpeedFor: () => 2,
73
- segmentCoverage: {
74
- provenNumbers: (address) => store.provenNumbers(address),
75
- announce: (address, index) => store.announce(address, index),
76
- filesHeld: (address) => store.filesHeld(address),
77
- clearUpAfter: (address, startedAt) => store.clearUpAfter(address, startedAt)
78
- },
79
- now: () => 1000,
80
- logger,
81
- makeRun: ({ address, from, to }) => new EncodeRun({
82
- address,
83
- encoder: new SoftwareEncoder(),
84
- from,
85
- to,
86
- buildArgs: () => ["-i", "in", "out"],
87
- spawn: () => new FakeProcess(),
88
- logger,
89
- now: () => 1000,
90
- onEnded: (ended) => made.noteEnded(ended)
91
- })
92
- });
93
- made.setSegmentCount(PICTURE, SEGMENTS);
94
- return { made, store, dir, root, lines };
95
- }
96
-
97
- /** A viewer stopped at the beginning, which is what a fresh session states. */
98
- function aViewerAtTheStart(made) {
99
- made.notePriorityMap(PICTURE, [
100
- { from: 0, to: 0, priority: 100, withinSeconds: 0 },
101
- { from: 1, to: SEGMENTS - 1, priority: 91, withinSeconds: 6 }
102
- ]);
103
- }
104
-
105
- /**
106
- * Every segment of the film, written and reported closed — what the store looked
107
- * like while the film was being watched.
108
- */
109
- function theWholeFilmIsOnDisk(store, dir) {
110
- for (let index = 0; index < SEGMENTS; index += 1) {
111
- // Under the served name, which is the whole of what says a piece is closed:
112
- // it takes that name only when its writer has said so. There used to be a
113
- // statement kept beside the disk as well, told by whoever noticed a piece
114
- // being produced — a second owner of one fact, and the fault this file's own
115
- // subject is.
116
- writeFileSync(path.join(dir, fmp4Format.segmentFileName(index)), Buffer.alloc(16));
117
- }
118
- }
119
-
120
- test("a film that is entirely made needs no encoder", (t) => {
121
- const { made, store, dir, root } = orchestratorWithAStore();
122
- t.after(() => {
123
- // THE STORE LETS ITS DIRECTORIES GO, and only then is the root removed. It
124
- // holds a watch on each of them — that is how a piece closed by a muxer
125
- // with no channel of its own becomes an event — and a directory with an
126
- // open watch on it cannot be removed on Windows: `rmSync` retries until it
127
- // gives up, and the check reads as a hang.
128
- store.dropAll("the check is over");
129
- rmSync(root, { recursive: true, force: true });
130
- });
131
-
132
- theWholeFilmIsOnDisk(store, dir);
133
- aViewerAtTheStart(made);
134
- made.reconcile();
135
-
136
- // The other half of the property, and the reason the failure looked
137
- // reasonable: when the film really is all there, taking the encoder away IS
138
- // right, and the viewer is served from the disk.
139
- assert.equal(made.runsOn(PICTURE).length, 0, "nothing left to make");
140
- });
141
-
142
- test("segments the store has lost stop being ready, and an encoder is placed again", (t) => {
143
- const { made, store, dir, root } = orchestratorWithAStore();
144
- t.after(() => {
145
- // THE STORE LETS ITS DIRECTORIES GO, and only then is the root removed. It
146
- // holds a watch on each of them — that is how a piece closed by a muxer
147
- // with no channel of its own becomes an event — and a directory with an
148
- // open watch on it cannot be removed on Windows: `rmSync` retries until it
149
- // gives up, and the check reads as a hang.
150
- store.dropAll("the check is over");
151
- rmSync(root, { recursive: true, force: true });
152
- });
153
-
154
- theWholeFilmIsOnDisk(store, dir);
155
- aViewerAtTheStart(made);
156
- made.reconcile();
157
- assert.equal(made.runsOn(PICTURE).length, 0);
158
-
159
- // THE FIELD FAILURE. The output's directory goes — dropped for room, or by the
160
- // idle rule, or because a killed process left it and the sweep cleared it. The
161
- // map used to keep all 482 numbers and the plan went on believing the film was
162
- // made, for the life of the process.
163
- store.drop(PICTURE, "the test is taking its files away");
164
- store.useFormat(PICTURE, fmp4Format);
165
- store.directoryFor(PICTURE);
166
-
167
- made.reconcile();
168
- const runs = made.runsOn(PICTURE);
169
- assert.equal(runs.length, 1, "the film is unmade again, so somebody makes it");
170
- assert.equal(runs[0].from, 0, "beginning where the viewer is stopped");
171
- });
172
-
173
- test("a piece discarded with the run that had it open is not ready either", (t) => {
174
- const { made, store, dir, root } = orchestratorWithAStore();
175
- t.after(() => {
176
- // THE STORE LETS ITS DIRECTORIES GO, and only then is the root removed. It
177
- // holds a watch on each of them — that is how a piece closed by a muxer
178
- // with no channel of its own becomes an event — and a directory with an
179
- // open watch on it cannot be removed on Windows: `rmSync` retries until it
180
- // gives up, and the check reads as a hang.
181
- store.dropAll("the check is over");
182
- rmSync(root, { recursive: true, force: true });
183
- });
184
-
185
- theWholeFilmIsOnDisk(store, dir);
186
- aViewerAtTheStart(made);
187
- made.reconcile();
188
- assert.equal(made.runsOn(PICTURE).length, 0);
189
-
190
- // A run stopped the instant after opening #0 leaves a file of no bytes under a
191
- // name that reads as a segment; the store throws it away. Field 2026-09-07,
192
- // 20:13:13 and 20:13:57 — printed twice while the map went on saying 482.
193
- rmSync(path.join(dir, fmp4Format.segmentFileName(0)), { force: true });
194
-
195
- made.reconcile();
196
- assert.equal(made.runsOn(PICTURE).length, 1, "one number missing is one encoder");
197
- assert.equal(made.runsOn(PICTURE)[0].from, 0);
198
- });
199
-
200
- test("nobody making what somebody waits for is said out loud", (t) => {
201
- const { made, store, root, lines } = orchestratorWithAStore();
202
- t.after(() => {
203
- // THE STORE LETS ITS DIRECTORIES GO, and only then is the root removed. It
204
- // holds a watch on each of them — that is how a piece closed by a muxer
205
- // with no channel of its own becomes an event — and a directory with an
206
- // open watch on it cannot be removed on Windows: `rmSync` retries until it
207
- // gives up, and the check reads as a hang.
208
- store.dropAll("the check is over");
209
- rmSync(root, { recursive: true, force: true });
210
- });
211
-
212
- // A HOST THAT CANNOT BUILD AN ENCODER. Whatever the reason — and there are
213
- // several — the state it leaves is the one that cost two sessions on
214
- // 2026-09-07: somebody is waiting, nothing is being made, and every line
215
- // above reads as a healthy proxy. It ran for 41 seconds in the field with no
216
- // word about it on either side, and ended at the browser's own timeout with a
217
- // message naming no cause.
218
- made.makeRun = () => null;
219
- aViewerAtTheStart(made);
220
- made.reconcile();
221
-
222
- assert.equal(made.runsOn(PICTURE).length, 0);
223
- const said = lines.find((line) => line.includes("NO ENCODER IS MAKING IT"));
224
- assert.ok(said, "the state has a line of its own");
225
- assert.ok(said.includes("#0"), "which number is wanted");
226
- assert.ok(said.includes(PICTURE), "of which output, whole — not cut to sixty characters");
227
- assert.ok(/files=\d+/.test(said), "and what the disk holds, beside what is proven");
228
- });
1
+ /**
2
+ * @file What the plan believes exists is what the disk holds — with a real
3
+ * store, a real directory, and no ffmpeg.
4
+ *
5
+ * The failure these are written against, field 2026-09-07, twice in one evening
6
+ * on `Star.Trek.Strange.New.Worlds.S04E03`:
7
+ *
8
+ * > `encode: … ready=482 zones=[p100:#0..#0 …] runs=[#0..#0@0.0x] waiting=nobody`
9
+ * > `encode-run stopped #0..#0 …, reached #-1 (0 segment(s)) after 2778ms,`
10
+ * > `signal SIGTERM: the film is no worse off without it`
11
+ * > `encode: … ready=482 … runs=[] waiting=nobody`
12
+ *
13
+ * The map claimed every one of the film's 482 segments while the directory held
14
+ * nothing a header could be lifted out of, so every arrangement scored perfect,
15
+ * the only encoder was taken away as unnecessary and none was placed again. The
16
+ * viewer's browser asked for the init segment, was never answered, and gave up.
17
+ *
18
+ * Readiness had been accumulating for the life of the process: the map was told
19
+ * what existed and never told what had stopped existing — the word for that
20
+ * existed and was called from no line of the product. So these check the one
21
+ * property that makes the whole class of failure impossible: what the map says
22
+ * is ready is what the store can prove right now, and nothing older.
23
+ */
24
+
25
+ import test from "node:test";
26
+ import assert from "node:assert/strict";
27
+ import { EventEmitter } from "node:events";
28
+ import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
29
+ import os from "node:os";
30
+ import path from "node:path";
31
+ import { EncodeRun } from "../services/encode/EncodeRun.js";
32
+ import { SegmentStore } from "../services/storage/segment-store/SegmentStore.js";
33
+ import { SoftwareEncoder } from "../services/encode/SoftwareEncoder.js";
34
+ import { EncodeOrchestrator } from "../services/encode/EncodeOrchestrator.js";
35
+ import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
36
+
37
+ const PICTURE = "torrent:abc:fmt=fmp4:grid=kf@0:video-only:v=0/copy";
38
+ const SEGMENTS = 482;
39
+
40
+ class FakeProcess extends EventEmitter {
41
+ constructor() {
42
+ super();
43
+ this.pid = 1;
44
+ }
45
+
46
+ kill(signal) {
47
+ this.emit("exit", null, signal);
48
+ }
49
+ }
50
+
51
+ /**
52
+ * A store on a real directory, and an orchestrator that owns it.
53
+ *
54
+ * @returns {{ made: EncodeOrchestrator, store: SegmentStore, dir: string,
55
+ * root: string, lines: string[] }}
56
+ */
57
+ function orchestratorWithAStore() {
58
+ const root = mkdtempSync(path.join(os.tmpdir(), "coverage-disk-"));
59
+ const lines = [];
60
+ const logger = { info: (line) => lines.push(line), warn: (line) => lines.push(line) };
61
+ const store = new SegmentStore({ root, logger });
62
+ store.useFormat(PICTURE, fmp4Format);
63
+ const dir = store.directoryFor(PICTURE);
64
+ /** @type {EncodeOrchestrator} */
65
+ let made;
66
+ made = new EncodeOrchestrator({
67
+ maxRunsFor: () => 1,
68
+ segmentSeconds: 6,
69
+ killCostSec: 0,
70
+ firstByteWaitSec: 0.12,
71
+ refetchSecPerFilmSecond: () => 0.25,
72
+ startingSpeedFor: () => 2,
73
+ segmentCoverage: {
74
+ provenNumbers: (address) => store.provenNumbers(address),
75
+ announce: (address, index) => store.announce(address, index),
76
+ filesHeld: (address) => store.filesHeld(address),
77
+ clearUpAfter: (address, startedAt) => store.clearUpAfter(address, startedAt)
78
+ },
79
+ now: () => 1000,
80
+ logger,
81
+ makeRun: ({ address, from, to }) => new EncodeRun({
82
+ address,
83
+ encoder: new SoftwareEncoder(),
84
+ from,
85
+ to,
86
+ buildArgs: () => ["-i", "in", "out"],
87
+ spawn: () => new FakeProcess(),
88
+ logger,
89
+ now: () => 1000,
90
+ onEnded: (ended) => made.noteEnded(ended)
91
+ })
92
+ });
93
+ made.setSegmentCount(PICTURE, SEGMENTS);
94
+ return { made, store, dir, root, lines };
95
+ }
96
+
97
+ /** A viewer stopped at the beginning, which is what a fresh session states. */
98
+ function aViewerAtTheStart(made) {
99
+ made.notePriorityMap(PICTURE, [
100
+ { from: 0, to: 0, priority: 100, withinSeconds: 0 },
101
+ { from: 1, to: SEGMENTS - 1, priority: 91, withinSeconds: 6 }
102
+ ]);
103
+ }
104
+
105
+ /**
106
+ * Every segment of the film, written and reported closed — what the store looked
107
+ * like while the film was being watched.
108
+ */
109
+ function theWholeFilmIsOnDisk(store, dir) {
110
+ for (let index = 0; index < SEGMENTS; index += 1) {
111
+ // Under the served name, which is the whole of what says a piece is closed:
112
+ // it takes that name only when its writer has said so. There used to be a
113
+ // statement kept beside the disk as well, told by whoever noticed a piece
114
+ // being produced — a second owner of one fact, and the fault this file's own
115
+ // subject is.
116
+ writeFileSync(path.join(dir, fmp4Format.segmentFileName(index)), Buffer.alloc(16));
117
+ }
118
+ }
119
+
120
+ test("a film that is entirely made needs no encoder", (t) => {
121
+ const { made, store, dir, root } = orchestratorWithAStore();
122
+ t.after(() => {
123
+ // THE STORE LETS ITS DIRECTORIES GO, and only then is the root removed. It
124
+ // holds a watch on each of them — that is how a piece closed by a muxer
125
+ // with no channel of its own becomes an event — and a directory with an
126
+ // open watch on it cannot be removed on Windows: `rmSync` retries until it
127
+ // gives up, and the check reads as a hang.
128
+ store.dropAll("the check is over");
129
+ rmSync(root, { recursive: true, force: true });
130
+ });
131
+
132
+ theWholeFilmIsOnDisk(store, dir);
133
+ aViewerAtTheStart(made);
134
+ made.reconcile();
135
+
136
+ // The other half of the property, and the reason the failure looked
137
+ // reasonable: when the film really is all there, taking the encoder away IS
138
+ // right, and the viewer is served from the disk.
139
+ assert.equal(made.runsOn(PICTURE).length, 0, "nothing left to make");
140
+ });
141
+
142
+ test("segments the store has lost stop being ready, and an encoder is placed again", (t) => {
143
+ const { made, store, dir, root } = orchestratorWithAStore();
144
+ t.after(() => {
145
+ // THE STORE LETS ITS DIRECTORIES GO, and only then is the root removed. It
146
+ // holds a watch on each of them — that is how a piece closed by a muxer
147
+ // with no channel of its own becomes an event — and a directory with an
148
+ // open watch on it cannot be removed on Windows: `rmSync` retries until it
149
+ // gives up, and the check reads as a hang.
150
+ store.dropAll("the check is over");
151
+ rmSync(root, { recursive: true, force: true });
152
+ });
153
+
154
+ theWholeFilmIsOnDisk(store, dir);
155
+ aViewerAtTheStart(made);
156
+ made.reconcile();
157
+ assert.equal(made.runsOn(PICTURE).length, 0);
158
+
159
+ // THE FIELD FAILURE. The output's directory goes — dropped for room, or by the
160
+ // idle rule, or because a killed process left it and the sweep cleared it. The
161
+ // map used to keep all 482 numbers and the plan went on believing the film was
162
+ // made, for the life of the process.
163
+ store.drop(PICTURE, "the test is taking its files away");
164
+ store.useFormat(PICTURE, fmp4Format);
165
+ store.directoryFor(PICTURE);
166
+
167
+ made.reconcile();
168
+ const runs = made.runsOn(PICTURE);
169
+ assert.equal(runs.length, 1, "the film is unmade again, so somebody makes it");
170
+ assert.equal(runs[0].from, 0, "beginning where the viewer is stopped");
171
+ });
172
+
173
+ test("a piece discarded with the run that had it open is not ready either", (t) => {
174
+ const { made, store, dir, root } = orchestratorWithAStore();
175
+ t.after(() => {
176
+ // THE STORE LETS ITS DIRECTORIES GO, and only then is the root removed. It
177
+ // holds a watch on each of them — that is how a piece closed by a muxer
178
+ // with no channel of its own becomes an event — and a directory with an
179
+ // open watch on it cannot be removed on Windows: `rmSync` retries until it
180
+ // gives up, and the check reads as a hang.
181
+ store.dropAll("the check is over");
182
+ rmSync(root, { recursive: true, force: true });
183
+ });
184
+
185
+ theWholeFilmIsOnDisk(store, dir);
186
+ aViewerAtTheStart(made);
187
+ made.reconcile();
188
+ assert.equal(made.runsOn(PICTURE).length, 0);
189
+
190
+ // A run stopped the instant after opening #0 leaves a file of no bytes under a
191
+ // name that reads as a segment; the store throws it away. Field 2026-09-07,
192
+ // 20:13:13 and 20:13:57 — printed twice while the map went on saying 482.
193
+ rmSync(path.join(dir, fmp4Format.segmentFileName(0)), { force: true });
194
+
195
+ made.reconcile();
196
+ assert.equal(made.runsOn(PICTURE).length, 1, "one number missing is one encoder");
197
+ assert.equal(made.runsOn(PICTURE)[0].from, 0);
198
+ });
199
+
200
+ test("nobody making what somebody waits for is said out loud", (t) => {
201
+ const { made, store, root, lines } = orchestratorWithAStore();
202
+ t.after(() => {
203
+ // THE STORE LETS ITS DIRECTORIES GO, and only then is the root removed. It
204
+ // holds a watch on each of them — that is how a piece closed by a muxer
205
+ // with no channel of its own becomes an event — and a directory with an
206
+ // open watch on it cannot be removed on Windows: `rmSync` retries until it
207
+ // gives up, and the check reads as a hang.
208
+ store.dropAll("the check is over");
209
+ rmSync(root, { recursive: true, force: true });
210
+ });
211
+
212
+ // A HOST THAT CANNOT BUILD AN ENCODER. Whatever the reason — and there are
213
+ // several — the state it leaves is the one that cost two sessions on
214
+ // 2026-09-07: somebody is waiting, nothing is being made, and every line
215
+ // above reads as a healthy proxy. It ran for 41 seconds in the field with no
216
+ // word about it on either side, and ended at the browser's own timeout with a
217
+ // message naming no cause.
218
+ made.makeRun = () => null;
219
+ aViewerAtTheStart(made);
220
+ made.reconcile();
221
+
222
+ assert.equal(made.runsOn(PICTURE).length, 0);
223
+ const said = lines.find((line) => line.includes("NO ENCODER IS MAKING IT"));
224
+ assert.ok(said, "the state has a line of its own");
225
+ assert.ok(said.includes("#0"), "which number is wanted");
226
+ assert.ok(said.includes(PICTURE), "of which output, whole — not cut to sixty characters");
227
+ assert.ok(/files=\d+/.test(said), "and what the disk holds, beside what is proven");
228
+ });