@torrent-tv/proxy 2.87.2 → 2.87.4

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 (465) 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 +2157 -2148
  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 +94 -94
  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/post.js +53 -53
  85. package/routes/api/sources/files/get.js +100 -100
  86. package/routes/api/sources/post.js +36 -36
  87. package/routes/api/sources/stats/get.js +132 -132
  88. package/routes/api/sources/warm/post.js +217 -181
  89. package/routes/api/subtitles/get.js +230 -230
  90. package/routes/api/transcode-sessions/fragment-far/post.js +60 -60
  91. package/routes/api/transcode-sessions/net-report/post.js +129 -129
  92. package/routes/api/transcode-sessions/post.js +160 -160
  93. package/routes/api/transcode-sessions/progress/get.js +27 -27
  94. package/routes/api/transcode-sessions/release/post.js +41 -41
  95. package/routes/api/transcode-sessions/seek/post.js +63 -63
  96. package/routes/health/get.js +13 -13
  97. package/routes/healthz/get.js +13 -13
  98. package/routes/stream/get.js +361 -361
  99. package/routes/transcode/audio-file/get.js +64 -64
  100. package/routes/transcode/audio-warm/get.js +84 -84
  101. package/routes/transcode/session-file/get.js +52 -52
  102. package/routes/transcode/variant-file/get.js +95 -95
  103. package/routes/transcode/variant-warm/get.js +84 -84
  104. package/scripts/render-run-graph.js +173 -173
  105. package/server.js +721 -720
  106. package/services/encode/CoverageMap.js +428 -428
  107. package/services/encode/CushionReport.js +345 -345
  108. package/services/encode/EncodeAdmission.js +332 -332
  109. package/services/encode/EncodeOrchestrator.js +1217 -1217
  110. package/services/encode/EncodePlan.js +1366 -1366
  111. package/services/encode/EncodeRun.js +776 -776
  112. package/services/encode/EncodeRuns.js +1229 -1229
  113. package/services/encode/Encoder.js +142 -142
  114. package/services/encode/EncoderSelection.js +38 -38
  115. package/services/encode/LocalObservations.js +359 -359
  116. package/services/encode/NvencEncoder.js +50 -50
  117. package/services/encode/OutputOpening.js +755 -755
  118. package/services/encode/OutputTimes.js +579 -579
  119. package/services/encode/QsvEncoder.js +58 -58
  120. package/services/encode/Renditions.js +2162 -2162
  121. package/services/encode/RunProgress.js +84 -84
  122. package/services/encode/SegmentDemand.js +95 -95
  123. package/services/encode/SoftwareEncoder.js +121 -121
  124. package/services/encode/V4l2m2mEncoder.js +53 -53
  125. package/services/encode/VaapiEncoder.js +66 -66
  126. package/services/encode/args.js +416 -416
  127. package/services/encode/available-share.js +89 -89
  128. package/services/encode/calibration.js +361 -361
  129. package/services/encode/contention.js +128 -128
  130. package/services/encode/decode-cost-fit.js +363 -363
  131. package/services/encode/encode-exit.js +114 -114
  132. package/services/encode/encode-run-state.js +551 -551
  133. package/services/encode/encoder-readings.js +45 -45
  134. package/services/encode/fingerprint.js +322 -322
  135. package/services/encode/host-load.js +174 -174
  136. package/services/encode/hwaccel.js +1894 -1894
  137. package/services/encode/index.js +9 -9
  138. package/services/encode/learned-median.js +90 -90
  139. package/services/encode/output/EncodedOutput.js +57 -57
  140. package/services/encode/output/Output.js +131 -131
  141. package/services/encode/output/OutputCatalog.js +414 -414
  142. package/services/encode/output/OutputSpec.js +390 -390
  143. package/services/encode/output/Timeline.js +308 -308
  144. package/services/encode/output/cut-grid.js +107 -107
  145. package/services/encode/output/index.js +20 -20
  146. package/services/encode/output/ladder.js +32 -32
  147. package/services/encode/output/playlists.js +284 -284
  148. package/services/encode/output/rates.js +125 -125
  149. package/services/encode/output-key-format.js +21 -21
  150. package/services/encode/quality/EncodeCost.js +1083 -1083
  151. package/services/encode/quality/HostLoad.js +525 -525
  152. package/services/encode/quality/HostTimings.js +249 -249
  153. package/services/encode/quality/OutputQualityState.js +28 -28
  154. package/services/encode/quality/QualityController.js +935 -935
  155. package/services/encode/quality/QualityOffer.js +416 -416
  156. package/services/encode/quality/drain-threat.js +47 -47
  157. package/services/encode/quality/link-budget.js +254 -254
  158. package/services/encode/quality/output-format.js +266 -266
  159. package/services/encode/quality/serving-output.js +216 -216
  160. package/services/encode/quality/visible-rung.js +57 -57
  161. package/services/encode/run-budget.js +97 -97
  162. package/services/encode/run-command.js +747 -747
  163. package/services/encode/run-costs.js +155 -155
  164. package/services/encode/run-inputs.js +42 -42
  165. package/services/encode/segment-formats/fmp4.js +437 -437
  166. package/services/encode/segment-formats/index.js +77 -77
  167. package/services/encode/segment-formats/init-compat.js +324 -324
  168. package/services/encode/segment-formats/mp4-boxes.js +311 -311
  169. package/services/encode/segment-formats/mpegts.js +134 -134
  170. package/services/encode/start-stop-cost.js +178 -178
  171. package/services/encode/throughput.js +97 -97
  172. package/services/encode/torrent-cost.js +88 -88
  173. package/services/identity/installation-id.js +38 -38
  174. package/services/media/ContainerOrchestrator.js +149 -149
  175. package/services/media/KeyframeTables.js +316 -316
  176. package/services/media/SourceFile.js +298 -298
  177. package/services/media/SubtitleCues.js +520 -520
  178. package/services/media/SubtitleOrchestrator.js +167 -167
  179. package/services/media/audio-inventory.js +212 -212
  180. package/services/media/container/AviContainer.js +266 -266
  181. package/services/media/container/Container.js +603 -603
  182. package/services/media/container/ContainerFactory.js +56 -56
  183. package/services/media/container/KeyframeTable.js +272 -272
  184. package/services/media/container/MatroskaContainer.js +1494 -1494
  185. package/services/media/container/Mp4Container.js +1244 -1244
  186. package/services/media/container/SubtitleFileContainer.js +322 -322
  187. package/services/media/container/ebml-reader.js +159 -159
  188. package/services/media/ffmpeg-banner.js +260 -260
  189. package/services/media/keyframe-probe.js +157 -157
  190. package/services/media/media-info-probe.js +93 -93
  191. package/services/media/playback-planner.js +856 -848
  192. package/services/media/tracks/AudioTrack.js +131 -131
  193. package/services/media/tracks/ContainerTrack.js +75 -75
  194. package/services/media/tracks/ImageSubtitleTrack.js +19 -19
  195. package/services/media/tracks/SubtitleTrack.js +38 -38
  196. package/services/media/tracks/TextSubtitleTrack.js +287 -287
  197. package/services/media/tracks/VideoTrack.js +33 -33
  198. package/services/media/tracks/index.js +15 -15
  199. package/services/media/tracks/language-detect.js +174 -174
  200. package/services/server/OutputLifecycle.js +418 -418
  201. package/services/server/SegmentServing.js +1146 -1146
  202. package/services/server/ViewerRequests.js +522 -522
  203. package/services/{viewer → server}/WaitLedger.js +142 -142
  204. package/services/server/controllers/PlaybackController.js +36 -36
  205. package/services/server/controllers/SubtitleController.js +109 -109
  206. package/services/server/http-responses.js +60 -60
  207. package/services/server/transcode-session-files.js +325 -325
  208. package/services/server/wire-outputs.js +983 -983
  209. package/services/storage/Diagnostics.js +202 -202
  210. package/services/storage/MachineBudget.js +235 -235
  211. package/services/storage/allowance.js +107 -107
  212. package/services/storage/core-dumps.js +106 -106
  213. package/services/storage/files/CompletedFiles.js +391 -391
  214. package/services/storage/files/piece-from-whole-file.js +118 -118
  215. package/services/storage/free.js +71 -71
  216. package/services/storage/keep.js +48 -48
  217. package/services/storage/machine-memory.js +56 -56
  218. package/services/storage/memory-report.js +575 -575
  219. package/services/storage/piece-store/piece-disk-store.js +516 -516
  220. package/services/storage/piece-store/piece-lru.js +495 -495
  221. package/services/storage/piece-store/shared-piece-store.js +1880 -1880
  222. package/services/storage/returns.js +103 -103
  223. package/services/storage/segment-store/SegmentStore.js +1196 -1196
  224. package/services/storage/wire.js +175 -175
  225. package/services/torrent/Contents.js +324 -324
  226. package/services/torrent/demand/DemandRegister.js +202 -202
  227. package/services/torrent/demand/Urgency.js +137 -137
  228. package/services/torrent/demand/Window.js +118 -118
  229. package/services/torrent/demand/index.js +8 -8
  230. package/services/torrent/demand/pieces.js +140 -140
  231. package/services/torrent/download/SwarmSelection.js +386 -386
  232. package/services/torrent/download/registry.js +102 -102
  233. package/services/torrent/download/withdraw-claim.js +80 -80
  234. package/services/torrent/files.js +455 -455
  235. package/services/torrent/naming.js +619 -619
  236. package/services/torrent/piece-store-of.js +29 -29
  237. package/services/torrent/supply-margin.js +262 -262
  238. package/services/torrent/torrent-pool.js +2675 -2635
  239. package/services/torrent/torrent-source-key.js +38 -38
  240. package/services/torrent/worker/background-fill.js +213 -213
  241. package/services/torrent/worker/channel.js +271 -271
  242. package/services/torrent/worker/client.js +765 -760
  243. package/services/torrent/worker/fastest-wires.js +342 -342
  244. package/services/torrent/worker/handle-state.js +23 -23
  245. package/services/torrent/worker/held-bytes.js +155 -155
  246. package/services/torrent/worker/install-webrtc-shim.js +32 -32
  247. package/services/torrent/worker/piece-reader.js +1078 -1078
  248. package/services/torrent/worker/pool-adapter.js +365 -350
  249. package/services/torrent/worker/protocol.js +184 -182
  250. package/services/torrent/worker/resume-warm.js +107 -107
  251. package/services/torrent/worker/webrtc-shim.js +219 -219
  252. package/services/torrent/worker/worker.js +1129 -1116
  253. package/services/transport/data-channel-handler.js +1356 -1356
  254. package/services/transport/delivery-probe.js +842 -842
  255. package/services/transport/health-collector.js +53 -53
  256. package/services/transport/nat-classifier.js +231 -231
  257. package/services/transport/packet-witness.js +808 -808
  258. package/services/transport/port-mapper.js +235 -235
  259. package/services/transport/registry-api.js +81 -81
  260. package/services/transport/tunnel-client.js +447 -447
  261. package/services/transport/usrsctp-state.js +175 -175
  262. package/services/transport/webrtc-manager.js +484 -484
  263. package/services/viewer/Assignments.js +340 -340
  264. package/services/viewer/PriorityMap.js +390 -390
  265. package/services/viewer/PriorityOrchestrator.js +325 -325
  266. package/services/viewer/Viewer.js +657 -657
  267. package/services/viewer/Viewers.js +368 -368
  268. package/services/viewer/active-output.js +37 -37
  269. package/services/viewer/audio-start.js +46 -46
  270. package/services/viewer/buffer-trend.js +81 -81
  271. package/services/viewer/choices.js +647 -647
  272. package/services/viewer/positions.js +126 -126
  273. package/services/viewer/report-intake.js +46 -46
  274. package/store/source-registry.js +73 -73
  275. package/test/asset-paths.test.js +28 -28
  276. package/test/audio-inventory.test.js +176 -176
  277. package/test/audio-track-bitrate.test.js +40 -40
  278. package/test/auto-quality-step.test.js +707 -707
  279. package/test/available-share.test.js +76 -76
  280. package/test/background-fill.test.js +190 -190
  281. package/test/client-log-file.test.js +110 -110
  282. package/test/completed-files.test.js +115 -115
  283. package/test/concurrent-cost.test.js +148 -148
  284. package/test/container-media-info.test.js +228 -228
  285. package/test/contention.test.js +76 -76
  286. package/test/core-dumps.test.js +57 -57
  287. package/test/coverage-follows-the-disk.test.js +228 -228
  288. package/test/coverage-map.test.js +195 -195
  289. package/test/cue-push-carries-what-the-walk-found.test.js +58 -58
  290. package/test/cut-times-timeline.test.js +65 -65
  291. package/test/cuts-follow-published-grid.test.js +109 -109
  292. package/test/data-channel-frame.test.js +63 -63
  293. package/test/dead-torrent-handle.test.js +52 -52
  294. package/test/declared-rates.test.js +116 -116
  295. package/test/declared-tracks.test.js +35 -35
  296. package/test/decode-cost-fit.test.js +202 -202
  297. package/test/decode-cost.test.js +462 -462
  298. package/test/delivery-probe.test.js +393 -393
  299. package/test/demand-register.test.js +206 -206
  300. package/test/dht-bootstrap.test.js +72 -72
  301. package/test/drain-threat.test.js +65 -65
  302. package/test/duplicate-add.test.js +48 -48
  303. package/test/encode-admission.test.js +146 -146
  304. package/test/encode-cost.test.js +283 -283
  305. package/test/encode-exit.test.js +111 -111
  306. package/test/encode-orchestrator.test.js +419 -419
  307. package/test/encode-plan-viewers.test.js +718 -718
  308. package/test/encode-plan.test.js +545 -545
  309. package/test/encode-run-state.test.js +314 -314
  310. package/test/encode-run.test.js +161 -161
  311. package/test/encode-slope.test.js +46 -46
  312. package/test/encoded-output.test.js +39 -39
  313. package/test/encoder-kinds.test.js +122 -122
  314. package/test/encoder-readings.test.js +46 -46
  315. package/test/every-claimant-is-told-its-share.test.js +152 -152
  316. package/test/failed-encoder-still-serves-what-exists.test.js +354 -354
  317. package/test/failed-start-breaker.test.js +202 -202
  318. package/test/fastest-wires.test.js +143 -143
  319. package/test/ffmpeg-stream-counts.test.js +78 -78
  320. package/test/file-edges.test.js +191 -191
  321. package/test/fmp4-self-contained.test.js +80 -80
  322. package/test/fmp4-timestamps.test.js +140 -140
  323. package/test/fmp4-track-completeness.test.js +41 -41
  324. package/test/format-keyed-outputs.test.js +78 -78
  325. package/test/health-metrics.test.js +38 -38
  326. package/test/held-request-width.test.js +157 -157
  327. package/test/helpers/encode-run.js +136 -136
  328. package/test/helpers/held-file.js +29 -29
  329. package/test/helpers/manager.js +57 -57
  330. package/test/helpers/output-spec.js +63 -63
  331. package/test/host-load.test.js +68 -68
  332. package/test/index-accuracy-is-about-the-file.test.js +128 -128
  333. package/test/init-compat.test.js +219 -219
  334. package/test/input-lost-quiets-the-plan.test.js +261 -261
  335. package/test/input-unavailable.test.js +48 -48
  336. package/test/installation-id.test.js +39 -39
  337. package/test/keeping-period.test.js +83 -83
  338. package/test/keyframe-index-accuracy.test.js +188 -188
  339. package/test/keyframe-table-budget.test.js +102 -102
  340. package/test/keyframes-belong-to-the-file.test.js +249 -249
  341. package/test/learned-median.test.js +37 -37
  342. package/test/letting-go-asks-who-is-watching.test.js +191 -191
  343. package/test/limit-row-by-area.test.js +60 -60
  344. package/test/link-budget.test.js +111 -111
  345. package/test/link-probe.test.js +56 -56
  346. package/test/local-encoding-data.test.js +273 -273
  347. package/test/logger-repeats.test.js +134 -134
  348. package/test/look-ahead-coverage.test.js +56 -56
  349. package/test/manager-surface.test.js +292 -294
  350. package/test/matroska-cues-track.test.js +192 -192
  351. package/test/memory-budget.test.js +390 -390
  352. package/test/move-cost.test.js +216 -216
  353. package/test/mp4-subtitles.test.js +173 -173
  354. package/test/one-authority.test.js +285 -285
  355. package/test/one-budget.test.js +149 -149
  356. package/test/one-output-one-session.test.js +204 -204
  357. package/test/one-resource-divided.test.js +185 -185
  358. package/test/one-serving-output-per-height.test.js +458 -458
  359. package/test/orchestrator-wired.test.js +206 -206
  360. package/test/output-catalog.test.js +39 -39
  361. package/test/output-shape.test.js +21 -21
  362. package/test/output-spec.test.js +251 -251
  363. package/test/output-speed.test.js +88 -88
  364. package/test/outputs-being-prepared.test.js +40 -40
  365. package/test/packet-witness-ring.test.js +236 -236
  366. package/test/packet-witness.test.js +148 -148
  367. package/test/piece-disk-store.test.js +381 -381
  368. package/test/piece-from-whole-file.test.js +129 -129
  369. package/test/piece-lru.test.js +319 -319
  370. package/test/piece-reader.test.js +162 -162
  371. package/test/piece-selection-offset.test.js +85 -85
  372. package/test/piece-store-eviction.test.js +560 -560
  373. package/test/piece-store-never-refuses.test.js +153 -153
  374. package/test/piece-store-reservations.test.js +318 -318
  375. package/test/piece-store-slow-disk.test.js +159 -159
  376. package/test/piece-tail.test.js +97 -97
  377. package/test/plan-host-timings.test.js +68 -68
  378. package/test/plan-is-steady.test.js +225 -225
  379. package/test/priority-map-download.test.js +174 -174
  380. package/test/priority-map-emptied.test.js +204 -204
  381. package/test/priority-map-per-output.test.js +215 -215
  382. package/test/priority-map.test.js +163 -163
  383. package/test/probe-wedge-certainty.test.js +60 -60
  384. package/test/produced-copy-choice.test.js +213 -213
  385. package/test/published-timeline.test.js +83 -83
  386. package/test/quality-offer.test.js +162 -162
  387. package/test/quality-variants.test.js +1229 -1229
  388. package/test/rate-control-in-the-output.test.js +180 -180
  389. package/test/read-survives-withdrawal.test.js +164 -164
  390. package/test/read-window.test.js +365 -365
  391. package/test/resume-warm.test.js +39 -39
  392. package/test/run-graph-drift.test.js +37 -37
  393. package/test/run-inputs.test.js +80 -80
  394. package/test/run-intervals.test.js +100 -100
  395. package/test/run-position-follows-published-grid.test.js +89 -89
  396. package/test/run-progress.test.js +65 -65
  397. package/test/same-height-switch.test.js +664 -664
  398. package/test/seek-frees-the-viewers-requests.test.js +217 -217
  399. package/test/seek-landing.test.js +109 -109
  400. package/test/seek-target-not-superseded.test.js +195 -195
  401. package/test/segment-closed-on-both-branches.test.js +96 -96
  402. package/test/segment-cut-times.test.js +63 -63
  403. package/test/segment-demand.test.js +80 -80
  404. package/test/segment-hold-supersede.test.js +91 -91
  405. package/test/segment-judged-by-its-own-header.test.js +221 -221
  406. package/test/segment-serve-wiring.test.js +475 -475
  407. package/test/segment-store-eviction.test.js +247 -247
  408. package/test/segment-store.test.js +323 -323
  409. package/test/segment-true-start.test.js +86 -86
  410. package/test/segments-are-shared.test.js +176 -176
  411. package/test/send-chunk-bytes.test.js +86 -86
  412. package/test/serving-existing-output.test.js +102 -102
  413. package/test/serving-output.test.js +102 -102
  414. package/test/shared-piece-store.test.js +310 -310
  415. package/test/sidecar-naming.test.js +142 -142
  416. package/test/source-file.test.js +133 -133
  417. package/test/source-files-route.test.js +103 -103
  418. package/test/split-a-stretch.test.js +139 -139
  419. package/test/stale-request-after-seek.test.js +158 -158
  420. package/test/startup-readings.test.js +124 -124
  421. package/test/stream-route.test.js +182 -182
  422. package/test/subtitle-cue-framing.test.js +200 -200
  423. package/test/subtitle-cue-source.test.js +102 -102
  424. package/test/subtitle-cue-walk.test.js +370 -370
  425. package/test/subtitle-cursor.test.js +63 -63
  426. package/test/subtitle-defaults.test.js +118 -118
  427. package/test/subtitle-language.test.js +252 -252
  428. package/test/subtitle-track-numbering.test.js +386 -386
  429. package/test/supply-margin.test.js +177 -177
  430. package/test/swarm-follows-readers.test.js +174 -174
  431. package/test/swarm-reach.test.js +130 -130
  432. package/test/swarm-selection.test.js +220 -220
  433. package/test/tail-duplication.test.js +167 -167
  434. package/test/the-channel-has-both-ends.test.js +91 -91
  435. package/test/the-torrent-thread-serves-bytes.test.js +107 -107
  436. package/test/thread-pool.test.js +53 -53
  437. package/test/timeline.test.js +84 -84
  438. package/test/torrent-contents.test.js +235 -235
  439. package/test/torrent-cost.test.js +71 -71
  440. package/test/torrent-files.test.js +221 -221
  441. package/test/torrent-naming.test.js +255 -255
  442. package/test/tracks-begin-together.test.js +209 -209
  443. package/test/tunnel-renewal.test.js +167 -167
  444. package/test/two-viewers-one-picture.test.js +407 -407
  445. package/test/upload-hurry.test.js +186 -186
  446. package/test/usrsctp-state.test.js +131 -131
  447. package/test/video-facts.test.js +102 -102
  448. package/test/viewer-assignments.test.js +143 -143
  449. package/test/viewer-outputs.test.js +285 -285
  450. package/test/viewer-presence.test.js +116 -116
  451. package/test/viewer-requests-admission.test.js +89 -89
  452. package/test/viewer-states.test.js +189 -189
  453. package/test/viewer-subtitle-subscription.test.js +96 -96
  454. package/test/viewer.test.js +139 -139
  455. package/test/viewing-generations.test.js +390 -390
  456. package/test/visible-rung.test.js +37 -37
  457. package/test/wait-ledger.test.js +100 -100
  458. package/test/webrtc-shim.test.js +149 -149
  459. package/test/wedge-certainty.test.js +131 -131
  460. package/test/withdraw-piece-claim.test.js +212 -212
  461. package/test/worker-channel.test.js +158 -158
  462. package/utils/client-log-file.js +151 -151
  463. package/utils/logger.js +312 -312
  464. package/utils/parse-range.js +25 -25
  465. package/utils/perf.js +59 -59
