@wasmsoft/fantastic 1.0.0

package/dist/shell/parse-line.js

@@ -0,0 +1,62 @@
+// AR: تقسيم سطر الصَدَفة إلى وسائط. **لا نمرّر السطر إلى صَدَفة النظام** — لا ‎cmd.exe‎ ولا غيرها:
+//     الأوامر تُنفَّذ داخل العملية، فتمريره إلى مُفسِّر خارجي كان سيفتح بابًا لإعادة التوجيه والأنابيب
+//     وتوسيع المتغيّرات في نصٍّ نكتبه نحن — وهو سطحُ حقنٍ كامل مقابل راحةٍ لم يطلبها أحد.
+//
+//     ما يُدعَم هو ما يحتاجه أمر فعليًّا: مسافات فاصلة، واقتباس يجمع ما بينه (مسار فيه فراغ). وما
+//     عدا ذلك محارف عادية.
+//
+//     **والشرطة المائلة العكسية ليست محرف هروب — هي فاصل مسار.** كتبتُها أوّلًا على عادة صَدَفات
+//     POSIX، فكشف الاختبار أن ‎"D:\My Media\films"‎ يخرج ‎D:My Mediafilms‎: أشيعُ مُدخَل على المنصّة
+//     التي يعمل عليها هذا الـ CLI يُدمَّر صامتًا. و‎cmd.exe‎ نفسه لا يعتبرها هروبًا. فمن أراد علامة
+//     اقتباس داخل وسيط أحاطه بالنوع الآخر — قاعدةٌ لا تكلّف أحدًا شيئًا، بينما القاعدة الأخرى تكلّف
+//     كل مسار ويندوز.
+// EN: Splitting a shell line into arguments. **The line is never handed to a system shell** — not
+//     cmd.exe, not any other: commands run in-process, so passing it to an external interpreter would
+//     open redirection, pipes and variable expansion inside text we author — a full injection surface
+//     in exchange for convenience nobody asked for.
+//
+//     What is supported is what a command actually needs: spaces as separators and quotes to hold
+//     something together (a path with a blank in it). Everything else is an ordinary character.
+//
+//     **And a backslash is not an escape — it is a path separator.** It was written as an escape
+//     first, out of POSIX-shell habit, and the test showed `"D:\My Media\films"` coming out as
+//     `D:My Mediafilms`: the most common input on the platform this CLI runs on, destroyed in
+//     silence. cmd.exe does not treat it as an escape either. Anyone needing a quote character inside
+//     an argument wraps it in the other quote style — a rule that costs nobody anything, where the
+//     other rule costs every Windows path.
+/**
+ * يقسّم سطرًا إلى وسائط. سطر فارغ أو مسافات وحدها يعطي مصفوفة فارغة.
+ * الاقتباس غير المغلَق يُقرأ حتى نهاية السطر بدل أن يُرمى: من نسي علامة إغلاق يريد ما كتبه، لا خطأً.
+ */
+export function splitCommandLine(line) {
+    const argv = [];
+    let current = "";
+    let quote = null;
+    let started = false;
+    for (let index = 0; index < line.length; index += 1) {
+        const char = line[index];
+        if (quote && char === quote) {
+            quote = null;
+            continue;
+        }
+        if (!quote && (char === '"' || char === "'")) {
+            quote = char;
+            // اقتباس فارغ ‎""‎ وسيطٌ فارغ مقصود لا لا-شيء.
+            started = true;
+            continue;
+        }
+        if (!quote && /\s/.test(char)) {
+            if (started)
+                argv.push(current);
+            current = "";
+            started = false;
+            continue;
+        }
+        current += char;
+        started = true;
+    }
+    if (started)
+        argv.push(current);
+    return argv;
+}
+//# sourceMappingURL=parse-line.js.map

package/dist/shell/parse-line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-line.js","sourceRoot":"","sources":["../../src/shell/parse-line.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,uGAAuG;AACvG,0FAA0F;AAC1F,EAAE;AACF,kGAAkG;AAClG,2BAA2B;AAC3B,EAAE;AACF,iGAAiG;AACjG,qGAAqG;AACrG,oGAAoG;AACpG,oGAAoG;AACpG,sBAAsB;AACtB,kGAAkG;AAClG,sGAAsG;AACtG,sGAAsG;AACtG,oDAAoD;AACpD,EAAE;AACF,kGAAkG;AAClG,gGAAgG;AAChG,EAAE;AACF,iGAAiG;AACjG,+FAA+F;AAC/F,8FAA8F;AAC9F,sGAAsG;AACtG,mGAAmG;AACnG,2CAA2C;AAE3C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,GAAqB,IAAI,CAAC;IACnC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC;QAE1B,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YAC5B,KAAK,GAAG,IAAI,CAAC;YACb,SAAS;QACX,CAAC;QAED,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC7C,KAAK,GAAG,IAAI,CAAC;YACb,+CAA+C;YAC/C,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QAED,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;QAChB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/shell/suggestions.d.ts

