@wasmsoft/fantastic 1.0.0

package/dist/packaging/machine-path.js.map

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

package/dist/packaging/manifest.d.ts

@@ -0,0 +1,37 @@
+import type { BundleManifest } from "../contracts/core.js";
+/**
+ * بصمة مجلد: اسم كل ملف ومحتواه، بترتيب مستقرّ.
+ *
+ * الترتيب مقصود: ‎readdirSync‎ لا يضمن ترتيبًا عبر أنظمة الملفات، فبصمة غير مرتّبة تختلف بين آلتين
+ * لنفس المحتوى — وتصير عديمة المعنى ككشفٍ للتغيير.
+ */
+export declare function hashDirectory(root: string): {
+    sha256: string;
+    files: number;
+};
+export declare function hashFile(path: string): string;
+export interface ManifestInput {
+    bundleRoot: string;
+    bundleVersion: string;
+    versions: {
+        core: string;
+        live: string;
+        interface: string;
+        supervisor: string;
+    };
+    ffmpeg: string;
+    ffprobe: string;
+    builtAt: string;
+    unverified: boolean;
+    /**
+     * AR: أدنى إصدار واجهة يقرأ هذه الحزمة (٠٢٦). يكتبه الباني ويقرؤه المُثبِّت قبل التنزيل.
+     * EN: The lowest CLI version that reads this bundle (026). The builder writes it; the installer
+     *     reads it before downloading.
+     */
+    minCliVersion: string;
+}
+export declare function writeManifest(input: ManifestInput): BundleManifest;
+export declare function readManifest(bundleRoot: string): BundleManifest | undefined;
+/** حجم شجرة، للتقرير. */
+export declare function treeBytes(root: string): number;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/packaging/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/packaging/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiB5E;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0B7E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAOD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAoClE;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAS3E;AAED,yBAAyB;AACzB,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAa9C"}

package/dist/packaging/manifest.js

@@ -0,0 +1,115 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { BUNDLE_DIRS, MANIFEST_FILE } from "./layout.js";
+// AR: بصمات المكوّنات وبيان الحزمة.
+//
+//     **نطاق البصمة معلَن ولا يُبالَغ فيه:** تكشف التلف وتلف النقل والعبث العابر، ولا تثبت الأصالة.
+//     ما دام ‎signature‎ فارغًا — وهو كذلك حتى تصل ميزة التحديثات — فمن يعدّل ملفًا يعدّل بصمته
+//     المسجَّلة بجواره. لذلك يُكتب الحقل ‎null‎ صراحةً لا يُحذَف: الحقل الغائب يُقرأ «لم يُنفَّذ»،
+//     و‎null‎ يُقرأ «لا توقيع، ونحن نعلم».
+// EN: Component fingerprints and the bundle manifest.
+//
+//     **The fingerprint's scope is declared and not overstated:** it detects damage, transfer
+//     corruption and casual tampering, and does not prove authenticity. While `signature` is null —
+//     and it is, until the update feature lands — whoever edits a file can edit the fingerprint
+//     recorded beside it. Hence the field is written as an explicit null rather than omitted: an
+//     absent field reads "not implemented", a null reads "there is no signature, and we know it".
+/**
+ * بصمة مجلد: اسم كل ملف ومحتواه، بترتيب مستقرّ.
+ *
+ * الترتيب مقصود: ‎readdirSync‎ لا يضمن ترتيبًا عبر أنظمة الملفات، فبصمة غير مرتّبة تختلف بين آلتين
+ * لنفس المحتوى — وتصير عديمة المعنى ككشفٍ للتغيير.
+ */
+export function hashDirectory(root) {
+    const hash = createHash("sha256");
+    let files = 0;
+    const walk = (dir, prefix) => {
+        const entries = readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            const full = join(dir, entry.name);
+            const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                walk(full, relative);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            // المسار النسبي جزء من البصمة: نقل ملف بلا تغيير محتواه تغييرٌ يجب أن يُكشَف.
+            hash.update(relative);
+            hash.update(readFileSync(full));
+            files += 1;
+        }
+    };
+    if (existsSync(root))
+        walk(root, "");
+    return { sha256: hash.digest("hex"), files };
+}
+export function hashFile(path) {
+    return createHash("sha256").update(readFileSync(path)).digest("hex");
+}
+function component(root, version) {
+    const { sha256, files } = hashDirectory(root);
+    return { version, sha256, files };
+}
+export function writeManifest(input) {
+    const { bundleRoot } = input;
+    const runtimeDir = join(bundleRoot, BUNDLE_DIRS.runtime);
+    const runtimeHash = hashDirectory(runtimeDir).sha256;
+    const manifest = {
+        bundle: {
+            version: input.bundleVersion,
+            builtAt: input.builtAt,
+            platform: "win32-x64",
+            nodeVersion: process.version.replace(/^v/, ""),
+            minCliVersion: input.minCliVersion,
+            ...(input.unverified ? { unverified: true } : {}),
+        },
+        components: {
+            core: component(join(bundleRoot, BUNDLE_DIRS.core), input.versions.core),
+            live: component(join(bundleRoot, BUNDLE_DIRS.live), input.versions.live),
+            interface: component(join(bundleRoot, BUNDLE_DIRS.interfaceClient), input.versions.interface),
+            // AR: المُشرِف المشحون مكوّن كامل، كما كانت الواجهة منذ ٠١٨ وللسبب نفسه: بصمته تكشف تلفه،
+            //     وإصداره هو ما تقارنه خدمة التحديث. وما تغيّر في ٠٢٦ هو **ما يُشحن** لا كيف يُسجَّل.
+            // EN: The shipped supervisor is a full component, as the CLI was from 018 and for the same
+            //     reason: its digest catches corruption and its version is what the update service
+            //     compares. What 026 changed is **what ships**, not how it is recorded.
+            supervisor: component(join(bundleRoot, BUNDLE_DIRS.supervisor), input.versions.supervisor),
+            runtime: { ffmpeg: input.ffmpeg, ffprobe: input.ffprobe, sha256: runtimeHash },
+        },
+        // صراحةً ‎null‎. انظر رأس الملف.
+        signature: null,
+    };
+    const path = join(bundleRoot, MANIFEST_FILE);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    return manifest;
+}
+export function readManifest(bundleRoot) {
+    const path = join(bundleRoot, MANIFEST_FILE);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** حجم شجرة، للتقرير. */
+export function treeBytes(root) {
+    let bytes = 0;
+    const walk = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory())
+                walk(full);
+            else if (entry.isFile())
+                bytes += statSync(full).size;
+        }
+    };
+    if (existsSync(root))
+        walk(root);
+    return bytes;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/packaging/manifest.js.map

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

