@wasmsoft/fantastic 1.0.0

package/dist/commands/restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../src/commands/restart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,iGAAiG;AACjG,iCAAiC;AACjC,kGAAkG;AAClG,oEAAoE;AAEpE,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,WAAW;IAC9C,MAAM,CAAC,WAAW,GAAG,oCAAoC,CAAC;IAE1D,MAAM,CAAC,QAAQ,GAAG,CAAC,2BAA2B,EAAE,gCAAgC,CAAC,CAAC;IAElF,MAAM,CAAC,IAAI,GAAG;QACZ,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,2CAA2C;YACxD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;IAElB,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAErE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,OAAO,CAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QAE/D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE;YAC1D,IAAI;YACJ,MAAM,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;gBAC5B,IAAI,KAAK,KAAK,UAAU;oBAAE,OAAO,CAAC,KAAK,CAAC,YAAY,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC;gBACzE,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,CAAC,IAAI,GAAG,eAAe,UAAU,CAAC,KAAK,eAAe,CAAC;gBACvF,IAAI,KAAK,KAAK,MAAM;oBAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YACvC,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,EAAE,CAAC;QAEf,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEb,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEb,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC"}

package/dist/commands/restore.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from "../base-command.js";
+export default class Restore extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        file: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "dry-run": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private printPlan;
+    /** نفس حساب ‎archive.ts‎: عدد ملفات الهجرة على القرص. */
+    private currentSchemaRevision;
+}
+//# sourceMappingURL=restore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/commands/restore.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmBjD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,WAAW;IAC9C,MAAM,CAAC,WAAW,SAA6E;IAE/F,MAAM,CAAC,QAAQ,WAGb;IAEF,MAAM,CAAC,IAAI;;MAET;IAEF,MAAM,CAAC,KAAK;;;MAGV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA0G1B,OAAO,CAAC,SAAS;IAkBjB,yDAAyD;IACzD,OAAO,CAAC,qBAAqB;CAa9B"}

package/dist/commands/restore.js

