@wasmsoft/fantastic 1.0.0

package/dist/base-command.js

@@ -0,0 +1,120 @@
+import { Command, Flags } from "@oclif/core";
+import { ProfileResolutionError, resolveProfile } from "./profiles/resolve.js";
+import { buildEnvelope, renderJson } from "./render/json.js";
+import { c, glyph } from "./render/theme.js";
+import { EXIT } from "./exit-codes.js";
+import { checkRuntime } from "./runtime-guard.js";
+// AR: أساس مشترك لكل الأوامر. يحمل ‎--profile‎ و‎--json‎ ويحوّل فشل الاستنتاج إلى رسالة واحدة،
+//     فلا يكرّر كل أمر نفس الأسطر ولا يطبع أثر استدعاء خامًا في وجه المستخدم.
+// EN: A shared base for every command. It carries --profile and --json and turns a resolution
+//     failure into one message, so no command repeats the same lines and no raw stack trace ever
+//     lands in the user's face.
+/**
+ * AR: عقد رموز الخروج، معروضًا في مساعدة كل أمر (017/FR-032، T075). ليس تفصيلًا داخليًا: سكربت
+ *     بوّابة يفرّق به بين «المنفذ محجوز» و«التشخيص وجد عائقًا» دون أن يحلّل نصًّا إنجليزيًا.
+ * EN: The exit-code contract, shown in every command's help (017/FR-032, T075). Not an internal
+ *     detail: a gate script uses it to tell "the port was busy" from "diagnosis found a blocker"
+ *     without parsing English prose.
+ */
+export const EXIT_CODE_HELP = `EXIT CODES
+  ${EXIT.OK}  success
+  ${EXIT.FAILURE}  general failure
+  ${EXIT.USAGE}  usage error — unknown flag or missing argument
+  ${EXIT.PORT_CONFLICT}  port conflict — something else holds a required port
+  ${EXIT.UNREACHABLE}  service unreachable — alive as a process, not ready as a service
+  ${EXIT.NO_PROFILE}  no profile resolved — no repository here and no installed appliance
+  ${EXIT.DIAGNOSTIC_BLOCKED}  doctor found blocking problems`;
+export class BaseCommand extends Command {
+    static baseFlags = {
+        profile: Flags.string({
+            description: "Run profile: dev or appliance. Auto-detected when omitted.",
+            options: ["dev", "appliance"],
+        }),
+        json: Flags.boolean({
+            description: "Emit machine-readable output instead of a rendered table.",
+            default: false,
+        }),
+        /**
+         * AR: أيّ منتجٍ يقصد هذا الأمر؟ (٠٢٦)
+         *
+         *     **يُستنتَج عند الوحدة ويُطلَب عند التعدّد.** أمرُ إيقافٍ يصيب الجهاز الخطأ في استراحةٍ
+         *     تعمل أسوأ من أمرٍ يسأل — ولذلك لا تخمين هنا، والرفض يعدّد الأسماء بدل أن يقول «حدّد».
+         *
+         *     وموضعه في الأساس لا في كل أمر: سطرٌ يُكرَّر في ستّةٍ وثلاثين ملفًّا يُنسى في السابع
+         *     والثلاثين، فيصير أمرٌ واحدٌ لا يقبل العَلَم بلا أن يلاحظ أحد.
+         * EN: Which product does this command act on? (026)
+         *
+         *     **Inferred when there is one, required when there are several.** A stop command hitting
+         *     the wrong appliance in a working rest-house is worse than a command that asks — so nothing
+         *     is guessed here, and the refusal lists the names rather than saying "specify one".
+         *
+         *     It belongs in the base rather than in every command: a line repeated across thirty-six
+         *     files is forgotten in the thirty-seventh, leaving one command that ignores the flag with
+         *     nobody noticing.
+         */
+        product: Flags.string({
+            description: "Which installed product to act on. Inferred when only one is installed.",
+        }),
+    };
+    /**
+     * AR: يُنفَّذ قبل جسم أيّ أمر (‎oclif‎ يناديها لكل أمر). وهو الموضع الوحيد الذي يضمن أن **كل**
+     *     أمرٍ يمرّ بفحص بيئة التشغيل، بلا سطرٍ مكرَّرٍ في ستّةٍ وثلاثين ملفًّا يُنسى في السابع
+     *     والثلاثين.
+     * EN: Runs before any command's body (oclif calls it for every command). It is the one place that
+     *     guarantees **every** command passes the runtime check, with no line repeated across
+     *     thirty-six files and forgotten in the thirty-seventh.
+     */
+    async init() {
+        await super.init();
+        const verdict = checkRuntime();
+        if (verdict.ok)
+            return;
+        this.log("");
+        this.log(c.bad(verdict.message));
+        this.log(`${c.accent(glyph.arrow)} ${verdict.remedy}`);
+        this.log("");
+        this.exit(EXIT.FAILURE);
+    }
+    loadProfile(kind, ensureDirs = true, product) {
+        try {
+            return resolveProfile({ kind: kind, ensureDirs, product });
+        }
+        catch (error) {
+            // كان هذا يخرج بالرمز 2 «خطأ استخدام»، وهو تصنيف خاطئ: المستخدم لم يخطئ في كتابة الأمر، بل
+            // لا يوجد نظام في هذا المكان. الرمز 5 يقول ذلك تحديدًا فيميّزه سكربت البوّابة (017/FR-032).
+            if (error instanceof ProfileResolutionError)
+                this.error(error.message, { exit: EXIT.NO_PROFILE });
+            throw error;
+        }
+    }
+    /**
+     * جواب موحّد حين لا تُجيب النواة (017/FR-015).
+     *
+     * كل أمر إدارة يمرّ بهذه الحالة، وتكرار صياغتها في اثني عشر ملفًا يُنتج اثنتي عشرة صياغة تختلف
+     * قليلًا وتتباعد مع الوقت. **ولا يتراجع أي أمر إلى قراءة البيانات بنفسه**: هذا هو الحدّ الذي
+     * يفصل «الـ CLI يعرض» عن «الـ CLI يقرّر».
+     */
+    coreUnreachable(command, profile, reason, json) {
+        if (json) {
+            this.log(renderJson(buildEnvelope({
+                command,
+                profile,
+                data: null,
+                problems: [
+                    {
+                        id: "core.unreachable",
+                        severity: "fail",
+                        message: `the core is not reachable: ${reason}`,
+                        remedy: "Start it: fantastic start",
+                    },
+                ],
+            })));
+        }
+        else {
+            this.log(c.bad(`The core is not reachable — ${reason}`));
+            this.log(`${c.accent(glyph.arrow)} Start it: fantastic start`);
+        }
+        this.exit(EXIT.UNREACHABLE);
+    }
+}
+//# sourceMappingURL=base-command.js.map