package/dist/packaging/shims.d.ts

@@ -0,0 +1,31 @@
+/**
+ * AR: شيمة المُشرِف بعد التثبيت، في ‎bin\‎ (٠٢٦).
+ *
+ *     **كانت هذه شيمة الأمر ‎fantastic‎ للفنّي، وصارت شيمة المُشرِف للآلة.** الفنّي يكتب
+ *     ‎fantastic‎ فيصل إلى الحزمة العالمية المثبَّتة بـ‎npm‎؛ أمّا هذا الملفّ فمُناديه واحدٌ لا
+ *     ثانيَ له: مهمّة الإقلاع في جدولة ويندوز.
+ *
+ *     **ولماذا شيمةٌ أصلًا بدل أن تنادي المهمّةُ ‎node.exe‎ مباشرةً؟** لأن الشيمة تحسب مسار زمن
+ *     التشغيل من موقعها هي، فينتقل التثبيت مع ‎--root D:\...‎ بلا أن تُعاد كتابة المهمّة. ولأن
+ *     ‎.cmd‎ تعمل تحت سياسة ويندوز الافتراضية ‎Restricted‎ التي تمنع ‎.ps1‎ (القرار D-018-03).
+ *
+ *     ولا تُمرَّر وسائط: المُشرِف لا يقبل شيئًا، ومهمّةٌ تمرّر ‎watch‎ إلى ملفٍّ لا يقرأ الوسائط
+ *     كانت ستُخفي خطأً يومًا.
+ * EN: The supervisor's shim after installation, in `bin\` (026).
+ *
+ *     **This used to be the technician's `fantastic` shim; it is now the machine's supervisor
+ *     shim.** The technician types `fantastic` and reaches the global package installed with npm;
+ *     this file has exactly one caller: the Windows scheduled boot task.
+ *
+ *     **Why a shim at all, rather than the task calling `node.exe` directly?** Because the shim
+ *     computes the runtime's path from its own location, so an installation moved with
+ *     `--root D:\...` travels without the task being rewritten. And because `.cmd` runs under
+ *     Windows' default `Restricted` policy, which blocks `.ps1` (decision D-018-03).
+ *
+ *     No arguments are forwarded: the supervisor accepts none, and a task passing `watch` to a file
+ *     that ignores arguments would have hidden a mistake one day.
+ */
+export declare function commandShimContent(): string;
+/** يكتب شيمة المُشرِف في ‎bin\‎ أثناء التثبيت. */
+export declare function writeCommandShim(root: string): string;
+//# sourceMappingURL=shims.d.ts.map

package/dist/packaging/shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shims.d.ts","sourceRoot":"","sources":["../../src/packaging/shims.ts"],"names":[],"mappings":"AAoIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD"}

package/dist/packaging/shims.js

