@wasmsoft/fantastic 1.0.0

package/dist/supervisor/spawn.js

@@ -0,0 +1,119 @@
+import { createWriteStream } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+import { StringDecoder } from "node:string_decoder";
+import { execa } from "execa";
+import stripAnsi from "strip-ansi";
+import { closeLogFd, logFilePath, openLogFd, rotateIfNeeded } from "../logs/sink.js";
+import { LAUNCH_PAYLOAD_ENV, resolveInvocation } from "./invocation.js";
+import { readProcessIdentity } from "./process-identity.js";
+import { writePidRecord } from "./pidfile.js";
+// AR: إطلاق الخدمات. نمطان يتشاركان نفس التعريف: منفصل (‎start‎) يحيا بعد خروج الـ CLI، ومرتبط
+//     (‎dev‎) يمرّر الأسطر إلى الشاشة وإلى الملف معًا.
+//
+//     النمط المنفصل **لا يُطلق الخدمة مباشرةً**، بل يُطلق مشرفًا صغيرًا (‎runner.ts‎) يُطلقها. السبب
+//     مقيس ومشروح كاملًا هناك، وخلاصته: الإطلاق المباشر بـ ‎detached‎ يفتح على ويندوز نافذة كونسول
+//     مرئية لكل خدمة، وإغلاق أيّ منها يقتل خدمتها. **لا تُعِد هذا السطر إلى إطلاق مباشر.**
+// EN: Service launching. Two modes over one definition: detached (`start`) outlives the CLI, attached
+//     (`dev`) forwards lines to both the screen and the file.
+//
+//     The detached mode **does not launch the service directly** — it launches a small supervisor
+//     (runner.ts) that does. The reason is measured and spelled out in full there; in short, spawning
+//     the service directly with `detached` opens a visible console window per service on Windows, and
+//     closing any of them kills that service. **Do not fold this back into a direct spawn.**
+function buildEnv(definition, extra = {}) {
+    return { ...process.env, ...definition.env, ...extra };
+}
+/** مسار المشرف بجوارنا في ‎dist‎. يُحلّ نسبةً إلى هذا الملف فيصحّ في المستودع وفي التثبيت العالمي معًا. */
+function runnerEntry() {
+    return fileURLToPath(new URL("runner.js", import.meta.url));
+}
+/** يُطلق خدمة في الخلفية ويسجّل هويتها. العملية تحيا بعد خروج الـ CLI. */
+export async function launchDetached(profile, definition) {
+    const fd = openLogFd(profile.logDir, definition.name);
+    try {
+        const payload = {
+            label: definition.label,
+            command: definition.command,
+            args: definition.args,
+            cwd: definition.cwd,
+            env: definition.env,
+        };
+        // ‎spawn‎ الخام لا execa هنا: نحتاج ‎unref‎ لنترك العملية تحيا بعد خروجنا، وexeca لا تكشفه.
+        // واصف السجلّ يُمرَّر إلى المشرف مباشرةً، فهو مخرَجه القياسي ومنه يكتب أسطر الخدمة — ويستمر
+        // التسجيل بعد خروج الـ CLI لأن لا أحد بيننا يعترضه.
+        const child = spawn(process.execPath, [runnerEntry()], {
+            cwd: definition.cwd,
+            env: { ...process.env, [LAUNCH_PAYLOAD_ENV]: JSON.stringify(payload) },
+            stdio: ["ignore", fd, fd],
+            detached: true,
+            windowsHide: true,
+        });
+        child.unref();
+        const pid = child.pid;
+        if (!pid)
+            throw new Error(`could not launch ${definition.label}`);
+        // نقرأ الهوية من النظام لا من ساعتنا: وقت البدء الحقيقي هو ما يحمي من إعادة استعمال الـ PID.
+        const identity = await readProcessIdentity(pid);
+        const record = {
+            service: definition.name,
+            pid,
+            port: definition.port,
+            profile: profile.kind,
+            startedAt: identity?.startedAt ?? "",
+            commandLine: identity?.commandLine ?? `${definition.command} ${definition.args.join(" ")}`,
+            writtenAt: new Date().toISOString(),
+        };
+        writePidRecord(profile, record);
+        return record;
+    }
+    finally {
+        // نسختنا من الواصف لم تعد لازمة؛ العملية تحمل نسختها.
+        closeLogFd(fd);
+    }
+}
+/** يُطلق خدمة مرتبطة بالطرفية: الأسطر تذهب إلى الشاشة وإلى ملف السجلّ معًا. */
+export function launchAttached(profile, definition, options) {
+    rotateIfNeeded(profile.logDir, definition.name);
+    const logStream = createWriteStream(logFilePath(profile.logDir, definition.name), {
+        flags: "a",
+    });
+    const { file, argv } = resolveInvocation(definition.command, definition.args);
+    const child = execa(file, argv, {
+        cwd: definition.cwd,
+        env: buildEnv(definition),
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+        reject: false,
+        buffer: false,
+    });
+    // نفس سبب المفكّك في ‎runner.ts‎: الأنبوب يقطع عند حدّ البايت، والسجلات عربية.
+    const decoder = new StringDecoder("utf8");
+    let pending = "";
+    const consume = (chunk) => {
+        pending += decoder.write(chunk);
+        const lines = pending.split(/\r?\n/);
+        pending = lines.pop() ?? "";
+        for (const line of lines) {
+            if (line.trim().length === 0)
+                continue;
+            // الملف يُجرَّد من ANSI ليبقى قابلًا للبحث؛ الشاشة تحتفظ بما أرسلته الخدمة.
+            logStream.write(`${stripAnsi(line)}\n`);
+            options.onLine(definition, line);
+        }
+    };
+    child.stdout?.on("data", consume);
+    child.stderr?.on("data", consume);
+    return {
+        definition,
+        child,
+        pid: child.pid ?? 0,
+        close: () => {
+            pending += decoder.end();
+            if (pending.trim().length > 0)
+                logStream.write(`${stripAnsi(pending)}\n`);
+            logStream.end();
+        },
+    };
+}
+//# sourceMappingURL=spawn.js.map

