@wasmsoft/fantastic 1.0.0

package/dist/supervisor/restart-consumer.d.ts

@@ -0,0 +1,37 @@
+import type { RestartRequestFile, RestartScope } from "../contracts/core.js";
+import type { Profile, ServiceName } from "../profiles/types.js";
+/**
+ * AR: يترجم نطاقًا إلى الخدمات التي يشملها، أو ‎undefined‎ ليعني «كلّ ما في ملفّ التشغيل بترتيبه».
+ *     **القائمة الشاملة لا تُكتب يدويًا**: الجهاز خدمتان والمستودع ثلاث، وقائمةٌ ثابتة هنا كانت
+ *     ستحاول إعادة تشغيل واجهةٍ لا وجود لها على الجهاز فتُبلّغ فشلًا كاذبًا.
+ * EN: Translates a scope into the services it covers, or `undefined` meaning "everything in the
+ *     profile, in its order". **The catch-all list is not written by hand**: the appliance has two
+ *     services and the repository three, and a fixed list here would try to restart a portal that
+ *     does not exist on the appliance and report a false failure.
+ */
+export declare function servicesForScope(scope: RestartScope): ServiceName[] | undefined;
+export interface RestartExecution {
+    scope: RestartScope;
+    reason: RestartRequestFile["reason"];
+    ok: boolean;
+    detail: string;
+}
+export interface ConsumeOptions {
+    /**
+     * AR: يُسأل قبل التنفيذ حين يطلب الطلب تأجيلًا (‎force:false‎ وجدولٌ يحترم المشاهدين). يعيد
+     *     سببًا عربيًّا للتأجيل، أو ‎null‎ للمضيّ. المشرف لا يعرف من يشاهد — النواة تعرف — فيُحقن.
+     * EN: Asked before executing when the request permits deferral (`force:false` on a schedule that
+     *     respects viewers). Returns an Arabic reason to defer, or `null` to proceed. The supervisor
+     *     does not know who is watching — the core does — so it is injected.
+     */
+    deferIf?: () => Promise<string | null>;
+    onEvent?: (message: string) => void;
+}
+/**
+ * AR: يستهلك الطلب المعلّق إن وُجد وينفّذه. يعيد ‎null‎ حين لا طلب — وهي الحالة الغالبة في كل جولة.
+ * EN: Consumes the pending request if there is one and executes it. Returns `null` when there is no
+ *     request — which is the usual case on every round.
+ */
+export declare function consumeRestartRequest(profile: Profile, options?: ConsumeOptions): Promise<RestartExecution | null>;
+export declare function executeRestart(profile: Profile, request: RestartRequestFile, options?: ConsumeOptions): Promise<RestartExecution>;
+//# sourceMappingURL=restart-consumer.d.ts.map

package/dist/supervisor/restart-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-consumer.d.ts","sourceRoot":"","sources":["../../src/supervisor/restart-consumer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA+BjE;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,EAAE,GAAG,SAAS,CAG/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAKlC;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA4B3B"}

package/dist/supervisor/restart-consumer.js