@@ -0,0 +1,165 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { BUNDLE_DIRS, SUPERVISOR_ENTRY, RUNTIME_FILES, SHIM_FILES } from "./layout.js";
+// AR: الشيمتان اللتان تصلان زمن تشغيل الحزمة بواجهتها (٠١٨).
+//
+//     **الفكرة كلّها سطر واحد**: نداءٌ بمسار مطلق محسوب من موقع الملفّ نفسه. لا كلمة ‎node‎ مجرّدة،
+//     ولا استشارة لـ‎PATH‎، ولا npm. وبهذا تتعايش نسخة Node الخاصّة بالعميل مع نسختنا على الآلة
+//     نفسها بلا أن تعرف إحداهما بالأخرى — وهي فرضية الميزة كلّها (القاعدة I).
+//
+//     ولماذا ‎.cmd‎: سياسة ويندوز الافتراضية ‎Restricted‎ تمنع ‎.ps1‎، وقد أوقفت التثبيت الأول ميدانيًّا.
+//     رفع السياسة تغييرٌ في أمان جهاز العميل، ولا يجوز أن يكون ثمن تثبيت منتجنا (D-018-03).
+// EN: The two shims that connect the bundle's runtime to its CLI (018).
+//
+//     **The whole idea is one line**: a call by an absolute path computed from the file's own
+//     location. No bare `node`, no consulting `PATH`, no npm. That is how the customer's own Node and
+//     ours live on the same machine without either knowing about the other — the premise of the whole
+//     feature (rule I).
+//
+//     And why `.cmd`: Windows' default `Restricted` policy blocks `.ps1`, and it stopped the very
+//     first field installation. Raising that policy is a change to the customer's machine security,
+//     and must not be the price of installing our product (D-018-03).
+/**
+ * AR: ‎%~dp0‎ هو مجلد ملفّ الدفعة نفسه، **منتهيًا بشرطة مائلة خلفية**. وتلك الشرطة هي الفخّ: كتابة
+ *     ‎"%~dp0"‎ تُنتج ‎"C:\Fantastic\"‎ فتُقرأ الشرطة هروبًا لعلامة الاقتباس عند من يفكّ سطر الأوامر،
+ *     فيبتلع الوسيط التالي. إلحاق نقطة يُنهي المسار بمُكوِّن حقيقي — ‎"C:\Fantastic\."‎ — فيسلم
+ *     الاقتباس ويبقى المسار صحيحًا. الدرس نفسه المسجَّل في ‎shell/parse-line.ts‎: الشرطة المائلة
+ *     الخلفية فاصل مسار على ويندوز لا محرف هروب، ومَن يعاملها هروبًا يُفتّت المسارات.
+ * EN: `%~dp0` is the batch file's own directory, **ending in a backslash**. That backslash is the
+ *     trap: writing `"%~dp0"` yields `"C:\Fantastic\"`, where the backslash reads as an escape for the
+ *     closing quote to a command-line parser, which then swallows the next argument. Appending a dot
+ *     ends the path on a real component — `"C:\Fantastic\."` — so the quote survives and the path
+ *     still resolves. The same lesson recorded in `shell/parse-line.ts`: on Windows a backslash is a
+ *     path separator, not an escape, and treating it as one shatters paths.
+ */
+const SELF_DIR = "%~dp0";
+/**
+ * AR: ‎%*‎ يمرّر بقيّة سطر الأوامر **كما كُتب حرفيًّا**، بعلامات اقتباسه. فمسار فيه مسافة
+ *     (‎--root "D:\My Media"‎) يعبر الشيمة سليمًا بلا أي إعادة ترميز من طرفنا — وأي محاولة لتفكيك
+ *     الوسائط وإعادة تجميعها هنا كانت ستكسر ما يعمل أصلًا.
+ * EN: `%*` forwards the rest of the command line **exactly as typed**, quotes included. So a path with
+ *     a space (`--root "D:\My Media"`) crosses the shim intact with no re-encoding on our part — and
+ *     any attempt to split and reassemble the arguments here would break what already works.
+ */
+const FORWARD_ARGS = "%*";
+/**
+ * AR: رمز الخروج جزء من عقد الواجهة: سكربتات البوّابة تقرأه (‎EXIT_CODE_HELP‎ في ‎base-command.ts‎).
+ *     ملفّ الدفعة يورّث رمز آخر أمر فيه ضمنًا، لكن التصريح به يجعل العقد صريحًا لا معتمِدًا على سلوك.
+ * EN: The exit code is part of the CLI's contract: gate scripts read it (`EXIT_CODE_HELP` in
+ *     `base-command.ts`). A batch file inherits its last command's code implicitly, but stating it
+ *     makes the contract explicit rather than behavioural.
+ */
+/**
+ * AR: **ملفّ ‎.cmd‎ يُنقَر نقرًا مزدوجًا يفتح نافذة تُغلق لحظة انتهائه.** فيرى الفنّي شاشة تومض
+ *     وتختفي، ويذهب معها كل ما يحتاجه: عناوين الدخول، وكلمة مرور المالك الأولى، وأيّ تحذير — ومنه
+ *     تحذير تعذّر الكتابة في ‎PATH‎، الذي يفسّر بالضبط لماذا لا يعرف ويندوز الأمر ‎fantastic‎ بعدها.
+ *     رُصد على جهاز عميل: التثبيت ينجح والفنّي لا يرى منه شيئًا، ثم يكتب ‎fantastic‎ فيُقال له
+ *     «غير معرَّف»، ولا شيء على الشاشة يربط الأمرين.
+ *
+ *     **والعلامة هي ‎--yes‎ لا شكل سطر الاستدعاء.** جُرّب أوّلًا فحص ‎%cmdcmdline%‎ بحثًا عن ‎cmd /c‎،
+ *     وسقط لسببين: يبدأ بعلامة اقتباس حين يُستدعى ‎cmd.exe‎ بمساره الكامل فيكسر جملة ‎if‎ نحويًّا،
+ *     و‎cmd /c‎ نفسه هو ما تستعمله السكربتات أيضًا فلا يميّز شيئًا. أمّا ‎--yes‎ فمعناه المعلن «لا
+ *     تسألني» — ومن قالها لا يريد أن يُنتظَر منه ضغط مفتاح. والقراءة بحلقة ‎for‎ مع ‎%%~A‎ تنزع
+ *     الاقتباس، فيعبر مسارٌ فيه مسافة سليمًا.
+ * EN: **A double-clicked `.cmd` opens a window that closes the instant it finishes.** The technician
+ *     sees a screen flash and vanish, taking with it everything they needed: the sign-in URLs, the
+ *     first owner password, and any warning — including the one about PATH not being writable, which
+ *     is precisely what explains why Windows does not know the `fantastic` command afterwards.
+ *     Observed at a customer site: the install succeeds, the technician sees none of it, then types
+ *     `fantastic` and is told it is not recognised, with nothing on screen connecting the two.
+ *
+ *     **The signal is `--yes`, not the shape of the invocation.** Testing `%cmdcmdline%` for `cmd /c`
+ *     was tried first and failed twice over: it begins with a quote when `cmd.exe` is invoked by its
+ *     full path, which breaks the `if` statement syntactically, and `cmd /c` is also what scripts use,
+ *     so it distinguishes nothing. `--yes`, by contrast, means exactly "do not ask me" — and whoever
+ *     said that does not want to be waited on for a keypress. Reading it with a `for` loop and `%%~A`
+ *     strips the quoting, so a path with a space crosses intact.
+ */
+const HOLD_WINDOW_OPEN = [
+    `set FANTASTIC_UNATTENDED=`,
+    `for %%A in (${FORWARD_ARGS}) do if /i "%%~A"=="--yes" set FANTASTIC_UNATTENDED=1`,
+    `if not defined FANTASTIC_UNATTENDED (`,
+    `  echo.`,
+    `  echo Press any key to close this window.`,
+    `  pause >nul`,
+    `)`,
+];
+function shim(lines, options = {}) {
+    const body = [
+        "@echo off",
+        ...UTF8_PREAMBLE,
+        ...lines,
+        ...(options.holdWindowOpen ? ["set FANTASTIC_EXIT=%ERRORLEVEL%", ...HOLD_WINDOW_OPEN, "exit /b %FANTASTIC_EXIT%"] : ["exit /b %ERRORLEVEL%"]),
+    ];
+    return `${body.join("\r\n")}\r\n`;
+}
+/**
+ * AR: **تُفتَح الطرفية على UTF-8 قبل أن يُكتب فيها حرف.**
+ *
+ *     «موجّه الأوامر» التقليدي يعمل بصفحة ترميز قديمة (‎437‎ أو ‎720‎ على ويندوز عربيّ)، فكل محرف
+ *     خارج ASCII يخرج ‎?‎ — والرسائل عندنا عربية، فتصير الشاشة صفوفًا من علامات الاستفهام. رُصد على
+ *     جهاز عميل: التثبيت يعمل تمامًا والفنّي يقرأ ما يبدو خرابًا.
+ *     و‎chcp‎ محصور بهذه النافذة وحدها ولا يمسّ إعداد الجهاز، ومخرَجه يُبتلع فلا يزاحم أوّل سطر.
+ *
+ *     **ولا يُعلَن أن الطرفية صارت قادرة على الرسم.** كانت هذه المقدّمة تضبط ‎FANTASTIC_UTF8‎ فتقول
+ *     للواجهة «استعملي رموزك»، وكان ذلك خطأً: صفحة الترميز نصف المسألة، ونصفها الآخر **الخطّ**.
+ *     «موجّه الأوامر» التقليدي يعمل بخطّ نقطيّ لا يحوي ‎━‎ ولا ‎✔‎ أصلًا، فتبقى علامات استفهام مهما
+ *     كان الترميز. قِيس على جهاز عميل: ‎chcp 65001‎ نُفِّذ، والشاشة ظلّت صفوفًا من ‎?‎.
+ *     ولا سبيل إلى سؤال الطرفية عن خطّها، فيبقى الحكم لما تُعلنه عن نفسها (theme.ts) — والافتراض
+ *     عند الشكّ هو ASCII.
+ * EN: **The console is switched to UTF-8 before a character is written to it.**
+ *
+ *     The classic Command Prompt runs on a legacy code page (437, or 720 on an Arabic Windows), so
+ *     every non-ASCII character comes out as `?`. `chcp` is scoped to this window alone and touches no
+ *     machine setting, and its output is swallowed so it does not crowd the first line.
+ *
+ *     **But it does not declare the console able to draw.** This preamble used to set `FANTASTIC_UTF8`,
+ *     telling the CLI "use your own glyphs", and that was wrong: the code page is half the problem and
+ *     the other half is **the font**. The classic Command Prompt uses a raster font that contains
+ *     neither `━` nor `✔`, so question marks remain whatever the encoding. Measured at a customer
+ *     site: `chcp 65001` ran, and the screen stayed rows of `?`.
+ *     A terminal cannot be asked about its font, so the judgement rests on what it announces about
+ *     itself (theme.ts) — and when in doubt the assumption is ASCII.
+ */
+const UTF8_PREAMBLE = ["chcp 65001 >nul"];
+/**
+ * AR: شيمة المُشرِف بعد التثبيت، في ‎bin\‎ (٠٢٦).
+ *
+ *     **كانت هذه شيمة الأمر ‎fantastic‎ للفنّي، وصارت شيمة المُشرِف للآلة.** الفنّي يكتب
+ *     ‎fantastic‎ فيصل إلى الحزمة العالمية المثبَّتة بـ‎npm‎؛ أمّا هذا الملفّ فمُناديه واحدٌ لا
+ *     ثانيَ له: مهمّة الإقلاع في جدولة ويندوز.
+ *
+ *     **ولماذا شيمةٌ أصلًا بدل أن تنادي المهمّةُ ‎node.exe‎ مباشرةً؟** لأن الشيمة تحسب مسار زمن
+ *     التشغيل من موقعها هي، فينتقل التثبيت مع ‎--root D:\...‎ بلا أن تُعاد كتابة المهمّة. ولأن
+ *     ‎.cmd‎ تعمل تحت سياسة ويندوز الافتراضية ‎Restricted‎ التي تمنع ‎.ps1‎ (القرار D-018-03).
+ *
+ *     ولا تُمرَّر وسائط: المُشرِف لا يقبل شيئًا، ومهمّةٌ تمرّر ‎watch‎ إلى ملفٍّ لا يقرأ الوسائط
+ *     كانت ستُخفي خطأً يومًا.
+ * EN: The supervisor's shim after installation, in `bin\` (026).
+ *
+ *     **This used to be the technician's `fantastic` shim; it is now the machine's supervisor
+ *     shim.** The technician types `fantastic` and reaches the global package installed with npm;
+ *     this file has exactly one caller: the Windows scheduled boot task.
+ *
+ *     **Why a shim at all, rather than the task calling `node.exe` directly?** Because the shim
+ *     computes the runtime's path from its own location, so an installation moved with
+ *     `--root D:\...` travels without the task being rewritten. And because `.cmd` runs under
+ *     Windows' default `Restricted` policy, which blocks `.ps1` (decision D-018-03).
+ *
+ *     No arguments are forwarded: the supervisor accepts none, and a task passing `watch` to a file
+ *     that ignores arguments would have hidden a mistake one day.
+ */
+export function commandShimContent() {
+    const node = `"${SELF_DIR}..\\${join(BUNDLE_DIRS.runtime, RUNTIME_FILES.node)}"`;
+    const entry = `"${SELF_DIR}..\\${SUPERVISOR_ENTRY}"`;
+    return shim([`${node} ${entry}`]);
+}
+/** يكتب شيمة المُشرِف في ‎bin\‎ أثناء التثبيت. */
+export function writeCommandShim(root) {
+    const dir = join(root, BUNDLE_DIRS.bin);
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, SHIM_FILES.command);
+    writeFileSync(path, commandShimContent(), "utf8");
+    return path;
+}
+//# sourceMappingURL=shims.js.map