@@ -0,0 +1,148 @@
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { Args, Flags } from "@oclif/core";
+import { confirm } from "@inquirer/prompts";
+import ora from "ora";
+import { BaseCommand } from "../base-command.js";
+import { RestoreRefused, assertCompatible, clearWalSiblings, extractArchive, inspectArchive, planRestore, } from "../backup/restore.js";
+import { buildEnvelope, renderJson } from "../render/json.js";
+import { c, formatBytes, glyph, isTty } from "../render/theme.js";
+import { EXIT } from "../exit-codes.js";
+// AR: استعادة أرشيف. ثلاث بوّابات قبل أي كتابة: توافق المخطَّط، عرض ما سيُكتب فوقه، ثم تأكيد صريح.
+//     الكتابة فوق بيانات عميل ليست عملية يُستهان بها، و‎--dry-run‎ موجود ليُرى أثرها قبل وقوعها.
+// EN: Restoring an archive. Three gates before any write: schema compatibility, a listing of what
+//     would be overwritten, then an explicit confirmation. Writing over a customer's data is not a
+//     casual operation, and --dry-run exists so its effect is seen before it happens.
+export default class Restore extends BaseCommand {
+    static description = "Restore a backup archive, after showing exactly what it would overwrite";
+    static examples = [
+        "<%= config.bin %> restore backup.zip --dry-run",
+        "<%= config.bin %> restore backup.zip",
+    ];
+    static args = {
+        file: Args.string({ description: "Archive produced by fantastic backup", required: true }),
+    };
+    static flags = {
+        yes: Flags.boolean({ description: "Skip the confirmation prompt.", default: false }),
+        "dry-run": Flags.boolean({ description: "Report what would change and write nothing.", default: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Restore);
+        const profile = this.loadProfile(flags.profile, true, flags.product);
+        if (!existsSync(args.file)) {
+            this.log(c.bad(`No such archive: ${args.file}`));
+            this.exit(EXIT.FAILURE);
+        }
+        const spinner = ora({ isEnabled: isTty && !flags.json, discardStdin: false });
+        spinner.start("reading the archive…");
+        const contents = await inspectArchive(args.file).catch((error) => {
+            spinner.stop();
+            this.log(c.bad(error instanceof Error ? error.message : String(error)));
+            this.exit(EXIT.FAILURE);
+        });
+        spinner.stop();
+        if (!contents)
+            return;
+        // بوّابة ١: التوافق. **قبل** أي كتابة، فالرفض هنا مجّاني والرفض بعدها مستحيل.
+        try {
+            assertCompatible(contents.manifest, this.currentSchemaRevision(profile));
+        }
+        catch (error) {
+            if (!(error instanceof RestoreRefused))
+                throw error;
+            if (flags.json) {
+                this.log(renderJson(buildEnvelope({
+                    command: "restore",
+                    profile,
+                    data: { restored: false, manifest: contents.manifest },
+                    problems: [
+                        {
+                            id: "restore.incompatible",
+                            severity: "fail",
+                            message: error.message,
+                            remedy: "Update Fantastic to at least the version this archive was taken from, then retry.",
+                        },
+                    ],
+                })));
+                this.exit(EXIT.FAILURE);
+            }
+            this.log(c.bad(error.message));
+            this.exit(EXIT.FAILURE);
+        }
+        const plan = planRestore(profile, contents);
+        const overwrites = plan.filter((entry) => entry.overwrites);
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({
+                command: "restore",
+                profile,
+                data: {
+                    dryRun: flags["dry-run"],
+                    manifest: contents.manifest,
+                    wouldWrite: plan.length,
+                    wouldOverwrite: overwrites.length,
+                    files: plan.map((entry) => ({ to: entry.to, bytes: entry.bytes, overwrites: entry.overwrites })),
+                },
+            })));
+            if (flags["dry-run"])
+                return;
+        }
+        else {
+            this.printPlan(contents.manifest.createdAt, plan.length, overwrites);
+        }
+        if (flags["dry-run"]) {
+            if (!flags.json)
+                this.log(c.dim("dry run — nothing was written."));
+            return;
+        }
+        // بوّابة ٢: تأكيد صريح. ‎--yes‎ يتخطّاه للأتمتة، وغيابه يعني سؤالًا حقيقيًا.
+        if (!flags.yes && !flags.json) {
+            const proceed = await confirm({
+                message: `Overwrite ${overwrites.length} existing file(s) in ${profile.dataDir}?`,
+                default: false,
+            });
+            if (!proceed) {
+                this.log(c.dim("cancelled — nothing was written."));
+                return;
+            }
+        }
+        // بوّابة ٣: إزالة ملفَّي WAL المرافقَين، وإلّا خلط SQLite كتاباتٍ قديمة بقاعدة مستعادة.
+        clearWalSiblings(profile);
+        spinner.start("restoring…");
+        const written = await extractArchive(profile, args.file);
+        spinner.stop();
+        this.log("");
+        this.log(`${c.ok(glyph.pass)} Restored ${written} file(s).`);
+        this.log(c.dim("   Start the system: fantastic start   ·   then verify: fantastic doctor"));
+        this.log("");
+    }
+    printPlan(createdAt, total, overwrites) {
+        this.log("");
+        this.log(`${c.dim("archive taken:")} ${c.value(createdAt)}`);
+        this.log(`${c.dim("files to write:")} ${total}`);
+        if (overwrites.length === 0) {
+            this.log(c.ok("nothing existing would be overwritten."));
+            return;
+        }
+        this.log(c.warn(`${overwrites.length} existing file(s) would be overwritten:`));
+        for (const entry of overwrites.slice(0, 12)) {
+            this.log(`   ${c.dim("•")} ${entry.to} ${c.dim(formatBytes(entry.bytes))}`);
+        }
+        if (overwrites.length > 12)
+            this.log(c.dim(`   … and ${overwrites.length - 12} more`));
+        this.log("");
+    }
+    /** نفس حساب ‎archive.ts‎: عدد ملفات الهجرة على القرص. */
+    currentSchemaRevision(profile) {
+        const candidates = [
+            join(profile.root, "apps", "core", "dist", "db", "migrations"),
+            join(profile.root, "core", "db", "migrations"),
+        ];
+        for (const dir of candidates) {
+            if (!existsSync(dir))
+                continue;
+            return readdirSync(dir).filter((entry) => entry.endsWith(".sql")).length;
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/commands/restore.js.map

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

package/dist/commands/self-update.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from "../base-command.js";
+export default class SelfUpdate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        check: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=self-update.d.ts.map

package/dist/commands/self-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-update.d.ts","sourceRoot":"","sources":["../../src/commands/self-update.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAwBjD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,WAAW,SAAqD;IAEvE,MAAM,CAAC,QAAQ,WAA8E;IAE7F,MAAM,CAAC,KAAK;;MAEV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4E3B"}

package/dist/commands/self-update.js

@@ -0,0 +1,98 @@
+import { execa } from "execa";
+import { Flags } from "@oclif/core";
+import ora from "ora";
+import { BaseCommand } from "../base-command.js";
+import { VERSION } from "../version.js";
+import { latestPublished, PACKAGE_NAME } from "../updating/self.js";
+import { buildEnvelope, renderJson } from "../render/json.js";
+import { c, glyph, isTty } from "../render/theme.js";
+import { EXIT } from "../exit-codes.js";
+// AR: تحديث الواجهة نفسها — **وهذا هو سبب الميزة ٠٢٦ كلّها** (US4).
+//
+//     قبل الفصل كانت الواجهة تُشحن داخل الحزمة، فإصلاح سطرٍ فيها يكلّف: بناء حزمةٍ كاملة، ورفعها،
+//     وتنزيل ‎150‎ ميغابايت عند العميل، وإعادة تثبيتٍ توقف الخدمات. أي أن عطلًا في رسالةٍ يُصلَح
+//     بإعادة تركيب النظام.
+//
+//     وصار: أمرٌ واحد، ولا يتوقّف نظامٌ يعمل، ولا يتغيّر إصداره. **ولا يمسّ هذا الأمر أيّ تثبيت**
+//     — يحدّث الحزمة العالمية وحدها.
+// EN: Updating the CLI itself — **and this is the whole reason for feature 026** (US4).
+//
+//     Before the separation the CLI shipped inside the bundle, so fixing one line in it cost: a full
+//     bundle build, an upload, a 150 MB download at the customer's site, and a reinstall that stopped
+//     the services. A fault in a message was repaired by reinstalling the system.
+//
+//     Now: one command, with no running system stopped and no installed version changed. **This
+//     command touches no installation** — it updates the global package alone.
+export default class SelfUpdate extends BaseCommand {
+    static description = "Update this CLI to the newest published version";
+    static examples = ["<%= config.bin %> self-update", "<%= config.bin %> self-update --check"];
+    static flags = {
+        check: Flags.boolean({ description: "Report only; change nothing.", default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(SelfUpdate);
+        const spinner = ora({ isEnabled: isTty && !flags.json, discardStdin: false });
+        spinner.start("asking the registry…");
+        const latest = await latestPublished();
+        spinner.stop();
+        if (!latest) {
+            if (flags.json) {
+                this.log(renderJson(buildEnvelope({ command: "self-update", data: { current: VERSION, latest: null } })));
+                return;
+            }
+            this.log("");
+            this.log(c.warn("تعذّر سؤال السِّجلّ عن أحدث إصدار."));
+            this.log(c.dim("   السبب شبكيّ. الواجهة الحالية تعمل كما هي، ولا شيء تغيّر."));
+            this.log("");
+            return;
+        }
+        const behind = latest.newer;
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({ command: "self-update", data: { current: VERSION, latest: latest.version, behind } })));
+            if (flags.check || !behind)
+                return;
+        }
+        else {
+            this.log("");
+            this.log(`${c.dim("installed")} ${c.value(VERSION)}   ${c.dim("published")} ${c.value(latest.version)}`);
+            if (!behind) {
+                this.log(c.ok(` ${glyph.pass} أحدث إصدار مثبَّت.`));
+                this.log("");
+                return;
+            }
+            if (flags.check) {
+                this.log(`${c.accent(glyph.arrow)} حدّثها:  fantastic self-update`);
+                this.log("");
+                return;
+            }
+        }
+        // AR: **يُنادى مدير الحزم ولا يُعاد تنفيذ ما يفعله.** تنزيل الحزمة وفكّها وربط الأمر عمله هو،
+        //     ونسخةٌ منه هنا تعني مثبِّتًا ثانيًا ينحرف عن الأول في أول اختلاف صلاحيات أو وسيط.
+        //
+        //     و‎stdio: "inherit"‎ عن قصد: مخرجات ‎npm‎ هي ما يقرؤه الفنّي حين يفشل التثبيت لصلاحيات
+        //     ناقصة، وابتلاعها يترك «فشل» بلا سبب.
+        // EN: **The package manager is called rather than reimplemented.** Downloading, unpacking and
+        //     linking the command is its job, and a copy of that here means a second installer that
+        //     diverges from the first at the first difference in permissions or arguments.
+        //
+        //     And `stdio: "inherit"` on purpose: npm's output is what the technician reads when the
+        //     install fails for want of rights, and swallowing it leaves "failed" with no cause.
+        this.log("");
+        this.log(c.dim(`  npm i -g ${PACKAGE_NAME}@latest`));
+        this.log("");
+        try {
+            await execa("npm", ["install", "-g", `${PACKAGE_NAME}@latest`], { stdio: "inherit", shell: true });
+        }
+        catch {
+            this.log("");
+            this.log(c.bad("تعذّر تحديث الواجهة."));
+            this.log(c.dim("   جرّب طرفيةً بصلاحيات مسؤول، أو نفّذ الأمر أعلاه بيدك."));
+            this.log("");
+            this.exit(EXIT.FAILURE);
+        }
+        this.log("");
+        this.log(c.ok(` ${glyph.pass} حُدِّثت إلى ${latest.version}. افتح طرفيةً جديدة.`));
+        this.log("");
+    }
+}
+//# sourceMappingURL=self-update.js.map

package/dist/commands/self-update.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from "../base-command.js";
+export default class Setup extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "skip-deps": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /**
+     * يعرض بيانات المالك إن طبعتها النواة في هذا الإقلاع.
+     *
+     * **الصياغة هنا مقصودة.** كلمة المرور افتراضية **موثّقة وثابتة** في ‎apps/core/src/db/seed.ts‎،
+     * لا سرًّا يُولَّد مرّة. كانت عشوائية وغُيّرت عمدًا لأن جهازًا بلا إنترنت ولا استعادة كلمة مرور
+     * لا يحتمل سرًّا يُعرض مرّة واحدة. فنقول «افتراضية — غيّرها» لا «احفظها الآن ولن تراها ثانيةً».
+     */
+    private showOwnerCredentials;
+}
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAuBjD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW;IAC5C,MAAM,CAAC,WAAW,SAA6E;IAE/F,MAAM,CAAC,QAAQ,WAA4E;IAE3F,MAAM,CAAC,KAAK;;;MAGV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD1B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;CAuB7B"}