package/dist/supervisor/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/supervisor/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAsB,MAAM,OAAO,CAAC;AAClD,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAsB,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAC;AAE9D,+FAA+F;AAC/F,uDAAuD;AACvD,EAAE;AACF,qGAAqG;AACrG,mGAAmG;AACnG,2FAA2F;AAC3F,sGAAsG;AACtG,8DAA8D;AAC9D,EAAE;AACF,kGAAkG;AAClG,sGAAsG;AACtG,sGAAsG;AACtG,6FAA6F;AAE7F,SAAS,QAAQ,CAAC,UAA6B,EAAE,QAAgC,EAAE;IACjF,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;AACzD,CAAC;AAED,2GAA2G;AAC3G,SAAS,WAAW;IAClB,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAgB,EAChB,UAA6B;IAE7B,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAkB;YAC7B,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,GAAG,EAAE,UAAU,CAAC,GAAG;YACnB,GAAG,EAAE,UAAU,CAAC,GAAG;SACpB,CAAC;QAEF,4FAA4F;QAC5F,4FAA4F;QAC5F,oDAAoD;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE;YACrD,GAAG,EAAE,UAAU,CAAC,GAAG;YACnB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;YACtE,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC;YACzB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,KAAK,CAAC,KAAK,EAAE,CAAC;QAEd,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QAElE,6FAA6F;QAC7F,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAc;YACxB,OAAO,EAAE,UAAU,CAAC,IAAI;YACxB,GAAG;YACH,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,EAAE;YACpC,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAC1F,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,sDAAsD;QACtD,UAAU,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;AACH,CAAC;AAcD,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,UAA6B,EAC7B,OAAsB;IAEtB,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAgB,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;QAC7F,KAAK,EAAE,GAAG;KACX,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAE9E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE;QAC9B,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,GAAG,EAAE,QAAQ,CAAC,UAAU,CAAC;QACzB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IAEH,+EAA+E;IAC/E,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,MAAM,OAAO,GAAG,CAAC,KAAa,EAAQ,EAAE;QACtC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACvC,4EAA4E;YAC5E,SAAS,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,OAAO;QACL,UAAU;QACV,KAAK;QACL,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;QACnB,KAAK,EAAE,GAAG,EAAE;YACV,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1E,SAAS,CAAC,GAAG,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/supervisor/state-files.d.ts

@@ -0,0 +1,33 @@
+import type { RemoteStateFiles } from "../contracts/core.js";
+import type { Profile } from "../profiles/types.js";
+/**
+ * AR: أسماء ملفّات القناة بين المشرف والنواة — نسخة الـ CLI (٠٢٠).
+ *
+ *     **نسختان لا واحدة، والسبب مقيس:** ‎@fantastic/shared-types‎ حزمة أنواع فقط تُشحن مصدرًا خامًّا
+ *     بلا خطوة بناء، فاستيراد **قيمة** منها يفشل عند الإقلاع. والانحراف بين النسختين يمنعه اختبار
+ *     ‎remote-contract.spec.ts‎ الذي يقرأهما ويقارن قيمهما — فاسمٌ يتغيّر هنا وحده يُفشل البناء بدل
+ *     أن يُنتج طلبًا لا يقرؤه أحد.
+ * EN: The names of the supervisor↔core channel files — the CLI's copy (020).
+ *
+ *     **Two copies rather than one, and the reason was measured:** `@fantastic/shared-types` is a
+ *     types-only package shipped as raw source with no build step, so importing a **value** from it
+ *     fails at boot. Drift between the copies is prevented by `remote-contract.spec.ts`, which reads
+ *     both and compares their values — so a name changed here alone fails the build instead of
+ *     producing a request nobody reads.
+ */
+export declare const REMOTE_STATE_FILES: RemoteStateFiles;
+export declare function stateFilePath(profile: Profile, name: string): string;
+/** يقرأ ملفّ JSON من مجلد الحالة، أو ‎null‎ حين لا يوجد أو تعذّرت قراءته. */
+export declare function readStateJson<T>(profile: Profile, name: string): T | null;
+/** يكتب ملفّ JSON ذرّيًّا. */
+export declare function writeStateJson(profile: Profile, name: string, value: unknown): void;
+export declare function removeStateFile(profile: Profile, name: string): void;
+/**
+ * AR: يطالب بملفّ لمرّة واحدة ثم يقرؤه ويحذفه. يعيد ‎null‎ إن لم يكن هناك شيء يُستهلَك.
+ *     المطالبة بإعادة التسمية أولًا هي ما يجعل «مرّة واحدة» صحيحة حتى لو عمل مشرفان بالخطأ.
+ * EN: Claims a one-shot file, reads it, and deletes it. Returns `null` when there is nothing to
+ *     consume. Claiming by renaming first is what makes "once" true even if two supervisors are
+ *     running by mistake.
+ */
+export declare function takeStateJson<T>(profile: Profile, name: string): T | null;
+//# sourceMappingURL=state-files.d.ts.map