package/dist/packaging/shims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shims.js","sourceRoot":"","sources":["../../src/packaging/shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvF,6DAA6D;AAC7D,EAAE;AACF,oGAAoG;AACpG,gGAAgG;AAChG,8EAA8E;AAC9E,EAAE;AACF,0GAA0G;AAC1G,4FAA4F;AAC5F,wEAAwE;AACxE,EAAE;AACF,8FAA8F;AAC9F,sGAAsG;AACtG,sGAAsG;AACtG,wBAAwB;AACxB,EAAE;AACF,kGAAkG;AAClG,oGAAoG;AACpG,sEAAsE;AAEtE;;;;;;;;;;;;GAYG;AACH,MAAM,QAAQ,GAAG,OAAO,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B;;;;;;GAMG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,gBAAgB,GAAG;IACvB,2BAA2B;IAC3B,eAAe,YAAY,uDAAuD;IAClF,uCAAuC;IACvC,SAAS;IACT,4CAA4C;IAC5C,cAAc;IACd,GAAG;CACJ,CAAC;AAEF,SAAS,IAAI,CAAC,KAAe,EAAE,UAAwC,EAAE;IACvE,MAAM,IAAI,GAAG;QACX,WAAW;QACX,GAAG,aAAa;QAChB,GAAG,KAAK;QACR,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,iCAAiC,EAAE,GAAG,gBAAgB,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;KAC9I,CAAC;IAEF,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,aAAa,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,IAAI,GAAG,IAAI,QAAQ,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;IACjF,MAAM,KAAK,GAAG,IAAI,QAAQ,OAAO,gBAAgB,GAAG,CAAC;IAErD,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC3C,aAAa,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/probes/internal-paths.d.ts