@@ -0,0 +1,14 @@
+export type CommandHint = {
+    id: string;
+    /** سطر واحد يصف الأمر. الاسم وحده لا يكفي للاختيار بين ‎stop‎ و‎uninstall‎. */
+    summary: string;
+};
+/**
+ * ترتيب ثلاثيّ مقصود:
+ *   ١. ما يبدأ بما كُتب — من كتب ‎st‎ يقصد ‎status‎ أو ‎stop‎ لا ‎library list‎.
+ *   ٢. ما يبدأ **جزؤه الثاني** بما كُتب — ‎scan‎ يجد ‎library scan‎، فالمواضيع لا تُخفي أوامرها.
+ *   ٣. ما يحتويه في أي موضع.
+ * وداخل كل رتبة أبجديًّا، فلا يتحرّك ترتيب القائمة تحت اليد بين ضغطتين.
+ */
+export declare function matchCommands(hints: CommandHint[], term: string, limit: number): CommandHint[];
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/shell/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../src/shell/suggestions.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAuB9F"}

package/dist/shell/suggestions.js

@@ -0,0 +1,35 @@
+// AR: مطابقة أسماء الأوامر لما يكتبه المستخدم. **منطق خالص بلا رسم ولا oclif**، فيُختبَر كما هو —
+//     والترتيب هنا هو ما يقرّر أيّ أمر تراه العين أوّلًا، وهو أهمّ من كونه «يعمل».
+// EN: Matching command names against what the user is typing. **Pure logic, no drawing and no
+//     oclif**, so it is testable as-is — and the ranking here decides which command the eye lands on
+//     first, which matters more than merely working.
+/**
+ * ترتيب ثلاثيّ مقصود:
+ *   ١. ما يبدأ بما كُتب — من كتب ‎st‎ يقصد ‎status‎ أو ‎stop‎ لا ‎library list‎.
+ *   ٢. ما يبدأ **جزؤه الثاني** بما كُتب — ‎scan‎ يجد ‎library scan‎، فالمواضيع لا تُخفي أوامرها.
+ *   ٣. ما يحتويه في أي موضع.
+ * وداخل كل رتبة أبجديًّا، فلا يتحرّك ترتيب القائمة تحت اليد بين ضغطتين.
+ */
+export function matchCommands(hints, term, limit) {
+    const needle = term.trim().toLowerCase();
+    if (!needle)
+        return [];
+    const ranked = [];
+    for (const hint of hints) {
+        const id = hint.id.toLowerCase();
+        const rank = id.startsWith(needle)
+            ? 0
+            : id.split(/[ :]/).some((part) => part.startsWith(needle))
+                ? 1
+                : id.includes(needle)
+                    ? 2
+                    : -1;
+        if (rank >= 0)
+            ranked.push({ hint, rank });
+    }
+    return ranked
+        .sort((a, b) => a.rank - b.rank || a.hint.id.localeCompare(b.hint.id))
+        .slice(0, limit)
+        .map((entry) => entry.hint);
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/shell/suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../../src/shell/suggestions.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,mFAAmF;AACnF,8FAA8F;AAC9F,qGAAqG;AACrG,qDAAqD;AAQrD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAoB,EAAE,IAAY,EAAE,KAAa;IAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,MAAM,MAAM,GAA+C,EAAE,CAAC;IAE9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAChC,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBACxD,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACnB,CAAC,CAAC,CAAC;oBACH,CAAC,CAAC,CAAC,CAAC,CAAC;QAEX,IAAI,IAAI,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,MAAM;SACV,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACrE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/supervisor/dependencies.d.ts

@@ -0,0 +1,2 @@
+export declare const SUPERVISOR_DEPENDENCIES: readonly ["chalk", "execa", "strip-ansi"];
+//# sourceMappingURL=dependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/supervisor/dependencies.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,uBAAuB,2CAA4C,CAAC"}

package/dist/supervisor/dependencies.js

@@ -0,0 +1,38 @@
+// AR: ما يحتاجه المُشرِف فعلًا من ‎node_modules‎ — **قائمةٌ يحرسها اختبار، لا تخمين**.
+//
+//     الحزمة تشحن المُشرِف بشجرة اعتمادياته. وأوّل تنفيذٍ نسخ ‎dependencies‎ كاملةً من بيان
+//     الواجهة، فبلغت الشجرة ‎143‎ حزمة و‎20.5‎ ميغابايت — أي أن الحزمة لم تنقص شيئًا يُذكر عمّا
+//     كانت عليه قبل الفصل (‎34‎ م.ب مقيسة). **والميزة كانت ستُسلَّم بلا فائدتها المعلنة.**
+//
+//     والسبب أن الواجهة تحتاج oclif و Ink و React و ‎archiver‎ و‎boxen‎ وأخواتها؛ أمّا المُشرِف —
+//     حلقةٌ تشغّل عمليات وتسأل منافذ وتكتب سطورًا — فلا يمسّ شيئًا من ذلك.
+//
+//     **ولماذا قائمةٌ مكتوبة بدل تحليلٍ ساكن وقت التحزيم؟** لأن التحليل يجب أن يقع حيث يُقرأ
+//     الكود لا حيث يُنسَخ: هنا، بجانب ما يستورد. و‎test/supervisor-dependencies.spec.ts‎ يمشي شجرة
+//     الاستيراد من ‎supervisor/entry.ts‎ ويطابقها بهذه القائمة، فحزمةٌ تُضاف إلى المُشرِف وتُنسى
+//     هنا **تُفشل الاختبار** — لا تصل عميلًا فتنهار عنده بعد انقطاع كهرباء.
+//
+//     وطبقةٌ ثانية من الحماية عند البناء: الإقلاع التجريبي يشغّل ‎supervisor.js --check‎ بزمن تشغيل
+//     الحزمة، فيُحمَّل الرسم البيانيّ كاملًا. اعتماديةٌ ناقصة تُسقط البناء على شاشة المطوّر.
+// EN: What the supervisor actually needs from `node_modules` — **a list guarded by a test, not a
+//     guess**.
+//
+//     The bundle ships the supervisor with its dependency tree. The first implementation copied the
+//     CLI manifest's `dependencies` wholesale, and the tree came to 143 packages and 20.5 MB — that
+//     is, the bundle shed almost nothing against what it carried before the separation (a measured
+//     34 MB). **The feature would have shipped without its stated benefit.**
+//
+//     The reason is that the CLI needs oclif, Ink, React, archiver, boxen and their kin; the
+//     supervisor — a loop that spawns processes, probes ports and writes lines — touches none of it.
+//
+//     **Why a written list rather than static analysis at packaging time?** Because the analysis
+//     belongs where the code is read, not where it is copied: here, beside what imports it. And
+//     `test/supervisor-dependencies.spec.ts` walks the import graph from `supervisor/entry.ts` and
+//     matches it against this list, so a package added to the supervisor and forgotten here **fails
+//     the test** — rather than reaching a customer and collapsing after a power cut.
+//
+//     A second layer guards it at build time: the smoke boot runs `supervisor.js --check` on the
+//     bundle's own runtime, loading the entire graph. A missing dependency fails the build on the
+//     developer's screen.
+export const SUPERVISOR_DEPENDENCIES = ["chalk", "execa", "strip-ansi"];
+//# sourceMappingURL=dependencies.js.map

package/dist/supervisor/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../src/supervisor/dependencies.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,EAAE;AACF,4FAA4F;AAC5F,gGAAgG;AAChG,2FAA2F;AAC3F,EAAE;AACF,kGAAkG;AAClG,2EAA2E;AAC3E,EAAE;AACF,6FAA6F;AAC7F,mGAAmG;AACnG,iGAAiG;AACjG,4EAA4E;AAC5E,EAAE;AACF,oGAAoG;AACpG,6FAA6F;AAC7F,iGAAiG;AACjG,eAAe;AACf,EAAE;AACF,oGAAoG;AACpG,oGAAoG;AACpG,mGAAmG;AACnG,6EAA6E;AAC7E,EAAE;AACF,6FAA6F;AAC7F,qGAAqG;AACrG,EAAE;AACF,iGAAiG;AACjG,gGAAgG;AAChG,mGAAmG;AACnG,oGAAoG;AACpG,qFAAqF;AACrF,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,0BAA0B;AAE1B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAU,CAAC"}

package/dist/supervisor/entry.d.ts

@@ -0,0 +1,36 @@
+import type { Profile } from "../profiles/types.js";
+export interface SuperviseOptions {
+    /** تشغيل الخدمات عند الدخول. ‎false‎ تعني الإشراف على ما يعمل أصلًا. */
+    boot: boolean;
+    /** أين تُكتب السطور. الأمر يمرّر ‎this.log‎، والمُشرِف المشحون يمرّر ‎console.log‎. */
+    log: (line: string) => void;
+}
+/**
+ * AR: الحلقة التي لا تعود. **جولة واحدة تفعل ثلاثة أشياء بترتيب مقصود:**
+ *     ١ — تستهلك طلب إعادة تشغيل إن وُجد. أوّلًا لأنه فعلٌ صريح طلبه إنسان، ولا يجوز أن يسبقه شيء.
+ *     ٢ — تسأل المؤقّت. الجدول تلقائيّ ويؤجَّل بأدب.
+ *     ٣ — تراقب وتُحيي. آخرًا لأن الخطوتين قبله قد أعادتا التشغيل أصلًا، ومسبارٌ يجري أثناء إعادة
+ *         تشغيل مقصودة يرى خدمة ميّتة فيُحصي محاولة إحياء كاذبة ضدّ حارس الدورة.
+ * EN: The loop that does not return. **One round does three things in a deliberate order:**
+ *     1 — consume a restart request if there is one. First, because it is an explicit act a human
+ *         asked for, and nothing may come before it.
+ *     2 — ask the timer. The schedule is automatic and defers politely.
+ *     3 — monitor and revive. Last, because the two steps above may have just restarted something,
+ *         and a probe running during an intentional restart sees a dead service and counts a false
+ *         revival attempt against the loop guard.
+ */
+export declare function supervise(profile: Profile, options: SuperviseOptions): Promise<never>;
+/**
+ * AR: مدخل المُشرِف المشحون. **يستنتج جذر التثبيت من موقع الملفّ نفسه**، لا من ‎cwd‎ ولا من متغيّر
+ *     بيئة: مهمّة جدولة ويندوز تبدأ بمجلد عملٍ لا نتحكّم به (‎C:\Windows\system32‎ غالبًا)،
+ *     وبيئةٍ لا تحمل ما يحمله حساب من ثبّت. المسار الصاعد من ‎<root>\supervisor\bin\‎ يصدق دائمًا،
+ *     ويتحرّك مع التثبيت إن نُقل بـ‎--root‎ — وهي نفس الحيلة التي تعتمدها الشيمة.
+ * EN: The shipped supervisor's entry point. **It infers the install root from the file's own
+ *     location**, not from `cwd` and not from an environment variable: a Windows scheduled task
+ *     starts with a working directory we do not control (usually `C:\Windows\system32`) and an
+ *     environment that carries none of what the installer's account carried. Climbing from
+ *     `<root>\supervisor\bin\` is always true, and travels with the installation when `--root`
+ *     moves it — the same trick the shim relies on.
+ */
+export declare function main(bundleRoot: string): Promise<never>;
+//# sourceMappingURL=entry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/supervisor/entry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAgDpD,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,IAAI,EAAE,OAAO,CAAC;IACd,uFAAuF;IACvF,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAoCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAyE3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAG7D"}

package/dist/supervisor/entry.js

@@ -0,0 +1,171 @@
+import { buildAppliance } from "../profiles/resolve.js";
+import { isBootTaskInstalled } from "../packaging/boot-task.js";
+import { fetchInternalHealth } from "../probes/internal.client.js";
+import { startServices } from "./orchestrator.js";
+import { ServiceMonitor } from "./monitor.js";
+import { consumeRestartRequest } from "./restart-consumer.js";
+import { ScheduleTimer } from "./schedule-timer.js";
+import { REMOTE_STATE_FILES, removeStateFile, writeStateJson } from "./state-files.js";
+import { renderStartOutcome } from "../render/boot.render.js";
+import { c, glyph } from "../render/theme.js";
+import { EXIT } from "../exit-codes.js";
+// AR: حلقة الإشراف — **جسمُ ‎watch‎ مستخرَجًا من الأمر** (٠٢٦).
+//
+//     كان المنطق كلّه داخل ‎commands/watch.ts‎، وهذا كان صحيحًا حين كانت الواجهة تُشحن في الحزمة:
+//     مهمّة الإقلاع تنادي ‎fantastic watch‎ فتصل إلى oclif فتصل إلى الحلقة.
+//
+//     وقد خرجت الواجهة إلى سِجلّ الحزم (٠٢٦)، وبقي في الحزمة المُشرِف وحده. فصار للحلقة مُناديان:
+//     الأمر ‎watch‎ من الواجهة العالمية، و‎bin/supervisor.js‎ المشحون الذي تناديه المهمّة. **ومسارَا
+//     إشرافٍ يتباعدان حتمًا** — وهي القاعدة المكتوبة في ‎watch.ts‎ نفسه عن مسارَي الإقلاع، ولنفس
+//     السبب: ينجح أحدهما حيث يفشل الآخر ولا يعرف أحد لماذا. فالجسم هنا، والمُناديان غلافان.
+//
+//     **ولا يستورد هذا الملفّ oclif.** المُشرِف المشحون يعمل على ‎runtime\‎ داخل الحزمة، وشجرة
+//     اعتمادياته هي ما يُنسَخ إليها — فكلّ ما يُستورَد هنا يصير ميغابايتات على قرص كل عميل.
+// EN: The supervision loop — **`watch`'s body, lifted out of the command** (026).
+//
+//     All of this logic used to live inside `commands/watch.ts`, and that was right while the CLI
+//     shipped inside the bundle: the boot task called `fantastic watch`, which reached oclif, which
+//     reached the loop.
+//
+//     The CLI has since moved to a package registry (026), and only the supervisor stayed in the
+//     bundle. So the loop now has two callers: the `watch` command from the global CLI, and the
+//     shipped `bin/supervisor.js` that the boot task calls. **Two supervision paths would inevitably
+//     drift** — the rule `watch.ts` itself states about boot paths, for the same reason: one
+//     succeeds where the other fails and nobody knows why. So the body lives here and both callers
+//     are wrappers.
+//
+//     **And this file imports no oclif.** The shipped supervisor runs on the bundle's `runtime\`,
+//     and its dependency tree is what gets copied in — so everything imported here becomes megabytes
+//     on every customer's disk.
+/** إيقاع الجولة. ثانيتان: أسرع من ذلك يقصف النواة بمسابر، وأبطأ يجعل «≤٣٠ ثانية» وعدًا ضيّقًا. */
+const ROUND_MS = 2_000;
+/** كل كم جولة نجدّد النبض ونسأل عن مهمة الإقلاع. ‎schtasks‎ استدعاء عملية، لا يُنادى كل ثانيتين. */
+const HEARTBEAT_EVERY_ROUNDS = 15;
+function stamp() {
+    return new Date().toISOString().slice(11, 19);
+}
+/**
+ * AR: من يشاهد الآن؟ **نسأل النواة ولا نخمّن**: هي وحدها تعرف الجلسات (حدّ «الـ CLI يعرض والنواة
+ *     تقرّر»). ونواةٌ لا تُجيب **لا تؤجّل شيئًا**: أشيع سبب لصمتها هو التعليق، وهو بالضبط ما جاء
+ *     هذا الجدول ليعالجه — تأجيلٌ عندها يعني نظامًا معلّقًا يحمي نفسه من الإصلاح.
+ * EN: Who is watching right now? **We ask the core rather than guess**: it alone knows the sessions
+ *     (the "the CLI displays, the core decides" boundary). And a core that does not answer **defers
+ *     nothing**: the commonest reason for its silence is a hang, which is exactly what this schedule
+ *     exists to cure — deferring then would be a hung system protecting itself from repair.
+ */
+async function deferralReason(profile) {
+    const health = await fetchInternalHealth(profile, 2_000);
+    if (!health.ok)
+        return null;
+    const watching = health.data.streams?.active ?? 0;
+    if (watching === 0)
+        return null;
+    return watching === 1 ? "ضيف واحد يشاهد الآن" : `${watching} ضيوف يشاهدون الآن`;
+}
+function beat(profile, startedAt, bootTaskInstalled) {
+    const status = {
+        pid: process.pid,
+        startedAt,
+        updatedAt: new Date().toISOString(),
+        bootTaskInstalled,
+    };
+    writeStateJson(profile, REMOTE_STATE_FILES.supervisor, status);
+}
+/**
+ * AR: الحلقة التي لا تعود. **جولة واحدة تفعل ثلاثة أشياء بترتيب مقصود:**
+ *     ١ — تستهلك طلب إعادة تشغيل إن وُجد. أوّلًا لأنه فعلٌ صريح طلبه إنسان، ولا يجوز أن يسبقه شيء.
+ *     ٢ — تسأل المؤقّت. الجدول تلقائيّ ويؤجَّل بأدب.
+ *     ٣ — تراقب وتُحيي. آخرًا لأن الخطوتين قبله قد أعادتا التشغيل أصلًا، ومسبارٌ يجري أثناء إعادة
+ *         تشغيل مقصودة يرى خدمة ميّتة فيُحصي محاولة إحياء كاذبة ضدّ حارس الدورة.
+ * EN: The loop that does not return. **One round does three things in a deliberate order:**
+ *     1 — consume a restart request if there is one. First, because it is an explicit act a human
+ *         asked for, and nothing may come before it.
+ *     2 — ask the timer. The schedule is automatic and defers politely.
+ *     3 — monitor and revive. Last, because the two steps above may have just restarted something,
+ *         and a probe running during an intentional restart sees a dead service and counts a false
+ *         revival attempt against the loop guard.
+ */
+export async function supervise(profile, options) {
+    const { log } = options;
+    if (options.boot) {
+        const outcome = await startServices(profile);
+        log(renderStartOutcome(outcome));
+        // AR: **لا نخرج عند فشل الإقلاع.** المشرف الذي ينصرف لأن منفذًا كان محجوزًا لحظة الإقلاع هو
+        //     مشرفٌ لا يعود أبدًا: مهمة ويندوز تعمل مرّة واحدة عند بدء التشغيل. البقاء يعني أن
+        //     الخدمة تُحيا بعد ثوانٍ حين يتحرّر المنفذ — وهو ما يقع فعلًا عند إقلاع بارد.
+        // EN: **We do not exit when the boot fails.** A supervisor that walks away because a port was
+        //     held at boot is a supervisor that never returns: the Windows task runs once, at startup.
+        //     Staying means the service is revived seconds later when the port frees up — which is
+        //     exactly what happens on a cold boot.
+        if (!outcome.ok)
+            log(c.warn("the services did not all start — supervising anyway, they will be revived"));
+    }
+    const report = (event) => {
+        const paint = event.kind === "revived" || event.kind === "recovered" ? c.ok : c.warn;
+        log(`${c.dim(stamp())} ${paint(event.detail)}`);
+    };
+    const monitor = new ServiceMonitor(profile, { onEvent: report });
+    const timer = new ScheduleTimer(profile, {
+        deferIf: () => deferralReason(profile),
+        onEvent: (message) => log(`${c.dim(stamp())} ${message}`),
+    });
+    let stopping = false;
+    const stop = () => {
+        if (stopping)
+            return;
+        stopping = true;
+        // الملفّ يُحذَف عند الخروج المنظّم: نبضٌ متروك خلف مشرف ميّت يقول للنواة «الآلة تعود بعد
+        // الإطفاء» وهي لا تعود. القِدَم يحمينا حين لا يكون الخروج منظّمًا، وهذا يحمينا حين يكون.
+        removeStateFile(profile, REMOTE_STATE_FILES.supervisor);
+        log(c.dim("supervisor stopped."));
+        process.exit(EXIT.OK);
+    };
+    process.on("SIGINT", stop);
+    process.on("SIGTERM", stop);
+    log(`${c.ok(glyph.pass)} supervising — ${profile.services.map((service) => service.label).join(", ")}`);
+    const startedAt = new Date().toISOString();
+    let round = 0;
+    let bootTaskInstalled = await isBootTaskInstalled();
+    for (;;) {
+        if (round % HEARTBEAT_EVERY_ROUNDS === 0) {
+            if (round > 0)
+                bootTaskInstalled = await isBootTaskInstalled();
+            beat(profile, startedAt, bootTaskInstalled);
+        }
+        round += 1;
+        // AR: كل جولة داخل ‎try‎: المشرف الذي يموت على استثناء عابر — قرص امتلأ لحظة كتابة نبض،
+        //     شبكة رفضت مسبارًا — يترك الجهاز بلا حارس إلى إقلاعه التالي. الاستمرار هو وظيفته.
+        // EN: Every round inside a `try`: a supervisor that dies on a passing exception — a disk full at
+        //     the moment a heartbeat is written, a socket refusing a probe — leaves the appliance
+        //     unguarded until its next boot. Continuing is its whole job.
+        try {
+            await consumeRestartRequest(profile, {
+                deferIf: () => deferralReason(profile),
+                onEvent: (message) => log(`${c.dim(stamp())} ${message}`),
+            });
+            await timer.round();
+            await monitor.round();
+        }
+        catch (error) {
+            log(c.warn(`${stamp()} round failed: ${error instanceof Error ? error.message : String(error)}`));
+        }
+        await new Promise((resolve) => setTimeout(resolve, ROUND_MS));
+    }
+}
+/**
+ * AR: مدخل المُشرِف المشحون. **يستنتج جذر التثبيت من موقع الملفّ نفسه**، لا من ‎cwd‎ ولا من متغيّر
+ *     بيئة: مهمّة جدولة ويندوز تبدأ بمجلد عملٍ لا نتحكّم به (‎C:\Windows\system32‎ غالبًا)،
+ *     وبيئةٍ لا تحمل ما يحمله حساب من ثبّت. المسار الصاعد من ‎<root>\supervisor\bin\‎ يصدق دائمًا،
+ *     ويتحرّك مع التثبيت إن نُقل بـ‎--root‎ — وهي نفس الحيلة التي تعتمدها الشيمة.
+ * EN: The shipped supervisor's entry point. **It infers the install root from the file's own
+ *     location**, not from `cwd` and not from an environment variable: a Windows scheduled task
+ *     starts with a working directory we do not control (usually `C:\Windows\system32`) and an
+ *     environment that carries none of what the installer's account carried. Climbing from
+ *     `<root>\supervisor\bin\` is always true, and travels with the installation when `--root`
+ *     moves it — the same trick the shim relies on.
+ */
+export async function main(bundleRoot) {
+    const profile = buildAppliance(bundleRoot);
+    return supervise(profile, { boot: true, log: (line) => console.log(line) });
+}
+//# sourceMappingURL=entry.js.map

package/dist/supervisor/entry.js.map

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

package/dist/supervisor/inspect.d.ts

@@ -0,0 +1,17 @@
+import type { Profile, ServiceDefinition } from "../profiles/types.js";
+import { type ProbeResult } from "../probes/service.probe.js";
+import { type PidRecord } from "./pidfile.js";
+export type StateSource = "record" | "probe" | "none";
+export interface ServiceState {
+    definition: ServiceDefinition;
+    running: boolean;
+    /** من أين عرفنا: سجلّنا، أم سبر خدمة أطلقها غيرنا، أم لا شيء. */
+    source: StateSource;
+    record?: PidRecord;
+    probe: ProbeResult;
+    /** مدة التشغيل بالثواني إن أمكن معرفتها. */
+    uptimeSeconds?: number;
+}
+export declare function inspectService(profile: Profile, definition: ServiceDefinition): Promise<ServiceState>;
+export declare function inspectServices(profile: Profile): Promise<ServiceState[]>;
+//# sourceMappingURL=inspect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/supervisor/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAQrE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAqBD,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,iBAAiB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAiBvB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAE/E"}

package/dist/supervisor/inspect.js

@@ -0,0 +1,39 @@
+import { probeService } from "../probes/service.probe.js";
+import { readVerifiedPidRecord } from "./pidfile.js";
+function uptimeFromRecord(record) {
+    const stamp = record?.startedAt || record?.writtenAt;
+    if (!stamp)
+        return undefined;
+    const started = Date.parse(stamp);
+    if (Number.isNaN(started))
+        return undefined;
+    return Math.max(0, Math.floor((Date.now() - started) / 1000));
+}
+/** مدة تشغيل النواة كما تبلّغ عنها هي. أدقّ من حساب الـ CLI لأنها تبدأ من لحظة الاستماع. */
+function uptimeFromPayload(probe) {
+    const payload = probe.payload;
+    if (typeof payload !== "object" || payload === null)
+        return undefined;
+    const value = payload.uptimeSeconds;
+    return typeof value === "number" ? value : undefined;
+}
+export async function inspectService(profile, definition) {
+    const [record, probe] = await Promise.all([
+        readVerifiedPidRecord(profile, definition.name),
+        probeService(definition),
+    ]);
+    const running = probe.reachable || Boolean(record);
+    const source = record ? "record" : probe.reachable ? "probe" : "none";
+    return {
+        definition,
+        running,
+        source,
+        record,
+        probe,
+        uptimeSeconds: uptimeFromPayload(probe) ?? uptimeFromRecord(record),
+    };
+}
+export async function inspectServices(profile) {
+    return Promise.all(profile.services.map((definition) => inspectService(profile, definition)));
+}
+//# sourceMappingURL=inspect.js.map

package/dist/supervisor/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/supervisor/inspect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAoB,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAkB,MAAM,cAAc,CAAC;AAqBrE,SAAS,gBAAgB,CAAC,MAA6B;IACrD,MAAM,KAAK,GAAG,MAAM,EAAE,SAAS,IAAI,MAAM,EAAE,SAAS,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,4FAA4F;AAC5F,SAAS,iBAAiB,CAAC,KAAkB;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAEtE,MAAM,KAAK,GAAI,OAAuC,CAAC,aAAa,CAAC;IACrE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAgB,EAChB,UAA6B;IAE7B,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxC,qBAAqB,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC;QAC/C,YAAY,CAAC,UAAU,CAAC;KACzB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAgB,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAEnF,OAAO;QACL,UAAU;QACV,OAAO;QACP,MAAM;QACN,MAAM;QACN,KAAK;QACL,aAAa,EAAE,iBAAiB,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAgB;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AAChG,CAAC"}

package/dist/supervisor/invocation.d.ts

@@ -0,0 +1,27 @@
+export interface Invocation {
+    file: string;
+    argv: string[];
+}
+/**
+ * حمولة الإطلاق تُمرَّر إلى المشرف ببيئة العملية لا بسطر الأمر: مسارات ويندوز مليئة بالمسافات
+ * وعلامات التنصيص، وسطر الأمر محدود بـ 8191 محرفًا، بينما متغيّر البيئة يقبل 32767 بلا اقتباس
+ * ولا هروب.
+ *
+ * العقد هنا لا في ‎runner.ts‎: ذاك الملف **مدخل تنفيذي** يعمل بمجرّد استيراده، فاستيراده من
+ * ‎spawn.ts‎ لأجل نوع واحد كان سيُشغّل مشرفًا داخل الـ CLI نفسه.
+ */
+export declare const LAUNCH_PAYLOAD_ENV = "FANTASTIC_SERVICE_LAUNCH";
+export interface LaunchPayload {
+    label: string;
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+}
+/**
+ * لماذا لا نطلق ‎npm.cmd‎ مباشرة؟ ‎spawn‎ الخام يرفض ملفات ‎.cmd‎ منذ إصلاح CVE-2024-27980 فيرمي
+ * ‎EINVAL‎. وإطلاق ‎node‎ مباشرةً على ‎npm-cli.js‎ يحلّها ويُبقي سكربتات ‎package.json‎ مصدر الحقيقة،
+ * فلا يخترع الـ CLI طريقة تشغيل ثانية تنحرف عنها.
+ */
+export declare function resolveInvocation(command: string, args: string[]): Invocation;
+//# sourceMappingURL=invocation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../../src/supervisor/invocation.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,6BAA6B,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAiB7E"}

package/dist/supervisor/invocation.js

@@ -0,0 +1,33 @@
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * حمولة الإطلاق تُمرَّر إلى المشرف ببيئة العملية لا بسطر الأمر: مسارات ويندوز مليئة بالمسافات
+ * وعلامات التنصيص، وسطر الأمر محدود بـ 8191 محرفًا، بينما متغيّر البيئة يقبل 32767 بلا اقتباس
+ * ولا هروب.
+ *
+ * العقد هنا لا في ‎runner.ts‎: ذاك الملف **مدخل تنفيذي** يعمل بمجرّد استيراده، فاستيراده من
+ * ‎spawn.ts‎ لأجل نوع واحد كان سيُشغّل مشرفًا داخل الـ CLI نفسه.
+ */
+export const LAUNCH_PAYLOAD_ENV = "FANTASTIC_SERVICE_LAUNCH";
+/**
+ * لماذا لا نطلق ‎npm.cmd‎ مباشرة؟ ‎spawn‎ الخام يرفض ملفات ‎.cmd‎ منذ إصلاح CVE-2024-27980 فيرمي
+ * ‎EINVAL‎. وإطلاق ‎node‎ مباشرةً على ‎npm-cli.js‎ يحلّها ويُبقي سكربتات ‎package.json‎ مصدر الحقيقة،
+ * فلا يخترع الـ CLI طريقة تشغيل ثانية تنحرف عنها.
+ */
+export function resolveInvocation(command, args) {
+    const isNpm = /(^|[\\/])npm(\.cmd|\.exe)?$/i.test(command);
+    if (isNpm) {
+        const npmCli = join(dirname(process.execPath), "node_modules", "npm", "bin", "npm-cli.js");
+        if (existsSync(npmCli))
+            return { file: process.execPath, argv: [npmCli, ...args] };
+    }
+    // احتياط: تثبيت Node لا نجد فيه ‎npm-cli.js‎.
+    if (process.platform === "win32" && /\.(cmd|bat)$/i.test(command)) {
+        const line = [command, ...args]
+            .map((part) => (/[\s&|<>^"]/.test(part) ? `"${part}"` : part))
+            .join(" ");
+        return { file: "cmd.exe", argv: ["/d", "/s", "/c", line] };
+    }
+    return { file: command, argv: args };
+}
+//# sourceMappingURL=invocation.js.map

package/dist/supervisor/invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.js","sourceRoot":"","sources":["../../src/supervisor/invocation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAe1C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAU7D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,IAAc;IAC/D,MAAM,KAAK,GAAG,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE3D,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAC3F,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACrF,CAAC;IAED,8CAA8C;IAC9C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;aAC5B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAC7D,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/dist/supervisor/monitor.d.ts

@@ -0,0 +1,63 @@
+import type { Profile, ServiceName } from "../profiles/types.js";
+/** كم فشلًا متتاليًا قبل أن نعدّ الخدمة ميّتة. */
+export declare const FAILURES_BEFORE_REVIVAL = 2;
+/** نافذة الحارس وحدّها: أكثر من ثلاث إحياءات في عشر دقائق يعني عطلًا لا حادثة. */
+export declare const REVIVAL_LIMIT = 3;
+export declare const REVIVAL_WINDOW_MS: number;
+export interface RevivalDecision {
+    /** نُحيي الآن؟ */
+    revive: boolean;
+    /** توقّفنا نهائيًا عن إحياء هذه الخدمة؟ يقع مرّة واحدة عند تجاوز الحدّ. */
+    looping: boolean;
+    /** عدد الإحياءات داخل النافذة، بما فيها هذه. */
+    attempts: number;
+}
+/**
+ * AR: حارس الدورة، **خالص بلا أثر جانبي وبلا ساعة خاصة به**. الزمن يُمرَّر إليه، فيُختبَر عبور
+ *     عشر دقائق في سطر بدل انتظارها فعلًا — واختبارٌ لا يُكتَب لأنه بطيء هو اختبارٌ لا يوجد.
+ * EN: The loop guard, **pure, side-effect-free, and holding no clock of its own**. Time is passed
+ *     in, so crossing a ten-minute window is tested in a line instead of waited out — and a test
+ *     not written because it is slow is a test that does not exist.
+ */
+export declare class RevivalGuard {
+    private readonly limit;
+    private readonly windowMs;
+    private readonly revivals;
+    private readonly stopped;
+    constructor(limit?: number, windowMs?: number);
+    /** هل توقّفنا عن إحياء هذه الخدمة؟ */
+    isStopped(service: string): boolean;
+    /**
+     * يسجّل محاولة إحياء ويقرّر مصيرها. **يُستدعى مرّة لكل محاولة** — استدعاؤه للاستعلام وحده
+     * يفسد العدّ.
+     */
+    record(service: string, now: number): RevivalDecision;
+    /** يمسح تاريخ خدمة عادت واستقرّت — أو أعاد المالك تشغيلها بيده. */
+    clear(service: string): void;
+}
+export interface MonitorEvent {
+    service: ServiceName;
+    kind: "revived" | "revival-failed" | "loop-stopped" | "recovered";
+    detail: string;
+}
+export interface MonitorOptions {
+    onEvent?: (event: MonitorEvent) => void;
+    guard?: RevivalGuard;
+}
+/**
+ * AR: جولة مراقبة واحدة على كل الخدمات. جولةٌ لا حلقة: من ينادينا يملك الإيقاع، فيُختبَر السلوك
+ *     بجولات متتابعة بلا مؤقّتات ولا انتظار.
+ * EN: One monitoring round over every service. A round rather than a loop: the caller owns the
+ *     cadence, so the behaviour is tested by calling rounds in sequence with no timers and no waits.
+ */
+export declare class ServiceMonitor {
+    private readonly profile;
+    private readonly options;
+    private readonly failures;
+    private readonly guard;
+    constructor(profile: Profile, options?: MonitorOptions);
+    round(now?: number): Promise<void>;
+    private check;
+    private emit;
+}
+//# sourceMappingURL=monitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/supervisor/monitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAqB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA+BpF,kDAAkD;AAClD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,kFAAkF;AAClF,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,iBAAiB,QAAc,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAG1B,KAAK,SAAgB,EACrB,QAAQ,SAAoB;IAG/C,sCAAsC;IACtC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAInC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe;IAgBrD,mEAAmE;IACnE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAI7B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,SAAS,GAAG,gBAAgB,GAAG,cAAc,GAAG,WAAW,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAGlB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,cAAmB;IAKzC,KAAK,CAAC,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;YAMtC,KAAK;IAuDnB,OAAO,CAAC,IAAI;CAGb"}