@wasmsoft/fantastic 1.0.0

package/dist/supervisor/monitor.js

@@ -0,0 +1,141 @@
+import { probeService } from "../probes/service.probe.js";
+import { startServices } from "./orchestrator.js";
+import { REMOTE_STATE_FILES, removeStateFile, writeStateJson } from "./state-files.js";
+// AR: حلقة المراقبة والإحياء (٠٢٠/US1).
+//
+//     **الخدمة الميّتة تُحيا، والخدمة التي تموت مرارًا تُترَك.** الجملتان معًا لا إحداهما: الأولى
+//     هي الميزة، والثانية هي ما يمنع الميزة من أن تصير عطلًا. خدمةٌ تفشل عند الإقلاع — منفذ محجوز،
+//     قاعدة تالفة، قرص امتلأ — تُحيا كل عشرين ثانية إلى الأبد، فتُغرق السجلّ وتستهلك المعالج وتخفي
+//     السبب الجذري خلف ضجيج محاولات لا تنتهي. الحارس يوقف الدورة **ويترك أثرًا مقروءًا**: العطل
+//     الظاهر أنفع من إخفاءٍ نشيط.
+//
+//     **ولماذا فشلان متتاليان قبل الإحياء؟** لأن مسبارًا واحدًا يفشل لأسباب لا علاقة لها بموت
+//     الخدمة: النواة مشغولة بفحص مكتبة، أو ‎ffmpeg‎ يستهلك المعالج، أو المهلة انتهت بفارق أجزاء من
+//     الثانية. إحياءُ خدمة حيّة يقطع ضيفًا يشاهد — أي أن الدواء يصير الداء.
+//
+// EN: The monitor-and-revive loop (020/US1).
+//
+//     **A dead service is revived, and a service that keeps dying is left alone.** Both sentences,
+//     not one: the first is the feature and the second is what stops the feature from becoming the
+//     fault. A service failing at boot — a held port, a corrupt database, a full disk — would be
+//     revived every twenty seconds forever, flooding the log, burning CPU and hiding the root cause
+//     behind the noise of endless attempts. The guard stops the cycle **and leaves a readable
+//     trace**: a visible fault is more useful than active concealment.
+//
+//     **And why two consecutive failures before reviving?** Because a single probe fails for reasons
+//     that have nothing to do with a dead service: the core is busy scanning a library, `ffmpeg` is
+//     saturating the CPU, or the timeout expired by a fraction of a second. Reviving a live service
+//     cuts off a watching guest — the cure becomes the disease.
+/** كم فشلًا متتاليًا قبل أن نعدّ الخدمة ميّتة. */
+export const FAILURES_BEFORE_REVIVAL = 2;
+/** نافذة الحارس وحدّها: أكثر من ثلاث إحياءات في عشر دقائق يعني عطلًا لا حادثة. */
+export const REVIVAL_LIMIT = 3;
+export const REVIVAL_WINDOW_MS = 10 * 60_000;
+/**
+ * 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 class RevivalGuard {
+    limit;
+    windowMs;
+    revivals = new Map();
+    stopped = new Set();
+    constructor(limit = REVIVAL_LIMIT, windowMs = REVIVAL_WINDOW_MS) {
+        this.limit = limit;
+        this.windowMs = windowMs;
+    }
+    /** هل توقّفنا عن إحياء هذه الخدمة؟ */
+    isStopped(service) {
+        return this.stopped.has(service);
+    }
+    /**
+     * يسجّل محاولة إحياء ويقرّر مصيرها. **يُستدعى مرّة لكل محاولة** — استدعاؤه للاستعلام وحده
+     * يفسد العدّ.
+     */
+    record(service, now) {
+        if (this.stopped.has(service))
+            return { revive: false, looping: false, attempts: this.limit };
+        const recent = (this.revivals.get(service) ?? []).filter((at) => now - at < this.windowMs);
+        recent.push(now);
+        this.revivals.set(service, recent);
+        // المحاولة التي تتجاوز الحدّ **لا تُنفَّذ**: تجاوز الحدّ هو نفسه سبب التوقّف.
+        if (recent.length > this.limit) {
+            this.stopped.add(service);
+            return { revive: false, looping: true, attempts: recent.length };
+        }
+        return { revive: true, looping: false, attempts: recent.length };
+    }
+    /** يمسح تاريخ خدمة عادت واستقرّت — أو أعاد المالك تشغيلها بيده. */
+    clear(service) {
+        this.revivals.delete(service);
+        this.stopped.delete(service);
+    }
+}
+/**
+ * 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 class ServiceMonitor {
+    profile;
+    options;
+    failures = new Map();
+    guard;
+    constructor(profile, options = {}) {
+        this.profile = profile;
+        this.options = options;
+        this.guard = options.guard ?? new RevivalGuard();
+    }
+    async round(now = Date.now()) {
+        for (const definition of this.profile.services) {
+            await this.check(definition, now);
+        }
+    }
+    async check(definition, now) {
+        const probe = await probeService(definition, 2_000);
+        if (probe.reachable) {
+            const wasFailing = (this.failures.get(definition.name) ?? 0) >= FAILURES_BEFORE_REVIVAL;
+            this.failures.set(definition.name, 0);
+            if (wasFailing) {
+                // عادت من تلقائها أو بعد إحيائنا: نمسح تاريخها فلا يُحسَب عطلٌ قديم ضدّ عطلٍ جديد بعد شهر.
+                this.guard.clear(definition.name);
+                removeStateFile(this.profile, REMOTE_STATE_FILES.restartLoop);
+                this.emit(definition.name, "recovered", `${definition.label} is answering again`);
+            }
+            return;
+        }
+        const failures = (this.failures.get(definition.name) ?? 0) + 1;
+        this.failures.set(definition.name, failures);
+        if (failures < FAILURES_BEFORE_REVIVAL)
+            return;
+        const decision = this.guard.record(definition.name, now);
+        if (decision.looping) {
+            const loop = {
+                service: definition.name,
+                attempts: decision.attempts - 1,
+                windowMinutes: Math.round(REVIVAL_WINDOW_MS / 60_000),
+                stoppedAt: new Date(now).toISOString(),
+            };
+            writeStateJson(this.profile, REMOTE_STATE_FILES.restartLoop, loop);
+            this.emit(definition.name, "loop-stopped", `${definition.label} failed ${loop.attempts} times in ${loop.windowMinutes} minutes — no longer reviving it`);
+            return;
+        }
+        if (!decision.revive)
+            return;
+        const outcome = await startServices(this.profile, { only: [definition.name] });
+        const ok = outcome.ok;
+        if (ok)
+            this.failures.set(definition.name, 0);
+        this.emit(definition.name, ok ? "revived" : "revival-failed", ok
+            ? `${definition.label} was not answering and has been restarted (attempt ${decision.attempts})`
+            : `${definition.label} did not come back: ${outcome.steps.at(-1)?.readiness?.reason ?? "unknown reason"}`);
+    }
+    emit(service, kind, detail) {
+        this.options.onEvent?.({ service, kind, detail });
+    }
+}
+//# sourceMappingURL=monitor.js.map

package/dist/supervisor/monitor.js.map

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

package/dist/supervisor/orchestrator.d.ts

@@ -0,0 +1,52 @@
+import type { Profile, ServiceDefinition, ServiceName } from "../profiles/types.js";
+import { type PortConflict } from "../probes/port.probe.js";
+import { type ReadinessOutcome } from "./readiness.js";
+export type StepStatus = "started" | "already-running" | "failed" | "skipped";
+export interface StartStep {
+    definition: ServiceDefinition;
+    status: StepStatus;
+    pid?: number;
+    readiness?: ReadinessOutcome;
+}
+export interface StartOutcome {
+    steps: StartStep[];
+    conflicts: PortConflict[];
+    ok: boolean;
+}
+export interface StartOptions {
+    /** قصر التشغيل على خدمات بعينها. الترتيب يبقى ترتيب ملفّ التشغيل. */
+    only?: ServiceName[];
+    onStep?: (definition: ServiceDefinition, phase: "starting" | "waiting" | "done") => void;
+}
+export declare function startServices(profile: Profile, options?: StartOptions): Promise<StartOutcome>;
+export interface StopStep {
+    definition: ServiceDefinition;
+    /** كانت تعمل قبل الأمر؟ */
+    wasRunning: boolean;
+    terminated: boolean;
+    forced: boolean;
+    /** تحرَّر المنفذ فعلًا؟ الدليل الحقيقي على نجاح الإيقاف. */
+    portReleased: boolean;
+    /** تعمل لكن لم نُطلقها نحن، فلا نملك سجلًّا نقتل به. */
+    foreign: boolean;
+    /** أوقفناها رغم أننا لم نُطلقها (‎--force‎): تُعرَض بوضوح لأنها تخصّ نافذة أخرى. */
+    adopted: boolean;
+    /** تعمل، ولم نُطلقها، ولم نتعرّف على العملية التي تحجز المنفذ. */
+    holderUnknown: boolean;
+}
+export interface StopOptions {
+    only?: ServiceName[];
+    /**
+     * يوقف ما يحجز منفذ الخدمة ولو لم يُطلقه الـ CLI.
+     * الافتراضي **لا يفعل**: مشرف عمليات يقتل ما لم يُطلقه هو خطر — قد يكون خادمًا شغّلته يدويًا في
+     * نافذة أخرى، أو عمليةً لا تخصّ المشروع أصلًا تصادف أنها تستمع على المنفذ نفسه.
+     * ومع ذلك بدون هذا العَلَم يبقى المستخدم بلا وسيلة لإيقاف ما شغّله بيده، فيُتاح صراحةً.
+     */
+    force?: boolean;
+}
+export declare function stopServices(profile: Profile, options?: StopOptions): Promise<StopStep[]>;
+export declare function restartServices(profile: Profile, options?: StartOptions & StopOptions): Promise<{
+    stopped: StopStep[];
+    started: StartOutcome;
+}>;
+//# sourceMappingURL=orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/supervisor/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAK/F,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAWrE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,iBAAiB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9E,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,KAAK,IAAI,CAAC;CAC1F;AAgBD,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,YAAY,CAAC,CA0DvB;AASD,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,2BAA2B;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,4DAA4D;IAC5D,YAAY,EAAE,OAAO,CAAC;IACtB,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAyFnG;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,YAAY,GAAG,WAAgB,GACvC,OAAO,CAAC;IAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAIzD"}