package/dist/supervisor/state-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-files.d.ts","sourceRoot":"","sources":["../../src/supervisor/state-files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAMhC,CAAC;AAiCF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CASzE;AAED,8BAA8B;AAC9B,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAOnF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAoBzE"}

package/dist/supervisor/state-files.js

@@ -0,0 +1,110 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * AR: أسماء ملفّات القناة بين المشرف والنواة — نسخة الـ CLI (٠٢٠).
+ *
+ *     **نسختان لا واحدة، والسبب مقيس:** ‎@fantastic/shared-types‎ حزمة أنواع فقط تُشحن مصدرًا خامًّا
+ *     بلا خطوة بناء، فاستيراد **قيمة** منها يفشل عند الإقلاع. والانحراف بين النسختين يمنعه اختبار
+ *     ‎remote-contract.spec.ts‎ الذي يقرأهما ويقارن قيمهما — فاسمٌ يتغيّر هنا وحده يُفشل البناء بدل
+ *     أن يُنتج طلبًا لا يقرؤه أحد.
+ * EN: The names of the supervisor↔core channel files — the CLI's copy (020).
+ *
+ *     **Two copies rather than one, and the reason was measured:** `@fantastic/shared-types` is a
+ *     types-only package shipped as raw source with no build step, so importing a **value** from it
+ *     fails at boot. Drift between the copies is prevented by `remote-contract.spec.ts`, which reads
+ *     both and compares their values — so a name changed here alone fails the build instead of
+ *     producing a request nobody reads.
+ */
+export const REMOTE_STATE_FILES = {
+    restartRequest: "restart.request",
+    restartSchedule: "restart.schedule.json",
+    restartOutcome: "restart.outcome.json",
+    restartLoop: "restart-loop.json",
+    supervisor: "supervisor.json",
+};
+// AR: ملفّات مجلد الحالة التي يتشاركها المشرف والنواة (٠٢٠).
+//
+//     القناة ملفّات لا مقبس، وذلك قرار لا تفصيل: المقبس يموت مع العملية التي وُضع ليتجاوز موتها.
+//     الملف في مجلد الحالة ينجو من موت الطرفين، ويلتقطه أيّ مشرف حيّ بعد ذلك.
+//
+//     **ثلاث قواعد، كلّها مقيسة على عطبٍ صامت:**
+//     ١ — **كل كتابة ذرّية** (مؤقّت ثم ‎rename‎). الطرف الآخر يستقصي كل ثانية، وملفٌّ نصف مكتوب
+//         يُقرأ JSON تالفًا فيُهمَل — أي طلبٌ يختفي بلا رسالة ولا أثر.
+//     ٢ — **القراءة متسامحة.** ملفّ تالف أو ناقص يعني «لا نعرف» لا انهيارًا: المشرف يجب أن يبقى
+//         حيًّا خصوصًا حين يسوء شيء.
+//     ٣ — **الاستهلاك يبدأ بمطالبة.** الطلب يُعاد تسميته إلى اسم خاصّ بنا **قبل** أن يُقرأ. بدون
+//         ذلك يقع سباق: نقرأ، تكتب النواة طلبًا ثانيًا، ثم نحذف — فيضيع طلبٌ لم يُنفَّذ قط.
+//         و‎rename‎ على ويندوز فوق ملفّ موجود ينجح ذرّيًّا، فلا نافذة بين الفحص والفعل.
+//
+// EN: The state-dir files the supervisor and the core share (020).
+//
+//     The channel is files rather than a socket, and that is a decision rather than a detail: a
+//     socket dies with the very process it was put there to outlive. A file in the state dir
+//     survives the death of both sides and is picked up by whichever supervisor is alive next.
+//
+//     **Three rules, each measured against a silent failure:**
+//     1 — **Every write is atomic** (temp then `rename`). The other side polls every second, and a
+//         half-written file parses as broken JSON and is discarded — a request that vanishes with
+//         no message and no trace.
+//     2 — **Reads are forgiving.** A corrupt or missing file means "we do not know", not a crash:
+//         the supervisor must stay alive precisely when something is going wrong.
+//     3 — **Consuming begins by claiming.** The request is renamed to a name of our own **before**
+//         it is read. Without that there is a race: we read, the core writes a second request, we
+//         delete — and a request that was never executed is lost. `rename` over an existing file
+//         succeeds atomically on Windows, so there is no window between checking and acting.
+export function stateFilePath(profile, name) {
+    return join(profile.stateDir, name);
+}
+/** يقرأ ملفّ JSON من مجلد الحالة، أو ‎null‎ حين لا يوجد أو تعذّرت قراءته. */
+export function readStateJson(profile, name) {
+    const path = stateFilePath(profile, name);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** يكتب ملفّ JSON ذرّيًّا. */
+export function writeStateJson(profile, name, value) {
+    const path = stateFilePath(profile, name);
+    mkdirSync(profile.stateDir, { recursive: true });
+    const temporary = `${path}.part`;
+    writeFileSync(temporary, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+    renameSync(temporary, path);
+}
+export function removeStateFile(profile, name) {
+    rmSync(stateFilePath(profile, name), { force: true });
+}
+/**
+ * AR: يطالب بملفّ لمرّة واحدة ثم يقرؤه ويحذفه. يعيد ‎null‎ إن لم يكن هناك شيء يُستهلَك.
+ *     المطالبة بإعادة التسمية أولًا هي ما يجعل «مرّة واحدة» صحيحة حتى لو عمل مشرفان بالخطأ.
+ * EN: Claims a one-shot file, reads it, and deletes it. Returns `null` when there is nothing to
+ *     consume. Claiming by renaming first is what makes "once" true even if two supervisors are
+ *     running by mistake.
+ */
+export function takeStateJson(profile, name) {
+    const path = stateFilePath(profile, name);
+    if (!existsSync(path))
+        return null;
+    const claimed = `${path}.claimed-${process.pid}`;
+    try {
+        renameSync(path, claimed);
+    }
+    catch {
+        // سبقنا إليه أحد، أو اختفى بين الفحص وإعادة التسمية. لا شيء لنا هنا.
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(claimed, "utf8"));
+    }
+    catch {
+        return null;
+    }
+    finally {
+        rmSync(claimed, { force: true });
+    }
+}
+//# sourceMappingURL=state-files.js.map

package/dist/supervisor/state-files.js.map

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

package/dist/supervisor/tree-kill.d.ts

@@ -0,0 +1,14 @@
+export interface TerminateResult {
+    /** هل انتهت العملية فعلًا؟ */
+    terminated: boolean;
+    /** هل اضطررنا للإجبار؟ يُعرض للمستخدم لأنه يعني أن الإغلاق لم يكن مرتّبًا. */
+    forced: boolean;
+}
+/** ينهي عملية وكل ذرّيتها. آمن للاستدعاء على PID غير موجود. */
+export declare function terminateTree(pid: number, graceMs?: number): Promise<TerminateResult>;
+/**
+ * تحرَّر المنفذ فعلًا؟ هذا هو الدليل الحقيقي على نجاح الإيقاف، لا خروج العملية التي أطلقناها:
+ * الإطلاق عبر ‎npm.cmd‎ يضيف طبقة غلاف، فقد يخرج الأب بينما يبقى الحفيد ممسكًا بالمنفذ.
+ */
+export declare function waitForPortRelease(port: number, timeoutMs?: number): Promise<boolean>;
+//# sourceMappingURL=tree-kill.d.ts.map

package/dist/supervisor/tree-kill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-kill.d.ts","sourceRoot":"","sources":["../../src/supervisor/tree-kill.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,+DAA+D;AAC/D,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,SAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CA8B7F;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAS1F"}

package/dist/supervisor/tree-kill.js

@@ -0,0 +1,82 @@
+import { execa } from "execa";
+import { isPortFree } from "../probes/port.probe.js";
+import { readProcessIdentity } from "./process-identity.js";
+// AR: إنهاء شجرة العمليات. ‎process.kill(pid)‎ على ويندوز يقتل الأب وحده، و‎nest start --watch‎
+//     و‎vite‎ كلاهما يولّد أبناء — فإغلاق النافذة يترك ‎node.exe‎ حيًّا وهو ما نراه اليوم.
+//     نحاول الإنهاء المرتّب أولًا لأنه ما يستدعي ‎enableShutdownHooks‎ في NestJS، ثم نُجبر بعد مهلة.
+// EN: Process-tree termination. process.kill(pid) on Windows kills only the parent, and both
+//     `nest start --watch` and `vite` spawn children — which is why closing a window leaves node.exe
+//     alive today. We try an orderly termination first, because that is what triggers NestJS's
+//     enableShutdownHooks, and force only after a grace period.
+/**
+ * مهلة الإنهاء المرتّب قبل الإجبار. قصيرة عن قصد: على ويندوز، عملية منفصلة بلا طرفية لا تستقبل
+ * إشارة ‎taskkill‎ غير المُجبِرة أصلًا، فالانتظار الطويل ضياع خالص — قِيس أن الخدمات الثلاث كلها
+ * تحتاج الإجبار. على أنظمة POSIX يستجيب NestJS لـ SIGTERM في أقل من ثانية، فـ 2.5 ثانية تكفيه.
+ * لذلك «(بالإجبار)» في مخرَج ‎stop‎ على ويندوز هو الوضع الطبيعي لا علامة خلل.
+ */
+const GRACE_MS = 2_500;
+const POLL_MS = 250;
+async function isAlive(pid) {
+    return Boolean(await readProcessIdentity(pid));
+}
+async function taskkill(pid, force) {
+    const args = ["/PID", String(pid), "/T"];
+    if (force)
+        args.push("/F");
+    await execa("taskkill.exe", args, { reject: false, timeout: 10_000 });
+}
+async function waitForExit(pid, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!(await isAlive(pid)))
+            return true;
+        await new Promise((resolvePromise) => setTimeout(resolvePromise, POLL_MS));
+    }
+    return !(await isAlive(pid));
+}
+/** ينهي عملية وكل ذرّيتها. آمن للاستدعاء على PID غير موجود. */
+export async function terminateTree(pid, graceMs = GRACE_MS) {
+    if (!(await isAlive(pid)))
+        return { terminated: true, forced: false };
+    if (process.platform === "win32") {
+        await taskkill(pid, false);
+        if (await waitForExit(pid, graceMs))
+            return { terminated: true, forced: false };
+        await taskkill(pid, true);
+        return { terminated: await waitForExit(pid, graceMs), forced: true };
+    }
+    try {
+        process.kill(-pid, "SIGTERM");
+    }
+    catch {
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch {
+            // العملية اختفت بين الفحص والإشارة. لا شيء نفعله.
+        }
+    }
+    if (await waitForExit(pid, graceMs))
+        return { terminated: true, forced: false };
+    try {
+        process.kill(-pid, "SIGKILL");
+    }
+    catch {
+        // كما أعلاه.
+    }
+    return { terminated: await waitForExit(pid, graceMs), forced: true };
+}
+/**
+ * تحرَّر المنفذ فعلًا؟ هذا هو الدليل الحقيقي على نجاح الإيقاف، لا خروج العملية التي أطلقناها:
+ * الإطلاق عبر ‎npm.cmd‎ يضيف طبقة غلاف، فقد يخرج الأب بينما يبقى الحفيد ممسكًا بالمنفذ.
+ */
+export async function waitForPortRelease(port, timeoutMs = 8_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await isPortFree(port))
+            return true;
+        await new Promise((resolvePromise) => setTimeout(resolvePromise, POLL_MS));
+    }
+    return isPortFree(port);
+}
+//# sourceMappingURL=tree-kill.js.map