package/dist/commands/setup.js

@@ -0,0 +1,111 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { Flags } from "@oclif/core";
+import boxen from "boxen";
+import ora from "ora";
+import { BaseCommand } from "../base-command.js";
+import { runCoreScript, extractOwnerCredentials } from "../core-scripts/run.js";
+import { startServices } from "../supervisor/orchestrator.js";
+import { readTail } from "../logs/tail.js";
+import { renderBrand } from "../render/brand.js";
+import { renderUrls } from "../render/boot.render.js";
+import { c, glyph, isTty } from "../render/theme.js";
+import { EXIT } from "../exit-codes.js";
+// AR: أول تشغيل. يأخذ نظامًا غير مهيّأ إلى نظامٍ يمكن الدخول إليه، بأمر واحد ومن أي مجلد.
+//
+//     **ترتيب الخطوات ليس اعتباطيًا.** الهجرات **قبل** إقلاع أي خدمة، وهذا يعالج عطلًا مسجَّلًا في
+//     ‎specs/009-cli-orchestrator/tasks.md‎ (الاكتشاف الأخير): ترتيب الإقلاع هو live ← core، والنواة
+//     هي من تُنشئ ‎fantastic.db‎، فعلى أول تشغيل تجد خدمةُ البث الفهرسَ غائبًا وتُحذّر. تشغيل
+//     الهجرات أولًا يُنشئ الملف فلا تظهر تلك الحالة أصلًا.
+// EN: First run. Takes an unprepared system to one that can be logged into, in one command from any
+//     directory.
+//
+//     **The order is not arbitrary.** Migrations run **before** any service starts, which fixes a
+//     defect recorded in specs/009-cli-orchestrator/tasks.md: boot order is live → core and the core
+//     is what creates fantastic.db, so on a first-ever run the live service finds the index missing
+//     and warns. Migrating first creates the file, so that state never arises.
+export default class Setup extends BaseCommand {
+    static description = "Prepare an unconfigured system: dependencies, migrations, then start it";
+    static examples = ["<%= config.bin %> setup", "<%= config.bin %> setup --yes --skip-deps"];
+    static flags = {
+        yes: Flags.boolean({ description: "Do not ask for confirmation.", default: false }),
+        "skip-deps": Flags.boolean({ description: "Skip the dependency install step.", default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(Setup);
+        const profile = this.loadProfile(flags.profile, true, flags.product);
+        const brand = renderBrand({ profile: profile.kind, root: profile.root });
+        if (brand)
+            this.log(brand);
+        const spinner = ora({ isEnabled: isTty, discardStdin: false });
+        // ١ — الاعتماديات. في الجهاز المركّب هي داخل الحزمة أصلًا فلا خطوة هنا.
+        if (!flags["skip-deps"] && profile.kind === "dev") {
+            const installed = existsSync(join(profile.root, "node_modules"));
+            if (!installed) {
+                this.log(c.bad("Dependencies are not installed."));
+                this.log(`   ${c.accent(glyph.arrow)} Run "npm install" at ${profile.root}, then run setup again.`);
+                this.exit(EXIT.FAILURE);
+            }
+            this.log(` ${c.ok(glyph.pass)} Dependencies present`);
+        }
+        // ٢ — الهجرات، قبل أي خدمة.
+        spinner.start("applying migrations…");
+        const migrated = await runCoreScript(profile, "db:migrate");
+        spinner.stop();
+        if (!migrated.ok) {
+            this.log(` ${c.bad(glyph.fail)} Migrations failed`);
+            this.log(migrated.output.split("\n").slice(-15).join("\n"));
+            this.exit(EXIT.FAILURE);
+        }
+        this.log(` ${c.ok(glyph.pass)} Migrations applied`);
+        // ٣ — الإقلاع. النواة هي من تزرع حساب المالك عند أول إقلاع، فالبذر يحدث هنا لا في خطوة مستقلّة.
+        spinner.start("starting services…");
+        const outcome = await startServices(profile, {
+            onStep: (definition, phase) => {
+                if (phase === "starting")
+                    spinner.text = `starting ${definition.label}…`;
+                if (phase === "waiting")
+                    spinner.text = `waiting for ${definition.label}…`;
+            },
+        });
+        spinner.stop();
+        if (!outcome.ok) {
+            this.log(` ${c.bad(glyph.fail)} The system did not start. Run: fantastic doctor`);
+            this.exit(EXIT.FAILURE);
+        }
+        this.log(` ${c.ok(glyph.pass)} Services started`);
+        this.showOwnerCredentials(profile.logDir);
+        this.log(renderUrls(profile));
+        this.log("");
+        this.log(c.dim("check anything: fantastic doctor   ·   live view: fantastic health"));
+        this.log("");
+    }
+    /**
+     * يعرض بيانات المالك إن طبعتها النواة في هذا الإقلاع.
+     *
+     * **الصياغة هنا مقصودة.** كلمة المرور افتراضية **موثّقة وثابتة** في ‎apps/core/src/db/seed.ts‎،
+     * لا سرًّا يُولَّد مرّة. كانت عشوائية وغُيّرت عمدًا لأن جهازًا بلا إنترنت ولا استعادة كلمة مرور
+     * لا يحتمل سرًّا يُعرض مرّة واحدة. فنقول «افتراضية — غيّرها» لا «احفظها الآن ولن تراها ثانيةً».
+     */
+    showOwnerCredentials(logDir) {
+        const recent = readTail(logDir, "core", 200).join("\n");
+        const credentials = extractOwnerCredentials(recent);
+        if (!credentials) {
+            this.log("");
+            this.log(c.dim("   An owner account already exists; no new credentials were created."));
+            this.log(c.dim("   Forgotten the password? Run: fantastic owner reset"));
+            return;
+        }
+        const body = [
+            c.label("OWNER ACCOUNT — DEFAULT CREDENTIALS, CHANGE THEM"),
+            "",
+            `  user      ${c.value(credentials.username)}`,
+            `  password  ${c.accent(credentials.password)}`,
+            "",
+            c.dim("  Change it from the admin panel. Lost it? fantastic owner reset"),
+        ].join("\n");
+        this.log("");
+        this.log(boxen(body, { padding: 1, borderStyle: "double", borderColor: "yellow" }));
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/shell.d.ts

@@ -0,0 +1,118 @@
+import { BaseCommand } from "../base-command.js";
+export default class Shell extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static help: string;
+    static flags: {};
+    run(): Promise<void>;
+    private loop;
+    /** عدد أسطر اللوحة المرسومة الآن، لتُمحى قبل رسم غيرها. */
+    private panelRows;
+    /** ما تعرضه اللوحة الآن. مصفوفة فارغة تعني: لا لوحة، فالأسهم للتاريخ. */
+    private matches;
+    /** المُظلَّل، أو ‎-1‎ حين لم يتنقّل المستخدم بعد — وعندها ‎Enter‎ يُرسل ما كُتب لا ما هو معروض. */
+    private selected;
+    private keypressHandler?;
+    /**
+     * AR: يجعل الصَدَفة **المُستمِع الوحيد** للمفاتيح، وتمرّر هي ما يخصّ ‎readline‎ إليه.
+     *
+     *     الترتيب هو كل شيء: ‎readline‎ يسجّل مُستمِعه عند إنشاء الواجهة، وكل مُستمِع يُضاف بعده يعمل
+     *     **بعده** — فلا يستطيع منعه من التصرّف. ولهذا كان سهم واحد يحرّك التظليل ويستبدل السطر بأمرٍ
+     *     من التاريخ معًا. نأخذ مُستمِعيه ونحتفظ بهم، ونصير نحن الوحيدين، فنقرّر: ما يخصّ اللوحة يُبتلَع،
+     *     وما عداه يُمرَّر كما هو فلا يفقد ‎readline‎ حرفًا ولا مفتاح تحرير.
+     *
+     *     وإن لم نجد مُستمِعًا لنمسكه — تغيّرت بنية ‎readline‎ يومًا — **نتراجع إلى السلوك القديم** بلا
+     *     تنقّل بدل أن نكسر المُدخَل كلّه: صَدَفةٌ بلا أسهم تعمل، وصَدَفةٌ لا تستقبل حرفًا لا تعمل.
+     * EN: Makes the shell the **only** keypress listener, forwarding to readline what belongs to it.
+     *
+     *     Order is everything: readline registers its listener when the interface is created, and every
+     *     listener added afterwards runs **after** it — and so cannot stop it acting. That is why one
+     *     arrow both moved the highlight and replaced the line with a history entry. We take its
+     *     listeners and keep them, become the only ones, and decide: what belongs to the panel is
+     *     swallowed, everything else is forwarded untouched, so readline loses no character and no
+     *     editing key.
+     *
+     *     And if there is no listener to capture — readline's internals changed one day — we **fall
+     *     back to the old behaviour** without navigation rather than break input entirely: a shell
+     *     without arrows works, a shell that receives no characters does not.
+     */
+    private installKeyInterceptor;
+    /** انظر ‎shell/input-mode.ts‎: القاعدة كلها هناك ومعها سببها المقيس. */
+    private restoreInput;
+    /** يمنع فتح قائمتين حين تصل ضغطة أثناء فتح الأولى. */
+    private menuOpen;
+    private hintsCache;
+    /**
+     * وصف كل أمر بسطر. يُبنى مرّة: شجرة الأوامر لا تتغيّر داخل الجلسة، وإعادة بنائها مع كل ضغطة مفتاح
+     * تعني عملًا في المسار الذي يجب أن يبقى فوريًّا.
+     */
+    private hints;
+    /**
+     * AR: هل تخصّ هذه الضغطة اللوحة وحدها؟ **‎true‎ تعني: لا تُمرَّر إلى ‎readline‎.**
+     *
+     *     هنا كانت المشكلة كلها. مُستمِع ‎readline‎ يُسجَّل قبل مُستمِعنا، فسهمٌ واحد كان يحرّك الاختيار
+     *     **ويستبدل السطر بأمرٍ قديم من التاريخ** في آن. ولذلك صرنا المُستمِع الوحيد المُسجَّل
+     *     (‎installKeyInterceptor‎)، ونمرّر نحن ما يخصّه — فيصير للأسهم معنى واحد لا يتنازعه اثنان:
+     *     تنقّلٌ ما دامت اللوحة مفتوحة، وتاريخٌ حين تكون مغلقة.
+     * EN: Does this key belong to the panel alone? **`true` means: do not forward it to readline.**
+     *
+     *     This was the whole problem. Readline's listener is registered before ours, so a single arrow
+     *     moved the highlight **and replaced the line with a history entry** at the same time. Hence we
+     *     became the only registered listener (`installKeyInterceptor`) and forward what belongs to it —
+     *     giving the arrows one meaning nobody contests: navigation while the panel is open, history
+     *     when it is closed.
+     */
+    private interceptPanelKey;
+    private onKeypress;
+    /**
+     * يرسم الاقتراحات أسفل سطر الكتابة ثم يعيد المؤشّر إلى موضعه فيه.
+     *
+     * تُعرَض للكلمة الأولى وحدها: بعد أوّل مسافة صار المكتوب وسائط وأعلامًا، ولا نملك قائمة قيم لها —
+     * واقتراحُ أسماء أوامر بعد ‎status ‎ إزعاجٌ لا مساعدة.
+     */
+    private drawPanel;
+    /** يمحو اللوحة ويُسقط التظليل، ويعيد المؤشّر إلى سطر الكتابة. */
+    private clearPanel;
+    /**
+     * القائمة الكاملة: يُكتَب ‎/‎ على سطر فارغ فتُفتح قائمة تُرشَّح بالكتابة وتُتنقّل بالأسهم — نفس فكرة
+     * ‎claude code‎.
+     *
+     * **ولماذا قائمة منفصلة لا أسهم على اللوحة أعلاه**: الأسهم في ‎readline‎ محجوزة للتاريخ، ومُستمِعنا
+     * يعمل **بعد** مُستمِعها فلا يستطيع ابتلاع الضغطة — أي أن سهمًا واحدًا كان سيحرّك الاختيار ويستبدل
+     * السطر بأمرٍ قديم في آن. الفصل يعطي كلَّ مفتاح معنًى واحدًا لا يتنازعه اثنان.
+     *
+     * والمختار **يُملأ في السطر ولا يُنفَّذ**: أوامر مثل ‎live test <source>‎ تلزمها وسائط، وتشغيلها
+     * فور الاختيار كان يردّ خطأ استخدام على اختيار سليم. تملأ السطر فيُكمِل المستخدم أو يضغط ‎Enter‎.
+     */
+    private openMenu;
+    /** يعيد ‎true‎ حين يطلب السطر إنهاء الجلسة. */
+    private handleLine;
+    /**
+     * ينفّذ أمر oclif داخل هذه العملية.
+     *
+     * ‎rl.pause()‎ حول التنفيذ ضرورة لا تحسين: أوامر مثل ‎setup‎ و‎owner‎ تفتح مِحَثّاتها الخاصة على
+     * ‎stdin‎، ومِحَثّان يقرآن نفس المُدخَل يبتلع أحدهما ضغطات الآخر فتضيع الإجابة أو تُقرأ مرّتين.
+     */
+    private runCommand;
+    /**
+     * يحوّل ما كُتب إلى معرّف أمر عند oclif.
+     *
+     * **أمر الموضوع كلمتان عند المستخدم ومعرّف واحد عند oclif**: ‎stream queue‎ هو ‎stream:queue‎، وتمريرُ
+     * الكلمة الأولى وحدها كان يبحث عن أمر اسمه ‎stream‎ — وهو موضوع لا أمر — فيردّ «غير موجود» على أمر
+     * موجود. يُجرَّب الأطول أوّلًا فلا يحجب موضوعٌ أمرًا يشاركه اسمه.
+     */
+    private resolveCommandId;
+    /**
+     * يعرض فشل أمر **ولا يُخرِج**. رمز الخروج يُذكر حين لا يكون صفرًا لأنه معلومة يعرفها المستخدم من
+     * السطر العادي، وإخفاؤه هنا يجعل السلوكين مختلفين بلا سبب.
+     *
+     * **و‎ExitError‎ ليست خطأً برسالة.** أمرٌ خرج برمز غير صفري عن قصد — ‎status‎ حين تكون كل الخدمات
+     * متوقّفة مثلًا — يرميها من داخل ‎runCommand‎ ورسالتها نصّ ‎oclif‎ الداخلي «‎EEXIT: 1‎». طباعتها
+     * تضع سطرًا أحمر بلا معنى تحت جدول اكتمل بنجاح. الرمز وحده هو المعلومة هنا؛ الأمر قال قوله سلفًا.
+     */
+    private reportFailure;
+    private hintLine;
+    /** إكمال بالمفتاح ‎Tab‎ على الكلمة الأولى وحدها: ما بعدها وسائط لا نعرف قيمها. */
+    private complete;
+}
+//# sourceMappingURL=shell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/commands/shell.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAkB,MAAM,oBAAoB,CAAC;AAgEjE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW;IAC5C,MAAM,CAAC,WAAW,SAA6F;IAE/G,MAAM,CAAC,QAAQ,WAAoD;IAEnE,MAAM,CAAC,IAAI,SAAkB;IAE7B,MAAM,CAAC,KAAK,KAAM;IAEZ,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YA+BZ,IAAI;IAuClB,2DAA2D;IAC3D,OAAO,CAAC,SAAS,CAAK;IAEtB,yEAAyE;IACzE,OAAO,CAAC,OAAO,CAAqB;IAEpC,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAM;IAEtB,OAAO,CAAC,eAAe,CAAC,CAAyC;IAEjE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,qBAAqB;IAkB7B,wEAAwE;IACxE,OAAO,CAAC,YAAY;IAKpB,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,UAAU,CAA8B;IAEhD;;;OAGG;IACH,OAAO,CAAC,KAAK;IAab;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,UAAU;IAmBlB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAwCjB,iEAAiE;IACjE,OAAO,CAAC,UAAU;IAclB;;;;;;;;;;OAUG;YACW,QAAQ;IAiCtB,+CAA+C;YACjC,UAAU;IAiCxB;;;;;OAKG;YACW,UAAU;IAaxB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,QAAQ;IAOhB,kFAAkF;IAClF,OAAO,CAAC,QAAQ;CAYjB"}