@wasmsoft/fantastic 1.0.0

package/dist/commands/live/channels.js

@@ -0,0 +1,55 @@
+import { Flags } from "@oclif/core";
+import Table from "cli-table3";
+import { BaseCommand } from "../../base-command.js";
+import { getInternal } from "../../probes/internal.client.js";
+import { INTERNAL_PATHS } from "../../probes/internal-paths.js";
+import { buildEnvelope, renderJson } from "../../render/json.js";
+import { NOT_REPORTED, c } from "../../render/theme.js";
+export default class LiveChannels extends BaseCommand {
+    static description = "List the live channels the core knows about";
+    static examples = ["<%= config.bin %> live channels", "<%= config.bin %> live channels --json"];
+    static flags = {
+        provider: Flags.string({ description: "Only channels from this provider." }),
+    };
+    async run() {
+        const { flags } = await this.parse(LiveChannels);
+        const profile = this.loadProfile(flags.profile, false, flags.product);
+        const result = await getInternal(profile, INTERNAL_PATHS.LIVE_CHANNELS);
+        if (!result.ok)
+            this.coreUnreachable("live channels", profile, result.reason, flags.json);
+        const channels = flags.provider
+            ? result.data.filter((channel) => channel.providerName === flags.provider)
+            : result.data;
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({ command: "live channels", profile, data: { channels } })));
+            return;
+        }
+        if (channels.length === 0) {
+            this.log("");
+            this.log(c.dim(flags.provider ? `no channels from "${flags.provider}".` : "no channels configured."));
+            this.log("");
+            return;
+        }
+        const table = new Table({
+            head: ["#", "Channel", "Category", "Provider"].map((header) => c.dim(header)),
+            style: { head: [], border: [], "padding-left": 1, "padding-right": 1 },
+        });
+        for (const channel of channels.slice(0, 60)) {
+            table.push([
+                String(channel.id),
+                channel.name ?? NOT_REPORTED,
+                channel.category ?? c.dim(NOT_REPORTED),
+                channel.providerName ?? c.dim(NOT_REPORTED),
+            ]);
+        }
+        this.log("");
+        this.log(table.toString());
+        // القصّ يُعلَن ولا يُخفى: قائمة مبتورة صامتة تُقرأ على أنها كل ما يوجد.
+        if (channels.length > 60)
+            this.log(c.dim(`showing 60 of ${channels.length} — use --json for all`));
+        else
+            this.log(c.dim(`${channels.length} channel(s)`));
+        this.log("");
+    }
+}
+//# sourceMappingURL=channels.js.map

package/dist/commands/live/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../../src/commands/live/channels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAC;AAQxD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAC,WAAW,GAAG,6CAA6C,CAAC;IAEnE,MAAM,CAAC,QAAQ,GAAG,CAAC,iCAAiC,EAAE,wCAAwC,CAAC,CAAC;IAEhG,MAAM,CAAC,KAAK,GAAG;QACb,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC;KAC7E,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAY,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;QACnF,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,eAAe,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE1F,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ;YAC7B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,QAAQ,CAAC;YAC1E,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAEhB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/F,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAqB,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC;YACtG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;YACtB,IAAI,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC7E,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE;SACvE,CAAC,CAAC;QAEH,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC;gBACT,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClB,OAAO,CAAC,IAAI,IAAI,YAAY;gBAC5B,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;gBACvC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE3B,wEAAwE;QACxE,IAAI,QAAQ,CAAC,MAAM,GAAG,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,MAAM,uBAAuB,CAAC,CAAC,CAAC;;YAC9F,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC;QAEtD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACf,CAAC"}

package/dist/commands/live/test.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from "../../base-command.js";
+export default class LiveTest extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        source: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /** من ملفّ التشغيل: ‎runtime\ffprobe.exe‎ على الجهاز، وحزمة المُثبِّت في المستودع. */
+    private ffprobePath;
+}
+//# sourceMappingURL=test.d.ts.map