@@ -0,0 +1,35 @@
+export declare const INTERNAL_PATHS: {
+    /** اللقطة الغنيّة: نفس ‎HealthService‎ الذي تقرأ منه ‎/api/health‎، بحقولها الاختيارية مملوءة. */
+    readonly HEALTH: "/internal/health";
+    /** لقطة قاعدة متّسقة عبر ‎VACUUM INTO‎. تُنفَّذ في النواة لأن الـ CLI ممنوع من فتح القاعدة. */
+    readonly BACKUP_SNAPSHOT: "/internal/backup/snapshot";
+    readonly SECTIONS: "/internal/sections";
+    readonly DRIVES: "/internal/drives";
+    readonly SCAN_RESULTS: "/internal/scan/results";
+    readonly SCAN_DISCONNECTED: "/internal/scan/disconnected-drive";
+    readonly SCAN_START: "/internal/scan";
+    readonly SCAN_RELINK: "/internal/scan/relink";
+    readonly TRANSCODE_JOBS: "/internal/transcode/jobs";
+    readonly TRANSCODE_ENCODERS: "/internal/transcode/encoders";
+    readonly TRANSCODE_CANCEL: (id: number) => string;
+    readonly STREAM_SESSIONS: "/internal/streams/sessions";
+    readonly LIVE_CHANNELS: "/internal/live/channels";
+    /**
+     * حالة خادم الـ FTP وقاعدة جدار الحماية معًا (٠٢٠/FR-027). نصفان لا يكفي أحدهما: «يعمل» وحدها
+     * تكذب حين يحجبه الجدار، و«القاعدة غائبة» وحدها إنذار كاذب حين يكون الـ FTP مطفأً أصلًا.
+     */
+    readonly REMOTE_FTP: "/internal/remote/ftp";
+    readonly LICENSE_STATUS: "/internal/license/status";
+    readonly LICENSE_ACTIVATE: "/internal/license/activate";
+    readonly LICENSE_DEACTIVATE: "/internal/license/deactivate";
+    /**
+     * AR: التحديثات (P5.4). **نفس قاعدة الترخيص حرفيًّا:** الـ CLI يسأل النواة، والنواة تسأل
+     *     المركز — لأن هوية الجهاز وعنوان المركز والمفتاح العام تعيش هناك وحدها.
+     * EN: Updates (P5.4). **Exactly the licensing rule:** the CLI asks the core and the core asks
+     *     the centre — because the device identity, the centre's address and the public key live
+     *     there and nowhere else.
+     */
+    readonly UPDATES_CHECK: "/internal/updates/check";
+};
+export type InternalPath = (typeof INTERNAL_PATHS)[keyof typeof INTERNAL_PATHS];
+//# sourceMappingURL=internal-paths.d.ts.map

