Consolidate MangaCircus app, scraper, and Compose baseline

sentinel/test/monitor.test.js

@@ -0,0 +1,26 @@
+'use strict';
+const test = require('node:test'), assert = require('node:assert/strict');
+const { Monitor } = require('../monitor');
+test('Sentinel does not disturb progressing or deliberately paused jobs', async () => {
+  let now = 0, recoveries = 0;
+  const monitor = new Monitor({ now: () => now, stallMs: 100 });
+  const state = { paused: false, active: [{ source: 'a', current: { id: 'job', title: 'Manga' }, job: { completed: 0, current: { downloadedPages: 1 } } }], queue: [] };
+  const recover = async () => { recoveries++; return { changed: true }; };
+  await monitor.observe({ ok: true }, state, recover);
+  now = 500000; state.active[0].job.current.downloadedPages = 2;
+  await monitor.observe({ ok: true }, state, recover);
+  now = 1000000; state.paused = true;
+  await monitor.observe({ ok: true }, state, recover);
+  assert.equal(recoveries, 0);
+  state.paused = false; await monitor.observe({ ok: true }, state, recover); await monitor.observe({ ok: true }, state, recover);
+  assert.equal(recoveries, 1);
+  state.active[0].job.completed = 1; await monitor.observe({ ok: true }, state, recover);
+  assert.equal(monitor.incidents.find(i => i.key === 'stall:job').state, 'resolved');
+});
+test('Sentinel reports service failures without restart loops and resolves recovery', async () => {
+  const monitor = new Monitor();
+  await monitor.observe(null, null); await monitor.observe(null, null);
+  assert.equal(monitor.incidents.length, 2);
+  await monitor.observe({ ok: true }, { active: [], queue: [], paused: false });
+  assert.equal(monitor.state.status, 'healthy'); assert.ok(monitor.incidents.every(i => i.state === 'resolved'));
+});

sentinel/test/supervisor.test.js

@@ -0,0 +1,28 @@
+'use strict';
+const test = require('node:test'), assert = require('node:assert/strict');
+const fs = require('fs'), os = require('os'), path = require('path'), { EventEmitter } = require('events');
+const { Supervisor } = require('../../runtime/supervisor');
+const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
+test('supervisor isolates a child crash and persists its bounded restart budget', async () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mc-supervisor-')), file = path.join(dir, 'runtime.json');
+  let starts = 0;
+  const spawn = () => { const child = new EventEmitter(); child.pid = ++starts; child.kill = () => { child.emit('exit', 0); child.emit('close', 0); }; return child; };
+  const supervisor = new Supervisor('reader', { file, spawn, retryBaseMs: 1 });
+  try {
+    supervisor.start();
+    for (let n = 0; n < 3; n++) {
+      supervisor.child.emit('close', 1, null);
+      for (let i = 0; i < 50 && supervisor.state.status === 'retry_wait'; i++) await delay(2);
+    }
+    assert.equal(starts, 3); assert.equal(supervisor.state.status, 'parked'); assert.equal(supervisor.child, null);
+    const restored = new Supervisor('reader', { file, spawn, retryBaseMs: 1 }); restored.start();
+    assert.equal(starts, 3); assert.equal(restored.state.status, 'parked'); await restored.close();
+  } finally { await supervisor.close(); fs.rmSync(dir, { recursive: true, force: true }); }
+});
+test('intentional supervisor shutdown does not consume the crash budget', async () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mc-supervisor-stop-'));
+  const child = new EventEmitter(); child.pid = 1; child.kill = () => { child.emit('exit', 0); child.emit('close', 0); };
+  const supervisor = new Supervisor('scraper', { file: path.join(dir, 'runtime.json'), spawn: () => child });
+  try { supervisor.start(); await supervisor.close(); assert.equal(supervisor.state.status, 'stopped'); assert.equal(supervisor.state.failures.length, 0); }
+  finally { await supervisor.close(); fs.rmSync(dir, { recursive: true, force: true }); }
+});