feat: add app-owned YouTube subtitle flow with absPlayer-style parsing (#31)

* fix: harden preload argv parsing for popup windows * fix: align youtube playback with shared overlay startup * fix: unwrap mpv youtube streams for anki media mining * docs: update docs for youtube subtitle and mining flow * refactor: unify cli and runtime wiring for startup and youtube flow * feat: update subtitle sidebar overlay behavior * chore: add shared log-file source for diagnostics * fix(ci): add changelog fragment for immersion changes * fix: address CodeRabbit review feedback * fix: persist canonical title from youtube metadata * style: format stats library tab * fix: address latest review feedback * style: format stats library files * test: stub launcher youtube deps in CI * test: isolate launcher youtube flow deps * test: stub launcher youtube deps in failing case * test: force x11 backend in launcher ci harness * test: address latest review feedback * fix(launcher): preserve user YouTube ytdl raw options * docs(backlog): update task tracking notes * fix(immersion): special-case youtube media paths in runtime and tracking * feat(stats): improve YouTube media metadata and picker key handling * fix(ci): format stats media library hook * fix: address latest CodeRabbit review items * docs: update youtube release notes and docs * feat: auto-load youtube subtitles before manual picker * fix: restore app-owned youtube subtitle flow * docs: update youtube playback docs and config copy * refactor: remove legacy youtube launcher mode plumbing * fix: refine youtube subtitle startup binding * docs: clarify youtube subtitle startup behavior * fix: address PR #31 latest review follow-ups * fix: address PR #31 follow-up review comments * test: harden youtube picker test harness * udpate backlog * fix: add timeout to youtube metadata probe * docs: refresh youtube and stats docs * update backlog * update backlog * chore: release v0.9.0
2026-07-27 16:49:51 -07:00 · 2026-03-24 00:01:24 -07:00
parent c17f0a4080
commit 5feed360ca
219 changed files with 12778 additions and 1052 deletions
@@ -0,0 +1,67 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import {
+  appendLogLine,
+  pruneLogFiles,
+  resolveDefaultLogFilePath,
+} from './log-files';
+
+test('resolveDefaultLogFilePath uses app prefix by default', () => {
+  const now = new Date('2026-03-22T12:00:00.000Z');
+  const resolved = resolveDefaultLogFilePath('app', {
+    platform: 'linux',
+    homeDir: '/home/tester',
+    now,
+  });
+
+  assert.equal(
+    resolved,
+    path.join(
+      '/home/tester',
+      '.config',
+      'SubMiner',
+      'logs',
+      `app-${now.toISOString().slice(0, 10)}.log`,
+    ),
+  );
+});
+
+test('pruneLogFiles removes logs older than retention window', () => {
+  const logsDir = fs.mkdtempSync(path.join(os.tmpdir(), 'subminer-log-prune-'));
+  const stalePath = path.join(logsDir, 'app-old.log');
+  const freshPath = path.join(logsDir, 'app-fresh.log');
+  fs.writeFileSync(stalePath, 'stale\n', 'utf8');
+  fs.writeFileSync(freshPath, 'fresh\n', 'utf8');
+  const now = new Date('2026-03-22T12:00:00.000Z');
+  fs.utimesSync(stalePath, new Date('2026-03-01T12:00:00.000Z'), new Date('2026-03-01T12:00:00.000Z'));
+  fs.utimesSync(freshPath, new Date('2026-03-21T12:00:00.000Z'), new Date('2026-03-21T12:00:00.000Z'));
+
+  try {
+    pruneLogFiles(logsDir, { retentionDays: 7, now });
+
+    assert.equal(fs.existsSync(stalePath), false);
+    assert.equal(fs.existsSync(freshPath), true);
+  } finally {
+    fs.rmSync(logsDir, { recursive: true, force: true });
+  }
+});
+
+test('appendLogLine trims oversized logs to newest bytes', () => {
+  const logsDir = fs.mkdtempSync(path.join(os.tmpdir(), 'subminer-log-trim-'));
+  const logPath = path.join(logsDir, 'app.log');
+
+  try {
+    appendLogLine(logPath, '012345678901234567890123456789', { maxBytes: 48, retentionDays: 30 });
+    appendLogLine(logPath, 'abcdefghijabcdefghijabcdefghij', { maxBytes: 48, retentionDays: 30 });
+
+    const content = fs.readFileSync(logPath, 'utf8');
+    assert.match(content, /\[truncated older log content\]/);
+    assert.match(content, /abcdefghij/);
+    assert.ok(Buffer.byteLength(content) <= 48);
+  } finally {
+    fs.rmSync(logsDir, { recursive: true, force: true });
+  }
+});