package/dist/supervisor/tree-kill.js.map

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

package/dist/ui/health-panel.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import type { Profile } from "../profiles/types.js";
+export interface PanelProps {
+    profile: Profile;
+    intervalMs: number;
+}
+export declare function HealthPanel({ profile, intervalMs }: PanelProps): React.JSX.Element;
+//# sourceMappingURL=health-panel.d.ts.map

package/dist/ui/health-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-panel.d.ts","sourceRoot":"","sources":["../../src/ui/health-panel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAKnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA8DpD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AASD,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA8HlF"}

package/dist/ui/health-panel.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+import { fetchInternalHealth } from "../probes/internal.client.js";
+import { inspectServices } from "../supervisor/inspect.js";
+// AR: لوحة الصحة الحيّة.
+//
+//     **قاعدتها الحاكمة: الحقل الذي لا تُبلِغ عنه النواة يُرسَم شرطةً، لا صفرًا** (017/FR-012).
+//     الصفر ادّعاء والشرطة إقرار، والفرق بينهما هو الفرق بين لوحة تُصدَّق ولوحة تُخمِّن.
+//
+//     **ولا تنهار حين تسقط خدمة.** ‎doctor‎ يُستدعى وقت العطل، وهذه اللوحة تُفتَح وقته أيضًا؛ لوحةٌ
+//     تموت مع أوّل خدمة تسقط عديمة الفائدة في اللحظة التي تُحتاج فيها. كل جلب ملفوف، والفشل يصير
+//     حالةَ عرضٍ لا استثناءً.
+// EN: The live health panel.
+//
+//     **Its governing rule: a field the core does not report renders as a dash, never a zero**
+//     (017/FR-012). A zero is a claim, a dash is an admission, and the difference between them is
+//     the difference between a panel that can be believed and one that guesses.
+//
+//     **And it does not die when a service does.** `doctor` is called when something is broken, and
+//     this panel is opened then too; a panel that dies with the first failing service is useless at
+//     the exact moment it is needed. Every fetch is wrapped and failure becomes a display state.
+const DASH = "—";
+function dash(value, suffix = "") {
+    if (value === undefined || value === null)
+        return DASH;
+    return `${value}${suffix}`;
+}
+function duration(seconds) {
+    if (seconds === undefined)
+        return DASH;
+    const days = Math.floor(seconds / 86_400);
+    const hours = Math.floor((seconds % 86_400) / 3_600);
+    const minutes = Math.floor((seconds % 3_600) / 60);
+    const pad = (value) => String(value).padStart(2, "0");
+    return `${days > 0 ? `${days}d ` : ""}${pad(hours)}:${pad(minutes)}`;
+}
+function bytes(value) {
+    if (value === undefined)
+        return DASH;
+    const units = ["B", "KB", "MB", "GB", "TB"];
+    let size = value;
+    let unit = 0;
+    while (size >= 1024 && unit < units.length - 1) {
+        size /= 1024;
+        unit += 1;
+    }
+    return `${size.toFixed(unit === 0 ? 0 : 1)} ${units[unit]}`;
+}
+function Row({ label, children }) {
+    return (_jsxs(Box, { children: [_jsx(Box, { width: 18, children: _jsx(Text, { dimColor: true, children: label }) }), _jsx(Text, { children: children })] }));
+}
+export function HealthPanel({ profile, intervalMs }) {
+    const { exit } = useApp();
+    const [state, setState] = useState({ services: [], refreshedAt: new Date() });
+    useInput((input, key) => {
+        if (input === "q" || key.escape || (key.ctrl && input === "c"))
+            exit();
+    });
+    useEffect(() => {
+        let live = true;
+        const tick = async () => {
+            // العمليات من الـ CLI نفسه، والبيانات من النواة: كلٌّ يجيب عمّا يملكه.
+            const services = await inspectServices(profile).catch(() => []);
+            const health = await fetchInternalHealth(profile).catch(() => undefined);
+            if (!live)
+                return;
+            setState({
+                services,
+                snapshot: health?.ok ? health.data : undefined,
+                unreachable: health && !health.ok ? health.reason : undefined,
+                refreshedAt: new Date(),
+            });
+        };
+        void tick();
+        const timer = setInterval(() => void tick(), intervalMs);
+        return () => {
+            live = false;
+            clearInterval(timer);
+        };
+    }, [profile, intervalMs]);
+    const { snapshot, services, unreachable } = state;
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "yellow", paddingX: 1, children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsx(Text, { bold: true, color: "yellow", children: "FANTASTIC" }), _jsxs(Text, { dimColor: true, children: [profile.kind, " \u00B7 v", snapshot?.version ?? DASH] })] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: services.length === 0 ? (_jsx(Text, { dimColor: true, children: "no services in this profile" })) : (services.map((service) => (_jsxs(Box, { children: [_jsx(Box, { width: 18, children: _jsx(Text, { dimColor: true, children: service.definition.label }) }), _jsx(Text, { color: service.running ? "green" : "red", children: service.running ? "● running" : "○ stopped" }), _jsxs(Text, { dimColor: true, children: ["  ", ":", service.definition.port, " ", "  ", duration(service.uptimeSeconds)] })] }, service.definition.name)))) }), unreachable ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", children: ["core unreachable \u2014 ", unreachable] }) })) : (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Row, { label: "Transcode", children: snapshot?.transcode
+                            ? `${snapshot.transcode.running} / ${snapshot.transcode.capacity} slots   queued ${snapshot.transcode.queued}`
+                            : DASH }), _jsx(Row, { label: "Active streams", children: snapshot?.streams
+                            ? `${snapshot.streams.active}   direct ${snapshot.streams.direct} · hls ${snapshot.streams.transcoded}`
+                            : DASH }), _jsx(Row, { label: "Library", children: snapshot?.library
+                            ? `${snapshot.library.titles} titles · ${snapshot.library.sections} sections`
+                            : DASH }), _jsx(Row, { label: "Downloads", children: dash(snapshot?.activeDownloads) })] })), _jsx(Box, { marginTop: 1, flexDirection: "column", children: (snapshot?.drives ?? []).length === 0 ? (_jsx(Row, { label: "Drives", children: DASH })) : ((snapshot?.drives ?? []).map((drive, index) => (_jsxs(Box, { children: [_jsx(Box, { width: 18, children: _jsx(Text, { dimColor: true, children: drive.mountPath ?? DASH }) }), _jsx(Text, { color: drive.present ? "green" : "red", children: drive.present ? "● online " : "○ missing" }), _jsxs(Text, { dimColor: true, children: ["  ", bytes(drive.freeBytes), " free \u00B7 ", drive.sectionCount, " section(s)"] })] }, `${drive.label}-${index}`)))) }), _jsx(Box, { marginTop: 1, children: _jsx(Row, { label: "Licence", children: _jsxs(Text, { dimColor: true, children: [DASH, " (not implemented yet)"] }) }) }), _jsxs(Box, { marginTop: 1, justifyContent: "space-between", children: [_jsx(Text, { dimColor: true, children: "q quit" }), _jsxs(Text, { dimColor: true, children: ["refreshed ", state.refreshedAt.toLocaleTimeString()] })] })] }));
+}
+//# sourceMappingURL=health-panel.js.map