package/dist/probes/internal-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-paths.d.ts","sourceRoot":"","sources":["../../src/probes/internal-paths.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc;IACzB,kGAAkG;;IAElG,+FAA+F;;;;;;;;;;oCAcxE,MAAM;;;IAM7B;;;OAGG;;;;;IAaH;;;;;;OAMG;;CAEK,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC"}

package/dist/probes/internal-paths.js

@@ -0,0 +1,58 @@
+// AR: سِجل مسارات السطح الداخلي للنواة. **المكان الوحيد الذي يظهر فيه نصّ مسار داخلي** — لا في أمر
+//     ولا في عارضة، مطابقةً للمبدأ الثالث كما يطبّقه ‎api-paths.ts‎ على الواجهة.
+//
+//     ولماذا سِجلّ مستقلّ بدل الإضافة إلى ‎apps/client-portal/src/lib/api-paths.ts‎؟ لأن الواجهة
+//     **لا تنادي هذه المسارات ولا تستطيع**: السطح محميّ باللوب-باك، فشحن أسمائه داخل حزمة المتصفّح
+//     يُعلن للضيوف عن سطحٍ لا يبلغونه — ضجيج بلا فائدة وإشارة لمن يفتّش.
+//
+// EN: The registry of the core's internal-surface paths. **The only place an internal path string
+//     appears** — never in a command or a renderer, mirroring how api-paths.ts applies principle III
+//     on the portal side.
+//
+//     Why a separate registry rather than adding to the portal's api-paths.ts? Because the portal
+//     **does not and cannot call these**: the surface is loopback-guarded, so shipping its route
+//     names inside the browser bundle advertises to guests a surface they can never reach — noise
+//     with no benefit, and a signpost for anyone probing.
+export const INTERNAL_PATHS = {
+    /** اللقطة الغنيّة: نفس ‎HealthService‎ الذي تقرأ منه ‎/api/health‎، بحقولها الاختيارية مملوءة. */
+    HEALTH: "/internal/health",
+    /** لقطة قاعدة متّسقة عبر ‎VACUUM INTO‎. تُنفَّذ في النواة لأن الـ CLI ممنوع من فتح القاعدة. */
+    BACKUP_SNAPSHOT: "/internal/backup/snapshot",
+    // المكتبة
+    SECTIONS: "/internal/sections",
+    DRIVES: "/internal/drives",
+    SCAN_RESULTS: "/internal/scan/results",
+    SCAN_DISCONNECTED: "/internal/scan/disconnected-drive",
+    SCAN_START: "/internal/scan",
+    SCAN_RELINK: "/internal/scan/relink",
+    // البثّ والتحويل
+    TRANSCODE_JOBS: "/internal/transcode/jobs",
+    TRANSCODE_ENCODERS: "/internal/transcode/encoders",
+    TRANSCODE_CANCEL: (id) => `/internal/transcode/jobs/${id}/cancel`,
+    STREAM_SESSIONS: "/internal/streams/sessions",
+    // البث المباشر
+    LIVE_CHANNELS: "/internal/live/channels",
+    /**
+     * حالة خادم الـ FTP وقاعدة جدار الحماية معًا (٠٢٠/FR-027). نصفان لا يكفي أحدهما: «يعمل» وحدها
+     * تكذب حين يحجبه الجدار، و«القاعدة غائبة» وحدها إنذار كاذب حين يكون الـ FTP مطفأً أصلًا.
+     */
+    REMOTE_FTP: "/internal/remote/ftp",
+    // AR: الترخيص (P4.4). الـ CLI **لا ينادي البوّابة المركزية** — ينادي هذه المسارات، والنواة
+    //     هي التي تنادي المركز بنفس ‎LicenseService‎ الذي تناديه شاشة التفعيل. مسارا تفعيل في
+    //     مشروع واحد يفترقان أوّل يوم يتغيّر فيه شيء.
+    // EN: Licensing (P4.4). The CLI **never calls the central portal** — it calls these, and the
+    //     core calls the centre through the same `LicenseService` the activation screen uses. Two
+    //     activation paths in one project diverge the first day anything changes.
+    LICENSE_STATUS: "/internal/license/status",
+    LICENSE_ACTIVATE: "/internal/license/activate",
+    LICENSE_DEACTIVATE: "/internal/license/deactivate",
+    /**
+     * AR: التحديثات (P5.4). **نفس قاعدة الترخيص حرفيًّا:** الـ CLI يسأل النواة، والنواة تسأل
+     *     المركز — لأن هوية الجهاز وعنوان المركز والمفتاح العام تعيش هناك وحدها.
+     * EN: Updates (P5.4). **Exactly the licensing rule:** the CLI asks the core and the core asks
+     *     the centre — because the device identity, the centre's address and the public key live
+     *     there and nowhere else.
+     */
+    UPDATES_CHECK: "/internal/updates/check",
+};
+//# sourceMappingURL=internal-paths.js.map