package/dist/supervisor/orchestrator.js

@@ -0,0 +1,154 @@
+import { findPortConflicts, findPortHolder } from "../probes/port.probe.js";
+import { probeService } from "../probes/service.probe.js";
+import { readVerifiedPidRecord, removePidRecord } from "./pidfile.js";
+import { launchDetached } from "./spawn.js";
+import { isRecordedProcessAlive } from "./process-identity.js";
+import { waitForReady } from "./readiness.js";
+import { terminateTree, waitForPortRelease } from "./tree-kill.js";
+function selectServices(profile, only) {
+    if (!only || only.length === 0)
+        return profile.services;
+    return profile.services.filter((service) => only.includes(service.name));
+}
+/** هل الخدمة تعمل أصلًا؟ نسأل السجلّ والمسبار معًا كما يفعل ‎status‎. */
+async function alreadyRunning(profile, definition) {
+    const record = await readVerifiedPidRecord(profile, definition.name);
+    if (record)
+        return true;
+    const probe = await probeService(definition, 1_500);
+    return probe.reachable;
+}
+export async function startServices(profile, options = {}) {
+    const targets = selectServices(profile, options.only);
+    const steps = [];
+    // الفحص المسبق للمنافذ يسبق أي إطلاق: رفض واضح يسمّي صاحب المنفذ أنفع من EADDRINUSE خام.
+    // نستثني الخدمات التي تعمل أصلًا، فمنفذها محجوز بها هي لا بغريب.
+    const runningFlags = await Promise.all(targets.map(async (definition) => ({ definition, running: await alreadyRunning(profile, definition) })));
+    const portsToCheck = runningFlags
+        .filter((entry) => !entry.running)
+        .map((entry) => entry.definition.port);
+    const conflicts = await findPortConflicts(portsToCheck);
+    if (conflicts.length > 0) {
+        return { steps, conflicts, ok: false };
+    }
+    const started = [];
+    for (const { definition, running } of runningFlags) {
+        if (running) {
+            steps.push({ definition, status: "already-running" });
+            continue;
+        }
+        options.onStep?.(definition, "starting");
+        const record = await launchDetached(profile, definition);
+        options.onStep?.(definition, "waiting");
+        const readiness = await waitForReady(definition, {
+            logDir: profile.logDir,
+            stillRunning: () => isRecordedProcessAlive(record),
+        });
+        if (!readiness.ready) {
+            steps.push({ definition, status: "failed", pid: record.pid, readiness });
+            // تراجع نظيف: نُسقط ما أقلعناه في هذه الجولة فلا نترك نظامًا نصف قائم.
+            await stopStarted(profile, started);
+            for (const remaining of targets.slice(targets.indexOf(definition) + 1)) {
+                steps.push({ definition: remaining, status: "skipped" });
+            }
+            return { steps, conflicts, ok: false };
+        }
+        const step = { definition, status: "started", pid: record.pid, readiness };
+        steps.push(step);
+        started.push(step);
+        options.onStep?.(definition, "done");
+    }
+    return { steps, conflicts, ok: true };
+}
+async function stopStarted(profile, steps) {
+    for (const step of [...steps].reverse()) {
+        if (step.pid)
+            await terminateTree(step.pid);
+        removePidRecord(profile, step.definition.name);
+    }
+}
+export async function stopServices(profile, options = {}) {
+    // الإيقاف يعكس ترتيب الإقلاع: نُسقط الواجهة أولًا فلا يصل طلب إلى خدمة تُغلَق تحته.
+    const targets = selectServices(profile, options.only).slice().reverse();
+    const results = [];
+    for (const definition of targets) {
+        const record = await readVerifiedPidRecord(profile, definition.name);
+        if (!record) {
+            const probe = await probeService(definition, 1_500);
+            if (!probe.reachable) {
+                results.push({
+                    definition,
+                    wasRunning: false,
+                    terminated: false,
+                    forced: false,
+                    portReleased: true,
+                    foreign: false,
+                    adopted: false,
+                    holderUnknown: false,
+                });
+                continue;
+            }
+            // خدمة حيّة بلا سجلّ: أطلقها غيرنا. لا نقتل ما لم نُطلق إلا بطلب صريح (‎--force‎).
+            if (!options.force) {
+                results.push({
+                    definition,
+                    wasRunning: true,
+                    terminated: false,
+                    forced: false,
+                    portReleased: false,
+                    foreign: true,
+                    adopted: false,
+                    holderUnknown: false,
+                });
+                continue;
+            }
+            const holder = await findPortHolder(definition.port);
+            if (!holder) {
+                results.push({
+                    definition,
+                    wasRunning: true,
+                    terminated: false,
+                    forced: false,
+                    portReleased: false,
+                    foreign: true,
+                    adopted: false,
+                    holderUnknown: true,
+                });
+                continue;
+            }
+            const { terminated, forced } = await terminateTree(holder.pid);
+            const portReleased = await waitForPortRelease(definition.port);
+            results.push({
+                definition,
+                wasRunning: true,
+                terminated,
+                forced,
+                portReleased,
+                foreign: true,
+                adopted: true,
+                holderUnknown: false,
+            });
+            continue;
+        }
+        const { terminated, forced } = await terminateTree(record.pid);
+        removePidRecord(profile, definition.name);
+        const portReleased = await waitForPortRelease(definition.port);
+        results.push({
+            definition,
+            wasRunning: true,
+            terminated,
+            forced,
+            portReleased,
+            foreign: false,
+            adopted: false,
+            holderUnknown: false,
+        });
+    }
+    return results;
+}
+export async function restartServices(profile, options = {}) {
+    const stopped = await stopServices(profile, { only: options.only });
+    const started = await startServices(profile, options);
+    return { stopped, started };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/supervisor/orchestrator.js.map

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

package/dist/supervisor/pidfile.d.ts

@@ -0,0 +1,21 @@
+import type { Profile, ServiceName } from "../profiles/types.js";
+export interface PidRecord {
+    service: ServiceName;
+    pid: number;
+    port: number;
+    profile: Profile["kind"];
+    /** وقت بدء العملية كما قرأه النظام. هذا ما يميّز عمليتنا عن PID أُعيد استعماله. */
+    startedAt: string;
+    commandLine: string;
+    /** وقت كتابة السجلّ. يُستعمل لعرض مدة التشغيل حين لا يتوفّر وقت البدء الحقيقي. */
+    writtenAt: string;
+}
+export declare function writePidRecord(profile: Profile, record: PidRecord): void;
+export declare function readPidRecord(profile: Profile, service: ServiceName): PidRecord | undefined;
+export declare function removePidRecord(profile: Profile, service: ServiceName): void;
+/**
+ * يقرأ السجلّ **ويتحقّق منه**. السجلّ الذي لم تعد عمليته حيّة (أو صار الـ PID لعملية أخرى) يُحذف
+ * ويُعامَل كغير موجود، فلا يتراكم على القرص ولا يخدع أمرًا لاحقًا.
+ */
+export declare function readVerifiedPidRecord(profile: Profile, service: ServiceName): Promise<PidRecord | undefined>;
+//# sourceMappingURL=pidfile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pidfile.d.ts","sourceRoot":"","sources":["../../src/supervisor/pidfile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAQjE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAGxE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAU3F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAE5E;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAQhC"}

package/dist/supervisor/pidfile.js

@@ -0,0 +1,39 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { isRecordedProcessAlive } from "./process-identity.js";
+function recordPath(profile, service) {
+    return join(profile.runDir, `${service}.json`);
+}
+export function writePidRecord(profile, record) {
+    mkdirSync(profile.runDir, { recursive: true });
+    writeFileSync(recordPath(profile, record.service), JSON.stringify(record, null, 2), "utf8");
+}
+export function readPidRecord(profile, service) {
+    const path = recordPath(profile, service);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        // سجلّ تالف يُعامَل كغير موجود: الأمر يمضي بالسبر بدل أن يفشل.
+        return undefined;
+    }
+}
+export function removePidRecord(profile, service) {
+    rmSync(recordPath(profile, service), { force: true });
+}
+/**
+ * يقرأ السجلّ **ويتحقّق منه**. السجلّ الذي لم تعد عمليته حيّة (أو صار الـ PID لعملية أخرى) يُحذف
+ * ويُعامَل كغير موجود، فلا يتراكم على القرص ولا يخدع أمرًا لاحقًا.
+ */
+export async function readVerifiedPidRecord(profile, service) {
+    const record = readPidRecord(profile, service);
+    if (!record)
+        return undefined;
+    if (await isRecordedProcessAlive(record))
+        return record;
+    removePidRecord(profile, service);
+    return undefined;
+}
+//# sourceMappingURL=pidfile.js.map