@@ -0,0 +1,119 @@
+import { execa } from "execa";
+import { restartServices } from "./orchestrator.js";
+import { REMOTE_STATE_FILES, takeStateJson, writeStateJson } from "./state-files.js";
+// AR: تنفيذ طلب إعادة التشغيل (٠٢٠/US1، US2).
+//
+//     **هنا وحده يقع الفعل.** النواة تكتب طلبًا، وهذا الملف — الذي يعيش في عملية تنجو من موتها —
+//     ينفّذه. الاتجاه مقصود ولا يُعكَس: النواة لا تملك ‎spawn‎ ولا ‎taskkill‎ ولا ‎shutdown‎
+//     (يحرسه ‎core-never-restarts-itself.spec.ts‎).
+//
+//     **والنتيجة تُكتب بعد التنفيذ لا قبله.** «آخر إعادة تشغيل» في لوحة المالك يجب أن تعني «وقعت»
+//     لا «طُلبت»: طلبٌ فشل تنفيذه ثم عُرض كنجاح هو أسوأ من غياب السطر أصلًا، لأنه يغلق التحقيق.
+//
+//     **و‎machine‎ حالة خاصة تُكتَب نتيجتها قبل الأمر.** بعد ‎shutdown /r‎ لا يبقى شيء ليكتب:
+//     العملية تموت مع الآلة. فتُكتب أولًا، وتُصحَّح ضمنًا إن فشل الأمر (نبقى أحياء فنكتب الفشل).
+//
+// EN: Executing a restart request (020/US1, US2).
+//
+//     **This is the only place the act happens.** The core writes a request, and this file — living
+//     in a process that outlives it — carries it out. The direction is deliberate and never
+//     reversed: the core holds no `spawn`, no `taskkill` and no `shutdown` (guarded by
+//     `core-never-restarts-itself.spec.ts`).
+//
+//     **And the outcome is written after the act, not before.** "Last restart" in the owner's panel
+//     must mean "it happened", not "it was asked for": a request that failed and was then shown as a
+//     success is worse than no line at all, because it closes the investigation.
+//
+//     **`machine` is the one case whose outcome is written first.** After `shutdown /r` there is
+//     nothing left to write with: the process dies with the machine. So it is written first, and
+//     implicitly corrected if the command fails (we are still alive, so we write the failure).
+/**
+ * AR: يترجم نطاقًا إلى الخدمات التي يشملها، أو ‎undefined‎ ليعني «كلّ ما في ملفّ التشغيل بترتيبه».
+ *     **القائمة الشاملة لا تُكتب يدويًا**: الجهاز خدمتان والمستودع ثلاث، وقائمةٌ ثابتة هنا كانت
+ *     ستحاول إعادة تشغيل واجهةٍ لا وجود لها على الجهاز فتُبلّغ فشلًا كاذبًا.
+ * EN: Translates a scope into the services it covers, or `undefined` meaning "everything in the
+ *     profile, in its order". **The catch-all list is not written by hand**: the appliance has two
+ *     services and the repository three, and a fixed list here would try to restart a portal that
+ *     does not exist on the appliance and report a false failure.
+ */
+export function servicesForScope(scope) {
+    if (scope === "machine" || scope === "services")
+        return undefined;
+    return [scope];
+}
+/**
+ * AR: يستهلك الطلب المعلّق إن وُجد وينفّذه. يعيد ‎null‎ حين لا طلب — وهي الحالة الغالبة في كل جولة.
+ * EN: Consumes the pending request if there is one and executes it. Returns `null` when there is no
+ *     request — which is the usual case on every round.
+ */
+export async function consumeRestartRequest(profile, options = {}) {
+    const request = takeStateJson(profile, REMOTE_STATE_FILES.restartRequest);
+    if (!request)
+        return null;
+    return executeRestart(profile, request, options);
+}
+export async function executeRestart(profile, request, options = {}) {
+    if (!request.force && options.deferIf) {
+        const reason = await options.deferIf();
+        if (reason) {
+            // AR: **يُعاد كتابة الطلب** لا يُهمَل: التأجيل يعني «لاحقًا» لا «أُلغي». وإسقاطه هنا كان
+            //     سيجعل جدولًا يوميًّا يفقد جولته كاملة لأن ضيفًا شاهد دقيقتين.
+            // EN: **The request is written back** rather than dropped: a deferral means "later", not
+            //     "cancelled". Dropping it here would make a daily schedule lose its whole round because
+            //     one guest watched for two minutes.
+            writeStateJson(profile, REMOTE_STATE_FILES.restartRequest, request);
+            options.onEvent?.(`deferred (${reason})`);
+            return { scope: request.scope, reason: request.reason, ok: false, detail: `deferred — ${reason}` };
+        }
+    }
+    if (request.scope === "machine")
+        return restartMachine(profile, request, options);
+    const { started } = await restartServices(profile, { only: servicesForScope(request.scope) });
+    const ok = started.ok;
+    const detail = ok
+        ? `restarted ${request.scope}`
+        : `failed to restart ${request.scope}: ${started.steps.find((step) => step.status === "failed")?.readiness?.reason ?? "unknown reason"}`;
+    if (ok)
+        recordOutcome(profile, request);
+    options.onEvent?.(detail);
+    return { scope: request.scope, reason: request.reason, ok, detail };
+}
+/**
+ * AR: يعيد تشغيل الآلة. **الأمر الوحيد في المستودع كلّه الذي يُطفئ عتادًا**، ولذلك يعيش هنا وحده
+ *     وخلف بوّابتين سبقتاه: النواة رفضت الطلب أصلًا ما لم تكن مهمة الإقلاع مسجَّلة، والواجهة عطّلت
+ *     الزرّ بالسبب نفسه. المهلة عشر ثوانٍ تعطي الخدمات فرصة الإغلاق النظيف قبل أن يقطع ويندوز.
+ * EN: Restarts the machine. **The only command in the whole repository that powers hardware down**,
+ *     which is why it lives here alone and behind two gates that came before it: the core refused
+ *     the request unless a boot task is registered, and the portal disabled the button for the same
+ *     reason. The ten-second delay gives the services a chance to close cleanly before Windows cuts
+ *     them off.
+ */
+async function restartMachine(profile, request, options) {
+    if (process.platform !== "win32") {
+        const detail = "a machine restart is only supported on Windows";
+        options.onEvent?.(detail);
+        return { scope: request.scope, reason: request.reason, ok: false, detail };
+    }
+    // تُكتب قبل الأمر: بعده لا تبقى عملية تكتب. وإن فشل الأمر بقينا أحياء فصحّحنا السطر بأنفسنا.
+    recordOutcome(profile, request);
+    try {
+        await execa("shutdown", ["/r", "/t", "10", "/c", "Fantastic scheduled restart"], { windowsHide: true });
+        options.onEvent?.("the machine restarts in 10 seconds");
+        return { scope: request.scope, reason: request.reason, ok: true, detail: "machine restart requested" };
+    }
+    catch (error) {
+        const detail = `the machine restart was refused: ${error instanceof Error ? error.message : String(error)}`;
+        options.onEvent?.(detail);
+        return { scope: request.scope, reason: request.reason, ok: false, detail };
+    }
+}
+/** يكتب ما وقع فعلًا. تقرؤه النواة لتعرض «آخر إعادة تشغيل» بلا أن تفترضها عن نفسها. */
+function recordOutcome(profile, request) {
+    const outcome = {
+        at: new Date().toISOString(),
+        scope: request.scope,
+        reason: request.reason,
+    };
+    writeStateJson(profile, REMOTE_STATE_FILES.restartOutcome, outcome);
+}
+//# sourceMappingURL=restart-consumer.js.map