package/dist/ui/health-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-panel.js","sourceRoot":"","sources":["../../src/ui/health-panel.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAqB,MAAM,0BAA0B,CAAC;AAG9E,yBAAyB;AACzB,EAAE;AACF,gGAAgG;AAChG,yFAAyF;AACzF,EAAE;AACF,oGAAoG;AACpG,iGAAiG;AACjG,8BAA8B;AAC9B,6BAA6B;AAC7B,EAAE;AACF,+FAA+F;AAC/F,kGAAkG;AAClG,gFAAgF;AAChF,EAAE;AACF,oGAAoG;AACpG,oGAAoG;AACpG,iGAAiG;AAEjG,MAAM,IAAI,GAAG,GAAG,CAAC;AAEjB,SAAS,IAAI,CAAC,KAAyC,EAAE,MAAM,GAAG,EAAE;IAClE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,GAAG,KAAK,GAAG,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,OAA2B;IAC3C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEtE,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,KAAK,CAAC,KAAyB;IACtC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,IAAI,IAAI,CAAC;QACb,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAgD;IAC5E,OAAO,CACL,MAAC,GAAG,eACF,KAAC,GAAG,IAAC,KAAK,EAAE,EAAE,YACZ,KAAC,IAAI,IAAC,QAAQ,kBAAE,KAAK,GAAQ,GACzB,EACN,KAAC,IAAI,cAAE,QAAQ,GAAQ,IACnB,CACP,CAAC;AACJ,CAAC;AAcD,MAAM,UAAU,WAAW,CAAC,EAAE,OAAO,EAAE,UAAU,EAAc;IAC7D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAE1F,QAAQ,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,IAAI,KAAK,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC;YAAE,IAAI,EAAE,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,GAAG,IAAI,CAAC;QAEhB,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;YACrC,uEAAuE;YACvE,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAoB,CAAC,CAAC;YAClF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAEzE,IAAI,CAAC,IAAI;gBAAE,OAAO;YAElB,QAAQ,CAAC;gBACP,QAAQ;gBACR,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAC9C,WAAW,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBAC7D,WAAW,EAAE,IAAI,IAAI,EAAE;aACxB,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,KAAK,IAAI,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;QAEzD,OAAO,GAAG,EAAE;YACV,IAAI,GAAG,KAAK,CAAC;YACb,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAE1B,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAElD,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,WAAW,EAAC,OAAO,EAAC,WAAW,EAAC,QAAQ,EAAC,QAAQ,EAAE,CAAC,aAC9E,MAAC,GAAG,IAAC,cAAc,EAAC,eAAe,aACjC,KAAC,IAAI,IAAC,IAAI,QAAC,KAAK,EAAC,QAAQ,0BAElB,EACP,MAAC,IAAI,IAAC,QAAQ,mBACX,OAAO,CAAC,IAAI,eAAM,QAAQ,EAAE,OAAO,IAAI,IAAI,IACvC,IACH,EAEN,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,YACtC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACvB,KAAC,IAAI,IAAC,QAAQ,kDAAmC,CAClD,CAAC,CAAC,CAAC,CACF,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACxB,MAAC,GAAG,eACF,KAAC,GAAG,IAAC,KAAK,EAAE,EAAE,YACZ,KAAC,IAAI,IAAC,QAAQ,kBAAE,OAAO,CAAC,UAAU,CAAC,KAAK,GAAQ,GAC5C,EACN,KAAC,IAAI,IAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,YAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,GAAQ,EACpG,MAAC,IAAI,IAAC,QAAQ,mBACX,IAAI,OAAG,OAAO,CAAC,UAAU,CAAC,IAAI,OAAG,IAAI,EACrC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,IAC3B,KARC,OAAO,CAAC,UAAU,CAAC,IAAI,CAS3B,CACP,CAAC,CACH,GACG,EAEL,WAAW,CAAC,CAAC,CAAC,CACb,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YACf,MAAC,IAAI,IAAC,KAAK,EAAC,KAAK,yCAAqB,WAAW,IAAQ,GACrD,CACP,CAAC,CAAC,CAAC,CACF,MAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,aACvC,KAAC,GAAG,IAAC,KAAK,EAAC,WAAW,YACnB,QAAQ,EAAE,SAAS;4BAClB,CAAC,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,MAAM,QAAQ,CAAC,SAAS,CAAC,QAAQ,mBAAmB,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;4BAC9G,CAAC,CAAC,IAAI,GACJ,EACN,KAAC,GAAG,IAAC,KAAK,EAAC,gBAAgB,YACxB,QAAQ,EAAE,OAAO;4BAChB,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,aAAa,QAAQ,CAAC,OAAO,CAAC,MAAM,UAAU,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE;4BACvG,CAAC,CAAC,IAAI,GACJ,EACN,KAAC,GAAG,IAAC,KAAK,EAAC,SAAS,YACjB,QAAQ,EAAE,OAAO;4BAChB,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,aAAa,QAAQ,CAAC,OAAO,CAAC,QAAQ,WAAW;4BAC7E,CAAC,CAAC,IAAI,GACJ,EACN,KAAC,GAAG,IAAC,KAAK,EAAC,WAAW,YAAE,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,GAAO,IAC1D,CACP,EAED,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,YACtC,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACvC,KAAC,GAAG,IAAC,KAAK,EAAC,QAAQ,YAAE,IAAI,GAAO,CACjC,CAAC,CAAC,CAAC,CACF,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAC7C,MAAC,GAAG,eACF,KAAC,GAAG,IAAC,KAAK,EAAE,EAAE,YACZ,KAAC,IAAI,IAAC,QAAQ,kBAAE,KAAK,CAAC,SAAS,IAAI,IAAI,GAAQ,GAC3C,EACN,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,YAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,GAAQ,EAChG,MAAC,IAAI,IAAC,QAAQ,mBACX,IAAI,EACJ,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,mBAAU,KAAK,CAAC,YAAY,mBAC9C,KARC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,EAAE,CAS7B,CACP,CAAC,CACH,GACG,EAEN,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YAEf,KAAC,GAAG,IAAC,KAAK,EAAC,SAAS,YAClB,MAAC,IAAI,IAAC,QAAQ,mBACX,IAAI,8BACA,GACH,GACF,EAEN,MAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,cAAc,EAAC,eAAe,aAC/C,KAAC,IAAI,IAAC,QAAQ,6BAAc,EAC5B,MAAC,IAAI,IAAC,QAAQ,iCAAY,KAAK,CAAC,WAAW,CAAC,kBAAkB,EAAE,IAAQ,IACpE,IACF,CACP,CAAC;AACJ,CAAC"}