package/dist/base-command.js.map

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

package/dist/bundle-format/index.d.ts

@@ -0,0 +1,6 @@
+export { BUNDLE_DIRS, MANIFEST_FILE, RUNTIME_FILES, SERVICE_ENTRY, SUPERVISOR_ENTRY, SHIM_FILES, REQUIRED_NATIVE, WORKSPACE_PACKAGES, EXCLUDED_FROM_BUNDLE, } from "../packaging/layout.js";
+export { hashDirectory, hashFile, writeManifest, readManifest, treeBytes, type ManifestInput, } from "../packaging/manifest.js";
+export { writeCommandShim } from "../packaging/shims.js";
+export { SUPERVISOR_DEPENDENCIES } from "../supervisor/dependencies.js";
+export type { BundleManifest, BundleComponent, BundleComponentName, BundlePlatform, BundleRuntimeComponent, } from "../contracts/core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/bundle-format/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bundle-format/index.ts"],"names":[],"mappings":"AAgCA,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,SAAS,EACT,KAAK,aAAa,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,YAAY,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/bundle-format/index.js

@@ -0,0 +1,36 @@
+// AR: **عقد شكل الحزمة — المسار الفرعيّ الذي يستهلكه مستودع المنتج.**
+//
+//     الحزمة تُبنى في مستودعٍ وتُقرأ في آخر: أدوات الإصدار تكتب الشجرة والبيان، وهذه الواجهة
+//     تقرؤهما على جهاز العميل. وحرفٌ واحد يفترق بين الطرفين يعني تثبيتًا يفشل عند عميل — لا
+//     بناءً يفشل على شاشة مطوّر.
+//
+//     ولذلك **القارئ صاحب العقد**: التعريف يعيش هنا، ويستورده الباني من الحزمة المنشورة
+//     (‎@wasmsoft/fantastic/bundle-format‎). اتجاهٌ واحد لا دائريّ، وبلا حزمةٍ ثالثة تُنشَر لأجل
+//     ثمانين سطرًا من الثوابت. والسبب مبدئيّ لا تنظيميّ: الحزمة تُبنى مرّةً وتُقرأ على أجهزةٍ كثيرة
+//     لسنواتٍ بعد بنائها؛ والباني يستطيع دائمًا أن يوافق قارئًا، أمّا القارئ فلا يستطيع أن يوافق
+//     بانيًا مضى.
+//
+//     **وهذا الملفّ لا يستورد oclif ولا Ink ولا ‎chalk‎.** من يستورده أداةُ بناءٍ لا واجهةُ مستخدم،
+//     وجرّ شجرة اعتمادياتٍ كاملة إلى سكربت إصدارٍ يجعل بناء الحزمة يعتمد على مكتبة ألوان.
+// EN: **The bundle-format contract — the subpath the product repository consumes.**
+//
+//     A bundle is built in one repository and read in another: the release tooling writes the tree
+//     and the manifest, and this CLI reads them on a customer's machine. One character of drift
+//     between the two means an install that fails at a customer's site — not a build that fails on
+//     a developer's screen.
+//
+//     Hence **the reader owns the contract**: the definition lives here and the builder imports it
+//     from the published package (`@wasmsoft/fantastic/bundle-format`). One direction, not a cycle,
+//     and no third package published for eighty lines of constants. The reason is principled rather
+//     than organisational: a bundle is built once and read on many machines for years afterwards; a
+//     builder can always be made to match a reader, but a reader cannot be made to match a builder
+//     that has already shipped.
+//
+//     **And this file imports neither oclif nor Ink nor chalk.** Its consumer is a build script, not
+//     a user interface, and dragging a whole dependency tree into a release script makes building a
+//     bundle depend on a colour library.
+export { BUNDLE_DIRS, MANIFEST_FILE, RUNTIME_FILES, SERVICE_ENTRY, SUPERVISOR_ENTRY, SHIM_FILES, REQUIRED_NATIVE, WORKSPACE_PACKAGES, EXCLUDED_FROM_BUNDLE, } from "../packaging/layout.js";
+export { hashDirectory, hashFile, writeManifest, readManifest, treeBytes, } from "../packaging/manifest.js";
+export { writeCommandShim } from "../packaging/shims.js";
+export { SUPERVISOR_DEPENDENCIES } from "../supervisor/dependencies.js";
+//# sourceMappingURL=index.js.map