package/dist/supervisor/restart-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-consumer.js","sourceRoot":"","sources":["../../src/supervisor/restart-consumer.ts"],"names":[],"mappings":"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"}

package/dist/supervisor/runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/supervisor/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/supervisor/runner.ts"],"names":[],"mappings":""}

package/dist/supervisor/runner.js

@@ -0,0 +1,118 @@
+import { spawn } from "node:child_process";
+import { StringDecoder } from "node:string_decoder";
+import stripAnsi from "strip-ansi";
+import { LAUNCH_PAYLOAD_ENV, resolveInvocation } from "./invocation.js";
+// AR: المشرف الصغير الذي يقف بين الـ CLI والخدمة. عملية واحدة لكل خدمة، لا تفعل شيئًا سوى إطلاقها
+//     وتمرير مخرجها إلى ملف السجلّ ثم الموت معها.
+//
+//     **لماذا يوجد أصلًا؟ مقياس على ويندوز، لا تجميل.** كان الـ CLI يُطلق كل خدمة بـ ‎detached‎،
+//     ومعناها على ويندوز ‎DETACHED_PROCESS‎: عملية **بلا كونسول**. و‎npm run‎ يشغّل سكربت الحزمة عبر
+//     ‎cmd.exe‎، وتطبيق كونسول يولده أبٌ بلا كونسول يحصل على **كونسول جديد بنافذة مرئية**. فكانت
+//     ثلاث نوافذ سوداء تفتح مع كل ‎fantastic start‎ — ولأن النافذة تملك الكونسول، إغلاق أيّ منها
+//     يرسل ‎CTRL_CLOSE_EVENT‎ إلى كل ما هو موصول به، فتموت الخدمة كلها بسحبة فأرة.
+//
+//     المخرج الوحيد الذي يتيحه Node: ‎windowsHide‎ يترجَم إلى ‎CREATE_NO_WINDOW‎، وهذا العَلَم يعطي
+//     العملية **كونسولًا بلا نافذة** حين يكون أبوها بلا كونسول — وترثه كل ذريّتها، بما فيها
+//     ‎cmd.exe‎. لكن libuv يتجاهل العَلَم إذا كان أيّ من الأنابيب واصفَ ملف موروثًا، وDETACHED_PROCESS
+//     يتقدّم عليه أصلًا. فلا سبيل إلى الجمع بين «ينجو من إغلاق الطرفية» و«بلا نافذة» في إطلاق واحد.
+//
+//     فالإطلاق طبقتان: الـ CLI يُطلق **هذا الملف** منفصلًا (بلا كونسول، ينجو)، وهذا الملف يُطلق
+//     الخدمة بأنابيب و‎windowsHide‎ (كونسول بلا نافذة، ترثه الذرّية). قِيس: صفر نوافذ، والشجرة كاملة
+//     تبقى حيّة بعد إغلاق نافذة الإطلاق.
+// EN: The small supervisor that sits between the CLI and a service. One process per service, doing
+//     nothing but launching it, forwarding its output to the log file, and dying with it.
+//
+//     **Why it exists at all — measured on Windows, not decoration.** The CLI used to launch each
+//     service `detached`, which on Windows means DETACHED_PROCESS: a process with **no console**.
+//     `npm run` runs the package script through cmd.exe, and a console application spawned by a
+//     console-less parent gets a **brand-new console with a visible window**. So three black windows
+//     opened on every `fantastic start` — and because the window owns the console, closing any one of
+//     them sends CTRL_CLOSE_EVENT to everything attached to it, killing the whole service with a
+//     mouse click.
+//
+//     The only lever Node exposes: `windowsHide` maps to CREATE_NO_WINDOW, and that flag gives a
+//     process **a console with no window** when its parent has no console — which its entire
+//     descendancy inherits, cmd.exe included. But libuv skips the flag if any stdio entry is an
+//     inherited file descriptor, and DETACHED_PROCESS overrides it regardless. So "survives the
+//     terminal closing" and "draws no window" cannot be had in a single spawn.
+//
+//     Hence two layers: the CLI launches **this file** detached (no console, survives), and this file
+//     launches the service with pipes and `windowsHide` (windowless console, inherited by the tree).
+//     Measured: zero windows, and the whole tree stays alive after the launching window closes.
+/** يكتب سطرًا إلى ملف السجلّ. مخرَجنا القياسي **هو** واصف ملف السجلّ، ورّثه إيّانا الـ CLI. */
+function write(line) {
+    process.stdout.write(`${line}\n`);
+}
+/**
+ * يجمّع القطع في أسطر كاملة قبل الكتابة. الأنبوب يقطع حيث شاء، وسطر سجلّ منقطع في منتصفه غير قابل
+ * للبحث. ويُجرَّد من ANSI هنا: هذه الطبقة هي أول موضع في التاريخ يمكنه ذلك — الإطلاق المباشر إلى
+ * واصف ملف لم يكن يمرّ بأحد.
+ *
+ * ‎StringDecoder‎ لا ‎chunk.toString()‎: سجلات النواة عربية، والحرف العربي بايتان في UTF-8. والأنبوب
+ * يقطع عند حدّ البايت لا حدّ الحرف، فحرف يقع نصفه في قطعة ونصفه في التالية يخرج من ‎toString‎
+ * علامتَي استفهام لا يعيدهما شيء. المفكّك يحتفظ بالبايتات المعلّقة حتى يكتمل الحرف.
+ */
+function createLineWriter() {
+    const decoder = new StringDecoder("utf8");
+    let pending = "";
+    return {
+        push(chunk) {
+            pending += decoder.write(chunk);
+            const lines = pending.split(/\r?\n/);
+            pending = lines.pop() ?? "";
+            for (const line of lines)
+                write(stripAnsi(line));
+        },
+        flush() {
+            pending += decoder.end();
+            if (pending.trim().length > 0)
+                write(stripAnsi(pending));
+            pending = "";
+        },
+    };
+}
+function readPayload() {
+    const raw = process.env[LAUNCH_PAYLOAD_ENV];
+    if (!raw)
+        throw new Error(`${LAUNCH_PAYLOAD_ENV} is missing — this entry is launched by the CLI, not by hand.`);
+    return JSON.parse(raw);
+}
+function main() {
+    const payload = readPayload();
+    // تُحذف من نسختنا فلا تتسرّب إلى بيئة الخدمة ولا إلى أي عملية تحتها.
+    delete process.env[LAUNCH_PAYLOAD_ENV];
+    const { file, argv } = resolveInvocation(payload.command, payload.args);
+    const child = spawn(file, argv, {
+        cwd: payload.cwd,
+        // ‎NO_COLOR‎ احتياطًا: الأدوات تُعطّل التلوين خارج الطرفية، لكن سجلًّا ملوّثًا بـ ANSI لا يُبحث فيه.
+        env: { ...process.env, ...payload.env, NO_COLOR: "1" },
+        // أنابيب لا واصفات موروثة: هذا بالضبط شرط libuv لتمرير ‎CREATE_NO_WINDOW‎. لا خطر من امتلاء
+        // الأنبوب لأننا نحيا ما دامت الخدمة تحيا فنستنزفه دائمًا.
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+    });
+    write(`--- ${payload.label} started (runner ${process.pid}, service ${child.pid ?? "?"}) ---`);
+    const writer = createLineWriter();
+    child.stdout?.on("data", writer.push);
+    child.stderr?.on("data", writer.push);
+    child.on("error", (error) => {
+        writer.flush();
+        write(`--- ${payload.label} failed to launch: ${error.message} ---`);
+        process.exit(1);
+    });
+    // نموت مع الخدمة. لازم لا مستحبّ: سجلّ العملية يحمل رقمنا نحن، فلو بقينا حيّين بعد موتها لقال
+    // ‎status‎ إنها تعمل وهي ميتة.
+    child.on("exit", (code, signal) => {
+        writer.flush();
+        write(`--- ${payload.label} exited (code ${code ?? "—"}, signal ${signal ?? "—"}) ---`);
+        process.exit(code ?? 1);
+    });
+}
+try {
+    main();
+}
+catch (error) {
+    write(`--- runner aborted: ${error instanceof Error ? error.message : String(error)} ---`);
+    process.exit(1);
+}
+//# sourceMappingURL=runner.js.map