package/dist/probes/internal-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-paths.js","sourceRoot":"","sources":["../../src/probes/internal-paths.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,iFAAiF;AACjF,EAAE;AACF,iGAAiG;AACjG,mGAAmG;AACnG,yEAAyE;AACzE,EAAE;AACF,kGAAkG;AAClG,qGAAqG;AACrG,0BAA0B;AAC1B,EAAE;AACF,kGAAkG;AAClG,iGAAiG;AACjG,kGAAkG;AAClG,0DAA0D;AAE1D,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,kGAAkG;IAClG,MAAM,EAAE,kBAAkB;IAC1B,+FAA+F;IAC/F,eAAe,EAAE,2BAA2B;IAE5C,UAAU;IACV,QAAQ,EAAE,oBAAoB;IAC9B,MAAM,EAAE,kBAAkB;IAC1B,YAAY,EAAE,wBAAwB;IACtC,iBAAiB,EAAE,mCAAmC;IACtD,UAAU,EAAE,gBAAgB;IAC5B,WAAW,EAAE,uBAAuB;IAEpC,iBAAiB;IACjB,cAAc,EAAE,0BAA0B;IAC1C,kBAAkB,EAAE,8BAA8B;IAClD,gBAAgB,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,4BAA4B,EAAE,SAAS;IACzE,eAAe,EAAE,4BAA4B;IAE7C,eAAe;IACf,aAAa,EAAE,yBAAyB;IAExC;;;OAGG;IACH,UAAU,EAAE,sBAAsB;IAElC,2FAA2F;IAC3F,0FAA0F;IAC1F,kDAAkD;IAClD,6FAA6F;IAC7F,8FAA8F;IAC9F,8EAA8E;IAC9E,cAAc,EAAE,0BAA0B;IAC1C,gBAAgB,EAAE,4BAA4B;IAC9C,kBAAkB,EAAE,8BAA8B;IAElD;;;;;;OAMG;IACH,aAAa,EAAE,yBAAyB;CAChC,CAAC"}