package/dist/commands/live/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/commands/live/test.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAwBpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAC,WAAW,SAA+E;IAEjG,MAAM,CAAC,QAAQ,WAGb;IAEF,MAAM,CAAC,IAAI;;MAET;IAEF,MAAM,CAAC,KAAK;;MAEV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAqG1B,sFAAsF;IACtF,OAAO,CAAC,WAAW;CAOpB"}

package/dist/commands/live/test.js

@@ -0,0 +1,116 @@
+import { Args, Flags } from "@oclif/core";
+import { execa } from "execa";
+import ora from "ora";
+import { BaseCommand } from "../../base-command.js";
+import { buildEnvelope, renderJson } from "../../render/json.js";
+import { c, glyph, isTty } from "../../render/theme.js";
+import { EXIT } from "../../exit-codes.js";
+// AR: يفحص مصدر بثّ **قبل** إضافته.
+//
+//     يستعمل ‎ffprobe‎ المُجمَّع مباشرةً، وهذا استثناء مقصود من قاعدة «النواة تقرّر»: هذا ليس سؤالًا
+//     عن بيانات النظام بل عن **رابط لم يُضَف بعد** ولا تعرفه النواة أصلًا. سؤالها عنه سيتطلّب أن
+//     تحفظه أوّلًا، وهو عكس الغرض — أن يُختبَر المصدر قبل الالتزام به.
+//
+//     ومسار ‎ffprobe‎ يأتي من ملفّ التشغيل نفسه، فيصحّ في المستودع وفي الجهاز المركّب بلا فرق.
+// EN: Probes a live source **before** it is added.
+//
+//     It uses the bundled ffprobe directly, and that is a deliberate exception to the "core decides"
+//     rule: this is not a question about system data but about **a URL that has not been added yet**
+//     and that the core knows nothing about. Asking the core would require saving it first, which is
+//     the opposite of the point — testing a source before committing to it.
+//
+//     The ffprobe path comes from the profile, so it is correct in the repository and on an
+//     installed appliance alike.
+const DEFAULT_TIMEOUT_SECONDS = 15;
+export default class LiveTest extends BaseCommand {
+    static description = "Probe a live source before adding it: does it answer, and with what codec";
+    static examples = [
+        "<%= config.bin %> live test http://example.com/stream.m3u8",
+        "<%= config.bin %> live test <url> --timeout 30",
+    ];
+    static args = {
+        source: Args.string({ description: "Stream URL to probe", required: true }),
+    };
+    static flags = {
+        timeout: Flags.integer({ description: "Seconds to wait.", default: DEFAULT_TIMEOUT_SECONDS }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(LiveTest);
+        const profile = this.loadProfile(flags.profile, false, flags.product);
+        const ffprobe = this.ffprobePath(profile);
+        const spinner = ora({ isEnabled: isTty && !flags.json, discardStdin: false });
+        spinner.start("probing the source…");
+        const started = Date.now();
+        const result = await execa(ffprobe, [
+            "-v",
+            "error",
+            "-print_format",
+            "json",
+            "-show_streams",
+            "-show_format",
+            "-analyzeduration",
+            "3000000",
+            args.source,
+        ], { timeout: Math.max(1, flags.timeout) * 1_000, reject: false });
+        spinner.stop();
+        const elapsedMs = Date.now() - started;
+        const ok = result.exitCode === 0 && result.stdout.trim().length > 0;
+        if (!ok) {
+            const reason = (result.stderr || "the source did not answer").split("\n")[0] ?? "unknown";
+            if (flags.json) {
+                this.log(renderJson(buildEnvelope({
+                    command: "live test",
+                    profile,
+                    data: { source: args.source, reachable: false, elapsedMs },
+                    problems: [
+                        {
+                            id: "live.source",
+                            severity: "fail",
+                            message: reason,
+                            remedy: "Check the URL and any credentials it needs, then try a longer --timeout.",
+                        },
+                    ],
+                })));
+                this.exit(EXIT.FAILURE);
+            }
+            this.log("");
+            this.log(c.bad(`The source did not answer — ${reason}`));
+            this.log(`${c.accent(glyph.arrow)} Check the URL and its credentials, then retry with a longer --timeout.`);
+            this.log("");
+            this.exit(EXIT.FAILURE);
+        }
+        const probe = JSON.parse(result.stdout);
+        const video = probe.streams?.find((stream) => stream.codec_type === "video");
+        const audio = probe.streams?.find((stream) => stream.codec_type === "audio");
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({
+                command: "live test",
+                profile,
+                data: {
+                    source: args.source,
+                    reachable: true,
+                    elapsedMs,
+                    container: probe.format?.format_name ?? null,
+                    video: video ? { codec: video.codec_name, width: video.width, height: video.height } : null,
+                    audio: audio ? { codec: audio.codec_name } : null,
+                },
+            })));
+            return;
+        }
+        this.log("");
+        this.log(`${c.ok(glyph.pass)} The source answered in ${(elapsedMs / 1000).toFixed(1)}s`);
+        this.log(` ${c.dim("Container".padEnd(14))} ${probe.format?.format_name ?? c.dim("—")}`);
+        this.log(` ${c.dim("Video".padEnd(14))} ${video ? `${video.codec_name} ${video.width}×${video.height}` : c.dim("none")}`);
+        this.log(` ${c.dim("Audio".padEnd(14))} ${audio ? audio.codec_name : c.dim("none")}`);
+        this.log("");
+    }
+    /** من ملفّ التشغيل: ‎runtime\ffprobe.exe‎ على الجهاز، وحزمة المُثبِّت في المستودع. */
+    ffprobePath(profile) {
+        const core = profile.services.find((service) => service.name === "core");
+        const fromProfile = core?.env.FFPROBE_PATH;
+        if (fromProfile)
+            return fromProfile;
+        return `${profile.root}\\node_modules\\@ffprobe-installer\\win32-x64\\ffprobe.exe`;
+    }
+}
+//# sourceMappingURL=test.js.map