package/dist/supervisor/pidfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pidfile.js","sourceRoot":"","sources":["../../src/supervisor/pidfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAmB/D,SAAS,UAAU,CAAC,OAAgB,EAAE,OAAoB;IACxD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,MAAiB;IAChE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,OAAoB;IAClE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAc,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;QAC/D,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,OAAoB;IACpE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAgB,EAChB,OAAoB;IAEpB,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,IAAI,MAAM,sBAAsB,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAExD,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/supervisor/process-identity.d.ts

@@ -0,0 +1,19 @@
+export interface ProcessIdentity {
+    pid: number;
+    /** وقت بدء العملية بصيغة ISO. هو المميّز الحقيقي: رقم الـ PID وحده لا يميّز. */
+    startedAt: string;
+    commandLine: string;
+}
+/**
+ * يقرأ هوية عملية حيّة. يُرجع undefined إذا لم تعد موجودة.
+ * على غير ويندوز لا نملك مصدرًا موحّدًا للهوية، فنكتفي بفحص الوجود ونعيد هوية فارغة الحقول.
+ */
+export declare function readProcessIdentity(pid: number): Promise<ProcessIdentity | undefined>;
+/**
+ * هل العملية الحيّة هي نفسها التي سجّلناها؟
+ * وقت البدء هو الفيصل. غيابه (غير ويندوز) يجعلنا نكتفي بالوجود، وهو أضعف لكنه أفضل المتاح.
+ */
+export declare function identityMatches(recorded: Pick<ProcessIdentity, "startedAt" | "commandLine">, live: ProcessIdentity | undefined): boolean;
+/** فحص مجمّع: هل الـ PID المسجَّل ما زال هو عمليتنا؟ */
+export declare function isRecordedProcessAlive(record: Pick<ProcessIdentity, "pid" | "startedAt" | "commandLine">): Promise<boolean>;
+//# sourceMappingURL=process-identity.d.ts.map