package/dist/bundle-format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bundle-format/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,6FAA6F;AAC7F,4FAA4F;AAC5F,iCAAiC;AACjC,EAAE;AACF,wFAAwF;AACxF,iGAAiG;AACjG,oGAAoG;AACpG,iGAAiG;AACjG,kBAAkB;AAClB,EAAE;AACF,oGAAoG;AACpG,0FAA0F;AAC1F,oFAAoF;AACpF,EAAE;AACF,mGAAmG;AACnG,gGAAgG;AAChG,mGAAmG;AACnG,4BAA4B;AAC5B,EAAE;AACF,mGAAmG;AACnG,oGAAoG;AACpG,oGAAoG;AACpG,oGAAoG;AACpG,mGAAmG;AACnG,gCAAgC;AAChC,EAAE;AACF,qGAAqG;AACrG,oGAAoG;AACpG,yCAAyC;AAEzC,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,SAAS,GAEV,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/commands/activate.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from "../base-command.js";
+export default class Activate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        code: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {};
+    static help: string;
+    run(): Promise<void>;
+    /** يرسم الخطوات حتى نقطة السقوط، ثم رسالة النواة العربية كما هي. */
+    private renderFailure;
+    private emitJson;
+}
+//# sourceMappingURL=activate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activate.d.ts","sourceRoot":"","sources":["../../src/commands/activate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAkB,MAAM,oBAAoB,CAAC;AAoDjE,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAC,WAAW,SAAgE;IAElF,MAAM,CAAC,QAAQ,WAGb;IAEF,MAAM,CAAC,IAAI;;MAET;IAEF,MAAM,CAAC,KAAK,KAAM;IAElB,MAAM,CAAC,IAAI,SAAkB;IAEvB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC1B,oEAAoE;IACpE,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,QAAQ;CAkCjB"}