package/dist/commands/live/test.js.map

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

package/dist/commands/logs.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from "../base-command.js";
+export default class Logs extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        service: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        follow: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lines: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private printHistory;
+    private follow;
+}
+//# sourceMappingURL=logs.d.ts.map

package/dist/commands/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgBjD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,MAAM,CAAC,WAAW,SAA4C;IAE9D,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,IAAI;;MAMT;IAEF,MAAM,CAAC,KAAK;;;MAWV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB1B,OAAO,CAAC,YAAY;YAYN,MAAM;CAiBrB"}

package/dist/commands/logs.js

@@ -0,0 +1,77 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../base-command.js";
+import { followLogs, readTail } from "../logs/tail.js";
+import { c, servicePrefixColor } from "../render/theme.js";
+// AR: عرض السجلات. تحلّ المصيدة السادسة: النواة تكتب على stdout و‎LOG_DIR‎ بلا مصرف ملفات موصول به،
+//     فما كان هناك مكان واحد تُقرأ منه سجلات الخدمات الثلاث.
+// EN: Log viewing. It solves the sixth trap: the core writes to stdout and LOG_DIR has no file
+//     transport wired to it, so there was no single place to read all three services' logs.
+const SERVICES = ["live", "core", "portal"];
+function prefix(service) {
+    return servicePrefixColor[service](`[${service.padEnd(6)}]`);
+}
+export default class Logs extends BaseCommand {
+    static description = "Show service logs, or follow them live";
+    static examples = [
+        "<%= config.bin %> logs",
+        "<%= config.bin %> logs core -n 100",
+        "<%= config.bin %> logs --follow",
+    ];
+    static args = {
+        service: Args.string({
+            description: "A single service. Leave empty to show all.",
+            options: SERVICES,
+            required: false,
+        }),
+    };
+    static flags = {
+        follow: Flags.boolean({
+            char: "f",
+            description: "Follow new lines until you stop with Ctrl+C",
+            default: false,
+        }),
+        lines: Flags.integer({
+            char: "n",
+            description: "How many trailing lines to show",
+            default: 40,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Logs);
+        const profile = this.loadProfile(flags.profile, false, flags.product);
+        const available = profile.services.map((service) => service.name);
+        const targets = args.service ? [args.service] : available;
+        this.printHistory(profile.logDir, targets, flags.lines);
+        if (!flags.follow)
+            return;
+        this.log("");
+        this.log(c.dim("— following. Ctrl+C to exit —"));
+        await this.follow(profile.logDir, targets);
+    }
+    printHistory(logDir, targets, lines) {
+        for (const service of targets) {
+            const history = readTail(logDir, service, lines);
+            // التاريخ مقسّم بالخدمة لا مدموجًا: أسطر Vite بلا طوابع زمنية، فالدمج التاريخي سيكون ادّعاء.
+            this.log("");
+            this.log(`${prefix(service)} ${c.dim(history.length === 0 ? "no log yet" : `last ${history.length} lines`)}`);
+            for (const line of history)
+                this.log(`  ${line}`);
+        }
+    }
+    async follow(logDir, targets) {
+        return new Promise((resolvePromise) => {
+            const follower = followLogs({
+                logDir,
+                services: targets,
+                onLine: (service, line) => this.log(`${prefix(service)} ${line}`),
+            });
+            const finish = () => {
+                follower.stop();
+                resolvePromise();
+            };
+            process.once("SIGINT", finish);
+            process.once("SIGTERM", finish);
+        });
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/logs.js.map

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

package/dist/commands/migrate-cli.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from "../base-command.js";
+export default class MigrateCli extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        root: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=migrate-cli.d.ts.map

package/dist/commands/migrate-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-cli.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAsCjD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,WAAW,SAA+D;IAEjF,MAAM,CAAC,QAAQ,WAA4E;IAE3F,MAAM,CAAC,KAAK;;;MAGV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+E3B"}

package/dist/commands/migrate-cli.js

@@ -0,0 +1,116 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { Flags } from "@oclif/core";
+import { confirm } from "@inquirer/prompts";
+import { BaseCommand } from "../base-command.js";
+import { BUNDLE_DIRS, SHIM_FILES } from "../packaging/layout.js";
+import { unregisterFromMachinePath } from "../packaging/machine-path.js";
+import { inspectRoot, readRegistry, recordInstall } from "../registry/local-registry.js";
+import { findApplianceRoot } from "../profiles/resolve.js";
+import { buildEnvelope, renderJson } from "../render/json.js";
+import { c, glyph, isTty } from "../render/theme.js";
+import { EXIT } from "../exit-codes.js";
+// AR: يسوّي جهازًا رُكِّب قبل ٠٢٦ (FR-027).
+//
+//     **لماذا يلزم أمرٌ لهذا أصلًا؟** الأجهزة المثبَّتة اليوم تحمل أثرين كتبهما تثبيتٌ سابق:
+//     مُدخَلًا في PATH الآلة يشير إلى ‎bin\‎، وشيمةً كانت طريق الفنّي إلى الواجهة الكاملة. وقد صار
+//     الفنّي يصل إلى الواجهة من ‎npm‎، وصارت الشيمة تصل إلى **المُشرِف** الذي لا يقبل أوامر.
+//
+//     فيكتب الفنّي ‎fantastic status‎ على جهازٍ قديم، ويسبق مُدخَل PATH الحزمةَ العالمية، فيصل إلى
+//     المُشرِف — الذي يتجاهل ‎status‎ ويبدأ الإشراف. **عطلٌ يبدو تعليقًا**: لا رسالة خطأ، ولا شيء
+//     معطوب، والفنّي ينتظر جوابًا لن يأتي.
+//
+//     **ولا يُلمس النظام نفسه.** لا خدمة تتوقّف، ولا ملفّ يُحذف من التثبيت، ولا مهمّة إقلاع
+//     تُمَسّ — تلك تبقى تنادي الشيمة بمسارٍ مطلق كما كانت. ما يُنظَّف هو **مُدخَل PATH وحده**،
+//     وهو الشيء الوحيد الذي صار كذبًا.
+// EN: Settles an appliance installed before 026 (FR-027).
+//
+//     **Why does this need a command at all?** Appliances installed today carry two traces written by
+//     an earlier install: an entry on the machine's PATH pointing at `bin\`, and a shim that used to
+//     be the technician's route to the full CLI. The technician now reaches the CLI from npm, and the
+//     shim now reaches **the supervisor**, which takes no commands.
+//
+//     So a technician types `fantastic status` on an older machine, the PATH entry precedes the
+//     global package, and they land on the supervisor — which ignores `status` and starts
+//     supervising. **A fault that looks like a hang**: no error message, nothing broken, and a
+//     technician waiting for an answer that will never come.
+//
+//     **And the system itself is not touched.** No service stops, no file is removed from the
+//     installation, and the boot task is left alone — it goes on calling the shim by an absolute path
+//     as it always did. What is cleaned is **the PATH entry alone**, the one thing that became a lie.
+export default class MigrateCli extends BaseCommand {
+    static description = "Settle an appliance installed before the CLI moved to npm";
+    static examples = ["<%= config.bin %> migrate-cli", "<%= config.bin %> migrate-cli --yes"];
+    static flags = {
+        yes: Flags.boolean({ description: "Do not ask for confirmation.", default: false }),
+        root: Flags.string({ description: "Installation location. Detected when omitted." }),
+    };
+    async run() {
+        const { flags } = await this.parse(MigrateCli);
+        const root = flags.root ?? findApplianceRoot();
+        if (!root || !existsSync(root)) {
+            this.log("");
+            this.log(c.dim("No installed appliance found on this machine — nothing to settle."));
+            this.log("");
+            return;
+        }
+        const binDir = join(root, BUNDLE_DIRS.bin);
+        const shim = join(binDir, SHIM_FILES.command);
+        const registered = readRegistry().products.some((row) => row.root.toLowerCase() === root.toLowerCase());
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({ command: "migrate-cli", data: { root, binDir, shim: existsSync(shim), registered } })));
+            if (!flags.yes)
+                return;
+        }
+        else {
+            this.log("");
+            this.log(`${c.dim("appliance:")} ${c.value(root)}`);
+            this.log(`${c.dim("will clear:")} the machine PATH entry for ${binDir}`);
+            if (!registered)
+                this.log(`${c.dim("will record:")} this appliance in the machine's product registry`);
+            this.log(c.dim("nothing is stopped, and no file inside the installation is removed."));
+            this.log("");
+        }
+        if (!flags.yes && isTty) {
+            const proceed = await confirm({ message: `Settle the appliance at ${root}?`, default: true });
+            if (!proceed) {
+                this.log(c.dim("cancelled — nothing was changed."));
+                return;
+            }
+        }
+        const pathChange = await unregisterFromMachinePath(binDir, join(root, BUNDLE_DIRS.logs));
+        this.log(` ${pathChange.changed ? c.ok(glyph.pass) : c.dim("·")} PATH                 ${c.dim(pathChange.detail)}`);
+        // AR: **ويُسجَّل الجهاز إن لم يكن مسجَّلًا.** ثُبِّت قبل أن يوجد السجلّ، فبقيت الواجهة تجده
+        //     بالمسح وحده. وتسجيله هنا يجعله يُرى في ‎list‎ ويُسمّى في ‎--product‎ كأيّ تثبيتٍ جديد.
+        // EN: **And the appliance is recorded if it was not.** It was installed before the registry
+        //     existed, so the CLI found it by scanning alone. Recording it here makes it visible in
+        //     `list` and nameable with `--product`, like any new installation.
+        let recorded = false;
+        if (!registered) {
+            const product = inspectRoot(root);
+            if (product) {
+                try {
+                    recordInstall(product);
+                    recorded = true;
+                }
+                catch {
+                    recorded = false;
+                }
+            }
+        }
+        if (!registered) {
+            this.log(` ${recorded ? c.ok(glyph.pass) : c.dim("·")} Registry             ${c.dim(recorded ? "recorded" : "not written — it will still be found by scanning")}`);
+        }
+        this.log("");
+        this.log(c.ok(` ${glyph.pass} settled. "fantastic" now reaches the global package from any folder.`));
+        this.log(c.dim("   verify it:  fantastic doctor"));
+        this.log("");
+        if (!pathChange.changed && !recorded && registered) {
+            // لا شيء تغيّر لأن لا شيء كان يحتاج تغييرًا: يُقال صراحةً بدل «تمّ» التي توحي بعملٍ لم يقع.
+            this.log(c.dim("   (nothing needed changing — this appliance was already settled.)"));
+            this.log("");
+            this.exit(EXIT.OK);
+        }
+    }
+}
+//# sourceMappingURL=migrate-cli.js.map