package/dist/supervisor/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/supervisor/runner.ts"],"names":[],"mappings":"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"}

package/dist/supervisor/schedule-timer.d.ts

@@ -0,0 +1,38 @@
+import type { RestartOutcomeFile, RestartScheduleFile } from "../contracts/core.js";
+import type { Profile } from "../profiles/types.js";
+import { type ConsumeOptions, type RestartExecution } from "./restart-consumer.js";
+/** بين محاولتين بعد تأجيل. ربع ساعة: أقصر منها يزعج، وأطول منها يفوّت نافذة هدوء قصيرة. */
+export declare const DEFER_RETRY_MS: number;
+/** أقصى ما نؤجّل قبل التخلّي عن الجولة. */
+export declare const DEFER_CEILING_MS: number;
+/**
+ * AR: موعد الجولة التالية بالمللي ثانية، أو ‎null‎ حين لا جدول. **دالّة خالصة**: الزمن يُمرَّر،
+ *     فتُختبَر سنةٌ من الجداول في مللي ثانية.
+ * EN: When the next round is due in milliseconds, or `null` when nothing is scheduled. **A pure
+ *     function**: time is passed in, so a year of schedules is tested in a millisecond.
+ */
+export declare function dueAt(schedule: RestartScheduleFile, lastRestartAt: string | null, now: number): number | null;
+export interface ScheduleTimerOptions extends ConsumeOptions {
+    /** يُحقَن في الاختبار. الافتراض: قراءة المرآة من مجلد الحالة. */
+    readSchedule?: () => RestartScheduleFile | null;
+    readLastRestart?: () => RestartOutcomeFile | null;
+}
+/**
+ * AR: يقرّر في كل جولة: أحان الموعد؟ وهل نؤجّل؟ وهل بلغنا السقف؟ لا مؤقّت داخله ولا ساعة: الزمن
+ *     يُمرَّر من الخارج، فهذه الحلقة كلّها قابلة للاختبار بلا انتظار ثانية واحدة.
+ * EN: Decides on each round: is it due? should it defer? has it hit the ceiling? It holds no timer
+ *     and no clock: time comes in from outside, so this whole loop is testable without waiting a
+ *     single second.
+ */
+export declare class ScheduleTimer {
+    private readonly profile;
+    private readonly options;
+    /** متى بدأ التأجيل الحالي، أو ‎null‎ حين لا تأجيل جارٍ. */
+    private deferringSince;
+    private nextAttemptAt;
+    constructor(profile: Profile, options?: ScheduleTimerOptions);
+    round(now?: number): Promise<RestartExecution | null>;
+    private readSchedule;
+    private readLastRestart;
+}
+//# sourceMappingURL=schedule-timer.d.ts.map