package/dist/updating/apply.d.ts

@@ -0,0 +1,50 @@
+/**
+ * AR: أين يُركَّب كل مكوّن. **‎assets‎ غائب عمدًا**: تخطيط الحزمة في ‎layout.ts‎ لا يعرّف له
+ *     مجلدًا، وتخمينُ مسارٍ يعني فكّ آلاف الملفّات في مكانٍ لا يقرؤه شيء — تحديثٌ يُعلَن
+ *     ناجحًا ولا يغيّر شيئًا. يُرفَض برسالة صريحة حتى يُعرَّف موضعه.
+ * EN: Where each component installs. **`assets` is deliberately absent**: the bundle layout in
+ *     `layout.ts` defines no directory for it, and guessing a path means unpacking thousands of
+ *     files somewhere nothing reads — an update reported as successful that changes nothing. It is
+ *     refused with a clear message until its location is defined.
+ */
+export declare const COMPONENT_TARGET: Record<string, string>;
+export type SwapHandle = {
+    component: string;
+    /** المجلد الحيّ: ‎<root>/core‎. */
+    target: string;
+    /** الشجرة السابقة بعد إزاحتها: ‎<root>/core.prev-0.20.0‎. */
+    previous: string;
+};
+export declare function targetFor(root: string, component: string): string | undefined;
+/**
+ * AR: يزيح الشجرة القائمة جانبًا ويعيد مقبضًا يتيح التراجع.
+ *
+ *     **إعادة التسمية على ويندوز تفشل أحيانًا بلا سبب دائم**: مضادّ فيروسات أو مفهرس يمسك
+ *     ملفًّا لأجزاء من الثانية بعد إيقاف الخدمة. محاولةٌ واحدة كانت ستُفشل تحديثًا سليمًا،
+ *     فتُعاد المحاولة قليلًا قبل الاستسلام.
+ * EN: Moves the existing tree aside and returns a handle that makes rollback possible.
+ *
+ *     **Renaming on Windows fails intermittently for no lasting reason**: an antivirus or the
+ *     indexer holds a file for fractions of a second after the service stops. A single attempt
+ *     would fail a perfectly good update, so it retries briefly before giving up.
+ */
+export declare function swapAside(root: string, component: string, currentVersion: string): Promise<SwapHandle>;
+/**
+ * AR: يفكّ الحزمة في موضع المكوّن.
+ *
+ *     **يرفض أي مدخل يخرج من الوجهة.** أسماء المدخلات داخل الزِب يكتبها من صنعها، و
+ *     ‎..\..\runtime\node.exe‎ اسمُ مدخلٍ صالح تمامًا — فبدون هذا الحارس تستطيع حزمةٌ موقَّعة
+ *     أن تكتب خارج مجلدها. التوقيع يثبت أن الحزمة منّا، ولا يثبت أن من بناها لم يخطئ.
+ * EN: Unpacks the bundle into the component's place.
+ *
+ *     **Refuses any entry that escapes the destination.** Entry names inside a zip are written by
+ *     whoever made it, and `..\..\runtime\node.exe` is a perfectly valid one — so without this
+ *     guard a signed bundle could write outside its directory. The signature proves the bundle is
+ *     ours; it does not prove whoever built it made no mistake.
+ */
+export declare function extractInto(archive: string, destination: string): Promise<number>;
+/** يتراجع: يحذف الجديد ويعيد القديم إلى مكانه. */
+export declare function undoSwap(handle: SwapHandle): Promise<void>;
+/** يثبّت النجاح: تُزال الشجرة السابقة. تُنادى **بعد** فحص الصحة لا قبله. */
+export declare function discardPrevious(handle: SwapHandle): void;
+//# sourceMappingURL=apply.d.ts.map

package/dist/updating/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/updating/apply.ts"],"names":[],"mappings":"AAgCA;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAInD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC,CAYrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDvF;AAED,kDAAkD;AAClD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAExD"}