package/dist/commands/migrate-cli.js.map

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

package/dist/commands/owner/reset.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand } from "../../base-command.js";
+export default class OwnerReset extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+//# sourceMappingURL=reset.d.ts.map

package/dist/commands/owner/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../../src/commands/owner/reset.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAiBpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,WAAW,SAA+D;IAEjF,MAAM,CAAC,QAAQ,WAAqC;IAE9C,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8D3B"}

package/dist/commands/owner/reset.js

@@ -0,0 +1,74 @@
+import boxen from "boxen";
+import ora from "ora";
+import { BaseCommand } from "../../base-command.js";
+import { runCoreScript, extractOwnerCredentials } from "../../core-scripts/run.js";
+import { buildEnvelope, renderJson } from "../../render/json.js";
+import { c, glyph, isTty } from "../../render/theme.js";
+import { EXIT } from "../../exit-codes.js";
+// AR: إعادة ضبط حساب المالك من أي مجلد. هذا هو مخرج من نسي كلمة المرور على جهاز بلا إنترنت ولا
+//     استعادة بالبريد — فلا شيء آخر يفتحه.
+//
+//     **لا تُطبَع كلمة المرور في ‎--json‎.** المخرَج الآلي يُوجَّه إلى ملف أو سجلّ في العادة، وكتابة
+//     بيانات دخول هناك تُخرجها من الشاشة إلى القرص. الطرفية تكفي لهذا الغرض.
+// EN: Resets the owner account from any directory. This is the way back in for someone who forgot
+//     the password on a machine with no internet and no email recovery — nothing else opens it.
+//
+//     **The password is not printed in --json.** Machine output is usually redirected to a file or a
+//     log, and writing credentials there moves them from the screen onto disk. The terminal suffices.
+export default class OwnerReset extends BaseCommand {
+    static description = "Reset the owner account password and show the credentials";
+    static examples = ["<%= config.bin %> owner reset"];
+    async run() {
+        const { flags } = await this.parse(OwnerReset);
+        const profile = this.loadProfile(flags.profile, true, flags.product);
+        const spinner = ora({ isEnabled: isTty && !flags.json, discardStdin: false });
+        spinner.start("resetting the owner account…");
+        const result = await runCoreScript(profile, "reset-owner");
+        spinner.stop();
+        const credentials = extractOwnerCredentials(result.output);
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({
+                command: "owner reset",
+                profile,
+                // القيمة نفسها لا تُنشَر هنا عمدًا؛ نقول إنها أُعيدت وأين تُقرأ.
+                data: { reset: result.ok, credentialsShownOnTerminalOnly: true },
+                problems: result.ok
+                    ? []
+                    : [
+                        {
+                            id: "owner.reset",
+                            severity: "fail",
+                            message: "the owner reset failed",
+                            remedy: "Run: fantastic doctor — the database may be missing or locked.",
+                        },
+                    ],
+            })));
+            if (!result.ok)
+                this.exit(EXIT.FAILURE);
+            return;
+        }
+        if (!result.ok) {
+            this.log(c.bad("The owner reset failed."));
+            this.log(result.output.split("\n").slice(-15).join("\n"));
+            this.log(`${c.accent(glyph.arrow)} Run: fantastic doctor`);
+            this.exit(EXIT.FAILURE);
+        }
+        if (!credentials) {
+            // نجح ولم نتعرّف على الشكل: نطبع المخرَج الخام بدل أن ندّعي قيمةً لم نقرأها.
+            this.log(result.output.trim());
+            return;
+        }
+        const body = [
+            c.label("OWNER ACCOUNT RESET"),
+            "",
+            `  user      ${c.value(credentials.username)}`,
+            `  password  ${c.accent(credentials.password)}`,
+            "",
+            c.dim("  This is the documented default. Change it from the admin panel."),
+        ].join("\n");
+        this.log("");
+        this.log(boxen(body, { padding: 1, borderStyle: "double", borderColor: "yellow" }));
+        this.log("");
+    }
+}
+//# sourceMappingURL=reset.js.map