package/dist/commands/activate.js

@@ -0,0 +1,139 @@
+import { Args } from "@oclif/core";
+import { BaseCommand, EXIT_CODE_HELP } from "../base-command.js";
+import { activateLicense } from "../probes/internal.client.js";
+import { renderLicenceCard } from "../render/licence.render.js";
+import { buildEnvelope, renderJson } from "../render/json.js";
+import { c, glyph } from "../render/theme.js";
+import { EXIT } from "../exit-codes.js";
+// AR: ‎fantastic activate <code>‎ — تفعيل هذا الجهاز من الطرفية.
+//
+//     **الأمر لا ينادي البوّابة المركزية، بل ينادي النواة.** القاعدة مكتوبة كاملةً في تعليق
+//     ‎internal.controller.ts‎: الـ CLI يعرض والنواة تقرّر. لو نادى المركز بنفسه لصار في المشروع
+//     مسارا تفعيل — أحدهما يقرأ البصمة ويتحقّق من التوقيع ويكتب الملف ذرّيًّا، والآخر يفعل شبيهًا
+//     بذلك — ويفترقان أوّل يوم يتغيّر فيه شيء. والـ CLI فوق ذلك لا يحمل أسرارًا ولا يعرف المفتاح
+//     العام الذي يُتحقَّق به.
+//
+// EN: `fantastic activate <code>` — activating this appliance from the terminal.
+//
+//     **The command does not call the central portal; it calls the core.** The rule is written out
+//     in full in the `internal.controller.ts` comment: the CLI displays, the core decides. Were it
+//     to call the centre itself, the project would hold two activation paths — one reading the
+//     fingerprint, verifying the signature and writing the file atomically, another doing something
+//     similar — and they would diverge the first day anything changed. The CLI also holds no
+//     secrets and does not know the public key that verification needs.
+/**
+ * AR: الخطوات كما تُعرَض. **ليست مؤقّتًا تجميليًّا**: النواة تنفّذها في هذا الترتيب فعلًا، فحين
+ *     يتوقّف السطر عند خطوة تكون الخطوة نفسها هي اسمُ العطل — وهذا ما يفرّق بين شاشةٍ تشرح
+ *     وشاشةٍ تُسلّي.
+ * EN: The steps as shown. **Not a decorative timer**: the core really performs them in this order,
+ *     so when the line stops at a step, that step is the name of the fault — which is the
+ *     difference between a screen that explains and a screen that entertains.
+ */
+const STEPS = [
+    { label: "Reading device fingerprint", width: 4 },
+    { label: "Contacting licence server", width: 5 },
+    { label: "Verifying signature", width: 11 },
+    { label: "Writing licence", width: 15 },
+];
+/**
+ * AR: أيّ خطوة سقط عندها هذا الرمز؟ الرفض من المركز يسقط عند «الاتصال بخادم الرخص» — الاتصال
+ *     نجح والمركز أجاب برفض، فما بعده لم يُنفَّذ أصلًا ولا يجوز أن يُرسَم ناجحًا.
+ * EN: Which step did this code fall at? A refusal from the centre falls at "contacting licence
+ *     server" — the connection worked and the centre answered no, so nothing after it ran and
+ *     nothing after it may be drawn as passed.
+ */
+function failedStepFor(code) {
+    if (code === "FINGERPRINT_UNAVAILABLE")
+        return 0;
+    if (code === "INVALID_SIGNATURE")
+        return 2;
+    return 1;
+}
+export default class Activate extends BaseCommand {
+    static description = "Activate this appliance with a licence code from Fantastic";
+    static examples = [
+        "<%= config.bin %> activate FN-2026-K7M4P",
+        "<%= config.bin %> activate FN-2026-K7M4P --json",
+    ];
+    static args = {
+        code: Args.string({ description: "Activation code, e.g. FN-2026-K7M4P", required: true }),
+    };
+    static flags = {};
+    static help = EXIT_CODE_HELP;
+    async run() {
+        const { args, flags } = await this.parse(Activate);
+        const profile = this.loadProfile(flags.profile, false, flags.product);
+        const result = await activateLicense(profile, args.code);
+        if (flags.json) {
+            this.emitJson(profile, result);
+            return;
+        }
+        if (!result.ok) {
+            // النواة متوقّفة: الرسالة الموحّدة القائمة سلفًا، بلا صياغة جديدة تتباعد عن أخواتها.
+            if (result.unreachable)
+                this.coreUnreachable("activate", profile, result.reason, false);
+            this.renderFailure(result.error?.code, result.reason);
+            // AR: رمزان مختلفان لسببين مختلفين، وسكربتات التثبيت تفرّق بهما: انقطاعُ الشبكة يستحقّ
+            //     إعادةَ محاولة آليّة، وكودٌ خاطئ لا يستحقّها مهما أُعيد.
+            // EN: Two codes for two reasons, and installer scripts branch on them: a network drop
+            //     deserves an automatic retry, a wrong code never will however often it is repeated.
+            this.exit(result.error?.code === "CENTRAL_UNREACHABLE" ? EXIT.UNREACHABLE : EXIT.FAILURE);
+        }
+        for (const step of STEPS) {
+            this.log(` ${c.accent(glyph.step)} ${step.label} ${c.dim(".".repeat(step.width))} ${c.ok("ok")}`);
+        }
+        this.log("");
+        this.log(renderLicenceCard(result.data.device, { heading: true }));
+        this.log("");
+        this.log(`${c.accent(glyph.arrow)} Restart to enter Full Mode: ${c.value("fantastic restart")}`);
+        this.log("");
+    }
+    /** يرسم الخطوات حتى نقطة السقوط، ثم رسالة النواة العربية كما هي. */
+    renderFailure(code, message) {
+        const failedAt = failedStepFor(code);
+        this.log("");
+        STEPS.forEach((step, index) => {
+            if (index < failedAt) {
+                this.log(` ${c.accent(glyph.step)} ${step.label} ${c.dim(".".repeat(step.width))} ${c.ok("ok")}`);
+            }
+            else if (index === failedAt) {
+                this.log(` ${c.accent(glyph.step)} ${step.label} ${c.dim(".".repeat(step.width))} ${c.bad("failed")}`);
+            }
+            // ما بعد نقطة السقوط لا يُرسَم إطلاقًا: لم يُنفَّذ، ورسمُه رماديًّا يوحي بأنه ينتظر دوره.
+        });
+        this.log("");
+        this.log(`${c.bad(glyph.fail)} ${message}`);
+        if (code === "CENTRAL_UNREACHABLE") {
+            this.log(`${c.accent(glyph.arrow)} ${c.dim("Check the internet connection, then run the command again.")}`);
+        }
+        this.log("");
+    }
+    emitJson(profile, result) {
+        const device = result.ok ? result.data.device : null;
+        this.log(renderJson(buildEnvelope({
+            command: "activate",
+            profile,
+            data: device ? { device, restartRequired: true } : null,
+            problems: result.ok
+                ? []
+                : [
+                    {
+                        id: result.unreachable ? "core.unreachable" : `licence.${result.error?.code ?? "failed"}`,
+                        severity: "fail",
+                        message: result.reason,
+                        remedy: result.unreachable
+                            ? "Start it: fantastic start"
+                            : result.error?.code === "CENTRAL_UNREACHABLE"
+                                ? "Check the internet connection, then run the command again."
+                                : "Check the activation code, or contact Fantastic support.",
+                    },
+                ],
+        })));
+        if (result.ok)
+            return;
+        if (result.unreachable)
+            this.exit(EXIT.UNREACHABLE);
+        this.exit(result.error?.code === "CENTRAL_UNREACHABLE" ? EXIT.UNREACHABLE : EXIT.FAILURE);
+    }
+}
+//# sourceMappingURL=activate.js.map