package/dist/supervisor/schedule-timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-timer.d.ts","sourceRoot":"","sources":["../../src/supervisor/schedule-timer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAsB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA+CnG,2FAA2F;AAC3F,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAE9C;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiB7G;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;IAChD,eAAe,CAAC,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAC;CACnD;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IAMtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,2DAA2D;IAC3D,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,aAAa,CAAK;gBAGP,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,oBAAyB;IAG/C,KAAK,CAAC,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAsDvE,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;CAIxB"}

package/dist/supervisor/schedule-timer.js

@@ -0,0 +1,148 @@
+import { REMOTE_STATE_FILES, readStateJson } from "./state-files.js";
+import { executeRestart } from "./restart-consumer.js";
+// AR: المؤقّت الدوريّ (٠٢٠/US2).
+//
+//     **لماذا يعيش المؤقّت في المشرف لا في النواة؟** لأن الجدول وُضع أصلًا لعلاج التعليق، ومؤقّتٌ
+//     داخل النواة يتعلّق معها — أي يفشل في اللحظة الوحيدة التي بُني لها. المشرف يقرأ مرآة الجدول
+//     من مجلد الحالة (‎restart.schedule.json‎) بلا أن يفتح قاعدة البيانات، وهي قاعدة قائمة في
+//     المستودع لا استثناء لها.
+//
+//     **والمرساة هي آخر إعادة تشغيل وقعت، لا لحظة الحفظ.** بدونها يعيد كل حفظ ضبطَ العدّاد، فجهازٌ
+//     يُعدَّل جدوله كل يوم لا يُعاد تشغيله أبدًا — عطبٌ صامت تمامًا: الإعداد مفعّل، والزمن يمرّ،
+//     ولا شيء يقع. وهي المرساة نفسها التي تحسب بها النواة ‎nextRestartAt‎، فلا تتباعد اللوحة عن
+//     الفعل.
+//
+//     **والتأجيل له سقف.** «لا نقطع أحدًا» قاعدة، لكن جهازًا في استراحة ممتلئة قد لا يخلو ست ساعات
+//     متّصلة، وجدولٌ يؤجّل إلى الأبد هو جدولٌ لا وجود له. عند السقف **نتخلّى عن الجولة** ولا نقطع:
+//     تفويت صيانة أهون من قطع فيلم على ضيف — والجولة التالية تأتي في موعدها.
+//
+// EN: The periodic timer (020/US2).
+//
+//     **Why does the timer live in the supervisor rather than the core?** Because the schedule
+//     exists to cure hangs, and a timer inside the core hangs with it — failing at the one moment it
+//     was built for. The supervisor reads the schedule's mirror from the state dir
+//     (`restart.schedule.json`) without opening the database, which is a standing repository rule
+//     with no exception.
+//
+//     **And the anchor is the last restart that actually happened, not the moment of saving.**
+//     Without that every save resets the counter, so an appliance whose schedule is edited daily is
+//     never restarted at all — a perfectly silent defect: the setting is on, time passes, and
+//     nothing happens. It is the same anchor the core uses to compute `nextRestartAt`, so the panel
+//     and the act never drift apart.
+//
+//     **And deferral has a ceiling.** "Cut nobody off" is a rule, but an appliance in a full
+//     rest-house may not go quiet for six straight hours, and a schedule that defers forever is a
+//     schedule that does not exist. At the ceiling **we abandon the round** rather than cut: missing
+//     one maintenance window is a smaller harm than cutting a guest's film — and the next round
+//     arrives on time.
+const HOURS = {
+    "2h": 2,
+    "4h": 4,
+    "6h": 6,
+    "12h": 12,
+    "24h": 24,
+    weekly: 24 * 7,
+};
+/** بين محاولتين بعد تأجيل. ربع ساعة: أقصر منها يزعج، وأطول منها يفوّت نافذة هدوء قصيرة. */
+export const DEFER_RETRY_MS = 15 * 60_000;
+/** أقصى ما نؤجّل قبل التخلّي عن الجولة. */
+export const DEFER_CEILING_MS = 6 * 3_600_000;
+/**
+ * AR: موعد الجولة التالية بالمللي ثانية، أو ‎null‎ حين لا جدول. **دالّة خالصة**: الزمن يُمرَّر،
+ *     فتُختبَر سنةٌ من الجداول في مللي ثانية.
+ * EN: When the next round is due in milliseconds, or `null` when nothing is scheduled. **A pure
+ *     function**: time is passed in, so a year of schedules is tested in a millisecond.
+ */
+export function dueAt(schedule, lastRestartAt, now) {
+    if (!schedule.autoEnabled)
+        return null;
+    const hours = HOURS[schedule.every];
+    const parsed = lastRestartAt ? Date.parse(lastRestartAt) : Number.NaN;
+    const anchor = Number.isFinite(parsed) ? parsed : now;
+    const due = new Date(anchor + hours * 3_600_000);
+    // الساعة المفضّلة للجداول اليومية فأطول وحدها: تثبيت جدول كل ساعتين على الرابعة يحوّله جدولًا
+    // يوميًّا بصمت — إعدادٌ يُقبَل ويعني غير ما يقول.
+    if (schedule.atHour !== null && hours >= 24) {
+        due.setHours(schedule.atHour, 0, 0, 0);
+        if (due.getTime() <= now)
+            due.setDate(due.getDate() + 1);
+    }
+    return due.getTime();
+}
+/**
+ * AR: يقرّر في كل جولة: أحان الموعد؟ وهل نؤجّل؟ وهل بلغنا السقف؟ لا مؤقّت داخله ولا ساعة: الزمن
+ *     يُمرَّر من الخارج، فهذه الحلقة كلّها قابلة للاختبار بلا انتظار ثانية واحدة.
+ * EN: Decides on each round: is it due? should it defer? has it hit the ceiling? It holds no timer
+ *     and no clock: time comes in from outside, so this whole loop is testable without waiting a
+ *     single second.
+ */
+export class ScheduleTimer {
+    profile;
+    options;
+    /** متى بدأ التأجيل الحالي، أو ‎null‎ حين لا تأجيل جارٍ. */
+    deferringSince = null;
+    nextAttemptAt = 0;
+    constructor(profile, options = {}) {
+        this.profile = profile;
+        this.options = options;
+    }
+    async round(now = Date.now()) {
+        const schedule = this.readSchedule();
+        if (!schedule?.autoEnabled) {
+            this.deferringSince = null;
+            return null;
+        }
+        if (now < this.nextAttemptAt)
+            return null;
+        const last = this.readLastRestart();
+        const due = dueAt(schedule, last?.at ?? null, now);
+        if (due === null || now < due)
+            return null;
+        if (this.deferringSince !== null && now - this.deferringSince >= DEFER_CEILING_MS) {
+            // AR: بلغنا السقف. **نتخلّى ولا نقطع**، ونحرّك المرساة إلى الآن فلا نعيد المحاولة فورًا
+            //     في الجولة التالية — وإلّا صار «التخلّي» حلقةً محمومة كل ثانية.
+            // EN: The ceiling is reached. **We abandon rather than cut**, and move the anchor to now so we
+            //     do not retry immediately on the next round — otherwise "abandoning" becomes a hot loop
+            //     every second.
+            this.deferringSince = null;
+            this.nextAttemptAt = now + HOURS[schedule.every] * 3_600_000;
+            this.options.onEvent?.("the scheduled restart was abandoned — guests were watching for six hours");
+            return null;
+        }
+        const request = {
+            scope: schedule.scope,
+            reason: "scheduled",
+            // AR: الجدول **لا يقطع أبدًا** حين اختار المالك ذلك. و‎force‎ هنا معناه «لا تسأل» لا «اقطع»،
+            //     فيُشتقّ من إعداده هو لا من رغبتنا في أن ينجح.
+            // EN: A schedule **never cuts** when the owner chose so. `force` here means "do not ask" rather
+            //     than "cut", so it is derived from the owner's own setting rather than from our wish for
+            //     the round to succeed.
+            force: !schedule.deferWhileWatching,
+            requestedAt: new Date(now).toISOString(),
+        };
+        const execution = await executeRestart(this.profile, request, {
+            deferIf: this.options.deferIf,
+            onEvent: this.options.onEvent,
+        });
+        if (execution.ok) {
+            this.deferringSince = null;
+            this.nextAttemptAt = 0;
+            return execution;
+        }
+        // تأجيل (أو فشل): نعاود بعد ربع ساعة، ونبدأ عدّ السقف من أوّل تأجيل لا من آخره.
+        this.deferringSince ??= now;
+        this.nextAttemptAt = now + DEFER_RETRY_MS;
+        return execution;
+    }
+    readSchedule() {
+        if (this.options.readSchedule)
+            return this.options.readSchedule();
+        return readStateJson(this.profile, REMOTE_STATE_FILES.restartSchedule);
+    }
+    readLastRestart() {
+        if (this.options.readLastRestart)
+            return this.options.readLastRestart();
+        return readStateJson(this.profile, REMOTE_STATE_FILES.restartOutcome);
+    }
+}
+//# sourceMappingURL=schedule-timer.js.map