package/dist/commands/owner/reset.js.map

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

package/dist/commands/restart.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from "../base-command.js";
+export default class Restart extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        service: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {};
+    run(): Promise<void>;
+}
+//# sourceMappingURL=restart.d.ts.map

package/dist/commands/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../src/commands/restart.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAWjD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,WAAW;IAC9C,MAAM,CAAC,WAAW,SAAwC;IAE1D,MAAM,CAAC,QAAQ,WAAmE;IAElF,MAAM,CAAC,IAAI;;MAMT;IAEF,MAAM,CAAC,KAAK,KAAM;IAEZ,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiC3B"}

package/dist/commands/restart.js

@@ -0,0 +1,53 @@
+import { Args } from "@oclif/core";
+import ora from "ora";
+import { BaseCommand } from "../base-command.js";
+import { restartServices } from "../supervisor/orchestrator.js";
+import { renderConflicts, renderStartOutcome, renderStopOutcome } from "../render/boot.render.js";
+import { isTty } from "../render/theme.js";
+// AR: إعادة تشغيل الكل أو خدمة واحدة. إعادة خدمة واحدة تفيد كثيرًا: تعديل في خدمة البث لا يستدعي
+//     إسقاط النواة والواجهة معه.
+// EN: Restart everything or one service. Restarting one matters in practice: a change in the live
+//     service should not take the core and the portal down with it.
+export default class Restart extends BaseCommand {
+    static description = "Restart every service, or just one";
+    static examples = ["<%= config.bin %> restart", "<%= config.bin %> restart live"];
+    static args = {
+        service: Args.string({
+            description: "Service name. Leave empty to restart all.",
+            options: ["live", "core", "portal"],
+            required: false,
+        }),
+    };
+    static flags = {};
+    async run() {
+        const { args, flags } = await this.parse(Restart);
+        const profile = this.loadProfile(flags.profile, true, flags.product);
+        const only = args.service ? [args.service] : undefined;
+        const spinner = ora({ isEnabled: isTty, discardStdin: false });
+        const { stopped, started } = await restartServices(profile, {
+            only,
+            onStep: (definition, phase) => {
+                if (phase === "starting")
+                    spinner.start(`starting ${definition.label}…`);
+                if (phase === "waiting")
+                    spinner.text = `waiting for ${definition.label} to be ready…`;
+                if (phase === "done")
+                    spinner.stop();
+            },
+        });
+        spinner.stop();
+        this.log("");
+        this.log(renderStopOutcome(stopped));
+        this.log("");
+        if (started.conflicts.length > 0) {
+            this.log(renderConflicts(started.conflicts));
+            this.log("");
+            this.exit(3);
+        }
+        this.log(renderStartOutcome(started));
+        this.log("");
+        if (!started.ok)
+            this.exit(1);
+    }
+}
+//# sourceMappingURL=restart.js.map