@wasmsoft/fantastic 1.0.0

package/dist/profiles/resolve.d.ts

@@ -0,0 +1,37 @@
+import type { Profile, ProfileKind } from "./types.js";
+export declare class ProfileResolutionError extends Error {
+}
+/**
+ * يصعد من مجلد ما بحثًا عن جذر مستودع Fantastic: ‎package.json‎ باسم ‎fantastic‎ وفيه ‎workspaces‎.
+ * الصعود هو ما يجعل الأوامر تعمل من أي مجلد داخل المستودع لا من جذره فقط.
+ */
+export declare function findRepoRoot(from?: string): string | undefined;
+/**
+ * هل يوجد جهاز مركّب على هذه الآلة؟ الدليل مدخل النواة المُثبَّت لا مجرّد وجود المجلد.
+ *
+ * كان الفحص على ‎core\fantastic-core.exe‎ — ملفّ لم يُنتَج قط، فكان وضع الجهاز غير قابل للاستنتاج
+ * إطلاقًا. صار على ‎core\main.js‎: ما تكتبه الحزمة فعلًا (017/T048).
+ *
+ * ونقبل الملف التنفيذي المُترجَم أيضًا، ليعمل هذا الاستنتاج بلا تعديل يوم يصل الترخيص وتُترجَم
+ * الخدمات — الشرط أن يوجد **أحدهما**، لا أن يوجد شكل بعينه.
+ *
+ * الترتيب: ‎FANTASTIC_HOME‎ الصريح، ثم الجهاز الذي تعيش الواجهة داخله، ثم الموضع الافتراضي. الصريح
+ * أوّلًا لأنه قصدُ من كتبه، والمُستنتَج قبل الافتراضي لأنه حقيقةٌ مقروءة من القرص لا موضعٌ متوقَّع.
+ */
+export declare function findApplianceRoot(): string | undefined;
+export interface ResolveOptions {
+    /** تجاوز صريح من العَلَم ‎--profile‎. */
+    kind?: ProfileKind;
+    /** مجلد البدء للبحث عن الجذر. يُمرَّر في الاختبارات. */
+    cwd?: string;
+    /** إنشاء مجلدات الحالة. يُعطَّل في الاختبارات وفي الأوامر التي تقرأ فقط. */
+    ensureDirs?: boolean;
+    /**
+     * AR: المنتج المقصود من العَلَم ‎--product‎ (٠٢٦). يُقرأ من سجلّ الآلة.
+     * EN: The product named by `--product` (026). Looked up in the machine's registry.
+     */
+    product?: string;
+}
+export declare function resolveProfile(options?: ResolveOptions): Profile;
+export declare function buildAppliance(root: string): Profile;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/profiles/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/profiles/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA+CvD,qBAAa,sBAAuB,SAAQ,KAAK;CAAG;AAEpD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAsB,GAAG,MAAM,GAAG,SAAS,CAwB7E;AAqCD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAKtD;AAcD,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAwCD,wBAAgB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAqDpE;AAqBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWpD"}

package/dist/profiles/resolve.js