package/dist/supervisor/process-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-identity.d.ts","sourceRoot":"","sources":["../../src/supervisor/process-identity.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAkC3F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,aAAa,CAAC,EAC5D,IAAI,EAAE,eAAe,GAAG,SAAS,GAChC,OAAO,CAIT;AAED,wDAAwD;AACxD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,WAAW,GAAG,aAAa,CAAC,GACjE,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/supervisor/process-identity.js

@@ -0,0 +1,51 @@
+import { execa } from "execa";
+/**
+ * يقرأ هوية عملية حيّة. يُرجع undefined إذا لم تعد موجودة.
+ * على غير ويندوز لا نملك مصدرًا موحّدًا للهوية، فنكتفي بفحص الوجود ونعيد هوية فارغة الحقول.
+ */
+export async function readProcessIdentity(pid) {
+    if (process.platform !== "win32") {
+        try {
+            process.kill(pid, 0);
+            return { pid, startedAt: "", commandLine: "" };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const script = `$p = Get-CimInstance Win32_Process -Filter "ProcessId=${pid}" -ErrorAction SilentlyContinue; if ($p) { "$($p.ProcessId)|$($p.CreationDate.ToString('o'))|$($p.CommandLine)" }`;
+    try {
+        const { stdout } = await execa("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], { timeout: 8_000, reject: false });
+        const line = stdout.trim();
+        if (!line)
+            return undefined;
+        // سطر الأمر نفسه قد يحوي ‎|‎، فنقسم إلى ثلاثة أجزاء فقط ونضمّ الباقي إلى الأخير.
+        const parts = line.split("|");
+        const foundPid = Number(parts[0]);
+        const startedAt = parts[1] ?? "";
+        const commandLine = parts.slice(2).join("|");
+        if (!Number.isFinite(foundPid))
+            return undefined;
+        return { pid: foundPid, startedAt, commandLine };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * هل العملية الحيّة هي نفسها التي سجّلناها؟
+ * وقت البدء هو الفيصل. غيابه (غير ويندوز) يجعلنا نكتفي بالوجود، وهو أضعف لكنه أفضل المتاح.
+ */
+export function identityMatches(recorded, live) {
+    if (!live)
+        return false;
+    if (!recorded.startedAt || !live.startedAt)
+        return true;
+    return recorded.startedAt === live.startedAt;
+}
+/** فحص مجمّع: هل الـ PID المسجَّل ما زال هو عمليتنا؟ */
+export async function isRecordedProcessAlive(record) {
+    const live = await readProcessIdentity(record.pid);
+    return identityMatches(record, live);
+}
+//# sourceMappingURL=process-identity.js.map

package/dist/supervisor/process-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-identity.js","sourceRoot":"","sources":["../../src/supervisor/process-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAiB9B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,yDAAyD,GAAG,mHAAmH,CAAC;IAE/L,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAC5B,gBAAgB,EAChB,CAAC,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,CAAC,EACrD,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAClC,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAE5B,iFAAiF;QACjF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAEjD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAA4D,EAC5D,IAAiC;IAEjC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IACxD,OAAO,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAkE;IAElE,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnD,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/supervisor/readiness.d.ts

@@ -0,0 +1,17 @@
+import type { ServiceDefinition } from "../profiles/types.js";
+export interface ReadinessOutcome {
+    ready: boolean;
+    reason?: string;
+    /** آخر أسطر السجلّ عند الفشل، للعرض. */
+    tail?: string[];
+}
+/** يقرأ آخر أسطر من سجلّ الخدمة. مصدر السبب حين تفشل الجاهزية. */
+export declare function readLogTail(logDir: string, service: ServiceDefinition["name"], lines?: number): string[];
+export interface WaitOptions {
+    logDir: string;
+    /** يُسأل بين المحاولات: إن ماتت العملية توقّفنا فورًا بدل انتظار المهلة كاملة. */
+    stillRunning?: () => Promise<boolean>;
+    onAttempt?: (elapsedMs: number) => void;
+}
+export declare function waitForReady(service: ServiceDefinition, options: WaitOptions): Promise<ReadinessOutcome>;
+//# sourceMappingURL=readiness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../src/supervisor/readiness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAc9D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE,CAYpG;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA2B3B"}

package/dist/supervisor/readiness.js

@@ -0,0 +1,52 @@
+import { readFileSync, existsSync } from "node:fs";
+import { probeService } from "../probes/service.probe.js";
+import { logFilePath } from "../logs/sink.js";
+// AR: انتظار الجاهزية. المبدأ: «أُطلقت» لا تعني «جاهزة» — NestJS يستغرق ثوانيَ حتى يستمع، وVite يبني
+//     الاعتماديات أول مرة. ولكل انتظار مهلة، وعند انتهائها نطبع آخر ما كتبته الخدمة **كسبب**، لأن
+//     سبينر يدور إلى الأبد هو أسوأ ما يمكن أن يفعله مشرف عمليات.
+// EN: Readiness waiting. The principle: "spawned" is not "ready" — NestJS takes seconds to listen and
+//     Vite builds dependencies on first run. Every wait is bounded, and on expiry we print the
+//     service's last output **as the reason**, because a spinner that turns forever is the worst
+//     thing a supervisor can do.
+const POLL_MS = 500;
+/** يقرأ آخر أسطر من سجلّ الخدمة. مصدر السبب حين تفشل الجاهزية. */
+export function readLogTail(logDir, service, lines = 20) {
+    const path = logFilePath(logDir, service);
+    if (!existsSync(path))
+        return [];
+    try {
+        return readFileSync(path, "utf8")
+            .split(/\r?\n/)
+            .filter((line) => line.trim().length > 0)
+            .slice(-lines);
+    }
+    catch {
+        return [];
+    }
+}
+export async function waitForReady(service, options) {
+    const started = Date.now();
+    const deadline = started + service.readyTimeoutMs;
+    for (;;) {
+        const probe = await probeService(service, 1_500);
+        if (probe.reachable)
+            return { ready: true };
+        if (options.stillRunning && !(await options.stillRunning())) {
+            return {
+                ready: false,
+                reason: "the process exited before it became ready",
+                tail: readLogTail(options.logDir, service.name),
+            };
+        }
+        if (Date.now() >= deadline) {
+            return {
+                ready: false,
+                reason: `not ready within ${Math.round(service.readyTimeoutMs / 1000)}s`,
+                tail: readLogTail(options.logDir, service.name),
+            };
+        }
+        options.onAttempt?.(Date.now() - started);
+        await new Promise((resolvePromise) => setTimeout(resolvePromise, POLL_MS));
+    }
+}
+//# sourceMappingURL=readiness.js.map

package/dist/supervisor/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/supervisor/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,qGAAqG;AACrG,kGAAkG;AAClG,iEAAiE;AACjE,sGAAsG;AACtG,+FAA+F;AAC/F,iGAAiG;AACjG,iCAAiC;AAEjC,MAAM,OAAO,GAAG,GAAG,CAAC;AASpB,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,OAAkC,EAAE,KAAK,GAAG,EAAE;IACxF,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC;aAC9B,KAAK,CAAC,OAAO,CAAC;aACd,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;aACxC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA0B,EAC1B,OAAoB;IAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAElD,SAAS,CAAC;QACR,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,SAAS;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAE5C,IAAI,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;YAC5D,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,2CAA2C;gBACnD,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;aAChD,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3B,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,oBAAoB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG;gBACxE,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;aAChD,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;QAC1C,MAAM,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}