@@ -1,209 +1,209 @@
1
- # Передача: клин доставки, стенд и werift — 2026-09-13
2
-
3
- Написано для того, кто продолжит. Всё, что ниже, либо прочитано из журналов и
4
- кода, либо помечено как непроверенное.
5
-
6
- ## 1. Что установила сессия 2026-09-12 (прокси 2.83.5)
7
-
8
- Показ встал на **521,2 с фильма** и не возобновился. Причина — клин доставки,
9
- и он снят на проводе с обеих сторон. Разбор:
10
- `research/delivery-wedge-on-the-wire-2026-09-12.md`.
11
-
12
- Цепочка, каждое звено с числом из журнала:
13
-
14
- 1. 21:50:39.658 — последнее, что браузер получил. Его счётчик канала
15
- `proxy=12112msg/479898176B` не сдвинулся больше ни разу;
16
- 2. прокси продолжал отдавать: `sent=485243979 → 485263428`, очереди
17
- `queued[proxy:0B proxy-control:0B proxy-fast:0B]`, `rtt=24ms`,
18
- `pc=connected ice=completed`. Обратное направление работало весь клин;
19
- 3. через ассоциацию прошло **485 МБ**. Прежние эпизоды: 783, 813, 825, 2294 МБ.
20
- Порога по объёму нет;
21
- 4. обрыв пойман посреди отдачи одного куска: `bytes=10657210 sendMs=360
22
- bufferedAtEnd=0` — usrsctp принял всё, очередь пуста; на проводе за
23
- следующие три секунды ушло 6 727 961 байт (≈63 %), и в середине четвёртой —
24
- ноль, без ретрансмиссий и без утоньшения подтверждений.
25
-
26
- **Лечение было измерено и выброшено.** Браузер поднял вторую ассоциацию к тому
27
- же пиру, прокачал `GET /api/delivery-sink?bytes=4194304` за 140 мс, записал
28
- `the fault is held in the wedged association` — и **закрыл её через 0,45 с**.
29
- Показ остался на мёртвой.
30
-
31
- **Почему зритель сидит навсегда, а не минуту:** лестница пересоединения не
32
- запускается. В клиентском журнале нет ни `transport lost`, ни `reconnect
33
- attempt`, потому что заклинивший канал остаётся `state=connected
34
- ice=connected`, и объявлять его потерянным нечему. В тот же вечер в 20:03 на
35
- ЗАКРЫТОМ канале та же лестница отработала штатно.
36
-
37
- ## 2. Две поправки к роадмапу, сделанные чтением кода
38
-
39
- 1. **`waitForBufferDrain` УЖЕ починен** (`services/data-channel-handler.js:1199`,
40
- выпущено в 2.80.6): он ждёт нижней отметки с опросом каждые 50 мс,
41
- постоянная `DC_BUFFER_DRAIN_TIMEOUT_MS` удалена. Запись в роадмапе
42
- («fails open», 2026-09-06) устарела.
43
- 2. **И он всё равно не защищает.** В поле 2026-09-12 `bufferedAtEnd=0` и
44
- `drainMs=0` на каждой строке: наша очередь пуста, потому что libdatachannel
45
- отдал байты в usrsctp, а держит их usrsctp. `bufferedAmount()` слеп к этому
46
- по построению — прокси отдал 10,6 МБ в тишину и не узнал.
47
-
48
- **Что на месте этого предложено и НЕ построено:** backpressure по тому, что
49
- зритель ПОДТВЕРДИЛ. Браузер уже сообщает счётчики каждого канала
50
- (`proxy=12112msg/479898176B` в строке `[dc-far]`, раз в 500 мс). Отправка
51
- сверяется с ними, а не только с `bufferedAmount()`. Порог не выбирать — вывести
52
- из того, сколько байт эта связь держит в полёте при здоровой работе.
53
-
54
- ## 3. Обновление зависимости — проверено, не лечит
55
-
56
- Пин `^0.32.0`, в npm **0.33.4**. Внутри libdatachannel 0.24.2 → 0.24.5.
57
- Подмодуль usrsctp сверен по четырём тегам (v0.24.2, .3, .4, .5):
58
- `fec583d54493f879d2ae44a743423bf8a04371ab` во всех. **От клина не лечит.**
59
- Запись роадмапа «upstream fix waiting нет» была верна на 26.08; теперь
60
- перепроверена и по-прежнему верна по существу, но libdatachannel ушёл вперёд
61
- на три версии (там исправление прерывистых отказов DTLS-рукопожатия).
62
-
63
- ## 4. werift — исследовано, читая сам пакет
64
-
65
- werift 0.24.4, MIT, обновлён 2026-08-10, один автор. 4,2 МБ, 9 зависимостей.
66
- `ice/`, `dtls/`, `sctp/`, `rtp/`, `webrtc/` — полная реализация на TypeScript.
67
-
68
- **За:**
69
- 1. usrsctp исчезает целиком, а с ним и подозреваемый;
70
- 2. ни одной нативной зависимости (`@noble/curves`, `tweetnacl`,
71
- `@peculiar/x509` — чистый JS). Ни prebuilt, ни musl/aarch64, ни сборки в
72
- дополнении. Для проекта с одним форком нативного модуля и девятью смертями
73
- процесса это существенно;
74
- 3. `bufferedAmount`, `bufferedAmountLow`, `bufferedAmountLowThreshold` есть —
75
- наш backpressure переносится.
76
-
77
- **Против:**
78
- 1. **Мультиплексирования одного UDP-порта нет.** `lib/common/src/transport.js:130`
79
- создаёт `dgram.createSocket` на соединение; `icePortRange` — диапазон, а не
80
- общий сокет. У нас `IceUdpMuxListener` держит один порт 9090 на все сессии,
81
- и ровно он замаплен UPnP — шаг 3 удалённого доступа (2.9.18). На werift
82
- каждая сессия берёт свой порт, которого в маппинге нет;
83
- 2. **Цена в процессоре не измерена и может быть запретительной.**
84
- `lib/sctp/src/sctp.js:16` — `USERDATA_MAX_LENGTH = 1200`. Сообщение в 65 КБ
85
- режется на 55 SCTP-кусков, каждый собирается в JS, CRC32c через
86
- `Buffer.concat` на пакет (`chunk.js:763`), поверх — DTLS-шифрование на JS.
87
- При 8 Мбит/с ≈830 пакетов/с; на измеренных 24.08 пиках 150-330 Мбит/с —
88
- за 30 000/с. На CM4, который кодирует 1080p на 1,96x.
89
-
90
- **Вывод:** werift снимает подозреваемого и платит сломанным единым портом и
91
- неизвестной производительностью. Назвать его решением до замера нельзя.
92
- Замер дешёвый: поднять werift-приёмник, прокачать гигабайт, сравнить загрузку
93
- процессора с сегодняшней.
94
-
95
- ## 5. Стенд — построен наполовину, упёрся в выбор прокси
96
-
97
- Цель: измерить, ЗАВИСИТ ЛИ КЛИН ОТ РАЗМЕРА ПОРЦИИ. Это гейт на всё остальное,
98
- и он не снят ни разу — стенд 26.08 прокачал 1,0 ГБ без отказов, но его
99
- приёмник был libdatachannel, а нужен dcSCTP браузера.
100
-
101
- **Что работает:** `chrome-devtools` MCP подключён к Chrome 155 на 9222
102
- (`list_pages` отвечает). Локальный прокси поднимается и регистрируется:
103
-
104
- ```
105
- node bin/cli.js --server-url https://webauth.courses --port 9091 \
106
- --delivery-sink --name wedge-stand --log-file <path>
107
- ```
108
-
109
- **Что мешает:** браузер его не выбирает. Дважды подряд, включая после
110
- перезагрузки страницы:
111
-
112
- ```
113
- selectedId: f3013ad3 (полевой, хост дополнения)
114
- candidates: wedge-stand score=0.6075, proxy-f3013ad3 score=0.4466
115
- ```
116
-
117
- Стенд имеет ЛУЧШИЙ счёт и не выбран. Отличие одно: `reachable: false` —
118
- сервер дозванивается снаружи и до машины разработчика не достаёт. Значит
119
- нагрузка пошла бы на рабочий узел, чего делать нельзя.
120
-
121
- **Два выхода, решение за пользователем:** сделать стенд достижимым (проброс
122
- порта) или добавить способ назначить прокси явно (правка продукта ради
123
- стенда).
124
-
125
- **Оговорка, которую надо держать при любом прогоне:** клин наступал при 485,
126
- 783, 813, 825 и 2294 МБ — разброс впятеро. Одна прогонка на значение не
127
- докажет ничего; нужно по нескольку, и это часы прокачки. Если разброс внутри
128
- одного размера порции останется таким же, честный ответ — «не установлено», а
129
- не число.
130
-
131
- **Механика автономного прогона, продуманная и не построенная:** фоновый
132
- процесс через `run_in_background`; цикл в странице ставится ОДНИМ вызовом
133
- `evaluate_script` и дальше живёт сам; результат выходит через `client-logger`
134
- на сервер, а не через канал данных, — этот путь HTTP и переживает клин, чего
135
- сегодня не хватило (пункт 85: браузер замолчал ровно на клине).
136
-
137
- ## 6. Что делать дальше, по порядку
138
-
139
- 1. снять препятствие со стендом и взять замер размера порции — это гейт;
140
- 2. backpressure по подтверждённому зрителем (§2), целиком наш код;
141
- 3. замер werift на процессоре, если §1 не даст ответа;
142
- 4. сообщить наверх: у нас есть то, чего нет ни у кого — два захвата с обеих
143
- сторон и доказательство, что вторая ассоциация к тому же пиру работает в ту
144
- же секунду. Ни в libdatachannel, ни в usrsctp вопрос не открыт.
145
-
146
- **Чего делать НЕ надо:** прямой HTTPS (шаги 6-7) как ответ на этот клин.
147
- Сказано пользователем 2026-09-12: это не решение проблемы.
148
-
149
- ## 7. Что осталось незакрытым от прошлых сессий и всплыло сегодня
150
-
151
- 1. ложное срабатывание 21:13:34 при 76 МБ прокачанных — 180 с захвата и файлы
152
- кольца на показ, который шёл дальше ещё 37 минут;
153
- 2. `--delivery-sink` включён на полевом прокси. Он отдаёт ответ любого размера
154
- и существует только для стенда.
155
-
156
- ## 8. СОСТОЯНИЕ НА КОНЕЦ 2026-09-12: дополнение ОСТАНОВЛЕНО, на его месте стенд
157
-
158
- **Смотреть нельзя, пока это не свёрнуто.** Дополнение остановлено намеренно
159
- (`ha apps stop b34a1737_torrent_tv_proxy`), и его место на порту 9090 занял
160
- контейнер `ttv-wedge-stand`, запущенный из того же образа
161
- (`b34a1737/aarch64-addon-torrent_tv_proxy:0.74.4`) с пропатченными
162
- `services/data-channel-handler.js` и `bin/cli.js`.
163
-
164
- **Свернуть:**
165
-
166
- ```
167
- ssh ha 'sudo docker rm -f ttv-wedge-stand'
168
- ssh ha 'sudo docker exec hassio_cli ha apps start b34a1737_torrent_tv_proxy'
169
- ```
170
-
171
- **Почему свой контейнер, а не правка живого.** Пробовал патчить контейнер
172
- дополнения — не выживает: `ha apps restart` пересоздаёт его из образа, а
173
- убийство процесса внутри поднимает watchdog, который тоже пересоздаёт. Дважды
174
- проверено по дате создания контейнера. Свой контейнер watchdog не трогает.
175
-
176
- **Что построено в продукте** (в npm НЕ опубликовано, в git НЕ закоммичено):
177
- `--send-chunk-bytes <N>` — размер одного сообщения канала данных;
178
- `bodySender` — чистая функция нарезки и склейки, восемь проверок
179
- (`test/send-chunk-bytes.test.js`), одна проверена на красноту поломкой склейки
180
- через границу чтения; `msgBytes=` в строке `[net-debug]`; `chunks=` теперь
181
- считает сообщения, а не чтения тела. Запись в CHANGELOG на 2.83.7.
182
-
183
- **Как сменить размер** (стенд перезапускается изнутри своего контейнера):
184
-
185
- ```
186
- ssh ha 'sudo docker exec ttv-wedge-stand pkill -f cli.js'
187
- ssh ha 'sudo docker exec -d ttv-wedge-stand sh -c "node /usr/local/lib/node_modules/@torrent-tv/proxy/bin/cli.js --server-url https://webauth.courses --host 0.0.0.0 --port 9090 --ffmpeg-bin /usr/bin/ffmpeg --state-dir /standdata --delivery-sink --send-chunk-bytes 16384 --name wedge-stand > /standdata/stand.log 2>&1"'
188
- ```
189
-
190
- **Нагрузка** ставится одним вызовом `evaluate_script` в открытой на
191
- `webauth.courses` вкладке Chrome (9222, chrome-devtools MCP): цикл поднимает
192
- СВОЁ соединение `new WebRtcProxy(id)` — рабочее соединение страницы не
193
- трогается, — тянет `GET /api/delivery-sink?bytes=4194304` подряд и пишет отчёты
194
- через `POST /api/client-logs`, то есть по HTTP, мимо заклинивающего канала.
195
- Состояние лежит в `window.__WEDGE_STAND__`, остановка — `.stopped = true`.
196
-
197
- **Читать результат:**
198
-
199
- ```
200
- ssh do 'docker logs --tail 400 infra-server-1' | grep wedge-stand
201
- ssh ha 'sudo docker exec ttv-wedge-stand grep msgBytes /standdata/stand.log | tail -5'
202
- ```
203
-
204
- **Ловушка, стоившая одного прогона:** локальный стенд на машине разработчика
205
- назывался тем же именем `wedge-stand`, и цикл подключился к нему вместо ХА.
206
- Целиться по id, не по имени. Локальный остановлен.
207
-
208
- **Опорный прогон запущен 2026-09-12 23:36 UTC** на `f312d1e6`, размер `asread`
209
- (65 382 байта), 4 МБ на запрос, 190-325 Мбит/с. Результата на момент записи нет.
1
+ # Передача: клин доставки, стенд и werift — 2026-09-13
2
+
3
+ Написано для того, кто продолжит. Всё, что ниже, либо прочитано из журналов и
4
+ кода, либо помечено как непроверенное.
5
+
6
+ ## 1. Что установила сессия 2026-09-12 (прокси 2.83.5)
7
+
8
+ Показ встал на **521,2 с фильма** и не возобновился. Причина — клин доставки,
9
+ и он снят на проводе с обеих сторон. Разбор:
10
+ `research/delivery-wedge-on-the-wire-2026-09-12.md`.
11
+
12
+ Цепочка, каждое звено с числом из журнала:
13
+
14
+ 1. 21:50:39.658 — последнее, что браузер получил. Его счётчик канала
15
+ `proxy=12112msg/479898176B` не сдвинулся больше ни разу;
16
+ 2. прокси продолжал отдавать: `sent=485243979 → 485263428`, очереди
17
+ `queued[proxy:0B proxy-control:0B proxy-fast:0B]`, `rtt=24ms`,
18
+ `pc=connected ice=completed`. Обратное направление работало весь клин;
19
+ 3. через ассоциацию прошло **485 МБ**. Прежние эпизоды: 783, 813, 825, 2294 МБ.
20
+ Порога по объёму нет;
21
+ 4. обрыв пойман посреди отдачи одного куска: `bytes=10657210 sendMs=360
22
+ bufferedAtEnd=0` — usrsctp принял всё, очередь пуста; на проводе за
23
+ следующие три секунды ушло 6 727 961 байт (≈63 %), и в середине четвёртой —
24
+ ноль, без ретрансмиссий и без утоньшения подтверждений.
25
+
26
+ **Лечение было измерено и выброшено.** Браузер поднял вторую ассоциацию к тому
27
+ же пиру, прокачал `GET /api/delivery-sink?bytes=4194304` за 140 мс, записал
28
+ `the fault is held in the wedged association` — и **закрыл её через 0,45 с**.
29
+ Показ остался на мёртвой.
30
+
31
+ **Почему зритель сидит навсегда, а не минуту:** лестница пересоединения не
32
+ запускается. В клиентском журнале нет ни `transport lost`, ни `reconnect
33
+ attempt`, потому что заклинивший канал остаётся `state=connected
34
+ ice=connected`, и объявлять его потерянным нечему. В тот же вечер в 20:03 на
35
+ ЗАКРЫТОМ канале та же лестница отработала штатно.
36
+
37
+ ## 2. Две поправки к роадмапу, сделанные чтением кода
38
+
39
+ 1. **`waitForBufferDrain` УЖЕ починен** (`services/data-channel-handler.js:1199`,
40
+ выпущено в 2.80.6): он ждёт нижней отметки с опросом каждые 50 мс,
41
+ постоянная `DC_BUFFER_DRAIN_TIMEOUT_MS` удалена. Запись в роадмапе
42
+ («fails open», 2026-09-06) устарела.
43
+ 2. **И он всё равно не защищает.** В поле 2026-09-12 `bufferedAtEnd=0` и
44
+ `drainMs=0` на каждой строке: наша очередь пуста, потому что libdatachannel
45
+ отдал байты в usrsctp, а держит их usrsctp. `bufferedAmount()` слеп к этому
46
+ по построению — прокси отдал 10,6 МБ в тишину и не узнал.
47
+
48
+ **Что на месте этого предложено и НЕ построено:** backpressure по тому, что
49
+ зритель ПОДТВЕРДИЛ. Браузер уже сообщает счётчики каждого канала
50
+ (`proxy=12112msg/479898176B` в строке `[dc-far]`, раз в 500 мс). Отправка
51
+ сверяется с ними, а не только с `bufferedAmount()`. Порог не выбирать — вывести
52
+ из того, сколько байт эта связь держит в полёте при здоровой работе.
53
+
54
+ ## 3. Обновление зависимости — проверено, не лечит
55
+
56
+ Пин `^0.32.0`, в npm **0.33.4**. Внутри libdatachannel 0.24.2 → 0.24.5.
57
+ Подмодуль usrsctp сверен по четырём тегам (v0.24.2, .3, .4, .5):
58
+ `fec583d54493f879d2ae44a743423bf8a04371ab` во всех. **От клина не лечит.**
59
+ Запись роадмапа «upstream fix waiting нет» была верна на 26.08; теперь
60
+ перепроверена и по-прежнему верна по существу, но libdatachannel ушёл вперёд
61
+ на три версии (там исправление прерывистых отказов DTLS-рукопожатия).
62
+
63
+ ## 4. werift — исследовано, читая сам пакет
64
+
65
+ werift 0.24.4, MIT, обновлён 2026-08-10, один автор. 4,2 МБ, 9 зависимостей.
66
+ `ice/`, `dtls/`, `sctp/`, `rtp/`, `webrtc/` — полная реализация на TypeScript.
67
+
68
+ **За:**
69
+ 1. usrsctp исчезает целиком, а с ним и подозреваемый;
70
+ 2. ни одной нативной зависимости (`@noble/curves`, `tweetnacl`,
71
+ `@peculiar/x509` — чистый JS). Ни prebuilt, ни musl/aarch64, ни сборки в
72
+ дополнении. Для проекта с одним форком нативного модуля и девятью смертями
73
+ процесса это существенно;
74
+ 3. `bufferedAmount`, `bufferedAmountLow`, `bufferedAmountLowThreshold` есть —
75
+ наш backpressure переносится.
76
+
77
+ **Против:**
78
+ 1. **Мультиплексирования одного UDP-порта нет.** `lib/common/src/transport.js:130`
79
+ создаёт `dgram.createSocket` на соединение; `icePortRange` — диапазон, а не
80
+ общий сокет. У нас `IceUdpMuxListener` держит один порт 9090 на все сессии,
81
+ и ровно он замаплен UPnP — шаг 3 удалённого доступа (2.9.18). На werift
82
+ каждая сессия берёт свой порт, которого в маппинге нет;
83
+ 2. **Цена в процессоре не измерена и может быть запретительной.**
84
+ `lib/sctp/src/sctp.js:16` — `USERDATA_MAX_LENGTH = 1200`. Сообщение в 65 КБ
85
+ режется на 55 SCTP-кусков, каждый собирается в JS, CRC32c через
86
+ `Buffer.concat` на пакет (`chunk.js:763`), поверх — DTLS-шифрование на JS.
87
+ При 8 Мбит/с ≈830 пакетов/с; на измеренных 24.08 пиках 150-330 Мбит/с —
88
+ за 30 000/с. На CM4, который кодирует 1080p на 1,96x.
89
+
90
+ **Вывод:** werift снимает подозреваемого и платит сломанным единым портом и
91
+ неизвестной производительностью. Назвать его решением до замера нельзя.
92
+ Замер дешёвый: поднять werift-приёмник, прокачать гигабайт, сравнить загрузку
93
+ процессора с сегодняшней.
94
+
95
+ ## 5. Стенд — построен наполовину, упёрся в выбор прокси
96
+
97
+ Цель: измерить, ЗАВИСИТ ЛИ КЛИН ОТ РАЗМЕРА ПОРЦИИ. Это гейт на всё остальное,
98
+ и он не снят ни разу — стенд 26.08 прокачал 1,0 ГБ без отказов, но его
99
+ приёмник был libdatachannel, а нужен dcSCTP браузера.
100
+
101
+ **Что работает:** `chrome-devtools` MCP подключён к Chrome 155 на 9222
102
+ (`list_pages` отвечает). Локальный прокси поднимается и регистрируется:
103
+
104
+ ```
105
+ node bin/cli.js --server-url https://webauth.courses --port 9091 \
106
+ --delivery-sink --name wedge-stand --log-file <path>
107
+ ```
108
+
109
+ **Что мешает:** браузер его не выбирает. Дважды подряд, включая после
110
+ перезагрузки страницы:
111
+
112
+ ```
113
+ selectedId: f3013ad3 (полевой, хост дополнения)
114
+ candidates: wedge-stand score=0.6075, proxy-f3013ad3 score=0.4466
115
+ ```
116
+
117
+ Стенд имеет ЛУЧШИЙ счёт и не выбран. Отличие одно: `reachable: false` —
118
+ сервер дозванивается снаружи и до машины разработчика не достаёт. Значит
119
+ нагрузка пошла бы на рабочий узел, чего делать нельзя.
120
+
121
+ **Два выхода, решение за пользователем:** сделать стенд достижимым (проброс
122
+ порта) или добавить способ назначить прокси явно (правка продукта ради
123
+ стенда).
124
+
125
+ **Оговорка, которую надо держать при любом прогоне:** клин наступал при 485,
126
+ 783, 813, 825 и 2294 МБ — разброс впятеро. Одна прогонка на значение не
127
+ докажет ничего; нужно по нескольку, и это часы прокачки. Если разброс внутри
128
+ одного размера порции останется таким же, честный ответ — «не установлено», а
129
+ не число.
130
+
131
+ **Механика автономного прогона, продуманная и не построенная:** фоновый
132
+ процесс через `run_in_background`; цикл в странице ставится ОДНИМ вызовом
133
+ `evaluate_script` и дальше живёт сам; результат выходит через `client-logger`
134
+ на сервер, а не через канал данных, — этот путь HTTP и переживает клин, чего
135
+ сегодня не хватило (пункт 85: браузер замолчал ровно на клине).
136
+
137
+ ## 6. Что делать дальше, по порядку
138
+
139
+ 1. снять препятствие со стендом и взять замер размера порции — это гейт;
140
+ 2. backpressure по подтверждённому зрителем (§2), целиком наш код;
141
+ 3. замер werift на процессоре, если §1 не даст ответа;
142
+ 4. сообщить наверх: у нас есть то, чего нет ни у кого — два захвата с обеих
143
+ сторон и доказательство, что вторая ассоциация к тому же пиру работает в ту
144
+ же секунду. Ни в libdatachannel, ни в usrsctp вопрос не открыт.
145
+
146
+ **Чего делать НЕ надо:** прямой HTTPS (шаги 6-7) как ответ на этот клин.
147
+ Сказано пользователем 2026-09-12: это не решение проблемы.
148
+
149
+ ## 7. Что осталось незакрытым от прошлых сессий и всплыло сегодня
150
+
151
+ 1. ложное срабатывание 21:13:34 при 76 МБ прокачанных — 180 с захвата и файлы
152
+ кольца на показ, который шёл дальше ещё 37 минут;
153
+ 2. `--delivery-sink` включён на полевом прокси. Он отдаёт ответ любого размера
154
+ и существует только для стенда.
155
+
156
+ ## 8. СОСТОЯНИЕ НА КОНЕЦ 2026-09-12: дополнение ОСТАНОВЛЕНО, на его месте стенд
157
+
158
+ **Смотреть нельзя, пока это не свёрнуто.** Дополнение остановлено намеренно
159
+ (`ha apps stop b34a1737_torrent_tv_proxy`), и его место на порту 9090 занял
160
+ контейнер `ttv-wedge-stand`, запущенный из того же образа
161
+ (`b34a1737/aarch64-addon-torrent_tv_proxy:0.74.4`) с пропатченными
162
+ `services/data-channel-handler.js` и `bin/cli.js`.
163
+
164
+ **Свернуть:**
165
+
166
+ ```
167
+ ssh ha 'sudo docker rm -f ttv-wedge-stand'
168
+ ssh ha 'sudo docker exec hassio_cli ha apps start b34a1737_torrent_tv_proxy'
169
+ ```
170
+
171
+ **Почему свой контейнер, а не правка живого.** Пробовал патчить контейнер
172
+ дополнения — не выживает: `ha apps restart` пересоздаёт его из образа, а
173
+ убийство процесса внутри поднимает watchdog, который тоже пересоздаёт. Дважды
174
+ проверено по дате создания контейнера. Свой контейнер watchdog не трогает.
175
+
176
+ **Что построено в продукте** (в npm НЕ опубликовано, в git НЕ закоммичено):
177
+ `--send-chunk-bytes <N>` — размер одного сообщения канала данных;
178
+ `bodySender` — чистая функция нарезки и склейки, восемь проверок
179
+ (`test/send-chunk-bytes.test.js`), одна проверена на красноту поломкой склейки
180
+ через границу чтения; `msgBytes=` в строке `[net-debug]`; `chunks=` теперь
181
+ считает сообщения, а не чтения тела. Запись в CHANGELOG на 2.83.7.
182
+
183
+ **Как сменить размер** (стенд перезапускается изнутри своего контейнера):
184
+
185
+ ```
186
+ ssh ha 'sudo docker exec ttv-wedge-stand pkill -f cli.js'
187
+ ssh ha 'sudo docker exec -d ttv-wedge-stand sh -c "node /usr/local/lib/node_modules/@torrent-tv/proxy/bin/cli.js --server-url https://webauth.courses --host 0.0.0.0 --port 9090 --ffmpeg-bin /usr/bin/ffmpeg --state-dir /standdata --delivery-sink --send-chunk-bytes 16384 --name wedge-stand > /standdata/stand.log 2>&1"'
188
+ ```
189
+
190
+ **Нагрузка** ставится одним вызовом `evaluate_script` в открытой на
191
+ `webauth.courses` вкладке Chrome (9222, chrome-devtools MCP): цикл поднимает
192
+ СВОЁ соединение `new WebRtcProxy(id)` — рабочее соединение страницы не
193
+ трогается, — тянет `GET /api/delivery-sink?bytes=4194304` подряд и пишет отчёты
194
+ через `POST /api/client-logs`, то есть по HTTP, мимо заклинивающего канала.
195
+ Состояние лежит в `window.__WEDGE_STAND__`, остановка — `.stopped = true`.
196
+
197
+ **Читать результат:**
198
+
199
+ ```
200
+ ssh do 'docker logs --tail 400 infra-server-1' | grep wedge-stand
201
+ ssh ha 'sudo docker exec ttv-wedge-stand grep msgBytes /standdata/stand.log | tail -5'
202
+ ```
203
+
204
+ **Ловушка, стоившая одного прогона:** локальный стенд на машине разработчика
205
+ назывался тем же именем `wedge-stand`, и цикл подключился к нему вместо ХА.
206
+ Целиться по id, не по имени. Локальный остановлен.
207
+
208
+ **Опорный прогон запущен 2026-09-12 23:36 UTC** на `f312d1e6`, размер `asread`
209
+ (65 382 байта), 4 МБ на запрос, 190-325 Мбит/с. Результата на момент записи нет.