@@ -0,0 +1,198 @@
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname, join, parse, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { DEV_DEFAULTS, createDevProfile } from "./dev.profile.js";
+import { APPLIANCE_DEFAULTS, APPLIANCE_ROOT, createApplianceProfile } from "./appliance.profile.js";
+import { readRegistry, resolveProduct } from "../registry/local-registry.js";
+export class ProfileResolutionError extends Error {
+}
+/**
+ * يصعد من مجلد ما بحثًا عن جذر مستودع Fantastic: ‎package.json‎ باسم ‎fantastic‎ وفيه ‎workspaces‎.
+ * الصعود هو ما يجعل الأوامر تعمل من أي مجلد داخل المستودع لا من جذره فقط.
+ */
+export function findRepoRoot(from = process.cwd()) {
+    let current = resolve(from);
+    const { root } = parse(current);
+    for (;;) {
+        const manifestPath = join(current, "package.json");
+        if (existsSync(manifestPath)) {
+            try {
+                const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+                if (manifest.name === "fantastic" && Array.isArray(manifest.workspaces))
+                    return current;
+            }
+            catch {
+                // ملف تالف أو غير قابل للقراءة لا يوقف الصعود: قد يكون الجذر الحقيقي أعلى منه.
+            }
+        }
+        if (current === root)
+            return undefined;
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+/** الدليل على وجود جهاز في مجلد: مدخل النواة، بأيّ من شكليه. */
+function looksInstalled(root) {
+    return [join(root, "core", "main.js"), join(root, "core", "fantastic-core.exe")].some((path) => existsSync(path));
+}
+/**
+ * AR: **الجهاز الذي تعيش هذه الواجهة داخله**، إن كانت مشحونة داخل حزمة (٠١٨).
+ *
+ *     منذ ٠١٨ تُشحن الواجهة في ‎<root>\cli\‎، فموقع هذا الملف نفسه يدلّ على جذر التثبيت: ثلاث درجات
+ *     فوق ‎cli\dist\profiles‎. وهذا ما يجعل تثبيتًا بـ‎--root D:\Fantastic‎ يعمل: الشيمة تنتقل مع
+ *     المجلد بمسارات نسبية، وكان الاستنتاج وحده يبقى مثبَّتًا على ‎C:\Fantastic‎ فيقول للفنّي
+ *     «لا يوجد نظام» وهو واقفٌ داخله.
+ *
+ *     والدليل يُفحَص ولا يُفترَض: في المستودع تصعد الدرجات الثلاث إلى ‎apps\‎ ولا نواة هناك، فيعود
+ *     ‎undefined‎ ولا يتغيّر شيء في بيئة التطوير.
+ * EN: **The appliance this CLI lives inside**, when it is shipped within a bundle (018).
+ *
+ *     Since 018 the CLI ships at `<root>\cli\`, so this file's own location reveals the install root:
+ *     three levels above `cli\dist\profiles`. This is what makes an install at `--root D:\Fantastic`
+ *     work: the shim travels with the folder on relative paths, and detection alone stayed pinned to
+ *     `C:\Fantastic`, telling the technician "no system found" while they stood inside one.
+ *
+ *     The evidence is checked rather than assumed: inside the repository those three levels land on
+ *     `apps\`, where there is no core, so this returns `undefined` and development is unaffected.
+ */
+function findEnclosingAppliance() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const candidate = resolve(here, "..", "..", "..");
+        return looksInstalled(candidate) ? candidate : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * هل يوجد جهاز مركّب على هذه الآلة؟ الدليل مدخل النواة المُثبَّت لا مجرّد وجود المجلد.
+ *
+ * كان الفحص على ‎core\fantastic-core.exe‎ — ملفّ لم يُنتَج قط، فكان وضع الجهاز غير قابل للاستنتاج
+ * إطلاقًا. صار على ‎core\main.js‎: ما تكتبه الحزمة فعلًا (017/T048).
+ *
+ * ونقبل الملف التنفيذي المُترجَم أيضًا، ليعمل هذا الاستنتاج بلا تعديل يوم يصل الترخيص وتُترجَم
+ * الخدمات — الشرط أن يوجد **أحدهما**، لا أن يوجد شكل بعينه.
+ *
+ * الترتيب: ‎FANTASTIC_HOME‎ الصريح، ثم الجهاز الذي تعيش الواجهة داخله، ثم الموضع الافتراضي. الصريح
+ * أوّلًا لأنه قصدُ من كتبه، والمُستنتَج قبل الافتراضي لأنه حقيقةٌ مقروءة من القرص لا موضعٌ متوقَّع.
+ */
+export function findApplianceRoot() {
+    const declared = process.env.FANTASTIC_HOME;
+    if (declared)
+        return looksInstalled(declared) ? declared : undefined;
+    return findEnclosingAppliance() ?? (looksInstalled(APPLIANCE_ROOT) ? APPLIANCE_ROOT : undefined);
+}
+function readLocalConfig(stateDir) {
+    const path = join(stateDir, "config.json");
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        // إعدادات تالفة لا يجوز أن تمنع ‎stop‎ أو ‎doctor‎ من العمل، فنتجاهلها ونمضي بالافتراضيات.
+        return {};
+    }
+}
+/**
+ * AR: يستشير سجلّ المثبَّت قبل المسح (٠٢٦). **والترتيب بين هذا والمسح مقصود**: السجلّ يعرف
+ *     المنتجات بأسمائها ومنافذها، والمسح يعرف موضعًا واحدًا معتادًا. فالسجلّ يُسأل أولًا، وما لا
+ *     يجيبه يبقى للمسح كما كان — فجهازٌ ثُبِّت قبل ٠٢٦ ولا قيد له يظلّ يعمل.
+ * EN: Consults the installed-products registry before scanning (026). **The order between this and
+ *     the scan is deliberate**: the registry knows products by name and port, the scan knows one
+ *     customary location. So the registry is asked first, and whatever it cannot answer falls
+ *     through to the scan as before — so an appliance installed before 026, with no entry, keeps
+ *     working.
+ */
+function rootFromRegistry(product) {
+    const { products, newerSchema } = readRegistry();
+    if (newerSchema) {
+        return {
+            problem: "the machine's product registry was written by a newer CLI. Update this one:\n" +
+                "    npm i -g @wasmsoft/fantastic@latest",
+        };
+    }
+    const outcome = resolveProduct(products, product);
+    if (outcome.unknown && product) {
+        const known = products.map((row) => row.id).join(", ") || "nothing";
+        return { problem: `no product named "${product}" is installed here. Installed: ${known}` };
+    }
+    if (outcome.ambiguous) {
+        const names = products.map((row) => `      · ${row.id}  (${row.version}, ${row.root})`).join("\n");
+        return {
+            problem: `more than one product is installed here — name the one you mean:\n${names}\n\n    fantastic <command> --product <name>`,
+        };
+    }
+    return { root: outcome.product?.root };
+}
+export function resolveProfile(options = {}) {
+    const { kind, cwd = process.cwd(), ensureDirs = true, product } = options;
+    const envKind = process.env.FANTASTIC_PROFILE;
+    const repoRoot = findRepoRoot(cwd);
+    // AR: **السجلّ قبل المسح** (٠٢٦). ‎--product‎ يُسأل عنه هنا وحده؛ وبلا عَلَمٍ يُستنتَج الواحد
+    //     ويُرفض التخمين عند التعدّد. وما لا يجيبه السجلّ يسقط إلى المسح كما كان دائمًا.
+    // EN: **The registry before the scan** (026). `--product` is answered here alone; with no flag the
+    //     single product is inferred and guessing is refused when there are several. Whatever the
+    //     registry cannot answer falls through to the scan, as it always did.
+    const registry = rootFromRegistry(product);
+    if (registry.problem)
+        throw new ProfileResolutionError(registry.problem);
+    const applianceRoot = registry.root ?? findApplianceRoot();
+    const requested = kind ??
+        envKind ??
+        // المستودع يسبق الجهاز: مطوّر يعمل داخل المستودع على آلة فيها جهاز مركّب يقصد المستودع.
+        (repoRoot ? "dev" : applianceRoot ? "appliance" : undefined);
+    if (!requested) {
+        // العلاج يجب أن **يعالج**. النسخة الأولى كانت تقترح ‎--profile‎، وهو اقتراح لا ينفع من خارج
+        // المستودع: ‎--profile dev‎ يفشل هناك أيضًا لأن الجذر غير موجود أصلًا. العَلَم يُرجّح بين
+        // موجودَين، ولا يُوجِد معدومًا. فنقول أين بحثنا، ونعطي ثلاثة طرق تعمل فعلًا.
+        const searched = process.env.FANTASTIC_HOME ?? APPLIANCE_ROOT;
+        throw new ProfileResolutionError([
+            `No Fantastic system found from ${cwd}.`,
+            "",
+            `  Looked for a repository by walking up from here, and for an appliance at ${searched}.`,
+            "",
+            "  Do one of:",
+            "    · cd into the Fantastic repository, then run the command again",
+            "    · install an appliance:  fantastic install --from <bundle.zip>",
+            `    · point at an existing install:  set FANTASTIC_HOME=<path>  (currently ${searched})`,
+        ].join("\n"));
+    }
+    const profile = requested === "dev"
+        ? buildDev(repoRoot, cwd)
+        : buildAppliance(applianceRoot ?? process.env.FANTASTIC_HOME ?? APPLIANCE_ROOT);
+    if (ensureDirs) {
+        mkdirSync(profile.runDir, { recursive: true });
+        mkdirSync(profile.logDir, { recursive: true });
+    }
+    return profile;
+}
+function buildDev(repoRoot, cwd) {
+    if (!repoRoot) {
+        throw new ProfileResolutionError(`Profile "dev" was requested but no repository root was found starting at ${cwd}. Run this from inside the repository.`);
+    }
+    const config = readLocalConfig(join(repoRoot, ".fantastic"));
+    return createDevProfile({
+        root: repoRoot,
+        corePort: config.corePort ?? DEV_DEFAULTS.corePort,
+        livePort: config.livePort ?? DEV_DEFAULTS.livePort,
+        portalPort: config.portalPort ?? DEV_DEFAULTS.portalPort,
+        logLevel: config.logLevel ?? DEV_DEFAULTS.logLevel,
+        dataDir: process.env.FANTASTIC_DATA_DIR ?? config.dataDir,
+    });
+}
+export function buildAppliance(root) {
+    const config = readLocalConfig(root);
+    return createApplianceProfile({
+        root,
+        corePort: config.corePort ?? APPLIANCE_DEFAULTS.corePort,
+        livePort: config.livePort ?? APPLIANCE_DEFAULTS.livePort,
+        logLevel: config.logLevel ?? APPLIANCE_DEFAULTS.logLevel,
+        centralApiUrl: config.centralApiUrl,
+        licensePublicKey: config.licensePublicKey,
+    });
+}
+//# sourceMappingURL=resolve.js.map

package/dist/profiles/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/profiles/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AA4C7E,MAAM,OAAO,sBAAuB,SAAQ,KAAK;CAAG;AAEpD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,OAAO,CAAC,GAAG,EAAE;IACvD,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAEhC,SAAS,CAAC;QACR,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAEnD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAG7D,CAAC;gBACF,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAAE,OAAO,OAAO,CAAC;YAC1F,CAAC;YAAC,MAAM,CAAC;gBACP,+EAA+E;YACjF,CAAC;QACH,CAAC;QAED,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACvC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,SAAS,CAAC;QACzC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACpH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,sBAAsB;IAC7B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC5C,IAAI,QAAQ;QAAE,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAErE,OAAO,sBAAsB,EAAE,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAgB,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,2FAA2F;QAC3F,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAgBD;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,OAA2B;IACnD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE,CAAC;IAEjD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO;YACL,OAAO,EACL,+EAA+E;gBAC/E,yCAAyC;SAC5C,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAElD,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,qBAAqB,OAAO,mCAAmC,KAAK,EAAE,EAAE,CAAC;IAC7F,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnG,OAAO;YACL,OAAO,EAAE,qEAAqE,KAAK,8CAA8C;SAClI,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAA0B,EAAE;IACzD,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE1E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAA4C,CAAC;IACzE,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAEnC,8FAA8F;IAC9F,qFAAqF;IACrF,mGAAmG;IACnG,8FAA8F;IAC9F,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,QAAQ,CAAC,OAAO;QAAE,MAAM,IAAI,sBAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEzE,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,IAAI,iBAAiB,EAAE,CAAC;IAE3D,MAAM,SAAS,GACb,IAAI;QACJ,OAAO;QACP,wFAAwF;QACxF,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAE/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,4FAA4F;QAC5F,0FAA0F;QAC1F,6EAA6E;QAC7E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,cAAc,CAAC;QAE9D,MAAM,IAAI,sBAAsB,CAC9B;YACE,kCAAkC,GAAG,GAAG;YACxC,EAAE;YACF,8EAA8E,QAAQ,GAAG;YACzF,EAAE;YACF,cAAc;YACd,oEAAoE;YACpE,oEAAoE;YACpE,8EAA8E,QAAQ,GAAG;SAC1F,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GACX,SAAS,KAAK,KAAK;QACjB,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC;QACzB,CAAC,CAAC,cAAc,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,cAAc,CAAC,CAAC;IAEpF,IAAI,UAAU,EAAE,CAAC;QACf,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,QAA4B,EAAE,GAAW;IACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,sBAAsB,CAC9B,4EAA4E,GAAG,wCAAwC,CACxH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAE7D,OAAO,gBAAgB,CAAC;QACtB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ;QAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ;QAClD,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,YAAY,CAAC,UAAU;QACxD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ;QAClD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM,CAAC,OAAO;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO,sBAAsB,CAAC;QAC5B,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,kBAAkB,CAAC,QAAQ;QACxD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,kBAAkB,CAAC,QAAQ;QACxD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,kBAAkB,CAAC,QAAQ;QACxD,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/dist/profiles/types.d.ts

@@ -0,0 +1,57 @@
+/** الخدمات التي يشرف عليها الـ CLI. الترتيب هنا ليس ترتيب الإقلاع؛ ذاك يقرّره ترتيب المصفوفة. */
+export type ServiceName = "live" | "core" | "portal";
+/**
+ * كيف نعرف أن الخدمة **جاهزة** لا مجرّد **مُطلَقة**. الفرق جوهري: NestJS يستغرق ثوانيَ حتى يستمع،
+ * وVite يبني الاعتماديات في أول تشغيل، فالإطلاق وحده لا يعني شيئًا لمن ينتظرها.
+ */
+export type ReadinessProbe = 
+/** نداء HTTP يجب أن يعيد 2xx. المسار نسبيّ لأصل الخدمة. */
+{
+    kind: "http";
+    path: string;
+}
+/** اتصال TCP ناجح. يكفي لـ Vite لأنه لا يقدّم نقطة صحة. */
+ | {
+    kind: "tcp";
+};
+/** تعريف خدمة واحدة: كيف تُطلَق، وأين، وبأي بيئة، وكيف نعرف أنها جاهزة. */
+export interface ServiceDefinition {
+    name: ServiceName;
+    /** التسمية العربية المعروضة في الجداول والسجلات. */
+    label: string;
+    /** الملف التنفيذي. على ويندوز يجب أن يكون ‎npm.cmd‎ لا ‎npm‎. */
+    command: string;
+    args: string[];
+    /** مجلد العمل. مهم لأن ‎DATA_DIR‎ في النواة يُحلّ نسبةً إليه. */
+    cwd: string;
+    /** بيئة إضافية تُدمج فوق بيئة العملية الأب. */
+    env: Record<string, string>;
+    host: string;
+    port: number;
+    readiness: ReadinessProbe;
+    /** مهلة الجاهزية. تجاوزها يعني تراجعًا نظيفًا لا انتظارًا لا نهائيًا. */
+    readyTimeoutMs: number;
+}
+export type ProfileKind = "dev" | "appliance";
+/**
+ * ملفّ التشغيل المُحلّل: المصدر **الوحيد** للمنافذ والمسارات وأوامر الإطلاق. وجود مصدر واحد هو ما
+ * يجعل انحراف ‎DATA_DIR‎ بين النواة وخدمة البث مستحيلًا بنيويًا لا بالانضباط (المصيدة 2 في الخطة).
+ */
+export interface Profile {
+    kind: ProfileKind;
+    /** جذر النظام: مجلد المستودع في dev، ومجلد التثبيت في appliance. */
+    root: string;
+    /** مجلد بيانات النواة، مطلقًا دائمًا. خدمة البث تشتقّ مجلدها منه ولا تكتبه مرتين. */
+    dataDir: string;
+    /** مجلد حالة التشغيل: ملفات PID والسجلات وإعدادات الـ CLI. */
+    stateDir: string;
+    logDir: string;
+    runDir: string;
+    /** الخدمات **بترتيب الإقلاع**. الإيقاف يعكس هذا الترتيب. */
+    services: ServiceDefinition[];
+}
+/** يجد تعريف خدمة بالاسم، أو undefined إن كان ملفّ التشغيل لا يشرف عليها (الواجهة في appliance). */
+export declare function findService(profile: Profile, name: ServiceName): ServiceDefinition | undefined;
+/** أصل الخدمة كما يُنادى محليًا. نستعمل 127.0.0.1 حين تستمع على 0.0.0.0 لأن الأخير ليس وجهة صالحة. */
+export declare function serviceOrigin(service: ServiceDefinition): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/profiles/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/profiles/types.ts"],"names":[],"mappings":"AAMA,iGAAiG;AACjG,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,cAAc;AACxB,2DAA2D;AACzD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAChC,2DAA2D;GACzD;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpB,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,cAAc,CAAC;IAC1B,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,WAAW,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAE9F;AAED,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAGhE"}

package/dist/profiles/types.js

@@ -0,0 +1,15 @@
+// AR: أنواع ملفّ التشغيل. هذا الملف يصف "ما هي الخدمة" مرة واحدة، فيصير كل ما عداه — المشرف
+//     والمسابر والعارضات — محايدًا تجاه كون النظام مستودعًا تطويريًا أم جهازًا مركّبًا عند العميل.
+// EN: Profile types. This file describes "what a service is" once, which is what lets everything
+//     else — the supervisor, the probes, the renderers — stay neutral about whether the system is a
+//     development repository or an installed appliance.
+/** يجد تعريف خدمة بالاسم، أو undefined إن كان ملفّ التشغيل لا يشرف عليها (الواجهة في appliance). */
+export function findService(profile, name) {
+    return profile.services.find((service) => service.name === name);
+}
+/** أصل الخدمة كما يُنادى محليًا. نستعمل 127.0.0.1 حين تستمع على 0.0.0.0 لأن الأخير ليس وجهة صالحة. */
+export function serviceOrigin(service) {
+    const host = service.host === "0.0.0.0" || service.host === "::" ? "127.0.0.1" : service.host;
+    return `http://${host}:${service.port}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/profiles/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/profiles/types.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,mGAAmG;AACnG,iGAAiG;AACjG,oGAAoG;AACpG,wDAAwD;AAsDxD,oGAAoG;AACpG,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,IAAiB;IAC7D,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,aAAa,CAAC,OAA0B;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9F,OAAO,UAAU,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/dist/registry/local-registry.d.ts

@@ -0,0 +1,79 @@
+/** ما نعرف كيف نقرؤه. رقمٌ أعلى يعني ملفًّا كتبته واجهةٌ أحدث — نتوقّف ولا نخمّن. */
+export declare const REGISTRY_SCHEMA_VERSION = 1;
+export declare const REGISTRY_DIR: string;
+export declare const REGISTRY_FILE: string;
+export type InstalledProduct = {
+    id: string;
+    version: string;
+    root: string;
+    ports: {
+        core: number;
+        live: number;
+    };
+    installedAt: string;
+    installedBy: string;
+};
+/**
+ * AR: يقرأ شجرة تثبيتٍ ويستنتج ما يعرفه عنها. **البيان هو الدليل**: مجلدٌ بلا ‎versions.json‎
+ *     صالح ليس تثبيتًا لنا مهما كان اسمه، وقبولُه يُدرِج في السجلّ مجلدًا عشوائيًّا.
+ * EN: Reads an install tree and infers what it can. **The manifest is the proof**: a directory
+ *     without a valid `versions.json` is not one of our installations whatever it is called, and
+ *     accepting it would list a random folder in the registry.
+ */
+export declare function inspectRoot(root: string, id?: string): InstalledProduct | undefined;
+/**
+ * AR: يعيد بناء السجلّ من الأنظمة نفسها. يُستدعى حين يضيع الملفّ أو يتلف، **ولا يُستدعى في كل
+ *     أمر**: المسح أبطأ من قراءة ملفّ، والاختصار الذي يُحسَب في كل مرّة ليس اختصارًا.
+ * EN: Rebuilds the registry from the installations themselves. Called when the file is lost or
+ *     corrupt, **not on every command**: scanning is slower than reading a file, and a shortcut
+ *     recomputed every time is not a shortcut.
+ */
+export declare function rebuild(extraRoots?: string[]): InstalledProduct[];
+export type RegistryRead = {
+    products: InstalledProduct[];
+    /** صحيح حين أُعيد البناء لأن الملفّ ضاع أو تلف — يُعلَن للمستخدم مرّة، ولا يُخفى. */
+    rebuilt: boolean;
+    /** صحيح حين كتب الملفَّ إصدارٌ أحدث من هذه الواجهة: نتوقّف ونطلب تحديثها. */
+    newerSchema: boolean;
+};
+/**
+ * AR: **القراءة الوحيدة التي تُستعمل في الأوامر.** تقرأ، وتُسقط ما لم يعد موجودًا على القرص،
+ *     وتعيد البناء عند الحاجة.
+ *
+ *     وإسقاطُ الجذر المفقود مقصود: قرصٌ نُزع أو مجلدٌ حُذف بيد أحدهم يترك قيدًا يشير إلى لا شيء،
+ *     وأمرُ حالةٍ يقرؤه يُبلّغ عن نظامٍ لا وجود له. ولا يُحذف القيد من الملفّ في القراءة — القراءة
+ *     لا تكتب؛ يسقط من الجواب، ويُكتب الملفّ عند أول تسجيلٍ أو إزالة.
+ * EN: **The only read the commands use.** It reads, drops what no longer exists on disk, and
+ *     rebuilds when it must.
+ *
+ *     Dropping a missing root is deliberate: an unplugged disk or a folder somebody deleted leaves
+ *     an entry pointing at nothing, and a status command reading it reports an appliance that does
+ *     not exist. The entry is not deleted from the file during a read — reads do not write; it is
+ *     dropped from the answer, and the file is rewritten at the next record or removal.
+ */
+export declare function readRegistry(): RegistryRead;
+/**
+ * AR: يسجّل منتجًا بعد **نجاح** تثبيته. الموضع في ‎install.ts‎ مقصود: بعد PATH ومهمّة الإقلاع، مع
+ *     بقيّة الآثار خارج مجلد التثبيت — فتثبيتٌ فشل وتراجع لا يترك قيدًا يشير إلى شجرةٍ حُذفت.
+ * EN: Records a product after its installation **succeeded**. Its placement in `install.ts` is
+ *     deliberate: after PATH and the boot task, with the rest of the traces outside the install
+ *     directory — so a failed, rolled-back install leaves no entry pointing at a deleted tree.
+ */
+export declare function recordInstall(product: InstalledProduct): void;
+/** يزيل قيد منتجٍ بعد نجاح إزالته. غيابه أصلًا ليس خطأً — الغاية بلوغ حالةٍ لا تنفيذ خطوة. */
+export declare function forgetInstall(id: string): void;
+/**
+ * AR: منتجٌ واحد يُستنتَج، وأكثر يُطلب تحديده. **ولا يُخمَّن عند التعدّد**: أمرُ إيقافٍ يصيب
+ *     الجهاز الخطأ في استراحةٍ تعمل أسوأ من أمرٍ يسأل.
+ * EN: One product is inferred; more than one must be named. **Never guessed when there are
+ *     several**: a stop command hitting the wrong appliance in a working rest-house is worse than a
+ *     command that asks.
+ */
+export declare function resolveProduct(products: InstalledProduct[], requested?: string): {
+    product?: InstalledProduct;
+    ambiguous: boolean;
+    unknown: boolean;
+};
+/** يُستعمل في الاختبارات وحدها: يمسح الملفّ. لا أمر ينادي هذه. */
+export declare function forgetEverything(): void;
+//# sourceMappingURL=local-registry.d.ts.map

package/dist/registry/local-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-registry.d.ts","sourceRoot":"","sources":["../../src/registry/local-registry.ts"],"names":[],"mappings":"AAsCA,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,eAAO,MAAM,YAAY,QAAkE,CAAC;AAC5F,eAAO,MAAM,aAAa,QAAsC,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AA4EF;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAY,GAAG,gBAAgB,GAAG,SAAS,CAyBtF;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,UAAU,GAAE,MAAM,EAAO,GAAG,gBAAgB,EAAE,CAWrE;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,qFAAqF;IACrF,OAAO,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,IAAI,YAAY,CA0C3C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAM7D;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAStE;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}