package/dist/supervisor/schedule-timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-timer.js","sourceRoot":"","sources":["../../src/supervisor/schedule-timer.ts"],"names":[],"mappings":"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"}

package/dist/supervisor/spawn.d.ts

@@ -0,0 +1,18 @@
+import { type ResultPromise } from "execa";
+import type { Profile, ServiceDefinition } from "../profiles/types.js";
+import { type PidRecord } from "./pidfile.js";
+/** يُطلق خدمة في الخلفية ويسجّل هويتها. العملية تحيا بعد خروج الـ CLI. */
+export declare function launchDetached(profile: Profile, definition: ServiceDefinition): Promise<PidRecord>;
+export interface AttachedService {
+    definition: ServiceDefinition;
+    child: ResultPromise;
+    pid: number;
+    close: () => void;
+}
+export interface AttachOptions {
+    /** يُنادى لكل سطر مخرَج، لعرضه ببادئة ملوّنة. */
+    onLine: (service: ServiceDefinition, line: string) => void;
+}
+/** يُطلق خدمة مرتبطة بالطرفية: الأسطر تذهب إلى الشاشة وإلى ملف السجلّ معًا. */
+export declare function launchAttached(profile: Profile, definition: ServiceDefinition, options: AttachOptions): AttachedService;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/supervisor/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/supervisor/spawn.ts"],"names":[],"mappings":"AAIA,OAAO,EAAS,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIvE,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAyB9D,0EAA0E;AAC1E,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,iBAAiB,GAC5B,OAAO,CAAC,SAAS,CAAC,CA+CpB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,MAAM,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5D;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,aAAa,GACrB,eAAe,CA+CjB"}