docs: regenerate HTML/WASM docs with video vs clip comparison + timestamps

docs_v1.0/doc/01_auth.html

@@ -389,6 +389,8 @@ curl<span class="w"> </span>-s<span class="w"> </span>-o<span class="w"> </span>
 <li><code>POST /api/v1/resource/tmdb/check</code> — test authentication + TMDb API connectivity</li>
 <li><code>GET /health/detailed</code> — view auth status (integrations section)</li>
 </ul>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/02_health.html

@@ -339,6 +339,8 @@ a { color: #0066cc; }
 </tr>
 </tbody>
 </table>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/03_register.html

@@ -446,6 +446,8 @@ curl<span class="w"> </span>-s<span class="w"> </span><span class="s2">&quot;</s
 </tr>
 </tbody>
 </table>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/04_lookup.html

@@ -292,6 +292,8 @@ curl<span class="w"> </span>-s<span class="w"> </span>-X<span class="w"> </span>
 </tr>
 </tbody>
 </table>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/05_process.html

@@ -506,6 +506,8 @@ curl<span class="w"> </span>-s<span class="w"> </span>-X<span class="w"> </span>
 </tr>
 </tbody>
 </table>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/06_search.html

@@ -281,6 +281,8 @@ a { color: #0066cc; }
 </tr>
 </tbody>
 </table>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/07_identity.html

@@ -511,6 +511,8 @@ a { color: #0066cc; }
 </tr>
 </tbody>
 </table>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/08_identity_agent.html

@@ -98,6 +98,9 @@ a { color: #0066cc; }
 <span class="w">  </span>-H<span class="w"> </span><span class="s2">&quot;Content-Type: application/json&quot;</span><span class="w"> </span><span class="se">\</span>
 <span class="w">  </span>-d<span class="w"> </span><span class="s1">&#39;{&quot;file_uuid&quot;: &quot;&#39;</span><span class="s2">&quot;</span><span class="nv">$FILE_UUID</span><span class="s2">&quot;</span><span class="s1">&#39;&quot;, &quot;trace_id&quot;: 10}&#39;</span>
 </code></pre></div>
+
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/08_media.html

@@ -273,6 +273,95 @@ curl<span class="w"> </span>-s<span class="w"> </span><span class="s2">&quot;</s
 </tr>
 </tbody>
 </table>
+<h3>Video vs Clip: Quality &amp; Format Comparison</h3>
+<p>Both endpoints support time range extraction, but serve different use cases:</p>
+<table class="table">
+<thead>
+<tr>
+<th>Feature</th>
+<th><code>/video</code></th>
+<th><code>/clip</code></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>No params</strong></td>
+<td>Streams full file (Range seek)</td>
+<td>Returns 400 (params required)</td>
+</tr>
+<tr>
+<td><strong>HTTP Range</strong></td>
+<td>✅ Supported</td>
+<td>❌ Not supported</td>
+</tr>
+<tr>
+<td><strong>Encoding</strong></td>
+<td><code>-c copy</code> (zero encoding)</td>
+<td><code>-c:v libx264 -c:a aac</code> (re-encode)</td>
+</tr>
+<tr>
+<td><strong>Quality</strong></td>
+<td>Original (bit-exact, zero loss)</td>
+<td>Compressed (default CRF ≈ 23)</td>
+</tr>
+<tr>
+<td><strong>Format</strong></td>
+<td><code>video/mp4</code></td>
+<td><code>video/mp2t</code> (MPEG-TS)</td>
+</tr>
+<tr>
+<td><strong>Speed</strong></td>
+<td>Fast (no computation)</td>
+<td>Slower (encoding required)</td>
+</tr>
+<tr>
+<td><strong>Frame control</strong></td>
+<td>Time-based (<code>dur = (ef-sf)/fps</code>)</td>
+<td>Precise (<code>-vframes</code>)</td>
+</tr>
+<tr>
+<td><strong>Debug mode</strong></td>
+<td>❌</td>
+<td>✅ <code>mode=debug</code> overlay</td>
+</tr>
+<tr>
+<td><strong>Cache</strong></td>
+<td>❌</td>
+<td>✅ <code>max-age=86400</code></td>
+</tr>
+</tbody>
+</table>
+<h4>Usage Recommendation</h4>
+<table class="table">
+<thead>
+<tr>
+<th>Scenario</th>
+<th>Use</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>Full video streaming / player seek</td>
+<td><code>/video</code></td>
+</tr>
+<tr>
+<td>Quick preview clip (zero quality loss)</td>
+<td><code>/video?start_frame=...&amp;end_frame=...</code></td>
+</tr>
+<tr>
+<td>Debug frame verification / text overlay</td>
+<td><code>/clip?mode=debug</code></td>
+</tr>
+<tr>
+<td>Precise frame count control</td>
+<td><code>/clip</code></td>
+</tr>
+<tr>
+<td>CDN cacheable clip</td>
+<td><code>/clip</code></td>
+</tr>
+</tbody>
+</table>
 <hr />
 <table class="table">
 <thead>
@@ -304,6 +393,8 @@ curl<span class="w"> </span>-s<span class="w"> </span><span class="s2">&quot;</s
 </tr>
 </tbody>
 </table>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/09_tmdb.html

@@ -124,6 +124,9 @@ If local files exist, no external API call is made. Internet is only needed for
 <span class="w">  </span><span class="nt">&quot;api_latency_ms&quot;</span><span class="p">:</span><span class="w"> </span><span class="mi">120</span>
 <span class="p">}</span>
 </code></pre></div>
+
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/10_pipeline.html

@@ -338,6 +338,8 @@ a { color: #0066cc; }
 </tr>
 </tbody>
 </table>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/12_agent.html

@@ -208,6 +208,8 @@ a { color: #0066cc; }
 </tr>
 </tbody>
 </table>
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>

docs_v1.0/doc/13_config.html

@@ -138,6 +138,9 @@ curl<span class="w"> </span>-s<span class="w"> </span>-X<span class="w"> </span>
 <span class="w">  </span>-H<span class="w"> </span><span class="s2">&quot;X-API-Key: </span><span class="nv">$KEY</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
 <span class="w">  </span>-d<span class="w"> </span><span class="s1">&#39;{&quot;enabled&quot;: true}&#39;</span>
 </code></pre></div>
+
+<hr />
+<p><em>Updated: 2026-05-19 12:49:24</em></p>
 </div>
 </body>
 </html>