package/dist/probes/internal.client.d.ts

@@ -0,0 +1,54 @@
+import type { ActivationResult, DeviceInfo, HealthSnapshot } from "../contracts/core.js";
+import { type Profile } from "../profiles/types.js";
+export type InternalResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    /** سبب الفشل للعرض. */
+    reason: string;
+    /** صحيح حين تعذّر الوصول أصلًا — يميّز «النواة متوقّفة» عن «ردّت بخطأ». */
+    unreachable: boolean;
+    /**
+     * AR: غلاف الخطأ من النواة حين ردّت به. **بلا هذا الحقل كان الفنّي يقرأ «the core
+     *     responded with status 400» على كودٍ أخطأ في حرف** — رسالةٌ عن بروتوكول HTTP
+     *     مكان رسالةٍ عربية تقول له بالضبط ما يصحّحه. النواة تكتبها جاهزةً للعرض، وكانت
+     *     تُرمى هنا.
+     * EN: The core's error envelope when it answered with one. **Without this field the
+     *     technician read "the core responded with status 400" for a mistyped character** — an
+     *     HTTP-protocol message where an Arabic one telling him exactly what to fix belonged.
+     *     The core writes it display-ready, and it was being discarded here.
+     */
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+};
+/** اللقطة الغنيّة من ‎/internal/health‎. الحقول الاختيارية الغائبة تُرسَم شرطةً لا صفرًا. */
+export declare function fetchInternalHealth(profile: Profile, timeoutMs?: number): Promise<InternalResult<HealthSnapshot>>;
+/** قراءة عامة من السطح الداخلي. */
+export declare function getInternal<T>(profile: Profile, path: string, timeoutMs?: number): Promise<InternalResult<T>>;
+/**
+ * كتابة على السطح الداخلي. المهلة أطول بكثير من القراءة: ‎VACUUM INTO‎ على قاعدة كبيرة يستغرق
+ * ثوانيَ حقيقية، وقطعُه في منتصفه يترك أرشيفًا ناقصًا — وهو بالضبط ما بُني هذا المسار لتفاديه.
+ */
+export declare function postInternal<T>(profile: Profile, path: string, body: unknown, timeoutMs?: number): Promise<InternalResult<T>>;
+/** حالة الرخصة على هذا الجهاز، كما تصفها النواة لشاشة التفعيل حرفًا بحرف. */
+export declare function fetchLicenseStatus(profile: Profile, timeoutMs?: number): Promise<InternalResult<DeviceInfo>>;
+/**
+ * AR: يفعّل هذا الجهاز. المهلة **دقيقة كاملة** لا الافتراضيةَ القصيرة: النداء يعبر النواةَ إلى
+ *     المركز عبر الإنترنت، والنواة تعيد المحاولة ثلاثًا بتباعد أسّي حين لا يجيب. قطعُه بعد
+ *     ثانيتين ونصف كان يقول «النواة لا تجيب» بينما هي تنتظر ردًّا سيصل.
+ * EN: Activates this machine. The timeout is **a full minute** rather than the short default: the
+ *     call travels through the core to the centre over the internet, and the core retries three
+ *     times with exponential backoff when there is no answer. Cutting it off after 2.5 seconds
+ *     reported "the core is not answering" while it was waiting for a reply that would arrive.
+ */
+export declare function activateLicense(profile: Profile, code: string): Promise<InternalResult<ActivationResult>>;
+/** يوقف تفعيل هذا الجهاز ويحرّر مقعده في المركز. يُنادى من ‎uninstall‎ قبل حذف أي ملف. */
+export declare function deactivateLicense(profile: Profile): Promise<InternalResult<{
+    ok: boolean;
+    message: string;
+}>>;
+//# sourceMappingURL=internal.client.d.ts.map

package/dist/probes/internal.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.client.d.ts","sourceRoot":"","sources":["../../src/probes/internal.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAsBhF,MAAM,MAAM,cAAc,CAAC,CAAC,IACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IACE,EAAE,EAAE,KAAK,CAAC;IACV,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAC9E,CAAC;AA8EN,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,SAAS,SAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAEzC;AAED,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,SAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAE5B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,SAAS,SAAU,GAClB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAE5B;AAID,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,SAAS,SAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAErC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAK3C;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,cAAc,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAO3D"}