package/dist/commands/activate.js.map

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

package/dist/commands/backup.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYjD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,MAAM,CAAC,WAAW,SAA+E;IAEjG,MAAM,CAAC,QAAQ,WAA8E;IAE7F,MAAM,CAAC,KAAK;;;MAGV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiE3B"}

package/dist/commands/backup.js

@@ -0,0 +1,75 @@
+import { join } from "node:path";
+import { Flags } from "@oclif/core";
+import ora from "ora";
+import { BaseCommand } from "../base-command.js";
+import { createBackup } from "../backup/archive.js";
+import { buildEnvelope, renderJson } from "../render/json.js";
+import { c, formatBytes, glyph, isTty } from "../render/theme.js";
+import { EXIT } from "../exit-codes.js";
+// AR: أرشيف واحد مؤرَّخ لحالة الجهاز. يعمل **والنظام يعمل**، لأن اللقطة تأتي من ‎VACUUM INTO‎ لا من
+//     نسخ ملف حيّ — وهذا هو الفرق بين نسخة تُستعاد ونسخة تبدو سليمة وتفشل يوم الحاجة.
+// EN: One dated archive of the appliance's state. It works **while the system is running**, because
+//     the snapshot comes from VACUUM INTO rather than a live file copy — the difference between a
+//     backup that restores and one that looks fine and fails on the day it is needed.
+export default class Backup extends BaseCommand {
+    static description = "Write one dated archive of the database, settings, theme and owner assets";
+    static examples = ["<%= config.bin %> backup", "<%= config.bin %> backup --out D:\\backups"];
+    static flags = {
+        out: Flags.string({ description: "Directory to write the archive into." }),
+        "include-logs": Flags.boolean({ description: "Include service logs in the archive.", default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(Backup);
+        const profile = this.loadProfile(flags.profile, true, flags.product);
+        const outDir = flags.out ?? join(profile.root, "backups");
+        const spinner = ora({ isEnabled: isTty && !flags.json, discardStdin: false });
+        try {
+            const result = await createBackup(profile, {
+                outDir,
+                includeLogs: flags["include-logs"],
+                onStep: (message) => {
+                    if (!flags.json)
+                        spinner.start(message);
+                },
+            });
+            spinner.stop();
+            if (flags.json) {
+                this.log(renderJson(buildEnvelope({
+                    command: "backup",
+                    profile,
+                    data: { file: result.file, bytes: result.bytes, manifest: result.manifest },
+                })));
+                return;
+            }
+            this.log("");
+            this.log(`${c.ok(glyph.pass)} ${c.value(result.file)}   ${c.dim(formatBytes(result.bytes))}`);
+            this.log(c.dim(`   schema revision ${result.manifest.schemaRevision} · media is never included`));
+            this.log("");
+            this.log(c.dim(`restore with: fantastic restore "${result.file}" --dry-run`));
+            this.log("");
+        }
+        catch (error) {
+            spinner.stop();
+            const message = error instanceof Error ? error.message : String(error);
+            if (flags.json) {
+                this.log(renderJson(buildEnvelope({
+                    command: "backup",
+                    profile,
+                    data: { written: false },
+                    problems: [
+                        {
+                            id: "backup.failed",
+                            severity: "fail",
+                            message,
+                            remedy: "Start the core so it can produce a consistent snapshot: fantastic start",
+                        },
+                    ],
+                })));
+                this.exit(EXIT.FAILURE);
+            }
+            this.log(c.bad(`Backup failed: ${message}`));
+            this.exit(EXIT.FAILURE);
+        }
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/commands/backup.js.map

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

package/dist/commands/config/get.d.ts

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

package/dist/commands/config/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/config/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,SAA0B;IAE5C,MAAM,CAAC,QAAQ,WAA6C;IAE5D,MAAM,CAAC,IAAI;;MAET;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyB3B"}

package/dist/commands/config/get.js

@@ -0,0 +1,33 @@
+import { Args } from "@oclif/core";
+import { BaseCommand } from "../../base-command.js";
+import { CONFIG_KEYS, effectiveValues, readLocalConfig } from "../../config/local-config.js";
+import { buildEnvelope, renderJson } from "../../render/json.js";
+import { NOT_REPORTED, c } from "../../render/theme.js";
+import { EXIT } from "../../exit-codes.js";
+// AR: يقرأ إعدادًا واحدًا. يطبع القيمة السارية عاريةً (بلا زخرفة) ليصلح للاستعمال في سكربت مباشرة.
+// EN: Reads one setting. Prints the effective value bare, so it can be used in a script directly.
+export default class ConfigGet extends BaseCommand {
+    static description = "Read one CLI setting";
+    static examples = ["<%= config.bin %> config get corePort"];
+    static args = {
+        key: Args.string({ description: "Setting name", required: true, options: [...CONFIG_KEYS] }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConfigGet);
+        const profile = this.loadProfile(flags.profile, false, flags.product);
+        const key = args.key;
+        const stored = readLocalConfig(profile)[key];
+        const effective = effectiveValues(profile)[key];
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({ command: "config get", profile, data: { key, stored: stored ?? null, effective: effective ?? null } })));
+            return;
+        }
+        if (effective === undefined) {
+            this.log(c.dim(NOT_REPORTED));
+            this.exit(EXIT.OK);
+        }
+        // عارية عمدًا: ‎$(fantastic config get corePort)‎ يجب أن يعطي رقمًا لا سطرًا مزخرفًا.
+        this.log(String(effective));
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/config/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/config/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAkB,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,mGAAmG;AACnG,kGAAkG;AAElG,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,GAAG,sBAAsB,CAAC;IAE5C,MAAM,CAAC,QAAQ,GAAG,CAAC,uCAAuC,CAAC,CAAC;IAE5D,MAAM,CAAC,IAAI,GAAG;QACZ,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC;KAC7F,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAgB,CAAC;QAClC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CACN,UAAU,CACR,aAAa,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE,EAAE,CAAC,CACvH,CACF,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC;QAED,sFAAsF;QACtF,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9B,CAAC"}

package/dist/commands/config/list.d.ts

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

package/dist/commands/config/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/config/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,WAAW,SAA2E;IAE7F,MAAM,CAAC,QAAQ,WAA6E;IAEtF,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqC3B"}

package/dist/commands/config/list.js

@@ -0,0 +1,43 @@
+import Table from "cli-table3";
+import { BaseCommand } from "../../base-command.js";
+import { CONFIG_KEYS, configPath, effectiveValues, readLocalConfig } from "../../config/local-config.js";
+import { buildEnvelope, renderJson } from "../../render/json.js";
+import { NOT_REPORTED, c } from "../../render/theme.js";
+// AR: يعرض **القيمة السارية** بجانب **المخزَّنة**. الفرق بينهما هو ما يبحث عنه من يسأل «لماذا لا
+//     يعمل إعدادي؟»: قيمة مخزَّنة لا تُطابق السارية تعني أن شيئًا آخر يتقدّم عليها.
+// EN: Shows the **effective** value beside the **stored** one. The gap between them is exactly what
+//     someone asking "why isn't my setting taking effect?" is looking for: a stored value that does
+//     not match the effective one means something else outranks it.
+export default class ConfigList extends BaseCommand {
+    static description = "Show every CLI setting: what is stored and what is actually in effect";
+    static examples = ["<%= config.bin %> config list", "<%= config.bin %> config list --json"];
+    async run() {
+        const { flags } = await this.parse(ConfigList);
+        const profile = this.loadProfile(flags.profile, false, flags.product);
+        const stored = readLocalConfig(profile);
+        const effective = effectiveValues(profile);
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({
+                command: "config list",
+                profile,
+                data: { file: configPath(profile), stored, effective },
+            })));
+            return;
+        }
+        const table = new Table({
+            head: ["Key", "Stored", "In effect"].map((header) => c.dim(header)),
+            style: { head: [], border: [], "padding-left": 1, "padding-right": 1 },
+        });
+        for (const key of CONFIG_KEYS) {
+            const storedValue = stored[key];
+            table.push([
+                key,
+                storedValue === undefined ? c.dim(NOT_REPORTED) : c.value(String(storedValue)),
+                effective[key] === undefined ? c.dim(NOT_REPORTED) : String(effective[key]),
+            ]);
+        }
+        this.log(table.toString());
+        this.log(c.dim(`file: ${configPath(profile)}`));
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/config/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/config/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAC;AAExD,iGAAiG;AACjG,oFAAoF;AACpF,oGAAoG;AACpG,oGAAoG;AACpG,oEAAoE;AAEpE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,WAAW,GAAG,uEAAuE,CAAC;IAE7F,MAAM,CAAC,QAAQ,GAAG,CAAC,+BAA+B,EAAE,sCAAsC,CAAC,CAAC;IAE5F,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtE,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CACN,UAAU,CACR,aAAa,CAAC;gBACZ,OAAO,EAAE,aAAa;gBACtB,OAAO;gBACP,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE;aACvD,CAAC,CACH,CACF,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;YACtB,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACnE,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,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG;gBACH,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAC9E,SAAS,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;aAC5E,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC"}

package/dist/commands/config/set.d.ts

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

package/dist/commands/config/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/commands/config/set.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,SAAwE;IAE1F,MAAM,CAAC,QAAQ,WAAqG;IAEpH,MAAM,CAAC,IAAI;;;MAGT;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+C3B"}